copilotkit 4.8.4 → 4.9.1

package/onboarding/prompts/framework/agno.md

@@ -0,0 +1,48 @@
+# Configure Agno
+
+Preserve an existing Agno model setup. Start with OpenAI for a new agent. Offer another
+vendor only after an exact CopilotKit Markdown page names it. The page must name its
+credential variables and setup steps.
+
+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.
+
+## Documentation
+
+- https://docs.copilotkit.ai/agno/quickstart.md
+- https://docs.copilotkit.ai/agno/inspector.md
+- https://docs.copilotkit.ai/agno/generative-ui/a2ui/fixed-schema.md
+- https://docs.copilotkit.ai/agno/shared-state/agent-readonly.md
+
+Fetch all four pages in one step rather than one after another.
+
+The documentation scope is `agno`. Use only the Python agent examples from these pages.
+When the repository already has an Agno agent, use the quickstart's
+`Use an existing agent` path. Use `Start from scratch` only when the repository needs a
+new agent. For a new agent, install the documented Python dependencies
+`agno fastapi uvicorn openai ag-ui-protocol`. Preserve an existing `AgentOS` with the
+`AGUI` interface and its endpoint. In the documented runtime, `AgnoAgent` from
+`@ag-ui/agno` targets `/agui`. Do not replace that adapter with a generic agent or change
+the endpoint without repository evidence.
+
+The fixed-schema page has no Agno backend schema-loading, render-operations, or runtime
+setup snippet. The agent-readonly page does not bundle its Agno backend context setup.
+Do not invent either missing backend setup. If the requested work needs one of those
+setups and the project does not already have it, run the unsupported route below.
+
+Record the selected framework, vendor, model, required credential variable names, these
+URLs, the documented dependencies and adapter, and both documentation gaps. 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 --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.1 onboard read unsupported/no-validated-path`.

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

@@ -0,0 +1,43 @@
+# Configure the built-in CopilotKit agent
+
+Preserve an existing built-in agent model setup. Start with OpenAI for a new agent. Offer
+another vendor only after an exact CopilotKit Markdown page names it. The page must name
+its credential variables and setup steps.
+
+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.
+
+The built-in agent runs in the CopilotKit Runtime process.
+Do not create or start a separate agent server.
+Keep the agent, model choice, tools, and runtime endpoint in the project's existing
+runtime setup.
+
+## Documentation
+
+- https://docs.copilotkit.ai/built-in-agent.md
+- https://docs.copilotkit.ai/quickstart.md
+- https://docs.copilotkit.ai/inspector.md
+- https://docs.copilotkit.ai/agent-app-context.md
+- https://docs.copilotkit.ai/model-selection.md
+- https://docs.copilotkit.ai/generative-ui/tool-based.md
+
+Fetch all six pages in one step rather than one after another.
+
+These pages use the root documentation scope. Do not add a framework path segment to
+their URLs. Use the tool-based generative UI page for this built-in route.
+
+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 --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.1 onboard read unsupported/no-validated-path`.

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

