copilotkit 4.16.0 → 4.17.0

package/onboarding/prompts/feature/voice/proof.md

@@ -10,26 +10,46 @@ When microphone permission is unavailable, use the official guide's documented c
 developer's behalf or claim a live recording was made. Record the visible control, transcript
 path, agent response, app URL, and process IDs. Fix changed-file defects and repeat.
 
+Give the proof subagent the protected path list and the authorized list. Take that list from
+the latest audit, and copy the paths under `Authorized to modify:`. Tell it this rule: a fix
+can change a path on the authorized list. When a fix needs any other protected path, it must
+not edit it. It returns a result that starts with `Status: blocked` and names the file under
+Blockers.
+
+That result is a question for the developer. The file has not changed yet, so consent can
+still go on the record. Name the file and why the fix needs it, then end your turn and wait
+for the developer's answer. If they allow it, record their answer before any edit:
+
+```text
+npx --prefer-offline --yes copilotkit@4.17.0 onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"
+```
+
+Continue only when the result starts with `Status: passed`. Run the audit again, take the
+new list from its `Authorized to modify:` block, and spawn a fresh proof subagent with the
+same handoff and that list. A subagent that already returned cannot pick up consent recorded
+after it was spawned. If you cannot ask, or the developer declines, take the feature stop
+route below.
+
 Report each attempt at the proof as it ends, counting from one:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.16.0 onboard checkpoint --phase journey-attempted --attempt 1
+npx --prefer-offline --yes copilotkit@4.17.0 onboard checkpoint --phase journey-attempted --attempt 1
 ```
 
 Report each repair cycle the same way, counting from one:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.16.0 onboard checkpoint --phase repair-attempted --attempt 1
+npx --prefer-offline --yes copilotkit@4.17.0 onboard checkpoint --phase repair-attempted --attempt 1
 ```
 
 After the final attempt, report the gate exactly once:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.16.0 onboard proof --step round-trip --outcome <passed|failed|skipped>
+npx --prefer-offline --yes copilotkit@4.17.0 onboard proof --step round-trip --outcome <passed|failed|skipped>
 ```
 
 Use `passed` only for proved voice input, `failed` for an attempted proof that failed, and
-`skipped` when the proof could not run. Then run `npx --prefer-offline --yes copilotkit@4.16.0 onboard audit`.
+`skipped` when the proof could not run. Then run `npx --prefer-offline --yes copilotkit@4.17.0 onboard audit`.
 Continue only when it starts with `Status: passed`.
 
 If the audit fails, never repair, reset, or revert a protected path. Compare each named path
@@ -37,16 +57,16 @@ with the proof subagent's `Files changed` section. If that section does not name
 run `onboard protect --accept-external --path <path>`, or
 `onboard protect --accept-credential --path <path>` for an env file where the developer
 placed a requested credential. If the subagent names the path, or its report does not settle
-who changed it, ask the developer to allow it. Only after they agree, run
-`onboard protect --authorize --unplanned --path <path> --reason "<what the developer said>"`.
-Run the audit again after each accepted or authorized change.
+who changed it, the change is this run's own, made without consent. Do not ask the developer
+to allow it: the CLI refuses consent for a path that already changed. Route out, and name
+the path and the change the audit reports. Run the audit again after each accepted change.
 
 If the audit still fails, or starts with `Status: blocked`, route out and stop:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.16.0 onboard read feature/stop
+npx --prefer-offline --yes copilotkit@4.17.0 onboard read feature/stop
 ```
 
 When the audit passes, run
-`npx --prefer-offline --yes copilotkit@4.16.0 onboard read feature/complete` with the actual surface
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read feature/complete` with the actual surface
 outcome.

package/onboarding/prompts/feature/voice/start.md

@@ -6,7 +6,7 @@ read-only, implementation, and proof subagents, each restricted to the target pr
 Before any subagent or project process runs, capture the developer's existing work:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.16.0 onboard protect
+npx --prefer-offline --yes copilotkit@4.17.0 onboard protect
 ```
 
 Keep the exact protected path list it prints and give that list to every subagent. No
