chainlesschain 0.166.0 → 0.166.2

package/src/commands/team.js

@@ -25,6 +25,7 @@ import { TeamWorktreeCoordinator } from "../lib/agent-team/team-worktree.js";
 import { TeamBudget } from "../lib/agent-team/team-budget.js";
 import { TeamMailbox } from "../lib/agent-team/team-mailbox.js";
 import { TeamAgentStreamParser } from "../lib/agent-team/team-agent-stream.js";
+import { TeamMessageBridge } from "../lib/agent-team/team-message-bridge.js";
 import { resolveTeamTaskContract } from "../lib/agent-team/team-task-contract.js";
 import {
   TeamScopeLock,
@@ -727,6 +728,7 @@ export function buildTeamAgentPrompt(prompt, { inbox = [] } = {}) {
   const messages = inbox
     .slice(-MAX_TEAM_AGENT_INBOX_MESSAGES)
     .map((message) => ({
+      id: Number.isSafeInteger(message?.id) ? message.id : null,
       from: String(message?.from || "unknown").slice(0, 128),
       to: String(message?.to || "").slice(0, 128),
       subject:
@@ -1016,7 +1018,7 @@ export function makeShellRunTask() {
 }
 
 /** Spawn a headless `cc agent -p` for one prompt in `cwd`; resolve on exit 0. */
-export function spawnAgent(prompt, cwd, opts = {}) {
+function spawnAgentProcess(prompt, cwd, opts = {}) {
   return new Promise((resolve, reject) => {
     const parser = new TeamAgentStreamParser({
       maxLineBytes: opts.maxStreamLineBytes,
@@ -1043,7 +1045,11 @@ export function spawnAgent(prompt, cwd, opts = {}) {
     try {
       child = _deps.spawn(process.execPath, args, {
         cwd,
-        env: { ...process.env, CLAUDECODE: "1" },
+        env: {
+          ...process.env,
+          CLAUDECODE: "1",
+          ...(opts.childEnv || {}),
+        },
         windowsHide: true,
         detached:
           opts.managedCheckpoint === true
@@ -1311,6 +1317,33 @@ export function spawnAgent(prompt, cwd, opts = {}) {
   });
 }
 
+export function spawnAgent(prompt, cwd, opts = {}) {
+  if (!opts.messageBridge) return spawnAgentProcess(prompt, cwd, opts);
+  return (async () => {
+    let bridge;
+    try {
+      bridge = new TeamMessageBridge(opts.messageBridge);
+      await bridge.start();
+    } catch (error) {
+      throw teamAgentError(
+        "TEAM_AGENT_MESSAGE_BRIDGE_FAILED",
+        error?.message || "Could not start teammate message bridge",
+      );
+    }
+    try {
+      return await spawnAgentProcess(bridge.decoratePrompt(prompt), cwd, {
+        ...opts,
+        childEnv: {
+          ...(opts.childEnv || {}),
+          ...bridge.childEnvironment(),
+        },
+      });
+    } finally {
+      await bridge.close();
+    }
+  })();
+}
+
 /** Real executor: hand a task's `prompt` to a headless `cc agent -p` in cwd. */
 function applyBudgetReservation(contract, budgetReservation) {
   const effectiveContract = { ...contract };
@@ -1333,7 +1366,12 @@ export function makeAgentRunTask(opts = {}) {
   return function runTask({
     key,
     task,
+    holder,
     inbox = [],
+    sendMessage = null,
+    messageAuthority = null,
+    recipientState = null,
+    mailbox = null,
     budgetReservation = null,
     signal = null,
   }) {
@@ -1359,6 +1397,19 @@ export function makeAgentRunTask(opts = {}) {
       ...effectiveContract,
       sessionId: opts.sessionIdForTask?.(key) || null,
       signal,
+      ...(mailbox && holder
+        ? {
+            messageBridge: {
+              mailbox,
+              holder,
+              sendMessage,
+              assertAuthority: messageAuthority,
+              recipientState,
+              onMutation: opts.onMailboxMutation,
+              durable: opts.mailboxDurable === true,
+            },
+          }
+        : {}),
     });
   };
 }
@@ -2661,8 +2712,13 @@ export function registerTeamCommand(program, { logger } = {}) {
               runInWorktree: async ({
                 key,
                 task,
+                holder,
                 cwd,
                 inbox = [],
+                sendMessage = null,
+                messageAuthority = null,
+                recipientState = null,
+                mailbox: taskMailbox = null,
                 budgetReservation = null,
                 signal = null,
                 managedCheckpoint = false,
@@ -2689,6 +2745,19 @@ export function registerTeamCommand(program, { logger } = {}) {
                     managedCheckpoint,
                     sessionId: collaborationUnits.get(key)?.sessionId,
                     signal,
+                    ...(taskMailbox && holder
+                      ? {
+                          messageBridge: {
+                            mailbox: taskMailbox,
+                            holder,
+                            sendMessage,
+                            assertAuthority: messageAuthority,
+                            recipientState,
+                            onMutation: persist,
+                            durable: Boolean(options.state),
+                          },
+                        }
+                      : {}),
                   },
                 );
               },
@@ -2709,6 +2778,8 @@ export function registerTeamCommand(program, { logger } = {}) {
             contractForTask: (key) => taskContracts.get(key),
             worktreeEnabled: false,
             sessionIdForTask: (key) => collaborationUnits.get(key)?.sessionId,
+            onMailboxMutation: persist,
+            mailboxDurable: Boolean(options.state),
           });
         else runTask = async () => ({ dryRun: true });
 
@@ -2797,6 +2868,7 @@ export function registerTeamCommand(program, { logger } = {}) {
             ? (task) => taskContracts.get(task.key)
             : () => ({ reserveUsage: false }),
           mailbox,
+          realtimeMessaging: options.agent === true,
           scopeLock,
           recorder,
           beforeTask: ({ key }) => {

package/src/data/changelog.json

@@ -1,6 +1,32 @@
 {
   "source": "CHANGELOG.md",
   "releases": [
+    {
+      "productVersion": null,
+      "cliVersion": "0.166.2",
+      "cliVersions": ["0.166.1", "0.166.2"],
+      "date": "2026-08-25",
+      "title": "",
+      "sections": [
+        {
+          "heading": "Added - cc CLI 0.166.2: lease-bound real-time team messaging",
+          "body": "> `chainlesschain` **0.166.1 -> 0.166.2** (CLI-only release candidate,\n> 2026-08-25). `@chainlesschain/agent-protocol` remains **0.1.1**,\n> `@chainlesschain/agent-sdk` remains **0.2.1**, and\n> `chainlesschain-agent-sdk` remains **0.2.1**.\n\n- **Live teammate tools**: real `cc team --agent` children receive host-owned\n  `team_send`, `team_receive`, `team_ack`, and `team_followup` tools over a\n  private local bridge instead of relying only on a startup inbox snapshot.\n- **Retry-safe delivery**: the bounded mailbox persists at-least-once delivery\n  receipts, stable-consumer ACKs, idempotent message keys, payload digests,\n  causation/correlation metadata, processed/dead-letter states, and monotonic\n  cursors across team-state restore.\n- **Attempt-scoped authority**: every bridge operation revalidates the current\n  holder, task, attempt, lease, and fencing token; stale attempts fail closed,\n  bridge credentials never enter the prompt, and nested subagents cannot\n  inherit the parent-bound tools.\n- **Honest durability and wake semantics**: `--state` checkpoints every bridge\n  mutation, runs without state declare process-local delivery, and follow-up\n  results distinguish an active target from a request queued for a future turn.\n- **Release validation**: publication requires this candidate's exact commit\n  to pass the complete Linux, Windows, and macOS `CLI CI` and\n  `CLI Strict Sandbox` matrices before an immutable npm tag is created."
+        }
+      ]
+    },
+    {
+      "productVersion": null,
+      "cliVersion": "0.166.1",
+      "cliVersions": ["0.1.1", "0.2.1", "0.166.0", "0.166.1"],
+      "date": "2026-08-24",
+      "title": "",
+      "sections": [
+        {
+          "heading": "Added - cc CLI 0.166.1 + Agent Protocol 0.1.1 + Agent SDKs 0.2.1: structured Graph execution",
+          "body": "> `chainlesschain` **0.166.0 -> 0.166.1**,\n> `@chainlesschain/agent-protocol` **0.1.0 -> 0.1.1**,\n> `@chainlesschain/agent-sdk` **0.2.0 -> 0.2.1**, and\n> `chainlesschain-agent-sdk` **0.2.0 -> 0.2.1** (release candidate,\n> 2026-08-24).\n\n- **Typed subgraphs with budget isolation**: subgraph calls now validate\n  parent/child input and output mappings before effects, reserve durable\n  per-call budget slices, prevent parallel oversubscription, and settle only\n  the child run's actual usage across completion, cancellation, and recovery.\n- **Effectful bounded loops**: loop effects receive deterministic\n  iteration-scoped idempotency keys and receipts. Compensation executes once\n  per committed iteration in reverse dependency/iteration order and resumes\n  safely after interruption or budget exhaustion.\n- **Graph migration and rollback**: the compiler includes a built-in v0-to-v1\n  upcaster, frozen minimal and typed N/N-1 corpora, immutable pre-migration\n  backups, domain-separated rollback digests, and tamper-evident restore.\n- **Cross-language delivery**: the canonical schema and generated TypeScript,\n  Python, Kotlin, and Swift bindings expose the new subgraph budget/mapping and\n  effect iteration lineage fields without adding SDK runtime dependencies.\n- **Release validation**: publication requires this exact release commit to\n  pass the complete Linux, Windows, and macOS `CLI CI`, `CLI Strict Sandbox`,\n  and Agent Protocol matrices plus Python 3.10/3.12/3.13 SDK conformance."
+        }
+      ]
+    },
     {
       "productVersion": null,
       "cliVersion": "0.166.0",

package/src/generated/cc-agent-protocol.schema.json

@@ -937,6 +937,43 @@
           "type": "integer",
           "minimum": 1,
           "maximum": 64
+        },
+        "inputBindings": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "$ref": "#/$defs/SubgraphPortBinding"
+          }
+        },
+        "outputBindings": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "$ref": "#/$defs/SubgraphPortBinding"
+          }
+        },
+        "budget": {
+          "$ref": "#/$defs/Budget"
+        }
+      }
+    },
+    "SubgraphPortBinding": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "parentPort",
+        "childNodeId",
+        "childPort"
+      ],
+      "properties": {
+        "parentPort": {
+          "$ref": "#/$defs/Identifier"
+        },
+        "childNodeId": {
+          "$ref": "#/$defs/Identifier"
+        },
+        "childPort": {
+          "$ref": "#/$defs/Identifier"
         }
       }
     },
@@ -1397,6 +1434,18 @@
           "minLength": 1,
           "maxLength": 256
         },
+        "baseIdempotencyKey": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "iterationPath": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "minimum": 0
+          }
+        },
         "operationDigest": {
           "$ref": "#/$defs/Digest"
         },