copilotkit 4.23.1 → 4.25.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 (94) hide show
  1. package/README.md +164 -17
  2. package/cli-build-info.json +8 -8
  3. package/exporters/langgraph/README.md +33 -0
  4. package/exporters/langgraph/export_checkpointer.py +16 -0
  5. package/index.js +10909 -8245
  6. package/onboarding/index.json +2 -1
  7. package/onboarding/prompts/authenticate/start.md +50 -42
  8. package/onboarding/prompts/conversion/plan.md +3 -3
  9. package/onboarding/prompts/credentials/finalize-plan.md +30 -8
  10. package/onboarding/prompts/credentials/plan.md +115 -49
  11. package/onboarding/prompts/credentials/settle-credentials.md +16 -5
  12. package/onboarding/prompts/credentials/write-plan.md +15 -15
  13. package/onboarding/prompts/deployment/choose-local.md +62 -14
  14. package/onboarding/prompts/deployment/local-evaluation.md +37 -7
  15. package/onboarding/prompts/fallback/best-effort.md +8 -8
  16. package/onboarding/prompts/feature/a2ui/implement.md +15 -8
  17. package/onboarding/prompts/feature/a2ui/plan.md +15 -7
  18. package/onboarding/prompts/feature/a2ui/proof.md +14 -7
  19. package/onboarding/prompts/feature/a2ui/start.md +26 -8
  20. package/onboarding/prompts/feature/channels/implement.md +21 -9
  21. package/onboarding/prompts/feature/channels/plan.md +15 -7
  22. package/onboarding/prompts/feature/channels/proof.md +14 -7
  23. package/onboarding/prompts/feature/channels/start.md +30 -19
  24. package/onboarding/prompts/feature/chat-suggestions/implement.md +15 -8
  25. package/onboarding/prompts/feature/chat-suggestions/plan.md +15 -7
  26. package/onboarding/prompts/feature/chat-suggestions/proof.md +14 -7
  27. package/onboarding/prompts/feature/chat-suggestions/start.md +26 -8
  28. package/onboarding/prompts/feature/complete.md +2 -2
  29. package/onboarding/prompts/feature/learning/implement.md +32 -18
  30. package/onboarding/prompts/feature/learning/plan.md +15 -7
  31. package/onboarding/prompts/feature/learning/proof.md +76 -9
  32. package/onboarding/prompts/feature/learning/start.md +26 -8
  33. package/onboarding/prompts/feature/open-generative-ui/implement.md +15 -8
  34. package/onboarding/prompts/feature/open-generative-ui/plan.md +15 -7
  35. package/onboarding/prompts/feature/open-generative-ui/proof.md +14 -7
  36. package/onboarding/prompts/feature/open-generative-ui/start.md +26 -8
  37. package/onboarding/prompts/feature/realtime-sync/implement.md +20 -12
  38. package/onboarding/prompts/feature/realtime-sync/plan.md +15 -7
  39. package/onboarding/prompts/feature/realtime-sync/proof.md +14 -7
  40. package/onboarding/prompts/feature/realtime-sync/start.md +25 -7
  41. package/onboarding/prompts/feature/rich-threads/implement.md +21 -13
  42. package/onboarding/prompts/feature/rich-threads/plan.md +15 -7
  43. package/onboarding/prompts/feature/rich-threads/proof.md +14 -7
  44. package/onboarding/prompts/feature/rich-threads/start.md +25 -7
  45. package/onboarding/prompts/feature/stop.md +9 -3
  46. package/onboarding/prompts/feature/voice/implement.md +15 -8
  47. package/onboarding/prompts/feature/voice/plan.md +16 -8
  48. package/onboarding/prompts/feature/voice/proof.md +14 -7
  49. package/onboarding/prompts/feature/voice/start.md +26 -8
  50. package/onboarding/prompts/framework/ag2.md +6 -5
  51. package/onboarding/prompts/framework/agno.md +6 -5
  52. package/onboarding/prompts/framework/built-in.md +9 -6
  53. package/onboarding/prompts/framework/claude-sdk-python.md +2 -2
  54. package/onboarding/prompts/framework/claude-sdk-typescript.md +2 -2
  55. package/onboarding/prompts/framework/crewai-flows.md +12 -4
  56. package/onboarding/prompts/framework/custom-ag-ui.md +8 -2
  57. package/onboarding/prompts/framework/deep-agents.md +6 -5
  58. package/onboarding/prompts/framework/google-adk.md +2 -2
  59. package/onboarding/prompts/framework/langgraph-fastapi.md +8 -5
  60. package/onboarding/prompts/framework/langgraph-python.md +8 -5
  61. package/onboarding/prompts/framework/langgraph-typescript.md +8 -5
  62. package/onboarding/prompts/framework/llamaindex.md +6 -5
  63. package/onboarding/prompts/framework/mastra.md +9 -6
  64. package/onboarding/prompts/framework/ms-agent-dotnet.md +12 -4
  65. package/onboarding/prompts/framework/ms-agent-harness-dotnet.md +12 -4
  66. package/onboarding/prompts/framework/ms-agent-python.md +6 -5
  67. package/onboarding/prompts/framework/pydantic-ai.md +6 -5
  68. package/onboarding/prompts/framework/strands-python.md +10 -6
  69. package/onboarding/prompts/framework/strands-typescript.md +10 -6
  70. package/onboarding/prompts/frontend/angular.md +10 -3
  71. package/onboarding/prompts/frontend/nextjs.md +36 -3
  72. package/onboarding/prompts/frontend/plan.md +13 -7
  73. package/onboarding/prompts/frontend/react-native.md +9 -2
  74. package/onboarding/prompts/frontend/react-spa.md +9 -2
  75. package/onboarding/prompts/frontend/vue.md +9 -2
  76. package/onboarding/prompts/implementation/build-and-validate.md +49 -21
  77. package/onboarding/prompts/proof/complete.md +3 -3
  78. package/onboarding/prompts/proof/oss-baseline.md +30 -13
  79. package/onboarding/prompts/proof/round-trip.md +55 -17
  80. package/onboarding/prompts/research/gather.md +21 -11
  81. package/onboarding/prompts/research/merge.md +8 -2
  82. package/onboarding/prompts/research/preflight.md +2 -2
  83. package/onboarding/prompts/research/route.md +14 -7
  84. package/onboarding/prompts/starter/clone.md +151 -9
  85. package/onboarding/prompts/stopped/run-failed.md +8 -2
  86. package/onboarding/prompts/subagent/create-plan.md +9 -2
  87. package/onboarding/prompts/subagent/implement-and-validate.md +2 -2
  88. package/onboarding/prompts/subagent/inspect-repository.md +12 -6
  89. package/onboarding/prompts/subagent/prove-oss-baseline.md +6 -1
  90. package/onboarding/prompts/subagent/prove-round-trip.md +53 -10
  91. package/onboarding/prompts/unsupported/no-validated-path.md +8 -2
  92. package/package.json +1 -1
  93. package/release/release-tool.js +18 -1
  94. package/services/local-auth-worker.js +175 -159
