copilotkit 4.8.3 → 4.9.0

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

@@ -1,6 +1,41 @@
-# Configure Microsoft Agent Framework .NET
+# Configure Microsoft Agent Framework for .NET
 
-Preserve an existing Microsoft Agent Framework .NET setup. Start with GitHub Models for a new agent. Ask the developer to choose the model. Record the required credential variable names.
+Preserve an existing Microsoft Agent Framework model setup. Start with GitHub Models for
+a new agent, which is what the starter configures. Offer another vendor only after an
+exact CopilotKit Markdown page names it. The page must name its credential variables and
+setup steps.
+
+This agent resolves its model credential in a fixed order: the `OPENAI_API_KEY`
+environment variable, then `OPENAI_API_KEY` in configuration, then a `GitHubToken` user
+secret. The environment variable wins.
+
+Neither this framework nor .NET configuration reads a `.env`. `builder.Configuration`
+sources appsettings, environment variables, and user secrets, and none of those is a
+dotenv file. A credential in `.env` works only if application code loads it into the
+environment before the chat client constructs: walk up from the working directory for a
+`.env` and set each name that is not already set. Otherwise pick a mechanism .NET reads
+on its own, an exported variable or a user secret. A scaffold that writes `.env`, reads
+`builder.Configuration["OPENAI_API_KEY"]`, and loads nothing falls silently to the
+`GitHubToken` branch.
+
+Pick one and say which. For GitHub Models, set the user secret from the agent directory
+with `dotnet user-secrets set GitHubToken`. The agent reads it through
+`builder.Configuration["GitHubToken"]`, so the name in the store and the name in the
+code have to match exactly. For an OpenAI-compatible vendor, name `OPENAI_API_KEY`
+instead.
+
+The GitHub Models catalog is not the OpenAI catalog. A model name that is valid against
+`api.openai.com` can return 404 against `https://models.inference.ai.azure.com`, so a
+run that falls back to the `GitHubToken` branch and keeps the same model name gets a 404
+that looks like an outage rather than a wrong catalog. Name a model the endpoint you
+selected serves.
+
+Check whether `OPENAI_API_KEY` is already set in the environment before you configure a
+user secret. It takes precedence, so a run on a machine that already exports one uses
+that key rather than the token you just set, and reports success for the wrong reason.
+
+The .NET SDK has to be installed before any of this. Confirm `dotnet --version` answers
+before scaffolding, rather than after.
 
 Keep `INTELLIGENCE_API_KEY` separate from model-vendor credentials. Do not read, show,
 store, or request a secret value.
@@ -10,12 +45,27 @@ store, or request a secret value.
 - https://docs.copilotkit.ai/ms-agent-dotnet/quickstart.md
 - https://docs.copilotkit.ai/ms-agent-dotnet/inspector.md
 - https://docs.copilotkit.ai/ms-agent-dotnet/generative-ui/a2ui/fixed-schema.md
+- https://docs.copilotkit.ai/ms-agent-dotnet/agent-app-context.md
+
+Fetch all four pages in one step rather than one after another. Sequential fetching
+cost about nine minutes of the first proven journey.
+
+The documentation scope is `ms-agent-dotnet`. The quickstart at that scope is
+byte-identical to the one at `ms-agent-python`: one page serves both languages through
+a `.NET` and `Python` tab group. The scope in the URL does not select the language, so
+read the .NET tab.
+
+Record the selected framework, vendor, model, required credential variable names, and
+these URLs.
+Do not use remembered CopilotKit instructions.
 
-Fetch all three pages. Record the selected framework, vendor, model, required credential
-variable names, and these URLs. Do not use remembered CopilotKit instructions.
+A fetch tool that refuses a URL, or fails to reach it, reports a limit of the tool and
+not a fact about the page. Retrieve the same URL a second way before you judge it. Run
+`curl -fsSL <url>`, or read the same page without the `.md` suffix. Treat a page as
+unavailable only after a second method also fails.
 
 If the pages support the selection, run
-`npx copilotkit@4.8.3 onboard read frontend/plan`.
+`npx --yes copilotkit@4.9.0 onboard read frontend/plan`.
 
