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.
Files changed (80) hide show
  1. package/LICENSE +11 -0
  2. package/README.md +145 -12
  3. package/cli-build-info.json +8 -8
  4. package/index.js +4970 -4644
  5. package/onboarding/index.json +8 -1
  6. package/onboarding/prompts/authenticate/start.md +14 -12
  7. package/onboarding/prompts/conversion/plan.md +3 -3
  8. package/onboarding/prompts/credentials/finalize-plan.md +14 -13
  9. package/onboarding/prompts/credentials/plan.md +20 -20
  10. package/onboarding/prompts/credentials/settle-credentials.md +55 -23
  11. package/onboarding/prompts/credentials/write-plan.md +5 -5
  12. package/onboarding/prompts/fallback/best-effort.md +6 -6
  13. package/onboarding/prompts/feature/a2ui/implement.md +7 -7
  14. package/onboarding/prompts/feature/a2ui/proof.md +6 -6
  15. package/onboarding/prompts/feature/a2ui/start.md +10 -8
  16. package/onboarding/prompts/feature/blocked-by-plan.md +32 -0
  17. package/onboarding/prompts/feature/channels/implement.md +7 -7
  18. package/onboarding/prompts/feature/channels/proof.md +6 -6
  19. package/onboarding/prompts/feature/channels/start.md +10 -8
  20. package/onboarding/prompts/feature/chat-suggestions/implement.md +7 -7
  21. package/onboarding/prompts/feature/chat-suggestions/proof.md +6 -6
  22. package/onboarding/prompts/feature/chat-suggestions/start.md +10 -8
  23. package/onboarding/prompts/feature/complete.md +1 -1
  24. package/onboarding/prompts/feature/learning/implement.md +73 -14
  25. package/onboarding/prompts/feature/learning/proof.md +10 -9
  26. package/onboarding/prompts/feature/learning/start.md +61 -7
  27. package/onboarding/prompts/feature/open-generative-ui/implement.md +7 -7
  28. package/onboarding/prompts/feature/open-generative-ui/proof.md +6 -6
  29. package/onboarding/prompts/feature/open-generative-ui/start.md +10 -8
  30. package/onboarding/prompts/feature/realtime-sync/implement.md +8 -8
  31. package/onboarding/prompts/feature/realtime-sync/proof.md +6 -6
  32. package/onboarding/prompts/feature/realtime-sync/start.md +9 -7
  33. package/onboarding/prompts/feature/rich-threads/implement.md +9 -9
  34. package/onboarding/prompts/feature/rich-threads/proof.md +6 -6
  35. package/onboarding/prompts/feature/rich-threads/start.md +9 -7
  36. package/onboarding/prompts/feature/stop.md +2 -2
  37. package/onboarding/prompts/feature/voice/implement.md +7 -7
  38. package/onboarding/prompts/feature/voice/proof.md +6 -6
  39. package/onboarding/prompts/feature/voice/start.md +10 -8
  40. package/onboarding/prompts/framework/ag2.md +2 -2
  41. package/onboarding/prompts/framework/agno.md +2 -2
  42. package/onboarding/prompts/framework/built-in.md +2 -2
  43. package/onboarding/prompts/framework/claude-sdk-python.md +2 -2
  44. package/onboarding/prompts/framework/claude-sdk-typescript.md +2 -2
  45. package/onboarding/prompts/framework/crewai-flows.md +2 -2
  46. package/onboarding/prompts/framework/deep-agents.md +2 -2
  47. package/onboarding/prompts/framework/google-adk.md +2 -2
  48. package/onboarding/prompts/framework/langgraph-fastapi.md +2 -2
  49. package/onboarding/prompts/framework/langgraph-python.md +2 -2
  50. package/onboarding/prompts/framework/langgraph-typescript.md +2 -2
  51. package/onboarding/prompts/framework/llamaindex.md +2 -2
  52. package/onboarding/prompts/framework/mastra.md +2 -2
  53. package/onboarding/prompts/framework/ms-agent-dotnet.md +2 -2
  54. package/onboarding/prompts/framework/ms-agent-harness-dotnet.md +2 -2
  55. package/onboarding/prompts/framework/ms-agent-python.md +2 -2
  56. package/onboarding/prompts/framework/pydantic-ai.md +2 -2
  57. package/onboarding/prompts/framework/strands-python.md +2 -2
  58. package/onboarding/prompts/framework/strands-typescript.md +2 -2
  59. package/onboarding/prompts/frontend/angular.md +5 -5
  60. package/onboarding/prompts/frontend/nextjs.md +4 -4
  61. package/onboarding/prompts/frontend/plan.md +7 -7
  62. package/onboarding/prompts/frontend/react-native.md +2 -2
  63. package/onboarding/prompts/frontend/react-spa.md +2 -2
  64. package/onboarding/prompts/frontend/vue.md +2 -2
  65. package/onboarding/prompts/implementation/build-and-validate.md +21 -16
  66. package/onboarding/prompts/proof/complete.md +12 -11
  67. package/onboarding/prompts/proof/oss-baseline.md +5 -5
  68. package/onboarding/prompts/proof/round-trip.md +10 -10
  69. package/onboarding/prompts/research/gather.md +41 -9
  70. package/onboarding/prompts/research/route.md +25 -4
  71. package/onboarding/prompts/starter/clone.md +5 -5
  72. package/onboarding/prompts/stopped/run-failed.md +30 -1
  73. package/onboarding/prompts/subagent/create-plan.md +7 -1
  74. package/onboarding/prompts/subagent/implement-and-validate.md +2 -1
  75. package/onboarding/prompts/subagent/inspect-repository.md +43 -16
  76. package/onboarding/prompts/subagent/prove-oss-baseline.md +1 -1
  77. package/onboarding/prompts/subagent/prove-round-trip.md +27 -10
  78. package/onboarding/prompts/unsupported/no-validated-path.md +2 -2
  79. package/package.json +4 -3
  80. 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.11.0 onboard read frontend/plan`.
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.11.0 onboard read unsupported/no-validated-path`.
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.11.0 onboard read frontend/plan`.
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.11.0 onboard read unsupported/no-validated-path`.
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.11.0 onboard read frontend/plan`.
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.11.0 onboard read unsupported/no-validated-path`.
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.11.0 onboard read frontend/plan`.
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.11.0 onboard read unsupported/no-validated-path`.
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.11.0 onboard read frontend/plan`.
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.11.0 onboard read unsupported/no-validated-path`.
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.11.0 onboard read frontend/plan`.
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.11.0 onboard read unsupported/no-validated-path`.
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.11.0 onboard read frontend/plan`.
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.11.0 onboard read unsupported/no-validated-path`.
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.11.0 onboard read frontend/plan`.
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.11.0 onboard read unsupported/no-validated-path`.
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.11.0 onboard read frontend/plan`.
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.11.0 onboard read unsupported/no-validated-path`.
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.11.0 onboard read frontend/plan`.
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.11.0 onboard read unsupported/no-validated-path`.
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.11.0 onboard read frontend/plan`.
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.11.0 onboard read unsupported/no-validated-path`.
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.11.0 onboard read frontend/plan`.
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.11.0 onboard read unsupported/no-validated-path`.
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.11.0 onboard read frontend/plan`.
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.11.0 onboard read unsupported/no-validated-path`.
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.11.0 onboard read frontend/plan`.
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.11.0 onboard read unsupported/no-validated-path`.
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.11.0 onboard read frontend/plan`.
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.11.0 onboard read unsupported/no-validated-path`.
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.11.0 onboard read frontend/plan`.
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.11.0 onboard read unsupported/no-validated-path`.
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.11.0 onboard read frontend/plan`.
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.11.0 onboard read unsupported/no-validated-path`.
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.11.0 onboard read frontend/plan`.
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.11.0 onboard read unsupported/no-validated-path`.
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 contains
6
- no entries, its name is a valid `init` project name, and the selected framework is ADK.
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.11.0 onboard read starter/clone` before you fetch documentation.
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.11.0 onboard read credentials/finalize-plan`.
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.11.0 onboard read unsupported/no-validated-path`.
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 contains no entries and its name is
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.11.0 onboard read starter/clone` before you fetch documentation.
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.11.0 onboard read credentials/finalize-plan`.
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.11.0 onboard read unsupported/no-validated-path`.
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.11.0 onboard read frontend/react-spa`
29
- 2. Next.js: `npx --yes copilotkit@4.11.0 onboard read frontend/nextjs`
30
- 3. Angular: `npx --yes copilotkit@4.11.0 onboard read frontend/angular`
31
- 4. Vue 3: `npx --yes copilotkit@4.11.0 onboard read frontend/vue`
32
- 5. React Native: `npx --yes copilotkit@4.11.0 onboard read frontend/react-native`
33
- 6. Slack or Microsoft Teams: `npx --yes copilotkit@4.11.0 onboard read feature/channels/start`
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.11.0 onboard read unsupported/no-validated-path`.
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.11.0 onboard read credentials/finalize-plan`.
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.11.0 onboard read unsupported/no-validated-path`.
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.11.0 onboard read credentials/finalize-plan`.
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.11.0 onboard read unsupported/no-validated-path`.
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.11.0 onboard read credentials/finalize-plan`.
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.11.0 onboard read unsupported/no-validated-path`.
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.11.0 onboard friction --phase stop --category <slug>
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.11.0 onboard protect --authorize --path <path> --reason "<the plan's sentence>"
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.11.0 onboard protect --authorize --path <path> --reason "<the plan's sentence>" --with-prior-change
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.11.0 onboard audit
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 change:` is not a finding. The developer approved
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.11.0 onboard protect --accept-external --path <path>
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.11.0 onboard protect --accept-credential --path <path>
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.11.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
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.11.0 learning containers create --id <id> --name <name> --json
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.11.0 onboard checkpoint --phase container-settled
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.11.0 onboard checkpoint --phase plan-written
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.11.0 onboard read subagent/implement-and-validate` first and follow
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.11.0 onboard checkpoint --phase build-validated
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.11.0 onboard read proof/round-trip`.
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.11.0 onboard read stopped/run-failed`.
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.11.0 onboard read unsupported/no-validated-path`.
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.11.0 verify --round-trip`, the runtime's own log, the AG-UI
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. A thread takes its container before its first
83
- agent run, so threads that ran before this change are never pulled in. The container starts
84
- empty on purpose.
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.11.0 onboard friction --category <slug> --cost-seconds <seconds>
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.11.0 onboard friction --category docs-wrong --cost-seconds 300 --docs-path /docs/threads/drawer
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.11.0 onboard complete`, carrying
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.11.0 onboard complete --visual-check <outcome>
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.11.0 onboard complete --device-check <outcome>
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.11.0 onboard complete --visual-check <outcome> \
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.11.0 onboard complete --visual-check performed --blocked-by <cause>
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.11.0 onboard read subagent/prove-oss-baseline` first and follow the
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.11.0 onboard proof --step oss-baseline --outcome <passed|failed|skipped> [--predicate <1-6>]
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.11.0 onboard read conversion/plan`. That project already works.
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.11.0 onboard read credentials/plan`. This prompt is served
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.11.0 onboard read stopped/run-failed`. None of those mean the
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.