copilotkit 4.9.1 → 4.9.2

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 (45) hide show
  1. package/cli-build-info.json +7 -7
  2. package/index.js +21 -5
  3. package/onboarding/index.json +10 -0
  4. package/onboarding/prompts/authenticate/start.md +10 -4
  5. package/onboarding/prompts/credentials/finalize-plan.md +36 -13
  6. package/onboarding/prompts/credentials/plan.md +20 -20
  7. package/onboarding/prompts/fallback/best-effort.md +3 -3
  8. package/onboarding/prompts/framework/ag2.md +2 -2
  9. package/onboarding/prompts/framework/agno.md +2 -2
  10. package/onboarding/prompts/framework/built-in.md +2 -2
  11. package/onboarding/prompts/framework/claude-sdk-python.md +2 -2
  12. package/onboarding/prompts/framework/claude-sdk-typescript.md +2 -2
  13. package/onboarding/prompts/framework/crewai-flows.md +2 -2
  14. package/onboarding/prompts/framework/deep-agents.md +2 -2
  15. package/onboarding/prompts/framework/google-adk.md +2 -2
  16. package/onboarding/prompts/framework/langgraph-fastapi.md +2 -2
  17. package/onboarding/prompts/framework/langgraph-python.md +2 -2
  18. package/onboarding/prompts/framework/langgraph-typescript.md +2 -2
  19. package/onboarding/prompts/framework/llamaindex.md +2 -2
  20. package/onboarding/prompts/framework/mastra.md +2 -2
  21. package/onboarding/prompts/framework/ms-agent-dotnet.md +2 -2
  22. package/onboarding/prompts/framework/ms-agent-harness-dotnet.md +2 -2
  23. package/onboarding/prompts/framework/ms-agent-python.md +2 -2
  24. package/onboarding/prompts/framework/pydantic-ai.md +2 -2
  25. package/onboarding/prompts/framework/strands-python.md +2 -2
  26. package/onboarding/prompts/framework/strands-typescript.md +2 -2
  27. package/onboarding/prompts/frontend/angular.md +7 -2
  28. package/onboarding/prompts/frontend/nextjs.md +17 -2
  29. package/onboarding/prompts/frontend/plan.md +6 -6
  30. package/onboarding/prompts/frontend/react-native.md +2 -2
  31. package/onboarding/prompts/frontend/react-spa.md +2 -2
  32. package/onboarding/prompts/frontend/vue.md +2 -2
  33. package/onboarding/prompts/implementation/build-and-validate.md +19 -4
  34. package/onboarding/prompts/proof/complete.md +15 -5
  35. package/onboarding/prompts/proof/oss-baseline.md +3 -3
  36. package/onboarding/prompts/proof/round-trip.md +183 -63
  37. package/onboarding/prompts/starter/clone.md +67 -0
  38. package/onboarding/prompts/subagent/create-plan.md +22 -4
  39. package/onboarding/prompts/subagent/implement-and-validate.md +17 -2
  40. package/onboarding/prompts/subagent/inspect-repository.md +5 -0
  41. package/onboarding/prompts/subagent/prove-oss-baseline.md +1 -1
  42. package/onboarding/prompts/subagent/prove-round-trip.md +175 -61
  43. package/onboarding/prompts/unsupported/no-validated-path.md +2 -2
  44. package/package.json +1 -1
  45. package/release/release-tool.js +15 -1
@@ -2,20 +2,20 @@
2
2
  "schemaVersion": 1,
3
3
  "package": {
4
4
  "name": "copilotkit",
5
- "version": "4.9.1"
5
+ "version": "4.9.2"
6
6
  },
7
7
  "intelligence": {
8
- "commit": "0528d9de0d7915386d789deb676d44c4668842b1"
8
+ "commit": "bc4cd3dc36cef218051ef6236acdef7033d2a7b0"
9
9
  },
10
10
  "copilotKit": {
11
- "submittedInput": "2ad03320fe1f0834b138113fffe791781e5b226e",
12
- "commit": "2ad03320fe1f0834b138113fffe791781e5b226e"
11
+ "submittedInput": "e432fd161b9114fb15080dbd9d9208e29f5e8960",
12
+ "commit": "e432fd161b9114fb15080dbd9d9208e29f5e8960"
13
13
  },
14
14
  "channel": "production",
15
15
  "triggeringActor": "MikeRyanDev",
16
16
  "workflow": {
17
- "runId": "32915219082",
18
- "runUrl": "https://github.com/CopilotKit/Intelligence/actions/runs/32915219082"
17
+ "runId": "33012065996",
18
+ "runUrl": "https://github.com/CopilotKit/Intelligence/actions/runs/33012065996"
19
19
  },
20
20
  "validationResult": "passed",
21
21
  "ag2": {
@@ -24,5 +24,5 @@
24
24
  "revision": "main",
25
25
  "pinned": false
26
26
  },
27
- "builtAt": "2026-08-26T00:29:57Z"
27
+ "builtAt": "2026-08-26T20:47:57Z"
28
28
  }
