@with-logic/elwood 0.1.0

package/dist/claude/session-interface.d.ts

@@ -0,0 +1,49 @@
+/**
+ * The Claude-typed live-session surface (`ClaudeSessionApi`): the shape the PTY-backed
+ * session object satisfies. It is the PUBLIC low-level interface returned by the eager
+ * `startClaude`/`resumeClaude` factories and exposed through `ClaudeSession.session`;
+ * `src/index.ts` exports it and the CHANGELOG documents it as the supported low-level type.
+ * Most callers should prefer the ergonomic `ClaudeSession` class (src/claude/simple.ts),
+ * which wraps and delegates to this. Implements PRD §5 public API.
+ */
+import type { ElwoodActivityEvent } from "../core/activity.ts";
+import type { SendOptions } from "../core/images/types.ts";
+import type { LoopControls } from "../core/loops/loop-controls.ts";
+import type { AgentModelOption } from "../core/model-rows.ts";
+import type { ActivityMatch, ElwoodEventHandler, ElwoodEventName, ElwoodSessionStatus, ElwoodStatusDecision, StatusMatch, TerminalSize, Unsubscribe } from "../core/types.ts";
+import type { ElwoodTerminal } from "../terminal/headless.ts";
+import type { ClaudeLoginOptions } from "./login/types.ts";
+export interface ClaudeSessionApi extends LoopControls {
+    readonly elwoodSessionId: string;
+    readonly cwd: string;
+    readonly status: ElwoodSessionStatus;
+    readonly terminal: ElwoodTerminal;
+    statusDecisions(): readonly ElwoodStatusDecision[];
+    waitForStatus(match: StatusMatch, timeoutMs?: number): Promise<ElwoodSessionStatus>;
+    waitForActivity(match: ActivityMatch, timeoutMs?: number): Promise<ElwoodActivityEvent>;
+    on<E extends ElwoodEventName>(event: E, handler: ElwoodEventHandler<E>): Unsubscribe;
+    off<E extends ElwoodEventName>(event: E, handler: ElwoodEventHandler<E>): void;
+    sendPrompt(prompt: string, options?: SendOptions): Promise<void>;
+    sendMessage(message: string, options?: SendOptions): Promise<void>;
+    sendGuidance(message: string, options?: SendOptions): Promise<void>;
+    sendKeys(input: string | Uint8Array): Promise<void>;
+    resize(size: TerminalSize): Promise<void>;
+    interrupt(options?: {
+        readonly timeoutMs?: number;
+    }): Promise<void>;
+    compact(options?: {
+        readonly timeoutMs?: number;
+    }): Promise<void>;
+    listModels(options?: {
+        readonly timeoutMs?: number;
+    }): Promise<readonly AgentModelOption[]>;
+    setModel(id: string, options?: {
+        readonly timeoutMs?: number;
+    }): Promise<void>;
+    /** Drive the interactive `/login` re-authentication flow to recover a lapsed login (C-API-43). */
+    login(options: ClaudeLoginOptions): Promise<void>;
+    stop(): Promise<void>;
+    kill(): Promise<void>;
+    teardown(): Promise<void>;
+}
+//# sourceMappingURL=session-interface.d.ts.map

package/dist/claude/session-interface.d.ts.map

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

package/dist/claude/session-interface.js

@@ -0,0 +1,10 @@
+/**
+ * The Claude-typed live-session surface (`ClaudeSessionApi`): the shape the PTY-backed
+ * session object satisfies. It is the PUBLIC low-level interface returned by the eager
+ * `startClaude`/`resumeClaude` factories and exposed through `ClaudeSession.session`;
+ * `src/index.ts` exports it and the CHANGELOG documents it as the supported low-level type.
+ * Most callers should prefer the ergonomic `ClaudeSession` class (src/claude/simple.ts),
+ * which wraps and delegates to this. Implements PRD §5 public API.
+ */
+export {};
+//# sourceMappingURL=session-interface.js.map

package/dist/claude/session-interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-interface.js","sourceRoot":"","sources":["../../src/claude/session-interface.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/claude/session-resume.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Claude session resume entry point built on the shared start path.
+ * Implements PRD §5.2, §9.3, and C-API-16.
+ */
+import type { ResumeClaudeOptions } from "../core/types.ts";
+import type { ClaudeSessionApi } from "./session-interface.ts";
+export declare function resumeClaude(options: ResumeClaudeOptions): Promise<ClaudeSessionApi>;
+//# sourceMappingURL=session-resume.d.ts.map

package/dist/claude/session-resume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-resume.d.ts","sourceRoot":"","sources":["../../src/claude/session-resume.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAS5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA2C1F"}

package/dist/claude/session-resume.js

