copilotkit 4.29.0 → 4.30.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 (97) hide show
  1. package/README.md +311 -33
  2. package/cli-build-info.json +7 -7
  3. package/exporters/claude-sdk/README.md +93 -0
  4. package/exporters/claude-sdk/export_session_store.py +39 -0
  5. package/exporters/claude-sdk/store-export.ts +61 -0
  6. package/index.js +212561 -109267
  7. package/onboarding/index.json +51 -5
  8. package/onboarding/prompts/authenticate/start.md +51 -49
  9. package/onboarding/prompts/conversion/plan.md +3 -3
  10. package/onboarding/prompts/credentials/finalize-plan.md +15 -15
  11. package/onboarding/prompts/credentials/plan.md +25 -29
  12. package/onboarding/prompts/credentials/settle-credentials.md +13 -8
  13. package/onboarding/prompts/credentials/write-plan.md +18 -16
  14. package/onboarding/prompts/deployment/choose-local.md +13 -12
  15. package/onboarding/prompts/deployment/local-evaluation.md +11 -11
  16. package/onboarding/prompts/fallback/best-effort.md +10 -11
  17. package/onboarding/prompts/feature/a2ui/implement.md +7 -5
  18. package/onboarding/prompts/feature/a2ui/plan.md +7 -3
  19. package/onboarding/prompts/feature/a2ui/proof.md +8 -6
  20. package/onboarding/prompts/feature/a2ui/start.md +10 -10
  21. package/onboarding/prompts/feature/channels/implement.md +10 -8
  22. package/onboarding/prompts/feature/channels/plan.md +9 -5
  23. package/onboarding/prompts/feature/channels/proof.md +8 -6
  24. package/onboarding/prompts/feature/channels/start.md +17 -13
  25. package/onboarding/prompts/feature/chat-suggestions/implement.md +7 -5
  26. package/onboarding/prompts/feature/chat-suggestions/plan.md +7 -3
  27. package/onboarding/prompts/feature/chat-suggestions/proof.md +8 -6
  28. package/onboarding/prompts/feature/chat-suggestions/start.md +10 -10
  29. package/onboarding/prompts/feature/complete.md +3 -3
  30. package/onboarding/prompts/feature/learning/implement.md +15 -13
  31. package/onboarding/prompts/feature/learning/plan.md +8 -4
  32. package/onboarding/prompts/feature/learning/proof.md +16 -14
  33. package/onboarding/prompts/feature/learning/start.md +10 -10
  34. package/onboarding/prompts/feature/open-generative-ui/implement.md +7 -5
  35. package/onboarding/prompts/feature/open-generative-ui/plan.md +7 -3
  36. package/onboarding/prompts/feature/open-generative-ui/proof.md +8 -6
  37. package/onboarding/prompts/feature/open-generative-ui/start.md +10 -10
  38. package/onboarding/prompts/feature/realtime-sync/implement.md +8 -6
  39. package/onboarding/prompts/feature/realtime-sync/plan.md +7 -3
  40. package/onboarding/prompts/feature/realtime-sync/proof.md +8 -6
  41. package/onboarding/prompts/feature/realtime-sync/start.md +9 -9
  42. package/onboarding/prompts/feature/rich-threads/implement.md +9 -7
  43. package/onboarding/prompts/feature/rich-threads/plan.md +7 -3
  44. package/onboarding/prompts/feature/rich-threads/proof.md +8 -6
  45. package/onboarding/prompts/feature/rich-threads/start.md +9 -9
  46. package/onboarding/prompts/feature/stop.md +4 -4
  47. package/onboarding/prompts/feature/voice/implement.md +7 -5
  48. package/onboarding/prompts/feature/voice/plan.md +8 -4
  49. package/onboarding/prompts/feature/voice/proof.md +8 -6
  50. package/onboarding/prompts/feature/voice/start.md +10 -10
  51. package/onboarding/prompts/framework/ag2.md +4 -11
  52. package/onboarding/prompts/framework/agno.md +4 -11
  53. package/onboarding/prompts/framework/built-in.md +3 -3
  54. package/onboarding/prompts/framework/claude-sdk-python.md +3 -3
  55. package/onboarding/prompts/framework/claude-sdk-typescript.md +3 -3
  56. package/onboarding/prompts/framework/crewai-flows.md +6 -12
  57. package/onboarding/prompts/framework/custom-ag-ui.md +5 -11
  58. package/onboarding/prompts/framework/deep-agents.md +5 -11
  59. package/onboarding/prompts/framework/google-adk.md +4 -8
  60. package/onboarding/prompts/framework/langgraph-fastapi.md +4 -10
  61. package/onboarding/prompts/framework/langgraph-python.md +4 -10
  62. package/onboarding/prompts/framework/langgraph-typescript.md +5 -11
  63. package/onboarding/prompts/framework/llamaindex.md +4 -10
  64. package/onboarding/prompts/framework/mastra.md +4 -10
  65. package/onboarding/prompts/framework/ms-agent-dotnet.md +6 -13
  66. package/onboarding/prompts/framework/ms-agent-harness-dotnet.md +7 -13
  67. package/onboarding/prompts/framework/ms-agent-python.md +5 -11
  68. package/onboarding/prompts/framework/pydantic-ai.md +4 -10
  69. package/onboarding/prompts/framework/strands-python.md +4 -10
  70. package/onboarding/prompts/framework/strands-typescript.md +4 -10
  71. package/onboarding/prompts/frontend/angular.md +4 -4
  72. package/onboarding/prompts/frontend/nextjs.md +4 -4
  73. package/onboarding/prompts/frontend/plan.md +10 -10
  74. package/onboarding/prompts/frontend/react-native.md +3 -3
  75. package/onboarding/prompts/frontend/react-spa.md +3 -3
  76. package/onboarding/prompts/frontend/vue.md +3 -3
  77. package/onboarding/prompts/implementation/build-and-validate.md +33 -16
  78. package/onboarding/prompts/proof/complete.md +22 -19
  79. package/onboarding/prompts/proof/oss-baseline.md +6 -6
  80. package/onboarding/prompts/proof/round-trip.md +34 -14
  81. package/onboarding/prompts/research/gather.md +15 -15
  82. package/onboarding/prompts/research/merge.md +6 -5
  83. package/onboarding/prompts/research/preflight.md +2 -2
  84. package/onboarding/prompts/research/route.md +4 -4
  85. package/onboarding/prompts/setup/questions.md +10 -8
  86. package/onboarding/prompts/starter/clone.md +77 -75
  87. package/onboarding/prompts/starter/setup.md +111 -0
  88. package/onboarding/prompts/stopped/declined.md +44 -0
  89. package/onboarding/prompts/stopped/run-failed.md +6 -6
  90. package/onboarding/prompts/subagent/create-plan.md +5 -5
  91. package/onboarding/prompts/subagent/implement-and-validate.md +4 -4
  92. package/onboarding/prompts/subagent/inspect-repository.md +1 -1
  93. package/onboarding/prompts/subagent/prove-oss-baseline.md +2 -2
  94. package/onboarding/prompts/subagent/prove-round-trip.md +21 -8
  95. package/onboarding/prompts/unsupported/no-validated-path.md +6 -6
  96. package/package.json +4 -1
  97. package/release/release-tool.js +383 -112
