copilotkit 4.9.24 → 4.9.31
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 +141 -53
- package/cli-build-info.json +8 -8
- package/index.js +4460 -3157
- package/onboarding/index.json +1 -1
- package/onboarding/prompts/authenticate/start.md +27 -8
- package/onboarding/prompts/conversion/plan.md +6 -5
- package/onboarding/prompts/credentials/finalize-plan.md +39 -26
- package/onboarding/prompts/credentials/plan.md +20 -20
- package/onboarding/prompts/fallback/best-effort.md +15 -7
- package/onboarding/prompts/framework/ag2.md +2 -2
- package/onboarding/prompts/framework/agno.md +2 -2
- package/onboarding/prompts/framework/built-in.md +2 -2
- package/onboarding/prompts/framework/claude-sdk-python.md +2 -2
- package/onboarding/prompts/framework/claude-sdk-typescript.md +2 -2
- package/onboarding/prompts/framework/crewai-flows.md +2 -2
- package/onboarding/prompts/framework/deep-agents.md +2 -2
- package/onboarding/prompts/framework/google-adk.md +2 -2
- package/onboarding/prompts/framework/langgraph-fastapi.md +2 -2
- package/onboarding/prompts/framework/langgraph-python.md +2 -2
- package/onboarding/prompts/framework/langgraph-typescript.md +2 -2
- package/onboarding/prompts/framework/llamaindex.md +2 -2
- package/onboarding/prompts/framework/mastra.md +2 -2
- package/onboarding/prompts/framework/ms-agent-dotnet.md +2 -2
- package/onboarding/prompts/framework/ms-agent-harness-dotnet.md +2 -2
- package/onboarding/prompts/framework/ms-agent-python.md +2 -2
- package/onboarding/prompts/framework/pydantic-ai.md +2 -2
- package/onboarding/prompts/framework/strands-python.md +2 -2
- package/onboarding/prompts/framework/strands-typescript.md +2 -2
- package/onboarding/prompts/frontend/angular.md +32 -4
- package/onboarding/prompts/frontend/nextjs.md +3 -3
- package/onboarding/prompts/frontend/plan.md +6 -6
- package/onboarding/prompts/frontend/react-native.md +2 -2
- package/onboarding/prompts/frontend/react-spa.md +2 -2
- package/onboarding/prompts/frontend/vue.md +2 -2
- package/onboarding/prompts/implementation/build-and-validate.md +32 -10
- package/onboarding/prompts/proof/complete.md +10 -6
- package/onboarding/prompts/proof/oss-baseline.md +13 -6
- package/onboarding/prompts/proof/round-trip.md +16 -8
- package/onboarding/prompts/starter/clone.md +4 -4
- package/onboarding/prompts/subagent/create-plan.md +23 -1
- package/onboarding/prompts/subagent/implement-and-validate.md +30 -1
- package/onboarding/prompts/subagent/prove-oss-baseline.md +16 -7
- package/onboarding/prompts/subagent/prove-round-trip.md +17 -7
- package/onboarding/prompts/unsupported/no-validated-path.md +6 -2
- package/package.json +1 -1
- package/release/release-tool.js +15 -1
package/onboarding/index.json
CHANGED
|
@@ -16,7 +16,7 @@ Every later command must run from the directory this run started in. A command r
|
|
|
16
16
|
somewhere else, such as a sibling of that directory, is refused rather than answered,
|
|
17
17
|
because the run it belongs to cannot be found from there. That refusal is a step to take,
|
|
18
18
|
not a stop to report: run
|
|
19
|
-
`npx --yes copilotkit@4.9.
|
|
19
|
+
`npx --yes copilotkit@4.9.31 onboard start --run <onboarding_run_id>` in the directory
|
|
20
20
|
you are now in, which binds it to the same run, then run the refused command again. Do not
|
|
21
21
|
start a run without that id. A run started without it is a second run, and the work already
|
|
22
22
|
done stops counting toward the first.
|
|
@@ -50,7 +50,7 @@ without another developer question. The CLI telemetry gate decides whether the r
|
|
|
50
50
|
sent.
|
|
51
51
|
|
|
52
52
|
```text
|
|
53
|
-
npx --yes copilotkit@4.9.
|
|
53
|
+
npx --yes copilotkit@4.9.31 onboard feedback
|
|
54
54
|
```
|
|
55
55
|
|
|
56
56
|
Write at most four lines to the command's standard input: the step you stopped at and what
|
|
@@ -67,7 +67,7 @@ Until now the route out of an unsupported path was the only place that asked for
|
|
|
67
67
|
so a stop anywhere else left no trace at all. A stop nobody hears about is a stop this
|
|
68
68
|
graph cannot fix.
|
|
69
69
|
|
|
70
|
-
Run `npx --yes copilotkit@4.9.
|
|
70
|
+
Run `npx --yes copilotkit@4.9.31 login --json` before any project work. This command
|
|
71
71
|
checks the current session. It starts sign-in only as needed. Treat this as a long-lived
|
|
72
72
|
streaming process. Do not wait for the command to exit before you read its standard output.
|
|
73
73
|
|
|
@@ -84,11 +84,30 @@ Read each JSON Lines record as the running command writes it:
|
|
|
84
84
|
Do not use `whoami` for this check. It has no JSON output and some failures exit with code
|
|
85
85
|
zero. Do not put account tokens or credentials in the conversation.
|
|
86
86
|
|
|
87
|
+
## How to wait for a subagent
|
|
88
|
+
|
|
89
|
+
This rule covers every subagent this run spawns, here and in every later prompt.
|
|
90
|
+
|
|
91
|
+
Spawning a subagent returns almost at once. That return is the dispatch succeeding, not the
|
|
92
|
+
work finishing: the subagent runs in the background, and its result reaches you as a
|
|
93
|
+
notification. Where your own harness hands you the report from the dispatch itself instead,
|
|
94
|
+
you already hold the result. Either way there is nothing to poll.
|
|
95
|
+
|
|
96
|
+
After you dispatch, do the work that does not depend on the result -- dispatch the other
|
|
97
|
+
subagent, run the preflight below -- and then stop and wait. Wherever a prompt in this graph
|
|
98
|
+
says to wait for a subagent to finish, that is what it means.
|
|
99
|
+
|
|
100
|
+
Do not sleep to pass the time. Not `sleep`, not `/bin/sleep`, not a timer under another
|
|
101
|
+
name, and not a loop that re-checks whether a result has arrived. Sleeping tells you nothing
|
|
102
|
+
that waiting for the result does not, and it spends wall clock, which is one of the things
|
|
103
|
+
this journey is measured on. One recorded run spent most of two hours asleep between
|
|
104
|
+
dispatches that had all returned in seconds.
|
|
105
|
+
|
|
87
106
|
Before you ask the developer any setup question, finish every read-only investigation and
|
|
88
107
|
preflight check in this section.
|
|
89
108
|
|
|
90
109
|
Prepare two research assignments. Give each research subagent one assignment. Tell it to run
|
|
91
|
-
`npx --yes copilotkit@4.9.
|
|
110
|
+
`npx --yes copilotkit@4.9.31 onboard read subagent/inspect-repository` first and follow the
|
|
92
111
|
prompt it returns. If that read fails because the subagent cannot use the shell, stop that
|
|
93
112
|
subagent. Run the same command yourself, then spawn a fresh subagent with the returned prompt
|
|
94
113
|
and the same handoff. Require only its assigned packet.
|
|
@@ -171,7 +190,7 @@ both workers return the same one target app directory. Both results must start w
|
|
|
171
190
|
Before you route on, run this from the target app directory:
|
|
172
191
|
|
|
173
192
|
```text
|
|
174
|
-
npx --yes copilotkit@4.9.
|
|
193
|
+
npx --yes copilotkit@4.9.31 onboard protect
|
|
175
194
|
```
|
|
176
195
|
|
|
177
196
|
It reads the working tree itself, records every changed or untracked path with a digest,
|
|
@@ -213,7 +232,7 @@ settle these three from your own reading of the project. Each one comes from the
|
|
|
213
232
|
packets or it is not proved.
|
|
214
233
|
|
|
215
234
|
If all three are proved, prove the live starting state before any project file changes. Run
|
|
216
|
-
`npx --yes copilotkit@4.9.
|
|
235
|
+
`npx --yes copilotkit@4.9.31 onboard read proof/oss-baseline`.
|
|
217
236
|
|
|
218
237
|
Route there before you ask the developer anything else. The questions after this prompt
|
|
219
238
|
select a framework and a frontend that the findings already name, so a developer who
|
|
@@ -226,10 +245,10 @@ developer nor the repository findings prove what the project is for, ask one gui
|
|
|
226
245
|
question about the user outcome. This asks what the developer wants to build before you
|
|
227
246
|
select a framework. Give two or three short examples and offer a minimal starter. Record
|
|
228
247
|
the answer and give it to each later subagent. Then run
|
|
229
|
-
`npx --yes copilotkit@4.9.
|
|
248
|
+
`npx --yes copilotkit@4.9.31 onboard read credentials/plan`.
|
|
230
249
|
|
|
231
250
|
Do not ask that question on the route above. A project carrying all three states its
|
|
232
251
|
purpose in the application it already serves.
|
|
233
252
|
|
|
234
253
|
If authentication or inspection stops onboarding, run
|
|
235
|
-
`npx --yes copilotkit@4.9.
|
|
254
|
+
`npx --yes copilotkit@4.9.31 onboard read unsupported/no-validated-path`.
|
|
@@ -79,8 +79,9 @@ steps unchanged. This conversion succeeded when all five are true:
|
|
|
79
79
|
1. The same request the OSS baseline made still produces the same kind of user-visible
|
|
80
80
|
result, on the same frontend.
|
|
81
81
|
2. The runtime is constructed with an `intelligence` option rather than a `runner` option.
|
|
82
|
-
3. `verify --json` exits zero with `ok` true and
|
|
83
|
-
`intelligence_consumed` and
|
|
82
|
+
3. `verify --json` exits zero with `ok` true and every check passing, including
|
|
83
|
+
`intelligence_consumed`, `intelligence_thread_routes`, and
|
|
84
|
+
`api_key_loadable_by_app`.
|
|
84
85
|
4. `/info` now reports `licenseStatus`, which the runtime emits exactly when an
|
|
85
86
|
Intelligence client was constructed and passed.
|
|
86
87
|
5. A thread for that request is persisted and visible to the developer.
|
|
@@ -99,7 +100,7 @@ of this journey, and a drawer that lists nothing is not a reason to mint one. Li
|
|
|
99
100
|
tokens stay a self-hosted concern.
|
|
100
101
|
|
|
101
102
|
Where this journey's frontend framework ships no threads drawer -- React Native --, the
|
|
102
|
-
fifth item is proved by `npx --yes copilotkit@4.9.
|
|
103
|
+
fifth item is proved by `npx --yes copilotkit@4.9.31 verify --round-trip`, which sends a
|
|
103
104
|
real request and reads the answer back off the thread it landed on. The run says which of
|
|
104
105
|
the two it proved. Do not send a run to the managed Intelligence dashboard to prove this.
|
|
105
106
|
An authenticated browser session at a hosted dashboard is the one thing an agent-driven run
|
|
@@ -107,7 +108,7 @@ cannot produce, so a criterion that asks for one can never be met on this route.
|
|
|
107
108
|
|
|
108
109
|
Record this criterion as `conversion-v1` for the run report.
|
|
109
110
|
|
|
110
|
-
Then run `npx --yes copilotkit@4.9.
|
|
111
|
+
Then run `npx --yes copilotkit@4.9.31 onboard read credentials/finalize-plan`.
|
|
111
112
|
|
|
112
113
|
If a selected page does not load after the second method, run
|
|
113
|
-
`npx --yes copilotkit@4.9.
|
|
114
|
+
`npx --yes copilotkit@4.9.31 onboard read unsupported/no-validated-path`.
|
|
@@ -14,15 +14,16 @@ project to use. Keep final plan approval as its own later question.
|
|
|
14
14
|
|
|
15
15
|
## If you stop in this phase
|
|
16
16
|
|
|
17
|
-
Several rules below stop onboarding: a refused classification value,
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
17
|
+
Several rules below stop onboarding: a refused classification value, a project selection
|
|
18
|
+
that reports a false field, a failed credential check, a model credential nobody can
|
|
19
|
+
place. Each one ends a run that reached project selection and never got a plan, and more
|
|
20
|
+
runs stop here than anywhere else. Name the exact file, value, or check that stopped you:
|
|
21
|
+
a report that names only the step cannot be acted on. Send one short report before you
|
|
22
|
+
stop. Run the feedback command without another developer question. The CLI telemetry gate
|
|
23
|
+
decides whether the report is sent.
|
|
23
24
|
|
|
24
25
|
```text
|
|
25
|
-
npx --yes copilotkit@4.9.
|
|
26
|
+
npx --yes copilotkit@4.9.31 onboard feedback
|
|
26
27
|
```
|
|
27
28
|
|
|
28
29
|
Write at most four lines to standard input: the step you stopped at and what stopped it.
|
|
@@ -45,7 +46,7 @@ starts. Choose one starting state: empty, agent-only, frontend-only, both, both-
|
|
|
45
46
|
Run this command with the exact selected slugs:
|
|
46
47
|
|
|
47
48
|
```text
|
|
48
|
-
npx --yes copilotkit@4.9.
|
|
49
|
+
npx --yes copilotkit@4.9.31 onboard classify --starting-state <starting-state> --agent-framework <agent-framework> --frontend <frontend>
|
|
49
50
|
```
|
|
50
51
|
|
|
51
52
|
Do not continue if a value is refused. Fix the value from the choices that the earlier
|
|
@@ -103,9 +104,17 @@ the repository root. If no repository exists, use the target. If the repository
|
|
|
103
104
|
home directory, use the target.
|
|
104
105
|
|
|
105
106
|
Before project selection, derive the expected project-record path from the repository
|
|
106
|
-
findings. Compare that path and the environment path with the
|
|
107
|
-
the path-segment overlap rule.
|
|
108
|
-
|
|
107
|
+
findings. Compare that path and the environment path with the paths the first capture
|
|
108
|
+
printed as `protected`. Use the path-segment overlap rule. Ignore every path it printed as
|
|
109
|
+
`deferred`. Those are the files project selection exists to write, so the environment path
|
|
110
|
+
always overlaps one of them, and a run that stops on that overlap never reaches the step
|
|
111
|
+
that provisions its key.
|
|
112
|
+
|
|
113
|
+
If an output path overlaps a `protected` path, do not stop. Name the path, say what
|
|
114
|
+
project selection writes there, list that file in the plan with every other change, and
|
|
115
|
+
carry on. Nothing before project selection ends the run. It is the step that provisions
|
|
116
|
+
this project's key, so a run that stops earlier leaves the developer with no key and no
|
|
117
|
+
way to finish.
|
|
109
118
|
|
|
110
119
|
### Create a project for this directory
|
|
111
120
|
|
|
@@ -131,7 +140,7 @@ passes against the wrong one.
|
|
|
131
140
|
Create it, from the target directory:
|
|
132
141
|
|
|
133
142
|
```text
|
|
134
|
-
npx --yes copilotkit@4.9.
|
|
143
|
+
npx --yes copilotkit@4.9.31 project select --create <name> --json
|
|
135
144
|
```
|
|
136
145
|
|
|
137
146
|
If the command fails as a duplicate, the organization already holds that display name and
|
|
@@ -145,13 +154,13 @@ Take this branch only when the developer asks for an existing project, or asks t
|
|
|
145
154
|
projects they have. Read the choices:
|
|
146
155
|
|
|
147
156
|
```text
|
|
148
|
-
npx --yes copilotkit@4.9.
|
|
157
|
+
npx --yes copilotkit@4.9.31 project list --json
|
|
149
158
|
```
|
|
150
159
|
|
|
151
160
|
Narrow them:
|
|
152
161
|
|
|
153
162
|
```text
|
|
154
|
-
npx --yes copilotkit@4.9.
|
|
163
|
+
npx --yes copilotkit@4.9.31 project list --search <query> --json
|
|
155
164
|
```
|
|
156
165
|
|
|
157
166
|
With `--json` the payload is the only thing on standard output, so it is safe to parse. Do
|
|
@@ -163,7 +172,7 @@ this directory's.
|
|
|
163
172
|
Then record the project they name, from the target directory:
|
|
164
173
|
|
|
165
174
|
```text
|
|
166
|
-
npx --yes copilotkit@4.9.
|
|
175
|
+
npx --yes copilotkit@4.9.31 project select --project <slug-or-id> --json
|
|
167
176
|
```
|
|
168
177
|
|
|
169
178
|
The two flags cannot be combined. A slug that does not exist fails and lists the real ones,
|
|
@@ -173,9 +182,13 @@ Read the JSON result. It reports `selected_project_slug`, `config_path`,
|
|
|
173
182
|
`api_key_provisioned`, `project_file_written`, and `environment_file_written` at the top
|
|
174
183
|
level. The result does not contain a secret. Report `selected_project_slug` as the project
|
|
175
184
|
slug that the server selected or created. Require `api_key_provisioned`,
|
|
176
|
-
`project_file_written`, and `environment_file_written` to be true.
|
|
177
|
-
|
|
178
|
-
|
|
185
|
+
`project_file_written`, and `environment_file_written` to be true.
|
|
186
|
+
|
|
187
|
+
A run that wrote the project record without a key exits 75 and reports `"type": "partial"`
|
|
188
|
+
with a `retry_command`. That is the recoverable half: the record is kept, and the failure
|
|
189
|
+
is usually transient. Run the `retry_command` once. If the retry also reports
|
|
190
|
+
`api_key_provisioned` false, report the error and stop onboarding.
|
|
191
|
+
A scaffold with no key looks finished and is not.
|
|
179
192
|
|
|
180
193
|
After project selection, set the project-record path to the absolute `config_path` from the
|
|
181
194
|
JSON result. If it differs from the expected project-record path, report both paths and stop
|
|
@@ -223,7 +236,7 @@ protected path list. Also add each project file that the developer changed for m
|
|
|
223
236
|
credentials. Record them in the baseline from the target app directory:
|
|
224
237
|
|
|
225
238
|
```text
|
|
226
|
-
npx --yes copilotkit@4.9.
|
|
239
|
+
npx --yes copilotkit@4.9.31 onboard protect --path <path>
|
|
227
240
|
```
|
|
228
241
|
|
|
229
242
|
Pass one `--path` for each. The command captures a digest for each path and never re-reads
|
|
@@ -233,7 +246,7 @@ Then re-capture the files this graph wrote itself. For each path the first captu
|
|
|
233
246
|
as `deferred` that this run has now written, run:
|
|
234
247
|
|
|
235
248
|
```text
|
|
236
|
-
npx --yes copilotkit@4.9.
|
|
249
|
+
npx --yes copilotkit@4.9.31 onboard protect --rebaseline --path <path>
|
|
237
250
|
```
|
|
238
251
|
|
|
239
252
|
From that point they are protected like any other path, so a later step that rewrites
|
|
@@ -257,7 +270,7 @@ proof subagents:
|
|
|
257
270
|
Fetch them together with the pages already selected rather than on their own.
|
|
258
271
|
|
|
259
272
|
Spawn one planning subagent. Tell it to run
|
|
260
|
-
`npx --yes copilotkit@4.9.
|
|
273
|
+
`npx --yes copilotkit@4.9.31 onboard read subagent/create-plan` first and follow the prompt
|
|
261
274
|
it returns. If that read fails because the subagent cannot use the shell, stop that subagent.
|
|
262
275
|
Run the same command yourself, then spawn a fresh subagent with the returned prompt and the
|
|
263
276
|
same handoff. Give it the repository findings, selected framework, frontend, model, credential
|
|
@@ -273,17 +286,17 @@ ask for approval of a non-pass plan.
|
|
|
273
286
|
Make sure that the plan preserves each part that already exists. The plan must name the
|
|
274
287
|
credential variables, the Intelligence runtime wiring, the application the project asks
|
|
275
288
|
for, implementation steps, validation steps, and proof steps. Where the plan upgrades the
|
|
276
|
-
CopilotKit dependencies, it must name the versions it moves
|
|
277
|
-
to. It must not contain secret values.
|
|
289
|
+
CopilotKit dependencies, it must name the versions it moves, every other pin it has to
|
|
290
|
+
move with them, and the revert it falls back to. It must not contain secret values.
|
|
278
291
|
|
|
279
|
-
Show only the selected framework, frontend, model, planned file changes, any ignore-file line this run adds, the CopilotKit dependency upgrade and the versions it moves, validation commands, and proof steps.
|
|
292
|
+
Show only the selected framework, frontend, model, planned file changes, any ignore-file line this run adds, the CopilotKit dependency upgrade and the versions it moves, every other dependency the upgrade moves and the versions it moves them to, validation commands, and proof steps.
|
|
280
293
|
|
|
281
294
|
An upgrade to a working install is the developer's call, so it belongs in the plan they
|
|
282
295
|
approve rather than in the implementation that follows. Do not upgrade a dependency the
|
|
283
296
|
developer did not approve.
|
|
284
297
|
|
|
285
298
|
If the developer approves the plan, run
|
|
286
|
-
`npx --yes copilotkit@4.9.
|
|
299
|
+
`npx --yes copilotkit@4.9.31 onboard read implementation/build-and-validate`.
|
|
287
300
|
|
|
288
301
|
If no exact supported path or documentation URL exists, run
|
|
289
|
-
`npx --yes copilotkit@4.9.
|
|
302
|
+
`npx --yes copilotkit@4.9.31 onboard read unsupported/no-validated-path`.
|
|
@@ -68,26 +68,26 @@ another framework. Do not show the internal route.
|
|
|
68
68
|
|
|
69
69
|
Use exactly one matching internal route:
|
|
70
70
|
|
|
71
|
-
1. AG2: `npx --yes copilotkit@4.9.
|
|
72
|
-
2. Agno: `npx --yes copilotkit@4.9.
|
|
73
|
-
3. Built-in CopilotKit agent: `npx --yes copilotkit@4.9.
|
|
74
|
-
4. Claude Agent SDK Python: `npx --yes copilotkit@4.9.
|
|
75
|
-
5. Claude Agent SDK TypeScript: `npx --yes copilotkit@4.9.
|
|
76
|
-
6. CrewAI Flows: `npx --yes copilotkit@4.9.
|
|
77
|
-
7. Deep Agents: `npx --yes copilotkit@4.9.
|
|
78
|
-
8. LangGraph Python: `npx --yes copilotkit@4.9.
|
|
79
|
-
9. LangGraph FastAPI: `npx --yes copilotkit@4.9.
|
|
80
|
-
10. LangGraph TypeScript: `npx --yes copilotkit@4.9.
|
|
81
|
-
11. LlamaIndex: `npx --yes copilotkit@4.9.
|
|
82
|
-
12. ADK: `npx --yes copilotkit@4.9.
|
|
83
|
-
13. Microsoft Agent Framework Python: `npx --yes copilotkit@4.9.
|
|
84
|
-
14. Microsoft Agent Framework .NET: `npx --yes copilotkit@4.9.
|
|
85
|
-
15. Mastra: `npx --yes copilotkit@4.9.
|
|
86
|
-
16. MS Agent Harness .NET: `npx --yes copilotkit@4.9.
|
|
87
|
-
17. Pydantic AI: `npx --yes copilotkit@4.9.
|
|
88
|
-
18. Strands Agents Python: `npx --yes copilotkit@4.9.
|
|
89
|
-
19. Strands Agents TypeScript: `npx --yes copilotkit@4.9.
|
|
71
|
+
1. AG2: `npx --yes copilotkit@4.9.31 onboard read framework/ag2`
|
|
72
|
+
2. Agno: `npx --yes copilotkit@4.9.31 onboard read framework/agno`
|
|
73
|
+
3. Built-in CopilotKit agent: `npx --yes copilotkit@4.9.31 onboard read framework/built-in`
|
|
74
|
+
4. Claude Agent SDK Python: `npx --yes copilotkit@4.9.31 onboard read framework/claude-sdk-python`
|
|
75
|
+
5. Claude Agent SDK TypeScript: `npx --yes copilotkit@4.9.31 onboard read framework/claude-sdk-typescript`
|
|
76
|
+
6. CrewAI Flows: `npx --yes copilotkit@4.9.31 onboard read framework/crewai-flows`
|
|
77
|
+
7. Deep Agents: `npx --yes copilotkit@4.9.31 onboard read framework/deep-agents`
|
|
78
|
+
8. LangGraph Python: `npx --yes copilotkit@4.9.31 onboard read framework/langgraph-python`
|
|
79
|
+
9. LangGraph FastAPI: `npx --yes copilotkit@4.9.31 onboard read framework/langgraph-fastapi`
|
|
80
|
+
10. LangGraph TypeScript: `npx --yes copilotkit@4.9.31 onboard read framework/langgraph-typescript`
|
|
81
|
+
11. LlamaIndex: `npx --yes copilotkit@4.9.31 onboard read framework/llamaindex`
|
|
82
|
+
12. ADK: `npx --yes copilotkit@4.9.31 onboard read framework/google-adk`
|
|
83
|
+
13. Microsoft Agent Framework Python: `npx --yes copilotkit@4.9.31 onboard read framework/ms-agent-python`
|
|
84
|
+
14. Microsoft Agent Framework .NET: `npx --yes copilotkit@4.9.31 onboard read framework/ms-agent-dotnet`
|
|
85
|
+
15. Mastra: `npx --yes copilotkit@4.9.31 onboard read framework/mastra`
|
|
86
|
+
16. MS Agent Harness .NET: `npx --yes copilotkit@4.9.31 onboard read framework/ms-agent-harness-dotnet`
|
|
87
|
+
17. Pydantic AI: `npx --yes copilotkit@4.9.31 onboard read framework/pydantic-ai`
|
|
88
|
+
18. Strands Agents Python: `npx --yes copilotkit@4.9.31 onboard read framework/strands-python`
|
|
89
|
+
19. Strands Agents TypeScript: `npx --yes copilotkit@4.9.31 onboard read framework/strands-typescript`
|
|
90
90
|
|
|
91
91
|
If the project has an agent in another framework, or no listed framework fits, keep the
|
|
92
92
|
developer's current agent and run
|
|
93
|
-
`npx --yes copilotkit@4.9.
|
|
93
|
+
`npx --yes copilotkit@4.9.31 onboard read unsupported/no-validated-path`.
|
|
@@ -14,7 +14,7 @@ command without another developer question. The CLI telemetry gate decides wheth
|
|
|
14
14
|
report is sent.
|
|
15
15
|
|
|
16
16
|
```text
|
|
17
|
-
npx --yes copilotkit@4.9.
|
|
17
|
+
npx --yes copilotkit@4.9.31 onboard feedback
|
|
18
18
|
```
|
|
19
19
|
|
|
20
20
|
Write at most four lines to standard input: the step you stopped at and what stopped it.
|
|
@@ -40,7 +40,8 @@ from different official pages. Tell it to run every implementation and validatio
|
|
|
40
40
|
plan order, and to run the full validation list.
|
|
41
41
|
|
|
42
42
|
Give it this result format: Start with `Status: passed`, `Status: failed`, or
|
|
43
|
-
`Status: blocked`.
|
|
43
|
+
`Status: blocked`. Then require a Files changed section that names every file it touched.
|
|
44
|
+
The protected-path rules below read that section, so a result without it settles nothing.
|
|
44
45
|
|
|
45
46
|
Wait for the implementation subagent to finish.
|
|
46
47
|
|
|
@@ -55,10 +56,17 @@ stop.
|
|
|
55
56
|
|
|
56
57
|
Use these rules for every protected-path check in this fallback:
|
|
57
58
|
|
|
58
|
-
- Run `npx --yes copilotkit@4.9.
|
|
59
|
+
- Run `npx --yes copilotkit@4.9.31 onboard audit` from the target app directory.
|
|
59
60
|
- If a result starts with `Status: blocked`, stop onboarding and report the printed reason.
|
|
60
61
|
It proved nothing changed, so do not report a preservation failure.
|
|
61
|
-
- If a result reports a changed protected path, stop onboarding.
|
|
62
|
+
- If a result reports a changed protected path this run wrote, stop onboarding.
|
|
63
|
+
- If a result reports a changed path that no Files changed section from this run names,
|
|
64
|
+
the change came from outside the run. Accept it by name with
|
|
65
|
+
`npx --yes copilotkit@4.9.31 onboard protect --accept-external --path <path>`, run the
|
|
66
|
+
audit again, and name it in the closing report.
|
|
67
|
+
- If no Files changed section from this run covers the step that wrote it, stop
|
|
68
|
+
onboarding. The proof subagent here returns no such section, so a finding it raises is
|
|
69
|
+
unsettled rather than outside the run.
|
|
62
70
|
- Never repair, reset, or revert a protected path.
|
|
63
71
|
|
|
64
72
|
Run the protected-path check now. Apply the protected-path rules. Continue only when the
|
|
@@ -107,13 +115,13 @@ application passes proof. Report each tool result separately from the proof resu
|
|
|
107
115
|
Report the documentation gap and each assumption with the proof evidence. Do not claim
|
|
108
116
|
that the selected documentation proved an inferred step.
|
|
109
117
|
|
|
110
|
-
When the proof is complete, run `npx --yes copilotkit@4.9.
|
|
118
|
+
When the proof is complete, run `npx --yes copilotkit@4.9.31 onboard complete`, carrying the
|
|
111
119
|
surface-check result the proof subagent returned. Pass exactly one flag, matching this
|
|
112
120
|
journey's surface:
|
|
113
121
|
|
|
114
122
|
```text
|
|
115
|
-
npx --yes copilotkit@4.9.
|
|
116
|
-
npx --yes copilotkit@4.9.
|
|
123
|
+
npx --yes copilotkit@4.9.31 onboard complete --visual-check <outcome>
|
|
124
|
+
npx --yes copilotkit@4.9.31 onboard complete --device-check <outcome>
|
|
117
125
|
```
|
|
118
126
|
|
|
119
127
|
`--visual-check` is for a web frontend and takes `performed`, `skipped-no-browser-tool`, or
|
|
@@ -31,7 +31,7 @@ Record the selected framework, vendor, model, required credential variable names
|
|
|
31
31
|
URLs, and the A2UI documentation gap.
|
|
32
32
|
|
|
33
33
|
If the pages support the selection, run
|
|
34
|
-
`npx --yes copilotkit@4.9.
|
|
34
|
+
`npx --yes copilotkit@4.9.31 onboard read frontend/plan`.
|
|
35
35
|
|
|
36
36
|
If the documentation does not support the selection, run
|
|
37
|
-
`npx --yes copilotkit@4.9.
|
|
37
|
+
`npx --yes copilotkit@4.9.31 onboard read unsupported/no-validated-path`.
|
|
@@ -34,7 +34,7 @@ Record the selected framework, vendor, model, required credential variable names
|
|
|
34
34
|
URLs, the documented dependencies and adapter, and the context documentation gap.
|
|
35
35
|
|
|
36
36
|
If the pages support the selection, run
|
|
37
|
-
`npx --yes copilotkit@4.9.
|
|
37
|
+
`npx --yes copilotkit@4.9.31 onboard read frontend/plan`.
|
|
38
38
|
|
|
39
39
|
If the documentation does not support the selection, run
|
|
40
|
-
`npx --yes copilotkit@4.9.
|
|
40
|
+
`npx --yes copilotkit@4.9.31 onboard read unsupported/no-validated-path`.
|
|
@@ -27,7 +27,7 @@ Record the selected framework, vendor, model, required credential variable names
|
|
|
27
27
|
these URLs.
|
|
28
28
|
|
|
29
29
|
If the pages support the selection, run
|
|
30
|
-
`npx --yes copilotkit@4.9.
|
|
30
|
+
`npx --yes copilotkit@4.9.31 onboard read frontend/plan`.
|
|
31
31
|
|
|
32
32
|
If the documentation does not support the selection, run
|
|
33
|
-
`npx --yes copilotkit@4.9.
|
|
33
|
+
`npx --yes copilotkit@4.9.31 onboard read unsupported/no-validated-path`.
|
|
@@ -33,7 +33,7 @@ Record the selected framework, vendor, model, required credential variable names
|
|
|
33
33
|
URLs, and the context limit.
|
|
34
34
|
|
|
35
35
|
If the pages support the selection, run
|
|
36
|
-
`npx --yes copilotkit@4.9.
|
|
36
|
+
`npx --yes copilotkit@4.9.31 onboard read frontend/plan`.
|
|
37
37
|
|
|
38
38
|
If the documentation does not support the selection, run
|
|
39
|
-
`npx --yes copilotkit@4.9.
|
|
39
|
+
`npx --yes copilotkit@4.9.31 onboard read unsupported/no-validated-path`.
|
|
@@ -37,7 +37,7 @@ Record the selected framework, vendor, model, required credential variable names
|
|
|
37
37
|
URLs, and the context limit.
|
|
38
38
|
|
|
39
39
|
If the pages support the selection, run
|
|
40
|
-
`npx --yes copilotkit@4.9.
|
|
40
|
+
`npx --yes copilotkit@4.9.31 onboard read frontend/plan`.
|
|
41
41
|
|
|
42
42
|
If the documentation does not support the selection, run
|
|
43
|
-
`npx --yes copilotkit@4.9.
|
|
43
|
+
`npx --yes copilotkit@4.9.31 onboard read unsupported/no-validated-path`.
|
|
@@ -54,7 +54,7 @@ variable names the repository proves or the developer named, these URLs, the ada
|
|
|
54
54
|
shared-state limit.
|
|
55
55
|
|
|
56
56
|
If the pages support the selection, run
|
|
57
|
-
`npx --yes copilotkit@4.9.
|
|
57
|
+
`npx --yes copilotkit@4.9.31 onboard read frontend/plan`.
|
|
58
58
|
|
|
59
59
|
If the documentation does not support the selection, run
|
|
60
|
-
`npx --yes copilotkit@4.9.
|
|
60
|
+
`npx --yes copilotkit@4.9.31 onboard read unsupported/no-validated-path`.
|
|
@@ -29,7 +29,7 @@ Record the selected framework, language, vendor, model, required credential vari
|
|
|
29
29
|
names, these URLs, and each documentation gap.
|
|
30
30
|
|
|
31
31
|
If the pages support the selection, run
|
|
32
|
-
`npx --yes copilotkit@4.9.
|
|
32
|
+
`npx --yes copilotkit@4.9.31 onboard read frontend/plan`.
|
|
33
33
|
|
|
34
34
|
If the documentation does not support the selection, run
|
|
35
|
-
`npx --yes copilotkit@4.9.
|
|
35
|
+
`npx --yes copilotkit@4.9.31 onboard read unsupported/no-validated-path`.
|
|
@@ -28,7 +28,7 @@ Record the selected framework, vendor, model, required credential variable names
|
|
|
28
28
|
these URLs.
|
|
29
29
|
|
|
30
30
|
If the pages support the selection, run
|
|
31
|
-
`npx --yes copilotkit@4.9.
|
|
31
|
+
`npx --yes copilotkit@4.9.31 onboard read frontend/plan`.
|
|
32
32
|
|
|
33
33
|
If the documentation does not support the selection, run
|
|
34
|
-
`npx --yes copilotkit@4.9.
|
|
34
|
+
`npx --yes copilotkit@4.9.31 onboard read unsupported/no-validated-path`.
|
|
@@ -24,7 +24,7 @@ Record the selected framework, vendor, model, required credential variable names
|
|
|
24
24
|
these URLs.
|
|
25
25
|
|
|
26
26
|
If the pages support the selection, run
|
|
27
|
-
`npx --yes copilotkit@4.9.
|
|
27
|
+
`npx --yes copilotkit@4.9.31 onboard read frontend/plan`.
|
|
28
28
|
|
|
29
29
|
If the documentation does not support the selection, run
|
|
30
|
-
`npx --yes copilotkit@4.9.
|
|
30
|
+
`npx --yes copilotkit@4.9.31 onboard read unsupported/no-validated-path`.
|
|
@@ -15,7 +15,7 @@ Record the selected framework, vendor, model, required credential variable names
|
|
|
15
15
|
these URLs.
|
|
16
16
|
|
|
17
17
|
If the pages support the selection, run
|
|
18
|
-
`npx --yes copilotkit@4.9.
|
|
18
|
+
`npx --yes copilotkit@4.9.31 onboard read frontend/plan`.
|
|
19
19
|
|
|
20
20
|
If the documentation does not support the selection, run
|
|
21
|
-
`npx --yes copilotkit@4.9.
|
|
21
|
+
`npx --yes copilotkit@4.9.31 onboard read unsupported/no-validated-path`.
|
|
@@ -15,7 +15,7 @@ Record the selected framework, vendor, model, required credential variable names
|
|
|
15
15
|
these URLs.
|
|
16
16
|
|
|
17
17
|
If the pages support the selection, run
|
|
18
|
-
`npx --yes copilotkit@4.9.
|
|
18
|
+
`npx --yes copilotkit@4.9.31 onboard read frontend/plan`.
|
|
19
19
|
|
|
20
20
|
If the documentation does not support the selection, run
|
|
21
|
-
`npx --yes copilotkit@4.9.
|
|
21
|
+
`npx --yes copilotkit@4.9.31 onboard read unsupported/no-validated-path`.
|
|
@@ -34,7 +34,7 @@ Record the selected framework, vendor, model, required credential variable names
|
|
|
34
34
|
URLs, the documented dependencies and adapter, and both documentation limits.
|
|
35
35
|
|
|
36
36
|
If the pages support the selection, run
|
|
37
|
-
`npx --yes copilotkit@4.9.
|
|
37
|
+
`npx --yes copilotkit@4.9.31 onboard read frontend/plan`.
|
|
38
38
|
|
|
39
39
|
If the documentation does not support the selection, run
|
|
40
|
-
`npx --yes copilotkit@4.9.
|
|
40
|
+
`npx --yes copilotkit@4.9.31 onboard read unsupported/no-validated-path`.
|
|
@@ -45,7 +45,7 @@ Record the selected framework, vendor, model, required credential variable names
|
|
|
45
45
|
these URLs.
|
|
46
46
|
|
|
47
47
|
If the pages support the selection, run
|
|
48
|
-
`npx --yes copilotkit@4.9.
|
|
48
|
+
`npx --yes copilotkit@4.9.31 onboard read frontend/plan`.
|
|
49
49
|
|
|
50
50
|
If the documentation does not support the selection, run
|
|
51
|
-
`npx --yes copilotkit@4.9.
|
|
51
|
+
`npx --yes copilotkit@4.9.31 onboard read unsupported/no-validated-path`.
|
|
@@ -34,7 +34,7 @@ Record the selected framework, provider, model, required credential variable nam
|
|
|
34
34
|
these URLs.
|
|
35
35
|
|
|
36
36
|
If the pages support the selection, run
|
|
37
|
-
`npx --yes copilotkit@4.9.
|
|
37
|
+
`npx --yes copilotkit@4.9.31 onboard read frontend/plan`.
|
|
38
38
|
|
|
39
39
|
If the documentation does not support the selection, run
|
|
40
|
-
`npx --yes copilotkit@4.9.
|
|
40
|
+
`npx --yes copilotkit@4.9.31 onboard read unsupported/no-validated-path`.
|
|
@@ -44,7 +44,7 @@ Record the selected framework, provider, model, required credential variable nam
|
|
|
44
44
|
URLs, and the quickstart gap.
|
|
45
45
|
|
|
46
46
|
If the pages support the selection, run
|
|
47
|
-
`npx --yes copilotkit@4.9.
|
|
47
|
+
`npx --yes copilotkit@4.9.31 onboard read frontend/plan`.
|
|
48
48
|
|
|
49
49
|
If the documentation does not support the selection, run
|
|
50
|
-
`npx --yes copilotkit@4.9.
|
|
50
|
+
`npx --yes copilotkit@4.9.31 onboard read unsupported/no-validated-path`.
|
|
@@ -28,7 +28,7 @@ Record the selected framework, vendor, model, required credential variable names
|
|
|
28
28
|
these URLs.
|
|
29
29
|
|
|
30
30
|
If the pages support the selection, run
|
|
31
|
-
`npx --yes copilotkit@4.9.
|
|
31
|
+
`npx --yes copilotkit@4.9.31 onboard read frontend/plan`.
|
|
32
32
|
|
|
33
33
|
If the documentation does not support the selection, run
|
|
34
|
-
`npx --yes copilotkit@4.9.
|
|
34
|
+
`npx --yes copilotkit@4.9.31 onboard read unsupported/no-validated-path`.
|
|
@@ -43,7 +43,7 @@ Record the selected framework, vendor, model, required credential variable names
|
|
|
43
43
|
URLs, and the two-step context route.
|
|
44
44
|
|
|
45
45
|
If the pages support the selection, run
|
|
46
|
-
`npx --yes copilotkit@4.9.
|
|
46
|
+
`npx --yes copilotkit@4.9.31 onboard read frontend/plan`.
|
|
47
47
|
|
|
48
48
|
If the documentation does not support the selection, run
|
|
49
|
-
`npx --yes copilotkit@4.9.
|
|
49
|
+
`npx --yes copilotkit@4.9.31 onboard read unsupported/no-validated-path`.
|
|
@@ -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.
|
|
30
|
+
`npx --yes copilotkit@4.9.31 onboard read frontend/plan`.
|
|
31
31
|
|
|
32
32
|
If the documentation does not support the selection, run
|
|
33
|
-
`npx --yes copilotkit@4.9.
|
|
33
|
+
`npx --yes copilotkit@4.9.31 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.
|
|
31
|
+
`npx --yes copilotkit@4.9.31 onboard read frontend/plan`.
|
|
32
32
|
|
|
33
33
|
If the documentation does not support the selection, run
|
|
34
|
-
`npx --yes copilotkit@4.9.
|
|
34
|
+
`npx --yes copilotkit@4.9.31 onboard read unsupported/no-validated-path`.
|