copilotkit 4.13.0 → 4.13.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (79) hide show
  1. package/cli-build-info.json +8 -8
  2. package/index.js +607 -257
  3. package/onboarding/index.json +1 -1
  4. package/onboarding/prompts/authenticate/start.md +7 -7
  5. package/onboarding/prompts/conversion/plan.md +3 -3
  6. package/onboarding/prompts/credentials/finalize-plan.md +9 -8
  7. package/onboarding/prompts/credentials/plan.md +21 -21
  8. package/onboarding/prompts/credentials/settle-credentials.md +8 -8
  9. package/onboarding/prompts/credentials/write-plan.md +5 -5
  10. package/onboarding/prompts/fallback/best-effort.md +6 -6
  11. package/onboarding/prompts/feature/a2ui/implement.md +6 -6
  12. package/onboarding/prompts/feature/a2ui/proof.md +6 -6
  13. package/onboarding/prompts/feature/a2ui/start.md +7 -7
  14. package/onboarding/prompts/feature/channels/implement.md +15 -7
  15. package/onboarding/prompts/feature/channels/proof.md +6 -6
  16. package/onboarding/prompts/feature/channels/start.md +7 -7
  17. package/onboarding/prompts/feature/chat-suggestions/implement.md +6 -6
  18. package/onboarding/prompts/feature/chat-suggestions/proof.md +6 -6
  19. package/onboarding/prompts/feature/chat-suggestions/start.md +7 -7
  20. package/onboarding/prompts/feature/complete.md +1 -1
  21. package/onboarding/prompts/feature/learning/implement.md +15 -15
  22. package/onboarding/prompts/feature/learning/proof.md +7 -7
  23. package/onboarding/prompts/feature/learning/start.md +8 -8
  24. package/onboarding/prompts/feature/open-generative-ui/implement.md +6 -6
  25. package/onboarding/prompts/feature/open-generative-ui/proof.md +6 -6
  26. package/onboarding/prompts/feature/open-generative-ui/start.md +7 -7
  27. package/onboarding/prompts/feature/realtime-sync/implement.md +7 -7
  28. package/onboarding/prompts/feature/realtime-sync/proof.md +6 -6
  29. package/onboarding/prompts/feature/realtime-sync/start.md +6 -6
  30. package/onboarding/prompts/feature/rich-threads/implement.md +8 -8
  31. package/onboarding/prompts/feature/rich-threads/proof.md +6 -6
  32. package/onboarding/prompts/feature/rich-threads/start.md +6 -6
  33. package/onboarding/prompts/feature/stop.md +2 -2
  34. package/onboarding/prompts/feature/voice/implement.md +6 -6
  35. package/onboarding/prompts/feature/voice/proof.md +6 -6
  36. package/onboarding/prompts/feature/voice/start.md +7 -7
  37. package/onboarding/prompts/framework/ag2.md +2 -2
  38. package/onboarding/prompts/framework/agno.md +2 -2
  39. package/onboarding/prompts/framework/built-in.md +2 -2
  40. package/onboarding/prompts/framework/claude-sdk-python.md +2 -2
  41. package/onboarding/prompts/framework/claude-sdk-typescript.md +2 -2
  42. package/onboarding/prompts/framework/crewai-flows.md +2 -2
  43. package/onboarding/prompts/framework/deep-agents.md +2 -2
  44. package/onboarding/prompts/framework/google-adk.md +2 -2
  45. package/onboarding/prompts/framework/langgraph-fastapi.md +2 -2
  46. package/onboarding/prompts/framework/langgraph-python.md +2 -2
  47. package/onboarding/prompts/framework/langgraph-typescript.md +2 -2
  48. package/onboarding/prompts/framework/llamaindex.md +2 -2
  49. package/onboarding/prompts/framework/mastra.md +2 -2
  50. package/onboarding/prompts/framework/ms-agent-dotnet.md +2 -2
  51. package/onboarding/prompts/framework/ms-agent-harness-dotnet.md +2 -2
  52. package/onboarding/prompts/framework/ms-agent-python.md +2 -2
  53. package/onboarding/prompts/framework/pydantic-ai.md +2 -2
  54. package/onboarding/prompts/framework/strands-python.md +2 -2
  55. package/onboarding/prompts/framework/strands-typescript.md +2 -2
  56. package/onboarding/prompts/frontend/angular.md +3 -3
  57. package/onboarding/prompts/frontend/nextjs.md +3 -3
  58. package/onboarding/prompts/frontend/plan.md +7 -7
  59. package/onboarding/prompts/frontend/react-native.md +2 -2
  60. package/onboarding/prompts/frontend/react-spa.md +2 -2
  61. package/onboarding/prompts/frontend/vue.md +2 -2
  62. package/onboarding/prompts/implementation/build-and-validate.md +15 -15
  63. package/onboarding/prompts/proof/complete.md +8 -8
  64. package/onboarding/prompts/proof/oss-baseline.md +5 -5
  65. package/onboarding/prompts/proof/round-trip.md +10 -10
  66. package/onboarding/prompts/research/gather.md +5 -5
  67. package/onboarding/prompts/research/merge.md +3 -3
  68. package/onboarding/prompts/research/preflight.md +4 -4
  69. package/onboarding/prompts/research/route.md +7 -7
  70. package/onboarding/prompts/starter/clone.md +5 -5
  71. package/onboarding/prompts/stopped/run-failed.md +2 -2
  72. package/onboarding/prompts/subagent/create-plan.md +1 -1
  73. package/onboarding/prompts/subagent/implement-and-validate.md +7 -0
  74. package/onboarding/prompts/subagent/inspect-repository.md +1 -1
  75. package/onboarding/prompts/subagent/prove-oss-baseline.md +1 -1
  76. package/onboarding/prompts/subagent/prove-round-trip.md +7 -7
  77. package/onboarding/prompts/unsupported/no-validated-path.md +2 -2
  78. package/package.json +1 -1
  79. package/release/release-tool.js +101 -1
