@with-logic/elwood 0.1.0

package/dist/claude/simple.d.ts

@@ -0,0 +1,28 @@
+/**
+ * `ClaudeSession`: the public Claude session (PRD §5.8). Constructed synchronously with
+ * the same options as the low-level factory (`cwd` defaults to `process.cwd()`), it starts
+ * Claude lazily on first use and exposes both the ergonomic `send`/`stream` API and the
+ * full control surface (all lazy-start-aware). Prefer this over the deprecated
+ * `startClaude` factory.
+ */
+import { SessionBase } from "../core/simple/session.ts";
+import type { ElwoodEventHandler, ElwoodEventName, StartClaudeOptions, Unsubscribe } from "../core/types.ts";
+import type { ClaudeLoginOptions } from "./login/types.ts";
+import type { ClaudeSessionApi } from "./session/interface.ts";
+/** Options for `ClaudeSession`: the low-level `startClaude` options with an optional `cwd`. */
+export type ClaudeSessionOptions = Omit<StartClaudeOptions, "cwd"> & {
+    readonly cwd?: string;
+};
+export declare class ClaudeSession extends SessionBase<ClaudeSessionApi> {
+    private readonly options;
+    constructor(options?: ClaudeSessionOptions);
+    protected launch(): Promise<ClaudeSessionApi>;
+    /** Claude's `Stop` hook carries `last_assistant_message` — the standard completeness signal. */
+    protected readBoundarySignal: import("../core/simple/turn-types.ts").BoundarySignalReader;
+    /** Typed event subscription over the Claude event map (buffered before start). */
+    on<E extends ElwoodEventName>(event: E, handler: ElwoodEventHandler<E>): Unsubscribe;
+    off<E extends ElwoodEventName>(event: E, handler: ElwoodEventHandler<E>): void;
+    /** Drive the interactive `/login` re-authentication flow (Claude-only, C-API-43). */
+    login(options: ClaudeLoginOptions): Promise<void>;
+}
+//# sourceMappingURL=simple.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"simple.d.ts","sourceRoot":"","sources":["../../src/claude/simple.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD,OAAO,KAAK,EACV,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,WAAW,EACZ,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAa/D,+FAA+F;AAC/F,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,kBAAkB,EAAE,KAAK,CAAC,GAAG;IAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/F,qBAAa,aAAc,SAAQ,WAAW,CAAC,gBAAgB,CAAC;IAC9D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;gBAEjC,OAAO,GAAE,oBAAyB;IAQ9C,SAAS,CAAC,MAAM,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAI7C,gGAAgG;IAChG,SAAS,CAAC,kBAAkB,8DAAyB;IAErD,kFAAkF;IAClF,EAAE,CAAC,CAAC,SAAS,eAAe,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,WAAW;IAMpF,GAAG,CAAC,CAAC,SAAS,eAAe,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,IAAI;IAM9E,qFAAqF;IAC/E,KAAK,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;CAGxD"}

package/dist/claude/simple.js

@@ -0,0 +1,45 @@
+/**
+ * `ClaudeSession`: the public Claude session (PRD §5.8). Constructed synchronously with
+ * the same options as the low-level factory (`cwd` defaults to `process.cwd()`), it starts
+ * Claude lazily on first use and exposes both the ergonomic `send`/`stream` API and the
+ * full control surface (all lazy-start-aware). Prefer this over the deprecated
+ * `startClaude` factory.
+ */
+import { resolveSessionPaths } from "../core/simple/resolve-paths.js";
+import { SessionBase } from "../core/simple/session.js";
+import { defaultBoundarySignal } from "../core/simple/turn.js";
+import { startClaude } from "./session/index.js";
+const _stopBoundaryCheck = true;
+void _stopBoundaryCheck;
+export class ClaudeSession extends SessionBase {
+    options;
+    constructor(options = {}) {
+        super();
+        // SNAPSHOT the working directory (and resolve any relative stateDir against it) at
+        // CONSTRUCTION, not at lazy launch: a `process.chdir()` between `new ClaudeSession()` and the
+        // first use must not change which project is launched/auto-trusted or where state is written.
+        this.options = resolveSessionPaths(options);
+    }
+    launch() {
+        return startClaude(this.options);
+    }
+    /** Claude's `Stop` hook carries `last_assistant_message` — the standard completeness signal. */
+    readBoundarySignal = defaultBoundarySignal;
+    /** Typed event subscription over the Claude event map (buffered before start). */
+    on(event, handler) {
+        // The attach closure captures the fully-typed (event, handler) pair — no cast crosses the
+        // base's buffer boundary, so the event↔payload correlation is preserved. The base keys the
+        // registration by (event, handler), so the returned disposer works before AND after start.
+        return this.subscribe(event, handler, (session) => session.on(event, handler));
+    }
+    off(event, handler) {
+        // Remove the registration matching this exact (event, handler) — detaching a live sub if
+        // attached — so a handler reused across events is unsubscribed from the right one only.
+        this.unsubscribe(event, handler);
+    }
+    /** Drive the interactive `/login` re-authentication flow (Claude-only, C-API-43). */
+    async login(options) {
+        return (await this.start()).login(options);
+    }
+}
+//# sourceMappingURL=simple.js.map