@@ -0,0 +1,49 @@
+# Configure Claude Agent SDK for Python
+
+Preserve an existing Claude Agent SDK model setup. Start with Anthropic 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 `ANTHROPIC_API_KEY`. The documented model variable is
+`ANTHROPIC_MODEL`.
+
+Keep `INTELLIGENCE_API_KEY` separate from model-vendor credentials. Do not read, show,
+store, or request a secret value.
+
+## Documentation
+
+- https://docs.copilotkit.ai/claude-sdk-python/quickstart.md
+- https://docs.copilotkit.ai/claude-sdk-python/inspector.md
+- https://docs.copilotkit.ai/claude-sdk-python/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 `claude-sdk-python`. For an existing agent, install the exact
+documented backend set with
+`uv add claude-agent-sdk ag-ui-claude-sdk ag-ui-protocol anthropic fastapi uvicorn python-dotenv`.
+Expose the agent through FastAPI and use `ClaudeAgentAdapter` from `ag_ui_claude_sdk`.
+Keep one long-lived adapter at module scope. Register the remote endpoint in Copilot Runtime
+with `HttpAgent`. Do not replace this transport with a different Claude or AG-UI 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 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.
+
+Record the selected framework, vendor, model, required credential variable names, these
+URLs, and the context and A2UI limits. 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 --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.1 onboard read unsupported/no-validated-path`.

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

@@ -0,0 +1,53 @@
+# Configure Claude Agent SDK for TypeScript
+
+Preserve an existing Claude Agent SDK model setup. Start with Anthropic 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 `ANTHROPIC_API_KEY`. The documented model variable is
+`CLAUDE_MODEL`.
+
+Keep `INTELLIGENCE_API_KEY` separate from model-vendor credentials. Do not read, show,
+store, or request a secret value.
+
+## Documentation
+
+- https://docs.copilotkit.ai/claude-sdk-typescript/quickstart.md
+- https://docs.copilotkit.ai/claude-sdk-typescript/inspector.md
+- https://docs.copilotkit.ai/claude-sdk-typescript/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 `claude-sdk-typescript`. For an existing agent, install the
+documented packages, including `@anthropic-ai/claude-agent-sdk@^0.2.58`,
+`@anthropic-ai/sdk`, `@ag-ui/claude-agent-sdk`, `@ag-ui/core`, `@ag-ui/encoder`,
+`express`, `dotenv`, and `zod`. Keep the Express AG-UI endpoint. Use
+`ClaudeAgentAdapter` from `@ag-ui/claude-agent-sdk` in that endpoint and `HttpAgent` in
+Copilot Runtime. Do not replace either adapter.
+
+For fixed-schema A2UI, expose the backend tool through the in-process Claude SDK MCP
+server. Set `injectA2UITool` to `false` so the agent-owned tool is the only A2UI tool.
+The Claude Agent SDK adapter does not bridge CopilotKit frontend or runtime tools through
+AG-UI. If the requested path needs those tools, run the unsupported route below. Do not
+replace the Claude Agent SDK with the direct Anthropic Messages API fallback.
+
+The adapter appends AG-UI `input.context` entries to the Claude system prompt. Pair that
+backend path with the frontend hook from the reference page. Treat this as read-only app
+context. It does not provide an agent-to-frontend write-back path. Inspect the installed,
+pinned adapter source before using this path. If the package no longer handles
+`input.context`, run the unsupported route below.
+
+Record the selected framework, vendor, model, required credential variable names, these
+URLs, and the adapter and context limits. 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 --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.1 onboard read unsupported/no-validated-path`.

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

@@ -0,0 +1,56 @@
+# Configure CrewAI Flows
+
+Preserve the project's existing CrewAI Flow, model, and deployment. The selected pages do
+not name a default model vendor or model credential variable. Do not choose a vendor or
+credential name for the developer. Ask only for a choice that the repository does not
+show and the documentation supports.
+
+Keep `INTELLIGENCE_API_KEY` separate from model-vendor credentials. Do not read, show,
+store, or request a secret value.
+
+## Documentation
+
+- https://docs.copilotkit.ai/crewai-crews/quickstart.md
+- https://docs.copilotkit.ai/crewai-crews/inspector.md
+- https://docs.copilotkit.ai/crewai-crews/generative-ui/a2ui/fixed-schema.md
+- https://docs.copilotkit.ai/crewai-crews/shared-state/in-app-agent-read.md
+
+Fetch all four pages in one step rather than one after another.
+
+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/`
+links. Use the canonical Markdown URLs above and keep the project's CrewAI Flow name.
+
+The quickstart offers `Use the CopilotKit CLI (NextJS only)` and `Code along`. It assumes
+an existing Flow. Preserve the vendor, model, and credential variable that the project
+already uses. The new quickstart example uses GitHub Models. An existing OpenAI Flow can
+keep OpenAI and `OPENAI_API_KEY`. Do not change vendors to match the example.
+
+The current Python base adapter is `ag-ui-crewai==0.3.0`. Add the endpoint to the
+project's FastAPI app with
+`add_crewai_flow_fastapi_endpoint(app, ExistingFlow(), "/chat")`. Keep the existing Flow
+and its regular, non-conversational mode. Use the generic `HttpAgent` for the `/chat`
+endpoint. Do not invent a `CrewAIAgent` runtime class.
+
+The fixed-schema page extends this base adapter. Keep the fixed-schema tool on the CrewAI
+Flow path, call `copilotkit_emit_tool_result`, and set `injectA2UITool: false` in the
+runtime catalog. Do not replace the existing Flow with a Crew, Agent, or Task graph.
+
+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.
+
+Record the selected framework, project-defined vendor and model, repository-proven
+credential variable names, these URLs, the adapter, and both documentation limits. 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 --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.1 onboard read unsupported/no-validated-path`.

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

