copilotkit 4.13.0 → 4.13.1

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/cli-build-info.json +8 -8
  2. package/index.js +607 -257
  3. package/onboarding/index.json +1 -1
  4. package/onboarding/prompts/authenticate/start.md +7 -7
  5. package/onboarding/prompts/conversion/plan.md +3 -3
  6. package/onboarding/prompts/credentials/finalize-plan.md +9 -8
  7. package/onboarding/prompts/credentials/plan.md +21 -21
  8. package/onboarding/prompts/credentials/settle-credentials.md +8 -8
  9. package/onboarding/prompts/credentials/write-plan.md +5 -5
  10. package/onboarding/prompts/fallback/best-effort.md +6 -6
  11. package/onboarding/prompts/feature/a2ui/implement.md +6 -6
  12. package/onboarding/prompts/feature/a2ui/proof.md +6 -6
  13. package/onboarding/prompts/feature/a2ui/start.md +7 -7
  14. package/onboarding/prompts/feature/channels/implement.md +15 -7
  15. package/onboarding/prompts/feature/channels/proof.md +6 -6
  16. package/onboarding/prompts/feature/channels/start.md +7 -7
  17. package/onboarding/prompts/feature/chat-suggestions/implement.md +6 -6
  18. package/onboarding/prompts/feature/chat-suggestions/proof.md +6 -6
  19. package/onboarding/prompts/feature/chat-suggestions/start.md +7 -7
  20. package/onboarding/prompts/feature/complete.md +1 -1
  21. package/onboarding/prompts/feature/learning/implement.md +15 -15
  22. package/onboarding/prompts/feature/learning/proof.md +7 -7
  23. package/onboarding/prompts/feature/learning/start.md +8 -8
  24. package/onboarding/prompts/feature/open-generative-ui/implement.md +6 -6
  25. package/onboarding/prompts/feature/open-generative-ui/proof.md +6 -6
  26. package/onboarding/prompts/feature/open-generative-ui/start.md +7 -7
  27. package/onboarding/prompts/feature/realtime-sync/implement.md +7 -7
  28. package/onboarding/prompts/feature/realtime-sync/proof.md +6 -6
  29. package/onboarding/prompts/feature/realtime-sync/start.md +6 -6
  30. package/onboarding/prompts/feature/rich-threads/implement.md +8 -8
  31. package/onboarding/prompts/feature/rich-threads/proof.md +6 -6
  32. package/onboarding/prompts/feature/rich-threads/start.md +6 -6
  33. package/onboarding/prompts/feature/stop.md +2 -2
  34. package/onboarding/prompts/feature/voice/implement.md +6 -6
  35. package/onboarding/prompts/feature/voice/proof.md +6 -6
  36. package/onboarding/prompts/feature/voice/start.md +7 -7
  37. package/onboarding/prompts/framework/ag2.md +2 -2
  38. package/onboarding/prompts/framework/agno.md +2 -2
  39. package/onboarding/prompts/framework/built-in.md +2 -2
  40. package/onboarding/prompts/framework/claude-sdk-python.md +2 -2
  41. package/onboarding/prompts/framework/claude-sdk-typescript.md +2 -2
  42. package/onboarding/prompts/framework/crewai-flows.md +2 -2
  43. package/onboarding/prompts/framework/deep-agents.md +2 -2
  44. package/onboarding/prompts/framework/google-adk.md +2 -2
  45. package/onboarding/prompts/framework/langgraph-fastapi.md +2 -2
  46. package/onboarding/prompts/framework/langgraph-python.md +2 -2
  47. package/onboarding/prompts/framework/langgraph-typescript.md +2 -2
  48. package/onboarding/prompts/framework/llamaindex.md +2 -2
  49. package/onboarding/prompts/framework/mastra.md +2 -2
  50. package/onboarding/prompts/framework/ms-agent-dotnet.md +2 -2
  51. package/onboarding/prompts/framework/ms-agent-harness-dotnet.md +2 -2
  52. package/onboarding/prompts/framework/ms-agent-python.md +2 -2
  53. package/onboarding/prompts/framework/pydantic-ai.md +2 -2
  54. package/onboarding/prompts/framework/strands-python.md +2 -2
  55. package/onboarding/prompts/framework/strands-typescript.md +2 -2
  56. package/onboarding/prompts/frontend/angular.md +3 -3
  57. package/onboarding/prompts/frontend/nextjs.md +3 -3
  58. package/onboarding/prompts/frontend/plan.md +7 -7
  59. package/onboarding/prompts/frontend/react-native.md +2 -2
  60. package/onboarding/prompts/frontend/react-spa.md +2 -2
  61. package/onboarding/prompts/frontend/vue.md +2 -2
  62. package/onboarding/prompts/implementation/build-and-validate.md +15 -15
  63. package/onboarding/prompts/proof/complete.md +8 -8
  64. package/onboarding/prompts/proof/oss-baseline.md +5 -5
  65. package/onboarding/prompts/proof/round-trip.md +10 -10
  66. package/onboarding/prompts/research/gather.md +5 -5
  67. package/onboarding/prompts/research/merge.md +3 -3
  68. package/onboarding/prompts/research/preflight.md +4 -4
  69. package/onboarding/prompts/research/route.md +7 -7
  70. package/onboarding/prompts/starter/clone.md +5 -5
  71. package/onboarding/prompts/stopped/run-failed.md +2 -2
  72. package/onboarding/prompts/subagent/create-plan.md +1 -1
  73. package/onboarding/prompts/subagent/implement-and-validate.md +7 -0
  74. package/onboarding/prompts/subagent/inspect-repository.md +1 -1
  75. package/onboarding/prompts/subagent/prove-oss-baseline.md +1 -1
  76. package/onboarding/prompts/subagent/prove-round-trip.md +7 -7
  77. package/onboarding/prompts/unsupported/no-validated-path.md +2 -2
  78. package/package.json +1 -1
  79. package/release/release-tool.js +101 -1