package/dist/claude/simple.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple.js","sourceRoot":"","sources":["../../src/claude/simple.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAA2B,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AASxF,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAWjD,MAAM,kBAAkB,GAA2B,IAAI,CAAC;AACxD,KAAK,kBAAkB,CAAC;AAKxB,MAAM,OAAO,aAAc,SAAQ,WAA6B;IAC7C,OAAO,CAAqB;IAE7C,YAAY,UAAgC,EAAE;QAC5C,KAAK,EAAE,CAAC;QACR,mFAAmF;QACnF,8FAA8F;QAC9F,8FAA8F;QAC9F,IAAI,CAAC,OAAO,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC9C,CAAC;IAES,MAAM;QACd,OAAO,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,gGAAgG;IACtF,kBAAkB,GAAG,qBAAqB,CAAC;IAErD,kFAAkF;IAClF,EAAE,CAA4B,KAAQ,EAAE,OAA8B;QACpE,0FAA0F;QAC1F,2FAA2F;QAC3F,2FAA2F;QAC3F,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;IACjF,CAAC;IACD,GAAG,CAA4B,KAAQ,EAAE,OAA8B;QACrE,yFAAyF;QACzF,wFAAwF;QACxF,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,qFAAqF;IACrF,KAAK,CAAC,KAAK,CAAC,OAA2B;QACrC,OAAO,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;CACF"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"start-or-resume.d.ts","sourceRoot":"","sources":["../../src/claude/start-or-resume.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,mBAAmB,EAAiB,MAAM,4BAA4B,CAAC;AACrF,OAAO,KAAK,EAAuB,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAGhF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG/D,MAAM,MAAM,0BAA0B,GAAG,kBAAkB,GAAG;IAC5D,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC,CAAC;AAEF,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,CAAC,CAOhD"}

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

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

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

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

package/dist/claude/startup-prompts.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Answers Claude first-party startup prompts that block embedded readiness:
+ * workspace/skill/plugin/MCP trust (via the allowlisted TrustPromptResponder)
+ * and the browser-tools prompt. Implements PRD §5.1, C-CLAUDE-10, C-CLAUDE-11,
+ * C-CLAUDE-14, and C-CLAUDE-16.
+ */
+import type { SettledStartupOutcome } from "../core/startup/write.ts";
+import { type TrustWriteResult } from "../core/trust/responder.ts";
+export declare class ClaudeStartupPromptResponder {
+    private readonly trust;
+    private browserDeclined;
+    constructor(autotrust: boolean);
+    handle(screenText: string, write: (input: string) => TrustWriteResult, readFrame?: () => string): readonly SettledStartupOutcome<"claude">[];
+}
+export declare function browserToolsPromptVisible(text: string): boolean;
+//# sourceMappingURL=startup-prompts.d.ts.map

package/dist/claude/startup-prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-prompts.d.ts","sourceRoot":"","sources":["../../src/claude/startup-prompts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAwB,KAAK,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAKzF,qBAAa,4BAA4B;IACvC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;IACvD,OAAO,CAAC,eAAe,CAAS;gBAEpB,SAAS,EAAE,OAAO;IAI9B,MAAM,CACJ,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,gBAAgB,EAC1C,SAAS,CAAC,EAAE,MAAM,MAAM,GACvB,SAAS,qBAAqB,CAAC,QAAQ,CAAC,EAAE;CAyB9C;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE/D"}

package/dist/claude/startup-prompts.js

