copilotkit 4.20.0 → 4.21.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/README.md +28 -0
- package/cli-build-info.json +8 -8
- package/index.js +3530 -2868
- package/onboarding/prompts/authenticate/start.md +8 -8
- package/onboarding/prompts/conversion/plan.md +3 -3
- package/onboarding/prompts/credentials/finalize-plan.md +7 -7
- package/onboarding/prompts/credentials/plan.md +22 -22
- package/onboarding/prompts/credentials/settle-credentials.md +3 -3
- package/onboarding/prompts/credentials/write-plan.md +5 -5
- package/onboarding/prompts/fallback/best-effort.md +8 -8
- package/onboarding/prompts/feature/a2ui/implement.md +6 -6
- package/onboarding/prompts/feature/a2ui/proof.md +5 -5
- package/onboarding/prompts/feature/a2ui/start.md +9 -9
- package/onboarding/prompts/feature/channels/implement.md +7 -7
- package/onboarding/prompts/feature/channels/proof.md +5 -5
- package/onboarding/prompts/feature/channels/start.md +9 -9
- package/onboarding/prompts/feature/chat-suggestions/implement.md +6 -6
- package/onboarding/prompts/feature/chat-suggestions/proof.md +5 -5
- package/onboarding/prompts/feature/chat-suggestions/start.md +9 -9
- package/onboarding/prompts/feature/complete.md +2 -2
- package/onboarding/prompts/feature/learning/implement.md +13 -13
- package/onboarding/prompts/feature/learning/proof.md +6 -6
- package/onboarding/prompts/feature/learning/start.md +9 -9
- package/onboarding/prompts/feature/open-generative-ui/implement.md +6 -6
- package/onboarding/prompts/feature/open-generative-ui/proof.md +5 -5
- package/onboarding/prompts/feature/open-generative-ui/start.md +9 -9
- package/onboarding/prompts/feature/realtime-sync/implement.md +7 -7
- package/onboarding/prompts/feature/realtime-sync/proof.md +5 -5
- package/onboarding/prompts/feature/realtime-sync/start.md +8 -8
- package/onboarding/prompts/feature/rich-threads/implement.md +8 -8
- package/onboarding/prompts/feature/rich-threads/proof.md +5 -5
- package/onboarding/prompts/feature/rich-threads/start.md +8 -8
- package/onboarding/prompts/feature/stop.md +3 -3
- package/onboarding/prompts/feature/voice/implement.md +6 -6
- package/onboarding/prompts/feature/voice/proof.md +5 -5
- package/onboarding/prompts/feature/voice/start.md +9 -9
- 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 +3 -3
- package/onboarding/prompts/framework/ms-agent-harness-dotnet.md +3 -3
- package/onboarding/prompts/framework/ms-agent-python.md +2 -2
- package/onboarding/prompts/framework/pydantic-ai.md +2 -2
- package/onboarding/prompts/framework/strands-python.md +2 -2
- package/onboarding/prompts/framework/strands-typescript.md +2 -2
- package/onboarding/prompts/frontend/angular.md +3 -3
- package/onboarding/prompts/frontend/nextjs.md +3 -3
- package/onboarding/prompts/frontend/plan.md +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 +12 -12
- package/onboarding/prompts/proof/complete.md +3 -3
- package/onboarding/prompts/proof/oss-baseline.md +5 -5
- package/onboarding/prompts/proof/round-trip.md +8 -8
- package/onboarding/prompts/research/gather.md +5 -5
- package/onboarding/prompts/research/merge.md +2 -2
- package/onboarding/prompts/research/preflight.md +2 -2
- package/onboarding/prompts/research/route.md +5 -5
- package/onboarding/prompts/starter/clone.md +5 -5
- package/onboarding/prompts/stopped/run-failed.md +2 -2
- package/onboarding/prompts/subagent/create-plan.md +1 -1
- package/onboarding/prompts/subagent/inspect-repository.md +1 -1
- package/onboarding/prompts/subagent/prove-oss-baseline.md +1 -1
- package/onboarding/prompts/subagent/prove-round-trip.md +10 -10
- package/onboarding/prompts/unsupported/no-validated-path.md +2 -2
- package/package.json +1 -1
- package/release/release-tool.js +9 -5
|
@@ -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.
|
|
18
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
37
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
49
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
60
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
73
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
80
|
+
`npx --prefer-offline --yes copilotkit@4.21.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.
|
|
23
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
36
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
40
|
+
and `skipped` when the proof could not run. Then run `npx --prefer-offline --yes copilotkit@4.21.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.
|
|
55
|
+
npx --prefer-offline --yes copilotkit@4.21.0 onboard read feature/stop
|
|
56
56
|
```
|
|
57
57
|
|
|
58
58
|
When the audit passes, run
|
|
59
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
59
|
+
`npx --prefer-offline --yes copilotkit@4.21.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.
|
|
22
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
28
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
38
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
52
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
61
|
+
`/info`, `npx --prefer-offline --yes copilotkit@4.21.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.
|
|
67
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
74
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
96
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
103
|
+
Then run `npx --prefer-offline --yes copilotkit@4.21.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.
|
|
6
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
25
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
20
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
52
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
66
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
74
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
97
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
111
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
137
|
+
`npx --prefer-offline --yes copilotkit@4.21.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.
|
|
143
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
162
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
174
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
185
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
199
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
206
|
+
`npx --prefer-offline --yes copilotkit@4.21.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.
|
|
10
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
43
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
56
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
61
|
+
`npx --prefer-offline --yes copilotkit@4.21.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.
|
|
76
|
+
npx --prefer-offline --yes copilotkit@4.21.0 onboard read feature/stop
|
|
77
77
|
```
|
|
78
78
|
|
|
79
79
|
When the audit passes, run
|
|
80
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
80
|
+
`npx --prefer-offline --yes copilotkit@4.21.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.
|
|
23
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
29
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
39
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
69
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
90
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
104
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
111
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
143
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
150
|
+
Then run `npx --prefer-offline --yes copilotkit@4.21.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.
|
|
19
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
38
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
50
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
61
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
74
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
81
|
+
`npx --prefer-offline --yes copilotkit@4.21.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.
|
|
24
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
37
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
41
|
+
and `skipped` when the proof could not run. Then run `npx --prefer-offline --yes copilotkit@4.21.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.
|
|
56
|
+
npx --prefer-offline --yes copilotkit@4.21.0 onboard read feature/stop
|
|
57
57
|
```
|
|
58
58
|
|
|
59
59
|
When the audit passes, run
|
|
60
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
60
|
+
`npx --prefer-offline --yes copilotkit@4.21.0 onboard read feature/complete` with the outcome actually
|
|
61
61
|
observed.
|
|
@@ -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.
|
|
22
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
28
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
38
|
+
npx --prefer-offline --yes copilotkit@4.21.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.
|
|
52
|
+
npx --prefer-offline --yes copilotkit@4.21.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
|
|
@@ -59,20 +59,20 @@ approved authorization before implementation.
|
|
|
59
59
|
Before edits, have a research subagent identify the current CopilotKit runtime route,
|
|
60
60
|
provider/chat component, agent id, package versions, existing middleware, sandbox/CSP
|
|
61
61
|
constraints, and normal test/dev commands. Prove the existing app first with `/info`,
|
|
62
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
62
|
+
`npx --prefer-offline --yes copilotkit@4.21.0 verify --expect-runtime oss --round-trip --agent <agent-id> --json`,
|
|
63
63
|
and a real frontend request when browser control is available.
|
|
64
64
|
|
|
65
65
|
Wait for the inspection subagent to finish. Then report that the inspection came back:
|
|
66
66
|
|
|
67
67
|
```text
|
|
68
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
68
|
+
npx --prefer-offline --yes copilotkit@4.21.0 onboard checkpoint --phase research-returned
|
|
69
69
|
```
|
|
70
70
|
|
|
71
71
|
If the inspection did not prove the baseline this intent extends, stop here without
|
|
72
72
|
changing files:
|
|
73
73
|
|
|
74
74
|
```text
|
|
75
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
75
|
+
npx --prefer-offline --yes copilotkit@4.21.0 onboard read feature/stop
|
|
76
76
|
```
|
|
77
77
|
|
|
78
78
|
Do not sign in, select an Intelligence project, create credentials, change the existing
|
|
@@ -94,11 +94,11 @@ one.
|
|
|
94
94
|
After approval, record each approved path before implementation:
|
|
95
95
|
|
|
96
96
|
```text
|
|
97
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
97
|
+
npx --prefer-offline --yes copilotkit@4.21.0 onboard protect --authorize --path <path> --reason "<the plan's sentence>"
|
|
98
98
|
```
|
|
99
99
|
|
|
100
100
|
If an approved path changed after capture and no implementation step has run, add
|
|
101
101
|
`--with-prior-change`. Continue only when every result starts with `Status: passed`. Do not
|
|
102
102
|
authorize a path the approved plan did not list.
|
|
103
103
|
|
|
104
|
-
Then run `npx --prefer-offline --yes copilotkit@4.
|
|
104
|
+
Then run `npx --prefer-offline --yes copilotkit@4.21.0 onboard read feature/open-generative-ui/implement`.
|
|
@@ -17,14 +17,14 @@ non-zero on an app that is working. Pass what `identifyUser` reads with a repeat
|
|
|
17
17
|
It is not a defect to repair.
|
|
18
18
|
|
|
19
19
|
Run focused tests and
|
|
20
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
20
|
+
`npx --prefer-offline --yes copilotkit@4.21.0 verify --expect-runtime intelligence --round-trip --agent <agent-id> --json`.
|
|
21
21
|
Repair changed-file failures and record changed paths and secret-safe validation
|
|
22
22
|
evidence.
|
|
23
23
|
|
|
24
24
|
Before you spawn the implementation subagent, take the authorized list from the CLI:
|
|
25
25
|
|
|
26
26
|
```text
|
|
27
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
27
|
+
npx --prefer-offline --yes copilotkit@4.21.0 onboard audit
|
|
28
28
|
```
|
|
29
29
|
|
|
30
30
|
From its result, copy the paths under `Authorized to modify:`. A passed or failed audit with
|
|
@@ -43,7 +43,7 @@ still go on the record. Name the file and why the work needs it, then end your t
|
|
|
43
43
|
for the developer's answer. If they allow it, record their answer before any edit:
|
|
44
44
|
|
|
45
45
|
```text
|
|
46
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
46
|
+
npx --prefer-offline --yes copilotkit@4.21.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
|
|
47
47
|
```
|
|
48
48
|
|
|
49
49
|
Continue only when the result starts with `Status: passed`. Run the audit again, take the
|
|
@@ -55,7 +55,7 @@ feature stop route below.
|
|
|
55
55
|
After validation and each repair, run:
|
|
56
56
|
|
|
57
57
|
```text
|
|
58
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
58
|
+
npx --prefer-offline --yes copilotkit@4.21.0 onboard audit
|
|
59
59
|
```
|
|
60
60
|
|
|
61
61
|
Continue only when it starts with `Status: passed`. A path under `Authorized to modify:` is
|
|
@@ -66,7 +66,7 @@ with the implementation subagent's `Files changed` section. If that section does
|
|
|
66
66
|
the path, accept the developer's external change:
|
|
67
67
|
|
|
68
68
|
```text
|
|
69
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
69
|
+
npx --prefer-offline --yes copilotkit@4.21.0 onboard protect --accept-external --path <path>
|
|
70
70
|
```
|
|
71
71
|
|
|
72
72
|
For an env file where the developer placed a requested credential, use
|
|
@@ -79,11 +79,11 @@ Run the audit again after each accepted change. If it still fails, or starts
|
|
|
79
79
|
with `Status: blocked`, route out and stop:
|
|
80
80
|
|
|
81
81
|
```text
|
|
82
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
82
|
+
npx --prefer-offline --yes copilotkit@4.21.0 onboard read feature/stop
|
|
83
83
|
```
|
|
84
84
|
|
|
85
85
|
If validation cannot pass, or this intent needs a prerequisite the app does not have, use
|
|
86
86
|
the feature stop route above without further changes.
|
|
87
87
|
|
|
88
88
|
Otherwise run
|
|
89
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
89
|
+
`npx --prefer-offline --yes copilotkit@4.21.0 onboard read feature/realtime-sync/proof`.
|
|
@@ -23,7 +23,7 @@ still go on the record. Name the file and why the fix needs it, then end your tu
|
|
|
23
23
|
for the developer's answer. If they allow it, record their answer before any edit:
|
|
24
24
|
|
|
25
25
|
```text
|
|
26
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
26
|
+
npx --prefer-offline --yes copilotkit@4.21.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
|
|
27
27
|
```
|
|
28
28
|
|
|
29
29
|
Continue only when the result starts with `Status: passed`. Run the audit again, take the
|
|
@@ -36,11 +36,11 @@ Report the outcome of each attempt as it ends, before any repair. The command co
|
|
|
36
36
|
attempts and the repairs:
|
|
37
37
|
|
|
38
38
|
```text
|
|
39
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
39
|
+
npx --prefer-offline --yes copilotkit@4.21.0 onboard proof --step round-trip --outcome <passed|failed|skipped>
|
|
40
40
|
```
|
|
41
41
|
|
|
42
42
|
Use `passed` only for proved two-client sync, `failed` for an attempted proof that failed,
|
|
43
|
-
and `skipped` when the proof could not run. Then run `npx --prefer-offline --yes copilotkit@4.
|
|
43
|
+
and `skipped` when the proof could not run. Then run `npx --prefer-offline --yes copilotkit@4.21.0 onboard audit`.
|
|
44
44
|
Continue only when it starts with `Status: passed`.
|
|
45
45
|
|
|
46
46
|
If the audit fails, never repair, reset, or revert a protected path. Compare each named path
|
|
@@ -55,8 +55,8 @@ the path and the change the audit reports. Run the audit again after each accept
|
|
|
55
55
|
If the audit still fails, or starts with `Status: blocked`, route out and stop:
|
|
56
56
|
|
|
57
57
|
```text
|
|
58
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
58
|
+
npx --prefer-offline --yes copilotkit@4.21.0 onboard read feature/stop
|
|
59
59
|
```
|
|
60
60
|
|
|
61
61
|
When the audit passes, run
|
|
62
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
62
|
+
`npx --prefer-offline --yes copilotkit@4.21.0 onboard read feature/complete` with the actual outcome.
|