copilotkit 4.25.1 → 4.27.0

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 (92) hide show
  1. package/README.md +286 -35
  2. package/cli-build-info.json +8 -8
  3. package/index.js +7469 -3899
  4. package/onboarding/index.json +2 -2
  5. package/onboarding/prompts/authenticate/start.md +28 -23
  6. package/onboarding/prompts/conversion/plan.md +3 -3
  7. package/onboarding/prompts/credentials/finalize-plan.md +35 -26
  8. package/onboarding/prompts/credentials/plan.md +46 -33
  9. package/onboarding/prompts/credentials/settle-credentials.md +41 -16
  10. package/onboarding/prompts/credentials/write-plan.md +104 -47
  11. package/onboarding/prompts/deployment/choose-local.md +17 -20
  12. package/onboarding/prompts/deployment/local-evaluation.md +45 -21
  13. package/onboarding/prompts/fallback/best-effort.md +11 -9
  14. package/onboarding/prompts/feature/a2ui/implement.md +4 -4
  15. package/onboarding/prompts/feature/a2ui/plan.md +3 -3
  16. package/onboarding/prompts/feature/a2ui/proof.md +5 -5
  17. package/onboarding/prompts/feature/a2ui/start.md +10 -8
  18. package/onboarding/prompts/feature/channels/implement.md +11 -8
  19. package/onboarding/prompts/feature/channels/plan.md +15 -7
  20. package/onboarding/prompts/feature/channels/proof.md +5 -5
  21. package/onboarding/prompts/feature/channels/start.md +11 -10
  22. package/onboarding/prompts/feature/chat-suggestions/implement.md +4 -4
  23. package/onboarding/prompts/feature/chat-suggestions/plan.md +3 -3
  24. package/onboarding/prompts/feature/chat-suggestions/proof.md +5 -5
  25. package/onboarding/prompts/feature/chat-suggestions/start.md +10 -8
  26. package/onboarding/prompts/feature/complete.md +2 -2
  27. package/onboarding/prompts/feature/learning/implement.md +14 -12
  28. package/onboarding/prompts/feature/learning/plan.md +4 -4
  29. package/onboarding/prompts/feature/learning/proof.md +24 -14
  30. package/onboarding/prompts/feature/learning/start.md +8 -8
  31. package/onboarding/prompts/feature/open-generative-ui/implement.md +4 -4
  32. package/onboarding/prompts/feature/open-generative-ui/plan.md +3 -3
  33. package/onboarding/prompts/feature/open-generative-ui/proof.md +5 -5
  34. package/onboarding/prompts/feature/open-generative-ui/start.md +10 -8
  35. package/onboarding/prompts/feature/realtime-sync/implement.md +7 -5
  36. package/onboarding/prompts/feature/realtime-sync/plan.md +3 -3
  37. package/onboarding/prompts/feature/realtime-sync/proof.md +5 -5
  38. package/onboarding/prompts/feature/realtime-sync/start.md +7 -7
  39. package/onboarding/prompts/feature/rich-threads/implement.md +8 -6
  40. package/onboarding/prompts/feature/rich-threads/plan.md +3 -3
  41. package/onboarding/prompts/feature/rich-threads/proof.md +5 -5
  42. package/onboarding/prompts/feature/rich-threads/start.md +7 -7
  43. package/onboarding/prompts/feature/stop.md +4 -4
  44. package/onboarding/prompts/feature/voice/implement.md +4 -4
  45. package/onboarding/prompts/feature/voice/plan.md +4 -4
  46. package/onboarding/prompts/feature/voice/proof.md +5 -5
  47. package/onboarding/prompts/feature/voice/start.md +10 -8
  48. package/onboarding/prompts/framework/ag2.md +20 -5
  49. package/onboarding/prompts/framework/agno.md +25 -9
  50. package/onboarding/prompts/framework/built-in.md +21 -6
  51. package/onboarding/prompts/framework/claude-sdk-python.md +11 -5
  52. package/onboarding/prompts/framework/claude-sdk-typescript.md +13 -6
  53. package/onboarding/prompts/framework/crewai-flows.md +24 -10
  54. package/onboarding/prompts/framework/custom-ag-ui.md +62 -28
  55. package/onboarding/prompts/framework/deep-agents.md +26 -9
  56. package/onboarding/prompts/framework/google-adk.md +18 -5
  57. package/onboarding/prompts/framework/langgraph-fastapi.md +20 -5
  58. package/onboarding/prompts/framework/langgraph-python.md +20 -5
  59. package/onboarding/prompts/framework/langgraph-typescript.md +27 -7
  60. package/onboarding/prompts/framework/llamaindex.md +24 -8
  61. package/onboarding/prompts/framework/mastra.md +21 -8
  62. package/onboarding/prompts/framework/ms-agent-dotnet.md +24 -6
  63. package/onboarding/prompts/framework/ms-agent-harness-dotnet.md +24 -5
  64. package/onboarding/prompts/framework/ms-agent-python.md +21 -5
  65. package/onboarding/prompts/framework/pydantic-ai.md +20 -5
  66. package/onboarding/prompts/framework/strands-python.md +27 -12
  67. package/onboarding/prompts/framework/strands-typescript.md +27 -12
  68. package/onboarding/prompts/frontend/angular.md +4 -4
  69. package/onboarding/prompts/frontend/nextjs.md +4 -4
  70. package/onboarding/prompts/frontend/plan.md +21 -13
  71. package/onboarding/prompts/frontend/react-native.md +3 -3
  72. package/onboarding/prompts/frontend/react-spa.md +3 -3
  73. package/onboarding/prompts/frontend/vue.md +3 -3
  74. package/onboarding/prompts/implementation/build-and-validate.md +25 -20
  75. package/onboarding/prompts/proof/complete.md +10 -7
  76. package/onboarding/prompts/proof/oss-baseline.md +6 -6
  77. package/onboarding/prompts/proof/round-trip.md +10 -10
  78. package/onboarding/prompts/research/gather.md +8 -8
  79. package/onboarding/prompts/research/merge.md +3 -3
  80. package/onboarding/prompts/research/preflight.md +2 -2
  81. package/onboarding/prompts/research/route.md +4 -4
  82. package/onboarding/prompts/setup/questions.md +193 -158
  83. package/onboarding/prompts/starter/clone.md +129 -54
  84. package/onboarding/prompts/stopped/run-failed.md +5 -3
  85. package/onboarding/prompts/subagent/create-plan.md +80 -23
  86. package/onboarding/prompts/subagent/implement-and-validate.md +33 -14
  87. package/onboarding/prompts/subagent/inspect-repository.md +3 -2
  88. package/onboarding/prompts/subagent/prove-oss-baseline.md +10 -5
  89. package/onboarding/prompts/subagent/prove-round-trip.md +23 -14
  90. package/onboarding/prompts/unsupported/no-validated-path.md +5 -4
  91. package/package.json +1 -1
  92. package/release/release-tool.js +12 -2