@@ -0,0 +1,46 @@
+/**
+ * Answers Claude first-party startup prompts that block embedded readiness:
+ * workspace/skill/plugin/MCP trust (via the allowlisted TrustPromptResponder)
+ * and the browser-tools prompt. Implements PRD §5.1, C-CLAUDE-10, C-CLAUDE-11,
+ * C-CLAUDE-14, and C-CLAUDE-16.
+ */
+import { TrustPromptResponder } from "../core/trust/responder.js";
+// The prompt's documented decline keystroke (ESC).
+const declineKey = "\u001b";
+export class ClaudeStartupPromptResponder {
+    trust;
+    browserDeclined = false;
+    constructor(autotrust) {
+        this.trust = new TrustPromptResponder("claude", autotrust);
+    }
+    handle(screenText, write, readFrame) {
+        const settled = [];
+        const trust = this.trust.handle(screenText, write, readFrame);
+        if (trust?.kind === "answered") {
+            settled.push({ outcome: { kind: "answered", ...trust.automation }, settled: trust.settled });
+        }
+        else if (trust?.kind === "option_pending") {
+            settled.push({ outcome: { kind: "option_pending", prompt: trust.prompt } });
+        }
+        if (!this.browserDeclined && browserToolsPromptVisible(screenText)) {
+            // Escape is the prompt's documented decline path and needs no option
+            // number, so it stays correct if the option ordering changes. Settle
+            // OPTIMISTICALLY, but keep the decline retryable if the write is rejected
+            // so a later frame re-attempts it rather than reporting a false "answered".
+            this.browserDeclined = true;
+            const writeSettled = Promise.resolve(write(declineKey)).catch((error) => {
+                this.browserDeclined = false;
+                throw error;
+            });
+            settled.push({
+                outcome: { kind: "answered", prompt: "browser_tools", input: "esc" },
+                settled: writeSettled,
+            });
+        }
+        return settled;
+    }
+}
+export function browserToolsPromptVisible(text) {
+    return /use my browser/i.test(text) && /keep browser tools off/i.test(text);
+}
+//# sourceMappingURL=startup-prompts.js.map

package/dist/claude/startup-prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-prompts.js","sourceRoot":"","sources":["../../src/claude/startup-prompts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,oBAAoB,EAAyB,MAAM,4BAA4B,CAAC;AAEzF,mDAAmD;AACnD,MAAM,UAAU,GAAG,QAAQ,CAAC;AAE5B,MAAM,OAAO,4BAA4B;IACtB,KAAK,CAAiC;IAC/C,eAAe,GAAG,KAAK,CAAC;IAEhC,YAAY,SAAkB;QAC5B,IAAI,CAAC,KAAK,GAAG,IAAI,oBAAoB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,CACJ,UAAkB,EAClB,KAA0C,EAC1C,SAAwB;QAExB,MAAM,OAAO,GAAsC,EAAE,CAAC;QACtD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;QAC9D,IAAI,KAAK,EAAE,IAAI,KAAK,UAAU,EAAE,CAAC;YAC/B,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/F,CAAC;aAAM,IAAI,KAAK,EAAE,IAAI,KAAK,gBAAgB,EAAE,CAAC;YAC5C,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC9E,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,eAAe,IAAI,yBAAyB,CAAC,UAAU,CAAC,EAAE,CAAC;YACnE,qEAAqE;YACrE,qEAAqE;YACrE,0EAA0E;YAC1E,4EAA4E;YAC5E,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;YAC5B,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;gBAC/E,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC;gBAC7B,MAAM,KAAK,CAAC;YACd,CAAC,CAAC,CAAC;YACH,OAAO,CAAC,IAAI,CAAC;gBACX,OAAO,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,KAAK,EAAE;gBACpE,OAAO,EAAE,YAAY;aACtB,CAAC,CAAC;QACL,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAED,MAAM,UAAU,yBAAyB,CAAC,IAAY;IACpD,OAAO,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,yBAAyB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC9E,CAAC"}

package/dist/claude/startup-size.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Claude startup terminal-width floor. Claude's TUI needs at least this many
+ * columns to render its interactive prompt cleanly, so a session requested
+ * narrower bootstraps at this width and restores the requested size at initial
+ * readiness (PRD §5.3, C-API-36).
+ */
+export declare const CLAUDE_STARTUP_MIN_COLS = 100;
+//# sourceMappingURL=startup-size.d.ts.map

package/dist/claude/startup-size.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-size.d.ts","sourceRoot":"","sources":["../../src/claude/startup-size.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,uBAAuB,MAAM,CAAC"}

package/dist/claude/startup-size.js

