@with-logic/elwood 0.1.0

package/dist/core/activity.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Unified activity events shared across agent adapters.
+ * Implements PRD §5.4.
+ */
+import type { ClaudeHookEvent } from "../claude/hooks.ts";
+import type { CodexHookEvent } from "../codex/hooks.ts";
+import type { ElwoodSessionStatus, ElwoodWarningEvent, HookErrorEvent } from "./types.ts";
+export type ElwoodAgentKind = "claude" | "codex";
+export type ElwoodActivitySource = "hook" | "transcript" | "terminal" | "lifecycle";
+export type ElwoodActivityKind = "status" | "terminal_exit" | "user_message" | "assistant_message" | "reasoning" | "tool_call" | "tool_result" | "web_search" | "other" | "notification" | "warning" | "startup_prompt" | "attention" | "hook" | "hook_result" | "hook_error";
+export type ElwoodActivityEvent = {
+    readonly elwoodSessionId: string;
+    readonly agent: ElwoodAgentKind;
+    readonly source: ElwoodActivitySource;
+    readonly kind: ElwoodActivityKind;
+    readonly label: string;
+    readonly text?: string;
+    readonly hookEventName?: string;
+    readonly turnId?: string;
+    readonly toolName?: string;
+    readonly toolUseId?: string;
+    readonly toolInput?: string;
+    readonly toolOutput?: string;
+    readonly status?: ElwoodSessionStatus;
+    readonly exitCode?: number;
+    readonly failedOpen?: boolean;
+    readonly transcriptPath?: string;
+    readonly raw?: unknown;
+};
+export { activityFromStatus, activityFromTerminalExit, reapFailureWarning, } from "./activity-lifecycle.ts";
+/**
+ * Claude hook → activity. Agent/event correlation stops a Claude event routing
+ * through the Codex path. Claude tool/assistant activity is transcript-sourced
+ * (C-CLAUDE-15), so those hooks stay plain `hook` here (no transcript duplicate).
+ */
+export declare function activityFromClaudeHook(elwoodSessionId: string, event: ClaudeHookEvent): ElwoodActivityEvent;
+/**
+ * Codex hook → activity. Codex's `assistant_message`, `tool_call`, and
+ * `tool_result` are sourced from the committed `codex:transcript` (C-CODEX-16),
+ * so the `Stop`/`PreToolUse`/`PostToolUse` hooks MUST NOT re-project them — that
+ * surfaced every reply and every tool step twice (once from the hook, once from
+ * the transcript). Those hooks stay plain `hook` turn-boundary signals here, and
+ * `Stop`'s `last_assistant_message` (which can be un-submitted ghost text) never
+ * becomes an `assistant_message`, exactly as for Claude (C-CLAUDE-15).
+ */
+export declare function activityFromCodexHook(elwoodSessionId: string, event: CodexHookEvent): ElwoodActivityEvent;
+export declare function activityFromHookError(agent: ElwoodAgentKind, event: HookErrorEvent): ElwoodActivityEvent;
+export declare function activityFromHookResult(agent: ElwoodAgentKind, elwoodSessionId: string, hookEventName: string, result: unknown, failedOpen: boolean): ElwoodActivityEvent;
+export declare function activityFromWarning(event: ElwoodWarningEvent): ElwoodActivityEvent;
+export { activityFromClaudeTranscript, activityFromCodexTranscript, } from "./activity-transcript.ts";
+//# sourceMappingURL=activity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../../src/core/activity.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE1F,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,OAAO,CAAC;AACjD,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,YAAY,GAAG,UAAU,GAAG,WAAW,CAAC;AACpF,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,eAAe,GACf,cAAc,GACd,mBAAmB,GACnB,WAAW,GACX,WAAW,GACX,aAAa,GACb,YAAY,GACZ,OAAO,GACP,cAAc,GACd,SAAS,GACT,gBAAgB,GAChB,WAAW,GACX,MAAM,GACN,aAAa,GACb,YAAY,CAAC;AAEjB,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AAgBjC;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,eAAe,GACrB,mBAAmB,CAIrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,cAAc,GACpB,mBAAmB,CAIrB;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,eAAe,EACtB,KAAK,EAAE,cAAc,GACpB,mBAAmB,CAWrB;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,eAAe,EACtB,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,OAAO,EACf,UAAU,EAAE,OAAO,GAClB,mBAAmB,CAWrB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,kBAAkB,GAAG,mBAAmB,CAUlF;AAED,OAAO,EACL,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,0BAA0B,CAAC"}