@@ -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 --prefer-offline --yes copilotkit@4.25.1 onboard read subagent/prove-round-trip` first and follow the
4
+ `npx --prefer-offline --yes copilotkit@4.27.0 onboard read subagent/prove-round-trip` first and follow the
5
5
  prompt it returns. Tell it to return at once, and say so, if that read is refused or fails,
6
6
  and not to wait for an approval. If it returns that way, stop that subagent. Run the same
7
7
  command yourself, then spawn a fresh subagent with the returned prompt and the same handoff.
@@ -41,7 +41,7 @@ pass the time.
41
41
  Record what that proof returned before you route on it:
42
42
 
43
43
  ```text
44
- npx --prefer-offline --yes copilotkit@4.25.1 onboard proof --step round-trip --outcome <passed|failed|skipped>
44
+ npx --prefer-offline --yes copilotkit@4.27.0 onboard proof --step round-trip --outcome <passed|failed|skipped>
45
45
  ```
46
46
 
47
47
  Report the gate whatever it returned. A proof that never ran is `skipped`, not failed. A
@@ -53,7 +53,7 @@ the next one starts. Until then, `onboard proof-check` counts the next failure a
53
53
  If the CLI prints `## Stop: this run deleted or moved the developer's work` instead of a
54
54
  step, show the developer the list it printed, and run what they choose:
