copilotkit 4.20.0 → 4.21.0

package/README.md

@@ -1545,3 +1545,31 @@ copilotkit import --source langgraph --langgraph-snapshot native.jsonl \
 The destination frontend must register that catalog. This option works with all import sources and applies to every selected conversation; import applications with different defaults separately. Explicit native `catalogId` values and native A2UI operation payloads take precedence. Native tool arguments/results are preserved; the setting only controls reconstructed UI. Without the option, existing replay behavior is unchanged. Invalid empty/whitespace identifiers fail before upload. No catalog is inferred from message prose.
 
 API callers can set `replayConfig: { defaultCatalogId: "copilotkit://app-dashboard-catalog" }` on each normalized conversation. An unchanged source identity is still deduplicated: changing this option does not update an existing import. Use the existing `--replace` workflow to regenerate its imported history, after accounting for any destination changes.
+
+## Claude Managed Agents starter
+
+```bash
+copilotkit init --template claude-managed-agents
+```
+
+The command clones the Claude Managed Agents starter from CopilotKit, creates a Learning Container and runtime key in the selected Intelligence project, installs dependencies, and provisions the Anthropic agent and environment with Ant. The frontend contains the SDK thread drawer and CopilotChat with the Beautiful Chat styles. The Inspector uses the SDK defaults and is available during local development. The generated README covers daily development and links to the component docs. A separate `REFERENCE.md` covers configuration and deployment. New threads bind to the Learning Container; the starter fetches published Skill files through the Intelligence SDK, uploads them to Anthropic, and pins their native versions for each new session. Existing sessions retain their skills.
+
+Requires Node.js 20.19+, Git, npm, Ant, Intelligence Learning access, and a Claude Console workspace with Managed Agents access and credits. Ant owns and refreshes its OAuth credentials; the CLI never copies them into the app. The project runtime key, container ID, and local app-user ID go into gitignored `.env.local` with private file permissions.
+
+Interactive setup asks for the app directory, opens Intelligence login when needed, and uses the existing project picker to select or create a project. If Ant is missing, setup offers to install it with Homebrew or Go when either is available. Otherwise it prints both installation methods and the [Ant installation guide](https://github.com/anthropics/anthropic-cli#installation). Installation must finish with Ant available on `PATH`. Setup opens Ant login when needed and asks before starting the dev server. Between prompts, setup stops reading terminal input so Ant and npm can receive input and Ctrl-C.
+
+Pass `--name my-app` to name the directory, `--project <slug>` to select a project, or `--create "Project name"` to create one. Use `--profile work` for an Ant profile, `--no-dev` to skip the dev-server offer, and `--skip-install` (or `--no-install`) to install app dependencies yourself. The destination must be a new child directory. `copilotkit with-claude [directory]` opens the same setup flow.
+
+For automation, sign in to both services first, then run:
+
+```bash
+copilotkit init --template claude-managed-agents --name my-app --project your-project-slug --yes
+```
+
+With `--yes` or no terminal, setup never opens prompts, installs Ant, or starts the dev server. It requires existing logins and Ant on `PATH`. Without project flags it uses the current directory's selected Intelligence project; without a name it uses `my-claude-app`.
+
+A failed install leaves the configured app in place: run `npm install`, then `npm run agent:apply`, then `npm run dev` there. Failed Ant provisioning can be retried with `npm run agent:apply`. Neither failure prints Ready. A Learning or key error stops setup and reports the remaining step; remote resources are not deleted automatically.
+
+The starter listens on localhost and uses one local developer identity. Before deployment, add verified user authentication, request limits, and durable Managed Agents session mappings. Intelligence thread storage does not replace that adapter mapping.
+
+Release ordering: merge the CopilotKit starter before releasing this command. The shared starter catalog includes `examples/integrations/claude-managed-agents`, so the release source gate rejects a template revision that omits it. The command uses the build-pinned CopilotKit revision, like the existing starters.

package/cli-build-info.json

@@ -2,20 +2,20 @@
   "schemaVersion": 1,
   "package": {
     "name": "copilotkit",
-    "version": "4.20.0"
+    "version": "4.21.0"
   },
   "intelligence": {
-    "commit": "2dd0ade2a238b05e4b84b6317a929b679a6f21fe"
+    "commit": "83dc327eb0243ab1d5a74b9fd1496b9f8679d3df"
   },
   "copilotKit": {
-    "submittedInput": "24c969848df0",
-    "commit": "24c969848df0b217144a93a58dcc3564bffa26ee"
+    "submittedInput": "3dc45f8bdca6665af9b4cc5cecfbcb8ab057e426",
+    "commit": "3dc45f8bdca6665af9b4cc5cecfbcb8ab057e426"
   },
   "channel": "production",
-  "triggeringActor": "BenTaylorDev",
+  "triggeringActor": "MikeRyanDev",
   "workflow": {
-    "runId": "36644626933",
-    "runUrl": "https://github.com/CopilotKit/Intelligence/actions/runs/36644626933"
+    "runId": "36646329163",
+    "runUrl": "https://github.com/CopilotKit/Intelligence/actions/runs/36646329163"
   },
   "validationResult": "passed",
   "ag2": {
@@ -24,5 +24,5 @@
     "revision": "main",
     "pinned": false
   },
-  "builtAt": "2026-09-29T23:21:50Z"
+  "builtAt": "2026-09-29T23:41:18Z"
 }