-If a page does not load or support the selection, run
-`npx copilotkit@4.8.3 onboard read unsupported/no-validated-path`.
+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`.

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

@@ -1,7 +1,14 @@
-# Configure Microsoft Agent Framework Harness .NET
+# Configure MS Agent Harness for .NET
 
-If the repository uses this framework, preserve it. Preserve its model vendor and model
-setup. Record the required credential variable names from the selected CopilotKit pages.
+Preserve an existing MS Agent Harness model, vendor, credential name, and host setup. The
+documented .NET starter uses GitHub Models. Use that vendor for a new matching setup.
+
+For GitHub Models, name the user secret `GitHubToken`. Set it from the agent directory
+with `dotnet user-secrets set GitHubToken`. The app must read the same name through .NET
+configuration. Confirm `dotnet --version` works before changing the project.
+
+For an existing OpenAI setup, keep `OPENAI_API_KEY` and the existing OpenAI client. Do not
+convert it to GitHub Models.
 
 Keep `INTELLIGENCE_API_KEY` separate from model-vendor credentials. Do not read, show,
 store, or request a secret value.
@@ -11,12 +18,45 @@ store, or request a secret value.
 - https://docs.copilotkit.ai/ms-agent-harness-dotnet/quickstart.md
 - https://docs.copilotkit.ai/ms-agent-harness-dotnet/inspector.md
 - https://docs.copilotkit.ai/ms-agent-harness-dotnet/generative-ui/a2ui/fixed-schema.md
+- https://docs.copilotkit.ai/ms-agent-harness-dotnet/agent-app-context.md
+
+Fetch all four pages in one step rather than one after another.
+
+The documentation scope is `ms-agent-harness-dotnet`. Read only the `.NET` tab of the
+quickstart. Do not use its Python tab. Use `Microsoft.Agents.AI.Harness --version 1.19.0`
+for the stable agent package. The current AG-UI host package is
+`Microsoft.Agents.AI.Hosting.AGUI.AspNetCore --version 1.19.0-preview.260822.1`.
+Use `AddAGUIServer` service registration and a `MapAGUIServer` endpoint. The older
+showcase uses `AddAGUI` and `MapAGUI`. Do not copy those stale names into the current
+host. Register the remote endpoint in Copilot Runtime with `HttpAgent`.
+
+The quickstart's generic .NET example uses `CreateAIAgent`. Do not replace an existing
+Harness agent with that example. For a new Harness agent, use `AsHarnessAgent` with
+`HarnessAgentOptions`. Disable built-in providers that add environment-dependent tools,
+then pass the project-owned tools through `ChatOptions`.
+
+For fixed-schema A2UI, keep the C# tool and its inline schema in the Harness agent. Set
+`injectA2UITool` to `false` in the runtime. The page omits a bundled setup block, and its
+action-handler note describes Python SDK behavior. Do not infer C# action-handler support
+from the Python-only note. If the visible C# steps do not cover the requested setup, run
+the unsupported route below.
+
+A bare `HarnessAgent` does not consume AG-UI app context. The published example adds a
+custom `DelegatingAIAgent` wrapper that reads context from `ChatOptions.AdditionalProperties`
+and injects a system message. Keep app context unsupported until that wrapper passes
+browser proof. Do not copy the page's generic `CreateAIAgent` constructor over an existing
+Harness agent.
+
+Record the selected framework, vendor, model, required credential variable names, these
+URLs, and the quickstart and A2UI gaps. Do not use remembered CopilotKit instructions.
 
-Fetch all three pages. Record the selected framework, vendor, model, required credential
-variable names, and these URLs. Do not use remembered CopilotKit instructions.
+A fetch tool that refuses a URL, or fails to reach it, reports a limit of the tool and
+not a fact about the page. Retrieve the same URL a second way before you judge it. Run
+`curl -fsSL <url>`, or read the same page without the `.md` suffix. Treat a page as
+unavailable only after a second method also fails.
 
 If the pages support the selection, run
-`npx copilotkit@4.8.3 onboard read frontend/plan`.
+`npx --yes copilotkit@4.9.0 onboard read frontend/plan`.
 
-If a page does not load or support the selection, run
-`npx copilotkit@4.8.3 onboard read unsupported/no-validated-path`.
+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`.

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

@@ -1,6 +1,16 @@
-# Configure Microsoft Agent Framework Python
+# Configure Microsoft Agent Framework for Python
 
-Preserve an existing Microsoft Agent Framework Python setup. Offer OpenAI or Azure OpenAI for a new agent. Ask the developer to choose the vendor and model. Record the required credential variable names.
+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.
+
+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.
+
+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.
 
 Keep `INTELLIGENCE_API_KEY` separate from model-vendor credentials. Do not read, show,
 store, or request a secret value.