55
55
  the `onboard restore` command the tripwire stop prints, which names each deleted file, or
56
- `npx --prefer-offline --yes copilotkit@4.25.1 onboard tripwire --continue`. Then read the step again. If
56
+ `npx --prefer-offline --yes copilotkit@4.27.0 onboard tripwire --continue`. Then read the step again. If
57
57
  you cannot ask, use the route-out rules below.
58
58
 
59
59
  Never repair, reset, or revert a file the developer changed outside this run. That holds for
@@ -66,11 +66,11 @@ This prompt pauses for the developer in several places. Before you end your turn
66
66
  for the developer, report the pause:
67
67
 
68
68
  ```text
69
- npx --prefer-offline --yes copilotkit@4.25.1 onboard checkpoint --phase awaiting-developer
69
+ npx --prefer-offline --yes copilotkit@4.27.0 onboard checkpoint --phase awaiting-developer
70
70
  ```
71
71
 
72
72
  If the proof result starts with `Status: passed`, run
73
- `npx --prefer-offline --yes copilotkit@4.25.1 onboard read proof/complete`. A performed surface outcome with
73
+ `npx --prefer-offline --yes copilotkit@4.27.0 onboard read proof/complete`. A performed surface outcome with
74
74
  the full round trip is core success even if a continued-development tool fails. A skipped
75
75
  surface outcome still enters `proof/complete`. The CLI records `skipped-cloned-starter` and
76
76
  `skipped-no-browser-tool` after a passed round trip as complete, and `skipped-no-device` as
@@ -97,7 +97,7 @@ credentials step found the model key missing, or the vendor refused it, and the
97
97
  started nothing. Do not send it to a repair worker. Run the `onboard credentials` command
98
98
  that its detail names, and act on its answer as `credentials/settle-credentials` says. Ask
99
99
  the developer its question, report the pause with
100
- `npx --prefer-offline --yes copilotkit@4.25.1 onboard checkpoint --phase awaiting-model-credential`, and
100
+ `npx --prefer-offline --yes copilotkit@4.27.0 onboard checkpoint --phase awaiting-model-credential`, and
101
101
  end your turn. When the key settles, run the proof subagent again. If you have not recorded
102
102
  this attempt yet, record it first, with the outcome it ended with. This attempt does not
103
103
  count toward the three.
@@ -124,7 +124,7 @@ fault, so this is not a route-out. Ask the developer to send one message in the
124
124
  thread, and to give you that thread's id. Give them the app URL and the request words from
125
125
  the result. Tell them where the id is: in the browser's network tools, the request the page
126
126
  sends to the runtime URL carries `threadId` in its body. Report the pause with
127
- `npx --prefer-offline --yes copilotkit@4.25.1 onboard checkpoint --phase awaiting-developer` and end your
127
+ `npx --prefer-offline --yes copilotkit@4.27.0 onboard checkpoint --phase awaiting-developer` and end your
128
128
  turn. When the developer gives the id, start a new proof subagent with
129
129
  the full original proof handoff, the pinned Step 1 record, and the thread id. Tell it to run
130
130
  the proof checks with `--thread <id>`. This attempt does not count toward the three. Use the
@@ -173,7 +173,7 @@ files the developer allowed, and the developer's answer on the Skills install.
173
173
  Before you end your turn to wait for the developer, report the pause:
174
174
 
175
175
  ```text
176
- npx --prefer-offline --yes copilotkit@4.25.1 onboard checkpoint --phase awaiting-developer
176
+ npx --prefer-offline --yes copilotkit@4.27.0 onboard checkpoint --phase awaiting-developer
177
177
  ```
178
178
 
179
179
  Restart each project-owned process changed by the repair. Then spawn a fresh proof subagent
@@ -191,7 +191,7 @@ takes the developer path above instead.
191
191
 
192
192
  Route out only when the failure is not yours to fix, when the same proof still fails after
