copilotkit 4.10.0 → 4.10.1
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 +10 -3
- package/cli-build-info.json +8 -8
- package/index.js +16 -14
- package/onboarding/index.json +26 -1
- package/onboarding/prompts/authenticate/start.md +6 -6
- package/onboarding/prompts/conversion/plan.md +3 -3
- package/onboarding/prompts/credentials/finalize-plan.md +7 -7
- package/onboarding/prompts/credentials/plan.md +20 -20
- package/onboarding/prompts/credentials/settle-credentials.md +7 -7
- package/onboarding/prompts/credentials/write-plan.md +5 -5
- package/onboarding/prompts/fallback/best-effort.md +6 -6
- package/onboarding/prompts/feature/a2ui/implement.md +6 -6
- package/onboarding/prompts/feature/a2ui/proof.md +6 -6
- package/onboarding/prompts/feature/a2ui/start.md +7 -7
- package/onboarding/prompts/feature/channels/implement.md +70 -0
- package/onboarding/prompts/feature/channels/proof.md +60 -0
- package/onboarding/prompts/feature/channels/start.md +87 -0
- package/onboarding/prompts/feature/chat-suggestions/implement.md +6 -6
- package/onboarding/prompts/feature/chat-suggestions/proof.md +6 -6
- package/onboarding/prompts/feature/chat-suggestions/start.md +7 -7
- package/onboarding/prompts/feature/complete.md +1 -1
- package/onboarding/prompts/feature/learning/implement.md +12 -12
- package/onboarding/prompts/feature/learning/proof.md +7 -7
- package/onboarding/prompts/feature/learning/start.md +6 -6
- package/onboarding/prompts/feature/open-generative-ui/implement.md +6 -6
- package/onboarding/prompts/feature/open-generative-ui/proof.md +6 -6
- package/onboarding/prompts/feature/open-generative-ui/start.md +7 -7
- package/onboarding/prompts/feature/realtime-sync/implement.md +7 -7
- package/onboarding/prompts/feature/realtime-sync/proof.md +6 -6
- package/onboarding/prompts/feature/realtime-sync/start.md +6 -6
- package/onboarding/prompts/feature/rich-threads/implement.md +8 -8
- package/onboarding/prompts/feature/rich-threads/proof.md +6 -6
- package/onboarding/prompts/feature/rich-threads/start.md +6 -6
- package/onboarding/prompts/feature/stop.md +10 -4
- package/onboarding/prompts/feature/voice/implement.md +6 -6
- package/onboarding/prompts/feature/voice/proof.md +6 -6
- package/onboarding/prompts/feature/voice/start.md +7 -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 +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 +15 -15
- package/onboarding/prompts/proof/complete.md +8 -8
- package/onboarding/prompts/proof/oss-baseline.md +5 -5
- package/onboarding/prompts/proof/round-trip.md +10 -10
- package/onboarding/prompts/research/gather.md +4 -4
- package/onboarding/prompts/research/route.md +4 -4
- package/onboarding/prompts/starter/clone.md +5 -5
- package/onboarding/prompts/stopped/run-failed.md +1 -1
- package/onboarding/prompts/subagent/create-plan.md +1 -1
- package/onboarding/prompts/subagent/prove-oss-baseline.md +1 -1
- package/onboarding/prompts/subagent/prove-round-trip.md +7 -7
- package/onboarding/prompts/unsupported/no-validated-path.md +2 -2
- package/package.json +1 -1
- package/release/release-tool.js +1 -1
|
@@ -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.10.
|
|
27
|
+
`npx --yes copilotkit@4.10.1 onboard read frontend/plan`.
|
|
28
28
|
|
|
29
29
|
If the documentation does not support the selection, run
|
|
30
|
-
`npx --yes copilotkit@4.10.
|
|
30
|
+
`npx --yes copilotkit@4.10.1 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.10.
|
|
18
|
+
`npx --yes copilotkit@4.10.1 onboard read frontend/plan`.
|
|
19
19
|
|
|
20
20
|
If the documentation does not support the selection, run
|
|
21
|
-
`npx --yes copilotkit@4.10.
|
|
21
|
+
`npx --yes copilotkit@4.10.1 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.10.
|
|
18
|
+
`npx --yes copilotkit@4.10.1 onboard read frontend/plan`.
|
|
19
19
|
|
|
20
20
|
If the documentation does not support the selection, run
|
|
21
|
-
`npx --yes copilotkit@4.10.
|
|
21
|
+
`npx --yes copilotkit@4.10.1 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.10.
|
|
37
|
+
`npx --yes copilotkit@4.10.1 onboard read frontend/plan`.
|
|
38
38
|
|
|
39
39
|
If the documentation does not support the selection, run
|
|
40
|
-
`npx --yes copilotkit@4.10.
|
|
40
|
+
`npx --yes copilotkit@4.10.1 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.10.
|
|
48
|
+
`npx --yes copilotkit@4.10.1 onboard read frontend/plan`.
|
|
49
49
|
|
|
50
50
|
If the documentation does not support the selection, run
|
|
51
|
-
`npx --yes copilotkit@4.10.
|
|
51
|
+
`npx --yes copilotkit@4.10.1 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.10.
|
|
37
|
+
`npx --yes copilotkit@4.10.1 onboard read frontend/plan`.
|
|
38
38
|
|
|
39
39
|
If the documentation does not support the selection, run
|
|
40
|
-
`npx --yes copilotkit@4.10.
|
|
40
|
+
`npx --yes copilotkit@4.10.1 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.10.
|
|
47
|
+
`npx --yes copilotkit@4.10.1 onboard read frontend/plan`.
|
|
48
48
|
|
|
49
49
|
If the documentation does not support the selection, run
|
|
50
|
-
`npx --yes copilotkit@4.10.
|
|
50
|
+
`npx --yes copilotkit@4.10.1 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.10.
|
|
31
|
+
`npx --yes copilotkit@4.10.1 onboard read frontend/plan`.
|
|
32
32
|
|
|
33
33
|
If the documentation does not support the selection, run
|
|
34
|
-
`npx --yes copilotkit@4.10.
|
|
34
|
+
`npx --yes copilotkit@4.10.1 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.10.
|
|
46
|
+
`npx --yes copilotkit@4.10.1 onboard read frontend/plan`.
|
|
47
47
|
|
|
48
48
|
If the documentation does not support the selection, run
|
|
49
|
-
`npx --yes copilotkit@4.10.
|
|
49
|
+
`npx --yes copilotkit@4.10.1 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.10.
|
|
30
|
+
`npx --yes copilotkit@4.10.1 onboard read frontend/plan`.
|
|
31
31
|
|
|
32
32
|
If the documentation does not support the selection, run
|
|
33
|
-
`npx --yes copilotkit@4.10.
|
|
33
|
+
`npx --yes copilotkit@4.10.1 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.10.
|
|
31
|
+
`npx --yes copilotkit@4.10.1 onboard read frontend/plan`.
|
|
32
32
|
|
|
33
33
|
If the documentation does not support the selection, run
|
|
34
|
-
`npx --yes copilotkit@4.10.
|
|
34
|
+
`npx --yes copilotkit@4.10.1 onboard read unsupported/no-validated-path`.
|
|
@@ -5,7 +5,7 @@ Preserve an existing Angular frontend. Use the selected page for a new frontend.
|
|
|
5
5
|
Use the starter shortcut only if all these facts are true: the target directory contains
|
|
6
6
|
no entries, its name is a valid `init` project name, and the selected framework is ADK.
|
|
7
7
|
If all three facts are true, record Angular as the selected frontend. Then run
|
|
8
|
-
`npx --yes copilotkit@4.10.
|
|
8
|
+
`npx --yes copilotkit@4.10.1 onboard read starter/clone` before you fetch documentation.
|
|
9
9
|
|
|
10
10
|
## Documentation
|
|
11
11
|
|
|
@@ -63,7 +63,7 @@ you create or build an Angular project. If the installed version is lower, selec
|
|
|
63
63
|
supported version first and use it for every later command in this project.
|
|
64
64
|
|
|
65
65
|
If the pages support the selection, record Angular and these URLs. Then run
|
|
66
|
-
`npx --yes copilotkit@4.10.
|
|
66
|
+
`npx --yes copilotkit@4.10.1 onboard read credentials/finalize-plan`.
|
|
67
67
|
|
|
68
68
|
If the documentation does not support the selection, or the two version lines do not fit
|
|
69
|
-
together, run `npx --yes copilotkit@4.10.
|
|
69
|
+
together, run `npx --yes copilotkit@4.10.1 onboard read unsupported/no-validated-path`.
|
|
@@ -15,7 +15,7 @@ These TypeScript options have starters: Claude Agent SDK TypeScript, LangGraph T
|
|
|
15
15
|
Mastra, and Strands Agents TypeScript. The .NET option is Microsoft Agent Framework .NET.
|
|
16
16
|
|
|
17
17
|
If all shortcut conditions are true, record Next.js as the selected frontend. Then run
|
|
18
|
-
`npx --yes copilotkit@4.10.
|
|
18
|
+
`npx --yes copilotkit@4.10.1 onboard read starter/clone` before you fetch documentation.
|
|
19
19
|
|
|
20
20
|
## Documentation
|
|
21
21
|
|
|
@@ -27,7 +27,7 @@ agent as the default agent, which is correct only for a project that has no agen
|
|
|
27
27
|
Do not replace the developer's existing agent with the built-in agent.
|
|
28
28
|
|
|
29
29
|
If the page supports the selection, record Next.js and this URL. Then run
|
|
30
|
-
`npx --yes copilotkit@4.10.
|
|
30
|
+
`npx --yes copilotkit@4.10.1 onboard read credentials/finalize-plan`.
|
|
31
31
|
|
|
32
32
|
If the documentation does not support the selection, run
|
|
33
|
-
`npx --yes copilotkit@4.10.
|
|
33
|
+
`npx --yes copilotkit@4.10.1 onboard read unsupported/no-validated-path`.
|
|
@@ -24,11 +24,11 @@ process.
|
|
|
24
24
|
|
|
25
25
|
Use exactly one matching internal route:
|
|
26
26
|
|
|
27
|
-
1. React SPA: `npx --yes copilotkit@4.10.
|
|
28
|
-
2. Next.js: `npx --yes copilotkit@4.10.
|
|
29
|
-
3. Angular: `npx --yes copilotkit@4.10.
|
|
30
|
-
4. Vue 3: `npx --yes copilotkit@4.10.
|
|
31
|
-
5. React Native: `npx --yes copilotkit@4.10.
|
|
27
|
+
1. React SPA: `npx --yes copilotkit@4.10.1 onboard read frontend/react-spa`
|
|
28
|
+
2. Next.js: `npx --yes copilotkit@4.10.1 onboard read frontend/nextjs`
|
|
29
|
+
3. Angular: `npx --yes copilotkit@4.10.1 onboard read frontend/angular`
|
|
30
|
+
4. Vue 3: `npx --yes copilotkit@4.10.1 onboard read frontend/vue`
|
|
31
|
+
5. React Native: `npx --yes copilotkit@4.10.1 onboard read frontend/react-native`
|
|
32
32
|
|
|
33
33
|
If no listed frontend fits, run
|
|
34
|
-
`npx --yes copilotkit@4.10.
|
|
34
|
+
`npx --yes copilotkit@4.10.1 onboard read unsupported/no-validated-path`.
|
|
@@ -15,7 +15,7 @@ documents `useRenderTool`, which is React Native's own hook for drawing a tool t
|
|
|
15
15
|
already has. That is a different job and needs a tool in the agent.
|
|
16
16
|
|
|
17
17
|
If the pages support the selection, record React Native and these URLs. Then run
|
|
18
|
-
`npx --yes copilotkit@4.10.
|
|
18
|
+
`npx --yes copilotkit@4.10.1 onboard read credentials/finalize-plan`.
|
|
19
19
|
|
|
20
20
|
If the documentation does not support the selection, run
|
|
21
|
-
`npx --yes copilotkit@4.10.
|
|
21
|
+
`npx --yes copilotkit@4.10.1 onboard read unsupported/no-validated-path`.
|
|
@@ -11,7 +11,7 @@ not move the agent into it.
|
|
|
11
11
|
- https://docs.copilotkit.ai/react-spa.md
|
|
12
12
|
|
|
13
13
|
If the page supports the selection, record React SPA and this URL. Then run
|
|
14
|
-
`npx --yes copilotkit@4.10.
|
|
14
|
+
`npx --yes copilotkit@4.10.1 onboard read credentials/finalize-plan`.
|
|
15
15
|
|
|
16
16
|
If the documentation does not support the selection, run
|
|
17
|
-
`npx --yes copilotkit@4.10.
|
|
17
|
+
`npx --yes copilotkit@4.10.1 onboard read unsupported/no-validated-path`.
|
|
@@ -16,7 +16,7 @@ page above. Vue has its own `useComponent`, which is not the React package. Take
|
|
|
16
16
|
that reference page rather than from a Vue generative-UI guide, which is not published.
|
|
17
17
|
|
|
18
18
|
If the pages support the selection, record Vue 3 and these URLs. Then run
|
|
19
|
-
`npx --yes copilotkit@4.10.
|
|
19
|
+
`npx --yes copilotkit@4.10.1 onboard read credentials/finalize-plan`.
|
|
20
20
|
|
|
21
21
|
If the documentation does not support the selection, run
|
|
22
|
-
`npx --yes copilotkit@4.10.
|
|
22
|
+
`npx --yes copilotkit@4.10.1 onboard read unsupported/no-validated-path`.
|
|
@@ -11,7 +11,7 @@ only the step cannot be acted on. Send one short report before you stop. Run the
|
|
|
11
11
|
report is sent.
|
|
12
12
|
|
|
13
13
|
```text
|
|
14
|
-
npx --yes copilotkit@4.10.
|
|
14
|
+
npx --yes copilotkit@4.10.1 onboard friction --phase stop --category <slug>
|
|
15
15
|
```
|
|
16
16
|
|
|
17
17
|
Write one or two sentences to standard input: the step you stopped at and what stopped it.
|
|
@@ -31,7 +31,7 @@ Approving the plan is the developer agreeing to every path it listed under
|
|
|
31
31
|
app directory:
|
|
32
32
|
|
|
33
33
|
```text
|
|
34
|
-
npx --yes copilotkit@4.10.
|
|
34
|
+
npx --yes copilotkit@4.10.1 onboard protect --authorize --path <path> --reason "<the plan's sentence>"
|
|
35
35
|
```
|
|
36
36
|
|
|
37
37
|
Consent has to be on the record before the file moves, so a call made after the change is
|
|
@@ -43,7 +43,7 @@ No implementation step has run yet, so the change is theirs rather than this run
|
|
|
43
43
|
consent over it by adding one flag:
|
|
44
44
|
|
|
45
45
|
```text
|
|
46
|
-
npx --yes copilotkit@4.10.
|
|
46
|
+
npx --yes copilotkit@4.10.1 onboard protect --authorize --path <path> --reason "<the plan's sentence>" --with-prior-change
|
|
47
47
|
```
|
|
48
48
|
|
|
49
49
|
The flag records their change as drift beside the consent, so the closing report names both
|
|
@@ -62,7 +62,7 @@ rather than this section.
|
|
|
62
62
|
Run the audit from the target app directory:
|
|
63
63
|
|
|
64
64
|
```text
|
|
65
|
-
npx --yes copilotkit@4.10.
|
|
65
|
+
npx --yes copilotkit@4.10.1 onboard audit
|
|
66
66
|
```
|
|
67
67
|
|
|
68
68
|
It compares every protected path with the digest the CLI captured for it. Its result starts
|
|
@@ -97,14 +97,14 @@ A path that no Files changed section names changed outside the run, and it is th
|
|
|
97
97
|
developer's own file. Accept it by name:
|
|
98
98
|
|
|
99
99
|
```text
|
|
100
|
-
npx --yes copilotkit@4.10.
|
|
100
|
+
npx --yes copilotkit@4.10.1 onboard protect --accept-external --path <path>
|
|
101
101
|
```
|
|
102
102
|
|
|
103
103
|
A changed env file is its own case. This run asked the developer to place a credential
|
|
104
104
|
there, so it takes the credential route rather than this one:
|
|
105
105
|
|
|
106
106
|
```text
|
|
107
|
-
npx --yes copilotkit@4.10.
|
|
107
|
+
npx --yes copilotkit@4.10.1 onboard protect --accept-credential --path <path>
|
|
108
108
|
```
|
|
109
109
|
|
|
110
110
|
That route proves no recorded credential was lost, instead of taking the run's word that it
|
|
@@ -123,7 +123,7 @@ neither does a one-line fix. Never repair, reset, or revert it. Ask the develope
|
|
|
123
123
|
the change, and record the answer they give:
|
|
124
124
|
|
|
125
125
|
```text
|
|
126
|
-
npx --yes copilotkit@4.10.
|
|
126
|
+
npx --yes copilotkit@4.10.1 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
|
|
127
127
|
```
|
|
128
128
|
|
|
129
129
|
Use it only for an answer a developer actually gave. It records the consent as taken
|
|
@@ -144,7 +144,7 @@ create it now, from the target app directory. The developer approved the id befo
|
|
|
144
144
|
made, so this is the first point at which it can be created:
|
|
145
145
|
|
|
146
146
|
```text
|
|
147
|
-
npx --yes copilotkit@4.10.
|
|
147
|
+
npx --yes copilotkit@4.10.1 learning containers create --id <id> --name <name> --json
|
|
148
148
|
```
|
|
149
149
|
|
|
150
150
|
Pass the id the plan names. Take the name from the selected project's own display name, so
|
|
@@ -160,7 +160,7 @@ hold.
|
|
|
160
160
|
Then report that the container is settled, before any edit:
|
|
161
161
|
|
|
162
162
|
```text
|
|
163
|
-
npx --yes copilotkit@4.10.
|
|
163
|
+
npx --yes copilotkit@4.10.1 onboard checkpoint --phase container-settled
|
|
164
164
|
```
|
|
165
165
|
|
|
166
166
|
Where the plan names a container the platform already held, report the same checkpoint and
|
|
@@ -169,11 +169,11 @@ create nothing. Where the plan names no container, skip this section.
|
|
|
169
169
|
Report the plan this run is about to implement:
|
|
170
170
|
|
|
171
171
|
```text
|
|
172
|
-
npx --yes copilotkit@4.10.
|
|
172
|
+
npx --yes copilotkit@4.10.1 onboard checkpoint --phase plan-written
|
|
173
173
|
```
|
|
174
174
|
|
|
175
175
|
Spawn one implementation subagent. Tell it to run
|
|
176
|
-
`npx --yes copilotkit@4.10.
|
|
176
|
+
`npx --yes copilotkit@4.10.1 onboard read subagent/implement-and-validate` first and follow
|
|
177
177
|
the prompt it returns. If that read fails because the subagent cannot use the shell, stop that
|
|
178
178
|
subagent. Run the same command yourself, then spawn a fresh subagent with the returned prompt
|
|
179
179
|
and the same handoff. Give it the plan, selected framework, frontend, model, exact target app
|
|
@@ -193,11 +193,11 @@ returned. Continue to proof only when that audit passes.
|
|
|
193
193
|
After the selected implementation path passes, report it:
|
|
194
194
|
|
|
195
195
|
```text
|
|
196
|
-
npx --yes copilotkit@4.10.
|
|
196
|
+
npx --yes copilotkit@4.10.1 onboard checkpoint --phase build-validated
|
|
197
197
|
```
|
|
198
198
|
|
|
199
199
|
Then run
|
|
200
|
-
`npx --yes copilotkit@4.10.
|
|
200
|
+
`npx --yes copilotkit@4.10.1 onboard read proof/round-trip`.
|
|
201
201
|
|
|
202
202
|
## Repair rules
|
|
203
203
|
|
|
@@ -219,9 +219,9 @@ the same command still fails after three repair attempts, or a result starts wit
|
|
|
219
219
|
`Status: blocked`. A defect in a package this run installed is not a stack CopilotKit does
|
|
220
220
|
not serve, a command this run cannot get to pass is not one either, and a blocked audit
|
|
221
221
|
proved nothing about the stack. In those cases run
|
|
222
|
-
`npx --yes copilotkit@4.10.
|
|
222
|
+
`npx --yes copilotkit@4.10.1 onboard read stopped/run-failed`.
|
|
223
223
|
|
|
224
224
|
A plan with no path to follow takes the unsupported ending: the fix requires changing the
|
|
225
225
|
developer's existing agent or frontend, or the documentation does not support the plan. In
|
|
226
226
|
those cases run
|
|
227
|
-
`npx --yes copilotkit@4.10.
|
|
227
|
+
`npx --yes copilotkit@4.10.1 onboard read unsupported/no-validated-path`.
|
|
@@ -66,7 +66,7 @@ Name the debugging surface this journey's frontend can reach, rather than the on
|
|
|
66
66
|
of the documentation leads with. For a web frontend it is the CopilotKit Inspector. For
|
|
67
67
|
React Native there is no Inspector: it is a browser overlay built on a DOM custom element,
|
|
68
68
|
and `@copilotkit/react-native` does not ship it. Give a mobile developer
|
|
69
|
-
`npx --yes copilotkit@4.10.
|
|
69
|
+
`npx --yes copilotkit@4.10.1 verify --round-trip`, the runtime's own log, the AG-UI
|
|
70
70
|
Event Inspector in the CopilotKit VS Code extension, and the Intelligence thread view
|
|
71
71
|
instead. Naming the Inspector to a developer who cannot open it costs them the time it
|
|
72
72
|
takes to conclude their own wiring is broken.
|
|
@@ -89,7 +89,7 @@ the friction commands without another developer question. The CLI telemetry gate
|
|
|
89
89
|
whether the report is sent.
|
|
90
90
|
|
|
91
91
|
```text
|
|
92
|
-
npx --yes copilotkit@4.10.
|
|
92
|
+
npx --yes copilotkit@4.10.1 onboard friction --category <slug> --cost-seconds <seconds>
|
|
93
93
|
```
|
|
94
94
|
|
|
95
95
|
Write one or two sentences on the command's standard input. Pick one category from
|
|
@@ -101,7 +101,7 @@ Pass --docs-path only for a docs-missing or docs-wrong report, naming the page t
|
|
|
101
101
|
is about:
|
|
102
102
|
|
|
103
103
|
```text
|
|
104
|
-
npx --yes copilotkit@4.10.
|
|
104
|
+
npx --yes copilotkit@4.10.1 onboard friction --category docs-wrong --cost-seconds 300 --docs-path /docs/threads/drawer
|
|
105
105
|
```
|
|
106
106
|
|
|
107
107
|
Give the page's site-relative path or its full URL, with no spaces, query string, or
|
|
@@ -118,14 +118,14 @@ Tell the developer when you send a friction report. Do not quote or summarize th
|
|
|
118
118
|
unless the developer asks. If the CLI says the report was not sent,
|
|
119
119
|
state what it said and continue without another question.
|
|
120
120
|
|
|
121
|
-
When the evidence is gathered, run `npx --yes copilotkit@4.10.
|
|
121
|
+
When the evidence is gathered, run `npx --yes copilotkit@4.10.1 onboard complete`, carrying
|
|
122
122
|
the surface-check outcome the proof subagent returned. Pass exactly one flag, and pass the
|
|
123
123
|
one that matches this journey's surface.
|
|
124
124
|
|
|
125
125
|
For a web frontend -- React SPA, Next.js, Angular, Vue:
|
|
126
126
|
|
|
127
127
|
```text
|
|
128
|
-
npx --yes copilotkit@4.10.
|
|
128
|
+
npx --yes copilotkit@4.10.1 onboard complete --visual-check <outcome>
|
|
129
129
|
```
|
|
130
130
|
|
|
131
131
|
The outcome is one of `performed`, `skipped-no-browser-tool`, or `failed`.
|
|
@@ -133,7 +133,7 @@ The outcome is one of `performed`, `skipped-no-browser-tool`, or `failed`.
|
|
|
133
133
|
For React Native:
|
|
134
134
|
|
|
135
135
|
```text
|
|
136
|
-
npx --yes copilotkit@4.10.
|
|
136
|
+
npx --yes copilotkit@4.10.1 onboard complete --device-check <outcome>
|
|
137
137
|
```
|
|
138
138
|
|
|
139
139
|
The outcome is one of `performed`, `skipped-no-device`, or `failed`.
|
|
@@ -145,7 +145,7 @@ browser-origin CORS, so the flag you pass is how this run states which surface i
|
|
|
145
145
|
For a web frontend, also pass the URL the browser opened:
|
|
146
146
|
|
|
147
147
|
```text
|
|
148
|
-
npx --yes copilotkit@4.10.
|
|
148
|
+
npx --yes copilotkit@4.10.1 onboard complete --visual-check <outcome> \
|
|
149
149
|
--frontend-url <the url you opened>
|
|
150
150
|
```
|
|
151
151
|
|
|
@@ -164,7 +164,7 @@ If the round trip proved and something after it still blocked this run, add `--b
|
|
|
164
164
|
to the same command:
|
|
165
165
|
|
|
166
166
|
```text
|
|
167
|
-
npx --yes copilotkit@4.10.
|
|
167
|
+
npx --yes copilotkit@4.10.1 onboard complete --visual-check performed --blocked-by <cause>
|
|
168
168
|
```
|
|
169
169
|
|
|
170
170
|
The cause is one of `inspector` for a debugging surface that did not open,
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# Prove the existing OSS baseline
|
|
2
2
|
|
|
3
3
|
Do not prove the baseline yourself. Spawn one proof subagent. Tell it to run
|
|
4
|
-
`npx --yes copilotkit@4.10.
|
|
4
|
+
`npx --yes copilotkit@4.10.1 onboard read subagent/prove-oss-baseline` first and follow the
|
|
5
5
|
prompt it returns. If that read fails because the subagent cannot use the shell, stop that
|
|
6
6
|
subagent. Run the same command yourself, then spawn a fresh subagent with the returned prompt
|
|
7
7
|
and the same handoff. Give it the repository findings and exact CLI package spec.
|
|
@@ -17,7 +17,7 @@ Wait for the subagent to finish.
|
|
|
17
17
|
Record what that proof returned before you route on it:
|
|
18
18
|
|
|
19
19
|
```text
|
|
20
|
-
npx --yes copilotkit@4.10.
|
|
20
|
+
npx --yes copilotkit@4.10.1 onboard proof --step oss-baseline --outcome <passed|failed|skipped> [--predicate <1-6>]
|
|
21
21
|
```
|
|
22
22
|
|
|
23
23
|
Report the gate whatever it returned. Pass `passed` when the subagent proved a predicate,
|
|
@@ -35,12 +35,12 @@ Do not change project files before this proof ends. Starting existing developmen
|
|
|
35
35
|
processes and their ignored runtime files is allowed.
|
|
36
36
|
|
|
37
37
|
If the subagent proves the `both-oss` predicate, keep its evidence with the plan and run
|
|
38
|
-
`npx --yes copilotkit@4.10.
|
|
38
|
+
`npx --yes copilotkit@4.10.1 onboard read conversion/plan`. That project already works.
|
|
39
39
|
What it needs is the conversion, not a build.
|
|
40
40
|
|
|
41
41
|
If the proof does not establish the baseline, record the starting state
|
|
42
42
|
`both-copilotkit-unproved` and run
|
|
43
|
-
`npx --yes copilotkit@4.10.
|
|
43
|
+
`npx --yes copilotkit@4.10.1 onboard read credentials/plan`. This prompt is served
|
|
44
44
|
whenever a project looks like an OSS integration, so a baseline that did not prove is an
|
|
45
45
|
ordinary starting state rather than a failure. Keep the failing predicate with the plan.
|
|
46
46
|
|
|
@@ -54,5 +54,5 @@ and the plan preserves it rather than repeating it.
|
|
|
54
54
|
|
|
55
55
|
If it cannot identify the running process safely, exposes a secret, or finds a baseline
|
|
56
56
|
failure that cannot be classified, run
|
|
57
|
-
`npx --yes copilotkit@4.10.
|
|
57
|
+
`npx --yes copilotkit@4.10.1 onboard read stopped/run-failed`. None of those mean the
|
|
58
58
|
project is unsupported: they mean this run did not establish what it needed to.
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# Prove the user journey
|
|
2
2
|
|
|
3
3
|
Do not do the proof work yourself. Spawn one proof subagent. Tell it to run
|
|
4
|
-
`npx --yes copilotkit@4.10.
|
|
4
|
+
`npx --yes copilotkit@4.10.1 onboard read subagent/prove-round-trip` first and follow the
|
|
5
5
|
prompt it returns. If that read fails because the subagent cannot use the shell, stop that
|
|
6
6
|
subagent. Run the same command yourself, then spawn a fresh subagent with the returned prompt
|
|
7
7
|
and the same handoff. Give it the selected framework, frontend, model, approved plan, selected
|
|
@@ -32,13 +32,13 @@ pass the time.
|
|
|
32
32
|
Report each attempt at the journey as it ends, counting from one:
|
|
33
33
|
|
|
34
34
|
```text
|
|
35
|
-
npx --yes copilotkit@4.10.
|
|
35
|
+
npx --yes copilotkit@4.10.1 onboard checkpoint --phase journey-attempted --attempt 1
|
|
36
36
|
```
|
|
37
37
|
|
|
38
38
|
Record what that proof returned before you route on it:
|
|
39
39
|
|
|
40
40
|
```text
|
|
41
|
-
npx --yes copilotkit@4.10.
|
|
41
|
+
npx --yes copilotkit@4.10.1 onboard proof --step round-trip --outcome <passed|failed|skipped>
|
|
42
42
|
```
|
|
43
43
|
|
|
44
44
|
Report the gate whatever it returned. A proof that never ran is `skipped`, not failed. The
|
|
@@ -46,7 +46,7 @@ command prints one line and sends nothing else. Where a repair cycle runs the pr
|
|
|
46
46
|
record each attempt as it ends.
|
|
47
47
|
|
|
48
48
|
For every protected-path audit in this prompt, run
|
|
49
|
-
`npx --yes copilotkit@4.10.
|
|
49
|
+
`npx --yes copilotkit@4.10.1 onboard audit` from the target app directory. If its result
|
|
50
50
|
starts with `Status: blocked`, report the printed reason and use the route-out rules below.
|
|
51
51
|
A blocked audit proved nothing changed and is not a preservation failure. If a
|
|
52
52
|
protected-path audit reports a changed path, decide it the way the implementation prompt
|
|
@@ -55,7 +55,7 @@ returns none, so a finding with no Files changed section to test against routes
|
|
|
55
55
|
path one of those sections names is this run's own change and routes out too. Accept a
|
|
56
56
|
path only when a section this run collected covers the step that wrote it and does not
|
|
57
57
|
name it:
|
|
58
|
-
`npx --yes copilotkit@4.10.
|
|
58
|
+
`npx --yes copilotkit@4.10.1 onboard protect --accept-external --path <path>`. Then run
|
|
59
59
|
the audit again and name the path in the closing summary. Never repair, reset, or revert a
|
|
60
60
|
protected path.
|
|
61
61
|
|
|
@@ -63,12 +63,12 @@ That holds for a repair cycle too. When the fix for a failing check lands on a p
|
|
|
63
63
|
path, the path is still the developer's, however right the diagnosis is and however small
|
|
64
64
|
the fix. Reading the file never settles who wrote it. Ask the developer to allow the
|
|
65
65
|
change, and record their answer with
|
|
66
|
-
`npx --yes copilotkit@4.10.
|
|
66
|
+
`npx --yes copilotkit@4.10.1 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"`,
|
|
67
67
|
or route out. Never repair it, and never send it to a repair worker.
|
|
68
68
|
|
|
69
69
|
If the proof result starts with `Status: passed`, run the protected-path audit. Continue to
|
|
70
70
|
`proof/complete` only if that audit passes. After the audit passes, run
|
|
71
|
-
`npx --yes copilotkit@4.10.
|
|
71
|
+
`npx --yes copilotkit@4.10.1 onboard read proof/complete`. A performed surface outcome with
|
|
72
72
|
the full round trip is core success even if a continued-development tool fails. A skipped
|
|
73
73
|
surface outcome still enters `proof/complete` so the CLI records the blocked result. Do not
|
|
74
74
|
describe a skipped surface as proved. Keep the Skills and MCP results separate from the proof
|
|
@@ -124,7 +124,7 @@ Restart each project-owned process changed by the repair. Report the cycle, coun
|
|
|
124
124
|
one:
|
|
125
125
|
|
|
126
126
|
```text
|
|
127
|
-
npx --yes copilotkit@4.10.
|
|
127
|
+
npx --yes copilotkit@4.10.1 onboard checkpoint --phase repair-attempted --attempt 1
|
|
128
128
|
```
|
|
129
129
|
|
|
130
130
|
Then spawn a fresh proof subagent
|
|
@@ -142,7 +142,7 @@ and proof cycles.
|
|
|
142
142
|
|
|
143
143
|
Route out only when the failure is not yours to fix, when the same proof still fails after
|
|
144
144
|
three attempts, or when no evidence of the round trip can be produced. In those cases run
|
|
145
|
-
`npx --yes copilotkit@4.10.
|
|
145
|
+
`npx --yes copilotkit@4.10.1 onboard read stopped/run-failed`. The stack is supported:
|
|
146
146
|
this run did not finish, which is a different ending and a different report. All three are
|
|
147
147
|
about the round trip itself. A round trip that proved is not one of them, whatever failed
|
|
148
148
|
after it.
|
|
@@ -153,7 +153,7 @@ Run the friction command without another developer question. The CLI telemetry g
|
|
|
153
153
|
whether the report is sent.
|
|
154
154
|
|
|
155
155
|
```text
|
|
156
|
-
npx --yes copilotkit@4.10.
|
|
156
|
+
npx --yes copilotkit@4.10.1 onboard friction --phase stop --category <slug>
|
|
157
157
|
```
|
|
158
158
|
|
|
159
159
|
Write one or two sentences to standard input: the step you stopped at and what stopped it.
|
|
@@ -27,7 +27,7 @@ Before you ask the developer any setup question, finish every read-only investig
|
|
|
27
27
|
preflight check in this section.
|
|
28
28
|
|
|
29
29
|
Prepare two research assignments. Give each research subagent one assignment. Tell it to run
|
|
30
|
-
`npx --yes copilotkit@4.10.
|
|
30
|
+
`npx --yes copilotkit@4.10.1 onboard read subagent/inspect-repository` first and follow the
|
|
31
31
|
prompt it returns. If that read fails because the subagent cannot use the shell, stop that
|
|
32
32
|
subagent. Run the same command yourself, then spawn a fresh subagent with the returned prompt
|
|
33
33
|
and the same handoff. Require only its assigned packet.
|
|
@@ -92,7 +92,7 @@ Wait for both research subagents to finish.
|
|
|
92
92
|
Then report that the research came back:
|
|
93
93
|
|
|
94
94
|
```text
|
|
95
|
-
npx --yes copilotkit@4.10.
|
|
95
|
+
npx --yes copilotkit@4.10.1 onboard checkpoint --phase research-returned
|
|
96
96
|
```
|
|
97
97
|
|
|
98
98
|
A refused checkpoint prints its reason and leaves onboarding unaffected. It is not a
|
|
@@ -115,7 +115,7 @@ both workers return the same one target app directory. Both results must start w
|
|
|
115
115
|
`Status: passed`. Otherwise, use the stop route.
|
|
116
116
|
|
|
117
117
|
When both research results are merged, run
|
|
118
|
-
`npx --yes copilotkit@4.10.
|
|
118
|
+
`npx --yes copilotkit@4.10.1 onboard read research/route`.
|
|
119
119
|
|
|
120
120
|
If inspection stops onboarding, run
|
|
121
|
-
`npx --yes copilotkit@4.10.
|
|
121
|
+
`npx --yes copilotkit@4.10.1 onboard read stopped/run-failed`.
|
|
@@ -9,7 +9,7 @@ sends the run down one path.
|
|
|
9
9
|
Before you route on, run this from the target app directory:
|
|
10
10
|
|
|
11
11
|
```text
|
|
12
|
-
npx --yes copilotkit@4.10.
|
|
12
|
+
npx --yes copilotkit@4.10.1 onboard protect
|
|
13
13
|
```
|
|
14
14
|
|
|
15
15
|
It reads the working tree itself, records every changed or untracked path with a digest,
|
|
@@ -51,7 +51,7 @@ settle these three from your own reading of the project. Each one comes from the
|
|
|
51
51
|
packets or it is not proved.
|
|
52
52
|
|
|
53
53
|
If all three are proved, prove the live starting state before any project file changes. Run
|
|
54
|
-
`npx --yes copilotkit@4.10.
|
|
54
|
+
`npx --yes copilotkit@4.10.1 onboard read proof/oss-baseline`.
|
|
55
55
|
|
|
56
56
|
Route there before you ask the developer anything else. The questions after this prompt
|
|
57
57
|
select a framework and a frontend that the findings already name, so a developer who
|
|
@@ -64,7 +64,7 @@ developer nor the repository findings prove what the project is for, ask one gui
|
|
|
64
64
|
question about the user outcome. This asks what the developer wants to build before you
|
|
65
65
|
select a framework. Give two or three short examples and offer a minimal starter. Record
|
|
66
66
|
the answer and give it to each later subagent. Then run
|
|
67
|
-
`npx --yes copilotkit@4.10.
|
|
67
|
+
`npx --yes copilotkit@4.10.1 onboard read credentials/plan`.
|
|
68
68
|
|
|
69
69
|
Do not ask that question on the route above. A project carrying all three states its
|
|
70
70
|
purpose in the application it already serves.
|
|
@@ -77,5 +77,5 @@ already made, and then names a purpose the cloned code does not serve. Take the
|
|
|
77
77
|
named above without asking, and let the starter state the domain.
|
|
78
78
|
|
|
79
79
|
If authentication or inspection stops onboarding, run
|
|
80
|
-
`npx --yes copilotkit@4.10.
|
|
80
|
+
`npx --yes copilotkit@4.10.1 onboard read stopped/run-failed`. Neither says anything
|
|
81
81
|
about whether this project's stack is supported, which is not yet known at this point.
|
|
@@ -46,7 +46,7 @@ the derived name.
|
|
|
46
46
|
Only if the developer asks for an existing project, or asks to see the projects they have,
|
|
47
47
|
read the choices:
|
|
48
48
|
|
|
49
|
-
`npx --yes copilotkit@4.10.
|
|
49
|
+
`npx --yes copilotkit@4.10.1 project list --json`
|
|
50
50
|
|
|
51
51
|
Then ask which one to use. Do not order the projects by creation time. If the developer
|
|
52
52
|
already gave this answer, do not ask again. Do not read a secret value. Do not show or
|
|
@@ -56,7 +56,7 @@ Run the command from the parent directory. Do not inspect another entry in the p
|
|
|
56
56
|
directory. Replace each placeholder with the recorded value. Do not run a placeholder as
|
|
57
57
|
a shell argument.
|
|
58
58
|
|
|
59
|
-
`npx --yes copilotkit@4.10.
|
|
59
|
+
`npx --yes copilotkit@4.10.1 init --name <project-name> --framework <framework-id> --channel none --no-banner --create <name> --install`
|
|
60
60
|
|
|
61
61
|
Pass the confirmed name to both `--name` and `--create`: the app directory and its
|
|
62
62
|
Intelligence project take the same name here. If the developer names an existing project,
|
|
@@ -72,7 +72,7 @@ account. The command does not need terminal input.
|
|
|
72
72
|
Report the clone before you inspect anything:
|
|
73
73
|
|
|
74
74
|
```text
|
|
75
|
-
npx --yes copilotkit@4.10.
|
|
75
|
+
npx --yes copilotkit@4.10.1 onboard checkpoint --phase starter-cloned
|
|
76
76
|
```
|
|
77
77
|
|
|
78
78
|
This is its own step, not an aside. A run that clones and then goes quiet is
|
|
@@ -82,10 +82,10 @@ separates them.
|
|
|
82
82
|
Do not rebuild the starter by hand. Then inspect only the generated
|
|
83
83
|
paths inside the target directory. Record the files, install result, project connection,
|
|
84
84
|
and validation commands. Then run
|
|
85
|
-
`npx --yes copilotkit@4.10.
|
|
85
|
+
`npx --yes copilotkit@4.10.1 onboard read proof/round-trip`.
|
|
86
86
|
|
|
87
87
|
If the command fails, report its exact error and do not claim that the starter is ready.
|
|
88
88
|
Then run
|
|
89
|
-
`npx --yes copilotkit@4.10.
|
|
89
|
+
`npx --yes copilotkit@4.10.1 onboard read stopped/run-failed`. The starter is one this
|
|
90
90
|
graph ships and the stack was chosen from its own supported list, so a command that
|
|
91
91
|
returned an error is a run that broke, not a setup this release does not support.
|
|
@@ -29,7 +29,7 @@ Send one short report. Run the friction command without another developer questi
|
|
|
29
29
|
CLI telemetry gate decides whether the report is sent.
|
|
30
30
|
|
|
31
31
|
```text
|
|
32
|
-
npx --yes copilotkit@4.10.
|
|
32
|
+
npx --yes copilotkit@4.10.1 onboard friction --phase stop --category <slug>
|
|
33
33
|
```
|
|
34
34
|
|
|
35
35
|
Write one or two sentences to standard input: the step you stopped at and what stopped
|