@excitedjs/agent-runtime-claude-code 0.5.0-beta.168 → 1.0.0-beta.170

package/dist/runtime-deps.d.ts

@@ -0,0 +1,29 @@
+import type { AgentRuntimeMcpServer, AgentRuntimePathContext, AgentRuntimeSkillSource, AgentRuntimeStateCallbacks, DreamuxLogger } from '@excitedjs/dreamux-types';
+import type { DispatcherClaudeCodeConfig } from './config.js';
+import type { ClaudeCodeSessionFactory } from './supervisor.js';
+/** Neutral host capabilities required by one resident Claude Code runtime. */
+export interface ClaudeCodeRuntimeDeps {
+    config: DispatcherClaudeCodeConfig;
+    cwd: string;
+    state: AgentRuntimeStateCallbacks;
+    paths: AgentRuntimePathContext;
+    mcpServers: readonly AgentRuntimeMcpServer[];
+    sessionFactory: ClaudeCodeSessionFactory;
+    resolveBinPath: (bin: string) => string;
+    injectEnv?: Record<string, string>;
+    systemPromptAppend?: readonly string[];
+    skillSources?: readonly AgentRuntimeSkillSource[];
+    disableFeatures?: readonly string[];
+    outputSchema?: Record<string, unknown>;
+    generateSessionId?: () => string;
+    resolveTranscriptPath?: (input: {
+        sessionId: string;
+        cwd: string;
+        locator: string | null;
+        env: NodeJS.ProcessEnv;
+        resume: boolean;
+    }) => Promise<string>;
+    sourceIdDedupeWindow?: number;
+    logger?: DreamuxLogger;
+}
+//# sourceMappingURL=runtime-deps.d.ts.map

package/dist/runtime-deps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-deps.d.ts","sourceRoot":"","sources":["../src/runtime-deps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,EACvB,0BAA0B,EAC1B,aAAa,EACd,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAEhE,8EAA8E;AAC9E,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,0BAA0B,CAAC;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,0BAA0B,CAAC;IAClC,KAAK,EAAE,uBAAuB,CAAC;IAC/B,UAAU,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC7C,cAAc,EAAE,wBAAwB,CAAC;IACzC,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,YAAY,CAAC,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAClD,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,iBAAiB,CAAC,EAAE,MAAM,MAAM,CAAC;IACjC,qBAAqB,CAAC,EAAE,CAAC,KAAK,EAAE;QAC9B,SAAS,EAAE,MAAM,CAAC;QAClB,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;QACvB,MAAM,EAAE,OAAO,CAAC;KACjB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB"}

package/dist/runtime-deps.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runtime-deps.js.map

package/dist/runtime-deps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-deps.js","sourceRoot":"","sources":["../src/runtime-deps.ts"],"names":[],"mappings":""}

package/dist/runtime-session.d.ts

@@ -0,0 +1,13 @@
+import type { TurnOutcome } from './supervisor.js';
+export interface ResolveRuntimeTranscriptPathInput {
+    sessionId: string;
+    cwd: string;
+    locator: string | null;
+    env: NodeJS.ProcessEnv;
+    resume: boolean;
+    override?: (input: Omit<ResolveRuntimeTranscriptPathInput, 'override'>) => Promise<string>;
+}
+export declare function buildClaudeProcessEnv(injectEnv: Record<string, string> | undefined, extraEnv: Record<string, string>): NodeJS.ProcessEnv;
+export declare function resolveRuntimeTranscriptPath(input: ResolveRuntimeTranscriptPathInput): Promise<string>;
+export declare function resultTextFromTurnOutcome(outcome: TurnOutcome, expectedSessionId: string | null, requiresStructuredOutput: boolean): string | null;
+//# sourceMappingURL=runtime-session.d.ts.map

package/dist/runtime-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-session.d.ts","sourceRoot":"","sources":["../src/runtime-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAMnD,MAAM,WAAW,iCAAiC;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,CACT,KAAK,EAAE,IAAI,CAAC,iCAAiC,EAAE,UAAU,CAAC,KACvD,OAAO,CAAC,MAAM,CAAC,CAAC;CACtB;AAED,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EAC7C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,MAAM,CAAC,UAAU,CAMnB;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,iCAAiC,GACvC,OAAO,CAAC,MAAM,CAAC,CAWjB;AAED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,WAAW,EACpB,iBAAiB,EAAE,MAAM,GAAG,IAAI,EAChC,wBAAwB,EAAE,OAAO,GAChC,MAAM,GAAG,IAAI,CA0Bf"}