package/dist/core/activity.js

@@ -0,0 +1,81 @@
+/**
+ * Unified activity events shared across agent adapters.
+ * Implements PRD §5.4.
+ */
+import * as meta from "./activity-meta.js";
+import { hookResultLabel } from "./hook-result.js";
+export { activityFromStatus, activityFromTerminalExit, reapFailureWarning, } from "./activity-lifecycle.js";
+/** Hook events both adapters map identically; returns undefined for the rest. */
+function sharedHookActivity(base, event) {
+    if (event.hook_event_name === "UserPromptSubmit") {
+        return withText(base, "user_message", "user", event.prompt);
+    }
+    if (event.hook_event_name === "Notification") {
+        return withText(base, "notification", event.notification_type, event.message);
+    }
+    return undefined;
+}
+/**
+ * Claude hook → activity. Agent/event correlation stops a Claude event routing
+ * through the Codex path. Claude tool/assistant activity is transcript-sourced
+ * (C-CLAUDE-15), so those hooks stay plain `hook` here (no transcript duplicate).
+ */
+export function activityFromClaudeHook(elwoodSessionId, event) {
+    const base = meta.hookActivityBase("claude", elwoodSessionId, event);
+    const shared = sharedHookActivity(base, event);
+    return shared ?? { ...base, kind: "hook", label: event.hook_event_name };
+}
+/**
+ * Codex hook → activity. Codex's `assistant_message`, `tool_call`, and
+ * `tool_result` are sourced from the committed `codex:transcript` (C-CODEX-16),
+ * so the `Stop`/`PreToolUse`/`PostToolUse` hooks MUST NOT re-project them — that
+ * surfaced every reply and every tool step twice (once from the hook, once from
+ * the transcript). Those hooks stay plain `hook` turn-boundary signals here, and
+ * `Stop`'s `last_assistant_message` (which can be un-submitted ghost text) never
+ * becomes an `assistant_message`, exactly as for Claude (C-CLAUDE-15).
+ */
+export function activityFromCodexHook(elwoodSessionId, event) {
+    const base = meta.hookActivityBase("codex", elwoodSessionId, event);
+    const shared = sharedHookActivity(base, event);
+    return shared ?? { ...base, kind: "hook", label: event.hook_event_name };
+}
+export function activityFromHookError(agent, event) {
+    return {
+        elwoodSessionId: event.elwoodSessionId,
+        agent,
+        source: "hook",
+        kind: "hook_error",
+        label: `${event.hookEventName}:${event.category}`,
+        text: event.message,
+        hookEventName: event.hookEventName,
+        raw: event,
+    };
+}
+export function activityFromHookResult(agent, elwoodSessionId, hookEventName, result, failedOpen) {
+    return {
+        elwoodSessionId,
+        agent,
+        source: "hook",
+        kind: "hook_result",
+        label: hookResultLabel(result, failedOpen),
+        hookEventName,
+        failedOpen,
+        raw: { hookEventName, result, failedOpen },
+    };
+}
+export function activityFromWarning(event) {
+    return {
+        elwoodSessionId: event.elwoodSessionId,
+        agent: event.agent,
+        source: event.source,
+        kind: "warning",
+        label: event.code,
+        text: event.message,
+        raw: event,
+    };
+}
+export { activityFromClaudeTranscript, activityFromCodexTranscript, } from "./activity-transcript.js";
+function withText(base, kind, label, text) {
+    return { ...base, kind, label, text };
+}
+//# sourceMappingURL=activity.js.map

package/dist/core/activity.js.map

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

