copilotkit 4.24.0 → 4.25.0

package/onboarding/prompts/framework/ag2.md

@@ -1,8 +1,9 @@
 # Configure AG2
 
-Preserve an existing AG2 model setup. Start with OpenAI for a new agent. Offer another
-vendor only after an exact CopilotKit Markdown page names it. The page must name its
-credential variables and setup steps.
+Preserve an existing AG2 model setup. For a new agent, use the vendor that the framework
+step recorded. If it recorded none, use OpenAI. Offer another vendor only after an exact
+CopilotKit Markdown page names it. The page must name its credential variables and setup
+steps.
 
 Name the default model credential `OPENAI_API_KEY`.
 
@@ -31,7 +32,7 @@ Record the selected framework, vendor, model, required credential variable names
 URLs, and the A2UI documentation gap.
 
 If the pages support the selection, run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read frontend/plan`.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read frontend/plan`.
 
 If the documentation does not support the selection, run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read unsupported/no-validated-path`.

package/onboarding/prompts/framework/agno.md

@@ -1,8 +1,9 @@
 # Configure Agno
 
-Preserve an existing Agno model setup. Start with OpenAI for a new agent. Offer another
-vendor only after an exact CopilotKit Markdown page names it. The page must name its
-credential variables and setup steps.
+Preserve an existing Agno model setup. For a new agent, use the vendor that the framework
+step recorded. If it recorded none, use OpenAI. Offer another vendor only after an exact
+CopilotKit Markdown page names it. The page must name its credential variables and setup
+steps.
 
 Name the default model credential `OPENAI_API_KEY`.
 
@@ -34,7 +35,7 @@ Record the selected framework, vendor, model, required credential variable names
 URLs, the documented dependencies and adapter, and the context documentation gap.
 
 If the pages support the selection, run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read frontend/plan`.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read frontend/plan`.
 
 If the documentation does not support the selection, run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read unsupported/no-validated-path`.

package/onboarding/prompts/framework/built-in.md

@@ -1,10 +1,13 @@
 # Configure the built-in CopilotKit agent
 
-Preserve an existing built-in agent model setup. Start with OpenAI for a new agent. Offer
-another vendor only after an exact CopilotKit Markdown page names it. The page must name
-its credential variables and setup steps.
+Preserve an existing built-in agent model setup. For a new agent, use the vendor that the
+framework step recorded. If it recorded none, use OpenAI. Offer another vendor only after
+an exact CopilotKit Markdown page names it. The page must name its credential variables
+and setup steps.
 
-Name the default model credential `OPENAI_API_KEY`.
+Name the default model credential `OPENAI_API_KEY`. For Anthropic, name it
+`ANTHROPIC_API_KEY`. For Google, name it `GOOGLE_API_KEY`. Take the model id for the
+chosen vendor, in the `provider:model` form, from the model selection page.
 
 The built-in agent runs in the CopilotKit Runtime process.
 Do not create or start a separate agent server.
@@ -29,7 +32,7 @@ Record the selected framework, vendor, model, required credential variable names
 these URLs.
 
 If the pages support the selection, run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read frontend/plan`.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read frontend/plan`.
 
 If the documentation does not support the selection, run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read unsupported/no-validated-path`.

package/onboarding/prompts/framework/claude-sdk-python.md

@@ -34,7 +34,7 @@ Record the selected framework, vendor, model, required credential variable names
 these URLs.
 
 If the pages support the selection, run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read frontend/plan`.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read frontend/plan`.
 
 If the documentation does not support the selection, run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read unsupported/no-validated-path`.

package/onboarding/prompts/framework/claude-sdk-typescript.md