@@ -2,7 +2,7 @@
2
2
 
3
3
  Delegate implementation to one subagent with the approved plan and fetched official guides.
4
4
  If repository evidence does not prove an existing valid Intelligence selection, run
5
- `npx --prefer-offline --yes copilotkit@4.29.0 login --json` and follow its single streaming session. Then
5
+ `npx --prefer-offline --yes copilotkit@4.30.0 login --json` and follow its single streaming session. Then
6
6
  list projects, show the developer the current/recent choices, and select or create one only
7
7
  after they choose. Require the secret-safe selection summary to confirm the project file,
8
8
  environment file, and key provisioning; never display a key. If existing configuration is
@@ -21,7 +21,7 @@ such an app on a thread the app created, with `--thread <id>`, which needs no se
21
21
  record UNKNOWN as the expected result here.
22
22
 
23
23
  Run focused type/test commands, then start the app and run
24
- `npx --prefer-offline --yes copilotkit@4.29.0 verify --expect-runtime intelligence --round-trip --agent <agent-id> --json`.
24
+ `npx --prefer-offline --yes copilotkit@4.30.0 verify --expect-runtime intelligence --round-trip --agent <agent-id> --json`.
25
25
  The `verify` report names the runtime URL it probed. If the dev server serves the
26
26
  runtime at another URL, add `--runtime-url <url>`.
27
27
  Repair changed-file failures before continuing. Record changed paths and secret-safe
@@ -36,26 +36,28 @@ That result is a question for the developer. Name the file and why the work need
36
36
  Before you end your turn to wait for the developer, report the pause:
37
37
 
38
38
  ```text
39
- npx --prefer-offline --yes copilotkit@4.29.0 onboard checkpoint --phase awaiting-developer --about uncommitted-file
39
+ npx --prefer-offline --yes copilotkit@4.30.0 onboard checkpoint --phase awaiting-developer --about uncommitted-file
40
40
  ```
41
41
 
42
42
  Then end your turn and wait for the developer's answer. If they allow it, spawn a fresh
43
43
  implementation subagent with the same handoff and the file added to the plan. If you
44
- cannot ask, or the developer declines, take the feature stop route below.
44
+ cannot ask, take the feature stop route below. If the developer declines, such as **no** or **not now**,
45
+ the run did not break. Run
46
+ `npx --prefer-offline --yes copilotkit@4.30.0 onboard read stopped/declined --message "<their reason>"`.
45
47
 
46
48
  If the CLI prints `## Stop: this run deleted or moved the developer's work` instead of
47
49
  a step, show the developer the list it printed, and run what they choose:
48
50
  the `onboard restore` command the tripwire stop prints, which names each deleted file, or
49
- `npx --prefer-offline --yes copilotkit@4.29.0 onboard tripwire --continue`. Then read the step again.
51
+ `npx --prefer-offline --yes copilotkit@4.30.0 onboard tripwire --continue`. Then read the step again.
50
52
 
51
53
  To route out and stop:
52
54
 
53
55
  ```text
54
- npx --prefer-offline --yes copilotkit@4.29.0 onboard read feature/stop
56
+ npx --prefer-offline --yes copilotkit@4.30.0 onboard read feature/stop
55
57
  ```
56
58
 
57
59
  If validation cannot pass, or this intent needs a prerequisite the app does not have, use
58
60
  the feature stop route above without further changes.
59
61
 
60
62
  Otherwise run
61
- `npx --prefer-offline --yes copilotkit@4.29.0 onboard read feature/rich-threads/proof`.
63
+ `npx --prefer-offline --yes copilotkit@4.30.0 onboard read feature/rich-threads/proof`.
@@ -12,13 +12,17 @@ The approval is a wait for the developer. Before you end your turn to wait, repo
12
12
  pause:
13
13
 
14
14
  ```text
15
- npx --prefer-offline --yes copilotkit@4.29.0 onboard checkpoint --phase awaiting-plan-approval
15
+ npx --prefer-offline --yes copilotkit@4.30.0 onboard checkpoint --phase awaiting-plan-approval
16
16
  ```
17
17
 
18
18
  A turn that ends while the run waits is a pause, not a stop, even when your harness ends it.
19
19
  When the answer arrives, continue from the step that paused. If the developer asks for a
20
20
  change, show the changed plan and ask again.
21
21
 
22
+ If the developer declines the plan, such as **no**, **not now** or **do not add it**, change
23
+ no files. Run
24
+ `npx --prefer-offline --yes copilotkit@4.30.0 onboard read stopped/declined --message "<their reason>"`.
25
+
22
26
  ## What this prompt takes from the start
23
27
 
24
28
  Keep these from `feature/rich-threads/start`, and give them to every subagent:
@@ -54,7 +58,7 @@ tests, and a reload/reopen proof. Ask for approval as its own question.
54
58
  Before you end your turn to wait for the developer, report the pause:
55
59
 
56
60
  ```text
57
- npx --prefer-offline --yes copilotkit@4.29.0 onboard checkpoint --phase awaiting-plan-approval
61
+ npx --prefer-offline --yes copilotkit@4.30.0 onboard checkpoint --phase awaiting-plan-approval
58
62
  ```
59
63
 
60
64
  Ask the developer before you edit a file that has uncommitted changes. List those files in
@@ -62,4 +66,4 @@ the plan under `Uncommitted files`, each with one sentence explaining why, or wr
62
66
  `git status` names them. The CLI records no consent: the approved plan is the record. The
