copilotkit 4.12.0 → 4.13.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 (80) hide show
  1. package/README.md +10 -0
  2. package/cli-build-info.json +8 -8
  3. package/index.js +1015 -123
  4. package/onboarding/index.json +20 -2
  5. package/onboarding/prompts/authenticate/start.md +38 -33
  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 +26 -20
  9. package/onboarding/prompts/credentials/settle-credentials.md +8 -8
  10. package/onboarding/prompts/credentials/write-plan.md +19 -6
  11. package/onboarding/prompts/fallback/best-effort.md +6 -6
  12. package/onboarding/prompts/feature/a2ui/implement.md +6 -6
  13. package/onboarding/prompts/feature/a2ui/proof.md +6 -6
  14. package/onboarding/prompts/feature/a2ui/start.md +7 -7
  15. package/onboarding/prompts/feature/channels/implement.md +67 -12
  16. package/onboarding/prompts/feature/channels/proof.md +13 -6
  17. package/onboarding/prompts/feature/channels/start.md +27 -10
  18. package/onboarding/prompts/feature/chat-suggestions/implement.md +6 -6
  19. package/onboarding/prompts/feature/chat-suggestions/proof.md +6 -6
  20. package/onboarding/prompts/feature/chat-suggestions/start.md +7 -7
  21. package/onboarding/prompts/feature/complete.md +1 -1
  22. package/onboarding/prompts/feature/learning/implement.md +15 -15
  23. package/onboarding/prompts/feature/learning/proof.md +7 -7
  24. package/onboarding/prompts/feature/learning/start.md +8 -8
  25. package/onboarding/prompts/feature/open-generative-ui/implement.md +6 -6
  26. package/onboarding/prompts/feature/open-generative-ui/proof.md +6 -6
  27. package/onboarding/prompts/feature/open-generative-ui/start.md +7 -7
  28. package/onboarding/prompts/feature/realtime-sync/implement.md +7 -7
  29. package/onboarding/prompts/feature/realtime-sync/proof.md +6 -6
  30. package/onboarding/prompts/feature/realtime-sync/start.md +6 -6
  31. package/onboarding/prompts/feature/rich-threads/implement.md +8 -8
  32. package/onboarding/prompts/feature/rich-threads/proof.md +6 -6
  33. package/onboarding/prompts/feature/rich-threads/start.md +6 -6
  34. package/onboarding/prompts/feature/stop.md +2 -2
  35. package/onboarding/prompts/feature/voice/implement.md +6 -6
  36. package/onboarding/prompts/feature/voice/proof.md +6 -6
  37. package/onboarding/prompts/feature/voice/start.md +7 -7
  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 +4 -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 +5 -2
  45. package/onboarding/prompts/framework/google-adk.md +4 -2
  46. package/onboarding/prompts/framework/langgraph-fastapi.md +4 -3
  47. package/onboarding/prompts/framework/langgraph-python.md +6 -2
  48. package/onboarding/prompts/framework/langgraph-typescript.md +6 -2
  49. package/onboarding/prompts/framework/llamaindex.md +2 -2
  50. package/onboarding/prompts/framework/mastra.md +4 -2
  51. package/onboarding/prompts/framework/ms-agent-dotnet.md +4 -2
  52. package/onboarding/prompts/framework/ms-agent-harness-dotnet.md +2 -2
  53. package/onboarding/prompts/framework/ms-agent-python.md +4 -2
  54. package/onboarding/prompts/framework/pydantic-ai.md +2 -2
  55. package/onboarding/prompts/framework/strands-python.md +4 -2
  56. package/onboarding/prompts/framework/strands-typescript.md +4 -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 +21 -10
  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 +33 -15
  64. package/onboarding/prompts/proof/complete.md +35 -16
  65. package/onboarding/prompts/proof/oss-baseline.md +5 -5
  66. package/onboarding/prompts/proof/round-trip.md +23 -12
  67. package/onboarding/prompts/research/gather.md +12 -102
  68. package/onboarding/prompts/research/merge.md +60 -0
  69. package/onboarding/prompts/research/preflight.md +75 -0
  70. package/onboarding/prompts/research/route.md +28 -4
  71. package/onboarding/prompts/starter/clone.md +5 -5
  72. package/onboarding/prompts/stopped/run-failed.md +2 -2
  73. package/onboarding/prompts/subagent/create-plan.md +18 -1
  74. package/onboarding/prompts/subagent/implement-and-validate.md +30 -0
  75. package/onboarding/prompts/subagent/inspect-repository.md +1 -1
  76. package/onboarding/prompts/subagent/prove-oss-baseline.md +1 -1
  77. package/onboarding/prompts/subagent/prove-round-trip.md +17 -7
  78. package/onboarding/prompts/unsupported/no-validated-path.md +2 -2
  79. package/package.json +4 -1
  80. package/release/release-tool.js +1 -1