@@ -15,7 +15,7 @@ These TypeScript options have starters: Claude Agent SDK TypeScript, LangGraph T
15
15
  Mastra, and Strands Agents TypeScript. The .NET option is Microsoft Agent Framework .NET.
16
16
 
17
17
  If all shortcut conditions are true, record Next.js as the selected frontend. Then run
18
- `npx --yes copilotkit@4.13.0 onboard read starter/clone` before you fetch documentation.
18
+ `npx --yes copilotkit@4.13.1 onboard read starter/clone` before you fetch documentation.
19
19
 
20
20
  ## Documentation
21
21
 
@@ -27,7 +27,7 @@ agent as the default agent, which is correct only for a project that has no agen
27
27
  Do not replace the developer's existing agent with the built-in agent.
28
28
 
29
29
  If the page supports the selection, record Next.js and this URL. Then run
30
- `npx --yes copilotkit@4.13.0 onboard read credentials/finalize-plan`.
30
+ `npx --yes copilotkit@4.13.1 onboard read credentials/finalize-plan`.
31
31
 
32
32
  If the documentation does not support the selection, run
33
- `npx --yes copilotkit@4.13.0 onboard read unsupported/no-validated-path`.
33
+ `npx --yes copilotkit@4.13.1 onboard read unsupported/no-validated-path`.
@@ -36,15 +36,15 @@ CopilotKit web apps. Then recommend the one the developer names, and say what ea
36
36
 
37
37
  Use exactly one matching internal route:
38
38
 
39
- 1. React SPA: `npx --yes copilotkit@4.13.0 onboard read frontend/react-spa`
40
- 2. Next.js: `npx --yes copilotkit@4.13.0 onboard read frontend/nextjs`
41
- 3. Angular: `npx --yes copilotkit@4.13.0 onboard read frontend/angular`
42
- 4. Vue 3: `npx --yes copilotkit@4.13.0 onboard read frontend/vue`
43
- 5. React Native: `npx --yes copilotkit@4.13.0 onboard read frontend/react-native`
44
- 6. Slack or Microsoft Teams: `npx --yes copilotkit@4.13.0 onboard read feature/channels/start`
39
+ 1. React SPA: `npx --yes copilotkit@4.13.1 onboard read frontend/react-spa`
40
+ 2. Next.js: `npx --yes copilotkit@4.13.1 onboard read frontend/nextjs`
41
+ 3. Angular: `npx --yes copilotkit@4.13.1 onboard read frontend/angular`
42
+ 4. Vue 3: `npx --yes copilotkit@4.13.1 onboard read frontend/vue`
43
+ 5. React Native: `npx --yes copilotkit@4.13.1 onboard read frontend/react-native`
44
+ 6. Slack or Microsoft Teams: `npx --yes copilotkit@4.13.1 onboard read feature/channels/start`
45
45
 
46
46
  If they chose Slack or Microsoft Teams, tell that node which one they chose so it
47
47
  does not ask again.
48
48
 
49
49
  If no listed frontend fits, run
50
- `npx --yes copilotkit@4.13.0 onboard read unsupported/no-validated-path`.
50
+ `npx --yes copilotkit@4.13.1 onboard read unsupported/no-validated-path`.
@@ -15,7 +15,7 @@ documents `useRenderTool`, which is React Native's own hook for drawing a tool t
15
15
  already has. That is a different job and needs a tool in the agent.
16
16
 
17
17
  If the pages support the selection, record React Native and these URLs. Then run
18
- `npx --yes copilotkit@4.13.0 onboard read credentials/finalize-plan`.
18
+ `npx --yes copilotkit@4.13.1 onboard read credentials/finalize-plan`.
19
19
 
20
20
  If the documentation does not support the selection, run
21
- `npx --yes copilotkit@4.13.0 onboard read unsupported/no-validated-path`.
21
+ `npx --yes copilotkit@4.13.1 onboard read unsupported/no-validated-path`.
@@ -11,7 +11,7 @@ not move the agent into it.
11
11
  - https://docs.copilotkit.ai/react-spa.md
12
12
 
13
13
  If the page supports the selection, record React SPA and this URL. Then run
14
- `npx --yes copilotkit@4.13.0 onboard read credentials/finalize-plan`.
14
+ `npx --yes copilotkit@4.13.1 onboard read credentials/finalize-plan`.
15
15
 
16
16
  If the documentation does not support the selection, run
17
- `npx --yes copilotkit@4.13.0 onboard read unsupported/no-validated-path`.
17
+ `npx --yes copilotkit@4.13.1 onboard read unsupported/no-validated-path`.
@@ -16,7 +16,7 @@ page above. Vue has its own `useComponent`, which is not the React package. Take
16
16
  that reference page rather than from a Vue generative-UI guide, which is not published.
17
17
 
18
18
  If the pages support the selection, record Vue 3 and these URLs. Then run
19
- `npx --yes copilotkit@4.13.0 onboard read credentials/finalize-plan`.
19
+ `npx --yes copilotkit@4.13.1 onboard read credentials/finalize-plan`.
20
20
 