63
67
  plan must not delete, move, or rename one of those files.
64
68
 
65
- Then run `npx --prefer-offline --yes copilotkit@4.29.0 onboard read feature/rich-threads/implement`.
69
+ Then run `npx --prefer-offline --yes copilotkit@4.30.0 onboard read feature/rich-threads/implement`.
@@ -20,23 +20,25 @@ That result is a question for the developer. Name the file and why the fix needs
20
20
  Before you end your turn to wait for the developer, report the pause:
21
21
 
22
22
  ```text
23
- npx --prefer-offline --yes copilotkit@4.29.0 onboard checkpoint --phase awaiting-developer --about uncommitted-file
23
+ npx --prefer-offline --yes copilotkit@4.30.0 onboard checkpoint --phase awaiting-developer --about uncommitted-file
24
24
  ```
25
25
 
26
26
  Then end your turn and wait for the developer's answer. If they allow it, spawn a fresh
27
27
  proof subagent with the same handoff and the file added to the plan. If you cannot ask,
28
- or the developer declines, take the feature stop route below.
28
+ take the feature stop route below. If the developer declines, such as **no** or **not now**,
29
+ the run did not break. Run
30
+ `npx --prefer-offline --yes copilotkit@4.30.0 onboard read stopped/declined --message "<their reason>"`.
29
31
 
30
32
  If the CLI prints `## Stop: this run deleted or moved the developer's work` instead of
31
33
  a step, show the developer the list it printed, and run what they choose:
32
34
  the `onboard restore` command the tripwire stop prints, which names each deleted file, or
33
- `npx --prefer-offline --yes copilotkit@4.29.0 onboard tripwire --continue`. Then read the step again.
35
+ `npx --prefer-offline --yes copilotkit@4.30.0 onboard tripwire --continue`. Then read the step again.
34
36
 
35
37
  Report the outcome of each attempt as it ends, before any repair. The command counts the
36
38
  attempts and the repairs:
37
39
 
38
40
  ```text
39
- npx --prefer-offline --yes copilotkit@4.29.0 onboard proof --step round-trip --outcome <passed|failed|skipped>
41
+ npx --prefer-offline --yes copilotkit@4.30.0 onboard proof --step round-trip --outcome <passed|failed|skipped>
40
42
  ```
41
43
 
42
44
  Use `passed` only for proved persistence and reopen, `failed` for an attempted proof that
@@ -45,9 +47,9 @@ failed, and `skipped` when the proof could not run.
45
47
  To route out and stop:
46
48
 
47
49
  ```text
48
- npx --prefer-offline --yes copilotkit@4.29.0 onboard read feature/stop
50
+ npx --prefer-offline --yes copilotkit@4.30.0 onboard read feature/stop
49
51
  ```
50
52
 
51
53
  When the proof is recorded, run
52
- `npx --prefer-offline --yes copilotkit@4.29.0 onboard read feature/complete` with the actual browser
54
+ `npx --prefer-offline --yes copilotkit@4.30.0 onboard read feature/complete` with the actual browser
53
55
  outcome.
@@ -9,11 +9,11 @@ implementation, and proof to separate subagents within the target project.
9
9
  Run this before anything else in this prompt:
10
10
 
11
11
  ```text
12
- npx --prefer-offline --yes copilotkit@4.29.0 onboard identify --coding-agent <coding-agent-slug> --model <model-id> --model-family <model-family>
12
+ npx --prefer-offline --yes copilotkit@4.30.0 onboard identify --coding-agent <coding-agent-slug> --model <model-id> --model-family <model-family>
13
13
  ```
14
14
 
15
15
  Report your product slug, such as `codex` or `claude-code`. The command needs no sign-in,
16
- browser, or project. If this run already ran `onboard identify`, skip this step.
16
+ browser, or project. If this run already ran `onboard identify` or `onboard begin`, skip this step.
17
17
 
18
18
  - `--model`: copy the model id exactly as your instructions write it. Without an exact
19
19
  model id, leave out `--model` rather than guess.
@@ -38,17 +38,17 @@ carry on. Keep a read-only assignment read-only. If no subagent works at all, re
38
38
  once:
39
39
 
40
40
  ```text
41
- npx --prefer-offline --yes copilotkit@4.29.0 onboard checkpoint --phase delegation-unavailable
41
+ npx --prefer-offline --yes copilotkit@4.30.0 onboard checkpoint --phase delegation-unavailable
42
42
  ```
43
43
 
44
44
  Before you end your turn to wait for the developer, report the pause:
45
45
 
46
46
  ```text
47
- npx --prefer-offline --yes copilotkit@4.29.0 onboard checkpoint --phase awaiting-developer --about <question>
47
+ npx --prefer-offline --yes copilotkit@4.30.0 onboard checkpoint --phase awaiting-developer --about <question>
48
48
  ```
49
49
 
50
50
  Name the question with `--about`. Use the one the prompt that asks it names, or else the
51
- closest of: `harness-permission`, `sign-in`, `setup-answers`, `stack-choice`,
51
+ closest of: `welcome`, `harness-permission`, `sign-in`, `setup-answers`, `stack-choice`,
52
52
  `project-name`, `which-project`, `env-file-tracked`, `local-connection`, `local-terms`,
53
53
  `existing-folder`,
54
54
  `environment-fix`, `uncommitted-file`, `agent-change`, `restore-files`, `thread-id`,
@@ -63,7 +63,7 @@ If you stop this run, send one short report before you stop. The friction comman
63
63
  the telemetry setting the developer already chose, so it needs no separate question.
64
64
 
65
65
  ```text
66
- npx --prefer-offline --yes copilotkit@4.29.0 onboard friction --phase stop --category <slug> --message "<sentences>"
66
+ npx --prefer-offline --yes copilotkit@4.30.0 onboard friction --phase stop --category <slug> --message "<sentences>"
67
67
  ```
68
68
 
69
69
  `--message` takes one or two sentences: the step you stopped at and what stopped it.
@@ -85,20 +85,20 @@ the current frontend-to-runtime-to-agent round trip and inspect `/info`.
85
85
  Wait for the inspection subagent to finish. Then report that the inspection came back:
86
86
 