@@ -37,7 +37,7 @@ Record the selected framework, vendor, model, required credential variable names
 URLs, and the context limit.
 
 If the pages support the selection, run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read frontend/plan`.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read frontend/plan`.
 
 If the documentation does not support the selection, run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read unsupported/no-validated-path`.

package/onboarding/prompts/framework/crewai-flows.md

@@ -18,8 +18,16 @@ CrewAI pages name no vendor, so this release makes no recommendation here and wi
 pick one. If the developer names a vendor and no variable name, propose the variable name
 that vendor's own client reads and ask them to confirm it. A proposal the developer
 confirms is theirs. Ask for a variable name, never the value it holds. Do not combine this
-with a frontend, project, or plan-approval question. Record the answer as the
-project-defined provider, model, and credential variable name, and continue.
+with a frontend, project, or plan-approval question.
+
+Before you end your turn to wait for the developer, report the pause:
+
+```text
+npx --prefer-offline --yes copilotkit@4.25.0 onboard checkpoint --phase awaiting-developer
+```
+
+When the developer answers, record the answer as the project-defined provider, model, and
+credential variable name, and continue.
 
 A vendor nobody has chosen yet is not a missing supported path. This release supports
 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
 variable names the repository proves or the developer named, these URLs, and the adapter.
 
 If the pages support the selection, run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read frontend/plan`.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read frontend/plan`.
 
 If the documentation does not support the selection, run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read unsupported/no-validated-path`.

package/onboarding/prompts/framework/custom-ag-ui.md

@@ -60,6 +60,12 @@ If the project's `@ag-ui/client` version is not the runtime's version, name both
 in the plan. The agent depends on its own version, so ask the developer before you change
 it.
 
+Before you end your turn to wait for the developer, report the pause:
+
+```text
+npx --prefer-offline --yes copilotkit@4.25.0 onboard checkpoint --phase awaiting-developer
+```
+
 ## Keep the agent working on a clone
 
 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
 URLs.
 
 If the pages support the selection, run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read frontend/plan`.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read frontend/plan`.
 
 If the documentation does not support the selection, run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read unsupported/no-validated-path`.

package/onboarding/prompts/framework/deep-agents.md

@@ -1,8 +1,9 @@
 # Configure Deep Agents
 
-Preserve an existing Deep Agents language and model setup. Start with OpenAI for a new
-agent. Offer another vendor only after an exact CopilotKit Markdown page names it. The
-page must name its credential variables and setup steps.
+Preserve an existing Deep Agents language and model setup. For a new agent, use the vendor
+that the framework step recorded. If it recorded none, use OpenAI. Offer another vendor
+only after an exact CopilotKit Markdown page names it. The page must name its credential
+variables and setup steps.
 
 Name the default model credential `OPENAI_API_KEY`.
 
@@ -33,7 +34,7 @@ Record the selected framework, language, vendor, model, required credential vari
 names, these URLs, and each documentation gap.
 
 If the pages support the selection, run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read frontend/plan`.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read frontend/plan`.
 
 If the documentation does not support the selection, run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read unsupported/no-validated-path`.

package/onboarding/prompts/framework/google-adk.md

@@ -30,7 +30,7 @@ Record the selected framework, vendor, model, required credential variable names
 these URLs.
 
 If the pages support the selection, run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read frontend/plan`.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read frontend/plan`.
 
 If the documentation does not support the selection, run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read unsupported/no-validated-path`.

package/onboarding/prompts/framework/langgraph-fastapi.md

@@ -1,8 +1,11 @@
 # Configure LangGraph FastAPI
 
-Preserve an existing LangGraph FastAPI model setup. Start with OpenAI for a new agent.
-Offer another vendor only after an exact CopilotKit Markdown page names it. The page must
-name its credential variables and setup steps.
+Preserve an existing LangGraph FastAPI model setup. For a new agent, use the vendor that
+the framework step recorded. If it recorded none, use OpenAI. Offer another vendor only
+after an exact CopilotKit Markdown page names it. The page must name its credential
+variables and setup steps.
+
+Name the default model credential `OPENAI_API_KEY`.
 
 ## Documentation
 
@@ -25,7 +28,7 @@ Record the selected framework, vendor, model, required credential variable names
 these URLs.
 
 If the pages support the selection, run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read frontend/plan`.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read frontend/plan`.
 
 If the documentation does not support the selection, run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read unsupported/no-validated-path`.

package/onboarding/prompts/framework/langgraph-python.md

@@ -1,8 +1,11 @@
 # Configure LangGraph Python
 
-Preserve an existing LangGraph Python model setup. Start with OpenAI for a new agent.
-Offer another vendor only after an exact CopilotKit Markdown page names it. The page must
-name its credential variables and setup steps.
+Preserve an existing LangGraph Python model setup. For a new agent, use the vendor that
+the framework step recorded. If it recorded none, use OpenAI. Offer another vendor only
+after an exact CopilotKit Markdown page names it. The page must name its credential
+variables and setup steps.
+
+Name the default model credential `OPENAI_API_KEY`.
 
 ## Documentation
 
