copilotkit 4.14.0 → 4.15.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (79) hide show
  1. package/README.md +41 -6
  2. package/cli-build-info.json +8 -8
  3. package/index.js +31335 -30607
  4. package/onboarding/index.json +1 -1
  5. package/onboarding/prompts/authenticate/start.md +17 -8
  6. package/onboarding/prompts/conversion/plan.md +3 -3
  7. package/onboarding/prompts/credentials/finalize-plan.md +8 -8
  8. package/onboarding/prompts/credentials/plan.md +21 -21
  9. package/onboarding/prompts/credentials/settle-credentials.md +10 -10
  10. package/onboarding/prompts/credentials/write-plan.md +6 -6
  11. package/onboarding/prompts/fallback/best-effort.md +7 -7
  12. package/onboarding/prompts/feature/a2ui/implement.md +6 -6
  13. package/onboarding/prompts/feature/a2ui/proof.md +6 -6
  14. package/onboarding/prompts/feature/a2ui/start.md +7 -7
  15. package/onboarding/prompts/feature/channels/implement.md +7 -7
  16. package/onboarding/prompts/feature/channels/proof.md +6 -6
  17. package/onboarding/prompts/feature/channels/start.md +7 -7
  18. package/onboarding/prompts/feature/chat-suggestions/implement.md +6 -6
  19. package/onboarding/prompts/feature/chat-suggestions/proof.md +6 -6
  20. package/onboarding/prompts/feature/chat-suggestions/start.md +7 -7
  21. package/onboarding/prompts/feature/complete.md +3 -3
  22. package/onboarding/prompts/feature/learning/implement.md +16 -16
  23. package/onboarding/prompts/feature/learning/proof.md +7 -7
  24. package/onboarding/prompts/feature/learning/start.md +9 -9
  25. package/onboarding/prompts/feature/open-generative-ui/implement.md +6 -6
  26. package/onboarding/prompts/feature/open-generative-ui/proof.md +6 -6
  27. package/onboarding/prompts/feature/open-generative-ui/start.md +7 -7
  28. package/onboarding/prompts/feature/realtime-sync/implement.md +7 -7
  29. package/onboarding/prompts/feature/realtime-sync/proof.md +6 -6
  30. package/onboarding/prompts/feature/realtime-sync/start.md +6 -6
  31. package/onboarding/prompts/feature/rich-threads/implement.md +8 -8
  32. package/onboarding/prompts/feature/rich-threads/proof.md +6 -6
  33. package/onboarding/prompts/feature/rich-threads/start.md +6 -6
  34. package/onboarding/prompts/feature/stop.md +5 -5
  35. package/onboarding/prompts/feature/voice/implement.md +6 -6
  36. package/onboarding/prompts/feature/voice/proof.md +6 -6
  37. package/onboarding/prompts/feature/voice/start.md +7 -7
  38. package/onboarding/prompts/framework/ag2.md +2 -2
  39. package/onboarding/prompts/framework/agno.md +2 -2
  40. package/onboarding/prompts/framework/built-in.md +2 -2
  41. package/onboarding/prompts/framework/claude-sdk-python.md +2 -2
  42. package/onboarding/prompts/framework/claude-sdk-typescript.md +2 -2
  43. package/onboarding/prompts/framework/crewai-flows.md +2 -2
  44. package/onboarding/prompts/framework/deep-agents.md +2 -2
  45. package/onboarding/prompts/framework/google-adk.md +2 -2
  46. package/onboarding/prompts/framework/langgraph-fastapi.md +2 -2
  47. package/onboarding/prompts/framework/langgraph-python.md +2 -2
  48. package/onboarding/prompts/framework/langgraph-typescript.md +2 -2
  49. package/onboarding/prompts/framework/llamaindex.md +2 -2
  50. package/onboarding/prompts/framework/mastra.md +2 -2
  51. package/onboarding/prompts/framework/ms-agent-dotnet.md +2 -2
  52. package/onboarding/prompts/framework/ms-agent-harness-dotnet.md +2 -2
  53. package/onboarding/prompts/framework/ms-agent-python.md +2 -2
  54. package/onboarding/prompts/framework/pydantic-ai.md +2 -2
  55. package/onboarding/prompts/framework/strands-python.md +2 -2
  56. package/onboarding/prompts/framework/strands-typescript.md +2 -2
  57. package/onboarding/prompts/frontend/angular.md +3 -3
  58. package/onboarding/prompts/frontend/nextjs.md +3 -3
  59. package/onboarding/prompts/frontend/plan.md +7 -7
  60. package/onboarding/prompts/frontend/react-native.md +2 -2
  61. package/onboarding/prompts/frontend/react-spa.md +2 -2
  62. package/onboarding/prompts/frontend/vue.md +2 -2
  63. package/onboarding/prompts/implementation/build-and-validate.md +16 -16
  64. package/onboarding/prompts/proof/complete.md +9 -9
  65. package/onboarding/prompts/proof/oss-baseline.md +5 -5
  66. package/onboarding/prompts/proof/round-trip.md +11 -11
  67. package/onboarding/prompts/research/gather.md +6 -6
  68. package/onboarding/prompts/research/merge.md +3 -3
  69. package/onboarding/prompts/research/preflight.md +4 -4
  70. package/onboarding/prompts/research/route.md +5 -5
  71. package/onboarding/prompts/starter/clone.md +6 -6
  72. package/onboarding/prompts/stopped/run-failed.md +4 -4
  73. package/onboarding/prompts/subagent/create-plan.md +1 -1
  74. package/onboarding/prompts/subagent/inspect-repository.md +1 -1
  75. package/onboarding/prompts/subagent/prove-oss-baseline.md +8 -1
  76. package/onboarding/prompts/subagent/prove-round-trip.md +18 -16
  77. package/onboarding/prompts/unsupported/no-validated-path.md +3 -3
  78. package/package.json +1 -1
  79. package/release/release-tool.js +1 -1
