#2716 · @yoavf · opened Sep 21, 2025 at 5:57 AM UTC · last updated Mar 21, 2026 at 12:10 PM UTC

docs: update sdk example to show how to set a custom agent

appdocs
17
+2641102 files

Score breakdown

Impact

3.0

Clarity

2.0

Urgency

2.0

Ease Of Review

1.0

Guidelines

1.0

Readiness

1.0

Size

1.0

Trust

5.0

Traction

0.0

Summary

This PR aims to update SDK documentation but includes a large, unexplained change to the STATS.md file. The extraneous file change inflates the PR size significantly and severely reduces its focus.

Open in GitHub

Description

Updating the sdk docs to indicate it's possible to select a custom agent when calling client.session.prompt

Linked Issues

None.

Comments

No comments.

Changed Files

STATS.md

+263110
@@ -1,112 +1,265 @@
# Download Stats
| Date | GitHub Downloads | npm Downloads | Total |
| ---------- | ----------------- | ----------------- | ----------------- |
| 2025-06-29 | 18,789 (+0) | 39,420 (+0) | 58,209 (+0) |
| 2025-06-30 | 20,127 (+1,338) | 41,059 (+1,639) | 61,186 (+2,977) |
| 2025-07-01 | 22,108 (+1,981) | 43,745 (+2,686) | 65,853 (+4,667) |
| 2025-07-02 | 24,814 (+2,706) | 46,168 (+2,423) | 70,982 (+5,129) |
| 2025-07-03 | 27,834 (+3,020) | 49,955 (+3,787) | 77,789 (+6,807) |
| 2025-07-04 | 30,608 (+2,774) | 54,758 (+4,803) | 85,366 (+7,577) |
| 2025-07-05 | 32,524 (+1,916) | 58,371 (+3,613) | 90,895 (+5,529) |
| 2025-07-06 | 33,766 (+1,242) | 59,694 (+1,323) | 93,460 (+2,565) |
| 2025-07-08 | 38,052 (+4,286) | 64,468 (+4,774) | 102,520 (+9,060) |
| 2025-07-09 | 40,924 (+2,872) | 67,935 (+3,467) | 108,859 (+6,339) |
| 2025-07-10 | 43,796 (+2,872) | 71,402 (+3,467) | 115,198 (+6,339) |
| 2025-07-11 | 46,982 (+3,186) | 77,462 (+6,060) | 124,444 (+9,246) |
| 2025-07-12 | 49,302 (+2,320) | 82,177 (+4,715) | 131,479 (+7,035) |
| 2025-07-13 | 50,8

packages/web/src/content/docs/sdk.mdx

+10
@@ -247,6 +247,7 @@ const sessions = await client.session.list()
const result = await client.session.prompt({
path: { id: session.id },
body: {
agent: "my-custom-agent",
model: { providerID: "anthropic", modelID: "claude-3-5-sonnet-20241022" },
parts: [{ type: "text", text: "Hello!" }],
},