@@ -19,7 +22,7 @@ Record the selected framework, vendor, model, required credential variable names
 these URLs.
 
 If the pages support the selection, run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read frontend/plan`.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read frontend/plan`.
 
 If the documentation does not support the selection, run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read unsupported/no-validated-path`.

package/onboarding/prompts/framework/langgraph-typescript.md

@@ -1,8 +1,11 @@
 # Configure LangGraph TypeScript
 
-Preserve an existing LangGraph TypeScript model setup. Start with OpenAI for a new agent.
-Offer another vendor only after an exact CopilotKit Markdown page names it. The page must
-name its credential variables and setup steps.
+Preserve an existing LangGraph TypeScript model setup. For a new agent, use the vendor
+that the framework step recorded. If it recorded none, use OpenAI. Offer another vendor
+only after an exact CopilotKit Markdown page names it. The page must name its credential
+variables and setup steps.
+
+Name the default model credential `OPENAI_API_KEY`.
 
 ## Documentation
 
@@ -19,7 +22,7 @@ Record the selected framework, vendor, model, required credential variable names
 these URLs.
 
 If the pages support the selection, run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read frontend/plan`.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read frontend/plan`.
 
 If the documentation does not support the selection, run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read unsupported/no-validated-path`.

package/onboarding/prompts/framework/llamaindex.md

@@ -1,8 +1,9 @@
 # Configure LlamaIndex
 
-Preserve an existing LlamaIndex model setup. Start with OpenAI for a new agent. Offer
-another vendor only after an exact CopilotKit Markdown page names it. The page must name
-its credential variables and setup steps.
+Preserve an existing LlamaIndex model setup. For a new agent, use the vendor that the
+framework step recorded. If it recorded none, use OpenAI. Offer another vendor only after
+an exact CopilotKit Markdown page names it. The page must name its credential variables
+and setup steps.
 
 Name the default model credential `OPENAI_API_KEY`.
 
@@ -34,7 +35,7 @@ Record the selected framework, vendor, model, required credential variable names
 URLs, the documented dependencies and adapter, and both documentation limits.
 
 If the pages support the selection, run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read frontend/plan`.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read frontend/plan`.
 
 If the documentation does not support the selection, run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read unsupported/no-validated-path`.

package/onboarding/prompts/framework/mastra.md

@@ -1,10 +1,13 @@
 # Configure Mastra
 
-Preserve an existing Mastra model setup. Start with OpenAI for a new agent. Offer
-another vendor only after an exact CopilotKit Markdown page names it. The page must name
-its credential variables and setup steps.
+Preserve an existing Mastra model setup. For a new agent, use the vendor that the
+framework step recorded. If it recorded none, use OpenAI. Offer another vendor only after
+an exact CopilotKit Markdown page names it. The page must name its credential variables
+and setup steps.
 
-Name the model credential `OPENAI_API_KEY`.
+Name the default model credential `OPENAI_API_KEY`. For Anthropic, follow the
+quickstart's steps to run the agent on Anthropic, and name the credential
+`ANTHROPIC_API_KEY`.
 
 `mastra dev` loads the `.env` beside the project it serves and does not look in a
 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
 these URLs.
 
 If the pages support the selection, run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read frontend/plan`.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read frontend/plan`.
 
 If the documentation does not support the selection, run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read unsupported/no-validated-path`.

package/onboarding/prompts/framework/ms-agent-dotnet.md

@@ -15,8 +15,16 @@ Run `dotnet --version` before you change the project. If it fails, no .NET SDK i
 shell's PATH. Do not change the project, and do not install the SDK yourself. Tell the
 developer to install the .NET SDK from https://dotnet.microsoft.com/download. Say that the
 coding agent's shell cannot see a new install until the developer restarts the coding