@@ -0,0 +1,47 @@
+/**
+ * Claude session resume entry point built on the shared start path.
+ * Implements PRD §5.2, §9.3, and C-API-16.
+ */
+import { resolve } from "node:path";
+import { elwoodError } from "../core/errors.js";
+import { claudeLaunchPosture, effectivePosture, withClaudeLaunch, } from "../state/launch-posture.js";
+import { defaultStateDir, readSessionRecord } from "../state/store.js";
+import { preflightClaude } from "./preflight.js";
+import { startClaudeFromRecord } from "./session.js";
+export async function resumeClaude(options) {
+    // Resolve stateDir to ABSOLUTE ONCE, before any read or `await`: a relative path
+    // re-resolved after a `process.chdir()` between the record read and the runtime-file
+    // writes would read one session and write another's files (PRD §8.1). (C-STATE)
+    const stateDir = resolve(options.stateDir ?? defaultStateDir(options.cwd ?? process.cwd()));
+    const record = readSessionRecord(stateDir, options.elwoodSessionId);
+    if (record.adapter !== "claude") {
+        throw elwoodError("adapter_mismatch", "Cannot resume a non-Claude session as Claude.");
+    }
+    if (!record.claude.resumeId) {
+        throw elwoodError("resume_unavailable", "Cannot resume Claude without a Claude session id.");
+    }
+    const warning = await preflightClaude(options.strictVersionCheck ?? false, options.autoupdate ?? false);
+    // Resume defaults to the posture this session launched with; explicit options
+    // override field by field, and the effective posture is re-persisted (C-API-32,
+    // C-STATE-13). Terminal size is not persisted: it falls back to options.initialSize.
+    const launch = effectivePosture(record.claude.launch, claudeLaunchPosture(options));
+    const resumedRecord = withClaudeLaunch(record, launch);
+    return await startClaudeFromRecord(resumedRecord, stateDir, {
+        cwd: options.cwd ?? record.cwd,
+        stateDir,
+        ...(options.hooks === undefined ? {} : { hooks: options.hooks }),
+        ...(options.initialSize === undefined ? {} : { initialSize: options.initialSize }),
+        ...(options.hookTimeoutMs === undefined ? {} : { hookTimeoutMs: options.hookTimeoutMs }),
+        ...(options.autotrust === undefined ? {} : { autotrust: options.autotrust }),
+        // Reasoning effort is NOT persisted posture — re-supply it per resume (C-CLAUDE-20).
+        ...(options.reasoningEffort === undefined
+            ? {}
+            : { reasoningEffort: options.reasoningEffort }),
+        ...launch,
+        ...(options.strictVersionCheck === undefined
+            ? {}
+            : { strictVersionCheck: options.strictVersionCheck }),
+    }, true, // resumed: mark ready on the first composer marker, symmetric with Codex
+    warning);
+}
+//# sourceMappingURL=session-resume.js.map