@@ -3,6 +3,24 @@
3
3
  Treat voice as an OSS enhancement to an existing CopilotKit chat. Orchestrate with separate
4
4
  read-only, implementation, and proof subagents, each restricted to the target project.
5
5
 
6
+ ## First, say which coding agent you are
7
+
8
+ Run this before anything else in this prompt:
9
+
10
+ ```text
11
+ npx --prefer-offline --yes copilotkit@4.25.0 onboard identify --coding-agent <coding-agent-slug> --model <model-id> --model-family <model-family>
12
+ ```
13
+
14
+ Report your product slug, such as `codex` or `claude-code`. The command needs no sign-in,
15
+ browser, or project. If this run already ran `onboard identify`, skip this step.
16
+
17
+ - `--model`: copy the model id exactly as your instructions write it. Without an exact
18
+ model id, leave out `--model` rather than guess.
19
+ - `--model-family`: give it even without `--model`. Closest of: `claude-opus`,
20
+ `claude-sonnet`, `claude-haiku`, `gpt-5`, `gemini`, `grok`, `glm`, `minimax`, `mimo`,
21
+ `deepseek`, `qwen`, `kimi`, else the model's series. Leave it out if you do not know it.
22
+ - Never give your product slug as a model, or as an unlisted family.
23
+
6
24
  ## Waits, stops, and subagents
7
25
 
8
26
  A run that starts here has not read these rules yet, so they come first. They cover this
@@ -19,13 +37,13 @@ carry on. Keep a read-only assignment read-only. If no subagent works at all, re
19
37
  once:
20
38
 
21
39
  ```text
22
- npx --prefer-offline --yes copilotkit@4.23.1 onboard checkpoint --phase delegation-unavailable
40
+ npx --prefer-offline --yes copilotkit@4.25.0 onboard checkpoint --phase delegation-unavailable
23
41
  ```
24
42
 
25
43
  Before you end your turn to wait for the developer, report the pause:
26
44
 
27
45
  ```text
28
- npx --prefer-offline --yes copilotkit@4.23.1 onboard checkpoint --phase awaiting-developer
46
+ npx --prefer-offline --yes copilotkit@4.25.0 onboard checkpoint --phase awaiting-developer
29
47
  ```
30
48
 
31
49
  A turn that ends while the run waits is a pause, not a stop, even when your harness ends it.
@@ -35,7 +53,7 @@ If you stop this run, send one short report before you stop. The friction comman
35
53
  the telemetry setting the developer already chose, so it needs no separate question.
36
54
 
37
55
  ```text
38
- npx --prefer-offline --yes copilotkit@4.23.1 onboard friction --phase stop --category <slug> --message "<sentences>"
56
+ npx --prefer-offline --yes copilotkit@4.25.0 onboard friction --phase stop --category <slug> --message "<sentences>"
39
57
  ```
40
58
 
41
59
  `--message` takes one or two sentences: the step you stopped at and what stopped it.
@@ -49,7 +67,7 @@ one scoped fix, and sends the report itself when no fix is approved.
49
67
  Before any subagent or project process runs, capture the developer's existing work:
50
68
 
51
69
  ```text
52
- npx --prefer-offline --yes copilotkit@4.23.1 onboard protect
70
+ npx --prefer-offline --yes copilotkit@4.25.0 onboard protect
53
71
  ```
54
72
 
55
73
  Keep the exact protected path list it prints and give that list to every subagent. No
@@ -59,26 +77,26 @@ approved authorization before implementation.
59
77
  Before edits, inspect the runtime route, CopilotKit provider/chat composer, current agent,
