copilotkit 4.9.0 → 4.9.1

package/onboarding/prompts/authenticate/start.md

@@ -14,24 +14,38 @@ question from the documentation this graph gives you. Another checkout on this m
 not a source. The developer running this has none, so an answer taken from one is an
 answer they cannot get, and it hides the documentation gap that blocks them.
 
-Tell the developer that onboarding can send feedback outside this machine. Explain that
-the reports contain short descriptions of CLI or documentation problems. Ask whether the
-developer permits these reports before project work starts. Record the answer. Do not send
-feedback unless the developer permits it.
+Before you run a command or spawn a subagent, send this exact message:
 
-Run `npx --yes copilotkit@4.9.0 login --json` before any project work. This command checks the
-current session. It starts sign-in only as needed.
+Welcome to CopilotKit. I will check sign-in, inspect your project, recommend a setup, and
+show you a plan before I change files. After you approve the plan, I will build the
+integration, prove the full round trip, and leave the app running with its URLs.
 
-Read its JSON Lines output in order:
+Do not ask for separate feedback consent. The feedback commands enforce the developer's
+CLI telemetry setting when a later step tries to send a report.
 
-1. If it emits `authentication_url`, show only that URL to the developer.
+Run `npx --yes copilotkit@4.9.1 login --json` before any project work. This command
+checks the current session. It starts sign-in only as needed. Treat this as a long-lived
+streaming process. Do not wait for the command to exit before you read its standard output.
+
+Read each JSON Lines record as the running command writes it:
+
+1. If the process emits `authentication_url`, show the `authentication_url` to the
+   developer as soon as that line arrives. The process is still running.
 2. Tell the developer to open the URL and finish sign-in.
-3. Wait for the command to emit `type: completed`.
-4. If it emits `type: failed`, report the error and stop onboarding.
+3. Keep monitoring the same process after you show the URL. Do not start a second login
+   command.
+4. Continue onboarding only after that same process emits `type: completed`.
+5. If that process emits `type: failed`, report the error and stop onboarding.
 
 Do not use `whoami` for this check. It has no JSON output and some failures exit with code
 zero. Do not put account tokens or credentials in the conversation.
 
+Before you ask the developer any setup question, finish every read-only investigation and
+preflight check in this section. Record whether your coding-agent environment has browser
+or device control. Use the control that matches the selected surface later. Do not install
+a browser or device tool during this preflight. Do not ask the developer about this tool
+limit.
+
 Spawn one research subagent. Give it the full text of the research brief at the end of this
 prompt and tell it to follow that brief and return only its findings. Add these tasks:
 
@@ -46,9 +60,10 @@ prompt and tell it to follow that brief and return only its findings. Add these
 Do not print either file or any secret value. Return only paths, presence checks, and missing
 field names. Wait for the subagent to finish.
 
-If the findings show an empty project and do not prove its purpose, ask what the developer
-wants to build before you select a framework. Ask this question immediately. Record the
-answer and give it to each later subagent.
+If the findings show an empty project and do not prove its purpose, ask one guided question
+about the user outcome. This asks what the developer wants to build before you select a
+framework. Give two or three short examples and offer a minimal starter. Record the answer
+and give it to each later subagent.
 
 If a repository file exists, each finding must cite it. For an empty project, the subagent
 must cite its directory check and report absent parts.
@@ -60,13 +75,13 @@ that the repository answers.
 Do not infer a working OSS path from packages, imports, project files, or keys. If an
 agent, frontend, and CopilotKit integration are present, prove the live starting state
 before any project file changes. Run
-`npx --yes copilotkit@4.9.0 onboard read proof/oss-baseline`.
+`npx --yes copilotkit@4.9.1 onboard read proof/oss-baseline`.
 
 For every other inspected state, run
-`npx --yes copilotkit@4.9.0 onboard read credentials/plan`.
+`npx --yes copilotkit@4.9.1 onboard read credentials/plan`.
 
 If authentication or inspection stops onboarding, run
