copilotkit 4.21.0 → 4.22.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 (81) hide show
  1. package/README.md +29 -6
  2. package/cli-build-info.json +8 -8
  3. package/index.js +4558 -3358
  4. package/onboarding/index.json +10 -1
  5. package/onboarding/prompts/authenticate/start.md +11 -17
  6. package/onboarding/prompts/conversion/plan.md +3 -3
  7. package/onboarding/prompts/credentials/finalize-plan.md +7 -7
  8. package/onboarding/prompts/credentials/plan.md +36 -25
  9. package/onboarding/prompts/credentials/settle-credentials.md +3 -3
  10. package/onboarding/prompts/credentials/write-plan.md +10 -18
  11. package/onboarding/prompts/fallback/best-effort.md +8 -8
  12. package/onboarding/prompts/feature/a2ui/implement.md +6 -6
  13. package/onboarding/prompts/feature/a2ui/proof.md +5 -5
  14. package/onboarding/prompts/feature/a2ui/start.md +9 -9
  15. package/onboarding/prompts/feature/channels/implement.md +7 -7
  16. package/onboarding/prompts/feature/channels/proof.md +5 -5
  17. package/onboarding/prompts/feature/channels/start.md +9 -9
  18. package/onboarding/prompts/feature/chat-suggestions/implement.md +6 -6
  19. package/onboarding/prompts/feature/chat-suggestions/proof.md +5 -5
  20. package/onboarding/prompts/feature/chat-suggestions/start.md +9 -9
  21. package/onboarding/prompts/feature/complete.md +2 -2
  22. package/onboarding/prompts/feature/learning/implement.md +13 -13
  23. package/onboarding/prompts/feature/learning/proof.md +6 -6
  24. package/onboarding/prompts/feature/learning/start.md +9 -9
  25. package/onboarding/prompts/feature/open-generative-ui/implement.md +6 -6
  26. package/onboarding/prompts/feature/open-generative-ui/proof.md +5 -5
  27. package/onboarding/prompts/feature/open-generative-ui/start.md +9 -9
  28. package/onboarding/prompts/feature/realtime-sync/implement.md +7 -7
  29. package/onboarding/prompts/feature/realtime-sync/proof.md +5 -5
  30. package/onboarding/prompts/feature/realtime-sync/start.md +8 -8
  31. package/onboarding/prompts/feature/rich-threads/implement.md +8 -8
  32. package/onboarding/prompts/feature/rich-threads/proof.md +5 -5
  33. package/onboarding/prompts/feature/rich-threads/start.md +8 -8
  34. package/onboarding/prompts/feature/stop.md +3 -3
  35. package/onboarding/prompts/feature/voice/implement.md +6 -6
  36. package/onboarding/prompts/feature/voice/proof.md +5 -5
  37. package/onboarding/prompts/feature/voice/start.md +9 -9
  38. package/onboarding/prompts/framework/ag2.md +2 -2
  39. package/onboarding/prompts/framework/agno.md +2 -2
  40. package/onboarding/prompts/framework/built-in.md +2 -2
  41. package/onboarding/prompts/framework/claude-sdk-python.md +2 -2
  42. package/onboarding/prompts/framework/claude-sdk-typescript.md +2 -2
  43. package/onboarding/prompts/framework/crewai-flows.md +2 -2
  44. package/onboarding/prompts/framework/custom-ag-ui.md +98 -0
  45. package/onboarding/prompts/framework/deep-agents.md +2 -2
  46. package/onboarding/prompts/framework/google-adk.md +2 -2
  47. package/onboarding/prompts/framework/langgraph-fastapi.md +2 -2
  48. package/onboarding/prompts/framework/langgraph-python.md +2 -2
  49. package/onboarding/prompts/framework/langgraph-typescript.md +2 -2
  50. package/onboarding/prompts/framework/llamaindex.md +2 -2
  51. package/onboarding/prompts/framework/mastra.md +2 -2
  52. package/onboarding/prompts/framework/ms-agent-dotnet.md +3 -3
  53. package/onboarding/prompts/framework/ms-agent-harness-dotnet.md +3 -3
  54. package/onboarding/prompts/framework/ms-agent-python.md +2 -2
  55. package/onboarding/prompts/framework/pydantic-ai.md +2 -2
  56. package/onboarding/prompts/framework/strands-python.md +2 -2
  57. package/onboarding/prompts/framework/strands-typescript.md +2 -2
  58. package/onboarding/prompts/frontend/angular.md +10 -21
  59. package/onboarding/prompts/frontend/nextjs.md +3 -3
  60. package/onboarding/prompts/frontend/plan.md +7 -7
  61. package/onboarding/prompts/frontend/react-native.md +2 -2
  62. package/onboarding/prompts/frontend/react-spa.md +2 -2
  63. package/onboarding/prompts/frontend/vue.md +2 -2
  64. package/onboarding/prompts/implementation/build-and-validate.md +12 -12
  65. package/onboarding/prompts/proof/complete.md +3 -3
  66. package/onboarding/prompts/proof/oss-baseline.md +5 -5
  67. package/onboarding/prompts/proof/round-trip.md +10 -10
  68. package/onboarding/prompts/research/gather.md +5 -5
  69. package/onboarding/prompts/research/merge.md +2 -2
  70. package/onboarding/prompts/research/preflight.md +2 -2
  71. package/onboarding/prompts/research/route.md +9 -9
  72. package/onboarding/prompts/starter/clone.md +15 -14
  73. package/onboarding/prompts/stopped/run-failed.md +2 -2
  74. package/onboarding/prompts/subagent/create-plan.md +26 -40
  75. package/onboarding/prompts/subagent/implement-and-validate.md +26 -38
  76. package/onboarding/prompts/subagent/inspect-repository.md +4 -1
  77. package/onboarding/prompts/subagent/prove-oss-baseline.md +1 -1
  78. package/onboarding/prompts/subagent/prove-round-trip.md +86 -244
  79. package/onboarding/prompts/unsupported/no-validated-path.md +2 -2
  80. package/package.json +1 -1
  81. package/release/release-tool.js +1 -1