193
193
  three attempts, or when no evidence of the round trip can be produced. In those cases run
194
- `npx --prefer-offline --yes copilotkit@4.25.1 onboard read stopped/run-failed`. The stack is supported:
194
+ `npx --prefer-offline --yes copilotkit@4.27.0 onboard read stopped/run-failed`. The stack is supported:
195
195
  this run did not finish, which is a different ending and a different report. All three are
196
196
  about the round trip itself. A round trip that proved is not one of them, whatever failed
197
197
  after it.
@@ -202,7 +202,7 @@ friction command follows the telemetry setting the developer already chose, so i
202
202
  separate question.
203
203
 
204
204
  ```text
205
- npx --prefer-offline --yes copilotkit@4.25.1 onboard friction --phase stop --category <slug> --message "<sentences>"
205
+ npx --prefer-offline --yes copilotkit@4.27.0 onboard friction --phase stop --category <slug> --message "<sentences>"
206
206
  ```
207
207
 
208
208
  `--message` takes one or two sentences: the step you stopped at and what stopped it.
@@ -14,10 +14,10 @@ own bookkeeping. Say what the run is doing in the developer's words instead.
14
14
 
15
15
  Every later command must run from the directory this run is bound to. Elsewhere, the
16
16
  command cannot find its run and refuses. Do not report that refusal as a stop. Run
17
- `npx --prefer-offline --yes copilotkit@4.25.1 onboard start --run <onboarding_run_id>` where you are
17
+ `npx --prefer-offline --yes copilotkit@4.27.0 onboard start --run <onboarding_run_id>` where you are
18
18
  standing, then run the refused command again.
19
19
 
20
- If you no longer hold the id, run `npx --prefer-offline --yes copilotkit@4.25.1 onboard start` in the
20
+ If you no longer hold the id, run `npx --prefer-offline --yes copilotkit@4.27.0 onboard start` in the
21
21
  directory this run started in, with no `--run` and no `--intent`. It reprints the id
22
22
  and starts nothing. An id this project does not already hold starts a second
23
23
  run, and the work already done stops counting toward the first.
@@ -82,7 +82,7 @@ When that thing arrives, continue. A pause waits for one of two things:
82
82
  Before you end your turn to wait for the developer, report the pause:
83
83
 
84
84
  ```text
85
- npx --prefer-offline --yes copilotkit@4.25.1 onboard checkpoint --phase awaiting-developer
85
+ npx --prefer-offline --yes copilotkit@4.27.0 onboard checkpoint --phase awaiting-developer
86
86
  ```
87
87
 
88
88
  When the answer or the result arrives, continue from the step that paused. Do not read an
@@ -102,7 +102,7 @@ Both research subagents failing means this harness has no working subagent at al
102
102
  is worth recording once:
103
103
 
104
104
  ```text
105
- npx --prefer-offline --yes copilotkit@4.25.1 onboard checkpoint --phase delegation-unavailable
105
+ npx --prefer-offline --yes copilotkit@4.27.0 onboard checkpoint --phase delegation-unavailable
106
106
  ```
107
107
 
108
108
  Then say once, in your own words, that this environment has no working subagents. Say that
@@ -118,8 +118,8 @@ Prepare two research assignments. Before you spawn either subagent, run these tw
118
118
  read-only commands yourself, from the target project directory:
119
119
 
120
120
  ```text
121
- npx --prefer-offline --yes copilotkit@4.25.1 onboard read subagent/inspect-repository
122
- npx --prefer-offline --yes copilotkit@4.25.1 onboard inspect --json
121
+ npx --prefer-offline --yes copilotkit@4.27.0 onboard read subagent/inspect-repository
122
+ npx --prefer-offline --yes copilotkit@4.27.0 onboard inspect --json
123
123
  ```
124
124
 
125
125
  Give each research subagent the prompt that the first command returns, the whole JSON that
@@ -140,8 +140,8 @@ Start both research subagents in parallel:
140
140
  The research is under way. Continue to the surface-control preflight while it runs:
141
141
 