package/dist/core/agent-session.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Adapter-neutral session view satisfied by Claude and Codex sessions.
+ * Implements PRD §5.7 shared surface and C-API-27.
+ */
+import type { ElwoodTerminal } from "../terminal/headless.ts";
+import type { ElwoodActivityEvent } from "./activity/index.ts";
+import type { SendOptions } from "./images/types.ts";
+import type { LoopControls } from "./loops/loop-controls.ts";
+import type { AgentModelOption } from "./models/rows.ts";
+import type { ActivityMatch, ElwoodCommonEventMap, ElwoodCommonEventName, ElwoodSessionStatus, ElwoodStatusDecision, StatusMatch, TerminalSize, Unsubscribe } from "./types.ts";
+export type { ElwoodCommonEventMap, ElwoodCommonEventName } from "./types.ts";
+/**
+ * Structural supertype of ClaudeSessionApi and CodexSessionApi. Code generic over
+ * "any agent session" can hold either concrete session as this type and use
+ * the shared events, io, commands, and lifecycle without adapter-specific
+ * generics.
+ */
+export interface ElwoodAgentSession extends LoopControls {
+    readonly elwoodSessionId: string;
+    readonly cwd: string;
+    readonly status: ElwoodSessionStatus;
+    readonly terminal: ElwoodTerminal;
+    /** Live-only log of recent status decisions, oldest first, for diagnostics. */
+    statusDecisions(): readonly ElwoodStatusDecision[];
+    waitForStatus(match: StatusMatch, timeoutMs?: number): Promise<ElwoodSessionStatus>;
+    waitForActivity(match: ActivityMatch, timeoutMs?: number): Promise<ElwoodActivityEvent>;
+    on<E extends ElwoodCommonEventName>(event: E, handler: (event: ElwoodCommonEventMap[E]) => void): Unsubscribe;
+    off<E extends ElwoodCommonEventName>(event: E, handler: (event: ElwoodCommonEventMap[E]) => void): 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>;
+    stop(): Promise<void>;
+    kill(): Promise<void>;
+    teardown(): Promise<void>;
+}
+//# sourceMappingURL=agent-session.d.ts.map

package/dist/core/agent-session.d.ts.map

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

package/dist/core/agent-session.js

@@ -0,0 +1,6 @@
+/**
+ * Adapter-neutral session view satisfied by Claude and Codex sessions.
+ * Implements PRD §5.7 shared surface and C-API-27.
+ */
+export {};
+//# sourceMappingURL=agent-session.js.map

package/dist/core/agent-session.js.map

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

package/dist/core/async-mutex.d.ts

@@ -0,0 +1,13 @@
+/**
+ * A minimal process-local async mutex: a promise chain that serializes tasks so
+ * each caller waits for the prior holder to settle before starting. The internal
+ * tail swallows rejections so one caller's failure never rejects the NEXT caller's
+ * acquire; the real result/rejection is returned to THIS caller. Shared by the
+ * clipboard and Codex config locks (PRD §5.3, C-API-46 / C-CODEX-14); extracted
+ * so the one correct chaining shape lives in one place.
+ */
+/** Runs `task` while holding the mutex; released when `task` settles (ok or error). */
+export type AsyncMutex = <T>(task: () => Promise<T>) => Promise<T>;
+/** Creates an independent async mutex with its own serialization chain. */
+export declare function createAsyncMutex(): AsyncMutex;
+//# sourceMappingURL=async-mutex.d.ts.map

package/dist/core/async-mutex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-mutex.d.ts","sourceRoot":"","sources":["../../src/core/async-mutex.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,uFAAuF;AACvF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAEnE,2EAA2E;AAC3E,wBAAgB,gBAAgB,IAAI,UAAU,CAU7C"}

package/dist/core/async-mutex.js