21
21
  If the documentation does not support the selection, run
22
- `npx --yes copilotkit@4.13.0 onboard read unsupported/no-validated-path`.
22
+ `npx --yes copilotkit@4.13.1 onboard read unsupported/no-validated-path`.
@@ -12,7 +12,7 @@ command without another developer question. Do not ask the developer about telem
12
12
  command applies the setting they already have.
13
13
 
14
14
  ```text
15
- npx --yes copilotkit@4.13.0 onboard friction --phase stop --category <slug>
15
+ npx --yes copilotkit@4.13.1 onboard friction --phase stop --category <slug>
16
16
  ```
17
17
 
18
18
  Write one or two sentences to standard input: the step you stopped at and what stopped it.
@@ -53,7 +53,7 @@ Approving the plan is the developer agreeing to every path it listed under
53
53
  app directory:
54
54
 
55
55
  ```text
56
- npx --yes copilotkit@4.13.0 onboard protect --authorize --path <path> --reason "<the plan's sentence>"
56
+ npx --yes copilotkit@4.13.1 onboard protect --authorize --path <path> --reason "<the plan's sentence>"
57
57
  ```
58
58
 
59
59
  Consent has to be on the record before the file moves, so a call made after the change is
@@ -70,7 +70,7 @@ No implementation step has run yet, so the change is theirs rather than this run
70
70
  consent over it by adding one flag:
71
71
 
72
72
  ```text
73
- npx --yes copilotkit@4.13.0 onboard protect --authorize --path <path> --reason "<the plan's sentence>" --with-prior-change
73
+ npx --yes copilotkit@4.13.1 onboard protect --authorize --path <path> --reason "<the plan's sentence>" --with-prior-change
74
74
  ```
75
75
 
76
76
  The flag records their change as drift beside the consent, so the closing report names both
@@ -89,7 +89,7 @@ rather than this section.
89
89
  Run the audit from the target app directory:
90
90
 
91
91
  ```text
92
- npx --yes copilotkit@4.13.0 onboard audit
92
+ npx --yes copilotkit@4.13.1 onboard audit
93
93
  ```
94
94
 
95
95
  It compares every protected path with the digest the CLI captured for it. Its result starts
@@ -124,14 +124,14 @@ A path that no Files changed section names changed outside the run, and it is th
124
124
  developer's own file. Accept it by name:
125
125
 
126
126
  ```text
127
- npx --yes copilotkit@4.13.0 onboard protect --accept-external --path <path>
127
+ npx --yes copilotkit@4.13.1 onboard protect --accept-external --path <path>
128
128
  ```
129
129
 
130
130
  A changed env file is its own case. This run asked the developer to place a credential
131
131
  there, so it takes the credential route rather than this one:
132
132
 
133
133
  ```text
134
- npx --yes copilotkit@4.13.0 onboard protect --accept-credential --path <path>
134
+ npx --yes copilotkit@4.13.1 onboard protect --accept-credential --path <path>
135
135
  ```
136
136
 
137
137
  That route proves no recorded credential was lost, instead of taking the run's word that it
@@ -150,7 +150,7 @@ neither does a one-line fix. Never repair, reset, or revert it. Ask the develope
150
150
  the change, and record the answer they give:
151
151
 
152
152
  ```text
153
- npx --yes copilotkit@4.13.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
153
+ npx --yes copilotkit@4.13.1 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
154
154
  ```
155
155
 
156
156
  Use it only for an answer a developer actually gave. It records the consent as taken
@@ -171,7 +171,7 @@ create it now, from the target app directory. The developer approved the id befo
171
171
  made, so this is the first point at which it can be created:
172
172
 
173
173
  ```text
174
- npx --yes copilotkit@4.13.0 learning containers create --id <id> --name <name> --json
174
+ npx --yes copilotkit@4.13.1 learning containers create --id <id> --name <name> --json
175
175
  ```
176
176
 
177
177
  Pass the id the plan names. Take the name from the selected project's own display name, so
@@ -187,7 +187,7 @@ hold.
187
187
  Then report that the container is settled, before any edit:
188
188
 
189
189
  ```text
190
- npx --yes copilotkit@4.13.0 onboard checkpoint --phase container-settled
190
+ npx --yes copilotkit@4.13.1 onboard checkpoint --phase container-settled
191
191
  ```
192
192
 
193
193
  Where the plan names a container the platform already held, report the same checkpoint and
@@ -196,11 +196,11 @@ create nothing. Where the plan names no container, skip this section.
196
196
  Report the plan this run is about to implement:
197
197
 
198
198
  ```text
199
- npx --yes copilotkit@4.13.0 onboard checkpoint --phase plan-written
199
+ npx --yes copilotkit@4.13.1 onboard checkpoint --phase plan-written
200
200
  ```
201
201
 
202
202
  Spawn one implementation subagent. Tell it to run
203
- `npx --yes copilotkit@4.13.0 onboard read subagent/implement-and-validate` first and follow
203
+ `npx --yes copilotkit@4.13.1 onboard read subagent/implement-and-validate` first and follow
204
204
  the prompt it returns. If that read fails because the subagent cannot use the shell, stop that
205
205
  subagent. Run the same command yourself, then spawn a fresh subagent with the returned prompt
206
206
  and the same handoff. Give it the plan, selected framework, frontend, model, exact target app
@@ -228,11 +228,11 @@ returned. Continue to proof only when that audit passes.
228
228
  After the selected implementation path passes, report it:
229
229
 