@@ -16,14 +16,13 @@ approved authorization before implementation.
 Before edits, inspect the runtime route, CopilotKit provider/chat composer, current agent,
 existing provider credential variable names (presence only), package versions, browser
 permissions approach, and test/dev commands. Prove the existing OSS baseline with `/info`,
-`npx --prefer-offline --yes copilotkit@4.16.0 verify --expect-runtime oss --round-trip --agent <agent-id> --json`,
-and a real UI request when a browser is available. If that baseline is absent, change nothing
-and direct the developer to generic onboarding first.
+`npx --prefer-offline --yes copilotkit@4.17.0 verify --expect-runtime oss --round-trip --agent <agent-id> --json`,
+and a real UI request when a browser is available.
 
 Wait for the inspection subagent to finish. Then report that the inspection came back:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.16.0 onboard checkpoint --phase research-returned
+npx --prefer-offline --yes copilotkit@4.17.0 onboard checkpoint --phase research-returned
 ```
 
 A refused checkpoint prints its reason and leaves onboarding unaffected. It is not a
@@ -33,7 +32,7 @@ If the inspection did not prove the baseline this intent extends, stop here with
 changing files:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.16.0 onboard read feature/stop
+npx --prefer-offline --yes copilotkit@4.17.0 onboard read feature/stop
 ```
 
 Do not run login, select Intelligence, create a credential, read a credential value, or
@@ -54,7 +53,7 @@ one.
 After approval, record each approved path before implementation:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.16.0 onboard protect --authorize --path <path> --reason "<the plan's sentence>"
+npx --prefer-offline --yes copilotkit@4.17.0 onboard protect --authorize --path <path> --reason "<the plan's sentence>"
 ```
 
 If an approved path changed after capture and no implementation step has run, add
@@ -64,7 +63,7 @@ authorize a path the approved plan did not list.
 Then report the plan this run is about to implement:
 
 ```text
-npx --prefer-offline --yes copilotkit@4.16.0 onboard checkpoint --phase plan-written
+npx --prefer-offline --yes copilotkit@4.17.0 onboard checkpoint --phase plan-written
 ```
 
-Then run `npx --prefer-offline --yes copilotkit@4.16.0 onboard read feature/voice/implement`.
+Then run `npx --prefer-offline --yes copilotkit@4.17.0 onboard read feature/voice/implement`.

package/onboarding/prompts/framework/ag2.md

@@ -31,7 +31,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.16.0 onboard read frontend/plan`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read frontend/plan`.
 
 If the documentation does not support the selection, run
-`npx --prefer-offline --yes copilotkit@4.16.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read unsupported/no-validated-path`.

package/onboarding/prompts/framework/agno.md

@@ -23,8 +23,8 @@ new agent. For a new agent, install the documented Python dependencies
 the endpoint without repository evidence.
 
 The agent-readonly page does not bundle its Agno backend context setup. Do not invent it.
-If the requested work needs that setup and the project does not already have it, run the
-unsupported route below.
+If the requested work passes project data to the agent and the project does not already have that
+setup, run the unsupported route below. Otherwise, record the gap and continue.
 
 A2UI is not on this path. If the developer asks for it, say first that its page has no Agno
 backend schema-loading, render-operations, or runtime setup snippet, so there is nothing to
@@ -34,7 +34,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.16.0 onboard read frontend/plan`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read frontend/plan`.
 
 If the documentation does not support the selection, run
-`npx --prefer-offline --yes copilotkit@4.16.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read unsupported/no-validated-path`.

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

@@ -29,7 +29,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.16.0 onboard read frontend/plan`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read frontend/plan`.
 
 If the documentation does not support the selection, run
-`npx --prefer-offline --yes copilotkit@4.16.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read unsupported/no-validated-path`.

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

@@ -13,6 +13,7 @@ Name the model credential `ANTHROPIC_API_KEY`. The documented model variable is
 - https://docs.copilotkit.ai/claude-sdk-python/inspector.md
 - https://docs.copilotkit.ai/claude-sdk-python/generative-ui/tool-based.md
 - https://docs.copilotkit.ai/reference/v2/hooks/useAgentContext.md
+- https://docs.copilotkit.ai/claude-sdk-python/shared-state/agent-readonly.md
 
 The documentation scope is `claude-sdk-python`. For an existing agent, install the exact
 documented backend set with
@@ -25,15 +26,15 @@ A2UI is not on this path. If the developer asks for it, say first that the docum
 Python setup does not support `action_handlers` on `a2ui.render`, so its button callback
 cannot return a decision to the agent.
 
-No Claude Agent SDK Python agent-app-context Markdown page is available. The reference
-page above documents the frontend hook only. Do not invent the missing agent-side context
-setup. If the requested work needs that setup, run the unsupported route below.
+Where the requested work passes project data to the agent, follow the agent-readonly page above for
+both sides. The adapter does not add the context to the Claude prompt by itself, so the
+agent-side step on that page, which appends the context to the system prompt, is required.
 
-Record the selected framework, vendor, model, required credential variable names, these
-URLs, and the context limit.
+Record the selected framework, vendor, model, required credential variable names, and
+these URLs.
 
 If the pages support the selection, run
-`npx --prefer-offline --yes copilotkit@4.16.0 onboard read frontend/plan`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read frontend/plan`.
 
 If the documentation does not support the selection, run
