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
@@ -27,7 +27,7 @@ Record the selected framework, vendor, model, required credential variable names
27
27
  URLs, and the context documentation gap.
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`.
@@ -28,7 +28,7 @@ Record the selected framework, vendor, model, required credential variable names
28
28
  URLs, and the context documentation gap.
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`.
@@ -5,7 +5,7 @@ Preserve an existing Angular frontend. Use the selected page for a new frontend.
5
5
  Use the starter shortcut only if all these facts are true: the target directory contains
6
6
  no entries, its name is a valid `init` project name, and the selected framework is ADK.
7
7
  If all three facts are true, record Angular as the selected frontend. Then run
8
- `npx --yes copilotkit@4.9.17 onboard read starter/clone` before you fetch documentation.
8
+ `npx --yes copilotkit@4.9.24 onboard read starter/clone` before you fetch documentation.
9
9
 
10
10
  ## Documentation
11
11
 
@@ -35,7 +35,7 @@ you create or build an Angular project. If the installed version is lower, selec
35
35
  supported version first and use it for every later command in this project.
36
36
 
37
37
  If the pages support the selection, record Angular and these URLs. Then run
38
- `npx --yes copilotkit@4.9.17 onboard read credentials/finalize-plan`.
38
+ `npx --yes copilotkit@4.9.24 onboard read credentials/finalize-plan`.
39
39
 
40
40
  If the documentation does not support the selection, run
41
- `npx --yes copilotkit@4.9.17 onboard read unsupported/no-validated-path`.
41
+ `npx --yes copilotkit@4.9.24 onboard read unsupported/no-validated-path`.
@@ -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.9.17 onboard read starter/clone` before you fetch documentation.
18
+ `npx --yes copilotkit@4.9.24 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.9.17 onboard read credentials/finalize-plan`.
30
+ `npx --yes copilotkit@4.9.24 onboard read credentials/finalize-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`.
@@ -24,11 +24,11 @@ process.
24
24
 
25
25
  Use exactly one matching internal route:
26
26
 
27
- 1. React SPA: `npx --yes copilotkit@4.9.17 onboard read frontend/react-spa`
28
- 2. Next.js: `npx --yes copilotkit@4.9.17 onboard read frontend/nextjs`
29
- 3. Angular: `npx --yes copilotkit@4.9.17 onboard read frontend/angular`
30
- 4. Vue 3: `npx --yes copilotkit@4.9.17 onboard read frontend/vue`
31
- 5. React Native: `npx --yes copilotkit@4.9.17 onboard read frontend/react-native`
27
+ 1. React SPA: `npx --yes copilotkit@4.9.24 onboard read frontend/react-spa`
28
+ 2. Next.js: `npx --yes copilotkit@4.9.24 onboard read frontend/nextjs`
29
+ 3. Angular: `npx --yes copilotkit@4.9.24 onboard read frontend/angular`
30
+ 4. Vue 3: `npx --yes copilotkit@4.9.24 onboard read frontend/vue`
31
+ 5. React Native: `npx --yes copilotkit@4.9.24 onboard read frontend/react-native`
32
32
 
33
33
  If no listed frontend fits, 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`.
@@ -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.9.17 onboard read credentials/finalize-plan`.
18
+ `npx --yes copilotkit@4.9.24 onboard read credentials/finalize-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`.
@@ -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.9.17 onboard read credentials/finalize-plan`.
14
+ `npx --yes copilotkit@4.9.24 onboard read credentials/finalize-plan`.
15
15
 
16
16
  If the documentation does not support the selection, run
17
- `npx --yes copilotkit@4.9.17 onboard read unsupported/no-validated-path`.
17
+ `npx --yes copilotkit@4.9.24 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.9.17 onboard read credentials/finalize-plan`.
19
+ `npx --yes copilotkit@4.9.24 onboard read credentials/finalize-plan`.
20
20
 
21
21
  If the documentation does not support the selection, run
22
- `npx --yes copilotkit@4.9.17 onboard read unsupported/no-validated-path`.
22
+ `npx --yes copilotkit@4.9.24 onboard read unsupported/no-validated-path`.
@@ -7,7 +7,7 @@ Do not implement the plan yourself. Use the step order in the approved plan.
7
7
  Run the audit from the target app directory:
8
8
 
9
9
  ```text
10
- npx --yes copilotkit@4.9.17 onboard audit
10
+ npx --yes copilotkit@4.9.24 onboard audit
11
11
  ```
12
12
 
13
13
  It compares every protected path with the digest the CLI captured for it. Its result starts
@@ -25,7 +25,7 @@ protected path as changed. Report the printed reason and use the route-out rules
25
25
  A non-pass audit never continues the run. Do not send an audit result to a repair worker.
26
26
 
27
27
  Spawn one implementation subagent. Tell it to run
28
- `npx --yes copilotkit@4.9.17 onboard read subagent/implement-and-validate` first and follow
28
+ `npx --yes copilotkit@4.9.24 onboard read subagent/implement-and-validate` first and follow
29
29
  the prompt it returns. If that read fails because the subagent cannot use the shell, stop that
30
30
  subagent. Run the same command yourself, then spawn a fresh subagent with the returned prompt
31
31
  and the same handoff. Give it the plan, selected framework, frontend, model, exact target app
@@ -42,7 +42,7 @@ Run the protected-path audit after the implementation subagent passes. If any pr
42
42
  changed, use the route-out rules. Continue to proof only when that audit passes.
43
43
 
44
44
  After the selected implementation path passes, run
45
- `npx --yes copilotkit@4.9.17 onboard read proof/round-trip`.
45
+ `npx --yes copilotkit@4.9.24 onboard read proof/round-trip`.
46
46
 
47
47
  ## Repair rules
48
48
 
@@ -60,4 +60,4 @@ Route out for `Status: blocked`. Route out only when the failure is not yours to
60
60
  failure is in code this run did not write, the fix requires changing the developer's existing
61
61
  agent or frontend, the same command still fails after three repair attempts, or the
62
62
  documentation does not support the plan. In those cases run
63
- `npx --yes copilotkit@4.9.17 onboard read unsupported/no-validated-path`.
63
+ `npx --yes copilotkit@4.9.24 onboard read unsupported/no-validated-path`.
@@ -37,17 +37,30 @@ The handoff must include:
37
37
  - The URL of the running app.
38
38
  - The command that starts the app in the future.
39
39
  - The debugging surface this journey's frontend can reach, named below.
40
- - How to use https://intelligence.copilotkit.ai to manage the Intelligence installation.
40
+ - How to use https://intelligence.copilotkit.ai to manage the Intelligence
41
+ installation. Do not open it. This item makes the developer aware the dashboard is
42
+ there, and it is a sentence to write rather than a check to perform. Nothing in this
43
+ graph gates on the dashboard, so a dashboard this run never opened is not a finding,
44
+ not a caveat, and not a blocker.
41
45
  - The process IDs and stop commands for the running agent and frontend.
42
46
  - The `@copilotkit/*` versions this conversion changed, and what they were before.
43
47
  - On a conversion, the criterion this run was judged against, in the words the run was
44
48
  given.
49
+ - Any path this run created that git does not ignore, and what to do with each.
50
+
51
+ A run leaves paths beside the credential file. Tool output such as `.playwright-mcp/` and
52
+ `.langgraph_api/` is regenerable, so the developer normally wants it ignored.
53
+ `.copilotkit/` is not debris: `project.json` and `channels.json` are the project's own
54
+ declared state and belong in the commit, while `.copilotkit/artifacts/` holds regenerable
55
+ manifests and does not. Name each path and say which of the two it is. Do not add an
56
+ ignore line for any of them yourself. None of these carries a secret, unlike the
57
+ credential path, so the developer decides.
45
58
 
46
59
  Name the debugging surface this journey's frontend can reach, rather than the one the rest
47
60
  of the documentation leads with. For a web frontend it is the CopilotKit Inspector. For
48
61
  React Native there is no Inspector: it is a browser overlay built on a DOM custom element,
49
62
  and `@copilotkit/react-native` does not ship it. Give a mobile developer
50
- `npx --yes copilotkit@4.9.17 verify --round-trip`, the runtime's own log, the AG-UI
63
+ `npx --yes copilotkit@4.9.24 verify --round-trip`, the runtime's own log, the AG-UI
51
64
  Event Inspector in the CopilotKit VS Code extension, and the Intelligence thread view
