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.
- package/README.md +13 -0
- package/cli-build-info.json +7 -7
- package/index.js +1926 -1873
- package/onboarding/index.json +1 -1
- package/onboarding/prompts/authenticate/start.md +8 -8
- package/onboarding/prompts/conversion/plan.md +21 -11
- package/onboarding/prompts/credentials/finalize-plan.md +95 -34
- package/onboarding/prompts/credentials/plan.md +20 -20
- package/onboarding/prompts/fallback/best-effort.md +9 -8
- 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 +3 -3
- package/onboarding/prompts/framework/strands-python.md +2 -2
- package/onboarding/prompts/framework/strands-typescript.md +2 -2
- package/onboarding/prompts/frontend/angular.md +3 -3
- 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 +4 -4
- package/onboarding/prompts/proof/complete.md +29 -12
- package/onboarding/prompts/proof/oss-baseline.md +4 -4
- package/onboarding/prompts/proof/round-trip.md +9 -9
- package/onboarding/prompts/starter/clone.md +17 -8
- package/onboarding/prompts/subagent/create-plan.md +9 -3
- package/onboarding/prompts/subagent/inspect-repository.md +1 -1
- package/onboarding/prompts/subagent/prove-oss-baseline.md +1 -1
- package/onboarding/prompts/subagent/prove-round-trip.md +17 -6
- package/onboarding/prompts/unsupported/no-validated-path.md +2 -2
- package/package.json +1 -1
- package/release/release-tool.js +1 -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.24 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.24 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.24 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
|
|
|
@@ -88,7 +88,7 @@ Before you ask the developer any setup question, finish every read-only investig
|
|
|
88
88
|
preflight check in this section.
|
|
89
89
|
|
|
90
90
|
Prepare two research assignments. Give each research subagent one assignment. Tell it to run
|
|
91
|
-
`npx --yes copilotkit@4.9.
|
|
91
|
+
`npx --yes copilotkit@4.9.24 onboard read subagent/inspect-repository` first and follow the
|
|
92
92
|
prompt it returns. If that read fails because the subagent cannot use the shell, stop that
|
|
93
93
|
subagent. Run the same command yourself, then spawn a fresh subagent with the returned prompt
|
|
94
94
|
and the same handoff. Require only its assigned packet.
|
|
@@ -171,7 +171,7 @@ both workers return the same one target app directory. Both results must start w
|
|
|
171
171
|
Before you route on, run this from the target app directory:
|
|
172
172
|
|
|
173
173
|
```text
|
|
174
|
-
npx --yes copilotkit@4.9.
|
|
174
|
+
npx --yes copilotkit@4.9.24 onboard protect
|
|
175
175
|
```
|
|
176
176
|
|
|
177
177
|
It reads the working tree itself, records every changed or untracked path with a digest,
|
|
@@ -213,7 +213,7 @@ settle these three from your own reading of the project. Each one comes from the
|
|
|
213
213
|
packets or it is not proved.
|
|
214
214
|
|
|
215
215
|
If all three are proved, prove the live starting state before any project file changes. Run
|
|
216
|
-
`npx --yes copilotkit@4.9.
|
|
216
|
+
`npx --yes copilotkit@4.9.24 onboard read proof/oss-baseline`.
|
|
217
217
|
|
|
218
218
|
Route there before you ask the developer anything else. The questions after this prompt
|
|
219
219
|
select a framework and a frontend that the findings already name, so a developer who
|
|
@@ -226,10 +226,10 @@ developer nor the repository findings prove what the project is for, ask one gui
|
|
|
226
226
|
question about the user outcome. This asks what the developer wants to build before you
|
|
227
227
|
select a framework. Give two or three short examples and offer a minimal starter. Record
|
|
228
228
|
the answer and give it to each later subagent. Then run
|
|
229
|
-
`npx --yes copilotkit@4.9.
|
|
229
|
+
`npx --yes copilotkit@4.9.24 onboard read credentials/plan`.
|
|
230
230
|
|
|
231
231
|
Do not ask that question on the route above. A project carrying all three states its
|
|
232
232
|
purpose in the application it already serves.
|
|
233
233
|
|
|
234
234
|
If authentication or inspection stops onboarding, run
|
|
235
|
-
`npx --yes copilotkit@4.9.
|
|
235
|
+
`npx --yes copilotkit@4.9.24 onboard read unsupported/no-validated-path`.
|
|
@@ -52,9 +52,9 @@ Then select the drawer page for the frontend the baseline found:
|
|
|
52
52
|
1. React SPA or Next.js: https://docs.copilotkit.ai/prebuilt-components/copilot-threads-drawer.md
|
|
53
53
|
2. Angular: https://docs.copilotkit.ai/angular/guides/threads-memory-attachments-headless.md
|
|
54
54
|
3. Vue 3: https://docs.copilotkit.ai/vue/guides/threads-and-drawer.md
|
|
55
|
-
4. React Native: select no drawer page
|
|
56
|
-
|
|
57
|
-
|
|
55
|
+
4. React Native: select no drawer page. No page documents a threads drawer for React
|
|
56
|
+
Native, and `@copilotkit/react-native` ships no thread components, so the fifth
|
|
57
|
+
criterion below is proved on the command line instead. The closing prompt gives a
|
|
58
58
|
mobile developer a different debugging surface for the same reason.
|
|
59
59
|
|
|
60
60
|
The next prompt adds the runtime pages and fetches everything in one pass, so do not fetch
|
|
@@ -86,18 +86,28 @@ steps unchanged. This conversion succeeded when all five are true:
|
|
|
86
86
|
5. A thread for that request is persisted and visible to the developer.
|
|
87
87
|
|
|
88
88
|
The drawer is what makes the fifth item something the developer can see. Before the
|
|
89
|
-
conversion it
|
|
90
|
-
|
|
91
|
-
after is the conversion's whole user-visible result, and it is why a conversion
|
|
92
|
-
passes the command-line checks is worth less to the developer than one that does
|
|
89
|
+
conversion it lists nothing, because it reads the entitlement the runtime reports and an
|
|
90
|
+
OSS runtime reports none. After it, it lists the thread the proven request created. That
|
|
91
|
+
before and after is the conversion's whole user-visible result, and it is why a conversion
|
|
92
|
+
that only passes the command-line checks is worth less to the developer than one that does
|
|
93
|
+
not.
|
|
94
|
+
|
|
95
|
+
A managed Intelligence project needs no license token. The entitlement the drawer reads
|
|
96
|
+
comes from the project API key this run already configured, resolved by the runtime
|
|
97
|
+
against the managed platform. Minting a token with `copilotkit license create` is not part
|
|
98
|
+
of this journey, and a drawer that lists nothing is not a reason to mint one. License
|
|
99
|
+
tokens stay a self-hosted concern.
|
|
93
100
|
|
|
94
101
|
Where this journey's frontend framework ships no threads drawer -- React Native --, the
|
|
95
|
-
fifth item is proved
|
|
96
|
-
|
|
102
|
+
fifth item is proved by `npx --yes copilotkit@4.9.24 verify --round-trip`, which sends a
|
|
103
|
+
real request and reads the answer back off the thread it landed on. The run says which of
|
|
104
|
+
the two it proved. Do not send a run to the managed Intelligence dashboard to prove this.
|
|
105
|
+
An authenticated browser session at a hosted dashboard is the one thing an agent-driven run
|
|
106
|
+
cannot produce, so a criterion that asks for one can never be met on this route.
|
|
97
107
|
|
|
98
108
|
Record this criterion as `conversion-v1` for the run report.
|
|
99
109
|
|
|
100
|
-
Then run `npx --yes copilotkit@4.9.
|
|
110
|
+
Then run `npx --yes copilotkit@4.9.24 onboard read credentials/finalize-plan`.
|
|
101
111
|
|
|
102
112
|
If a selected page does not load after the second method, run
|
|
103
|
-
`npx --yes copilotkit@4.9.
|
|
113
|
+
`npx --yes copilotkit@4.9.24 onboard read unsupported/no-validated-path`.
|
|
@@ -22,7 +22,7 @@ one short report before you stop. Run the feedback command without another devel
|
|
|
22
22
|
question. The CLI telemetry gate decides whether the report is sent.
|
|
23
23
|
|
|
24
24
|
```text
|
|
25
|
-
npx --yes copilotkit@4.9.
|
|
25
|
+
npx --yes copilotkit@4.9.24 onboard feedback
|
|
26
26
|
```
|
|
27
27
|
|
|
28
28
|
Write at most four lines to standard input: the step you stopped at and what stopped it.
|
|
@@ -45,7 +45,7 @@ starts. Choose one starting state: empty, agent-only, frontend-only, both, both-
|
|
|
45
45
|
Run this command with the exact selected slugs:
|
|
46
46
|
|
|
47
47
|
```text
|
|
48
|
-
npx --yes copilotkit@4.9.
|
|
48
|
+
npx --yes copilotkit@4.9.24 onboard classify --starting-state <starting-state> --agent-framework <agent-framework> --frontend <frontend>
|
|
49
49
|
```
|
|
50
50
|
|
|
51
51
|
Do not continue if a value is refused. Fix the value from the choices that the earlier
|
|
@@ -57,36 +57,45 @@ Use the target app or runtime directory from the repository findings. If a neste
|
|
|
57
57
|
the runtime `.env` file, do not default to the repository root.
|
|
58
58
|
Set the environment path to `<target>/.env`.
|
|
59
59
|
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
60
|
+
Every credential this run writes goes to the environment path. That covers the project
|
|
61
|
+
key, the model credential, and a license token. Do not write a credential to `.env.local`,
|
|
62
|
+
or to any second env file beside it. A project ignore file usually covers `.env` and not
|
|
63
|
+
`.env.local`, so a credential written there is untracked, visible, and added by the first
|
|
64
|
+
`git add -A`. And a second env file beside `.env` outranks it when a key is read back, so
|
|
65
|
+
the value the run depends on is the one it did not write.
|
|
66
66
|
|
|
67
|
-
|
|
68
|
-
target directory. Do not send the developer to another terminal.
|
|
67
|
+
### Prove the environment path is ignored
|
|
69
68
|
|
|
70
|
-
|
|
69
|
+
Do this before the first credential is written. Ask git whether it ignores the environment
|
|
70
|
+
path, from the repository the path lives in:
|
|
71
71
|
|
|
72
72
|
```text
|
|
73
|
-
|
|
73
|
+
git check-ignore -q <environment path>
|
|
74
74
|
```
|
|
75
75
|
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
developer asks.
|
|
76
|
+
Ask git rather than reading `.gitignore`. The answer also comes from a parent ignore file,
|
|
77
|
+
a global excludes file, or a pattern the developer already has, and reading one file gets
|
|
78
|
+
each of those wrong.
|
|
80
79
|
|
|
81
|
-
|
|
80
|
+
Exit zero means git ignores the path and nothing more is needed. Exit one means git tracks
|
|
81
|
+
the path, and the credential this run is about to write lands in the first commit. Add the
|
|
82
|
+
missing pattern to the ignore file the developer already keeps, and list that edit in the
|
|
83
|
+
plan with every other file change. Any other exit means there is no work tree here to
|
|
84
|
+
protect. Say so once and carry on.
|
|
82
85
|
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
+
If the path cannot be made ignored, stop onboarding and report it. Do not write the
|
|
87
|
+
credential and leave the problem in the closing report. A developer who commits before
|
|
88
|
+
reading the last screen has already published the token.
|
|
86
89
|
|
|
87
|
-
If
|
|
88
|
-
|
|
89
|
-
|
|
90
|
+
If valid project fields and a non-empty `CPK_INTELLIGENCE_API_KEY` already exist, use this
|
|
91
|
+
rule: Reuse that project without another question. Do not mint another key. The round-trip
|
|
92
|
+
proof later runs the authenticated Intelligence checks. Record the reused project
|
|
93
|
+
credentials as unverified in the plan until those checks pass.
|
|
94
|
+
If you reuse a project, set the project-record path to the exact evidence path from the
|
|
95
|
+
project research subagent.
|
|
96
|
+
|
|
97
|
+
If the developer needs a project, do the work yourself from the target directory.
|
|
98
|
+
Do not send the developer to another terminal.
|
|
90
99
|
|
|
91
100
|
Project selection writes the environment path. It updates the nearest project record from
|
|
92
101
|
the target through the repository root. If no project record exists there, it writes one at
|
|
@@ -98,15 +107,67 @@ findings. Compare that path and the environment path with the initial protected
|
|
|
98
107
|
the path-segment overlap rule. If either output path overlaps an initial protected path, do
|
|
99
108
|
not run project selection. Report the conflicting path and stop onboarding.
|
|
100
109
|
|
|
101
|
-
|
|
110
|
+
### Create a project for this directory
|
|
111
|
+
|
|
112
|
+
No project is bound to this directory, so creating a project for this directory is the
|
|
113
|
+
default. Take the name from the directory that holds the expected project-record path. If
|
|
114
|
+
that directory name is generic -- `project`, `app`, `apps`, `src`, `web`, `frontend`,
|
|
115
|
+
`backend`, `server`, `packages`, `repo` -- use the nearest enclosing directory whose name
|
|
116
|
+
is not. A generic name tells the developer nothing later, and every run that derives it
|
|
117
|
+
collides on it.
|
|
118
|
+
|
|
119
|
+
Ask one question: confirm that name, give another, or ask to use a project they already
|
|
120
|
+
have. Name that third answer, so a developer who has one is not asked to guess
|
|
121
|
+
that it is available. Do not list the organization's projects as part of the question: a
|
|
122
|
+
menu of projects is what bound one onboarding to another one's project, and a developer who
|
|
123
|
+
wants theirs will say so. If they ask for an existing project, take the branch below.
|
|
124
|
+
|
|
125
|
+
Do not combine this question with a frontend, framework, model, credential, or
|
|
126
|
+
plan-approval question. If no developer answers, create with the derived name. Never select
|
|
127
|
+
a project from a listing without an answer that names it. A project another run created
|
|
128
|
+
minutes ago reads exactly like this directory's own, and every check after the selection
|
|
129
|
+
passes against the wrong one.
|
|
130
|
+
|
|
131
|
+
Create it, from the target directory:
|
|
132
|
+
|
|
133
|
+
```text
|
|
134
|
+
npx --yes copilotkit@4.9.24 project select --create <name> --json
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
If the command fails as a duplicate, the organization already holds that display name and
|
|
138
|
+
the refusal names the colliding slug. Do not select the colliding project. Ask whether that
|
|
139
|
+
project is this app's. If no developer answers, run the command again with the next free
|
|
140
|
+
`-2`, `-3` suffix on the name.
|
|
141
|
+
|
|
142
|
+
### Select an existing project instead
|
|
143
|
+
|
|
144
|
+
Take this branch only when the developer asks for an existing project, or asks to see the
|
|
145
|
+
projects they have. Read the choices:
|
|
146
|
+
|
|
147
|
+
```text
|
|
148
|
+
npx --yes copilotkit@4.9.24 project list --json
|
|
149
|
+
```
|
|
150
|
+
|
|
151
|
+
Narrow them:
|
|
152
|
+
|
|
153
|
+
```text
|
|
154
|
+
npx --yes copilotkit@4.9.24 project list --search <query> --json
|
|
155
|
+
```
|
|
156
|
+
|
|
157
|
+
With `--json` the payload is the only thing on standard output, so it is safe to parse. Do
|
|
158
|
+
not run either list command unless the developer asks. Show what they asked for and nothing
|
|
159
|
+
more. Do not order the projects by creation time: the newest project in the organization is
|
|
160
|
+
the one another run created while this one was working, and it is the least likely to be
|
|
161
|
+
this directory's.
|
|
162
|
+
|
|
163
|
+
Then record the project they name, from the target directory:
|
|
102
164
|
|
|
103
165
|
```text
|
|
104
|
-
npx --yes copilotkit@4.9.
|
|
166
|
+
npx --yes copilotkit@4.9.24 project select --project <slug-or-id> --json
|
|
105
167
|
```
|
|
106
168
|
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
a selection that points at nothing.
|
|
169
|
+
The two flags cannot be combined. A slug that does not exist fails and lists the real ones,
|
|
170
|
+
so a typo cannot record a selection that points at nothing.
|
|
110
171
|
|
|
111
172
|
Read the JSON result. It reports `selected_project_slug`, `config_path`,
|
|
112
173
|
`api_key_provisioned`, `project_file_written`, and `environment_file_written` at the top
|
|
@@ -162,7 +223,7 @@ protected path list. Also add each project file that the developer changed for m
|
|
|
162
223
|
credentials. Record them in the baseline from the target app directory:
|
|
163
224
|
|
|
164
225
|
```text
|
|
165
|
-
npx --yes copilotkit@4.9.
|
|
226
|
+
npx --yes copilotkit@4.9.24 onboard protect --path <path>
|
|
166
227
|
```
|
|
167
228
|
|
|
168
229
|
Pass one `--path` for each. The command captures a digest for each path and never re-reads
|
|
@@ -172,7 +233,7 @@ Then re-capture the files this graph wrote itself. For each path the first captu
|
|
|
172
233
|
as `deferred` that this run has now written, run:
|
|
173
234
|
|
|
174
235
|
```text
|
|
175
|
-
npx --yes copilotkit@4.9.
|
|
236
|
+
npx --yes copilotkit@4.9.24 onboard protect --rebaseline --path <path>
|
|
176
237
|
```
|
|
177
238
|
|
|
178
239
|
From that point they are protected like any other path, so a later step that rewrites
|
|
@@ -196,7 +257,7 @@ proof subagents:
|
|
|
196
257
|
Fetch them together with the pages already selected rather than on their own.
|
|
197
258
|
|
|
198
259
|
Spawn one planning subagent. Tell it to run
|
|
199
|
-
`npx --yes copilotkit@4.9.
|
|
260
|
+
`npx --yes copilotkit@4.9.24 onboard read subagent/create-plan` first and follow the prompt
|
|
200
261
|
it returns. If that read fails because the subagent cannot use the shell, stop that subagent.
|
|
201
262
|
Run the same command yourself, then spawn a fresh subagent with the returned prompt and the
|
|
202
263
|
same handoff. Give it the repository findings, selected framework, frontend, model, credential
|
|
@@ -215,14 +276,14 @@ for, implementation steps, validation steps, and proof steps. Where the plan upg
|
|
|
215
276
|
CopilotKit dependencies, it must name the versions it moves and the revert it falls back
|
|
216
277
|
to. It must not contain secret values.
|
|
217
278
|
|
|
218
|
-
Show only the selected framework, frontend, model, planned file changes, the CopilotKit dependency upgrade and the versions it moves, validation commands, and proof steps.
|
|
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.
|
|
219
280
|
|
|
220
281
|
An upgrade to a working install is the developer's call, so it belongs in the plan they
|
|
221
282
|
approve rather than in the implementation that follows. Do not upgrade a dependency the
|
|
222
283
|
developer did not approve.
|
|
223
284
|
|
|
224
285
|
If the developer approves the plan, run
|
|
225
|
-
`npx --yes copilotkit@4.9.
|
|
286
|
+
`npx --yes copilotkit@4.9.24 onboard read implementation/build-and-validate`.
|
|
226
287
|
|
|
227
288
|
If no exact supported path or documentation URL exists, run
|
|
228
|
-
`npx --yes copilotkit@4.9.
|
|
289
|
+
`npx --yes copilotkit@4.9.24 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.24 onboard read framework/ag2`
|
|
72
|
+
2. Agno: `npx --yes copilotkit@4.9.24 onboard read framework/agno`
|
|
73
|
+
3. Built-in CopilotKit agent: `npx --yes copilotkit@4.9.24 onboard read framework/built-in`
|
|
74
|
+
4. Claude Agent SDK Python: `npx --yes copilotkit@4.9.24 onboard read framework/claude-sdk-python`
|
|
75
|
+
5. Claude Agent SDK TypeScript: `npx --yes copilotkit@4.9.24 onboard read framework/claude-sdk-typescript`
|
|
76
|
+
6. CrewAI Flows: `npx --yes copilotkit@4.9.24 onboard read framework/crewai-flows`
|
|
77
|
+
7. Deep Agents: `npx --yes copilotkit@4.9.24 onboard read framework/deep-agents`
|
|
78
|
+
8. LangGraph Python: `npx --yes copilotkit@4.9.24 onboard read framework/langgraph-python`
|
|
79
|
+
9. LangGraph FastAPI: `npx --yes copilotkit@4.9.24 onboard read framework/langgraph-fastapi`
|
|
80
|
+
10. LangGraph TypeScript: `npx --yes copilotkit@4.9.24 onboard read framework/langgraph-typescript`
|
|
81
|
+
11. LlamaIndex: `npx --yes copilotkit@4.9.24 onboard read framework/llamaindex`
|
|
82
|
+
12. ADK: `npx --yes copilotkit@4.9.24 onboard read framework/google-adk`
|
|
83
|
+
13. Microsoft Agent Framework Python: `npx --yes copilotkit@4.9.24 onboard read framework/ms-agent-python`
|
|
84
|
+
14. Microsoft Agent Framework .NET: `npx --yes copilotkit@4.9.24 onboard read framework/ms-agent-dotnet`
|
|
85
|
+
15. Mastra: `npx --yes copilotkit@4.9.24 onboard read framework/mastra`
|
|
86
|
+
16. MS Agent Harness .NET: `npx --yes copilotkit@4.9.24 onboard read framework/ms-agent-harness-dotnet`
|
|
87
|
+
17. Pydantic AI: `npx --yes copilotkit@4.9.24 onboard read framework/pydantic-ai`
|
|
88
|
+
18. Strands Agents Python: `npx --yes copilotkit@4.9.24 onboard read framework/strands-python`
|
|
89
|
+
19. Strands Agents TypeScript: `npx --yes copilotkit@4.9.24 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.24 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.24 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.
|
|
@@ -55,7 +55,7 @@ stop.
|
|
|
55
55
|
|
|
56
56
|
Use these rules for every protected-path check in this fallback:
|
|
57
57
|
|
|
58
|
-
- Run `npx --yes copilotkit@4.9.
|
|
58
|
+
- Run `npx --yes copilotkit@4.9.24 onboard audit` from the target app directory.
|
|
59
59
|
- If a result starts with `Status: blocked`, stop onboarding and report the printed reason.
|
|
60
60
|
It proved nothing changed, so do not report a preservation failure.
|
|
61
61
|
- If a result reports a changed protected path, stop onboarding.
|
|
@@ -107,13 +107,13 @@ application passes proof. Report each tool result separately from the proof resu
|
|
|
107
107
|
Report the documentation gap and each assumption with the proof evidence. Do not claim
|
|
108
108
|
that the selected documentation proved an inferred step.
|
|
109
109
|
|
|
110
|
-
When the proof is complete, run `npx --yes copilotkit@4.9.
|
|
110
|
+
When the proof is complete, run `npx --yes copilotkit@4.9.24 onboard complete`, carrying the
|
|
111
111
|
surface-check result the proof subagent returned. Pass exactly one flag, matching this
|
|
112
112
|
journey's surface:
|
|
113
113
|
|
|
114
114
|
```text
|
|
115
|
-
npx --yes copilotkit@4.9.
|
|
116
|
-
npx --yes copilotkit@4.9.
|
|
115
|
+
npx --yes copilotkit@4.9.24 onboard complete --visual-check <outcome>
|
|
116
|
+
npx --yes copilotkit@4.9.24 onboard complete --device-check <outcome>
|
|
117
117
|
```
|
|
118
118
|
|
|
119
119
|
`--visual-check` is for a web frontend and takes `performed`, `skipped-no-browser-tool`, or
|
|
@@ -122,6 +122,7 @@ or `failed`. Anything but `performed` ends this run as blocked, and the command'
|
|
|
122
122
|
names the evidence that is missing. Report it that way.
|
|
123
123
|
|
|
124
124
|
If the proof passed and something after it still blocked this run, add
|
|
125
|
-
`--blocked-by <cause>` to the same command, with one of `
|
|
126
|
-
|
|
127
|
-
|
|
125
|
+
`--blocked-by <cause>` to the same command, with one of `inspector`, `plan-excluded-capability`,
|
|
126
|
+
or `other`. It ends the run as blocked and names what the blocker leaves unverified. The
|
|
127
|
+
managed Intelligence dashboard is not a cause, because nothing in this graph asks a run to
|
|
128
|
+
open it.
|
|
@@ -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.24 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.24 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.24 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.24 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.24 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.24 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.24 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.24 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.24 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.24 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.24 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.24 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.24 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.24 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.24 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.24 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.24 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.24 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.24 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.24 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.24 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.24 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.24 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.24 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.24 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.24 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.24 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.24 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.24 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.24 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.24 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.24 onboard read unsupported/no-validated-path`.
|
|
@@ -19,7 +19,7 @@ documented backend set with
|
|
|
19
19
|
`uv add 'pydantic-ai-slim[ag-ui,openai]>=2,<3' 'starlette>=0.46.2' uvicorn`.
|
|
20
20
|
Keep the Starlette endpoint that calls `AGUIAdapter.dispatch_request`, unless the app
|
|
21
21
|
context route below replaces it with the two-step form. Register it in Copilot Runtime
|
|
22
|
-
with `HttpAgent
|
|
22
|
+
with `HttpAgent`. Do not replace this transport with a different Pydantic AI adapter.
|
|
23
23
|
|
|
24
24
|
A2UI is not on this path. If the developer asks for it, say first that the documented
|
|
25
25
|
Python setup does not support `action_handlers` on `a2ui.render`, so its button callback
|
|
@@ -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.24 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.24 onboard read unsupported/no-validated-path`.
|