-`npx --prefer-offline --yes copilotkit@4.16.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.17.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.16.0 onboard read frontend/plan`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read frontend/plan`.
 
 If the documentation does not support the selection, run
-`npx --prefer-offline --yes copilotkit@4.16.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read unsupported/no-validated-path`.

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

@@ -4,6 +4,13 @@ Preserve the project's existing CrewAI Flow, provider, model, and deployment. Th
 pages do not name a default model vendor or model credential variable. Do not choose a
 vendor or credential name for the developer.
 
+When the target directory holds no project, do not ask the vendor question yet. The
+frontend is chosen next, and with Next.js the run clones the CrewAI Flows starter, which
+reads `OPENAI_API_KEY`, so an answer here decides nothing. If the run clones that
+starter, tell the developer that the starter decides the vendor. If the frontend prompt
+sends you to its Documentation section instead, ask the vendor question below at that
+point, before the plan.
+
 When the repository shows a provider, keep it and ask nothing further about it. When
 neither the repository nor these pages show one, the developer decides, so ask. Ask one
 short question: which model vendor the CrewAI Flow will call. Say that the CopilotKit
@@ -24,6 +31,7 @@ vendor. That route is for a documentation page that does not support the selecti
 - https://docs.copilotkit.ai/crewai-crews/inspector.md
 - https://docs.copilotkit.ai/crewai-crews/generative-ui/tool-based.md
 - https://docs.copilotkit.ai/crewai-crews/shared-state/in-app-agent-read.md
+- https://docs.copilotkit.ai/crewai-crews/agent-app-context.md
 
 The public onboarding route ID is `crewai-flows`. The canonical documentation scope is
 `crewai-crews`. The quickstart and feature pages also contain older `/crewai-flows/`
@@ -45,16 +53,16 @@ A2UI is not on this path. If the developer asks for it, say first that its page
 this base adapter rather than standing alone, so it needs the Flow to call
 `copilotkit_emit_tool_result` itself.
 
-The shared-state page is not an agent-app-context guide. Do not use it to invent a
-`useAgentContext` backend setup. If the requested work needs app context rather than the
-documented shared-state path, run the unsupported route below.
+The shared-state page is not an agent-app-context guide. Where the requested work passes project data
+to the agent, follow the agent-app-context page above for both sides. The Flow does not
+receive the context by itself, so the steps that declare `context` on the state class and
+render it into the crew's work are required.
 
 Record the selected framework, project-defined provider and model, the credential
-variable names the repository proves or the developer named, these URLs, the adapter, and the
-shared-state limit.
+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.16.0 onboard read frontend/plan`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read frontend/plan`.
 
 If the documentation does not support the selection, run
-`npx --prefer-offline --yes copilotkit@4.16.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read unsupported/no-validated-path`.

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

@@ -20,7 +20,8 @@ Preserve the project's existing deployment path. Choose the same `Deep Agent` or
 deployment to FastAPI or a FastAPI deployment to Deep Agent.
 
 No Deep Agents agent-app-context Markdown page is available. Do not invent an
-agent-app-context setup. If the requested work needs it, run the unsupported route below.
+agent-app-context setup. If the requested work passes project data to the agent, run the unsupported
+route below. Otherwise, record the gap and continue.
 
 A2UI is not on this path. If the developer asks for it, say first that its backend example
 is Python-only, so a TypeScript project has nothing to follow.
@@ -32,7 +33,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.16.0 onboard read frontend/plan`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read frontend/plan`.
 
 If the documentation does not support the selection, run
-`npx --prefer-offline --yes copilotkit@4.16.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read unsupported/no-validated-path`.

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

@@ -14,15 +14,15 @@ key.
 - https://docs.copilotkit.ai/google-adk/inspector.md
 - https://docs.copilotkit.ai/google-adk/generative-ui/tool-based.md
 - https://docs.copilotkit.ai/reference/v2/hooks/useAgentContext.md
+- https://docs.copilotkit.ai/google-adk/agent-app-context.md
 
 The documentation scope is `google-adk`. A `/adk/` URL answers with a redirect stub
 whose body is the canonical path, so fetch the `google-adk` form.
 
-No page documents the Google ADK side of frontend context. The reference page above
-names the frontend hook, and the agent side of the step is undocumented here. Record
-that missing page as a documentation gap. Do not read the built-in-agent context page
-in its place: that page states no backend work is needed, which holds for the built-in
-agent and not for ADK.
+Follow the agent-app-context page above for both sides of frontend context. The ADK
+agent does not receive the context by itself, so the agent-side step on that page is
+required. Do not read the built-in-agent context page in its place: that page states no
+backend work is needed, which holds for the built-in agent and not for ADK.
 
 Connect the Copilot Runtime with `HttpAgent` from `@ag-ui/client`.
 
@@ -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.16.0 onboard read frontend/plan`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read frontend/plan`.
 
 If the documentation does not support the selection, run
-`npx --prefer-offline --yes copilotkit@4.16.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read unsupported/no-validated-path`.

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

@@ -25,7 +25,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.16.0 onboard read frontend/plan`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read frontend/plan`.
 
 If the documentation does not support the selection, run
-`npx --prefer-offline --yes copilotkit@4.16.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read unsupported/no-validated-path`.

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

@@ -19,7 +19,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.16.0 onboard read frontend/plan`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read frontend/plan`.
 
 If the documentation does not support the selection, run
-`npx --prefer-offline --yes copilotkit@4.16.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read unsupported/no-validated-path`.

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

@@ -19,7 +19,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.16.0 onboard read frontend/plan`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read frontend/plan`.
 
 If the documentation does not support the selection, run
-`npx --prefer-offline --yes copilotkit@4.16.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read unsupported/no-validated-path`.

package/onboarding/prompts/framework/llamaindex.md

@@ -27,14 +27,14 @@ LlamaIndex backend code but does not bundle its runtime setup, so it only works
 the quickstart runtime it extends.
 
 The shared-state page is not an agent-app-context guide. Do not use it to invent a
-`useAgentContext` backend setup. If the requested work needs app context rather than the
-documented shared-state path, run the unsupported route below.
+`useAgentContext` backend setup. If the requested work passes project data to the agent, run the
+unsupported route below. Otherwise, record the gap and continue.
 
 Record the selected framework, vendor, model, required credential variable names, these
 URLs, the documented dependencies and adapter, and both documentation limits.
 
 If the pages support the selection, run
-`npx --prefer-offline --yes copilotkit@4.16.0 onboard read frontend/plan`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read frontend/plan`.
 
 If the documentation does not support the selection, run