package/dist/claude/session-resume.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-resume.js","sourceRoot":"","sources":["../../src/claude/session-resume.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAGrD,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAA4B;IAC7D,iFAAiF;IACjF,qFAAqF;IACrF,gFAAgF;IAChF,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,IAAI,eAAe,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAC5F,MAAM,MAAM,GAAG,iBAAiB,CAAC,QAAQ,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IACpE,IAAI,MAAM,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,MAAM,WAAW,CAAC,kBAAkB,EAAE,+CAA+C,CAAC,CAAC;IACzF,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC5B,MAAM,WAAW,CAAC,oBAAoB,EAAE,mDAAmD,CAAC,CAAC;IAC/F,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,eAAe,CACnC,OAAO,CAAC,kBAAkB,IAAI,KAAK,EACnC,OAAO,CAAC,UAAU,IAAI,KAAK,CAC5B,CAAC;IACF,8EAA8E;IAC9E,gFAAgF;IAChF,qFAAqF;IACrF,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC;IACpF,MAAM,aAAa,GAAG,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvD,OAAO,MAAM,qBAAqB,CAChC,aAAa,EACb,QAAQ,EACR;QACE,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,MAAM,CAAC,GAAG;QAC9B,QAAQ;QACR,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;QAChE,GAAG,CAAC,OAAO,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;QAClF,GAAG,CAAC,OAAO,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC;QACxF,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC;QAC5E,qFAAqF;QACrF,GAAG,CAAC,OAAO,CAAC,eAAe,KAAK,SAAS;YACvC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,eAAe,EAAE,CAAC;QACjD,GAAG,MAAM;QACT,GAAG,CAAC,OAAO,CAAC,kBAAkB,KAAK,SAAS;YAC1C,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,EAAE,CAAC;KACxD,EACD,IAAI,EAAE,yEAAyE;IAC/E,OAAO,CACR,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,43 @@
+/**
+ * Runtime file and PTY helpers for Claude sessions.
+ * Implements PRD §4, §6, and §9.
+ */
+import * as activity from "../core/activity.ts";
+import { AttentionWatcher } from "../core/attention.ts";
+import { TurnStateWatcher } from "../core/turn-state.ts";
+import type { ClaudeEventMap, StartClaudeOptions, TerminalSize } from "../core/types.ts";
+import type { TypedEmitter } from "../events/emitter.ts";
+import type { PtyExit, PtyProcess } from "../pty/types.ts";
+import type { SessionRuntime } from "../state/runtime-paths.ts";
+import type { SessionRecord } from "../state/store.ts";
+/** The rendered-frame observers (turn/attention/screen-fact) for a Claude session. */
+export declare function buildClaudeObservers(elwoodSessionId: string, autotrust: boolean, emitter: TypedEmitter<ClaudeEventMap>): {
+    turn: TurnStateWatcher;
+    attention: AttentionWatcher;
+    table: import("../core/screen-facts.ts").ScreenFactTable;
+    agent: "claude";
+    elwoodSessionId: string;
+    emitActivity: (event: activity.ElwoodActivityEvent) => void;
+};
+export declare function writeRuntimeFiles(runtime: SessionRuntime, options: StartClaudeOptions): void;
+/**
+ * The per-hook timeout written into Claude's settings. The CLI's clock starts when
+ * it spawns the hook process, BEFORE the bridge connects and Elwood's own
+ * `hookTimeoutMs` race begins, so an identical value would let the CLI kill the
+ * hook just before Elwood's fail-open "no decision" reply arrived — turning every
+ * handler timeout into a CLI-side hook failure. The margin keeps Elwood the one
+ * that times out, so the parent always sees its typed `hookError` (PRD §6.3).
+ */
+export declare const cliHookTimeoutMarginSeconds = 5;
+export declare function cliHookTimeoutSeconds(hookTimeoutMs: number): number;
+export declare function spawnClaudePty(record: SessionRecord, settingsPath: string, options: StartClaudeOptions & {
+    readonly initialSize: TerminalSize;
+}): PtyProcess;
+export declare function registerInitialHooks(emitter: TypedEmitter<ClaudeEventMap>, handlers: StartClaudeOptions["hooks"]): void;
+/**
+ * The PTY-exit boundary: run the bounded transcript flush, then emit `terminal:exit`
+ * and submit terminal status (which reaps) behind the shared error boundary so a
+ * throwing flush/listener never skips the unconditional reap (PRD §5.3 C-LIFE-10).
+ */
+export declare function handleClaudeExit(emitter: TypedEmitter<ClaudeEventMap>, elwoodSessionId: string, exit: PtyExit, finishSafely: (afterFlush: () => void) => void, submitExit: () => void): void;
+//# sourceMappingURL=session-runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-runtime.d.ts","sourceRoot":"","sources":["../../src/claude/session-runtime.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EACV,cAAc,EAGd,kBAAkB,EAClB,YAAY,EACb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAK3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAKvD,sFAAsF;AACtF,wBAAgB,oBAAoB,CAClC,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,OAAO,EAClB,OAAO,EAAE,YAAY,CAAC,cAAc,CAAC;;;;;;0BAQb,QAAQ,CAAC,mBAAmB;EAErD;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAW5F;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAE7C,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,aAAa,EACrB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,kBAAkB,GAAG;IAAE,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAA;CAAE,GACnE,UAAU,CAmBZ;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,YAAY,CAAC,cAAc,CAAC,EACrC,QAAQ,EAAE,kBAAkB,CAAC,OAAO,CAAC,GACpC,IAAI,CAKN;AAmBD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,YAAY,CAAC,cAAc,CAAC,EACrC,eAAe,EAAE,MAAM,EACvB,IAAI,EAAE,OAAO,EACb,YAAY,EAAE,CAAC,UAAU,EAAE,MAAM,IAAI,KAAK,IAAI,EAC9C,UAAU,EAAE,MAAM,IAAI,GACrB,IAAI,CAIN"}

package/dist/claude/session-runtime.js