52
65
  instead. Naming the Inspector to a developer who cannot open it costs them the time it
53
66
  takes to conclude their own wiring is broken.
@@ -59,7 +72,7 @@ the friction commands without another developer question. The CLI telemetry gate
59
72
  whether the report is sent.
60
73
 
61
74
  ```text
62
- npx --yes copilotkit@4.9.17 onboard friction --category <slug> --cost-seconds <seconds>
75
+ npx --yes copilotkit@4.9.24 onboard friction --category <slug> --cost-seconds <seconds>
63
76
  ```
64
77
 
65
78
  Write one or two sentences on the command's standard input. Pick one category from
@@ -76,14 +89,14 @@ Tell the developer when you send a friction report. Do not quote or summarize th
76
89
  unless the developer asks. If the CLI says that telemetry is disabled or unavailable,
77
90
  state that the report was not sent and continue without another question.
78
91
 
79
- When the evidence is gathered, run `npx --yes copilotkit@4.9.17 onboard complete`, carrying
92
+ When the evidence is gathered, run `npx --yes copilotkit@4.9.24 onboard complete`, carrying
80
93
  the surface-check outcome the proof subagent returned. Pass exactly one flag, and pass the
81
94
  one that matches this journey's surface.
82
95
 
83
96
  For a web frontend -- React SPA, Next.js, Angular, Vue:
84
97
 
85
98
  ```text
86
- npx --yes copilotkit@4.9.17 onboard complete --visual-check <outcome>
99
+ npx --yes copilotkit@4.9.24 onboard complete --visual-check <outcome>
87
100
  ```
88
101
 
89
102
  The outcome is one of `performed`, `skipped-no-browser-tool`, or `failed`.
@@ -91,7 +104,7 @@ The outcome is one of `performed`, `skipped-no-browser-tool`, or `failed`.
91
104
  For React Native:
92
105
 
93
106
  ```text
94
- npx --yes copilotkit@4.9.17 onboard complete --device-check <outcome>
107
+ npx --yes copilotkit@4.9.24 onboard complete --device-check <outcome>
95
108
  ```
96
109
 
97
110
  The outcome is one of `performed`, `skipped-no-device`, or `failed`.
@@ -109,14 +122,18 @@ If the round trip proved and something after it still blocked this run, add `--b
109
122
  to the same command:
110
123
 
111
124
  ```text