60
78
  existing provider credential variable names (presence only), package versions, browser
61
79
  permissions approach, and test/dev commands. Prove the existing OSS baseline with `/info`,
62
- `npx --prefer-offline --yes copilotkit@4.23.1 verify --expect-runtime oss --round-trip --agent <agent-id> --json`,
80
+ `npx --prefer-offline --yes copilotkit@4.25.0 verify --expect-runtime oss --round-trip --agent <agent-id> --json`,
63
81
  and a real UI request when a browser is available.
64
82
 
65
83
  Wait for the inspection subagent to finish. Then report that the inspection came back:
66
84
 
67
85
  ```text
68
- npx --prefer-offline --yes copilotkit@4.23.1 onboard checkpoint --phase research-returned
86
+ npx --prefer-offline --yes copilotkit@4.25.0 onboard checkpoint --phase research-returned
69
87
  ```
70
88
 
71
89
  If the inspection did not prove the baseline this intent extends, stop here without
72
90
  changing files:
73
91
 
74
92
  ```text
75
- npx --prefer-offline --yes copilotkit@4.23.1 onboard read feature/stop
93
+ npx --prefer-offline --yes copilotkit@4.25.0 onboard read feature/stop
76
94
  ```
77
95
 
78
96
  When the inspection proved what this intent needs, read the next prompt now, in this turn:
79
97
 
80
98
  ```text
81
- npx --prefer-offline --yes copilotkit@4.23.1 onboard read feature/voice/plan
99
+ npx --prefer-offline --yes copilotkit@4.25.0 onboard read feature/voice/plan
82
100
  ```
83
101
 
84
102
  That prompt holds the plan, the developer's approval, and the paths the plan changes.
@@ -1,8 +1,9 @@
1
1
  # Configure AG2
2
2
 
3
- Preserve an existing AG2 model setup. Start with OpenAI for a new agent. Offer another
4
- vendor only after an exact CopilotKit Markdown page names it. The page must name its
5
- credential variables and setup steps.
3
+ Preserve an existing AG2 model setup. For a new agent, use the vendor that the framework
4
+ step recorded. If it recorded none, use OpenAI. Offer another vendor only after an exact
5
+ CopilotKit Markdown page names it. The page must name its credential variables and setup
6
+ steps.
6
7
 
7
8
  Name the default model credential `OPENAI_API_KEY`.
8
9
 
@@ -31,7 +32,7 @@ Record the selected framework, vendor, model, required credential variable names
31
32
  URLs, and the A2UI documentation gap.
32
33
 
33
34
  If the pages support the selection, run
34
- `npx --prefer-offline --yes copilotkit@4.23.1 onboard read frontend/plan`.
35
+ `npx --prefer-offline --yes copilotkit@4.25.0 onboard read frontend/plan`.
35
36
 
36
37
  If the documentation does not support the selection, run
37
- `npx --prefer-offline --yes copilotkit@4.23.1 onboard read unsupported/no-validated-path`.
38
+ `npx --prefer-offline --yes copilotkit@4.25.0 onboard read unsupported/no-validated-path`.
@@ -1,8 +1,9 @@
1
1
  # Configure Agno
2
2
 
3
- Preserve an existing Agno model setup. Start with OpenAI for a new agent. Offer another
4
- vendor only after an exact CopilotKit Markdown page names it. The page must name its
5
- credential variables and setup steps.
3
+ Preserve an existing Agno model setup. For a new agent, use the vendor that the framework
4
+ step recorded. If it recorded none, use OpenAI. Offer another vendor only after an exact
5
+ CopilotKit Markdown page names it. The page must name its credential variables and setup
6
+ steps.
6
7
 
7
8
  Name the default model credential `OPENAI_API_KEY`.
8
9
 
@@ -34,7 +35,7 @@ Record the selected framework, vendor, model, required credential variable names
34
35
  URLs, the documented dependencies and adapter, and the context documentation gap.
35
36
 
36
37
  If the pages support the selection, run
37
- `npx --prefer-offline --yes copilotkit@4.23.1 onboard read frontend/plan`.
38
+ `npx --prefer-offline --yes copilotkit@4.25.0 onboard read frontend/plan`.
38
39
 
39
40
  If the documentation does not support the selection, run
40
- `npx --prefer-offline --yes copilotkit@4.23.1 onboard read unsupported/no-validated-path`.
41
+ `npx --prefer-offline --yes copilotkit@4.25.0 onboard read unsupported/no-validated-path`.
@@ -1,10 +1,13 @@
1
1
  # Configure the built-in CopilotKit agent
2
2
 
3
- Preserve an existing built-in agent model setup. Start with OpenAI for a new agent. Offer
4
- another vendor only after an exact CopilotKit Markdown page names it. The page must name
5
- its credential variables and setup steps.
3
+ Preserve an existing built-in agent model setup. For a new agent, use the vendor that the
4
+ framework step recorded. If it recorded none, use OpenAI. Offer another vendor only after
5
+ an exact CopilotKit Markdown page names it. The page must name its credential variables
6
+ and setup steps.
6
7
 
7
- Name the default model credential `OPENAI_API_KEY`.
8
+ Name the default model credential `OPENAI_API_KEY`. For Anthropic, name it
9
+ `ANTHROPIC_API_KEY`. For Google, name it `GOOGLE_API_KEY`. Take the model id for the
10
+ chosen vendor, in the `provider:model` form, from the model selection page.
8
11
 
