@with-logic/elwood 0.1.0

package/dist/claude/session/instance.js

@@ -0,0 +1,146 @@
+import { sessionWaitForActivity, sessionWaitForStatus } from "../../core/session-wait.js";
+import { terminalStatuses } from "../../core/status-categories.js";
+import { emitSessionWarnings } from "../../core/warnings/session.js";
+import { AgentSessionBase } from "../../runtime/session/base.js";
+import { runCleanupSteps } from "../../runtime/shutdown/teardown.js";
+import { updateSessionResumeId } from "../../state/store.js";
+import { attachClaudeImages } from "../attach-images.js";
+import { runSessionLogin } from "../login/session-login.js";
+import { LoginExpiredWatcher, loginExpiredWarning } from "../login-expired.js";
+import { claudeModelPicker } from "../model-picker.js";
+import { resizeRestoreFailedWarning } from "../resize-restore.js";
+import { CLAUDE_STARTUP_MIN_COLS } from "../startup-size.js";
+export class ClaudeSessionImpl extends AgentSessionBase {
+    picker = claudeModelPicker;
+    bridge;
+    emitter;
+    requestedSize;
+    // Only a session requested BELOW the 100-column startup floor bootstraps wide and
+    // defers its restore to readiness (C-API-36); a 100+ session resizes immediately.
+    awaitingInitialReady;
+    // Whether the one-shot initial-ready transition has already run (idempotent).
+    initialReadyDone = false;
+    // Edge-detects a mid-session login-expiry banner so it warns once per occurrence.
+    loginExpiredWatcher = new LoginExpiredWatcher();
+    constructor(record, stateDir, runtime, pty, terminal, bridge, emitter, terminalReplay, requestedSize, loopDefinitions) {
+        super("claude", record, stateDir, runtime, pty, terminal, emitter, terminalReplay, loopDefinitions);
+        this.bridge = bridge;
+        this.emitter = emitter;
+        this.requestedSize = requestedSize;
+        this.awaitingInitialReady = requestedSize.cols < CLAUDE_STARTUP_MIN_COLS;
+    }
+    on(event, handler) {
+        // REGISTER before replaying buffered `terminal:data`: a throwing replay handler must still be
+        // subscribed for FUTURE data (otherwise startup telemetry silently disappears). Replay is of
+        // already-buffered past data and runs synchronously, so no live event interleaves.
+        const unsubscribe = this.emitter.on(event, handler);
+        this.replayFor(event, handler);
+        return unsubscribe;
+    }
+    off(event, handler) {
+        this.emitter.off(event, handler);
+    }
+    waitForStatus(match, timeoutMs) {
+        return sessionWaitForStatus(this, match, timeoutMs);
+    }
+    waitForActivity(match, timeoutMs) {
+        return sessionWaitForActivity(this, match, timeoutMs);
+    }
+    // Captured staged chip: "❯ [Pasted text #1 +15 lines]" (claude 2.1.201).
+    stagedPaste(screen) {
+        return /\[Pasted text/.test(screen);
+    }
+    // Claude reads a pasted absolute path; the paste is held while a dialog shows (C-API-45/37).
+    attachImages = (paths, signal) => attachClaudeImages(this.terminal, paths, signal, () => this.status === "blocked");
+    // A narrow session holds the PHYSICAL resize until readiness; it just records the
+    // requested geometry now and restores it at the initial-ready transition. A wide
+    // session (100+ cols) never deferred; it resizes now.
+    resize(size) {
+        if (!(this.awaitingInitialReady && !terminalStatuses.has(this.status))) {
+            this.requestedSize = size;
+            return super.resize(size);
+        }
+        // Non-terminal here: capture the requested geometry to restore at readiness
+        // without disturbing the live bootstrap width (C-API-25/39).
+        this.requestedSize = size;
+        return Promise.resolve();
+    }
+    // Restore deferred geometry (narrow only) then advance readiness — which MUST run even
+    // if the restore/warning throws, or queued messages starve (C-API-39/36). Idempotent.
+    completeInitialReady() {
+        if (this.initialReadyDone)
+            return Promise.resolve();
+        this.initialReadyDone = true;
+        const wasNarrowBootstrap = this.awaitingInitialReady;
+        this.awaitingInitialReady = false;
+        try {
+            if (wasNarrowBootstrap)
+                this.restoreRequestedSize();
+        }
+        finally {
+            this.advanceInitialReady();
+        }
+        return Promise.resolve();
+    }
+    // Apply the deferred physical geometry, so only a genuine native resize failure
+    // reports as staying at bootstrap width (C-API-39).
+    restoreRequestedSize() {
+        try {
+            this.restoreHeldSize(this.requestedSize);
+        }
+        catch (error) {
+            // Isolated so a throwing warning/activity listener cannot skip readiness.
+            try {
+                this.emitWarnings([
+                    resizeRestoreFailedWarning(this.elwoodSessionId, this.requestedSize, error),
+                ]);
+            }
+            catch {
+                // A warning-sink/listener failure must never block readiness release.
+            }
+        }
+    }
+    rememberClaudeSessionId(sessionId) {
+        if (this.record.claude.resumeId)
+            return;
+        this.persist(updateSessionResumeId(this.record, "claude", sessionId));
+    }
+    emitWarnings(warnings) {
+        emitSessionWarnings(warnings, {
+            warning: (event) => this.emitter.emit("warning", event),
+            activity: (event) => this.emitter.emit("activity", event),
+        });
+    }
+    // Surface a mid-session login-expiry banner once (C-CLAUDE-18): gated on prior
+    // readiness (startup handles it fatally), edge-detected. FULLY non-throwing — runs
+    // in the frame callback's detached continuation, so a listener failure can't become
+    // an unhandled rejection or skip `terminal:data`. COMMIT the edge BEFORE the live
+    // fan-out: warnings are live-only (fire exactly once), and emitWarnings delivers to
+    // every listener before rethrowing a listener error — committing after would treat
+    // a throwing listener as non-delivery and re-fire the SAME incident to the listeners
+    // that already received it (a duplicate). A throwing listener is contained here.
+    noteLoginExpiry(screenText) {
+        if (!(this.everReady && this.loginExpiredWatcher.peek(screenText)))
+            return;
+        this.loginExpiredWatcher.commit();
+        try {
+            this.emitWarnings([loginExpiredWarning(this.elwoodSessionId)]);
+        }
+        catch {
+            // Live-only: a throwing listener is contained and the warning is dropped, not
+            // re-fired — the edge is already committed so a persistent banner warns once.
+        }
+    }
+    // Drive `/login` re-auth as an exclusive, abort-aware queue transaction (C-API-43).
+    login(options) {
+        const onReady = (handler) => this.emitter.on("status", (e) => e.status === "ready" && handler());
+        const blocked = () => this.status === "blocked";
+        const deps = { controlQueue: this.controlQueue, terminal: this.terminal, blocked, onReady };
+        return this.inSession(() => runSessionLogin(deps, options));
+    }
+    stopRuntime() {
+        // Dispose the terminal even if the bridge stop rejects — no first-failure leak (§9.4).
+        return runCleanupSteps([() => this.bridge.stop(), () => this.terminal.dispose()]);
+    }
+}
+//# sourceMappingURL=instance.js.map

package/dist/claude/session/instance.js.map

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

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/index.ts";
+import type { SendOptions } from "../../core/images/types.ts";
+import type { LoopControls } from "../../core/loops/loop-controls.ts";
+import type { AgentModelOption } from "../../core/models/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=interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"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=interface.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"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 "./interface.ts";
+export declare function resumeClaude(options: ResumeClaudeOptions): Promise<ClaudeSessionApi>;
+//# sourceMappingURL=resume.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resume.d.ts","sourceRoot":"","sources":["../../../src/claude/session/resume.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAS/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,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 "./index.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=resume.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"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,sBAAsB,CAAC;AAEnD,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAGnD,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/index.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=runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/claude/session/runtime.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,QAAQ,MAAM,8BAA8B,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAG3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EACV,cAAc,EAGd,kBAAkB,EAClB,YAAY,EACb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAK9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAK1D,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/index.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=runtime.js.map

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

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

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

@@ -0,0 +1,12 @@
+/**
+ * Claude try-resume-else-start convenience entry point.
+ * Implements PRD §5.2 and C-API-26.
+ */
+import { type StartOrResumeResult } from "../../core/start-or-resume.ts";
+import type { StartClaudeOptions } from "../../core/types.ts";
+import type { ClaudeSessionApi } from "./interface.ts";
+export type StartOrResumeClaudeOptions = StartClaudeOptions & {
+    readonly elwoodSessionId?: string;
+};
+export declare function startOrResumeClaude(options: StartOrResumeClaudeOptions): Promise<StartOrResumeResult<ClaudeSessionApi>>;
+//# sourceMappingURL=start-or-resume.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"start-or-resume.d.ts","sourceRoot":"","sources":["../../../src/claude/session/start-or-resume.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,mBAAmB,EAAiB,MAAM,+BAA+B,CAAC;AACxF,OAAO,KAAK,EAAuB,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAGnF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGvD,MAAM,MAAM,0BAA0B,GAAG,kBAAkB,GAAG;IAC5D,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC,CAAC;AAEF,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,CAAC,CAOhD"}

package/dist/claude/session/start-or-resume.js

@@ -0,0 +1,32 @@
+/**
+ * Claude try-resume-else-start convenience entry point.
+ * Implements PRD §5.2 and C-API-26.
+ */
+import { startOrResume } from "../../core/start-or-resume.js";
+import { compact } from "../../state/launch-posture.js";
+import { startClaude } from "./index.js";
+import { resumeClaude } from "./resume.js";
+export function startOrResumeClaude(options) {
+    const { elwoodSessionId, ...startOptions } = options;
+    return startOrResume(elwoodSessionId, (id) => resumeClaude(resumeOptions(id, startOptions)), () => startClaude(startOptions));
+}
+// Every resume-relevant start option is forwarded (PRD §5.2); `compact` drops the
+// absent ones so `exactOptionalPropertyTypes` sees no explicit `undefined`.
+function resumeOptions(elwoodSessionId, start) {
+    const forwarded = compact({
+        stateDir: start.stateDir,
+        hooks: start.hooks,
+        initialSize: start.initialSize,
+        reasoningEffort: start.reasoningEffort,
+        permissionMode: start.permissionMode,
+        allowedTools: start.allowedTools,
+        disallowedTools: start.disallowedTools,
+        tools: start.tools,
+        autoupdate: start.autoupdate,
+        autotrust: start.autotrust,
+        hookTimeoutMs: start.hookTimeoutMs,
+        strictVersionCheck: start.strictVersionCheck,
+    });
+    return { elwoodSessionId, cwd: start.cwd, ...forwarded };
+}
+//# sourceMappingURL=start-or-resume.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"start-or-resume.js","sourceRoot":"","sources":["../../../src/claude/session/start-or-resume.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAA4B,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAExF,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAM3C,MAAM,UAAU,mBAAmB,CACjC,OAAmC;IAEnC,MAAM,EAAE,eAAe,EAAE,GAAG,YAAY,EAAE,GAAG,OAAO,CAAC;IACrD,OAAO,aAAa,CAClB,eAAe,EACf,CAAC,EAAE,EAAE,EAAE,CAAC,YAAY,CAAC,aAAa,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC,EACrD,GAAG,EAAE,CAAC,WAAW,CAAC,YAAY,CAAC,CAChC,CAAC;AACJ,CAAC;AAED,kFAAkF;AAClF,4EAA4E;AAC5E,SAAS,aAAa,CAAC,eAAuB,EAAE,KAAyB;IACvE,MAAM,SAAS,GAAG,OAAO,CAAuD;QAC9E,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;KAC7C,CAAC,CAAC;IACH,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,GAAG,SAAS,EAAE,CAAC;AAC3D,CAAC"}

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/index.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=transcript.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transcript.d.ts","sourceRoot":"","sources":["../../../src/claude/session/transcript.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,QAAQ,MAAM,8BAA8B,CAAC;AACzD,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAGjE,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"}