@@ -10,12 +20,27 @@ store, or request a secret value.
 - https://docs.copilotkit.ai/ms-agent-python/quickstart.md
 - https://docs.copilotkit.ai/ms-agent-python/inspector.md
 - https://docs.copilotkit.ai/ms-agent-python/generative-ui/a2ui/fixed-schema.md
+- https://docs.copilotkit.ai/ms-agent-python/agent-app-context.md
+
+Fetch all four pages in one step rather than one after another. Sequential fetching
+cost about nine minutes of the first proven journey.
+
+The documentation scope is `ms-agent-python`. The quickstart at that scope is
+byte-identical to the one at `ms-agent-dotnet`: one page serves both languages through
+a `.NET` and `Python` tab group. The scope in the URL does not select the language, so
+read the Python tab. The first code block on the page is the .NET one.
+
+Record the selected framework, vendor, model, required credential variable names, and
+these URLs.
+Do not use remembered CopilotKit instructions.
 
-Fetch all three pages. Record the selected framework, vendor, model, required credential
-variable names, and these URLs. Do not use remembered CopilotKit instructions.
+A fetch tool that refuses a URL, or fails to reach it, reports a limit of the tool and
+not a fact about the page. Retrieve the same URL a second way before you judge it. Run
+`curl -fsSL <url>`, or read the same page without the `.md` suffix. Treat a page as
+unavailable only after a second method also fails.
 
 If the pages support the selection, run
-`npx copilotkit@4.8.3 onboard read frontend/plan`.
+`npx --yes copilotkit@4.9.0 onboard read frontend/plan`.
 
-If a page does not load or support the selection, run
-`npx copilotkit@4.8.3 onboard read unsupported/no-validated-path`.
+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`.

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

@@ -1,8 +1,10 @@
-# Configure PydanticAI
+# Configure Pydantic AI
 
-Preserve an existing PydanticAI model setup. Start with OpenAI for a new agent. Offer
-another vendor only after the selected CopilotKit Markdown pages document it. The pages must
-name its credential variables and setup steps.
+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.
+
+Name the default model credential `OPENAI_API_KEY`.
 
 Keep `INTELLIGENCE_API_KEY` separate from model-vendor credentials. Do not read, show,
 store, or request a secret value.
@@ -12,12 +14,35 @@ store, or request a secret value.
 - https://docs.copilotkit.ai/pydantic-ai/quickstart.md
 - https://docs.copilotkit.ai/pydantic-ai/inspector.md
 - https://docs.copilotkit.ai/pydantic-ai/generative-ui/a2ui/fixed-schema.md
+- https://docs.copilotkit.ai/reference/v2/hooks/useAgentContext.md
+
+Fetch all four pages in one step rather than one after another.
+
+The documentation scope is `pydantic-ai`. For an existing agent, install the exact
+documented backend set with
+`uv add 'pydantic-ai-slim[ag-ui,openai]>=2,<3' 'starlette>=0.46.2' uvicorn`.
+Keep the Starlette endpoint that calls `AGUIAdapter.dispatch_request`. Register it in
+Copilot Runtime with `HttpAgent` and keep `InMemoryAgentRunner` for the documented local
+OSS setup. Do not replace this transport with a different Pydantic AI adapter.
+
+For fixed-schema A2UI, keep the tool in the agent. Set `injectA2UITool` to `false` in the
+runtime. The documented Python setup does not support `action_handlers` on
+`a2ui.render`. Do not add them or claim that the fixed-schema button callback works.
+
+No Pydantic AI 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.
+
+Record the selected framework, vendor, model, required credential variable names, these
+URLs, and the context and A2UI limits. Do not use remembered CopilotKit instructions.
 
-Fetch all three pages. Record the selected framework, vendor, model, required credential
-variable names, and these URLs. Do not use remembered CopilotKit instructions.
+A fetch tool that refuses a URL, or fails to reach it, reports a limit of the tool and
+not a fact about the page. Retrieve the same URL a second way before you judge it. Run
+`curl -fsSL <url>`, or read the same page without the `.md` suffix. Treat a page as
+unavailable only after a second method also fails.
 
 If the pages support the selection, run
-`npx copilotkit@4.8.3 onboard read frontend/plan`.
+`npx --yes copilotkit@4.9.0 onboard read frontend/plan`.
 
-If a page does not load or support the selection, run
-`npx copilotkit@4.8.3 onboard read unsupported/no-validated-path`.
+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`.

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

