@relayflows/sdk 2.0.41 → 2.0.43

package/dist/journal-client.js

@@ -7,38 +7,28 @@
 // AGENTS.md rule 4). The kernel binary (`kernel/relayflowd serve`) speaks
 // this transport, including out-of-band leases, watches, events, and durable
 // stream plumbing. The client's framing and failure behavior is covered by a
-// loopback double in tests.
-import { EventEmitter } from 'node:events';
+// loopback double in tests. Framing and the socket lifecycle live in
+// journal-connection.ts; budgeted reads in journal-budgeted-reads.ts.
+import { READ_ONLY_VERBS } from './journal-read-policy.js';
+import { JournalConnection, JournalProtocolError } from './journal-connection.js';
+export { JournalFrameError, JournalProtocolError } from './journal-connection.js';
+import { BudgetedReads } from './journal-budgeted-reads.js';
+export { JournalReadInterruptedError, JournalRequestTimeoutError } from './journal-read-policy.js';
 export { walkJournal, JournalReadError } from './journal-reader.js';
-import { randomUUID } from 'node:crypto';
-import { createConnection } from 'node:net';
 import { PROTOCOL_VERSION, } from './protocol.js';
-/** A structured rejection returned by relayflowd over the journal protocol. */
-export class JournalProtocolError extends Error {
-    code;
-    verb;
-    constructor(code, message) {
-        super(`${code}: ${message}`);
-        this.name = 'JournalProtocolError';
-        this.code = code;
-    }
-}
-export class JournalClient extends EventEmitter {
-    socketPath;
+export class JournalClient extends JournalConnection {
+    budgeted;
+    budgetHandshake;
     /** Additive request capabilities the daemon advertised at `hello`; none until then. */
     features = new Set();
-    socket = null;
-    /** Why the connection ended, so a later "not connected" names its cause rather than hiding it. */
-    disconnectCause;
-    buffer = '';
-    pending = new Map();
-    requestTimeoutMs;
-    connectTimeoutMs;
     constructor(socketPath, options = {}) {
-        super();
-        this.socketPath = socketPath;
-        this.requestTimeoutMs = options.requestTimeoutMs ?? 30_000;
-        this.connectTimeoutMs = options.connectTimeoutMs ?? 2_000;
+        super(socketPath, options.requestTimeoutMs ?? 30_000, options.connectTimeoutMs ?? 2_000);
+        this.budgetHandshake = options.budgetHandshake === true;
+        this.budgeted = options.readBudgetMs === undefined ? undefined
+            : new BudgetedReads(this, options.readBudgetMs, options.readSignal);
+    }
+    connectionClosed(cause, unexpected) {
+        this.budgeted?.close(cause, unexpected);
     }
     /** Independent session for an SDK helper worker; preserves the caller's registration. */
     createPeer() {
@@ -46,134 +36,36 @@ export class JournalClient extends EventEmitter {
             requestTimeoutMs: this.requestTimeoutMs, connectTimeoutMs: this.connectTimeoutMs,
         });
     }
-    /** Open the unix socket connection. Rejects on connect failure (fail-closed). */
-    connect() {
-        return new Promise((resolve, reject) => {
-            if (this.socket)
-                return resolve();
-            const socket = createConnection({ path: this.socketPath });
-            const timer = setTimeout(() => {
-                socket.removeAllListeners();
-                socket.destroy();
-                this.failAll(new Error(`journal client: connect timed out after ${this.connectTimeoutMs}ms`));
-                reject(new Error(`journal client: connect timed out after ${this.connectTimeoutMs}ms`));
-            }, this.connectTimeoutMs);
-            const onError = (err) => {
-                clearTimeout(timer);
-                socket.removeAllListeners();
-                this.failAll(err);
-                reject(new Error(`journal client: connect failed: ${err.message}`));
-            };
-            socket.once('error', onError);
-            socket.once('connect', () => {
-                clearTimeout(timer);
-                socket.removeListener('error', onError);
-                socket.on('error', (err) => { this.disconnectCause ??= err; this.failAll(err); });
-                socket.on('data', (chunk) => this.onData(chunk));
-                socket.on('close', () => {
-                    const closed = new Error('journal client: connection closed');
-                    this.disconnectCause ??= closed;
-                    this.failAll(closed);
-                });
-                this.disconnectCause = undefined;
-                this.socket = socket;
-                resolve();
-            });
-        });
+    request(verb, params, timeoutMs = this.requestTimeoutMs, signal) {
+        // Every allowlisted read takes the policy, even after the primary dropped: its
+        // closed state then answers with the typed interruption recorded at the drop.
+        if (this.budgeted !== undefined && timeoutMs !== null && READ_ONLY_VERBS.has(verb)) {
+            return this.budgeted.read(verb, params, timeoutMs, signal);
+        }
+        return this.requestOnce(verb, params, timeoutMs, signal);
     }
     /**
-     * Close the connection and reject any pending requests. A `cause` (for
-     * example the worker failure that forced the close) is carried into every
-     * later "not connected" rejection.
+     * Cancel budgeted reads also when `signal` aborts — a root attempt's lease —
+     * until the returned release is called. A no-op without a read budget.
      */
-    close(cause) {
-        const closed = cause === undefined
-            ? new Error('journal client: closed by caller')
-            : new Error(`journal client: closed after ${cause instanceof Error ? cause.message : String(cause)}`, { cause });
-        this.disconnectCause ??= closed;
-        this.failAll(closed);
-        this.socket?.destroy();
-        this.socket = null;
-        this.buffer = '';
-    }
-    onData(chunk) {
-        this.buffer += chunk.toString('utf8');
-        let nl;
-        while ((nl = this.buffer.indexOf('\n')) !== -1) {
-            const line = this.buffer.slice(0, nl);
-            this.buffer = this.buffer.slice(nl + 1);
-            if (line.length > 0)
-                this.onLine(line);
-        }
+    scopeReads(signal) {
+        return this.budgeted?.scope(signal) ?? (() => { });
     }
-    onLine(line) {
-        let msg;
-        try {
-            msg = JSON.parse(line);
-        }
-        catch {
-            // A malformed frame is a protocol violation; fail closed.
-            this.failAll(new Error('journal client: malformed frame from server'));
-            return;
-        }
-        if (typeof msg.id === 'string' && 'ok' in msg) {
-            const res = msg;
-            const pending = this.pending.get(res.id);
-            if (!pending)
-                return; // reply for an already-timed-out request
-            this.pending.delete(res.id);
-            if (pending.timer !== undefined)
-                clearTimeout(pending.timer);
-            if (res.ok)
-                pending.resolve(res.result);
-            else
-                pending.reject(new JournalProtocolError(res.error.code, res.error.message));
-        }
-        else {
-            const ev = msg;
-            this.emit(ev.event, ev.data);
-            this.emit('event', ev);
-        }
-    }
-    failAll(err) {
-        for (const [, p] of this.pending) {
-            if (p.timer !== undefined)
-                clearTimeout(p.timer);
-            p.reject(err);
-        }
-        this.pending.clear();
-    }
-    request(verb, params, timeoutMs = this.requestTimeoutMs) {
-        return new Promise((resolve, reject) => {
-            if (!this.socket || this.socket.destroyed) {
-                const cause = this.disconnectCause;
-                reject(new Error(`journal client: not connected (${verb})${cause === undefined ? '' : `: ${cause.message}`}`, cause === undefined ? undefined : { cause }));
-                return;
-            }
-            const id = randomUUID();
-            const frame = { id, verb: verb, params };
-            const timer = timeoutMs === null ? undefined : setTimeout(() => {
-                this.pending.delete(id);
-                reject(new Error(`journal client: ${verb} timed out after ${timeoutMs}ms`));
-            }, timeoutMs);
-            this.pending.set(id, { resolve: resolve, reject, timer });
-            this.socket.write(JSON.stringify(frame) + '\n', (err) => {
-                if (err) {
-                    const p = this.pending.get(id);
-                    if (p) {
-                        if (p.timer !== undefined)
-                            clearTimeout(p.timer);
-                        this.pending.delete(id);
-                        p.reject(new Error(`journal client: ${verb} write failed: ${err.message}`));
-                    }
-                }
-            });
-        });
+    /**
+     * End every budgeted read now and refuse later ones; the session itself stays
+     * open. The reads end as read interruptions, so a worker hands its attempt
+     * back to the kernel rather than completing it as a failure.
+     */
+    cancelReads() {
+        this.budgeted?.close(new Error('journal client: reads canceled'), true);
     }
     // --- Typed verb methods (gate 1 minimal set, kernel DESIGN.md §5) --------
     /** Handshake; version mismatch is a hard error. Records the daemon's additive features. */
     async hello(client) {
-        const result = await this.request('hello', { protocol: PROTOCOL_VERSION, client });
+        const params = { protocol: PROTOCOL_VERSION, client };
+        // A flow client's handshake meets the same CPU load as its reads.
+        const result = this.budgeted === undefined || !this.budgetHandshake ? await this.request('hello', params)
+            : await this.budgeted.handshake(params, this.requestTimeoutMs);
         this.features = new Set(Array.isArray(result.features) ? result.features.filter(f => typeof f === 'string') : []);
         return result;
     }
@@ -200,12 +92,14 @@ export class JournalClient extends EventEmitter {
         return this.request('run.cancel', { run_id: runId }, null);
     }
     /** Snapshot for legibility. */
-    runGet(runId) {
-        return this.request('run.get', { run_id: runId });
+    runGet(runId, options = {}) {
+        return this.request('run.get', { run_id: runId }, this.requestTimeoutMs, options.signal);
     }
     /**
-     * Open a push stream of every appended entry. Resolves once subscribed;
-     * entries arrive as `'entry'` events: `client.on('entry', (entry) => …)`.
+     * Open a push stream of every appended entry. The daemon writes the run's
+     * existing entries before this resolves (server.rs `watch_with_replay`), so
+     * the replay is fully delivered first; later entries arrive as they are
+     * appended. Entries arrive as `'entry'` events: `client.on('entry', (entry) => …)`.
      */
     runWatch(runId) {
         return this.request('run.watch', { run_id: runId });

package/dist/journal-client.js.map

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

package/dist/journal-connection.d.ts

@@ -0,0 +1,42 @@
+import { EventEmitter } from 'node:events';
+import { type Socket } from 'node:net';
+import type { VerbContract } from './protocol.js';
+/** A structured rejection returned by relayflowd over the journal protocol. */
+export declare class JournalProtocolError extends Error {
+    readonly code: string;
+    verb?: string;
+    constructor(code: string, message: string);
+}
+/** The daemon sent a frame this client cannot parse: a protocol violation, never retried. */
+export declare class JournalFrameError extends Error {
+    constructor(message?: string);
+}
+/** Framing, socket lifecycle and request correlation; the typed verbs live on JournalClient. */
+export declare class JournalConnection extends EventEmitter {
+    readonly socketPath: string;
+    protected readonly requestTimeoutMs: number;
+    protected readonly connectTimeoutMs: number;
+    protected socket: Socket | null;
+    private connectingSocket;
+    /** Why the connection ended, so a later "not connected" names its cause rather than hiding it. */
+    protected disconnectCause: Error | undefined;
+    private buffer;
+    private readonly pending;
+    constructor(socketPath: string, requestTimeoutMs: number, connectTimeoutMs: number);
+    /** Hook for sessions layered on this one: `unexpected` is a drop the caller did not ask for. */
+    protected connectionClosed(_cause: unknown, _unexpected: boolean): void;
+    /** Open the unix socket connection. Rejects on connect failure (fail-closed). */
+    connect(): Promise<void>;
+    /**
+     * Close the connection and reject any pending requests. A `cause` (for
+     * example the worker failure that forced the close) is carried into every
+     * later "not connected" rejection.
+     */
+    close(cause?: unknown): void;
+    private onData;
+    private onLine;
+    private failAll;
+    /** @internal One unretried request on this session; flow reads go through `request`. */
+    requestOnce<V extends keyof VerbContract>(verb: V, params: VerbContract[V]['params'], timeoutMs?: number | null, signal?: AbortSignal): Promise<VerbContract[V]['result']>;
+}
+//# sourceMappingURL=journal-connection.d.ts.map

package/dist/journal-connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal-connection.d.ts","sourceRoot":"","sources":["../src/journal-connection.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAoB,KAAK,MAAM,EAAE,MAAM,UAAU,CAAC;AAEzD,OAAO,KAAK,EAAkC,YAAY,EAAE,MAAM,eAAe,CAAC;AAQlF,+EAA+E;AAC/E,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;gBAEF,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK1C;AAED,6FAA6F;AAC7F,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,SAAgD;CAIpE;AAED,gGAAgG;AAChG,qBAAa,iBAAkB,SAAQ,YAAY;IAS/C,QAAQ,CAAC,UAAU,EAAE,MAAM;IAC3B,SAAS,CAAC,QAAQ,CAAC,gBAAgB,EAAE,MAAM;IAC3C,SAAS,CAAC,QAAQ,CAAC,gBAAgB,EAAE,MAAM;IAV7C,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAQ;IACvC,OAAO,CAAC,gBAAgB,CAAqB;IAC7C,kGAAkG;IAClG,SAAS,CAAC,eAAe,EAAE,KAAK,GAAG,SAAS,CAAC;IAC7C,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;gBAG3C,UAAU,EAAE,MAAM,EACR,gBAAgB,EAAE,MAAM,EACxB,gBAAgB,EAAE,MAAM;IAK7C,gGAAgG;IAChG,SAAS,CAAC,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,GAAG,IAAI;IAEvE,iFAAiF;IACjF,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAwCxB;;;;OAIG;IACH,KAAK,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI;IAa5B,OAAO,CAAC,MAAM;IAUd,OAAO,CAAC,MAAM;IA4Bd,OAAO,CAAC,OAAO;IAQf,wFAAwF;IACxF,WAAW,CAAC,CAAC,SAAS,MAAM,YAAY,EACtC,IAAI,EAAE,CAAC,EACP,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EACjC,SAAS,GAAE,MAAM,GAAG,IAA4B,EAChD,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;CA+CtC"}

package/dist/journal-connection.js

@@ -0,0 +1,209 @@
+// Journal-protocol v0 client (kernel DESIGN.md §5).
+//
+// A real client implementation of the wire protocol — newline-delimited JSON
+// over a unix socket. It correlates requests by `id`, demultiplexes
+// server-pushed events, and is fail-closed: a connection drop or write error
+// rejects every pending request (a journal write that fails fails the step;
+// AGENTS.md rule 4). The kernel binary (`kernel/relayflowd serve`) speaks
+// this transport, including out-of-band leases, watches, events, and durable
+// stream plumbing. The client's framing and failure behavior is covered by a
+// loopback double in tests.
+import { EventEmitter } from 'node:events';
+import { randomUUID } from 'node:crypto';
+import { createConnection } from 'node:net';
+import { JournalRequestTimeoutError } from './journal-read-policy.js';
+/** A structured rejection returned by relayflowd over the journal protocol. */
+export class JournalProtocolError extends Error {
+    code;
+    verb;
+    constructor(code, message) {
+        super(`${code}: ${message}`);
+        this.name = 'JournalProtocolError';
+        this.code = code;
+    }
+}
+/** The daemon sent a frame this client cannot parse: a protocol violation, never retried. */
+export class JournalFrameError extends Error {
+    constructor(message = 'journal client: malformed frame from server') {
+        super(message);
+        this.name = 'JournalFrameError';
+    }
+}
+/** Framing, socket lifecycle and request correlation; the typed verbs live on JournalClient. */
+export class JournalConnection extends EventEmitter {
+    socketPath;
+    requestTimeoutMs;
+    connectTimeoutMs;
+    socket = null;
+    connectingSocket;
+    /** Why the connection ended, so a later "not connected" names its cause rather than hiding it. */
+    disconnectCause;
+    buffer = '';
+    pending = new Map();
+    constructor(socketPath, requestTimeoutMs, connectTimeoutMs) {
+        super();
+        this.socketPath = socketPath;
+        this.requestTimeoutMs = requestTimeoutMs;
+        this.connectTimeoutMs = connectTimeoutMs;
+    }
+    /** Hook for sessions layered on this one: `unexpected` is a drop the caller did not ask for. */
+    connectionClosed(_cause, _unexpected) { }
+    /** Open the unix socket connection. Rejects on connect failure (fail-closed). */
+    connect() {
+        return new Promise((resolve, reject) => {
+            if (this.socket)
+                return resolve();
+            const socket = createConnection({ path: this.socketPath });
+            this.connectingSocket = socket;
+            const timer = setTimeout(() => {
+                socket.removeAllListeners();
+                socket.destroy();
+                this.failAll(new Error(`journal client: connect timed out after ${this.connectTimeoutMs}ms`));
+                reject(new Error(`journal client: connect timed out after ${this.connectTimeoutMs}ms`));
+            }, this.connectTimeoutMs);
+            const onError = (err) => {
+                clearTimeout(timer);
+                socket.removeAllListeners();
+                this.failAll(err);
+                reject(new Error(`journal client: connect failed: ${err.message}`));
+            };
+            socket.once('error', onError);
+            socket.once('connect', () => {
+                clearTimeout(timer);
+                socket.removeListener('error', onError);
+                socket.on('error', (err) => { this.disconnectCause ??= err; this.failAll(err); });
+                socket.on('data', (chunk) => this.onData(chunk));
+                socket.on('close', () => {
+                    const closed = new Error('journal client: connection closed');
+                    this.connectionClosed(closed, this.socket === socket);
+                    this.disconnectCause ??= closed;
+                    this.failAll(closed);
+                    // Only a drop the caller did not ask for; close() clears this.socket first.
+                    // Sessions with nothing pending (a registered watch) must hear it too.
+                    if (this.socket === socket)
+                        this.emit('disconnected', closed);
+                });
+                this.disconnectCause = undefined;
+                this.connectingSocket = undefined;
+                this.socket = socket;
+                resolve();
+            });
+        });
+    }
+    /**
+     * Close the connection and reject any pending requests. A `cause` (for
+     * example the worker failure that forced the close) is carried into every
+     * later "not connected" rejection.
+     */
+    close(cause) {
+        const closed = cause === undefined
+            ? new Error('journal client: closed by caller')
+            : new Error(`journal client: closed after ${cause instanceof Error ? cause.message : String(cause)}`, { cause });
+        this.connectionClosed(cause, false);
+        this.connectingSocket?.destroy(closed);
+        this.disconnectCause ??= closed;
+        this.failAll(closed);
+        this.socket?.destroy();
+        this.socket = null;
+        this.buffer = '';
+    }
+    onData(chunk) {
+        this.buffer += chunk.toString('utf8');
+        let nl;
+        while ((nl = this.buffer.indexOf('\n')) !== -1) {
+            const line = this.buffer.slice(0, nl);
+            this.buffer = this.buffer.slice(nl + 1);
+            if (line.length > 0)
+                this.onLine(line);
+        }
+    }
+    onLine(line) {
+        let msg;
+        try {
+            msg = JSON.parse(line);
+        }
+        catch {
+            // A malformed frame is a protocol violation; fail closed.
+            const error = new JournalFrameError();
+            this.failAll(error);
+            // Sessions with nothing pending (a registered watch) must hear it too.
+            this.emit('protocol_error', error);
+            return;
+        }
+        if (typeof msg.id === 'string' && 'ok' in msg) {
+            const res = msg;
+            const pending = this.pending.get(res.id);
+            if (!pending)
+                return; // reply for an already-timed-out request
+            this.pending.delete(res.id);
+            if (pending.timer !== undefined)
+                clearTimeout(pending.timer);
+            if (res.ok)
+                pending.resolve(res.result);
+            else
+                pending.reject(new JournalProtocolError(res.error.code, res.error.message));
+        }
+        else {
+            const ev = msg;
+            this.emit(ev.event, ev.data);
+            this.emit('event', ev);
+        }
+    }
+    failAll(err) {
+        for (const [, p] of this.pending) {
+            if (p.timer !== undefined)
+                clearTimeout(p.timer);
+            p.reject(err);
+        }
+        this.pending.clear();
+    }
+    /** @internal One unretried request on this session; flow reads go through `request`. */
+    requestOnce(verb, params, timeoutMs = this.requestTimeoutMs, signal) {
+        return new Promise((resolve, reject) => {
+            if (signal?.aborted) {
+                reject(signal.reason);
+                return;
+            }
+            if (!this.socket || this.socket.destroyed) {
+                const cause = this.disconnectCause;
+                reject(new Error(`journal client: not connected (${verb})${cause === undefined ? '' : `: ${cause.message}`}`, cause === undefined ? undefined : { cause }));
+                return;
+            }
+            const id = randomUUID();
+            const started = performance.now();
+            const frame = { id, verb: verb, params };
+            // Cancellation forgets the request; a late reply is ignored like a timed-out one.
+            const onAbort = () => {
+                const p = this.pending.get(id);
+                if (p === undefined)
+                    return;
+                if (p.timer !== undefined)
+                    clearTimeout(p.timer);
+                this.pending.delete(id);
+                p.reject(signal.reason);
+            };
+            const settle = (fn) => (arg) => {
+                signal?.removeEventListener('abort', onAbort);
+                fn(arg);
+            };
+            const timer = timeoutMs === null ? undefined : setTimeout(() => {
+                this.pending.delete(id);
+                settle(reject)(new JournalRequestTimeoutError(verb, timeoutMs, 1, performance.now() - started));
+            }, timeoutMs);
+            this.pending.set(id, { resolve: settle(resolve), reject: settle(reject), timer });
+            signal?.addEventListener('abort', onAbort, { once: true });
+            this.socket.write(JSON.stringify(frame) + '\n', (err) => {
+                if (err) {
+                    const p = this.pending.get(id);
+                    if (p) {
+                        if (p.timer !== undefined)
+                            clearTimeout(p.timer);
+                        this.pending.delete(id);
+                        p.reject(new Error(`journal client: ${verb} write failed: ${err.message}`));
+                    }
+                }
+            });
+        });
+    }
+}
+//# sourceMappingURL=journal-connection.js.map

package/dist/journal-connection.js.map

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

package/dist/journal-read-policy.d.ts

@@ -0,0 +1,38 @@
+export declare const READ_ONLY_VERBS: Set<string>;
+export declare const FLOW_READ_BUDGET_MS = 300000;
+export declare class JournalRequestTimeoutError extends Error {
+    readonly verb: string;
+    readonly timeoutMs: number;
+    readonly attempts: number;
+    readonly elapsedMs: number;
+    readonly readBudgetMs?: number | undefined;
+    constructor(verb: string, timeoutMs: number, attempts?: number, elapsedMs?: number, readBudgetMs?: number | undefined);
+}
+/**
+ * The dedicated read session lost its transport (closed, reset, not connected)
+ * while the primary session may still be healthy. Like a timeout, this says
+ * nothing about the run itself: retry within the budget, then leave the run
+ * resumable. Protocol refusals and write failures are never this error.
+ */
+export declare class JournalReadInterruptedError extends Error {
+    readonly verb: string;
+    readonly attempts: number;
+    readonly elapsedMs: number;
+    readonly readBudgetMs?: number | undefined;
+    constructor(verb: string, attempts?: number, elapsedMs?: number, readBudgetMs?: number | undefined, options?: ErrorOptions & {
+        retryable?: boolean;
+    });
+    /** False when the session it ran on is gone, so retrying it cannot help. */
+    readonly retryable: boolean;
+}
+/** A read that could not be answered — by timeout or lost read transport — not a run failure. */
+export declare function isReadInterruptionError(error: unknown): error is JournalRequestTimeoutError | JournalReadInterruptedError;
+/** Serial admission bounds read amplification, including retries, per body client. */
+export declare class JournalReadPolicy {
+    private tail;
+    private readonly closed;
+    constructor();
+    close(reason?: unknown): void;
+    read<T>(verb: string, timeoutMs: number, budgetMs: number, request: (timeoutMs: number, signal: AbortSignal) => Promise<T>, caller?: AbortSignal): Promise<T>;
+}
+//# sourceMappingURL=journal-read-policy.d.ts.map

package/dist/journal-read-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal-read-policy.d.ts","sourceRoot":"","sources":["../src/journal-read-policy.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,eAAe,aAA8E,CAAC;AAC3G,eAAO,MAAM,mBAAmB,SAAU,CAAC;AAE3C,qBAAa,0BAA2B,SAAQ,KAAK;IAEjD,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM;IAC1B,QAAQ,CAAC,QAAQ;IACjB,QAAQ,CAAC,SAAS;IAClB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM;gBAJrB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,QAAQ,SAAI,EACZ,SAAS,SAAY,EACrB,YAAY,CAAC,EAAE,MAAM,YAAA;CAOjC;AAED;;;;;GAKG;AACH,qBAAa,2BAA4B,SAAQ,KAAK;IAElD,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,QAAQ;IACjB,QAAQ,CAAC,SAAS;IAClB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM;gBAHrB,IAAI,EAAE,MAAM,EACZ,QAAQ,SAAI,EACZ,SAAS,SAAI,EACb,YAAY,CAAC,EAAE,MAAM,YAAA,EAC9B,OAAO,CAAC,EAAE,YAAY,GAAG;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE;IAWlD,4EAA4E;IAC5E,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED,iGAAiG;AACjG,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,0BAA0B,GAAG,2BAA2B,CAIzH;AAED,sFAAsF;AACtF,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,IAAI,CAAuC;IACnD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;;IAOhD,KAAK,CAAC,MAAM,GAAE,OAAuD,GAAG,IAAI;IAEtE,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAC7D,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;CAsDrG"}