@@ -0,0 +1,18 @@
+/**
+ * A minimal process-local async mutex: a promise chain that serializes tasks so
+ * each caller waits for the prior holder to settle before starting. The internal
+ * tail swallows rejections so one caller's failure never rejects the NEXT caller's
+ * acquire; the real result/rejection is returned to THIS caller. Shared by the
+ * clipboard and Codex config locks (PRD §5.3, C-API-46 / C-CODEX-14); extracted
+ * so the one correct chaining shape lives in one place.
+ */
+/** Creates an independent async mutex with its own serialization chain. */
+export function createAsyncMutex() {
+    let tail = Promise.resolve();
+    return (task) => {
+        const run = tail.then(task); // `tail` never rejects, so no rejection arm is needed
+        tail = run.then(() => undefined, () => undefined);
+        return run;
+    };
+}
+//# sourceMappingURL=async-mutex.js.map

package/dist/core/async-mutex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-mutex.js","sourceRoot":"","sources":["../../src/core/async-mutex.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,2EAA2E;AAC3E,MAAM,UAAU,gBAAgB;IAC9B,IAAI,IAAI,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IAC5C,OAAO,CAAI,IAAsB,EAAc,EAAE;QAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,sDAAsD;QACnF,IAAI,GAAG,GAAG,CAAC,IAAI,CACb,GAAG,EAAE,CAAC,SAAS,EACf,GAAG,EAAE,CAAC,SAAS,CAChB,CAAC;QACF,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;AACJ,CAAC"}

package/dist/core/attention.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Rendered-screen attention watching: raises and clears the blocked state
+ * for dialogs that need a human decision.
+ * Implements PRD §5.3 blocked status (C-ATTN-01 through C-ATTN-03).
+ */
+import type { ElwoodActivityEvent, ElwoodAgentKind } from "./activity/index.ts";
+import type { ScreenFactReading } from "./screen-facts.ts";
+export type AttentionEdge = {
+    readonly edge: "raised" | "cleared";
+    /** Ids of the blocking rules that matched, for explain traces. */
+    readonly ruleIds: readonly string[];
+};
+export declare class AttentionWatcher {
+    private blocked;
+    /** Consumes a reading already classified from the frame (see observeRenderedFrame). */
+    observe(reading: ScreenFactReading): AttentionEdge | undefined;
+}
+export declare function activityFromAttention(agent: ElwoodAgentKind, elwoodSessionId: string, ruleIds: readonly string[]): ElwoodActivityEvent;
+//# sourceMappingURL=attention.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"attention.d.ts","sourceRoot":"","sources":["../../src/core/attention.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;IACpC,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC,CAAC;AAEF,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAAS;IAExB,uFAAuF;IACvF,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,aAAa,GAAG,SAAS;CAS/D;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,eAAe,EACtB,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,SAAS,MAAM,EAAE,GACzB,mBAAmB,CASrB"}

package/dist/core/attention.js

@@ -0,0 +1,31 @@
+/**
+ * Rendered-screen attention watching: raises and clears the blocked state
+ * for dialogs that need a human decision.
+ * Implements PRD §5.3 blocked status (C-ATTN-01 through C-ATTN-03).
+ */
+export class AttentionWatcher {
+    blocked = false;
+    /** Consumes a reading already classified from the frame (see observeRenderedFrame). */
+    observe(reading) {
+        if (reading.facts.blocking_prompt_visible === this.blocked)
+            return undefined;
+        this.blocked = !this.blocked;
+        if (!this.blocked)
+            return { edge: "cleared", ruleIds: [] };
+        const ruleIds = reading.matched
+            .filter((rule) => rule.fact === "blocking_prompt_visible")
+            .map((rule) => rule.id);
+        return { edge: "raised", ruleIds };
+    }
+}
+export function activityFromAttention(agent, elwoodSessionId, ruleIds) {
+    return {
+        elwoodSessionId,
+        agent,
+        source: "terminal",
+        kind: "attention",
+        label: ruleIds.join(","),
+        text: "Agent is blocked waiting on a human decision.",
+    };
+}
+//# sourceMappingURL=attention.js.map