package/dist/runtime-session.js

@@ -0,0 +1,41 @@
+import { deriveClaudeTranscriptPath, locateClaudeTranscript, } from './transcript/path.js';
+export function buildClaudeProcessEnv(injectEnv, extraEnv) {
+    return {
+        ...globalThis.process.env,
+        ...(injectEnv ?? {}),
+        ...extraEnv,
+    };
+}
+export function resolveRuntimeTranscriptPath(input) {
+    const { override, ...pathInput } = input;
+    if (override !== undefined)
+        return override(pathInput);
+    return input.resume
+        ? locateClaudeTranscript({
+            sessionId: input.sessionId,
+            cwd: input.cwd,
+            locator: input.locator,
+            env: input.env,
+        }).then((located) => located.path)
+        : deriveClaudeTranscriptPath(input.sessionId, input.cwd, input.env);
+}
+export function resultTextFromTurnOutcome(outcome, expectedSessionId, requiresStructuredOutput) {
+    if (outcome.sessionId !== null &&
+        outcome.sessionId !== '' &&
+        outcome.sessionId !== expectedSessionId) {
+        throw new Error('claude-code returned a session id that differs from the pinned native session');
+    }
+    const resultText = outcome.isError || outcome.text === '' ? null : outcome.text;
+    if (outcome.isError) {
+        const detail = outcome.errors.length > 0
+            ? outcome.errors.join('; ')
+            : (outcome.subtype ?? 'unknown error');
+        throw new Error(`claude turn returned an error result: ${detail}`);
+    }
+    if (requiresStructuredOutput && !outcome.hasStructuredOutput) {
+        throw new Error('claude turn did not return structured_output for a ' +
+            '--json-schema session');
+    }
+    return resultText;
+}
+//# sourceMappingURL=runtime-session.js.map

package/dist/runtime-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-session.js","sourceRoot":"","sources":["../src/runtime-session.ts"],"names":[],"mappings":"AACA,OAAO,EACL,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAa9B,MAAM,UAAU,qBAAqB,CACnC,SAA6C,EAC7C,QAAgC;IAEhC,OAAO;QACL,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG;QACzB,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC;QACpB,GAAG,QAAQ;KACZ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,KAAwC;IAExC,MAAM,EAAE,QAAQ,EAAE,GAAG,SAAS,EAAE,GAAG,KAAK,CAAC;IACzC,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC,SAAS,CAAC,CAAC;IACvD,OAAO,KAAK,CAAC,MAAM;QACjB,CAAC,CAAC,sBAAsB,CAAC;YACrB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,GAAG,EAAE,KAAK,CAAC,GAAG;SACf,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;QACpC,CAAC,CAAC,0BAA0B,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,OAAoB,EACpB,iBAAgC,EAChC,wBAAiC;IAEjC,IACE,OAAO,CAAC,SAAS,KAAK,IAAI;QAC1B,OAAO,CAAC,SAAS,KAAK,EAAE;QACxB,OAAO,CAAC,SAAS,KAAK,iBAAiB,EACvC,CAAC;QACD,MAAM,IAAI,KAAK,CACb,+EAA+E,CAChF,CAAC;IACJ,CAAC;IACD,MAAM,UAAU,GACd,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IAC/D,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,GACV,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;YACvB,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;YAC3B,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,IAAI,eAAe,CAAC,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,yCAAyC,MAAM,EAAE,CAAC,CAAC;IACrE,CAAC;IACD,IAAI,wBAAwB,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,CAAC;QAC7D,MAAM,IAAI,KAAK,CACb,qDAAqD;YACnD,uBAAuB,CAC1B,CAAC;IACJ,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/runtime-turn.d.ts

