copilotkit 4.18.0 → 4.20.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.
Files changed (79) hide show
  1. package/README.md +26 -12
  2. package/cli-build-info.json +7 -7
  3. package/index.js +4949 -3293
  4. package/onboarding/index.json +1 -1
  5. package/onboarding/prompts/authenticate/start.md +39 -32
  6. package/onboarding/prompts/conversion/plan.md +3 -3
  7. package/onboarding/prompts/credentials/finalize-plan.md +7 -7
  8. package/onboarding/prompts/credentials/plan.md +47 -21
  9. package/onboarding/prompts/credentials/settle-credentials.md +26 -12
  10. package/onboarding/prompts/credentials/write-plan.md +9 -6
  11. package/onboarding/prompts/fallback/best-effort.md +31 -19
  12. package/onboarding/prompts/feature/a2ui/implement.md +6 -12
  13. package/onboarding/prompts/feature/a2ui/proof.md +8 -19
  14. package/onboarding/prompts/feature/a2ui/start.md +9 -18
  15. package/onboarding/prompts/feature/channels/implement.md +12 -21
  16. package/onboarding/prompts/feature/channels/proof.md +7 -18
  17. package/onboarding/prompts/feature/channels/start.md +14 -21
  18. package/onboarding/prompts/feature/chat-suggestions/implement.md +6 -12
  19. package/onboarding/prompts/feature/chat-suggestions/proof.md +7 -18
  20. package/onboarding/prompts/feature/chat-suggestions/start.md +9 -18
  21. package/onboarding/prompts/feature/complete.md +4 -2
  22. package/onboarding/prompts/feature/learning/implement.md +13 -38
  23. package/onboarding/prompts/feature/learning/proof.md +8 -19
  24. package/onboarding/prompts/feature/learning/start.md +9 -18
  25. package/onboarding/prompts/feature/open-generative-ui/implement.md +6 -12
  26. package/onboarding/prompts/feature/open-generative-ui/proof.md +7 -18
  27. package/onboarding/prompts/feature/open-generative-ui/start.md +9 -18
  28. package/onboarding/prompts/feature/realtime-sync/implement.md +7 -13
  29. package/onboarding/prompts/feature/realtime-sync/proof.md +7 -18
  30. package/onboarding/prompts/feature/realtime-sync/start.md +8 -17
  31. package/onboarding/prompts/feature/rich-threads/implement.md +8 -14
  32. package/onboarding/prompts/feature/rich-threads/proof.md +7 -18
  33. package/onboarding/prompts/feature/rich-threads/start.md +8 -17
  34. package/onboarding/prompts/feature/stop.md +3 -3
  35. package/onboarding/prompts/feature/voice/implement.md +6 -12
  36. package/onboarding/prompts/feature/voice/proof.md +7 -18
  37. package/onboarding/prompts/feature/voice/start.md +9 -18
  38. package/onboarding/prompts/framework/ag2.md +2 -2
  39. package/onboarding/prompts/framework/agno.md +2 -2
  40. package/onboarding/prompts/framework/built-in.md +2 -2
  41. package/onboarding/prompts/framework/claude-sdk-python.md +2 -2
  42. package/onboarding/prompts/framework/claude-sdk-typescript.md +2 -2
  43. package/onboarding/prompts/framework/crewai-flows.md +2 -2
  44. package/onboarding/prompts/framework/deep-agents.md +2 -2
  45. package/onboarding/prompts/framework/google-adk.md +2 -2
  46. package/onboarding/prompts/framework/langgraph-fastapi.md +2 -2
  47. package/onboarding/prompts/framework/langgraph-python.md +2 -2
  48. package/onboarding/prompts/framework/langgraph-typescript.md +2 -2
  49. package/onboarding/prompts/framework/llamaindex.md +2 -2
  50. package/onboarding/prompts/framework/mastra.md +2 -2
  51. package/onboarding/prompts/framework/ms-agent-dotnet.md +8 -3
  52. package/onboarding/prompts/framework/ms-agent-harness-dotnet.md +8 -3
  53. package/onboarding/prompts/framework/ms-agent-python.md +2 -2
  54. package/onboarding/prompts/framework/pydantic-ai.md +2 -2
  55. package/onboarding/prompts/framework/strands-python.md +2 -2
  56. package/onboarding/prompts/framework/strands-typescript.md +2 -2
  57. package/onboarding/prompts/frontend/angular.md +3 -3
  58. package/onboarding/prompts/frontend/nextjs.md +3 -3
  59. package/onboarding/prompts/frontend/plan.md +7 -7
  60. package/onboarding/prompts/frontend/react-native.md +2 -2
  61. package/onboarding/prompts/frontend/react-spa.md +2 -2
  62. package/onboarding/prompts/frontend/vue.md +2 -2
  63. package/onboarding/prompts/implementation/build-and-validate.md +32 -40
  64. package/onboarding/prompts/proof/complete.md +89 -191
  65. package/onboarding/prompts/proof/oss-baseline.md +5 -5
  66. package/onboarding/prompts/proof/round-trip.md +22 -27
  67. package/onboarding/prompts/research/gather.md +5 -14
  68. package/onboarding/prompts/research/merge.md +4 -12
  69. package/onboarding/prompts/research/preflight.md +14 -55
  70. package/onboarding/prompts/research/route.md +7 -6
  71. package/onboarding/prompts/starter/clone.md +5 -15
  72. package/onboarding/prompts/stopped/run-failed.md +2 -2
  73. package/onboarding/prompts/subagent/create-plan.md +25 -1
  74. package/onboarding/prompts/subagent/inspect-repository.md +10 -2
  75. package/onboarding/prompts/subagent/prove-oss-baseline.md +1 -1
  76. package/onboarding/prompts/subagent/prove-round-trip.md +78 -56
  77. package/onboarding/prompts/unsupported/no-validated-path.md +2 -2
  78. package/package.json +1 -1
  79. package/release/release-tool.js +11 -2