@@ -31,7 +31,7 @@ still go on the record. Name the file and why the fix needs it, then end your tu
31
31
  for the developer's answer. If they allow it, record their answer before any edit:
32
32
 
33
33
  ```text
34
- npx --prefer-offline --yes copilotkit@4.21.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
34
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
35
35
  ```
36
36
 
37
37
  Continue only when the result starts with `Status: passed`. Run the audit again, take the
@@ -44,11 +44,11 @@ Report the outcome of each attempt as it ends, before any repair. The command co
44
44
  attempts and the repairs:
45
45
 
46
46
  ```text
47
- npx --prefer-offline --yes copilotkit@4.21.0 onboard proof --step round-trip --outcome <passed|failed|skipped>
47
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard proof --step round-trip --outcome <passed|failed|skipped>
48
48
  ```
49
49
 
50
50
  Use `passed` only for a proved mention reply, `failed` for an attempted proof that
51
- failed, and `skipped` when the proof did not run. Then run `npx --prefer-offline --yes copilotkit@4.21.0 onboard audit`.
51
+ failed, and `skipped` when the proof did not run. Then run `npx --prefer-offline --yes copilotkit@4.22.0 onboard audit`.
52
52
  Continue only when it starts with `Status: passed`.
53
53
 
54
54
  If the audit fails, never repair, reset, or revert a protected path. Compare each named path
@@ -63,11 +63,11 @@ the path and the change the audit reports. Run the audit again after each accept
63
63
  If the audit still fails, or starts with `Status: blocked`, route out and stop:
64
64
 
65
65
  ```text
66
- npx --prefer-offline --yes copilotkit@4.21.0 onboard read feature/stop
66
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard read feature/stop
67
67
  ```
68
68
 
69
69
  When the audit passes and the round trip you reported above was `passed`, run
70
- `npx --prefer-offline --yes copilotkit@4.21.0 onboard read feature/complete` and complete with
70
+ `npx --prefer-offline --yes copilotkit@4.22.0 onboard read feature/complete` and complete with
71
71
  `--visual-check channels-proof-passed`. The recorded mention and reply are this run's
72
72
  proof, so no web app check is missing. Use `--visual-check performed` only when a
73
73
  browser drove Slack or Teams web and proved the mention reply. Do not use
@@ -3,7 +3,7 @@
3
3
  First, report your coding agent identity using the same command as generic onboarding:
4
4
 
5
5
  ```text
6
- npx --prefer-offline --yes copilotkit@4.21.0 onboard identify --coding-agent <coding-agent-slug> --model <model-id> --model-family <model-family>
6
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard identify --coding-agent <coding-agent-slug> --model <model-id> --model-family <model-family>
7
7
  ```
8
8
 
9
9
  Use your own product's slug, such as `codex` or `claude-code`. For `--model`, copy the
@@ -34,13 +34,13 @@ carry on. Keep a read-only assignment read-only. If no subagent works at all, re
34
34
  once:
35
35
 
36
36
  ```text
37
- npx --prefer-offline --yes copilotkit@4.21.0 onboard checkpoint --phase delegation-unavailable
37
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard checkpoint --phase delegation-unavailable
38
38
  ```
39
39
 
40
40
  Before you end your turn to wait for the developer, report the pause:
41
41
 
42
42
  ```text
43
- npx --prefer-offline --yes copilotkit@4.21.0 onboard checkpoint --phase awaiting-developer
43
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard checkpoint --phase awaiting-developer
44
44
  ```
45
45
 