87
87
  ```text
88
- npx --prefer-offline --yes copilotkit@4.29.0 onboard checkpoint --phase research-returned
88
+ npx --prefer-offline --yes copilotkit@4.30.0 onboard checkpoint --phase research-returned
89
89
  ```
90
90
 
91
91
  If the inspection did not prove the baseline this intent extends, stop here without
92
92
  changing files:
93
93
 
94
94
  ```text
95
- npx --prefer-offline --yes copilotkit@4.29.0 onboard read feature/stop
95
+ npx --prefer-offline --yes copilotkit@4.30.0 onboard read feature/stop
96
96
  ```
97
97
 
98
98
  When the inspection proved what this intent needs, read the next prompt now, in this turn:
99
99
 
100
100
  ```text
101
- npx --prefer-offline --yes copilotkit@4.29.0 onboard read feature/rich-threads/plan
101
+ npx --prefer-offline --yes copilotkit@4.30.0 onboard read feature/rich-threads/plan
102
102
  ```
103
103
 
104
104
  That prompt holds the plan, the developer's approval, and the paths the plan changes.
@@ -20,7 +20,7 @@ a `start` with no `--run` reprints the id this stopped run already holds, and on
20
20
  covering both reads as one run that did two different things.
21
21
 
22
22
  ```text
23
- npx --prefer-offline --yes copilotkit@4.29.0 onboard start --run <new-12-character-id>
23
+ npx --prefer-offline --yes copilotkit@4.30.0 onboard start --run <new-12-character-id>
24
24
  ```
25
25
 
26
26
  Do not read a generic onboarding node from this run. A feature run and a generic run are
@@ -48,13 +48,13 @@ put to them, stop here and send the report below.
48
48
  Before you end your turn to wait for the developer, report the pause:
49
49
 
50
50
  ```text
51
- npx --prefer-offline --yes copilotkit@4.29.0 onboard checkpoint --phase awaiting-developer --about scoped-fix
51
+ npx --prefer-offline --yes copilotkit@4.30.0 onboard checkpoint --phase awaiting-developer --about scoped-fix
52
52
  ```
53
53
 
54
54
  If they approve it, make that one fix and nothing else. Then come back into this run:
55
55
 
56
56
  ```text
57
- npx --prefer-offline --yes copilotkit@4.29.0 onboard resume --message "<approval>"
57
+ npx --prefer-offline --yes copilotkit@4.30.0 onboard resume --message "<approval>"
58
58
  ```
59
59
 
60
60
  Put the developer's approval in `--message`, in one or two sentences: the fix they
@@ -75,7 +75,7 @@ Send one short report. The friction command follows the telemetry setting the de
75
75
  already chose, so it needs no separate question.
76
76
 
77
77
  ```text
78
- npx --prefer-offline --yes copilotkit@4.29.0 onboard friction --phase stop --category <slug> --message "<sentences>"
78
+ npx --prefer-offline --yes copilotkit@4.30.0 onboard friction --phase stop --category <slug> --message "<sentences>"
79
79
  ```
80
80
 
81
81
  `--message` takes one or two sentences: the step you stopped at and what stopped it.
@@ -20,26 +20,28 @@ That result is a question for the developer. Name the file and why the work need
20
20
  Before you end your turn to wait for the developer, report the pause:
21
21
 
22
22
  ```text
23
- npx --prefer-offline --yes copilotkit@4.29.0 onboard checkpoint --phase awaiting-developer --about uncommitted-file
23
+ npx --prefer-offline --yes copilotkit@4.30.0 onboard checkpoint --phase awaiting-developer --about uncommitted-file
24
24
  ```
25
25
 
26
26
  Then end your turn and wait for the developer's answer. If they allow it, spawn a fresh
27
27
  implementation subagent with the same handoff and the file added to the plan. If you
28
- cannot ask, or the developer declines, take the feature stop route below.
28
+ cannot ask, take the feature stop route below. If the developer declines, such as **no** or **not now**,
29
+ the run did not break. Run
30
+ `npx --prefer-offline --yes copilotkit@4.30.0 onboard read stopped/declined --message "<their reason>"`.
29
31
 
30
32
  If the CLI prints `## Stop: this run deleted or moved the developer's work` instead of
31
33
  a step, show the developer the list it printed, and run what they choose:
32
34
  the `onboard restore` command the tripwire stop prints, which names each deleted file, or
33
- `npx --prefer-offline --yes copilotkit@4.29.0 onboard tripwire --continue`. Then read the step again.
35
+ `npx --prefer-offline --yes copilotkit@4.30.0 onboard tripwire --continue`. Then read the step again.
34
36
 
35
37
  To route out and stop:
36
38
 
37
39
  ```text
38
- npx --prefer-offline --yes copilotkit@4.29.0 onboard read feature/stop
40
+ npx --prefer-offline --yes copilotkit@4.30.0 onboard read feature/stop
39
41
  ```
40
42
 
41
43
  If validation cannot pass, or this intent needs a prerequisite the app does not have, use
42
44
  the feature stop route above without further changes.
43
45
 
44
46
  Otherwise run
45
- `npx --prefer-offline --yes copilotkit@4.29.0 onboard read feature/voice/proof`.
47
+ `npx --prefer-offline --yes copilotkit@4.30.0 onboard read feature/voice/proof`.
@@ -12,13 +12,17 @@ The approval is a wait for the developer. Before you end your turn to wait, repo
12
12
  pause:
13
13
 
14
14
  ```text
15
- npx --prefer-offline --yes copilotkit@4.29.0 onboard checkpoint --phase awaiting-plan-approval
15
+ npx --prefer-offline --yes copilotkit@4.30.0 onboard checkpoint --phase awaiting-plan-approval
16
16
  ```
17
17
 
18
18
  A turn that ends while the run waits is a pause, not a stop, even when your harness ends it.
19
19
  When the answer arrives, continue from the step that paused. If the developer asks for a
20
20
  change, show the changed plan and ask again.
21
21
 
22
+ If the developer declines the plan, such as **no**, **not now** or **do not add it**, change
23
+ no files. Run
24
+ `npx --prefer-offline --yes copilotkit@4.30.0 onboard read stopped/declined --message "<their reason>"`.
25
+
22
26
  ## What this prompt takes from the start
23
27
 
24
28
  Keep these from `feature/voice/start`, and give them to every subagent:
