copilotkit 4.10.1 → 4.11.0
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 +8 -5
- package/cli-build-info.json +8 -8
- package/index.js +139 -34
- package/onboarding/index.json +2 -2
- package/onboarding/prompts/authenticate/start.md +27 -13
- package/onboarding/prompts/conversion/plan.md +3 -3
- package/onboarding/prompts/credentials/finalize-plan.md +30 -21
- package/onboarding/prompts/credentials/plan.md +20 -20
- package/onboarding/prompts/credentials/settle-credentials.md +9 -9
- package/onboarding/prompts/credentials/write-plan.md +7 -7
- package/onboarding/prompts/fallback/best-effort.md +9 -8
- package/onboarding/prompts/feature/a2ui/implement.md +6 -6
- package/onboarding/prompts/feature/a2ui/proof.md +6 -6
- package/onboarding/prompts/feature/a2ui/start.md +7 -7
- package/onboarding/prompts/feature/channels/implement.md +8 -8
- package/onboarding/prompts/feature/channels/proof.md +6 -6
- package/onboarding/prompts/feature/channels/start.md +17 -14
- package/onboarding/prompts/feature/chat-suggestions/implement.md +6 -6
- package/onboarding/prompts/feature/chat-suggestions/proof.md +6 -6
- package/onboarding/prompts/feature/chat-suggestions/start.md +7 -7
- package/onboarding/prompts/feature/complete.md +1 -1
- package/onboarding/prompts/feature/learning/implement.md +12 -12
- package/onboarding/prompts/feature/learning/proof.md +7 -7
- package/onboarding/prompts/feature/learning/start.md +6 -6
- package/onboarding/prompts/feature/open-generative-ui/implement.md +6 -6
- package/onboarding/prompts/feature/open-generative-ui/proof.md +6 -6
- package/onboarding/prompts/feature/open-generative-ui/start.md +7 -7
- package/onboarding/prompts/feature/realtime-sync/implement.md +7 -7
- package/onboarding/prompts/feature/realtime-sync/proof.md +6 -6
- package/onboarding/prompts/feature/realtime-sync/start.md +6 -6
- package/onboarding/prompts/feature/rich-threads/implement.md +8 -8
- package/onboarding/prompts/feature/rich-threads/proof.md +6 -6
- package/onboarding/prompts/feature/rich-threads/start.md +6 -6
- package/onboarding/prompts/feature/stop.md +6 -6
- package/onboarding/prompts/feature/voice/implement.md +6 -6
- package/onboarding/prompts/feature/voice/proof.md +6 -6
- package/onboarding/prompts/feature/voice/start.md +7 -7
- package/onboarding/prompts/framework/ag2.md +2 -2
- package/onboarding/prompts/framework/agno.md +2 -2
- package/onboarding/prompts/framework/built-in.md +2 -2
- package/onboarding/prompts/framework/claude-sdk-python.md +2 -2
- package/onboarding/prompts/framework/claude-sdk-typescript.md +2 -2
- package/onboarding/prompts/framework/crewai-flows.md +2 -2
- package/onboarding/prompts/framework/deep-agents.md +2 -2
- package/onboarding/prompts/framework/google-adk.md +2 -2
- package/onboarding/prompts/framework/langgraph-fastapi.md +2 -2
- package/onboarding/prompts/framework/langgraph-python.md +2 -2
- package/onboarding/prompts/framework/langgraph-typescript.md +2 -2
- package/onboarding/prompts/framework/llamaindex.md +2 -2
- package/onboarding/prompts/framework/mastra.md +2 -2
- package/onboarding/prompts/framework/ms-agent-dotnet.md +2 -2
- package/onboarding/prompts/framework/ms-agent-harness-dotnet.md +2 -2
- package/onboarding/prompts/framework/ms-agent-python.md +2 -2
- package/onboarding/prompts/framework/pydantic-ai.md +2 -2
- package/onboarding/prompts/framework/strands-python.md +2 -2
- package/onboarding/prompts/framework/strands-typescript.md +2 -2
- package/onboarding/prompts/frontend/angular.md +3 -3
- package/onboarding/prompts/frontend/nextjs.md +3 -3
- package/onboarding/prompts/frontend/plan.md +17 -12
- package/onboarding/prompts/frontend/react-native.md +2 -2
- package/onboarding/prompts/frontend/react-spa.md +2 -2
- package/onboarding/prompts/frontend/vue.md +2 -2
- package/onboarding/prompts/implementation/build-and-validate.md +29 -17
- package/onboarding/prompts/proof/complete.md +22 -14
- package/onboarding/prompts/proof/oss-baseline.md +5 -5
- package/onboarding/prompts/proof/round-trip.md +16 -15
- package/onboarding/prompts/research/gather.md +18 -4
- package/onboarding/prompts/research/route.md +9 -10
- package/onboarding/prompts/starter/clone.md +6 -6
- package/onboarding/prompts/stopped/run-failed.md +3 -3
- package/onboarding/prompts/subagent/create-plan.md +1 -1
- package/onboarding/prompts/subagent/prove-oss-baseline.md +1 -1
- package/onboarding/prompts/subagent/prove-round-trip.md +32 -15
- package/onboarding/prompts/unsupported/no-validated-path.md +4 -4
- package/package.json +1 -1
- package/release/release-tool.js +1 -1
|
@@ -135,7 +135,7 @@ IPv6 only, so an IPv4 literal fails against the correct port.
|
|
|
135
135
|
## Step 4 -- Check the wiring
|
|
136
136
|
|
|
137
137
|
With both running, check the wiring in one command before you open a browser:
|
|
138
|
-
`npx --yes copilotkit@4.
|
|
138
|
+
`npx --yes copilotkit@4.11.0 verify --json`. It reads the port from this project, so a
|
|
139
139
|
non-default port needs no flag. The payload reports `runtimeUrl` and `runtimeUrlSource`. A
|
|
140
140
|
`runtimeUrlSource` of `default` means nothing in the project named a port, so pass
|
|
141
141
|
`--runtime-url` with the URL from step 1 in that case. Read the individual checks rather than
|
|
@@ -150,7 +150,7 @@ used the Intelligence credential. `api_key_authenticates` proves only that the k
|
|
|
150
150
|
will not read. `verify` searches upward for the credential and a framework's env loader
|
|
151
151
|
does not, so a key at the repository root is invisible to an app in a subdirectory. The
|
|
152
152
|
check names the file to write instead. Write the key there, or run
|
|
153
|
-
`npx --yes copilotkit@4.
|
|
153
|
+
`npx --yes copilotkit@4.11.0 project select` from the app directory. Do not link,
|
|
154
154
|
copy, or symlink the file to work around it, and do not treat the credential as missing:
|
|
155
155
|
the check above already reported that it exists.
|
|
156
156
|
|
|
@@ -168,7 +168,7 @@ named no port the CLI can read: keep step 2's URL, and rewrite its host as `loca
|
|
|
168
168
|
before you use it.
|
|
169
169
|
|
|
170
170
|
Then run the command once more with the URL you are about to open:
|
|
171
|
-
`npx --yes copilotkit@4.
|
|
171
|
+
`npx --yes copilotkit@4.11.0 verify --frontend-url <that url> --json`. The
|
|
172
172
|
`frontend_assets_served` check asks that server for its page and for one of the page's own
|
|
173
173
|
assets, on that exact host. A `fail` there means the dev server refuses its own static
|
|
174
174
|
assets on the host you were about to use, and the check names the URL to use instead. This
|
|
@@ -176,7 +176,7 @@ is the cheapest step that can save the most expensive one, so run it before the
|
|
|
176
176
|
|
|
177
177
|
## Step 5 -- Prove that the agent runs
|
|
178
178
|
|
|
179
|
-
Run `npx --yes copilotkit@4.
|
|
179
|
+
Run `npx --yes copilotkit@4.11.0 verify --round-trip --json`. It sends one request through
|
|
180
180
|
the runtime and reads the answer back from the thread, so it separates an agent that is
|
|
181
181
|
configured from an agent that works. Use `--agent <id>` when the runtime declares more
|
|
182
182
|
than one. If it reports `user-not-identified`, this project's `identifyUser` reads a
|
|
@@ -189,7 +189,7 @@ Where this run settled a Learning Container, add the flag to the call above rath
|
|
|
189
189
|
running a second round trip:
|
|
190
190
|
|
|
191
191
|
```text
|
|
192
|
-
npx --yes copilotkit@4.
|
|
192
|
+
npx --yes copilotkit@4.11.0 verify --round-trip --expect-learning-container <container id> --json
|
|
193
193
|
```
|
|
194
194
|
|
|
195
195
|
The check reads the thread that this run created, so a second round trip proves a second
|
|
@@ -285,7 +285,7 @@ For a recorded `both-oss` starting state, this step has no component to render.
|
|
|
285
285
|
same request the baseline recorded, require the same kind of user-visible result the
|
|
286
286
|
baseline produced, and require that the thread for that request is listed in the drawer.
|
|
287
287
|
Where this journey's frontend framework ships no threads drawer -- React Native --, prove
|
|
288
|
-
that thread with `npx --yes copilotkit@4.
|
|
288
|
+
that thread with `npx --yes copilotkit@4.11.0 verify --round-trip`, which reads the
|
|
289
289
|
answer back off the thread and needs no browser. Record which of the two you proved.
|
|
290
290
|
|
|
291
291
|
Use the surface control the main coding agent recorded for your environment. It either had
|
|
@@ -313,7 +313,7 @@ request never exercises. Drive it with the browser control step 6 named.
|
|
|
313
313
|
the page to finish loading. Do not retype the host, and do not substitute a URL a tool
|
|
314
314
|
offers you by default. Where the page loads but its styling is missing or the chat
|
|
315
315
|
control is dead, run
|
|
316
|
-
`npx --yes copilotkit@4.
|
|
316
|
+
`npx --yes copilotkit@4.11.0 verify --frontend-url <the url you opened> --json`
|
|
317
317
|
before you diagnose anything else. A dev server can serve its page and refuse every
|
|
318
318
|
static chunk behind it, and on screen that is indistinguishable from a broken
|
|
319
319
|
integration. The `frontend_assets_served` check tells the two apart.
|
|
@@ -337,8 +337,9 @@ request never exercises. Drive it with the browser control step 6 named.
|
|
|
337
337
|
9. Record one line for the finished turn: the time, the page URL, the element you read
|
|
338
338
|
the answer from, and what that element showed.
|
|
339
339
|
|
|
340
|
-
Report exactly one of `performed`, `skipped-no-browser-tool`,
|
|
341
|
-
frontend.
|
|
340
|
+
Report exactly one of `performed`, `skipped-no-browser-tool`, `skipped-cloned-starter`, or
|
|
341
|
+
`failed` for a web frontend. Report `skipped-cloned-starter` when this prompt told you to
|
|
342
|
+
open no browser because the run cloned a starter.
|
|
342
343
|
|
|
343
344
|
### Step 6b -- React Native
|
|
344
345
|
|
|
@@ -363,7 +364,8 @@ An Android emulator reaches a runtime on the host machine at `10.0.2.2` rather t
|
|
|
363
364
|
`localhost`. A request that fails against the runtime with nothing in the runtime's own
|
|
364
365
|
log is that, rather than a broken runtime.
|
|
365
366
|
|
|
366
|
-
Report exactly one of `performed`, `skipped-no-device`,
|
|
367
|
+
Report exactly one of `performed`, `skipped-no-device`, `skipped-cloned-starter`, or
|
|
368
|
+
`failed` for React Native.
|
|
367
369
|
|
|
368
370
|
## Step 7 -- Check the answer against the project's data
|
|
369
371
|
|
|
@@ -412,7 +414,7 @@ it, rather than reading the compatibility field as a pass.
|
|
|
412
414
|
For every other starting state, record Step 8 as not applicable.
|
|
413
415
|
|
|
414
416
|
The application edit ban ends only after Step 8 passes or is recorded as not applicable.
|
|
415
|
-
Step 9 can write only the tool files named by its guide.
|
|
417
|
+
Step 9 can write only the tool files named by its guide or by this step.
|
|
416
418
|
|
|
417
419
|
## Step 9 -- Set up the continued-development tools
|
|
418
420
|
|
|
@@ -423,12 +425,27 @@ Tell the developer what the skills install writes into this project before you r
|
|
|
423
425
|
`.agents/skills` directory holding one folder per CopilotKit skill, linked into
|
|
424
426
|
`.claude/skills`. Both sit in the working tree, so the install shows up in `git status`
|
|
425
427
|
and can land in a commit. You cannot know whether this project keeps those directories in
|
|
426
|
-
version control, so name them before you write them rather than after.
|
|
428
|
+
version control, so name them before you write them rather than after. Say the same
|
|
429
|
+
thing about the MCP registration below where it writes `.mcp.json`: that file lands in the
|
|
430
|
+
working tree beside them, for the same reason and with the same consequence.
|
|
427
431
|
|
|
428
432
|
Use it to install the project-scoped CopilotKit Skills.
|
|
429
|
-
Use it to configure the CopilotKit documentation MCP server for the
|
|
430
|
-
|
|
431
|
-
|
|
433
|
+
Use it to configure the CopilotKit documentation MCP server for the coding-agent slug this
|
|
434
|
+
run reported to `onboard identify`.
|
|
435
|
+
|
|
436
|
+
Register it in this project wherever that agent reads a project-scoped file. For
|
|
437
|
+
`claude-code` that is `claude mcp add --scope project`, which writes `.mcp.json` at the
|
|
438
|
+
project root. Without that flag the command writes the agent's own configuration under the
|
|
439
|
+
developer's home directory, outside this project, so pass it even where the command line
|
|
440
|
+
you were given leaves it out. For `github-copilot` the project-scoped file is
|
|
441
|
+
`.vscode/mcp.json`, and for `cursor` it is the project `mcp.json`.
|
|
442
|
+
|
|
443
|
+
Where the agent reads no project-scoped file at all, do not run the registration. `codex`
|
|
444
|
+
and `windsurf` write only under the home directory, and the desktop and web clients
|
|
445
|
+
register through a settings screen this run cannot reach. Print the exact command or
|
|
446
|
+
setting the guide gives for that agent, and tell the developer it is theirs to run. Record
|
|
447
|
+
that as handed over rather than as failed: nothing went wrong, and this run is not allowed
|
|
448
|
+
to edit configuration outside the project.
|
|
432
449
|
|
|
433
450
|
Check whether each install succeeded and record what you found. Record the command result
|
|
434
451
|
for each attempt. Report the Skills result and the MCP result separately from the proof
|
|
@@ -30,13 +30,13 @@ Before you show the best-effort plan, require this complete packet:
|
|
|
30
30
|
- Give the ordered proof rules.
|
|
31
31
|
|
|
32
32
|
After the developer approves the best-effort plan, run
|
|
33
|
-
`npx --yes copilotkit@4.
|
|
33
|
+
`npx --yes copilotkit@4.11.0 onboard read fallback/best-effort`.
|
|
34
34
|
|
|
35
|
-
Send one short report. Run the friction command without another developer question.
|
|
36
|
-
|
|
35
|
+
Send one short report. Run the friction command without another developer question. Do not
|
|
36
|
+
ask the developer about telemetry: the command applies the setting they already have.
|
|
37
37
|
|
|
38
38
|
```text
|
|
39
|
-
npx --yes copilotkit@4.
|
|
39
|
+
npx --yes copilotkit@4.11.0 onboard friction --phase stop --category <slug>
|
|
40
40
|
```
|
|
41
41
|
|
|
42
42
|
Write one or two sentences to standard input: the step you stopped at and what stopped it.
|
package/package.json
CHANGED
package/release/release-tool.js
CHANGED
|
@@ -14698,7 +14698,7 @@ import * as path4 from "node:path";
|
|
|
14698
14698
|
|
|
14699
14699
|
// apps/cli/src/config.ts
|
|
14700
14700
|
function getTemplateRef() {
|
|
14701
|
-
return true ? "
|
|
14701
|
+
return true ? "dc1238c0bd473e259c992b85026cb30fe6b3b726" : "main";
|
|
14702
14702
|
}
|
|
14703
14703
|
|
|
14704
14704
|
// apps/cli/src/services/agentcore-config.ts
|