@@ -19,7 +19,7 @@ Prove the live runtime in this order:
19
19
  4. Confirm from project files that the runtime constructor passes a `runner` option rather
20
20
  than an `intelligence` option. A package, import, project file, or key is not use proof.
21
21
  5. Run
22
- `npx --yes copilotkit@4.12.0 verify --expect-runtime oss --round-trip --agent <expected-agent-id> --json`,
22
+ `npx --yes copilotkit@4.13.0 verify --expect-runtime oss --round-trip --agent <expected-agent-id> --json`,
23
23
  with the runtime URL or auth header options that this project needs. Require exit zero
24
24
  and the JSON `ok` field to be `true`.
25
25
  6. Drive one real request through the existing frontend, CopilotKit runtime, and expected
@@ -9,6 +9,16 @@ You can make only operational repairs to project-owned processes, ports, and req
9
9
  Do not write a path that overlaps a protected path. If a required proof or tool path
10
10
  overlaps one, return `Status: blocked` before writing it.
11
11
 
12
+ The existing agent's behavior is outside every step of this proof. It is four things: the
13
+ agent's system prompt and instructions, its tools and what those tools do, its model and
14
+ provider configuration, and its memory or state handling. A failing predicate is repaired
15
+ on the CopilotKit side -- the frontend rendering, the tool schema, the runtime wiring.
16
+ Where the only fix you can find is a change to the agent's instructions or tools, stop and
17
+ return the failing predicate with the change you propose, for the developer to approve.
18
+ Such a change is a behavior change rather than a repair: it changes how the agent answers
19
+ everywhere, not only in CopilotKit. Never rewrite the agent's prompt to make a component
20
+ render, and never report a round trip proved by a prompt this run rewrote.
21
+
12
22
  Run the steps below in the order they appear. They are the proof. Do not design a
13
23
  different sequence of your own, and do not drop a step because an earlier one looked
14
24
  convincing. Step 6 has a web form and a React Native form: run the one that matches this
@@ -135,7 +145,7 @@ IPv6 only, so an IPv4 literal fails against the correct port.
135
145
  ## Step 4 -- Check the wiring
136
146
 
137
147
  With both running, check the wiring in one command before you open a browser:
138
- `npx --yes copilotkit@4.12.0 verify --json`. It reads the port from this project, so a
148
+ `npx --yes copilotkit@4.13.0 verify --json`. It reads the port from this project, so a
139
149
  non-default port needs no flag. The payload reports `runtimeUrl` and `runtimeUrlSource`. A
140
150
  `runtimeUrlSource` of `default` means nothing in the project named a port, so pass
141
151
  `--runtime-url` with the URL from step 1 in that case. Read the individual checks rather than
@@ -169,7 +179,7 @@ named no port the CLI can read: keep step 2's URL, and rewrite its host as `loca
169
179
  before you use it.
170
180
 
171
181
  Then run the command once more with the URL you are about to open:
172
- `npx --yes copilotkit@4.12.0 verify --frontend-url <that url> --json`. The
182
+ `npx --yes copilotkit@4.13.0 verify --frontend-url <that url> --json`. The
173
183
  `frontend_assets_served` check asks that server for its page and for one of the page's own
174
184
  assets, on that exact host. A `fail` there means the dev server refuses its own static
175
185
  assets on the host you were about to use, and the check names the URL to use instead. This
@@ -177,7 +187,7 @@ is the cheapest step that can save the most expensive one, so run it before the
177
187
 