@@ -42,7 +46,7 @@ the repository proves its variable name is configured. Otherwise, explain the se
42
46
  take the feature stop route rather than writing a placeholder:
43
47
 
44
48
  ```text
45
- npx --prefer-offline --yes copilotkit@4.29.0 onboard read feature/stop
49
+ npx --prefer-offline --yes copilotkit@4.30.0 onboard read feature/stop
46
50
  ```
47
51
 
48
52
  Show a small plan for the documented transcription service, the existing composer, focused
@@ -51,7 +55,7 @@ tests, and a microphone/canned-transcript proof. Ask for approval as its own que
51
55
  Before you end your turn to wait for the developer, report the pause:
52
56
 
53
57
  ```text
54
- npx --prefer-offline --yes copilotkit@4.29.0 onboard checkpoint --phase awaiting-plan-approval
58
+ npx --prefer-offline --yes copilotkit@4.30.0 onboard checkpoint --phase awaiting-plan-approval
55
59
  ```
56
60
 
57
61
  Ask the developer before you edit a file that has uncommitted changes. List those files in
@@ -59,4 +63,4 @@ the plan under `Uncommitted files`, each with one sentence explaining why, or wr
59
63
  `git status` names them. The CLI records no consent: the approved plan is the record. The
60
64
  plan must not delete, move, or rename one of those files.
61
65
 
62
- Then run `npx --prefer-offline --yes copilotkit@4.29.0 onboard read feature/voice/implement`.
66
+ Then run `npx --prefer-offline --yes copilotkit@4.30.0 onboard read feature/voice/implement`.
@@ -19,23 +19,25 @@ That result is a question for the developer. Name the file and why the fix needs
19
19
  Before you end your turn to wait for the developer, report the pause:
20
20
 
21
21
  ```text
22
- npx --prefer-offline --yes copilotkit@4.29.0 onboard checkpoint --phase awaiting-developer --about uncommitted-file
22
+ npx --prefer-offline --yes copilotkit@4.30.0 onboard checkpoint --phase awaiting-developer --about uncommitted-file
23
23
  ```
24
24
 
25
25
  Then end your turn and wait for the developer's answer. If they allow it, spawn a fresh
26
26
  proof subagent with the same handoff and the file added to the plan. If you cannot ask,
27
- or the developer declines, take the feature stop route below.
27
+ take the feature stop route below. If the developer declines, such as **no** or **not now**,
28
+ the run did not break. Run
29
+ `npx --prefer-offline --yes copilotkit@4.30.0 onboard read stopped/declined --message "<their reason>"`.
28
30
 
29
31
  If the CLI prints `## Stop: this run deleted or moved the developer's work` instead of
30
32
  a step, show the developer the list it printed, and run what they choose:
31
33
  the `onboard restore` command the tripwire stop prints, which names each deleted file, or
32
- `npx --prefer-offline --yes copilotkit@4.29.0 onboard tripwire --continue`. Then read the step again.
34
+ `npx --prefer-offline --yes copilotkit@4.30.0 onboard tripwire --continue`. Then read the step again.
33
35
 
34
36
  Report the outcome of each attempt as it ends, before any repair. The command counts the
35
37
  attempts and the repairs:
36
38
 
37
39
  ```text
38
- npx --prefer-offline --yes copilotkit@4.29.0 onboard proof --step round-trip --outcome <passed|failed|skipped>
40
+ npx --prefer-offline --yes copilotkit@4.30.0 onboard proof --step round-trip --outcome <passed|failed|skipped>
39
41
  ```
40
42
 
41
43
  Use `passed` only for proved voice input, `failed` for an attempted proof that failed, and
@@ -44,9 +46,9 @@ Use `passed` only for proved voice input, `failed` for an attempted proof that f
44
46
  To route out and stop:
45
47
 
46
48
  ```text
47
- npx --prefer-offline --yes copilotkit@4.29.0 onboard read feature/stop
49
+ npx --prefer-offline --yes copilotkit@4.30.0 onboard read feature/stop
48
50
  ```
49
51
 
50
52
  When the proof is recorded, run
51
- `npx --prefer-offline --yes copilotkit@4.29.0 onboard read feature/complete` with the actual surface
53
+ `npx --prefer-offline --yes copilotkit@4.30.0 onboard read feature/complete` with the actual surface
52
54
  outcome.
@@ -8,11 +8,11 @@ read-only, implementation, and proof subagents, each restricted to the target pr
8
8
  Run this before anything else in this prompt:
9
9
 
10
10
  ```text
11
- npx --prefer-offline --yes copilotkit@4.29.0 onboard identify --coding-agent <coding-agent-slug> --model <model-id> --model-family <model-family>
11
+ npx --prefer-offline --yes copilotkit@4.30.0 onboard identify --coding-agent <coding-agent-slug> --model <model-id> --model-family <model-family>
12
12
  ```
13
13
 
14
14
  Report your product slug, such as `codex` or `claude-code`. The command needs no sign-in,
15
- browser, or project. If this run already ran `onboard identify`, skip this step.
15
+ browser, or project. If this run already ran `onboard identify` or `onboard begin`, skip this step.
16
16
 
17
17
  - `--model`: copy the model id exactly as your instructions write it. Without an exact
18
18
  model id, leave out `--model` rather than guess.
@@ -37,17 +37,17 @@ carry on. Keep a read-only assignment read-only. If no subagent works at all, re
37
37
  once:
38
38
 
39
39
  ```text
40
- npx --prefer-offline --yes copilotkit@4.29.0 onboard checkpoint --phase delegation-unavailable
40
+ npx --prefer-offline --yes copilotkit@4.30.0 onboard checkpoint --phase delegation-unavailable
41
41
  ```
42
42
 
43
43
  Before you end your turn to wait for the developer, report the pause:
44
44
 
45
45
  ```text
46
- npx --prefer-offline --yes copilotkit@4.29.0 onboard checkpoint --phase awaiting-developer --about <question>
46
+ npx --prefer-offline --yes copilotkit@4.30.0 onboard checkpoint --phase awaiting-developer --about <question>
47
47
  ```
48
48
 
49
49
  Name the question with `--about`. Use the one the prompt that asks it names, or else the
50
- closest of: `harness-permission`, `sign-in`, `setup-answers`, `stack-choice`,
50
+ closest of: `welcome`, `harness-permission`, `sign-in`, `setup-answers`, `stack-choice`,
51
51
  `project-name`, `which-project`, `env-file-tracked`, `local-connection`, `local-terms`,