9
12
  The built-in agent runs in the CopilotKit Runtime process.
10
13
  Do not create or start a separate agent server.
@@ -29,7 +32,7 @@ Record the selected framework, vendor, model, required credential variable names
29
32
  these URLs.
30
33
 
31
34
  If the pages support the selection, run
32
- `npx --prefer-offline --yes copilotkit@4.23.1 onboard read frontend/plan`.
35
+ `npx --prefer-offline --yes copilotkit@4.25.0 onboard read frontend/plan`.
33
36
 
34
37
  If the documentation does not support the selection, run
35
- `npx --prefer-offline --yes copilotkit@4.23.1 onboard read unsupported/no-validated-path`.
38
+ `npx --prefer-offline --yes copilotkit@4.25.0 onboard read unsupported/no-validated-path`.
@@ -34,7 +34,7 @@ Record the selected framework, vendor, model, required credential variable names
34
34
  these URLs.
35
35
 
36
36
  If the pages support the selection, run
37
- `npx --prefer-offline --yes copilotkit@4.23.1 onboard read frontend/plan`.
37
+ `npx --prefer-offline --yes copilotkit@4.25.0 onboard read frontend/plan`.
38
38
 
39
39
  If the documentation does not support the selection, run
40
- `npx --prefer-offline --yes copilotkit@4.23.1 onboard read unsupported/no-validated-path`.
40
+ `npx --prefer-offline --yes copilotkit@4.25.0 onboard read unsupported/no-validated-path`.
@@ -37,7 +37,7 @@ Record the selected framework, vendor, model, required credential variable names
37
37
  URLs, and the context limit.
38
38
 
39
39
  If the pages support the selection, run
40
- `npx --prefer-offline --yes copilotkit@4.23.1 onboard read frontend/plan`.
40
+ `npx --prefer-offline --yes copilotkit@4.25.0 onboard read frontend/plan`.
41
41
 
42
42
  If the documentation does not support the selection, run
43
- `npx --prefer-offline --yes copilotkit@4.23.1 onboard read unsupported/no-validated-path`.
43
+ `npx --prefer-offline --yes copilotkit@4.25.0 onboard read unsupported/no-validated-path`.
@@ -18,8 +18,16 @@ CrewAI pages name no vendor, so this release makes no recommendation here and wi
18
18
  pick one. If the developer names a vendor and no variable name, propose the variable name
19
19
  that vendor's own client reads and ask them to confirm it. A proposal the developer
20
20
  confirms is theirs. Ask for a variable name, never the value it holds. Do not combine this
21
- with a frontend, project, or plan-approval question. Record the answer as the
22
- project-defined provider, model, and credential variable name, and continue.
21
+ with a frontend, project, or plan-approval question.
22
+
23
+ Before you end your turn to wait for the developer, report the pause:
24
+
25
+ ```text
26
+ npx --prefer-offline --yes copilotkit@4.25.0 onboard checkpoint --phase awaiting-developer
27
+ ```
28
+
29
+ When the developer answers, record the answer as the project-defined provider, model, and
30
+ credential variable name, and continue.
23
31
 
24
32
  A vendor nobody has chosen yet is not a missing supported path. This release supports
25
33
  CrewAI Flows. Do not run the unsupported route below because the project defines no
@@ -62,7 +70,7 @@ Record the selected framework, project-defined provider and model, the credentia
62
70
  variable names the repository proves or the developer named, these URLs, and the adapter.
63
71
 
64
72
  If the pages support the selection, run
65
- `npx --prefer-offline --yes copilotkit@4.23.1 onboard read frontend/plan`.
73
+ `npx --prefer-offline --yes copilotkit@4.25.0 onboard read frontend/plan`.
66
74
 
67
75
  If the documentation does not support the selection, run
68
- `npx --prefer-offline --yes copilotkit@4.23.1 onboard read unsupported/no-validated-path`.
76
+ `npx --prefer-offline --yes copilotkit@4.25.0 onboard read unsupported/no-validated-path`.
@@ -60,6 +60,12 @@ If the project's `@ag-ui/client` version is not the runtime's version, name both
60
60
  in the plan. The agent depends on its own version, so ask the developer before you change
61
61
  it.
62
62
 
63
+ Before you end your turn to wait for the developer, report the pause:
64
+
65
+ ```text
66
+ npx --prefer-offline --yes copilotkit@4.25.0 onboard checkpoint --phase awaiting-developer
67
+ ```
68
+
63
69
  ## Keep the agent working on a clone
64
70
 
65
71
  The runtime clones the registered agent for every request. `AbstractAgent.clone()`
@@ -95,7 +101,7 @@ credential variable names that the agent already uses, the `clone()` finding, an
95
101
  URLs.
96
102
 
97
103
  If the pages support the selection, run
98
- `npx --prefer-offline --yes copilotkit@4.23.1 onboard read frontend/plan`.
104
+ `npx --prefer-offline --yes copilotkit@4.25.0 onboard read frontend/plan`.
99
105
 
100
106
  If the documentation does not support the selection, run
101
- `npx --prefer-offline --yes copilotkit@4.23.1 onboard read unsupported/no-validated-path`.
107
+ `npx --prefer-offline --yes copilotkit@4.25.0 onboard read unsupported/no-validated-path`.
@@ -1,8 +1,9 @@
1
1
  # Configure Deep Agents