-agent. Give them `npx --prefer-offline --yes copilotkit@4.24.0 onboard start --run <onboarding_run_id>`
-to resume the run after the restart. Then end your turn and wait for the developer.
+agent. Give them `npx --prefer-offline --yes copilotkit@4.25.0 onboard start --run <onboarding_run_id>`
+to resume the run after the restart.
+
+Before you end your turn to wait for the developer, report the pause:
+
+```text
+npx --prefer-offline --yes copilotkit@4.25.0 onboard checkpoint --phase awaiting-developer
+```
+
+Then end your turn and wait for the developer.
 
 ## Documentation
 
@@ -41,7 +49,7 @@ Record the selected framework, provider, model, required credential variable nam
 these URLs.
 
 If the pages support the selection, run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read frontend/plan`.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read frontend/plan`.
 
 If the documentation does not support the selection, run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read unsupported/no-validated-path`.

package/onboarding/prompts/framework/ms-agent-harness-dotnet.md

@@ -9,8 +9,16 @@ you change the project. If it fails, no .NET SDK is on this shell's PATH. Do not
 the project, and do not install the SDK yourself. Tell the developer to install the .NET
 SDK from https://dotnet.microsoft.com/download. Say that the coding agent's shell cannot
 see a new install until the developer restarts the coding agent. Give them
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard start --run <onboarding_run_id>` to resume the run
-after the restart. Then end your turn and wait for the developer.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard start --run <onboarding_run_id>` to resume the run
+after the restart.
+
+Before you end your turn to wait for the developer, report the pause:
+
+```text
+npx --prefer-offline --yes copilotkit@4.25.0 onboard checkpoint --phase awaiting-developer
+```
+
+Then end your turn and wait for the developer.
 
 ## Documentation
 
@@ -49,7 +57,7 @@ Record the selected framework, provider, model, required credential variable nam
 URLs, and the quickstart gap.
 
 If the pages support the selection, run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read frontend/plan`.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read frontend/plan`.
 
 If the documentation does not support the selection, run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read unsupported/no-validated-path`.

package/onboarding/prompts/framework/ms-agent-python.md

@@ -1,8 +1,9 @@
 # Configure Microsoft Agent Framework for Python
 
-Preserve an existing Microsoft Agent Framework model setup. Start with OpenAI for a new
-agent. Offer another vendor only after an exact CopilotKit Markdown page names it. The
-page must name its credential variables and setup steps.
+Preserve an existing Microsoft Agent Framework model setup. For a new agent, use the
+vendor that the framework step recorded. If it recorded none, use OpenAI. Offer another
+vendor only after an exact CopilotKit Markdown page names it. The page must name its
+credential variables and setup steps.
 
 Name the model credential `OPENAI_API_KEY`, in `agent/.env`, for a new agent. This
 framework also accepts Azure OpenAI, through `AZURE_OPENAI_ENDPOINT` and
@@ -30,7 +31,7 @@ Record the selected framework, vendor, model, required credential variable names
 these URLs.
 
 If the pages support the selection, run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read frontend/plan`.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read frontend/plan`.
 
 If the documentation does not support the selection, run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read unsupported/no-validated-path`.

package/onboarding/prompts/framework/pydantic-ai.md

@@ -1,8 +1,9 @@
 # Configure Pydantic AI
 
-Preserve an existing Pydantic AI model setup. Start with OpenAI for a new agent. Offer
-another vendor only after an exact CopilotKit Markdown page names it. The page must name
-its credential variables and setup steps.
+Preserve an existing Pydantic AI model setup. For a new agent, use the vendor that the
+framework step recorded. If it recorded none, use OpenAI. Offer another vendor only after
+an exact CopilotKit Markdown page names it. The page must name its credential variables
+and setup steps.
 
 Name the default model credential `OPENAI_API_KEY`.
 
@@ -43,7 +44,7 @@ Record the selected framework, vendor, model, required credential variable names
 URLs, and the two-step context route.
 
 If the pages support the selection, run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read frontend/plan`.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read frontend/plan`.
 
 If the documentation does not support the selection, run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read unsupported/no-validated-path`.

package/onboarding/prompts/framework/strands-python.md

@@ -1,10 +1,14 @@
 # Configure Strands Agents Python
 
