copilotkit 4.8.3 → 4.9.0

package/onboarding/prompts/framework/agno.md

@@ -1,8 +1,10 @@
 # Configure Agno
 
 Preserve an existing Agno 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.
+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/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.
 
-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/built-in.md

@@ -1,21 +1,43 @@
-# Configure CopilotKit built-in agent
+# Configure the built-in CopilotKit agent
 
-Preserve an existing built-in agent and its model setup. For a new agent, follow the setup page. Ask the developer to choose the documented model vendor and model. Record the required credential variable names.
+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/generative-ui/a2ui/fixed-schema.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.
 
-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/claude-sdk-python.md

@@ -1,6 +1,11 @@
-# Configure Claude Agent SDK Python
+# Configure Claude Agent SDK for Python
 
-Preserve an existing Claude Agent SDK Python setup. This onboarding path supports Anthropic only. Ask the developer to choose the Anthropic model. Record the required credential variable names.
+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.
@@ -10,12 +15,35 @@ store, or request a secret value.
 - 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.
 
-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/claude-sdk-typescript.md

@@ -1,6 +1,11 @@
-# Configure Claude Agent SDK TypeScript
+# Configure Claude Agent SDK for TypeScript
 
-Preserve an existing Claude Agent SDK TypeScript setup. This onboarding path supports Anthropic only. Ask the developer to choose the Anthropic model. Record the required credential variable names.
+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.
@@ -10,12 +15,39 @@ store, or request a secret value.
 - 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.
 
-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/crewai-flows.md

@@ -1,7 +1,9 @@
 # Configure CrewAI Flows
 
-If the repository uses a CrewAI Enterprise agent, preserve CrewAI Flows. Do not recommend
-it for a new agent. Preserve its remote model setup. Record its credential variable names.
+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.
@@ -11,12 +13,44 @@ store, or request a secret value.
 - 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 three pages. Record the selected framework, vendor, model, required credential
-variable names, and these URLs. Do not use remembered CopilotKit instructions.
+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 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/deep-agents.md

@@ -1,6 +1,10 @@
 # Configure Deep Agents
 
-Preserve an existing Deep Agents setup. Ask the developer to confirm its model vendor and model. Use the documented default for a new setup. Record the required credential variable names.
+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.
@@ -10,12 +14,32 @@ store, or request a secret value.
 - 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.
 
-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/google-adk.md

@@ -1,7 +1,12 @@
-# Configure Google ADK
+# Configure ADK
 
-Preserve an existing Google ADK model setup. Start with Google Gemini for a new agent.
-Offer another model only after the selected CopilotKit Markdown pages document its setup.
+Preserve an existing ADK model setup. Start with Google 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 `GOOGLE_API_KEY`. This framework accepts more than one
+spelling, and a scaffold that reaches for a different one looks finished and reads no
+key.
 
 Keep `INTELLIGENCE_API_KEY` separate from model-vendor credentials. Do not read, show,
 store, or request a secret value.
@@ -11,12 +16,31 @@ store, or request a secret value.
 - https://docs.copilotkit.ai/google-adk/quickstart.md
 - https://docs.copilotkit.ai/google-adk/inspector.md
 - https://docs.copilotkit.ai/google-adk/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. Sequential fetching
+cost about nine minutes of the first proven journey.
+
+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.
+
+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/langgraph-fastapi.md

@@ -12,12 +12,31 @@ store, or request a secret value.
 - 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 three pages. Record the selected framework, vendor, model, required credential
-variable names, and these URLs. Do not use remembered CopilotKit instructions.
+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 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/langgraph-python.md

@@ -12,12 +12,22 @@ store, or request a secret value.
 - https://docs.copilotkit.ai/langgraph-python/quickstart.md
 - https://docs.copilotkit.ai/langgraph-python/inspector.md
 - https://docs.copilotkit.ai/langgraph-python/generative-ui/a2ui/fixed-schema.md
+- https://docs.copilotkit.ai/langgraph-python/agent-app-context.md
 
-Fetch all three pages. Record the selected framework, vendor, model, required credential
-variable names, and these URLs. Do not use remembered CopilotKit instructions.
+Fetch all four pages in one step rather than one after another. Sequential fetching
+cost about nine minutes of the first proven journey.
+
+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/langgraph-typescript.md

@@ -12,12 +12,22 @@ store, or request a secret value.
 - https://docs.copilotkit.ai/langgraph-typescript/quickstart.md
 - https://docs.copilotkit.ai/langgraph-typescript/inspector.md
 - https://docs.copilotkit.ai/langgraph-typescript/generative-ui/a2ui/fixed-schema.md
+- https://docs.copilotkit.ai/langgraph-typescript/agent-app-context.md
 
-Fetch all three pages. Record the selected framework, vendor, model, required credential
-variable names, and these URLs. Do not use remembered CopilotKit instructions.
+Fetch all four pages in one step rather than one after another. Sequential fetching
+cost about nine minutes of the first proven journey.
+
+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/llamaindex.md

@@ -1,8 +1,10 @@
 # Configure LlamaIndex
 
 Preserve an existing LlamaIndex 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.
+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,38 @@ store, or request a secret value.
 - 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.
 
-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/mastra.md

@@ -1,21 +1,63 @@
 # Configure Mastra
 
-Preserve an existing Mastra model setup. Start with OpenAI for a new agent. Before offering another vendor, an exact CopilotKit Markdown page must name the vendor, credential variables, and setup steps.
+Preserve an existing Mastra model setup. Start with OpenAI for a new agent. Offer
+another vendor only after an exact CopilotKit Markdown page names it. The page must name
+its credential variables and setup steps.
+
+Name the model credential `OPENAI_API_KEY`.
 
 Keep `INTELLIGENCE_API_KEY` separate from model-vendor credentials. Do not read, show,
 store, or request a secret value.
 
+`mastra dev` loads the `.env` beside the project it serves and does not look in a
+parent directory. When one credential file serves more than one part of the repository,
+name the path in the dev script as `mastra dev --env <path>` rather than relying on a
+search.
+
+The dev server serves port 4111 and puts a web console at `/` on that same port. A
+request to `/` answers 200 with HTML whether or not an agent exists, so read
+`/api/agents` to confirm which agent is served.
+
+That console runs any agent the Mastra instance registers, with that agent's full
+tool set, and the API behind it takes
+`POST /api/agents/{agentId}/tools/{toolId}/execute`, which invokes one tool with no
+model and no credential. Neither surface asks for authentication. Tool gating done
+at the CopilotKit runtime governs the runtime's route and does not reach this port.
+Where the project restricts which tools reach a browser, say in the summary that
+the agent port is a second, ungated entrance to the same tools.
+
+The dev server binds every interface unless it is told not to, while the banner it
+prints, the `.mastra/dev.lock` it writes and the framework's own documentation all
+say `localhost`. Bind it to loopback: `MASTRA_HOST=127.0.0.1` on the dev command
+when the agent is the developer's existing code, or `server: { host: '127.0.0.1' }`
+on a Mastra instance this run creates. Declare a `server.port` beside it only if
+the run does not also rely on `PORT`, which it overrides.
+
+If the project already runs the agent as its own service, reach it where it runs. The
+quickstart shows the agent inside the frontend, and moving a running agent there deletes
+what the developer had.
+
 ## Documentation
 
 - https://docs.copilotkit.ai/mastra/quickstart.md
 - https://docs.copilotkit.ai/mastra/inspector.md
 - https://docs.copilotkit.ai/mastra/generative-ui/a2ui/fixed-schema.md
+- https://docs.copilotkit.ai/mastra/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.
+
+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`.