copilotkit 4.23.1 → 4.24.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 +91 -5
- package/cli-build-info.json +8 -8
- package/exporters/langgraph/README.md +33 -0
- package/exporters/langgraph/export_checkpointer.py +16 -0
- package/index.js +4380 -3586
- package/onboarding/index.json +2 -1
- package/onboarding/prompts/authenticate/start.md +15 -12
- package/onboarding/prompts/conversion/plan.md +3 -3
- package/onboarding/prompts/credentials/finalize-plan.md +8 -8
- package/onboarding/prompts/credentials/plan.md +23 -23
- package/onboarding/prompts/credentials/settle-credentials.md +14 -5
- package/onboarding/prompts/credentials/write-plan.md +6 -6
- package/onboarding/prompts/deployment/choose-local.md +24 -13
- package/onboarding/prompts/deployment/local-evaluation.md +31 -7
- package/onboarding/prompts/fallback/best-effort.md +8 -8
- package/onboarding/prompts/feature/a2ui/implement.md +6 -6
- package/onboarding/prompts/feature/a2ui/plan.md +4 -4
- package/onboarding/prompts/feature/a2ui/proof.md +5 -5
- package/onboarding/prompts/feature/a2ui/start.md +25 -8
- package/onboarding/prompts/feature/channels/implement.md +7 -7
- package/onboarding/prompts/feature/channels/plan.md +4 -4
- package/onboarding/prompts/feature/channels/proof.md +5 -5
- package/onboarding/prompts/feature/channels/start.md +23 -19
- package/onboarding/prompts/feature/chat-suggestions/implement.md +6 -6
- package/onboarding/prompts/feature/chat-suggestions/plan.md +4 -4
- package/onboarding/prompts/feature/chat-suggestions/proof.md +5 -5
- package/onboarding/prompts/feature/chat-suggestions/start.md +25 -8
- package/onboarding/prompts/feature/complete.md +2 -2
- package/onboarding/prompts/feature/learning/implement.md +13 -13
- package/onboarding/prompts/feature/learning/plan.md +4 -4
- package/onboarding/prompts/feature/learning/proof.md +49 -6
- package/onboarding/prompts/feature/learning/start.md +25 -8
- package/onboarding/prompts/feature/open-generative-ui/implement.md +6 -6
- package/onboarding/prompts/feature/open-generative-ui/plan.md +4 -4
- package/onboarding/prompts/feature/open-generative-ui/proof.md +5 -5
- package/onboarding/prompts/feature/open-generative-ui/start.md +25 -8
- package/onboarding/prompts/feature/realtime-sync/implement.md +7 -7
- package/onboarding/prompts/feature/realtime-sync/plan.md +4 -4
- package/onboarding/prompts/feature/realtime-sync/proof.md +5 -5
- package/onboarding/prompts/feature/realtime-sync/start.md +24 -7
- package/onboarding/prompts/feature/rich-threads/implement.md +8 -8
- package/onboarding/prompts/feature/rich-threads/plan.md +4 -4
- package/onboarding/prompts/feature/rich-threads/proof.md +5 -5
- package/onboarding/prompts/feature/rich-threads/start.md +24 -7
- package/onboarding/prompts/feature/stop.md +3 -3
- package/onboarding/prompts/feature/voice/implement.md +6 -6
- package/onboarding/prompts/feature/voice/plan.md +5 -5
- package/onboarding/prompts/feature/voice/proof.md +5 -5
- package/onboarding/prompts/feature/voice/start.md +25 -8
- package/onboarding/prompts/framework/ag2.md +2 -2
- package/onboarding/prompts/framework/agno.md +2 -2
- package/onboarding/prompts/framework/built-in.md +2 -2
- package/onboarding/prompts/framework/claude-sdk-python.md +2 -2
- package/onboarding/prompts/framework/claude-sdk-typescript.md +2 -2
- package/onboarding/prompts/framework/crewai-flows.md +2 -2
- package/onboarding/prompts/framework/custom-ag-ui.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 +16 -14
- 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 +92 -7
- package/onboarding/prompts/stopped/run-failed.md +2 -2
- package/onboarding/prompts/subagent/create-plan.md +2 -2
- package/onboarding/prompts/subagent/implement-and-validate.md +2 -2
- 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 +8 -6
- package/onboarding/prompts/unsupported/no-validated-path.md +2 -2
- package/package.json +1 -1
- package/release/release-tool.js +12 -1
- package/services/local-auth-worker.js +175 -159
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
Delegate implementation to one subagent with the approved plan and fetched official guides.
|
|
4
4
|
If repository evidence does not prove an existing valid Intelligence selection, run
|
|
5
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
5
|
+
`npx --prefer-offline --yes copilotkit@4.24.0 login --json` and follow its single streaming session. Then
|
|
6
6
|
list projects, show the developer the current/recent choices, and select or create one only
|
|
7
7
|
after they choose. Require the secret-safe selection summary to confirm the project file,
|
|
8
8
|
environment file, and key provisioning; never display a key. If existing configuration is
|
|
@@ -20,14 +20,14 @@ non-zero on an app that is working. Pass what `identifyUser` reads with a repeat
|
|
|
20
20
|
It is not a defect to repair.
|
|
21
21
|
|
|
22
22
|
Run focused type/test commands, then start the app and run
|
|
23
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
23
|
+
`npx --prefer-offline --yes copilotkit@4.24.0 verify --expect-runtime intelligence --round-trip --agent <agent-id> --json`.
|
|
24
24
|
Repair changed-file failures before continuing. Record changed paths and secret-safe
|
|
25
25
|
validation evidence.
|
|
26
26
|
|
|
27
27
|
Before you spawn the implementation subagent, take the authorized list from the CLI:
|
|
28
28
|
|
|
29
29
|
```text
|
|
30
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
30
|
+
npx --prefer-offline --yes copilotkit@4.24.0 onboard audit
|
|
31
31
|
```
|
|
32
32
|
|
|
33
33
|
From its result, copy the paths under `Authorized to modify:`. A passed or failed audit with
|
|
@@ -46,7 +46,7 @@ still go on the record. Name the file and why the work needs it, then end your t
|
|
|
46
46
|
for the developer's answer. If they allow it, record their answer before any edit:
|
|
47
47
|
|
|
48
48
|
```text
|
|
49
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
49
|
+
npx --prefer-offline --yes copilotkit@4.24.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
|
|
50
50
|
```
|
|
51
51
|
|
|
52
52
|
Continue only when the result starts with `Status: passed`. Run the audit again, take the
|
|
@@ -58,7 +58,7 @@ feature stop route below.
|
|
|
58
58
|
After validation and each repair, run:
|
|
59
59
|
|
|
60
60
|
```text
|
|
61
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
61
|
+
npx --prefer-offline --yes copilotkit@4.24.0 onboard audit
|
|
62
62
|
```
|
|
63
63
|
|
|
64
64
|
Continue only when it starts with `Status: passed`. A path under `Authorized to modify:` is
|
|
@@ -69,7 +69,7 @@ with the implementation subagent's `Files changed` section. If that section does
|
|
|
69
69
|
the path, accept the developer's external change:
|
|
70
70
|
|
|
71
71
|
```text
|
|
72
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
72
|
+
npx --prefer-offline --yes copilotkit@4.24.0 onboard protect --accept-external --path <path>
|
|
73
73
|
```
|
|
74
74
|
|
|
75
75
|
For an env file where the developer placed a requested credential, use
|
|
@@ -82,11 +82,11 @@ Run the audit again after each accepted change. If it still fails, or starts
|
|
|
82
82
|
with `Status: blocked`, route out and stop:
|
|
83
83
|
|
|
84
84
|
```text
|
|
85
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
85
|
+
npx --prefer-offline --yes copilotkit@4.24.0 onboard read feature/stop
|
|
86
86
|
```
|
|
87
87
|
|
|
88
88
|
If validation cannot pass, or this intent needs a prerequisite the app does not have, use
|
|
89
89
|
the feature stop route above without further changes.
|
|
90
90
|
|
|
91
91
|
Otherwise run
|
|
92
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
92
|
+
`npx --prefer-offline --yes copilotkit@4.24.0 onboard read feature/rich-threads/proof`.
|
|
@@ -12,7 +12,7 @@ The approval is a wait for the developer. Before you end your turn to wait, repo
|
|
|
12
12
|
pause:
|
|
13
13
|
|
|
14
14
|
```text
|
|
15
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
15
|
+
npx --prefer-offline --yes copilotkit@4.24.0 onboard checkpoint --phase awaiting-developer
|
|
16
16
|
```
|
|
17
17
|
|
|
18
18
|
A turn that ends while the run waits is a pause, not a stop, even when your harness ends it.
|
|
@@ -34,7 +34,7 @@ you plan. Run `onboard protect` again from the target app directory: on the same
|
|
|
34
34
|
prints the baseline the run already holds.
|
|
35
35
|
|
|
36
36
|
```text
|
|
37
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
37
|
+
npx --prefer-offline --yes copilotkit@4.24.0 onboard protect
|
|
38
38
|
```
|
|
39
39
|
|
|
40
40
|
Then have one read-only subagent repeat the inspection for the findings above, and wait
|
|
@@ -67,11 +67,11 @@ one.
|
|
|
67
67
|
After approval, record each approved path before implementation:
|
|
68
68
|
|
|
69
69
|
```text
|
|
70
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
70
|
+
npx --prefer-offline --yes copilotkit@4.24.0 onboard protect --authorize --path <path> --reason "<the plan's sentence>"
|
|
71
71
|
```
|
|
72
72
|
|
|
73
73
|
If an approved path changed after capture and no implementation step has run, add
|
|
74
74
|
`--with-prior-change`. Continue only when every result starts with `Status: passed`. Do not
|
|
75
75
|
authorize a path the approved plan did not list.
|
|
76
76
|
|
|
77
|
-
Then run `npx --prefer-offline --yes copilotkit@4.
|
|
77
|
+
Then run `npx --prefer-offline --yes copilotkit@4.24.0 onboard read feature/rich-threads/implement`.
|
|
@@ -22,7 +22,7 @@ still go on the record. Name the file and why the fix needs it, then end your tu
|
|
|
22
22
|
for the developer's answer. If they allow it, record their answer before any edit:
|
|
23
23
|
|
|
24
24
|
```text
|
|
25
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
25
|
+
npx --prefer-offline --yes copilotkit@4.24.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
|
|
26
26
|
```
|
|
27
27
|
|
|
28
28
|
Continue only when the result starts with `Status: passed`. Run the audit again, take the
|
|
@@ -35,12 +35,12 @@ Report the outcome of each attempt as it ends, before any repair. The command co
|
|
|
35
35
|
attempts and the repairs:
|
|
36
36
|
|
|
37
37
|
```text
|
|
38
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
38
|
+
npx --prefer-offline --yes copilotkit@4.24.0 onboard proof --step round-trip --outcome <passed|failed|skipped>
|
|
39
39
|
```
|
|
40
40
|
|
|
41
41
|
Use `passed` only for proved persistence and reopen, `failed` for an attempted proof that
|
|
42
42
|
failed, and `skipped` when the proof could not run. Then run
|
|
43
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
43
|
+
`npx --prefer-offline --yes copilotkit@4.24.0 onboard audit`. Continue only when it starts with
|
|
44
44
|
`Status: passed`.
|
|
45
45
|
|
|
46
46
|
If the audit fails, never repair, reset, or revert a protected path. Compare each named path
|
|
@@ -55,9 +55,9 @@ 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.24.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.24.0 onboard read feature/complete` with the actual browser
|
|
63
63
|
outcome.
|
|
@@ -4,6 +4,23 @@ Treat Rich Threads as a managed Intelligence feature layered onto the existing a
|
|
|
4
4
|
reason to replace its agent or chat. Act as the orchestrator and delegate inspection,
|
|
5
5
|
implementation, and proof to separate subagents within the target project.
|
|
6
6
|
|
|
7
|
+
## First, say which coding agent you are
|
|
8
|
+
|
|
9
|
+
Run this before anything else in this prompt:
|
|
10
|
+
|
|
11
|
+
```text
|
|
12
|
+
npx --prefer-offline --yes copilotkit@4.24.0 onboard identify --coding-agent <coding-agent-slug> --model <model-id> --model-family <model-family>
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
Report your product slug, such as `codex` or `claude-code`. The command needs no sign-in,
|
|
16
|
+
browser, or project. If this run already ran `onboard identify`, skip this step.
|
|
17
|
+
|
|
18
|
+
- `--model`: copy the model id exactly as your instructions write it. If they name no
|
|
19
|
+
exact model id, leave out `--model` rather than guess.
|
|
20
|
+
- `--model-family`: your model's family, such as `claude-opus` or `gpt-5`. Give it even
|
|
21
|
+
without `--model`, and leave out `--model-family` if you do not know it.
|
|
22
|
+
- Never give your product slug as a model or a family.
|
|
23
|
+
|
|
7
24
|
## Waits, stops, and subagents
|
|
8
25
|
|
|
9
26
|
A run that starts here has not read these rules yet, so they come first. They cover this
|
|
@@ -20,13 +37,13 @@ carry on. Keep a read-only assignment read-only. If no subagent works at all, re
|
|
|
20
37
|
once:
|
|
21
38
|
|
|
22
39
|
```text
|
|
23
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
40
|
+
npx --prefer-offline --yes copilotkit@4.24.0 onboard checkpoint --phase delegation-unavailable
|
|
24
41
|
```
|
|
25
42
|
|
|
26
43
|
Before you end your turn to wait for the developer, report the pause:
|
|
27
44
|
|
|
28
45
|
```text
|
|
29
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
46
|
+
npx --prefer-offline --yes copilotkit@4.24.0 onboard checkpoint --phase awaiting-developer
|
|
30
47
|
```
|
|
31
48
|
|
|
32
49
|
A turn that ends while the run waits is a pause, not a stop, even when your harness ends it.
|
|
@@ -36,7 +53,7 @@ If you stop this run, send one short report before you stop. The friction comman
|
|
|
36
53
|
the telemetry setting the developer already chose, so it needs no separate question.
|
|
37
54
|
|
|
38
55
|
```text
|
|
39
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
56
|
+
npx --prefer-offline --yes copilotkit@4.24.0 onboard friction --phase stop --category <slug> --message "<sentences>"
|
|
40
57
|
```
|
|
41
58
|
|
|
42
59
|
`--message` takes one or two sentences: the step you stopped at and what stopped it.
|
|
@@ -50,7 +67,7 @@ one scoped fix, and sends the report itself when no fix is approved.
|
|
|
50
67
|
Before any subagent or project process runs, capture the developer's existing work:
|
|
51
68
|
|
|
52
69
|
```text
|
|
53
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
70
|
+
npx --prefer-offline --yes copilotkit@4.24.0 onboard protect
|
|
54
71
|
```
|
|
55
72
|
|
|
56
73
|
Keep the exact protected path list it prints and give that list to every subagent. No
|
|
@@ -65,20 +82,20 @@ the current frontend-to-runtime-to-agent round trip and inspect `/info`.
|
|
|
65
82
|
Wait for the inspection subagent to finish. Then report that the inspection came back:
|
|
66
83
|
|
|
67
84
|
```text
|
|
68
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
85
|
+
npx --prefer-offline --yes copilotkit@4.24.0 onboard checkpoint --phase research-returned
|
|
69
86
|
```
|
|
70
87
|
|
|
71
88
|
If the inspection did not prove the baseline this intent extends, stop here without
|
|
72
89
|
changing files:
|
|
73
90
|
|
|
74
91
|
```text
|
|
75
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
92
|
+
npx --prefer-offline --yes copilotkit@4.24.0 onboard read feature/stop
|
|
76
93
|
```
|
|
77
94
|
|
|
78
95
|
When the inspection proved what this intent needs, read the next prompt now, in this turn:
|
|
79
96
|
|
|
80
97
|
```text
|
|
81
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
98
|
+
npx --prefer-offline --yes copilotkit@4.24.0 onboard read feature/rich-threads/plan
|
|
82
99
|
```
|
|
83
100
|
|
|
84
101
|
That prompt holds the plan, the developer's approval, and the paths the plan changes.
|
|
@@ -20,7 +20,7 @@ a `start` with no `--run` reprints the id this stopped run already holds, and on
|
|
|
20
20
|
covering both reads as one run that did two different things.
|
|
21
21
|
|
|
22
22
|
```text
|
|
23
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
23
|
+
npx --prefer-offline --yes copilotkit@4.24.0 onboard start --run <new-12-character-id>
|
|
24
24
|
```
|
|
25
25
|
|
|
26
26
|
Do not read a generic onboarding node from this run. A feature run and a generic run are
|
|
@@ -48,7 +48,7 @@ put to them, stop here and send the report below.
|
|
|
48
48
|
If they approve it, make that one fix and nothing else. Then come back into this run:
|
|
49
49
|
|
|
50
50
|
```text
|
|
51
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
51
|
+
npx --prefer-offline --yes copilotkit@4.24.0 onboard resume --message "<approval>"
|
|
52
52
|
```
|
|
53
53
|
|
|
54
54
|
Put the developer's approval in `--message`, in one or two sentences: the fix they
|
|
@@ -69,7 +69,7 @@ Send one short report. The friction command follows the telemetry setting the de
|
|
|
69
69
|
already chose, so it needs no separate question.
|
|
70
70
|
|
|
71
71
|
```text
|
|
72
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
72
|
+
npx --prefer-offline --yes copilotkit@4.24.0 onboard friction --phase stop --category <slug> --message "<sentences>"
|
|
73
73
|
```
|
|
74
74
|
|
|
75
75
|
`--message` takes one or two sentences: the step you stopped at and what stopped it.
|
|
@@ -14,7 +14,7 @@ voice proof. Record changed paths and validation results.
|
|
|
14
14
|
Before you spawn the implementation subagent, take the authorized list from the CLI:
|
|
15
15
|
|
|
16
16
|
```text
|
|
17
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
17
|
+
npx --prefer-offline --yes copilotkit@4.24.0 onboard audit
|
|
18
18
|
```
|
|
19
19
|
|
|
20
20
|
From its result, copy the paths under `Authorized to modify:`. A passed or failed audit with
|
|
@@ -33,7 +33,7 @@ still go on the record. Name the file and why the work needs it, then end your t
|
|
|
33
33
|
for the developer's answer. If they allow it, record their answer before any edit:
|
|
34
34
|
|
|
35
35
|
```text
|
|
36
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
36
|
+
npx --prefer-offline --yes copilotkit@4.24.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
|
|
37
37
|
```
|
|
38
38
|
|
|
39
39
|
Continue only when the result starts with `Status: passed`. Run the audit again, take the
|
|
@@ -45,7 +45,7 @@ feature stop route below.
|
|
|
45
45
|
After validation and each repair, run:
|
|
46
46
|
|
|
47
47
|
```text
|
|
48
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
48
|
+
npx --prefer-offline --yes copilotkit@4.24.0 onboard audit
|
|
49
49
|
```
|
|
50
50
|
|
|
51
51
|
Continue only when it starts with `Status: passed`. A path under `Authorized to modify:` is
|
|
@@ -56,7 +56,7 @@ with the implementation subagent's `Files changed` section. If that section does
|
|
|
56
56
|
the path, accept the developer's external change:
|
|
57
57
|
|
|
58
58
|
```text
|
|
59
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
59
|
+
npx --prefer-offline --yes copilotkit@4.24.0 onboard protect --accept-external --path <path>
|
|
60
60
|
```
|
|
61
61
|
|
|
62
62
|
For an env file where the developer placed a requested credential, use
|
|
@@ -69,11 +69,11 @@ Run the audit again after each accepted change. If it still fails, or starts
|
|
|
69
69
|
with `Status: blocked`, route out and stop:
|
|
70
70
|
|
|
71
71
|
```text
|
|
72
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
72
|
+
npx --prefer-offline --yes copilotkit@4.24.0 onboard read feature/stop
|
|
73
73
|
```
|
|
74
74
|
|
|
75
75
|
If validation cannot pass, or this intent needs a prerequisite the app does not have, use
|
|
76
76
|
the feature stop route above without further changes.
|
|
77
77
|
|
|
78
78
|
Otherwise run
|
|
79
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
79
|
+
`npx --prefer-offline --yes copilotkit@4.24.0 onboard read feature/voice/proof`.
|
|
@@ -12,7 +12,7 @@ The approval is a wait for the developer. Before you end your turn to wait, repo
|
|
|
12
12
|
pause:
|
|
13
13
|
|
|
14
14
|
```text
|
|
15
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
15
|
+
npx --prefer-offline --yes copilotkit@4.24.0 onboard checkpoint --phase awaiting-developer
|
|
16
16
|
```
|
|
17
17
|
|
|
18
18
|
A turn that ends while the run waits is a pause, not a stop, even when your harness ends it.
|
|
@@ -34,7 +34,7 @@ you plan. Run `onboard protect` again from the target app directory: on the same
|
|
|
34
34
|
prints the baseline the run already holds.
|
|
35
35
|
|
|
36
36
|
```text
|
|
37
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
37
|
+
npx --prefer-offline --yes copilotkit@4.24.0 onboard protect
|
|
38
38
|
```
|
|
39
39
|
|
|
40
40
|
Then have one read-only subagent repeat the inspection for the findings above, and wait
|
|
@@ -50,7 +50,7 @@ the repository proves its variable name is configured. Otherwise, explain the se
|
|
|
50
50
|
take the feature stop route rather than writing a placeholder:
|
|
51
51
|
|
|
52
52
|
```text
|
|
53
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
53
|
+
npx --prefer-offline --yes copilotkit@4.24.0 onboard read feature/stop
|
|
54
54
|
```
|
|
55
55
|
|
|
56
56
|
Show a small plan for the documented transcription service, the existing composer, focused
|
|
@@ -64,11 +64,11 @@ one.
|
|
|
64
64
|
After approval, record each approved path before implementation:
|
|
65
65
|
|
|
66
66
|
```text
|
|
67
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
67
|
+
npx --prefer-offline --yes copilotkit@4.24.0 onboard protect --authorize --path <path> --reason "<the plan's sentence>"
|
|
68
68
|
```
|
|
69
69
|
|
|
70
70
|
If an approved path changed after capture and no implementation step has run, add
|
|
71
71
|
`--with-prior-change`. Continue only when every result starts with `Status: passed`. Do not
|
|
72
72
|
authorize a path the approved plan did not list.
|
|
73
73
|
|
|
74
|
-
Then run `npx --prefer-offline --yes copilotkit@4.
|
|
74
|
+
Then run `npx --prefer-offline --yes copilotkit@4.24.0 onboard read feature/voice/implement`.
|
|
@@ -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.24.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.24.0 onboard proof --step round-trip --outcome <passed|failed|skipped>
|
|
38
38
|
```
|
|
39
39
|
|
|
40
40
|
Use `passed` only for proved voice input, `failed` for an attempted proof that failed, and
|
|
41
|
-
`skipped` when the proof could not run. Then run `npx --prefer-offline --yes copilotkit@4.
|
|
41
|
+
`skipped` when the proof could not run. Then run `npx --prefer-offline --yes copilotkit@4.24.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.24.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.24.0 onboard read feature/complete` with the actual surface
|
|
61
61
|
outcome.
|
|
@@ -3,6 +3,23 @@
|
|
|
3
3
|
Treat voice as an OSS enhancement to an existing CopilotKit chat. Orchestrate with separate
|
|
4
4
|
read-only, implementation, and proof subagents, each restricted to the target project.
|
|
5
5
|
|
|
6
|
+
## First, say which coding agent you are
|
|
7
|
+
|
|
8
|
+
Run this before anything else in this prompt:
|
|
9
|
+
|
|
10
|
+
```text
|
|
11
|
+
npx --prefer-offline --yes copilotkit@4.24.0 onboard identify --coding-agent <coding-agent-slug> --model <model-id> --model-family <model-family>
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
Report your product slug, such as `codex` or `claude-code`. The command needs no sign-in,
|
|
15
|
+
browser, or project. If this run already ran `onboard identify`, skip this step.
|
|
16
|
+
|
|
17
|
+
- `--model`: copy the model id exactly as your instructions write it. If they name no
|
|
18
|
+
exact model id, leave out `--model` rather than guess.
|
|
19
|
+
- `--model-family`: your model's family, such as `claude-opus` or `gpt-5`. Give it even
|
|
20
|
+
without `--model`, and leave out `--model-family` if you do not know it.
|
|
21
|
+
- Never give your product slug as a model or a family.
|
|
22
|
+
|
|
6
23
|
## Waits, stops, and subagents
|
|
7
24
|
|
|
8
25
|
A run that starts here has not read these rules yet, so they come first. They cover this
|
|
@@ -19,13 +36,13 @@ carry on. Keep a read-only assignment read-only. If no subagent works at all, re
|
|
|
19
36
|
once:
|
|
20
37
|
|
|
21
38
|
```text
|
|
22
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
39
|
+
npx --prefer-offline --yes copilotkit@4.24.0 onboard checkpoint --phase delegation-unavailable
|
|
23
40
|
```
|
|
24
41
|
|
|
25
42
|
Before you end your turn to wait for the developer, report the pause:
|
|
26
43
|
|
|
27
44
|
```text
|
|
28
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
45
|
+
npx --prefer-offline --yes copilotkit@4.24.0 onboard checkpoint --phase awaiting-developer
|
|
29
46
|
```
|
|
30
47
|
|
|
31
48
|
A turn that ends while the run waits is a pause, not a stop, even when your harness ends it.
|
|
@@ -35,7 +52,7 @@ If you stop this run, send one short report before you stop. The friction comman
|
|
|
35
52
|
the telemetry setting the developer already chose, so it needs no separate question.
|
|
36
53
|
|
|
37
54
|
```text
|
|
38
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
55
|
+
npx --prefer-offline --yes copilotkit@4.24.0 onboard friction --phase stop --category <slug> --message "<sentences>"
|
|
39
56
|
```
|
|
40
57
|
|
|
41
58
|
`--message` takes one or two sentences: the step you stopped at and what stopped it.
|
|
@@ -49,7 +66,7 @@ one scoped fix, and sends the report itself when no fix is approved.
|
|
|
49
66
|
Before any subagent or project process runs, capture the developer's existing work:
|
|
50
67
|
|
|
51
68
|
```text
|
|
52
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
69
|
+
npx --prefer-offline --yes copilotkit@4.24.0 onboard protect
|
|
53
70
|
```
|
|
54
71
|
|
|
55
72
|
Keep the exact protected path list it prints and give that list to every subagent. No
|
|
@@ -59,26 +76,26 @@ approved authorization before implementation.
|
|
|
59
76
|
Before edits, inspect the runtime route, CopilotKit provider/chat composer, current agent,
|
|
60
77
|
existing provider credential variable names (presence only), package versions, browser
|
|
61
78
|
permissions approach, and test/dev commands. Prove the existing OSS baseline with `/info`,
|
|
62
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
79
|
+
`npx --prefer-offline --yes copilotkit@4.24.0 verify --expect-runtime oss --round-trip --agent <agent-id> --json`,
|
|
63
80
|
and a real UI request when a browser is available.
|
|
64
81
|
|
|
65
82
|
Wait for the inspection subagent to finish. Then report that the inspection came back:
|
|
66
83
|
|
|
67
84
|
```text
|
|
68
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
85
|
+
npx --prefer-offline --yes copilotkit@4.24.0 onboard checkpoint --phase research-returned
|
|
69
86
|
```
|
|
70
87
|
|
|
71
88
|
If the inspection did not prove the baseline this intent extends, stop here without
|
|
72
89
|
changing files:
|
|
73
90
|
|
|
74
91
|
```text
|
|
75
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
92
|
+
npx --prefer-offline --yes copilotkit@4.24.0 onboard read feature/stop
|
|
76
93
|
```
|
|
77
94
|
|
|
78
95
|
When the inspection proved what this intent needs, read the next prompt now, in this turn:
|
|
79
96
|
|
|
80
97
|
```text
|
|
81
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
98
|
+
npx --prefer-offline --yes copilotkit@4.24.0 onboard read feature/voice/plan
|
|
82
99
|
```
|
|
83
100
|
|
|
84
101
|
That prompt holds the plan, the developer's approval, and the paths the plan changes.
|
|
@@ -31,7 +31,7 @@ Record the selected framework, vendor, model, required credential variable names
|
|
|
31
31
|
URLs, and the A2UI documentation gap.
|
|
32
32
|
|
|
33
33
|
If the pages support the selection, run
|
|
34
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
34
|
+
`npx --prefer-offline --yes copilotkit@4.24.0 onboard read frontend/plan`.
|
|
35
35
|
|
|
36
36
|
If the documentation does not support the selection, run
|
|
37
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
37
|
+
`npx --prefer-offline --yes copilotkit@4.24.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 the context documentation gap.
|
|
35
35
|
|
|
36
36
|
If the pages support the selection, run
|
|
37
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
37
|
+
`npx --prefer-offline --yes copilotkit@4.24.0 onboard read frontend/plan`.
|
|
38
38
|
|
|
39
39
|
If the documentation does not support the selection, run
|
|
40
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
40
|
+
`npx --prefer-offline --yes copilotkit@4.24.0 onboard read unsupported/no-validated-path`.
|
|
@@ -29,7 +29,7 @@ Record the selected framework, vendor, model, required credential variable names
|
|
|
29
29
|
these URLs.
|
|
30
30
|
|
|
31
31
|
If the pages support the selection, run
|
|
32
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
32
|
+
`npx --prefer-offline --yes copilotkit@4.24.0 onboard read frontend/plan`.
|
|
33
33
|
|
|
34
34
|
If the documentation does not support the selection, run
|
|
35
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
35
|
+
`npx --prefer-offline --yes copilotkit@4.24.0 onboard read unsupported/no-validated-path`.
|
|
@@ -34,7 +34,7 @@ Record the selected framework, vendor, model, required credential variable names
|
|
|
34
34
|
these URLs.
|
|
35
35
|
|
|
36
36
|
If the pages support the selection, run
|
|
37
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
37
|
+
`npx --prefer-offline --yes copilotkit@4.24.0 onboard read frontend/plan`.
|
|
38
38
|
|
|
39
39
|
If the documentation does not support the selection, run
|
|
40
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
40
|
+
`npx --prefer-offline --yes copilotkit@4.24.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 --prefer-offline --yes copilotkit@4.
|
|
40
|
+
`npx --prefer-offline --yes copilotkit@4.24.0 onboard read frontend/plan`.
|
|
41
41
|
|
|
42
42
|
If the documentation does not support the selection, run
|
|
43
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
43
|
+
`npx --prefer-offline --yes copilotkit@4.24.0 onboard read unsupported/no-validated-path`.
|
|
@@ -62,7 +62,7 @@ Record the selected framework, project-defined provider and model, the credentia
|
|
|
62
62
|
variable names the repository proves or the developer named, these URLs, and the adapter.
|
|
63
63
|
|
|
64
64
|
If the pages support the selection, run
|
|
65
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
65
|
+
`npx --prefer-offline --yes copilotkit@4.24.0 onboard read frontend/plan`.
|
|
66
66
|
|
|
67
67
|
If the documentation does not support the selection, run
|
|
68
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
68
|
+
`npx --prefer-offline --yes copilotkit@4.24.0 onboard read unsupported/no-validated-path`.
|
|
@@ -95,7 +95,7 @@ credential variable names that the agent already uses, the `clone()` finding, an
|
|
|
95
95
|
URLs.
|
|
96
96
|
|
|
97
97
|
If the pages support the selection, run
|
|
98
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
98
|
+
`npx --prefer-offline --yes copilotkit@4.24.0 onboard read frontend/plan`.
|
|
99
99
|
|
|
100
100
|
If the documentation does not support the selection, run
|
|
101
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
101
|
+
`npx --prefer-offline --yes copilotkit@4.24.0 onboard read unsupported/no-validated-path`.
|
|
@@ -33,7 +33,7 @@ Record the selected framework, language, vendor, model, required credential vari
|
|
|
33
33
|
names, these URLs, and each documentation gap.
|
|
34
34
|
|
|
35
35
|
If the pages support the selection, run
|
|
36
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
36
|
+
`npx --prefer-offline --yes copilotkit@4.24.0 onboard read frontend/plan`.
|
|
37
37
|
|
|
38
38
|
If the documentation does not support the selection, run
|
|
39
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
39
|
+
`npx --prefer-offline --yes copilotkit@4.24.0 onboard read unsupported/no-validated-path`.
|
|
@@ -30,7 +30,7 @@ Record the selected framework, vendor, model, required credential variable names
|
|
|
30
30
|
these URLs.
|
|
31
31
|
|
|
32
32
|
If the pages support the selection, run
|
|
33
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
33
|
+
`npx --prefer-offline --yes copilotkit@4.24.0 onboard read frontend/plan`.
|
|
34
34
|
|
|
35
35
|
If the documentation does not support the selection, run
|
|
36
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
36
|
+
`npx --prefer-offline --yes copilotkit@4.24.0 onboard read unsupported/no-validated-path`.
|
|
@@ -25,7 +25,7 @@ Record the selected framework, vendor, model, required credential variable names
|
|
|
25
25
|
these URLs.
|
|
26
26
|
|
|
27
27
|
If the pages support the selection, run
|
|
28
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
28
|
+
`npx --prefer-offline --yes copilotkit@4.24.0 onboard read frontend/plan`.
|
|
29
29
|
|
|
30
30
|
If the documentation does not support the selection, run
|
|
31
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
31
|
+
`npx --prefer-offline --yes copilotkit@4.24.0 onboard read unsupported/no-validated-path`.
|
|
@@ -19,7 +19,7 @@ Record the selected framework, vendor, model, required credential variable names
|
|
|
19
19
|
these URLs.
|
|
20
20
|
|
|
21
21
|
If the pages support the selection, run
|
|
22
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
22
|
+
`npx --prefer-offline --yes copilotkit@4.24.0 onboard read frontend/plan`.
|
|
23
23
|
|
|
24
24
|
If the documentation does not support the selection, run
|
|
25
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
25
|
+
`npx --prefer-offline --yes copilotkit@4.24.0 onboard read unsupported/no-validated-path`.
|
|
@@ -19,7 +19,7 @@ Record the selected framework, vendor, model, required credential variable names
|
|
|
19
19
|
these URLs.
|
|
20
20
|
|
|
21
21
|
If the pages support the selection, run
|
|
22
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
22
|
+
`npx --prefer-offline --yes copilotkit@4.24.0 onboard read frontend/plan`.
|
|
23
23
|
|
|
24
24
|
If the documentation does not support the selection, run
|
|
25
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
25
|
+
`npx --prefer-offline --yes copilotkit@4.24.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 --prefer-offline --yes copilotkit@4.
|
|
37
|
+
`npx --prefer-offline --yes copilotkit@4.24.0 onboard read frontend/plan`.
|
|
38
38
|
|
|
39
39
|
If the documentation does not support the selection, run
|
|
40
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
40
|
+
`npx --prefer-offline --yes copilotkit@4.24.0 onboard read unsupported/no-validated-path`.
|
|
@@ -47,7 +47,7 @@ Record the selected framework, vendor, model, required credential variable names
|
|
|
47
47
|
these URLs.
|
|
48
48
|
|
|
49
49
|
If the pages support the selection, run
|
|
50
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
50
|
+
`npx --prefer-offline --yes copilotkit@4.24.0 onboard read frontend/plan`.
|
|
51
51
|
|
|
52
52
|
If the documentation does not support the selection, run
|
|
53
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
53
|
+
`npx --prefer-offline --yes copilotkit@4.24.0 onboard read unsupported/no-validated-path`.
|
|
@@ -15,7 +15,7 @@ Run `dotnet --version` before you change the project. If it fails, no .NET SDK i
|
|
|
15
15
|
shell's PATH. Do not change the project, and do not install the SDK yourself. Tell the
|
|
16
16
|
developer to install the .NET SDK from https://dotnet.microsoft.com/download. Say that the
|
|
17
17
|
coding agent's shell cannot see a new install until the developer restarts the coding
|
|
18
|
-
agent. Give them `npx --prefer-offline --yes copilotkit@4.
|
|
18
|
+
agent. Give them `npx --prefer-offline --yes copilotkit@4.24.0 onboard start --run <onboarding_run_id>`
|
|
19
19
|
to resume the run after the restart. Then end your turn and wait for the developer.
|
|
20
20
|
|
|
21
21
|
## Documentation
|
|
@@ -41,7 +41,7 @@ Record the selected framework, provider, model, required credential variable nam
|
|
|
41
41
|
these URLs.
|
|
42
42
|
|
|
43
43
|
If the pages support the selection, run
|
|
44
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
44
|
+
`npx --prefer-offline --yes copilotkit@4.24.0 onboard read frontend/plan`.
|
|
45
45
|
|
|
46
46
|
If the documentation does not support the selection, run
|
|
47
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
47
|
+
`npx --prefer-offline --yes copilotkit@4.24.0 onboard read unsupported/no-validated-path`.
|