@@ -0,0 +1,7 @@
+import type { RuntimeTurn, RuntimeTurnOutcome } from '@excitedjs/dreamux-types';
+/** Create one stable logical Turn object with an exactly-once outcome latch. */
+export declare function createRuntimeTurn(): {
+    turn: RuntimeTurn;
+    settle: (outcome: RuntimeTurnOutcome) => boolean;
+};
+//# sourceMappingURL=runtime-turn.d.ts.map

package/dist/runtime-turn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-turn.d.ts","sourceRoot":"","sources":["../src/runtime-turn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,kBAAkB,EACnB,MAAM,0BAA0B,CAAC;AAElC,gFAAgF;AAChF,wBAAgB,iBAAiB,IAAI;IACnC,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC;CAClD,CAiBA"}

package/dist/runtime-turn.js

@@ -0,0 +1,21 @@
+/** Create one stable logical Turn object with an exactly-once outcome latch. */
+export function createRuntimeTurn() {
+    let resolve;
+    let settled = false;
+    const turn = Object.freeze({
+        settled: new Promise((value) => {
+            resolve = value;
+        }),
+    });
+    return {
+        turn,
+        settle(outcome) {
+            if (settled)
+                return false;
+            settled = true;
+            resolve(outcome);
+            return true;
+        },
+    };
+}
+//# sourceMappingURL=runtime-turn.js.map

package/dist/runtime-turn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-turn.js","sourceRoot":"","sources":["../src/runtime-turn.ts"],"names":[],"mappings":"AAKA,gFAAgF;AAChF,MAAM,UAAU,iBAAiB;IAI/B,IAAI,OAA+C,CAAC;IACpD,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC;QACzB,OAAO,EAAE,IAAI,OAAO,CAAqB,CAAC,KAAK,EAAE,EAAE;YACjD,OAAO,GAAG,KAAK,CAAC;QAClB,CAAC,CAAC;KACH,CAAC,CAAC;IACH,OAAO;QACL,IAAI;QACJ,MAAM,CAAC,OAAO;YACZ,IAAI,OAAO;gBAAE,OAAO,KAAK,CAAC;YAC1B,OAAO,GAAG,IAAI,CAAC;YACf,OAAO,CAAC,OAAO,CAAC,CAAC;YACjB,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/runtime.d.ts

