copilotkit 4.15.0 → 4.16.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 +49 -6
- package/cli-build-info.json +8 -8
- package/index.js +22447 -2987
- package/onboarding/index.json +1 -1
- 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 +21 -21
- package/onboarding/prompts/credentials/settle-credentials.md +9 -9
- package/onboarding/prompts/credentials/write-plan.md +5 -5
- package/onboarding/prompts/fallback/best-effort.md +6 -6
- package/onboarding/prompts/feature/a2ui/implement.md +6 -6
- package/onboarding/prompts/feature/a2ui/proof.md +6 -6
- package/onboarding/prompts/feature/a2ui/start.md +7 -7
- package/onboarding/prompts/feature/channels/implement.md +7 -7
- package/onboarding/prompts/feature/channels/proof.md +6 -6
- package/onboarding/prompts/feature/channels/start.md +7 -7
- package/onboarding/prompts/feature/chat-suggestions/implement.md +6 -6
- package/onboarding/prompts/feature/chat-suggestions/proof.md +6 -6
- package/onboarding/prompts/feature/chat-suggestions/start.md +7 -7
- package/onboarding/prompts/feature/complete.md +2 -2
- package/onboarding/prompts/feature/learning/implement.md +15 -15
- package/onboarding/prompts/feature/learning/proof.md +7 -7
- package/onboarding/prompts/feature/learning/start.md +8 -8
- package/onboarding/prompts/feature/open-generative-ui/implement.md +6 -6
- package/onboarding/prompts/feature/open-generative-ui/proof.md +6 -6
- package/onboarding/prompts/feature/open-generative-ui/start.md +7 -7
- package/onboarding/prompts/feature/realtime-sync/implement.md +7 -7
- package/onboarding/prompts/feature/realtime-sync/proof.md +6 -6
- package/onboarding/prompts/feature/realtime-sync/start.md +6 -6
- package/onboarding/prompts/feature/rich-threads/implement.md +8 -8
- package/onboarding/prompts/feature/rich-threads/proof.md +6 -6
- package/onboarding/prompts/feature/rich-threads/start.md +6 -6
- package/onboarding/prompts/feature/stop.md +3 -3
- package/onboarding/prompts/feature/voice/implement.md +6 -6
- package/onboarding/prompts/feature/voice/proof.md +6 -6
- package/onboarding/prompts/feature/voice/start.md +7 -7
- package/onboarding/prompts/framework/ag2.md +2 -2
- package/onboarding/prompts/framework/agno.md +2 -2
- package/onboarding/prompts/framework/built-in.md +2 -2
- package/onboarding/prompts/framework/claude-sdk-python.md +2 -2
- package/onboarding/prompts/framework/claude-sdk-typescript.md +2 -2
- package/onboarding/prompts/framework/crewai-flows.md +2 -2
- package/onboarding/prompts/framework/deep-agents.md +2 -2
- package/onboarding/prompts/framework/google-adk.md +2 -2
- package/onboarding/prompts/framework/langgraph-fastapi.md +2 -2
- package/onboarding/prompts/framework/langgraph-python.md +2 -2
- package/onboarding/prompts/framework/langgraph-typescript.md +2 -2
- package/onboarding/prompts/framework/llamaindex.md +2 -2
- package/onboarding/prompts/framework/mastra.md +2 -2
- package/onboarding/prompts/framework/ms-agent-dotnet.md +2 -2
- package/onboarding/prompts/framework/ms-agent-harness-dotnet.md +2 -2
- package/onboarding/prompts/framework/ms-agent-python.md +2 -2
- package/onboarding/prompts/framework/pydantic-ai.md +2 -2
- package/onboarding/prompts/framework/strands-python.md +2 -2
- package/onboarding/prompts/framework/strands-typescript.md +2 -2
- package/onboarding/prompts/frontend/angular.md +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 +15 -15
- package/onboarding/prompts/proof/complete.md +8 -8
- package/onboarding/prompts/proof/oss-baseline.md +5 -5
- package/onboarding/prompts/proof/round-trip.md +10 -10
- package/onboarding/prompts/research/gather.md +6 -6
- package/onboarding/prompts/research/merge.md +3 -3
- package/onboarding/prompts/research/preflight.md +4 -4
- package/onboarding/prompts/research/route.md +5 -5
- package/onboarding/prompts/starter/clone.md +22 -15
- package/onboarding/prompts/stopped/run-failed.md +8 -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 +7 -1
- package/onboarding/prompts/subagent/prove-round-trip.md +17 -7
- package/onboarding/prompts/unsupported/no-validated-path.md +2 -2
- package/package.json +1 -1
- package/release/release-tool.js +52 -7
|
@@ -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.
|
|
6
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard identify --coding-agent <coding-agent-slug>
|
|
7
7
|
```
|
|
8
8
|
|
|
9
9
|
Use your own product's slug, such as `codex` or `claude-code`. This also covers entry
|
|
@@ -17,7 +17,7 @@ restricted to the target project.
|
|
|
17
17
|
Before any subagent or project process runs, capture the developer's existing work:
|
|
18
18
|
|
|
19
19
|
```text
|
|
20
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
20
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard protect
|
|
21
21
|
```
|
|
22
22
|
|
|
23
23
|
Keep the exact protected path list it prints and give that list to every subagent. Do not
|
|
@@ -47,7 +47,7 @@ This one does not.
|
|
|
47
47
|
Wait for the inspection subagent to finish. Then report that the inspection came back:
|
|
48
48
|
|
|
49
49
|
```text
|
|
50
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
50
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard checkpoint --phase research-returned
|
|
51
51
|
```
|
|
52
52
|
|
|
53
53
|
A refused checkpoint prints its reason and leaves onboarding unaffected. It is not a
|
|
@@ -64,7 +64,7 @@ and its install command in the message the developer sees: `nvm install 22` for
|
|
|
64
64
|
for Python. Offer a custom headless build as a later path. Then route out:
|
|
65
65
|
|
|
66
66
|
```text
|
|
67
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
67
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard read feature/stop
|
|
68
68
|
```
|
|
69
69
|
|
|
70
70
|
Do not run login, select Intelligence, or create a credential until the developer
|
|
@@ -94,7 +94,7 @@ 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.16.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
|
|
@@ -104,7 +104,7 @@ authorize a path the approved plan did not list.
|
|
|
104
104
|
Then report the plan this run is about to implement:
|
|
105
105
|
|
|
106
106
|
```text
|
|
107
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
107
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard checkpoint --phase plan-written
|
|
108
108
|
```
|
|
109
109
|
|
|
110
|
-
Then run `npx --prefer-offline --yes copilotkit@4.
|
|
110
|
+
Then run `npx --prefer-offline --yes copilotkit@4.16.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
|
After validation and each repair, run:
|
|
16
16
|
|
|
17
17
|
```text
|
|
18
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
18
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard audit
|
|
19
19
|
```
|
|
20
20
|
|
|
21
21
|
Continue only when it starts with `Status: passed`. A path under `Authorized to modify:` is
|
|
@@ -26,7 +26,7 @@ with the implementation subagent's `Files changed` section. If that section does
|
|
|
26
26
|
the path, accept the developer's external change:
|
|
27
27
|
|
|
28
28
|
```text
|
|
29
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
29
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard protect --accept-external --path <path>
|
|
30
30
|
```
|
|
31
31
|
|
|
32
32
|
For an env file where the developer placed a requested credential, use
|
|
@@ -35,24 +35,24 @@ or its report does not settle who changed it, ask the developer to allow the unp
|
|
|
35
35
|
change. Only after they agree, record their answer:
|
|
36
36
|
|
|
37
37
|
```text
|
|
38
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
38
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
|
|
39
39
|
```
|
|
40
40
|
|
|
41
41
|
Run the audit again after each accepted or authorized change. If it still fails, or starts
|
|
42
42
|
with `Status: blocked`, route out and stop:
|
|
43
43
|
|
|
44
44
|
```text
|
|
45
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
45
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard read feature/stop
|
|
46
46
|
```
|
|
47
47
|
|
|
48
48
|
When implementation validation passes, report it:
|
|
49
49
|
|
|
50
50
|
```text
|
|
51
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
51
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard checkpoint --phase build-validated
|
|
52
52
|
```
|
|
53
53
|
|
|
54
54
|
If validation cannot pass, or this intent needs a prerequisite the app does not have, use
|
|
55
55
|
the feature stop route above without further changes.
|
|
56
56
|
|
|
57
57
|
Otherwise run
|
|
58
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
58
|
+
`npx --prefer-offline --yes copilotkit@4.16.0 onboard read feature/chat-suggestions/proof`.
|
|
@@ -12,23 +12,23 @@ project-owned services running.
|
|
|
12
12
|
Report each attempt at the proof as it ends, counting from one:
|
|
13
13
|
|
|
14
14
|
```text
|
|
15
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
15
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard checkpoint --phase journey-attempted --attempt 1
|
|
16
16
|
```
|
|
17
17
|
|
|
18
18
|
Report each repair cycle the same way, counting from one:
|
|
19
19
|
|
|
20
20
|
```text
|
|
21
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
21
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard checkpoint --phase repair-attempted --attempt 1
|
|
22
22
|
```
|
|
23
23
|
|
|
24
24
|
After the final attempt, report the gate exactly once:
|
|
25
25
|
|
|
26
26
|
```text
|
|
27
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
27
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard proof --step round-trip --outcome <passed|failed|skipped>
|
|
28
28
|
```
|
|
29
29
|
|
|
30
30
|
Use `passed` only for a proved sent suggestion, `failed` for an attempted proof that failed,
|
|
31
|
-
and `skipped` when the proof could not run. Then run `npx --prefer-offline --yes copilotkit@4.
|
|
31
|
+
and `skipped` when the proof could not run. Then run `npx --prefer-offline --yes copilotkit@4.16.0 onboard audit`.
|
|
32
32
|
Continue only when it starts with `Status: passed`.
|
|
33
33
|
|
|
34
34
|
If the audit fails, never repair, reset, or revert a protected path. Compare each named path
|
|
@@ -43,9 +43,9 @@ Run the audit again after each accepted or authorized change.
|
|
|
43
43
|
If the audit still fails, or starts with `Status: blocked`, route out and stop:
|
|
44
44
|
|
|
45
45
|
```text
|
|
46
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
46
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard read feature/stop
|
|
47
47
|
```
|
|
48
48
|
|
|
49
49
|
When the audit passes, run
|
|
50
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
50
|
+
`npx --prefer-offline --yes copilotkit@4.16.0 onboard read feature/complete` with the real browser-proof
|
|
51
51
|
outcome.
|
|
@@ -6,7 +6,7 @@ implementation, and proof to separate subagents and keep all work inside the tar
|
|
|
6
6
|
Before any subagent or project process runs, capture the developer's existing work:
|
|
7
7
|
|
|
8
8
|
```text
|
|
9
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
9
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard protect
|
|
10
10
|
```
|
|
11
11
|
|
|
12
12
|
Keep the exact protected path list it prints and give that list to every subagent. No
|
|
@@ -15,7 +15,7 @@ approved authorization before implementation.
|
|
|
15
15
|
|
|
16
16
|
Before edits, identify the current CopilotKit provider, chat component, message lifecycle,
|
|
17
17
|
agent id, package version, and test/dev commands. Prove the existing OSS round trip with
|
|
18
|
-
`/info`, `npx --prefer-offline --yes copilotkit@4.
|
|
18
|
+
`/info`, `npx --prefer-offline --yes copilotkit@4.16.0 verify --expect-runtime oss --round-trip --agent <agent-id> --json`,
|
|
19
19
|
and one real frontend request when browser control is available. If there is no proven
|
|
20
20
|
existing CopilotKit chat, leave files unchanged and direct the developer to generic
|
|
21
21
|
onboarding first.
|
|
@@ -23,7 +23,7 @@ onboarding first.
|
|
|
23
23
|
Wait for the inspection subagent to finish. Then report that the inspection came back:
|
|
24
24
|
|
|
25
25
|
```text
|
|
26
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
26
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard checkpoint --phase research-returned
|
|
27
27
|
```
|
|
28
28
|
|
|
29
29
|
A refused checkpoint prints its reason and leaves onboarding unaffected. It is not a
|
|
@@ -33,7 +33,7 @@ If the inspection did not prove the baseline this intent extends, stop here with
|
|
|
33
33
|
changing files:
|
|
34
34
|
|
|
35
35
|
```text
|
|
36
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
36
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard read feature/stop
|
|
37
37
|
```
|
|
38
38
|
|
|
39
39
|
Do not run login, provision Intelligence, request a credential, replace the agent, or alter
|
|
@@ -55,7 +55,7 @@ one.
|
|
|
55
55
|
After approval, record each approved path before implementation:
|
|
56
56
|
|
|
57
57
|
```text
|
|
58
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
58
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard protect --authorize --path <path> --reason "<the plan's sentence>"
|
|
59
59
|
```
|
|
60
60
|
|
|
61
61
|
If an approved path changed after capture and no implementation step has run, add
|
|
@@ -65,7 +65,7 @@ authorize a path the approved plan did not list.
|
|
|
65
65
|
Then report the plan this run is about to implement:
|
|
66
66
|
|
|
67
67
|
```text
|
|
68
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
68
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard checkpoint --phase plan-written
|
|
69
69
|
```
|
|
70
70
|
|
|
71
|
-
Then run `npx --prefer-offline --yes copilotkit@4.
|
|
71
|
+
Then run `npx --prefer-offline --yes copilotkit@4.16.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.16.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
|
|
@@ -20,7 +20,7 @@ Before `onboard complete`, send the friction this run mentioned to the developer
|
|
|
20
20
|
report each, at most four, costliest first:
|
|
21
21
|
|
|
22
22
|
```text
|
|
23
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
23
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard friction --category <slug> --cost-seconds <seconds> --message "<sentences>"
|
|
24
24
|
```
|
|
25
25
|
|
|
26
26
|
Put one or two sentences in `--message`, with no secrets, source, or logs. Pick the
|
|
@@ -16,7 +16,7 @@ command without another developer question. Do not ask the developer about telem
|
|
|
16
16
|
command applies the setting they already have.
|
|
17
17
|
|
|
18
18
|
```text
|
|
19
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
19
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard friction --phase stop --category <slug> --message "<sentences>"
|
|
20
20
|
```
|
|
21
21
|
|
|
22
22
|
`--message` takes one or two sentences: the step you stopped at and what stopped it.
|
|
@@ -41,7 +41,7 @@ settled refusal rather than a missing baseline, so stop here, before any file ch
|
|
|
41
41
|
take its own ending:
|
|
42
42
|
|
|
43
43
|
```text
|
|
44
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
44
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard read feature/blocked-by-plan
|
|
45
45
|
```
|
|
46
46
|
|
|
47
47
|
`LEARNING_AVAILABILITY_UNAVAILABLE` means the platform did not resolve the answer. It is
|
|
@@ -55,7 +55,7 @@ then, so the read below is where its refusal surfaces.
|
|
|
55
55
|
When the plan or the repository already names an id, ask about that one id and nothing else:
|
|
56
56
|
|
|
57
57
|
```text
|
|
58
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
58
|
+
npx --prefer-offline --yes copilotkit@4.16.0 learning containers get <id> --json
|
|
59
59
|
```
|
|
60
60
|
|
|
61
61
|
One call answers it, and no list is needed.
|
|
@@ -63,7 +63,7 @@ One call answers it, and no list is needed.
|
|
|
63
63
|
When no id is in hand, survey what the project holds:
|
|
64
64
|
|
|
65
65
|
```text
|
|
66
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
66
|
+
npx --prefer-offline --yes copilotkit@4.16.0 learning containers list --json
|
|
67
67
|
```
|
|
68
68
|
|
|
69
69
|
One call returns at most 500 containers. When `nextCursor` in the result is not null, read
|
|
@@ -74,7 +74,7 @@ second container for work the first one already covers.
|
|
|
74
74
|
Report what the read found before asking anyone anything:
|
|
75
75
|
|
|
76
76
|
```text
|
|
77
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
77
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard checkpoint --phase container-surveyed
|
|
78
78
|
```
|
|
79
79
|
|
|
80
80
|
Everything after this waits on a person, so a run that stops past this point stopped on a
|
|
@@ -95,7 +95,7 @@ user, so the callback can return a different id per tier or per customer.
|
|
|
95
95
|
Ask the CLI for the id rather than spelling one yourself:
|
|
96
96
|
|
|
97
97
|
```text
|
|
98
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
98
|
+
npx --prefer-offline --yes copilotkit@4.16.0 learning containers default-id --json
|
|
99
99
|
```
|
|
100
100
|
|
|
101
101
|
It derives the project-scoped id from the selected project's slug, reads the local project
|
|
@@ -109,7 +109,7 @@ run that spells the id differently gives one project two containers, each below
|
|
|
109
109
|
above on its own. One command is what keeps the two spellings identical.
|
|
110
110
|
|
|
111
111
|
```text
|
|
112
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
112
|
+
npx --prefer-offline --yes copilotkit@4.16.0 learning containers create --id <id> --name <name> --json
|
|
113
113
|
```
|
|
114
114
|
|
|
115
115
|
An id already in use answers `LEARNING_CONTAINER_ALREADY_EXISTS`. That is a container to
|
|
@@ -124,7 +124,7 @@ or a guessed id.
|
|
|
124
124
|
Then report that the container is settled, before any edit:
|
|
125
125
|
|
|
126
126
|
```text
|
|
127
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
127
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard checkpoint --phase container-settled
|
|
128
128
|
```
|
|
129
129
|
|
|
130
130
|
Everything above happens between two prompts, so a run that stopped on a developer who could
|
|
@@ -145,13 +145,13 @@ non-zero on an app that is working. Pass what `identifyUser` reads with a repeat
|
|
|
145
145
|
It is not a defect to repair.
|
|
146
146
|
|
|
147
147
|
Run focused tests and
|
|
148
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
148
|
+
`npx --prefer-offline --yes copilotkit@4.16.0 verify --expect-runtime intelligence --round-trip --agent <agent-id> --json`.
|
|
149
149
|
Repair changed-file failures and record secret-safe evidence.
|
|
150
150
|
|
|
151
151
|
After validation and each repair, run:
|
|
152
152
|
|
|
153
153
|
```text
|
|
154
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
154
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard audit
|
|
155
155
|
```
|
|
156
156
|
|
|
157
157
|
Continue only when it starts with `Status: passed`. A path under `Authorized to modify:` is
|
|
@@ -162,7 +162,7 @@ with the implementation subagent's `Files changed` section. If that section does
|
|
|
162
162
|
the path, accept the developer's external change:
|
|
163
163
|
|
|
164
164
|
```text
|
|
165
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
165
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard protect --accept-external --path <path>
|
|
166
166
|
```
|
|
167
167
|
|
|
168
168
|
For an env file where the developer placed a requested credential, use
|
|
@@ -171,24 +171,24 @@ or its report does not settle who changed it, ask the developer to allow the unp
|
|
|
171
171
|
change. Only after they agree, record their answer:
|
|
172
172
|
|
|
173
173
|
```text
|
|
174
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
174
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
|
|
175
175
|
```
|
|
176
176
|
|
|
177
177
|
Run the audit again after each accepted or authorized change. If it still fails, or starts
|
|
178
178
|
with `Status: blocked`, route out and stop:
|
|
179
179
|
|
|
180
180
|
```text
|
|
181
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
181
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard read feature/stop
|
|
182
182
|
```
|
|
183
183
|
|
|
184
184
|
When implementation validation passes, report it:
|
|
185
185
|
|
|
186
186
|
```text
|
|
187
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
187
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard checkpoint --phase build-validated
|
|
188
188
|
```
|
|
189
189
|
|
|
190
190
|
If validation cannot pass, or this intent needs a prerequisite the app does not have, use
|
|
191
191
|
the feature stop route above without further changes.
|
|
192
192
|
|
|
193
193
|
Otherwise run
|
|
194
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
194
|
+
`npx --prefer-offline --yes copilotkit@4.16.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.16.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
|
|
@@ -32,24 +32,24 @@ same threshold. Existing threads do not join automatically just because a contai
|
|
|
32
32
|
Report each attempt at the proof as it ends, counting from one:
|
|
33
33
|
|
|
34
34
|
```text
|
|
35
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
35
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard checkpoint --phase journey-attempted --attempt 1
|
|
36
36
|
```
|
|
37
37
|
|
|
38
38
|
Report each repair cycle the same way, counting from one:
|
|
39
39
|
|
|
40
40
|
```text
|
|
41
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
41
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard checkpoint --phase repair-attempted --attempt 1
|
|
42
42
|
```
|
|
43
43
|
|
|
44
44
|
After the final attempt, report the gate exactly once:
|
|
45
45
|
|
|
46
46
|
```text
|
|
47
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
47
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard proof --step round-trip --outcome <passed|failed|skipped>
|
|
48
48
|
```
|
|
49
49
|
|
|
50
50
|
Use `passed` only for a proved Container assignment, `failed` for an attempted proof that
|
|
51
51
|
failed, and `skipped` when the proof could not run. Then run
|
|
52
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
52
|
+
`npx --prefer-offline --yes copilotkit@4.16.0 onboard audit`. Continue only when it starts with
|
|
53
53
|
`Status: passed`.
|
|
54
54
|
|
|
55
55
|
If the audit fails, never repair, reset, or revert a protected path. Compare each named path
|
|
@@ -64,9 +64,9 @@ Run the audit again after each accepted or authorized change.
|
|
|
64
64
|
If the audit still fails, or starts with `Status: blocked`, route out and stop:
|
|
65
65
|
|
|
66
66
|
```text
|
|
67
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
67
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard read feature/stop
|
|
68
68
|
```
|
|
69
69
|
|
|
70
70
|
When the audit passes, run
|
|
71
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
71
|
+
`npx --prefer-offline --yes copilotkit@4.16.0 onboard read feature/complete` with the actual surface
|
|
72
72
|
outcome.
|
|
@@ -11,7 +11,7 @@ friction command without another developer question. Do not ask the developer ab
|
|
|
11
11
|
telemetry: the command applies the setting they already have.
|
|
12
12
|
|
|
13
13
|
```text
|
|
14
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
14
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard friction --phase stop --category <slug> --message "<sentences>"
|
|
15
15
|
```
|
|
16
16
|
|
|
17
17
|
`--message` takes one or two sentences: the step you stopped at and what stopped it.
|
|
@@ -38,7 +38,7 @@ status:
|
|
|
38
38
|
before the capture, the inspection, and any edit:
|
|
39
39
|
|
|
40
40
|
```text
|
|
41
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
41
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard read feature/blocked-by-plan
|
|
42
42
|
```
|
|
43
43
|
|
|
44
44
|
- `LEARNING_AVAILABILITY_UNAVAILABLE` means the platform did not resolve the answer. It is
|
|
@@ -59,7 +59,7 @@ again: it has no answer, so it carries the question forward rather than ending o
|
|
|
59
59
|
Before any subagent or project process runs, capture the developer's existing work:
|
|
60
60
|
|
|
61
61
|
```text
|
|
62
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
62
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard protect
|
|
63
63
|
```
|
|
64
64
|
|
|
65
65
|
Keep the exact protected path list it prints and give that list to every subagent. No
|
|
@@ -75,7 +75,7 @@ onboarding.
|
|
|
75
75
|
Wait for the inspection subagent to finish. Then report that the inspection came back:
|
|
76
76
|
|
|
77
77
|
```text
|
|
78
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
78
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard checkpoint --phase research-returned
|
|
79
79
|
```
|
|
80
80
|
|
|
81
81
|
A refused checkpoint prints its reason and leaves onboarding unaffected. It is not a
|
|
@@ -85,7 +85,7 @@ If the inspection did not prove the baseline this intent extends, stop here with
|
|
|
85
85
|
changing files:
|
|
86
86
|
|
|
87
87
|
```text
|
|
88
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
88
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard read feature/stop
|
|
89
89
|
```
|
|
90
90
|
|
|
91
91
|
Fetch the current official guides before planning:
|
|
@@ -117,7 +117,7 @@ one.
|
|
|
117
117
|
After approval, record each approved path before implementation:
|
|
118
118
|
|
|
119
119
|
```text
|
|
120
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
120
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard protect --authorize --path <path> --reason "<the plan's sentence>"
|
|
121
121
|
```
|
|
122
122
|
|
|
123
123
|
If an approved path changed after capture and no implementation step has run, add
|
|
@@ -127,7 +127,7 @@ authorize a path the approved plan did not list.
|
|
|
127
127
|
Then report the plan this run is about to implement:
|
|
128
128
|
|
|
129
129
|
```text
|
|
130
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
130
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard checkpoint --phase plan-written
|
|
131
131
|
```
|
|
132
132
|
|
|
133
|
-
Then run `npx --prefer-offline --yes copilotkit@4.
|
|
133
|
+
Then run `npx --prefer-offline --yes copilotkit@4.16.0 onboard read feature/learning/implement`.
|
|
@@ -16,7 +16,7 @@ validation results without secrets.
|
|
|
16
16
|
After validation and each repair, run:
|
|
17
17
|
|
|
18
18
|
```text
|
|
19
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
19
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard audit
|
|
20
20
|
```
|
|
21
21
|
|
|
22
22
|
Continue only when it starts with `Status: passed`. A path under `Authorized to modify:` is
|
|
@@ -27,7 +27,7 @@ with the implementation subagent's `Files changed` section. If that section does
|
|
|
27
27
|
the path, accept the developer's external change:
|
|
28
28
|
|
|
29
29
|
```text
|
|
30
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
30
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard protect --accept-external --path <path>
|
|
31
31
|
```
|
|
32
32
|
|
|
33
33
|
For an env file where the developer placed a requested credential, use
|
|
@@ -36,24 +36,24 @@ or its report does not settle who changed it, ask the developer to allow the unp
|
|
|
36
36
|
change. Only after they agree, record their answer:
|
|
37
37
|
|
|
38
38
|
```text
|
|
39
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
39
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
|
|
40
40
|
```
|
|
41
41
|
|
|
42
42
|
Run the audit again after each accepted or authorized change. If it still fails, or starts
|
|
43
43
|
with `Status: blocked`, route out and stop:
|
|
44
44
|
|
|
45
45
|
```text
|
|
46
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
46
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard read feature/stop
|
|
47
47
|
```
|
|
48
48
|
|
|
49
49
|
When implementation validation passes, report it:
|
|
50
50
|
|
|
51
51
|
```text
|
|
52
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
52
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard checkpoint --phase build-validated
|
|
53
53
|
```
|
|
54
54
|
|
|
55
55
|
If validation cannot pass, or this intent needs a prerequisite the app does not have, use
|
|
56
56
|
the feature stop route above without further changes.
|
|
57
57
|
|
|
58
58
|
Otherwise run
|
|
59
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
59
|
+
`npx --prefer-offline --yes copilotkit@4.16.0 onboard read feature/open-generative-ui/proof`.
|
|
@@ -13,23 +13,23 @@ the missing visual proof honestly.
|
|
|
13
13
|
Report each attempt at the proof as it ends, counting from one:
|
|
14
14
|
|
|
15
15
|
```text
|
|
16
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
16
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard checkpoint --phase journey-attempted --attempt 1
|
|
17
17
|
```
|
|
18
18
|
|
|
19
19
|
Report each repair cycle the same way, counting from one:
|
|
20
20
|
|
|
21
21
|
```text
|
|
22
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
22
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard checkpoint --phase repair-attempted --attempt 1
|
|
23
23
|
```
|
|
24
24
|
|
|
25
25
|
After the final attempt, report the gate exactly once:
|
|
26
26
|
|
|
27
27
|
```text
|
|
28
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
28
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard proof --step round-trip --outcome <passed|failed|skipped>
|
|
29
29
|
```
|
|
30
30
|
|
|
31
31
|
Use `passed` only for a proved generated UI, `failed` for an attempted proof that failed,
|
|
32
|
-
and `skipped` when the proof could not run. Then run `npx --prefer-offline --yes copilotkit@4.
|
|
32
|
+
and `skipped` when the proof could not run. Then run `npx --prefer-offline --yes copilotkit@4.16.0 onboard audit`.
|
|
33
33
|
Continue only when it starts with `Status: passed`.
|
|
34
34
|
|
|
35
35
|
If the audit fails, never repair, reset, or revert a protected path. Compare each named path
|
|
@@ -44,9 +44,9 @@ Run the audit again after each accepted or authorized change.
|
|
|
44
44
|
If the audit still fails, or starts with `Status: blocked`, route out and stop:
|
|
45
45
|
|
|
46
46
|
```text
|
|
47
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
47
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard read feature/stop
|
|
48
48
|
```
|
|
49
49
|
|
|
50
50
|
When the audit passes, run
|
|
51
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
51
|
+
`npx --prefer-offline --yes copilotkit@4.16.0 onboard read feature/complete` with the outcome actually
|
|
52
52
|
observed.
|
|
@@ -6,7 +6,7 @@ implementation, and proof subagents, all restricted to the target project direct
|
|
|
6
6
|
Before any subagent or project process runs, capture the developer's existing work:
|
|
7
7
|
|
|
8
8
|
```text
|
|
9
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
9
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard protect
|
|
10
10
|
```
|
|
11
11
|
|
|
12
12
|
Keep the exact protected path list it prints and give that list to every subagent. No
|
|
@@ -16,7 +16,7 @@ approved authorization before implementation.
|
|
|
16
16
|
Before edits, have a research subagent identify the current CopilotKit runtime route,
|
|
17
17
|
provider/chat component, agent id, package versions, existing middleware, sandbox/CSP
|
|
18
18
|
constraints, and normal test/dev commands. Prove the existing app first with `/info`,
|
|
19
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
19
|
+
`npx --prefer-offline --yes copilotkit@4.16.0 verify --expect-runtime oss --round-trip --agent <agent-id> --json`,
|
|
20
20
|
and a real frontend request when browser control is available. If the app is not an existing
|
|
21
21
|
OSS CopilotKit app with a proven round trip, change nothing and direct the developer to the
|
|
22
22
|
generic onboarding path first.
|
|
@@ -24,7 +24,7 @@ generic onboarding path first.
|
|
|
24
24
|
Wait for the inspection subagent to finish. Then report that the inspection came back:
|
|
25
25
|
|
|
26
26
|
```text
|
|
27
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
27
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard checkpoint --phase research-returned
|
|
28
28
|
```
|
|
29
29
|
|
|
30
30
|
A refused checkpoint prints its reason and leaves onboarding unaffected. It is not a
|
|
@@ -34,7 +34,7 @@ If the inspection did not prove the baseline this intent extends, stop here with
|
|
|
34
34
|
changing files:
|
|
35
35
|
|
|
36
36
|
```text
|
|
37
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
37
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard read feature/stop
|
|
38
38
|
```
|
|
39
39
|
|
|
40
40
|
Do not sign in, select an Intelligence project, create credentials, change the existing
|
|
@@ -56,7 +56,7 @@ one.
|
|
|
56
56
|
After approval, record each approved path before implementation:
|
|
57
57
|
|
|
58
58
|
```text
|
|
59
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
59
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard protect --authorize --path <path> --reason "<the plan's sentence>"
|
|
60
60
|
```
|
|
61
61
|
|
|
62
62
|
If an approved path changed after capture and no implementation step has run, add
|
|
@@ -66,7 +66,7 @@ authorize a path the approved plan did not list.
|
|
|
66
66
|
Then report the plan this run is about to implement:
|
|
67
67
|
|
|
68
68
|
```text
|
|
69
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
69
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard checkpoint --phase plan-written
|
|
70
70
|
```
|
|
71
71
|
|
|
72
|
-
Then run `npx --prefer-offline --yes copilotkit@4.
|
|
72
|
+
Then run `npx --prefer-offline --yes copilotkit@4.16.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.16.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
|
After validation and each repair, run:
|
|
25
25
|
|
|
26
26
|
```text
|
|
27
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
27
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard audit
|
|
28
28
|
```
|
|
29
29
|
|
|
30
30
|
Continue only when it starts with `Status: passed`. A path under `Authorized to modify:` is
|
|
@@ -35,7 +35,7 @@ with the implementation subagent's `Files changed` section. If that section does
|
|
|
35
35
|
the path, accept the developer's external change:
|
|
36
36
|
|
|
37
37
|
```text
|
|
38
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
38
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard protect --accept-external --path <path>
|
|
39
39
|
```
|
|
40
40
|
|
|
41
41
|
For an env file where the developer placed a requested credential, use
|
|
@@ -44,24 +44,24 @@ or its report does not settle who changed it, ask the developer to allow the unp
|
|
|
44
44
|
change. Only after they agree, record their answer:
|
|
45
45
|
|
|
46
46
|
```text
|
|
47
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
47
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
|
|
48
48
|
```
|
|
49
49
|
|
|
50
50
|
Run the audit again after each accepted or authorized change. If it still fails, or starts
|
|
51
51
|
with `Status: blocked`, route out and stop:
|
|
52
52
|
|
|
53
53
|
```text
|
|
54
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
54
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard read feature/stop
|
|
55
55
|
```
|
|
56
56
|
|
|
57
57
|
When implementation validation passes, report it:
|
|
58
58
|
|
|
59
59
|
```text
|
|
60
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
60
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard checkpoint --phase build-validated
|
|
61
61
|
```
|
|
62
62
|
|
|
63
63
|
If validation cannot pass, or this intent needs a prerequisite the app does not have, use
|
|
64
64
|
the feature stop route above without further changes.
|
|
65
65
|
|
|
66
66
|
Otherwise run
|
|
67
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
67
|
+
`npx --prefer-offline --yes copilotkit@4.16.0 onboard read feature/realtime-sync/proof`.
|