chainlesschain 0.166.2 → 0.166.4

package/src/commands/team.js

@@ -24,8 +24,14 @@ import { TeamRunner } from "../lib/agent-team/team-runner.js";
 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 { TeamSessionMessageAdapter } from "../lib/agent-team/team-session-message-adapter.js";
 import { TeamAgentStreamParser } from "../lib/agent-team/team-agent-stream.js";
 import { TeamMessageBridge } from "../lib/agent-team/team-message-bridge.js";
+import {
+  computeTeamGraphAuthorityDigest,
+  computeTeamGraphRevisionDigest,
+  projectTeamGraphCollaboration,
+} from "../lib/agent-team/team-graph-projection.js";
 import { resolveTeamTaskContract } from "../lib/agent-team/team-task-contract.js";
 import {
   TeamScopeLock,
@@ -1371,6 +1377,8 @@ export function makeAgentRunTask(opts = {}) {
     sendMessage = null,
     messageAuthority = null,
     recipientState = null,
+    requestFollowupWake = null,
+    requestHandoff = null,
     mailbox = null,
     budgetReservation = null,
     signal = null,
@@ -1395,7 +1403,7 @@ export function makeAgentRunTask(opts = {}) {
     );
     return spawnAgent(buildTeamAgentPrompt(prompt, { inbox }), process.cwd(), {
       ...effectiveContract,
-      sessionId: opts.sessionIdForTask?.(key) || null,
+      sessionId: opts.sessionIdForTask?.(key, task) || null,
       signal,
       ...(mailbox && holder
         ? {
@@ -1405,6 +1413,8 @@ export function makeAgentRunTask(opts = {}) {
               sendMessage,
               assertAuthority: messageAuthority,
               recipientState,
+              requestFollowupWake,
+              requestHandoff,
               onMutation: opts.onMailboxMutation,
               durable: opts.mailboxDurable === true,
             },
@@ -2160,8 +2170,17 @@ export function registerTeamCommand(program, { logger } = {}) {
           return;
         }
         const ttlMs = limits.ttlMs;
+        const stateId = resumeSnapshot?.stateId || `team_state_${randomUUID()}`;
+        const messageStatePath = options.state
+          ? `${options.state}.${stateId}.messages.json`
+          : null;
         let reg;
-        let mailbox = new TeamMailbox();
+        let mailbox = options.state
+          ? new TeamSessionMessageAdapter({
+              statePath: messageStatePath,
+              teamId: stateId,
+            })
+          : new TeamMailbox();
         let budget = new TeamBudget({
           maxTasks: limits.maxTasks,
           maxTokens: limits.maxTokens,
@@ -2181,7 +2200,32 @@ export function registerTeamCommand(program, { logger } = {}) {
             const isV2 = snap && snap.version >= 2 && snap.registry;
             reg = TaskLeaseRegistry.restore(isV2 ? snap.registry : snap);
             if (isV2) {
-              if (snap.mailbox) mailbox = TeamMailbox.restore(snap.mailbox);
+              if (snap.mailbox?.authority === "session-message-fabric") {
+                if (
+                  !sameFilesystemPath(
+                    path.resolve(snap.mailbox.statePath),
+                    path.resolve(messageStatePath),
+                  )
+                ) {
+                  throw new Error(
+                    "Team message authority path does not match the trusted state identity",
+                  );
+                }
+                mailbox = TeamSessionMessageAdapter.restore(snap.mailbox, {
+                  statePath: messageStatePath,
+                  teamId: stateId,
+                });
+              } else if (snap.mailbox && options.state) {
+                mailbox = TeamSessionMessageAdapter.migrateLegacy(
+                  snap.mailbox,
+                  {
+                    statePath: messageStatePath,
+                    teamId: stateId,
+                  },
+                );
+              } else if (snap.mailbox) {
+                mailbox = TeamMailbox.restore(snap.mailbox);
+              }
               budget = TeamBudget.restore(snap.budget, {
                 // Resume flags may only tighten prior caps; omitted flags keep
                 // the persisted authority.
@@ -2285,6 +2329,11 @@ export function registerTeamCommand(program, { logger } = {}) {
             }),
           ]),
         );
+        const sessionTaskKeyFor = (key, task = reg.getTask(key)) =>
+          task?.metadata?.teamFollowup?.sessionTaskKey || key;
+        const taskContractFor = (key, task = reg.getTask(key)) =>
+          taskContracts.get(key) ||
+          taskContracts.get(sessionTaskKeyFor(key, task));
         if ((options.agent || options.exec) && !options.worktree) {
           const isolatedTask = reg
             .list()
@@ -2352,7 +2401,6 @@ export function registerTeamCommand(program, { logger } = {}) {
             );
           }
         }
-        const stateId = resumeSnapshot?.stateId || `team_state_${randomUUID()}`;
         let controlCursor = resumeSnapshot?.controlCursor || null;
         let adjudicationCursor = resumeSnapshot?.adjudicationCursor || null;
         let adjudicationRunId = resumeSnapshot?.adjudicationRunId || null;
@@ -2531,37 +2579,40 @@ export function registerTeamCommand(program, { logger } = {}) {
             checkpointRequired:
               options.agent === true || options.managedCheckpoint === true,
             worktreeRequired: options.worktree === true,
-            units: reg.list().map((task) => ({
-              key: task.key,
-              branch: options.worktree
-                ? priorUnits.get(task.key)?.branch ||
-                  branchPlanner.branchFor(task.key)
-                : null,
-              worktreePath: options.worktree
-                ? priorUnits.get(task.key)?.worktreePath || null
-                : null,
-              sessionId: options.agent
-                ? priorUnits.get(task.key)?.sessionId ||
-                  _deps.collaborationStore.createSessionId(runId, task.key)
-                : null,
-              status:
-                String(task.status || "").toLowerCase() === "completed"
-                  ? "completed"
-                  : "pending",
-              permissionMode: taskContracts.get(task.key)?.permissionMode,
-              resourceBudget: {
-                maxTurns: taskContracts.get(task.key)?.maxTurns,
-                maxCostUsd: taskContracts.get(task.key)?.maxBudgetUsd,
-                maxTokens: taskContracts.get(task.key)?.maxTokens,
-                maxWallMs: taskContracts.get(task.key)?.maxWallMs,
-              },
-              checkpointRequired:
-                taskContracts.get(task.key)?.checkpointRequired === true ||
-                options.managedCheckpoint === true,
-              worktreeRequired:
-                taskContracts.get(task.key)?.worktreeRequired === true,
-              scopePaths: task.metadata?.scopePaths || [],
-            })),
+            units: reg
+              .list()
+              .filter((task) => !task.metadata?.teamFollowup)
+              .map((task) => ({
+                key: task.key,
+                branch: options.worktree
+                  ? priorUnits.get(task.key)?.branch ||
+                    branchPlanner.branchFor(task.key)
+                  : null,
+                worktreePath: options.worktree
+                  ? priorUnits.get(task.key)?.worktreePath || null
+                  : null,
+                sessionId: options.agent
+                  ? priorUnits.get(task.key)?.sessionId ||
+                    _deps.collaborationStore.createSessionId(runId, task.key)
+                  : null,
+                status:
+                  String(task.status || "").toLowerCase() === "completed"
+                    ? "completed"
+                    : "pending",
+                permissionMode: taskContracts.get(task.key)?.permissionMode,
+                resourceBudget: {
+                  maxTurns: taskContracts.get(task.key)?.maxTurns,
+                  maxCostUsd: taskContracts.get(task.key)?.maxBudgetUsd,
+                  maxTokens: taskContracts.get(task.key)?.maxTokens,
+                  maxWallMs: taskContracts.get(task.key)?.maxWallMs,
+                },
+                checkpointRequired:
+                  taskContracts.get(task.key)?.checkpointRequired === true ||
+                  options.managedCheckpoint === true,
+                worktreeRequired:
+                  taskContracts.get(task.key)?.worktreeRequired === true,
+                scopePaths: task.metadata?.scopePaths || [],
+              })),
           });
         } catch (err) {
           (log.error || console.error)(
@@ -2573,8 +2624,27 @@ export function registerTeamCommand(program, { logger } = {}) {
         const collaborationUnits = new Map(
           collaborationRun.units.map((unit) => [unit.key, unit]),
         );
+        const teamGraphRunId =
+          resumeSnapshot?.graphProjection?.runId || `team:${stateId}`;
+        const teamGraphRevisionDigest =
+          resumeSnapshot?.graphProjection?.revisionDigest ||
+          computeTeamGraphRevisionDigest(reg);
+        const teamGraphAuthorityDigest =
+          resumeSnapshot?.graphProjection?.authorityDigest ||
+          computeTeamGraphAuthorityDigest({
+            stateId,
+            permissionMode: options.agent ? permissionMode : "default",
+            worktreeRequired: options.worktree === true,
+            checkpointRequired:
+              options.agent === true || options.managedCheckpoint === true,
+            holders: Array.from(
+              { length: Math.min(teammates, Math.max(1, reg.list().length)) },
+              (_, index) => `teammate-${index + 1}`,
+            ),
+          });
         const settleGovernance = (key, status, extra = {}) => {
-          const unit = collaborationUnits.get(key);
+          const governanceKey = sessionTaskKeyFor(key);
+          const unit = collaborationUnits.get(governanceKey);
           let sideEffects = null;
           if (unit?.sessionId) {
             try {
@@ -2587,7 +2657,7 @@ export function registerTeamCommand(program, { logger } = {}) {
           }
           const updated = _deps.collaborationStore.updateUnit(
             collaborationRun.id,
-            key,
+            governanceKey,
             {
               status,
               ...extra,
@@ -2595,7 +2665,7 @@ export function registerTeamCommand(program, { logger } = {}) {
             },
             { returnUnit: true },
           );
-          if (updated) collaborationUnits.set(key, updated);
+          if (updated) collaborationUnits.set(governanceKey, updated);
         };
 
         // Persist a snapshot after each task settles so a crash mid-run is
@@ -2626,6 +2696,14 @@ export function registerTeamCommand(program, { logger } = {}) {
             adjudicationRunId,
             adjudicationCursor,
             execution: executionContract,
+            graphProjection: projectTeamGraphCollaboration({
+              runId: teamGraphRunId,
+              mailbox,
+              registry: reg,
+              recipients: mailbox.status?.().recipients || [],
+              revisionDigest: teamGraphRevisionDigest,
+              authorityDigest: teamGraphAuthorityDigest,
+            }),
           });
         };
 
@@ -2718,6 +2796,8 @@ export function registerTeamCommand(program, { logger } = {}) {
                 sendMessage = null,
                 messageAuthority = null,
                 recipientState = null,
+                requestFollowupWake = null,
+                requestHandoff = null,
                 mailbox: taskMailbox = null,
                 budgetReservation = null,
                 signal = null,
@@ -2728,7 +2808,7 @@ export function registerTeamCommand(program, { logger } = {}) {
                   throw new Error(`task "${key}" has no \`prompt\` to --agent`);
                 }
                 const contract = applyBudgetReservation(
-                  taskContracts.get(key),
+                  taskContractFor(key, task),
                   budgetReservation,
                 );
                 return spawnAgent(
@@ -2743,7 +2823,9 @@ export function registerTeamCommand(program, { logger } = {}) {
                       ? false
                       : contract.checkpointRequired,
                     managedCheckpoint,
-                    sessionId: collaborationUnits.get(key)?.sessionId,
+                    sessionId: collaborationUnits.get(
+                      sessionTaskKeyFor(key, task),
+                    )?.sessionId,
                     signal,
                     ...(taskMailbox && holder
                       ? {
@@ -2753,6 +2835,8 @@ export function registerTeamCommand(program, { logger } = {}) {
                             sendMessage,
                             assertAuthority: messageAuthority,
                             recipientState,
+                            requestFollowupWake,
+                            requestHandoff,
                             onMutation: persist,
                             durable: Boolean(options.state),
                           },
@@ -2775,9 +2859,10 @@ export function registerTeamCommand(program, { logger } = {}) {
           runTask = makeShellRunTask(log);
         } else if (options.agent)
           runTask = makeAgentRunTask({
-            contractForTask: (key) => taskContracts.get(key),
+            contractForTask: (key, task) => taskContractFor(key, task),
             worktreeEnabled: false,
-            sessionIdForTask: (key) => collaborationUnits.get(key)?.sessionId,
+            sessionIdForTask: (key, task) =>
+              collaborationUnits.get(sessionTaskKeyFor(key, task))?.sessionId,
             onMailboxMutation: persist,
             mailboxDurable: Boolean(options.state),
           });
@@ -2838,7 +2923,7 @@ export function registerTeamCommand(program, { logger } = {}) {
           }
           const binding = adjudicationBindingFor(
             task,
-            collaborationUnits.get(key) || null,
+            collaborationUnits.get(sessionTaskKeyFor(key, task)) || null,
           );
           const opened = adjudicationStore.openCase(binding, {
             anchor: adjudicationCursor,
@@ -2865,7 +2950,7 @@ export function registerTeamCommand(program, { logger } = {}) {
           runTask,
           budget,
           budgetForTask: options.agent
-            ? (task) => taskContracts.get(task.key)
+            ? (task) => taskContractFor(task.key, task)
             : () => ({ reserveUsage: false }),
           mailbox,
           realtimeMessaging: options.agent === true,
@@ -2895,9 +2980,14 @@ export function registerTeamCommand(program, { logger } = {}) {
                 ? "pending"
                 : retry
                   ? "pending"
-                  : status;
+                  : options.agent === true && status === "completed"
+                    ? "running"
+                    : status;
             settleGovernance(key, governanceStatus, {
-              endedAt: governanceStatus === "pending" ? null : Date.now(),
+              endedAt:
+                governanceStatus === "pending" || governanceStatus === "running"
+                  ? null
+                  : Date.now(),
             });
             ensureTaskAdjudicationCase(key);
             persist();
@@ -2905,6 +2995,14 @@ export function registerTeamCommand(program, { logger } = {}) {
           onLeaseChanged: () => {
             persist();
           },
+          onFollowupMutation: () => {
+            persist();
+          },
+          onHandoffMutation: () => {
+            persist();
+          },
+          graphRevisionDigest: teamGraphRevisionDigest,
+          graphAuthorityDigest: teamGraphAuthorityDigest,
           onEvent: (e) => {
             if (options.json) console.log(JSON.stringify(e));
             else if (e.type === "task:claimed")
@@ -3011,18 +3109,32 @@ export function registerTeamCommand(program, { logger } = {}) {
         persist();
         let governanceFailed = false;
         try {
-          // Reconcile only units whose authoritative registry state differs.
-          // Per-task hooks already durably settled the common path.
+          // Follow-up wake tasks are new lease-bound turns in the same durable
+          // collaboration session/unit as their source task. Aggregate every
+          // such turn before making the unit terminal; otherwise the first
+          // completed turn would freeze governance before a later follow-up.
+          const tasksByGovernanceKey = new Map(
+            [...collaborationUnits.keys()].map((key) => [key, []]),
+          );
           for (const task of reg.list()) {
-            const state = String(task.status || "").toLowerCase();
+            const governanceKey = sessionTaskKeyFor(task.key, task);
+            tasksByGovernanceKey.get(governanceKey)?.push(task);
+          }
+          for (const [key, tasks] of tasksByGovernanceKey) {
+            const states = tasks.map((task) =>
+              String(task.status || "").toLowerCase(),
+            );
             const status =
-              state === "completed"
+              states.length > 0 &&
+              states.every((state) => state === "completed")
                 ? "completed"
-                : state === "cancelled" || state === "pending"
+                : states.some(
+                      (state) => state === "cancelled" || state === "pending",
+                    )
                   ? "cancelled"
                   : "failed";
-            if (collaborationUnits.get(task.key)?.status === status) continue;
-            settleGovernance(task.key, status, {
+            if (collaborationUnits.get(key)?.status === status) continue;
+            settleGovernance(key, status, {
               endedAt: Date.now(),
             });
           }

package/src/data/changelog.json

@@ -1,6 +1,32 @@
 {
   "source": "CHANGELOG.md",
   "releases": [
+    {
+      "productVersion": null,
+      "cliVersion": "0.166.4",
+      "cliVersions": ["0.1.4", "0.2.3", "0.166.3", "0.166.4"],
+      "date": "2026-08-26",
+      "title": "",
+      "sections": [
+        {
+          "heading": "Added - cc CLI 0.166.4 + Agent Protocol 0.1.4 + Agent SDKs 0.2.3: canonical stream event inventory",
+          "body": "> `chainlesschain` **0.166.3 -> 0.166.4**,\n> `@chainlesschain/agent-protocol` **0.1.3 -> 0.1.4**,\n> `@chainlesschain/agent-sdk` **0.2.2 -> 0.2.3**, and\n> `chainlesschain-agent-sdk` **0.2.2 -> 0.2.3** (release candidate,\n> 2026-08-26).\n\n- **One event discriminator inventory**: the canonical JSON Schema now owns\n  all currently emitted Agent stdout event types, including Hook, subagent,\n  recovery, budget, structured-result, and interaction rejection events.\n- **Generated cross-language contract**: TypeScript and Python receive the\n  event literal inventory, envelope type, and validator; Kotlin and Swift\n  receive generated event enums and typed envelopes from the same definition.\n- **Forward compatibility retained**: SDK transports continue to preserve\n  unknown future events. The new known-event guard is opt-in and does not turn\n  additive provider/runtime events into transport failures.\n- **Shared conformance**: legal and illegal event envelopes run through the\n  protocol, TypeScript SDK, and Python SDK validators; generated-output drift,\n  invalid metadata, and explicit non-JSON values fail the release gate.\n- **Release validation**: publication requires this exact candidate to pass\n  Agent Protocol and Python SDK conformance, Linux/Windows/macOS `CLI CI` and\n  `CLI Strict Sandbox`, and the IDE extension matrix before immutable OIDC\n  release tags are created."
+        }
+      ]
+    },
+    {
+      "productVersion": null,
+      "cliVersion": "0.166.3",
+      "cliVersions": ["0.1.2", "0.2.2", "0.166.2", "0.166.3"],
+      "date": "2026-08-25",
+      "title": "",
+      "sections": [
+        {
+          "heading": "Added - cc CLI 0.166.3 + Agent Protocol 0.1.2 + Agent SDKs 0.2.2: scoped approvals and durable team authority",
+          "body": "> `chainlesschain` **0.166.2 -> 0.166.3**,\n> `@chainlesschain/agent-protocol` **0.1.1 -> 0.1.2**,\n> `@chainlesschain/agent-sdk` **0.2.1 -> 0.2.2**, and\n> `chainlesschain-agent-sdk` **0.2.1 -> 0.2.2** (release candidate,\n> 2026-08-25).\n\n- **Canonical approval contract**: the protocol package exports schema-derived\n  JavaScript validators and deterministic TypeScript/Python bindings for\n  `acceptOnce`, `acceptForTurn`, `acceptForSession`, `decline`, and `cancel`.\n  Shared valid/invalid fixtures keep the protocol, both SDKs, and CLI App\n  Server on one wire contract.\n- **Fail-closed, exactly scoped grants**: approval responses bind the request,\n  requested permission, tool, arguments, working directory, and policy digest.\n  Turn grants stay in memory; session grants become effective only after a\n  tamper-evident authority event is persisted and verified. Expired, corrupt,\n  mismatched, widened, or persistence-failed grants never silently authorize a\n  call.\n- **N-1 SDK compatibility**: boolean callbacks normalize to one-shot canonical\n  decisions with the request binding, while direct boolean responses retain\n  the legacy wire for older callers. Invalid or throwing callbacks decline\n  safely in both TypeScript and Python.\n- **Durable Team messaging and custody**: state-backed Team runs now use the\n  `SessionMessageFabric` authority for bounded cross-process delivery,\n  offline/reconnect, receipts, fencing, dead letters, rate limits, and legacy\n  mailbox migration. Idle follow-up turns and offer/accept/commit handoffs keep\n  stable message identity while transferring attempt/lease custody explicitly.\n- **Release validation**: publication requires the exact release commit to pass\n  Agent Protocol and Python SDK conformance, Linux/Windows/macOS `CLI CI` and\n  `CLI Strict Sandbox`, and the desktop E2E matrix before immutable OIDC tags\n  are created."
+        }
+      ]
+    },
     {
       "productVersion": null,
       "cliVersion": "0.166.2",

package/src/gateways/ws/remote-session-protocol.js

@@ -17,6 +17,10 @@ import {
 } from "../../lib/agent-authority.js";
 import { hasCompleteInteractionBinding } from "../../lib/interaction-binding.js";
 import { REMOTE_MEMBERSHIP_NOT_ACTIVE_CODE } from "../../lib/remote-membership-coordinator.js";
+import {
+  REMOTE_APPROVAL_DECISION_CAPABILITY,
+  requireRemoteApprovalDecision,
+} from "../../lib/remote-approval-decision.js";
 
 const CLIENT_EVENT_SCOPES = Object.freeze({
   prompt: "prompt",
@@ -918,7 +922,14 @@ export async function handleRemoteSessionPublish(
       // fail-safe). The envelope also feeds `describeAuthorityChain` provenance
       // into the audit trail below.
       let approvalEnvelope = null;
+      let approvalDecision = null;
       if (message.event.type === "approval.resolve") {
+        approvalDecision = requireRemoteApprovalDecision(message.event, {
+          requireCanonical:
+            member.capabilities?.includes(
+              REMOTE_APPROVAL_DECISION_CAPABILITY,
+            ) === true,
+        });
         approvalEnvelope = {
           origin: ORIGIN.REMOTE,
           authenticated: true,
@@ -934,8 +945,7 @@ export async function handleRemoteSessionPublish(
               }
             : {}),
         };
-        const approved = message.event.answer ?? message.event.approved;
-        if (approved === true || approved === "true" || approved === "yes") {
+        if (approvalDecision.approved) {
           assertCanApprove(approvalEnvelope);
           if (session.hostPrincipalId) {
             requireRemoteApprovalRequest(server, session, message.event);
@@ -974,10 +984,7 @@ export async function handleRemoteSessionPublish(
       } else if (
         session.hostPrincipalId &&
         message.event.type === "approval.resolve" &&
-        (message.event.answer === true ||
-          message.event.answer === "true" ||
-          message.event.answer === "yes" ||
-          message.event.approved === true)
+        approvalDecision.approved
       ) {
         throw new Error(
           "Server-hosted remote approval is disabled until its dispatch path consumes a durable lease",
@@ -995,17 +1002,12 @@ export async function handleRemoteSessionPublish(
           message.event.type === "approval.resolve" &&
           !serverHosted
         ) {
-          const rawDecision = message.event.answer ?? message.event.approved;
-          const approved =
-            rawDecision === true ||
-            rawDecision === "true" ||
-            rawDecision === "yes";
           const request = requireRemoteApprovalRequest(
             server,
             session,
             message.event,
           );
-          if (approved) {
+          if (approvalDecision.approved) {
             approvalLease = server
               ._requireRemoteMembershipCoordinator()
               .createApprovalLease({
@@ -1046,7 +1048,8 @@ export async function handleRemoteSessionPublish(
                   ? {
                       requestId:
                         message.event.requestId || message.event.approvalId,
-                      approved: message.event.answer ?? message.event.approved,
+                      approved: approvalDecision.approved,
+                      decisionKind: approvalDecision.kind,
                       // Log-safe provenance: which principal/session/authority.
                       authority: describeAuthorityChain(approvalEnvelope || {}),
                       forwarded: true,
@@ -1098,6 +1101,7 @@ export async function handleRemoteSessionPublish(
                   membershipAuthority: membership.authorityVersion,
                   sessionEpoch: membership.sessionEpoch,
                   membershipEpoch: membership.membershipEpoch,
+                  memberCapabilities: [...(member.capabilities || [])],
                 }
               : {}),
             event: message.event,
@@ -1131,7 +1135,8 @@ export async function handleRemoteSessionPublish(
             action: "control.approval",
             detail: {
               requestId: message.event.requestId || message.event.approvalId,
-              approved: message.event.answer ?? message.event.approved,
+              approved: approvalDecision.approved,
+              decisionKind: approvalDecision.kind,
               // Log-safe provenance: which principal/session/authority approved.
               authority: describeAuthorityChain(approvalEnvelope || {}),
             },
@@ -1139,7 +1144,7 @@ export async function handleRemoteSessionPublish(
           await handleSessionAnswer(server, message.id, ws, {
             ...controlMessage,
             requestId: message.event.requestId || message.event.approvalId,
-            answer: message.event.answer ?? message.event.approved,
+            answer: approvalDecision.approved,
             // Echoed approval binding (if any): the host interaction gate rejects
             // a verdict whose binding doesn't match the pending request.
             binding: message.event.binding ?? null,

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

@@ -14,7 +14,8 @@
       "durable_human_task",
       "bounded_transport",
       "graph_effect_receipts",
-      "deterministic_trace"
+      "deterministic_trace",
+      "agent_stream_events"
     ]
   },
   "oneOf": [
@@ -1782,6 +1783,71 @@
         }
       }
     },
+    "AgentStreamEventType": {
+      "enum": [
+        "approval_request",
+        "approval_resolved",
+        "checkpoint",
+        "compaction",
+        "compaction-degraded",
+        "compaction_usage_unknown",
+        "cost_budget_exhausted",
+        "elicitation_complete",
+        "elicitation_deferred",
+        "feedback_ack",
+        "hook_progress",
+        "hook_response",
+        "hook_started",
+        "iteration_budget_exhausted",
+        "iteration_warning",
+        "plan_update",
+        "question_request",
+        "question_resolved",
+        "question_response_rejected",
+        "raw",
+        "recovery_degraded",
+        "remote_control",
+        "result",
+        "resume_ack",
+        "session_error",
+        "slash_command_result",
+        "stream_event",
+        "stream_retry",
+        "structured_result",
+        "subagent_completed",
+        "subagent_progress",
+        "subagent_started",
+        "system",
+        "token_usage",
+        "tool_result",
+        "tool_use",
+        "user"
+      ]
+    },
+    "AgentStreamEventEnvelope": {
+      "type": "object",
+      "required": [
+        "type"
+      ],
+      "properties": {
+        "type": {
+          "$ref": "#/$defs/AgentStreamEventType"
+        },
+        "seq": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "trace_id": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128,
+          "pattern": "^[A-Za-z0-9._:-]+$"
+        }
+      },
+      "additionalProperties": {
+        "$ref": "#/$defs/JsonValue"
+      }
+    },
     "InitializeParams": {
       "type": "object",
       "additionalProperties": false,