-`npx --prefer-offline --yes copilotkit@4.16.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read unsupported/no-validated-path`.

package/onboarding/prompts/framework/mastra.md

@@ -47,7 +47,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.16.0 onboard read frontend/plan`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read frontend/plan`.
 
 If the documentation does not support the selection, run
-`npx --prefer-offline --yes copilotkit@4.16.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read unsupported/no-validated-path`.

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

@@ -36,7 +36,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.16.0 onboard read frontend/plan`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read frontend/plan`.
 
 If the documentation does not support the selection, run
-`npx --prefer-offline --yes copilotkit@4.16.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read unsupported/no-validated-path`.

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

@@ -44,7 +44,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.16.0 onboard read frontend/plan`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read frontend/plan`.
 
 If the documentation does not support the selection, run
-`npx --prefer-offline --yes copilotkit@4.16.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read unsupported/no-validated-path`.

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

@@ -4,10 +4,10 @@ Preserve an existing Microsoft Agent Framework model setup. Start with OpenAI fo
 agent. 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`. This framework also accepts
-Azure OpenAI, through `AZURE_OPENAI_ENDPOINT` and `AZURE_OPENAI_CHAT_DEPLOYMENT_NAME`.
-Pick one of the two and name it. A scaffold that writes one spelling and reads the other
-looks finished and reads no key.
+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
+`AZURE_OPENAI_CHAT_DEPLOYMENT_NAME`. Keep Azure OpenAI only when the project already uses
+it. A scaffold that writes one spelling and reads the other looks finished and reads no key.
 
 This framework reads no `.env` on its own. Whatever loads the file is application code,
 so a scaffold that writes `agent/.env` and never loads it starts with no credential.
@@ -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.16.0 onboard read frontend/plan`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read frontend/plan`.
 
 If the documentation does not support the selection, run
-`npx --prefer-offline --yes copilotkit@4.16.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read unsupported/no-validated-path`.

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

@@ -43,7 +43,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.16.0 onboard read frontend/plan`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read frontend/plan`.
 
 If the documentation does not support the selection, run
-`npx --prefer-offline --yes copilotkit@4.16.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read unsupported/no-validated-path`.

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

@@ -20,8 +20,8 @@ A2UI tool makes its own OpenAI call, so it bills a second model call this plan d
 account for.
 
 No Strands agent-app-context Markdown page is available. Do not invent an
-agent-app-context setup. If the requested work needs that missing setup, run the
-unsupported route below.
+agent-app-context setup. If the requested work passes project data to the agent, run the unsupported
+route below. Otherwise, record the gap and continue.
 
 Connect the Copilot Runtime with `HttpAgent` from `@ag-ui/client`.
 
@@ -29,7 +29,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.16.0 onboard read frontend/plan`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read frontend/plan`.
 
 If the documentation does not support the selection, run
-`npx --prefer-offline --yes copilotkit@4.16.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read unsupported/no-validated-path`.

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

@@ -18,8 +18,8 @@ these pages. Install `@modelcontextprotocol/sdk` as a runtime dependency.
 `@strands-agents/sdk` loads it even when the application does not use MCP.
 
 No Strands TypeScript agent-app-context Markdown page is available. Do not translate
-another language's backend example or invent that setup. If the requested work needs it,
-run the unsupported route below.
+another language's backend example or invent that setup. If the requested work passes project data
+to the agent, run the unsupported route below. Otherwise, record the gap and continue.
 
 A2UI is not on this path. If the developer asks for it, say first that its page has no
 Strands TypeScript backend example, so a TypeScript project has nothing to follow.
@@ -30,7 +30,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.16.0 onboard read frontend/plan`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read frontend/plan`.
 
 If the documentation does not support the selection, run
-`npx --prefer-offline --yes copilotkit@4.16.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read unsupported/no-validated-path`.

package/onboarding/prompts/frontend/angular.md

@@ -5,7 +5,7 @@ Preserve an existing Angular frontend. Use the selected page for a new frontend.
 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.16.0 onboard read starter/clone` before you fetch documentation.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read starter/clone` before you fetch documentation.
 
 ## Documentation
 
@@ -63,7 +63,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.16.0 onboard read credentials/finalize-plan`.
+`npx --prefer-offline --yes copilotkit@4.17.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.16.0 onboard read unsupported/no-validated-path`.
+together, run `npx --prefer-offline --yes copilotkit@4.17.0 onboard read unsupported/no-validated-path`.

