copilotkit 4.8.3 → 4.8.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/README.md +164 -0
- package/cli-build-info.json +7 -7
- package/index.js +5569 -3567
- package/onboarding/index.json +1 -140
- package/onboarding/prompts/authenticate/start.md +45 -9
- package/onboarding/prompts/credentials/finalize-plan.md +143 -15
- package/onboarding/prompts/credentials/plan.md +24 -50
- package/onboarding/prompts/framework/google-adk.md +26 -7
- package/onboarding/prompts/framework/langgraph-python.md +9 -4
- package/onboarding/prompts/framework/langgraph-typescript.md +9 -4
- package/onboarding/prompts/framework/mastra.md +42 -5
- package/onboarding/prompts/framework/ms-agent-dotnet.md +51 -6
- package/onboarding/prompts/framework/ms-agent-python.md +26 -6
- package/onboarding/prompts/frontend/angular.md +13 -4
- package/onboarding/prompts/frontend/nextjs.md +7 -2
- package/onboarding/prompts/frontend/plan.md +15 -20
- package/onboarding/prompts/frontend/react-native.md +2 -2
- package/onboarding/prompts/frontend/react-spa.md +1 -1
- package/onboarding/prompts/frontend/vue.md +2 -2
- package/onboarding/prompts/implementation/build-and-validate.md +72 -7
- package/onboarding/prompts/proof/complete.md +54 -2
- package/onboarding/prompts/proof/round-trip.md +134 -7
- package/onboarding/prompts/subagent/create-plan.md +57 -2
- package/onboarding/prompts/subagent/implement-and-validate.md +38 -3
- package/onboarding/prompts/subagent/inspect-repository.md +13 -3
- package/onboarding/prompts/subagent/prove-round-trip.md +103 -9
- package/onboarding/prompts/unsupported/no-validated-path.md +9 -4
- package/package.json +1 -1
- package/release/release-tool.js +32 -4
- package/onboarding/prompts/framework/ag2.md +0 -22
- package/onboarding/prompts/framework/agno.md +0 -23
- package/onboarding/prompts/framework/built-in.md +0 -21
- package/onboarding/prompts/framework/claude-sdk-python.md +0 -21
- package/onboarding/prompts/framework/claude-sdk-typescript.md +0 -21
- package/onboarding/prompts/framework/crewai-flows.md +0 -22
- package/onboarding/prompts/framework/deep-agents.md +0 -21
- package/onboarding/prompts/framework/langgraph-fastapi.md +0 -23
- package/onboarding/prompts/framework/llamaindex.md +0 -23
- package/onboarding/prompts/framework/ms-agent-harness-dotnet.md +0 -22
- package/onboarding/prompts/framework/pydantic-ai.md +0 -23
- package/onboarding/prompts/framework/strands-python.md +0 -23
- package/onboarding/prompts/framework/strands-typescript.md +0 -23
- package/onboarding/prompts/frontend/slack.md +0 -20
- package/onboarding/prompts/frontend/teams.md +0 -20
package/onboarding/index.json
CHANGED
|
@@ -3,7 +3,6 @@
|
|
|
3
3
|
"prompts": [
|
|
4
4
|
{
|
|
5
5
|
"edges": [
|
|
6
|
-
"subagent/inspect-repository",
|
|
7
6
|
"credentials/plan",
|
|
8
7
|
"unsupported/no-validated-path"
|
|
9
8
|
],
|
|
@@ -12,7 +11,6 @@
|
|
|
12
11
|
},
|
|
13
12
|
{
|
|
14
13
|
"edges": [
|
|
15
|
-
"subagent/create-plan",
|
|
16
14
|
"implementation/build-and-validate",
|
|
17
15
|
"unsupported/no-validated-path"
|
|
18
16
|
],
|
|
@@ -21,86 +19,17 @@
|
|
|
21
19
|
},
|
|
22
20
|
{
|
|
23
21
|
"edges": [
|
|
24
|
-
"framework/built-in",
|
|
25
|
-
"framework/deep-agents",
|
|
26
22
|
"framework/langgraph-python",
|
|
27
|
-
"framework/langgraph-fastapi",
|
|
28
23
|
"framework/langgraph-typescript",
|
|
29
24
|
"framework/google-adk",
|
|
30
|
-
"framework/strands-python",
|
|
31
|
-
"framework/strands-typescript",
|
|
32
|
-
"framework/mastra",
|
|
33
|
-
"framework/claude-sdk-python",
|
|
34
|
-
"framework/claude-sdk-typescript",
|
|
35
|
-
"framework/pydantic-ai",
|
|
36
25
|
"framework/ms-agent-python",
|
|
37
26
|
"framework/ms-agent-dotnet",
|
|
38
|
-
"framework/
|
|
39
|
-
"framework/ag2",
|
|
40
|
-
"framework/agno",
|
|
41
|
-
"framework/llamaindex",
|
|
42
|
-
"framework/crewai-flows",
|
|
27
|
+
"framework/mastra",
|
|
43
28
|
"unsupported/no-validated-path"
|
|
44
29
|
],
|
|
45
30
|
"milestone": "credentials",
|
|
46
31
|
"name": "credentials/plan"
|
|
47
32
|
},
|
|
48
|
-
{
|
|
49
|
-
"edges": [
|
|
50
|
-
"frontend/plan",
|
|
51
|
-
"unsupported/no-validated-path"
|
|
52
|
-
],
|
|
53
|
-
"milestone": "framework",
|
|
54
|
-
"name": "framework/ag2"
|
|
55
|
-
},
|
|
56
|
-
{
|
|
57
|
-
"edges": [
|
|
58
|
-
"frontend/plan",
|
|
59
|
-
"unsupported/no-validated-path"
|
|
60
|
-
],
|
|
61
|
-
"milestone": "framework",
|
|
62
|
-
"name": "framework/agno"
|
|
63
|
-
},
|
|
64
|
-
{
|
|
65
|
-
"edges": [
|
|
66
|
-
"frontend/plan",
|
|
67
|
-
"unsupported/no-validated-path"
|
|
68
|
-
],
|
|
69
|
-
"milestone": "framework",
|
|
70
|
-
"name": "framework/built-in"
|
|
71
|
-
},
|
|
72
|
-
{
|
|
73
|
-
"edges": [
|
|
74
|
-
"frontend/plan",
|
|
75
|
-
"unsupported/no-validated-path"
|
|
76
|
-
],
|
|
77
|
-
"milestone": "framework",
|
|
78
|
-
"name": "framework/claude-sdk-python"
|
|
79
|
-
},
|
|
80
|
-
{
|
|
81
|
-
"edges": [
|
|
82
|
-
"frontend/plan",
|
|
83
|
-
"unsupported/no-validated-path"
|
|
84
|
-
],
|
|
85
|
-
"milestone": "framework",
|
|
86
|
-
"name": "framework/claude-sdk-typescript"
|
|
87
|
-
},
|
|
88
|
-
{
|
|
89
|
-
"edges": [
|
|
90
|
-
"frontend/plan",
|
|
91
|
-
"unsupported/no-validated-path"
|
|
92
|
-
],
|
|
93
|
-
"milestone": "framework",
|
|
94
|
-
"name": "framework/crewai-flows"
|
|
95
|
-
},
|
|
96
|
-
{
|
|
97
|
-
"edges": [
|
|
98
|
-
"frontend/plan",
|
|
99
|
-
"unsupported/no-validated-path"
|
|
100
|
-
],
|
|
101
|
-
"milestone": "framework",
|
|
102
|
-
"name": "framework/deep-agents"
|
|
103
|
-
},
|
|
104
33
|
{
|
|
105
34
|
"edges": [
|
|
106
35
|
"frontend/plan",
|
|
@@ -109,14 +38,6 @@
|
|
|
109
38
|
"milestone": "framework",
|
|
110
39
|
"name": "framework/google-adk"
|
|
111
40
|
},
|
|
112
|
-
{
|
|
113
|
-
"edges": [
|
|
114
|
-
"frontend/plan",
|
|
115
|
-
"unsupported/no-validated-path"
|
|
116
|
-
],
|
|
117
|
-
"milestone": "framework",
|
|
118
|
-
"name": "framework/langgraph-fastapi"
|
|
119
|
-
},
|
|
120
41
|
{
|
|
121
42
|
"edges": [
|
|
122
43
|
"frontend/plan",
|
|
@@ -133,14 +54,6 @@
|
|
|
133
54
|
"milestone": "framework",
|
|
134
55
|
"name": "framework/langgraph-typescript"
|
|
135
56
|
},
|
|
136
|
-
{
|
|
137
|
-
"edges": [
|
|
138
|
-
"frontend/plan",
|
|
139
|
-
"unsupported/no-validated-path"
|
|
140
|
-
],
|
|
141
|
-
"milestone": "framework",
|
|
142
|
-
"name": "framework/llamaindex"
|
|
143
|
-
},
|
|
144
57
|
{
|
|
145
58
|
"edges": [
|
|
146
59
|
"frontend/plan",
|
|
@@ -157,14 +70,6 @@
|
|
|
157
70
|
"milestone": "framework",
|
|
158
71
|
"name": "framework/ms-agent-dotnet"
|
|
159
72
|
},
|
|
160
|
-
{
|
|
161
|
-
"edges": [
|
|
162
|
-
"frontend/plan",
|
|
163
|
-
"unsupported/no-validated-path"
|
|
164
|
-
],
|
|
165
|
-
"milestone": "framework",
|
|
166
|
-
"name": "framework/ms-agent-harness-dotnet"
|
|
167
|
-
},
|
|
168
73
|
{
|
|
169
74
|
"edges": [
|
|
170
75
|
"frontend/plan",
|
|
@@ -173,30 +78,6 @@
|
|
|
173
78
|
"milestone": "framework",
|
|
174
79
|
"name": "framework/ms-agent-python"
|
|
175
80
|
},
|
|
176
|
-
{
|
|
177
|
-
"edges": [
|
|
178
|
-
"frontend/plan",
|
|
179
|
-
"unsupported/no-validated-path"
|
|
180
|
-
],
|
|
181
|
-
"milestone": "framework",
|
|
182
|
-
"name": "framework/pydantic-ai"
|
|
183
|
-
},
|
|
184
|
-
{
|
|
185
|
-
"edges": [
|
|
186
|
-
"frontend/plan",
|
|
187
|
-
"unsupported/no-validated-path"
|
|
188
|
-
],
|
|
189
|
-
"milestone": "framework",
|
|
190
|
-
"name": "framework/strands-python"
|
|
191
|
-
},
|
|
192
|
-
{
|
|
193
|
-
"edges": [
|
|
194
|
-
"frontend/plan",
|
|
195
|
-
"unsupported/no-validated-path"
|
|
196
|
-
],
|
|
197
|
-
"milestone": "framework",
|
|
198
|
-
"name": "framework/strands-typescript"
|
|
199
|
-
},
|
|
200
81
|
{
|
|
201
82
|
"edges": [
|
|
202
83
|
"credentials/finalize-plan",
|
|
@@ -220,8 +101,6 @@
|
|
|
220
101
|
"frontend/angular",
|
|
221
102
|
"frontend/vue",
|
|
222
103
|
"frontend/react-native",
|
|
223
|
-
"frontend/slack",
|
|
224
|
-
"frontend/teams",
|
|
225
104
|
"unsupported/no-validated-path"
|
|
226
105
|
],
|
|
227
106
|
"milestone": "frontend",
|
|
@@ -242,22 +121,6 @@
|
|
|
242
121
|
"milestone": "frontend",
|
|
243
122
|
"name": "frontend/react-spa"
|
|
244
123
|
},
|
|
245
|
-
{
|
|
246
|
-
"edges": [
|
|
247
|
-
"credentials/finalize-plan",
|
|
248
|
-
"unsupported/no-validated-path"
|
|
249
|
-
],
|
|
250
|
-
"milestone": "frontend",
|
|
251
|
-
"name": "frontend/slack"
|
|
252
|
-
},
|
|
253
|
-
{
|
|
254
|
-
"edges": [
|
|
255
|
-
"credentials/finalize-plan",
|
|
256
|
-
"unsupported/no-validated-path"
|
|
257
|
-
],
|
|
258
|
-
"milestone": "frontend",
|
|
259
|
-
"name": "frontend/teams"
|
|
260
|
-
},
|
|
261
124
|
{
|
|
262
125
|
"edges": [
|
|
263
126
|
"credentials/finalize-plan",
|
|
@@ -268,7 +131,6 @@
|
|
|
268
131
|
},
|
|
269
132
|
{
|
|
270
133
|
"edges": [
|
|
271
|
-
"subagent/implement-and-validate",
|
|
272
134
|
"proof/round-trip",
|
|
273
135
|
"unsupported/no-validated-path"
|
|
274
136
|
],
|
|
@@ -282,7 +144,6 @@
|
|
|
282
144
|
},
|
|
283
145
|
{
|
|
284
146
|
"edges": [
|
|
285
|
-
"subagent/prove-round-trip",
|
|
286
147
|
"proof/complete",
|
|
287
148
|
"unsupported/no-validated-path"
|
|
288
149
|
],
|
|
@@ -8,7 +8,13 @@ Do not show prompt names, internal route IDs, subagent names, or storage field n
|
|
|
8
8
|
Work from the target project directory. For an existing project, start at its inspection
|
|
9
9
|
root.
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
Read only inside the target project directory. Every subagent you spawn inherits that
|
|
12
|
+
limit, including one this graph does not name. Answer a CopilotKit API or configuration
|
|
13
|
+
question from the documentation this graph gives you. Another checkout on this machine is
|
|
14
|
+
not a source. The developer running this has none, so an answer taken from one is an
|
|
15
|
+
answer they cannot get, and it hides the documentation gap that blocks them.
|
|
16
|
+
|
|
17
|
+
Run `npx copilotkit@4.8.4 login --json` before any project work. This command checks the
|
|
12
18
|
current session. It starts sign-in only as needed.
|
|
13
19
|
|
|
14
20
|
Read its JSON Lines output in order:
|
|
@@ -21,9 +27,8 @@ Read its JSON Lines output in order:
|
|
|
21
27
|
Do not use `whoami` for this check. It has no JSON output and some failures exit with code
|
|
22
28
|
zero. Do not put account tokens or credentials in the conversation.
|
|
23
29
|
|
|
24
|
-
Spawn one research subagent.
|
|
25
|
-
|
|
26
|
-
return only its findings. Add these tasks:
|
|
30
|
+
Spawn one research subagent. Give it the full text of the research brief at the end of this
|
|
31
|
+
prompt and tell it to follow that brief and return only its findings. Add these tasks:
|
|
27
32
|
|
|
28
33
|
- Find the target app or runtime directory that owns `.env` and CopilotKit setup.
|
|
29
34
|
- Check whether `.copilotkit/project.json` has `projectId`, `projectSlug`, and `clerkOrgId`.
|
|
@@ -36,12 +41,43 @@ field names. Wait for the subagent to finish.
|
|
|
36
41
|
If a repository file exists, each finding must cite it. For an empty project, the subagent
|
|
37
42
|
must cite its directory check and report absent parts.
|
|
38
43
|
|
|
39
|
-
The findings must cover the agent, frontend, CopilotKit setup,
|
|
40
|
-
credential names, and validation path. Do not ask the developer for facts
|
|
41
|
-
repository answers.
|
|
44
|
+
The findings must cover what the project is for, the agent, frontend, CopilotKit setup,
|
|
45
|
+
authentication, credential names, and validation path. Do not ask the developer for facts
|
|
46
|
+
that the repository answers.
|
|
42
47
|
|
|
43
48
|
When the evidence is complete, run
|
|
44
|
-
`npx copilotkit@4.8.
|
|
49
|
+
`npx copilotkit@4.8.4 onboard read credentials/plan`.
|
|
45
50
|
|
|
46
51
|
If authentication or inspection stops onboarding, run
|
|
47
|
-
`npx copilotkit@4.8.
|
|
52
|
+
`npx copilotkit@4.8.4 onboard read unsupported/no-validated-path`.
|
|
53
|
+
|
|
54
|
+
## Research subagent brief
|
|
55
|
+
|
|
56
|
+
Everything below the rule is the subagent's prompt. Give it verbatim.
|
|
57
|
+
|
|
58
|
+
---
|
|
59
|
+
|
|
60
|
+
# Inspect the repository
|
|
61
|
+
|
|
62
|
+
Inspect the repository without changing it. Find evidence for:
|
|
63
|
+
|
|
64
|
+
- what the project is for, in the project's own words
|
|
65
|
+
- any existing agent framework
|
|
66
|
+
- any existing frontend
|
|
67
|
+
- current CopilotKit packages and configuration
|
|
68
|
+
- authentication boundaries
|
|
69
|
+
- names of required credential variables, without reading their values
|
|
70
|
+
|
|
71
|
+
A project states what it is for in its `README.md`, in its package description, or in
|
|
72
|
+
the prompt of an agent it already has. Quote that statement rather than rewriting it. An
|
|
73
|
+
empty project carries it in the README alone, and that makes the README the whole of the
|
|
74
|
+
evidence. State the purpose as unproved when the project never says.
|
|
75
|
+
|
|
76
|
+
Gather what you need in as few commands as possible. Combine independent reads into one
|
|
77
|
+
command rather than running them one at a time. Split a command only when its result decides
|
|
78
|
+
what you run next.
|
|
79
|
+
|
|
80
|
+
Return the file paths and a short finding for each item. State each absent or unproved item.
|
|
81
|
+
Do not read, print, or return secret values. Do not read a file outside the project
|
|
82
|
+
directory. Do not run or return another onboarding command. Stop after returning the
|
|
83
|
+
findings to the main coding agent.
|
|
@@ -17,15 +17,36 @@ confirm that the prior project selection had no key-provision warning.
|
|
|
17
17
|
Reused project credentials remain unverified until an authenticated Intelligence call
|
|
18
18
|
succeeds. Record that state in the plan.
|
|
19
19
|
|
|
20
|
-
If the developer needs a project or another project,
|
|
21
|
-
|
|
22
|
-
directory. This command lets the developer select or create an Intelligence project.
|
|
20
|
+
If the developer needs a project or another project, do the selection yourself from the
|
|
21
|
+
target directory. Do not send the developer to another terminal.
|
|
23
22
|
|
|
24
|
-
|
|
25
|
-
remove any secret before replying. Resume only after they reply.
|
|
23
|
+
List the choices first:
|
|
26
24
|
|
|
27
|
-
|
|
28
|
-
|
|
25
|
+
```text
|
|
26
|
+
npx copilotkit@4.8.4 project list --json
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
With `--json` the payload is the only thing on standard output, so it is safe to parse.
|
|
30
|
+
Show the developer the project names and ask which one to use, or ask for a name for a new
|
|
31
|
+
project. This is the same kind of question as the frontend choice, so ask it here rather
|
|
32
|
+
than ending the turn.
|
|
33
|
+
|
|
34
|
+
Then record their answer, from the target directory:
|
|
35
|
+
|
|
36
|
+
```text
|
|
37
|
+
npx copilotkit@4.8.4 project select --project <slug-or-id> --json
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
Use `--create <name> --json` instead when they want a new project. The two flags cannot be
|
|
41
|
+
combined. A slug that does not exist fails and lists the real ones, so a typo cannot record
|
|
42
|
+
a selection that points at nothing.
|
|
43
|
+
|
|
44
|
+
Read the JSON result. It reports `api_key_provisioned`. Key provisioning is deliberately
|
|
45
|
+
non-fatal, so this command can persist the selection, warn on standard error, and still
|
|
46
|
+
exit zero with no key written. Treat `api_key_provisioned` as false the same way as an
|
|
47
|
+
error and stop onboarding: a scaffold with no key looks finished and is not.
|
|
48
|
+
|
|
49
|
+
Never print the payload or any secret value.
|
|
29
50
|
|
|
30
51
|
After a warning-free result, send the research subagent a follow-up check. Require it to
|
|
31
52
|
confirm these facts without showing values:
|
|
@@ -39,19 +60,126 @@ Do not print either file or any secret value. If a check fails, stop onboarding.
|
|
|
39
60
|
selection success message alone does not prove key readiness. The CLI cannot prove key scope
|
|
40
61
|
before an authenticated Intelligence call succeeds.
|
|
41
62
|
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
63
|
+
## Where a model credential comes from
|
|
64
|
+
|
|
65
|
+
The plan names the model credential variables. Finding their values is not its job.
|
|
66
|
+
|
|
67
|
+
If the project has no value for one, ask the developer where it lives. Never read a file
|
|
68
|
+
outside the project directory to find one. A key found that way belongs to another
|
|
69
|
+
project: it bills that project for these model calls, points attribution at a project
|
|
70
|
+
nobody chose, and leaves no trace, because the scaffold works.
|
|
71
|
+
|
|
72
|
+
Asking where a credential lives is not requesting a secret value. Ask for a path, or ask
|
|
73
|
+
the developer to write the value into the project's env file themselves. A path the
|
|
74
|
+
developer names is theirs to give, including one outside the project. A path this run
|
|
75
|
+
finds is not.
|
|
76
|
+
|
|
77
|
+
If no answer comes, stop. Do not write a placeholder or an empty value. A scaffold
|
|
78
|
+
carrying a dummy key looks finished and fails at the first model call, which is worse
|
|
79
|
+
than stopping here.
|
|
80
|
+
|
|
81
|
+
## Wire the runtime to Intelligence
|
|
82
|
+
|
|
83
|
+
The key in `.env` does nothing on its own. The runtime reads no environment variable for
|
|
84
|
+
it. The credential reaches the platform only when the runtime is constructed with an
|
|
85
|
+
Intelligence client, and a runtime built without one compiles, serves, answers in a
|
|
86
|
+
browser, and never touches the platform.
|
|
87
|
+
|
|
88
|
+
Add this page to the selected documentation URLs for both subagents:
|
|
89
|
+
|
|
90
|
+
- https://docs.copilotkit.ai/premium/connect-your-runtime.md
|
|
91
|
+
|
|
92
|
+
Fetch it together with the pages already selected rather than on its own.
|
|
93
|
+
|
|
94
|
+
Spawn one planning subagent. Give it the full text of the planning brief at the end of this
|
|
95
|
+
prompt, the repository findings, selected framework, frontend, model, credential variable
|
|
96
|
+
names, and selected documentation URLs. Wait for the subagent to finish.
|
|
46
97
|
|
|
47
98
|
Make sure that the plan preserves each part that already exists. The plan must name the
|
|
48
|
-
credential variables,
|
|
49
|
-
contain secret
|
|
99
|
+
credential variables, the Intelligence runtime wiring, the application the project asks
|
|
100
|
+
for, implementation steps, validation steps, and proof steps. It must not contain secret
|
|
101
|
+
values.
|
|
50
102
|
|
|
51
103
|
Show only the selected framework, frontend, model, planned file changes, validation commands, and proof steps.
|
|
52
104
|
|
|
53
105
|
If the developer approves the plan, run
|
|
54
|
-
`npx copilotkit@4.8.
|
|
106
|
+
`npx copilotkit@4.8.4 onboard read implementation/build-and-validate`.
|
|
55
107
|
|
|
56
108
|
If no exact supported path or documentation URL exists, run
|
|
57
|
-
`npx copilotkit@4.8.
|
|
109
|
+
`npx copilotkit@4.8.4 onboard read unsupported/no-validated-path`.
|
|
110
|
+
|
|
111
|
+
## Planning subagent brief
|
|
112
|
+
|
|
113
|
+
Everything below the rule is the subagent's prompt. Give it verbatim.
|
|
114
|
+
|
|
115
|
+
---
|
|
116
|
+
|
|
117
|
+
# Create the onboarding plan
|
|
118
|
+
|
|
119
|
+
Use the selected framework, frontend, model, repository findings, and documentation URLs
|
|
120
|
+
from the main coding agent. Fetch every selected URL in one step rather than one after
|
|
121
|
+
another. Do not use remembered CopilotKit instructions.
|
|
122
|
+
|
|
123
|
+
Name the application the project asks for, and plan that application. Each documentation
|
|
124
|
+
page teaches through one worked example, and that example carries a domain of its own.
|
|
125
|
+
The domain belongs to the page. The project's purpose from the repository findings
|
|
126
|
+
decides what gets built. Where the two differ, the project wins. Where the repository
|
|
127
|
+
never states a purpose, say so in the plan and ask the developer before you adopt the
|
|
128
|
+
domain of an example.
|
|
129
|
+
|
|
130
|
+
Read only inside the project directory. Answer an API question from the documentation
|
|
131
|
+
URLs you were given, not from another checkout on this machine.
|
|
132
|
+
|
|
133
|
+
List the required credential variable names. Do not read or return credential values.
|
|
134
|
+
Preserve each agent or frontend that already exists.
|
|
135
|
+
|
|
136
|
+
Plan the runtime to consume the Intelligence credential. The runtime takes an
|
|
137
|
+
`intelligence` option holding a client built from the project key. A runtime given a
|
|
138
|
+
`runner` option instead is the SSE runtime. It never reads the key, threads are not
|
|
139
|
+
durable, and the Inspector reads the project as locked. The two options cannot be
|
|
140
|
+
combined. Take the constructor from the connect-your-runtime page. Where a framework
|
|
141
|
+
quickstart shows a `runner` option instead, the connect-your-runtime page wins.
|
|
142
|
+
|
|
143
|
+
Where the SDK requires an application-level value that the repository cannot supply, such
|
|
144
|
+
as an end-user identity for threads, use one clearly marked local placeholder and name what
|
|
145
|
+
production requires instead. Do not stop onboarding to ask the developer for it.
|
|
146
|
+
|
|
147
|
+
Check whether the existing agent performs unattended side effects, such as paging, sending
|
|
148
|
+
notifications, writing to an external system, or creating tickets. If it does, the new
|
|
149
|
+
conversational surface must not trigger them. Wrap only the reasoning steps, or require an
|
|
150
|
+
explicit developer confirmation before the side effect can run. Name each side effect you
|
|
151
|
+
found and state how the plan avoids it.
|
|
152
|
+
|
|
153
|
+
If the value of the journey depends on data the project already holds, name that data,
|
|
154
|
+
name where it lives, and name how it reaches the agent. Rendering a list in the DOM does
|
|
155
|
+
not give the agent access to it. An agent wired without the page's data answers from
|
|
156
|
+
entities it invents, and the answer looks correct. Take the frontend-context step from
|
|
157
|
+
the selected documentation. Where no selected page documents it for this framework or
|
|
158
|
+
frontend, record that as a documentation gap rather than guessing the API.
|
|
159
|
+
|
|
160
|
+
Where that data exists, name the entities the proof compares against: the ids, names, or
|
|
161
|
+
records the project holds and the answer has to reference. Where the outcome references
|
|
162
|
+
no project data, say so in the plan, so that the proof asks for evidence this journey can
|
|
163
|
+
produce.
|
|
164
|
+
|
|
165
|
+
Create one plan for implementation, validation, and proof. Name each file or area that can
|
|
166
|
+
change. Name the commands that can validate the result.
|
|
167
|
+
Name the commands or user path that prove a real generative-UI round trip.
|
|
168
|
+
|
|
169
|
+
Keep a production build out of the validation commands. A type check plus the real round
|
|
170
|
+
trip is the proof, and the round trip runs in development mode. Name the production build
|
|
171
|
+
as a follow-up for the developer instead. Never raise a bundle budget or relax a lint rule
|
|
172
|
+
to make a build pass during onboarding.
|
|
173
|
+
|
|
174
|
+
The type check runs against the project's own configuration. If the project has no
|
|
175
|
+
type-check command, add one that uses the configuration the project already has.
|
|
176
|
+
Do not add compiler strictness the project did not have. Nothing later in the run is
|
|
177
|
+
allowed to weaken type safety, so a stricter gate named here is one the run cannot get
|
|
178
|
+
back out of.
|
|
179
|
+
|
|
180
|
+
Gather what you need in as few commands as possible. Combine independent reads into one
|
|
181
|
+
command rather than running them one at a time. Split a command only when its result decides
|
|
182
|
+
what you run next.
|
|
183
|
+
|
|
184
|
+
Return the plan, the URLs that you read, and each documentation gap. Stop after you return
|
|
185
|
+
the findings to the main coding agent.
|
|
@@ -4,61 +4,35 @@ Use the repository findings to select the agent framework. Ask the developer onl
|
|
|
4
4
|
choices that the repository does not show. Do not change application code in this phase.
|
|
5
5
|
Do not read, show, store, or request a secret value.
|
|
6
6
|
|
|
7
|
-
|
|
8
|
-
below. Ask only about choices that remain unknown.
|
|
7
|
+
This release validates six agent frameworks:
|
|
9
8
|
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
9
|
+
| Framework | Default vendor |
|
|
10
|
+
| ---------------------------------- | -------------- |
|
|
11
|
+
| LangGraph Python | OpenAI |
|
|
12
|
+
| LangGraph TypeScript | OpenAI |
|
|
13
|
+
| ADK | Google |
|
|
14
|
+
| Microsoft Agent Framework (Python) | OpenAI |
|
|
15
|
+
| Microsoft Agent Framework (.NET) | GitHub Models |
|
|
16
|
+
| Mastra | OpenAI |
|
|
13
17
|
|
|
14
|
-
|
|
18
|
+
If the project already has an agent in a listed framework, preserve that framework and
|
|
19
|
+
its model setup. Ask only about choices that remain unknown.
|
|
15
20
|
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
| LangGraph Python | OpenAI |
|
|
19
|
-
| LangGraph TypeScript | OpenAI |
|
|
20
|
-
| Google ADK | Google |
|
|
21
|
-
| AWS Strands Python | OpenAI |
|
|
22
|
-
| Mastra | OpenAI |
|
|
23
|
-
| Claude Agent SDK Python | Anthropic |
|
|
24
|
-
| Claude Agent SDK TypeScript | Anthropic |
|
|
25
|
-
| PydanticAI | OpenAI |
|
|
26
|
-
| Microsoft Agent Framework Python | OpenAI |
|
|
27
|
-
| Microsoft Agent Framework .NET | GitHub Models |
|
|
28
|
-
| Agno | OpenAI |
|
|
29
|
-
| LlamaIndex | OpenAI |
|
|
21
|
+
If the project needs an agent, show the options and one recommendation based on repository
|
|
22
|
+
evidence. Match the language the repository already uses. Ask the developer to choose.
|
|
30
23
|
|
|
31
|
-
Do not offer
|
|
32
|
-
|
|
33
|
-
either framework, preserve it.
|
|
34
|
-
|
|
35
|
-
Do not offer A2A, A2UI, MCP Apps, Open Generative UI, AgentCore, or `adk-angular` as agent
|
|
36
|
-
frameworks. They are protocols, deployment targets, tools, or combined starters.
|
|
37
|
-
|
|
38
|
-
Show the public options and one recommendation based on repository evidence. If the
|
|
39
|
-
repository has no agent, ask the developer to choose. Do not show the internal route.
|
|
24
|
+
Do not offer a framework that is not listed above. Do not port an existing agent to
|
|
25
|
+
another framework. Do not show the internal route.
|
|
40
26
|
|
|
41
27
|
Use exactly one matching internal route:
|
|
42
28
|
|
|
43
|
-
1.
|
|
44
|
-
2.
|
|
45
|
-
3.
|
|
46
|
-
4.
|
|
47
|
-
5.
|
|
48
|
-
6.
|
|
49
|
-
7. AWS Strands Python: `npx copilotkit@4.8.3 onboard read framework/strands-python`
|
|
50
|
-
8. AWS Strands TypeScript: `npx copilotkit@4.8.3 onboard read framework/strands-typescript`
|
|
51
|
-
9. Mastra: `npx copilotkit@4.8.3 onboard read framework/mastra`
|
|
52
|
-
10. Claude Agent SDK Python: `npx copilotkit@4.8.3 onboard read framework/claude-sdk-python`
|
|
53
|
-
11. Claude Agent SDK TypeScript: `npx copilotkit@4.8.3 onboard read framework/claude-sdk-typescript`
|
|
54
|
-
12. PydanticAI: `npx copilotkit@4.8.3 onboard read framework/pydantic-ai`
|
|
55
|
-
13. Microsoft Agent Framework Python: `npx copilotkit@4.8.3 onboard read framework/ms-agent-python`
|
|
56
|
-
14. Microsoft Agent Framework .NET: `npx copilotkit@4.8.3 onboard read framework/ms-agent-dotnet`
|
|
57
|
-
15. Microsoft Agent Framework Harness .NET: `npx copilotkit@4.8.3 onboard read framework/ms-agent-harness-dotnet`
|
|
58
|
-
16. AG2: `npx copilotkit@4.8.3 onboard read framework/ag2`
|
|
59
|
-
17. Agno: `npx copilotkit@4.8.3 onboard read framework/agno`
|
|
60
|
-
18. LlamaIndex: `npx copilotkit@4.8.3 onboard read framework/llamaindex`
|
|
61
|
-
19. CrewAI Flows: `npx copilotkit@4.8.3 onboard read framework/crewai-flows`
|
|
29
|
+
1. LangGraph Python: `npx copilotkit@4.8.4 onboard read framework/langgraph-python`
|
|
30
|
+
2. LangGraph TypeScript: `npx copilotkit@4.8.4 onboard read framework/langgraph-typescript`
|
|
31
|
+
3. ADK: `npx copilotkit@4.8.4 onboard read framework/google-adk`
|
|
32
|
+
4. Microsoft Agent Framework Python: `npx copilotkit@4.8.4 onboard read framework/ms-agent-python`
|
|
33
|
+
5. Microsoft Agent Framework .NET: `npx copilotkit@4.8.4 onboard read framework/ms-agent-dotnet`
|
|
34
|
+
6. Mastra: `npx copilotkit@4.8.4 onboard read framework/mastra`
|
|
62
35
|
|
|
63
|
-
If no listed framework fits,
|
|
64
|
-
|
|
36
|
+
If the project has an agent in another framework, or no listed framework fits, keep the
|
|
37
|
+
developer's current agent and run
|
|
38
|
+
`npx copilotkit@4.8.4 onboard read unsupported/no-validated-path`.
|
|
@@ -1,7 +1,12 @@
|
|
|
1
|
-
# Configure
|
|
1
|
+
# Configure ADK
|
|
2
2
|
|
|
3
|
-
Preserve an existing
|
|
4
|
-
|
|
3
|
+
Preserve an existing ADK model setup. Start with Google for a new agent. Offer another
|
|
4
|
+
vendor only after an exact CopilotKit Markdown page names it. The page must name its
|
|
5
|
+
credential variables and setup steps.
|
|
6
|
+
|
|
7
|
+
Name the model credential `GOOGLE_API_KEY`. This framework accepts more than one
|
|
8
|
+
spelling, and a scaffold that reaches for a different one looks finished and reads no
|
|
9
|
+
key.
|
|
5
10
|
|
|
6
11
|
Keep `INTELLIGENCE_API_KEY` separate from model-vendor credentials. Do not read, show,
|
|
7
12
|
store, or request a secret value.
|
|
@@ -11,12 +16,26 @@ store, or request a secret value.
|
|
|
11
16
|
- https://docs.copilotkit.ai/google-adk/quickstart.md
|
|
12
17
|
- https://docs.copilotkit.ai/google-adk/inspector.md
|
|
13
18
|
- https://docs.copilotkit.ai/google-adk/generative-ui/a2ui/fixed-schema.md
|
|
19
|
+
- https://docs.copilotkit.ai/reference/v2/hooks/useAgentContext.md
|
|
20
|
+
|
|
21
|
+
Fetch all four pages in one step rather than one after another. Sequential fetching
|
|
22
|
+
cost about nine minutes of the first proven journey.
|
|
23
|
+
|
|
24
|
+
The documentation scope is `google-adk`. A `/adk/` URL answers with a redirect stub
|
|
25
|
+
whose body is the canonical path, so fetch the `google-adk` form.
|
|
26
|
+
|
|
27
|
+
No page documents the Google ADK side of frontend context. The reference page above
|
|
28
|
+
names the frontend hook, and the agent side of the step is undocumented here. Record
|
|
29
|
+
that missing page as a documentation gap. Do not read the built-in-agent context page
|
|
30
|
+
in its place: that page states no backend work is needed, which holds for the built-in
|
|
31
|
+
agent and not for ADK.
|
|
14
32
|
|
|
15
|
-
|
|
16
|
-
|
|
33
|
+
Record the selected framework, vendor, model, required credential variable names, and
|
|
34
|
+
these URLs.
|
|
35
|
+
Do not use remembered CopilotKit instructions.
|
|
17
36
|
|
|
18
37
|
If the pages support the selection, run
|
|
19
|
-
`npx copilotkit@4.8.
|
|
38
|
+
`npx copilotkit@4.8.4 onboard read frontend/plan`.
|
|
20
39
|
|
|
21
40
|
If a page does not load or support the selection, run
|
|
22
|
-
`npx copilotkit@4.8.
|
|
41
|
+
`npx copilotkit@4.8.4 onboard read unsupported/no-validated-path`.
|
|
@@ -12,12 +12,17 @@ store, or request a secret value.
|
|
|
12
12
|
- https://docs.copilotkit.ai/langgraph-python/quickstart.md
|
|
13
13
|
- https://docs.copilotkit.ai/langgraph-python/inspector.md
|
|
14
14
|
- https://docs.copilotkit.ai/langgraph-python/generative-ui/a2ui/fixed-schema.md
|
|
15
|
+
- https://docs.copilotkit.ai/langgraph-python/agent-app-context.md
|
|
15
16
|
|
|
16
|
-
Fetch all
|
|
17
|
-
|
|
17
|
+
Fetch all four pages in one step rather than one after another. Sequential fetching
|
|
18
|
+
cost about nine minutes of the first proven journey.
|
|
19
|
+
|
|
20
|
+
Record the selected framework, vendor, model, required credential variable names, and
|
|
21
|
+
these URLs.
|
|
22
|
+
Do not use remembered CopilotKit instructions.
|
|
18
23
|
|
|
19
24
|
If the pages support the selection, run
|
|
20
|
-
`npx copilotkit@4.8.
|
|
25
|
+
`npx copilotkit@4.8.4 onboard read frontend/plan`.
|
|
21
26
|
|
|
22
27
|
If a page does not load or support the selection, run
|
|
23
|
-
`npx copilotkit@4.8.
|
|
28
|
+
`npx copilotkit@4.8.4 onboard read unsupported/no-validated-path`.
|
|
@@ -12,12 +12,17 @@ store, or request a secret value.
|
|
|
12
12
|
- https://docs.copilotkit.ai/langgraph-typescript/quickstart.md
|
|
13
13
|
- https://docs.copilotkit.ai/langgraph-typescript/inspector.md
|
|
14
14
|
- https://docs.copilotkit.ai/langgraph-typescript/generative-ui/a2ui/fixed-schema.md
|
|
15
|
+
- https://docs.copilotkit.ai/langgraph-typescript/agent-app-context.md
|
|
15
16
|
|
|
16
|
-
Fetch all
|
|
17
|
-
|
|
17
|
+
Fetch all four pages in one step rather than one after another. Sequential fetching
|
|
18
|
+
cost about nine minutes of the first proven journey.
|
|
19
|
+
|
|
20
|
+
Record the selected framework, vendor, model, required credential variable names, and
|
|
21
|
+
these URLs.
|
|
22
|
+
Do not use remembered CopilotKit instructions.
|
|
18
23
|
|
|
19
24
|
If the pages support the selection, run
|
|
20
|
-
`npx copilotkit@4.8.
|
|
25
|
+
`npx copilotkit@4.8.4 onboard read frontend/plan`.
|
|
21
26
|
|
|
22
27
|
If a page does not load or support the selection, run
|
|
23
|
-
`npx copilotkit@4.8.
|
|
28
|
+
`npx copilotkit@4.8.4 onboard read unsupported/no-validated-path`.
|