@demicodes/agent 0.21.0 → 0.22.0

package/dist/client-entry.d.mts

@@ -1,4 +1,4 @@
-import { f as TranscriptPatch, l as ServerFrame, n as AgentServerTransport, o as ClientFrame, r as AgentTransport, s as ClientSessionEvent, t as AgentClientTransport, u as ShellCommandStatusLike, x as AgentMetadata } from "./transport-_eV2zg9M.mjs";
-import { a as AgentClient, i as AgentActionOptions, n as createWebSocketClientTransport, o as AgentClientListener, r as createWebSocketServerTransport, t as JsonWebSocket } from "./websocket-transport-BC7OstFf.mjs";
+import { f as TranscriptPatch, l as ServerFrame, n as AgentServerTransport, o as ClientFrame, r as AgentTransport, s as ClientSessionEvent, t as AgentClientTransport, u as ShellCommandStatusLike, x as AgentMetadata } from "./transport-vzA9vMxT.mjs";
+import { a as AgentClient, i as AgentActionOptions, n as createWebSocketClientTransport, o as AgentClientListener, r as createWebSocketServerTransport, t as JsonWebSocket } from "./websocket-transport-CyoM_NS1.mjs";
 import { ProviderSelection } from "@demicodes/provider";
 export { type AgentActionOptions, AgentClient, type AgentClientListener, type AgentClientTransport, type AgentMetadata, type AgentServerTransport, type AgentTransport, type ClientFrame, type ClientSessionEvent, type JsonWebSocket, type ProviderSelection, type ServerFrame, type ShellCommandStatusLike, type TranscriptPatch, createWebSocketClientTransport, createWebSocketServerTransport };

package/dist/index.d.mts

@@ -1,6 +1,6 @@
-import { A as AgentSystemPromptContext, B as CompactionWindow, C as AgentReferenceResolveContext, D as AgentSessionParams, E as AgentSessionOptions, F as ExternalMutationReservation, G as DEFAULT_TURN_RETRY_POLICY, H as TranscriptLog, I as ModelSwitchApply, J as resolveRetryPolicy, K as TurnRetryPolicy, L as SessionEvent, M as AgentToolContext, N as AgentToolInvokeContext, O as AgentSessionRestoreParams, P as AgentToolInvokeResult, R as SessionEventListener, S as AgentPromptContext, T as AgentSessionCloneParams, U as TranscriptOptions, V as DrainedTranscriptPatches, W as estimateTranscriptBlockTokens, Y as retryDelayMs, _ as AgentHarnessContext, a as createInProcessTransportPair, b as AgentLifecycleEvent, c as ConversationSummary, d as SubagentJob, f as TranscriptPatch, g as AgentHarness, h as AgentDisposeContext, i as InProcessTransportPair, j as AgentTool, k as AgentSessionStore, l as ServerFrame, m as AbortTarget, n as AgentServerTransport, o as ClientFrame, p as AbortResult, q as isRetryableCode, r as AgentTransport, s as ClientSessionEvent, t as AgentClientTransport, u as ShellCommandStatusLike, v as AgentHarnessRuntime, w as AgentSessionCheckpoint, x as AgentMetadata, y as AgentHostContext, z as SubagentProfile } from "./transport-_eV2zg9M.mjs";
-import { a as AgentClient, i as AgentActionOptions, n as createWebSocketClientTransport, o as AgentClientListener, r as createWebSocketServerTransport, t as JsonWebSocket } from "./websocket-transport-BC7OstFf.mjs";
-import { BashAuditEvent, BashEnvironment, BashEnvironmentOptions, Command, CommandMetadataRecord, Host, HostStore, ShellCommandStatus, ShellOutputChunk } from "@demicodes/shell";
+import { A as AgentSystemPromptContext, B as CompactionWindow, C as AgentReferenceResolveContext, D as AgentSessionParams, E as AgentSessionOptions, F as ExternalMutationReservation, G as DEFAULT_TURN_RETRY_POLICY, H as TranscriptLog, I as ModelSwitchApply, J as resolveRetryPolicy, K as TurnRetryPolicy, L as SessionEvent, M as AgentToolContext, N as AgentToolInvokeContext, O as AgentSessionRestoreParams, P as AgentToolInvokeResult, R as SessionEventListener, S as AgentPromptContext, T as AgentSessionCloneParams, U as TranscriptOptions, V as DrainedTranscriptPatches, W as estimateTranscriptBlockTokens, Y as retryDelayMs, _ as AgentHarnessContext, a as createInProcessTransportPair, b as AgentLifecycleEvent, c as ConversationSummary, d as SubagentJob, f as TranscriptPatch, g as AgentHarness, h as AgentDisposeContext, i as InProcessTransportPair, j as AgentTool, k as AgentSessionStore, l as ServerFrame, m as AbortTarget, n as AgentServerTransport, o as ClientFrame, p as AbortResult, q as isRetryableCode, r as AgentTransport, s as ClientSessionEvent, t as AgentClientTransport, u as ShellCommandStatusLike, v as AgentHarnessRuntime, w as AgentSessionCheckpoint, x as AgentMetadata, y as AgentHostContext, z as SubagentProfile } from "./transport-vzA9vMxT.mjs";
+import { a as AgentClient, i as AgentActionOptions, n as createWebSocketClientTransport, o as AgentClientListener, r as createWebSocketServerTransport, t as JsonWebSocket } from "./websocket-transport-CyoM_NS1.mjs";
+import { BashAuditEvent, BashEnvironment, BashEnvironmentOptions, Command, CommandMetadataRecord, CommandRegistry, Host, HostStore, ShellCommandStatus, ShellOutputChunk } from "@demicodes/shell";
 import { AgentProvider, Provider } from "@demicodes/provider";
 import { Block, Model, ModelMediaKind, ModelSelection, ProviderErrorDiagnostics, QueuedMessage, SessionPhase, UserContentBlock } from "@demicodes/core";
 //#region src/recovery.d.ts