-`npx --yes copilotkit@4.9.0 onboard read unsupported/no-validated-path`.
+`npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.
 
 ## Research subagent brief
 
@@ -84,6 +99,10 @@ Inspect the repository without changing it. Find evidence for:
 - current CopilotKit packages and configuration
 - authentication boundaries
 - names of required credential variables, without reading their values
+- package manager and lockfile
+- required toolchains and their installed versions
+- declared ports and whether each port is available
+- CopilotKit package versions and package compatibility risks
 
 A project states what it is for in its `README.md`, in its package description, or in
 the prompt of an agent it already has. Quote that statement rather than rewriting it. An
@@ -92,7 +111,8 @@ evidence. State the purpose as unproved when the project never says.
 
 Gather what you need in as few commands as possible. Combine independent reads into one
 command rather than running them one at a time. Split a command only when its result decides
-what you run next.
+what you run next. Keep this preflight read-only. Do not install packages, stop processes,
+or change a port. Check only the toolchains and ports that repository files require.
 
 Return the file paths and a short finding for each item. State each absent or unproved item.
 Do not read, print, or return secret values. Do not read a file outside the project

package/onboarding/prompts/credentials/finalize-plan.md

@@ -5,6 +5,31 @@ repository findings. Ask the developer only for choices that the repository does
 show. Do not change application code in this phase. Do not read, show, store, or request
 a secret value.
 
+Use a gentle wizard. Ask one short question at a time. Do not combine separate choices in
+one question. Put the recommendation first, give its evidence in one sentence, and keep
+the alternatives short. When project selection is unknown, ask only which Intelligence
+project to use. Keep final plan approval as its own later question.
+
+## Record the audit cell
+
+Use the repository findings and selected choices to record the path before project work
+starts. Choose one starting state: empty, agent-only, frontend-only, both, both-oss.
+
+- `empty`: no agent and no frontend.
+- `agent-only`: an agent and no frontend.
+- `frontend-only`: a frontend and no agent.
+- `both`: an agent and frontend that do not have a proved CopilotKit round trip.
+- `both-oss`: an agent and frontend with the proved OSS CopilotKit baseline.
+
+Run this command with the exact selected slugs:
+
+```text
+npx --yes copilotkit@4.9.1 onboard classify --starting-state <starting-state> --agent-framework <agent-framework> --frontend <frontend>
+```
+
+Do not continue if a value is refused. Fix the value from the choices that the earlier
+prompts gave, then run the command again.
+
 ## Select the Intelligence project
 
 Use the target app or runtime directory from the repository findings. If a nested app owns
@@ -23,7 +48,7 @@ target directory. Do not send the developer to another terminal.
 Read the choices first:
 
 ```text
-npx --yes copilotkit@4.9.0 project list --json
+npx --yes copilotkit@4.9.1 project list --json
 ```
 
 With `--json` the payload is the only thing on standard output, so it is safe to parse.
@@ -34,17 +59,17 @@ developer asks.
 If the developer searches, run:
 
 ```text
-npx --yes copilotkit@4.9.0 project list --search <query> --json
+npx --yes copilotkit@4.9.1 project list --search <query> --json
 ```
 
 If the developer asks for all projects, show the result of the first list command. Ask
-which project to use, or ask for a new project name. Ask this with the frontend and model
-choices when those choices remain unknown.
+which project to use, or ask for a new project name. Do not combine this question with a
+frontend, framework, model, credential, or plan-approval question.
 
 Then record their answer, from the target directory:
 
 ```text
-npx --yes copilotkit@4.9.0 project select --project <slug-or-id> --json
+npx --yes copilotkit@4.9.1 project select --project <slug-or-id> --json
 ```
 
 Use `--create <name> --json` instead when they want a new project. The two flags cannot be
@@ -116,10 +141,10 @@ values.
 Show only the selected framework, frontend, model, planned file changes, validation commands, and proof steps.
 
 If the developer approves the plan, run
-`npx --yes copilotkit@4.9.0 onboard read implementation/build-and-validate`.
+`npx --yes copilotkit@4.9.1 onboard read implementation/build-and-validate`.
 
 If no exact supported path or documentation URL exists, run
-`npx --yes copilotkit@4.9.0 onboard read unsupported/no-validated-path`.
+`npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.
 
 ## Planning subagent brief
 

package/onboarding/prompts/credentials/plan.md

@@ -4,6 +4,12 @@ Use the repository findings to select the agent framework. Ask the developer onl
 choices that the repository does not show. Do not change application code in this phase.
 Do not read, show, store, or request a secret value.
 
+Use a gentle wizard. Ask one short question at a time. Do not combine separate choices in
+one question. Put the recommendation first, give its evidence in one sentence, and keep
+the alternatives short. When the framework is unknown, ask only whether to use the
+recommended framework. If the developer declines it, ask one follow-up question that lists
+the valid framework choices. Do not ask about the frontend, model, or project in this step.
+
 These are the agent frameworks and their default vendors:
 
 | Framework                          | Default vendor  |