@@ -1,8 +1,10 @@
-# Configure AWS Strands Python
+# Configure Strands Agents Python
 
-Preserve an existing AWS Strands Python model setup. Start with OpenAI for a new agent.
-Offer another vendor only after the selected CopilotKit Markdown pages document it. The
-pages must name its credential variables and setup steps.
+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.
+
+Name the default model credential `OPENAI_API_KEY`.
 
 Keep `INTELLIGENCE_API_KEY` separate from model-vendor credentials. Do not read, show,
 store, or request a secret value.
@@ -12,12 +14,29 @@ store, or request a secret value.
 - https://docs.copilotkit.ai/strands/quickstart.md
 - https://docs.copilotkit.ai/strands/inspector.md
 - https://docs.copilotkit.ai/strands/generative-ui/a2ui/fixed-schema.md
+- https://docs.copilotkit.ai/strands/shared-state/agent-readonly.md
+
+Fetch all four pages in one step rather than one after another.
+
+The documentation scope is `strands`. Use the Python examples from these pages.
+The fixed-schema A2UI tool makes its own OpenAI call. Set `injectA2UITool` to `false` when
+the fixed-schema A2UI tool makes its own OpenAI call. This prevents a second injected A2UI
+tool from changing the documented setup.
+
+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.
+
+Record the selected framework, vendor, model, required credential variable names, these
+URLs, and the context documentation gap. Do not use remembered CopilotKit instructions.
 
-Fetch all three pages. Record the selected framework, vendor, model, required credential
-variable names, and these URLs. Do not use remembered CopilotKit instructions.
+A fetch tool that refuses a URL, or fails to reach it, reports a limit of the tool and
+not a fact about the page. Retrieve the same URL a second way before you judge it. Run
+`curl -fsSL <url>`, or read the same page without the `.md` suffix. Treat a page as
+unavailable only after a second method also fails.
 
 If the pages support the selection, run
-`npx copilotkit@4.8.3 onboard read frontend/plan`.
+`npx --yes copilotkit@4.9.0 onboard read frontend/plan`.
 
-If a page does not load or support the selection, run
-`npx copilotkit@4.8.3 onboard read unsupported/no-validated-path`.
+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`.

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

@@ -1,8 +1,10 @@
-# Configure AWS Strands TypeScript
+# Configure Strands Agents TypeScript
 
-Preserve an existing AWS Strands TypeScript model setup. Start with OpenAI for a new agent.
-Offer another vendor only after the selected CopilotKit Markdown pages document it. The
-pages must name its credential variables and setup steps.
+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.
+
+Name the default model credential `OPENAI_API_KEY`.
 
 Keep `INTELLIGENCE_API_KEY` separate from model-vendor credentials. Do not read, show,
 store, or request a secret value.
@@ -12,12 +14,29 @@ store, or request a secret value.
 - https://docs.copilotkit.ai/strands-typescript/quickstart.md
 - https://docs.copilotkit.ai/strands-typescript/inspector.md
 - https://docs.copilotkit.ai/strands-typescript/generative-ui/a2ui/fixed-schema.md
+- https://docs.copilotkit.ai/strands-typescript/shared-state/agent-readonly.md
+
+Fetch all four pages in one step rather than one after another.
+
+The documentation scope is `strands-typescript`. Use only the TypeScript examples from
+these pages. Install `@modelcontextprotocol/sdk` as a runtime dependency.
+`@strands-agents/sdk` loads it even when the application does not use MCP.
+
+The fixed-schema page has no Strands TypeScript backend example. No Strands TypeScript
+agent-app-context Markdown page is available. Do not translate another language's backend
+example or invent either missing setup. If the requested work needs either missing setup,
+run the unsupported route below.
+
+Record the selected framework, vendor, model, required credential variable names, these
+URLs, and both documentation gaps. Do not use remembered CopilotKit instructions.
 
-Fetch all three pages. Record the selected framework, vendor, model, required credential
-variable names, and these URLs. Do not use remembered CopilotKit instructions.
+A fetch tool that refuses a URL, or fails to reach it, reports a limit of the tool and
+not a fact about the page. Retrieve the same URL a second way before you judge it. Run
+`curl -fsSL <url>`, or read the same page without the `.md` suffix. Treat a page as
+unavailable only after a second method also fails.
 
 If the pages support the selection, run
-`npx copilotkit@4.8.3 onboard read frontend/plan`.
+`npx --yes copilotkit@4.9.0 onboard read frontend/plan`.
 
-If a page does not load or support the selection, run
-`npx copilotkit@4.8.3 onboard read unsupported/no-validated-path`.
+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`.