52
52
  `existing-folder`,
53
53
  `environment-fix`, `uncommitted-file`, `agent-change`, `restore-files`, `thread-id`,
@@ -62,7 +62,7 @@ If you stop this run, send one short report before you stop. The friction comman
62
62
  the telemetry setting the developer already chose, so it needs no separate question.
63
63
 
64
64
  ```text
65
- npx --prefer-offline --yes copilotkit@4.29.0 onboard friction --phase stop --category <slug> --message "<sentences>"
65
+ npx --prefer-offline --yes copilotkit@4.30.0 onboard friction --phase stop --category <slug> --message "<sentences>"
66
66
  ```
67
67
 
68
68
  `--message` takes one or two sentences: the step you stopped at and what stopped it.
@@ -79,7 +79,7 @@ before a subagent or a project process runs.
79
79
  Before edits, inspect the runtime route, CopilotKit provider/chat composer, current agent,
80
80
  existing provider credential variable names (presence only), package versions, browser
81
81
  permissions approach, and test/dev commands. Prove the existing OSS baseline with `/info`,
82
- `npx --prefer-offline --yes copilotkit@4.29.0 verify --expect-runtime oss --round-trip --agent <agent-id> --json`,
82
+ `npx --prefer-offline --yes copilotkit@4.30.0 verify --expect-runtime oss --round-trip --agent <agent-id> --json`,
83
83
  and a real UI request when a browser is available.
84
84
  The `verify` report names the runtime URL it probed. If the dev server serves the
85
85
  runtime at another URL, add `--runtime-url <url>`.
@@ -87,20 +87,20 @@ runtime at another URL, add `--runtime-url <url>`.
87
87
  Wait for the inspection subagent to finish. Then report that the inspection came back:
88
88
 
89
89
  ```text
90
- npx --prefer-offline --yes copilotkit@4.29.0 onboard checkpoint --phase research-returned
90
+ npx --prefer-offline --yes copilotkit@4.30.0 onboard checkpoint --phase research-returned
91
91
  ```
92
92
 
93
93
  If the inspection did not prove the baseline this intent extends, stop here without
94
94
  changing files:
95
95
 
96
96
  ```text
97
- npx --prefer-offline --yes copilotkit@4.29.0 onboard read feature/stop
97
+ npx --prefer-offline --yes copilotkit@4.30.0 onboard read feature/stop
98
98
  ```
99
99
 
100
100
  When the inspection proved what this intent needs, read the next prompt now, in this turn:
101
101
 
102
102
  ```text
103
- npx --prefer-offline --yes copilotkit@4.29.0 onboard read feature/voice/plan
103
+ npx --prefer-offline --yes copilotkit@4.30.0 onboard read feature/voice/plan
104
104
  ```
105
105
 
106
106
  That prompt holds the plan, the developer's approval, and the paths the plan changes.
@@ -1,18 +1,11 @@
1
1
  # Configure AG2
2
2
 
3
- First run `npx --prefer-offline --yes copilotkit@4.29.0 onboard setup-answers`. Its `vendor` is the
3
+ First run `npx --prefer-offline --yes copilotkit@4.30.0 onboard setup-answers`. Its `vendor` is the
4
4
  vendor the framework step recorded, even after this conversation lost it, with
5
5
  `vendor.baseUrl` and `vendor.modelId` for an OpenAI-compatible provider.
6
6
 
7
7
  Preserve an existing AG2 model setup. For a new agent, use the vendor that the framework
8
- step recorded. Use OpenAI only when the record and this conversation have no vendor. This
9
- release offers a new agent on this framework OpenAI or an OpenAI-compatible provider only.
10
- For a new agent, if the developer names Anthropic or Google, say that this release
11
- supports OpenAI or an OpenAI-compatible provider on this framework, that Anthropic and
12
- Google come in a later release, and offer the built-in CopilotKit agent if they need
13
- Anthropic or Google now. An existing agent keeps its vendor and model. If it runs on
14
- Anthropic or Google, add one line to the plan: the page context that CopilotKit sends can
15
- fail with that vendor until a CopilotKit SDK release fixes it (PE-728). Take that vendor's
8
+ step recorded. Use OpenAI only when the record and this conversation have no vendor. This release offers a new agent on this framework OpenAI or an OpenAI-compatible provider only. For a new agent, if the developer names Anthropic or Google, say that this release supports OpenAI or an OpenAI-compatible provider on this framework, that Anthropic and Google come in a later release, and offer the built-in CopilotKit agent if they need Anthropic or Google now. An existing agent keeps its vendor and model. If it runs on Anthropic or Google, add one line to the plan: this CopilotKit CLI release has not proven Anthropic or Google on this framework, so a chat can fail with it. Take that vendor's
16
9
  package, class, and credential variable names from the framework's own documentation, and
17
10
  use a model id that the vendor serves to a new key today. For an OpenAI-compatible
18
11
  provider, keep `OPENAI_API_KEY`, use the model id that `setup/questions` recorded, and
@@ -47,7 +40,7 @@ Record the selected framework, vendor, model, required credential variable names
47
40
  URLs, and the A2UI documentation gap.
48
41
 
49
42
  If the pages support the selection, run
50
- `npx --prefer-offline --yes copilotkit@4.29.0 onboard read frontend/plan`.
43
+ `npx --prefer-offline --yes copilotkit@4.30.0 onboard read frontend/plan`.
51
44
 
52
45
  If the documentation does not support the selection, run
53
- `npx --prefer-offline --yes copilotkit@4.29.0 onboard read unsupported/no-validated-path`.
46
+ `npx --prefer-offline --yes copilotkit@4.30.0 onboard read unsupported/no-validated-path`.
@@ -1,18 +1,11 @@
1
1
  # Configure Agno
2
2
 
3
- First run `npx --prefer-offline --yes copilotkit@4.29.0 onboard setup-answers`. Its `vendor` is the
3
+ First run `npx --prefer-offline --yes copilotkit@4.30.0 onboard setup-answers`. Its `vendor` is the
4
4
  vendor the framework step recorded, even after this conversation lost it, with
5
5
  `vendor.baseUrl` and `vendor.modelId` for an OpenAI-compatible provider.
6
6
 