46
46
  A turn that ends while the run waits is a pause, not a stop, even when your harness ends it.
@@ -50,7 +50,7 @@ If you stop this run, send one short report before you stop. The friction comman
50
50
  the telemetry setting the developer already chose, so it needs no separate question.
51
51
 
52
52
  ```text
53
- npx --prefer-offline --yes copilotkit@4.21.0 onboard friction --phase stop --category <slug> --message "<sentences>"
53
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard friction --phase stop --category <slug> --message "<sentences>"
54
54
  ```
55
55
 
56
56
  `--message` takes one or two sentences: the step you stopped at and what stopped it.
@@ -64,7 +64,7 @@ one scoped fix, and sends the report itself when no fix is approved.
64
64
  Before any subagent or project process runs, capture the developer's existing work:
65
65
 
66
66
  ```text
67
- npx --prefer-offline --yes copilotkit@4.21.0 onboard protect
67
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard protect
68
68
  ```
69
69
 
70
70
  Keep the exact protected path list it prints and give that list to every subagent. Do not
@@ -94,7 +94,7 @@ This one does not.
94
94
  Wait for the inspection subagent to finish. Then report that the inspection came back:
95
95
 
96
96
  ```text
97
- npx --prefer-offline --yes copilotkit@4.21.0 onboard checkpoint --phase research-returned
97
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard checkpoint --phase research-returned
98
98
  ```
99
99
 
100
100
  If the folder is empty, check Node 22, `uv`, and Python before cloning. Python 3.12 or
@@ -108,7 +108,7 @@ and its install command in the message the developer sees: `nvm install 22` for
108
108
  for Python. Offer a custom headless build as a later path. Then route out:
109
109
 
110
110
  ```text
111
- npx --prefer-offline --yes copilotkit@4.21.0 onboard read feature/stop
111
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard read feature/stop
112
112
  ```
113
113
 
114
114
  Do not run login, select Intelligence, or create a credential until the developer
@@ -138,11 +138,11 @@ one.
138
138
  After approval, record each approved path before implementation:
139
139
 
140
140
  ```text
141
- npx --prefer-offline --yes copilotkit@4.21.0 onboard protect --authorize --path <path> --reason "<the plan's sentence>"
141
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard protect --authorize --path <path> --reason "<the plan's sentence>"
142
142
  ```
143
143
 
144
144
  If an approved path changed after capture and no implementation step has run, add
145
145
  `--with-prior-change`. Continue only when every result starts with `Status: passed`. Do not
146
146
  authorize a path the approved plan did not list.
147
147
 
148
- Then run `npx --prefer-offline --yes copilotkit@4.21.0 onboard read feature/channels/implement`.
148
+ Then run `npx --prefer-offline --yes copilotkit@4.22.0 onboard read feature/channels/implement`.
@@ -15,7 +15,7 @@ Run focused type/test checks and start the app. Record the changed files and val
15
15
  Before you spawn the implementation subagent, take the authorized list from the CLI:
16
16
 
17
17
  ```text
18
- npx --prefer-offline --yes copilotkit@4.21.0 onboard audit
18
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard audit
19
19
  ```
20
20
 
21
21
  From its result, copy the paths under `Authorized to modify:`. A passed or failed audit with
@@ -34,7 +34,7 @@ still go on the record. Name the file and why the work needs it, then end your t
34
34
  for the developer's answer. If they allow it, record their answer before any edit:
35
35
 
36
36
  ```text
37
- npx --prefer-offline --yes copilotkit@4.21.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
37
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
38
38
  ```
39
39
 
40
40
  Continue only when the result starts with `Status: passed`. Run the audit again, take the
@@ -46,7 +46,7 @@ feature stop route below.
46
46
  After validation and each repair, run:
47
47
 
48
48
  ```text
49
- npx --prefer-offline --yes copilotkit@4.21.0 onboard audit
49
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard audit
50
50
  ```
51
51
 
52
52
  Continue only when it starts with `Status: passed`. A path under `Authorized to modify:` is
@@ -57,7 +57,7 @@ with the implementation subagent's `Files changed` section. If that section does
57
57
  the path, accept the developer's external change:
58
58
 
59
59
  ```text
60
- npx --prefer-offline --yes copilotkit@4.21.0 onboard protect --accept-external --path <path>
60
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard protect --accept-external --path <path>
61
61
  ```
62
62
 
63
63
  For an env file where the developer placed a requested credential, use
@@ -70,11 +70,11 @@ Run the audit again after each accepted change. If it still fails, or starts
70
70
  with `Status: blocked`, route out and stop:
71
71
 
72
72
  ```text
73
- npx --prefer-offline --yes copilotkit@4.21.0 onboard read feature/stop
73
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard read feature/stop
74
74
  ```
75
75
 
76
76
  If validation cannot pass, or this intent needs a prerequisite the app does not have, use