package/onboarding/prompts/frontend/angular.md

@@ -7,12 +7,27 @@ Preserve an existing Angular frontend. Use the selected page for a new frontend.
 - Credentials and plan: `Not applicable`
 - Implementation and validation: https://docs.copilotkit.ai/angular.md
 - Proof: https://docs.copilotkit.ai/angular.md
+- Frontend context: https://docs.copilotkit.ai/reference/angular/directives/CopilotKitAgentContext.md
 
-Fetch the selected documentation page. Record Angular as the selected frontend and keep
-this URL. Do not use remembered CopilotKit instructions.
+Fetch both selected documentation pages in one step rather than one after another.
+Record Angular as the selected frontend and keep these URLs. Do not use remembered
+CopilotKit instructions.
+
+Take the frontend-context step from the directive page. The agent-framework page shows
+the React hook, and Angular shares the same context through this directive instead.
+
+Angular CLI 22 requires Node `^22.22.3 || ^24.15.0 || >=26`. Check the Node version before
+you create or build an Angular project. If the installed version is lower, select a
+supported version first and use it for every later command in this project.
+
+A fetch tool that refuses a URL, or fails to reach it, reports a limit of the tool and
+not a fact about the page. Retrieve the same URL a second way before you judge it. Run
+`curl -fsSL <url>`, or read the same page without the `.md` suffix. Treat a page as
+unavailable only after a second method also fails.
 
 If the page supports the selection, run
-`npx copilotkit@4.8.3 onboard read credentials/finalize-plan`.
+`npx --yes copilotkit@4.9.0 onboard read credentials/finalize-plan`.
 
-If the page does not load or support the selection, run
-`npx copilotkit@4.8.3 onboard read unsupported/no-validated-path`.
+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`.

package/onboarding/prompts/frontend/nextjs.md

@@ -11,8 +11,18 @@ Preserve an existing Next.js frontend. Use the selected pages for a new frontend
 Fetch each selected documentation URL. Record Next.js as the selected frontend and keep
 these URLs. Do not use remembered CopilotKit instructions.
 
+Take the frontend scaffolding from this page. Take the runtime agent wiring from the
+agent framework documentation instead. This page configures the CopilotKit built-in
+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.
+
+A fetch tool that refuses a URL, or fails to reach it, reports a limit of the tool and
+not a fact about the page. Retrieve the same URL a second way before you judge it. Run
+`curl -fsSL <url>`, or read the same page without the `.md` suffix. Treat a page as
+unavailable only after a second method also fails.
+
 If the pages support the selection, run
-`npx copilotkit@4.8.3 onboard read credentials/finalize-plan`.
+`npx --yes copilotkit@4.9.0 onboard read credentials/finalize-plan`.
 
-If a page does not load or support the selection, run
-`npx copilotkit@4.8.3 onboard read unsupported/no-validated-path`.
+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`.

package/onboarding/prompts/frontend/plan.md

@@ -3,30 +3,31 @@
 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.
 
-If the project has a frontend, preserve it. Use the matching route below. If the project
-needs a frontend, show the valid choices for its starting state.
+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.
 
-| Starting state  | Frontend choices                                                  |
-| --------------- | ----------------------------------------------------------------- |
-| `empty`         | React SPA, Next.js, Angular, Vue 3, React Native, Slack, or Teams |
-| `agent-only`    | React SPA, Next.js, Angular, Vue 3, React Native, Slack, or Teams |
-| `frontend-only` | React SPA, Next.js, Angular, Vue 3, or React Native               |
-| `both`          | React SPA, Next.js, Angular, Vue 3, or React Native               |
+The valid choices are React SPA, Next.js, Angular, Vue 3, and React Native. They are valid
+in every starting state. Do not show the internal route.
 
-Slack and Teams are valid only for `empty` and `agent-only`.
+Recommend the frontend the project already uses. Where there is no existing frontend,
+recommend the one the developer names, and say what each choice implies for where the
+CopilotKit runtime lives: Next.js hosts it in a route handler, Angular in its SSR
+server, and Vue 3, React SPA and React Native reach a runtime that runs as its own
+process.
 
