copilotkit 4.9.17 → 4.9.24

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 (46) hide show
  1. package/README.md +13 -0
  2. package/cli-build-info.json +7 -7
  3. package/index.js +1926 -1873
  4. package/onboarding/index.json +1 -1
  5. package/onboarding/prompts/authenticate/start.md +8 -8
  6. package/onboarding/prompts/conversion/plan.md +21 -11
  7. package/onboarding/prompts/credentials/finalize-plan.md +95 -34
  8. package/onboarding/prompts/credentials/plan.md +20 -20
  9. package/onboarding/prompts/fallback/best-effort.md +9 -8
  10. package/onboarding/prompts/framework/ag2.md +2 -2
  11. package/onboarding/prompts/framework/agno.md +2 -2
  12. package/onboarding/prompts/framework/built-in.md +2 -2
  13. package/onboarding/prompts/framework/claude-sdk-python.md +2 -2
  14. package/onboarding/prompts/framework/claude-sdk-typescript.md +2 -2
  15. package/onboarding/prompts/framework/crewai-flows.md +2 -2
  16. package/onboarding/prompts/framework/deep-agents.md +2 -2
  17. package/onboarding/prompts/framework/google-adk.md +2 -2
  18. package/onboarding/prompts/framework/langgraph-fastapi.md +2 -2
  19. package/onboarding/prompts/framework/langgraph-python.md +2 -2
  20. package/onboarding/prompts/framework/langgraph-typescript.md +2 -2
  21. package/onboarding/prompts/framework/llamaindex.md +2 -2
  22. package/onboarding/prompts/framework/mastra.md +2 -2
  23. package/onboarding/prompts/framework/ms-agent-dotnet.md +2 -2
  24. package/onboarding/prompts/framework/ms-agent-harness-dotnet.md +2 -2
  25. package/onboarding/prompts/framework/ms-agent-python.md +2 -2
  26. package/onboarding/prompts/framework/pydantic-ai.md +3 -3
  27. package/onboarding/prompts/framework/strands-python.md +2 -2
  28. package/onboarding/prompts/framework/strands-typescript.md +2 -2
  29. package/onboarding/prompts/frontend/angular.md +3 -3
  30. package/onboarding/prompts/frontend/nextjs.md +3 -3
  31. package/onboarding/prompts/frontend/plan.md +6 -6
  32. package/onboarding/prompts/frontend/react-native.md +2 -2
  33. package/onboarding/prompts/frontend/react-spa.md +2 -2
  34. package/onboarding/prompts/frontend/vue.md +2 -2
  35. package/onboarding/prompts/implementation/build-and-validate.md +4 -4
  36. package/onboarding/prompts/proof/complete.md +29 -12
  37. package/onboarding/prompts/proof/oss-baseline.md +4 -4
  38. package/onboarding/prompts/proof/round-trip.md +9 -9
  39. package/onboarding/prompts/starter/clone.md +17 -8
  40. package/onboarding/prompts/subagent/create-plan.md +9 -3
  41. package/onboarding/prompts/subagent/inspect-repository.md +1 -1
  42. package/onboarding/prompts/subagent/prove-oss-baseline.md +1 -1
  43. package/onboarding/prompts/subagent/prove-round-trip.md +17 -6
  44. package/onboarding/prompts/unsupported/no-validated-path.md +2 -2
  45. package/package.json +1 -1
  46. package/release/release-tool.js +1 -1