77
77
  the feature stop route above without further changes.
78
78
 
79
79
  Otherwise run
80
- `npx --prefer-offline --yes copilotkit@4.21.0 onboard read feature/chat-suggestions/proof`.
80
+ `npx --prefer-offline --yes copilotkit@4.22.0 onboard read feature/chat-suggestions/proof`.
@@ -20,7 +20,7 @@ still go on the record. Name the file and why the fix needs it, then end your tu
20
20
  for the developer's answer. If they allow it, record their answer before any edit:
21
21
 
22
22
  ```text
23
- npx --prefer-offline --yes copilotkit@4.21.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
23
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
24
24
  ```
25
25
 
26
26
  Continue only when the result starts with `Status: passed`. Run the audit again, take the
@@ -33,11 +33,11 @@ Report the outcome of each attempt as it ends, before any repair. The command co
33
33
  attempts and the repairs:
34
34
 
35
35
  ```text
36
- npx --prefer-offline --yes copilotkit@4.21.0 onboard proof --step round-trip --outcome <passed|failed|skipped>
36
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard proof --step round-trip --outcome <passed|failed|skipped>
37
37
  ```
38
38
 
39
39
  Use `passed` only for a proved sent suggestion, `failed` for an attempted proof that failed,
40
- and `skipped` when the proof could not run. Then run `npx --prefer-offline --yes copilotkit@4.21.0 onboard audit`.
40
+ and `skipped` when the proof could not run. Then run `npx --prefer-offline --yes copilotkit@4.22.0 onboard audit`.
41
41
  Continue only when it starts with `Status: passed`.
42
42
 
43
43
  If the audit fails, never repair, reset, or revert a protected path. Compare each named path
@@ -52,9 +52,9 @@ the path and the change the audit reports. Run the audit again after each accept
52
52
  If the audit still fails, or starts with `Status: blocked`, route out and stop:
53
53
 
54
54
  ```text
55
- npx --prefer-offline --yes copilotkit@4.21.0 onboard read feature/stop
55
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard read feature/stop
56
56
  ```
57
57
 
58
58
  When the audit passes, run
59
- `npx --prefer-offline --yes copilotkit@4.21.0 onboard read feature/complete` with the real browser-proof
59
+ `npx --prefer-offline --yes copilotkit@4.22.0 onboard read feature/complete` with the real browser-proof
60
60
  outcome.
@@ -19,13 +19,13 @@ carry on. Keep a read-only assignment read-only. If no subagent works at all, re
19
19
  once:
20
20
 
21
21
  ```text
22
- npx --prefer-offline --yes copilotkit@4.21.0 onboard checkpoint --phase delegation-unavailable
22
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard checkpoint --phase delegation-unavailable
23
23
  ```
24
24
 
25
25
  Before you end your turn to wait for the developer, report the pause:
26
26
 
27
27
  ```text
28
- npx --prefer-offline --yes copilotkit@4.21.0 onboard checkpoint --phase awaiting-developer
28
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard checkpoint --phase awaiting-developer
29
29
  ```
30
30
 
31
31
  A turn that ends while the run waits is a pause, not a stop, even when your harness ends it.
@@ -35,7 +35,7 @@ If you stop this run, send one short report before you stop. The friction comman
35
35
  the telemetry setting the developer already chose, so it needs no separate question.
36
36
 
37
37
  ```text
38
- npx --prefer-offline --yes copilotkit@4.21.0 onboard friction --phase stop --category <slug> --message "<sentences>"
38
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard friction --phase stop --category <slug> --message "<sentences>"
39
39
  ```
40
40
 
41
41
  `--message` takes one or two sentences: the step you stopped at and what stopped it.
@@ -49,7 +49,7 @@ one scoped fix, and sends the report itself when no fix is approved.
49
49
  Before any subagent or project process runs, capture the developer's existing work:
50
50
 
51
51
  ```text
52
- npx --prefer-offline --yes copilotkit@4.21.0 onboard protect
52
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard protect
53
53
  ```
54
54
 
55
55
  Keep the exact protected path list it prints and give that list to every subagent. No
@@ -58,20 +58,20 @@ approved authorization before implementation.
58
58
 
59
59
  Before edits, identify the current CopilotKit provider, chat component, message lifecycle,
60
60
  agent id, package version, and test/dev commands. Prove the existing OSS round trip with
61
- `/info`, `npx --prefer-offline --yes copilotkit@4.21.0 verify --expect-runtime oss --round-trip --agent <agent-id> --json`,
61
+ `/info`, `npx --prefer-offline --yes copilotkit@4.22.0 verify --expect-runtime oss --round-trip --agent <agent-id> --json`,
62
62
  and one real frontend request when browser control is available.
63
63
 
64
64
  Wait for the inspection subagent to finish. Then report that the inspection came back:
65
65
 
66
66
  ```text
67
- npx --prefer-offline --yes copilotkit@4.21.0 onboard checkpoint --phase research-returned
67
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard checkpoint --phase research-returned
68
68
  ```
69
69
 
70
70
  If the inspection did not prove the baseline this intent extends, stop here without
71
71
  changing files:
72
72
 
73
73
  ```text
74
- npx --prefer-offline --yes copilotkit@4.21.0 onboard read feature/stop
74
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard read feature/stop
75
75
  ```
76
76
 
77
77
  Do not run login, provision Intelligence, request a credential, replace the agent, or alter
@@ -93,11 +93,11 @@ one.
93
93
  After approval, record each approved path before implementation:
94
94
 
95
95
  ```text
96
- npx --prefer-offline --yes copilotkit@4.21.0 onboard protect --authorize --path <path> --reason "<the plan's sentence>"
96
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard protect --authorize --path <path> --reason "<the plan's sentence>"
97
97
  ```
98
98
 
99
99
  If an approved path changed after capture and no implementation step has run, add
100
100
  `--with-prior-change`. Continue only when every result starts with `Status: passed`. Do not
101
101
  authorize a path the approved plan did not list.
102
102
 
103
- Then run `npx --prefer-offline --yes copilotkit@4.21.0 onboard read feature/chat-suggestions/implement`.
103
+ Then run `npx --prefer-offline --yes copilotkit@4.22.0 onboard read feature/chat-suggestions/implement`.
@@ -3,7 +3,7 @@
3
3
  Use the outcome the proof step observed. Run:
4
4
 
5
5
  ```text
6
- npx --prefer-offline --yes copilotkit@4.21.0 onboard complete --visual-check <performed|skipped-no-browser-tool|channels-proof-passed|failed>
6
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard complete --visual-check <performed|skipped-no-browser-tool|channels-proof-passed|failed>
7
7
  ```
8
8
 
9
9
  Use `channels-proof-passed` for a Slack or Teams run that recorded a passed round-trip proof
@@ -22,7 +22,7 @@ Before `onboard complete`, send the friction this run mentioned to the developer
22
22
  report each, at most four, costliest first:
23
23
 
24
24
  ```text
25
- npx --prefer-offline --yes copilotkit@4.21.0 onboard friction --category <slug> --cost-seconds <seconds> --message "<sentences>"
25
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard friction --category <slug> --cost-seconds <seconds> --message "<sentences>"
26
26
  ```
27
27
 
28
28
  Put one or two sentences in `--message`, with no secrets, source, or logs. Pick the
@@ -17,7 +17,7 @@ follows the telemetry setting the developer already chose, so it needs no separa
17
17
  question.
18
18
 
19
19
  ```text
20
- npx --prefer-offline --yes copilotkit@4.21.0 onboard friction --phase stop --category <slug> --message "<sentences>"
20
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard friction --phase stop --category <slug> --message "<sentences>"
21
21
  ```
22
22
 
23
23
  `--message` takes one or two sentences: the step you stopped at and what stopped it.
@@ -49,7 +49,7 @@ settled refusal rather than a missing baseline, so stop here, before any file ch
49
49
  take its own ending:
50
50
 
51
51
  ```text
52
- npx --prefer-offline --yes copilotkit@4.21.0 onboard read feature/blocked-by-plan
52
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard read feature/blocked-by-plan
53
53
  ```
54
54
 
55
55
  `LEARNING_AVAILABILITY_UNAVAILABLE` means the platform did not resolve the answer. It is
@@ -63,7 +63,7 @@ then, so the read below is where its refusal surfaces.
63
63
  When the plan or the repository already names an id, ask about that one id and nothing else:
64
64
 
65
65
  ```text
66
- npx --prefer-offline --yes copilotkit@4.21.0 learning containers get <id> --json
66
+ npx --prefer-offline --yes copilotkit@4.22.0 learning containers get <id> --json
67
67
  ```
68
68
 
69
69
  One call answers it, and no list is needed.
@@ -71,7 +71,7 @@ One call answers it, and no list is needed.
71
71
  When no id is in hand, survey what the project holds:
72
72
 
73
73
  ```text
74
- npx --prefer-offline --yes copilotkit@4.21.0 learning containers list --json
74
+ npx --prefer-offline --yes copilotkit@4.22.0 learning containers list --json
75
75
  ```
76
76
 
77
77
  One call returns at most 500 containers. When `nextCursor` in the result is not null, read
@@ -94,7 +94,7 @@ user, so the callback can return a different id per tier or per customer.
94
94
  Ask the CLI for the id rather than spelling one yourself:
95
95
 
96
96
  ```text
97
- npx --prefer-offline --yes copilotkit@4.21.0 learning containers default-id --json
97
+ npx --prefer-offline --yes copilotkit@4.22.0 learning containers default-id --json
98
98
  ```
