@with-logic/elwood 0.1.0

package/dist/claude/serialize.js

@@ -0,0 +1,45 @@
+/**
+ * Converts typed hook handler results to Claude hook process output.
+ * Implements PRD §6.4.
+ */
+export function serializeHookResult(eventName, result) {
+    if (result === undefined)
+        return { exitCode: 0, stdout: "", stderr: "" };
+    if ("behavior" in result)
+        return jsonOutput(permissionRequest(eventName, result));
+    if ("retry" in result)
+        return jsonOutput({ hookSpecificOutput: { hookEventName: eventName, retry: true } });
+    if ("worktreePath" in result)
+        return worktree(result.worktreePath);
+    if ("decision" in result)
+        return jsonOutput(topLevel(eventName, result));
+    if ("continue" in result)
+        return jsonOutput(result);
+    // PreToolUse decisions, elicitation actions, and context/output fields all
+    // travel as hook-specific output keyed by the event name.
+    return jsonOutput({ hookSpecificOutput: { hookEventName: eventName, ...result } });
+}
+function jsonOutput(value) {
+    return { exitCode: 0, stdout: `${JSON.stringify(value)}\n`, stderr: "" };
+}
+function permissionRequest(eventName, result) {
+    return { hookSpecificOutput: { hookEventName: eventName, decision: result } };
+}
+function topLevel(eventName, result) {
+    return {
+        decision: result.decision,
+        reason: result.reason,
+        ...(result.additionalContext === undefined
+            ? {}
+            : {
+                hookSpecificOutput: {
+                    hookEventName: eventName,
+                    additionalContext: result.additionalContext,
+                },
+            }),
+    };
+}
+function worktree(path) {
+    return { exitCode: 0, stdout: `${path}\n`, stderr: "" };
+}
+//# sourceMappingURL=serialize.js.map

package/dist/claude/serialize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.js","sourceRoot":"","sources":["../../src/claude/serialize.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,MAAM,UAAU,mBAAmB,CACjC,SAA8B,EAC9B,MAAwB;IAExB,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACzE,IAAI,UAAU,IAAI,MAAM;QAAE,OAAO,UAAU,CAAC,iBAAiB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IAClF,IAAI,OAAO,IAAI,MAAM;QACnB,OAAO,UAAU,CAAC,EAAE,kBAAkB,EAAE,EAAE,aAAa,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IACvF,IAAI,cAAc,IAAI,MAAM;QAAE,OAAO,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IACnE,IAAI,UAAU,IAAI,MAAM;QAAE,OAAO,UAAU,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IACzE,IAAI,UAAU,IAAI,MAAM;QAAE,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;IACpD,2EAA2E;IAC3E,0DAA0D;IAC1D,OAAO,UAAU,CAAC,EAAE,kBAAkB,EAAE,EAAE,aAAa,EAAE,SAAS,EAAE,GAAG,MAAM,EAAE,EAAE,CAAC,CAAC;AACrF,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AAC3E,CAAC;AAED,SAAS,iBAAiB,CAAC,SAAiB,EAAE,MAA+B;IAC3E,OAAO,EAAE,kBAAkB,EAAE,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC;AAChF,CAAC;AAED,SAAS,QAAQ,CACf,SAAiB,EACjB,MAIC;IAED,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,GAAG,CAAC,MAAM,CAAC,iBAAiB,KAAK,SAAS;YACxC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC;gBACE,kBAAkB,EAAE;oBAClB,aAAa,EAAE,SAAS;oBACxB,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;iBAC5C;aACF,CAAC;KACP,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AAC1D,CAAC"}

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