package/onboarding/prompts/frontend/nextjs.md

@@ -15,7 +15,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.16.0 onboard read starter/clone` before you fetch documentation.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read starter/clone` before you fetch documentation.
 
 ## Documentation
 
@@ -26,8 +26,21 @@ agent framework documentation instead. This page configures the CopilotKit built
 agent as the default agent, which is correct only for a project that has no agent.
 Do not replace the developer's existing agent with the built-in agent.
 
+## Files that `next dev` writes
+
+If a coding agent starts `next dev` on Next.js 16.3 or later, Next.js writes `AGENTS.md`
+and `CLAUDE.md` in the app directory. If one of the files exists, Next.js adds its own
+block to that file. These files are Next.js output. They are not your work and not the
+developer's work.
+
+- For a new frontend that you create, pass `--no-agents-md` to `create-next-app`. If
+  the installed Next.js is 16.3 or later, also set `agentRules: false` in
+  `next.config.ts`.
+- 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.
+
 If the page supports the selection, record Next.js and this URL. Then run
-`npx --prefer-offline --yes copilotkit@4.16.0 onboard read credentials/finalize-plan`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read credentials/finalize-plan`.
 
 If the documentation does not support the selection, run
-`npx --prefer-offline --yes copilotkit@4.16.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read unsupported/no-validated-path`.

package/onboarding/prompts/frontend/plan.md

@@ -36,15 +36,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.16.0 onboard read frontend/react-spa`
-2. Next.js: `npx --prefer-offline --yes copilotkit@4.16.0 onboard read frontend/nextjs`
-3. Angular: `npx --prefer-offline --yes copilotkit@4.16.0 onboard read frontend/angular`
-4. Vue 3: `npx --prefer-offline --yes copilotkit@4.16.0 onboard read frontend/vue`
-5. React Native: `npx --prefer-offline --yes copilotkit@4.16.0 onboard read frontend/react-native`
-6. Slack or Microsoft Teams: `npx --prefer-offline --yes copilotkit@4.16.0 onboard read feature/channels/start`
+1. React SPA: `npx --prefer-offline --yes copilotkit@4.17.0 onboard read frontend/react-spa`
+2. Next.js: `npx --prefer-offline --yes copilotkit@4.17.0 onboard read frontend/nextjs`
+3. Angular: `npx --prefer-offline --yes copilotkit@4.17.0 onboard read frontend/angular`
+4. Vue 3: `npx --prefer-offline --yes copilotkit@4.17.0 onboard read frontend/vue`
+5. React Native: `npx --prefer-offline --yes copilotkit@4.17.0 onboard read frontend/react-native`
+6. Slack or Microsoft Teams: `npx --prefer-offline --yes copilotkit@4.17.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.16.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read unsupported/no-validated-path`.

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

