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.
Files changed (44) hide show
  1. package/README.md +164 -0
  2. package/cli-build-info.json +7 -7
  3. package/index.js +5569 -3567
  4. package/onboarding/index.json +1 -140
  5. package/onboarding/prompts/authenticate/start.md +45 -9
  6. package/onboarding/prompts/credentials/finalize-plan.md +143 -15
  7. package/onboarding/prompts/credentials/plan.md +24 -50
  8. package/onboarding/prompts/framework/google-adk.md +26 -7
  9. package/onboarding/prompts/framework/langgraph-python.md +9 -4
  10. package/onboarding/prompts/framework/langgraph-typescript.md +9 -4
  11. package/onboarding/prompts/framework/mastra.md +42 -5
  12. package/onboarding/prompts/framework/ms-agent-dotnet.md +51 -6
  13. package/onboarding/prompts/framework/ms-agent-python.md +26 -6
  14. package/onboarding/prompts/frontend/angular.md +13 -4
  15. package/onboarding/prompts/frontend/nextjs.md +7 -2
  16. package/onboarding/prompts/frontend/plan.md +15 -20
  17. package/onboarding/prompts/frontend/react-native.md +2 -2
  18. package/onboarding/prompts/frontend/react-spa.md +1 -1
  19. package/onboarding/prompts/frontend/vue.md +2 -2
  20. package/onboarding/prompts/implementation/build-and-validate.md +72 -7
  21. package/onboarding/prompts/proof/complete.md +54 -2
  22. package/onboarding/prompts/proof/round-trip.md +134 -7
  23. package/onboarding/prompts/subagent/create-plan.md +57 -2
  24. package/onboarding/prompts/subagent/implement-and-validate.md +38 -3
  25. package/onboarding/prompts/subagent/inspect-repository.md +13 -3
  26. package/onboarding/prompts/subagent/prove-round-trip.md +103 -9
  27. package/onboarding/prompts/unsupported/no-validated-path.md +9 -4
  28. package/package.json +1 -1
  29. package/release/release-tool.js +32 -4
  30. package/onboarding/prompts/framework/ag2.md +0 -22
  31. package/onboarding/prompts/framework/agno.md +0 -23
  32. package/onboarding/prompts/framework/built-in.md +0 -21
  33. package/onboarding/prompts/framework/claude-sdk-python.md +0 -21
  34. package/onboarding/prompts/framework/claude-sdk-typescript.md +0 -21
  35. package/onboarding/prompts/framework/crewai-flows.md +0 -22
  36. package/onboarding/prompts/framework/deep-agents.md +0 -21
  37. package/onboarding/prompts/framework/langgraph-fastapi.md +0 -23
  38. package/onboarding/prompts/framework/llamaindex.md +0 -23
  39. package/onboarding/prompts/framework/ms-agent-harness-dotnet.md +0 -22
  40. package/onboarding/prompts/framework/pydantic-ai.md +0 -23
  41. package/onboarding/prompts/framework/strands-python.md +0 -23
  42. package/onboarding/prompts/framework/strands-typescript.md +0 -23
  43. package/onboarding/prompts/frontend/slack.md +0 -20
  44. package/onboarding/prompts/frontend/teams.md +0 -20
@@ -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/ms-agent-harness-dotnet",
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
- Run `npx copilotkit@4.8.3 login --json` before any project work. This command checks the
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. Tell it to run
25
- `npx copilotkit@4.8.3 onboard read subagent/inspect-repository`, follow that prompt, and
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, authentication,
40
- credential names, and validation path. Do not ask the developer for facts that the
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.3 onboard read credentials/plan`.
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.3 onboard read unsupported/no-validated-path`.
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, use the target directory. Tell them
21
- to run `npx copilotkit@4.8.3 project select` from an interactive terminal in that
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
- End the turn and ask the developer to return the command's final status lines. Tell them to
25
- remove any secret before replying. Resume only after they reply.
23
+ List the choices first:
26
24
 
27
- If the output includes `Could not provision a project-scoped API key` or another error,
28
- stop onboarding.
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
- Spawn one planning subagent. Tell it to run
43
- `npx copilotkit@4.8.3 onboard read subagent/create-plan`. Give it the repository findings,
44
- selected framework, frontend, model, credential variable names, and selected documentation
45
- URLs. Wait for the subagent to finish.
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, implementation steps, validation steps, and proof steps. It must not
49
- contain secret values.
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.3 onboard read implementation/build-and-validate`.
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.3 onboard read unsupported/no-validated-path`.
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
- If the project has an agent, preserve its framework and model setup. Use the matching route
8
- below. Ask only about choices that remain unknown.
7
+ This release validates six agent frameworks:
9
8
 
10
- If the project needs an agent, run
11
- `npx copilotkit@4.8.3 framework list --json`. The command returns every CLI framework ID.
12
- It has no ownership or stability field.
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
- Offer these first-party CLI-backed options:
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
- | Framework | Default vendor |
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 AG2 as a first-party choice. Its starter tracks third-party code from a moving
32
- branch. CrewAI Flows needs an existing CrewAI Enterprise agent. If the repository uses
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. Built-in: `npx copilotkit@4.8.3 onboard read framework/built-in`
44
- 2. Deep Agents: `npx copilotkit@4.8.3 onboard read framework/deep-agents`
45
- 3. LangGraph Python: `npx copilotkit@4.8.3 onboard read framework/langgraph-python`
46
- 4. LangGraph FastAPI: `npx copilotkit@4.8.3 onboard read framework/langgraph-fastapi`
47
- 5. LangGraph TypeScript: `npx copilotkit@4.8.3 onboard read framework/langgraph-typescript`
48
- 6. Google ADK: `npx copilotkit@4.8.3 onboard read framework/google-adk`
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, run
64
- `npx copilotkit@4.8.3 onboard read unsupported/no-validated-path`.
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 Google ADK
1
+ # Configure ADK
2
2
 
3
- Preserve an existing Google ADK model setup. Start with Google Gemini for a new agent.
4
- Offer another model only after the selected CopilotKit Markdown pages document its setup.
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
- Fetch all three pages. Record the selected framework, vendor, model, required credential
16
- variable names, and these URLs. Do not use remembered CopilotKit instructions.
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.3 onboard read frontend/plan`.
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.3 onboard read unsupported/no-validated-path`.
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 three pages. Record the selected framework, vendor, model, required credential
17
- variable names, and these URLs. Do not use remembered CopilotKit instructions.
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.3 onboard read frontend/plan`.
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.3 onboard read unsupported/no-validated-path`.
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 three pages. Record the selected framework, vendor, model, required credential
17
- variable names, and these URLs. Do not use remembered CopilotKit instructions.
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.3 onboard read frontend/plan`.
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.3 onboard read unsupported/no-validated-path`.
28
+ `npx copilotkit@4.8.4 onboard read unsupported/no-validated-path`.