tywrap 0.7.0 → 0.9.0

package/dist/runtime/frame-codec.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Pure frame codec + reassembler for the `tywrap-frame/1` framing protocol.
+ *
+ * This module is the transport-agnostic core of large-payload chunking: it
+ * fragments one complete logical JSON message into {@link ChunkFrame}s and
+ * reassembles a stream of frames back into the original string. It performs NO
+ * I/O and knows nothing about subprocesses, stdin/stdout, or timeouts — the
+ * transport layer (W4/W5) wires these functions into the read/write loop.
+ *
+ * Encoding is `utf8-slice` (plan decision #6, docs/transport-framing.md): the
+ * logical payload is already valid-UTF-8 JSON, so each frame's `data` is a raw
+ * substring split on a UTF-8 codepoint boundary at or before `maxFrameBytes`
+ * UTF-8 bytes. Reassembly is plain concatenation — no base64, no ~33% inflation,
+ * no extra decode pass. A frame's `data` MUST NOT split a multi-byte UTF-8
+ * sequence; {@link encodeFrames} guarantees this by snapping every boundary back
+ * to the nearest codepoint boundary.
+ *
+ * The mirror implementation lives in `runtime/frame_codec.py`; the two MUST
+ * agree byte-for-byte on the wire (see test/frame-codec.test.ts and
+ * test/python/test_frame_codec.py for the cross-language parity vectors).
+ *
+ * @see docs/transport-framing.md
+ */
+import { type ChunkFrame } from './transport.js';
+/** Which logical stream a set of frames belongs to. */
+export type FrameStream = ChunkFrame['stream'];
+/** Options for {@link encodeFrames}. */
+export interface EncodeFramesOptions {
+    /** RPC correlation id, shared with the logical {@link ProtocolMessage.id}. */
+    readonly id: number;
+    /** Which logical stream these frames belong to (`request` or `response`). */
+    readonly stream: FrameStream;
+    /**
+     * Maximum UTF-8 byte length of a single frame's `data` field. Each frame's
+     * `data` is guaranteed to be at most this many UTF-8 bytes, snapped back to a
+     * codepoint boundary so no multi-byte sequence is split. Must be a positive
+     * integer large enough to hold at least one codepoint (>= 4 bytes).
+     */
+    readonly maxFrameBytes: number;
+}
+/** Exact UTF-8 byte length of a JS string (no allocation of the encoded bytes). */
+export declare function utf8ByteLength(value: string): number;
+/**
+ * Fragment a complete logical JSON message into `tywrap-frame/1` frames.
+ *
+ * Splits `logicalJson` on UTF-8 codepoint boundaries so each frame's `data` is
+ * at most `maxFrameBytes` UTF-8 bytes and never splits a multi-byte sequence.
+ * `totalBytes` is the exact UTF-8 byte length of the full message; `total` is
+ * the resulting frame count; `seq` is zero-based and dense.
+ *
+ * An empty `logicalJson` still produces exactly one (empty) frame so the
+ * receiver always sees `total >= 1` and a well-formed stream.
+ *
+ * @throws BridgeProtocolError if `maxFrameBytes` is not a positive integer of at
+ *   least 4 bytes (the worst-case single-codepoint size).
+ */
+export declare function encodeFrames(logicalJson: string, opts: EncodeFramesOptions): ChunkFrame[];
+/**
+ * Validates that a raw value is a structurally well-formed `tywrap-frame/1` data
+ * frame. Returns the frame typed, or throws a {@link BridgeProtocolError}.
+ *
+ * Only `__tywrap_frame__: 'chunk'` frames flow through reassembly; `'error'`
+ * frames are a transport-layer concern handled above this module.
+ */
+export declare function parseChunkFrame(value: unknown): ChunkFrame;
+export declare class Reassembler {
+    private readonly streams;
+    private readonly discarded;
+    private readonly maxReassemblyBytes;
+    private readonly expectedStream;
+    /**
+     * @param options.maxReassemblyBytes Reject (fail loud) any stream whose
+     *   declared OR accumulated payload exceeds this many UTF-8 bytes, so a huge
+     *   response cannot be buffered into memory before a higher layer's size cap
+     *   would reject it anyway. Default: no limit (`Infinity`).
+     * @param options.expectedStream If set, every frame must carry this `stream`
+     *   direction; a frame for the other direction is rejected. The response and
+     *   request reassemblers are distinct instances, so this is defense-in-depth.
+     */
+    constructor(options?: {
+        maxReassemblyBytes?: number;
+        expectedStream?: FrameStream;
+    });
+    /**
+     * Feed one frame. Returns the fully reassembled logical string when this
+     * frame completes the stream for its id, `null` if more frames are still
+     * needed (or the frame was dropped because its id is timed out).
+     *
+     * @throws BridgeProtocolError on any framing violation (malformed frame,
+     *   wrong stream direction, declared/accumulated payload over the cap,
+     *   duplicate `seq`, inconsistent `total`/`totalBytes`, byte-count mismatch,
+     *   invalid UTF-8, or unknown `frameProtocol`).
+     */
+    accept(rawFrame: unknown): string | null;
+    /**
+     * Mark an id as timed out / aborted. Any partial state is dropped immediately
+     * and every subsequent frame for this id is discarded until its declared
+     * final frame arrives. Idempotent.
+     */
+    discard(id: number): void;
+    /** Whether any frame for `id` is still being accumulated (not yet complete). */
+    isPending(id: number): boolean;
+    /** Number of ids currently mid-reassembly (for diagnostics/tests). */
+    get pendingCount(): number;
+    /**
+     * Number of timed-out ids whose late frames are still being dropped
+     * (FIFO-bounded by `MAX_DISCARDED_IDS`; for diagnostics/tests).
+     */
+    get discardedCount(): number;
+}
+//# sourceMappingURL=frame-codec.d.ts.map

package/dist/runtime/frame-codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-codec.d.ts","sourceRoot":"","sources":["../../src/runtime/frame-codec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EAAqB,KAAK,UAAU,EAA2B,MAAM,gBAAgB,CAAC;AAM7F,uDAAuD;AACvD,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;AAE/C,wCAAwC;AACxC,MAAM,WAAW,mBAAmB;IAClC,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAE7B;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAuBD,mFAAmF;AACnF,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMpD;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,GAAG,UAAU,EAAE,CA0DzF;AAgBD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAoE1D;AAkCD,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAC1D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA0B;IAEzD;;;;;;;;OAQG;gBACS,OAAO,GAAE;QAAE,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,WAAW,CAAA;KAAO;IAKvF;;;;;;;;;OASG;IACH,MAAM,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI;IAwHxC;;;;OAIG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAczB,gFAAgF;IAChF,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI9B,sEAAsE;IACtE,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;;OAGG;IACH,IAAI,cAAc,IAAI,MAAM,CAE3B;CACF"}

package/dist/runtime/frame-codec.js

@@ -0,0 +1,352 @@
+/**
+ * Pure frame codec + reassembler for the `tywrap-frame/1` framing protocol.
+ *
+ * This module is the transport-agnostic core of large-payload chunking: it
+ * fragments one complete logical JSON message into {@link ChunkFrame}s and
+ * reassembles a stream of frames back into the original string. It performs NO
+ * I/O and knows nothing about subprocesses, stdin/stdout, or timeouts — the
+ * transport layer (W4/W5) wires these functions into the read/write loop.
+ *
+ * Encoding is `utf8-slice` (plan decision #6, docs/transport-framing.md): the
+ * logical payload is already valid-UTF-8 JSON, so each frame's `data` is a raw
+ * substring split on a UTF-8 codepoint boundary at or before `maxFrameBytes`
+ * UTF-8 bytes. Reassembly is plain concatenation — no base64, no ~33% inflation,
+ * no extra decode pass. A frame's `data` MUST NOT split a multi-byte UTF-8
+ * sequence; {@link encodeFrames} guarantees this by snapping every boundary back
+ * to the nearest codepoint boundary.
+ *
+ * The mirror implementation lives in `runtime/frame_codec.py`; the two MUST
+ * agree byte-for-byte on the wire (see test/frame-codec.test.ts and
+ * test/python/test_frame_codec.py for the cross-language parity vectors).
+ *
+ * @see docs/transport-framing.md
+ */
+import { BridgeProtocolError } from './errors.js';
+import { FRAME_PROTOCOL_ID } from './transport.js';
+// =============================================================================
+// UTF-8 HELPERS (pure, codepoint-boundary aware)
+// =============================================================================
+const utf8Encoder = new TextEncoder();
+const utf8Decoder = new TextDecoder('utf-8', { fatal: true });
+/** UTF-8 byte length of a single Unicode codepoint. */
+function utf8ByteLengthOfCodePoint(codePoint) {
+    if (codePoint <= 0x7f) {
+        return 1;
+    }
+    if (codePoint <= 0x7ff) {
+        return 2;
+    }
+    if (codePoint <= 0xffff) {
+        return 3;
+    }
+    return 4;
+}
+/** Exact UTF-8 byte length of a JS string (no allocation of the encoded bytes). */
+export function utf8ByteLength(value) {
+    let bytes = 0;
+    for (const ch of value) {
+        bytes += utf8ByteLengthOfCodePoint(ch.codePointAt(0) ?? 0);
+    }
+    return bytes;
+}
+// =============================================================================
+// ENCODE
+// =============================================================================
+/**
+ * Fragment a complete logical JSON message into `tywrap-frame/1` frames.
+ *
+ * Splits `logicalJson` on UTF-8 codepoint boundaries so each frame's `data` is
+ * at most `maxFrameBytes` UTF-8 bytes and never splits a multi-byte sequence.
+ * `totalBytes` is the exact UTF-8 byte length of the full message; `total` is
+ * the resulting frame count; `seq` is zero-based and dense.
+ *
+ * An empty `logicalJson` still produces exactly one (empty) frame so the
+ * receiver always sees `total >= 1` and a well-formed stream.
+ *
+ * @throws BridgeProtocolError if `maxFrameBytes` is not a positive integer of at
+ *   least 4 bytes (the worst-case single-codepoint size).
+ */
+export function encodeFrames(logicalJson, opts) {
+    const { id, stream, maxFrameBytes } = opts;
+    if (!Number.isInteger(maxFrameBytes) || maxFrameBytes < 4) {
+        throw new BridgeProtocolError(`encodeFrames: maxFrameBytes must be an integer >= 4 (got ${String(maxFrameBytes)})`, { code: 'FRAME_BAD_MAX_BYTES' });
+    }
+    // Validate the protocol fields locally too (parseChunkFrame enforces them on
+    // the decode side, but catching misuse at the encoder fails fast and keeps the
+    // two sides symmetric with the Python encoder).
+    if (stream !== 'request' && stream !== 'response') {
+        throw new BridgeProtocolError(`encodeFrames: stream must be 'request' or 'response' (got ${String(stream)})`, { code: 'FRAME_BAD_STREAM' });
+    }
+    if (!Number.isInteger(id)) {
+        throw new BridgeProtocolError(`encodeFrames: id must be an integer (got ${String(id)})`, {
+            code: 'FRAME_BAD_ID',
+        });
+    }
+    const totalBytes = utf8ByteLength(logicalJson);
+    const encoding = 'utf8-slice';
+    // Walk codepoints, accumulating UTF-8 bytes into the current slice until the
+    // next codepoint would exceed maxFrameBytes; that boundary is, by
+    // construction, a codepoint boundary so no multi-byte sequence is split.
+    const slices = [];
+    let current = '';
+    let currentBytes = 0;
+    for (const ch of logicalJson) {
+        const chBytes = utf8ByteLengthOfCodePoint(ch.codePointAt(0) ?? 0);
+        if (currentBytes + chBytes > maxFrameBytes && current.length > 0) {
+            slices.push(current);
+            current = '';
+            currentBytes = 0;
+        }
+        current += ch;
+        currentBytes += chBytes;
+    }
+    // Always emit a final slice (covers the empty-string case: one empty frame).
+    slices.push(current);
+    const total = slices.length;
+    return slices.map((data, seq) => ({
+        __tywrap_frame__: 'chunk',
+        frameProtocol: FRAME_PROTOCOL_ID,
+        stream,
+        id,
+        seq,
+        total,
+        totalBytes,
+        encoding,
+        data,
+    }));
+}
+/**
+ * Validates that a raw value is a structurally well-formed `tywrap-frame/1` data
+ * frame. Returns the frame typed, or throws a {@link BridgeProtocolError}.
+ *
+ * Only `__tywrap_frame__: 'chunk'` frames flow through reassembly; `'error'`
+ * frames are a transport-layer concern handled above this module.
+ */
+export function parseChunkFrame(value) {
+    if (value === null || typeof value !== 'object') {
+        throw new BridgeProtocolError('frame: expected an object', {
+            code: 'FRAME_MALFORMED',
+        });
+    }
+    const f = value;
+    if (f.__tywrap_frame__ !== 'chunk') {
+        throw new BridgeProtocolError(`frame: __tywrap_frame__ must be "chunk" (got ${JSON.stringify(f.__tywrap_frame__)})`, { code: 'FRAME_MALFORMED' });
+    }
+    if (f.frameProtocol !== FRAME_PROTOCOL_ID) {
+        throw new BridgeProtocolError(`frame: unknown frameProtocol ${JSON.stringify(f.frameProtocol)} (expected ${FRAME_PROTOCOL_ID})`, { code: 'FRAME_UNKNOWN_PROTOCOL' });
+    }
+    if (f.stream !== 'request' && f.stream !== 'response') {
+        throw new BridgeProtocolError(`frame: stream must be "request" or "response" (got ${JSON.stringify(f.stream)})`, { code: 'FRAME_MALFORMED' });
+    }
+    if (f.encoding !== 'utf8-slice') {
+        // utf8-base64 is reserved in the schema but never emitted/accepted in 0.8.0.
+        throw new BridgeProtocolError(`frame: unsupported encoding ${JSON.stringify(f.encoding)} (only "utf8-slice" in 0.8.0)`, { code: 'FRAME_MALFORMED' });
+    }
+    if (!Number.isInteger(f.id)) {
+        throw new BridgeProtocolError(`frame: id must be an integer (got ${JSON.stringify(f.id)})`, {
+            code: 'FRAME_MALFORMED',
+        });
+    }
+    if (!Number.isInteger(f.seq) || f.seq < 0) {
+        throw new BridgeProtocolError(`frame: seq must be a non-negative integer (got ${JSON.stringify(f.seq)})`, { code: 'FRAME_MALFORMED' });
+    }
+    if (!Number.isInteger(f.total) || f.total < 1) {
+        throw new BridgeProtocolError(`frame: total must be an integer >= 1 (got ${JSON.stringify(f.total)})`, { code: 'FRAME_MALFORMED' });
+    }
+    if (!Number.isInteger(f.totalBytes) || f.totalBytes < 0) {
+        throw new BridgeProtocolError(`frame: totalBytes must be a non-negative integer (got ${JSON.stringify(f.totalBytes)})`, { code: 'FRAME_MALFORMED' });
+    }
+    if (typeof f.data !== 'string') {
+        throw new BridgeProtocolError(`frame: data must be a string (got ${typeof f.data})`, {
+            code: 'FRAME_MALFORMED',
+        });
+    }
+    if (f.seq >= f.total) {
+        throw new BridgeProtocolError(`frame: seq ${String(f.seq)} out of range for total ${String(f.total)}`, { code: 'FRAME_MALFORMED' });
+    }
+    return f;
+}
+/**
+ * Accumulates `tywrap-frame/1` frames by `id` and reconstructs the logical JSON
+ * string once a stream is complete.
+ *
+ * A single instance handles many concurrent ids (each correlated by
+ * {@link ChunkFrame.id}). Validation is enforced on every {@link accept} so a
+ * malformed/duplicate/inconsistent frame fails fast rather than corrupting an
+ * in-flight reassembly:
+ *
+ * - matching {@link FRAME_PROTOCOL_ID} on every frame;
+ * - consistent `total` / `totalBytes` across all frames of an id;
+ * - no duplicate `seq`;
+ * - on completion, exactly `total` frames covering `[0, total)`;
+ * - the concatenated payload's UTF-8 byte length equals `totalBytes` exactly;
+ * - the concatenated payload decodes as strict UTF-8.
+ *
+ * Timed-out ids: the transport marks an id timed out via {@link discard}. Every
+ * subsequent frame for that id is dropped (returning `null`) until its final
+ * frame arrives, at which point the id is forgotten so the slot can be reused.
+ * This prevents late multi-frame responses from desyncing the stream.
+ */
+/**
+ * Defensive bounds on per-id reassembly state. The peer is the local Python
+ * bridge, but a buggy or corrupt bridge must not grow memory without limit:
+ * cap how many distinct ids may be mid-reassembly at once (fail loud past the
+ * cap), and FIFO-bound the timed-out-id discard set so a long-lived process
+ * that times out many chunked requests whose final frames never arrive (e.g.
+ * the bridge died mid-stream) does not leak markers forever.
+ */
+const MAX_CONCURRENT_STREAMS = 1024;
+const MAX_DISCARDED_IDS = 4096;
+export class Reassembler {
+    streams = new Map();
+    discarded = new Set();
+    maxReassemblyBytes;
+    expectedStream;
+    /**
+     * @param options.maxReassemblyBytes Reject (fail loud) any stream whose
+     *   declared OR accumulated payload exceeds this many UTF-8 bytes, so a huge
+     *   response cannot be buffered into memory before a higher layer's size cap
+     *   would reject it anyway. Default: no limit (`Infinity`).
+     * @param options.expectedStream If set, every frame must carry this `stream`
+     *   direction; a frame for the other direction is rejected. The response and
+     *   request reassemblers are distinct instances, so this is defense-in-depth.
+     */
+    constructor(options = {}) {
+        this.maxReassemblyBytes = options.maxReassemblyBytes ?? Number.POSITIVE_INFINITY;
+        this.expectedStream = options.expectedStream;
+    }
+    /**
+     * Feed one frame. Returns the fully reassembled logical string when this
+     * frame completes the stream for its id, `null` if more frames are still
+     * needed (or the frame was dropped because its id is timed out).
+     *
+     * @throws BridgeProtocolError on any framing violation (malformed frame,
+     *   wrong stream direction, declared/accumulated payload over the cap,
+     *   duplicate `seq`, inconsistent `total`/`totalBytes`, byte-count mismatch,
+     *   invalid UTF-8, or unknown `frameProtocol`).
+     */
+    accept(rawFrame) {
+        const frame = parseChunkFrame(rawFrame);
+        const { id, seq, total, totalBytes, data, stream } = frame;
+        if (this.expectedStream !== undefined && stream !== this.expectedStream) {
+            throw new BridgeProtocolError(`frame: unexpected stream '${stream}' for id ${id} (this reassembler handles '${this.expectedStream}')`, { code: 'FRAME_WRONG_STREAM' });
+        }
+        // Late-frame discard: drop frames for a timed-out id; forget the id once its
+        // declared final frame has been seen so the stream stays aligned and the id
+        // can be reused.
+        if (this.discarded.has(id)) {
+            if (seq === total - 1) {
+                this.discarded.delete(id);
+            }
+            return null;
+        }
+        let state = this.streams.get(id);
+        if (state === undefined) {
+            if (this.streams.size >= MAX_CONCURRENT_STREAMS) {
+                throw new BridgeProtocolError(`frame: too many concurrent reassembly streams (>= ${MAX_CONCURRENT_STREAMS}); refusing to buffer id ${id}`, { code: 'FRAME_TOO_MANY_STREAMS' });
+            }
+            // Reject early: a declared payload past the cap can never be accepted by
+            // the higher-layer size guard, so refuse to buffer it instead of OOMing.
+            if (totalBytes > this.maxReassemblyBytes) {
+                throw new BridgeProtocolError(`frame: declared payload ${totalBytes} bytes exceeds max reassembly ${this.maxReassemblyBytes} bytes for id ${id}`, { code: 'FRAME_PAYLOAD_TOO_LARGE' });
+            }
+            state = { total, totalBytes, bytesSoFar: 0, slices: new Map() };
+            this.streams.set(id, state);
+        }
+        else {
+            if (state.total !== total) {
+                this.streams.delete(id);
+                throw new BridgeProtocolError(`frame: total mismatch for id ${id} (saw ${state.total}, frame says ${total})`, { code: 'FRAME_INCONSISTENT' });
+            }
+            if (state.totalBytes !== totalBytes) {
+                this.streams.delete(id);
+                throw new BridgeProtocolError(`frame: totalBytes mismatch for id ${id} (saw ${state.totalBytes}, frame says ${totalBytes})`, { code: 'FRAME_INCONSISTENT' });
+            }
+        }
+        if (state.slices.has(seq)) {
+            this.streams.delete(id);
+            throw new BridgeProtocolError(`frame: duplicate seq ${seq} for id ${id}`, {
+                code: 'FRAME_DUPLICATE_SEQ',
+            });
+        }
+        state.slices.set(seq, data);
+        // Running memory bound: a peer that under-declares totalBytes then overshoots
+        // is caught here (and the exact-count check at completion catches the rest)
+        // before the full payload is buffered.
+        state.bytesSoFar += utf8ByteLength(data);
+        if (state.bytesSoFar > this.maxReassemblyBytes) {
+            this.streams.delete(id);
+            throw new BridgeProtocolError(`frame: accumulated payload exceeds max reassembly ${this.maxReassemblyBytes} bytes for id ${id}`, { code: 'FRAME_PAYLOAD_TOO_LARGE' });
+        }
+        if (state.slices.size < total) {
+            return null;
+        }
+        // All `total` frames present; the dense [0, total) range is guaranteed
+        // because each seq is in range, unique, and there are exactly `total` of
+        // them. Concatenate in seq order.
+        this.streams.delete(id);
+        let payload = '';
+        for (let i = 0; i < total; i += 1) {
+            const slice = state.slices.get(i);
+            if (slice === undefined) {
+                // Unreachable given the count + uniqueness + range invariants above,
+                // but kept explicit rather than a silent gap.
+                throw new BridgeProtocolError(`frame: missing seq ${i} for id ${id}`, {
+                    code: 'FRAME_SEQ_GAP',
+                });
+            }
+            payload += slice;
+        }
+        const actualBytes = utf8ByteLength(payload);
+        if (actualBytes !== totalBytes) {
+            throw new BridgeProtocolError(`frame: reassembled byte length ${actualBytes} != declared totalBytes ${totalBytes} for id ${id}`, { code: 'FRAME_BYTES_MISMATCH' });
+        }
+        // Strict UTF-8 validation: re-encode then decode in fatal mode. With
+        // utf8-slice the concatenation cannot introduce invalid sequences (each
+        // slice is whole codepoints), but the spec requires the check explicitly.
+        try {
+            utf8Decoder.decode(utf8Encoder.encode(payload));
+        }
+        catch (cause) {
+            throw new BridgeProtocolError(`frame: reassembled payload is not valid UTF-8 for id ${id}`, {
+                code: 'FRAME_INVALID_UTF8',
+                cause,
+            });
+        }
+        return payload;
+    }
+    /**
+     * Mark an id as timed out / aborted. Any partial state is dropped immediately
+     * and every subsequent frame for this id is discarded until its declared
+     * final frame arrives. Idempotent.
+     */
+    discard(id) {
+        this.streams.delete(id);
+        this.discarded.add(id);
+        // Bound the discard set (FIFO): a timed-out id whose declared final frame
+        // never arrives would otherwise linger forever. Set iteration order is
+        // insertion order, so the first key is the oldest marker.
+        if (this.discarded.size > MAX_DISCARDED_IDS) {
+            const oldest = this.discarded.values().next().value;
+            if (oldest !== undefined) {
+                this.discarded.delete(oldest);
+            }
+        }
+    }
+    /** Whether any frame for `id` is still being accumulated (not yet complete). */
+    isPending(id) {
+        return this.streams.has(id);
+    }
+    /** Number of ids currently mid-reassembly (for diagnostics/tests). */
+    get pendingCount() {
+        return this.streams.size;
+    }
+    /**
+     * Number of timed-out ids whose late frames are still being dropped
+     * (FIFO-bounded by `MAX_DISCARDED_IDS`; for diagnostics/tests).
+     */
+    get discardedCount() {
+        return this.discarded.size;
+    }
+}
+//# sourceMappingURL=frame-codec.js.map

package/dist/runtime/frame-codec.js.map

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

package/dist/runtime/http-transport.d.ts

@@ -92,7 +92,7 @@ export declare class HttpTransport implements Transport {
      * @throws BridgeExecutionError if the server returns a non-2xx status
      * @throws BridgeProtocolError if the response cannot be read
      */
-    send(message: string, timeoutMs: number, signal?: AbortSignal): Promise<string>;
+    send(message: string, timeoutMs: number, signal?: AbortSignal, _requestId?: number): Promise<string>;
     /**
      * Safely read response body as text, returning empty string on failure.
      */

package/dist/runtime/http-transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http-transport.d.ts","sourceRoot":"","sources":["../../src/runtime/http-transport.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,OAAO,KAAK,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAMvE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAEhB,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC,mEAAmE;IACnE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,aAAc,YAAW,SAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,WAAW,CAAS;gBAEhB,OAAO,EAAE,oBAAoB;IAczC;;;;;OAKG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B;;;;OAIG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;;;;;;;OAQG;IACH,YAAY,IAAI,qBAAqB;IAerC;;;;;;;;;;;;OAYG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAwGrF;;OAEG;YACW,YAAY;CAO3B"}
+{"version":3,"file":"http-transport.d.ts","sourceRoot":"","sources":["../../src/runtime/http-transport.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,OAAO,KAAK,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAMvE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAEhB,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC,mEAAmE;IACnE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,aAAc,YAAW,SAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,WAAW,CAAS;gBAEhB,OAAO,EAAE,oBAAoB;IAczC;;;;;OAKG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B;;;;OAIG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;;;;;;;OAQG;IACH,YAAY,IAAI,qBAAqB;IAerC;;;;;;;;;;;;OAYG;IACG,IAAI,CACR,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,WAAW,EACpB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC;IAwGlB;;OAEG;YACW,YAAY;CAO3B"}

package/dist/runtime/http-transport.js

@@ -113,7 +113,7 @@ export class HttpTransport {
      * @throws BridgeExecutionError if the server returns a non-2xx status
      * @throws BridgeProtocolError if the response cannot be read
      */
-    async send(message, timeoutMs, signal) {
+    async send(message, timeoutMs, signal, _requestId) {
         if (this._isDisposed) {
             throw new BridgeDisposedError('Transport has been disposed');
         }

package/dist/runtime/http-transport.js.map

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

package/dist/runtime/index.d.ts

@@ -8,8 +8,9 @@
  */
 import type { RuntimeExecution } from '../types/index.js';
 export { BridgeCodec, type CodecOptions } from './bridge-codec.js';
+export { createReturnValidator, describeReceivedShape, type ReturnSchema, type ReturnValidator, } from './validators.js';
 export type { Transport, TransportCapabilities, TransportOptions, ProtocolMessage, ProtocolResponse, } from './transport.js';
-export { PROTOCOL_ID, isTransport, isProtocolMessage, isProtocolResponse, } from './transport.js';
+export { PROTOCOL_ID, isTransport, isProtocolMessage, isProtocolResponse } from './transport.js';
 export declare function setRuntimeBridge(bridge: RuntimeExecution): void;
 export declare function getRuntimeBridge(): RuntimeExecution;
 export declare function clearRuntimeBridge(): void;

package/dist/runtime/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAG1D,OAAO,EAAE,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGnE,YAAY,EACV,SAAS,EACT,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAIxB,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAE/D;AAED,wBAAgB,gBAAgB,IAAI,gBAAgB,CAOnD;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAG1D,OAAO,EAAE,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,KAAK,YAAY,EACjB,KAAK,eAAe,GACrB,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EACV,SAAS,EACT,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAIjG,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAE/D;AAED,wBAAgB,gBAAgB,IAAI,gBAAgB,CAOnD;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}

package/dist/runtime/index.js

@@ -8,7 +8,8 @@
  */
 // BridgeCodec — validation and serialization for the JS<->Python boundary
 export { BridgeCodec } from './bridge-codec.js';
-export { PROTOCOL_ID, isTransport, isProtocolMessage, isProtocolResponse, } from './transport.js';
+export { createReturnValidator, describeReceivedShape, } from './validators.js';
+export { PROTOCOL_ID, isTransport, isProtocolMessage, isProtocolResponse } from './transport.js';
 let runtimeBridge = null;
 export function setRuntimeBridge(bridge) {
     runtimeBridge = bridge;

package/dist/runtime/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,0EAA0E;AAC1E,OAAO,EAAE,WAAW,EAAqB,MAAM,mBAAmB,CAAC;AAUnE,OAAO,EACL,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAExB,IAAI,aAAa,GAA4B,IAAI,CAAC;AAElD,MAAM,UAAU,gBAAgB,CAAC,MAAwB;IACvD,aAAa,GAAG,MAAM,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CACb,sJAAsJ,CACvJ,CAAC;IACJ,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,aAAa,GAAG,IAAI,CAAC;AACvB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,0EAA0E;AAC1E,OAAO,EAAE,WAAW,EAAqB,MAAM,mBAAmB,CAAC;AACnE,OAAO,EACL,qBAAqB,EACrB,qBAAqB,GAGtB,MAAM,iBAAiB,CAAC;AAUzB,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEjG,IAAI,aAAa,GAA4B,IAAI,CAAC;AAElD,MAAM,UAAU,gBAAgB,CAAC,MAAwB;IACvD,aAAa,GAAG,MAAM,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CACb,sJAAsJ,CACvJ,CAAC;IACJ,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,aAAa,GAAG,IAAI,CAAC;AACvB,CAAC"}

package/dist/runtime/node.d.ts

@@ -18,7 +18,12 @@ export interface NodeBridgeOptions {
     minProcesses?: number;
     /** Maximum number of Python processes to spawn. Default: 1 (single-process mode) */
     maxProcesses?: number;
-    /** Maximum concurrent requests per process. Default: 10 */
+    /**
+     * Maximum concurrent requests per process. Default: 1.
+     *
+     * Python bridge workers process JSONL requests serially, so the default lets
+     * the pool use another process for concurrent calls when one is available.
+     */
     maxConcurrentPerProcess?: number;
     /** Path to Python executable. Auto-detected if not specified. */
     pythonPath?: string;
@@ -34,8 +39,6 @@ export interface NodeBridgeOptions {
     queueTimeoutMs?: number;
     /** Inherit all environment variables from parent process. Default: false */
     inheritProcessEnv?: boolean;
-    /** Enable result caching for pure functions. Default: false */
-    enableCache?: boolean;
     /** Optional extra environment variables to pass to the Python subprocess. */
     env?: Record<string, string | undefined>;
     /** Codec options for validation/serialization */
@@ -77,7 +80,6 @@ export interface NodeBridgeOptions {
  * - Virtual environment support
  * - Full BridgeCodec validation (NaN/Infinity rejection, key validation)
  * - Automatic Arrow decoding for DataFrames/ndarrays
- * - Optional result caching for pure functions
  * - Process warmup commands
  *
  * @example
@@ -98,7 +100,6 @@ export interface NodeBridgeOptions {
  * const pooledBridge = new NodeBridge({
  *   maxProcesses: 4,
  *   maxConcurrentPerProcess: 2,
- *   enableCache: true,
  * });
  * await pooledBridge.init();
  * ```
@@ -128,18 +129,9 @@ export declare class NodeBridge extends BasePythonBridge {
     protected doDispose(): Promise<void>;
     /**
      * Expose the held RpcClient to BasePythonBridge's shared delegating methods
-     * (instantiate/callMethod/disposeInstance/getBridgeInfo). call() is
-     * overridden below to layer caching on top.
+     * (call/getBridgeInfo).
      */
     protected getRpcClient(): RpcClient;
-    /**
-     * Call a Python function, with optional result caching.
-     *
-     * Overrides BasePythonBridge.call() to layer the cache lookup/writeback on
-     * top of the shared delegation. Cache lookup stays FIRST so cache hits return
-     * without forcing init, preserving the pre-composition behavior.
-     */
-    call<T = unknown>(module: string, functionName: string, args: unknown[], kwargs?: Record<string, unknown>): Promise<T>;
     /**
      * Get current pool statistics.
      */
@@ -168,13 +160,5 @@ export declare class NodeBridge extends BasePythonBridge {
         poolSize: number;
         busyWorkers: number;
     };
-    /**
-     * Generate a cache key, returning null if generation fails.
-     */
-    private safeCacheKey;
-    /**
-     * Heuristic to determine if function result should be cached.
-     */
-    private isPureFunctionCandidate;
 }
 //# sourceMappingURL=node.d.ts.map