99
99
 
100
100
  It derives the project-scoped id from the selected project's slug, reads the local project
@@ -108,7 +108,7 @@ run that spells the id differently gives one project two containers, each below
108
108
  above on its own. One command is what keeps the two spellings identical.
109
109
 
110
110
  ```text
111
- npx --prefer-offline --yes copilotkit@4.21.0 learning containers create --id <id> --name <name> --json
111
+ npx --prefer-offline --yes copilotkit@4.22.0 learning containers create --id <id> --name <name> --json
112
112
  ```
113
113
 
114
114
  An id already in use answers `LEARNING_CONTAINER_ALREADY_EXISTS`. That is a container to
@@ -134,13 +134,13 @@ non-zero on an app that is working. Pass what `identifyUser` reads with a repeat
134
134
  It is not a defect to repair.
135
135
 
136
136
  Run focused tests and
137
- `npx --prefer-offline --yes copilotkit@4.21.0 verify --expect-runtime intelligence --round-trip --agent <agent-id> --json`.
137
+ `npx --prefer-offline --yes copilotkit@4.22.0 verify --expect-runtime intelligence --round-trip --agent <agent-id> --json`.
138
138
  Repair changed-file failures and record secret-safe evidence.
139
139
 
140
140
  Before you spawn the implementation subagent, take the authorized list from the CLI:
141
141
 
142
142
  ```text
143
- npx --prefer-offline --yes copilotkit@4.21.0 onboard audit
143
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard audit
144
144
  ```
145
145
 
146
146
  From its result, copy the paths under `Authorized to modify:`. A passed or failed audit with
@@ -159,7 +159,7 @@ still go on the record. Name the file and why the work needs it, then end your t
159
159
  for the developer's answer. If they allow it, record their answer before any edit:
160
160
 
161
161
  ```text
162
- npx --prefer-offline --yes copilotkit@4.21.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
162
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
163
163
  ```
164
164
 
165
165
  Continue only when the result starts with `Status: passed`. Run the audit again, take the
@@ -171,7 +171,7 @@ feature stop route below.
171
171
  After validation and each repair, run:
172
172
 
173
173
  ```text
174
- npx --prefer-offline --yes copilotkit@4.21.0 onboard audit
174
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard audit
175
175
  ```
176
176
 
177
177
  Continue only when it starts with `Status: passed`. A path under `Authorized to modify:` is
@@ -182,7 +182,7 @@ with the implementation subagent's `Files changed` section. If that section does
182
182
  the path, accept the developer's external change:
183
183
 
184
184
  ```text
185
- npx --prefer-offline --yes copilotkit@4.21.0 onboard protect --accept-external --path <path>
185
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard protect --accept-external --path <path>
186
186
  ```
187
187
 
188
188
  For an env file where the developer placed a requested credential, use
@@ -196,11 +196,11 @@ with `Status: blocked`, route out and stop. Route out the same way when
196
196
  `--accept-credential` refuses because it names a lost variable:
197
197
 
198
198
  ```text
199
- npx --prefer-offline --yes copilotkit@4.21.0 onboard read feature/stop
199
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard read feature/stop
200
200
  ```
201
201
 
202
202
  If validation cannot pass, or this intent needs a prerequisite the app does not have, use
203
203
  the feature stop route above without further changes.
204
204
 
205
205
  Otherwise run
206
- `npx --prefer-offline --yes copilotkit@4.21.0 onboard read feature/learning/proof`.
206
+ `npx --prefer-offline --yes copilotkit@4.22.0 onboard read feature/learning/proof`.
@@ -7,7 +7,7 @@ Container. Confirm the thread remains associated with the expected user.
7
7
  One command decides it:
8
8
 
9
9
  ```text
10
- npx --prefer-offline --yes copilotkit@4.21.0 verify --expect-runtime intelligence --round-trip --agent <agent-id> --expect-learning-container <id> --json
10
+ npx --prefer-offline --yes copilotkit@4.22.0 verify --expect-runtime intelligence --round-trip --agent <agent-id> --expect-learning-container <id> --json
11
11
  ```
12
12
 
13
13
  It reads the thread back from the platform, so it answers for any runtime mount, and it
@@ -40,7 +40,7 @@ still go on the record. Name the file and why the fix needs it, then end your tu
40
40
  for the developer's answer. If they allow it, record their answer before any edit:
41
41
 
42
42
  ```text
43
- npx --prefer-offline --yes copilotkit@4.21.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
43
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
44
44
  ```
45
45
 
46
46
  Continue only when the result starts with `Status: passed`. Run the audit again, take the
@@ -53,12 +53,12 @@ Report the outcome of each attempt as it ends, before any repair. The command co
53
53
  attempts and the repairs:
54
54
 