-Preserve an existing Strands model setup. Start with OpenAI for a new agent. Offer another
-vendor only after an exact CopilotKit Markdown page names it. The page must name its
-credential variables and setup steps.
+Preserve an existing Strands model setup. For a new agent, use the vendor that the
+framework step recorded. If it recorded none, use OpenAI. Offer another vendor only after
+an exact CopilotKit Markdown page names it. The page must name its credential variables
+and setup steps.
 
-Name the default model credential `OPENAI_API_KEY`.
+Name the default model credential `OPENAI_API_KEY`. For Anthropic, follow the
+quickstart's "Using Anthropic instead" steps, and name the credential `ANTHROPIC_API_KEY`.
+The dynamic A2UI tool still calls OpenAI, so a developer who later adds A2UI also needs
+`OPENAI_API_KEY`.
 
 ## Documentation
 
@@ -29,7 +33,7 @@ Record the selected framework, vendor, model, required credential variable names
 URLs, and the context documentation gap.
 
 If the pages support the selection, run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read frontend/plan`.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read frontend/plan`.
 
 If the documentation does not support the selection, run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read unsupported/no-validated-path`.

package/onboarding/prompts/framework/strands-typescript.md

@@ -1,10 +1,14 @@
 # Configure Strands Agents TypeScript
 
-Preserve an existing Strands model setup. Start with OpenAI for a new agent. Offer another
-vendor only after an exact CopilotKit Markdown page names it. The page must name its
-credential variables and setup steps.
+Preserve an existing Strands model setup. For a new agent, use the vendor that the
+framework step recorded. If it recorded none, use OpenAI. Offer another vendor only after
+an exact CopilotKit Markdown page names it. The page must name its credential variables
+and setup steps.
 
-Name the default model credential `OPENAI_API_KEY`.
+Name the default model credential `OPENAI_API_KEY`. For Anthropic, follow the
+quickstart's "Using Anthropic instead" steps, and name the credential `ANTHROPIC_API_KEY`.
+The dynamic A2UI tool still calls OpenAI, so a developer who later adds A2UI also needs
+`OPENAI_API_KEY`.
 
 ## Documentation
 
@@ -30,7 +34,7 @@ Record the selected framework, vendor, model, required credential variable names
 URLs, and the context documentation gap.
 
 If the pages support the selection, run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read frontend/plan`.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read frontend/plan`.
 
 If the documentation does not support the selection, run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read unsupported/no-validated-path`.

package/onboarding/prompts/frontend/angular.md

@@ -2,10 +2,17 @@
 
 Preserve an existing Angular frontend. Use the selected page for a new frontend.
 
+This step asks the developer nothing. If the run must wait for the developer anyway, report
+the pause first:
+
+```text
+npx --prefer-offline --yes copilotkit@4.25.0 onboard checkpoint --phase awaiting-developer
+```
+
 Use the starter shortcut only if all these facts are true: the target directory holds no
 project, its name is a valid `init` project name, and the selected framework is ADK.
 If all three facts are true, record Angular as the selected frontend. Then run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read starter/clone` before you fetch documentation.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read starter/clone` before you fetch documentation.
 
 ## Documentation
 
@@ -52,7 +59,7 @@ you create or build an Angular project. If the installed version is lower, selec
 supported version first and use it for every later command in this project.
 
 If the pages support the selection, record Angular and these URLs. Then run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read credentials/finalize-plan`.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read credentials/finalize-plan`.
 
 If the documentation does not support the selection, or the two version lines do not fit
-together, run `npx --prefer-offline --yes copilotkit@4.24.0 onboard read unsupported/no-validated-path`.
+together, run `npx --prefer-offline --yes copilotkit@4.25.0 onboard read unsupported/no-validated-path`.

package/onboarding/prompts/frontend/nextjs.md

@@ -2,6 +2,13 @@
 
 Preserve an existing Next.js frontend. Use the selected pages for a new frontend.
 
+This step asks the developer nothing. If the run must wait for the developer anyway, report
+the pause first:
+
+```text
+npx --prefer-offline --yes copilotkit@4.25.0 onboard checkpoint --phase awaiting-developer
+```
+
 Use the starter shortcut only if the target directory holds no project and its name is
 a valid `init` project name. The selected framework must also match one of these options.
 