@@ -0,0 +1,11 @@
+/**
+ * Claude session hook bridge factory seam.
+ * Implements PRD §6.2 and §13.
+ */
+import { HookBridgeServer } from "../../bridge/server.ts";
+import type { HookBridge } from "./instance.ts";
+export type ClaudeHookBridgeFactory = (socketPath: string, token: string, elwoodSessionId: string, dispatch: ConstructorParameters<typeof HookBridgeServer>[2], onError: ConstructorParameters<typeof HookBridgeServer>[3]) => HookBridge;
+export declare function currentClaudeHookBridgeFactory(): ClaudeHookBridgeFactory;
+export declare function setHookBridgeFactoryForTests(next: ClaudeHookBridgeFactory): void;
+export declare function resetClaudeHookBridgeFactoryForTests(): void;
+//# sourceMappingURL=bridge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../../src/claude/session/bridge.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,MAAM,uBAAuB,GAAG,CACpC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,qBAAqB,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC,CAAC,EAC3D,OAAO,EAAE,qBAAqB,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC,CAAC,KACvD,UAAU,CAAC;AAOhB,wBAAgB,8BAA8B,IAAI,uBAAuB,CAExE;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,uBAAuB,GAAG,IAAI,CAEhF;AAED,wBAAgB,oCAAoC,IAAI,IAAI,CAE3D"}

package/dist/claude/session/bridge.js

@@ -0,0 +1,18 @@
+/**
+ * Claude session hook bridge factory seam.
+ * Implements PRD §6.2 and §13.
+ */
+import { HookBridgeServer } from "../../bridge/server.js";
+import { isClaudeHookInput } from "../validate/input.js";
+const realFactory = (socketPath, token, id, dispatch, onError) => new HookBridgeServer(socketPath, token, dispatch, onError, isClaudeHookInput, id);
+let factory = realFactory;
+export function currentClaudeHookBridgeFactory() {
+    return factory;
+}
+export function setHookBridgeFactoryForTests(next) {
+    factory = next;
+}
+export function resetClaudeHookBridgeFactoryForTests() {
+    factory = realFactory;
+}
+//# sourceMappingURL=bridge.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../../../src/claude/session/bridge.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAWzD,MAAM,WAAW,GAA4B,CAAC,UAAU,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,CACxF,IAAI,gBAAgB,CAAC,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,iBAAiB,EAAE,EAAE,CAAC,CAAC;AAEpF,IAAI,OAAO,GAAG,WAAW,CAAC;AAE1B,MAAM,UAAU,8BAA8B;IAC5C,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,IAA6B;IACxE,OAAO,GAAG,IAAI,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,oCAAoC;IAClD,OAAO,GAAG,WAAW,CAAC;AACxB,CAAC"}

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

@@ -0,0 +1,15 @@
+import type { StartClaudeOptions } from "../../core/types.ts";
+import type { SessionRuntime } from "../../state/runtime-paths.ts";
+import { type SessionRecord } from "../../state/store.ts";
+import { type ClaudePreflightWarning } from "../preflight.ts";
+import { ClaudeSessionImpl } from "./instance.ts";
+export type BuildClaudeSessionInput = {
+    readonly record: SessionRecord;
+    readonly stateDir: string;
+    readonly runtime: SessionRuntime;
+    readonly options: StartClaudeOptions;
+    readonly resumed: boolean;
+    readonly preflightWarning: ClaudePreflightWarning | undefined;
+};
+export declare function buildClaudeSession(input: BuildClaudeSessionInput): Promise<ClaudeSessionImpl>;
+//# sourceMappingURL=build.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/claude/session/build.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAkB,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAQ9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,KAAK,aAAa,EAAsB,MAAM,sBAAsB,CAAC;AAE9E,OAAO,EAAE,KAAK,sBAAsB,EAAkB,MAAM,iBAAiB,CAAC;AAK9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAUlD,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,sBAAsB,GAAG,SAAS,CAAC;CAC/D,CAAC;AAEF,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,iBAAiB,CAAC,CAkJ5B"}

package/dist/claude/session/build.js