178
188
  ## Step 5 -- Prove that the agent runs
179
189
 
180
- Run `npx --yes copilotkit@4.12.0 verify --round-trip --json`. It sends one request through
190
+ Run `npx --yes copilotkit@4.13.0 verify --round-trip --json`. It sends one request through
181
191
  the runtime and reads the answer back from the thread, so it separates an agent that is
182
192
  configured from an agent that works. Use `--agent <id>` when the runtime declares more
183
193
  than one. If it reports `user-not-identified`, this project's `identifyUser` reads a
@@ -190,7 +200,7 @@ Where this run settled a Learning Container, add the flag to the call above rath
190
200
  running a second round trip:
191
201
 
192
202
  ```text
193
- npx --yes copilotkit@4.12.0 verify --round-trip --expect-learning-container <container id> --json
203
+ npx --yes copilotkit@4.13.0 verify --round-trip --expect-learning-container <container id> --json
194
204
  ```
195
205
 
196
206
  The check reads the thread that this run created, so a second round trip proves a second
@@ -224,7 +234,7 @@ the credential was written holds an empty key while the file beside it carries t
224
234
  one. Run this from the target app directory:
225
235
 
226
236
  ```text
227
- npx --yes copilotkit@4.12.0 onboard env-staleness
237
+ npx --yes copilotkit@4.13.0 onboard env-staleness
228
238
  ```
229
239
 
230
240
  A `stale` line names the env file and how long after launch it was written. Report that,
@@ -302,7 +312,7 @@ For a recorded `both-oss` starting state, this step has no component to render.
302
312
  same request the baseline recorded, require the same kind of user-visible result the
303
313
  baseline produced, and require that the thread for that request is listed in the drawer.
304
314
  Where this journey's frontend framework ships no threads drawer -- React Native --, prove
305
- that thread with `npx --yes copilotkit@4.12.0 verify --round-trip`, which reads the
315
+ that thread with `npx --yes copilotkit@4.13.0 verify --round-trip`, which reads the
306
316
  answer back off the thread and needs no browser. Record which of the two you proved.
307
317
 
308
318
  Use the surface control the main coding agent recorded for your environment. It either had
@@ -330,7 +340,7 @@ request never exercises. Drive it with the browser control step 6 named.
330
340
  the page to finish loading. Do not retype the host, and do not substitute a URL a tool
331
341
  offers you by default. Where the page loads but its styling is missing or the chat
332
342
  control is dead, run
333
- `npx --yes copilotkit@4.12.0 verify --frontend-url <the url you opened> --json`
343
+ `npx --yes copilotkit@4.13.0 verify --frontend-url <the url you opened> --json`
334
344
  before you diagnose anything else. A dev server can serve its page and refuse every
335
345
  static chunk behind it, and on screen that is indistinguishable from a broken
336
346
  integration. The `frontend_assets_served` check tells the two apart.
@@ -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.12.0 onboard read fallback/best-effort`.
33
+ `npx --yes copilotkit@4.13.0 onboard read fallback/best-effort`.
34
34
 
35
35
  Send one short report. Run the friction command without another developer question. Do not
36
36
  ask the developer about telemetry: the command applies the setting they already have.
37
37
 
38
38
  ```text
39
- npx --yes copilotkit@4.12.0 onboard friction --phase stop --category <slug>
39
+ npx --yes copilotkit@4.13.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
@@ -1,7 +1,10 @@
1
1
  {
2
2
  "name": "copilotkit",
3
- "version": "4.12.0",
3
+ "version": "4.13.0",
4
4
  "type": "module",
5
+ "engines": {
6
+ "node": ">=20.9.0"
7
+ },
5
8
  "repository": {
6
9
  "type": "git",
7
10
  "url": "git+https://github.com/CopilotKit/Intelligence.git",
@@ -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 ? "0048ba241fdf14a9036cdad11a4f31aa021a9c8d" : "main";
14701
+ return true ? "1e13b4945b44c6afa2e398a0c9935415d4aa7577" : "main";
14702
14702
  }
14703
14703
 
14704
14704
  // apps/cli/src/services/agentcore-config.ts