@@ -15,7 +22,7 @@ These TypeScript options have starters: Claude Agent SDK TypeScript, LangGraph T
 Mastra, and Strands Agents TypeScript. The .NET option is Microsoft Agent Framework .NET.
 
 If all shortcut conditions are true, record Next.js as the selected frontend. Then run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read starter/clone` before you fetch documentation.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read starter/clone` before you fetch documentation.
 
 ## Documentation
 
@@ -39,8 +46,34 @@ developer's work.
 - For an existing frontend, do not change `next.config.ts` for this.
 - Do not claim, revert, or delete these files. Name them in the report as Next.js output.
 
+## Lockfile in a parent folder
+
+Next.js 16 uses the highest folder with a lockfile as the workspace root. If a parent
+folder holds a lockfile, Next.js takes that folder as the root. It then resolves packages
+and traces output from the wrong folder. `next dev` and `next build` print this warning:
+
+```text
+Warning: Next.js inferred your workspace root, but it may not be correct.
+```
+
+If you see the warning, read the lockfile paths that it lists. If the parent folder is a
+workspace that lists this app, do not set the root. Next.js chose the correct folder.
+Otherwise, set the root to the app folder in `next.config.ts`:
+
+```ts
+import { fileURLToPath } from 'node:url';
+
+const nextConfig = {
+  turbopack: { root: fileURLToPath(new URL('.', import.meta.url)) },
+};
+```
+
+In a CommonJS `next.config.js`, use `turbopack: { root: __dirname }` instead. This value
+also sets `outputFileTracingRoot`. Do not set `outputFileTracingRoot` to a
+different folder. For an existing frontend, name this change in the report.
+
 If the page supports the selection, record Next.js and this URL. Then run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read credentials/finalize-plan`.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read credentials/finalize-plan`.
 
 If the documentation does not support the selection, run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read unsupported/no-validated-path`.

package/onboarding/prompts/frontend/plan.md

@@ -27,6 +27,12 @@ If the project has a frontend, preserve it and use the matching route below. If
 needs a frontend, show the valid choices and one recommendation based on repository
 evidence, then ask the developer to choose.
 
+Before you end your turn to wait for the developer, report the pause:
+
+```text
+npx --prefer-offline --yes copilotkit@4.25.0 onboard checkpoint --phase awaiting-developer
+```
+
 The valid choices are React SPA, Next.js, Angular, Vue 3, React Native, Slack, and
 Microsoft Teams. They are valid in every starting state. Route names are this graph's own
 bookkeeping. Say what the run is doing in the developer's words instead.
@@ -37,15 +43,15 @@ CopilotKit web apps. Then recommend the one the developer names, and say what ea
 
 Use exactly one matching internal route:
 
-1. React SPA: `npx --prefer-offline --yes copilotkit@4.24.0 onboard read frontend/react-spa`
-2. Next.js: `npx --prefer-offline --yes copilotkit@4.24.0 onboard read frontend/nextjs`
-3. Angular: `npx --prefer-offline --yes copilotkit@4.24.0 onboard read frontend/angular`
-4. Vue 3: `npx --prefer-offline --yes copilotkit@4.24.0 onboard read frontend/vue`
-5. React Native: `npx --prefer-offline --yes copilotkit@4.24.0 onboard read frontend/react-native`
-6. Slack or Microsoft Teams: `npx --prefer-offline --yes copilotkit@4.24.0 onboard read feature/channels/start`
+1. React SPA: `npx --prefer-offline --yes copilotkit@4.25.0 onboard read frontend/react-spa`
+2. Next.js: `npx --prefer-offline --yes copilotkit@4.25.0 onboard read frontend/nextjs`
+3. Angular: `npx --prefer-offline --yes copilotkit@4.25.0 onboard read frontend/angular`
+4. Vue 3: `npx --prefer-offline --yes copilotkit@4.25.0 onboard read frontend/vue`
+5. React Native: `npx --prefer-offline --yes copilotkit@4.25.0 onboard read frontend/react-native`
+6. Slack or Microsoft Teams: `npx --prefer-offline --yes copilotkit@4.25.0 onboard read feature/channels/start`
 
 If they chose Slack or Microsoft Teams, tell that node which one they chose so it
 does not ask again.
 
 If no listed frontend fits, run
-`npx --prefer-offline --yes copilotkit@4.24.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.25.0 onboard read unsupported/no-validated-path`.