@@ -0,0 +1,105 @@
+/**
+ * Runtime file and PTY helpers for Claude sessions.
+ * Implements PRD §4, §6, and §9.
+ */
+import { resolve } from "node:path";
+import { bridgeScriptSource } from "../bridge/script.js";
+import * as activity from "../core/activity.js";
+import { AttentionWatcher } from "../core/attention.js";
+import { causeDetails, elwoodError } from "../core/errors.js";
+import { isRecord } from "../core/predicates.js";
+import { TurnStateWatcher } from "../core/turn-state.js";
+import { currentPtyFactory } from "../runtime/seams.js";
+import { finishSessionExit } from "../runtime/session-exit.js";
+import { userShell } from "../runtime/shell.js";
+import { writePrivateFileAtomic } from "../state/files.js";
+import { buildClaudeShellCommand, shellLaunch } from "./command.js";
+import { claudeScreenFactTableForTrustPolicy } from "./screen-table.js";
+import { generateClaudeSettings } from "./settings.js";
+/** The rendered-frame observers (turn/attention/screen-fact) for a Claude session. */
+export function buildClaudeObservers(elwoodSessionId, autotrust, emitter) {
+    return {
+        turn: new TurnStateWatcher(),
+        attention: new AttentionWatcher(),
+        table: claudeScreenFactTableForTrustPolicy(autotrust),
+        agent: "claude",
+        elwoodSessionId,
+        emitActivity: (event) => emitter.emit("activity", event),
+    };
+}
+export function writeRuntimeFiles(runtime, options) {
+    writePrivateFileAtomic(runtime.bridgeScriptPath, bridgeScriptSource(runtime.socketPath, runtime.bridgeToken));
+    const settings = generateClaudeSettings({
+        bridgeScriptPath: runtime.bridgeScriptPath,
+        options,
+        timeoutSeconds: cliHookTimeoutSeconds(options.hookTimeoutMs ?? 25_000),
+    });
+    writePrivateFileAtomic(runtime.settingsPath, `${JSON.stringify(settings, null, 2)}\n`);
+}
+/**
+ * The per-hook timeout written into Claude's settings. The CLI's clock starts when
+ * it spawns the hook process, BEFORE the bridge connects and Elwood's own
+ * `hookTimeoutMs` race begins, so an identical value would let the CLI kill the
+ * hook just before Elwood's fail-open "no decision" reply arrived — turning every
+ * handler timeout into a CLI-side hook failure. The margin keeps Elwood the one
+ * that times out, so the parent always sees its typed `hookError` (PRD §6.3).
+ */
+export const cliHookTimeoutMarginSeconds = 5;
+export function cliHookTimeoutSeconds(hookTimeoutMs) {
+    return Math.ceil(hookTimeoutMs / 1000) + cliHookTimeoutMarginSeconds;
+}
+export function spawnClaudePty(record, settingsPath, options) {
+    const launch = shellLaunch(userShell(), buildClaudeShellCommand(settingsPath, options, record.claude.resumeId));
+    try {
+        return currentPtyFactory()({
+            command: launch.command,
+            args: launch.args,
+            cwd: resolve(options.cwd),
+            env: {
+                ...process.env,
+                ELWOOD_SESSION_ID: record.elwoodSessionId,
+            },
+            size: options.initialSize,
+        });
+    }
+    catch (error) {
+        throw elwoodError("pty_start_failed", "Could not start Claude PTY.", causeDetails(error));
+    }
+}
+export function registerInitialHooks(emitter, handlers) {
+    if (!handlers)
+        return;
+    for (const [name, handler] of Object.entries(handlers)) {
+        emitter.listen(`hook:${name}`, hookHandler(name, handler));
+    }
+}
+/**
+ * Emit the terminal-exit event and its activity (PRD §5.3 C-LIFE-10). Called from
+ * the PTY-exit boundary's `finally` so it always runs, even if the final transcript
+ * flush threw — no missed exit event.
+ */
+function emitTerminalExit(emitter, elwoodSessionId, exit) {
+    emitter.emit("terminal:exit", { elwoodSessionId, ...exit });
+    emitter.emit("activity", activity.activityFromTerminalExit("claude", elwoodSessionId, exit.exitCode));
+}
+/**
+ * The PTY-exit boundary: run the bounded transcript flush, then emit `terminal:exit`
+ * and submit terminal status (which reaps) behind the shared error boundary so a
+ * throwing flush/listener never skips the unconditional reap (PRD §5.3 C-LIFE-10).
+ */
+export function handleClaudeExit(emitter, elwoodSessionId, exit, finishSafely, submitExit) {
+    finishSafely(() => finishSessionExit(() => emitTerminalExit(emitter, elwoodSessionId, exit), submitExit));
+}
+function hookHandler(name, handler) {
+    if (typeof handler === "function")
+        return handler;
+    if ((name !== "PreToolUse" && name !== "PermissionRequest") || !isRecord(handler)) {
+        return () => undefined;
+    }
+    return ((event) => {
+        const toolName = isRecord(event) && typeof event["tool_name"] === "string" ? event["tool_name"] : "";
+        const toolHandler = handler[toolName] ?? handler["unknown"];
+        return typeof toolHandler === "function" ? toolHandler(event) : undefined;
+    });
+}
+//# sourceMappingURL=session-runtime.js.map

package/dist/claude/session-runtime.js.map

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