@@ -0,0 +1,147 @@
+/** Builds a live ClaudeSessionApi from a record + runtime. Implements PRD §5, §6, §8, §9. */
+import { defaultTerminalSize } from "../../core/defaults.js";
+import { causeDetails, elwoodError } from "../../core/errors.js";
+import { observeRenderedFrame } from "../../core/rendered-observers.js";
+import { createStartupWarningGate, deliverFrameWarnings } from "../../core/startup/frame.js";
+import { emitSettledStartupOutcomes } from "../../core/startup/write.js";
+import { TerminalReplayBuffer } from "../../core/terminal-replay.js";
+import { TypedEmitter } from "../../events/emitter.js";
+import { loadRuntimeLoopDefinitions as loadLoops } from "../../runtime/loop-restore.js";
+import { createReadinessGate } from "../../runtime/session/readiness.js";
+import { assertStartupThenRelease, createStartupBuffer } from "../../runtime/startup/buffer.js";
+import { cleanupStartupResources, guardStartupRegion } from "../../runtime/startup/cleanup.js";
+import { secureMkdir } from "../../state/files.js";
+import { writeSessionRecord } from "../../state/store.js";
+import { attachPtyTerminal } from "../../terminal/headless.js";
+import { preflightEvent } from "../preflight.js";
+import { ClaudeStartupPromptResponder } from "../startup-prompts.js";
+import { CLAUDE_STARTUP_MIN_COLS } from "../startup-size.js";
+import { currentClaudeHookBridgeFactory } from "./bridge.js";
+import { buildClaudeHookErrorHandler, buildClaudeHookHandler } from "./hook-handler.js";
+import { ClaudeSessionImpl } from "./instance.js";
+import { buildClaudeObservers, handleClaudeExit, registerInitialHooks, spawnClaudePty, writeRuntimeFiles, } from "./runtime.js";
+import { createTranscriptWatcher, observeTranscript } from "./transcript.js";
+export async function buildClaudeSession(input) {
+    const { record, stateDir, runtime, options, resumed, preflightWarning } = input;
+    secureMkdir(runtime.sessionDir);
+    writeSessionRecord(record, runtime.sessionDir);
+    const loopDefinitions = resumed ? loadLoops(stateDir, record.elwoodSessionId) : [];
+    writeRuntimeFiles(runtime, options);
+    const emitter = new TypedEmitter();
+    registerInitialHooks(emitter, options.hooks);
+    let session;
+    // ALL startup-region warnings — startup-prompt (frame path) AND transcript
+    // drop/read-error diagnostics — route through ONE gate that buffers anything emitted
+    // before startClaude resolves and flushes it on a deferred macrotask after return,
+    // so every source stays observable without late-subscriber replay (C-API-14).
+    const warnGate = createStartupWarningGate({
+        emitWarnings: (w) => deliverFrameWarnings(session, w),
+    });
+    const wired = createTranscriptWatcher(record.elwoodSessionId, emitter, () => warnGate);
+    const { watcher: transcriptWatcher, flushPendingWarnings, finishSafely } = wired;
+    // Initial readiness is hook-backed (`InstructionsLoaded` fires `mark`); the first
+    // frame arms a starvation deadline so a missing/failed hook cannot starve the queue,
+    // and on resume the first composer frame also marks ready (PRD §5.3, C-API-28).
+    const autotrust = options.autotrust ?? false;
+    // Observers are built BEFORE the readiness gate so its callback never closes
+    // over a binding declared later in this function.
+    const observers = buildClaudeObservers(record.elwoodSessionId, autotrust, emitter);
+    const turnWatcher = observers.turn;
+    const { ready, observeReadinessFrame } = createReadinessGate(() => {
+        turnWatcher.arm(resumed); // resume arms in settling mode (no phantom replay turn)
+        // completeInitialReady advances readiness in a finally, isolating restore/warning
+        // failures internally, so its promise never rejects (not awaited).
+        void session?.completeInitialReady();
+    }, resumed);
+    const bridge = currentClaudeHookBridgeFactory()(runtime.socketPath, runtime.bridgeToken, record.elwoodSessionId, buildClaudeHookHandler({
+        record,
+        options,
+        emitter,
+        transcriptWatcher,
+        ready,
+        getSession: () => session,
+        getTurnWatcher: () => turnWatcher,
+        observeHookTranscript: (event) => observeTranscript(transcriptWatcher, event),
+    }), buildClaudeHookErrorHandler(record, emitter));
+    try {
+        await bridge.start();
+    }
+    catch (error) {
+        // Best-effort shut down a partially-started bridge so its listener/socket is not
+        // leaked; contained so the original bridge-start error is the one that rejects.
+        await bridge.stop().catch(() => undefined);
+        throw elwoodError("hook_bridge_failed", "Could not start Elwood hook bridge.", {
+            ...causeDetails(error),
+            socketPath: runtime.socketPath,
+        });
+    }
+    const requestedSize = options.initialSize ?? defaultTerminalSize;
+    const startupSize = {
+        ...requestedSize,
+        cols: Math.max(requestedSize.cols, CLAUDE_STARTUP_MIN_COLS),
+    };
+    let pty;
+    try {
+        pty = spawnClaudePty(record, runtime.settingsPath, { ...options, initialSize: startupSize });
+    }
+    catch (error) {
+        await cleanupStartupResources({ bridge });
+        throw error;
+    }
+    const startupOutput = createStartupBuffer();
+    let startupExit;
+    const terminalReplay = new TerminalReplayBuffer(record.elwoodSessionId);
+    terminalReplay.captureStartupAttention(emitter);
+    const promptResponder = new ClaudeStartupPromptResponder(autotrust);
+    let latestRenderedText = "";
+    const terminal = attachPtyTerminal(startupSize, pty, (data, renderedTerminal) => {
+        startupOutput.push(data);
+        terminalReplay.push(data);
+        latestRenderedText = renderedTerminal.snapshot().text;
+        const frame = { text: latestRenderedText, title: renderedTerminal.title };
+        // The write RETURNS its `sendInput` completion (no longer swallowed): the
+        // responder settles the prompt and its `startup_prompt` activity only after
+        // the write fulfills, and a rejected write stays retryable + warns (C-CLAUDE-16).
+        const autos = promptResponder.handle(frame.text, (input) => renderedTerminal.sendInput(input), () => latestRenderedText);
+        // Warning delivery is CONTAINED on the frame path: a throwing `warning`/`activity`
+        // listener must never skip readiness, login detection, or terminal:data (§5.7).
+        emitSettledStartupOutcomes(emitter, "claude", record.elwoodSessionId, autos, {
+            emitWarnings: (warnings) => warnGate.emitWarnings(warnings),
+        });
+        // Hook-backed readiness + deadline fallback; on resume the first composer also marks ready (C-API-28).
+        ready.armDeadline();
+        const reading = observeRenderedFrame(observers, frame, session);
+        observeReadinessFrame(reading.facts); // blocking gate + resume-composer mark
+        // Surface a mid-session login-expiry banner once (C-CLAUDE-18); no-op pre-readiness.
+        session?.noteLoginExpiry(frame.text);
+        emitter.emit("terminal:data", { elwoodSessionId: record.elwoodSessionId, data });
+    });
+    session = new ClaudeSessionImpl(record, stateDir, runtime, pty, terminal, bridge, emitter, terminalReplay, requestedSize, loopDefinitions);
+    const active = session;
+    const beforeCleanup = () => active.pauseLoopsForStartupCleanup(ready.cancel);
+    // Guard every live-resource step after session creation: a failure in any of them
+    // tears down the now-live PTY, bridge, terminal, and watcher first (PRD §9.1, §9.4).
+    await guardStartupRegion(async () => {
+        active.startLoops();
+        flushPendingWarnings(); // sink now exists: flush any early-buffered diagnostic (§5.7)
+        // A hook or deadline that fired before the session existed submitted nothing
+        // (evidence is `session?.`-guarded); replay it now the session can consume it.
+        ready.replay();
+        pty.onExit((exit) => {
+            startupExit = exit;
+            ready.cancel(); // No queued message can release after exit; drop the pending deadline.
+            handleClaudeExit(emitter, record.elwoodSessionId, exit, finishSafely, () => active.submitExit());
+        });
+        // Release the startup buffer once the check settles (§9.4).
+        await assertStartupThenRelease("claude", startupOutput, () => startupExit);
+        active.submitEvidence("startup_usable");
+    }, { before: beforeCleanup, pty, bridge, terminal, after: () => transcriptWatcher.stop() });
+    // Open buffered startup warnings after return so synchronous subscribers see them (C-API-14).
+    if (preflightWarning !== undefined) {
+        warnGate.emitWarnings([preflightEvent(record.elwoodSessionId, preflightWarning)]);
+    }
+    warnGate.openAfterReturn();
+    terminalReplay.releaseStartupAttentionAfterReturn();
+    return session;
+}
+//# sourceMappingURL=build.js.map

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

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