package/dist/core/attention.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attention.js","sourceRoot":"","sources":["../../src/core/attention.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH,MAAM,OAAO,gBAAgB;IACnB,OAAO,GAAG,KAAK,CAAC;IAExB,uFAAuF;IACvF,OAAO,CAAC,OAA0B;QAChC,IAAI,OAAO,CAAC,KAAK,CAAC,uBAAuB,KAAK,IAAI,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QAC7E,IAAI,CAAC,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC;QAC7B,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;QAC3D,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO;aAC5B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,yBAAyB,CAAC;aACzD,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1B,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IACrC,CAAC;CACF;AAED,MAAM,UAAU,qBAAqB,CACnC,KAAsB,EACtB,eAAuB,EACvB,OAA0B;IAE1B,OAAO;QACL,eAAe;QACf,KAAK;QACL,MAAM,EAAE,UAAU;QAClB,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC;QACxB,IAAI,EAAE,+CAA+C;KACtD,CAAC;AACJ,CAAC"}

package/dist/core/compact.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Shared /compact orchestration for adapter sessions.
+ * Implements PRD §5.3, §5.7, and C-API-22.
+ */
+import type { ElwoodSessionStatus, Unsubscribe } from "./types.ts";
+export declare const defaultCompactTimeoutMs = 120000;
+export declare const compactCommand = "/compact";
+export type CompactEmitter = {
+    on(event: "hook", handler: (event: {
+        readonly hook_event_name: string;
+    }) => void): Unsubscribe;
+    on(event: "status", handler: (event: {
+        readonly status: ElwoodSessionStatus;
+    }) => void): Unsubscribe;
+};
+export declare function sessionCompact(emitter: CompactEmitter, submit: () => Promise<void>, nudge: () => void, timeoutMs: number | undefined): Promise<void>;
+//# sourceMappingURL=compact.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compact.d.ts","sourceRoot":"","sources":["../../src/core/compact.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEnE,eAAO,MAAM,uBAAuB,SAAU,CAAC;AAC/C,eAAO,MAAM,cAAc,aAAa,CAAC;AAYzC,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,GAAG,WAAW,CAAC;IAC/F,EAAE,CACA,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAA;KAAE,KAAK,IAAI,GACjE,WAAW,CAAC;CAChB,CAAC;AAEF,wBAAgB,cAAc,CAC5B,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAC3B,KAAK,EAAE,MAAM,IAAI,EACjB,SAAS,EAAE,MAAM,GAAG,SAAS,GAC5B,OAAO,CAAC,IAAI,CAAC,CAWf"}

package/dist/core/compact.js

@@ -0,0 +1,69 @@
+/**
+ * Shared /compact orchestration for adapter sessions.
+ * Implements PRD §5.3, §5.7, and C-API-22.
+ */
+import { elwoodError } from "./errors.js";
+import { terminalStatuses } from "./status-categories.js";
+export const defaultCompactTimeoutMs = 120_000;
+export const compactCommand = "/compact";
+const defaultNudgeDelayMs = 3_000;
+export function sessionCompact(emitter, submit, nudge, timeoutMs) {
+    const effectiveTimeoutMs = timeoutMs ?? defaultCompactTimeoutMs;
+    return runCompact({
+        submit,
+        nudge,
+        onHookName: (handler) => emitter.on("hook", (event) => handler(event.hook_event_name)),
+        onStatus: (handler) => emitter.on("status", (event) => handler(event.status)),
+        timeoutMs: effectiveTimeoutMs,
+        // Short caller timeouts pull the popup-recovery nudge forward too.
+        nudgeDelayMs: Math.min(defaultNudgeDelayMs, Math.floor(effectiveTimeoutMs / 2)),
+    });
+}
+function runCompact(wiring) {
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        let compactStarted = false;
+        let nudgeTimer;
+        const settle = (finish) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            clearTimeout(nudgeTimer);
+            offHook();
+            offStatus();
+            finish();
+        };
+        const timer = setTimeout(() => {
+            settle(() => reject(elwoodError("compact_failed", "Compaction did not report completion in time.")));
+        }, wiring.timeoutMs);
+        const offHook = wiring.onHookName((name) => {
+            if (name === "PreCompact")
+                compactStarted = true;
+            if (name === "PostCompact")
+                settle(resolve);
+        });
+        const offStatus = wiring.onStatus((status) => {
+            if (!terminalStatuses.has(status))
+                return;
+            settle(() => reject(elwoodError("session_not_running", "Session ended before compaction completed.")));
+        });
+        wiring.submit().then(() => {
+            // The submission can resolve AFTER the compact already settled (the
+            // timeout rejected, or the session ended): never arm a nudge then, or a
+            // stray Enter would land in a session whose compact() already failed.
+            if (settled)
+                return;
+            // A slash-command popup can swallow the submitting Enter keystroke.
+            // If the adapter has not acknowledged the command via PreCompact by
+            // then, one extra Enter is sent; at an empty composer it is a no-op.
+            nudgeTimer = setTimeout(() => {
+                if (!compactStarted)
+                    wiring.nudge();
+            }, wiring.nudgeDelayMs);
+        }, (error) => {
+            settle(() => reject(error));
+        });
+    });
+}
+//# sourceMappingURL=compact.js.map

