@with-logic/elwood 0.1.0

package/dist/core/warnings.d.ts

@@ -0,0 +1,145 @@
+/**
+ * The typed non-fatal warning contract shared across adapters.
+ * Implements PRD §5.7 and §8.2: every warning is a named variant carrying only
+ * diagnostics (cause/phase labels, error codes, recovery hints) — no counts or
+ * byte magnitudes — and never raw prompts, transcripts, or conversation content.
+ * Most error-code fields are allowlisted tokens (`warning-reasons.ts`); the one
+ * exception is `transcript_read_error.lastErrorCode`, which the PRD types as the
+ * raw fs errno string (a system-controlled code, never transcript content).
+ * Warnings are live-only: emitted once when observed, never persisted.
+ */
+import type { ElwoodAgentKind } from "./activity.ts";
+import type { StartupPromptLabelFor } from "./startup-automation.ts";
+import type { AgentUpdateFailedWarning } from "./warning-lifecycle.ts";
+import type { DropCause, PollErrorReason, PollPhase, ReapErrorCode, ResizeErrorCode } from "./warning-reasons.ts";
+export type ElwoodWarningEvent = {
+    readonly elwoodSessionId: string;
+    readonly agent: ElwoodAgentKind;
+    readonly source: "lifecycle";
+    readonly code: "version_unparseable";
+    readonly severity: "warning";
+    readonly message: string;
+    readonly raw: string;
+} | AgentUpdateFailedWarning | {
+    readonly elwoodSessionId: string;
+    readonly agent: "codex";
+    readonly source: "terminal";
+    readonly code: "mcp_server_not_logged_in";
+    readonly severity: "warning";
+    readonly message: string;
+    readonly mcpServerName: string;
+    readonly recoveryCommand: string;
+    readonly raw: string;
+} | {
+    readonly elwoodSessionId: string;
+    readonly agent: "claude";
+    readonly source: "terminal";
+    readonly code: "login_expired";
+    readonly severity: "warning";
+    readonly message: string;
+    readonly recoveryCommand: "/login";
+    readonly raw: string;
+} | {
+    readonly elwoodSessionId: string;
+    readonly agent: "codex";
+    readonly source: "terminal";
+    readonly code: "mcp_startup_incomplete";
+    readonly severity: "warning";
+    readonly message: string;
+    readonly failedServers: readonly string[];
+    readonly recoveryCommands: readonly string[];
+    readonly raw: string;
+} | {
+    readonly elwoodSessionId: string;
+    readonly agent: "codex";
+    readonly source: "lifecycle";
+    readonly code: "codex_default_model_persisted";
+    readonly severity: "warning";
+    readonly message: string;
+    readonly raw: string;
+} | {
+    readonly elwoodSessionId: string;
+    readonly agent: "codex";
+    readonly source: "lifecycle";
+    readonly code: "clipboard_restore_failed";
+    readonly severity: "warning";
+    readonly message: string;
+    readonly raw: string;
+} | {
+    readonly elwoodSessionId: string;
+    readonly agent: ElwoodAgentKind;
+    readonly source: "terminal";
+    readonly code: "transcript_records_dropped";
+    readonly severity: "warning";
+    readonly message: string;
+    readonly cause: DropCause;
+    readonly transcriptPath: string;
+    readonly raw: string;
+} | {
+    readonly elwoodSessionId: string;
+    readonly agent: ElwoodAgentKind;
+    readonly source: "terminal";
+    readonly code: "transcript_read_error";
+    readonly severity: "warning";
+    readonly message: string;
+    readonly lastErrorCode: string;
+    readonly transcriptPath: string;
+    readonly raw: string;
+} | {
+    readonly elwoodSessionId: string;
+    readonly agent: ElwoodAgentKind;
+    readonly source: "terminal";
+    readonly code: "transcript_poll_stopped";
+    readonly severity: "warning";
+    readonly message: string;
+    readonly reason: PollErrorReason;
+    readonly phase: PollPhase;
+    readonly raw: string;
+} | StartupPromptWriteFailed<"claude"> | StartupPromptWriteFailed<"codex"> | {
+    readonly elwoodSessionId: string;
+    readonly agent: ElwoodAgentKind;
+    readonly source: "lifecycle";
+    readonly code: "reap_failed";
+    readonly severity: "warning";
+    readonly message: string;
+    readonly processGroupId: number;
+    readonly errorCode: ReapErrorCode;
+    readonly raw: string;
+} | {
+    readonly elwoodSessionId: string;
+    readonly agent: "claude";
+    readonly source: "lifecycle";
+    readonly code: "resize_restore_failed";
+    readonly severity: "warning";
+    readonly message: string;
+    readonly requestedCols: number;
+    readonly requestedRows: number;
+    readonly errorCode: ResizeErrorCode;
+    readonly raw: string;
+} | {
+    readonly elwoodSessionId: string;
+    readonly agent: ElwoodAgentKind;
+    readonly source: "lifecycle";
+    readonly code: "initial_ready_fallback";
+    readonly severity: "warning";
+    readonly message: string;
+    readonly raw: string;
+};
+/**
+ * A rejected startup-prompt PTY write, discriminated by agent so the LABEL is
+ * agent-correlated: an impossible pairing like Claude + `update` or Codex +
+ * `browser_tools` is unrepresentable (§5.4). The label is a bounded id from the
+ * agent's fixed startup-prompt set only — never raw prompt/screen content — and
+ * the prompt is left retryable so a later frame re-attempts the write.
+ */
+export type StartupPromptWriteFailed<A extends ElwoodAgentKind> = {
+    readonly elwoodSessionId: string;
+    readonly agent: A;
+    readonly source: "terminal";
+    readonly code: "startup_prompt_write_failed";
+    readonly severity: "warning";
+    readonly message: string;
+    readonly label: StartupPromptLabelFor<A>;
+    readonly raw: string;
+};
+//# sourceMappingURL=warnings.d.ts.map

