@with-logic/elwood 0.1.0

package/dist/cli/session/index.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Exact new/resume session facade for headless CLI execution.
+ * Implements PRD §12A.2/§12A.5 and C-CLI-03/C-CLI-04/C-CLI-08/C-CLI-15.
+ */
+import type { ElwoodAgentSession, ElwoodCommonEventMap } from "../../core/agent-session.ts";
+import type { TurnEvent } from "../../core/simple/events.ts";
+import { SessionBase } from "../../core/simple/session.ts";
+import type { TurnOptions } from "../../core/simple/turn-types.ts";
+import type { ElwoodSessionStatus, TerminalSize, Unsubscribe } from "../../core/types.ts";
+import type { SessionRecord } from "../../state/store.ts";
+import { finalizeRunRequest } from "../request/index.ts";
+import type { CliAgent, EffectiveRunRequest, ResolvedRunRequest } from "../types.ts";
+import { type CliLaunchDependencies } from "./launch.ts";
+export type CliSessionDependencies = {
+    readonly randomId: () => string;
+    readonly readRecord: (stateDir: string, id: string) => SessionRecord;
+    readonly finalize: typeof finalizeRunRequest;
+    readonly launch: CliLaunchDependencies;
+};
+export type PreparedCliSession = {
+    readonly request: EffectiveRunRequest;
+    readonly session: CliSessionFacade;
+};
+export interface CliSessionFacade {
+    readonly agent: CliAgent;
+    readonly id: string;
+    readonly resumed: boolean;
+    readonly status: ElwoodSessionStatus;
+    readonly session: ElwoodAgentSession | undefined;
+    start(): Promise<ElwoodAgentSession>;
+    setup(): Promise<void>;
+    stream(prompt: string, options?: TurnOptions): AsyncGenerator<TurnEvent>;
+    send(prompt: string, options?: TurnOptions): Promise<string>;
+    on<E extends keyof ElwoodCommonEventMap>(event: E, handler: (event: ElwoodCommonEventMap[E]) => void): Unsubscribe;
+    interrupt(options?: {
+        readonly timeoutMs?: number;
+    }): Promise<void>;
+    resize(size: TerminalSize): Promise<void>;
+    close(): Promise<void>;
+    kill(): Promise<void>;
+    teardown(): Promise<void>;
+    preservedSessionId(): string | null;
+}
+/** Resolve stored identity first, then create one lazy facade for the effective adapter. */
+export declare function prepareCliSession(draft: ResolvedRunRequest, dependencies?: CliSessionDependencies): Promise<PreparedCliSession>;
+export declare class HeadlessCliSession extends SessionBase<ElwoodAgentSession> implements CliSessionFacade {
+    readonly agent: CliAgent;
+    readonly id: string;
+    readonly resumed: boolean;
+    private readonly request;
+    private readonly launchSession;
+    private setupPromise;
+    private pendingLaunch;
+    constructor(request: EffectiveRunRequest, id: string, launch: () => Promise<ElwoodAgentSession>);
+    protected readonly readBoundarySignal: import("../../core/simple/turn-types.ts").BoundarySignalReader;
+    protected launch(): Promise<ElwoodAgentSession>;
+    private validatedLaunch;
+    setup(): Promise<void>;
+    on<E extends keyof ElwoodCommonEventMap>(event: E, handler: (event: ElwoodCommonEventMap[E]) => void): Unsubscribe;
+    teardown(): Promise<void>;
+    close(): Promise<void>;
+    preservedSessionId(): string | null;
+    private performSetup;
+    private clearPendingLaunch;
+    private deferPendingCleanup;
+    private removeIdentityAfterFailedLaunch;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/session/index.d.ts.map

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

package/dist/cli/session/index.js

@@ -0,0 +1,124 @@
+/**
+ * Exact new/resume session facade for headless CLI execution.
+ * Implements PRD §12A.2/§12A.5 and C-CLI-03/C-CLI-04/C-CLI-08/C-CLI-15.
+ */
+import { randomUUID } from "node:crypto";
+import { elwoodError } from "../../core/errors.js";
+import { SessionBase } from "../../core/simple/session.js";
+import { defaultBoundarySignal } from "../../core/simple/turn.js";
+import { readPrivateSessionRecord, removeSessionIdentity } from "../../state/private-session.js";
+import { finalizeRunRequest } from "../request/index.js";
+import { createCliLaunch, defaultCliLaunchDependencies, } from "./launch.js";
+const defaults = {
+    randomId: randomUUID,
+    readRecord: readPrivateSessionRecord,
+    finalize: finalizeRunRequest,
+    launch: defaultCliLaunchDependencies,
+};
+/** Resolve stored identity first, then create one lazy facade for the effective adapter. */
+export async function prepareCliSession(draft, dependencies = defaults) {
+    const stored = draft.resume === undefined ? undefined : dependencies.readRecord(draft.stateDir, draft.resume);
+    const request = await dependencies.finalize(draft, stored === undefined ? undefined : { agent: stored.adapter, cwd: stored.cwd });
+    const id = draft.resume ?? dependencies.randomId();
+    const launch = createCliLaunch(request, id, dependencies.launch);
+    return { request, session: new HeadlessCliSession(request, id, launch) };
+}
+export class HeadlessCliSession extends SessionBase {
+    agent;
+    id;
+    resumed;
+    request;
+    launchSession;
+    setupPromise;
+    pendingLaunch;
+    constructor(request, id, launch) {
+        super();
+        this.request = request;
+        this.agent = request.agent;
+        this.id = id;
+        this.resumed = request.resume !== undefined;
+        this.launchSession = launch;
+    }
+    readBoundarySignal = defaultBoundarySignal;
+    launch() {
+        const pending = this.validatedLaunch();
+        this.pendingLaunch = pending;
+        void pending.then(() => this.clearPendingLaunch(), () => this.clearPendingLaunch());
+        return pending;
+    }
+    async validatedLaunch() {
+        const session = await this.launchSession();
+        if (session.elwoodSessionId !== this.id) {
+            await session.kill().catch(() => undefined);
+            throw elwoodError("state_corrupt", "Started session identity did not match its owner.");
+        }
+        return session;
+    }
+    setup() {
+        this.setupPromise ??= this.performSetup();
+        return this.setupPromise;
+    }
+    on(event, handler) {
+        return this.subscribe(event, handler, (session) => session.on(event, handler));
+    }
+    teardown() {
+        const live = this.session;
+        if (live !== undefined)
+            return live.teardown();
+        this.deferPendingCleanup("teardown");
+        return Promise.resolve().then(() => {
+            removeSessionIdentity(this.request.stateDir, this.id, this.agent);
+        });
+    }
+    close() {
+        const live = this.session;
+        if (live !== undefined)
+            return this.closeLiveSession(live);
+        if (this.pendingLaunch !== undefined && this.preservedSessionId() === null) {
+            return this.teardown();
+        }
+        this.deferPendingCleanup("close");
+        return Promise.resolve();
+    }
+    preservedSessionId() {
+        try {
+            const record = readPrivateSessionRecord(this.request.stateDir, this.id);
+            if (record.adapter !== this.agent || !record[record.adapter].resumeId)
+                return null;
+            return this.id;
+        }
+        catch {
+            return null;
+        }
+    }
+    async performSetup() {
+        await this.start();
+        if (this.resumed && this.request.model !== undefined)
+            await this.setModel(this.request.model);
+        if (!this.resumed && this.request.persona !== undefined) {
+            await this.send(this.request.persona);
+        }
+    }
+    clearPendingLaunch() {
+        this.pendingLaunch = undefined;
+    }
+    deferPendingCleanup(action) {
+        if (this.pendingLaunch === undefined)
+            return;
+        void this.start().then(async (live) => {
+            await (action === "teardown" ? live.teardown() : this.closeLiveSession(live)).catch(() => undefined);
+        }, () => {
+            if (action === "teardown")
+                this.removeIdentityAfterFailedLaunch();
+        });
+    }
+    removeIdentityAfterFailedLaunch() {
+        try {
+            removeSessionIdentity(this.request.stateDir, this.id, this.agent);
+        }
+        catch {
+            // The synchronous cleanup already reported its failure; this late retry is best-effort.
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/session/index.js.map

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

package/dist/cli/session/launch.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Adapter launch mapping for the headless CLI session facade.
+ * Implements PRD §12A.2/§12A.5 and C-CLI-05/C-CLI-06/C-CLI-08/C-CLI-15.
+ */
+import { startClaudeWithId } from "../../claude/session/index.ts";
+import type { ClaudeSessionApi } from "../../claude/session/interface.ts";
+import { resumeClaude } from "../../claude/session/resume.ts";
+import { startCodexWithId } from "../../codex/session/index.ts";
+import { resumeCodex } from "../../codex/session/resume.ts";
+import type { CodexSessionApi } from "../../codex/session/types.ts";
+import type { ElwoodAgentSession } from "../../core/agent-session.ts";
+import type { EffectiveRunRequest } from "../types.ts";
+export type CliLaunchDependencies = {
+    readonly prepareStateRoot: (stateDir: string) => void;
+    readonly startClaude: (options: Parameters<typeof startClaudeWithId>[0], id: string) => Promise<ClaudeSessionApi>;
+    readonly resumeClaude: typeof resumeClaude;
+    readonly startCodex: (options: Parameters<typeof startCodexWithId>[0], id: string) => Promise<CodexSessionApi>;
+    readonly resumeCodex: typeof resumeCodex;
+};
+export declare const defaultCliLaunchDependencies: CliLaunchDependencies;
+/** Build exactly one adapter path; resumes never fall back to a new session. */
+export declare function createCliLaunch(request: EffectiveRunRequest, id: string, dependencies: CliLaunchDependencies): () => Promise<ElwoodAgentSession>;
+//# sourceMappingURL=launch.d.ts.map

package/dist/cli/session/launch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch.d.ts","sourceRoot":"","sources":["../../../src/cli/session/launch.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAGtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,gBAAgB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACtD,QAAQ,CAAC,WAAW,EAAE,CACpB,OAAO,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC,CAAC,CAAC,EAChD,EAAE,EAAE,MAAM,KACP,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,OAAO,YAAY,CAAC;IAC3C,QAAQ,CAAC,UAAU,EAAE,CACnB,OAAO,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC,CAAC,EAC/C,EAAE,EAAE,MAAM,KACP,OAAO,CAAC,eAAe,CAAC,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,OAAO,WAAW,CAAC;CAC1C,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAE,qBAM1C,CAAC;AAEF,gFAAgF;AAChF,wBAAgB,eAAe,CAC7B,OAAO,EAAE,mBAAmB,EAC5B,EAAE,EAAE,MAAM,EACV,YAAY,EAAE,qBAAqB,GAClC,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAGnC"}

package/dist/cli/session/launch.js

@@ -0,0 +1,57 @@
+/**
+ * Adapter launch mapping for the headless CLI session facade.
+ * Implements PRD §12A.2/§12A.5 and C-CLI-05/C-CLI-06/C-CLI-08/C-CLI-15.
+ */
+import { startClaudeWithId } from "../../claude/session/index.js";
+import { resumeClaude } from "../../claude/session/resume.js";
+import { startCodexWithId } from "../../codex/session/index.js";
+import { resumeCodex } from "../../codex/session/resume.js";
+import { ensurePrivateStateRoot } from "../../state/private-session.js";
+import { optional } from "../request/values.js";
+export const defaultCliLaunchDependencies = {
+    prepareStateRoot: ensurePrivateStateRoot,
+    startClaude: startClaudeWithId,
+    resumeClaude,
+    startCodex: startCodexWithId,
+    resumeCodex,
+};
+/** Build exactly one adapter path; resumes never fall back to a new session. */
+export function createCliLaunch(request, id, dependencies) {
+    if (request.agent === "claude")
+        return claudeLaunch(request, id, dependencies);
+    return codexLaunch(request, id, dependencies);
+}
+function claudeLaunch(request, id, dependencies) {
+    const common = {
+        cwd: request.cwd,
+        stateDir: request.stateDir,
+        autotrust: request.trust,
+        permissionMode: request.permissionMode ?? "dontAsk",
+        ...optional(request.initialSize, "initialSize"),
+        ...optional(request.reasoningEffort, "reasoningEffort"),
+    };
+    if (request.resume !== undefined)
+        return () => dependencies.resumeClaude({ ...common, elwoodSessionId: id });
+    return async () => {
+        dependencies.prepareStateRoot(request.stateDir);
+        return await dependencies.startClaude({ ...common, ...(request.model === undefined ? {} : { model: request.model }) }, id);
+    };
+}
+function codexLaunch(request, id, dependencies) {
+    const common = {
+        cwd: request.cwd,
+        stateDir: request.stateDir,
+        autotrust: request.trust,
+        sandbox: request.sandbox ?? "workspace-write",
+        approvalPolicy: request.approvalPolicy ?? "never",
+        ...optional(request.initialSize, "initialSize"),
+        ...optional(request.reasoningEffort, "reasoningEffort"),
+    };
+    if (request.resume !== undefined)
+        return () => dependencies.resumeCodex({ ...common, elwoodSessionId: id });
+    return async () => {
+        dependencies.prepareStateRoot(request.stateDir);
+        return await dependencies.startCodex({ ...common, ...(request.model === undefined ? {} : { model: request.model }) }, id);
+    };
+}
+//# sourceMappingURL=launch.js.map

package/dist/cli/session/launch.js.map

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

package/dist/cli/session-launch.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Adapter launch mapping for the headless CLI session facade.
+ * Implements PRD §12A.2/§12A.5 and C-CLI-05/C-CLI-06/C-CLI-08/C-CLI-15.
+ */
+import { startClaudeWithId } from "../claude/session.ts";
+import type { ClaudeSessionApi } from "../claude/session-interface.ts";
+import { resumeClaude } from "../claude/session-resume.ts";
+import { startCodexWithId } from "../codex/session.ts";
+import { resumeCodex } from "../codex/session-resume.ts";
+import type { CodexSessionApi } from "../codex/session-types.ts";
+import type { ElwoodAgentSession } from "../core/agent-session.ts";
+import type { EffectiveRunRequest } from "./types.ts";
+export type CliLaunchDependencies = {
+    readonly prepareStateRoot: (stateDir: string) => void;
+    readonly startClaude: (options: Parameters<typeof startClaudeWithId>[0], id: string) => Promise<ClaudeSessionApi>;
+    readonly resumeClaude: typeof resumeClaude;
+    readonly startCodex: (options: Parameters<typeof startCodexWithId>[0], id: string) => Promise<CodexSessionApi>;
+    readonly resumeCodex: typeof resumeCodex;
+};
+export declare const defaultCliLaunchDependencies: CliLaunchDependencies;
+/** Build exactly one adapter path; resumes never fall back to a new session. */
+export declare function createCliLaunch(request: EffectiveRunRequest, id: string, dependencies: CliLaunchDependencies): () => Promise<ElwoodAgentSession>;
+//# sourceMappingURL=session-launch.d.ts.map

package/dist/cli/session-launch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-launch.d.ts","sourceRoot":"","sources":["../../src/cli/session-launch.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAGnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,gBAAgB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACtD,QAAQ,CAAC,WAAW,EAAE,CACpB,OAAO,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC,CAAC,CAAC,EAChD,EAAE,EAAE,MAAM,KACP,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,OAAO,YAAY,CAAC;IAC3C,QAAQ,CAAC,UAAU,EAAE,CACnB,OAAO,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC,CAAC,EAC/C,EAAE,EAAE,MAAM,KACP,OAAO,CAAC,eAAe,CAAC,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,OAAO,WAAW,CAAC;CAC1C,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAE,qBAM1C,CAAC;AAEF,gFAAgF;AAChF,wBAAgB,eAAe,CAC7B,OAAO,EAAE,mBAAmB,EAC5B,EAAE,EAAE,MAAM,EACV,YAAY,EAAE,qBAAqB,GAClC,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAGnC"}

package/dist/cli/session-launch.js

@@ -0,0 +1,57 @@
+/**
+ * Adapter launch mapping for the headless CLI session facade.
+ * Implements PRD §12A.2/§12A.5 and C-CLI-05/C-CLI-06/C-CLI-08/C-CLI-15.
+ */
+import { startClaudeWithId } from "../claude/session.js";
+import { resumeClaude } from "../claude/session-resume.js";
+import { startCodexWithId } from "../codex/session.js";
+import { resumeCodex } from "../codex/session-resume.js";
+import { ensurePrivateStateRoot } from "../state/private-session.js";
+import { optional } from "./request-values.js";
+export const defaultCliLaunchDependencies = {
+    prepareStateRoot: ensurePrivateStateRoot,
+    startClaude: startClaudeWithId,
+    resumeClaude,
+    startCodex: startCodexWithId,
+    resumeCodex,
+};
+/** Build exactly one adapter path; resumes never fall back to a new session. */
+export function createCliLaunch(request, id, dependencies) {
+    if (request.agent === "claude")
+        return claudeLaunch(request, id, dependencies);
+    return codexLaunch(request, id, dependencies);
+}
+function claudeLaunch(request, id, dependencies) {
+    const common = {
+        cwd: request.cwd,
+        stateDir: request.stateDir,
+        autotrust: request.trust,
+        permissionMode: request.permissionMode ?? "dontAsk",
+        ...optional(request.initialSize, "initialSize"),
+        ...optional(request.reasoningEffort, "reasoningEffort"),
+    };
+    if (request.resume !== undefined)
+        return () => dependencies.resumeClaude({ ...common, elwoodSessionId: id });
+    return async () => {
+        dependencies.prepareStateRoot(request.stateDir);
+        return await dependencies.startClaude({ ...common, ...(request.model === undefined ? {} : { model: request.model }) }, id);
+    };
+}
+function codexLaunch(request, id, dependencies) {
+    const common = {
+        cwd: request.cwd,
+        stateDir: request.stateDir,
+        autotrust: request.trust,
+        sandbox: request.sandbox ?? "workspace-write",
+        approvalPolicy: request.approvalPolicy ?? "never",
+        ...optional(request.initialSize, "initialSize"),
+        ...optional(request.reasoningEffort, "reasoningEffort"),
+    };
+    if (request.resume !== undefined)
+        return () => dependencies.resumeCodex({ ...common, elwoodSessionId: id });
+    return async () => {
+        dependencies.prepareStateRoot(request.stateDir);
+        return await dependencies.startCodex({ ...common, ...(request.model === undefined ? {} : { model: request.model }) }, id);
+    };
+}
+//# sourceMappingURL=session-launch.js.map

package/dist/cli/session-launch.js.map

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

package/dist/cli/session.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Exact new/resume session facade for headless CLI execution.
+ * Implements PRD §12A.2/§12A.5 and C-CLI-03/C-CLI-04/C-CLI-08/C-CLI-15.
+ */
+import type { ElwoodAgentSession, ElwoodCommonEventMap } from "../core/agent-session.ts";
+import type { TurnEvent } from "../core/simple/events.ts";
+import { SessionBase } from "../core/simple/session.ts";
+import type { TurnOptions } from "../core/simple/turn-types.ts";
+import type { ElwoodSessionStatus, TerminalSize, Unsubscribe } from "../core/types.ts";
+import type { SessionRecord } from "../state/store.ts";
+import { finalizeRunRequest } from "./request.ts";
+import { type CliLaunchDependencies } from "./session-launch.ts";
+import type { CliAgent, EffectiveRunRequest, ResolvedRunRequest } from "./types.ts";
+export type CliSessionDependencies = {
+    readonly randomId: () => string;
+    readonly readRecord: (stateDir: string, id: string) => SessionRecord;
+    readonly finalize: typeof finalizeRunRequest;
+    readonly launch: CliLaunchDependencies;
+};
+export type PreparedCliSession = {
+    readonly request: EffectiveRunRequest;
+    readonly session: CliSessionFacade;
+};
+export interface CliSessionFacade {
+    readonly agent: CliAgent;
+    readonly id: string;
+    readonly resumed: boolean;
+    readonly status: ElwoodSessionStatus;
+    readonly session: ElwoodAgentSession | undefined;
+    start(): Promise<ElwoodAgentSession>;
+    setup(): Promise<void>;
+    stream(prompt: string, options?: TurnOptions): AsyncGenerator<TurnEvent>;
+    send(prompt: string, options?: TurnOptions): Promise<string>;
+    on<E extends keyof ElwoodCommonEventMap>(event: E, handler: (event: ElwoodCommonEventMap[E]) => void): Unsubscribe;
+    interrupt(options?: {
+        readonly timeoutMs?: number;
+    }): Promise<void>;
+    resize(size: TerminalSize): Promise<void>;
+    close(): Promise<void>;
+    kill(): Promise<void>;
+    teardown(): Promise<void>;
+    preservedSessionId(): string | null;
+}
+/** Resolve stored identity first, then create one lazy facade for the effective adapter. */
+export declare function prepareCliSession(draft: ResolvedRunRequest, dependencies?: CliSessionDependencies): Promise<PreparedCliSession>;
+export declare class HeadlessCliSession extends SessionBase<ElwoodAgentSession> implements CliSessionFacade {
+    readonly agent: CliAgent;
+    readonly id: string;
+    readonly resumed: boolean;
+    private readonly request;
+    private readonly launchSession;
+    private setupPromise;
+    private pendingLaunch;
+    constructor(request: EffectiveRunRequest, id: string, launch: () => Promise<ElwoodAgentSession>);
+    protected readonly readBoundarySignal: import("../core/simple/turn-types.ts").BoundarySignalReader;
+    protected launch(): Promise<ElwoodAgentSession>;
+    private validatedLaunch;
+    setup(): Promise<void>;
+    on<E extends keyof ElwoodCommonEventMap>(event: E, handler: (event: ElwoodCommonEventMap[E]) => void): Unsubscribe;
+    teardown(): Promise<void>;
+    close(): Promise<void>;
+    preservedSessionId(): string | null;
+    private performSetup;
+    private clearPendingLaunch;
+    private deferPendingCleanup;
+    private removeIdentityAfterFailedLaunch;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/cli/session.d.ts.map

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

package/dist/cli/session.js

@@ -0,0 +1,124 @@
+/**
+ * Exact new/resume session facade for headless CLI execution.
+ * Implements PRD §12A.2/§12A.5 and C-CLI-03/C-CLI-04/C-CLI-08/C-CLI-15.
+ */
+import { randomUUID } from "node:crypto";
+import { elwoodError } from "../core/errors.js";
+import { SessionBase } from "../core/simple/session.js";
+import { defaultBoundarySignal } from "../core/simple/turn.js";
+import { readPrivateSessionRecord, removeSessionIdentity } from "../state/private-session.js";
+import { finalizeRunRequest } from "./request.js";
+import { createCliLaunch, defaultCliLaunchDependencies, } from "./session-launch.js";
+const defaults = {
+    randomId: randomUUID,
+    readRecord: readPrivateSessionRecord,
+    finalize: finalizeRunRequest,
+    launch: defaultCliLaunchDependencies,
+};
+/** Resolve stored identity first, then create one lazy facade for the effective adapter. */
+export async function prepareCliSession(draft, dependencies = defaults) {
+    const stored = draft.resume === undefined ? undefined : dependencies.readRecord(draft.stateDir, draft.resume);
+    const request = await dependencies.finalize(draft, stored === undefined ? undefined : { agent: stored.adapter, cwd: stored.cwd });
+    const id = draft.resume ?? dependencies.randomId();
+    const launch = createCliLaunch(request, id, dependencies.launch);
+    return { request, session: new HeadlessCliSession(request, id, launch) };
+}
+export class HeadlessCliSession extends SessionBase {
+    agent;
+    id;
+    resumed;
+    request;
+    launchSession;
+    setupPromise;
+    pendingLaunch;
+    constructor(request, id, launch) {
+        super();
+        this.request = request;
+        this.agent = request.agent;
+        this.id = id;
+        this.resumed = request.resume !== undefined;
+        this.launchSession = launch;
+    }
+    readBoundarySignal = defaultBoundarySignal;
+    launch() {
+        const pending = this.validatedLaunch();
+        this.pendingLaunch = pending;
+        void pending.then(() => this.clearPendingLaunch(), () => this.clearPendingLaunch());
+        return pending;
+    }
+    async validatedLaunch() {
+        const session = await this.launchSession();
+        if (session.elwoodSessionId !== this.id) {
+            await session.kill().catch(() => undefined);
+            throw elwoodError("state_corrupt", "Started session identity did not match its owner.");
+        }
+        return session;
+    }
+    setup() {
+        this.setupPromise ??= this.performSetup();
+        return this.setupPromise;
+    }
+    on(event, handler) {
+        return this.subscribe(event, handler, (session) => session.on(event, handler));
+    }
+    teardown() {
+        const live = this.session;
+        if (live !== undefined)
+            return live.teardown();
+        this.deferPendingCleanup("teardown");
+        return Promise.resolve().then(() => {
+            removeSessionIdentity(this.request.stateDir, this.id, this.agent);
+        });
+    }
+    close() {
+        const live = this.session;
+        if (live !== undefined)
+            return this.closeLiveSession(live);
+        if (this.pendingLaunch !== undefined && this.preservedSessionId() === null) {
+            return this.teardown();
+        }
+        this.deferPendingCleanup("close");
+        return Promise.resolve();
+    }
+    preservedSessionId() {
+        try {
+            const record = readPrivateSessionRecord(this.request.stateDir, this.id);
+            if (record.adapter !== this.agent || !record[record.adapter].resumeId)
+                return null;
+            return this.id;
+        }
+        catch {
+            return null;
+        }
+    }
+    async performSetup() {
+        await this.start();
+        if (this.resumed && this.request.model !== undefined)
+            await this.setModel(this.request.model);
+        if (!this.resumed && this.request.persona !== undefined) {
+            await this.send(this.request.persona);
+        }
+    }
+    clearPendingLaunch() {
+        this.pendingLaunch = undefined;
+    }
+    deferPendingCleanup(action) {
+        if (this.pendingLaunch === undefined)
+            return;
+        void this.start().then(async (live) => {
+            await (action === "teardown" ? live.teardown() : this.closeLiveSession(live)).catch(() => undefined);
+        }, () => {
+            if (action === "teardown")
+                this.removeIdentityAfterFailedLaunch();
+        });
+    }
+    removeIdentityAfterFailedLaunch() {
+        try {
+            removeSessionIdentity(this.request.stateDir, this.id, this.agent);
+        }
+        catch {
+            // The synchronous cleanup already reported its failure; this late retry is best-effort.
+        }
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/cli/session.js.map

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

package/dist/cli/stream.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Serialized, backpressure-aware output writes with graceful downstream closure.
+ * Implements PRD §12A.3 and C-CLI-12.
+ */
+export type CliWritable = {
+    write(value: string, callback: (error?: Error | null) => void): boolean;
+    once(event: "drain", handler: () => void): unknown;
+    on?(event: "error", handler: (error: Error) => void): unknown;
+    off?(event: "error", handler: (error: Error) => void): unknown;
+};
+export declare class AsyncOutputSink {
+    private readonly target;
+    private tail;
+    private downstreamClosed;
+    private streamFailure;
+    private activeFailure;
+    constructor(target: CliWritable);
+    get closed(): boolean;
+    write(value: string): Promise<boolean>;
+    flush(): Promise<void>;
+    dispose(): void;
+    private writeNow;
+    private readonly onError;
+}
+//# sourceMappingURL=stream.d.ts.map

package/dist/cli/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/cli/stream.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,KAAK,IAAI,GAAG,OAAO,CAAC;IACxE,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC;IACnD,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,CAAC;IAC9D,GAAG,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,CAAC;CAChE,CAAC;AAEF,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,IAAI,CAAuC;IACnD,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,aAAa,CAAoB;IACzC,OAAO,CAAC,aAAa,CAAuC;gBAEhD,MAAM,EAAE,WAAW;IAK/B,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMhC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,OAAO,IAAI,IAAI;IAIf,OAAO,CAAC,QAAQ;IA6ChB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAItB;CACH"}