package/index.js CHANGED
@@ -96,14 +96,14 @@ function getTelemetryEndpointUrl() {
96
96
  }
97
97
  function getBuildInfo() {
98
98
  return {
99
- version: true ? "4.9.1" : "dev",
100
- buildNumber: true ? "32915219082" : "dev",
101
- commitSha: true ? "0528d9de0d7915386d789deb676d44c4668842b1" : "dev",
99
+ version: true ? "4.9.2" : "dev",
100
+ buildNumber: true ? "33012065996" : "dev",
101
+ commitSha: true ? "bc4cd3dc36cef218051ef6236acdef7033d2a7b0" : "dev",
102
102
  copilotKitCommit: getTemplateRef()
103
103
  };
104
104
  }
105
105
  function getTemplateRef() {
106
- return true ? "2ad03320fe1f0834b138113fffe791781e5b226e" : "main";
106
+ return true ? "e432fd161b9114fb15080dbd9d9208e29f5e8960" : "main";
107
107
  }
108
108
  function getC15tBackendUrl() {
109
109
  return true ? "https://calm-hazelnut-joy-copilotkit.inth.app" : "";
@@ -192,6 +192,9 @@ var init_starter_source_catalog = __esm({
192
192
  STARTER_SOURCE_CATALOG = {
193
193
  "langgraph-py": langGraphPython,
194
194
  "langgraph-js": copilotKitStarter("examples/integrations/langgraph-js"),
195
+ "langgraph-fastapi": copilotKitStarter(
196
+ "examples/integrations/langgraph-fastapi"
197
+ ),
195
198
  "claude-sdk-typescript": copilotKitStarter(
196
199
  "examples/integrations/claude-sdk-typescript"
197
200
  ),
@@ -412,6 +415,7 @@ function formatInvalidFrameworkError(value) {
412
415
  function standardTemplate(framework, template, successEmoji) {
413
416
  const pythonUvTemplates = /* @__PURE__ */ new Set([
414
417
  "langgraph-py",
418
+ "langgraph-fastapi",
415
419
  "claude-sdk-python",
416
420
  "flows",
417
421
  "llamaindex",
@@ -493,6 +497,7 @@ var init_types = __esm({
493
497
  FRAMEWORK_EMOJI = {
494
498
  "langgraph-py": "\u{1F99C}",
495
499
  "langgraph-js": "\u{1F99C}",
500
+ "langgraph-fastapi": "\u{1F99C}",
496
501
  "claude-sdk-typescript": "\u{1F506}",
497
502
  "claude-sdk-python": "\u{1F506}",
498
503
  flows: "\u{1F465}",
@@ -523,6 +528,10 @@ var init_types = __esm({
523
528
  label: `${FRAMEWORK_EMOJI["langgraph-js"]} LangGraph (JavaScript)`,
524
529
  value: "langgraph-js"
525
530
  },
531
+ {
532
+ label: `${FRAMEWORK_EMOJI["langgraph-fastapi"]} LangGraph (Python, FastAPI)`,
533
+ value: "langgraph-fastapi"
534
+ },
526
535
  {
527
536
  label: `${FRAMEWORK_EMOJI["claude-sdk-typescript"]} Claude Agent SDK (TypeScript)`,
528
537
  value: "claude-sdk-typescript"
@@ -636,6 +645,11 @@ var init_types = __esm({
636
645
  TEMPLATE_REPOS["langgraph-js"],
637
646
  `\u{1FA81}\u{1F91D}${FRAMEWORK_EMOJI["langgraph-js"]}`
638
647
  ),
648
+ "langgraph-fastapi": standardTemplate(
649
+ "langgraph-fastapi",
650
+ TEMPLATE_REPOS["langgraph-fastapi"],
651
+ `\u{1FA81}\u{1F91D}${FRAMEWORK_EMOJI["langgraph-fastapi"]}`
652
+ ),
639
653
  "claude-sdk-typescript": {
640
654
  ...standardTemplate(
641
655
  "claude-sdk-typescript",
@@ -810,6 +824,7 @@ var init_types = __esm({
810
824
  THREADS_FRAMEWORKS = /* @__PURE__ */ new Set([
811
825
  "langgraph-py",
812
826
  "langgraph-js",
827
+ "langgraph-fastapi",
813
828
  "claude-sdk-typescript",
814
829
  "claude-sdk-python",
815
830
  "mastra",
@@ -833,6 +848,7 @@ var init_types = __esm({
833
848
  FRAMEWORK_LANGUAGE = {
834
849
  "langgraph-py": "python",
835
850
  "langgraph-js": "typescript",
851
+ "langgraph-fastapi": "python",
836
852
  "claude-sdk-typescript": "typescript",
837
853
  "claude-sdk-python": "python",
838
854
  flows: "python",
@@ -93356,7 +93372,7 @@ var init_cli_tips = __esm({
93356
93372
  },
93357
93373
  {
93358
93374
  id: "server-debug-for-missing-events",
93359
- text: "Enable server `debug: true` when events, state, or tool calls disappear, then use the Inspector or `/cpk-debug-events` for live AG-UI details.",
93375
+ text: "Enable server `debug: true` when events, state, or tool calls disappear, then read live AG-UI details from the Inspector in a browser, or from the runtime's `/cpk-debug-events` route on any frontend.",
93360
93376
  relevancy: 82,
93361
93377
  insight: 90
93362
93378
  },
@@ -203,6 +203,7 @@
203
203
  },
204
204
  {
205
205
  "edges": [
206
+ "starter/clone",
206
207
  "credentials/finalize-plan",
207
208
  "unsupported/no-validated-path"
208
209
  ],
@@ -211,6 +212,7 @@
211
212
  },
212
213
  {
213
214
  "edges": [
215
+ "starter/clone",
214
216
  "credentials/finalize-plan",
215
217
  "unsupported/no-validated-path"
216
218
  ],
@@ -282,6 +284,14 @@
282
284
  "milestone": "proof",
283
285
  "name": "proof/round-trip"
284
286
  },
287
+ {
288
+ "edges": [
289
+ "proof/round-trip",
290
+ "unsupported/no-validated-path"
291
+ ],
292
+ "milestone": "starter",
293
+ "name": "starter/clone"
294
+ },
285
295
  {
286
296
  "edges": [],
287
297
  "milestone": "subagent",
@@ -23,7 +23,7 @@ integration, prove the full round trip, and leave the app running with its URLs.
23
23
  Do not ask for separate feedback consent. The feedback commands enforce the developer's
24
24
  CLI telemetry setting when a later step tries to send a report.
25
25
 
26
- Run `npx --yes copilotkit@4.9.1 login --json` before any project work. This command
26
+ Run `npx --yes copilotkit@4.9.2 login --json` before any project work. This command
27
27
  checks the current session. It starts sign-in only as needed. Treat this as a long-lived
28
28
  streaming process. Do not wait for the command to exit before you read its standard output.
29
29
 
@@ -53,6 +53,7 @@ prompt and tell it to follow that brief and return only its findings. Add these
53
53
  - Check whether `.copilotkit/project.json` has `projectId`, `projectSlug`, and `clerkOrgId`.
54
54
  - Check whether `.env` has a non-empty `INTELLIGENCE_API_KEY` entry.
55
55
  - Record the `.env` file modification time without returning it.
56
+ - Report whether the target project directory contains any entries.
56
57
  - Report whether an agent, frontend, and CopilotKit integration are present.
57
58
  - Report whether the runtime constructor uses a `runner` option, an `intelligence`
58
59
  option, or neither can be proved from project files.
@@ -75,13 +76,13 @@ that the repository answers.
75
76
  Do not infer a working OSS path from packages, imports, project files, or keys. If an
76
77
  agent, frontend, and CopilotKit integration are present, prove the live starting state
77
78
  before any project file changes. Run
78
- `npx --yes copilotkit@4.9.1 onboard read proof/oss-baseline`.
79
+ `npx --yes copilotkit@4.9.2 onboard read proof/oss-baseline`.
79
80
 
80
81
  For every other inspected state, run
81
- `npx --yes copilotkit@4.9.1 onboard read credentials/plan`.
82
+ `npx --yes copilotkit@4.9.2 onboard read credentials/plan`.
82
83
 
83
84
  If authentication or inspection stops onboarding, run
84
- `npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.
85
+ `npx --yes copilotkit@4.9.2 onboard read unsupported/no-validated-path`.
85
86
 
86
87
  ## Research subagent brief
87
88
 
@@ -104,6 +105,11 @@ Inspect the repository without changing it. Find evidence for:
104
105
  - declared ports and whether each port is available
105
106
  - CopilotKit package versions and package compatibility risks
106
107
 
108
+ For the CopilotKit versions, report the exact installed version of every `@copilotkit/*`
109
+ dependency, read from the lockfile rather than a manifest range, and state whether any of
110
+ them is below 1.64.0. The conversion decides its upgrade from exactly that, and a caret
111
+ range does not answer it.
112
+
107
113
  A project states what it is for in its `README.md`, in its package description, or in
108
114
  the prompt of an agent it already has. Quote that statement rather than rewriting it. An
109
115
  empty project carries it in the README alone, and that makes the README the whole of the
@@ -24,7 +24,7 @@ starts. Choose one starting state: empty, agent-only, frontend-only, both, both-
24
24
  Run this command with the exact selected slugs:
25
25
 
26
26
  ```text
27
- npx --yes copilotkit@4.9.1 onboard classify --starting-state <starting-state> --agent-framework <agent-framework> --frontend <frontend>
27
+ npx --yes copilotkit@4.9.2 onboard classify --starting-state <starting-state> --agent-framework <agent-framework> --frontend <frontend>
28
28
  ```
29
29
 
30
30
  Do not continue if a value is refused. Fix the value from the choices that the earlier
@@ -48,7 +48,7 @@ target directory. Do not send the developer to another terminal.
48
48
  Read the choices first:
49
49
 
50
50
  ```text
51
- npx --yes copilotkit@4.9.1 project list --json
51
+ npx --yes copilotkit@4.9.2 project list --json
52
52
  ```
53
53
 
54
54
  With `--json` the payload is the only thing on standard output, so it is safe to parse.
@@ -59,7 +59,7 @@ developer asks.
59
59
  If the developer searches, run:
60
60
 
61
61
  ```text
62
- npx --yes copilotkit@4.9.1 project list --search <query> --json
62
+ npx --yes copilotkit@4.9.2 project list --search <query> --json
63
63
  ```
64
64
 
65
65
  If the developer asks for all projects, show the result of the first list command. Ask
@@ -69,7 +69,7 @@ frontend, framework, model, credential, or plan-approval question.
69
69
  Then record their answer, from the target directory:
70
70
 
71
71
  ```text
72
- npx --yes copilotkit@4.9.1 project select --project <slug-or-id> --json
72
+ npx --yes copilotkit@4.9.2 project select --project <slug-or-id> --json
73
73
  ```
74
74
 
75
75
  Use `--create <name> --json` instead when they want a new project. The two flags cannot be
@@ -135,16 +135,21 @@ names, and selected documentation URLs. Wait for the subagent to finish.
135
135
 
136
136
  Make sure that the plan preserves each part that already exists. The plan must name the
137
137
  credential variables, the Intelligence runtime wiring, the application the project asks
138
- for, implementation steps, validation steps, and proof steps. It must not contain secret
139
- values.
138
+ for, implementation steps, validation steps, and proof steps. Where the plan upgrades the
139
+ CopilotKit dependencies, it must name the versions it moves and the revert it falls back
140
+ to. It must not contain secret values.
140
141
 
141
- Show only the selected framework, frontend, model, planned file changes, validation commands, and proof steps.
142
+ Show only the selected framework, frontend, model, planned file changes, the CopilotKit dependency upgrade and the versions it moves, validation commands, and proof steps.
143
+
144
+ An upgrade to a working install is the developer's call, so it belongs in the plan they
145
+ approve rather than in the implementation that follows. Do not upgrade a dependency the
146
+ developer did not approve.
142
147
 
143
148
  If the developer approves the plan, run
144
- `npx --yes copilotkit@4.9.1 onboard read implementation/build-and-validate`.
149
+ `npx --yes copilotkit@4.9.2 onboard read implementation/build-and-validate`.
145
150
 
146
151
  If no exact supported path or documentation URL exists, run
147
- `npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.
152
+ `npx --yes copilotkit@4.9.2 onboard read unsupported/no-validated-path`.
148
153
 
149
154
  ## Planning subagent brief
150
155
 
@@ -185,10 +190,28 @@ combined. Take the constructor from the connect-your-runtime page. Where a frame
185
190
  quickstart shows a `runner` option instead, the connect-your-runtime page wins.
186
191
 
187
192
  When the starting state is `both-oss`, use its recorded live baseline evidence. Preserve
188
- the working agent, frontend, CopilotKit integration, and OSS behavior. Plan only the
189
- project selection, Intelligence runtime configuration, and authenticated proof needed for
190
- the conversion. Preserve the existing persistence and user-visible request. Do not
191
- rebuild a path that already works.
193
+ the working agent, frontend, CopilotKit integration, and OSS behavior. Plan the project
194
+ selection, the CopilotKit dependency upgrade below, the Intelligence runtime
195
+ configuration, and the authenticated proof needed for the conversion. Preserve the
196
+ existing persistence and user-visible request. Do not rebuild a path that already works.
197
+
198
+ Preserving the OSS baseline preserves the application, not its CopilotKit dependency
199
+ versions. An install that predates the managed platform defaults carries a bundled
200
+ reference naming hosts that route nothing, and it requires the platform URLs the same
201
+ documentation calls optional. A run that reads that reference configures the runtime
202
+ against a dead host, and the failure arrives as an empty-body 404 with no cause named.
203
+
204
+ If any `@copilotkit/*` dependency is below 1.64.0, plan to upgrade every `@copilotkit/*`
205
+ dependency to its latest published version. Packages that share a version line must end
206
+ on the same version. Never force a package onto a version line it does not publish on.
207
+ Resolve each latest version at run time rather than from a remembered version number.
208
+ Where every `@copilotkit/*` dependency already meets that floor, plan no dependency
209
+ change.
210
+
211
+ Plan the upgrade as its own step before the Intelligence runtime wiring, and plan to
212
+ re-run the recorded baseline checks immediately after it. Name the revert: restore the
213
+ manifest and lockfile to their recorded state and stop, rather than wiring Intelligence
214
+ onto a baseline the upgrade broke.
192
215
 
193
216
  Where the SDK requires an application-level value that the repository cannot supply, such
194
217
  as an end-user identity for threads, use one clearly marked local placeholder and name what
@@ -51,26 +51,26 @@ another framework. Do not show the internal route.
51
51
 
52
52
  Use exactly one matching internal route:
53
53
 
54
- 1. AG2: `npx --yes copilotkit@4.9.1 onboard read framework/ag2`
55
- 2. Agno: `npx --yes copilotkit@4.9.1 onboard read framework/agno`
56
- 3. Built-in CopilotKit agent: `npx --yes copilotkit@4.9.1 onboard read framework/built-in`
57
- 4. Claude Agent SDK Python: `npx --yes copilotkit@4.9.1 onboard read framework/claude-sdk-python`
58
- 5. Claude Agent SDK TypeScript: `npx --yes copilotkit@4.9.1 onboard read framework/claude-sdk-typescript`
59
- 6. CrewAI Flows: `npx --yes copilotkit@4.9.1 onboard read framework/crewai-flows`
60
- 7. Deep Agents: `npx --yes copilotkit@4.9.1 onboard read framework/deep-agents`
61
- 8. LangGraph Python: `npx --yes copilotkit@4.9.1 onboard read framework/langgraph-python`
62
- 9. LangGraph FastAPI: `npx --yes copilotkit@4.9.1 onboard read framework/langgraph-fastapi`
63
- 10. LangGraph TypeScript: `npx --yes copilotkit@4.9.1 onboard read framework/langgraph-typescript`
64
- 11. LlamaIndex: `npx --yes copilotkit@4.9.1 onboard read framework/llamaindex`
65
- 12. ADK: `npx --yes copilotkit@4.9.1 onboard read framework/google-adk`
66
- 13. Microsoft Agent Framework Python: `npx --yes copilotkit@4.9.1 onboard read framework/ms-agent-python`
67
- 14. Microsoft Agent Framework .NET: `npx --yes copilotkit@4.9.1 onboard read framework/ms-agent-dotnet`
68
- 15. Mastra: `npx --yes copilotkit@4.9.1 onboard read framework/mastra`
69
- 16. MS Agent Harness .NET: `npx --yes copilotkit@4.9.1 onboard read framework/ms-agent-harness-dotnet`
70
- 17. Pydantic AI: `npx --yes copilotkit@4.9.1 onboard read framework/pydantic-ai`
71
- 18. Strands Agents Python: `npx --yes copilotkit@4.9.1 onboard read framework/strands-python`
72
- 19. Strands Agents TypeScript: `npx --yes copilotkit@4.9.1 onboard read framework/strands-typescript`
54
+ 1. AG2: `npx --yes copilotkit@4.9.2 onboard read framework/ag2`
55
+ 2. Agno: `npx --yes copilotkit@4.9.2 onboard read framework/agno`
56
+ 3. Built-in CopilotKit agent: `npx --yes copilotkit@4.9.2 onboard read framework/built-in`
57
+ 4. Claude Agent SDK Python: `npx --yes copilotkit@4.9.2 onboard read framework/claude-sdk-python`
58
+ 5. Claude Agent SDK TypeScript: `npx --yes copilotkit@4.9.2 onboard read framework/claude-sdk-typescript`
59
+ 6. CrewAI Flows: `npx --yes copilotkit@4.9.2 onboard read framework/crewai-flows`
60
+ 7. Deep Agents: `npx --yes copilotkit@4.9.2 onboard read framework/deep-agents`
61
+ 8. LangGraph Python: `npx --yes copilotkit@4.9.2 onboard read framework/langgraph-python`
62
+ 9. LangGraph FastAPI: `npx --yes copilotkit@4.9.2 onboard read framework/langgraph-fastapi`
63
+ 10. LangGraph TypeScript: `npx --yes copilotkit@4.9.2 onboard read framework/langgraph-typescript`
64
+ 11. LlamaIndex: `npx --yes copilotkit@4.9.2 onboard read framework/llamaindex`
65
+ 12. ADK: `npx --yes copilotkit@4.9.2 onboard read framework/google-adk`
66
+ 13. Microsoft Agent Framework Python: `npx --yes copilotkit@4.9.2 onboard read framework/ms-agent-python`
67
+ 14. Microsoft Agent Framework .NET: `npx --yes copilotkit@4.9.2 onboard read framework/ms-agent-dotnet`
68
+ 15. Mastra: `npx --yes copilotkit@4.9.2 onboard read framework/mastra`
69
+ 16. MS Agent Harness .NET: `npx --yes copilotkit@4.9.2 onboard read framework/ms-agent-harness-dotnet`
70
+ 17. Pydantic AI: `npx --yes copilotkit@4.9.2 onboard read framework/pydantic-ai`
71
+ 18. Strands Agents Python: `npx --yes copilotkit@4.9.2 onboard read framework/strands-python`
72
+ 19. Strands Agents TypeScript: `npx --yes copilotkit@4.9.2 onboard read framework/strands-typescript`
73
73
 
74
74
  If the project has an agent in another framework, or no listed framework fits, keep the
75
75
  developer's current agent and run
76
- `npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.
76
+ `npx --yes copilotkit@4.9.2 onboard read unsupported/no-validated-path`.
@@ -21,13 +21,13 @@ the application passes proof. Report each tool result separately.
21
21
  Report the documentation gap and each assumption with the proof evidence. Do not claim
22
22
  that the selected documentation proved an inferred step.
23
23
 
24
- When the proof is complete, run `npx --yes copilotkit@4.9.1 onboard complete`, carrying the
24
+ When the proof is complete, run `npx --yes copilotkit@4.9.2 onboard complete`, carrying the
25
25
  surface-check result the proof subagent returned. Pass exactly one flag, matching this
26
26
  journey's surface:
27
27
 
28
28
  ```text
29
- npx --yes copilotkit@4.9.1 onboard complete --visual-check <outcome>
30
- npx --yes copilotkit@4.9.1 onboard complete --device-check <outcome>
29
+ npx --yes copilotkit@4.9.2 onboard complete --visual-check <outcome>
30
+ npx --yes copilotkit@4.9.2 onboard complete --device-check <outcome>
31
31
  ```
32
32
 
33
33
  `--visual-check` is for a web frontend and takes `performed`, `skipped-no-browser-tool`, or
@@ -42,7 +42,7 @@ not a fact about the page. Retrieve the same URL a second way before you judge i
42
42
  unavailable only after a second method also fails.
43
43
 
44
44
  If the pages support the selection, run
45
- `npx --yes copilotkit@4.9.1 onboard read frontend/plan`.
45
+ `npx --yes copilotkit@4.9.2 onboard read frontend/plan`.
46
46
 
47
47
  If a second method also fails, or a page that loads does not support the selection, run
48
- `npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.
48
+ `npx --yes copilotkit@4.9.2 onboard read unsupported/no-validated-path`.
@@ -42,7 +42,7 @@ not a fact about the page. Retrieve the same URL a second way before you judge i
42
42
  unavailable only after a second method also fails.
43
43
 
44
44
  If the pages support the selection, run
45
- `npx --yes copilotkit@4.9.1 onboard read frontend/plan`.
45
+ `npx --yes copilotkit@4.9.2 onboard read frontend/plan`.
46
46
 
47
47
  If a second method also fails, or a page that loads does not support the selection, run
48
- `npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.
48
+ `npx --yes copilotkit@4.9.2 onboard read unsupported/no-validated-path`.
@@ -37,7 +37,7 @@ not a fact about the page. Retrieve the same URL a second way before you judge i
37
37
  unavailable only after a second method also fails.
38
38
 
39
39
  If the pages support the selection, run
40
- `npx --yes copilotkit@4.9.1 onboard read frontend/plan`.
40
+ `npx --yes copilotkit@4.9.2 onboard read frontend/plan`.
41
41
 
42
42
  If a second method also fails, or a page that loads does not support the selection, run
43
- `npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.
43
+ `npx --yes copilotkit@4.9.2 onboard read unsupported/no-validated-path`.
@@ -43,7 +43,7 @@ not a fact about the page. Retrieve the same URL a second way before you judge i
43
43
  unavailable only after a second method also fails.
44
44
 
45
45
  If the pages support the selection, run
46
- `npx --yes copilotkit@4.9.1 onboard read frontend/plan`.
46
+ `npx --yes copilotkit@4.9.2 onboard read frontend/plan`.
47
47
 
48
48
  If a second method also fails, or a page that loads does not support the selection, run
49
- `npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.
49
+ `npx --yes copilotkit@4.9.2 onboard read unsupported/no-validated-path`.
@@ -47,7 +47,7 @@ not a fact about the page. Retrieve the same URL a second way before you judge i
47
47
  unavailable only after a second method also fails.
48
48
 
49
49
  If the pages support the selection, run
50
- `npx --yes copilotkit@4.9.1 onboard read frontend/plan`.
50
+ `npx --yes copilotkit@4.9.2 onboard read frontend/plan`.
51
51
 
52
52
  If a second method also fails, or a page that loads does not support the selection, run
53
- `npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.
53
+ `npx --yes copilotkit@4.9.2 onboard read unsupported/no-validated-path`.
@@ -50,7 +50,7 @@ not a fact about the page. Retrieve the same URL a second way before you judge i
50
50
  unavailable only after a second method also fails.
51
51
 
52
52
  If the pages support the selection, run
53
- `npx --yes copilotkit@4.9.1 onboard read frontend/plan`.
53
+ `npx --yes copilotkit@4.9.2 onboard read frontend/plan`.
54
54
 
55
55
  If a second method also fails, or a page that loads does not support the selection, run
56
- `npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.
56
+ `npx --yes copilotkit@4.9.2 onboard read unsupported/no-validated-path`.
@@ -39,7 +39,7 @@ not a fact about the page. Retrieve the same URL a second way before you judge i
39
39
  unavailable only after a second method also fails.
40
40
 
41
41
  If the pages support the selection, run
42
- `npx --yes copilotkit@4.9.1 onboard read frontend/plan`.
42
+ `npx --yes copilotkit@4.9.2 onboard read frontend/plan`.
43
43
 
44
44
  If a second method also fails, or a page that loads does not support the selection, run
45
- `npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.
45
+ `npx --yes copilotkit@4.9.2 onboard read unsupported/no-validated-path`.
@@ -40,7 +40,7 @@ not a fact about the page. Retrieve the same URL a second way before you judge i
40
40
  unavailable only after a second method also fails.
41
41
 
42
42
  If the pages support the selection, run
43
- `npx --yes copilotkit@4.9.1 onboard read frontend/plan`.
43
+ `npx --yes copilotkit@4.9.2 onboard read frontend/plan`.
44
44
 
45
45
  If a second method also fails, or a page that loads does not support the selection, run
46
- `npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.
46
+ `npx --yes copilotkit@4.9.2 onboard read unsupported/no-validated-path`.
@@ -36,7 +36,7 @@ not a fact about the page. Retrieve the same URL a second way before you judge i
36
36
  unavailable only after a second method also fails.
37
37
 
38
38
  If the pages support the selection, run
39
- `npx --yes copilotkit@4.9.1 onboard read frontend/plan`.
39
+ `npx --yes copilotkit@4.9.2 onboard read frontend/plan`.
40
40
 
41
41
  If a second method also fails, or a page that loads does not support the selection, run
42
- `npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.
42
+ `npx --yes copilotkit@4.9.2 onboard read unsupported/no-validated-path`.
@@ -27,7 +27,7 @@ not a fact about the page. Retrieve the same URL a second way before you judge i
27
27
  unavailable only after a second method also fails.
28
28
 
29
29
  If the pages support the selection, run
30
- `npx --yes copilotkit@4.9.1 onboard read frontend/plan`.
30
+ `npx --yes copilotkit@4.9.2 onboard read frontend/plan`.
31
31
 
32
32
  If a second method also fails, or a page that loads does not support the selection, run
33
- `npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.
33
+ `npx --yes copilotkit@4.9.2 onboard read unsupported/no-validated-path`.
@@ -27,7 +27,7 @@ not a fact about the page. Retrieve the same URL a second way before you judge i
27
27
  unavailable only after a second method also fails.
28
28
 
29
29
  If the pages support the selection, run
30
- `npx --yes copilotkit@4.9.1 onboard read frontend/plan`.
30
+ `npx --yes copilotkit@4.9.2 onboard read frontend/plan`.
31
31
 
32
32
  If a second method also fails, or a page that loads does not support the selection, run
33
- `npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.
33
+ `npx --yes copilotkit@4.9.2 onboard read unsupported/no-validated-path`.
@@ -45,7 +45,7 @@ not a fact about the page. Retrieve the same URL a second way before you judge i
45
45
  unavailable only after a second method also fails.
46
46
 
47
47
  If the pages support the selection, run
48
- `npx --yes copilotkit@4.9.1 onboard read frontend/plan`.
48
+ `npx --yes copilotkit@4.9.2 onboard read frontend/plan`.
49
49
 
50
50
  If a second method also fails, or a page that loads does not support the selection, run
51
- `npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.
51
+ `npx --yes copilotkit@4.9.2 onboard read unsupported/no-validated-path`.
@@ -57,7 +57,7 @@ not a fact about the page. Retrieve the same URL a second way before you judge i
57
57
  unavailable only after a second method also fails.
58
58
 
59
59
  If the pages support the selection, run
60
- `npx --yes copilotkit@4.9.1 onboard read frontend/plan`.
60
+ `npx --yes copilotkit@4.9.2 onboard read frontend/plan`.
61
61
 
62
62
  If a second method also fails, or a page that loads does not support the selection, run
63
- `npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.
63
+ `npx --yes copilotkit@4.9.2 onboard read unsupported/no-validated-path`.
@@ -65,7 +65,7 @@ not a fact about the page. Retrieve the same URL a second way before you judge i
65
65
  unavailable only after a second method also fails.
66
66
 
67
67
  If the pages support the selection, run
68
- `npx --yes copilotkit@4.9.1 onboard read frontend/plan`.
68
+ `npx --yes copilotkit@4.9.2 onboard read frontend/plan`.
69
69
 
70
70
  If a second method also fails, or a page that loads does not support the selection, run
71
- `npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.
71
+ `npx --yes copilotkit@4.9.2 onboard read unsupported/no-validated-path`.
@@ -56,7 +56,7 @@ not a fact about the page. Retrieve the same URL a second way before you judge i
56
56
  unavailable only after a second method also fails.
57
57
 
58
58
  If the pages support the selection, run
59
- `npx --yes copilotkit@4.9.1 onboard read frontend/plan`.
59
+ `npx --yes copilotkit@4.9.2 onboard read frontend/plan`.
60
60
 
61
61
  If a second method also fails, or a page that loads does not support the selection, run
62
- `npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.
62
+ `npx --yes copilotkit@4.9.2 onboard read unsupported/no-validated-path`.
@@ -40,7 +40,7 @@ not a fact about the page. Retrieve the same URL a second way before you judge i
40
40
  unavailable only after a second method also fails.
41
41
 
42
42
  If the pages support the selection, run
43
- `npx --yes copilotkit@4.9.1 onboard read frontend/plan`.
43
+ `npx --yes copilotkit@4.9.2 onboard read frontend/plan`.
44
44
 
45
45
  If a second method also fails, or a page that loads does not support the selection, run
46
- `npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.
46
+ `npx --yes copilotkit@4.9.2 onboard read unsupported/no-validated-path`.
@@ -42,7 +42,7 @@ not a fact about the page. Retrieve the same URL a second way before you judge i
42
42
  unavailable only after a second method also fails.
43
43
 
44
44
  If the pages support the selection, run
45
- `npx --yes copilotkit@4.9.1 onboard read frontend/plan`.
45
+ `npx --yes copilotkit@4.9.2 onboard read frontend/plan`.
46
46
 
47
47
  If a second method also fails, or a page that loads does not support the selection, run
48
- `npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.
48
+ `npx --yes copilotkit@4.9.2 onboard read unsupported/no-validated-path`.
@@ -36,7 +36,7 @@ not a fact about the page. Retrieve the same URL a second way before you judge i
36
36
  unavailable only after a second method also fails.
37
37
 
38
38
  If the pages support the selection, run
39
- `npx --yes copilotkit@4.9.1 onboard read frontend/plan`.
39
+ `npx --yes copilotkit@4.9.2 onboard read frontend/plan`.
40
40
 
41
41
  If a second method also fails, or a page that loads does not support the selection, run
42
- `npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.
42
+ `npx --yes copilotkit@4.9.2 onboard read unsupported/no-validated-path`.
@@ -36,7 +36,7 @@ not a fact about the page. Retrieve the same URL a second way before you judge i
36
36
  unavailable only after a second method also fails.
37
37
 
38
38
  If the pages support the selection, run
39
- `npx --yes copilotkit@4.9.1 onboard read frontend/plan`.
39
+ `npx --yes copilotkit@4.9.2 onboard read frontend/plan`.
40
40
 
41
41
  If a second method also fails, or a page that loads does not support the selection, run
42
- `npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.
42
+ `npx --yes copilotkit@4.9.2 onboard read unsupported/no-validated-path`.
@@ -2,6 +2,11 @@
2
2
 
3
3
  Preserve an existing Angular frontend. Use the selected page for a new frontend.
4
4
 
5
+ Use the starter shortcut only if all these facts are true: the target directory contains
6
+ no entries, its name is a valid `init` project name, and the selected framework is ADK.
7
+ If all three facts are true, record Angular as the selected frontend. Then run
8
+ `npx --yes copilotkit@4.9.2 onboard read starter/clone` before you fetch documentation.
9
+
5
10
  ## Documentation
6
11
 
7
12
  - Credentials and plan: `Not applicable`
@@ -26,8 +31,8 @@ not a fact about the page. Retrieve the same URL a second way before you judge i
26
31
  unavailable only after a second method also fails.
27
32
 
28
33
  If the page supports the selection, run
29
- `npx --yes copilotkit@4.9.1 onboard read credentials/finalize-plan`.
34
+ `npx --yes copilotkit@4.9.2 onboard read credentials/finalize-plan`.
30
35
 
31
36
  If a second method also fails, or the page that loads does not support the selection,
32
37
  run
33
- `npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.
38
+ `npx --yes copilotkit@4.9.2 onboard read unsupported/no-validated-path`.
@@ -2,6 +2,21 @@
2
2
 
3
3
  Preserve an existing Next.js frontend. Use the selected pages for a new frontend.
4
4
 
5
+ Use the starter shortcut only if the target directory contains no entries and its name is
6
+ a valid `init` project name. The selected framework must also match one of these options.
7
+
8
+ These Python options have Next.js starters: Agno, Claude Agent SDK Python, CrewAI Flows,
9
+ LangGraph Python, LlamaIndex, and ADK.
10
+
11
+ These Python options also have starters: Microsoft Agent Framework Python, Pydantic AI,
12
+ and Strands Agents Python.
13
+
14
+ These TypeScript options have starters: Claude Agent SDK TypeScript, LangGraph TypeScript,
15
+ Mastra, and Strands Agents TypeScript. The .NET option is Microsoft Agent Framework .NET.
16
+
17
+ If all shortcut conditions are true, record Next.js as the selected frontend. Then run
18
+ `npx --yes copilotkit@4.9.2 onboard read starter/clone` before you fetch documentation.
19
+
5
20
  ## Documentation
6
21
 
7
22
  - Credentials and plan: `Not applicable`
@@ -22,7 +37,7 @@ not a fact about the page. Retrieve the same URL a second way before you judge i
22
37
  unavailable only after a second method also fails.
23
38
 
24
39
  If the pages support the selection, run
25
- `npx --yes copilotkit@4.9.1 onboard read credentials/finalize-plan`.
40
+ `npx --yes copilotkit@4.9.2 onboard read credentials/finalize-plan`.
26
41
 
27
42
  If a second method also fails, or a page that loads does not support the selection, run
28
- `npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.
43
+ `npx --yes copilotkit@4.9.2 onboard read unsupported/no-validated-path`.