@@ -145,7 +145,7 @@ IPv6 only, so an IPv4 literal fails against the correct port.
145
145
  ## Step 4 -- Check the wiring
146
146
 
147
147
  With both running, check the wiring in one command before you open a browser:
148
- `npx --yes copilotkit@4.13.0 verify --json`. It reads the port from this project, so a
148
+ `npx --yes copilotkit@4.13.1 verify --json`. It reads the port from this project, so a
149
149
  non-default port needs no flag. The payload reports `runtimeUrl` and `runtimeUrlSource`. A
150
150
  `runtimeUrlSource` of `default` means nothing in the project named a port, so pass
151
151
  `--runtime-url` with the URL from step 1 in that case. Read the individual checks rather than
@@ -179,7 +179,7 @@ named no port the CLI can read: keep step 2's URL, and rewrite its host as `loca
179
179
  before you use it.
180
180
 
181
181
  Then run the command once more with the URL you are about to open:
182
- `npx --yes copilotkit@4.13.0 verify --frontend-url <that url> --json`. The
182
+ `npx --yes copilotkit@4.13.1 verify --frontend-url <that url> --json`. The
183
183
  `frontend_assets_served` check asks that server for its page and for one of the page's own
184
184
  assets, on that exact host. A `fail` there means the dev server refuses its own static
185
185
  assets on the host you were about to use, and the check names the URL to use instead. This
@@ -187,7 +187,7 @@ is the cheapest step that can save the most expensive one, so run it before the
187
187
 
188
188
  ## Step 5 -- Prove that the agent runs
189
189
 
190
- Run `npx --yes copilotkit@4.13.0 verify --round-trip --json`. It sends one request through
190
+ Run `npx --yes copilotkit@4.13.1 verify --round-trip --json`. It sends one request through
191
191
  the runtime and reads the answer back from the thread, so it separates an agent that is
192
192
  configured from an agent that works. Use `--agent <id>` when the runtime declares more
193
193
  than one. If it reports `user-not-identified`, this project's `identifyUser` reads a
@@ -200,7 +200,7 @@ Where this run settled a Learning Container, add the flag to the call above rath
200
200
  running a second round trip:
201
201
 
202
202
  ```text
203
- npx --yes copilotkit@4.13.0 verify --round-trip --expect-learning-container <container id> --json
203
+ npx --yes copilotkit@4.13.1 verify --round-trip --expect-learning-container <container id> --json
204
204
  ```
205
205
 
206
206
  The check reads the thread that this run created, so a second round trip proves a second
@@ -234,7 +234,7 @@ the credential was written holds an empty key while the file beside it carries t
234
234
  one. Run this from the target app directory:
235
235
 
236
236
  ```text
237
- npx --yes copilotkit@4.13.0 onboard env-staleness
237
+ npx --yes copilotkit@4.13.1 onboard env-staleness
238
238
  ```
239
239
 
240
240
  A `stale` line names the env file and how long after launch it was written. Report that,
@@ -312,7 +312,7 @@ For a recorded `both-oss` starting state, this step has no component to render.
312
312
  same request the baseline recorded, require the same kind of user-visible result the
313
313
  baseline produced, and require that the thread for that request is listed in the drawer.
314
314
  Where this journey's frontend framework ships no threads drawer -- React Native --, prove
315
- that thread with `npx --yes copilotkit@4.13.0 verify --round-trip`, which reads the
315
+ that thread with `npx --yes copilotkit@4.13.1 verify --round-trip`, which reads the
316
316
  answer back off the thread and needs no browser. Record which of the two you proved.
317
317
 
318
318
  Use the surface control the main coding agent recorded for your environment. It either had
@@ -340,7 +340,7 @@ request never exercises. Drive it with the browser control step 6 named.
340
340
  the page to finish loading. Do not retype the host, and do not substitute a URL a tool
341
341
  offers you by default. Where the page loads but its styling is missing or the chat
342
342
  control is dead, run
343
- `npx --yes copilotkit@4.13.0 verify --frontend-url <the url you opened> --json`
343
+ `npx --yes copilotkit@4.13.1 verify --frontend-url <the url you opened> --json`
344
344
  before you diagnose anything else. A dev server can serve its page and refuse every
345
345
  static chunk behind it, and on screen that is indistinguishable from a broken