2
2
 
3
- Preserve an existing Deep Agents language and model setup. Start with OpenAI for a new
4
- agent. Offer another vendor only after an exact CopilotKit Markdown page names it. The
5
- page must name its credential variables and setup steps.
3
+ Preserve an existing Deep Agents language and model setup. For a new agent, use the vendor
4
+ that the framework step recorded. If it recorded none, use OpenAI. Offer another vendor
5
+ only after an exact CopilotKit Markdown page names it. The page must name its credential
6
+ variables and setup steps.
6
7
 
7
8
  Name the default model credential `OPENAI_API_KEY`.
8
9
 
@@ -33,7 +34,7 @@ Record the selected framework, language, vendor, model, required credential vari
33
34
  names, these URLs, and each documentation gap.
34
35
 
35
36
  If the pages support the selection, run
36
- `npx --prefer-offline --yes copilotkit@4.23.1 onboard read frontend/plan`.
37
+ `npx --prefer-offline --yes copilotkit@4.25.0 onboard read frontend/plan`.
37
38
 
38
39
  If the documentation does not support the selection, run
39
- `npx --prefer-offline --yes copilotkit@4.23.1 onboard read unsupported/no-validated-path`.
40
+ `npx --prefer-offline --yes copilotkit@4.25.0 onboard read unsupported/no-validated-path`.
@@ -30,7 +30,7 @@ Record the selected framework, vendor, model, required credential variable names
30
30
  these URLs.
31
31
 
32
32
  If the pages support the selection, run
33
- `npx --prefer-offline --yes copilotkit@4.23.1 onboard read frontend/plan`.
33
+ `npx --prefer-offline --yes copilotkit@4.25.0 onboard read frontend/plan`.
34
34
 
35
35
  If the documentation does not support the selection, run
36
- `npx --prefer-offline --yes copilotkit@4.23.1 onboard read unsupported/no-validated-path`.
36
+ `npx --prefer-offline --yes copilotkit@4.25.0 onboard read unsupported/no-validated-path`.
@@ -1,8 +1,11 @@
1
1
  # Configure LangGraph FastAPI
2
2
 
3
- Preserve an existing LangGraph FastAPI model setup. Start with OpenAI for a new agent.
4
- Offer another vendor only after an exact CopilotKit Markdown page names it. The page must
5
- name its credential variables and setup steps.
3
+ Preserve an existing LangGraph FastAPI model setup. For a new agent, use the vendor that
4
+ the framework step recorded. If it recorded none, use OpenAI. Offer another vendor only
5
+ after an exact CopilotKit Markdown page names it. The page must name its credential
6
+ variables and setup steps.
7
+
8
+ Name the default model credential `OPENAI_API_KEY`.
6
9
 
7
10
  ## Documentation
8
11
 
@@ -25,7 +28,7 @@ Record the selected framework, vendor, model, required credential variable names
25
28
  these URLs.
26
29
 
27
30
  If the pages support the selection, run
28
- `npx --prefer-offline --yes copilotkit@4.23.1 onboard read frontend/plan`.
31
+ `npx --prefer-offline --yes copilotkit@4.25.0 onboard read frontend/plan`.
29
32
 
30
33
  If the documentation does not support the selection, run
31
- `npx --prefer-offline --yes copilotkit@4.23.1 onboard read unsupported/no-validated-path`.
34
+ `npx --prefer-offline --yes copilotkit@4.25.0 onboard read unsupported/no-validated-path`.
@@ -1,8 +1,11 @@
1
1
  # Configure LangGraph Python
2
2
 
3
- Preserve an existing LangGraph Python model setup. Start with OpenAI for a new agent.
4
- Offer another vendor only after an exact CopilotKit Markdown page names it. The page must
5
- name its credential variables and setup steps.
3
+ Preserve an existing LangGraph Python model setup. For a new agent, use the vendor that
4
+ the framework step recorded. If it recorded none, use OpenAI. Offer another vendor only
5
+ after an exact CopilotKit Markdown page names it. The page must name its credential
6
+ variables and setup steps.
7
+
8
+ Name the default model credential `OPENAI_API_KEY`.
6
9
 
7
10
  ## Documentation
8
11
 
@@ -19,7 +22,7 @@ Record the selected framework, vendor, model, required credential variable names
19
22
  these URLs.
20
23
 
21
24
  If the pages support the selection, run
22
- `npx --prefer-offline --yes copilotkit@4.23.1 onboard read frontend/plan`.
25
+ `npx --prefer-offline --yes copilotkit@4.25.0 onboard read frontend/plan`.
23
26
 
24
27
  If the documentation does not support the selection, run
25
- `npx --prefer-offline --yes copilotkit@4.23.1 onboard read unsupported/no-validated-path`.
28
+ `npx --prefer-offline --yes copilotkit@4.25.0 onboard read unsupported/no-validated-path`.
@@ -1,8 +1,11 @@
1
1
  # Configure LangGraph TypeScript
2
2
 