230
230
  ```text
231
- npx --yes copilotkit@4.13.0 onboard checkpoint --phase build-validated
231
+ npx --yes copilotkit@4.13.1 onboard checkpoint --phase build-validated
232
232
  ```
233
233
 
234
234
  Then run
235
- `npx --yes copilotkit@4.13.0 onboard read proof/round-trip`.
235
+ `npx --yes copilotkit@4.13.1 onboard read proof/round-trip`.
236
236
 
237
237
  ## Repair rules
238
238
 
@@ -254,9 +254,9 @@ the same command still fails after three repair attempts, or a result starts wit
254
254
  `Status: blocked`. A defect in a package this run installed is not a stack CopilotKit does
255
255
  not serve, a command this run cannot get to pass is not one either, and a blocked audit
256
256
  proved nothing about the stack. In those cases run
257
- `npx --yes copilotkit@4.13.0 onboard read stopped/run-failed`.
257
+ `npx --yes copilotkit@4.13.1 onboard read stopped/run-failed`.
258
258
 
259
259
  A plan with no path to follow takes the unsupported ending: the fix requires changing the
260
260
  developer's existing agent or frontend, or the documentation does not support the plan. In
261
261
  those cases run
262
- `npx --yes copilotkit@4.13.0 onboard read unsupported/no-validated-path`.
262
+ `npx --yes copilotkit@4.13.1 onboard read unsupported/no-validated-path`.
@@ -84,7 +84,7 @@ Name the debugging surface this journey's frontend can reach, rather than the on
84
84
  of the documentation leads with. For a web frontend it is the CopilotKit Inspector. For
85
85
  React Native there is no Inspector: it is a browser overlay built on a DOM custom element,
86
86
  and `@copilotkit/react-native` does not ship it. Give a mobile developer
87
- `npx --yes copilotkit@4.13.0 verify --round-trip`, the runtime's own log, the AG-UI
87
+ `npx --yes copilotkit@4.13.1 verify --round-trip`, the runtime's own log, the AG-UI
88
88
  Event Inspector in the CopilotKit VS Code extension, and the CopilotKit Intelligence
89
89
  thread view
90
90
  instead. Naming the Inspector to a developer who cannot open it costs them the time it
@@ -114,7 +114,7 @@ the friction commands without another developer question. Do not ask the develop
114
114
  telemetry: the command applies the setting they already have.
115
115
 
116
116
  ```text
117
- npx --yes copilotkit@4.13.0 onboard friction --category <slug> --cost-seconds <seconds>
117
+ npx --yes copilotkit@4.13.1 onboard friction --category <slug> --cost-seconds <seconds>
118
118
  ```
119
119
 
120
120
  Write one or two sentences on the command's standard input. Pick one category from
@@ -126,7 +126,7 @@ Pass --docs-path only for a docs-missing or docs-wrong report, naming the page t
126
126
  is about:
127
127
 
128
128
  ```text
129
- npx --yes copilotkit@4.13.0 onboard friction --category docs-wrong --cost-seconds 300 --docs-path /docs/threads/drawer
129
+ npx --yes copilotkit@4.13.1 onboard friction --category docs-wrong --cost-seconds 300 --docs-path /docs/threads/drawer
130
130
  ```
131
131
 
132
132
  Give the page's site-relative path or its full URL, with no spaces, query string, or
@@ -143,14 +143,14 @@ Tell the developer when you send a friction report. Do not quote or summarize th
143
143
  unless the developer asks. If the CLI says the report was not sent,
144
144
  state what it said and continue without another question.
145
145
 
146
- When the evidence is gathered, run `npx --yes copilotkit@4.13.0 onboard complete`, carrying
146
+ When the evidence is gathered, run `npx --yes copilotkit@4.13.1 onboard complete`, carrying
147
147
  the surface-check outcome the proof subagent returned. Pass exactly one flag, and pass the
148
148
  one that matches this journey's surface.
149
149
 
150
150
  For a web frontend -- React SPA, Next.js, Angular, Vue:
151
151
 
152
152
  ```text
153
- npx --yes copilotkit@4.13.0 onboard complete --visual-check <outcome>
153
+ npx --yes copilotkit@4.13.1 onboard complete --visual-check <outcome>
154
154
  ```
155
155
 
156
156
  The outcome is one of `performed`, `skipped-no-browser-tool`, `skipped-cloned-starter`, or
@@ -160,7 +160,7 @@ open no browser. It is the one skip that does not block.
160
160
  For React Native:
161
161
 
162
162
  ```text
163
- npx --yes copilotkit@4.13.0 onboard complete --device-check <outcome>
163
+ npx --yes copilotkit@4.13.1 onboard complete --device-check <outcome>
164
164
  ```
165
165
 
166
166
  The outcome is one of `performed`, `skipped-no-device`, `skipped-cloned-starter`, or
@@ -173,7 +173,7 @@ browser-origin CORS, so the flag you pass is how this run states which surface i
173
173
  For a web frontend, also pass the URL the browser opened:
174
174
 
175
175
  ```text
176
- npx --yes copilotkit@4.13.0 onboard complete --visual-check <outcome> \
176
+ npx --yes copilotkit@4.13.1 onboard complete --visual-check <outcome> \
177
177
  --frontend-url <the url you opened>
178
178
  ```
179
179
 
@@ -192,7 +192,7 @@ If the round trip proved and something after it still blocked this run, add `--b
192
192
  to the same command:
193
193
 
194
194
  ```text