@@ -1,5 +1,5 @@
1
1
  {
2
- "graphTree": "3bdef9cbf4b02632fc8dfaa2a5b51cde7a2269eb",
2
+ "graphTree": "5060f03e832956c5641ef75cb6c54283c9e7230b",
3
3
  "intentRoots": {
4
4
  "add-a2ui": "feature/a2ui/start",
5
5
  "add-chat-suggestions": "feature/chat-suggestions/start",
@@ -10,12 +10,21 @@ directory and changes files only after the developer approves a written plan. Co
10
10
  Intelligence has a free Developer plan, and this run needs no paid subscription. Nothing it
11
11
  does is hidden from the developer.
12
12
 
13
+ ## Command approvals
14
+
15
+ Run each CLI call exactly as written, as its own command: no pipe, `tee`, `&&`, redirect,
16
+ or variable prefix. If your harness asks the developer to approve commands, request
17
+ escalation on the `onboard identify` call with the prefix rule
18
+ `["npx", "--prefer-offline", "--yes", "copilotkit@4.15.0"]`. Every CLI call in this run
19
+ matches it. Say then that the install, the dev servers, `curl` to the local app, and `ps`,
20
+ `lsof`, and `kill` ask for approval later.
21
+
13
22
  ## First, say which coding agent you are
14
23
 
15
24
  Run this before anything else in this prompt, including the welcome message below:
16
25
 
17
26
  ```text
18
- npx --yes copilotkit@4.14.0 onboard identify --coding-agent <coding-agent-slug>
27
+ npx --prefer-offline --yes copilotkit@4.15.0 onboard identify --coding-agent <coding-agent-slug>
19
28
  ```
20
29
 
21
30
  Report your own product with one short slug, such as `codex` or `claude-code`.
@@ -38,10 +47,10 @@ printed once.
38
47
  Every later command must run from the directory this run started in. A command run
39
48
  somewhere else is refused, because the run it belongs to cannot be found from there. That
40
49
  refusal is a step, not a stop to report: run
41
- `npx --yes copilotkit@4.14.0 onboard start --run <onboarding_run_id>` where you are
50
+ `npx --prefer-offline --yes copilotkit@4.15.0 onboard start --run <onboarding_run_id>` where you are
42
51
  standing, then run the refused command again.
43
52
 
44
- If you no longer hold the id, run `npx --yes copilotkit@4.14.0 onboard start` in the
53
+ If you no longer hold the id, run `npx --prefer-offline --yes copilotkit@4.15.0 onboard start` in the
45
54
  directory this run started in, with no `--run` and no `--intent`. It reprints the id of the
46
55
  run under way and starts nothing. An id this project does not already hold starts a second
47
56
  run, and the work already done stops counting toward the first.
@@ -108,10 +117,10 @@ the run waits is a pause, not a stop, even when your harness ends it. Run the fr
108
117
  command without another developer question.
109
118
 
110
119
  ```text
111
- npx --yes copilotkit@4.14.0 onboard friction --phase stop --category <slug>
120
+ npx --prefer-offline --yes copilotkit@4.15.0 onboard friction --phase stop --category <slug> --message "<sentences>"
112
121
  ```
113
122
 
114
- Write one or two sentences to standard input: the step you stopped at and what stopped it.
123
+ `--message` takes one or two sentences: the step you stopped at and what stopped it.
115
124
  Pick the category that fits from docs-missing, docs-wrong, docs-sequential, cli-gap,
116
125
  sdk-gap, environment, port-collision, credential, validation-loop, and other. Leave
117
126
  --cost-seconds off. Send no secrets, source code, logs, or command output. The command refuses a
@@ -124,7 +133,7 @@ next: send the report, then stop.
124
133
 
125
134
  ## Check sign-in
126
135
 
127
- Run `npx --yes copilotkit@4.14.0 login --json` before any project work. This command
136
+ Run `npx --prefer-offline --yes copilotkit@4.15.0 login --json` before any project work. This command
128
137
  checks the current session. It starts sign-in only as needed. Treat this as a long-lived
129
138
  streaming process. Do not wait for the command to exit before you read its standard output.
130
139
 
@@ -171,8 +180,8 @@ Do not use `whoami` for this check. Do not put account tokens or credentials in
171
180
  conversation.
172
181
 
173
182
  When sign-in is settled, run
174
- `npx --yes copilotkit@4.14.0 onboard read research/gather`.
183
+ `npx --prefer-offline --yes copilotkit@4.15.0 onboard read research/gather`.
175
184
 
176
185
  If sign-in stops onboarding, run
177
- `npx --yes copilotkit@4.14.0 onboard read stopped/run-failed`. It says nothing about
186
+ `npx --prefer-offline --yes copilotkit@4.15.0 onboard read stopped/run-failed`. It says nothing about
178
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 --yes copilotkit@4.14.0 verify --round-trip`, which sends a
103
+ fifth item is proved by `npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 onboard read credentials/finalize-plan`.
119
+ Then run `npx --prefer-offline --yes copilotkit@4.15.0 onboard read credentials/finalize-plan`.
120
120
 
121
121
  If a selected page does not load after the second method, run
122
- `npx --yes copilotkit@4.14.0 onboard read unsupported/no-validated-path`.
122
+ `npx --prefer-offline --yes copilotkit@4.15.0 onboard read unsupported/no-validated-path`.
@@ -24,10 +24,10 @@ 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 --yes copilotkit@4.14.0 onboard friction --phase stop --category <slug>
27
+ npx --prefer-offline --yes copilotkit@4.15.0 onboard friction --phase stop --category <slug> --message "<sentences>"
28
28
  ```
29
29
 
30
- Write one or two sentences to standard input: the step you stopped at and what stopped it.
30
+ `--message` takes one or two sentences: the step you stopped at and what stopped it.
31
31
  Pick the category that fits from docs-missing, docs-wrong, docs-sequential, cli-gap,
32
32
  sdk-gap, environment, port-collision, credential, validation-loop, and other. Leave
33
33
  --cost-seconds off. A run that stopped cannot separate one papercut's cost from the cost
@@ -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 --yes copilotkit@4.14.0 onboard classify --starting-state <starting-state> --agent-framework <agent-framework> --frontend <frontend>
62
+ npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 project select --create <name> \
159
+ npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 project list --json
177
+ npx --prefer-offline --yes copilotkit@4.15.0 project list --json
178
178
  ```
179
179
 
180
180
  Narrow them:
181
181
 
182
182
  ```text
183
- npx --yes copilotkit@4.14.0 project list --search <query> --json
183
+ npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 project select --project <slug-or-id> \
196
+ npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 onboard read credentials/settle-credentials`.
241
+ `npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 onboard read frontend/plan`.
23
+ `npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 onboard read framework/ag2`
78
- 2. Agno: `npx --yes copilotkit@4.14.0 onboard read framework/agno`
79
- 3. Built-in CopilotKit agent: `npx --yes copilotkit@4.14.0 onboard read framework/built-in`
80
- 4. Claude Agent SDK Python: `npx --yes copilotkit@4.14.0 onboard read framework/claude-sdk-python`
81
- 5. Claude Agent SDK TypeScript: `npx --yes copilotkit@4.14.0 onboard read framework/claude-sdk-typescript`
82
- 6. CrewAI Flows: `npx --yes copilotkit@4.14.0 onboard read framework/crewai-flows`
83
- 7. Deep Agents: `npx --yes copilotkit@4.14.0 onboard read framework/deep-agents`
84
- 8. LangGraph Python: `npx --yes copilotkit@4.14.0 onboard read framework/langgraph-python`
85
- 9. LangGraph FastAPI: `npx --yes copilotkit@4.14.0 onboard read framework/langgraph-fastapi`
86
- 10. LangGraph TypeScript: `npx --yes copilotkit@4.14.0 onboard read framework/langgraph-typescript`
87
- 11. LlamaIndex: `npx --yes copilotkit@4.14.0 onboard read framework/llamaindex`
88
- 12. ADK: `npx --yes copilotkit@4.14.0 onboard read framework/google-adk`
89
- 13. Microsoft Agent Framework Python: `npx --yes copilotkit@4.14.0 onboard read framework/ms-agent-python`
90
- 14. Microsoft Agent Framework .NET: `npx --yes copilotkit@4.14.0 onboard read framework/ms-agent-dotnet`
91
- 15. Mastra: `npx --yes copilotkit@4.14.0 onboard read framework/mastra`
92
- 16. MS Agent Harness .NET: `npx --yes copilotkit@4.14.0 onboard read framework/ms-agent-harness-dotnet`
93
- 17. Pydantic AI: `npx --yes copilotkit@4.14.0 onboard read framework/pydantic-ai`
94
- 18. Strands Agents Python: `npx --yes copilotkit@4.14.0 onboard read framework/strands-python`
95
- 19. Strands Agents TypeScript: `npx --yes copilotkit@4.14.0 onboard read framework/strands-typescript`
77
+ 1. AG2: `npx --prefer-offline --yes copilotkit@4.15.0 onboard read framework/ag2`
78
+ 2. Agno: `npx --prefer-offline --yes copilotkit@4.15.0 onboard read framework/agno`
79
+ 3. Built-in CopilotKit agent: `npx --prefer-offline --yes copilotkit@4.15.0 onboard read framework/built-in`
80
+ 4. Claude Agent SDK Python: `npx --prefer-offline --yes copilotkit@4.15.0 onboard read framework/claude-sdk-python`
81
+ 5. Claude Agent SDK TypeScript: `npx --prefer-offline --yes copilotkit@4.15.0 onboard read framework/claude-sdk-typescript`
82
+ 6. CrewAI Flows: `npx --prefer-offline --yes copilotkit@4.15.0 onboard read framework/crewai-flows`
83
+ 7. Deep Agents: `npx --prefer-offline --yes copilotkit@4.15.0 onboard read framework/deep-agents`
84
+ 8. LangGraph Python: `npx --prefer-offline --yes copilotkit@4.15.0 onboard read framework/langgraph-python`
85
+ 9. LangGraph FastAPI: `npx --prefer-offline --yes copilotkit@4.15.0 onboard read framework/langgraph-fastapi`
86
+ 10. LangGraph TypeScript: `npx --prefer-offline --yes copilotkit@4.15.0 onboard read framework/langgraph-typescript`
87
+ 11. LlamaIndex: `npx --prefer-offline --yes copilotkit@4.15.0 onboard read framework/llamaindex`
88
+ 12. ADK: `npx --prefer-offline --yes copilotkit@4.15.0 onboard read framework/google-adk`
89
+ 13. Microsoft Agent Framework Python: `npx --prefer-offline --yes copilotkit@4.15.0 onboard read framework/ms-agent-python`
90
+ 14. Microsoft Agent Framework .NET: `npx --prefer-offline --yes copilotkit@4.15.0 onboard read framework/ms-agent-dotnet`
91
+ 15. Mastra: `npx --prefer-offline --yes copilotkit@4.15.0 onboard read framework/mastra`
92
+ 16. MS Agent Harness .NET: `npx --prefer-offline --yes copilotkit@4.15.0 onboard read framework/ms-agent-harness-dotnet`
93
+ 17. Pydantic AI: `npx --prefer-offline --yes copilotkit@4.15.0 onboard read framework/pydantic-ai`
94
+ 18. Strands Agents Python: `npx --prefer-offline --yes copilotkit@4.15.0 onboard read framework/strands-python`
95
+ 19. Strands Agents TypeScript: `npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 onboard read unsupported/no-validated-path`.
99
+ `npx --prefer-offline --yes copilotkit@4.15.0 onboard read unsupported/no-validated-path`.
@@ -11,10 +11,10 @@ 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 --yes copilotkit@4.14.0 onboard friction --phase stop --category <slug>
14
+ npx --prefer-offline --yes copilotkit@4.15.0 onboard friction --phase stop --category <slug> --message "<sentences>"
15
15
  ```
16
16
 
17
- Write one or two sentences to standard input: the step you stopped at and what stopped it.
17
+ `--message` takes one or two sentences: the step you stopped at and what stopped it.
18
18
  Pick the category that fits from docs-missing, docs-wrong, docs-sequential, cli-gap,
19
19
  sdk-gap, environment, port-collision, credential, validation-loop, and other. Leave
20
20
  --cost-seconds off. A run that stopped cannot separate one papercut's cost from the cost of
@@ -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 --yes copilotkit@4.14.0 learning containers default-id --json
63
+ npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 learning containers get <id> --json
82
+ npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 onboard checkpoint --phase container-surveyed
107
+ npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 onboard checkpoint --phase awaiting-developer
131
+ npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 onboard protect --path <path>
144
+ npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 onboard protect --rebaseline --path <path>
158
+ npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 onboard protect --accept-credential --path <environment path>
177
+ npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 onboard read credentials/write-plan`.
192
+ `npx --prefer-offline --yes copilotkit@4.15.0 onboard read credentials/write-plan`.
@@ -11,10 +11,10 @@ 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 --yes copilotkit@4.14.0 onboard friction --phase stop --category <slug>
14
+ npx --prefer-offline --yes copilotkit@4.15.0 onboard friction --phase stop --category <slug> --message "<sentences>"
15
15
  ```
16
16
 
17
- Write one or two sentences to standard input: the step you stopped at and what stopped it.
17
+ `--message` takes one or two sentences: the step you stopped at and what stopped it.
18
18
  Pick the category that fits from docs-missing, docs-wrong, docs-sequential, cli-gap,
19
19
  sdk-gap, environment, port-collision, credential, validation-loop, and other. Leave
20
20
  --cost-seconds off. A run that stopped cannot separate one papercut's cost from the cost of
@@ -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 --yes copilotkit@4.14.0 onboard read subagent/create-plan` first and follow the prompt
55
+ `npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 onboard read stopped/run-failed`. A plan this run cannot
66
+ `npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 onboard read implementation/build-and-validate`.
110
+ `npx --prefer-offline --yes copilotkit@4.15.0 onboard read implementation/build-and-validate`.
111
111
 
112
112
  If no exact supported path or documentation URL exists, run
113
- `npx --yes copilotkit@4.14.0 onboard read unsupported/no-validated-path`.
113
+ `npx --prefer-offline --yes copilotkit@4.15.0 onboard read unsupported/no-validated-path`.
@@ -14,10 +14,10 @@ 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 --yes copilotkit@4.14.0 onboard friction --phase stop --category <slug>
17
+ npx --prefer-offline --yes copilotkit@4.15.0 onboard friction --phase stop --category <slug> --message "<sentences>"
18
18
  ```
19
19
 
20
- Write one or two sentences to standard input: the step you stopped at and what stopped it.
20
+ `--message` takes one or two sentences: the step you stopped at and what stopped it.
21
21
  Pick the category that fits from docs-missing, docs-wrong, docs-sequential, cli-gap,
22
22
  sdk-gap, environment, port-collision, credential, validation-loop, and other. Leave
23
23
  --cost-seconds off. A run that stopped cannot separate one papercut's cost from the cost
@@ -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 --yes copilotkit@4.14.0 onboard audit` from the target app directory.
63
+ - Run `npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 onboard protect --accept-external --path <path>`, run the
69
+ `npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 onboard complete`, carrying the
122
+ When the proof is complete, run `npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 onboard complete --visual-check <outcome>
128
- npx --yes copilotkit@4.14.0 onboard complete --device-check <outcome>
127
+ npx --prefer-offline --yes copilotkit@4.15.0 onboard complete --visual-check <outcome>
128
+ npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 onboard audit
21
+ npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 onboard protect --accept-external --path <path>
32
+ npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
41
+ npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 onboard read feature/stop
48
+ npx --prefer-offline --yes copilotkit@4.15.0 onboard read feature/stop
49
49
  ```
50
50
 
51
51
  When implementation validation passes, report it:
52
52
 
53
53
  ```text
54
- npx --yes copilotkit@4.14.0 onboard checkpoint --phase build-validated
54
+ npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 onboard read feature/a2ui/proof`.
61
+ `npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 onboard checkpoint --phase journey-attempted --attempt 1
22
+ npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 onboard checkpoint --phase repair-attempted --attempt 1
28
+ npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 onboard proof --step round-trip --outcome <passed|failed|skipped>
34
+ npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 onboard audit`.
38
+ and `skipped` when the proof could not run. Then run `npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 onboard read feature/stop
53
+ npx --prefer-offline --yes copilotkit@4.15.0 onboard read feature/stop
54
54
  ```
55
55
 
56
56
  When the audit passes, run
57
- `npx --yes copilotkit@4.14.0 onboard read feature/complete` with the actual browser-proof
57
+ `npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 onboard protect
10
+ npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 verify --expect-runtime oss --round-trip --agent <agent-id> --json`.
25
+ `npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 onboard checkpoint --phase research-returned
33
+ npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 onboard read feature/stop
43
+ npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 onboard protect --authorize --path <path> --reason "<the plan's sentence>"
67
+ npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 onboard checkpoint --phase plan-written
77
+ npx --prefer-offline --yes copilotkit@4.15.0 onboard checkpoint --phase plan-written
78
78
  ```
79
79
 
80
- Then run `npx --yes copilotkit@4.14.0 onboard read feature/a2ui/implement`.
80
+ Then run `npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 login --json`: the same single streaming
22
+ yourself with `npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 onboard audit
81
+ npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 onboard protect --accept-external --path <path>
92
+ npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
101
+ npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 onboard read feature/stop
108
+ npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 onboard checkpoint --phase build-validated
144
+ npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 onboard read feature/channels/proof`.
151
+ `npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 onboard checkpoint --phase journey-attempted --attempt 1
26
+ npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 onboard checkpoint --phase repair-attempted --attempt 1
32
+ npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 onboard proof --step round-trip --outcome <passed|failed|skipped>
38
+ npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 onboard audit`.
42
+ failed, and `skipped` when the proof did not run. Then run `npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 onboard read feature/stop
57
+ npx --prefer-offline --yes copilotkit@4.15.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 --yes copilotkit@4.14.0 onboard read feature/complete` and complete with
62
+ `npx --prefer-offline --yes copilotkit@4.15.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