@@ -0,0 +1,45 @@
+# Configure Deep Agents
+
+Preserve an existing Deep Agents language and model setup. Start with OpenAI for a new
+agent. Offer another vendor only after an exact CopilotKit Markdown page names it. The
+page must name its credential variables and setup steps.
+
+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.
+
+## Documentation
+
+- https://docs.copilotkit.ai/deepagents/quickstart.md
+- https://docs.copilotkit.ai/deepagents/inspector.md
+- https://docs.copilotkit.ai/deepagents/generative-ui/a2ui/fixed-schema.md
+- https://docs.copilotkit.ai/deepagents/shared-state/agent-readonly.md
+
+Fetch all four pages in one step rather than one after another.
+
+The documentation scope is `deepagents`. Do not use `deep-agents` in a documentation URL.
+The quickstart has Python and TypeScript tabs. Preserve the project's current language.
+Preserve the project's existing deployment path. Choose the same `Deep Agent` or
+`FastAPI` tab in both the quickstart and runtime setup. Do not change a Deep Agent
+deployment to FastAPI or a FastAPI deployment to Deep Agent.
+
+The fixed-schema A2UI backend example is Python-only. No Deep Agents agent-app-context
+Markdown page is available. Do not invent a TypeScript A2UI backend or an
+agent-app-context setup. If the requested work needs either missing setup, run the
+unsupported route below.
+
+Record the selected framework, language, vendor, model, required credential variable
+names, these URLs, and each documentation gap. 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 --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.1 onboard read unsupported/no-validated-path`.

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

@@ -34,8 +34,13 @@ Record the selected framework, vendor, model, required credential variable names
 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.4 onboard read frontend/plan`.
+`npx --yes copilotkit@4.9.1 onboard read frontend/plan`.
 
-If a page does not load or support the selection, run
-`npx copilotkit@4.8.4 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.1 onboard read unsupported/no-validated-path`.

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

@@ -0,0 +1,42 @@
+# Configure LangGraph FastAPI
+
+Preserve an existing LangGraph FastAPI model setup. Start with OpenAI for a new agent.
+Offer another vendor only after an exact CopilotKit Markdown page names it. The page must
+name its credential variables and setup steps.
+
+Keep `INTELLIGENCE_API_KEY` separate from model-vendor credentials. Do not read, show,
+store, or request a secret value.
+
+## Documentation
+
+- https://docs.copilotkit.ai/langgraph-fastapi/quickstart.md
+- https://docs.copilotkit.ai/langgraph-fastapi/inspector.md
+- https://docs.copilotkit.ai/langgraph-fastapi/generative-ui/a2ui/fixed-schema.md
+- https://docs.copilotkit.ai/langgraph-fastapi/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.
+
+Read the FastAPI tab of the quickstart.
+Preserve an existing FastAPI transport and its persistence.
+The FastAPI graph must have a checkpointer.
+Keep the existing checkpointer. For a new local agent, use `MemorySaver` only for
+development.
+Use `add_langgraph_fastapi_endpoint` for the FastAPI agent endpoint.
+Use `LangGraphHttpAgent` in the Copilot Runtime.
+Do not copy the LangSmith path, its no-checkpointer rule, or its `LangGraphAgent` adapter.
+
+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 --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.1 onboard read unsupported/no-validated-path`.

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

@@ -21,8 +21,13 @@ Record the selected framework, vendor, model, required credential variable names
 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.4 onboard read frontend/plan`.
+`npx --yes copilotkit@4.9.1 onboard read frontend/plan`.
 