7
7
  Preserve an existing Agno model setup. For a new agent, use the vendor that the framework
8
- step recorded. Use OpenAI only when the record and this conversation have no vendor. This
9
- release offers a new agent on this framework OpenAI or an OpenAI-compatible provider only.
10
- For a new agent, if the developer names Anthropic or Google, say that this release
11
- supports OpenAI or an OpenAI-compatible provider on this framework, that Anthropic and
12
- Google come in a later release, and offer the built-in CopilotKit agent if they need
13
- Anthropic or Google now. An existing agent keeps its vendor and model. If it runs on
14
- Anthropic or Google, add one line to the plan: the page context that CopilotKit sends can
15
- fail with that vendor until a CopilotKit SDK release fixes it (PE-728). Take that vendor's
8
+ step recorded. Use OpenAI only when the record and this conversation have no vendor. OpenAI, an OpenAI-compatible provider, Anthropic, and Google work. An existing agent keeps its vendor and model. Take that vendor's
16
9
  package, class, and credential variable names from the framework's own documentation, and
17
10
  use a model id that the vendor serves to a new key today. For an OpenAI-compatible
18
11
  provider, keep `OPENAI_API_KEY`, use the model id that `setup/questions` recorded, and
@@ -51,7 +44,7 @@ Record the selected framework, vendor, model, required credential variable names
51
44
  URLs, the documented dependencies and adapter, and how the agent reads `context`.
52
45
 
53
46
  If the pages support the selection, run
54
- `npx --prefer-offline --yes copilotkit@4.29.0 onboard read frontend/plan`.
47
+ `npx --prefer-offline --yes copilotkit@4.30.0 onboard read frontend/plan`.
55
48
 
56
49
  If the documentation does not support the selection, run
57
- `npx --prefer-offline --yes copilotkit@4.29.0 onboard read unsupported/no-validated-path`.
50
+ `npx --prefer-offline --yes copilotkit@4.30.0 onboard read unsupported/no-validated-path`.
@@ -1,6 +1,6 @@
1
1
  # Configure the built-in CopilotKit agent
2
2
 
3
- First run `npx --prefer-offline --yes copilotkit@4.29.0 onboard setup-answers`. Its `vendor` is the
3
+ First run `npx --prefer-offline --yes copilotkit@4.30.0 onboard setup-answers`. Its `vendor` is the
4
4
  vendor the framework step recorded, even after this conversation lost it, with
5
5
  `vendor.baseUrl` and `vendor.modelId` for an OpenAI-compatible provider.
6
6
 
@@ -47,7 +47,7 @@ Record the selected framework, vendor, model, required credential variable names
47
47
  these URLs.
48
48
 
49
49
  If the pages support the selection, run
50
- `npx --prefer-offline --yes copilotkit@4.29.0 onboard read frontend/plan`.
50
+ `npx --prefer-offline --yes copilotkit@4.30.0 onboard read frontend/plan`.
51
51
 
52
52
  If the documentation does not support the selection, run
53
- `npx --prefer-offline --yes copilotkit@4.29.0 onboard read unsupported/no-validated-path`.
53
+ `npx --prefer-offline --yes copilotkit@4.30.0 onboard read unsupported/no-validated-path`.
@@ -1,6 +1,6 @@
1
1
  # Configure Claude Agent SDK for Python
2
2
 
3
- First run `npx --prefer-offline --yes copilotkit@4.29.0 onboard setup-answers`. Its `vendor` is the
3
+ First run `npx --prefer-offline --yes copilotkit@4.30.0 onboard setup-answers`. Its `vendor` is the
4
4
  vendor the framework step recorded, even after this conversation lost it.
5
5
 
6
6
  Preserve an existing Claude Agent SDK model setup. The Claude Agent SDK runs only
@@ -40,7 +40,7 @@ Record the selected framework, vendor, model, required credential variable names
40
40
  these URLs.
41
41
 
42
42
  If the pages support the selection, run
43
- `npx --prefer-offline --yes copilotkit@4.29.0 onboard read frontend/plan`.
43
+ `npx --prefer-offline --yes copilotkit@4.30.0 onboard read frontend/plan`.
44
44
 
45
45
  If the documentation does not support the selection, run
46
- `npx --prefer-offline --yes copilotkit@4.29.0 onboard read unsupported/no-validated-path`.
46
+ `npx --prefer-offline --yes copilotkit@4.30.0 onboard read unsupported/no-validated-path`.
@@ -1,6 +1,6 @@
1
1
  # Configure Claude Agent SDK for TypeScript
2
2
 
3
- First run `npx --prefer-offline --yes copilotkit@4.29.0 onboard setup-answers`. Its `vendor` is the
3
+ First run `npx --prefer-offline --yes copilotkit@4.30.0 onboard setup-answers`. Its `vendor` is the
4
4
  vendor the framework step recorded, even after this conversation lost it.
5
5
 
6
6
  Preserve an existing Claude Agent SDK model setup. The Claude Agent SDK runs only
@@ -44,7 +44,7 @@ Record the selected framework, vendor, model, required credential variable names
44
44
  URLs, and the context limit.
45
45
 
46
46
  If the pages support the selection, run
47
- `npx --prefer-offline --yes copilotkit@4.29.0 onboard read frontend/plan`.
47
+ `npx --prefer-offline --yes copilotkit@4.30.0 onboard read frontend/plan`.
48
48
 
49
49
  If the documentation does not support the selection, run
50
- `npx --prefer-offline --yes copilotkit@4.29.0 onboard read unsupported/no-validated-path`.
50
+ `npx --prefer-offline --yes copilotkit@4.30.0 onboard read unsupported/no-validated-path`.
@@ -1,6 +1,6 @@
1
1
  # Configure CrewAI Flows
2
2
 
3
- First run `npx --prefer-offline --yes copilotkit@4.29.0 onboard setup-answers`. When it holds a `vendor`,
3
+ First run `npx --prefer-offline --yes copilotkit@4.30.0 onboard setup-answers`. When it holds a `vendor`,
4
4
  the developer already chose it: keep it, and do not ask the vendor question below.
5
5
 
6
6
  Preserve the project's existing CrewAI Flow, provider, model, and deployment. The selected
@@ -14,13 +14,7 @@ starter, tell the developer that the starter decides the vendor. If the frontend
14
14
  sends you to its Documentation section instead, ask the vendor question below at that