@@ -45,26 +51,26 @@ another framework. Do not show the internal route.
 
 Use exactly one matching internal route:
 
-1. AG2: `npx --yes copilotkit@4.9.0 onboard read framework/ag2`
-2. Agno: `npx --yes copilotkit@4.9.0 onboard read framework/agno`
-3. Built-in CopilotKit agent: `npx --yes copilotkit@4.9.0 onboard read framework/built-in`
-4. Claude Agent SDK Python: `npx --yes copilotkit@4.9.0 onboard read framework/claude-sdk-python`
-5. Claude Agent SDK TypeScript: `npx --yes copilotkit@4.9.0 onboard read framework/claude-sdk-typescript`
-6. CrewAI Flows: `npx --yes copilotkit@4.9.0 onboard read framework/crewai-flows`
-7. Deep Agents: `npx --yes copilotkit@4.9.0 onboard read framework/deep-agents`
-8. LangGraph Python: `npx --yes copilotkit@4.9.0 onboard read framework/langgraph-python`
-9. LangGraph FastAPI: `npx --yes copilotkit@4.9.0 onboard read framework/langgraph-fastapi`
-10. LangGraph TypeScript: `npx --yes copilotkit@4.9.0 onboard read framework/langgraph-typescript`
-11. LlamaIndex: `npx --yes copilotkit@4.9.0 onboard read framework/llamaindex`
-12. ADK: `npx --yes copilotkit@4.9.0 onboard read framework/google-adk`
-13. Microsoft Agent Framework Python: `npx --yes copilotkit@4.9.0 onboard read framework/ms-agent-python`
-14. Microsoft Agent Framework .NET: `npx --yes copilotkit@4.9.0 onboard read framework/ms-agent-dotnet`
-15. Mastra: `npx --yes copilotkit@4.9.0 onboard read framework/mastra`
-16. MS Agent Harness .NET: `npx --yes copilotkit@4.9.0 onboard read framework/ms-agent-harness-dotnet`
-17. Pydantic AI: `npx --yes copilotkit@4.9.0 onboard read framework/pydantic-ai`
-18. Strands Agents Python: `npx --yes copilotkit@4.9.0 onboard read framework/strands-python`
-19. Strands Agents TypeScript: `npx --yes copilotkit@4.9.0 onboard read framework/strands-typescript`
+1. AG2: `npx --yes copilotkit@4.9.1 onboard read framework/ag2`
+2. Agno: `npx --yes copilotkit@4.9.1 onboard read framework/agno`
+3. Built-in CopilotKit agent: `npx --yes copilotkit@4.9.1 onboard read framework/built-in`
+4. Claude Agent SDK Python: `npx --yes copilotkit@4.9.1 onboard read framework/claude-sdk-python`
+5. Claude Agent SDK TypeScript: `npx --yes copilotkit@4.9.1 onboard read framework/claude-sdk-typescript`
+6. CrewAI Flows: `npx --yes copilotkit@4.9.1 onboard read framework/crewai-flows`
+7. Deep Agents: `npx --yes copilotkit@4.9.1 onboard read framework/deep-agents`
+8. LangGraph Python: `npx --yes copilotkit@4.9.1 onboard read framework/langgraph-python`
+9. LangGraph FastAPI: `npx --yes copilotkit@4.9.1 onboard read framework/langgraph-fastapi`
+10. LangGraph TypeScript: `npx --yes copilotkit@4.9.1 onboard read framework/langgraph-typescript`
+11. LlamaIndex: `npx --yes copilotkit@4.9.1 onboard read framework/llamaindex`
+12. ADK: `npx --yes copilotkit@4.9.1 onboard read framework/google-adk`
+13. Microsoft Agent Framework Python: `npx --yes copilotkit@4.9.1 onboard read framework/ms-agent-python`
+14. Microsoft Agent Framework .NET: `npx --yes copilotkit@4.9.1 onboard read framework/ms-agent-dotnet`
+15. Mastra: `npx --yes copilotkit@4.9.1 onboard read framework/mastra`
+16. MS Agent Harness .NET: `npx --yes copilotkit@4.9.1 onboard read framework/ms-agent-harness-dotnet`
+17. Pydantic AI: `npx --yes copilotkit@4.9.1 onboard read framework/pydantic-ai`
+18. Strands Agents Python: `npx --yes copilotkit@4.9.1 onboard read framework/strands-python`
+19. Strands Agents TypeScript: `npx --yes copilotkit@4.9.1 onboard read framework/strands-typescript`
 
 If the project has an agent in another framework, or no listed framework fits, keep the
 developer's current agent and run