package/dist/claude/session-transcript.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Wires the Claude transcript watcher into the session's activity stream.
+ * Implements PRD §5.4 (C-CLAUDE-15): committed assistant text and tool activity
+ * come from the transcript(s), so an un-sent ghost-text suggestion never posts.
+ */
+import * as activity from "../core/activity.ts";
+import { type TranscriptWarningSink } from "../core/transcript/warning-router.ts";
+import { ClaudeTranscriptWatcher } from "./transcript/index.ts";
+/** The session surface the watcher emits warnings through (live-only). */
+export type WarningSink = TranscriptWarningSink;
+/** The narrow emitter surface the transcript wiring needs (activity only). */
+export type TranscriptActivityEmitter = {
+    emit(event: "activity", payload: activity.ElwoodActivityEvent): void;
+};
+/** A watcher plus a hook to flush any early-buffered warnings once the sink exists. */
+export type WiredTranscriptWatcher = {
+    readonly watcher: ClaudeTranscriptWatcher;
+    /** Flush warnings buffered before the session sink existed; call once it does. */
+    readonly flushPendingWarnings: () => void;
+    /**
+     * Drive `watcher.finish()` behind an error boundary (PRD §5.3 C-LIFE-10): the
+     * final transcript flush emits deltas through activity listeners, and a throwing
+     * listener must NOT abort the PTY-exit callback before it emits `terminal:exit`
+     * and reaps. `afterFlush` runs in a `finally` so those
+     * steps always execute. The flush itself is bounded (a shared watcher-wide chunk
+     * budget plus a small wall-clock slice, §9.2), so it returns to the event loop
+     * promptly rather than looping over a hundreds-of-MiB backlog. A flush failure is
+     * contained and routed as a bounded, content-free `transcript_poll_stopped`
+     * diagnostic carrying `phase: "final_flush"` (so lost trailing shutdown activity
+     * is distinguishable from a live poll failure); a throwing diagnostic listener is
+     * swallowed so it can't block lifecycle completion.
+     */
+    readonly finishSafely: (afterFlush?: () => void) => void;
+};
+/**
+ * Builds a transcript watcher that emits committed items and bounded diagnostics
+ * (drops, contained fs errors, and a poll-error stop). Diagnostics are routed
+ * through the session's warning sink so they are emitted through the
+ * `warning`/`activity` contract (live-only, never persisted). The sink is resolved
+ * lazily because the session object is constructed after the watcher (PRD §5.7). A
+ * diagnostic observed BEFORE the sink exists is BUFFERED and flushed through
+ * `emitWarnings` once it does — never silently dropped.
+ */
+export declare function createTranscriptWatcher(elwoodSessionId: string, emitter: TranscriptActivityEmitter, sink?: () => WarningSink | undefined, pollIntervalMs?: number): WiredTranscriptWatcher;
+/** The narrow watcher surface observeTranscript drives (observe + retire only). */
+export type ObservableTranscript = Pick<ClaudeTranscriptWatcher, "observe" | "retire">;
+/**
+ * Points the watcher at every transcript path the hook payload carries. A
+ * `SubagentStop` event has both a main `transcript_path` and a required
+ * `agent_transcript_path`; both must be observed (PRD §5.4). The watcher keeps
+ * an independent cursor per path and no-ops on an already-observed path.
+ *
+ * Backward tail recovery runs only when the FIRST observe of a path lands on a
+ * turn-boundary hook (`Stop`/`SubagentStop`) — the case where a just-committed
+ * turn would otherwise be missed. On `SessionStart`/resume the first observe
+ * baselines at EOF with no recovery, so a resumed session never republishes the
+ * prior conversation's final assistant/tool turn (PRD §5.4, C-CLAUDE-15).
+ */
+export declare function observeTranscript(watcher: ObservableTranscript, event: {
+    readonly [key: string]: unknown;
+}): void;
+//# sourceMappingURL=session-transcript.d.ts.map

package/dist/claude/session-transcript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-transcript.d.ts","sourceRoot":"","sources":["../../src/claude/session-transcript.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAGhE,0EAA0E;AAC1E,MAAM,MAAM,WAAW,GAAG,qBAAqB,CAAC;AAEhD,8EAA8E;AAC9E,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,CAAC,mBAAmB,GAAG,IAAI,CAAC;CACtE,CAAC;AAEF,uFAAuF;AACvF,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAC;IAC1C,kFAAkF;IAClF,QAAQ,CAAC,oBAAoB,EAAE,MAAM,IAAI,CAAC;IAC1C;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,YAAY,EAAE,CAAC,UAAU,CAAC,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;CAC1D,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,yBAAyB,EAClC,IAAI,CAAC,EAAE,MAAM,WAAW,GAAG,SAAS,EAGpC,cAAc,CAAC,EAAE,MAAM,GACtB,sBAAsB,CAmCxB;AAKD,mFAAmF;AACnF,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,uBAAuB,EAAE,SAAS,GAAG,QAAQ,CAAC,CAAC;AAEvF;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,oBAAoB,EAC7B,KAAK,EAAE;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,GACzC,IAAI,CAcN"}

package/dist/claude/session-transcript.js