15
15
  point, before the plan.
16
16
 
17
- This release offers a new agent on CrewAI Flows OpenAI or an OpenAI-compatible provider
18
- only. When the run chooses the vendor, if the developer names Anthropic or Google, say
19
- that this release supports OpenAI or an OpenAI-compatible provider on this framework, that
20
- Anthropic and Google come in a later release, and offer the built-in CopilotKit agent if
21
- they need Anthropic or Google now. An existing agent keeps its vendor and model. If it
22
- runs on Anthropic or Google, add one line to the plan: the page context that CopilotKit
23
- sends can fail with that vendor until a CopilotKit SDK release fixes it (PE-728).
17
+ This release offers a new agent on this framework OpenAI or an OpenAI-compatible provider only. For a new agent, if the developer names Anthropic or Google, say that this release supports OpenAI or an OpenAI-compatible provider on this framework, that Anthropic and Google come in a later release, and offer the built-in CopilotKit agent if they need Anthropic or Google now. An existing agent keeps its vendor and model. If it runs on Anthropic or Google, add one line to the plan: this CopilotKit CLI release has not proven Anthropic or Google on this framework, so a chat can fail with it.
24
18
 
25
19
  When the repository shows a provider, keep it and ask nothing further about it. When
26
20
  neither the repository nor these pages show one, the developer decides, so ask. Ask one
@@ -34,12 +28,12 @@ combine this with a frontend, project, or plan approval question.
34
28
  Before you end your turn to wait for the developer, report the pause:
35
29
 
36
30
  ```text
37
- npx --prefer-offline --yes copilotkit@4.29.0 onboard checkpoint --phase awaiting-developer --about stack-choice
31
+ npx --prefer-offline --yes copilotkit@4.30.0 onboard checkpoint --phase awaiting-developer --about stack-choice
38
32
  ```
39
33
 
40
34
  When the developer answers, record the answer as the project-defined provider, model, and
41
35
  credential variable name. Record the vendor in the CLI with
42
- `npx --prefer-offline --yes copilotkit@4.29.0 onboard setup-answers --vendor <vendor> --vendor-choice developer`,
36
+ `npx --prefer-offline --yes copilotkit@4.30.0 onboard setup-answers --vendor <vendor> --vendor-choice developer`,
43
37
  with `openai` or `openai-compatible`, and `--base-url <url> --model-id <id>` for the
44
38
  latter. Then continue.
45
39
 
@@ -84,7 +78,7 @@ Record the selected framework, project-defined provider and model, the credentia
84
78
  variable names the repository proves or the developer named, these URLs, and the adapter.
85
79
 
86
80
  If the pages support the selection, run
87
- `npx --prefer-offline --yes copilotkit@4.29.0 onboard read frontend/plan`.
81
+ `npx --prefer-offline --yes copilotkit@4.30.0 onboard read frontend/plan`.
88
82
 
89
83
  If the documentation does not support the selection, run
90
- `npx --prefer-offline --yes copilotkit@4.29.0 onboard read unsupported/no-validated-path`.
84
+ `npx --prefer-offline --yes copilotkit@4.30.0 onboard read unsupported/no-validated-path`.
@@ -19,13 +19,7 @@ In cases 1 and 2, do not port the agent to a listed framework, and do not rewrit
19
19
  tools, model, or prompts. Preserve its model setup and the credential variable names that
20
20
  the repository already uses. An existing agent has no default vendor on this route.
21
21
 
22
- This release offers a new agent on this route OpenAI or an OpenAI-compatible provider
23
- only. For a new agent, if the developer names Anthropic or Google, say that this release
24
- supports OpenAI or an OpenAI-compatible provider on this route, that Anthropic and Google
25
- come in a later release, and offer the built-in CopilotKit agent if they need Anthropic or
26
- Google now. An existing agent keeps its vendor and model. If it runs on Anthropic or
27
- Google, add one line to the plan: the page context that CopilotKit sends can fail with
28
- that vendor until a CopilotKit SDK release fixes it (PE-728).
22
+ This release offers a new agent on this route OpenAI or an OpenAI-compatible provider only. For a new agent, if the developer names Anthropic or Google, say that this release supports OpenAI or an OpenAI-compatible provider on this route, that Anthropic and Google come in a later release, and offer the built-in CopilotKit agent if they need Anthropic or Google now. An existing agent keeps its vendor and model. If it runs on Anthropic or Google, add one line to the plan: this CopilotKit CLI release has not proven Anthropic or Google on this framework, so a chat can fail with it.
29
23
 
30
24
  The research findings name the case and cite the file. Either of these proves case 1:
31
25
 
@@ -44,7 +38,7 @@ runs, and do not write an adapter yet.
44
38
  Before you end your turn to wait for the developer, report the pause:
45
39
 
46
40
  ```text
47
- npx --prefer-offline --yes copilotkit@4.29.0 onboard checkpoint --phase awaiting-developer --about stack-choice
41
+ npx --prefer-offline --yes copilotkit@4.30.0 onboard checkpoint --phase awaiting-developer --about stack-choice
48
42
  ```
49
43
 
50
44
  ## Documentation
@@ -94,7 +88,7 @@ it.
94
88
  Before you end your turn to wait for the developer, report the pause:
95
89
 
96
90
  ```text
97
- npx --prefer-offline --yes copilotkit@4.29.0 onboard checkpoint --phase awaiting-developer --about agent-change
91
+ npx --prefer-offline --yes copilotkit@4.30.0 onboard checkpoint --phase awaiting-developer --about agent-change
98
92
  ```
99
93
 
100
94
  ## Keep the agent working on a clone
@@ -135,7 +129,7 @@ URLs. For case 3, record the credential variable of the recorded vendor, such as
135
129
  `OPENAI_API_KEY`.
136
130
 
137
131
  If the pages support the selection, run
138
- `npx --prefer-offline --yes copilotkit@4.29.0 onboard read frontend/plan`.
132
+ `npx --prefer-offline --yes copilotkit@4.30.0 onboard read frontend/plan`.
139
133
 
140
134
  If the documentation does not support the selection, run
141
- `npx --prefer-offline --yes copilotkit@4.29.0 onboard read unsupported/no-validated-path`.
135
+ `npx --prefer-offline --yes copilotkit@4.30.0 onboard read unsupported/no-validated-path`.