package/dist/core/warnings.d.ts.map

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

package/dist/core/warnings.js

@@ -0,0 +1,12 @@
+/**
+ * The typed non-fatal warning contract shared across adapters.
+ * Implements PRD §5.7 and §8.2: every warning is a named variant carrying only
+ * diagnostics (cause/phase labels, error codes, recovery hints) — no counts or
+ * byte magnitudes — and never raw prompts, transcripts, or conversation content.
+ * Most error-code fields are allowlisted tokens (`warning-reasons.ts`); the one
+ * exception is `transcript_read_error.lastErrorCode`, which the PRD types as the
+ * raw fs errno string (a system-controlled code, never transcript content).
+ * Warnings are live-only: emitted once when observed, never persisted.
+ */
+export {};
+//# sourceMappingURL=warnings.js.map

package/dist/core/warnings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"warnings.js","sourceRoot":"","sources":["../../src/core/warnings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/events/emitter.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Small typed event emitter used by sessions and hook dispatch.
+ * Implements PRD §5.4.
+ */
+import type { Unsubscribe } from "../core/types.ts";
+type EventKey<M> = Extract<keyof M, string>;
+type HandlerFor<M, E extends EventKey<M>> = (event: M[E]) => unknown;
+export declare class TypedEmitter<M extends Record<string, unknown>> {
+    private readonly handlers;
+    constructor();
+    on<E extends EventKey<M>>(event: E, handler: HandlerFor<M, E>): Unsubscribe;
+    listen<E extends EventKey<M>>(event: E, handler: HandlerFor<M, E>): void;
+    off<E extends EventKey<M>>(event: E, handler: HandlerFor<M, E>): void;
+    emit<E extends EventKey<M>>(event: E, payload: M[E]): void;
+    hasListeners<E extends EventKey<M>>(event: E): boolean;
+    request<E extends EventKey<M>>(event: E, payload: M[E]): Promise<unknown>;
+}
+export {};
+//# sourceMappingURL=emitter.d.ts.map

package/dist/events/emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.d.ts","sourceRoot":"","sources":["../../src/events/emitter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGpD,KAAK,QAAQ,CAAC,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;AAC5C,KAAK,UAAU,CAAC,CAAC,EAAE,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC;AASrE,qBAAa,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACzD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8B;;IAMvD,EAAE,CAAC,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,WAAW;IAO3E,MAAM,CAAC,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI;IAaxE,GAAG,CAAC,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI;IASrE,IAAI,CAAC,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IA2B1D,YAAY,CAAC,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO;IAIhD,OAAO,CAAC,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;CAUhF"}

package/dist/events/emitter.js

@@ -0,0 +1,85 @@
+/**
+ * Small typed event emitter used by sessions and hook dispatch.
+ * Implements PRD §5.4.
+ */
+export class TypedEmitter {
+    handlers;
+    constructor() {
+        this.handlers = new Map();
+    }
+    on(event, handler) {
+        this.listen(event, handler);
+        return () => {
+            this.off(event, handler);
+        };
+    }
+    listen(event, handler) {
+        const entry = this.handlers.get(event);
+        const h = handler;
+        if (!entry) {
+            this.handlers.set(event, { list: [h], live: new Set([h]) });
+            return;
+        }
+        if (entry.live.has(h))
+            return;
+        entry.live.add(h);
+        // Copy-on-write: a fresh array so any in-flight `emit` snapshot is unaffected.
+        entry.list = [...entry.list, h];
+    }
+    off(event, handler) {
+        const entry = this.handlers.get(event);
+        const h = handler;
+        if (!entry?.live.delete(h))
+            return;
+        // Copy-on-write removal keeps a concurrent `emit` snapshot stable; `live`
+        // (already updated) makes the unsubscribe visible to that emission at once.
+        entry.list = entry.list.filter((existing) => existing !== h);
+    }
+    emit(event, payload) {
+        const entry = this.handlers.get(event);
+        if (!entry)
+            return;
+        // Deliver to every subscriber before surfacing any failure: one throwing
+        // listener must not abort iteration and wedge an internal lifecycle
+        // subscriber (e.g. interrupt/compact settling on a status transition, or
+        // the transcript watcher's flush). The first error is rethrown after the
+        // full fan-out so an enclosing error boundary can still observe it. The
+        // `list` snapshot is immutable, so a listener added mid-emit does not fire
+        // this round; `live` is consulted so one a prior handler removed is skipped.
+        const snapshot = entry.list;
+        let firstError;
+        let failed = false;
+        for (const handler of snapshot) {
+            if (!entry.live.has(handler))
+                continue;
+            try {
+                handler(payload);
+            }
+            catch (error) {
+                if (!failed) {
+                    failed = true;
+                    firstError = error;
+                }
+            }
+        }
+        if (failed)
+            throw firstError;
+    }
+    hasListeners(event) {
+        return (this.handlers.get(event)?.live.size ?? 0) > 0;
+    }
+    async request(event, payload) {
+        const entry = this.handlers.get(event);
+        if (!entry)
+            return undefined;
+        for (const handler of entry.list) {
+            if (!entry.live.has(handler))
+                continue;
+            const result = await handler(payload);
+            if (result !== undefined)
+                return result;
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=emitter.js.map

package/dist/events/emitter.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Public package entrypoint.
+ * Implements PRD §5.
+ */
+export type { AgentInput, AskUserQuestionInput, BashInput, ClaudeBackgroundTask, ClaudeEffortLevel, ClaudeHookEvent, ClaudeHookEventFor, ClaudeHookEventName, ClaudeHookHandlers, ClaudeHookPermissionMode, ClaudeHookResult, ClaudeHookResultForEvent, ClaudeNotificationType, ClaudePostToolBatchCall, ClaudeSessionCron, ClaudeStopFailureError, ClaudeStopFields, ClaudeTaskFields, ClaudeToolInputUpdateForEvent, EditInput, ExitPlanModeInput, GenericToolInput, GlobInput, GrepInput, KnownClaudeToolName, PermissionRule, PermissionUpdate, PermissionUpdateDestination, PreToolUseResult, ReadInput, WebFetchInput, WebSearchInput, WriteInput, } from "./claude/hooks/index.ts";
+export { claudeHookEventNames } from "./claude/hooks/index.ts";
+export { listClaudeModels } from "./claude/list-models.ts";
+export type { ClaudeLoginMethod, ClaudeLoginOptions } from "./claude/login/types.ts";
+export { startClaude } from "./claude/session/index.ts";
+export type { ClaudeSessionApi } from "./claude/session/interface.ts";
+export { resumeClaude } from "./claude/session/resume.ts";
+export { type StartOrResumeClaudeOptions, startOrResumeClaude, } from "./claude/session/start-or-resume.ts";
+export { ClaudeSession, type ClaudeSessionOptions } from "./claude/simple.ts";
+export type { CodexCommandToolInput, CodexCommonHookFields, CodexGenericToolInput, CodexHookEvent, CodexHookEventFor, CodexHookEventName, CodexHookHandlers, CodexHookResult, CodexHookResultForEvent, CodexKnownToolName, CodexPermissionMode, CodexPreToolUseResultFor, CodexToolEventFields, CodexUnknownToolName, } from "./codex/hooks/index.ts";
+export { codexHookEventNames } from "./codex/hooks/index.ts";
+export { listCodexModels } from "./codex/list-models.ts";
+export { startCodex } from "./codex/session/index.ts";
+export { resumeCodex } from "./codex/session/resume.ts";
+export { type StartOrResumeCodexOptions, startOrResumeCodex, } from "./codex/session/start-or-resume.ts";
+export type { CodexApprovalPolicy, CodexEventHandler, CodexEventMap, CodexEventName, CodexSandboxMode, CodexSessionApi, ResumeCodexOptions, StartCodexOptions, } from "./codex/session/types.ts";
+export { CodexSession, type CodexSessionOptions } from "./codex/simple.ts";
+export type { CodexTranscriptEvent, CodexTranscriptSummary, } from "./codex/transcript/index.ts";
+export type { ElwoodActivityEvent, ElwoodActivityKind, ElwoodActivitySource, ElwoodAgentKind, } from "./core/activity/index.ts";
+export type { ElwoodAgentSession, ElwoodCommonEventMap, ElwoodCommonEventName, } from "./core/agent-session.ts";
+export type { ElwoodErrorName } from "./core/errors.ts";
+export { ElwoodError, elwoodError } from "./core/errors.ts";
+export type { ImageFormat, ImageInput, SendOptions } from "./core/images/types.ts";
+export { parseLoopCommand } from "./core/loops/parser.ts";
+export type { ElwoodLoopEvent, ElwoodLoopEventSnapshot, ElwoodLoopRequest, ElwoodLoopSnapshot, ElwoodLoopState, } from "./core/loops/types.ts";
+export type { ListModelsOptions } from "./core/models/list.ts";
+export type { AgentModelOption } from "./core/models/rows.ts";
+export type { ClaudeReasoningEffort, CodexReasoningEffort } from "./core/reasoning-effort.ts";
+export type { TurnEvent } from "./core/simple/events.ts";
+export type { TurnOptions } from "./core/simple/session.ts";
+export type { StartOrResumeResult } from "./core/start-or-resume.ts";
+export type { ActivityMatch, ClaudeEventHandler, ClaudeEventMap, ClaudeEventName, ClaudePermissionMode, ClaudeSettingsOverrides, ClaudeToolRule, ElwoodEventHandler, ElwoodEventMap, ElwoodEventName, ElwoodSessionStatus, ElwoodStatusDecision, ElwoodStatusEvidence, ElwoodWarningEvent, HookErrorEvent, ResumeClaudeOptions, StartClaudeOptions, StatusMatch, TerminalSize, Unsubscribe, } from "./core/types.ts";
+export type { ElwoodTerminal, TerminalSnapshot, XtermTerminal } from "./terminal/headless.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,19 @@
+/**
+ * Public package entrypoint.
+ * Implements PRD §5.
+ */
+export { claudeHookEventNames } from "./claude/hooks/index.js";
+export { listClaudeModels } from "./claude/list-models.js";
+export { startClaude } from "./claude/session/index.js";
+export { resumeClaude } from "./claude/session/resume.js";
+export { startOrResumeClaude, } from "./claude/session/start-or-resume.js";
+export { ClaudeSession } from "./claude/simple.js";
+export { codexHookEventNames } from "./codex/hooks/index.js";
+export { listCodexModels } from "./codex/list-models.js";
+export { startCodex } from "./codex/session/index.js";
+export { resumeCodex } from "./codex/session/resume.js";
+export { startOrResumeCodex, } from "./codex/session/start-or-resume.js";
+export { CodexSession } from "./codex/simple.js";
+export { ElwoodError, elwoodError } from "./core/errors.js";
+export { parseLoopCommand } from "./core/loops/parser.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAqCH,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAEL,mBAAmB,GACpB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,aAAa,EAA6B,MAAM,oBAAoB,CAAC;AAiB9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAEL,kBAAkB,GACnB,MAAM,oCAAoC,CAAC;AAW5C,OAAO,EAAE,YAAY,EAA4B,MAAM,mBAAmB,CAAC;AAiB3E,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/pty/node.d.ts

@@ -0,0 +1,17 @@
+/**
+ * node-pty-backed real PTY implementation.
+ * Implements PRD §4.1.
+ */
+import type { PtyFactory } from "./types.ts";
+export declare const nodePtyFactory: PtyFactory;
+export declare function nodePtySpawnHelperPath(): string;
+/**
+ * Some package managers strip the execute bit from node-pty's prebuilt
+ * `spawn-helper`, which makes every PTY spawn fail with EACCES. Restore it only
+ * when it is actually missing: an already-executable helper is left untouched
+ * (never write into node_modules on every spawn), and a chmod that fails — a
+ * root-installed global, a read-only layer, a pnpm content store — is tolerated
+ * because node-pty itself reports the real spawn failure if the helper is unusable.
+ */
+export declare function ensureNodePtySpawnHelperExecutable(path?: string): void;
+//# sourceMappingURL=node.d.ts.map

package/dist/pty/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/pty/node.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EAAE,UAAU,EAA+B,MAAM,YAAY,CAAC;AAI1E,eAAO,MAAM,cAAc,EAAE,UAmC5B,CAAC;AAMF,wBAAgB,sBAAsB,IAAI,MAAM,CAO/C;AAED;;;;;;;GAOG;AACH,wBAAgB,kCAAkC,CAAC,IAAI,SAA2B,GAAG,IAAI,CAaxF"}

package/dist/pty/node.js

@@ -0,0 +1,79 @@
+/**
+ * node-pty-backed real PTY implementation.
+ * Implements PRD §4.1.
+ */
+import { chmodSync, statSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { spawn } from "node-pty";
+import { moduleRequire } from "../core/module-require.js";
+const require = moduleRequire(import.meta.url);
+export const nodePtyFactory = (options) => {
+    ensureNodePtySpawnHelperExecutable();
+    const pty = spawn(options.command, [...options.args], {
+        name: "xterm-256color",
+        cols: options.size.cols,
+        rows: options.size.rows,
+        cwd: options.cwd,
+        env: { ...options.env },
+    });
+    return {
+        pid: pty.pid,
+        onData(handler) {
+            const disposable = pty.onData(handler);
+            return () => disposable.dispose();
+        },
+        onExit(handler) {
+            const disposable = pty.onExit(handler);
+            return () => disposable.dispose();
+        },
+        write(data) {
+            pty.write(typeof data === "string" ? data : Buffer.from(data));
+        },
+        resize(size) {
+            try {
+                pty.resize(size.cols, size.rows);
+                return "resized";
+            }
+            catch (error) {
+                if (isClosedPtyError(error))
+                    return "closed";
+                throw error;
+            }
+        },
+        kill(signal = "SIGTERM") {
+            pty.kill(signal);
+        },
+    };
+};
+function isClosedPtyError(error) {
+    return error instanceof Error && error.message.includes("EBADF");
+}
+export function nodePtySpawnHelperPath() {
+    return join(dirname(require.resolve("node-pty/package.json")), "prebuilds", `${process.platform}-${process.arch}`, "spawn-helper");
+}
+/**
+ * Some package managers strip the execute bit from node-pty's prebuilt
+ * `spawn-helper`, which makes every PTY spawn fail with EACCES. Restore it only
+ * when it is actually missing: an already-executable helper is left untouched
+ * (never write into node_modules on every spawn), and a chmod that fails — a
+ * root-installed global, a read-only layer, a pnpm content store — is tolerated
+ * because node-pty itself reports the real spawn failure if the helper is unusable.
+ */
+export function ensureNodePtySpawnHelperExecutable(path = nodePtySpawnHelperPath()) {
+    let mode;
+    try {
+        mode = statSync(path).mode;
+    }
+    catch {
+        return; // absent helper (not every platform ships one): nothing to repair
+    }
+    if ((mode & 0o111) !== 0)
+        return;
+    try {
+        chmodSync(path, mode | 0o755);
+    }
+    catch {
+        // Best effort: a read-only install cannot be repaired from here.
+    }
+}
+//# sourceMappingURL=node.js.map

package/dist/pty/node.js.map

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

package/dist/pty/types.d.ts

@@ -0,0 +1,26 @@
+/**
+ * PTY abstraction for real and fake terminal processes.
+ * Implements PRD §4.1 and §5.3.
+ */
+import type { TerminalSize } from "../core/types.ts";
+export type PtyExit = {
+    readonly exitCode: number;
+    readonly signal?: number;
+};
+export type PtySpawnOptions = {
+    readonly command: string;
+    readonly args: readonly string[];
+    readonly cwd: string;
+    readonly env: Readonly<Record<string, string | undefined>>;
+    readonly size: TerminalSize;
+};
+export interface PtyProcess {
+    readonly pid: number;
+    onData(handler: (data: string) => void): () => void;
+    onExit(handler: (exit: PtyExit) => void): () => void;
+    write(data: string | Uint8Array): void;
+    resize(size: TerminalSize): "resized" | "closed";
+    kill(signal?: string): void;
+}
+export type PtyFactory = (options: PtySpawnOptions) => PtyProcess;
+//# sourceMappingURL=types.d.ts.map

package/dist/pty/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/pty/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,MAAM,OAAO,GAAG;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC3D,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;CAC7B,CAAC;AAEF,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACpD,MAAM,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACrD,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;IACvC,MAAM,CAAC,IAAI,EAAE,YAAY,GAAG,SAAS,GAAG,QAAQ,CAAC;IACjD,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,eAAe,KAAK,UAAU,CAAC"}

package/dist/pty/types.js

@@ -0,0 +1,6 @@
+/**
+ * PTY abstraction for real and fake terminal processes.
+ * Implements PRD §4.1 and §5.3.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/pty/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/pty/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/runtime/cleanup-latch.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Coalesces runtime-cleanup attempts while keeping a FAILED cleanup retryable.
+ * PRD §9.4 requires that a settled cleanup failure is not permanently sticky — a
+ * later explicit stop/kill/teardown must run a fresh attempt. A plain `??=` cache
+ * would latch a rejected promise forever, so this latch clears its cache the moment
+ * the attempt rejects. `cachedAttempt` is therefore only ever the reusable non-rejected
+ * attempt (in flight or successfully settled). Implements PRD §9.4.
+ */
+export declare class CleanupLatch {
+    private cachedAttempt;
+    private readonly run;
+    constructor(run: () => Promise<void>);
+    /**
+     * Runs cleanup, coalescing concurrent callers onto one in-flight attempt. On
+     * failure the cache is cleared so the NEXT call re-runs `run` instead of
+     * replaying the old rejection; the rejection still propagates to this caller.
+     */
+    attempt(): Promise<void>;
+    /**
+     * Runs cleanup from a path with no caller to reject to (an unsolicited exit).
+     * Owns the rejection so it never becomes an unhandled rejection; the failure is
+     * swallowed because `attempt` cleared its cache, so a later explicit shutdown
+     * retries cleanup and surfaces any persistent failure through its own error.
+     */
+    float(): void;
+}
+//# sourceMappingURL=cleanup-latch.d.ts.map

package/dist/runtime/cleanup-latch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup-latch.d.ts","sourceRoot":"","sources":["../../src/runtime/cleanup-latch.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,qBAAa,YAAY;IACvB,OAAO,CAAC,aAAa,CAA4B;IACjD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAsB;gBAE9B,GAAG,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC;IAIpC;;;;OAIG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAaxB;;;;;OAKG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/dist/runtime/cleanup-latch.js

@@ -0,0 +1,43 @@
+/**
+ * Coalesces runtime-cleanup attempts while keeping a FAILED cleanup retryable.
+ * PRD §9.4 requires that a settled cleanup failure is not permanently sticky — a
+ * later explicit stop/kill/teardown must run a fresh attempt. A plain `??=` cache
+ * would latch a rejected promise forever, so this latch clears its cache the moment
+ * the attempt rejects. `cachedAttempt` is therefore only ever the reusable non-rejected
+ * attempt (in flight or successfully settled). Implements PRD §9.4.
+ */
+export class CleanupLatch {
+    cachedAttempt;
+    run;
+    constructor(run) {
+        this.run = run;
+    }
+    /**
+     * Runs cleanup, coalescing concurrent callers onto one in-flight attempt. On
+     * failure the cache is cleared so the NEXT call re-runs `run` instead of
+     * replaying the old rejection; the rejection still propagates to this caller.
+     */
+    attempt() {
+        // A cached attempt is reused only when it is in flight or already settled
+        // SUCCESSFULLY; a rejecting attempt clears the cache below before any other
+        // caller can observe it, so no identity guard is needed on the clear.
+        if (this.cachedAttempt)
+            return this.cachedAttempt;
+        const attempt = this.run().catch((error) => {
+            this.cachedAttempt = undefined;
+            throw error;
+        });
+        this.cachedAttempt = attempt;
+        return attempt;
+    }
+    /**
+     * Runs cleanup from a path with no caller to reject to (an unsolicited exit).
+     * Owns the rejection so it never becomes an unhandled rejection; the failure is
+     * swallowed because `attempt` cleared its cache, so a later explicit shutdown
+     * retries cleanup and surfaces any persistent failure through its own error.
+     */
+    float() {
+        void this.attempt().catch(() => undefined);
+    }
+}
+//# sourceMappingURL=cleanup-latch.js.map

package/dist/runtime/cleanup-latch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup-latch.js","sourceRoot":"","sources":["../../src/runtime/cleanup-latch.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,OAAO,YAAY;IACf,aAAa,CAA4B;IAChC,GAAG,CAAsB;IAE1C,YAAY,GAAwB;QAClC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAED;;;;OAIG;IACH,OAAO;QACL,0EAA0E;QAC1E,4EAA4E;QAC5E,sEAAsE;QACtE,IAAI,IAAI,CAAC,aAAa;YAAE,OAAO,IAAI,CAAC,aAAa,CAAC;QAClD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YAClD,IAAI,CAAC,aAAa,GAAG,SAAS,CAAC;YAC/B,MAAM,KAAK,CAAC;QACd,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC;QAC7B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;OAKG;IACH,KAAK;QACH,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC7C,CAAC;CACF"}

package/dist/runtime/hook-command.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Builds the Node-compatible hook-bridge command (PRD §6.1/§7A.1). Electron
+ * embeds Node behind its own executable, which needs its documented run-as-Node
+ * switch when a child hook invokes that executable directly.
+ */
+/** Build a hook command for Node or an Electron-hosted Node main process. */
+export declare function hookCommand(bridgeScriptPath: string, seams?: {
+    readonly runtimePath?: string;
+    readonly electronRuntime?: boolean;
+}): string;
+//# sourceMappingURL=hook-command.d.ts.map

package/dist/runtime/hook-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-command.d.ts","sourceRoot":"","sources":["../../src/runtime/hook-command.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,6EAA6E;AAC7E,wBAAgB,WAAW,CACzB,gBAAgB,EAAE,MAAM,EACxB,KAAK,CAAC,EAAE;IAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAA;CAAE,GAC5E,MAAM,CAKR"}

package/dist/runtime/hook-command.js

@@ -0,0 +1,14 @@
+/**
+ * Builds the Node-compatible hook-bridge command (PRD §6.1/§7A.1). Electron
+ * embeds Node behind its own executable, which needs its documented run-as-Node
+ * switch when a child hook invokes that executable directly.
+ */
+import { shellQuote } from "./shell.js";
+/** Build a hook command for Node or an Electron-hosted Node main process. */
+export function hookCommand(bridgeScriptPath, seams) {
+    const runtimePath = seams?.runtimePath ?? process.execPath;
+    const electronRuntime = seams?.electronRuntime ?? process.versions["electron"] !== undefined;
+    const runAsNode = electronRuntime ? "ELECTRON_RUN_AS_NODE=1 " : "";
+    return `${runAsNode}${shellQuote(runtimePath)} ${shellQuote(bridgeScriptPath)}`;
+}
+//# sourceMappingURL=hook-command.js.map

package/dist/runtime/hook-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-command.js","sourceRoot":"","sources":["../../src/runtime/hook-command.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,6EAA6E;AAC7E,MAAM,UAAU,WAAW,CACzB,gBAAwB,EACxB,KAA6E;IAE7E,MAAM,WAAW,GAAG,KAAK,EAAE,WAAW,IAAI,OAAO,CAAC,QAAQ,CAAC;IAC3D,MAAM,eAAe,GAAG,KAAK,EAAE,eAAe,IAAI,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,SAAS,CAAC;IAC7F,MAAM,SAAS,GAAG,eAAe,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,EAAE,CAAC;IACnE,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC,WAAW,CAAC,IAAI,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;AAClF,CAAC"}