195
- npx --yes copilotkit@4.13.0 onboard complete --visual-check performed --blocked-by <cause>
195
+ npx --yes copilotkit@4.13.1 onboard complete --visual-check performed --blocked-by <cause>
196
196
  ```
197
197
 
198
198
  The cause is one of `inspector` for a debugging surface that did not open,
@@ -1,7 +1,7 @@
1
1
  # Prove the existing OSS baseline
2
2
 
3
3
  Do not prove the baseline yourself. Spawn one proof subagent. Tell it to run
4
- `npx --yes copilotkit@4.13.0 onboard read subagent/prove-oss-baseline` first and follow the
4
+ `npx --yes copilotkit@4.13.1 onboard read subagent/prove-oss-baseline` first and follow the
5
5
  prompt it returns. If that read fails because the subagent cannot use the shell, stop that
6
6
  subagent. Run the same command yourself, then spawn a fresh subagent with the returned prompt
7
7
  and the same handoff. Give it the repository findings and exact CLI package spec.
@@ -17,7 +17,7 @@ Wait for the subagent to finish.
17
17
  Record what that proof returned before you route on it:
18
18
 
19
19
  ```text
20
- npx --yes copilotkit@4.13.0 onboard proof --step oss-baseline --outcome <passed|failed|skipped> [--predicate <1-6>]
20
+ npx --yes copilotkit@4.13.1 onboard proof --step oss-baseline --outcome <passed|failed|skipped> [--predicate <1-6>]
21
21
  ```
22
22
 
23
23
  Report the gate whatever it returned. Pass `passed` when the subagent proved a predicate,
@@ -35,12 +35,12 @@ Do not change project files before this proof ends. Starting existing developmen
35
35
  processes and their ignored runtime files is allowed.
36
36
 
37
37
  If the subagent proves the `both-oss` predicate, keep its evidence with the plan and run
38
- `npx --yes copilotkit@4.13.0 onboard read conversion/plan`. That project already works.
38
+ `npx --yes copilotkit@4.13.1 onboard read conversion/plan`. That project already works.
39
39
  What it needs is the conversion, not a build.
40
40
 
41
41
  If the proof does not establish the baseline, record the starting state
42
42
  `both-copilotkit-unproved` and run
43
- `npx --yes copilotkit@4.13.0 onboard read credentials/plan`. This prompt is served
43
+ `npx --yes copilotkit@4.13.1 onboard read credentials/plan`. This prompt is served
44
44
  whenever a project looks like an OSS integration, so a baseline that did not prove is an
45
45
  ordinary starting state rather than a failure. Keep the failing predicate with the plan.
46
46
 
@@ -54,5 +54,5 @@ and the plan preserves it rather than repeating it.
54
54
 
55
55
  If it cannot identify the running process safely, exposes a secret, or finds a baseline
56
56
  failure that cannot be classified, run
57
- `npx --yes copilotkit@4.13.0 onboard read stopped/run-failed`. None of those mean the
57
+ `npx --yes copilotkit@4.13.1 onboard read stopped/run-failed`. None of those mean the
58
58
  project is unsupported: they mean this run did not establish what it needed to.
@@ -1,7 +1,7 @@
1
1
  # Prove the user journey
2
2
 
3
3
  Do not do the proof work yourself. Spawn one proof subagent. Tell it to run
4
- `npx --yes copilotkit@4.13.0 onboard read subagent/prove-round-trip` first and follow the
4
+ `npx --yes copilotkit@4.13.1 onboard read subagent/prove-round-trip` first and follow the
5
5
  prompt it returns. If that read fails because the subagent cannot use the shell, stop that
6
6
  subagent. Run the same command yourself, then spawn a fresh subagent with the returned prompt
7
7
  and the same handoff. Give it the selected framework, frontend, model, approved plan, selected
@@ -33,13 +33,13 @@ pass the time.
33
33
  Report each attempt at the journey as it ends, counting from one:
34
34
 
35
35
  ```text
36
- npx --yes copilotkit@4.13.0 onboard checkpoint --phase journey-attempted --attempt 1
36
+ npx --yes copilotkit@4.13.1 onboard checkpoint --phase journey-attempted --attempt 1
37
37
  ```
38
38
 
39
39
  Record what that proof returned before you route on it:
40
40
 
41
41
  ```text
42
- npx --yes copilotkit@4.13.0 onboard proof --step round-trip --outcome <passed|failed|skipped>
42
+ npx --yes copilotkit@4.13.1 onboard proof --step round-trip --outcome <passed|failed|skipped>
43
43
  ```
44
44
 
45
45
  Report the gate whatever it returned. A proof that never ran is `skipped`, not failed. The
@@ -47,7 +47,7 @@ command prints one line and sends nothing else. Where a repair cycle runs the pr
47
47
  record each attempt as it ends.
48
48
 
49
49
  For every protected-path audit in this prompt, run
50
- `npx --yes copilotkit@4.13.0 onboard audit` from the target app directory. If its result
50
+ `npx --yes copilotkit@4.13.1 onboard audit` from the target app directory. If its result
51
51
  starts with `Status: blocked`, report the printed reason and use the route-out rules below.
52
52
  A blocked audit proved nothing changed and is not a preservation failure. If a
53
53
  protected-path audit reports a changed path, decide it the way the implementation prompt
@@ -56,7 +56,7 @@ returns none, so a finding with no Files changed section to test against routes
56
56
  path one of those sections names is this run's own change and routes out too. Accept a
57
57
  path only when a section this run collected covers the step that wrote it and does not
58
58
  name it:
59
- `npx --yes copilotkit@4.13.0 onboard protect --accept-external --path <path>`. Then run
59
+ `npx --yes copilotkit@4.13.1 onboard protect --accept-external --path <path>`. Then run
60
60
  the audit again and name the path in the closing summary. Never repair, reset, or revert a
61
61
  protected path.
62
62
 
@@ -64,12 +64,12 @@ That holds for a repair cycle too. When the fix for a failing check lands on a p
64
64
  path, the path is still the developer's, however right the diagnosis is and however small
65
65
  the fix. Reading the file never settles who wrote it. Ask the developer to allow the
66
66
  change, and record their answer with
67
- `npx --yes copilotkit@4.13.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"`,
67
+ `npx --yes copilotkit@4.13.1 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"`,
68
68
  or route out. Never repair it, and never send it to a repair worker.