-`npx --yes copilotkit@4.9.0 onboard read unsupported/no-validated-path`.
+`npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.

package/onboarding/prompts/fallback/best-effort.md

@@ -21,9 +21,16 @@ the application passes proof. Report each tool result separately.
 Report the documentation gap and each assumption with the proof evidence. Do not claim
 that the selected documentation proved an inferred step.
 
-When the proof is complete, run `npx --yes copilotkit@4.9.0 onboard complete`, carrying the
-visual-check result:
+When the proof is complete, run `npx --yes copilotkit@4.9.1 onboard complete`, carrying the
+surface-check result the proof subagent returned. Pass exactly one flag, matching this
+journey's surface:
 
 ```text
-npx --yes copilotkit@4.9.0 onboard complete --visual-check <outcome>
+npx --yes copilotkit@4.9.1 onboard complete --visual-check <outcome>
+npx --yes copilotkit@4.9.1 onboard complete --device-check <outcome>
 ```
+
+`--visual-check` is for a web frontend and takes `performed`, `skipped-no-browser-tool`, or
+`failed`. `--device-check` is for React Native and takes `performed`, `skipped-no-device`,
+or `failed`. Anything but `performed` ends this run as blocked, and the command's output
+names the evidence that is missing. Report it that way.

package/onboarding/prompts/framework/ag2.md

@@ -42,7 +42,7 @@ not a fact about the page. Retrieve the same URL a second way before you judge i
 unavailable only after a second method also fails.
 
 If the pages support the selection, run
-`npx --yes copilotkit@4.9.0 onboard read frontend/plan`.
+`npx --yes copilotkit@4.9.1 onboard read frontend/plan`.
 
 If a second method also fails, or a page that loads does not support the selection, run
-`npx --yes copilotkit@4.9.0 onboard read unsupported/no-validated-path`.
+`npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.

package/onboarding/prompts/framework/agno.md

@@ -42,7 +42,7 @@ not a fact about the page. Retrieve the same URL a second way before you judge i
 unavailable only after a second method also fails.
 
 If the pages support the selection, run
-`npx --yes copilotkit@4.9.0 onboard read frontend/plan`.
+`npx --yes copilotkit@4.9.1 onboard read frontend/plan`.
 
 If a second method also fails, or a page that loads does not support the selection, run
-`npx --yes copilotkit@4.9.0 onboard read unsupported/no-validated-path`.
+`npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.

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

@@ -37,7 +37,7 @@ not a fact about the page. Retrieve the same URL a second way before you judge i
 unavailable only after a second method also fails.
 
 If the pages support the selection, run
-`npx --yes copilotkit@4.9.0 onboard read frontend/plan`.
+`npx --yes copilotkit@4.9.1 onboard read frontend/plan`.
 
 If a second method also fails, or a page that loads does not support the selection, run
-`npx --yes copilotkit@4.9.0 onboard read unsupported/no-validated-path`.
+`npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.

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

@@ -43,7 +43,7 @@ not a fact about the page. Retrieve the same URL a second way before you judge i
 unavailable only after a second method also fails.
 
 If the pages support the selection, run
-`npx --yes copilotkit@4.9.0 onboard read frontend/plan`.
+`npx --yes copilotkit@4.9.1 onboard read frontend/plan`.
 
 If a second method also fails, or a page that loads does not support the selection, run
-`npx --yes copilotkit@4.9.0 onboard read unsupported/no-validated-path`.
+`npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.

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

@@ -47,7 +47,7 @@ not a fact about the page. Retrieve the same URL a second way before you judge i
 unavailable only after a second method also fails.
 
 If the pages support the selection, run
-`npx --yes copilotkit@4.9.0 onboard read frontend/plan`.
+`npx --yes copilotkit@4.9.1 onboard read frontend/plan`.
 
 If a second method also fails, or a page that loads does not support the selection, run
-`npx --yes copilotkit@4.9.0 onboard read unsupported/no-validated-path`.
+`npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.

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