@@ -0,0 +1,88 @@
+/**
+ * Wires the Claude transcript watcher into the session's activity stream.
+ * Implements PRD §5.4 (C-CLAUDE-15): committed assistant text and tool activity
+ * come from the transcript(s), so an un-sent ghost-text suggestion never posts.
+ */
+import * as activity from "../core/activity.js";
+import { createTranscriptWarningRouter, } from "../core/transcript/warning-router.js";
+import { ClaudeTranscriptWatcher } from "./transcript/index.js";
+import { dropWarning, readErrorWarning, transcriptFailureWarning } from "./transcript/warnings.js";
+/**
+ * Builds a transcript watcher that emits committed items and bounded diagnostics
+ * (drops, contained fs errors, and a poll-error stop). Diagnostics are routed
+ * through the session's warning sink so they are emitted through the
+ * `warning`/`activity` contract (live-only, never persisted). The sink is resolved
+ * lazily because the session object is constructed after the watcher (PRD §5.7). A
+ * diagnostic observed BEFORE the sink exists is BUFFERED and flushed through
+ * `emitWarnings` once it does — never silently dropped.
+ */
+export function createTranscriptWatcher(elwoodSessionId, emitter, sink, 
+// Poll-cadence override forwarded to the watcher's existing test seam; production
+// omits it and the watcher uses its default cadence. Internal only (not a PRD flag).
+pollIntervalMs) {
+    // The shared router buffers diagnostics observed BEFORE the sink exists (the watcher
+    // is built first) and delivers each exactly once with clear-before-delivery + throw
+    // containment (see core/transcript/warning-router). `sink` is optional here; when
+    // omitted the router simply buffers with no sink to flush to.
+    const { route, flushPendingWarnings } = createTranscriptWarningRouter(() => sink?.());
+    const watcher = new ClaudeTranscriptWatcher(elwoodSessionId, (event) => emitter.emit("activity", activity.activityFromClaudeTranscript(event)), {
+        onDrop: (notice) => route(dropWarning(notice)),
+        onReadError: (notice) => route(readErrorWarning(notice)),
+        onPollError: (error) => route(transcriptFailureWarning(elwoodSessionId, error)),
+        ...(pollIntervalMs === undefined ? {} : { pollIntervalMs }),
+    });
+    // C-LIFE-10: flush trailing committed items behind an error boundary, then run
+    // `afterFlush` (terminal:exit emission, status, reap) in a `finally` so a throwing
+    // flush listener can never abort lifecycle completion. A flush failure is contained
+    // and surfaced as a bounded diagnostic; a throwing diagnostic route is swallowed.
+    const noop = () => undefined;
+    const finishSafely = (afterFlush = noop) => {
+        try {
+            watcher.finish();
+        }
+        catch (error) {
+            try {
+                // A failed FINAL flush at exit is phase-labelled so an operator can tell
+                // lost trailing shutdown activity from a live poll failure.
+                route(transcriptFailureWarning(elwoodSessionId, error, "final_flush"));
+            }
+            catch { } // a diagnostic-listener bug must not block lifecycle completion
+        }
+        finally {
+            afterFlush();
+        }
+    };
+    return { watcher, flushPendingWarnings, finishSafely };
+}
+/** Turn-boundary hooks: a first observe here recovers the already-committed tail. */
+const turnBoundaryHooks = new Set(["Stop", "SubagentStop"]);
+/**
+ * Points the watcher at every transcript path the hook payload carries. A
+ * `SubagentStop` event has both a main `transcript_path` and a required
+ * `agent_transcript_path`; both must be observed (PRD §5.4). The watcher keeps
+ * an independent cursor per path and no-ops on an already-observed path.
+ *
+ * Backward tail recovery runs only when the FIRST observe of a path lands on a
+ * turn-boundary hook (`Stop`/`SubagentStop`) — the case where a just-committed
+ * turn would otherwise be missed. On `SessionStart`/resume the first observe
+ * baselines at EOF with no recovery, so a resumed session never republishes the
+ * prior conversation's final assistant/tool turn (PRD §5.4, C-CLAUDE-15).
+ */
+export function observeTranscript(watcher, event) {
+    const hook = event["hook_event_name"];
+    const recoverTail = turnBoundaryHooks.has(hook);
+    for (const key of ["transcript_path", "agent_transcript_path"]) {
+        const path = event[key];
+        if (typeof path !== "string" || path.length === 0)
+            continue;
+        watcher.observe(path, recoverTail);
+        // A SubagentStop's agent transcript is a one-shot input: flush it now and
+        // retire it from active polling so a long session with many subagents does
+        // not accumulate cursors statted twice a second forever (PRD §5.4). The flush
+        // shares the watcher-wide terminal budget and a wall-clock slice, so it cannot
+        // stall the hook-dispatch path with a hundreds-of-MiB synchronous loop (§9.2).
+        if (hook === "SubagentStop" && key === "agent_transcript_path")
+            watcher.retire(path);
+    }
+}
+//# sourceMappingURL=session-transcript.js.map

package/dist/claude/session-transcript.js.map

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

package/dist/claude/session.d.ts