69
69
 
70
70
  If the proof result starts with `Status: passed`, run the protected-path audit. Continue to
71
71
  `proof/complete` only if that audit passes. After the audit passes, run
72
- `npx --yes copilotkit@4.13.0 onboard read proof/complete`. A performed surface outcome with
72
+ `npx --yes copilotkit@4.13.1 onboard read proof/complete`. A performed surface outcome with
73
73
  the full round trip is core success even if a continued-development tool fails. A skipped
74
74
  surface outcome still enters `proof/complete` so the CLI records the blocked result. Do not
75
75
  describe a skipped surface as proved. Keep the Skills and MCP results separate from the proof
@@ -136,7 +136,7 @@ Restart each project-owned process changed by the repair. Report the cycle, coun
136
136
  one:
137
137
 
138
138
  ```text
139
- npx --yes copilotkit@4.13.0 onboard checkpoint --phase repair-attempted --attempt 1
139
+ npx --yes copilotkit@4.13.1 onboard checkpoint --phase repair-attempted --attempt 1
140
140
  ```
141
141
 
142
142
  Then spawn a fresh proof subagent
@@ -154,7 +154,7 @@ and proof cycles.
154
154
 
155
155
  Route out only when the failure is not yours to fix, when the same proof still fails after
156
156
  three attempts, or when no evidence of the round trip can be produced. In those cases run
157
- `npx --yes copilotkit@4.13.0 onboard read stopped/run-failed`. The stack is supported:
157
+ `npx --yes copilotkit@4.13.1 onboard read stopped/run-failed`. The stack is supported:
158
158
  this run did not finish, which is a different ending and a different report. All three are
159
159
  about the round trip itself. A round trip that proved is not one of them, whatever failed
160
160
  after it.
@@ -165,7 +165,7 @@ friction command without another developer question: it applies the telemetry se
165
165
  developer already set.
166
166
 
167
167
  ```text
168
- npx --yes copilotkit@4.13.0 onboard friction --phase stop --category <slug>
168
+ npx --yes copilotkit@4.13.1 onboard friction --phase stop --category <slug>
169
169
  ```
170
170
 
171
171
  Write one or two sentences to standard input: the step you stopped at and what stopped it.
@@ -34,7 +34,7 @@ Both research subagents failing means this harness has no working subagent at al
34
34
  is worth recording once:
35
35
 
36
36
  ```text
37
- npx --yes copilotkit@4.13.0 onboard checkpoint --phase delegation-unavailable
37
+ npx --yes copilotkit@4.13.1 onboard checkpoint --phase delegation-unavailable
38
38
  ```
39
39
 
40
40
  Then say once, in your own words, that this environment has no working subagents, so you
@@ -47,7 +47,7 @@ Before you ask the developer any setup question, finish every read-only investig
47
47
  preflight check in this section.
48
48
 
49
49
  Prepare two research assignments. Give each research subagent one assignment. Tell it to run
50
- `npx --yes copilotkit@4.13.0 onboard read subagent/inspect-repository` first and follow the
50
+ `npx --yes copilotkit@4.13.1 onboard read subagent/inspect-repository` first and follow the
51
51
  prompt it returns. If that read fails because the subagent cannot use the shell, stop that
52
52
  subagent. Run the same command yourself, then spawn a fresh subagent with the returned prompt
53
53
  and the same handoff. Require only its assigned packet.
@@ -61,7 +61,7 @@ Start both research subagents in parallel:
61
61
  Report that both subagents started:
62
62
 
63
63
  ```text
64
- npx --yes copilotkit@4.13.0 onboard checkpoint --phase research-dispatched
64
+ npx --yes copilotkit@4.13.1 onboard checkpoint --phase research-dispatched
65
65
  ```
66
66
 
67
67
  A refused checkpoint prints its reason and leaves onboarding unaffected. It is not a
@@ -70,8 +70,8 @@ failed step.
70
70
  The research is under way. Continue to the surface-control preflight while it runs:
71
71
 
72
72
  ```text
73
- npx --yes copilotkit@4.13.0 onboard read research/preflight
73
+ npx --yes copilotkit@4.13.1 onboard read research/preflight
74
74
  ```
75
75
 
76
76
  If inspection stops onboarding, run
77
- `npx --yes copilotkit@4.13.0 onboard read stopped/run-failed`.
77
+ `npx --yes copilotkit@4.13.1 onboard read stopped/run-failed`.
@@ -21,7 +21,7 @@ Project selection is where the settled port is written down, through `--runtime-
21
21
  Then report that the research came back:
22
22
 
23
23
  ```text