55
55
  ```text
56
- npx --prefer-offline --yes copilotkit@4.21.0 onboard proof --step round-trip --outcome <passed|failed|skipped>
56
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard proof --step round-trip --outcome <passed|failed|skipped>
57
57
  ```
58
58
 
59
59
  Use `passed` only for a proved Container assignment, `failed` for an attempted proof that
60
60
  failed, and `skipped` when the proof could not run. Then run
61
- `npx --prefer-offline --yes copilotkit@4.21.0 onboard audit`. Continue only when it starts with
61
+ `npx --prefer-offline --yes copilotkit@4.22.0 onboard audit`. Continue only when it starts with
62
62
  `Status: passed`.
63
63
 
64
64
  If the audit fails, never repair, reset, or revert a protected path. Compare each named path
@@ -73,9 +73,9 @@ the path and the change the audit reports. Run the audit again after each accept
73
73
  If the audit still fails, or starts with `Status: blocked`, route out and stop:
74
74
 
75
75
  ```text
76
- npx --prefer-offline --yes copilotkit@4.21.0 onboard read feature/stop
76
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard read feature/stop
77
77
  ```
78
78
 
79
79
  When the audit passes, run
80
- `npx --prefer-offline --yes copilotkit@4.21.0 onboard read feature/complete` with the actual surface
80
+ `npx --prefer-offline --yes copilotkit@4.22.0 onboard read feature/complete` with the actual surface
81
81
  outcome.
@@ -20,13 +20,13 @@ carry on. Keep a read-only assignment read-only. If no subagent works at all, re
20
20
  once:
21
21
 
22
22
  ```text
23
- npx --prefer-offline --yes copilotkit@4.21.0 onboard checkpoint --phase delegation-unavailable
23
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard checkpoint --phase delegation-unavailable
24
24
  ```
25
25
 
26
26
  Before you end your turn to wait for the developer, report the pause:
27
27
 
28
28
  ```text
29
- npx --prefer-offline --yes copilotkit@4.21.0 onboard checkpoint --phase awaiting-developer
29
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard checkpoint --phase awaiting-developer
30
30
  ```
31
31
 
32
32
  A turn that ends while the run waits is a pause, not a stop, even when your harness ends it.
@@ -36,7 +36,7 @@ If you stop this run, send one short report before you stop. The friction comman
36
36
  the telemetry setting the developer already chose, so it needs no separate question.
37
37
 
38
38
  ```text
39
- npx --prefer-offline --yes copilotkit@4.21.0 onboard friction --phase stop --category <slug> --message "<sentences>"
39
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard friction --phase stop --category <slug> --message "<sentences>"
40
40
  ```
41
41
 
42
42
  `--message` takes one or two sentences: the step you stopped at and what stopped it.
@@ -66,7 +66,7 @@ status:
66
66
  before the capture, the inspection, and any edit:
67
67
 
68
68
  ```text
69
- npx --prefer-offline --yes copilotkit@4.21.0 onboard read feature/blocked-by-plan
69
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard read feature/blocked-by-plan
70
70
  ```
71
71
 
72
72
  - `LEARNING_AVAILABILITY_UNAVAILABLE` means the platform did not resolve the answer. It is
@@ -87,7 +87,7 @@ again: it has no answer, so it carries the question forward rather than ending o
87
87
  Before any subagent or project process runs, capture the developer's existing work:
88
88
 
89
89
  ```text
90
- npx --prefer-offline --yes copilotkit@4.21.0 onboard protect
90
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard protect
91
91
  ```
92
92
 
93
93
  Keep the exact protected path list it prints and give that list to every subagent. No
@@ -101,14 +101,14 @@ test/dev commands. Prove the current round trip and inspect `/info`.
101
101
  Wait for the inspection subagent to finish. Then report that the inspection came back:
102
102
 
103
103
  ```text
104
- npx --prefer-offline --yes copilotkit@4.21.0 onboard checkpoint --phase research-returned
104
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard checkpoint --phase research-returned
105
105
  ```
106
106
 
107
107
  If the inspection did not prove the baseline this intent extends, stop here without
108
108
  changing files:
109
109
 
110
110
  ```text
111
- npx --prefer-offline --yes copilotkit@4.21.0 onboard read feature/stop
111
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard read feature/stop
112
112
  ```
113
113
 
114
114
  Fetch the current official guides before planning:
@@ -140,11 +140,11 @@ one.
140
140
  After approval, record each approved path before implementation:
141
141
 
142
142
  ```text
143
- npx --prefer-offline --yes copilotkit@4.21.0 onboard protect --authorize --path <path> --reason "<the plan's sentence>"
143
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard protect --authorize --path <path> --reason "<the plan's sentence>"
144
144
  ```
145
145
 
146
146
  If an approved path changed after capture and no implementation step has run, add