@@ -0,0 +1,8 @@
+/**
+ * Claude startup terminal-width floor. Claude's TUI needs at least this many
+ * columns to render its interactive prompt cleanly, so a session requested
+ * narrower bootstraps at this width and restores the requested size at initial
+ * readiness (PRD §5.3, C-API-36).
+ */
+export const CLAUDE_STARTUP_MIN_COLS = 100;
+//# sourceMappingURL=startup-size.js.map

package/dist/claude/startup-size.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-size.js","sourceRoot":"","sources":["../../src/claude/startup-size.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC"}

package/dist/claude/tool-hook-events.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The Claude hook events that carry `tool_name`/`tool_input`, as one runtime list
+ * with its derived union so validation, settings matchers, and event typing cannot
+ * drift apart. Implements PRD §6.1.
+ */
+/** The hook events that carry `tool_name`/`tool_input`; the union is derived from it. */
+export declare const toolHookEventNames: readonly ["PermissionDenied", "PermissionRequest", "PostToolUse", "PostToolUseFailure", "PreToolUse"];
+export type ToolHookEventName = (typeof toolHookEventNames)[number];
+export declare function isToolHookEventName(value: unknown): value is ToolHookEventName;
+//# sourceMappingURL=tool-hook-events.d.ts.map

package/dist/claude/tool-hook-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-hook-events.d.ts","sourceRoot":"","sources":["../../src/claude/tool-hook-events.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,yFAAyF;AACzF,eAAO,MAAM,kBAAkB,uGAMrB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAE9E"}

package/dist/claude/tool-hook-events.js

@@ -0,0 +1,18 @@
+/**
+ * The Claude hook events that carry `tool_name`/`tool_input`, as one runtime list
+ * with its derived union so validation, settings matchers, and event typing cannot
+ * drift apart. Implements PRD §6.1.
+ */
+import { isOneOf } from "../core/predicates.js";
+/** The hook events that carry `tool_name`/`tool_input`; the union is derived from it. */
+export const toolHookEventNames = [
+    "PermissionDenied",
+    "PermissionRequest",
+    "PostToolUse",
+    "PostToolUseFailure",
+    "PreToolUse",
+];
+export function isToolHookEventName(value) {
+    return isOneOf(value, toolHookEventNames);
+}
+//# sourceMappingURL=tool-hook-events.js.map

package/dist/claude/tool-hook-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-hook-events.js","sourceRoot":"","sources":["../../src/claude/tool-hook-events.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAEhD,yFAAyF;AACzF,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,kBAAkB;IAClB,mBAAmB;IACnB,aAAa;IACb,oBAAoB;IACpB,YAAY;CACJ,CAAC;AAIX,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,OAAO,OAAO,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAC;AAC5C,CAAC"}

package/dist/claude/tool-types.d.ts