@@ -140,6 +140,8 @@ declare class AgentSession<State> {
   abort(): Promise<AbortResult>;
   scheduleYieldWakeup(durationMs: number, metadata?: AgentMetadata | null): AgentToolInvokeResult;
   waitUntilDone(): Promise<void>;
+  /** True when no turn is running and no action (including queued user sends) is pending. */
+  isSettled(): boolean;
   /**
    * Tears the session down: aborts any in-flight turn and releases provider-held resources
    * (e.g. a long-lived CLI subprocess). Called when the owning connection closes.
@@ -278,6 +280,11 @@ interface AgentServerOptions {
      * the parent itself. Defaults to true.
      */
     notifyParentOnIdle?: boolean;
+    /**
+     * Live-children ceiling applied to every session in the tree (each session
+     * counts its own direct children). Defaults to {@link MAX_LIVE_SUBAGENTS}.
+     */
+    maxLiveSubagents?: number;
   };
   /**
    * Optional host-side shell prep (env, PATH, etc.). Implementation-agnostic —
@@ -323,6 +330,7 @@ declare class AgentServer {
   private readonly sessionOptions;
   private readonly prepareShell;
   private readonly notifyParentOnIdle;
+  private readonly maxLiveSubagents;
   private readonly bindings;
   private readonly sessionOwnership;
   constructor(options: AgentServerOptions);
@@ -338,35 +346,140 @@ declare class AgentServer {
 }
 //#endregion
 //#region src/subagent.d.ts
+/** Default per-session live-children ceiling; override with `AgentServerOptions.subagents.maxLiveSubagents`. */
 declare const MAX_LIVE_SUBAGENTS = 8;
-declare const MAX_ARCHIVED_SUBAGENTS = 16;
 declare const SUBAGENT_RESULT_MAX_BYTES: number;
 type SubagentExecution = 'idle' | 'provider_streaming' | 'tool_executing' | 'compacting' | 'finalizing' | 'pending_yield';