112
- npx --yes copilotkit@4.9.17 onboard complete --visual-check performed --blocked-by <cause>
125
+ npx --yes copilotkit@4.9.24 onboard complete --visual-check performed --blocked-by <cause>
113
126
  ```
114
127
 
115
- The cause is one of `hosted-dashboard` for a managed dashboard that did not load or refused
116
- a sign-in, `inspector` for a debugging surface that did not open, `plan-excluded-capability`
117
- for a capability the approved plan had already excluded for this framework, and `other` for
118
- anything else. Pick `other` rather than leaving the flag off. The command ends the run as
119
- blocked and prints what the blocker leaves unverified.
128
+ The cause is one of `inspector` for a debugging surface that did not open,
129
+ `plan-excluded-capability` for a capability the approved plan had already excluded for this
130
+ framework, and `other` for anything else. Pick `other` rather than leaving the flag off.
131
+ The command ends the run as blocked and prints what the blocker leaves unverified.
132
+
133
+ The managed Intelligence dashboard is not among these, because nothing in this graph asks a
134
+ run to open it. A run that records a blocker for a surface it was never sent to looks worse
135
+ than an identical run that wrote the same handoff sentence, and the two are then not
136
+ comparable.
120
137
 
121
138
  This is the flag for a journey that worked. It is not a way to report an unsupported path,
122
139
  and a blocked run here is still owed the full handoff above: the URL, the start command,
@@ -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.9.17 onboard read subagent/prove-oss-baseline` first and follow the
4
+ `npx --yes copilotkit@4.9.24 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. Wait for the
@@ -11,14 +11,14 @@ Do not change project files before this proof ends. Starting existing developmen
11
11
  processes and their ignored runtime files is allowed.
12
12
 
13
13
  If the subagent proves the `both-oss` predicate, keep its evidence with the plan and run
14
- `npx --yes copilotkit@4.9.17 onboard read conversion/plan`. That project already works.
14
+ `npx --yes copilotkit@4.9.24 onboard read conversion/plan`. That project already works.
15
15
  What it needs is the conversion, not a build.
16
16
 
17
17
  If it proves another supported starting state, record that state and run
18
- `npx --yes copilotkit@4.9.17 onboard read credentials/plan`. This prompt is served
18
+ `npx --yes copilotkit@4.9.24 onboard read credentials/plan`. This prompt is served
19
19
  whenever a project looks like an OSS integration, so a baseline that did not prove is an
20
20
  ordinary starting state rather than a failure.
21
21
 
22
22
  If it cannot identify the running process safely, exposes a secret, or finds a baseline
23
23
  failure that cannot be classified, run
24
- `npx --yes copilotkit@4.9.17 onboard read unsupported/no-validated-path`.
24
+ `npx --yes copilotkit@4.9.24 onboard read unsupported/no-validated-path`.
@@ -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.9.17 onboard read subagent/prove-round-trip` first and follow the
4
+ `npx --yes copilotkit@4.9.24 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
@@ -20,7 +20,7 @@ https://docs.copilotkit.ai/build-with-agents.md
20
20
  Wait for the subagent to finish.
21
21
 
22
22
  For every protected-path audit in this prompt, run
23
- `npx --yes copilotkit@4.9.17 onboard audit` from the target app directory. If its result
23
+ `npx --yes copilotkit@4.9.24 onboard audit` from the target app directory. If its result
24
24
  starts with `Status: blocked`, report the printed reason and use the route-out rules below.
25
25
  A blocked audit proved nothing changed and is not a preservation failure. If a
26
26
  protected-path audit reports a changed path, use the route-out rules below. Never repair,
@@ -28,16 +28,16 @@ reset, or revert a protected path.
28
28
 
29
29
  If the proof result starts with `Status: passed`, run the protected-path audit. Continue to
30
30
  `proof/complete` only if that audit passes. After the audit passes, run
31
- `npx --yes copilotkit@4.9.17 onboard read proof/complete`. A performed surface outcome with
31
+ `npx --yes copilotkit@4.9.24 onboard read proof/complete`. A performed surface outcome with
32
32
  the full round trip is core success even if a continued-development tool fails. A skipped
33
33
  surface outcome still enters `proof/complete` so the CLI records the blocked result. Do not
34
34
  describe a skipped surface as proved. Keep the Skills and MCP results separate from the proof
35
35
  result.
36
36
 
37
- If the round trip proves and something after it blocks this run anyway -- the managed
38
- Intelligence dashboard, the debugging surface, or a capability the approved plan already
39
- excluded for this framework -- read `proof/complete` all the same, with the command above,
40
- and carry the blocker there with `--blocked-by`.
37
+ If the round trip proves and something after it blocks this run anyway -- the debugging
38
+ surface, or a capability the approved plan already excluded for this framework -- read
39
+ `proof/complete` all the same, with the command above, and carry the blocker there with
40
+ `--blocked-by`.
41
41
  The stop terminal is for a journey this release cannot carry. It is
42
42
  not for a journey that worked and then hit a wall: routing a proved run there tells the
43
43
  developer that a framework and frontend that just worked are unsupported, and hands them a
@@ -95,7 +95,7 @@ and proof cycles.
95
95
 
96
96
  Route out only when the failure is not yours to fix, when the same proof still fails after
97
97
  three attempts, or when no evidence of the round trip can be produced. In those cases run
98
- `npx --yes copilotkit@4.9.17 onboard read unsupported/no-validated-path`. All three are
98
+ `npx --yes copilotkit@4.9.24 onboard read unsupported/no-validated-path`. All three are
99
99
  about the round trip itself. A round trip that proved is not one of them, whatever failed
100
100
  after it.
101
101
 
@@ -105,7 +105,7 @@ Run the feedback command without another developer question. The CLI telemetry g
105
105
  whether the report is sent.
106
106
 
107
107
  ```text