-If a page does not load or support the selection, run
-`npx copilotkit@4.8.4 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.1 onboard read unsupported/no-validated-path`.

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

@@ -21,8 +21,13 @@ Record the selected framework, vendor, model, required credential variable names
 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.4 onboard read frontend/plan`.
+`npx --yes copilotkit@4.9.1 onboard read frontend/plan`.
 
-If a page does not load or support the selection, run
-`npx copilotkit@4.8.4 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.1 onboard read unsupported/no-validated-path`.

package/onboarding/prompts/framework/llamaindex.md

@@ -0,0 +1,51 @@
+# Configure LlamaIndex
+
+Preserve an existing LlamaIndex model setup. Start with OpenAI for a new agent. Offer
+another vendor only after an exact CopilotKit Markdown page names it. The page must name
+its credential variables and setup steps.
+
+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.
+
+## Documentation
+
+- https://docs.copilotkit.ai/llamaindex/quickstart.md
+- https://docs.copilotkit.ai/llamaindex/inspector.md
+- https://docs.copilotkit.ai/llamaindex/generative-ui/a2ui/fixed-schema.md
+- https://docs.copilotkit.ai/llamaindex/shared-state/in-app-agent-read.md
+
+Fetch all four pages in one step rather than one after another.
+
+The documentation scope is `llamaindex`. Use only the Python agent examples from these
+pages. When the repository already has a LlamaIndex agent, use the quickstart's
+`Use an existing agent` path. Use `Start from scratch` only when the repository needs a
+new agent. For a new agent, install the documented Python dependencies
+`llama-index llama-index-llms-openai llama-index-protocols-ag-ui fastapi uvicorn`.
+Preserve the existing `get_ag_ui_workflow_router` and its FastAPI router. In the
+documented runtime, `LlamaIndexAgent` from `@ag-ui/llamaindex` targets `/run`. Do not
+replace that adapter or change its route without repository evidence.
+
+The fixed-schema page includes LlamaIndex backend code but does not bundle its runtime
+setup. Use it only when the project already has the working quickstart runtime that the
+page extends. Do not invent a replacement runtime setup.
+
+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.
+
+Record the selected framework, vendor, model, required credential variable names, these
+URLs, the documented dependencies and adapter, and both documentation limits. 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 --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.1 onboard read unsupported/no-validated-path`.

package/onboarding/prompts/framework/mastra.md

@@ -51,8 +51,13 @@ Record the selected framework, vendor, model, required credential variable names
 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.4 onboard read frontend/plan`.
+`npx --yes copilotkit@4.9.1 onboard read frontend/plan`.
 
-If a page does not load or support the selection, run
-`npx copilotkit@4.8.4 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.1 onboard read unsupported/no-validated-path`.

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

@@ -59,8 +59,13 @@ Record the selected framework, vendor, model, required credential variable names
 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.4 onboard read frontend/plan`.
+`npx --yes copilotkit@4.9.1 onboard read frontend/plan`.
 
-If a page does not load or support the selection, run
-`npx copilotkit@4.8.4 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.1 onboard read unsupported/no-validated-path`.

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

@@ -0,0 +1,62 @@
+# Configure MS Agent Harness for .NET
+
+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.
+
+## Documentation
+
+- 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.
+
+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 --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.1 onboard read unsupported/no-validated-path`.

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

@@ -34,8 +34,13 @@ Record the selected framework, vendor, model, required credential variable names
 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.4 onboard read frontend/plan`.
+`npx --yes copilotkit@4.9.1 onboard read frontend/plan`.
 
-If a page does not load or support the selection, run
-`npx copilotkit@4.8.4 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.1 onboard read unsupported/no-validated-path`.

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

@@ -0,0 +1,48 @@
+# Configure Pydantic AI
+
+Preserve an existing Pydantic AI model setup. Start with OpenAI for a new agent. Offer
+another vendor only after an exact CopilotKit Markdown page names it. The page must name
+its credential variables and setup steps.
+
+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.
+
+## Documentation
+
+- 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.
+
+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 --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.1 onboard read unsupported/no-validated-path`.