@@ -0,0 +1,18 @@
+/** ClaudeSessionApi entry points: preflight, record creation, and socket-home-guarded start. Implements PRD §5, §6, §8, §9. */
+import type { StartClaudeOptions } from "../core/types.ts";
+import type { SessionRecord } from "../state/store.ts";
+import type { ClaudePreflightWarning } from "./preflight.ts";
+import { resetClaudeHookBridgeFactoryForTests, setHookBridgeFactoryForTests } from "./session-bridge.ts";
+import type { ClaudeSessionApi } from "./session-interface.ts";
+export { resetClaudeHookBridgeFactoryForTests as resetClaudeSessionSeamsForTests, setHookBridgeFactoryForTests, };
+/**
+ * @deprecated Prefer the `ClaudeSession` class (`new ClaudeSession(options)`), which starts
+ * lazily and exposes both `send`/`stream` and this full control surface. `startClaude`
+ * remains the low-level eager factory and is used internally; it will be removed once the
+ * sole consumer migrates.
+ */
+export declare function startClaude(rawOptions: StartClaudeOptions): Promise<ClaudeSessionApi>;
+/** Internal deterministic-identity start used by owners that must clean failed launch state. */
+export declare function startClaudeWithId(rawOptions: StartClaudeOptions, elwoodSessionId: string): Promise<ClaudeSessionApi>;
+export declare function startClaudeFromRecord(record: SessionRecord, stateDir: string, options: StartClaudeOptions, resumed: boolean, preflightWarning: ClaudePreflightWarning | undefined): Promise<import("./session-instance.ts").ClaudeSessionImpl>;
+//# sourceMappingURL=session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/claude/session.ts"],"names":[],"mappings":"AAAA,+HAA+H;AAM/H,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAK3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAE7D,OAAO,EACL,oCAAoC,EACpC,4BAA4B,EAC7B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,OAAO,EACL,oCAAoC,IAAI,+BAA+B,EACvE,4BAA4B,GAC7B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,kBAAkB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAErF;AAED,gGAAgG;AAChG,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,kBAAkB,EAC9B,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,gBAAgB,CAAC,CAe3B;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE,OAAO,EAChB,gBAAgB,EAAE,sBAAsB,GAAG,SAAS,8DAwBrD"}

package/dist/claude/session.js

@@ -0,0 +1,58 @@
+/** ClaudeSessionApi entry points: preflight, record creation, and socket-home-guarded start. Implements PRD §5, §6, §8, §9. */
+import { randomUUID } from "node:crypto";
+import { resolve } from "node:path";
+import { queuePersonaMessage } from "../core/persona.js";
+import { claudeReasoningEfforts, validateReasoningEffort } from "../core/reasoning-effort.js";
+import { withSocketHomeCleanup } from "../runtime/startup-cleanup.js";
+import { claudeLaunchPosture, withClaudeLaunch } from "../state/launch-posture.js";
+import { sessionRuntime } from "../state/runtime-paths.js";
+import { removeOwnSocketFile } from "../state/socket-home.js";
+import { createSessionRecord, defaultStateDir, prepareStateDir } from "../state/store.js";
+import { preflightClaude } from "./preflight.js";
+import { resetClaudeHookBridgeFactoryForTests, setHookBridgeFactoryForTests, } from "./session-bridge.js";
+import { buildClaudeSession } from "./session-build.js";
+export { resetClaudeHookBridgeFactoryForTests as resetClaudeSessionSeamsForTests, setHookBridgeFactoryForTests, };
+/**
+ * @deprecated Prefer the `ClaudeSession` class (`new ClaudeSession(options)`), which starts
+ * lazily and exposes both `send`/`stream` and this full control surface. `startClaude`
+ * remains the low-level eager factory and is used internally; it will be removed once the
+ * sole consumer migrates.
+ */
+export function startClaude(rawOptions) {
+    return startClaudeWithId(rawOptions, randomUUID());
+}
+/** Internal deterministic-identity start used by owners that must clean failed launch state. */
+export async function startClaudeWithId(rawOptions, elwoodSessionId) {
+    // Resolve BOTH cwd and stateDir to ABSOLUTE before the preflight `await`: a relative
+    // path resolved after the await could point elsewhere if the caller's (or preflight's)
+    // process.cwd() changed during it, splitting where state is written from where the CLI
+    // launches (§8.1, §8.2). Thread the resolved cwd everywhere so the record, launch, and
+    // PTY spawn all agree.
+    const options = { ...rawOptions, cwd: resolve(rawOptions.cwd) };
+    const stateDir = resolve(options.stateDir ?? defaultStateDir(options.cwd));
+    const strict = options.strictVersionCheck ?? false;
+    const warning = await preflightClaude(strict, options.autoupdate ?? false);
+    prepareStateDir(stateDir, { gitignore: options.stateDir === undefined });
+    const createdRecord = createSessionRecord({ cwd: options.cwd, id: elwoodSessionId });
+    const record = withClaudeLaunch(createdRecord, claudeLaunchPosture(options));
+    const session = await startClaudeFromRecord(record, stateDir, options, false, warning);
+    return queuePersonaMessage(session, options.persona);
+}
+export function startClaudeFromRecord(record, stateDir, options, resumed, preflightWarning) {
+    // Validate the effort enum before any spawn (C-CLAUDE-20): both start and resume
+    // funnel through here, so a bad value fails fast at the single chokepoint.
+    validateReasoningEffort(options.reasoningEffort, claudeReasoningEfforts, "claude_invalid_reasoning_effort");
+    // `sessionRuntime` ensures the session's STABLE out-of-tree home and reserves a FRESH
+    // per-launch socket PATH inside it; the socket is bound later, by `bridge.start()`
+    // (after the state/runtime files are written). Wrap the WHOLE build so ANY failure
+    // before the session takes ownership removes THIS launch's own socket file — never the
+    // shared home, which a concurrent launch may own (§9.1). On success ownership transfers
+    // to the returned session, whose teardown removes the whole home via removeSessionFiles.
+    const runtime = sessionRuntime({
+        stateDir,
+        elwoodSessionId: record.elwoodSessionId,
+        adapter: "claude",
+    });
+    return withSocketHomeCleanup(() => removeOwnSocketFile(runtime.socketPath), () => buildClaudeSession({ record, stateDir, runtime, options, resumed, preflightWarning }));
+}
+//# sourceMappingURL=session.js.map