108
- npx --yes copilotkit@4.9.17 onboard feedback
108
+ npx --yes copilotkit@4.9.24 onboard feedback
109
109
  ```
110
110
 
111
111
  Write at most four lines to standard input: the step you stopped at and what stopped it.
@@ -34,11 +34,18 @@ selected pair is not in the table, or the directory name is not valid, stop the
34
34
  Do not run `init`. Treat this result as a failed shortcut and follow the final failure
35
35
  instruction in this prompt.
36
36
 
37
- If the developer did not name an Intelligence project, list the available projects:
37
+ If the developer did not name an Intelligence project, create one for the app being
38
+ cloned. This directory is new, so no existing project is already its own: take the project
39
+ name from the target directory name derived above, and ask the developer to confirm it or
40
+ give another. Do not list the projects in the organization. If no developer answers, use
41
+ the derived name.
38
42
 
39
- `npx --yes copilotkit@4.9.17 project list --json`
43
+ Only if the developer asks for an existing project, or asks to see the projects they have,
44
+ read the choices:
40
45
 
41
- Ask the developer to select a project or give a name for a new project. If the developer
46
+ `npx --yes copilotkit@4.9.24 project list --json`
47
+
48
+ Then ask which one to use. Do not order the projects by creation time. If the developer
42
49
  already gave this answer, do not ask again. Do not read a secret value. Do not show or
43
50
  store a secret value.
44
51
 
@@ -46,10 +53,12 @@ Run the command from the parent directory. Do not inspect another entry in the p
46
53
  directory. Replace each placeholder with the recorded value. Do not run a placeholder as
47
54
  a shell argument.
48
55
 
49
- `npx --yes copilotkit@4.9.17 init --name <project-name> --framework <framework-id> --channel none --no-banner --project <slug-or-id> --install`
56
+ `npx --yes copilotkit@4.9.24 init --name <project-name> --framework <framework-id> --channel none --no-banner --create <name> --install`
50
57
 
51
- If the developer wants a new project, use `--create <name>` instead of
52
- `--project <slug-or-id>`. If the developer asked to skip the dependency install, use
58
+ Pass the confirmed name to both `--name` and `--create`: the app directory and its
59
+ Intelligence project take the same name here. If the developer names an existing project,
60
+ use `--project <slug-or-id>` instead of `--create <name>`. If the developer asked to skip
61
+ the dependency install, use
53
62
  `--no-install` instead of `--install`. Do not wait for an interactive prompt. Pass every
54
63
  answer as a flag.
55
64
 
@@ -60,8 +69,8 @@ account. The command does not need terminal input.
60
69
  If the command succeeds, do not rebuild the starter by hand. Inspect only the generated
61
70
  paths inside the target directory. Record the files, install result, project connection,
62
71
  and validation commands. Then run
63
- `npx --yes copilotkit@4.9.17 onboard read proof/round-trip`.
72
+ `npx --yes copilotkit@4.9.24 onboard read proof/round-trip`.
64
73
 
65
74
  If the command fails, report its exact error and do not claim that the starter is ready.
66
75
  Then run
67
- `npx --yes copilotkit@4.9.17 onboard read unsupported/no-validated-path`.
76
+ `npx --yes copilotkit@4.9.24 onboard read unsupported/no-validated-path`.
@@ -35,13 +35,18 @@ reference naming hosts that route nothing, and it requires the platform URLs the
35
35
  documentation calls optional. A run that reads that reference configures the runtime
36
36
  against a dead host, and the failure arrives as an empty-body 404 with no cause named.
37
37
 
38
- If any `@copilotkit/*` dependency is below 1.64.0, plan to upgrade every `@copilotkit/*`
38
+ If any `@copilotkit/*` dependency is below 1.70.0, plan to upgrade every `@copilotkit/*`
39
39
  dependency to its latest published version. Packages that share a version line must end
40
40
  on the same version. Never force a package onto a version line it does not publish on.
41
41
  Resolve each latest version at run time rather than from a remembered version number.
42
42
  Where every `@copilotkit/*` dependency already meets that floor, plan no dependency
43
43
  change.
44
44
 
45
+ The floor is 1.70.0 because the runtime resolves managed Intelligence entitlement
46
+ authority from that version. A runtime below it reports its license from a self-hosted
47
+ token alone. A managed project holds no such token, so the threads drawer this conversion
48
+ adds lists nothing even after every command-line check passes.
49
+
45
50
  Plan the upgrade as its own step before the Intelligence runtime wiring, and plan to
46
51
  re-run the recorded baseline checks immediately after it. Name the revert: restore the
47
52
  manifest and lockfile to their recorded state and stop, rather than wiring Intelligence
@@ -94,8 +99,9 @@ here is work the developer did not ask for.
94
99
 
95
100
  Plan the threads drawer itself: add it from the selected drawer page, where this frontend
96
101
  does not already render one. Where this journey's frontend framework ships no threads
97
- drawer -- React Native --, plan that the thread is proved in the managed Intelligence
98
- dashboard instead.
102
+ drawer -- React Native --, plan that the thread is proved by
103
+ `npx --yes copilotkit@4.9.24 verify --round-trip`, which needs no browser. Do not plan a
104
+ step that opens the managed Intelligence dashboard.
99
105
 
100
106
  ## Order the plan into steps
101
107
 
@@ -38,7 +38,7 @@ from different directories.
38
38
 
39
39
  For the CopilotKit versions, report the exact installed version of every `@copilotkit/*`
40
40
  dependency, read from the lockfile rather than a manifest range, and state whether any of
41
- them is below 1.64.0. The conversion decides its upgrade from exactly that, and a caret
41
+ them is below 1.70.0. The conversion decides its upgrade from exactly that, and a caret
42
42
  range does not answer it.
43
43
 
44
44
  A project states what it is for in its `README.md`, in its package description, or in
@@ -16,7 +16,7 @@ Prove the live runtime in this order:
16
16
  4. Confirm from project files that the runtime constructor passes a `runner` option rather
17
17
  than an `intelligence` option. A package, import, project file, or key is not use proof.
18
18
  5. Run
19
- `npx --yes copilotkit@4.9.17 verify --expect-runtime oss --round-trip --agent <expected-agent-id> --json`,
19
+ `npx --yes copilotkit@4.9.24 verify --expect-runtime oss --round-trip --agent <expected-agent-id> --json`,
20
20
  with the runtime URL or auth header options that this project needs. Require exit zero
21
21
  and the JSON `ok` field to be `true`.
22
22
  6. Drive one real request through the existing frontend, CopilotKit runtime, and expected
@@ -90,8 +90,8 @@ A server that never answered has written the reason to its own output, and readi
90
90
  output is faster than starting it again.
91
91
 
92
92
  Leave the agent and frontend servers running after proof. Record each process ID and a
93
- safe command that stops that process. Record the frontend URL and the commands that start
94
- both servers again.
93
+ safe command that stops that process. Record the frontend URL, written with `localhost`
94
+ rather than an IP literal, and the commands that start both servers again.
95
95
 
96
96
  ## Step 3 -- Identify the process that answered
97
97
 
@@ -120,7 +120,7 @@ IPv6 only, so an IPv4 literal fails against the correct port.
120
120
  ## Step 4 -- Check the wiring
121
121
 
122
122
  With both running, check the wiring in one command before you open a browser:
123
- `npx --yes copilotkit@4.9.17 verify --json`. Add `--runtime-url` when the runtime is not at
123
+ `npx --yes copilotkit@4.9.24 verify --json`. Add `--runtime-url` when the runtime is not at
124
124
  `http://localhost:3000/api/copilotkit`. Read the individual checks rather than the summary
125
125
  alone: a check reported `undetermined` did not run, and that is not a pass. Repair a failed
126
126
  check only within the limits above. Otherwise, return the check and its evidence before the
@@ -136,7 +136,7 @@ thread-endpoint state exists, the runtime predates the field. Record that and co
136
136
 
137
137
  ## Step 5 -- Prove that the agent runs
138
138
 
139
- Run `npx --yes copilotkit@4.9.17 verify --round-trip --json`. It sends one request through
139
+ Run `npx --yes copilotkit@4.9.24 verify --round-trip --json`. It sends one request through
140
140
  the runtime and reads the answer back from the thread, so it separates an agent that is
141
141
  configured from an agent that works. Use `--agent <id>` when the runtime declares more
142
142
  than one. If it reports `user-not-identified`, this project's `identifyUser` reads a
@@ -212,8 +212,9 @@ journey, and the graph ends such a run as blocked rather than complete.
212
212
  For a recorded `both-oss` starting state, this step has no component to render. Send the
213
213
  same request the baseline recorded, require the same kind of user-visible result the
214
214
  baseline produced, and require that the thread for that request is listed in the drawer.
215
- Where this journey's frontend framework ships no threads drawer -- React Native --, find
216
- that thread in the managed Intelligence dashboard and record which of the two you proved.
215
+ Where this journey's frontend framework ships no threads drawer -- React Native --, prove
216
+ that thread with `npx --yes copilotkit@4.9.24 verify --round-trip`, which reads the
217
+ answer back off the thread and needs no browser. Record which of the two you proved.
217
218
 
218
219
  Use the surface control the main coding agent recorded for your environment. It either had
219
220
  one already or registered one before this step, so that finding is the answer and there is
@@ -237,6 +238,10 @@ The surface is a browser, and it also covers browser-origin CORS and CSP, which
237
238
  request never exercises. Drive it with the browser control step 6 named.
238
239
 
239
240
  1. Open the frontend URL from step 2 and wait for the page to finish loading.
241
+ Address it as `localhost` rather than an IP literal, for the reason step 3 gives
242
+ for the agent. A dev server reached on the IP literal can refuse its own static
243
+ assets, and a page that loads without them leaves the chat control dead. That
244
+ reads as a broken integration rather than as the host name you used.
240
245
  2. Take one page snapshot. Record whether the CopilotKit surface is on the page. A page
241
246
  that renders without it is a wiring failure rather than a proof to retry.
242
247
  3. Read the browser console before you type anything, and record every error already
@@ -317,6 +322,12 @@ result. The runtime must now report `licenseStatus`, and the authenticated Intel
317
322
  checks must pass. A thread for that request must be persisted and visible. Record both
318
323
  before and after evidence, and record that the criterion was `conversion-v1`.
319
324
 
325
+ `licenseStatus` reports `unknown` while the runtime entitlement lookup for this project
326
+ has not resolved yet. That value is transient rather than a failure, and the drawer
327
+ renders its locked view for as long as it stands. Re-read `/info` and re-open the drawer
328
+ before you judge either one. Criterion 4 requires `licenseStatus` to be present, and a
329
+ present `unknown` meets it.
330
+
320
331
  For every other starting state, record Step 8 as not applicable.
321
332
 
322
333
  The application edit ban ends only after Step 8 passes or is recorded as not applicable.
@@ -26,13 +26,13 @@ Before you show the best-effort plan, require this complete packet:
26
26
  - Give the ordered proof rules.
27
27
 
28
28
  After the developer approves the best-effort plan, run
29
- `npx --yes copilotkit@4.9.17 onboard read fallback/best-effort`.
29
+ `npx --yes copilotkit@4.9.24 onboard read fallback/best-effort`.
30
30
 
31
31
  Send one short report. Run the feedback command without another developer question. The
32
32
  CLI telemetry gate decides whether the report is sent.
33
33
 
34
34
  ```text
35
- npx --yes copilotkit@4.9.17 onboard feedback
35
+ npx --yes copilotkit@4.9.24 onboard feedback
36
36
  ```
37
37
 
38
38
  Write the feedback message to the command's standard input, in at most four lines.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "copilotkit",
3
- "version": "4.9.17",
3
+ "version": "4.9.24",
4
4
  "type": "module",
5
5
  "repository": {
6
6
  "type": "git",
@@ -14698,7 +14698,7 @@ import * as path4 from "node:path";
14698
14698
 
14699
14699
  // apps/cli/src/config.ts
14700
14700
  function getTemplateRef() {
14701
- return true ? "f08f478cf73c46d34e8db03dedcc61f695f9b9b5" : "main";
14701
+ return true ? "2d44d3ff00910e9f3494d5e57aaa7bdd69a82e04" : "main";
14702
14702
  }
14703
14703
 
14704
14704
  // apps/cli/src/services/agentcore-config.ts