package/dist/claude/session/hook-handler.d.ts

@@ -0,0 +1,34 @@
+/**
+ * The Claude hook-bridge message and error handlers that `build.ts` hands
+ * to the bridge factory. Implements PRD §5.3, §5.4, §6, and §8:
+ * normalize each hook, emit its `hook`/`activity` events, run the caller's hook
+ * with a bounded timeout, and drive readiness/turn state — initial readiness on
+ * `InstructionsLoaded` (C-API-28), turn-end on an unblocked `Stop` (C-CLAUDE-15).
+ */
+import type { BridgeProcessResult } from "../../bridge/types.ts";
+import type { TurnStateWatcher } from "../../core/turn-state.ts";
+import type { ClaudeEventMap, HookErrorEvent, StartClaudeOptions } from "../../core/types.ts";
+import type { TypedEmitter } from "../../events/emitter.ts";
+import type { InitialReady } from "../../runtime/readiness/initial-ready.ts";
+import type { SessionRecord } from "../../state/store.ts";
+import type { ClaudeHookEvent } from "../hooks/index.ts";
+import type { ClaudeSessionImpl } from "./instance.ts";
+/** The live pieces the Claude hook handler drives; `session`/`turnWatcher` are read
+ * lazily because both are assigned after the bridge is constructed. */
+export type ClaudeHookHandlerDeps = {
+    readonly record: SessionRecord;
+    readonly options: StartClaudeOptions;
+    readonly emitter: TypedEmitter<ClaudeEventMap>;
+    readonly transcriptWatcher: {
+        readonly scan: () => void;
+    };
+    readonly ready: InitialReady;
+    readonly getSession: () => ClaudeSessionImpl | undefined;
+    readonly getTurnWatcher: () => TurnStateWatcher;
+    readonly observeHookTranscript: (event: ClaudeHookEvent) => void;
+};
+/** Builds the async hook-message handler passed to the Claude hook bridge factory. */
+export declare function buildClaudeHookHandler(deps: ClaudeHookHandlerDeps): (input: unknown) => Promise<BridgeProcessResult>;
+/** Builds the hook-error handler passed to the Claude hook bridge factory. */
+export declare function buildClaudeHookErrorHandler(record: SessionRecord, emitter: TypedEmitter<ClaudeEventMap>): (event: Omit<HookErrorEvent, "elwoodSessionId">) => void;
+//# sourceMappingURL=hook-handler.d.ts.map