package/dist/claude/session.js.map

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

package/dist/claude/settings.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Generates Claude session settings containing Elwood hook bridge wiring.
+ * Implements PRD §4.3 and §6.1.
+ */
+import type { StartClaudeOptions } from "../core/types.ts";
+export type GeneratedSettingsInput = {
+    readonly bridgeScriptPath: string;
+    readonly options: Pick<StartClaudeOptions, "settingsOverrides">;
+    /** The CLI-side per-hook timeout written into the settings (see session/runtime.ts). */
+    readonly timeoutSeconds: number;
+};
+/** Caller overrides (including any `permissions`) pass through; Elwood adds only `hooks`. */
+export declare function generateClaudeSettings(input: GeneratedSettingsInput): Readonly<Record<string, unknown>>;
+//# sourceMappingURL=settings.d.ts.map

package/dist/claude/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/claude/settings.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAK3D,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,CAAC;IAChE,wFAAwF;IACxF,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC,CAAC;AAEF,6FAA6F;AAC7F,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,sBAAsB,GAC5B,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAKnC"}

package/dist/claude/settings.js

@@ -0,0 +1,34 @@
+/**
+ * Generates Claude session settings containing Elwood hook bridge wiring.
+ * Implements PRD §4.3 and §6.1.
+ */
+import { hookCommand } from "../runtime/hook-command.js";
+import { claudeHookEventNames } from "./hooks/index.js";
+import { isToolHookEventName } from "./hooks/tool-events.js";
+/** Caller overrides (including any `permissions`) pass through; Elwood adds only `hooks`. */
+export function generateClaudeSettings(input) {
+    return {
+        ...input.options.settingsOverrides,
+        hooks: generateHooks(input.bridgeScriptPath, input.timeoutSeconds),
+    };
+}
+function generateHooks(bridgeScriptPath, timeout) {
+    const hooks = {};
+    for (const eventName of claudeHookEventNames) {
+        hooks[eventName] = [
+            {
+                // Tool events need a matcher; "*" routes every tool through the bridge.
+                ...(isToolHookEventName(eventName) ? { matcher: "*" } : {}),
+                hooks: [
+                    {
+                        type: "command",
+                        command: hookCommand(bridgeScriptPath),
+                        timeout,
+                    },
+                ],
+            },
+        ];
+    }
+    return hooks;
+}
+//# sourceMappingURL=settings.js.map

package/dist/claude/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../src/claude/settings.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAS7D,6FAA6F;AAC7F,MAAM,UAAU,sBAAsB,CACpC,KAA6B;IAE7B,OAAO;QACL,GAAG,KAAK,CAAC,OAAO,CAAC,iBAAiB;QAClC,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC,gBAAgB,EAAE,KAAK,CAAC,cAAc,CAAC;KACnE,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CACpB,gBAAwB,EACxB,OAAe;IAEf,MAAM,KAAK,GAA4B,EAAE,CAAC;IAC1C,KAAK,MAAM,SAAS,IAAI,oBAAoB,EAAE,CAAC;QAC7C,KAAK,CAAC,SAAS,CAAC,GAAG;YACjB;gBACE,wEAAwE;gBACxE,GAAG,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3D,KAAK,EAAE;oBACL;wBACE,IAAI,EAAE,SAAS;wBACf,OAAO,EAAE,WAAW,CAAC,gBAAgB,CAAC;wBACtC,OAAO;qBACR;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}