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.
- package/README.md +286 -35
- package/cli-build-info.json +8 -8
- package/index.js +7469 -3899
- package/onboarding/index.json +2 -2
- package/onboarding/prompts/authenticate/start.md +28 -23
- package/onboarding/prompts/conversion/plan.md +3 -3
- package/onboarding/prompts/credentials/finalize-plan.md +35 -26
- package/onboarding/prompts/credentials/plan.md +46 -33
- package/onboarding/prompts/credentials/settle-credentials.md +41 -16
- package/onboarding/prompts/credentials/write-plan.md +104 -47
- package/onboarding/prompts/deployment/choose-local.md +17 -20
- package/onboarding/prompts/deployment/local-evaluation.md +45 -21
- package/onboarding/prompts/fallback/best-effort.md +11 -9
- package/onboarding/prompts/feature/a2ui/implement.md +4 -4
- package/onboarding/prompts/feature/a2ui/plan.md +3 -3
- package/onboarding/prompts/feature/a2ui/proof.md +5 -5
- package/onboarding/prompts/feature/a2ui/start.md +10 -8
- package/onboarding/prompts/feature/channels/implement.md +11 -8
- package/onboarding/prompts/feature/channels/plan.md +15 -7
- package/onboarding/prompts/feature/channels/proof.md +5 -5
- package/onboarding/prompts/feature/channels/start.md +11 -10
- package/onboarding/prompts/feature/chat-suggestions/implement.md +4 -4
- package/onboarding/prompts/feature/chat-suggestions/plan.md +3 -3
- package/onboarding/prompts/feature/chat-suggestions/proof.md +5 -5
- package/onboarding/prompts/feature/chat-suggestions/start.md +10 -8
- package/onboarding/prompts/feature/complete.md +2 -2
- package/onboarding/prompts/feature/learning/implement.md +14 -12
- package/onboarding/prompts/feature/learning/plan.md +4 -4
- package/onboarding/prompts/feature/learning/proof.md +24 -14
- package/onboarding/prompts/feature/learning/start.md +8 -8
- package/onboarding/prompts/feature/open-generative-ui/implement.md +4 -4
- package/onboarding/prompts/feature/open-generative-ui/plan.md +3 -3
- package/onboarding/prompts/feature/open-generative-ui/proof.md +5 -5
- package/onboarding/prompts/feature/open-generative-ui/start.md +10 -8
- package/onboarding/prompts/feature/realtime-sync/implement.md +7 -5
- package/onboarding/prompts/feature/realtime-sync/plan.md +3 -3
- package/onboarding/prompts/feature/realtime-sync/proof.md +5 -5
- package/onboarding/prompts/feature/realtime-sync/start.md +7 -7
- package/onboarding/prompts/feature/rich-threads/implement.md +8 -6
- package/onboarding/prompts/feature/rich-threads/plan.md +3 -3
- package/onboarding/prompts/feature/rich-threads/proof.md +5 -5
- package/onboarding/prompts/feature/rich-threads/start.md +7 -7
- package/onboarding/prompts/feature/stop.md +4 -4
- package/onboarding/prompts/feature/voice/implement.md +4 -4
- package/onboarding/prompts/feature/voice/plan.md +4 -4
- package/onboarding/prompts/feature/voice/proof.md +5 -5
- package/onboarding/prompts/feature/voice/start.md +10 -8
- package/onboarding/prompts/framework/ag2.md +20 -5
- package/onboarding/prompts/framework/agno.md +25 -9
- package/onboarding/prompts/framework/built-in.md +21 -6
- package/onboarding/prompts/framework/claude-sdk-python.md +11 -5
- package/onboarding/prompts/framework/claude-sdk-typescript.md +13 -6
- package/onboarding/prompts/framework/crewai-flows.md +24 -10
- package/onboarding/prompts/framework/custom-ag-ui.md +62 -28
- package/onboarding/prompts/framework/deep-agents.md +26 -9
- package/onboarding/prompts/framework/google-adk.md +18 -5
- package/onboarding/prompts/framework/langgraph-fastapi.md +20 -5
- package/onboarding/prompts/framework/langgraph-python.md +20 -5
- package/onboarding/prompts/framework/langgraph-typescript.md +27 -7
- package/onboarding/prompts/framework/llamaindex.md +24 -8
- package/onboarding/prompts/framework/mastra.md +21 -8
- package/onboarding/prompts/framework/ms-agent-dotnet.md +24 -6
- package/onboarding/prompts/framework/ms-agent-harness-dotnet.md +24 -5
- package/onboarding/prompts/framework/ms-agent-python.md +21 -5
- package/onboarding/prompts/framework/pydantic-ai.md +20 -5
- package/onboarding/prompts/framework/strands-python.md +27 -12
- package/onboarding/prompts/framework/strands-typescript.md +27 -12
- package/onboarding/prompts/frontend/angular.md +4 -4
- package/onboarding/prompts/frontend/nextjs.md +4 -4
- package/onboarding/prompts/frontend/plan.md +21 -13
- package/onboarding/prompts/frontend/react-native.md +3 -3
- package/onboarding/prompts/frontend/react-spa.md +3 -3
- package/onboarding/prompts/frontend/vue.md +3 -3
- package/onboarding/prompts/implementation/build-and-validate.md +25 -20
- package/onboarding/prompts/proof/complete.md +10 -7
- package/onboarding/prompts/proof/oss-baseline.md +6 -6
- package/onboarding/prompts/proof/round-trip.md +10 -10
- package/onboarding/prompts/research/gather.md +8 -8
- package/onboarding/prompts/research/merge.md +3 -3
- package/onboarding/prompts/research/preflight.md +2 -2
- package/onboarding/prompts/research/route.md +4 -4
- package/onboarding/prompts/setup/questions.md +193 -158
- package/onboarding/prompts/starter/clone.md +129 -54
- package/onboarding/prompts/stopped/run-failed.md +5 -3
- package/onboarding/prompts/subagent/create-plan.md +80 -23
- package/onboarding/prompts/subagent/implement-and-validate.md +33 -14
- package/onboarding/prompts/subagent/inspect-repository.md +3 -2
- package/onboarding/prompts/subagent/prove-oss-baseline.md +10 -5
- package/onboarding/prompts/subagent/prove-round-trip.md +23 -14
- package/onboarding/prompts/unsupported/no-validated-path.md +5 -4
- package/package.json +1 -1
- 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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
122
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|