@@ -0,0 +1,158 @@
+/**
+ * Claude built-in and extensible tool input types.
+ * Implements PRD §6.
+ */
+import type { ClaudeCommonHookFields } from "./hook-names.ts";
+import type { PermissionUpdate } from "./permissions.ts";
+import type { ToolHookEventName } from "./tool-hook-events.ts";
+export type BashInput = {
+    readonly command: string;
+    readonly description?: string;
+    readonly timeout?: number;
+    readonly run_in_background?: boolean;
+};
+export type FileInput = {
+    readonly file_path: string;
+};
+export type ReadInput = FileInput & {
+    readonly offset?: number;
+    readonly limit?: number;
+};
+export type WriteInput = FileInput & {
+    readonly content: string;
+};
+export type EditInput = FileInput & {
+    readonly old_string: string;
+    readonly new_string: string;
+    readonly replace_all?: boolean;
+};
+export type GlobInput = {
+    readonly pattern: string;
+    readonly path?: string;
+};
+export type GrepInput = {
+    readonly pattern: string;
+    readonly path?: string;
+    readonly glob?: string;
+    readonly output_mode?: "content" | "files_with_matches" | "count";
+    readonly "-i"?: boolean;
+    readonly multiline?: boolean;
+};
+export type WebFetchInput = {
+    readonly url: string;
+    readonly prompt: string;
+};
+export type WebSearchInput = {
+    readonly query: string;
+    readonly allowed_domains?: readonly string[];
+    readonly blocked_domains?: readonly string[];
+};
+export type AgentInput = {
+    readonly prompt: string;
+    readonly description?: string;
+    readonly subagent_type?: string;
+    readonly model?: string;
+};
+export type SimplePromptInput = {
+    readonly prompt?: string;
+    readonly description?: string;
+};
+export type IdInput = {
+    readonly id: string;
+};
+export type ExitPlanModeInput = {
+    readonly allowedPrompts?: readonly string[];
+    readonly plan?: string;
+    readonly planFilePath?: string;
+};
+export type AskUserQuestionInput = {
+    readonly questions: readonly {
+        readonly question: string;
+        readonly header: string;
+        readonly options: readonly {
+            readonly label: string;
+            readonly description?: string;
+        }[];
+        readonly multiSelect?: boolean;
+    }[];
+    readonly answers?: Readonly<Record<string, string>>;
+};
+export type KnownClaudeToolName = "Agent" | "AskUserQuestion" | "Bash" | "CronCreate" | "CronDelete" | "CronList" | "Edit" | "EnterPlanMode" | "EnterWorktree" | "ExitPlanMode" | "ExitWorktree" | "Glob" | "Grep" | "LS" | "ListMcpResourcesTool" | "LSP" | "Monitor" | "MultiEdit" | "NotebookEdit" | "PowerShell" | "PushNotification" | "Read" | "ReadMcpResourceTool" | "RemoteTrigger" | "ScheduleWakeup" | "SendMessage" | "ShareOnboardingGuide" | "Skill" | "TaskCreate" | "TaskGet" | "TaskList" | "TaskOutput" | "TaskStop" | "TaskUpdate" | "TeamCreate" | "TeamDelete" | "TodoWrite" | "ToolSearch" | "WaitForMcpServers" | "WebFetch" | "WebSearch" | "Write";
+export type UnknownClaudeToolName = `mcp__${string}` | `unknown:${string}`;
+export type GenericToolInput = Readonly<Record<string, unknown>>;
+export type ClaudeToolInputByName = {
+    readonly tool_name: "Agent";
+    readonly tool_input: AgentInput;
+} | {
+    readonly tool_name: "AskUserQuestion";
+    readonly tool_input: AskUserQuestionInput;
+} | {
+    readonly tool_name: "Bash";
+    readonly tool_input: BashInput;
+} | {
+    readonly tool_name: "CronDelete" | "TaskGet" | "TaskOutput" | "TaskStop";
+    readonly tool_input: IdInput;
+} | {
+    readonly tool_name: "Edit";
+    readonly tool_input: EditInput;
+} | {
+    readonly tool_name: "ExitPlanMode";
+    readonly tool_input: ExitPlanModeInput;
+} | {
+    readonly tool_name: "Glob";
+    readonly tool_input: GlobInput;
+} | {
+    readonly tool_name: "Grep";
+    readonly tool_input: GrepInput;
+} | {
+    readonly tool_name: "PowerShell";
+    readonly tool_input: BashInput;
+} | {
+    readonly tool_name: "SendMessage" | "Skill" | "TaskCreate";
+    readonly tool_input: SimplePromptInput;
+} | {
+    readonly tool_name: "Read";
+    readonly tool_input: ReadInput;
+} | {
+    readonly tool_name: "WebFetch";
+    readonly tool_input: WebFetchInput;
+} | {
+    readonly tool_name: "WebSearch";
+    readonly tool_input: WebSearchInput;
+} | {
+    readonly tool_name: "Write";
+    readonly tool_input: WriteInput;
+} | {
+    readonly tool_name: GenericKnownToolName;
+    readonly tool_input: GenericToolInput;
+} | {
+    readonly tool_name: UnknownClaudeToolName;
+    readonly tool_input: GenericToolInput;
+};
+type GenericKnownToolName = Exclude<KnownClaudeToolName, "Agent" | "AskUserQuestion" | "Bash" | "CronDelete" | "Edit" | "ExitPlanMode" | "Glob" | "Grep" | "PowerShell" | "Read" | "SendMessage" | "Skill" | "TaskCreate" | "TaskGet" | "TaskOutput" | "TaskStop" | "WebFetch" | "WebSearch" | "Write">;
+export type ClaudeToolInputUpdate<Tool extends ClaudeToolInputByName = ClaudeToolInputByName> = Partial<Tool["tool_input"]>;
+export type ClaudeToolEventFields<E extends ToolHookEventName> = E extends "PreToolUse" ? {
+    readonly tool_use_id?: string;
+} : E extends "PermissionRequest" ? {
+    readonly permission_suggestions?: readonly PermissionUpdate[];
+} : E extends "PostToolUse" ? {
+    readonly tool_use_id?: string;
+    readonly tool_response: unknown;
+    readonly duration_ms?: number;
+} : E extends "PostToolUseFailure" ? {
+    readonly tool_use_id?: string;
+    readonly error: string;
+    readonly is_interrupt?: boolean;
+    readonly duration_ms?: number;
+} : E extends "PermissionDenied" ? {
+    readonly tool_use_id: string;
+    readonly reason: string;
+} : Record<string, never>;
+export type ClaudeToolEventForName<E extends ToolHookEventName> = ClaudeCommonHookFields & {
+    readonly hook_event_name: E;
+} & ClaudeToolInputByName & ClaudeToolEventFields<E>;
+export type ClaudeToolEvent = {
+    readonly [E in ToolHookEventName]: ClaudeToolEventForName<E>;
+}[ToolHookEventName];
+export {};
+//# sourceMappingURL=tool-types.d.ts.map