@@ -50,7 +50,7 @@ not a fact about the page. Retrieve the same URL a second way before you judge i
 unavailable only after a second method also fails.
 
 If the pages support the selection, run
-`npx --yes copilotkit@4.9.0 onboard read frontend/plan`.
+`npx --yes copilotkit@4.9.1 onboard read frontend/plan`.
 
 If a second method also fails, or a page that loads does not support the selection, run
-`npx --yes copilotkit@4.9.0 onboard read unsupported/no-validated-path`.
+`npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.

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

@@ -39,7 +39,7 @@ not a fact about the page. Retrieve the same URL a second way before you judge i
 unavailable only after a second method also fails.
 
 If the pages support the selection, run
-`npx --yes copilotkit@4.9.0 onboard read frontend/plan`.
+`npx --yes copilotkit@4.9.1 onboard read frontend/plan`.
 
 If a second method also fails, or a page that loads does not support the selection, run
-`npx --yes copilotkit@4.9.0 onboard read unsupported/no-validated-path`.
+`npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.

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

@@ -40,7 +40,7 @@ not a fact about the page. Retrieve the same URL a second way before you judge i
 unavailable only after a second method also fails.
 
 If the pages support the selection, run
-`npx --yes copilotkit@4.9.0 onboard read frontend/plan`.
+`npx --yes copilotkit@4.9.1 onboard read frontend/plan`.
 
 If a second method also fails, or a page that loads does not support the selection, run
-`npx --yes copilotkit@4.9.0 onboard read unsupported/no-validated-path`.
+`npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.

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

@@ -36,7 +36,7 @@ not a fact about the page. Retrieve the same URL a second way before you judge i
 unavailable only after a second method also fails.
 
 If the pages support the selection, run
-`npx --yes copilotkit@4.9.0 onboard read frontend/plan`.
+`npx --yes copilotkit@4.9.1 onboard read frontend/plan`.
 
 If a second method also fails, or a page that loads does not support the selection, run
-`npx --yes copilotkit@4.9.0 onboard read unsupported/no-validated-path`.
+`npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.

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

@@ -27,7 +27,7 @@ not a fact about the page. Retrieve the same URL a second way before you judge i
 unavailable only after a second method also fails.
 
 If the pages support the selection, run
-`npx --yes copilotkit@4.9.0 onboard read frontend/plan`.
+`npx --yes copilotkit@4.9.1 onboard read frontend/plan`.
 
 If a second method also fails, or a page that loads does not support the selection, run
-`npx --yes copilotkit@4.9.0 onboard read unsupported/no-validated-path`.
+`npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.

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

@@ -27,7 +27,7 @@ not a fact about the page. Retrieve the same URL a second way before you judge i
 unavailable only after a second method also fails.
 
 If the pages support the selection, run
-`npx --yes copilotkit@4.9.0 onboard read frontend/plan`.
+`npx --yes copilotkit@4.9.1 onboard read frontend/plan`.
 
 If a second method also fails, or a page that loads does not support the selection, run
-`npx --yes copilotkit@4.9.0 onboard read unsupported/no-validated-path`.
+`npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.

package/onboarding/prompts/framework/llamaindex.md

@@ -45,7 +45,7 @@ not a fact about the page. Retrieve the same URL a second way before you judge i
 unavailable only after a second method also fails.
 
 If the pages support the selection, run
-`npx --yes copilotkit@4.9.0 onboard read frontend/plan`.
+`npx --yes copilotkit@4.9.1 onboard read frontend/plan`.
 
 If a second method also fails, or a page that loads does not support the selection, run
-`npx --yes copilotkit@4.9.0 onboard read unsupported/no-validated-path`.
+`npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.

package/onboarding/prompts/framework/mastra.md

@@ -57,7 +57,7 @@ not a fact about the page. Retrieve the same URL a second way before you judge i
 unavailable only after a second method also fails.
 
 If the pages support the selection, run
-`npx --yes copilotkit@4.9.0 onboard read frontend/plan`.
+`npx --yes copilotkit@4.9.1 onboard read frontend/plan`.
 
 If a second method also fails, or a page that loads does not support the selection, run
-`npx --yes copilotkit@4.9.0 onboard read unsupported/no-validated-path`.
+`npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.

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

@@ -65,7 +65,7 @@ not a fact about the page. Retrieve the same URL a second way before you judge i
 unavailable only after a second method also fails.
 
 If the pages support the selection, run