147
147
  `--with-prior-change`. Continue only when every result starts with `Status: passed`. Do not
148
148
  authorize a path the approved plan did not list.
149
149
 
150
- Then run `npx --prefer-offline --yes copilotkit@4.21.0 onboard read feature/learning/implement`.
150
+ Then run `npx --prefer-offline --yes copilotkit@4.22.0 onboard read feature/learning/implement`.
@@ -16,7 +16,7 @@ validation results without secrets.
16
16
  Before you spawn the implementation subagent, take the authorized list from the CLI:
17
17
 
18
18
  ```text
19
- npx --prefer-offline --yes copilotkit@4.21.0 onboard audit
19
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard audit
20
20
  ```
21
21
 
22
22
  From its result, copy the paths under `Authorized to modify:`. A passed or failed audit with
@@ -35,7 +35,7 @@ still go on the record. Name the file and why the work needs it, then end your t
35
35
  for the developer's answer. If they allow it, record their answer before any edit:
36
36
 
37
37
  ```text
38
- npx --prefer-offline --yes copilotkit@4.21.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
38
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
39
39
  ```
40
40
 
41
41
  Continue only when the result starts with `Status: passed`. Run the audit again, take the
@@ -47,7 +47,7 @@ feature stop route below.
47
47
  After validation and each repair, run:
48
48
 
49
49
  ```text
50
- npx --prefer-offline --yes copilotkit@4.21.0 onboard audit
50
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard audit
51
51
  ```
52
52
 
53
53
  Continue only when it starts with `Status: passed`. A path under `Authorized to modify:` is
@@ -58,7 +58,7 @@ with the implementation subagent's `Files changed` section. If that section does
58
58
  the path, accept the developer's external change:
59
59
 
60
60
  ```text
61
- npx --prefer-offline --yes copilotkit@4.21.0 onboard protect --accept-external --path <path>
61
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard protect --accept-external --path <path>
62
62
  ```
63
63
 
64
64
  For an env file where the developer placed a requested credential, use
@@ -71,11 +71,11 @@ Run the audit again after each accepted change. If it still fails, or starts
71
71
  with `Status: blocked`, route out and stop:
72
72
 
73
73
  ```text
74
- npx --prefer-offline --yes copilotkit@4.21.0 onboard read feature/stop
74
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard read feature/stop
75
75
  ```
76
76
 
77
77
  If validation cannot pass, or this intent needs a prerequisite the app does not have, use
78
78
  the feature stop route above without further changes.
79
79
 
80
80
  Otherwise run
81
- `npx --prefer-offline --yes copilotkit@4.21.0 onboard read feature/open-generative-ui/proof`.
81
+ `npx --prefer-offline --yes copilotkit@4.22.0 onboard read feature/open-generative-ui/proof`.
@@ -21,7 +21,7 @@ still go on the record. Name the file and why the fix needs it, then end your tu
21
21
  for the developer's answer. If they allow it, record their answer before any edit:
22
22
 
23
23
  ```text
24
- npx --prefer-offline --yes copilotkit@4.21.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
24
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
25
25
  ```
26
26
 
27
27
  Continue only when the result starts with `Status: passed`. Run the audit again, take the
@@ -34,11 +34,11 @@ Report the outcome of each attempt as it ends, before any repair. The command co
34
34
  attempts and the repairs:
35
35
 
36
36
  ```text
37
- npx --prefer-offline --yes copilotkit@4.21.0 onboard proof --step round-trip --outcome <passed|failed|skipped>
37
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard proof --step round-trip --outcome <passed|failed|skipped>
38
38
  ```
39
39
 
40
40
  Use `passed` only for a proved generated UI, `failed` for an attempted proof that failed,
41
- and `skipped` when the proof could not run. Then run `npx --prefer-offline --yes copilotkit@4.21.0 onboard audit`.
41
+ and `skipped` when the proof could not run. Then run `npx --prefer-offline --yes copilotkit@4.22.0 onboard audit`.
42
42
  Continue only when it starts with `Status: passed`.
43
43
 
44
44
  If the audit fails, never repair, reset, or revert a protected path. Compare each named path
@@ -53,9 +53,9 @@ the path and the change the audit reports. Run the audit again after each accept
53
53
  If the audit still fails, or starts with `Status: blocked`, route out and stop:
54
54
 
55
55
  ```text
56
- npx --prefer-offline --yes copilotkit@4.21.0 onboard read feature/stop
56
+ npx --prefer-offline --yes copilotkit@4.22.0 onboard read feature/stop
57
57
  ```
58
58
 
59
59
  When the audit passes, run
60
- `npx --prefer-offline --yes copilotkit@4.21.0 onboard read feature/complete` with the outcome actually
60
+ `npx --prefer-offline --yes copilotkit@4.22.0 onboard read feature/complete` with the outcome actually
61
61
  observed.