-Show the public options and one recommendation based on repository evidence. If the
-project has no frontend, ask the developer to choose. Do not show the internal route.
+A fetch tool that refuses a URL, or fails to reach it, reports a limit of the tool and
+not a fact about the page. Retrieve the same URL a second way before you judge it. Run
+`curl -fsSL <url>`, or read the same page without the `.md` suffix. Treat a page as
+unavailable only after a second method also fails.
 
 Use exactly one matching internal route:
 
-1. React SPA: `npx copilotkit@4.8.3 onboard read frontend/react-spa`
-2. Next.js: `npx copilotkit@4.8.3 onboard read frontend/nextjs`
-3. Angular: `npx copilotkit@4.8.3 onboard read frontend/angular`
-4. Vue 3: `npx copilotkit@4.8.3 onboard read frontend/vue`
-5. React Native: `npx copilotkit@4.8.3 onboard read frontend/react-native`
-6. Slack: `npx copilotkit@4.8.3 onboard read frontend/slack`
-7. Microsoft Teams: `npx copilotkit@4.8.3 onboard read frontend/teams`
+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`
 
 If no listed frontend fits, run
-`npx copilotkit@4.8.3 onboard read unsupported/no-validated-path`.
+`npx --yes copilotkit@4.9.0 onboard read unsupported/no-validated-path`.

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

@@ -11,8 +11,14 @@ Preserve an existing React Native frontend. Use the selected page for a new fron
 Fetch the selected documentation page. Record React Native as the selected frontend and
 keep this URL. Do not use remembered CopilotKit instructions.
 
+A fetch tool that refuses a URL, or fails to reach it, reports a limit of the tool and
+not a fact about the page. Retrieve the same URL a second way before you judge it. Run
+`curl -fsSL <url>`, or read the same page without the `.md` suffix. Treat a page as
+unavailable only after a second method also fails.
+
 If the page supports the selection, run
-`npx copilotkit@4.8.3 onboard read credentials/finalize-plan`.
+`npx --yes copilotkit@4.9.0 onboard read credentials/finalize-plan`.
 
-If the page does not load or support the selection, run
-`npx copilotkit@4.8.3 onboard read unsupported/no-validated-path`.
+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`.

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

@@ -1,12 +1,27 @@
 # Configure React SPA
 
-Preserve an existing React SPA. This release has no documented implementation or proof
-path for React SPA. Do not change the project from remembered CopilotKit instructions.
+Preserve an existing React SPA. Use the selected page for a new frontend.
+
+A React SPA has no server of its own, so the CopilotKit runtime is a separate process
+rather than a route inside the app. Do not add a runtime route to the SPA build, and do
+not move the agent into it.
 
 ## Documentation
 
 - Credentials and plan: `Not applicable`
-- Implementation and validation: `Not documented`
-- Proof: `Not documented`
+- Implementation and validation: https://docs.copilotkit.ai/react-spa.md
+- Proof: https://docs.copilotkit.ai/react-spa.md
+
+Fetch the selected documentation page. Record React SPA as the selected frontend and
+keep this URL. Do not use remembered CopilotKit instructions.
+
+A fetch tool that refuses a URL, or fails to reach it, reports a limit of the tool and
+not a fact about the page. Retrieve the same URL a second way before you judge it. Run
+`curl -fsSL <url>`, or read the same page without the `.md` suffix. Treat a page as
+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`.
 
-Run `npx copilotkit@4.8.3 onboard read unsupported/no-validated-path`.
+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`.

package/onboarding/prompts/frontend/vue.md

@@ -11,8 +11,14 @@ Preserve an existing Vue 3 frontend. Use the selected page for a new frontend.
 Fetch the selected documentation page. Record Vue 3 as the selected frontend and keep
 this URL. Do not use remembered CopilotKit instructions.
 
+A fetch tool that refuses a URL, or fails to reach it, reports a limit of the tool and
+not a fact about the page. Retrieve the same URL a second way before you judge it. Run
+`curl -fsSL <url>`, or read the same page without the `.md` suffix. Treat a page as
+unavailable only after a second method also fails.
+
 If the page supports the selection, run
-`npx copilotkit@4.8.3 onboard read credentials/finalize-plan`.
+`npx --yes copilotkit@4.9.0 onboard read credentials/finalize-plan`.
 
-If the page does not load or support the selection, run
-`npx copilotkit@4.8.3 onboard read unsupported/no-validated-path`.
+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`.