142
142
  ```text
143
- npx --prefer-offline --yes copilotkit@4.25.1 onboard read research/preflight
143
+ npx --prefer-offline --yes copilotkit@4.27.0 onboard read research/preflight
144
144
  ```
145
145
 
146
146
  If inspection stops onboarding, run
147
- `npx --prefer-offline --yes copilotkit@4.25.1 onboard read stopped/run-failed`.
147
+ `npx --prefer-offline --yes copilotkit@4.27.0 onboard read stopped/run-failed`.
@@ -51,11 +51,11 @@ waits on the developer, end your turn and wait for it: that is a pause.
51
51
  Before you end your turn to wait for the developer, report the pause:
52
52
 
53
53
  ```text
54
- npx --prefer-offline --yes copilotkit@4.25.1 onboard checkpoint --phase awaiting-developer
54
+ npx --prefer-offline --yes copilotkit@4.27.0 onboard checkpoint --phase awaiting-developer
55
55
  ```
56
56
 
57
57
  When both research results are merged and sign-in is done, run
58
- `npx --prefer-offline --yes copilotkit@4.25.1 onboard read research/route`.
58
+ `npx --prefer-offline --yes copilotkit@4.27.0 onboard read research/route`.
59
59
 
60
60
  If inspection stops onboarding, run
61
- `npx --prefer-offline --yes copilotkit@4.25.1 onboard read stopped/run-failed`.
61
+ `npx --prefer-offline --yes copilotkit@4.27.0 onboard read stopped/run-failed`.
@@ -32,8 +32,8 @@ Where the device probe found no booted device, that is the whole finding.
32
32
  Then merge the research:
33
33
 
34
34
  ```text
35
- npx --prefer-offline --yes copilotkit@4.25.1 onboard read research/merge
35
+ npx --prefer-offline --yes copilotkit@4.27.0 onboard read research/merge
36
36
  ```
37
37
 
38
38
  If inspection stops onboarding, run
39
- `npx --prefer-offline --yes copilotkit@4.25.1 onboard read stopped/run-failed`.
39
+ `npx --prefer-offline --yes copilotkit@4.27.0 onboard read stopped/run-failed`.
@@ -21,7 +21,7 @@ On any one of them, run this before you read the three findings below, and witho
21
21
  the purpose question:
22
22
 
23
23
  ```text
24
- npx --prefer-offline --yes copilotkit@4.25.1 onboard read feature/channels/start
24
+ npx --prefer-offline --yes copilotkit@4.27.0 onboard read feature/channels/start
25
25
  ```
26
26
 
27
27
  Name the provider to that node so it does not ask again. A `/slack` page names Slack. A
@@ -82,7 +82,7 @@ settle these three from your own reading of the project. Each one comes from the
82
82
  packets or it is not proved.
83
83
 
84
84
  If all three are proved, prove the live starting state before any project file changes. Run
85
- `npx --prefer-offline --yes copilotkit@4.25.1 onboard read proof/oss-baseline`.
85
+ `npx --prefer-offline --yes copilotkit@4.27.0 onboard read proof/oss-baseline`.
86
86
 
87
87
  Route there before any other question to the developer. The questions after this prompt
88
88
  select a framework and a frontend that the findings already name, so a developer who
@@ -91,10 +91,10 @@ application is what that node protects. Whether it works is what the proof decid
91
91
  these three findings.
92
92
 
93
93
  For every other combination of the three, run
94
- `npx --prefer-offline --yes copilotkit@4.25.1 onboard read setup/questions`. That node asks every
94
+ `npx --prefer-offline --yes copilotkit@4.27.0 onboard read setup/questions`. That node asks every
95
95
  remaining setup question in one message, including what the project is for when nothing
96
96
  proves it.
97
97
 
98
98
  If authentication or inspection stops onboarding, run
99
- `npx --prefer-offline --yes copilotkit@4.25.1 onboard read stopped/run-failed`. Neither says anything
99
+ `npx --prefer-offline --yes copilotkit@4.27.0 onboard read stopped/run-failed`. Neither says anything
100
100
  about whether this project's stack is supported, which is not yet known at this point.