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
package/onboarding/index.json
CHANGED
|
@@ -15,7 +15,7 @@ does is hidden from the developer.
|
|
|
15
15
|
Run each CLI call exactly as written, as its own command: no pipe, `tee`, `&&`, redirect,
|
|
16
16
|
or variable prefix. If your harness asks the developer to approve commands, request
|
|
17
17
|
escalation on the `onboard identify` call with the prefix rule
|
|
18
|
-
`["npx", "--prefer-offline", "--yes", "copilotkit@4.
|
|
18
|
+
`["npx", "--prefer-offline", "--yes", "copilotkit@4.16.0"]`. Every CLI call in this run
|
|
19
19
|
matches it. Say then that the install, the dev servers, `curl` to the local app, and `ps`,
|
|
20
20
|
`lsof`, and `kill` ask for approval later.
|
|
21
21
|
|
|
@@ -24,7 +24,7 @@ matches it. Say then that the install, the dev servers, `curl` to the local app,
|
|
|
24
24
|
Run this before anything else in this prompt, including the welcome message below:
|
|
25
25
|
|
|
26
26
|
```text
|
|
27
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
27
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard identify --coding-agent <coding-agent-slug>
|
|
28
28
|
```
|
|
29
29
|
|
|
30
30
|
Report your own product with one short slug, such as `codex` or `claude-code`.
|
|
@@ -47,10 +47,10 @@ printed once.
|
|
|
47
47
|
Every later command must run from the directory this run started in. A command run
|
|
48
48
|
somewhere else is refused, because the run it belongs to cannot be found from there. That
|
|
49
49
|
refusal is a step, not a stop to report: run
|
|
50
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
50
|
+
`npx --prefer-offline --yes copilotkit@4.16.0 onboard start --run <onboarding_run_id>` where you are
|
|
51
51
|
standing, then run the refused command again.
|
|
52
52
|
|
|
53
|
-
If you no longer hold the id, run `npx --prefer-offline --yes copilotkit@4.
|
|
53
|
+
If you no longer hold the id, run `npx --prefer-offline --yes copilotkit@4.16.0 onboard start` in the
|
|
54
54
|
directory this run started in, with no `--run` and no `--intent`. It reprints the id of the
|
|
55
55
|
run under way and starts nothing. An id this project does not already hold starts a second
|
|
56
56
|
run, and the work already done stops counting toward the first.
|
|
@@ -117,7 +117,7 @@ the run waits is a pause, not a stop, even when your harness ends it. Run the fr
|
|
|
117
117
|
command without another developer question.
|
|
118
118
|
|
|
119
119
|
```text
|
|
120
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
120
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard friction --phase stop --category <slug> --message "<sentences>"
|
|
121
121
|
```
|
|
122
122
|
|
|
123
123
|
`--message` takes one or two sentences: the step you stopped at and what stopped it.
|
|
@@ -133,7 +133,7 @@ next: send the report, then stop.
|
|
|
133
133
|
|
|
134
134
|
## Check sign-in
|
|
135
135
|
|
|
136
|
-
Run `npx --prefer-offline --yes copilotkit@4.
|
|
136
|
+
Run `npx --prefer-offline --yes copilotkit@4.16.0 login --json` before any project work. This command
|
|
137
137
|
checks the current session. It starts sign-in only as needed. Treat this as a long-lived
|
|
138
138
|
streaming process. Do not wait for the command to exit before you read its standard output.
|
|
139
139
|
|
|
@@ -180,8 +180,8 @@ Do not use `whoami` for this check. Do not put account tokens or credentials in
|
|
|
180
180
|
conversation.
|
|
181
181
|
|
|
182
182
|
When sign-in is settled, run
|
|
183
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
183
|
+
`npx --prefer-offline --yes copilotkit@4.16.0 onboard read research/gather`.
|
|
184
184
|
|
|
185
185
|
If sign-in stops onboarding, run
|
|
186
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
186
|
+
`npx --prefer-offline --yes copilotkit@4.16.0 onboard read stopped/run-failed`. It says nothing about
|
|
187
187
|
whether this project's stack is supported, which is not yet known at this point.
|
|
@@ -100,7 +100,7 @@ of this journey, and a drawer that lists nothing is not a reason to mint one. Li
|
|
|
100
100
|
tokens stay a self-hosted concern.
|
|
101
101
|
|
|
102
102
|
Where this journey's frontend framework ships no threads drawer -- React Native --, the
|
|
103
|
-
fifth item is proved by `npx --prefer-offline --yes copilotkit@4.
|
|
103
|
+
fifth item is proved by `npx --prefer-offline --yes copilotkit@4.16.0 verify --round-trip`, which sends a
|
|
104
104
|
real request and reads the answer back off the thread it landed on. The run says which of
|
|
105
105
|
the two it proved. Do not send a run to the managed Intelligence dashboard to prove this.
|
|
106
106
|
An authenticated browser session at a hosted dashboard is the one thing an agent-driven run
|
|
@@ -116,7 +116,7 @@ and passed -- so a run scored on either one was scored on the same fact. Every r
|
|
|
116
116
|
resolves that condition from, while `licenseStatus` is a compatibility projection of it
|
|
117
117
|
for older thread surfaces and outlives them only until those surfaces go.
|
|
118
118
|
|
|
119
|
-
Then run `npx --prefer-offline --yes copilotkit@4.
|
|
119
|
+
Then run `npx --prefer-offline --yes copilotkit@4.16.0 onboard read credentials/finalize-plan`.
|
|
120
120
|
|
|
121
121
|
If a selected page does not load after the second method, run
|
|
122
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
122
|
+
`npx --prefer-offline --yes copilotkit@4.16.0 onboard read unsupported/no-validated-path`.
|
|
@@ -24,7 +24,7 @@ developer question. Do not ask the developer about telemetry: the command applie
|
|
|
24
24
|
setting they already have.
|
|
25
25
|
|
|
26
26
|
```text
|
|
27
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
27
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard friction --phase stop --category <slug> --message "<sentences>"
|
|
28
28
|
```
|
|
29
29
|
|
|
30
30
|
`--message` takes one or two sentences: the step you stopped at and what stopped it.
|
|
@@ -59,7 +59,7 @@ the command refuses one of them from a run that was served that node.
|
|
|
59
59
|
Run this command with the exact selected slugs:
|
|
60
60
|
|
|
61
61
|
```text
|
|
62
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
62
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard classify --starting-state <starting-state> --agent-framework <agent-framework> --frontend <frontend>
|
|
63
63
|
```
|
|
64
64
|
|
|
65
65
|
Do not continue if a value is refused. Fix the value from the choices that the earlier
|
|
@@ -156,7 +156,7 @@ passes against the wrong one.
|
|
|
156
156
|
Create it, from the target directory, passing the port research settled:
|
|
157
157
|
|
|
158
158
|
```text
|
|
159
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
159
|
+
npx --prefer-offline --yes copilotkit@4.16.0 project select --create <name> \
|
|
160
160
|
--runtime-url http://localhost:<port>/api/copilotkit --json
|
|
161
161
|
```
|
|
162
162
|
|
|
@@ -174,13 +174,13 @@ Take this branch only when the developer asks for an existing project, or asks t
|
|
|
174
174
|
projects they have. Read the choices:
|
|
175
175
|
|
|
176
176
|
```text
|
|
177
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
177
|
+
npx --prefer-offline --yes copilotkit@4.16.0 project list --json
|
|
178
178
|
```
|
|
179
179
|
|
|
180
180
|
Narrow them:
|
|
181
181
|
|
|
182
182
|
```text
|
|
183
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
183
|
+
npx --prefer-offline --yes copilotkit@4.16.0 project list --search <query> --json
|
|
184
184
|
```
|
|
185
185
|
|
|
186
186
|
With `--json` the payload is the only thing on standard output, so it is safe to parse. Do
|
|
@@ -193,7 +193,7 @@ Then record the project they name, from the target directory, with the same
|
|
|
193
193
|
`--runtime-url`:
|
|
194
194
|
|
|
195
195
|
```text
|
|
196
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
196
|
+
npx --prefer-offline --yes copilotkit@4.16.0 project select --project <slug-or-id> \
|
|
197
197
|
--runtime-url http://localhost:<port>/api/copilotkit --json
|
|
198
198
|
```
|
|
199
199
|
|
|
@@ -238,4 +238,4 @@ project-record path and environment path as the credential setup path list. Do n
|
|
|
238
238
|
to the baseline yet.
|
|
239
239
|
|
|
240
240
|
When project selection is settled, run
|
|
241
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
241
|
+
`npx --prefer-offline --yes copilotkit@4.16.0 onboard read credentials/settle-credentials`.
|
|
@@ -20,7 +20,7 @@ If the target directory holds no project and the copied prompt came from the Sla
|
|
|
20
20
|
Microsoft Teams docs page, do not ask the framework question. The Channel starter brings
|
|
21
21
|
its own agent, so an answer here decides nothing. Tell the developer that the Channel
|
|
22
22
|
starter decides the agent, then run
|
|
23
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
23
|
+
`npx --prefer-offline --yes copilotkit@4.16.0 onboard read frontend/plan`.
|
|
24
24
|
|
|
25
25
|
Use a gentle wizard. Ask one short question at a time. Do not combine separate choices in
|
|
26
26
|
one question. Put the recommendation first, give its evidence in one sentence, and keep
|
|
@@ -74,26 +74,26 @@ another framework. Do not show the internal route.
|
|
|
74
74
|
|
|
75
75
|
Use exactly one matching internal route:
|
|
76
76
|
|
|
77
|
-
1. AG2: `npx --prefer-offline --yes copilotkit@4.
|
|
78
|
-
2. Agno: `npx --prefer-offline --yes copilotkit@4.
|
|
79
|
-
3. Built-in CopilotKit agent: `npx --prefer-offline --yes copilotkit@4.
|
|
80
|
-
4. Claude Agent SDK Python: `npx --prefer-offline --yes copilotkit@4.
|
|
81
|
-
5. Claude Agent SDK TypeScript: `npx --prefer-offline --yes copilotkit@4.
|
|
82
|
-
6. CrewAI Flows: `npx --prefer-offline --yes copilotkit@4.
|
|
83
|
-
7. Deep Agents: `npx --prefer-offline --yes copilotkit@4.
|
|
84
|
-
8. LangGraph Python: `npx --prefer-offline --yes copilotkit@4.
|
|
85
|
-
9. LangGraph FastAPI: `npx --prefer-offline --yes copilotkit@4.
|
|
86
|
-
10. LangGraph TypeScript: `npx --prefer-offline --yes copilotkit@4.
|
|
87
|
-
11. LlamaIndex: `npx --prefer-offline --yes copilotkit@4.
|
|
88
|
-
12. ADK: `npx --prefer-offline --yes copilotkit@4.
|
|
89
|
-
13. Microsoft Agent Framework Python: `npx --prefer-offline --yes copilotkit@4.
|
|
90
|
-
14. Microsoft Agent Framework .NET: `npx --prefer-offline --yes copilotkit@4.
|
|
91
|
-
15. Mastra: `npx --prefer-offline --yes copilotkit@4.
|
|
92
|
-
16. MS Agent Harness .NET: `npx --prefer-offline --yes copilotkit@4.
|
|
93
|
-
17. Pydantic AI: `npx --prefer-offline --yes copilotkit@4.
|
|
94
|
-
18. Strands Agents Python: `npx --prefer-offline --yes copilotkit@4.
|
|
95
|
-
19. Strands Agents TypeScript: `npx --prefer-offline --yes copilotkit@4.
|
|
77
|
+
1. AG2: `npx --prefer-offline --yes copilotkit@4.16.0 onboard read framework/ag2`
|
|
78
|
+
2. Agno: `npx --prefer-offline --yes copilotkit@4.16.0 onboard read framework/agno`
|
|
79
|
+
3. Built-in CopilotKit agent: `npx --prefer-offline --yes copilotkit@4.16.0 onboard read framework/built-in`
|
|
80
|
+
4. Claude Agent SDK Python: `npx --prefer-offline --yes copilotkit@4.16.0 onboard read framework/claude-sdk-python`
|
|
81
|
+
5. Claude Agent SDK TypeScript: `npx --prefer-offline --yes copilotkit@4.16.0 onboard read framework/claude-sdk-typescript`
|
|
82
|
+
6. CrewAI Flows: `npx --prefer-offline --yes copilotkit@4.16.0 onboard read framework/crewai-flows`
|
|
83
|
+
7. Deep Agents: `npx --prefer-offline --yes copilotkit@4.16.0 onboard read framework/deep-agents`
|
|
84
|
+
8. LangGraph Python: `npx --prefer-offline --yes copilotkit@4.16.0 onboard read framework/langgraph-python`
|
|
85
|
+
9. LangGraph FastAPI: `npx --prefer-offline --yes copilotkit@4.16.0 onboard read framework/langgraph-fastapi`
|
|
86
|
+
10. LangGraph TypeScript: `npx --prefer-offline --yes copilotkit@4.16.0 onboard read framework/langgraph-typescript`
|
|
87
|
+
11. LlamaIndex: `npx --prefer-offline --yes copilotkit@4.16.0 onboard read framework/llamaindex`
|
|
88
|
+
12. ADK: `npx --prefer-offline --yes copilotkit@4.16.0 onboard read framework/google-adk`
|
|
89
|
+
13. Microsoft Agent Framework Python: `npx --prefer-offline --yes copilotkit@4.16.0 onboard read framework/ms-agent-python`
|
|
90
|
+
14. Microsoft Agent Framework .NET: `npx --prefer-offline --yes copilotkit@4.16.0 onboard read framework/ms-agent-dotnet`
|
|
91
|
+
15. Mastra: `npx --prefer-offline --yes copilotkit@4.16.0 onboard read framework/mastra`
|
|
92
|
+
16. MS Agent Harness .NET: `npx --prefer-offline --yes copilotkit@4.16.0 onboard read framework/ms-agent-harness-dotnet`
|
|
93
|
+
17. Pydantic AI: `npx --prefer-offline --yes copilotkit@4.16.0 onboard read framework/pydantic-ai`
|
|
94
|
+
18. Strands Agents Python: `npx --prefer-offline --yes copilotkit@4.16.0 onboard read framework/strands-python`
|
|
95
|
+
19. Strands Agents TypeScript: `npx --prefer-offline --yes copilotkit@4.16.0 onboard read framework/strands-typescript`
|
|
96
96
|
|
|
97
97
|
If the project has an agent in another framework, or no listed framework fits, keep the
|
|
98
98
|
developer's current agent and run
|
|
99
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
99
|
+
`npx --prefer-offline --yes copilotkit@4.16.0 onboard read unsupported/no-validated-path`.
|
|
@@ -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.
|
|
@@ -60,7 +60,7 @@ One container for this project is the default scope, so the id comes from the se
|
|
|
60
60
|
project slug. Ask the CLI for it, from the target directory:
|
|
61
61
|
|
|
62
62
|
```text
|
|
63
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
63
|
+
npx --prefer-offline --yes copilotkit@4.16.0 learning containers default-id --json
|
|
64
64
|
```
|
|
65
65
|
|
|
66
66
|
The command reads the local project record. It needs no credential and makes no network
|
|
@@ -79,7 +79,7 @@ happened.
|
|
|
79
79
|
Then ask the platform about that id, from the target directory:
|
|
80
80
|
|
|
81
81
|
```text
|
|
82
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
82
|
+
npx --prefer-offline --yes copilotkit@4.16.0 learning containers get <id> --json
|
|
83
83
|
```
|
|
84
84
|
|
|
85
85
|
The read carries the same availability gate as the create, so it answers the entitlement
|
|
@@ -104,7 +104,7 @@ Never invent an id, scrape a dashboard, or treat an arbitrary string as a contai
|
|
|
104
104
|
Report what the read found, before anything is planned:
|
|
105
105
|
|
|
106
106
|
```text
|
|
107
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
107
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard checkpoint --phase container-surveyed
|
|
108
108
|
```
|
|
109
109
|
|
|
110
110
|
Carry the derived id into the planning subagent's handoff, with whether the platform
|
|
@@ -128,7 +128,7 @@ finds is not.
|
|
|
128
128
|
Until the developer answers, the run waits. Report the pause and end your turn:
|
|
129
129
|
|
|
130
130
|
```text
|
|
131
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
131
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard checkpoint --phase awaiting-developer
|
|
132
132
|
```
|
|
133
133
|
|
|
134
134
|
This is a pause, not a stop. `research/gather` describes it under "Pausing vs stopping".
|
|
@@ -141,7 +141,7 @@ protected path list. Also add each project file that the developer changed for m
|
|
|
141
141
|
credentials. Record them in the baseline from the target app directory:
|
|
142
142
|
|
|
143
143
|
```text
|
|
144
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
144
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard protect --path <path>
|
|
145
145
|
```
|
|
146
146
|
|
|
147
147
|
Pass one `--path` for each. The command captures a digest for each path and never re-reads
|
|
@@ -155,7 +155,7 @@ Then re-capture the files this graph wrote itself. For each path the first captu
|
|
|
155
155
|
as `deferred` that this run has now written, run:
|
|
156
156
|
|
|
157
157
|
```text
|
|
158
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
158
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard protect --rebaseline --path <path>
|
|
159
159
|
```
|
|
160
160
|
|
|
161
161
|
From that point they are protected like any other path, so a later step that rewrites
|
|
@@ -174,7 +174,7 @@ environment path. The command below is what to run at that point, from the targe
|
|
|
174
174
|
directory:
|
|
175
175
|
|
|
176
176
|
```text
|
|
177
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
177
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard protect --accept-credential --path <environment path>
|
|
178
178
|
```
|
|
179
179
|
|
|
180
180
|
The command compares the variable names the baseline recorded with the names the file holds
|
|
@@ -189,4 +189,4 @@ now. Read its result:
|
|
|
189
189
|
is not a failed step. It answers the question and the run carries on.
|
|
190
190
|
|
|
191
191
|
When the credential question is answered, run
|
|
192
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
192
|
+
`npx --prefer-offline --yes copilotkit@4.16.0 onboard read credentials/write-plan`.
|
|
@@ -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.
|
|
@@ -52,7 +52,7 @@ proof subagents:
|
|
|
52
52
|
Fetch them together with the pages already selected rather than on their own.
|
|
53
53
|
|
|
54
54
|
Spawn one planning subagent. Tell it to run
|
|
55
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
55
|
+
`npx --prefer-offline --yes copilotkit@4.16.0 onboard read subagent/create-plan` first and follow the prompt
|
|
56
56
|
it returns. If that read fails because the subagent cannot use the shell, stop that subagent.
|
|
57
57
|
Run the same command yourself, then spawn a fresh subagent with the returned prompt and the
|
|
58
58
|
same handoff. Give it the repository findings, selected framework, frontend, model, credential
|
|
@@ -63,7 +63,7 @@ Wait for the subagent to finish.
|
|
|
63
63
|
Continue only if the planning result starts with `Status: passed`. For `Status: failed`,
|
|
64
64
|
send the result back to the planning subagent for repair, up to three attempts. For
|
|
65
65
|
`Status: blocked`, or a third failed result, run
|
|
66
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
66
|
+
`npx --prefer-offline --yes copilotkit@4.16.0 onboard read stopped/run-failed`. A plan this run cannot
|
|
67
67
|
write is a run that broke, not a stack the documentation does not cover. Do not show or
|
|
68
68
|
ask for approval of a non-pass plan.
|
|
69
69
|
|
|
@@ -107,7 +107,7 @@ build. Keep this window open until the app runs." Decide from your own approval
|
|
|
107
107
|
as the welcome did, not from your coding-agent slug.
|
|
108
108
|
|
|
109
109
|
If the developer approves the plan, run
|
|
110
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
110
|
+
`npx --prefer-offline --yes copilotkit@4.16.0 onboard read implementation/build-and-validate`.
|
|
111
111
|
|
|
112
112
|
If no exact supported path or documentation URL exists, run
|
|
113
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
113
|
+
`npx --prefer-offline --yes copilotkit@4.16.0 onboard read unsupported/no-validated-path`.
|
|
@@ -14,7 +14,7 @@ command without another developer question. Do not ask the developer about telem
|
|
|
14
14
|
command applies the setting they already have.
|
|
15
15
|
|
|
16
16
|
```text
|
|
17
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
17
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard friction --phase stop --category <slug> --message "<sentences>"
|
|
18
18
|
```
|
|
19
19
|
|
|
20
20
|
`--message` takes one or two sentences: the step you stopped at and what stopped it.
|
|
@@ -60,13 +60,13 @@ or frontend, stop onboarding.
|
|
|
60
60
|
|
|
61
61
|
Use these rules for every protected-path check in this fallback:
|
|
62
62
|
|
|
63
|
-
- Run `npx --prefer-offline --yes copilotkit@4.
|
|
63
|
+
- Run `npx --prefer-offline --yes copilotkit@4.16.0 onboard audit` from the target app directory.
|
|
64
64
|
- If a result starts with `Status: blocked`, stop onboarding and report the printed reason.
|
|
65
65
|
It proved nothing changed, so do not report a preservation failure.
|
|
66
66
|
- If a result reports a changed protected path this run wrote, stop onboarding.
|
|
67
67
|
- If a result reports a changed path that no Files changed section from this run names,
|
|
68
68
|
the change came from outside the run. Accept it by name with
|
|
69
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
69
|
+
`npx --prefer-offline --yes copilotkit@4.16.0 onboard protect --accept-external --path <path>`, run the
|
|
70
70
|
audit again, and name it in the closing report.
|
|
71
71
|
- If no Files changed section from this run covers the step that wrote it, stop
|
|
72
72
|
onboarding. The proof subagent here returns no such section, so a finding it raises is
|
|
@@ -119,13 +119,13 @@ application passes proof. Report each tool result separately from the proof resu
|
|
|
119
119
|
Report the documentation gap and each assumption with the proof evidence. Do not claim
|
|
120
120
|
that the selected documentation proved an inferred step.
|
|
121
121
|
|
|
122
|
-
When the proof is complete, run `npx --prefer-offline --yes copilotkit@4.
|
|
122
|
+
When the proof is complete, run `npx --prefer-offline --yes copilotkit@4.16.0 onboard complete`, carrying the
|
|
123
123
|
surface-check result the proof subagent returned. Pass exactly one flag, matching this
|
|
124
124
|
journey's surface:
|
|
125
125
|
|
|
126
126
|
```text
|
|
127
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
128
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
127
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard complete --visual-check <outcome>
|
|
128
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard complete --device-check <outcome>
|
|
129
129
|
```
|
|
130
130
|
|
|
131
131
|
`--visual-check` is for a web frontend and takes `performed`, `skipped-no-browser-tool`, or
|
|
@@ -18,7 +18,7 @@ without exposing secrets.
|
|
|
18
18
|
After validation and each repair, run:
|
|
19
19
|
|
|
20
20
|
```text
|
|
21
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
21
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard audit
|
|
22
22
|
```
|
|
23
23
|
|
|
24
24
|
Continue only when it starts with `Status: passed`. A path under `Authorized to modify:` is
|
|
@@ -29,7 +29,7 @@ with the implementation subagent's `Files changed` section. If that section does
|
|
|
29
29
|
the path, accept the developer's external change:
|
|
30
30
|
|
|
31
31
|
```text
|
|
32
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
32
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard protect --accept-external --path <path>
|
|
33
33
|
```
|
|
34
34
|
|
|
35
35
|
For an env file where the developer placed a requested credential, use
|
|
@@ -38,24 +38,24 @@ or its report does not settle who changed it, ask the developer to allow the unp
|
|
|
38
38
|
change. Only after they agree, record their answer:
|
|
39
39
|
|
|
40
40
|
```text
|
|
41
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
41
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
|
|
42
42
|
```
|
|
43
43
|
|
|
44
44
|
Run the audit again after each accepted or authorized change. If it still fails, or starts
|
|
45
45
|
with `Status: blocked`, route out and stop:
|
|
46
46
|
|
|
47
47
|
```text
|
|
48
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
48
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard read feature/stop
|
|
49
49
|
```
|
|
50
50
|
|
|
51
51
|
When implementation validation passes, report it:
|
|
52
52
|
|
|
53
53
|
```text
|
|
54
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
54
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard checkpoint --phase build-validated
|
|
55
55
|
```
|
|
56
56
|
|
|
57
57
|
If validation cannot pass, or this intent needs a prerequisite the app does not have, use
|
|
58
58
|
the feature stop route above without further changes.
|
|
59
59
|
|
|
60
60
|
Otherwise run
|
|
61
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
61
|
+
`npx --prefer-offline --yes copilotkit@4.16.0 onboard read feature/a2ui/proof`.
|
|
@@ -19,23 +19,23 @@ user's agent response with a hard-coded UI.
|
|
|
19
19
|
Report each attempt at the proof as it ends, 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 journey-attempted --attempt 1
|
|
23
23
|
```
|
|
24
24
|
|
|
25
25
|
Report each repair cycle the same way, counting from one:
|
|
26
26
|
|
|
27
27
|
```text
|
|
28
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
28
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard checkpoint --phase repair-attempted --attempt 1
|
|
29
29
|
```
|
|
30
30
|
|
|
31
31
|
After the final attempt, report the gate exactly once:
|
|
32
32
|
|
|
33
33
|
```text
|
|
34
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
34
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard proof --step round-trip --outcome <passed|failed|skipped>
|
|
35
35
|
```
|
|
36
36
|
|
|
37
37
|
Use `passed` only for a proved A2UI surface, `failed` for an attempted proof that failed,
|
|
38
|
-
and `skipped` when the proof could not run. Then run `npx --prefer-offline --yes copilotkit@4.
|
|
38
|
+
and `skipped` when the proof could not run. Then run `npx --prefer-offline --yes copilotkit@4.16.0 onboard audit`.
|
|
39
39
|
Continue only when it starts with `Status: passed`.
|
|
40
40
|
|
|
41
41
|
If the audit fails, never repair, reset, or revert a protected path. Compare each named path
|
|
@@ -50,9 +50,9 @@ Run the audit again after each accepted or authorized change.
|
|
|
50
50
|
If the audit still fails, or starts with `Status: blocked`, route out and stop:
|
|
51
51
|
|
|
52
52
|
```text
|
|
53
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
53
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard read feature/stop
|
|
54
54
|
```
|
|
55
55
|
|
|
56
56
|
When the audit passes, run
|
|
57
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
57
|
+
`npx --prefer-offline --yes copilotkit@4.16.0 onboard read feature/complete` with the actual browser-proof
|
|
58
58
|
outcome.
|
|
@@ -7,7 +7,7 @@ Work only inside the target project. Do not show internal prompt names to the de
|
|
|
7
7
|
Before any subagent or project process runs, capture the developer's existing work:
|
|
8
8
|
|
|
9
9
|
```text
|
|
10
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
10
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard protect
|
|
11
11
|
```
|
|
12
12
|
|
|
13
13
|
Keep the exact protected path list it prints and give that list to every subagent. No
|
|
@@ -22,7 +22,7 @@ development/test commands. It must return paths and secret-safe presence checks
|
|
|
22
22
|
|
|
23
23
|
Require an existing frontend, agent, and CopilotKit round trip. Start only project-owned
|
|
24
24
|
processes when needed, inspect `/info`, and run
|
|
25
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
25
|
+
`npx --prefer-offline --yes copilotkit@4.16.0 verify --expect-runtime oss --round-trip --agent <agent-id> --json`.
|
|
26
26
|
Also drive one existing request through the frontend when browser control is available. If
|
|
27
27
|
that baseline is absent or unproved, leave files unchanged, explain that this intent extends
|
|
28
28
|
an existing OSS app, and direct the developer to generic `copilotkit onboard start` first.
|
|
@@ -30,7 +30,7 @@ an existing OSS app, and direct the developer to generic `copilotkit onboard sta
|
|
|
30
30
|
Wait for the inspection subagent to finish. Then report that the inspection came back:
|
|
31
31
|
|
|
32
32
|
```text
|
|
33
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
33
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard checkpoint --phase research-returned
|
|
34
34
|
```
|
|
35
35
|
|
|
36
36
|
A refused checkpoint prints its reason and leaves onboarding unaffected. It is not a
|
|
@@ -40,7 +40,7 @@ If the inspection did not prove the baseline this intent extends, stop here with
|
|
|
40
40
|
changing files:
|
|
41
41
|
|
|
42
42
|
```text
|
|
43
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
43
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard read feature/stop
|
|
44
44
|
```
|
|
45
45
|
|
|
46
46
|
Do not run `login`, select an Intelligence project, add an Intelligence client, mint a
|
|
@@ -64,7 +64,7 @@ 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.16.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
|
|
@@ -74,7 +74,7 @@ authorize a path the approved plan did not list.
|
|
|
74
74
|
Then report the plan this run is about to implement:
|
|
75
75
|
|
|
76
76
|
```text
|
|
77
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
77
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard checkpoint --phase plan-written
|
|
78
78
|
```
|
|
79
79
|
|
|
80
|
-
Then run `npx --prefer-offline --yes copilotkit@4.
|
|
80
|
+
Then run `npx --prefer-offline --yes copilotkit@4.16.0 onboard read feature/a2ui/implement`.
|
|
@@ -19,7 +19,7 @@ On Teams, skip Slack-only tools and the Slack e2e harness. Do not add a CopilotK
|
|
|
19
19
|
web app to make this run look complete. Do not replace the existing agent.
|
|
20
20
|
|
|
21
21
|
If repository evidence does not prove an existing valid Intelligence selection, sign in
|
|
22
|
-
yourself with `npx --prefer-offline --yes copilotkit@4.
|
|
22
|
+
yourself with `npx --prefer-offline --yes copilotkit@4.16.0 login --json`: the same single streaming
|
|
23
23
|
session generic onboarding uses. Read its JSON Lines while the process runs. Open the
|
|
24
24
|
first `authentication_url` exactly once with the operating system's default browser
|
|
25
25
|
opener, `open` on macOS, `xdg-open` on Linux, `Start-Process` in Windows PowerShell. Your
|
|
@@ -78,7 +78,7 @@ starter to satisfy this rule, and do not report the page that shows it.
|
|
|
78
78
|
After validation and each repair, run:
|
|
79
79
|
|
|
80
80
|
```text
|
|
81
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
81
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard audit
|
|
82
82
|
```
|
|
83
83
|
|
|
84
84
|
Continue only when it starts with `Status: passed`. A path under `Authorized to modify:` is
|
|
@@ -89,7 +89,7 @@ with the implementation subagent's `Files changed` section. If that section does
|
|
|
89
89
|
the path, accept the developer's external change:
|
|
90
90
|
|
|
91
91
|
```text
|
|
92
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
92
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard protect --accept-external --path <path>
|
|
93
93
|
```
|
|
94
94
|
|
|
95
95
|
For an env file where the developer placed a requested credential, use
|
|
@@ -98,14 +98,14 @@ or its report does not settle who changed it, ask the developer to allow the unp
|
|
|
98
98
|
change. Only after they agree, record their answer:
|
|
99
99
|
|
|
100
100
|
```text
|
|
101
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
101
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
|
|
102
102
|
```
|
|
103
103
|
|
|
104
104
|
Run the audit again after each accepted or authorized change. If it still fails, or starts
|
|
105
105
|
with `Status: blocked`, route out and stop:
|
|
106
106
|
|
|
107
107
|
```text
|
|
108
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
108
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard read feature/stop
|
|
109
109
|
```
|
|
110
110
|
|
|
111
111
|
## Values this run writes, and the one credential the developer supplies
|
|
@@ -141,11 +141,11 @@ variable while every recorded one keeps its value, and run the audit again.
|
|
|
141
141
|
When implementation validation passes, report it:
|
|
142
142
|
|
|
143
143
|
```text
|
|
144
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
144
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard checkpoint --phase build-validated
|
|
145
145
|
```
|
|
146
146
|
|
|
147
147
|
If validation cannot pass, or this run needs a prerequisite the app does not have, use
|
|
148
148
|
the feature stop route above without further changes.
|
|
149
149
|
|
|
150
150
|
Otherwise run
|
|
151
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
151
|
+
`npx --prefer-offline --yes copilotkit@4.16.0 onboard read feature/channels/proof`.
|
|
@@ -23,23 +23,23 @@ route after the audit rules below.
|
|
|
23
23
|
Report each attempt at the proof as it ends, counting from one:
|
|
24
24
|
|
|
25
25
|
```text
|
|
26
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
26
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard checkpoint --phase journey-attempted --attempt 1
|
|
27
27
|
```
|
|
28
28
|
|
|
29
29
|
Report each repair cycle the same way, counting from one:
|
|
30
30
|
|
|
31
31
|
```text
|
|
32
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
32
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard checkpoint --phase repair-attempted --attempt 1
|
|
33
33
|
```
|
|
34
34
|
|
|
35
35
|
After the final attempt, report the gate exactly once:
|
|
36
36
|
|
|
37
37
|
```text
|
|
38
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
38
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard proof --step round-trip --outcome <passed|failed|skipped>
|
|
39
39
|
```
|
|
40
40
|
|
|
41
41
|
Use `passed` only for a proved mention reply, `failed` for an attempted proof that
|
|
42
|
-
failed, and `skipped` when the proof did not run. Then run `npx --prefer-offline --yes copilotkit@4.
|
|
42
|
+
failed, and `skipped` when the proof did not run. Then run `npx --prefer-offline --yes copilotkit@4.16.0 onboard audit`.
|
|
43
43
|
Continue only when it starts with `Status: passed`.
|
|
44
44
|
|
|
45
45
|
If the audit fails, never repair, reset, or revert a protected path. Compare each named path
|
|
@@ -54,12 +54,12 @@ Run the audit again after each accepted or authorized change.
|
|
|
54
54
|
If the audit still fails, or starts with `Status: blocked`, route out and stop:
|
|
55
55
|
|
|
56
56
|
```text
|
|
57
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
57
|
+
npx --prefer-offline --yes copilotkit@4.16.0 onboard read feature/stop
|
|
58
58
|
```
|
|
59
59
|
|
|
60
60
|
When the audit passes and the mention proof passed, record it first with
|
|
61
61
|
`onboard proof --step round-trip --outcome passed` as above. Then run
|
|
62
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
62
|
+
`npx --prefer-offline --yes copilotkit@4.16.0 onboard read feature/complete` and complete with
|
|
63
63
|
`--visual-check channels-proof-passed`. The recorded mention and reply are this run's
|
|
64
64
|
proof, so no web app check is missing. Use `--visual-check performed` only when a
|
|
65
65
|
browser drove Slack or Teams web and proved the mention reply. Do not use
|