package/dist/claude/tool-types.d.ts.map

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

package/dist/claude/tool-types.js

@@ -0,0 +1,6 @@
+/**
+ * Claude built-in and extensible tool input types.
+ * Implements PRD §6.
+ */
+export {};
+//# sourceMappingURL=tool-types.js.map

package/dist/claude/tool-types.js.map

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

package/dist/claude/transcript/baseline.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Backward current-turn recovery for the transcript cursor.
+ * Implements PRD §5.4 (C-CLAUDE-15): scans BACKWARD from EOF to the last user
+ * PROMPT so a Stop-first first-observe replays the whole committed current turn
+ * without corrupting a UTF-8 code point at a block seam, without O(n²) window
+ * re-splits, and — when the turn is larger than the cap — without silently
+ * dropping the whole turn (the in-window committed records are recovered instead).
+ */
+/** Test seam: shrink the record budget so the CPU guard is exercisable cheaply. */
+export declare function setMaxRecordsForTests(value: number): void;
+export declare function resetMaxRecordsForTests(): void;
+/**
+ * Recovered current turn: the committed record lines plus whether the scan hit
+ * its byte/record cap before the user PROMPT boundary. `truncated` is true only
+ * on that cap path (NOT on a clean BOF with no boundary, which has no turn to
+ * recover); `unrecoveredBytes` is then the magnitude of the earlier-in-file
+ * portion that fell outside the window, so the caller can surface it as a bounded,
+ * content-free drop rather than silently losing it.
+ */
+export type BaselineTail = {
+    readonly lines: readonly string[];
+    readonly truncated: boolean;
+    readonly unrecoveredBytes: number;
+};
+/**
+ * Scans backward in bounded blocks to the last user PROMPT. Blocks are collected
+ * newest-first and reversed ONCE at return (no repeated prepend), and only each
+ * block's OWN lines are scanned for a boundary (the seam line re-merges with the
+ * carried head), so total work stays linear. Returns the current-turn lines and
+ * whether the scan stopped at the cap/BOF without finding the boundary.
+ */
+export declare function scanBaselineTail(path: string, size: number): BaselineTail;
+//# sourceMappingURL=baseline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"baseline.d.ts","sourceRoot":"","sources":["../../../src/claude/transcript/baseline.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,mFAAmF;AACnF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAEzD;AACD,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,CAiCzE"}

package/dist/claude/transcript/baseline.js