package/dist/claude/session/hook-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-handler.d.ts","sourceRoot":"","sources":["../../../src/claude/session/hook-handler.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0CAA0C,CAAC;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD;uEACuE;AACvE,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC,cAAc,CAAC,CAAC;IAC/C,QAAQ,CAAC,iBAAiB,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC;IAC1D,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,iBAAiB,GAAG,SAAS,CAAC;IACzD,QAAQ,CAAC,cAAc,EAAE,MAAM,gBAAgB,CAAC;IAChD,QAAQ,CAAC,qBAAqB,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;CAClE,CAAC;AAEF,sFAAsF;AACtF,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,qBAAqB,GAC1B,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAiClD;AAED,8EAA8E;AAC9E,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,YAAY,CAAC,cAAc,CAAC,GACpC,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,iBAAiB,CAAC,KAAK,IAAI,CAM1D"}

package/dist/claude/session/hook-handler.js

@@ -0,0 +1,42 @@
+/**
+ * The Claude hook-bridge message and error handlers that `build.ts` hands
+ * to the bridge factory. Implements PRD §5.3, §5.4, §6, and §8:
+ * normalize each hook, emit its `hook`/`activity` events, run the caller's hook
+ * with a bounded timeout, and drive readiness/turn state — initial readiness on
+ * `InstructionsLoaded` (C-API-28), turn-end on an unblocked `Stop` (C-CLAUDE-15).
+ */
+import * as activity from "../../core/activity/index.js";
+import { isBlock, requestHook } from "../hooks/dispatch.js";
+import { normalizeClaudeHookEvent } from "../normalize.js";
+import { serializeHookResult } from "../serialize.js";
+/** Builds the async hook-message handler passed to the Claude hook bridge factory. */
+export function buildClaudeHookHandler(deps) {
+    const { record, options, emitter, transcriptWatcher, ready } = deps;
+    return async (input) => {
+        const event = normalizeClaudeHookEvent(input);
+        if (event.hook_event_name === "SessionStart")
+            deps.getSession()?.rememberClaudeSessionId(event.session_id);
+        deps.observeHookTranscript(event);
+        emitter.emit("hook", event);
+        emitter.emit("activity", activity.activityFromClaudeHook(record.elwoodSessionId, event));
+        const outcome = await requestHook(emitter, event, options.hookTimeoutMs ?? 25_000, record.elwoodSessionId);
+        emitter.emit("activity", activity.activityFromHookResult("claude", record.elwoodSessionId, event.hook_event_name, outcome.result, outcome.failedOpen));
+        if (event.hook_event_name === "InstructionsLoaded")
+            ready.mark();
+        if (event.hook_event_name === "Stop" && !isBlock(outcome.result)) {
+            transcriptWatcher.scan(); // Committed turn is on disk; read it now (C-CLAUDE-15).
+            deps.getTurnWatcher().arm();
+            deps.getSession()?.submitEvidence("hook_turn_ended");
+        }
+        return serializeHookResult(event.hook_event_name, outcome.result);
+    };
+}
+/** Builds the hook-error handler passed to the Claude hook bridge factory. */
+export function buildClaudeHookErrorHandler(record, emitter) {
+    return (event) => {
+        const hookError = { elwoodSessionId: record.elwoodSessionId, ...event };
+        emitter.emit("hookError", hookError);
+        emitter.emit("activity", activity.activityFromHookError("claude", hookError));
+    };
+}
+//# sourceMappingURL=hook-handler.js.map