+interface SubagentClose {
+  phase: 'completed' | 'aborted' | 'error';
+  result?: string;
+  failure?: string;
+}
+interface ChildToolRecord {
+  toolUseId: string;
+  title: string;
+  startedAt: number;
+  endedAt: number | null;
+  status: 'executing' | 'completed' | 'error';
+}
+interface ChildJob<State> {
+  id: string;
+  description: string;
+  profile: SubagentProfile<State>;
+  profileName: string | null;
+  metadata: AgentMetadata | null;
+  session: AgentSession<State>;
+  /** Supervisor of this child's own children (the grandchildren of this supervisor's owner). */
+  ownSupervisor: ChildSupervisor<State>;
+  commandRegistry: CommandRegistry;
+  commandNames: string[];
+  environments: Map<Host, BashEnvironment>;
+  pendingEnvironments: Map<Host, Promise<BashEnvironment>>;
+  readonlyHosts: WeakMap<Host, Host>;
+  spawnedAt: number;
+  lastEventAt: number;
+  tools: ChildToolRecord[];
+  lastAssistantTextAt: number | null;
+  phase: SubagentJob['phase'];
+  failure: string | null;
+  unsubscribe: () => void;
+  closed: Promise<SubagentClose>;
+  settleClosed: (close: SubagentClose) => void;
+  isClosing: boolean;
+  /** Wakes the settle loop when the child set or an inbound send changes the picture. */
+  wake: (() => void) | null;
+}
+/**
+ * Connection-wide flat registry of every live session in the tree: the root
+ * plus every subagent at any depth. The sole basis for cross-tree addressing —
+ * `send`, `steer`, `show`, and `list` resolve here, with no routing rules
+ * along the tree.
+ */
+declare class AgentDirectory<State = unknown> {
+  private root;
+  private readonly entries;
+  attachRoot(session: AgentSession<State>, supervisor: ChildSupervisor<State>): void;
+  rootId(): string;
+  rootSession(): AgentSession<State>;
+  register(job: ChildJob<State>, owner: ChildSupervisor<State>): void;
+  unregister(id: string): void;
+  liveEntry(id: string): {
+    job: ChildJob<State>;
+    owner: ChildSupervisor<State>;
+  } | null;
+  /** The parent session id of a live agent; null for the root, undefined for an unknown id. */
+  parentIdOf(id: string): string | null | undefined;
+  /**
+   * The whole session tree: the root, every live agent, and each live node's
+   * archived children (their supervisors exist, so their archives are
+   * readable). Live children order by spawn time; archived newest first.
+   */
+  tree(): Promise<AgentTreeNode[]>;
+}
+interface AgentTreeNode {
+  id: string;
+  parentId: string | null;
+  kind: 'root' | 'live' | 'archived';
+  description: string;
+  profile: string | null;
+  phase: SubagentJob['phase'];
+  closedAgoMs: number | null;
+  /** Pre-rendered live status line (id, phase, ages, execution, activity); null for root/archived. */
+  line: string | null;
+  children: AgentTreeNode[];
+}
 interface ChildSupervisorOptions<State> {
   agent: AgentHarness<State>;
   cwd: string;
   /** Harness-configured profiles; null means the implicit `default` only. */
   profiles: SubagentProfile<State>[] | null;
-  /** Parent registered commands (harness list, before the `demi agent` injection). */
+  /** The owner session's harness commands, before the `demi agent` injection. */
   parentCommands: Command[];
   shellOptions: Omit<BashEnvironmentOptions, 'host' | 'commands'>;
   prepareShell: PrepareShell | null;
   sessionOptions: AgentServerSessionOptions;
   /** When false, a child closing never wakes an idle parent; the host app orchestrates the wakeup from the `subagent closed` frame. */
   notifyParentOnIdle: boolean;
-  /** Backing store for child checkpoints and job metadata, keyed under the parent's session directory. */
+  /** Backing store for child checkpoints and job metadata. */
   store: HostStore;
+  /** Store key prefix of the owner session's directory (e.g. `agent-sessions/<id>`); children nest under `<prefix>/subagents/<childId>`. */
+  storePrefix: string;
+  /** Connection-wide registry shared by every supervisor in the tree. */
+  directory: AgentDirectory<State>;
+  /** Live-children ceiling for this supervisor (from `AgentServerOptions.subagents.maxLiveSubagents`). */
+  maxLiveSubagents: number;
+  /** When false, this supervisor's owner may not spawn: its `demi agent` tree carries communication and reads only. */
+  canSpawn: boolean;
+  /** Invoked whenever the live-children set changes; wired to the owning job's settle loop. */
+  onJobsChanged: (() => void) | null;
   emit(frame: ServerFrame): void;
 }
 /**
- * Per-parent subagent supervisor. Owns every child `AgentSession` this parent
- * spawns: lifecycle (spawn / steer / abort / natural end), the `demi agent`
- * command tree, child shell environments, and the `subagent*` protocol frames
- * on the parent connection. Children persist exactly like the parent: each
- * live child keeps a checkpoint and job record under the parent's session
- * directory, and reopening the parent restores and resumes them (`restore`).
- * A closed child moves to the archive: its transcript checkpoint stays on
- * store and `demi agent resume` revives it with a new user message.
+ * The on-store shape of a child (`<prefix>/subagents/<id>/job.json`); its
+ * checkpoint sits beside it. Without `closedPhase` the child is live (a parent
+ * restore resumes it); with `closedPhase` it is archived — finished but
+ * revivable with `demi agent resume`, skipped by restore, never pruned: it
+ * lives exactly as long as the owning session directory.
+ */
+interface PersistedSubagentJob {
+  description: string;
+  profileName: string | null;
+  metadata: AgentMetadata | null;
+  spawnedAt: number;
+  /** Absent means true; false pins the child to a communication-only `demi agent` tree across restores. */
+  canSpawnSubagents?: boolean;
+  closedPhase?: SubagentClose['phase'];
+  closedAt?: number;
+}
+/**
+ * Per-session subagent supervisor. Every session — root or subagent — owns one
+ * and carries the identical `demi agent` command tree, so spawn nests to any
+ * depth. The supervisor owns its direct children's lifecycle (spawn / abort /
+ * resume / natural end), their shell environments, and the `subagent*`
+ * protocol frames; communication and reads (`send` / `steer` / `show` /
+ * `list`) resolve through the shared AgentDirectory and reach any live agent
+ * in the tree. Children persist under the owner's session directory,
+ * recursively, and reopening a session restores its whole subtree.
  */
 declare class ChildSupervisor<State = unknown> {
   private readonly options;
@@ -375,29 +488,33 @@ declare class ChildSupervisor<State = unknown> {
   private isDisposed;
   constructor(options: ChildSupervisorOptions<State>);
   attachParent(session: AgentSession<State>): void;
-  /** The `agent` node AgentServer grafts under the parent registry's `demi` root. */
+  ownerId(): string;
+  hasLiveJobs(): boolean;
+  /** The `agent` node AgentServer (and every child assembly) grafts under the registry's `demi` root. */
   rootCommandNode(): Command;
+  private spawnableCommandNode;
   hasShell(shellId: string): boolean;
-  /** Resolves the child scope owning a shell, for the command bridge dispatch. */
+  /** Resolves the descendant scope owning a shell (recursively), for the command bridge dispatch. */
   environmentScopeForShell(shellId: string): {
     environment: BashEnvironment;
     commandNames: ReadonlySet<string>;
     agentSessionId: string;
   } | null;
-  /** Re-emits `subagent started` + transcript reset for every running child (transcript resync). */
+  /** Re-emits `subagent started` + transcript reset for the whole live subtree (transcript resync). */
   replay(): void;
   /**
-   * Detaches every live child on connection teardown: aborts in-flight turns,
-   * flushes checkpoints, and keeps the persisted job so the next open of this
-   * parent restores it — the same dispose semantics as the parent session.
+   * Detaches the live subtree on connection teardown: aborts in-flight turns,
+   * flushes checkpoints, and keeps the persisted jobs so the next open of the
+   * owner restores them — the same dispose semantics as the owner session.
    * No `closed` frame is emitted: the children are not done, just paused.
    */
   dispose(): Promise<void>;
   /**
-   * Rebuilds every persisted live child of this parent and finishes what it was
+   * Rebuilds every persisted live child of this owner and finishes what it was
    * doing: an interrupted turn resumes from its resume point; an already
-   * quiescent child closes with its result. Children share the parent's
-   * persistence lifecycle — a parent restore is a child restore.
+   * quiescent child closes with its result. Recursive: each restored child
+   * restores its own subtree. Children share the owner's persistence
+   * lifecycle — a session restore is a subtree restore.
    */
   restore(): Promise<void>;
   private restoreJob;
@@ -410,14 +527,21 @@ declare class ChildSupervisor<State = unknown> {
    * transcript.
    */
   private resumeArchived;
-  /** Every archived (finished, revivable) child of this parent, newest first. */
-  private listArchivedJobs;
-  private pruneArchive;
+  /** Every archived (finished, revivable) child of this owner, newest first. */
+  listArchivedJobs(): Promise<{
+    id: string;
+    meta: PersistedSubagentJob;
+  }[]>;
   abortSubtree(id: string): Promise<void>;
-  /** Aborts every live child; the archive is untouched. */
+  /** Aborts every live child (each with its subtree); the archive is untouched. */
   abortAll(): Promise<void>;
   private spawn;
-  /** Everything spawn and restore share: the command tree, the harness runtime, and the job record (session attached separately). */
+  /**
+   * Everything spawn and restore share: the command tree (identical to the
+   * owner's — children spawn, message, and observe exactly like any session),
+   * the child's own supervisor, the harness runtime, and the job record
+   * (session attached separately).
+   */
   private assembleJob;
   private attachSession;
   private childStoreKey;
@@ -425,20 +549,42 @@ declare class ChildSupervisor<State = unknown> {
   private deletePersistedJob;
   /** Shared spawn/resume foreground behaviour: announce the id, wire abort and stdin steers, wait for close, report the outcome. */
   private attendChild;
-  /** Delivers one steer to a child: mid-turn as a steer, idle as a new user turn. */
+  /**
+   * Resolves a send/steer target against the directory. `parent` is the
+   * session that spawned the caller; a caller cannot message itself.
+   */
+  private resolveTarget;
+  /**
+   * Mailbox delivery: an ordinary user send on the target session. The
+   * session's own action queue is the inbox — a busy target sees it as a new
+   * user turn after the current one; an idle root wakes; a finishing subagent
+   * is kept open for one more turn by its settle loop (the enqueue lands
+   * before the loop's synchronous close check, so nothing drops silently).
+   */
+  private deliverSend;
+  /** Chime-in delivery: injects into the target's running turn; no fallback when idle. */
+  private deliverSteer;
+  private senderPrefix;
+  /** Metadata for a turn on the root: the sender subtree's spawning round, or null from the root itself. */
+  private senderMetadata;
+  /** Delivers one stdin chunk from the attending spawner: mid-turn as a steer, otherwise as a new user turn. */
   private steerChild;
   private pumpStdinSteers;
-  private watchChild;
-  /** Tracks one child turn to session quiescence, then closes the job with its outcome. */
-  private watchTurn;
-  /** Resolves when the child is idle with no pending yield wakeups (or the job closed). */
-  private waitForQuiescence;
+  /** Observes one turn promise of an own child: a non-abort failure closes the job as an error. */
+  private trackTurn;
+  /**
+   * The one place a child closes naturally. Loops until the child is
+   * quiescent: no running or queued turn (the session action queue doubles as
+   * the mailbox), no pending yield wakeups, and no live children of its own.
+   * The final check-and-close is synchronous, so a send that lands before it
+   * is processed and one that lands after it fails on `isClosing` — nothing
+   * drops silently.
+   */
+  private settleJob;
   private closeJob;
   private disposeJobShells;
-  /** Wakes an idle parent with a user send; a parent blocked in the spawn gets the tool result instead. */
+  /** Wakes an idle owner with a user send; an owner blocked in the spawn gets the tool result instead. */
   private notifyIdleParent;
-  private createChildAgentNode;
-  private deliverToParent;
   private childEnvironment;
   private createChildEnvironment;
   private resolveProfile;
@@ -448,9 +594,9 @@ declare class ChildSupervisor<State = unknown> {
   private executionOf;
   private activityOf;
   private executionForMs;
-  private snapshot;
-  private renderListLine;
-  private renderShow;
+  snapshot(job: ChildJob<State>, detailed: boolean): Record<string, unknown>;
+  renderListLine(job: ChildJob<State>): string;
+  renderShow(job: ChildJob<State>): string;
   private wireJob;
 }
 /**
@@ -534,4 +680,4 @@ interface ShellToolView {
 declare function finishShellToolResult<State>(environment: BashEnvironment, result: ShellCommandStatus, ctx: AgentToolInvokeContext<State>): Promise<AgentToolInvokeResult>;
 declare function shellCommandHandleRequired(result: ShellCommandStatus, budgetTokens: number): boolean;
 //#endregion
-export { AbortResult, AbortTarget, ActiveTurnPhase, AgentActionOptions, AgentClient, AgentClientListener, AgentClientTransport, AgentDisposeContext, AgentHarness, AgentHarnessContext, AgentHarnessRuntime, AgentHostContext, AgentLifecycleEvent, AgentMetadata, AgentPromptContext, AgentReferenceResolveContext, AgentServer, AgentServerOptions, AgentServerSessionOptions, AgentServerTransport, AgentSession, AgentSessionCheckpoint, AgentSessionCloneParams, AgentSessionOptions, AgentSessionParams, AgentSessionRestoreParams, AgentSessionStore, AgentSystemPromptContext, AgentTool, AgentToolContext, AgentToolInvokeContext, AgentToolInvokeResult, AgentTransport, AgentTransportBinding, ChildSupervisor, ChildSupervisorOptions, ClientFrame, ClientSessionEvent, CompactionWindow, ConversationSummary, DEFAULT_MAX_MEDIA_BYTES, DEFAULT_TURN_RETRY_POLICY, DrainedTranscriptPatches, ExternalMutationReservation, InProcessTransportPair, JsonWebSocket, MAX_ARCHIVED_SUBAGENTS, MAX_LIVE_SUBAGENTS, ModelSwitchApply, PrepareShell, PrepareShellContext, ProviderStreamError, ResumePoint, RunCommandLineCommandNotRegisteredError, RunCommandLineOptions, RunCommandLineResult, RunCommandLineShellNotFoundError, RunCommandLineTimeoutError, SHELL_VIEW_MAX_CHARS, SUBAGENT_RESULT_MAX_BYTES, ServerFrame, SessionEvent, SessionEventListener, ShellCommandStatusLike, ShellToolResultOptions, ShellToolView, StandardAgentToolOptions, SubagentExecution, SubagentJob, SubagentProfile, TranscriptLog, TranscriptOptions, TranscriptPatch, TurnRetryPolicy, applyTranscriptPatches, cloneBlocks, createInProcessTransportPair, createReadonlyHost, createStandardAgentTools, createWebSocketClientTransport, createWebSocketServerTransport, estimateTranscriptBlockTokens, findResumePoint, finishShellToolResult, injectSubagentCommand, isContextLengthExceeded, isRetryableCode, resolveRetryPolicy, retryDelayMs, shellCommandHandleRequired, shellPreviewBudgetTokens, toShellToolResult };
+export { AbortResult, AbortTarget, ActiveTurnPhase, AgentActionOptions, AgentClient, AgentClientListener, AgentClientTransport, AgentDirectory, AgentDisposeContext, AgentHarness, AgentHarnessContext, AgentHarnessRuntime, AgentHostContext, AgentLifecycleEvent, AgentMetadata, AgentPromptContext, AgentReferenceResolveContext, AgentServer, AgentServerOptions, AgentServerSessionOptions, AgentServerTransport, AgentSession, AgentSessionCheckpoint, AgentSessionCloneParams, AgentSessionOptions, AgentSessionParams, AgentSessionRestoreParams, AgentSessionStore, AgentSystemPromptContext, AgentTool, AgentToolContext, AgentToolInvokeContext, AgentToolInvokeResult, AgentTransport, AgentTransportBinding, AgentTreeNode, ChildSupervisor, ChildSupervisorOptions, ClientFrame, ClientSessionEvent, CompactionWindow, ConversationSummary, DEFAULT_MAX_MEDIA_BYTES, DEFAULT_TURN_RETRY_POLICY, DrainedTranscriptPatches, ExternalMutationReservation, InProcessTransportPair, JsonWebSocket, MAX_LIVE_SUBAGENTS, ModelSwitchApply, PrepareShell, PrepareShellContext, ProviderStreamError, ResumePoint, RunCommandLineCommandNotRegisteredError, RunCommandLineOptions, RunCommandLineResult, RunCommandLineShellNotFoundError, RunCommandLineTimeoutError, SHELL_VIEW_MAX_CHARS, SUBAGENT_RESULT_MAX_BYTES, ServerFrame, SessionEvent, SessionEventListener, ShellCommandStatusLike, ShellToolResultOptions, ShellToolView, StandardAgentToolOptions, SubagentExecution, SubagentJob, SubagentProfile, TranscriptLog, TranscriptOptions, TranscriptPatch, TurnRetryPolicy, applyTranscriptPatches, cloneBlocks, createInProcessTransportPair, createReadonlyHost, createStandardAgentTools, createWebSocketClientTransport, createWebSocketServerTransport, estimateTranscriptBlockTokens, findResumePoint, finishShellToolResult, injectSubagentCommand, isContextLengthExceeded, isRetryableCode, resolveRetryPolicy, retryDelayMs, shellCommandHandleRequired, shellPreviewBudgetTokens, toShellToolResult };