@@ -0,0 +1,108 @@
+/**
+ * Backward current-turn recovery for the transcript cursor.
+ * Implements PRD §5.4 (C-CLAUDE-15): scans BACKWARD from EOF to the last user
+ * PROMPT so a Stop-first first-observe replays the whole committed current turn
+ * without corrupting a UTF-8 code point at a block seam, without O(n²) window
+ * re-splits, and — when the turn is larger than the cap — without silently
+ * dropping the whole turn (the in-window committed records are recovered instead).
+ */
+import { readBackwardBlock } from "./cursor-io.js";
+const stepBytes = 64 * 1024; // one backward step in current-turn recovery
+const maxBytes = 4 * 1024 * 1024; // cap on how far back the baseline scan reaches
+// Hard record-count budget so a pathological many-tiny-line window cannot run an
+// unbounded JSON.parse loop even inside the byte cap (a CPU guard, not a byte one).
+const defaultMaxRecords = 200_000;
+let maxRecords = defaultMaxRecords;
+/** Test seam: shrink the record budget so the CPU guard is exercisable cheaply. */
+export function setMaxRecordsForTests(value) {
+    maxRecords = value;
+}
+export function resetMaxRecordsForTests() {
+    maxRecords = defaultMaxRecords;
+}
+/**
+ * Scans backward in bounded blocks to the last user PROMPT. Blocks are collected
+ * newest-first and reversed ONCE at return (no repeated prepend), and only each
+ * block's OWN lines are scanned for a boundary (the seam line re-merges with the
+ * carried head), so total work stays linear. Returns the current-turn lines and
+ * whether the scan stopped at the cap/BOF without finding the boundary.
+ */
+export function scanBaselineTail(path, size) {
+    if (size === 0)
+        return { lines: [], truncated: false, unrecoveredBytes: 0 };
+    const chunks = []; // confirmed post-frontier line runs, newest-first
+    let head = ""; // partial first line of the block just scanned (seam carry)
+    let end = size;
+    let records = 0;
+    while (size - end < maxBytes && records < maxRecords) {
+        const start = Math.max(0, end - stepBytes);
+        const block = readBackwardBlock(path, start, end);
+        const lines = block.text.split(/\r?\n/);
+        lines[lines.length - 1] += head; // re-merge the seam-split line with the carry
+        records += lines.length;
+        const boundary = lastUserLine(lines);
+        if (boundary >= 0)
+            return {
+                lines: flatten(chunks, lines.slice(boundary + 1)),
+                truncated: false,
+                unrecoveredBytes: 0,
+            };
+        // Reached the start of the file with NO prompt: the file holds no boundary at
+        // all, so there is no current turn to recover — matches the pre-fix contract.
+        if (block.start === 0)
+            return { lines: [], truncated: false, unrecoveredBytes: 0 };
+        head = lines[0]; // carry the (still partial) first line one step back
+        chunks.push(lines.slice(1));
+        end = block.start;
+    }
+    // Cap/record-budget hit BEFORE the boundary (the turn is larger than the cap):
+    // recover the in-window bounded records rather than discarding the whole turn.
+    // The carried `head` is a partial first line (the window began mid-file), so it
+    // is dropped, not emitted; every complete in-window record is kept. `end` is the
+    // byte offset the recovered window begins at, so the `[0, end)` prefix is the
+    // magnitude of the earlier-in-file portion that was NOT recovered.
+    return { lines: flatten(chunks, []), truncated: true, unrecoveredBytes: end };
+}
+// Assemble the turn in FORWARD (oldest-first) order. `tail` is the post-boundary
+// run of the deepest block (oldest lines); `chunks` were pushed newest-first, so
+// they are walked in reverse to append oldest→newest. Flattened exactly once.
+function flatten(chunks, tail) {
+    const out = [...tail];
+    for (let i = chunks.length - 1; i >= 0; i--)
+        out.push(...chunks[i]);
+    return out;
+}
+/** Index of the last `user`-role PROMPT line in `lines`, or -1 if none. */
+function lastUserLine(lines) {
+    for (let i = lines.length - 1; i >= 0; i--) {
+        if (isUserRecord(lines[i]))
+            return i;
+    }
+    return -1;
+}
+// True only for a genuine user PROMPT — the real turn boundary. A `tool_result`
+// is ALSO a `type:"user"` record but belongs to the current turn, so it is NOT a
+// boundary (else committed tool activity is dropped). A prompt carries prose
+// (string content or a `text` block); a pure tool_result carries only those.
+// A cheap prefilter skips JSON.parse for any line that cannot be a user record.
+function isUserRecord(line) {
+    if (!line.includes('"user"'))
+        return false; // prefilter: no user marker → not a boundary
+    try {
+        const record = JSON.parse(line);
+        if (record.type !== "user")
+            return false;
+        const content = record.message?.content;
+        if (typeof content === "string")
+            return true; // string content is always prose
+        if (!Array.isArray(content))
+            return false;
+        // A prompt has at least one non-tool_result block; a pure tool_result record
+        // (every block is a tool_result) is part of the current turn, not a boundary.
+        return content.some((block) => block?.type !== "tool_result");
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=baseline.js.map

package/dist/claude/transcript/baseline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseline.js","sourceRoot":"","sources":["../../../src/claude/transcript/baseline.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,SAAS,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,6CAA6C;AAC1E,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,gDAAgD;AAClF,iFAAiF;AACjF,oFAAoF;AACpF,MAAM,iBAAiB,GAAG,OAAO,CAAC;AAClC,IAAI,UAAU,GAAG,iBAAiB,CAAC;AAEnC,mFAAmF;AACnF,MAAM,UAAU,qBAAqB,CAAC,KAAa;IACjD,UAAU,GAAG,KAAK,CAAC;AACrB,CAAC;AACD,MAAM,UAAU,uBAAuB;IACrC,UAAU,GAAG,iBAAiB,CAAC;AACjC,CAAC;AAgBD;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,IAAY;IACzD,IAAI,IAAI,KAAK,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC,EAAE,CAAC;IAC5E,MAAM,MAAM,GAAe,EAAE,CAAC,CAAC,kDAAkD;IACjF,IAAI,IAAI,GAAG,EAAE,CAAC,CAAC,4DAA4D;IAC3E,IAAI,GAAG,GAAG,IAAI,CAAC;IACf,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,OAAO,IAAI,GAAG,GAAG,GAAG,QAAQ,IAAI,OAAO,GAAG,UAAU,EAAE,CAAC;QACrD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,SAAS,CAAC,CAAC;QAC3C,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;QAClD,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACxC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,8CAA8C;QAC/E,OAAO,IAAI,KAAK,CAAC,MAAM,CAAC;QACxB,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,QAAQ,IAAI,CAAC;YACf,OAAO;gBACL,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;gBACjD,SAAS,EAAE,KAAK;gBAChB,gBAAgB,EAAE,CAAC;aACpB,CAAC;QACJ,8EAA8E;QAC9E,8EAA8E;QAC9E,IAAI,KAAK,CAAC,KAAK,KAAK,CAAC;YAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC,EAAE,CAAC;QACnF,IAAI,GAAG,KAAK,CAAC,CAAC,CAAW,CAAC,CAAC,qDAAqD;QAChF,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5B,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC;IACpB,CAAC;IACD,+EAA+E;IAC/E,+EAA+E;IAC/E,gFAAgF;IAChF,iFAAiF;IACjF,8EAA8E;IAC9E,mEAAmE;IACnE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,gBAAgB,EAAE,GAAG,EAAE,CAAC;AAChF,CAAC;AAED,iFAAiF;AACjF,iFAAiF;AACjF,8EAA8E;AAC9E,SAAS,OAAO,CAAC,MAA2B,EAAE,IAAuB;IACnE,MAAM,GAAG,GAAa,CAAC,GAAG,IAAI,CAAC,CAAC;IAChC,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE;QAAE,GAAG,CAAC,IAAI,CAAC,GAAI,MAAM,CAAC,CAAC,CAAc,CAAC,CAAC;IAClF,OAAO,GAAG,CAAC;AACb,CAAC;AAED,2EAA2E;AAC3E,SAAS,YAAY,CAAC,KAAwB;IAC5C,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC,CAAW,CAAC;YAAE,OAAO,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,CAAC,CAAC,CAAC;AACZ,CAAC;AAED,gFAAgF;AAChF,iFAAiF;AACjF,6EAA6E;AAC7E,6EAA6E;AAC7E,gFAAgF;AAChF,SAAS,YAAY,CAAC,IAAY;IAChC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC,CAAC,6CAA6C;IACzF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAwD,CAAC;QACvF,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM;YAAE,OAAO,KAAK,CAAC;QACzC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC;QACxC,IAAI,OAAO,OAAO,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC,CAAC,iCAAiC;QAC/E,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;YAAE,OAAO,KAAK,CAAC;QAC1C,6EAA6E;QAC7E,8EAA8E;QAC9E,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAE,KAA4B,EAAE,IAAI,KAAK,aAAa,CAAC,CAAC;IACxF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/claude/transcript/cursor-io.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Bounded filesystem primitives for the Claude transcript cursor.
+ * Implements PRD §5.4 (C-CLAUDE-15). The forward primitives (stat, forward range
+ * read, the injectable byte seam) are shared with Codex via core/transcript/cursor-io;
+ * this file adds the Claude-only BACKWARD block read used by the baseline-tail scan,
+ * funneling through the SAME shared byte seam so a test still controls all reads.
+ */
+export { type ByteReader, byteLen, fileSize, type RangeRead, readBytes, readRange, resetByteReaderForTests, setByteReaderForTests, } from "../../core/transcript/cursor-io.ts";
+/** One backward block: its decoded text and the byte offset it actually begins at. */
+export type BackwardBlock = {
+    readonly text: string;
+    readonly start: number;
+};
+export declare function readBackwardBlock(path: string, start: number, end: number): BackwardBlock;
+//# sourceMappingURL=cursor-io.d.ts.map