3
- Preserve an existing LangGraph TypeScript model setup. Start with OpenAI for a new agent.
4
- Offer another vendor only after an exact CopilotKit Markdown page names it. The page must
5
- name its credential variables and setup steps.
3
+ Preserve an existing LangGraph TypeScript model setup. For a new agent, use the vendor
4
+ that the framework step recorded. If it recorded none, use OpenAI. Offer another vendor
5
+ only after an exact CopilotKit Markdown page names it. The page must name its credential
6
+ variables and setup steps.
7
+
8
+ Name the default model credential `OPENAI_API_KEY`.
6
9
 
7
10
  ## Documentation
8
11
 
@@ -19,7 +22,7 @@ Record the selected framework, vendor, model, required credential variable names
19
22
  these URLs.
20
23
 
21
24
  If the pages support the selection, run
22
- `npx --prefer-offline --yes copilotkit@4.23.1 onboard read frontend/plan`.
25
+ `npx --prefer-offline --yes copilotkit@4.25.0 onboard read frontend/plan`.
23
26
 
24
27
  If the documentation does not support the selection, run
25
- `npx --prefer-offline --yes copilotkit@4.23.1 onboard read unsupported/no-validated-path`.
28
+ `npx --prefer-offline --yes copilotkit@4.25.0 onboard read unsupported/no-validated-path`.
@@ -1,8 +1,9 @@
1
1
  # Configure LlamaIndex
2
2
 
3
- Preserve an existing LlamaIndex model setup. Start with OpenAI for a new agent. Offer
4
- another vendor only after an exact CopilotKit Markdown page names it. The page must name
5
- its credential variables and setup steps.
3
+ Preserve an existing LlamaIndex model setup. For a new agent, use the vendor that the
4
+ framework step recorded. If it recorded none, use OpenAI. Offer another vendor only after
5
+ an exact CopilotKit Markdown page names it. The page must name its credential variables
6
+ and setup steps.
6
7
 
7
8
  Name the default model credential `OPENAI_API_KEY`.
8
9
 
@@ -34,7 +35,7 @@ Record the selected framework, vendor, model, required credential variable names
34
35
  URLs, the documented dependencies and adapter, and both documentation limits.
35
36
 
36
37
  If the pages support the selection, run
37
- `npx --prefer-offline --yes copilotkit@4.23.1 onboard read frontend/plan`.
38
+ `npx --prefer-offline --yes copilotkit@4.25.0 onboard read frontend/plan`.
38
39
 
39
40
  If the documentation does not support the selection, run
40
- `npx --prefer-offline --yes copilotkit@4.23.1 onboard read unsupported/no-validated-path`.
41
+ `npx --prefer-offline --yes copilotkit@4.25.0 onboard read unsupported/no-validated-path`.
@@ -1,10 +1,13 @@
1
1
  # Configure Mastra
2
2
 
3
- Preserve an existing Mastra model setup. Start with OpenAI for a new agent. Offer
4
- another vendor only after an exact CopilotKit Markdown page names it. The page must name
5
- its credential variables and setup steps.
3
+ Preserve an existing Mastra model setup. For a new agent, use the vendor that the
4
+ framework step recorded. If it recorded none, use OpenAI. Offer another vendor only after
5
+ an exact CopilotKit Markdown page names it. The page must name its credential variables
6
+ and setup steps.
6
7
 
7
- Name the model credential `OPENAI_API_KEY`.
8
+ Name the default model credential `OPENAI_API_KEY`. For Anthropic, follow the
9
+ quickstart's steps to run the agent on Anthropic, and name the credential
10
+ `ANTHROPIC_API_KEY`.
8
11
 
9
12
  `mastra dev` loads the `.env` beside the project it serves and does not look in a
10
13
  parent directory. When one credential file serves more than one part of the repository,
@@ -47,7 +50,7 @@ Record the selected framework, vendor, model, required credential variable names
47
50
  these URLs.
48
51
 
49
52
  If the pages support the selection, run
50
- `npx --prefer-offline --yes copilotkit@4.23.1 onboard read frontend/plan`.
53
+ `npx --prefer-offline --yes copilotkit@4.25.0 onboard read frontend/plan`.
51
54
 
52
55
  If the documentation does not support the selection, run
53
- `npx --prefer-offline --yes copilotkit@4.23.1 onboard read unsupported/no-validated-path`.
56
+ `npx --prefer-offline --yes copilotkit@4.25.0 onboard read unsupported/no-validated-path`.
@@ -15,8 +15,16 @@ Run `dotnet --version` before you change the project. If it fails, no .NET SDK i
15
15
  shell's PATH. Do not change the project, and do not install the SDK yourself. Tell the
16
16
  developer to install the .NET SDK from https://dotnet.microsoft.com/download. Say that the
17
17
  coding agent's shell cannot see a new install until the developer restarts the coding
18
- agent. Give them `npx --prefer-offline --yes copilotkit@4.23.1 onboard start --run <onboarding_run_id>`
19
- to resume the run after the restart. Then end your turn and wait for the developer.
18
+ agent. Give them `npx --prefer-offline --yes copilotkit@4.25.0 onboard start --run <onboarding_run_id>`
19
+ to resume the run after the restart.
20
+
21
+ Before you end your turn to wait for the developer, report the pause:
22
+
23
+ ```text
24
+ npx --prefer-offline --yes copilotkit@4.25.0 onboard checkpoint --phase awaiting-developer
25
+ ```
26
+
27
+ Then end your turn and wait for the developer.
20
28
 
21
29
  ## Documentation
22
30
 