package/dist/claude/session/hook-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-handler.js","sourceRoot":"","sources":["../../../src/claude/session/hook-handler.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,QAAQ,MAAM,8BAA8B,CAAC;AAMzD,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAgBtD,sFAAsF;AACtF,MAAM,UAAU,sBAAsB,CACpC,IAA2B;IAE3B,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;IACpE,OAAO,KAAK,EAAE,KAAc,EAAgC,EAAE;QAC5D,MAAM,KAAK,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;QAC9C,IAAI,KAAK,CAAC,eAAe,KAAK,cAAc;YAC1C,IAAI,CAAC,UAAU,EAAE,EAAE,uBAAuB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC/D,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;QAClC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC5B,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,sBAAsB,CAAC,MAAM,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC,CAAC;QACzF,MAAM,OAAO,GAAG,MAAM,WAAW,CAC/B,OAAO,EACP,KAAK,EACL,OAAO,CAAC,aAAa,IAAI,MAAM,EAC/B,MAAM,CAAC,eAAe,CACvB,CAAC;QACF,OAAO,CAAC,IAAI,CACV,UAAU,EACV,QAAQ,CAAC,sBAAsB,CAC7B,QAAQ,EACR,MAAM,CAAC,eAAe,EACtB,KAAK,CAAC,eAAe,EACrB,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,UAAU,CACnB,CACF,CAAC;QACF,IAAI,KAAK,CAAC,eAAe,KAAK,oBAAoB;YAAE,KAAK,CAAC,IAAI,EAAE,CAAC;QACjE,IAAI,KAAK,CAAC,eAAe,KAAK,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACjE,iBAAiB,CAAC,IAAI,EAAE,CAAC,CAAC,wDAAwD;YAClF,IAAI,CAAC,cAAc,EAAE,CAAC,GAAG,EAAE,CAAC;YAC5B,IAAI,CAAC,UAAU,EAAE,EAAE,cAAc,CAAC,iBAAiB,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,mBAAmB,CAAC,KAAK,CAAC,eAAe,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACpE,CAAC,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,2BAA2B,CACzC,MAAqB,EACrB,OAAqC;IAErC,OAAO,CAAC,KAAK,EAAE,EAAE;QACf,MAAM,SAAS,GAAG,EAAE,eAAe,EAAE,MAAM,CAAC,eAAe,EAAE,GAAG,KAAK,EAAE,CAAC;QACxE,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QACrC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,qBAAqB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;IAChF,CAAC,CAAC;AACJ,CAAC"}