24
- npx --yes copilotkit@4.13.0 onboard checkpoint --phase research-returned
24
+ npx --yes copilotkit@4.13.1 onboard checkpoint --phase research-returned
25
25
  ```
26
26
 
27
27
  A refused checkpoint prints its reason and leaves onboarding unaffected. It is not a
@@ -54,7 +54,7 @@ worker a focused directory check. Continue only when both workers return the sam
54
54
  app directory. Both results must start with `Status: passed`. Otherwise, use the stop route.
55
55
 
56
56
  When both research results are merged, run
57
- `npx --yes copilotkit@4.13.0 onboard read research/route`.
57
+ `npx --yes copilotkit@4.13.1 onboard read research/route`.
58
58
 
59
59
  If inspection stops onboarding, run
60
- `npx --yes copilotkit@4.13.0 onboard read stopped/run-failed`.
60
+ `npx --yes copilotkit@4.13.1 onboard read stopped/run-failed`.
@@ -45,7 +45,7 @@ mechanism a later step uses for the CopilotKit documentation server.
45
45
 
46
46
  Some coding agents, Claude Code among them, load a newly registered MCP server only at the
47
47
  next session start. Tell the developer in one line to expect one restart, then restart and
48
- re-bind with `npx --yes copilotkit@4.13.0 onboard start --run <onboarding_run_id>`. That
48
+ re-bind with `npx --yes copilotkit@4.13.1 onboard start --run <onboarding_run_id>`. That
49
49
  restart is a step here, not an error.
50
50
 
51
51
  Do not add a browser or device driver to the project. A driver added there is a
@@ -62,14 +62,14 @@ whole finding.
62
62
  Report that the probe settled, whichever way it came out:
63
63
 
64
64
  ```text
65
- npx --yes copilotkit@4.13.0 onboard checkpoint --phase surface-probed
65
+ npx --yes copilotkit@4.13.1 onboard checkpoint --phase surface-probed
66
66
  ```
67
67
 
68
68
  Then merge the research:
69
69
 
70
70
  ```text
71
- npx --yes copilotkit@4.13.0 onboard read research/merge
71
+ npx --yes copilotkit@4.13.1 onboard read research/merge
72
72
  ```
73
73
 
74
74
  If inspection stops onboarding, run
75
- `npx --yes copilotkit@4.13.0 onboard read stopped/run-failed`.
75
+ `npx --yes copilotkit@4.13.1 onboard read stopped/run-failed`.
@@ -9,7 +9,7 @@ sends the run down one path.
9
9
  Before you route on, run this from the target app directory:
10
10
 
11
11
  ```text
12
- npx --yes copilotkit@4.13.0 onboard protect
12
+ npx --yes copilotkit@4.13.1 onboard protect
13
13
  ```
14
14
 
15
15
  It reads the working tree itself, records every changed or untracked path with a digest,
@@ -41,7 +41,7 @@ On either, run this before you read the three findings below, and without asking
41
41
  purpose question:
42
42
 
43
43
  ```text
44
- npx --yes copilotkit@4.13.0 onboard read feature/channels/start
44
+ npx --yes copilotkit@4.13.1 onboard read feature/channels/start
45
45
  ```
46
46
 
47
47
  Name the provider to that node so it does not ask again. A Slack page names Slack. A Teams
@@ -96,7 +96,7 @@ settle these three from your own reading of the project. Each one comes from the
96
96
  packets or it is not proved.
97
97
 
98
98
  If all three are proved, prove the live starting state before any project file changes. Run
99
- `npx --yes copilotkit@4.13.0 onboard read proof/oss-baseline`.
99
+ `npx --yes copilotkit@4.13.1 onboard read proof/oss-baseline`.
100
100
 
101
101
  Route there before you ask the developer anything else. The questions after this prompt
102
102
  select a framework and a frontend that the findings already name, so a developer who
@@ -107,9 +107,9 @@ these three findings.
107
107
  For every other combination of the three, take one more step first. If neither the
108
108
  developer nor the repository findings prove what the project is for, ask one guided
109
109
  question about the user outcome. This asks what the developer wants to build before you
110
- select a framework. Give two or three short examples and offer a minimal starter. Record
111
- the answer and give it to each later subagent. Then run
112
- `npx --yes copilotkit@4.13.0 onboard read credentials/plan`.
110
+ select a framework. Give two or three short examples. Record the answer and give it to
111
+ each later subagent. Then run
112
+ `npx --yes copilotkit@4.13.1 onboard read credentials/plan`.
113
113
 
114
114
  Do not ask that question on the route above. A project carrying all three states its
115
115
  purpose in the application it already serves.
@@ -121,5 +121,5 @@ A purpose question here names a domain before that choice.
121
121
  Take the same read named above without asking.
122
122
 
123
123
  If authentication or inspection stops onboarding, run
124
- `npx --yes copilotkit@4.13.0 onboard read stopped/run-failed`. Neither says anything
124
+ `npx --yes copilotkit@4.13.1 onboard read stopped/run-failed`. Neither says anything
125
125
  about whether this project's stack is supported, which is not yet known at this point.
@@ -46,7 +46,7 @@ the derived name.
46
46
  Only if the developer asks for an existing project, or asks to see the projects they have,
47
47
  read the choices:
48
48
 
49
- `npx --yes copilotkit@4.13.0 project list --json`
49
+ `npx --yes copilotkit@4.13.1 project list --json`
50
50
 
51
51
  Then ask which one to use. Do not order the projects by creation time. If the developer
52
52
  already gave this answer, do not ask again. Do not read a secret value. Do not show or
@@ -56,7 +56,7 @@ Run the command from the parent directory. Do not inspect another entry in the p
56
56
  directory. Replace each placeholder with the recorded value. Do not run a placeholder as
57
57
  a shell argument.
58
58
 
59
- `npx --yes copilotkit@4.13.0 init --name <project-name> --framework <framework-id> --channel none --no-banner --create <name> --install`
59
+ `npx --yes copilotkit@4.13.1 init --name <project-name> --framework <framework-id> --channel none --no-banner --create <name> --install`
60
60
 
61
61
  Pass the confirmed name to both `--name` and `--create`: the app directory and its
62
62
  Intelligence project take the same name here. If the developer names an existing project,
@@ -72,7 +72,7 @@ account. The command does not need terminal input.
72
72
  Report the clone before you inspect anything:
73
73
 
74
74
  ```text