@@ -41,7 +49,7 @@ Record the selected framework, provider, model, required credential variable nam
41
49
  these URLs.
42
50
 
43
51
  If the pages support the selection, run
44
- `npx --prefer-offline --yes copilotkit@4.23.1 onboard read frontend/plan`.
52
+ `npx --prefer-offline --yes copilotkit@4.25.0 onboard read frontend/plan`.
45
53
 
46
54
  If the documentation does not support the selection, run
47
- `npx --prefer-offline --yes copilotkit@4.23.1 onboard read unsupported/no-validated-path`.
55
+ `npx --prefer-offline --yes copilotkit@4.25.0 onboard read unsupported/no-validated-path`.
@@ -9,8 +9,16 @@ you change the project. If it fails, no .NET SDK is on this shell's PATH. Do not
9
9
  the project, and do not install the SDK yourself. Tell the developer to install the .NET
10
10
  SDK from https://dotnet.microsoft.com/download. Say that the coding agent's shell cannot
11
11
  see a new install until the developer restarts the coding agent. Give them
12
- `npx --prefer-offline --yes copilotkit@4.23.1 onboard start --run <onboarding_run_id>` to resume the run
13
- after the restart. Then end your turn and wait for the developer.
12
+ `npx --prefer-offline --yes copilotkit@4.25.0 onboard start --run <onboarding_run_id>` to resume the run
13
+ after the restart.
14
+
15
+ Before you end your turn to wait for the developer, report the pause:
16
+
17
+ ```text
18
+ npx --prefer-offline --yes copilotkit@4.25.0 onboard checkpoint --phase awaiting-developer
19
+ ```
20
+
21
+ Then end your turn and wait for the developer.
14
22
 
15
23
  ## Documentation
16
24
 
@@ -49,7 +57,7 @@ Record the selected framework, provider, model, required credential variable nam
49
57
  URLs, and the quickstart gap.
50
58
 
51
59
  If the pages support the selection, run
52
- `npx --prefer-offline --yes copilotkit@4.23.1 onboard read frontend/plan`.
60
+ `npx --prefer-offline --yes copilotkit@4.25.0 onboard read frontend/plan`.
53
61
 
54
62
  If the documentation does not support the selection, run
55
- `npx --prefer-offline --yes copilotkit@4.23.1 onboard read unsupported/no-validated-path`.
63
+ `npx --prefer-offline --yes copilotkit@4.25.0 onboard read unsupported/no-validated-path`.
@@ -1,8 +1,9 @@
1
1
  # Configure Microsoft Agent Framework for Python
2
2
 
3
- Preserve an existing Microsoft Agent Framework model setup. Start with OpenAI for a new
4
- agent. Offer another vendor only after an exact CopilotKit Markdown page names it. The
5
- page must name its credential variables and setup steps.
3
+ Preserve an existing Microsoft Agent Framework model setup. For a new agent, use the
4
+ vendor that the framework step recorded. If it recorded none, use OpenAI. Offer another
5
+ vendor only after an exact CopilotKit Markdown page names it. The page must name its
6
+ credential variables and setup steps.
6
7
 
7
8
  Name the model credential `OPENAI_API_KEY`, in `agent/.env`, for a new agent. This
8
9
  framework also accepts Azure OpenAI, through `AZURE_OPENAI_ENDPOINT` and
@@ -30,7 +31,7 @@ Record the selected framework, vendor, model, required credential variable names
30
31
  these URLs.
31
32
 
32
33
  If the pages support the selection, run
33
- `npx --prefer-offline --yes copilotkit@4.23.1 onboard read frontend/plan`.
34
+ `npx --prefer-offline --yes copilotkit@4.25.0 onboard read frontend/plan`.
34
35
 
35
36
  If the documentation does not support the selection, run
36
- `npx --prefer-offline --yes copilotkit@4.23.1 onboard read unsupported/no-validated-path`.
37
+ `npx --prefer-offline --yes copilotkit@4.25.0 onboard read unsupported/no-validated-path`.
@@ -1,8 +1,9 @@
1
1
  # Configure Pydantic AI
2
2
 
3
- Preserve an existing Pydantic AI model setup. Start with OpenAI for a new agent. Offer
4
- another vendor only after an exact CopilotKit Markdown page names it. The page must name
5
- its credential variables and setup steps.
3
+ Preserve an existing Pydantic AI model setup. For a new agent, use the vendor that the
4
+ framework step recorded. If it recorded none, use OpenAI. Offer another vendor only after
5
+ an exact CopilotKit Markdown page names it. The page must name its credential variables
6
+ and setup steps.
6
7
 
7
8
  Name the default model credential `OPENAI_API_KEY`.
8
9
 
@@ -43,7 +44,7 @@ Record the selected framework, vendor, model, required credential variable names
43
44
  URLs, and the two-step context route.
44
45
 
45
46
  If the pages support the selection, run
46
- `npx --prefer-offline --yes copilotkit@4.23.1 onboard read frontend/plan`.
47
+ `npx --prefer-offline --yes copilotkit@4.25.0 onboard read frontend/plan`.
47
48
 
48
49
  If the documentation does not support the selection, run
49
- `npx --prefer-offline --yes copilotkit@4.23.1 onboard read unsupported/no-validated-path`.
50
+ `npx --prefer-offline --yes copilotkit@4.25.0 onboard read unsupported/no-validated-path`.
@@ -1,10 +1,14 @@
1
1
  # Configure Strands Agents Python