package/dist/core/compact.js.map

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

package/dist/core/contained.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Contain non-critical observer failures so they cannot control runtime progress.
+ * Implements PRD §5.4 and §5.9 event-delivery isolation.
+ */
+/** Run a notification step without allowing observer failures to escape. */
+export declare function runContained(step: () => void): void;
+//# sourceMappingURL=contained.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contained.d.ts","sourceRoot":"","sources":["../../src/core/contained.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,IAAI,GAAG,IAAI,CAMnD"}

package/dist/core/contained.js

@@ -0,0 +1,14 @@
+/**
+ * Contain non-critical observer failures so they cannot control runtime progress.
+ * Implements PRD §5.4 and §5.9 event-delivery isolation.
+ */
+/** Run a notification step without allowing observer failures to escape. */
+export function runContained(step) {
+    try {
+        step();
+    }
+    catch {
+        // Observers are telemetry, never control flow.
+    }
+}
+//# sourceMappingURL=contained.js.map

package/dist/core/contained.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contained.js","sourceRoot":"","sources":["../../src/core/contained.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,4EAA4E;AAC5E,MAAM,UAAU,YAAY,CAAC,IAAgB;IAC3C,IAAI,CAAC;QACH,IAAI,EAAE,CAAC;IACT,CAAC;IAAC,MAAM,CAAC;QACP,+CAA+C;IACjD,CAAC;AACH,CAAC"}

package/dist/core/control-queue/index.d.ts

