copilotkit 4.11.0 → 4.12.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +11 -0
- package/README.md +145 -12
- package/cli-build-info.json +8 -8
- package/index.js +4970 -4644
- package/onboarding/index.json +8 -1
- package/onboarding/prompts/authenticate/start.md +14 -12
- package/onboarding/prompts/conversion/plan.md +3 -3
- package/onboarding/prompts/credentials/finalize-plan.md +14 -13
- package/onboarding/prompts/credentials/plan.md +20 -20
- package/onboarding/prompts/credentials/settle-credentials.md +55 -23
- 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 +7 -7
- package/onboarding/prompts/feature/a2ui/proof.md +6 -6
- package/onboarding/prompts/feature/a2ui/start.md +10 -8
- package/onboarding/prompts/feature/blocked-by-plan.md +32 -0
- package/onboarding/prompts/feature/channels/implement.md +7 -7
- package/onboarding/prompts/feature/channels/proof.md +6 -6
- package/onboarding/prompts/feature/channels/start.md +10 -8
- package/onboarding/prompts/feature/chat-suggestions/implement.md +7 -7
- package/onboarding/prompts/feature/chat-suggestions/proof.md +6 -6
- package/onboarding/prompts/feature/chat-suggestions/start.md +10 -8
- package/onboarding/prompts/feature/complete.md +1 -1
- package/onboarding/prompts/feature/learning/implement.md +73 -14
- package/onboarding/prompts/feature/learning/proof.md +10 -9
- package/onboarding/prompts/feature/learning/start.md +61 -7
- package/onboarding/prompts/feature/open-generative-ui/implement.md +7 -7
- package/onboarding/prompts/feature/open-generative-ui/proof.md +6 -6
- package/onboarding/prompts/feature/open-generative-ui/start.md +10 -8
- package/onboarding/prompts/feature/realtime-sync/implement.md +8 -8
- package/onboarding/prompts/feature/realtime-sync/proof.md +6 -6
- package/onboarding/prompts/feature/realtime-sync/start.md +9 -7
- package/onboarding/prompts/feature/rich-threads/implement.md +9 -9
- package/onboarding/prompts/feature/rich-threads/proof.md +6 -6
- package/onboarding/prompts/feature/rich-threads/start.md +9 -7
- package/onboarding/prompts/feature/stop.md +2 -2
- package/onboarding/prompts/feature/voice/implement.md +7 -7
- package/onboarding/prompts/feature/voice/proof.md +6 -6
- package/onboarding/prompts/feature/voice/start.md +10 -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 +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 +5 -5
- package/onboarding/prompts/frontend/nextjs.md +4 -4
- package/onboarding/prompts/frontend/plan.md +7 -7
- 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 +21 -16
- package/onboarding/prompts/proof/complete.md +12 -11
- package/onboarding/prompts/proof/oss-baseline.md +5 -5
- package/onboarding/prompts/proof/round-trip.md +10 -10
- package/onboarding/prompts/research/gather.md +41 -9
- package/onboarding/prompts/research/route.md +25 -4
- package/onboarding/prompts/starter/clone.md +5 -5
- package/onboarding/prompts/stopped/run-failed.md +30 -1
- package/onboarding/prompts/subagent/create-plan.md +7 -1
- package/onboarding/prompts/subagent/implement-and-validate.md +2 -1
- package/onboarding/prompts/subagent/inspect-repository.md +43 -16
- package/onboarding/prompts/subagent/prove-oss-baseline.md +1 -1
- package/onboarding/prompts/subagent/prove-round-trip.md +27 -10
- package/onboarding/prompts/unsupported/no-validated-path.md +2 -2
- package/package.json +4 -3
- package/release/release-tool.js +1 -1
|
@@ -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.
|
|
37
|
+
`npx --yes copilotkit@4.12.0 onboard read frontend/plan`.
|
|
38
38
|
|
|
39
39
|
If the documentation does not support the selection, run
|
|
40
|
-
`npx --yes copilotkit@4.
|
|
40
|
+
`npx --yes copilotkit@4.12.0 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.
|
|
30
|
+
`npx --yes copilotkit@4.12.0 onboard read frontend/plan`.
|
|
31
31
|
|
|
32
32
|
If the documentation does not support the selection, run
|
|
33
|
-
`npx --yes copilotkit@4.
|
|
33
|
+
`npx --yes copilotkit@4.12.0 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.
|
|
36
|
+
`npx --yes copilotkit@4.12.0 onboard read frontend/plan`.
|
|
37
37
|
|
|
38
38
|
If the documentation does not support the selection, run
|
|
39
|
-
`npx --yes copilotkit@4.
|
|
39
|
+
`npx --yes copilotkit@4.12.0 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.
|
|
40
|
+
`npx --yes copilotkit@4.12.0 onboard read frontend/plan`.
|
|
41
41
|
|
|
42
42
|
If the documentation does not support the selection, run
|
|
43
|
-
`npx --yes copilotkit@4.
|
|
43
|
+
`npx --yes copilotkit@4.12.0 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.
|
|
57
|
+
`npx --yes copilotkit@4.12.0 onboard read frontend/plan`.
|
|
58
58
|
|
|
59
59
|
If the documentation does not support the selection, run
|
|
60
|
-
`npx --yes copilotkit@4.
|
|
60
|
+
`npx --yes copilotkit@4.12.0 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.
|
|
32
|
+
`npx --yes copilotkit@4.12.0 onboard read frontend/plan`.
|
|
33
33
|
|
|
34
34
|
If the documentation does not support the selection, run
|
|
35
|
-
`npx --yes copilotkit@4.
|
|
35
|
+
`npx --yes copilotkit@4.12.0 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.
|
|
31
|
+
`npx --yes copilotkit@4.12.0 onboard read frontend/plan`.
|
|
32
32
|
|
|
33
33
|
If the documentation does not support the selection, run
|
|
34
|
-
`npx --yes copilotkit@4.
|
|
34
|
+
`npx --yes copilotkit@4.12.0 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.
|
|
27
|
+
`npx --yes copilotkit@4.12.0 onboard read frontend/plan`.
|
|
28
28
|
|
|
29
29
|
If the documentation does not support the selection, run
|
|
30
|
-
`npx --yes copilotkit@4.
|
|
30
|
+
`npx --yes copilotkit@4.12.0 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.
|
|
18
|
+
`npx --yes copilotkit@4.12.0 onboard read frontend/plan`.
|
|
19
19
|
|
|
20
20
|
If the documentation does not support the selection, run
|
|
21
|
-
`npx --yes copilotkit@4.
|
|
21
|
+
`npx --yes copilotkit@4.12.0 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.
|
|
18
|
+
`npx --yes copilotkit@4.12.0 onboard read frontend/plan`.
|
|
19
19
|
|
|
20
20
|
If the documentation does not support the selection, run
|
|
21
|
-
`npx --yes copilotkit@4.
|
|
21
|
+
`npx --yes copilotkit@4.12.0 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.
|
|
37
|
+
`npx --yes copilotkit@4.12.0 onboard read frontend/plan`.
|
|
38
38
|
|
|
39
39
|
If the documentation does not support the selection, run
|
|
40
|
-
`npx --yes copilotkit@4.
|
|
40
|
+
`npx --yes copilotkit@4.12.0 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.
|
|
48
|
+
`npx --yes copilotkit@4.12.0 onboard read frontend/plan`.
|
|
49
49
|
|
|
50
50
|
If the documentation does not support the selection, run
|
|
51
|
-
`npx --yes copilotkit@4.
|
|
51
|
+
`npx --yes copilotkit@4.12.0 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.
|
|
37
|
+
`npx --yes copilotkit@4.12.0 onboard read frontend/plan`.
|
|
38
38
|
|
|
39
39
|
If the documentation does not support the selection, run
|
|
40
|
-
`npx --yes copilotkit@4.
|
|
40
|
+
`npx --yes copilotkit@4.12.0 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.
|
|
47
|
+
`npx --yes copilotkit@4.12.0 onboard read frontend/plan`.
|
|
48
48
|
|
|
49
49
|
If the documentation does not support the selection, run
|
|
50
|
-
`npx --yes copilotkit@4.
|
|
50
|
+
`npx --yes copilotkit@4.12.0 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.
|
|
31
|
+
`npx --yes copilotkit@4.12.0 onboard read frontend/plan`.
|
|
32
32
|
|
|
33
33
|
If the documentation does not support the selection, run
|
|
34
|
-
`npx --yes copilotkit@4.
|
|
34
|
+
`npx --yes copilotkit@4.12.0 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.
|
|
46
|
+
`npx --yes copilotkit@4.12.0 onboard read frontend/plan`.
|
|
47
47
|
|
|
48
48
|
If the documentation does not support the selection, run
|
|
49
|
-
`npx --yes copilotkit@4.
|
|
49
|
+
`npx --yes copilotkit@4.12.0 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.
|
|
30
|
+
`npx --yes copilotkit@4.12.0 onboard read frontend/plan`.
|
|
31
31
|
|
|
32
32
|
If the documentation does not support the selection, run
|
|
33
|
-
`npx --yes copilotkit@4.
|
|
33
|
+
`npx --yes copilotkit@4.12.0 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.
|
|
31
|
+
`npx --yes copilotkit@4.12.0 onboard read frontend/plan`.
|
|
32
32
|
|
|
33
33
|
If the documentation does not support the selection, run
|
|
34
|
-
`npx --yes copilotkit@4.
|
|
34
|
+
`npx --yes copilotkit@4.12.0 onboard read unsupported/no-validated-path`.
|
|
@@ -2,10 +2,10 @@
|
|
|
2
2
|
|
|
3
3
|
Preserve an existing Angular frontend. Use the selected page for a new frontend.
|
|
4
4
|
|
|
5
|
-
Use the starter shortcut only if all these facts are true: the target directory
|
|
6
|
-
|
|
5
|
+
Use the starter shortcut only if all these facts are true: the target directory holds no
|
|
6
|
+
project, 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.
|
|
8
|
+
`npx --yes copilotkit@4.12.0 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.
|
|
66
|
+
`npx --yes copilotkit@4.12.0 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.
|
|
69
|
+
together, run `npx --yes copilotkit@4.12.0 onboard read unsupported/no-validated-path`.
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
Preserve an existing Next.js frontend. Use the selected pages for a new frontend.
|
|
4
4
|
|
|
5
|
-
Use the starter shortcut only if the target directory
|
|
5
|
+
Use the starter shortcut only if the target directory holds no project and its name is
|
|
6
6
|
a valid `init` project name. The selected framework must also match one of these options.
|
|
7
7
|
|
|
8
8
|
These Python options have Next.js starters: Agno, Claude Agent SDK Python, CrewAI Flows,
|
|
@@ -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.
|
|
18
|
+
`npx --yes copilotkit@4.12.0 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.
|
|
30
|
+
`npx --yes copilotkit@4.12.0 onboard read credentials/finalize-plan`.
|
|
31
31
|
|
|
32
32
|
If the documentation does not support the selection, run
|
|
33
|
-
`npx --yes copilotkit@4.
|
|
33
|
+
`npx --yes copilotkit@4.12.0 onboard read unsupported/no-validated-path`.
|
|
@@ -25,15 +25,15 @@ CopilotKit web apps. Then recommend the one the developer names, and say what ea
|
|
|
25
25
|
|
|
26
26
|
Use exactly one matching internal route:
|
|
27
27
|
|
|
28
|
-
1. React SPA: `npx --yes copilotkit@4.
|
|
29
|
-
2. Next.js: `npx --yes copilotkit@4.
|
|
30
|
-
3. Angular: `npx --yes copilotkit@4.
|
|
31
|
-
4. Vue 3: `npx --yes copilotkit@4.
|
|
32
|
-
5. React Native: `npx --yes copilotkit@4.
|
|
33
|
-
6. Slack or Microsoft Teams: `npx --yes copilotkit@4.
|
|
28
|
+
1. React SPA: `npx --yes copilotkit@4.12.0 onboard read frontend/react-spa`
|
|
29
|
+
2. Next.js: `npx --yes copilotkit@4.12.0 onboard read frontend/nextjs`
|
|
30
|
+
3. Angular: `npx --yes copilotkit@4.12.0 onboard read frontend/angular`
|
|
31
|
+
4. Vue 3: `npx --yes copilotkit@4.12.0 onboard read frontend/vue`
|
|
32
|
+
5. React Native: `npx --yes copilotkit@4.12.0 onboard read frontend/react-native`
|
|
33
|
+
6. Slack or Microsoft Teams: `npx --yes copilotkit@4.12.0 onboard read feature/channels/start`
|
|
34
34
|
|
|
35
35
|
If they chose Slack or Microsoft Teams, tell that node which one they chose so it
|
|
36
36
|
does not ask again.
|
|
37
37
|
|
|
38
38
|
If no listed frontend fits, run
|
|
39
|
-
`npx --yes copilotkit@4.
|
|
39
|
+
`npx --yes copilotkit@4.12.0 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.
|
|
18
|
+
`npx --yes copilotkit@4.12.0 onboard read credentials/finalize-plan`.
|
|
19
19
|
|
|
20
20
|
If the documentation does not support the selection, run
|
|
21
|
-
`npx --yes copilotkit@4.
|
|
21
|
+
`npx --yes copilotkit@4.12.0 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.
|
|
14
|
+
`npx --yes copilotkit@4.12.0 onboard read credentials/finalize-plan`.
|
|
15
15
|
|
|
16
16
|
If the documentation does not support the selection, run
|
|
17
|
-
`npx --yes copilotkit@4.
|
|
17
|
+
`npx --yes copilotkit@4.12.0 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.
|
|
19
|
+
`npx --yes copilotkit@4.12.0 onboard read credentials/finalize-plan`.
|
|
20
20
|
|
|
21
21
|
If the documentation does not support the selection, run
|
|
22
|
-
`npx --yes copilotkit@4.
|
|
22
|
+
`npx --yes copilotkit@4.12.0 onboard read unsupported/no-validated-path`.
|
|
@@ -12,7 +12,7 @@ command without another developer question. Do not ask the developer about telem
|
|
|
12
12
|
command applies the setting they already have.
|
|
13
13
|
|
|
14
14
|
```text
|
|
15
|
-
npx --yes copilotkit@4.
|
|
15
|
+
npx --yes copilotkit@4.12.0 onboard friction --phase stop --category <slug>
|
|
16
16
|
```
|
|
17
17
|
|
|
18
18
|
Write one or two sentences to standard input: the step you stopped at and what stopped it.
|
|
@@ -43,19 +43,24 @@ Approving the plan is the developer agreeing to every path it listed under
|
|
|
43
43
|
app directory:
|
|
44
44
|
|
|
45
45
|
```text
|
|
46
|
-
npx --yes copilotkit@4.
|
|
46
|
+
npx --yes copilotkit@4.12.0 onboard protect --authorize --path <path> --reason "<the plan's sentence>"
|
|
47
47
|
```
|
|
48
48
|
|
|
49
49
|
Consent has to be on the record before the file moves, so a call made after the change is
|
|
50
50
|
refused. Continue only if every result starts with `Status: passed`. If the plan listed
|
|
51
51
|
nothing there, skip this section.
|
|
52
52
|
|
|
53
|
+
What you record here covers changing the file. It does not cover removing it. Never delete,
|
|
54
|
+
move, or rename a protected path, whatever the plan says: the audit fails a path that is
|
|
55
|
+
gone even when consent was recorded for it, and no command clears that. If a step cannot
|
|
56
|
+
proceed without removing one, route out and report the path.
|
|
57
|
+
|
|
53
58
|
If a path the plan listed has already changed, the developer changed it after the capture.
|
|
54
59
|
No implementation step has run yet, so the change is theirs rather than this run's. Record
|
|
55
60
|
consent over it by adding one flag:
|
|
56
61
|
|
|
57
62
|
```text
|
|
58
|
-
npx --yes copilotkit@4.
|
|
63
|
+
npx --yes copilotkit@4.12.0 onboard protect --authorize --path <path> --reason "<the plan's sentence>" --with-prior-change
|
|
59
64
|
```
|
|
60
65
|
|
|
61
66
|
The flag records their change as drift beside the consent, so the closing report names both
|
|
@@ -74,7 +79,7 @@ rather than this section.
|
|
|
74
79
|
Run the audit from the target app directory:
|
|
75
80
|
|
|
76
81
|
```text
|
|
77
|
-
npx --yes copilotkit@4.
|
|
82
|
+
npx --yes copilotkit@4.12.0 onboard audit
|
|
78
83
|
```
|
|
79
84
|
|
|
80
85
|
It compares every protected path with the digest the CLI captured for it. Its result starts
|
|
@@ -87,7 +92,7 @@ answers the same.
|
|
|
87
92
|
|
|
88
93
|
Decide each path the audit names, one at a time.
|
|
89
94
|
|
|
90
|
-
A path the audit lists under `Authorized to
|
|
95
|
+
A path the audit lists under `Authorized to modify:` is not a finding. The developer approved
|
|
91
96
|
it, the record says why, and the audit reports it rather than failing on it. Carry it into the
|
|
92
97
|
summary with its reason. Nothing else is needed for it.
|
|
93
98
|
|
|
@@ -109,14 +114,14 @@ A path that no Files changed section names changed outside the run, and it is th
|
|
|
109
114
|
developer's own file. Accept it by name:
|
|
110
115
|
|
|
111
116
|
```text
|
|
112
|
-
npx --yes copilotkit@4.
|
|
117
|
+
npx --yes copilotkit@4.12.0 onboard protect --accept-external --path <path>
|
|
113
118
|
```
|
|
114
119
|
|
|
115
120
|
A changed env file is its own case. This run asked the developer to place a credential
|
|
116
121
|
there, so it takes the credential route rather than this one:
|
|
117
122
|
|
|
118
123
|
```text
|
|
119
|
-
npx --yes copilotkit@4.
|
|
124
|
+
npx --yes copilotkit@4.12.0 onboard protect --accept-credential --path <path>
|
|
120
125
|
```
|
|
121
126
|
|
|
122
127
|
That route proves no recorded credential was lost, instead of taking the run's word that it
|
|
@@ -135,7 +140,7 @@ neither does a one-line fix. Never repair, reset, or revert it. Ask the develope
|
|
|
135
140
|
the change, and record the answer they give:
|
|
136
141
|
|
|
137
142
|
```text
|
|
138
|
-
npx --yes copilotkit@4.
|
|
143
|
+
npx --yes copilotkit@4.12.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
|
|
139
144
|
```
|
|
140
145
|
|
|
141
146
|
Use it only for an answer a developer actually gave. It records the consent as taken
|
|
@@ -156,7 +161,7 @@ create it now, from the target app directory. The developer approved the id befo
|
|
|
156
161
|
made, so this is the first point at which it can be created:
|
|
157
162
|
|
|
158
163
|
```text
|
|
159
|
-
npx --yes copilotkit@4.
|
|
164
|
+
npx --yes copilotkit@4.12.0 learning containers create --id <id> --name <name> --json
|
|
160
165
|
```
|
|
161
166
|
|
|
162
167
|
Pass the id the plan names. Take the name from the selected project's own display name, so
|
|
@@ -172,7 +177,7 @@ hold.
|
|
|
172
177
|
Then report that the container is settled, before any edit:
|
|
173
178
|
|
|
174
179
|
```text
|
|
175
|
-
npx --yes copilotkit@4.
|
|
180
|
+
npx --yes copilotkit@4.12.0 onboard checkpoint --phase container-settled
|
|
176
181
|
```
|
|
177
182
|
|
|
178
183
|
Where the plan names a container the platform already held, report the same checkpoint and
|
|
@@ -181,11 +186,11 @@ create nothing. Where the plan names no container, skip this section.
|
|
|
181
186
|
Report the plan this run is about to implement:
|
|
182
187
|
|
|
183
188
|
```text
|
|
184
|
-
npx --yes copilotkit@4.
|
|
189
|
+
npx --yes copilotkit@4.12.0 onboard checkpoint --phase plan-written
|
|
185
190
|
```
|
|
186
191
|
|
|
187
192
|
Spawn one implementation subagent. Tell it to run
|
|
188
|
-
`npx --yes copilotkit@4.
|
|
193
|
+
`npx --yes copilotkit@4.12.0 onboard read subagent/implement-and-validate` first and follow
|
|
189
194
|
the prompt it returns. If that read fails because the subagent cannot use the shell, stop that
|
|
190
195
|
subagent. Run the same command yourself, then spawn a fresh subagent with the returned prompt
|
|
191
196
|
and the same handoff. Give it the plan, selected framework, frontend, model, exact target app
|
|
@@ -205,11 +210,11 @@ returned. Continue to proof only when that audit passes.
|
|
|
205
210
|
After the selected implementation path passes, report it:
|
|
206
211
|
|
|
207
212
|
```text
|
|
208
|
-
npx --yes copilotkit@4.
|
|
213
|
+
npx --yes copilotkit@4.12.0 onboard checkpoint --phase build-validated
|
|
209
214
|
```
|
|
210
215
|
|
|
211
216
|
Then run
|
|
212
|
-
`npx --yes copilotkit@4.
|
|
217
|
+
`npx --yes copilotkit@4.12.0 onboard read proof/round-trip`.
|
|
213
218
|
|
|
214
219
|
## Repair rules
|
|
215
220
|
|
|
@@ -231,9 +236,9 @@ the same command still fails after three repair attempts, or a result starts wit
|
|
|
231
236
|
`Status: blocked`. A defect in a package this run installed is not a stack CopilotKit does
|
|
232
237
|
not serve, a command this run cannot get to pass is not one either, and a blocked audit
|
|
233
238
|
proved nothing about the stack. In those cases run
|
|
234
|
-
`npx --yes copilotkit@4.
|
|
239
|
+
`npx --yes copilotkit@4.12.0 onboard read stopped/run-failed`.
|
|
235
240
|
|
|
236
241
|
A plan with no path to follow takes the unsupported ending: the fix requires changing the
|
|
237
242
|
developer's existing agent or frontend, or the documentation does not support the plan. In
|
|
238
243
|
those cases run
|
|
239
|
-
`npx --yes copilotkit@4.
|
|
244
|
+
`npx --yes copilotkit@4.12.0 onboard read unsupported/no-validated-path`.
|
|
@@ -70,7 +70,7 @@ Name the debugging surface this journey's frontend can reach, rather than the on
|
|
|
70
70
|
of the documentation leads with. For a web frontend it is the CopilotKit Inspector. For
|
|
71
71
|
React Native there is no Inspector: it is a browser overlay built on a DOM custom element,
|
|
72
72
|
and `@copilotkit/react-native` does not ship it. Give a mobile developer
|
|
73
|
-
`npx --yes copilotkit@4.
|
|
73
|
+
`npx --yes copilotkit@4.12.0 verify --round-trip`, the runtime's own log, the AG-UI
|
|
74
74
|
Event Inspector in the CopilotKit VS Code extension, and the CopilotKit Intelligence
|
|
75
75
|
thread view
|
|
76
76
|
instead. Naming the Inspector to a developer who cannot open it costs them the time it
|
|
@@ -79,9 +79,10 @@ takes to conclude their own wiring is broken.
|
|
|
79
79
|
Where this run settled a Learning Container, tell the developer what happens next, because
|
|
80
80
|
a correct run looks like a broken one otherwise. Learning runs on its own: the first
|
|
81
81
|
automatic run needs new threads from 15 distinct conversations in this container, and only
|
|
82
|
-
the newest snapshot of each thread counts.
|
|
83
|
-
|
|
84
|
-
|
|
82
|
+
the newest snapshot of each thread counts. Existing threads can receive their first
|
|
83
|
+
container assignment after prior runs. Their surviving earlier history becomes eligible
|
|
84
|
+
for collection and counts toward the same threshold. Creating a container does not enroll
|
|
85
|
+
existing threads automatically.
|
|
85
86
|
|
|
86
87
|
Where the Learning step was skipped because this organization cannot use Learning, say so in
|
|
87
88
|
one line and name what was not created. A skip nobody names reads as a container that
|
|
@@ -94,7 +95,7 @@ the friction commands without another developer question. Do not ask the develop
|
|
|
94
95
|
telemetry: the command applies the setting they already have.
|
|
95
96
|
|
|
96
97
|
```text
|
|
97
|
-
npx --yes copilotkit@4.
|
|
98
|
+
npx --yes copilotkit@4.12.0 onboard friction --category <slug> --cost-seconds <seconds>
|
|
98
99
|
```
|
|
99
100
|
|
|
100
101
|
Write one or two sentences on the command's standard input. Pick one category from
|
|
@@ -106,7 +107,7 @@ Pass --docs-path only for a docs-missing or docs-wrong report, naming the page t
|
|
|
106
107
|
is about:
|
|
107
108
|
|
|
108
109
|
```text
|
|
109
|
-
npx --yes copilotkit@4.
|
|
110
|
+
npx --yes copilotkit@4.12.0 onboard friction --category docs-wrong --cost-seconds 300 --docs-path /docs/threads/drawer
|
|
110
111
|
```
|
|
111
112
|
|
|
112
113
|
Give the page's site-relative path or its full URL, with no spaces, query string, or
|
|
@@ -123,14 +124,14 @@ Tell the developer when you send a friction report. Do not quote or summarize th
|
|
|
123
124
|
unless the developer asks. If the CLI says the report was not sent,
|
|
124
125
|
state what it said and continue without another question.
|
|
125
126
|
|
|
126
|
-
When the evidence is gathered, run `npx --yes copilotkit@4.
|
|
127
|
+
When the evidence is gathered, run `npx --yes copilotkit@4.12.0 onboard complete`, carrying
|
|
127
128
|
the surface-check outcome the proof subagent returned. Pass exactly one flag, and pass the
|
|
128
129
|
one that matches this journey's surface.
|
|
129
130
|
|
|
130
131
|
For a web frontend -- React SPA, Next.js, Angular, Vue:
|
|
131
132
|
|
|
132
133
|
```text
|
|
133
|
-
npx --yes copilotkit@4.
|
|
134
|
+
npx --yes copilotkit@4.12.0 onboard complete --visual-check <outcome>
|
|
134
135
|
```
|
|
135
136
|
|
|
136
137
|
The outcome is one of `performed`, `skipped-no-browser-tool`, `skipped-cloned-starter`, or
|
|
@@ -140,7 +141,7 @@ open no browser. It is the one skip that does not block.
|
|
|
140
141
|
For React Native:
|
|
141
142
|
|
|
142
143
|
```text
|
|
143
|
-
npx --yes copilotkit@4.
|
|
144
|
+
npx --yes copilotkit@4.12.0 onboard complete --device-check <outcome>
|
|
144
145
|
```
|
|
145
146
|
|
|
146
147
|
The outcome is one of `performed`, `skipped-no-device`, `skipped-cloned-starter`, or
|
|
@@ -153,7 +154,7 @@ browser-origin CORS, so the flag you pass is how this run states which surface i
|
|
|
153
154
|
For a web frontend, also pass the URL the browser opened:
|
|
154
155
|
|
|
155
156
|
```text
|
|
156
|
-
npx --yes copilotkit@4.
|
|
157
|
+
npx --yes copilotkit@4.12.0 onboard complete --visual-check <outcome> \
|
|
157
158
|
--frontend-url <the url you opened>
|
|
158
159
|
```
|
|
159
160
|
|
|
@@ -172,7 +173,7 @@ If the round trip proved and something after it still blocked this run, add `--b
|
|
|
172
173
|
to the same command:
|
|
173
174
|
|
|
174
175
|
```text
|
|
175
|
-
npx --yes copilotkit@4.
|
|
176
|
+
npx --yes copilotkit@4.12.0 onboard complete --visual-check performed --blocked-by <cause>
|
|
176
177
|
```
|
|
177
178
|
|
|
178
179
|
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.
|
|
4
|
+
`npx --yes copilotkit@4.12.0 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.
|
|
20
|
+
npx --yes copilotkit@4.12.0 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.
|
|
38
|
+
`npx --yes copilotkit@4.12.0 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.
|
|
43
|
+
`npx --yes copilotkit@4.12.0 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.
|
|
57
|
+
`npx --yes copilotkit@4.12.0 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.
|