2
2
 
3
- Preserve an existing Strands model setup. Start with OpenAI for a new agent. Offer another
4
- vendor only after an exact CopilotKit Markdown page names it. The page must name its
5
- credential variables and setup steps.
3
+ Preserve an existing Strands model setup. For a new agent, use the vendor that the
4
+ framework step recorded. If it recorded none, use OpenAI. Offer another vendor only after
5
+ an exact CopilotKit Markdown page names it. The page must name its credential variables
6
+ and setup steps.
6
7
 
7
- Name the default model credential `OPENAI_API_KEY`.
8
+ Name the default model credential `OPENAI_API_KEY`. For Anthropic, follow the
9
+ quickstart's "Using Anthropic instead" steps, and name the credential `ANTHROPIC_API_KEY`.
10
+ The dynamic A2UI tool still calls OpenAI, so a developer who later adds A2UI also needs
11
+ `OPENAI_API_KEY`.
8
12
 
9
13
  ## Documentation
10
14
 
@@ -29,7 +33,7 @@ Record the selected framework, vendor, model, required credential variable names
29
33
  URLs, and the context documentation gap.
30
34
 
31
35
  If the pages support the selection, run
32
- `npx --prefer-offline --yes copilotkit@4.23.1 onboard read frontend/plan`.
36
+ `npx --prefer-offline --yes copilotkit@4.25.0 onboard read frontend/plan`.
33
37
 
34
38
  If the documentation does not support the selection, run
35
- `npx --prefer-offline --yes copilotkit@4.23.1 onboard read unsupported/no-validated-path`.
39
+ `npx --prefer-offline --yes copilotkit@4.25.0 onboard read unsupported/no-validated-path`.
@@ -1,10 +1,14 @@
1
1
  # Configure Strands Agents TypeScript
2
2
 
3
- Preserve an existing Strands model setup. Start with OpenAI for a new agent. Offer another
4
- vendor only after an exact CopilotKit Markdown page names it. The page must name its
5
- credential variables and setup steps.
3
+ Preserve an existing Strands model setup. For a new agent, use the vendor that the
4
+ framework step recorded. If it recorded none, use OpenAI. Offer another vendor only after
5
+ an exact CopilotKit Markdown page names it. The page must name its credential variables
6
+ and setup steps.
6
7
 
7
- Name the default model credential `OPENAI_API_KEY`.
8
+ Name the default model credential `OPENAI_API_KEY`. For Anthropic, follow the
9
+ quickstart's "Using Anthropic instead" steps, and name the credential `ANTHROPIC_API_KEY`.
10
+ The dynamic A2UI tool still calls OpenAI, so a developer who later adds A2UI also needs
11
+ `OPENAI_API_KEY`.
8
12
 
9
13
  ## Documentation
10
14
 
@@ -30,7 +34,7 @@ Record the selected framework, vendor, model, required credential variable names
30
34
  URLs, and the context documentation gap.
31
35
 
32
36
  If the pages support the selection, run
33
- `npx --prefer-offline --yes copilotkit@4.23.1 onboard read frontend/plan`.
37
+ `npx --prefer-offline --yes copilotkit@4.25.0 onboard read frontend/plan`.
34
38
 
35
39
  If the documentation does not support the selection, run
36
- `npx --prefer-offline --yes copilotkit@4.23.1 onboard read unsupported/no-validated-path`.
40
+ `npx --prefer-offline --yes copilotkit@4.25.0 onboard read unsupported/no-validated-path`.
@@ -2,10 +2,17 @@
2
2
 
3
3
  Preserve an existing Angular frontend. Use the selected page for a new frontend.
4
4
 
5
+ This step asks the developer nothing. If the run must wait for the developer anyway, report
6
+ the pause first:
7
+
8
+ ```text
9
+ npx --prefer-offline --yes copilotkit@4.25.0 onboard checkpoint --phase awaiting-developer
10
+ ```
11
+
5
12
  Use the starter shortcut only if all these facts are true: the target directory holds no
6
13
  project, its name is a valid `init` project name, and the selected framework is ADK.
7
14
  If all three facts are true, record Angular as the selected frontend. Then run
8
- `npx --prefer-offline --yes copilotkit@4.23.1 onboard read starter/clone` before you fetch documentation.
15
+ `npx --prefer-offline --yes copilotkit@4.25.0 onboard read starter/clone` before you fetch documentation.
9
16
 
10
17
  ## Documentation
11
18
 
@@ -52,7 +59,7 @@ you create or build an Angular project. If the installed version is lower, selec
52
59
  supported version first and use it for every later command in this project.
53
60
 
54
61
  If the pages support the selection, record Angular and these URLs. Then run
55
- `npx --prefer-offline --yes copilotkit@4.23.1 onboard read credentials/finalize-plan`.
62
+ `npx --prefer-offline --yes copilotkit@4.25.0 onboard read credentials/finalize-plan`.
56
63
 
57
64
  If the documentation does not support the selection, or the two version lines do not fit
58
- together, run `npx --prefer-offline --yes copilotkit@4.23.1 onboard read unsupported/no-validated-path`.
65
+ together, run `npx --prefer-offline --yes copilotkit@4.25.0 onboard read unsupported/no-validated-path`.