package/README.md CHANGED
@@ -242,13 +242,18 @@ copilotkit login --json
242
242
  ```
243
243
 
244
244
  The command prints JSON lines for the sign-in URL, an instruction for the
245
- machine reader, and the final result. It does not open a browser. Every JSON
246
- login URL carries the `agent_onboarding` display hint because JSON mode is the
247
- machine-readable login contract. A machine reader should open the first
248
- `authentication_url` once with the operating system's default browser, then
249
- keep reading the same process until its terminal event. If the opener fails,
250
- show the URL for manual sign-in instead of retrying it. A failed sign-in prints
251
- one final failure object and exits nonzero.
245
+ machine reader, and the final result. Every JSON login URL carries the
246
+ `agent_onboarding` display hint because JSON mode is the machine-readable login
247
+ contract.
248
+
249
+ The command opens the page in the default browser itself when a browser can be
250
+ reached. It does not try on CI, over SSH, in a container, on Linux with no
251
+ display, or when `BROWSER=none` is set. A launcher that exits with an error counts
252
+ as not opened, and the CLI does not retry it. The `action_required` record says which
253
+ happened in `browser_opened`. When it is `false`, the machine reader shows the
254
+ URL for manual sign-in. Either way, it keeps reading the same process until its
255
+ terminal event. A failed sign-in prints one final failure object and exits
256
+ nonzero.
252
257
 
253
258
  After the CLI exchanges the browser token and saves its credentials, the
254
259
  agent-onboarding callback page tries to close the tab. If the browser blocks
@@ -342,8 +347,12 @@ frontend.
342
347
  Its first prompt records the coding agent with `onboard identify`, including when
343
348
  the entry command omitted `--coding-agent`. The agent also passes `--model` with
344
349
  the exact model id its instructions name, and leaves it out when they name none.
345
- The event records a missing id as `unknown`, and the coding agent the environment
346
- shows as `detected_coding_agent`. `cli.onboarding.started` also carries
350
+ It passes `--model-family` with its model family, such as `gpt-5`, for the agent
351
+ that cannot see its exact id. The event records a missing id or family as
352
+ `unknown`, and a value that is not a model, such as a coding-agent product name,
353
+ as `unreportable`. It records the coding agent the environment shows as
354
+ `detected_coding_agent`, and sets `coding_agent_mismatch` when that agent differs
355
+ from the declared one. `cli.onboarding.started` also carries
347
356
  `detected_coding_agent`, because a run that stops before `onboard identify` sends
348
357
  no identify event. Channel setup stage events include
349
358
  the existing `onboarding_run_id` when the command runs inside an onboarding run;
@@ -1200,7 +1209,9 @@ records a thread, which is why it is opt-in rather than part of the bare command
1200
1209
  `user-not-identified` is reported as `UNKNOWN` rather than `FAIL`. `identifyUser`
1201
1210
  is the project's own code and usually reads a signed-in session, which a CLI
1202
1211
  request does not carry, so an auth-gated app refusing it is that app working
1203
- correctly. Pass what it reads with `--header`, repeatable.
1212
+ correctly. Pass what it reads with `--header`, repeatable. `verify` sends
1213
+ the header on every request to the runtime, `/info` included, so a runtime
1214
+ behind auth needs no local proxy.
1204
1215
 
1205
1216
  ### What `verify` still does not prove
1206
1217
 
@@ -1290,8 +1301,11 @@ project record, it writes nothing and exits non-zero.
1290
1301
 
1291
1302
  An onboarding run protects the record once it selects the project. When the
1292
1303
  bound run protects it, the command moves that baseline with its own write, so
1293
- the next `onboard audit` still passes. It refuses a record that changed since
1294
- the baseline, so a write it did not make is never absorbed.
1304
+ the next `onboard audit` still passes. If only the record's `runtimeUrl`
1305
+ changed since the baseline, for example by a hand edit after the port moved,
1306
+ the command replaces that URL and settles the record. It refuses any other
1307
+ change, so a write it did not make is never absorbed. Once the record is
1308
+ protected, no other `onboard protect` route accepts a change to it.
1295
1309
 
1296
1310
  ### A model key has no credits or is rejected
1297
1311
 
@@ -2,20 +2,20 @@
2
2
  "schemaVersion": 1,
3
3
  "package": {
4
4
  "name": "copilotkit",
5
- "version": "4.18.0"
5
+ "version": "4.20.0"
6
6
  },
7
7
  "intelligence": {
8
- "commit": "3a9266b5fa673a4974ad204d131ed63d5696dc00"
8
+ "commit": "2dd0ade2a238b05e4b84b6317a929b679a6f21fe"
9
9
  },
10
10
  "copilotKit": {
11
- "submittedInput": "70d1f3c0a832",
12
- "commit": "70d1f3c0a832d6274e2fe710e24102f6429f14f4"
11
+ "submittedInput": "24c969848df0",
12
+ "commit": "24c969848df0b217144a93a58dcc3564bffa26ee"
13
13
  },
14
14
  "channel": "production",
15
15
  "triggeringActor": "BenTaylorDev",
16
16
  "workflow": {
17
- "runId": "36480955998",
18
- "runUrl": "https://github.com/CopilotKit/Intelligence/actions/runs/36480955998"
17
+ "runId": "36644626933",
18
+ "runUrl": "https://github.com/CopilotKit/Intelligence/actions/runs/36644626933"
19
19
  },
20
20
  "validationResult": "passed",
21
21
  "ag2": {
@@ -24,5 +24,5 @@
24
24
  "revision": "main",
25
25
  "pinned": false
26
26
  },
27
- "builtAt": "2026-09-28T20:43:08Z"
27
+ "builtAt": "2026-09-29T23:21:50Z"
28
28
  }