@@ -1,5 +1,5 @@
1
1
  {
2
- "graphTree": "613209959e8d5888a5770391381eeb0055fbe68d",
2
+ "graphTree": "8619678c9fde3386c7b4986b3241775007971075",
3
3
  "root": "authenticate/start",
4
4
  "prompts": [
5
5
  {
@@ -16,7 +16,7 @@ Every later command must run from the directory this run started in. A command r
16
16
  somewhere else, such as a sibling of that directory, is refused rather than answered,
17
17
  because the run it belongs to cannot be found from there. That refusal is a step to take,
18
18
  not a stop to report: run
19
- `npx --yes copilotkit@4.9.17 onboard start --run <onboarding_run_id>` in the directory
19
+ `npx --yes copilotkit@4.9.24 onboard start --run <onboarding_run_id>` in the directory
20
20
  you are now in, which binds it to the same run, then run the refused command again. Do not
21
21
  start a run without that id. A run started without it is a second run, and the work already
22
22
  done stops counting toward the first.
@@ -50,7 +50,7 @@ without another developer question. The CLI telemetry gate decides whether the r
50
50
  sent.
51
51
 
52
52
  ```text
53
- npx --yes copilotkit@4.9.17 onboard feedback
53
+ npx --yes copilotkit@4.9.24 onboard feedback
54
54
  ```
55
55
 
56
56
  Write at most four lines to the command's standard input: the step you stopped at and what
@@ -67,7 +67,7 @@ Until now the route out of an unsupported path was the only place that asked for
67
67
  so a stop anywhere else left no trace at all. A stop nobody hears about is a stop this
68
68
  graph cannot fix.
69
69
 
70
- Run `npx --yes copilotkit@4.9.17 login --json` before any project work. This command
70
+ Run `npx --yes copilotkit@4.9.24 login --json` before any project work. This command
71
71
  checks the current session. It starts sign-in only as needed. Treat this as a long-lived
72
72
  streaming process. Do not wait for the command to exit before you read its standard output.
73
73
 
@@ -88,7 +88,7 @@ Before you ask the developer any setup question, finish every read-only investig
88
88
  preflight check in this section.
89
89
 
90
90
  Prepare two research assignments. Give each research subagent one assignment. Tell it to run
91
- `npx --yes copilotkit@4.9.17 onboard read subagent/inspect-repository` first and follow the
91
+ `npx --yes copilotkit@4.9.24 onboard read subagent/inspect-repository` first and follow the
92
92
  prompt it returns. If that read fails because the subagent cannot use the shell, stop that
93
93
  subagent. Run the same command yourself, then spawn a fresh subagent with the returned prompt
94
94
  and the same handoff. Require only its assigned packet.
@@ -171,7 +171,7 @@ both workers return the same one target app directory. Both results must start w
171
171
  Before you route on, run this from the target app directory:
172
172
 
173
173
  ```text
174
- npx --yes copilotkit@4.9.17 onboard protect
174
+ npx --yes copilotkit@4.9.24 onboard protect
175
175
  ```
176
176
 
177
177
  It reads the working tree itself, records every changed or untracked path with a digest,
@@ -213,7 +213,7 @@ settle these three from your own reading of the project. Each one comes from the
213
213
  packets or it is not proved.
214
214
 
215
215
  If all three are proved, prove the live starting state before any project file changes. Run
216
- `npx --yes copilotkit@4.9.17 onboard read proof/oss-baseline`.
216
+ `npx --yes copilotkit@4.9.24 onboard read proof/oss-baseline`.
217
217
 
218
218
  Route there before you ask the developer anything else. The questions after this prompt
219
219
  select a framework and a frontend that the findings already name, so a developer who
@@ -226,10 +226,10 @@ developer nor the repository findings prove what the project is for, ask one gui
226
226
  question about the user outcome. This asks what the developer wants to build before you
227
227
  select a framework. Give two or three short examples and offer a minimal starter. Record
228
228
  the answer and give it to each later subagent. Then run
229
- `npx --yes copilotkit@4.9.17 onboard read credentials/plan`.
229
+ `npx --yes copilotkit@4.9.24 onboard read credentials/plan`.
230
230
 
231
231
  Do not ask that question on the route above. A project carrying all three states its
232
232
  purpose in the application it already serves.
233
233
 
234
234
  If authentication or inspection stops onboarding, run
235
- `npx --yes copilotkit@4.9.17 onboard read unsupported/no-validated-path`.
235
+ `npx --yes copilotkit@4.9.24 onboard read unsupported/no-validated-path`.
@@ -52,9 +52,9 @@ Then select the drawer page for the frontend the baseline found:
52
52
  1. React SPA or Next.js: https://docs.copilotkit.ai/prebuilt-components/copilot-threads-drawer.md
53
53
  2. Angular: https://docs.copilotkit.ai/angular/guides/threads-memory-attachments-headless.md
54
54
  3. Vue 3: https://docs.copilotkit.ai/vue/guides/threads-and-drawer.md
55
- 4. React Native: select no drawer page, and select the managed Intelligence dashboard as
56
- the proof surface instead. No page documents a threads drawer for React Native, and
57
- `@copilotkit/react-native` ships no thread components. The closing prompt gives a
55
+ 4. React Native: select no drawer page. No page documents a threads drawer for React
56
+ Native, and `@copilotkit/react-native` ships no thread components, so the fifth
57
+ criterion below is proved on the command line instead. The closing prompt gives a
58
58
  mobile developer a different debugging surface for the same reason.
59
59
 
60
60
  The next prompt adds the runtime pages and fetches everything in one pass, so do not fetch
@@ -86,18 +86,28 @@ steps unchanged. This conversion succeeded when all five are true:
86
86
  5. A thread for that request is persisted and visible to the developer.
87
87
 
88
88
  The drawer is what makes the fifth item something the developer can see. Before the
89
- conversion it renders its locked state, because it reads the license context and this
90
- project has none. After it, it lists the thread the proven request created. That before and
91
- after is the conversion's whole user-visible result, and it is why a conversion that only
92
- passes the command-line checks is worth less to the developer than one that does not.
89
+ conversion it lists nothing, because it reads the entitlement the runtime reports and an
90
+ OSS runtime reports none. After it, it lists the thread the proven request created. That
91
+ before and after is the conversion's whole user-visible result, and it is why a conversion
92
+ that only passes the command-line checks is worth less to the developer than one that does
93
+ not.
94
+
95
+ A managed Intelligence project needs no license token. The entitlement the drawer reads
96
+ comes from the project API key this run already configured, resolved by the runtime
97
+ against the managed platform. Minting a token with `copilotkit license create` is not part
98
+ of this journey, and a drawer that lists nothing is not a reason to mint one. License
99
+ tokens stay a self-hosted concern.
93
100
 
94
101
  Where this journey's frontend framework ships no threads drawer -- React Native --, the
95
- fifth item is proved in the managed Intelligence dashboard instead, and the run says which
96
- of the two it proved.
102
+ fifth item is proved by `npx --yes copilotkit@4.9.24 verify --round-trip`, which sends a
103
+ real request and reads the answer back off the thread it landed on. The run says which of
104
+ the two it proved. Do not send a run to the managed Intelligence dashboard to prove this.
105
+ An authenticated browser session at a hosted dashboard is the one thing an agent-driven run
106
+ cannot produce, so a criterion that asks for one can never be met on this route.
97
107
 
98
108
  Record this criterion as `conversion-v1` for the run report.
99
109
 
100
- Then run `npx --yes copilotkit@4.9.17 onboard read credentials/finalize-plan`.
110
+ Then run `npx --yes copilotkit@4.9.24 onboard read credentials/finalize-plan`.
101
111
 
102
112
  If a selected page does not load after the second method, run
103
- `npx --yes copilotkit@4.9.17 onboard read unsupported/no-validated-path`.
113
+ `npx --yes copilotkit@4.9.24 onboard read unsupported/no-validated-path`.
@@ -22,7 +22,7 @@ one short report before you stop. Run the feedback command without another devel
22
22
  question. The CLI telemetry gate decides whether the report is sent.
23
23
 
24
24
  ```text
25
- npx --yes copilotkit@4.9.17 onboard feedback
25
+ npx --yes copilotkit@4.9.24 onboard feedback
26
26
  ```
27
27
 
28
28
  Write at most four lines to standard input: the step you stopped at and what stopped it.
@@ -45,7 +45,7 @@ starts. Choose one starting state: empty, agent-only, frontend-only, both, both-
45
45
  Run this command with the exact selected slugs:
46
46
 
47
47
  ```text
48
- npx --yes copilotkit@4.9.17 onboard classify --starting-state <starting-state> --agent-framework <agent-framework> --frontend <frontend>
48
+ npx --yes copilotkit@4.9.24 onboard classify --starting-state <starting-state> --agent-framework <agent-framework> --frontend <frontend>
49
49
  ```
50
50
 
51
51
  Do not continue if a value is refused. Fix the value from the choices that the earlier
@@ -57,36 +57,45 @@ Use the target app or runtime directory from the repository findings. If a neste
57
57
  the runtime `.env` file, do not default to the repository root.
58
58
  Set the environment path to `<target>/.env`.
59
59
 
60
- If valid project fields and a non-empty `CPK_INTELLIGENCE_API_KEY` already exist, use this
61
- rule: Reuse that project without another question. Do not mint another key. The round-trip
62
- proof later runs the authenticated Intelligence checks. Record the reused project
63
- credentials as unverified in the plan until those checks pass.
64
- If you reuse a project, set the project-record path to the exact evidence path from the
65
- project research subagent.
60
+ Every credential this run writes goes to the environment path. That covers the project
61
+ key, the model credential, and a license token. Do not write a credential to `.env.local`,
62
+ or to any second env file beside it. A project ignore file usually covers `.env` and not
63
+ `.env.local`, so a credential written there is untracked, visible, and added by the first
64
+ `git add -A`. And a second env file beside `.env` outranks it when a key is read back, so
65
+ the value the run depends on is the one it did not write.
66
66
 
67
- If the developer needs a project or another project, do the selection yourself from the
68
- target directory. Do not send the developer to another terminal.
67
+ ### Prove the environment path is ignored
69
68
 
70
- Read the choices first:
69
+ Do this before the first credential is written. Ask git whether it ignores the environment
70
+ path, from the repository the path lives in:
71
71
 
72
72
  ```text
73
- npx --yes copilotkit@4.9.17 project list --json
73
+ git check-ignore -q <environment path>
74
74
  ```
75
75
 
76
- With `--json` the payload is the only thing on standard output, so it is safe to parse.
77
- Show the current selection and the five most recent projects. Sort recency by `createdAt`.
78
- Offer search, create-new, and list-all options. Do not show every project unless the
79
- developer asks.
76
+ Ask git rather than reading `.gitignore`. The answer also comes from a parent ignore file,
77
+ a global excludes file, or a pattern the developer already has, and reading one file gets
78
+ each of those wrong.
80
79
 
81
- If the developer searches, run:
80
+ Exit zero means git ignores the path and nothing more is needed. Exit one means git tracks
81
+ the path, and the credential this run is about to write lands in the first commit. Add the
82
+ missing pattern to the ignore file the developer already keeps, and list that edit in the
83
+ plan with every other file change. Any other exit means there is no work tree here to
84
+ protect. Say so once and carry on.
82
85
 
83
- ```text
84
- npx --yes copilotkit@4.9.17 project list --search <query> --json
85
- ```
86
+ If the path cannot be made ignored, stop onboarding and report it. Do not write the
87
+ credential and leave the problem in the closing report. A developer who commits before
88
+ reading the last screen has already published the token.
86
89
 
87
- If the developer asks for all projects, show the result of the first list command. Ask
88
- which project to use, or ask for a new project name. Do not combine this question with a
89
- frontend, framework, model, credential, or plan-approval question.
90
+ If valid project fields and a non-empty `CPK_INTELLIGENCE_API_KEY` already exist, use this
91
+ rule: Reuse that project without another question. Do not mint another key. The round-trip
92
+ proof later runs the authenticated Intelligence checks. Record the reused project
93
+ credentials as unverified in the plan until those checks pass.
94
+ If you reuse a project, set the project-record path to the exact evidence path from the
95
+ project research subagent.
96
+
97
+ If the developer needs a project, do the work yourself from the target directory.
98
+ Do not send the developer to another terminal.
90
99
 
91
100
  Project selection writes the environment path. It updates the nearest project record from
92
101
  the target through the repository root. If no project record exists there, it writes one at
@@ -98,15 +107,67 @@ findings. Compare that path and the environment path with the initial protected
98
107
  the path-segment overlap rule. If either output path overlaps an initial protected path, do
99
108
  not run project selection. Report the conflicting path and stop onboarding.
100
109
 
101
- Then record their answer, from the target directory:
110
+ ### Create a project for this directory
111
+
112
+ No project is bound to this directory, so creating a project for this directory is the
113
+ default. Take the name from the directory that holds the expected project-record path. If
114
+ that directory name is generic -- `project`, `app`, `apps`, `src`, `web`, `frontend`,
115
+ `backend`, `server`, `packages`, `repo` -- use the nearest enclosing directory whose name
116
+ is not. A generic name tells the developer nothing later, and every run that derives it
117
+ collides on it.
118
+
119
+ Ask one question: confirm that name, give another, or ask to use a project they already
120
+ have. Name that third answer, so a developer who has one is not asked to guess
121
+ that it is available. Do not list the organization's projects as part of the question: a
122
+ menu of projects is what bound one onboarding to another one's project, and a developer who
123
+ wants theirs will say so. If they ask for an existing project, take the branch below.
124
+
125
+ Do not combine this question with a frontend, framework, model, credential, or
126
+ plan-approval question. If no developer answers, create with the derived name. Never select
127
+ a project from a listing without an answer that names it. A project another run created
128
+ minutes ago reads exactly like this directory's own, and every check after the selection
129
+ passes against the wrong one.
130
+
131
+ Create it, from the target directory:
132
+
133
+ ```text
134
+ npx --yes copilotkit@4.9.24 project select --create <name> --json
135
+ ```
136
+
137
+ If the command fails as a duplicate, the organization already holds that display name and
138
+ the refusal names the colliding slug. Do not select the colliding project. Ask whether that
139
+ project is this app's. If no developer answers, run the command again with the next free
140
+ `-2`, `-3` suffix on the name.
141
+
142
+ ### Select an existing project instead
143
+
144
+ Take this branch only when the developer asks for an existing project, or asks to see the
145
+ projects they have. Read the choices:
146
+
147
+ ```text
148
+ npx --yes copilotkit@4.9.24 project list --json
149
+ ```
150
+
151
+ Narrow them:
152
+
153
+ ```text
154
+ npx --yes copilotkit@4.9.24 project list --search <query> --json
155
+ ```
156
+
157
+ With `--json` the payload is the only thing on standard output, so it is safe to parse. Do
158
+ not run either list command unless the developer asks. Show what they asked for and nothing
159
+ more. Do not order the projects by creation time: the newest project in the organization is
160
+ the one another run created while this one was working, and it is the least likely to be
161
+ this directory's.
162
+
163
+ Then record the project they name, from the target directory:
102
164
 
103
165
  ```text
104
- npx --yes copilotkit@4.9.17 project select --project <slug-or-id> --json
166
+ npx --yes copilotkit@4.9.24 project select --project <slug-or-id> --json
105
167
  ```
106
168
 
107
- Use `--create <name> --json` instead when they want a new project. The two flags cannot be
108
- combined. A slug that does not exist fails and lists the real ones, so a typo cannot record
109
- a selection that points at nothing.
169
+ The two flags cannot be combined. A slug that does not exist fails and lists the real ones,
170
+ so a typo cannot record a selection that points at nothing.
110
171
 
111
172
  Read the JSON result. It reports `selected_project_slug`, `config_path`,
112
173
  `api_key_provisioned`, `project_file_written`, and `environment_file_written` at the top
@@ -162,7 +223,7 @@ protected path list. Also add each project file that the developer changed for m
162
223
  credentials. Record them in the baseline from the target app directory:
163
224
 
164
225
  ```text
165
- npx --yes copilotkit@4.9.17 onboard protect --path <path>
226
+ npx --yes copilotkit@4.9.24 onboard protect --path <path>
166
227
  ```
167
228
 
168
229
  Pass one `--path` for each. The command captures a digest for each path and never re-reads
@@ -172,7 +233,7 @@ Then re-capture the files this graph wrote itself. For each path the first captu
172
233
  as `deferred` that this run has now written, run:
173
234
 
174
235
  ```text
175
- npx --yes copilotkit@4.9.17 onboard protect --rebaseline --path <path>
236
+ npx --yes copilotkit@4.9.24 onboard protect --rebaseline --path <path>
176
237
  ```
177
238
 
178
239
  From that point they are protected like any other path, so a later step that rewrites
@@ -196,7 +257,7 @@ proof subagents:
196
257
  Fetch them together with the pages already selected rather than on their own.
197
258
 
198
259
  Spawn one planning subagent. Tell it to run
199
- `npx --yes copilotkit@4.9.17 onboard read subagent/create-plan` first and follow the prompt
260
+ `npx --yes copilotkit@4.9.24 onboard read subagent/create-plan` first and follow the prompt
200
261
  it returns. If that read fails because the subagent cannot use the shell, stop that subagent.
201
262
  Run the same command yourself, then spawn a fresh subagent with the returned prompt and the
202
263
  same handoff. Give it the repository findings, selected framework, frontend, model, credential
@@ -215,14 +276,14 @@ for, implementation steps, validation steps, and proof steps. Where the plan upg
215
276
  CopilotKit dependencies, it must name the versions it moves and the revert it falls back
216
277
  to. It must not contain secret values.
217
278
 
218
- Show only the selected framework, frontend, model, planned file changes, the CopilotKit dependency upgrade and the versions it moves, validation commands, and proof steps.
279
+ Show only the selected framework, frontend, model, planned file changes, any ignore-file line this run adds, the CopilotKit dependency upgrade and the versions it moves, validation commands, and proof steps.
219
280
 
220
281
  An upgrade to a working install is the developer's call, so it belongs in the plan they
221
282
  approve rather than in the implementation that follows. Do not upgrade a dependency the
222
283
  developer did not approve.
223
284
 
224
285
  If the developer approves the plan, run
225
- `npx --yes copilotkit@4.9.17 onboard read implementation/build-and-validate`.
286
+ `npx --yes copilotkit@4.9.24 onboard read implementation/build-and-validate`.
226
287
 
227
288
  If no exact supported path or documentation URL exists, run
228
- `npx --yes copilotkit@4.9.17 onboard read unsupported/no-validated-path`.
289
+ `npx --yes copilotkit@4.9.24 onboard read unsupported/no-validated-path`.
@@ -68,26 +68,26 @@ another framework. Do not show the internal route.
68
68
 
69
69
  Use exactly one matching internal route:
70
70
 
71
- 1. AG2: `npx --yes copilotkit@4.9.17 onboard read framework/ag2`
72
- 2. Agno: `npx --yes copilotkit@4.9.17 onboard read framework/agno`
73
- 3. Built-in CopilotKit agent: `npx --yes copilotkit@4.9.17 onboard read framework/built-in`
74
- 4. Claude Agent SDK Python: `npx --yes copilotkit@4.9.17 onboard read framework/claude-sdk-python`
75
- 5. Claude Agent SDK TypeScript: `npx --yes copilotkit@4.9.17 onboard read framework/claude-sdk-typescript`
76
- 6. CrewAI Flows: `npx --yes copilotkit@4.9.17 onboard read framework/crewai-flows`
77
- 7. Deep Agents: `npx --yes copilotkit@4.9.17 onboard read framework/deep-agents`
78
- 8. LangGraph Python: `npx --yes copilotkit@4.9.17 onboard read framework/langgraph-python`
79
- 9. LangGraph FastAPI: `npx --yes copilotkit@4.9.17 onboard read framework/langgraph-fastapi`
80
- 10. LangGraph TypeScript: `npx --yes copilotkit@4.9.17 onboard read framework/langgraph-typescript`
81
- 11. LlamaIndex: `npx --yes copilotkit@4.9.17 onboard read framework/llamaindex`
82
- 12. ADK: `npx --yes copilotkit@4.9.17 onboard read framework/google-adk`
83
- 13. Microsoft Agent Framework Python: `npx --yes copilotkit@4.9.17 onboard read framework/ms-agent-python`
84
- 14. Microsoft Agent Framework .NET: `npx --yes copilotkit@4.9.17 onboard read framework/ms-agent-dotnet`
85
- 15. Mastra: `npx --yes copilotkit@4.9.17 onboard read framework/mastra`
86
- 16. MS Agent Harness .NET: `npx --yes copilotkit@4.9.17 onboard read framework/ms-agent-harness-dotnet`
87
- 17. Pydantic AI: `npx --yes copilotkit@4.9.17 onboard read framework/pydantic-ai`
88
- 18. Strands Agents Python: `npx --yes copilotkit@4.9.17 onboard read framework/strands-python`
89
- 19. Strands Agents TypeScript: `npx --yes copilotkit@4.9.17 onboard read framework/strands-typescript`
71
+ 1. AG2: `npx --yes copilotkit@4.9.24 onboard read framework/ag2`
72
+ 2. Agno: `npx --yes copilotkit@4.9.24 onboard read framework/agno`
73
+ 3. Built-in CopilotKit agent: `npx --yes copilotkit@4.9.24 onboard read framework/built-in`
74
+ 4. Claude Agent SDK Python: `npx --yes copilotkit@4.9.24 onboard read framework/claude-sdk-python`
75
+ 5. Claude Agent SDK TypeScript: `npx --yes copilotkit@4.9.24 onboard read framework/claude-sdk-typescript`
76
+ 6. CrewAI Flows: `npx --yes copilotkit@4.9.24 onboard read framework/crewai-flows`
77
+ 7. Deep Agents: `npx --yes copilotkit@4.9.24 onboard read framework/deep-agents`
78
+ 8. LangGraph Python: `npx --yes copilotkit@4.9.24 onboard read framework/langgraph-python`
79
+ 9. LangGraph FastAPI: `npx --yes copilotkit@4.9.24 onboard read framework/langgraph-fastapi`
80
+ 10. LangGraph TypeScript: `npx --yes copilotkit@4.9.24 onboard read framework/langgraph-typescript`
81
+ 11. LlamaIndex: `npx --yes copilotkit@4.9.24 onboard read framework/llamaindex`
82
+ 12. ADK: `npx --yes copilotkit@4.9.24 onboard read framework/google-adk`
83
+ 13. Microsoft Agent Framework Python: `npx --yes copilotkit@4.9.24 onboard read framework/ms-agent-python`
84
+ 14. Microsoft Agent Framework .NET: `npx --yes copilotkit@4.9.24 onboard read framework/ms-agent-dotnet`
85
+ 15. Mastra: `npx --yes copilotkit@4.9.24 onboard read framework/mastra`
86
+ 16. MS Agent Harness .NET: `npx --yes copilotkit@4.9.24 onboard read framework/ms-agent-harness-dotnet`
87
+ 17. Pydantic AI: `npx --yes copilotkit@4.9.24 onboard read framework/pydantic-ai`
88
+ 18. Strands Agents Python: `npx --yes copilotkit@4.9.24 onboard read framework/strands-python`
89
+ 19. Strands Agents TypeScript: `npx --yes copilotkit@4.9.24 onboard read framework/strands-typescript`
90
90
 
91
91
  If the project has an agent in another framework, or no listed framework fits, keep the
92
92
  developer's current agent and run
93
- `npx --yes copilotkit@4.9.17 onboard read unsupported/no-validated-path`.
93
+ `npx --yes copilotkit@4.9.24 onboard read unsupported/no-validated-path`.
@@ -14,7 +14,7 @@ command without another developer question. The CLI telemetry gate decides wheth
14
14
  report is sent.
15
15
 
16
16
  ```text
17
- npx --yes copilotkit@4.9.17 onboard feedback
17
+ npx --yes copilotkit@4.9.24 onboard feedback
18
18
  ```
19
19
 
20
20
  Write at most four lines to standard input: the step you stopped at and what stopped it.
@@ -55,7 +55,7 @@ stop.
55
55
 
56
56
  Use these rules for every protected-path check in this fallback:
57
57
 
58
- - Run `npx --yes copilotkit@4.9.17 onboard audit` from the target app directory.
58
+ - Run `npx --yes copilotkit@4.9.24 onboard audit` from the target app directory.
59
59
  - If a result starts with `Status: blocked`, stop onboarding and report the printed reason.
60
60
  It proved nothing changed, so do not report a preservation failure.
61
61
  - If a result reports a changed protected path, stop onboarding.
@@ -107,13 +107,13 @@ application passes proof. Report each tool result separately from the proof resu
107
107
  Report the documentation gap and each assumption with the proof evidence. Do not claim
108
108
  that the selected documentation proved an inferred step.
109
109
 
110
- When the proof is complete, run `npx --yes copilotkit@4.9.17 onboard complete`, carrying the
110
+ When the proof is complete, run `npx --yes copilotkit@4.9.24 onboard complete`, carrying the
111
111
  surface-check result the proof subagent returned. Pass exactly one flag, matching this
112
112
  journey's surface:
113
113
 
114
114
  ```text
115
- npx --yes copilotkit@4.9.17 onboard complete --visual-check <outcome>
116
- npx --yes copilotkit@4.9.17 onboard complete --device-check <outcome>
115
+ npx --yes copilotkit@4.9.24 onboard complete --visual-check <outcome>
116
+ npx --yes copilotkit@4.9.24 onboard complete --device-check <outcome>
117
117
  ```
118
118
 
119
119
  `--visual-check` is for a web frontend and takes `performed`, `skipped-no-browser-tool`, or
@@ -122,6 +122,7 @@ or `failed`. Anything but `performed` ends this run as blocked, and the command'
122
122
  names the evidence that is missing. Report it that way.
123
123
 
124
124
  If the proof passed and something after it still blocked this run, add
125
- `--blocked-by <cause>` to the same command, with one of `hosted-dashboard`, `inspector`,
126
- `plan-excluded-capability`, or `other`. It ends the run as blocked and names what the
127
- blocker leaves unverified.
125
+ `--blocked-by <cause>` to the same command, with one of `inspector`, `plan-excluded-capability`,
126
+ or `other`. It ends the run as blocked and names what the blocker leaves unverified. The
127
+ managed Intelligence dashboard is not a cause, because nothing in this graph asks a run to
128
+ open it.
@@ -31,7 +31,7 @@ Record the selected framework, vendor, model, required credential variable names
31
31
  URLs, and the A2UI documentation gap.
32
32
 
33
33
  If the pages support the selection, run
34
- `npx --yes copilotkit@4.9.17 onboard read frontend/plan`.
34
+ `npx --yes copilotkit@4.9.24 onboard read frontend/plan`.
35
35
 
36
36
  If the documentation does not support the selection, run
37
- `npx --yes copilotkit@4.9.17 onboard read unsupported/no-validated-path`.
37
+ `npx --yes copilotkit@4.9.24 onboard read unsupported/no-validated-path`.
@@ -34,7 +34,7 @@ Record the selected framework, vendor, model, required credential variable names
34
34
  URLs, the documented dependencies and adapter, and the context documentation gap.
35
35
 
36
36
  If the pages support the selection, run
37
- `npx --yes copilotkit@4.9.17 onboard read frontend/plan`.
37
+ `npx --yes copilotkit@4.9.24 onboard read frontend/plan`.
38
38
 
39
39
  If the documentation does not support the selection, run
40
- `npx --yes copilotkit@4.9.17 onboard read unsupported/no-validated-path`.
40
+ `npx --yes copilotkit@4.9.24 onboard read unsupported/no-validated-path`.
@@ -27,7 +27,7 @@ Record the selected framework, vendor, model, required credential variable names
27
27
  these URLs.
28
28
 
29
29
  If the pages support the selection, run
30
- `npx --yes copilotkit@4.9.17 onboard read frontend/plan`.
30
+ `npx --yes copilotkit@4.9.24 onboard read frontend/plan`.
31
31
 
32
32
  If the documentation does not support the selection, run
33
- `npx --yes copilotkit@4.9.17 onboard read unsupported/no-validated-path`.
33
+ `npx --yes copilotkit@4.9.24 onboard read unsupported/no-validated-path`.
@@ -33,7 +33,7 @@ Record the selected framework, vendor, model, required credential variable names
33
33
  URLs, and the context limit.
34
34
 
35
35
  If the pages support the selection, run
36
- `npx --yes copilotkit@4.9.17 onboard read frontend/plan`.
36
+ `npx --yes copilotkit@4.9.24 onboard read frontend/plan`.
37
37
 
38
38
  If the documentation does not support the selection, run
39
- `npx --yes copilotkit@4.9.17 onboard read unsupported/no-validated-path`.
39
+ `npx --yes copilotkit@4.9.24 onboard read unsupported/no-validated-path`.
@@ -37,7 +37,7 @@ Record the selected framework, vendor, model, required credential variable names
37
37
  URLs, and the context limit.
38
38
 
39
39
  If the pages support the selection, run
40
- `npx --yes copilotkit@4.9.17 onboard read frontend/plan`.
40
+ `npx --yes copilotkit@4.9.24 onboard read frontend/plan`.
41
41
 
42
42
  If the documentation does not support the selection, run
43
- `npx --yes copilotkit@4.9.17 onboard read unsupported/no-validated-path`.
43
+ `npx --yes copilotkit@4.9.24 onboard read unsupported/no-validated-path`.
@@ -54,7 +54,7 @@ variable names the repository proves or the developer named, these URLs, the ada
54
54
  shared-state limit.
55
55
 
56
56
  If the pages support the selection, run
57
- `npx --yes copilotkit@4.9.17 onboard read frontend/plan`.
57
+ `npx --yes copilotkit@4.9.24 onboard read frontend/plan`.
58
58
 
59
59
  If the documentation does not support the selection, run
60
- `npx --yes copilotkit@4.9.17 onboard read unsupported/no-validated-path`.
60
+ `npx --yes copilotkit@4.9.24 onboard read unsupported/no-validated-path`.
@@ -29,7 +29,7 @@ Record the selected framework, language, vendor, model, required credential vari
29
29
  names, these URLs, and each documentation gap.
30
30
 
31
31
  If the pages support the selection, run
32
- `npx --yes copilotkit@4.9.17 onboard read frontend/plan`.
32
+ `npx --yes copilotkit@4.9.24 onboard read frontend/plan`.
33
33
 
34
34
  If the documentation does not support the selection, run
35
- `npx --yes copilotkit@4.9.17 onboard read unsupported/no-validated-path`.
35
+ `npx --yes copilotkit@4.9.24 onboard read unsupported/no-validated-path`.
@@ -28,7 +28,7 @@ Record the selected framework, vendor, model, required credential variable names
28
28
  these URLs.
29
29
 
30
30
  If the pages support the selection, run
31
- `npx --yes copilotkit@4.9.17 onboard read frontend/plan`.
31
+ `npx --yes copilotkit@4.9.24 onboard read frontend/plan`.
32
32
 
33
33
  If the documentation does not support the selection, run
34
- `npx --yes copilotkit@4.9.17 onboard read unsupported/no-validated-path`.
34
+ `npx --yes copilotkit@4.9.24 onboard read unsupported/no-validated-path`.
@@ -24,7 +24,7 @@ Record the selected framework, vendor, model, required credential variable names
24
24
  these URLs.
25
25
 
26
26
  If the pages support the selection, run
27
- `npx --yes copilotkit@4.9.17 onboard read frontend/plan`.
27
+ `npx --yes copilotkit@4.9.24 onboard read frontend/plan`.
28
28
 
29
29
  If the documentation does not support the selection, run
30
- `npx --yes copilotkit@4.9.17 onboard read unsupported/no-validated-path`.
30
+ `npx --yes copilotkit@4.9.24 onboard read unsupported/no-validated-path`.
@@ -15,7 +15,7 @@ Record the selected framework, vendor, model, required credential variable names
15
15
  these URLs.
16
16
 
17
17
  If the pages support the selection, run
18
- `npx --yes copilotkit@4.9.17 onboard read frontend/plan`.
18
+ `npx --yes copilotkit@4.9.24 onboard read frontend/plan`.
19
19
 
20
20
  If the documentation does not support the selection, run
21
- `npx --yes copilotkit@4.9.17 onboard read unsupported/no-validated-path`.
21
+ `npx --yes copilotkit@4.9.24 onboard read unsupported/no-validated-path`.
@@ -15,7 +15,7 @@ Record the selected framework, vendor, model, required credential variable names
15
15
  these URLs.
16
16
 
17
17
  If the pages support the selection, run
18
- `npx --yes copilotkit@4.9.17 onboard read frontend/plan`.
18
+ `npx --yes copilotkit@4.9.24 onboard read frontend/plan`.
19
19
 
20
20
  If the documentation does not support the selection, run
21
- `npx --yes copilotkit@4.9.17 onboard read unsupported/no-validated-path`.
21
+ `npx --yes copilotkit@4.9.24 onboard read unsupported/no-validated-path`.
@@ -34,7 +34,7 @@ Record the selected framework, vendor, model, required credential variable names
34
34
  URLs, the documented dependencies and adapter, and both documentation limits.
35
35
 
36
36
  If the pages support the selection, run
37
- `npx --yes copilotkit@4.9.17 onboard read frontend/plan`.
37
+ `npx --yes copilotkit@4.9.24 onboard read frontend/plan`.
38
38
 
39
39
  If the documentation does not support the selection, run
40
- `npx --yes copilotkit@4.9.17 onboard read unsupported/no-validated-path`.
40
+ `npx --yes copilotkit@4.9.24 onboard read unsupported/no-validated-path`.
@@ -45,7 +45,7 @@ Record the selected framework, vendor, model, required credential variable names
45
45
  these URLs.
46
46
 
47
47
  If the pages support the selection, run
48
- `npx --yes copilotkit@4.9.17 onboard read frontend/plan`.
48
+ `npx --yes copilotkit@4.9.24 onboard read frontend/plan`.
49
49
 
50
50
  If the documentation does not support the selection, run
51
- `npx --yes copilotkit@4.9.17 onboard read unsupported/no-validated-path`.
51
+ `npx --yes copilotkit@4.9.24 onboard read unsupported/no-validated-path`.
@@ -34,7 +34,7 @@ Record the selected framework, provider, model, required credential variable nam
34
34
  these URLs.
35
35
 
36
36
  If the pages support the selection, run
37
- `npx --yes copilotkit@4.9.17 onboard read frontend/plan`.
37
+ `npx --yes copilotkit@4.9.24 onboard read frontend/plan`.
38
38
 
39
39
  If the documentation does not support the selection, run
40
- `npx --yes copilotkit@4.9.17 onboard read unsupported/no-validated-path`.
40
+ `npx --yes copilotkit@4.9.24 onboard read unsupported/no-validated-path`.
@@ -44,7 +44,7 @@ Record the selected framework, provider, model, required credential variable nam
44
44
  URLs, and the quickstart gap.
45
45
 
46
46
  If the pages support the selection, run
47
- `npx --yes copilotkit@4.9.17 onboard read frontend/plan`.
47
+ `npx --yes copilotkit@4.9.24 onboard read frontend/plan`.
48
48
 
49
49
  If the documentation does not support the selection, run
50
- `npx --yes copilotkit@4.9.17 onboard read unsupported/no-validated-path`.
50
+ `npx --yes copilotkit@4.9.24 onboard read unsupported/no-validated-path`.
@@ -28,7 +28,7 @@ Record the selected framework, vendor, model, required credential variable names
28
28
  these URLs.
29
29
 
30
30
  If the pages support the selection, run
31
- `npx --yes copilotkit@4.9.17 onboard read frontend/plan`.
31
+ `npx --yes copilotkit@4.9.24 onboard read frontend/plan`.
32
32
 
33
33
  If the documentation does not support the selection, run
34
- `npx --yes copilotkit@4.9.17 onboard read unsupported/no-validated-path`.
34
+ `npx --yes copilotkit@4.9.24 onboard read unsupported/no-validated-path`.
@@ -19,7 +19,7 @@ documented backend set with
19
19
  `uv add 'pydantic-ai-slim[ag-ui,openai]>=2,<3' 'starlette>=0.46.2' uvicorn`.
20
20
  Keep the Starlette endpoint that calls `AGUIAdapter.dispatch_request`, unless the app
21
21
  context route below replaces it with the two-step form. Register it in Copilot Runtime
22
- with `HttpAgent` and keep `InMemoryAgentRunner` for the documented local OSS setup. Do not replace this transport with a different Pydantic AI adapter.
22
+ with `HttpAgent`. Do not replace this transport with a different Pydantic AI adapter.
23
23
 
24
24
  A2UI is not on this path. If the developer asks for it, say first that the documented
25
25
  Python setup does not support `action_handlers` on `a2ui.render`, so its button callback
@@ -43,7 +43,7 @@ Record the selected framework, vendor, model, required credential variable names
43
43
  URLs, and the two-step context route.
44
44
 
45
45
  If the pages support the selection, run
46
- `npx --yes copilotkit@4.9.17 onboard read frontend/plan`.
46
+ `npx --yes copilotkit@4.9.24 onboard read frontend/plan`.
47
47
 
48
48
  If the documentation does not support the selection, run
49
- `npx --yes copilotkit@4.9.17 onboard read unsupported/no-validated-path`.
49
+ `npx --yes copilotkit@4.9.24 onboard read unsupported/no-validated-path`.