@@ -0,0 +1,21 @@
+/** Serialized adapter controls with readiness semantics (PRD §5.3/§5.9). */
+import { ControlQueueState } from "./state.ts";
+import { type ControlOperationKind, type ControlQueueError } from "./traits.ts";
+import type { AbortableQueueTask, Cancel, ControlSendOptions, ControlSubmissionOrigin, ControlSubmitter } from "./types.ts";
+export type { ControlOperationKind, ControlOperationTraits, ControlQueueError, ControlSubmitMode, ReadinessPolicy, } from "./traits.ts";
+export { controlOperationTraits } from "./traits.ts";
+export type { AbortableQueueTask, Cancel, ControlSendOptions, ControlSubmissionOrigin, ControlSubmitter, } from "./types.ts";
+export declare class ControlQueue extends ControlQueueState {
+    private readonly submit;
+    private readonly onTurnStarted;
+    private readonly guidanceMayBypass;
+    constructor(submit: ControlSubmitter, stoppedError: ControlQueueError, onTurnStarted: (origin: ControlSubmissionOrigin) => void, guidanceMayBypass?: () => boolean);
+    send(input: string, kind: ControlOperationKind, attach?: AbortableQueueTask, options?: ControlSendOptions): Promise<void>;
+    runExclusive(kind: ControlOperationKind, run: AbortableQueueTask, cancel?: Cancel): Promise<void>;
+    protected drain(): void;
+    private submitWithAttach;
+    private beginSubmission;
+    private commit;
+    private rollback;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/core/control-queue/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/control-queue/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAI5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EACL,KAAK,oBAAoB,EAEzB,KAAK,iBAAiB,EAIvB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,kBAAkB,EAClB,MAAM,EACN,kBAAkB,EAClB,uBAAuB,EACvB,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,YAAY,EACV,kBAAkB,EAClB,MAAM,EACN,kBAAkB,EAClB,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAIpB,qBAAa,YAAa,SAAQ,iBAAiB;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA4C;IAC1E,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAgB;gBAGhD,MAAM,EAAE,gBAAgB,EACxB,YAAY,EAAE,iBAAiB,EAC/B,aAAa,EAAE,CAAC,MAAM,EAAE,uBAAuB,KAAK,IAAI,EACxD,iBAAiB,GAAE,MAAM,OAAqB;IAQhD,IAAI,CACF,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,oBAAoB,EAC1B,MAAM,CAAC,EAAE,kBAAkB,EAC3B,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC;IAiBhB,YAAY,CACV,IAAI,EAAE,oBAAoB,EAC1B,GAAG,EAAE,kBAAkB,EACvB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC;IAahB,SAAS,CAAC,KAAK,IAAI,IAAI;YA8BT,gBAAgB;IAa9B,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,MAAM;IAOd,OAAO,CAAC,QAAQ;CASjB"}

package/dist/core/control-queue/index.js

@@ -0,0 +1,98 @@
+/** Serialized adapter controls with readiness semantics (PRD §5.3/§5.9). */
+import { runContained } from "../contained.js";
+import { toError } from "../errors.js";
+import { ControlQueueState } from "./state.js";
+import { controlOperationTraits, nextDispatchIndex, overtakesReadiness, } from "./traits.js";
+export { controlOperationTraits } from "./traits.js";
+const callerOrigin = { kind: "caller" };
+export class ControlQueue extends ControlQueueState {
+    submit;
+    onTurnStarted;
+    guidanceMayBypass;
+    constructor(submit, stoppedError, onTurnStarted, guidanceMayBypass = () => false) {
+        super(stoppedError);
+        this.submit = submit;
+        this.onTurnStarted = onTurnStarted;
+        this.guidanceMayBypass = guidanceMayBypass;
+    }
+    send(input, kind, attach, options = {}) {
+        const mayBypassReadiness = controlOperationTraits[kind].readiness === "running_after_ready" &&
+            this.everReady &&
+            this.guidanceMayBypass();
+        return this.enqueue({
+            input,
+            kind,
+            mayBypassReadiness,
+            origin: options.origin ?? callerOrigin,
+            ...(attach ? { attach } : {}),
+        }, options.cancel);
+    }
+    runExclusive(kind, run, cancel) {
+        return this.enqueue({
+            input: "",
+            kind,
+            mayBypassReadiness: false,
+            origin: callerOrigin,
+            run,
+        }, cancel);
+    }
+    drain() {
+        if (this.inFlight || this.queue.length === 0)
+            return;
+        const index = nextDispatchIndex(this.queue, this.ready, this.bypassable);
+        if (index < 0)
+            return;
+        const operation = this.queue.splice(index, 1)[0];
+        if (overtakesReadiness(operation))
+            this.bypassable -= 1;
+        this.inFlight = operation;
+        const traits = controlOperationTraits[operation.kind];
+        const priorReady = this.ready;
+        const epoch = this.readinessEpoch;
+        let dispatched;
+        try {
+            const signal = this.armAbort();
+            if (!operation.attach)
+                this.beginSubmission(operation, traits);
+            dispatched = operation.run
+                ? operation.run(signal)
+                : this.submitWithAttach(operation, traits, signal);
+        }
+        catch (error) {
+            this.rollback(operation, priorReady, epoch, toError(error));
+            return;
+        }
+        dispatched.then(() => this.commit(operation, traits), (error) => {
+            const cancellation = this.cancellation.errorFor(operation);
+            this.rollback(operation, priorReady, epoch, cancellation ?? toError(error));
+        });
+    }
+    async submitWithAttach(operation, traits, signal) {
+        if (operation.attach) {
+            await operation.attach(signal);
+            if (signal.aborted)
+                throw this.abortError(signal);
+            this.beginSubmission(operation, traits);
+        }
+        await this.submit(operation.input, traits.submitMode, signal);
+    }
+    beginSubmission(operation, traits) {
+        if (traits.consumesReadiness)
+            this.ready = false;
+        if (traits.reportsCallerSubmission && operation.origin.kind === "caller") {
+            runContained(() => this.onTurnStarted(operation.origin));
+        }
+    }
+    commit(operation, traits) {
+        if (traits.reportsCallerSubmission && operation.origin.kind === "loop") {
+            runContained(() => this.onTurnStarted(operation.origin));
+        }
+        this.settle(operation, () => operation.resolve());
+    }
+    rollback(operation, priorReady, epoch, error) {
+        if (!this.closed && this.readinessEpoch === epoch)
+            this.ready = priorReady;
+        this.settle(operation, () => operation.reject(error));
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/core/control-queue/index.js.map

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

package/dist/core/control-queue/state.d.ts

@@ -0,0 +1,29 @@
+/** Queue lifecycle and cancellation bookkeeping (PRD §5.3/§5.9). */
+import type { ControlQueueError } from "./traits.ts";
+import { ControlCancellation } from "./traits.ts";
+import type { Cancel, PendingOperation, QueuedOperation } from "./types.ts";
+/** Shared mutable state for the serialized control queue. */
+export declare abstract class ControlQueueState {
+    protected readonly queue: QueuedOperation[];
+    protected ready: boolean;
+    protected everReady: boolean;
+    protected closed: boolean;
+    protected readinessEpoch: number;
+    protected bypassable: number;
+    protected inFlight: QueuedOperation | undefined;
+    protected submitAbort: AbortController | undefined;
+    protected readonly cancellation: ControlCancellation;
+    protected readonly stoppedError: ControlQueueError;
+    protected constructor(stoppedError: ControlQueueError);
+    markReady(): void;
+    suspendReadiness(): void;
+    close(): void;
+    protected enqueue(op: PendingOperation, cancel?: Cancel): Promise<void>;
+    protected settle(operation: QueuedOperation, finish: () => void): void;
+    protected armAbort(): AbortSignal;
+    protected abortError(signal: AbortSignal): Error;
+    protected abstract drain(): void;
+    private listenForCancel;
+    private cancelOperation;
+}
+//# sourceMappingURL=state.d.ts.map

package/dist/core/control-queue/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/core/control-queue/state.ts"],"names":[],"mappings":"AAAA,oEAAoE;AAGpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAsB,MAAM,aAAa,CAAC;AACtE,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE5E,6DAA6D;AAC7D,8BAAsB,iBAAiB;IACrC,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,eAAe,EAAE,CAAM;IACjD,SAAS,CAAC,KAAK,UAAS;IACxB,SAAS,CAAC,SAAS,UAAS;IAC5B,SAAS,CAAC,MAAM,UAAS;IACzB,SAAS,CAAC,cAAc,SAAK;IAC7B,SAAS,CAAC,UAAU,SAAK;IACzB,SAAS,CAAC,QAAQ,EAAE,eAAe,GAAG,SAAS,CAAC;IAChD,SAAS,CAAC,WAAW,EAAE,eAAe,GAAG,SAAS,CAAC;IACnD,SAAS,CAAC,QAAQ,CAAC,YAAY,sBAA6B;IAC5D,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC;IAEnD,SAAS,aAAa,YAAY,EAAE,iBAAiB;IAIrD,SAAS,IAAI,IAAI;IAOjB,gBAAgB,IAAI,IAAI;IAKxB,KAAK,IAAI,IAAI;IAkBb,SAAS,CAAC,OAAO,CAAC,EAAE,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWvE,SAAS,CAAC,MAAM,CAAC,SAAS,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,IAAI,GAAG,IAAI;IAQtE,SAAS,CAAC,QAAQ,IAAI,WAAW;IAMjC,SAAS,CAAC,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,KAAK;IAIhD,SAAS,CAAC,QAAQ,CAAC,KAAK,IAAI,IAAI;IAEhC,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,eAAe;CAYxB"}