-`npx --yes copilotkit@4.9.0 onboard read frontend/plan`.
+`npx --yes copilotkit@4.9.1 onboard read frontend/plan`.
 
 If a second method also fails, or a page that loads does not support the selection, run
-`npx --yes copilotkit@4.9.0 onboard read unsupported/no-validated-path`.
+`npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.

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

@@ -56,7 +56,7 @@ not a fact about the page. Retrieve the same URL a second way before you judge i
 unavailable only after a second method also fails.
 
 If the pages support the selection, run
-`npx --yes copilotkit@4.9.0 onboard read frontend/plan`.
+`npx --yes copilotkit@4.9.1 onboard read frontend/plan`.
 
 If a second method also fails, or a page that loads does not support the selection, run
-`npx --yes copilotkit@4.9.0 onboard read unsupported/no-validated-path`.
+`npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.

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

@@ -40,7 +40,7 @@ not a fact about the page. Retrieve the same URL a second way before you judge i
 unavailable only after a second method also fails.
 
 If the pages support the selection, run
-`npx --yes copilotkit@4.9.0 onboard read frontend/plan`.
+`npx --yes copilotkit@4.9.1 onboard read frontend/plan`.
 
 If a second method also fails, or a page that loads does not support the selection, run
-`npx --yes copilotkit@4.9.0 onboard read unsupported/no-validated-path`.
+`npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.

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

@@ -42,7 +42,7 @@ not a fact about the page. Retrieve the same URL a second way before you judge i
 unavailable only after a second method also fails.
 
 If the pages support the selection, run
-`npx --yes copilotkit@4.9.0 onboard read frontend/plan`.
+`npx --yes copilotkit@4.9.1 onboard read frontend/plan`.
 
 If a second method also fails, or a page that loads does not support the selection, run
-`npx --yes copilotkit@4.9.0 onboard read unsupported/no-validated-path`.
+`npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.

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

@@ -36,7 +36,7 @@ not a fact about the page. Retrieve the same URL a second way before you judge i
 unavailable only after a second method also fails.
 
 If the pages support the selection, run
-`npx --yes copilotkit@4.9.0 onboard read frontend/plan`.
+`npx --yes copilotkit@4.9.1 onboard read frontend/plan`.
 
 If a second method also fails, or a page that loads does not support the selection, run
-`npx --yes copilotkit@4.9.0 onboard read unsupported/no-validated-path`.
+`npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.

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

@@ -36,7 +36,7 @@ not a fact about the page. Retrieve the same URL a second way before you judge i
 unavailable only after a second method also fails.
 
 If the pages support the selection, run
-`npx --yes copilotkit@4.9.0 onboard read frontend/plan`.
+`npx --yes copilotkit@4.9.1 onboard read frontend/plan`.
 
 If a second method also fails, or a page that loads does not support the selection, run
-`npx --yes copilotkit@4.9.0 onboard read unsupported/no-validated-path`.
+`npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.

package/onboarding/prompts/frontend/angular.md

@@ -26,8 +26,8 @@ not a fact about the page. Retrieve the same URL a second way before you judge i
 unavailable only after a second method also fails.
 
 If the page supports the selection, run
-`npx --yes copilotkit@4.9.0 onboard read credentials/finalize-plan`.
+`npx --yes copilotkit@4.9.1 onboard read credentials/finalize-plan`.
 
 If a second method also fails, or the page that loads does not support the selection,
 run
-`npx --yes copilotkit@4.9.0 onboard read unsupported/no-validated-path`.
+`npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.

package/onboarding/prompts/frontend/nextjs.md

@@ -22,7 +22,7 @@ not a fact about the page. Retrieve the same URL a second way before you judge i
 unavailable only after a second method also fails.
 
 If the pages support the selection, run
-`npx --yes copilotkit@4.9.0 onboard read credentials/finalize-plan`.
+`npx --yes copilotkit@4.9.1 onboard read credentials/finalize-plan`.
 
 If a second method also fails, or a page that loads does not support the selection, run
-`npx --yes copilotkit@4.9.0 onboard read unsupported/no-validated-path`.
+`npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.

package/onboarding/prompts/frontend/plan.md

@@ -3,6 +3,12 @@
 Use the repository findings to select the frontend. Ask the developer only for choices
 that the repository does not show. Do not change application code in this phase.
 