@@ -18,7 +18,7 @@ documents `useRenderTool`, which is React Native's own hook for drawing a tool t
 already has. That is a different job and needs a tool in the agent.
 
 If the pages support the selection, record React Native and these URLs. Then run
-`npx --prefer-offline --yes copilotkit@4.16.0 onboard read credentials/finalize-plan`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read credentials/finalize-plan`.
 
 If the documentation does not support the selection, run
-`npx --prefer-offline --yes copilotkit@4.16.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read unsupported/no-validated-path`.

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

@@ -14,7 +14,7 @@ not move the agent into it.
 - https://docs.copilotkit.ai/react-spa.md
 
 If the page supports the selection, record React SPA and this URL. Then run
-`npx --prefer-offline --yes copilotkit@4.16.0 onboard read credentials/finalize-plan`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read credentials/finalize-plan`.
 
 If the documentation does not support the selection, run
-`npx --prefer-offline --yes copilotkit@4.16.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read unsupported/no-validated-path`.

package/onboarding/prompts/frontend/vue.md

@@ -19,7 +19,7 @@ page above. Vue has its own `useComponent`, which is not the React package. Take
 that reference page rather than from a Vue generative-UI guide, which is not published.
 
 If the pages support the selection, record Vue 3 and these URLs. Then run
-`npx --prefer-offline --yes copilotkit@4.16.0 onboard read credentials/finalize-plan`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read credentials/finalize-plan`.
 
 If the documentation does not support the selection, run
-`npx --prefer-offline --yes copilotkit@4.16.0 onboard read unsupported/no-validated-path`.
+`npx --prefer-offline --yes copilotkit@4.17.0 onboard read unsupported/no-validated-path`.