346
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.13.0 onboard read fallback/best-effort`.
33
+ `npx --yes copilotkit@4.13.1 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.13.0 onboard friction --phase stop --category <slug>
39
+ npx --yes copilotkit@4.13.1 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,6 +1,6 @@
1
1
  {
2
2
  "name": "copilotkit",
3
- "version": "4.13.0",
3
+ "version": "4.13.1",
4
4
  "type": "module",
5
5
  "engines": {
6
6
  "node": ">=20.9.0"
@@ -14696,9 +14696,109 @@ import * as fs4 from "node:fs";
14696
14696
  import * as os2 from "node:os";
14697
14697
  import * as path4 from "node:path";
14698
14698
 
14699
+ // libs/feature-flags/src/registry.ts
14700
+ function defineFlags(defs) {
14701
+ return Object.fromEntries(
14702
+ Object.entries(defs).map(([key, body]) => [key, { ...body, key }])
14703
+ );
14704
+ }
14705
+ var FLAG_DEFINITIONS = defineFlags({
14706
+ // Ops can auto-deploy before App API, including in staging. Keep issuance
14707
+ // off in every environment until all verifiers accept this signed claim.
14708
+ "cli.organization-slug": {
14709
+ purpose: "Include the Clerk organization slug in CLI product credentials after App API rollout.",
14710
+ owner: "platform",
14711
+ createdAt: "2026-09-17",
14712
+ status: "rollout",
14713
+ surfaces: ["ops-api"],
14714
+ defaultByEnv: { dev: false, ci: false, prod: false },
14715
+ envVar: "OPS_CLI_ORGANIZATION_SLUG_ENABLED"
14716
+ },
14717
+ // Self-hosted is a seam, not an offered choice yet (PE-94): the target moves
14718
+ // only the app API URL, and no onboarding path offers it. Keep released
14719
+ // binaries on managed until a self-hosted deployment can serve the product.
14720
+ "cli.self-hosted-deployment": {
14721
+ purpose: "Lets the CLI target a self-hosted Intelligence deployment through --deployment or COPILOTKIT_DEPLOYMENT.",
14722
+ owner: "platform",
14723
+ createdAt: "2026-09-22",
14724
+ status: "rollout",
14725
+ surfaces: ["cli"],
14726
+ defaultByEnv: { dev: true, ci: true, prod: false }
14727
+ },
14728
+ "threads.bounded-replay": {
14729
+ purpose: "Stage connect history on disk and require SDK acknowledgements for bounded delivery.",
14730
+ owner: "realtime",
14731
+ createdAt: "2026-09-16",
14732
+ status: "rollout",
14733
+ surfaces: ["realtime-gateway", "copilotkit-core"],
14734
+ defaultByEnv: { dev: true, ci: true, prod: false },
14735
+ envVar: "REALTIME_GATEWAY_BOUNDED_REPLAY_ENABLED"
14736
+ },
14737
+ // `active` (not `rollout`): a long-lived operational kill-switch, default-on
14738
+ // in every env; `envVar` adopts the pre-existing INSPECT_ROUTES_ENABLED name.
14739
+ "inspect.routes": {
14740
+ purpose: "Gates the /api/_inspect/* introspection routes used by the web inspector; operational kill-switch.",
14741
+ owner: "platform",
14742
+ createdAt: "2026-06-23",
14743
+ status: "active",
14744
+ surfaces: ["app-api"],
14745
+ defaultByEnv: { dev: true, ci: true, prod: true },
14746
+ envVar: "INSPECT_ROUTES_ENABLED"
14747
+ },
14748
+ // Rollout flag for the in-progress Channels feature (OSS-373). Lets the
14749
+ // SDK, UI, and infra land incrementally and deploy dark; production stays off
14750
+ // until the rollout completes and the prod default is flipped in a later
14751
+ // build. Server boundaries enforce it via the shared `resolveChannelsRollout`
14752
+ // helper; `envVar` pins the pre-existing FF_MANAGED_BOTS toggle name so the
14753
+ // operational override is byte-identical across the rename.
14754
+ channels: {
14755
+ purpose: "Gates the Channels feature (activation, listener, delivery, egress) so unfinished customer behavior stays dark until rollout completes.",
14756
+ owner: "channels",
14757
+ createdAt: "2026-06-25",
14758
+ status: "rollout",
14759
+ surfaces: ["app-api", "realtime-gateway", "app-frontend"],
14760
+ defaultByEnv: { dev: true, ci: true, prod: false },
14761
+ envVar: "FF_MANAGED_BOTS"
14762
+ },
14763
+ "managed-channels": {
14764
+ purpose: "Canonical Managed Channels rollout gate, evaluated alongside the legacy FF_MANAGED_BOTS override while deployments migrate.",
14765
+ owner: "channels",
14766
+ createdAt: "2026-07-09",
14767
+ status: "rollout",
14768
+ surfaces: ["app-api", "realtime-gateway", "app-frontend"],
14769
+ defaultByEnv: { dev: true, ci: true, prod: true }
14770
+ },
14771
+ "learning.platform-v1": {
14772
+ purpose: "Gates the Learning V1 control API, runtime workers, product UI, and CLI download while the platform rolls out.",
14773
+ owner: "learning",
14774
+ createdAt: "2026-08-06",
14775
+ status: "rollout",
14776
+ surfaces: ["app-api", "app-frontend", "cli"],
14777
+ defaultByEnv: { dev: false, ci: false, prod: false },
14778
+ envVar: "LEARNING_ENABLED"
14779
+ },
14780
+ "analytics.pipeline": {
14781
+ purpose: "Gates project-scoped analytics reads and realtime projection while the durable pipeline rolls out.",
14782
+ owner: "analytics",
14783
+ createdAt: "2026-08-16",
14784
+ status: "rollout",
14785
+ surfaces: ["app-api", "realtime-gateway"],
14786
+ defaultByEnv: { dev: false, ci: false, prod: false },
14787
+ envVar: "ANALYTICS_ENABLED"
14788
+ },
14789
+ "ops.stripe-billing-v1": {
14790
+ purpose: "Gates the direct Stripe Checkout, Portal, projection, and provider-aware billing API during rollout.",
14791
+ owner: "ops",
14792
+ createdAt: "2026-09-08",
14793
+ status: "rollout",
14794
+ surfaces: ["ops-api"],
14795
+ defaultByEnv: { dev: true, ci: true, prod: false }
14796
+ }
14797
+ });
14798
+
14699
14799
  // apps/cli/src/config.ts
14700
14800
  function getTemplateRef() {
14701
- return true ? "1e13b4945b44c6afa2e398a0c9935415d4aa7577" : "main";
14801
+ return true ? "f8047217b909a3e18404034f31f47157c4312241" : "main";
14702
14802
  }
14703
14803
 
14704
14804
  // apps/cli/src/services/agentcore-config.ts