+Use a gentle wizard. Ask one short question at a time. Do not combine separate choices in
+one question. Put the recommendation first, give its evidence in one sentence, and keep
+the alternatives short. When the frontend is unknown, ask only whether to use the
+recommended frontend. If the developer declines it, ask one follow-up question that lists
+the valid frontend choices. Do not ask about the model or project in this step.
+
 If the project has a frontend, preserve it and use the matching route below. If the project
 needs a frontend, show the valid choices and one recommendation based on repository
 evidence, then ask the developer to choose.
@@ -23,11 +29,11 @@ unavailable only after a second method also fails.
 
 Use exactly one matching internal route:
 
-1. React SPA: `npx --yes copilotkit@4.9.0 onboard read frontend/react-spa`
-2. Next.js: `npx --yes copilotkit@4.9.0 onboard read frontend/nextjs`
-3. Angular: `npx --yes copilotkit@4.9.0 onboard read frontend/angular`
-4. Vue 3: `npx --yes copilotkit@4.9.0 onboard read frontend/vue`
-5. React Native: `npx --yes copilotkit@4.9.0 onboard read frontend/react-native`
+1. React SPA: `npx --yes copilotkit@4.9.1 onboard read frontend/react-spa`
+2. Next.js: `npx --yes copilotkit@4.9.1 onboard read frontend/nextjs`
+3. Angular: `npx --yes copilotkit@4.9.1 onboard read frontend/angular`
+4. Vue 3: `npx --yes copilotkit@4.9.1 onboard read frontend/vue`
+5. React Native: `npx --yes copilotkit@4.9.1 onboard read frontend/react-native`
 
 If no listed frontend fits, run
-`npx --yes copilotkit@4.9.0 onboard read unsupported/no-validated-path`.
+`npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.

package/onboarding/prompts/frontend/react-native.md

@@ -17,8 +17,8 @@ not a fact about the page. Retrieve the same URL a second way before you judge i
 unavailable only after a second method also fails.
 
 If the page supports the selection, run
-`npx --yes copilotkit@4.9.0 onboard read credentials/finalize-plan`.
+`npx --yes copilotkit@4.9.1 onboard read credentials/finalize-plan`.
 
 If a second method also fails, or the page that loads does not support the selection,
 run
-`npx --yes copilotkit@4.9.0 onboard read unsupported/no-validated-path`.
+`npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.

package/onboarding/prompts/frontend/react-spa.md

@@ -21,7 +21,7 @@ not a fact about the page. Retrieve the same URL a second way before you judge i
 unavailable only after a second method also fails.
 
 If the page supports the selection, run
-`npx --yes copilotkit@4.9.0 onboard read credentials/finalize-plan`.
+`npx --yes copilotkit@4.9.1 onboard read credentials/finalize-plan`.
 
 If a second method also fails, or a page that loads does not support the selection, run
-`npx --yes copilotkit@4.9.0 onboard read unsupported/no-validated-path`.
+`npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.

package/onboarding/prompts/frontend/vue.md

@@ -17,8 +17,8 @@ not a fact about the page. Retrieve the same URL a second way before you judge i
 unavailable only after a second method also fails.
 
 If the page supports the selection, run
-`npx --yes copilotkit@4.9.0 onboard read credentials/finalize-plan`.
+`npx --yes copilotkit@4.9.1 onboard read credentials/finalize-plan`.
 
 If a second method also fails, or the page that loads does not support the selection,
 run
-`npx --yes copilotkit@4.9.0 onboard read unsupported/no-validated-path`.
+`npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.

package/onboarding/prompts/implementation/build-and-validate.md

@@ -8,7 +8,7 @@ documentation URLs.
 Wait for the subagent to finish.
 
 If all implementation and validation steps pass, run
-`npx --yes copilotkit@4.9.0 onboard read proof/round-trip`.
+`npx --yes copilotkit@4.9.1 onboard read proof/round-trip`.
 
 If a validation command fails, decide which kind of failure it is before you route.
 
@@ -20,7 +20,7 @@ Route out only when the failure is not yours to fix: the failure is in code this
 not write, or the fix requires changing the developer's existing agent or frontend,
 or the same command still fails after three repair attempts, or the documentation does not
 support the plan. In those cases run
-`npx --yes copilotkit@4.9.0 onboard read unsupported/no-validated-path`.
+`npx --yes copilotkit@4.9.1 onboard read unsupported/no-validated-path`.
 
 ## Implementation subagent brief