package/dist/claude/session/index.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 "./bridge.ts";
+import type { ClaudeSessionApi } from "./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("./instance.ts").ClaudeSessionImpl>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/claude/session/index.ts"],"names":[],"mappings":"AAAA,+HAA+H;AAM/H,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAK9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAE9D,OAAO,EAAE,oCAAoC,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAEjG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,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,sDAwBrD"}

package/dist/claude/session/index.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 "./bridge.js";
+import { buildClaudeSession } from "./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=index.js.map

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

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

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

@@ -0,0 +1,42 @@
+/** In-memory Claude session object exposed to callers. Implements PRD §4.1, §5, §6, §7, §8. */
+import type { ElwoodActivityEvent } from "../../core/activity/index.ts";
+import type { TerminalReplayBuffer } from "../../core/terminal-replay.ts";
+import type { ClaudeEventMap, ElwoodEventHandler, ElwoodEventName, ElwoodSessionStatus, ElwoodWarningEvent, TerminalSize } from "../../core/types.ts";
+import type { TypedEmitter } from "../../events/emitter.ts";
+import type { PtyProcess } from "../../pty/types.ts";
+import { AgentSessionBase } from "../../runtime/session/base.ts";
+import type { PersistedLoopDefinition } from "../../state/loop-store.ts";
+import type { SessionRuntime } from "../../state/runtime-paths.ts";
+import { type SessionRecord } from "../../state/store.ts";
+import type { ElwoodTerminal } from "../../terminal/headless.ts";
+import type { ClaudeLoginOptions } from "../login/types.ts";
+import type { ClaudeSessionApi } from "./interface.ts";
+export type HookBridge = {
+    readonly start: () => Promise<void>;
+    readonly stop: () => Promise<void>;
+};
+export declare class ClaudeSessionImpl extends AgentSessionBase implements ClaudeSessionApi {
+    protected readonly picker: import("../../core/models/picker.ts").ModelPickerSpec;
+    private readonly bridge;
+    private readonly emitter;
+    private requestedSize;
+    private awaitingInitialReady;
+    private initialReadyDone;
+    private readonly loginExpiredWatcher;
+    constructor(record: SessionRecord, stateDir: string, runtime: SessionRuntime, pty: PtyProcess, terminal: ElwoodTerminal, bridge: HookBridge, emitter: TypedEmitter<ClaudeEventMap>, terminalReplay: TerminalReplayBuffer, requestedSize: TerminalSize, loopDefinitions: readonly PersistedLoopDefinition[]);
+    on<E extends ElwoodEventName>(event: E, handler: ElwoodEventHandler<E>): import("../../index.ts").Unsubscribe;
+    off<E extends ElwoodEventName>(event: E, handler: ElwoodEventHandler<E>): void;
+    waitForStatus(match: (status: ElwoodSessionStatus) => boolean, timeoutMs?: number): Promise<"starting" | "running" | "ready" | "blocked" | "exited" | "stopped" | "killed" | "torn_down">;
+    waitForActivity(match: (event: ElwoodActivityEvent) => boolean, timeoutMs?: number): Promise<ElwoodActivityEvent>;
+    protected stagedPaste(screen: string): boolean;
+    protected attachImages: (paths: readonly string[], signal: AbortSignal) => Promise<void>;
+    resize(size: TerminalSize): Promise<void>;
+    completeInitialReady(): Promise<void>;
+    private restoreRequestedSize;
+    rememberClaudeSessionId(sessionId: string): void;
+    emitWarnings(warnings: readonly ElwoodWarningEvent[]): void;
+    noteLoginExpiry(screenText: string): void;
+    login(options: ClaudeLoginOptions): Promise<void>;
+    protected stopRuntime(): Promise<void>;
+}
+//# sourceMappingURL=instance.d.ts.map

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

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