@@ -1,119 +1,6 @@
-/**
- * `builtin:claude-code` AgentRuntime (issue #110 PR6, resident stream-json
- * transport since issue #120; extracted into `@excitedjs/agent-runtime-claude-code`
- * in issue #209).
- *
- * A real second agent runtime that proves the AgentRuntimeProvider abstraction
- * is not "Codex renamed". Like Codex it runs a **resident child process**
- * supervised for the runtime's lifetime — but it differs in every
- * runtime-specific dimension:
- *
- * - **Stream-json over stdio, not an app-server WebSocket.** The resident child
- *   is `claude --print --input-format stream-json --output-format stream-json`
- *   (see `./args.ts`); turns are NDJSON `user` lines on stdin and
- *   `init`/`assistant`/`result` envelopes on stdout (see `./stream.ts`). There
- *   is no `initialize` handshake — the child emits `init` lazily with the first
- *   turn — so readiness is "child spawned", not "handshake completed".
- * - **MCP injection is an inline JSON config document** (`--mcp-config <json>`),
- *   not Codex's `-c mcp_servers.*` TOML CLI flags.
- * - **Runtime-owned config** is `DispatcherClaudeCodeConfig` (bin / model /
- *   permission_mode / remote_control / extra_args / extra_env), distinct from
- *   the Codex config.
- * - **Completion delivery** is a plain user turn (no fake task-notification),
- *   not the Codex inbox-then-trigger path.
- *
- * Process spawning goes through an injectable {@link ClaudeCodeSessionFactory}
- * seam (mirroring Codex's process-factory seam), so the lifecycle contract is
- * fully unit-testable with a fake session. A live `claude` binary is exercised
- * only by the opt-in live test.
- *
- * Failure contract (unchanged by #120): a turn failure (spawn error, child
- * exit, error `result`) is never swallowed. For inbound/restart turns it drives
- * the runtime to `degraded` with a persisted `last_error` (observable via
- * status/doctor). For `completionInput` it surfaces as a `failed`
- * result the caller can act on (PR8 delivery retry). `channelInput` still
- * returns after accept (submit != completion) so the channel can ack promptly.
- *
- * Restart: an unexpected child exit marks the runtime `degraded`; the next turn
- * re-spawns the resident child with `--resume <session_id>`, restoring the
- * conversation. There is no background backoff timer — re-spawn is lazy and
- * bound to the (serialized) turn queue, so it stays deterministic.
- *
- * Per-turn idle deadline: a turn whose still-alive child goes silent — never
- * emitting another stream line (a stall, or a wait on input the runtime cannot
- * satisfy) — would otherwise pend forever and wedge the serial queue, and behind
- * it TeamMate completion delivery, which awaits this runtime. `turn_timeout_ms`
- * is a *max-idle* window (issue #156): it is reset on every inbound stream line,
- * so a long but continuously-streaming turn (e.g. a deep audit running many
- * tool calls for far longer than the window) is never reaped, while a child that
- * emits nothing for the whole window still is — turning an infinite hang into a
- * normal degraded + `last_error` (inbound) or `failed` delivery result.
- *
- * Reference: the resident stream-json protocol model and process-supervision
- * shape are adapted from the Claudemux `next` implementation; the AgentRuntime /
- * Channel / DispatcherService boundaries (provider seam, runtime-owned MCP
- * injection, degraded/last_error status, TeamMate delivery result contract) are
- * Dreamux's own, per `.agents/decisions/agent-runtime-provider.md`.
- */
-import type { DispatcherClaudeCodeConfig } from './config.js';
-import { type ClaudeCodeSessionFactory } from './supervisor.js';
-import type { AgentRuntimeCapabilities, AgentRuntime, AgentRuntimeIdentity, AgentRuntimeLastResult, AgentRuntimeMcpServer, AgentRuntimePathContext, AgentRuntimeSkillSource, AgentRuntimeStateCallbacks, AgentRuntimeStatus, AgentRuntimeTextInput, AgentRuntimeTurnResult, DreamuxLogger, InboundTurnInput, TurnSettledSignal } from '@excitedjs/dreamux-types';
-/**
- * Everything the Claude Code runtime needs, assembled by the provider from the
- * neutral create context plus host-supplied hooks. The host contracts the
- * package must not reconstruct — the per-dispatcher path context, the durable
- * state sink, and the base process env (`PATH` seeded with the host package
- * bins) — arrive here; nothing references a Dreamux host module.
- */
-export interface ClaudeCodeRuntimeDeps {
-    /** Provider-parsed Claude Code runtime config. */
-    config: DispatcherClaudeCodeConfig;
-    /** Working directory the resident `claude` child runs in. */
-    cwd: string;
-    /** Neutral state sink for status/thread transitions. */
-    state: AgentRuntimeStateCallbacks;
-    /** Neutral path context: the runtime derives its cache/log subpaths here. */
-    paths: AgentRuntimePathContext;
-    /** MCP server descriptors translated into the `--mcp-config` JSON document. */
-    mcpServers: readonly AgentRuntimeMcpServer[];
-    /** Resident-session factory (tests inject a fake). */
-    sessionFactory: ClaudeCodeSessionFactory;
-    /** Host-level bin resolver (default: identity on the config bin). */
-    resolveBinPath: (bin: string) => string;
-    /**
-     * The host's neutral env-injection entries from the create context, merged
-     * into the resident child env before this provider's own `extra_env`.
-     * Empty/omitted means inject nothing (the common case).
-     */
-    injectEnv?: Record<string, string>;
-    /**
-     * Launcher-supplied ordered role/system-prompt content, applied as an APPEND
-     * via `--append-system-prompt`. Omitted for launches that supply none.
-     */
-    systemPromptAppend?: readonly string[];
-    /**
-     * Role-gated skill sources core selected (issue #209 slice 6). The
-     * add-dir-compatible ones become `--add-dir` flags on every (re)spawn.
-     */
-    skillSources?: readonly AgentRuntimeSkillSource[];
-    /**
-     * Neutral feature names the host asked this runtime to disable. Args mapping
-     * is applied on every resident (re)spawn.
-     */
-    disableFeatures?: readonly string[];
-    /**
-     * Optional JSON Schema constraining every turn's final assistant message for
-     * the resident session's lifetime. Passed straight through to
-     * `claudeCodeResidentArgs` as the native `--json-schema` flag on every
-     * (re)spawn. In-memory only — never persisted to identity, so a resumed
-     * session that did not start with a schema does not silently gain one.
-     */
-    outputSchema?: Record<string, unknown>;
-    /** Fired each time a delivered turn reaches a terminal state. */
-    onTurnSettled?: (settled: TurnSettledSignal) => void;
-    /** Structured logger; falls back to a minimal `console.error` sink. */
-    logger?: DreamuxLogger;
-}
+/** Resident Claude Code AgentRuntime using stream-json stdio. */
+import type { ClaudeCodeRuntimeDeps } from './runtime-deps.js';
+import type { AgentRuntimeCapabilities, AgentRuntime, AgentRuntimeIdentity, AgentRuntimeStatus, AgentRuntimeTextInput, InboundTurnInput, RuntimeAdmission } from '@excitedjs/dreamux-types';
 /**
  * The Claude Code agent runtime for one dispatcher. A single resident
  * stream-json child serves every turn. Turns run serially (one at a time) and
@@ -133,15 +20,24 @@ export declare class ClaudeCodeRuntime implements AgentRuntime {
     private readonly logger;
     private status;
     private threadId;
+    private transcriptLocator;
+    private resumeOnNextSpawn;
     private resumed;
     private stopped;
     private readonly seen;
+    private readonly seenOrder;
     private readonly seenTextInputIds;
+    private readonly seenTextInputIdOrder;
+    private readonly sourceIdDedupeWindow;
+    private readonly pendingChannelSources;
+    private readonly pendingTextSources;
+    private readonly pendingAdmissions;
     private queue;
-    private readonly runtimeInstanceId;
-    private turnCounter;
     private session;
-    private lastResult;
+    private sessionStarting;
+    private startTask;
+    private stopTask;
+    private generation;
     private activeTurn;
     private queuedTurnCount;
     private idlePromise;
@@ -151,15 +47,23 @@ export declare class ClaudeCodeRuntime implements AgentRuntime {
     getCapabilities(): AgentRuntimeCapabilities;
     getCheckpoint(): {
         id: string;
+        transcript_locator?: string | null;
     } | null;
     wasCheckpointResumed(): boolean;
-    getLast(): Promise<AgentRuntimeLastResult | null>;
     getContext(): Promise<null>;
     resume(): Promise<void>;
     start(): Promise<void>;
+    private startRuntime;
     stop(): Promise<void>;
-    completionInput(input: AgentRuntimeTextInput): Promise<AgentRuntimeTurnResult>;
-    channelInput(input: InboundTurnInput): Promise<AgentRuntimeTurnResult>;
+    private stopRuntime;
+    completionInput(input: AgentRuntimeTextInput): Promise<RuntimeAdmission>;
+    private completionInputImpl;
+    private acceptTextInput;
+    channelInput(input: InboundTurnInput): Promise<RuntimeAdmission>;
+    private channelInputImpl;
+    private acceptChannelInput;
+    private trackAdmission;
+    private drainAdmissions;
     waitIdle(): Promise<void>;
     private runActiveTurnOnQueue;
     private runActiveTurn;
@@ -169,18 +73,13 @@ export declare class ClaudeCodeRuntime implements AgentRuntime {
     private recordQueuedTurnStart;
     private recordQueuedTurnEnd;
     private resolveIdleWaitersIfIdle;
-    /**
-     * Ensure a live resident session exists, spawning (or re-spawning after an
-     * unexpected exit) as needed. Re-spawn resumes the persisted session id so the
-     * conversation survives a crash.
-     */
+    /** Ensure a live resident session exists, resuming after a child exit. */
     private ensureSession;
-    private materializeSkillAddDir;
+    private createSession;
+    private resolveTranscriptPath;
     /** React to an unexpected resident-child exit: degrade and drop the session. */
     private onSessionExit;
-    private applyTurnOutcome;
-    private nextTurnId;
-    private buildProcessEnv;
+    private assertGeneration;
     private setStatus;
     private log;
 }

package/dist/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"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"}