copilotkit 4.19.0 → 4.21.0

package/README.md

@@ -242,13 +242,18 @@ copilotkit login --json
 ```
 
 The command prints JSON lines for the sign-in URL, an instruction for the
-machine reader, and the final result. It does not open a browser. Every JSON
-login URL carries the `agent_onboarding` display hint because JSON mode is the
-machine-readable login contract. A machine reader should open the first
-`authentication_url` once with the operating system's default browser, then
-keep reading the same process until its terminal event. If the opener fails,
-show the URL for manual sign-in instead of retrying it. A failed sign-in prints
-one final failure object and exits nonzero.
+machine reader, and the final result. Every JSON login URL carries the
+`agent_onboarding` display hint because JSON mode is the machine-readable login
+contract.
+
+The command opens the page in the default browser itself when a browser can be
+reached. It does not try on CI, over SSH, in a container, on Linux with no
+display, or when `BROWSER=none` is set. A launcher that exits with an error counts
+as not opened, and the CLI does not retry it. The `action_required` record says which
+happened in `browser_opened`. When it is `false`, the machine reader shows the
+URL for manual sign-in. Either way, it keeps reading the same process until its
+terminal event. A failed sign-in prints one final failure object and exits
+nonzero.
 
 After the CLI exchanges the browser token and saves its credentials, the
 agent-onboarding callback page tries to close the tab. If the browser blocks
@@ -342,8 +347,12 @@ frontend.
 Its first prompt records the coding agent with `onboard identify`, including when
 the entry command omitted `--coding-agent`. The agent also passes `--model` with
 the exact model id its instructions name, and leaves it out when they name none.
-The event records a missing id as `unknown`, and the coding agent the environment
-shows as `detected_coding_agent`. `cli.onboarding.started` also carries
+It passes `--model-family` with its model family, such as `gpt-5`, for the agent
+that cannot see its exact id. The event records a missing id or family as
+`unknown`, and a value that is not a model, such as a coding-agent product name,
+as `unreportable`. It records the coding agent the environment shows as
+`detected_coding_agent`, and sets `coding_agent_mismatch` when that agent differs
+from the declared one. `cli.onboarding.started` also carries
 `detected_coding_agent`, because a run that stops before `onboard identify` sends
 no identify event. Channel setup stage events include
 the existing `onboarding_run_id` when the command runs inside an onboarding run;
@@ -1536,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.19.0"
+    "version": "4.21.0"
   },
   "intelligence": {
-    "commit": "76b87a74c7887974711242010d86136292a1d56f"
+    "commit": "83dc327eb0243ab1d5a74b9fd1496b9f8679d3df"
   },
   "copilotKit": {
-    "submittedInput": "bb299bd0e719",
-    "commit": "bb299bd0e71963c139b78c5bc9ac0bc0fd6d614f"
+    "submittedInput": "3dc45f8bdca6665af9b4cc5cecfbcb8ab057e426",
+    "commit": "3dc45f8bdca6665af9b4cc5cecfbcb8ab057e426"
   },
   "channel": "production",
-  "triggeringActor": "BenTaylorDev",
+  "triggeringActor": "MikeRyanDev",
   "workflow": {
-    "runId": "36608240272",
-    "runUrl": "https://github.com/CopilotKit/Intelligence/actions/runs/36608240272"
+    "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-29T17:56:39Z"
+  "builtAt": "2026-09-29T23:41:18Z"
 }