75
- npx --yes copilotkit@4.13.0 onboard checkpoint --phase starter-cloned
75
+ npx --yes copilotkit@4.13.1 onboard checkpoint --phase starter-cloned
76
76
  ```
77
77
 
78
78
  This is its own step, not an aside. A run that clones and then goes quiet is
@@ -82,10 +82,10 @@ separates them.
82
82
  Do not rebuild the starter by hand. Then inspect only the generated
83
83
  paths inside the target directory. Record the files, install result, project connection,
84
84
  and validation commands. Then run
85
- `npx --yes copilotkit@4.13.0 onboard read proof/round-trip`.
85
+ `npx --yes copilotkit@4.13.1 onboard read proof/round-trip`.
86
86
 
87
87
  If the command fails, report its exact error and do not claim that the starter is ready.
88
88
  Then run
89
- `npx --yes copilotkit@4.13.0 onboard read stopped/run-failed`. The starter is one this
89
+ `npx --yes copilotkit@4.13.1 onboard read stopped/run-failed`. The starter is one this
90
90
  graph ships and the stack was chosen from its own supported list, so a command that
91
91
  returned an error is a run that broke, not a setup this release does not support.
@@ -35,7 +35,7 @@ put to them, stop here and send the report below.
35
35
  If they approve it, make that one fix and nothing else. Then come back into this run:
36
36
 
37
37
  ```text
38
- npx --yes copilotkit@4.13.0 onboard resume
38
+ npx --yes copilotkit@4.13.1 onboard resume
39
39
  ```
40
40
 
41
41
  Write the developer's approval to standard input, in one or two sentences: the fix they
@@ -58,7 +58,7 @@ Send one short report. Run the friction command without another developer questi
58
58
  ask the developer about telemetry: the command applies the setting they already have.
59
59
 
60
60
  ```text
61
- npx --yes copilotkit@4.13.0 onboard friction --phase stop --category <slug>
61
+ npx --yes copilotkit@4.13.1 onboard friction --phase stop --category <slug>
62
62
  ```
63
63
 
64
64
  Write one or two sentences to standard input: the step you stopped at and what stopped
@@ -170,7 +170,7 @@ here is work the developer did not ask for.
170
170
  Plan the threads drawer itself: add it from the selected drawer page, where this frontend
171
171
  does not already render one. Where this journey's frontend framework ships no threads
172
172
  drawer -- React Native --, plan that the thread is proved by
173
- `npx --yes copilotkit@4.13.0 verify --round-trip`, which needs no browser. Do not plan a
173
+ `npx --yes copilotkit@4.13.1 verify --round-trip`, which needs no browser. Do not plan a
174
174
  step that opens the managed Intelligence dashboard.
175
175
 
176
176
  ## Order the plan into steps
@@ -39,6 +39,13 @@ for the symbol you are about to write. Where the selected documentation page its
39
39
  a deprecated symbol, name that page under Blockers as `docs-wrong` friction and use the
40
40
  current symbol the package's own type definitions or changelog names.
41
41
 
42
+ A symbol this graph names is not that case. The approved plan and the framework
43
+ node carry the connection API for this stack, and `LangGraphAgent` from
44
+ `@copilotkit/runtime/langgraph` is one of them: deprecated at its entrypoint,
45
+ still the documented LangSmith path, and given no replacement by its own tooltip.
46
+ Write what the plan names. Do not rewrite a cloned starter to satisfy this rule,
47
+ and do not name the page that shows it under Blockers.
48
+
42
49
  The documentation supplies the wiring. The project supplies the application. Use that
43
50
  wiring in the project's domain. Do not copy an example's agent name, tools, or data.
44
51
 
@@ -7,7 +7,7 @@ Work only on the packet you were assigned. Inspect the repository without changi
7
7
  Run this first, from the target project directory:
8
8
 
9
9
  ```text
10
- npx --yes copilotkit@4.13.0 onboard inspect --json
10
+ npx --yes copilotkit@4.13.1 onboard inspect --json
11
11
  ```
12
12
 
13
13
  It answers the deterministic half of both packets exactly, from the same code
@@ -19,7 +19,7 @@ Prove the live runtime in this order:
19
19
  4. Confirm from project files that the runtime constructor passes a `runner` option rather
20
20
  than an `intelligence` option. A package, import, project file, or key is not use proof.
21
21
  5. Run
22
- `npx --yes copilotkit@4.13.0 verify --expect-runtime oss --round-trip --agent <expected-agent-id> --json`,
22
+ `npx --yes copilotkit@4.13.1 verify --expect-runtime oss --round-trip --agent <expected-agent-id> --json`,
23
23
  with the runtime URL or auth header options that this project needs. Require exit zero
24
24
  and the JSON `ok` field to be `true`.
25
25
  6. Drive one real request through the existing frontend, CopilotKit runtime, and expected