copilotkit 4.9.2 → 4.9.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/cli-build-info.json +8 -8
- package/index.js +134 -20
- package/onboarding/index.json +1 -0
- package/onboarding/prompts/authenticate/start.md +78 -33
- package/onboarding/prompts/credentials/finalize-plan.md +21 -26
- package/onboarding/prompts/credentials/plan.md +37 -25
- package/onboarding/prompts/fallback/best-effort.md +22 -11
- package/onboarding/prompts/framework/ag2.md +4 -15
- package/onboarding/prompts/framework/agno.md +4 -15
- package/onboarding/prompts/framework/built-in.md +4 -14
- package/onboarding/prompts/framework/claude-sdk-python.md +4 -14
- package/onboarding/prompts/framework/claude-sdk-typescript.md +4 -14
- package/onboarding/prompts/framework/crewai-flows.md +11 -23
- package/onboarding/prompts/framework/deep-agents.md +4 -15
- package/onboarding/prompts/framework/google-adk.md +3 -15
- package/onboarding/prompts/framework/langgraph-fastapi.md +3 -15
- package/onboarding/prompts/framework/langgraph-python.md +3 -15
- package/onboarding/prompts/framework/langgraph-typescript.md +3 -15
- package/onboarding/prompts/framework/llamaindex.md +4 -15
- package/onboarding/prompts/framework/mastra.md +3 -15
- package/onboarding/prompts/framework/ms-agent-dotnet.md +18 -49
- package/onboarding/prompts/framework/ms-agent-harness-dotnet.md +20 -30
- package/onboarding/prompts/framework/ms-agent-python.md +3 -15
- package/onboarding/prompts/framework/pydantic-ai.md +4 -14
- package/onboarding/prompts/framework/strands-python.md +4 -14
- package/onboarding/prompts/framework/strands-typescript.md +4 -14
- package/onboarding/prompts/frontend/angular.md +9 -19
- package/onboarding/prompts/frontend/nextjs.md +6 -16
- package/onboarding/prompts/frontend/plan.md +9 -14
- package/onboarding/prompts/frontend/react-native.md +7 -15
- package/onboarding/prompts/frontend/react-spa.md +5 -15
- package/onboarding/prompts/frontend/vue.md +8 -15
- package/onboarding/prompts/implementation/build-and-validate.md +5 -11
- package/onboarding/prompts/proof/complete.md +22 -5
- package/onboarding/prompts/proof/oss-baseline.md +3 -3
- package/onboarding/prompts/proof/round-trip.md +28 -23
- package/onboarding/prompts/starter/clone.md +4 -4
- package/onboarding/prompts/subagent/create-plan.md +4 -11
- package/onboarding/prompts/subagent/implement-and-validate.md +2 -8
- package/onboarding/prompts/subagent/inspect-repository.md +14 -7
- package/onboarding/prompts/subagent/prove-oss-baseline.md +1 -1
- package/onboarding/prompts/subagent/prove-round-trip.md +12 -18
- package/onboarding/prompts/unsupported/no-validated-path.md +2 -2
- package/package.json +1 -1
- package/release/release-tool.js +1 -1
|
@@ -6,9 +6,6 @@ its credential variables and setup steps.
|
|
|
6
6
|
|
|
7
7
|
Name the model credential `OPENAI_API_KEY`.
|
|
8
8
|
|
|
9
|
-
Keep `INTELLIGENCE_API_KEY` separate from model-vendor credentials. Do not read, show,
|
|
10
|
-
store, or request a secret value.
|
|
11
|
-
|
|
12
9
|
`mastra dev` loads the `.env` beside the project it serves and does not look in a
|
|
13
10
|
parent directory. When one credential file serves more than one part of the repository,
|
|
14
11
|
name the path in the dev script as `mastra dev --env <path>` rather than relying on a
|
|
@@ -44,20 +41,11 @@ what the developer had.
|
|
|
44
41
|
- https://docs.copilotkit.ai/mastra/generative-ui/a2ui/fixed-schema.md
|
|
45
42
|
- https://docs.copilotkit.ai/mastra/agent-app-context.md
|
|
46
43
|
|
|
47
|
-
Fetch all four pages in one step rather than one after another. Sequential fetching
|
|
48
|
-
cost about nine minutes of the first proven journey.
|
|
49
|
-
|
|
50
44
|
Record the selected framework, vendor, model, required credential variable names, and
|
|
51
45
|
these URLs.
|
|
52
|
-
Do not use remembered CopilotKit instructions.
|
|
53
|
-
|
|
54
|
-
A fetch tool that refuses a URL, or fails to reach it, reports a limit of the tool and
|
|
55
|
-
not a fact about the page. Retrieve the same URL a second way before you judge it. Run
|
|
56
|
-
`curl -fsSL <url>`, or read the same page without the `.md` suffix. Treat a page as
|
|
57
|
-
unavailable only after a second method also fails.
|
|
58
46
|
|
|
59
47
|
If the pages support the selection, run
|
|
60
|
-
`npx --yes copilotkit@4.9.
|
|
48
|
+
`npx --yes copilotkit@4.9.4 onboard read frontend/plan`.
|
|
61
49
|
|
|
62
|
-
If
|
|
63
|
-
`npx --yes copilotkit@4.9.
|
|
50
|
+
If the documentation does not support the selection, run
|
|
51
|
+
`npx --yes copilotkit@4.9.4 onboard read unsupported/no-validated-path`.
|
|
@@ -1,44 +1,17 @@
|
|
|
1
1
|
# Configure Microsoft Agent Framework for .NET
|
|
2
2
|
|
|
3
|
-
Preserve an existing Microsoft Agent Framework model setup.
|
|
4
|
-
|
|
5
|
-
exact CopilotKit Markdown page names it. The page must name its credential variables and
|
|
6
|
-
setup steps.
|
|
3
|
+
Preserve an existing Microsoft Agent Framework model setup. Use direct OpenAI for a new
|
|
4
|
+
agent. Name its credential `OPENAI_API_KEY`. Do not change an existing provider.
|
|
7
5
|
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
6
|
+
.NET configuration reads appsettings, environment variables, and user secrets. It does not
|
|
7
|
+
read a `.env` file. If the project uses `.env`, application code must load it before the
|
|
8
|
+
OpenAI client starts. Do not create a `.env` file without that loader.
|
|
11
9
|
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
environment before the chat client constructs: walk up from the working directory for a
|
|
16
|
-
`.env` and set each name that is not already set. Otherwise pick a mechanism .NET reads
|
|
17
|
-
on its own, an exported variable or a user secret. A scaffold that writes `.env`, reads
|
|
18
|
-
`builder.Configuration["OPENAI_API_KEY"]`, and loads nothing falls silently to the
|
|
19
|
-
`GitHubToken` branch.
|
|
10
|
+
For a user secret, run `dotnet user-secrets set OPENAI_API_KEY` from the agent directory.
|
|
11
|
+
The app must read the same name through .NET configuration. An exported environment
|
|
12
|
+
variable with that name takes precedence over the user secret.
|
|
20
13
|
|
|
21
|
-
|
|
22
|
-
with `dotnet user-secrets set GitHubToken`. The agent reads it through
|
|
23
|
-
`builder.Configuration["GitHubToken"]`, so the name in the store and the name in the
|
|
24
|
-
code have to match exactly. For an OpenAI-compatible vendor, name `OPENAI_API_KEY`
|
|
25
|
-
instead.
|
|
26
|
-
|
|
27
|
-
The GitHub Models catalog is not the OpenAI catalog. A model name that is valid against
|
|
28
|
-
`api.openai.com` can return 404 against `https://models.inference.ai.azure.com`, so a
|
|
29
|
-
run that falls back to the `GitHubToken` branch and keeps the same model name gets a 404
|
|
30
|
-
that looks like an outage rather than a wrong catalog. Name a model the endpoint you
|
|
31
|
-
selected serves.
|
|
32
|
-
|
|
33
|
-
Check whether `OPENAI_API_KEY` is already set in the environment before you configure a
|
|
34
|
-
user secret. It takes precedence, so a run on a machine that already exports one uses
|
|
35
|
-
that key rather than the token you just set, and reports success for the wrong reason.
|
|
36
|
-
|
|
37
|
-
The .NET SDK has to be installed before any of this. Confirm `dotnet --version` answers
|
|
38
|
-
before scaffolding, rather than after.
|
|
39
|
-
|
|
40
|
-
Keep `INTELLIGENCE_API_KEY` separate from model-vendor credentials. Do not read, show,
|
|
41
|
-
store, or request a secret value.
|
|
14
|
+
Run `dotnet --version` before you change the project.
|
|
42
15
|
|
|
43
16
|
## Documentation
|
|
44
17
|
|
|
@@ -46,26 +19,22 @@ store, or request a secret value.
|
|
|
46
19
|
- https://docs.copilotkit.ai/ms-agent-dotnet/inspector.md
|
|
47
20
|
- https://docs.copilotkit.ai/ms-agent-dotnet/generative-ui/a2ui/fixed-schema.md
|
|
48
21
|
- https://docs.copilotkit.ai/ms-agent-dotnet/agent-app-context.md
|
|
49
|
-
|
|
50
|
-
Fetch all four pages in one step rather than one after another. Sequential fetching
|
|
51
|
-
cost about nine minutes of the first proven journey.
|
|
22
|
+
- https://learn.microsoft.com/en-us/agent-framework/integrations/by-component/ui/ag-ui/getting-started
|
|
52
23
|
|
|
53
24
|
The documentation scope is `ms-agent-dotnet`. The quickstart at that scope is
|
|
54
25
|
byte-identical to the one at `ms-agent-python`: one page serves both languages through
|
|
55
26
|
a `.NET` and `Python` tab group. The scope in the URL does not select the language, so
|
|
56
27
|
read the .NET tab.
|
|
57
28
|
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
29
|
+
Use `Microsoft.Agents.AI.Hosting.AGUI.AspNetCore` from the Learn guide. Register the server
|
|
30
|
+
with `AddAGUIServer`. Map the existing `AIAgent` with `MapAGUIServer`. The endpoint accepts
|
|
31
|
+
`RunAgentInput` requests and streams AG-UI events with server-sent events.
|
|
61
32
|
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
`curl -fsSL <url>`, or read the same page without the `.md` suffix. Treat a page as
|
|
65
|
-
unavailable only after a second method also fails.
|
|
33
|
+
Record the selected framework, provider, model, required credential variable names, and
|
|
34
|
+
these URLs.
|
|
66
35
|
|
|
67
36
|
If the pages support the selection, run
|
|
68
|
-
`npx --yes copilotkit@4.9.
|
|
37
|
+
`npx --yes copilotkit@4.9.4 onboard read frontend/plan`.
|
|
69
38
|
|
|
70
|
-
If
|
|
71
|
-
`npx --yes copilotkit@4.9.
|
|
39
|
+
If the documentation does not support the selection, run
|
|
40
|
+
`npx --yes copilotkit@4.9.4 onboard read unsupported/no-validated-path`.
|
|
@@ -1,17 +1,11 @@
|
|
|
1
1
|
# Configure MS Agent Harness for .NET
|
|
2
2
|
|
|
3
|
-
Preserve an existing MS Agent Harness model,
|
|
4
|
-
|
|
3
|
+
Preserve an existing MS Agent Harness model, provider, credential name, and host setup.
|
|
4
|
+
Use direct OpenAI for a new setup. Name its credential `OPENAI_API_KEY`.
|
|
5
5
|
|
|
6
|
-
For
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
For an existing OpenAI setup, keep `OPENAI_API_KEY` and the existing OpenAI client. Do not
|
|
11
|
-
convert it to GitHub Models.
|
|
12
|
-
|
|
13
|
-
Keep `INTELLIGENCE_API_KEY` separate from model-vendor credentials. Do not read, show,
|
|
14
|
-
store, or request a secret value.
|
|
6
|
+
For a user secret, run `dotnet user-secrets set OPENAI_API_KEY` from the agent directory.
|
|
7
|
+
The app must read the same name through .NET configuration. Run `dotnet --version` before
|
|
8
|
+
you change the project.
|
|
15
9
|
|
|
16
10
|
## Documentation
|
|
17
11
|
|
|
@@ -19,21 +13,22 @@ store, or request a secret value.
|
|
|
19
13
|
- https://docs.copilotkit.ai/ms-agent-harness-dotnet/inspector.md
|
|
20
14
|
- https://docs.copilotkit.ai/ms-agent-harness-dotnet/generative-ui/a2ui/fixed-schema.md
|
|
21
15
|
- https://docs.copilotkit.ai/ms-agent-harness-dotnet/agent-app-context.md
|
|
22
|
-
|
|
23
|
-
|
|
16
|
+
- https://learn.microsoft.com/en-us/agent-framework/get-started/harness
|
|
17
|
+
- https://learn.microsoft.com/en-us/agent-framework/integrations/by-component/ui/ag-ui/getting-started
|
|
24
18
|
|
|
25
19
|
The documentation scope is `ms-agent-harness-dotnet`. Read only the `.NET` tab of the
|
|
26
20
|
quickstart. Do not use its Python tab. Use `Microsoft.Agents.AI.Harness --version 1.19.0`
|
|
27
21
|
for the stable agent package. The current AG-UI host package is
|
|
28
22
|
`Microsoft.Agents.AI.Hosting.AGUI.AspNetCore --version 1.19.0-preview.260822.1`.
|
|
29
|
-
Use `AddAGUIServer` service registration and a `MapAGUIServer` endpoint.
|
|
30
|
-
|
|
31
|
-
host. Register the remote endpoint in Copilot Runtime with `HttpAgent`.
|
|
23
|
+
Use `AddAGUIServer` service registration and a `MapAGUIServer` endpoint. Register the
|
|
24
|
+
remote endpoint in Copilot Runtime with `HttpAgent`.
|
|
32
25
|
|
|
33
|
-
The
|
|
34
|
-
|
|
35
|
-
`
|
|
36
|
-
|
|
26
|
+
The Learn Harness guide creates a Harness agent from an `IChatClient` with
|
|
27
|
+
`AsHarnessAgent`. Keep one `AgentSession` across turns. The quickstart's generic .NET
|
|
28
|
+
example uses `CreateAIAgent`. Do not replace an existing Harness agent with that example.
|
|
29
|
+
For a new Harness agent, use `AsHarnessAgent` with `HarnessAgentOptions`. Disable built-in
|
|
30
|
+
providers that add environment-dependent tools. Pass the project-owned tools through
|
|
31
|
+
`ChatOptions`.
|
|
37
32
|
|
|
38
33
|
For fixed-schema A2UI, keep the C# tool and its inline schema in the Harness agent. Set
|
|
39
34
|
`injectA2UITool` to `false` in the runtime. The page omits a bundled setup block, and its
|
|
@@ -47,16 +42,11 @@ and injects a system message. Keep app context unsupported until that wrapper pa
|
|
|
47
42
|
browser proof. Do not copy the page's generic `CreateAIAgent` constructor over an existing
|
|
48
43
|
Harness agent.
|
|
49
44
|
|
|
50
|
-
Record the selected framework,
|
|
51
|
-
URLs, and the quickstart and A2UI gaps.
|
|
52
|
-
|
|
53
|
-
A fetch tool that refuses a URL, or fails to reach it, reports a limit of the tool and
|
|
54
|
-
not a fact about the page. Retrieve the same URL a second way before you judge it. Run
|
|
55
|
-
`curl -fsSL <url>`, or read the same page without the `.md` suffix. Treat a page as
|
|
56
|
-
unavailable only after a second method also fails.
|
|
45
|
+
Record the selected framework, provider, model, required credential variable names, these
|
|
46
|
+
URLs, and the quickstart and A2UI gaps.
|
|
57
47
|
|
|
58
48
|
If the pages support the selection, run
|
|
59
|
-
`npx --yes copilotkit@4.9.
|
|
49
|
+
`npx --yes copilotkit@4.9.4 onboard read frontend/plan`.
|
|
60
50
|
|
|
61
|
-
If
|
|
62
|
-
`npx --yes copilotkit@4.9.
|
|
51
|
+
If the documentation does not support the selection, run
|
|
52
|
+
`npx --yes copilotkit@4.9.4 onboard read unsupported/no-validated-path`.
|
|
@@ -12,9 +12,6 @@ looks finished and reads no key.
|
|
|
12
12
|
This framework reads no `.env` on its own. Whatever loads the file is application code,
|
|
13
13
|
so a scaffold that writes `agent/.env` and never loads it starts with no credential.
|
|
14
14
|
|
|
15
|
-
Keep `INTELLIGENCE_API_KEY` separate from model-vendor credentials. Do not read, show,
|
|
16
|
-
store, or request a secret value.
|
|
17
|
-
|
|
18
15
|
## Documentation
|
|
19
16
|
|
|
20
17
|
- https://docs.copilotkit.ai/ms-agent-python/quickstart.md
|
|
@@ -22,9 +19,6 @@ store, or request a secret value.
|
|
|
22
19
|
- https://docs.copilotkit.ai/ms-agent-python/generative-ui/a2ui/fixed-schema.md
|
|
23
20
|
- https://docs.copilotkit.ai/ms-agent-python/agent-app-context.md
|
|
24
21
|
|
|
25
|
-
Fetch all four pages in one step rather than one after another. Sequential fetching
|
|
26
|
-
cost about nine minutes of the first proven journey.
|
|
27
|
-
|
|
28
22
|
The documentation scope is `ms-agent-python`. The quickstart at that scope is
|
|
29
23
|
byte-identical to the one at `ms-agent-dotnet`: one page serves both languages through
|
|
30
24
|
a `.NET` and `Python` tab group. The scope in the URL does not select the language, so
|
|
@@ -32,15 +26,9 @@ read the Python tab. The first code block on the page is the .NET one.
|
|
|
32
26
|
|
|
33
27
|
Record the selected framework, vendor, model, required credential variable names, and
|
|
34
28
|
these URLs.
|
|
35
|
-
Do not use remembered CopilotKit instructions.
|
|
36
|
-
|
|
37
|
-
A fetch tool that refuses a URL, or fails to reach it, reports a limit of the tool and
|
|
38
|
-
not a fact about the page. Retrieve the same URL a second way before you judge it. Run
|
|
39
|
-
`curl -fsSL <url>`, or read the same page without the `.md` suffix. Treat a page as
|
|
40
|
-
unavailable only after a second method also fails.
|
|
41
29
|
|
|
42
30
|
If the pages support the selection, run
|
|
43
|
-
`npx --yes copilotkit@4.9.
|
|
31
|
+
`npx --yes copilotkit@4.9.4 onboard read frontend/plan`.
|
|
44
32
|
|
|
45
|
-
If
|
|
46
|
-
`npx --yes copilotkit@4.9.
|
|
33
|
+
If the documentation does not support the selection, run
|
|
34
|
+
`npx --yes copilotkit@4.9.4 onboard read unsupported/no-validated-path`.
|
|
@@ -6,9 +6,6 @@ its credential variables and setup steps.
|
|
|
6
6
|
|
|
7
7
|
Name the default model credential `OPENAI_API_KEY`.
|
|
8
8
|
|
|
9
|
-
Keep `INTELLIGENCE_API_KEY` separate from model-vendor credentials. Do not read, show,
|
|
10
|
-
store, or request a secret value.
|
|
11
|
-
|
|
12
9
|
## Documentation
|
|
13
10
|
|
|
14
11
|
- https://docs.copilotkit.ai/pydantic-ai/quickstart.md
|
|
@@ -16,8 +13,6 @@ store, or request a secret value.
|
|
|
16
13
|
- https://docs.copilotkit.ai/pydantic-ai/generative-ui/a2ui/fixed-schema.md
|
|
17
14
|
- https://docs.copilotkit.ai/reference/v2/hooks/useAgentContext.md
|
|
18
15
|
|
|
19
|
-
Fetch all four pages in one step rather than one after another.
|
|
20
|
-
|
|
21
16
|
The documentation scope is `pydantic-ai`. For an existing agent, install the exact
|
|
22
17
|
documented backend set with
|
|
23
18
|
`uv add 'pydantic-ai-slim[ag-ui,openai]>=2,<3' 'starlette>=0.46.2' uvicorn`.
|
|
@@ -34,15 +29,10 @@ documents the frontend hook only. Do not invent the missing agent-side context s
|
|
|
34
29
|
the requested work needs that setup, run the unsupported route below.
|
|
35
30
|
|
|
36
31
|
Record the selected framework, vendor, model, required credential variable names, these
|
|
37
|
-
URLs, and the context and A2UI limits.
|
|
38
|
-
|
|
39
|
-
A fetch tool that refuses a URL, or fails to reach it, reports a limit of the tool and
|
|
40
|
-
not a fact about the page. Retrieve the same URL a second way before you judge it. Run
|
|
41
|
-
`curl -fsSL <url>`, or read the same page without the `.md` suffix. Treat a page as
|
|
42
|
-
unavailable only after a second method also fails.
|
|
32
|
+
URLs, and the context and A2UI limits.
|
|
43
33
|
|
|
44
34
|
If the pages support the selection, run
|
|
45
|
-
`npx --yes copilotkit@4.9.
|
|
35
|
+
`npx --yes copilotkit@4.9.4 onboard read frontend/plan`.
|
|
46
36
|
|
|
47
|
-
If
|
|
48
|
-
`npx --yes copilotkit@4.9.
|
|
37
|
+
If the documentation does not support the selection, run
|
|
38
|
+
`npx --yes copilotkit@4.9.4 onboard read unsupported/no-validated-path`.
|
|
@@ -6,9 +6,6 @@ credential variables and setup steps.
|
|
|
6
6
|
|
|
7
7
|
Name the default model credential `OPENAI_API_KEY`.
|
|
8
8
|
|
|
9
|
-
Keep `INTELLIGENCE_API_KEY` separate from model-vendor credentials. Do not read, show,
|
|
10
|
-
store, or request a secret value.
|
|
11
|
-
|
|
12
9
|
## Documentation
|
|
13
10
|
|
|
14
11
|
- https://docs.copilotkit.ai/strands/quickstart.md
|
|
@@ -16,8 +13,6 @@ store, or request a secret value.
|
|
|
16
13
|
- https://docs.copilotkit.ai/strands/generative-ui/a2ui/fixed-schema.md
|
|
17
14
|
- https://docs.copilotkit.ai/strands/shared-state/agent-readonly.md
|
|
18
15
|
|
|
19
|
-
Fetch all four pages in one step rather than one after another.
|
|
20
|
-
|
|
21
16
|
The documentation scope is `strands`. Use the Python examples from these pages.
|
|
22
17
|
The fixed-schema A2UI tool makes its own OpenAI call. Set `injectA2UITool` to `false` when
|
|
23
18
|
the fixed-schema A2UI tool makes its own OpenAI call. This prevents a second injected A2UI
|
|
@@ -28,15 +23,10 @@ agent-app-context setup. If the requested work needs that missing setup, run the
|
|
|
28
23
|
unsupported route below.
|
|
29
24
|
|
|
30
25
|
Record the selected framework, vendor, model, required credential variable names, these
|
|
31
|
-
URLs, and the context documentation gap.
|
|
32
|
-
|
|
33
|
-
A fetch tool that refuses a URL, or fails to reach it, reports a limit of the tool and
|
|
34
|
-
not a fact about the page. Retrieve the same URL a second way before you judge it. Run
|
|
35
|
-
`curl -fsSL <url>`, or read the same page without the `.md` suffix. Treat a page as
|
|
36
|
-
unavailable only after a second method also fails.
|
|
26
|
+
URLs, and the context documentation gap.
|
|
37
27
|
|
|
38
28
|
If the pages support the selection, run
|
|
39
|
-
`npx --yes copilotkit@4.9.
|
|
29
|
+
`npx --yes copilotkit@4.9.4 onboard read frontend/plan`.
|
|
40
30
|
|
|
41
|
-
If
|
|
42
|
-
`npx --yes copilotkit@4.9.
|
|
31
|
+
If the documentation does not support the selection, run
|
|
32
|
+
`npx --yes copilotkit@4.9.4 onboard read unsupported/no-validated-path`.
|
|
@@ -6,9 +6,6 @@ credential variables and setup steps.
|
|
|
6
6
|
|
|
7
7
|
Name the default model credential `OPENAI_API_KEY`.
|
|
8
8
|
|
|
9
|
-
Keep `INTELLIGENCE_API_KEY` separate from model-vendor credentials. Do not read, show,
|
|
10
|
-
store, or request a secret value.
|
|
11
|
-
|
|
12
9
|
## Documentation
|
|
13
10
|
|
|
14
11
|
- https://docs.copilotkit.ai/strands-typescript/quickstart.md
|
|
@@ -16,8 +13,6 @@ store, or request a secret value.
|
|
|
16
13
|
- https://docs.copilotkit.ai/strands-typescript/generative-ui/a2ui/fixed-schema.md
|
|
17
14
|
- https://docs.copilotkit.ai/strands-typescript/shared-state/agent-readonly.md
|
|
18
15
|
|
|
19
|
-
Fetch all four pages in one step rather than one after another.
|
|
20
|
-
|
|
21
16
|
The documentation scope is `strands-typescript`. Use only the TypeScript examples from
|
|
22
17
|
these pages. Install `@modelcontextprotocol/sdk` as a runtime dependency.
|
|
23
18
|
`@strands-agents/sdk` loads it even when the application does not use MCP.
|
|
@@ -28,15 +23,10 @@ example or invent either missing setup. If the requested work needs either missi
|
|
|
28
23
|
run the unsupported route below.
|
|
29
24
|
|
|
30
25
|
Record the selected framework, vendor, model, required credential variable names, these
|
|
31
|
-
URLs, and both documentation gaps.
|
|
32
|
-
|
|
33
|
-
A fetch tool that refuses a URL, or fails to reach it, reports a limit of the tool and
|
|
34
|
-
not a fact about the page. Retrieve the same URL a second way before you judge it. Run
|
|
35
|
-
`curl -fsSL <url>`, or read the same page without the `.md` suffix. Treat a page as
|
|
36
|
-
unavailable only after a second method also fails.
|
|
26
|
+
URLs, and both documentation gaps.
|
|
37
27
|
|
|
38
28
|
If the pages support the selection, run
|
|
39
|
-
`npx --yes copilotkit@4.9.
|
|
29
|
+
`npx --yes copilotkit@4.9.4 onboard read frontend/plan`.
|
|
40
30
|
|
|
41
|
-
If
|
|
42
|
-
`npx --yes copilotkit@4.9.
|
|
31
|
+
If the documentation does not support the selection, run
|
|
32
|
+
`npx --yes copilotkit@4.9.4 onboard read unsupported/no-validated-path`.
|
|
@@ -5,34 +5,24 @@ Preserve an existing Angular frontend. Use the selected page for a new frontend.
|
|
|
5
5
|
Use the starter shortcut only if all these facts are true: the target directory contains
|
|
6
6
|
no entries, its name is a valid `init` project name, and the selected framework is ADK.
|
|
7
7
|
If all three facts are true, record Angular as the selected frontend. Then run
|
|
8
|
-
`npx --yes copilotkit@4.9.
|
|
8
|
+
`npx --yes copilotkit@4.9.4 onboard read starter/clone` before you fetch documentation.
|
|
9
9
|
|
|
10
10
|
## Documentation
|
|
11
11
|
|
|
12
|
-
-
|
|
13
|
-
-
|
|
14
|
-
-
|
|
15
|
-
- Frontend context: https://docs.copilotkit.ai/reference/angular/directives/CopilotKitAgentContext.md
|
|
16
|
-
|
|
17
|
-
Fetch both selected documentation pages in one step rather than one after another.
|
|
18
|
-
Record Angular as the selected frontend and keep these URLs. Do not use remembered
|
|
19
|
-
CopilotKit instructions.
|
|
12
|
+
- https://docs.copilotkit.ai/angular.md
|
|
13
|
+
- https://docs.copilotkit.ai/angular/inspector.md
|
|
14
|
+
- https://docs.copilotkit.ai/reference/angular/directives/CopilotKitAgentContext.md
|
|
20
15
|
|
|
21
16
|
Take the frontend-context step from the directive page. The agent-framework page shows
|
|
22
17
|
the React hook, and Angular shares the same context through this directive instead.
|
|
18
|
+
Use the Inspector page for proof.
|
|
23
19
|
|
|
24
20
|
Angular CLI 22 requires Node `^22.22.3 || ^24.15.0 || >=26`. Check the Node version before
|
|
25
21
|
you create or build an Angular project. If the installed version is lower, select a
|
|
26
22
|
supported version first and use it for every later command in this project.
|
|
27
23
|
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
`curl -fsSL <url>`, or read the same page without the `.md` suffix. Treat a page as
|
|
31
|
-
unavailable only after a second method also fails.
|
|
32
|
-
|
|
33
|
-
If the page supports the selection, run
|
|
34
|
-
`npx --yes copilotkit@4.9.2 onboard read credentials/finalize-plan`.
|
|
24
|
+
If the pages support the selection, record Angular and these URLs. Then run
|
|
25
|
+
`npx --yes copilotkit@4.9.4 onboard read credentials/finalize-plan`.
|
|
35
26
|
|
|
36
|
-
If
|
|
37
|
-
|
|
38
|
-
`npx --yes copilotkit@4.9.2 onboard read unsupported/no-validated-path`.
|
|
27
|
+
If the documentation does not support the selection, run
|
|
28
|
+
`npx --yes copilotkit@4.9.4 onboard read unsupported/no-validated-path`.
|
|
@@ -15,29 +15,19 @@ These TypeScript options have starters: Claude Agent SDK TypeScript, LangGraph T
|
|
|
15
15
|
Mastra, and Strands Agents TypeScript. The .NET option is Microsoft Agent Framework .NET.
|
|
16
16
|
|
|
17
17
|
If all shortcut conditions are true, record Next.js as the selected frontend. Then run
|
|
18
|
-
`npx --yes copilotkit@4.9.
|
|
18
|
+
`npx --yes copilotkit@4.9.4 onboard read starter/clone` before you fetch documentation.
|
|
19
19
|
|
|
20
20
|
## Documentation
|
|
21
21
|
|
|
22
|
-
-
|
|
23
|
-
- Implementation and validation: https://docs.copilotkit.ai/quickstart.md
|
|
24
|
-
- Proof: https://docs.copilotkit.ai/quickstart.md
|
|
25
|
-
|
|
26
|
-
Fetch each selected documentation URL. Record Next.js as the selected frontend and keep
|
|
27
|
-
these URLs. Do not use remembered CopilotKit instructions.
|
|
22
|
+
- https://docs.copilotkit.ai/quickstart.md
|
|
28
23
|
|
|
29
24
|
Take the frontend scaffolding from this page. Take the runtime agent wiring from the
|
|
30
25
|
agent framework documentation instead. This page configures the CopilotKit built-in
|
|
31
26
|
agent as the default agent, which is correct only for a project that has no agent.
|
|
32
27
|
Do not replace the developer's existing agent with the built-in agent.
|
|
33
28
|
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
`curl -fsSL <url>`, or read the same page without the `.md` suffix. Treat a page as
|
|
37
|
-
unavailable only after a second method also fails.
|
|
38
|
-
|
|
39
|
-
If the pages support the selection, run
|
|
40
|
-
`npx --yes copilotkit@4.9.2 onboard read credentials/finalize-plan`.
|
|
29
|
+
If the page supports the selection, record Next.js and this URL. Then run
|
|
30
|
+
`npx --yes copilotkit@4.9.4 onboard read credentials/finalize-plan`.
|
|
41
31
|
|
|
42
|
-
If
|
|
43
|
-
`npx --yes copilotkit@4.9.
|
|
32
|
+
If the documentation does not support the selection, run
|
|
33
|
+
`npx --yes copilotkit@4.9.4 onboard read unsupported/no-validated-path`.
|
|
@@ -5,9 +5,9 @@ that the repository does not show. Do not change application code in this phase.
|
|
|
5
5
|
|
|
6
6
|
Use a gentle wizard. Ask one short question at a time. Do not combine separate choices in
|
|
7
7
|
one question. Put the recommendation first, give its evidence in one sentence, and keep
|
|
8
|
-
the alternatives short. When the frontend is unknown,
|
|
9
|
-
|
|
10
|
-
|
|
8
|
+
the alternatives short. When the frontend is unknown, use this rule: Ask one frontend
|
|
9
|
+
question that lists the recommendation and valid choices. Do not ask a yes-or-no question
|
|
10
|
+
first. Do not ask about the model or project in this step.
|
|
11
11
|
|
|
12
12
|
If the project has a frontend, preserve it and use the matching route below. If the project
|
|
13
13
|
needs a frontend, show the valid choices and one recommendation based on repository
|
|
@@ -22,18 +22,13 @@ CopilotKit runtime lives: Next.js hosts it in a route handler, Angular in its SS
|
|
|
22
22
|
server, and Vue 3, React SPA and React Native reach a runtime that runs as its own
|
|
23
23
|
process.
|
|
24
24
|
|
|
25
|
-
A fetch tool that refuses a URL, or fails to reach it, reports a limit of the tool and
|
|
26
|
-
not a fact about the page. Retrieve the same URL a second way before you judge it. Run
|
|
27
|
-
`curl -fsSL <url>`, or read the same page without the `.md` suffix. Treat a page as
|
|
28
|
-
unavailable only after a second method also fails.
|
|
29
|
-
|
|
30
25
|
Use exactly one matching internal route:
|
|
31
26
|
|
|
32
|
-
1. React SPA: `npx --yes copilotkit@4.9.
|
|
33
|
-
2. Next.js: `npx --yes copilotkit@4.9.
|
|
34
|
-
3. Angular: `npx --yes copilotkit@4.9.
|
|
35
|
-
4. Vue 3: `npx --yes copilotkit@4.9.
|
|
36
|
-
5. React Native: `npx --yes copilotkit@4.9.
|
|
27
|
+
1. React SPA: `npx --yes copilotkit@4.9.4 onboard read frontend/react-spa`
|
|
28
|
+
2. Next.js: `npx --yes copilotkit@4.9.4 onboard read frontend/nextjs`
|
|
29
|
+
3. Angular: `npx --yes copilotkit@4.9.4 onboard read frontend/angular`
|
|
30
|
+
4. Vue 3: `npx --yes copilotkit@4.9.4 onboard read frontend/vue`
|
|
31
|
+
5. React Native: `npx --yes copilotkit@4.9.4 onboard read frontend/react-native`
|
|
37
32
|
|
|
38
33
|
If no listed frontend fits, run
|
|
39
|
-
`npx --yes copilotkit@4.9.
|
|
34
|
+
`npx --yes copilotkit@4.9.4 onboard read unsupported/no-validated-path`.
|
|
@@ -4,21 +4,13 @@ Preserve an existing React Native frontend. Use the selected page for a new fron
|
|
|
4
4
|
|
|
5
5
|
## Documentation
|
|
6
6
|
|
|
7
|
-
-
|
|
8
|
-
-
|
|
9
|
-
- Proof: https://docs.copilotkit.ai/react-native.md
|
|
7
|
+
- https://docs.copilotkit.ai/react-native.md
|
|
8
|
+
- https://docs.copilotkit.ai/troubleshooting/event-inspector.md
|
|
10
9
|
|
|
11
|
-
|
|
12
|
-
keep this URL. Do not use remembered CopilotKit instructions.
|
|
10
|
+
Use the Event Inspector page for proof.
|
|
13
11
|
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
`curl -fsSL <url>`, or read the same page without the `.md` suffix. Treat a page as
|
|
17
|
-
unavailable only after a second method also fails.
|
|
12
|
+
If the pages support the selection, record React Native and these URLs. Then run
|
|
13
|
+
`npx --yes copilotkit@4.9.4 onboard read credentials/finalize-plan`.
|
|
18
14
|
|
|
19
|
-
If the
|
|
20
|
-
`npx --yes copilotkit@4.9.
|
|
21
|
-
|
|
22
|
-
If a second method also fails, or the page that loads does not support the selection,
|
|
23
|
-
run
|
|
24
|
-
`npx --yes copilotkit@4.9.2 onboard read unsupported/no-validated-path`.
|
|
15
|
+
If the documentation does not support the selection, run
|
|
16
|
+
`npx --yes copilotkit@4.9.4 onboard read unsupported/no-validated-path`.
|
|
@@ -8,20 +8,10 @@ not move the agent into it.
|
|
|
8
8
|
|
|
9
9
|
## Documentation
|
|
10
10
|
|
|
11
|
-
-
|
|
12
|
-
- Implementation and validation: https://docs.copilotkit.ai/react-spa.md
|
|
13
|
-
- Proof: https://docs.copilotkit.ai/react-spa.md
|
|
11
|
+
- https://docs.copilotkit.ai/react-spa.md
|
|
14
12
|
|
|
15
|
-
|
|
16
|
-
|
|
13
|
+
If the page supports the selection, record React SPA and this URL. Then run
|
|
14
|
+
`npx --yes copilotkit@4.9.4 onboard read credentials/finalize-plan`.
|
|
17
15
|
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
`curl -fsSL <url>`, or read the same page without the `.md` suffix. Treat a page as
|
|
21
|
-
unavailable only after a second method also fails.
|
|
22
|
-
|
|
23
|
-
If the page supports the selection, run
|
|
24
|
-
`npx --yes copilotkit@4.9.2 onboard read credentials/finalize-plan`.
|
|
25
|
-
|
|
26
|
-
If a second method also fails, or a page that loads does not support the selection, run
|
|
27
|
-
`npx --yes copilotkit@4.9.2 onboard read unsupported/no-validated-path`.
|
|
16
|
+
If the documentation does not support the selection, run
|
|
17
|
+
`npx --yes copilotkit@4.9.4 onboard read unsupported/no-validated-path`.
|
|
@@ -4,21 +4,14 @@ Preserve an existing Vue 3 frontend. Use the selected page for a new frontend.
|
|
|
4
4
|
|
|
5
5
|
## Documentation
|
|
6
6
|
|
|
7
|
-
-
|
|
8
|
-
-
|
|
9
|
-
-
|
|
7
|
+
- https://docs.copilotkit.ai/vue.md
|
|
8
|
+
- https://docs.copilotkit.ai/reference/vue/components/CopilotKitProvider.md
|
|
9
|
+
- https://docs.copilotkit.ai/reference/vue/hooks/useAgentContext.md
|
|
10
10
|
|
|
11
|
-
|
|
12
|
-
this URL. Do not use remembered CopilotKit instructions.
|
|
11
|
+
Use the component page for the provider setup. Use the hook page for frontend context.
|
|
13
12
|
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
`curl -fsSL <url>`, or read the same page without the `.md` suffix. Treat a page as
|
|
17
|
-
unavailable only after a second method also fails.
|
|
13
|
+
If the pages support the selection, record Vue 3 and these URLs. Then run
|
|
14
|
+
`npx --yes copilotkit@4.9.4 onboard read credentials/finalize-plan`.
|
|
18
15
|
|
|
19
|
-
If the
|
|
20
|
-
`npx --yes copilotkit@4.9.
|
|
21
|
-
|
|
22
|
-
If a second method also fails, or the page that loads does not support the selection,
|
|
23
|
-
run
|
|
24
|
-
`npx --yes copilotkit@4.9.2 onboard read unsupported/no-validated-path`.
|
|
16
|
+
If the documentation does not support the selection, run
|
|
17
|
+
`npx --yes copilotkit@4.9.4 onboard read unsupported/no-validated-path`.
|
|
@@ -4,11 +4,11 @@ Do not implement the plan yourself. Spawn one implementation subagent.
|
|
|
4
4
|
|
|
5
5
|
Give the subagent the full text of the implementation brief at the end of this prompt, the
|
|
6
6
|
approved plan, selected framework, frontend, model, repository findings, and selected
|
|
7
|
-
documentation URLs.
|
|
7
|
+
documentation URLs. Give it the documentation policy recorded during framework selection.
|
|
8
8
|
Wait for the subagent to finish.
|
|
9
9
|
|
|
10
10
|
If all implementation and validation steps pass, run
|
|
11
|
-
`npx --yes copilotkit@4.9.
|
|
11
|
+
`npx --yes copilotkit@4.9.4 onboard read proof/round-trip`.
|
|
12
12
|
|
|
13
13
|
If a validation command fails, decide which kind of failure it is before you route.
|
|
14
14
|
|
|
@@ -20,7 +20,7 @@ Route out only when the failure is not yours to fix: the failure is in code this
|
|
|
20
20
|
not write, or the fix requires changing the developer's existing agent or frontend,
|
|
21
21
|
or the same command still fails after three repair attempts, or the documentation does not
|
|
22
22
|
support the plan. In those cases run
|
|
23
|
-
`npx --yes copilotkit@4.9.
|
|
23
|
+
`npx --yes copilotkit@4.9.4 onboard read unsupported/no-validated-path`.
|
|
24
24
|
|
|
25
25
|
## Implementation subagent brief
|
|
26
26
|
|
|
@@ -30,14 +30,8 @@ Everything below the rule is the subagent's prompt. Give it verbatim.
|
|
|
30
30
|
|
|
31
31
|
# Implement and validate the approved plan
|
|
32
32
|
|
|
33
|
-
Use only the approved plan and the selected documentation URLs.
|
|
34
|
-
|
|
35
|
-
Do not use remembered CopilotKit instructions.
|
|
36
|
-
|
|
37
|
-
A fetch tool that refuses a URL, or fails to reach it, reports a limit of the tool and
|
|
38
|
-
not a fact about the page. Retrieve the same URL a second way before you judge it. Run
|
|
39
|
-
`curl -fsSL <url>`, or read the same page without the `.md` suffix. Report a
|
|
40
|
-
documentation gap only after a second method also fails.
|
|
33
|
+
Use only the approved plan and the selected documentation URLs. Follow the documentation
|
|
34
|
+
policy the main coding agent gives you before you change the project.
|
|
41
35
|
|
|
42
36
|
Add only the props, options, and imports that appear in the fetched documentation. A
|
|
43
37
|
remembered API from an earlier CopilotKit version will fail type checking against this
|