@vibesdotdev/external 0.0.0-stage → 1.0.0-rc.0

package/dist/jsonrpc/envelope.js

@@ -0,0 +1,46 @@
+/**
+ * Classify one line of child output as a JSON-RPC message.
+ *
+ * Hostile output is a value, never a throw: a line that is not JSON, not an
+ * object, not a recognizable envelope, or carries a bounded-field violation
+ * (an oversized id, a non-string method) is `invalid`, with a bounded excerpt of
+ * it for the log (never a message).
+ */
+import { attempt } from "./outcome.js";
+import { boundedExcerpt } from "./errors.js";
+import { JsonRpcEnvelopeSchema } from "./schemas.js";
+function invalid(line) {
+    return { kind: 'invalid', excerpt: boundedExcerpt(line) };
+}
+/** Decode and classify one line. Never throws: a hostile line is `invalid`. */
+export function classifyLine(line) {
+    const parsed = attempt(() => JSON.parse(line));
+    if (parsed.failed)
+        return invalid(line);
+    const raw = parsed.value;
+    const envelope = attempt(() => JsonRpcEnvelopeSchema.safeParse(raw));
+    if (envelope.failed || !envelope.value.success)
+        return invalid(line);
+    const message = envelope.value.data;
+    // Presence, not value: `"result": null` is an answer. The schema accepted `raw` as an object, so own-key reads are defined.
+    const hasResult = Object.hasOwn(raw, 'result');
+    const hasError = message.error !== undefined;
+    if (message.method === undefined) {
+        if (message.id === undefined || hasResult === hasError)
+            return invalid(line);
+        return {
+            kind: 'response',
+            id: message.id,
+            result: message.result,
+            error: message.error
+        };
+    }
+    if (hasResult || hasError)
+        return invalid(line);
+    if (message.id === undefined)
+        return { kind: 'notification', method: message.method, params: message.params };
+    if (message.id === null)
+        return invalid(line);
+    return { kind: 'request', id: message.id, method: message.method, params: message.params };
+}
+//# sourceMappingURL=envelope.js.map

package/dist/jsonrpc/envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.js","sourceRoot":"","sources":["../../src/jsonrpc/envelope.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAkB,MAAM,cAAc,CAAC;AAerE,SAAS,OAAO,CAAC,IAAY;IAC5B,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;AAC3D,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,YAAY,CAAC,IAAY;IACxC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/C,IAAI,MAAM,CAAC,MAAM;QAAE,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC;IACzB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,qBAAqB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IACrE,IAAI,QAAQ,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO;QAAE,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;IACpC,4HAA4H;IAC5H,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC;IAC7C,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAClC,IAAI,OAAO,CAAC,EAAE,KAAK,SAAS,IAAI,SAAS,KAAK,QAAQ;YAAE,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7E,OAAO;YACN,IAAI,EAAE,UAAU;YAChB,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,KAAK,EAAE,OAAO,CAAC,KAAK;SACpB,CAAC;IACH,CAAC;IACD,IAAI,SAAS,IAAI,QAAQ;QAAE,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,OAAO,CAAC,EAAE,KAAK,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;IAC9G,IAAI,OAAO,CAAC,EAAE,KAAK,IAAI;QAAE,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;AAC5F,CAAC"}

package/dist/jsonrpc/errors.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Typed failures of the JSON-RPC child client.
+ *
+ * Child-supplied text (a JSON-RPC `error.message`, an unparseable line, stderr)
+ * never enters a thrown message: every message is fixed per reason. The child's
+ * numeric code and a bounded, control-character-stripped excerpt ride only in
+ * `details`, so the logger that prints them decides whether to.
+ */
+import { CapabilityError, type CapabilityErrorDetails, type CaughtFailure } from '@vibesdotdev/kernel';
+/** The reasons this client fails with; each has one fixed message and one code. */
+export declare const JSONRPC_REASONS: readonly ["jsonrpc-error", "jsonrpc-protocol-invalid", "jsonrpc-child-exited", "jsonrpc-line-too-large", "jsonrpc-timeout", "jsonrpc-closed", "jsonrpc-cancelled", "jsonrpc-notification-overflow", "jsonrpc-kill-failed", "jsonrpc-hook-failed", "jsonrpc-invalid-options"];
+export type JsonRpcReason = (typeof JSONRPC_REASONS)[number];
+/** The longest excerpt of child text a failure carries in `details.excerpt`, in characters. */
+export declare const MAX_EXCERPT_CHARS = 200;
+/**
+ * Child text reduced to what a log line can safely carry: at most
+ * {@link MAX_EXCERPT_CHARS} characters, with control, format (bidi, zero-width),
+ * line- and paragraph-separator and unpaired-surrogate characters removed, and
+ * every credential-shaped token removed (the platform's one redaction,
+ * `@vibesdotdev/shared/utils`: a child echoes the keys and tokens it was given).
+ */
+export declare function boundedExcerpt(text: string): string;
+/** A typed failure with its reason's fixed message; `details` and `cause` are the caller's bounded facts. */
+export declare function jsonRpcFailure(reason: JsonRpcReason, extra?: {
+    readonly details?: CapabilityErrorDetails;
+    readonly cause?: CaughtFailure;
+}): CapabilityError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/jsonrpc/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/jsonrpc/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAA4B,KAAK,sBAAsB,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAIjI,mFAAmF;AACnF,eAAO,MAAM,eAAe,8QAYlB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,+FAA+F;AAC/F,eAAO,MAAM,iBAAiB,MAAM,CAAC;AA+DrC;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,6GAA6G;AAC7G,wBAAgB,cAAc,CAC7B,MAAM,EAAE,aAAa,EACrB,KAAK,GAAE;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,sBAAsB,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAA;CAAO,GACvF,eAAe,CASjB"}

package/dist/jsonrpc/errors.js

@@ -0,0 +1,110 @@
+/**
+ * Typed failures of the JSON-RPC child client.
+ *
+ * Child-supplied text (a JSON-RPC `error.message`, an unparseable line, stderr)
+ * never enters a thrown message: every message is fixed per reason. The child's
+ * numeric code and a bounded, control-character-stripped excerpt ride only in
+ * `details`, so the logger that prints them decides whether to.
+ */
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { redactedExcerpt } from '@vibesdotdev/shared/utils';
+import { asError } from "./outcome.js";
+/** The reasons this client fails with; each has one fixed message and one code. */
+export const JSONRPC_REASONS = [
+    'jsonrpc-error',
+    'jsonrpc-protocol-invalid',
+    'jsonrpc-child-exited',
+    'jsonrpc-line-too-large',
+    'jsonrpc-timeout',
+    'jsonrpc-closed',
+    'jsonrpc-cancelled',
+    'jsonrpc-notification-overflow',
+    'jsonrpc-kill-failed',
+    'jsonrpc-hook-failed',
+    'jsonrpc-invalid-options'
+];
+/** The longest excerpt of child text a failure carries in `details.excerpt`, in characters. */
+export const MAX_EXCERPT_CHARS = 200;
+/** How many characters of child text are examined before stripping, so a huge value costs a bounded amount. */
+const EXCERPT_SCAN_CHARS = 4 * MAX_EXCERPT_CHARS;
+const FAILURES = {
+    'jsonrpc-error': {
+        code: 'UNAVAILABLE',
+        message: 'The child process answered the request with a JSON-RPC error.',
+        retryable: false
+    },
+    'jsonrpc-protocol-invalid': {
+        code: 'INVALID_INPUT',
+        message: 'The child process sent output that is not valid JSON-RPC.',
+        retryable: false
+    },
+    'jsonrpc-child-exited': {
+        code: 'UNAVAILABLE',
+        message: 'The child process ended or its stdio failed.',
+        retryable: true
+    },
+    'jsonrpc-line-too-large': {
+        code: 'INVALID_INPUT',
+        message: 'The child process sent a line longer than the declared maximum.',
+        retryable: false
+    },
+    'jsonrpc-timeout': {
+        code: 'TIMEOUT',
+        message: 'The child process did not answer within the declared deadline.',
+        retryable: true
+    },
+    'jsonrpc-closed': {
+        code: 'UNAVAILABLE',
+        message: 'The JSON-RPC client is closed.',
+        retryable: false
+    },
+    'jsonrpc-cancelled': {
+        code: 'CANCELLED',
+        message: 'The request was cancelled by its caller.',
+        retryable: false
+    },
+    'jsonrpc-notification-overflow': {
+        code: 'UNAVAILABLE',
+        message: 'The notification queue is full: notifications are arriving faster than they are consumed.',
+        retryable: false
+    },
+    'jsonrpc-kill-failed': {
+        code: 'UNAVAILABLE',
+        message: 'The child process could not be confirmed stopped.',
+        retryable: false
+    },
+    'jsonrpc-hook-failed': {
+        code: 'INTERNAL',
+        message: 'A caller-supplied JSON-RPC hook threw.',
+        retryable: false
+    },
+    'jsonrpc-invalid-options': {
+        code: 'INVALID_INPUT',
+        message: 'The JSON-RPC client or request was given invalid options.',
+        retryable: false
+    }
+};
+/**
+ * Child text reduced to what a log line can safely carry: at most
+ * {@link MAX_EXCERPT_CHARS} characters, with control, format (bidi, zero-width),
+ * line- and paragraph-separator and unpaired-surrogate characters removed, and
+ * every credential-shaped token removed (the platform's one redaction,
+ * `@vibesdotdev/shared/utils`: a child echoes the keys and tokens it was given).
+ */
+export function boundedExcerpt(text) {
+    return redactedExcerpt(text, { maxChars: MAX_EXCERPT_CHARS, readChars: EXCERPT_SCAN_CHARS });
+}
+/** A typed failure with its reason's fixed message; `details` and `cause` are the caller's bounded facts. */
+export function jsonRpcFailure(reason, extra = {}) {
+    const failure = FAILURES[reason];
+    const options = {
+        reason,
+        retryable: failure.retryable
+    };
+    if (extra.details !== undefined)
+        options.details = extra.details;
+    if (extra.cause !== undefined)
+        options.cause = asError(extra.cause);
+    return new CapabilityError(failure.message, failure.code, options);
+}
+//# sourceMappingURL=errors.js.map

package/dist/jsonrpc/errors.js.map

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

package/dist/jsonrpc/framing.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Newline-delimited framing over a child's byte stream, with a hard line cap.
+ *
+ * {@link LineSplitter} works chunk by chunk and never holds more than
+ * `maxLineBytes` of a partial line: a line that would pass the cap fails typed
+ * (`INVALID_INPUT jsonrpc-line-too-large`) before any of it is copied, and a
+ * complete line inside one chunk is decoded straight from the chunk, so a long
+ * stream costs time proportional to its bytes (no repeated slicing of a growing
+ * string). A final line with no trailing newline is returned by `flush()`.
+ *
+ * {@link readLines} is the same framing as an async generator over a stream, for
+ * NDJSON protocols that are not JSON-RPC (Antigravity `agy`, Claude Code
+ * `stream-json`).
+ */
+export declare class LineSplitter {
+    #private;
+    constructor(maxLineBytes?: number);
+    /** Bytes of a partial line held right now (never more than `maxLineBytes`). */
+    get bufferedBytes(): number;
+    /** The most bytes of a partial line ever held: the memory claim, measurable. */
+    get highWaterBytes(): number;
+    /** The non-empty lines this chunk completes. Throws `jsonrpc-line-too-large` when a line passes the cap. */
+    push(chunk: Uint8Array): string[];
+    /** The final line when the stream ended without a trailing newline (zero or one line). */
+    flush(): string[];
+}
+/**
+ * The non-empty lines of a byte stream, capped per line. Ends when the stream
+ * ends (the final unterminated line included). A line over the cap, or a stream
+ * that fails, throws; leaving early (break/throw) cancels the stream.
+ */
+export declare function readLines(stream: ReadableStream<Uint8Array>, options?: {
+    readonly maxLineBytes?: number;
+}): AsyncGenerator<string, void, undefined>;
+//# sourceMappingURL=framing.d.ts.map

package/dist/jsonrpc/framing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framing.d.ts","sourceRoot":"","sources":["../../src/jsonrpc/framing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAYH,qBAAa,YAAY;;gBAOZ,YAAY,GAAE,MAA+B;IAOzD,+EAA+E;IAC/E,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,gFAAgF;IAChF,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,4GAA4G;IAC5G,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,EAAE;IAoBjC,0FAA0F;IAC1F,KAAK,IAAI,MAAM,EAAE;CAmCjB;AAED;;;;GAIG;AACH,wBAAuB,SAAS,CAC/B,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,EAClC,OAAO,GAAE;IAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAO,GAC9C,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,CAqBzC"}

package/dist/jsonrpc/framing.js

@@ -0,0 +1,134 @@
+/**
+ * Newline-delimited framing over a child's byte stream, with a hard line cap.
+ *
+ * {@link LineSplitter} works chunk by chunk and never holds more than
+ * `maxLineBytes` of a partial line: a line that would pass the cap fails typed
+ * (`INVALID_INPUT jsonrpc-line-too-large`) before any of it is copied, and a
+ * complete line inside one chunk is decoded straight from the chunk, so a long
+ * stream costs time proportional to its bytes (no repeated slicing of a growing
+ * string). A final line with no trailing newline is returned by `flush()`.
+ *
+ * {@link readLines} is the same framing as an async generator over a stream, for
+ * NDJSON protocols that are not JSON-RPC (Antigravity `agy`, Claude Code
+ * `stream-json`).
+ */
+import { jsonRpcFailure } from "./errors.js";
+import { DEFAULT_MAX_LINE_BYTES } from "./schemas.js";
+import { settle } from "./outcome.js";
+const NEWLINE = 0x0a;
+/** A partial-line buffer starts this small and doubles, never past the cap. */
+const INITIAL_BUFFER_BYTES = 1_024;
+/** A buffer larger than this is released once its line completes. */
+const RETAINED_BUFFER_BYTES = 65_536;
+export class LineSplitter {
+    #maxLineBytes;
+    #decoder = new TextDecoder();
+    #buffer = new Uint8Array(0);
+    #length = 0;
+    #highWater = 0;
+    constructor(maxLineBytes = DEFAULT_MAX_LINE_BYTES) {
+        if (!Number.isInteger(maxLineBytes) || maxLineBytes < 1) {
+            throw new RangeError('LineSplitter maxLineBytes must be a positive integer.');
+        }
+        this.#maxLineBytes = maxLineBytes;
+    }
+    /** Bytes of a partial line held right now (never more than `maxLineBytes`). */
+    get bufferedBytes() {
+        return this.#length;
+    }
+    /** The most bytes of a partial line ever held: the memory claim, measurable. */
+    get highWaterBytes() {
+        return this.#highWater;
+    }
+    /** The non-empty lines this chunk completes. Throws `jsonrpc-line-too-large` when a line passes the cap. */
+    push(chunk) {
+        const lines = [];
+        let start = 0;
+        while (start < chunk.length) {
+            const newline = chunk.indexOf(NEWLINE, start);
+            if (newline === -1) {
+                this.#append(chunk, start, chunk.length);
+                break;
+            }
+            if (this.#length + (newline - start) > this.#maxLineBytes)
+                throw this.#tooLarge();
+            const text = this.#length === 0
+                ? this.#decoder.decode(chunk.subarray(start, newline))
+                : this.#completeBuffered(chunk, start, newline);
+            const line = text.trim();
+            if (line !== '')
+                lines.push(line);
+            start = newline + 1;
+        }
+        return lines;
+    }
+    /** The final line when the stream ended without a trailing newline (zero or one line). */
+    flush() {
+        if (this.#length === 0)
+            return [];
+        const line = this.#decoder.decode(this.#buffer.subarray(0, this.#length)).trim();
+        this.#reset();
+        return line === '' ? [] : [line];
+    }
+    #completeBuffered(chunk, start, end) {
+        this.#append(chunk, start, end);
+        const text = this.#decoder.decode(this.#buffer.subarray(0, this.#length));
+        this.#reset();
+        return text;
+    }
+    #append(chunk, start, end) {
+        const needed = this.#length + (end - start);
+        if (needed > this.#maxLineBytes)
+            throw this.#tooLarge();
+        if (needed > this.#buffer.length) {
+            const grown = new Uint8Array(Math.min(this.#maxLineBytes, Math.max(needed, this.#buffer.length * 2, INITIAL_BUFFER_BYTES)));
+            grown.set(this.#buffer.subarray(0, this.#length));
+            this.#buffer = grown;
+        }
+        this.#buffer.set(chunk.subarray(start, end), this.#length);
+        this.#length = needed;
+        if (needed > this.#highWater)
+            this.#highWater = needed;
+    }
+    #reset() {
+        this.#length = 0;
+        if (this.#buffer.length > RETAINED_BUFFER_BYTES)
+            this.#buffer = new Uint8Array(0);
+    }
+    #tooLarge() {
+        return jsonRpcFailure('jsonrpc-line-too-large', { details: { maxLineBytes: this.#maxLineBytes } });
+    }
+}
+/**
+ * The non-empty lines of a byte stream, capped per line. Ends when the stream
+ * ends (the final unterminated line included). A line over the cap, or a stream
+ * that fails, throws; leaving early (break/throw) cancels the stream.
+ */
+export async function* readLines(stream, options = {}) {
+    const splitter = new LineSplitter(options.maxLineBytes);
+    const reader = stream.getReader();
+    let finished = false;
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            for (const line of splitter.push(value))
+                yield line;
+        }
+        for (const line of splitter.flush())
+            yield line;
+        finished = true;
+    }
+    finally {
+        if (finished) {
+            reader.releaseLock();
+        }
+        else {
+            // Left early or failed: stop the producer. The reader's own failure is the failure being thrown.
+            await settle(reader.cancel());
+            reader.releaseLock();
+        }
+    }
+}
+//# sourceMappingURL=framing.js.map

package/dist/jsonrpc/framing.js.map

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

package/dist/jsonrpc/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `@vibesdotdev/external/jsonrpc`: the one stdio JSON-RPC child client, the
+ * capped line framing it stands on, and the bounded async queue.
+ */
+export { createJsonRpcChild, type JsonRpcAbandonedRequest, type JsonRpcAbandonReason, type JsonRpcAgentRequest, type JsonRpcChild, type JsonRpcChildOptions, type JsonRpcDiagnostic, type JsonRpcNotification, type JsonRpcProcess, type JsonRpcRequestHandler, type JsonRpcRequestOptions, type JsonRpcRuntime } from './client.ts';
+export { boundedExcerpt, JSONRPC_REASONS, MAX_EXCERPT_CHARS, type JsonRpcReason } from './errors.ts';
+export { LineSplitter, readLines } from './framing.ts';
+export { AsyncQueue, type QueuePushResult } from './queue.ts';
+export { DEFAULT_GRACE_MS, DEFAULT_KILL_WAIT_MS, DEFAULT_MAX_LINE_BYTES, DEFAULT_NOTIFICATION_CAPACITY, DEFAULT_STDERR_TAIL_BYTES, JsonRpcChildLimitsSchema, JsonRpcEnvelopeStyleSchema, JsonRpcIdSchema, type JsonRpcChildLimits, type JsonRpcEnvelopeStyle, type JsonRpcId } from './schemas.ts';
+export { classifyLine, type JsonRpcInbound, type JsonRpcWireError } from './envelope.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/jsonrpc/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACN,kBAAkB,EAClB,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,iBAAiB,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AACrG,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EACN,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,EACtB,6BAA6B,EAC7B,yBAAyB,EACzB,wBAAwB,EACxB,0BAA0B,EAC1B,eAAe,EACf,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,SAAS,EACd,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,YAAY,EAAE,KAAK,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC"}

package/dist/jsonrpc/index.js

@@ -0,0 +1,11 @@
+/**
+ * `@vibesdotdev/external/jsonrpc`: the one stdio JSON-RPC child client, the
+ * capped line framing it stands on, and the bounded async queue.
+ */
+export { createJsonRpcChild } from "./client.js";
+export { boundedExcerpt, JSONRPC_REASONS, MAX_EXCERPT_CHARS } from "./errors.js";
+export { LineSplitter, readLines } from "./framing.js";
+export { AsyncQueue } from "./queue.js";
+export { DEFAULT_GRACE_MS, DEFAULT_KILL_WAIT_MS, DEFAULT_MAX_LINE_BYTES, DEFAULT_NOTIFICATION_CAPACITY, DEFAULT_STDERR_TAIL_BYTES, JsonRpcChildLimitsSchema, JsonRpcEnvelopeStyleSchema, JsonRpcIdSchema } from "./schemas.js";
+export { classifyLine } from "./envelope.js";
+//# sourceMappingURL=index.js.map

package/dist/jsonrpc/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/jsonrpc/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACN,kBAAkB,EAYlB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,iBAAiB,EAAsB,MAAM,aAAa,CAAC;AACrG,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,UAAU,EAAwB,MAAM,YAAY,CAAC;AAC9D,OAAO,EACN,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,EACtB,6BAA6B,EAC7B,yBAAyB,EACzB,wBAAwB,EACxB,0BAA0B,EAC1B,eAAe,EAIf,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,YAAY,EAA8C,MAAM,eAAe,CAAC"}

package/dist/jsonrpc/outcome.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Failures as values for the JSON-RPC client.
+ *
+ * A throw or a rejection becomes a value that carries its cause, so the owner
+ * of the decision (fail the client, report a diagnostic, rethrow typed) receives
+ * the failure itself and nothing in between can drop it.
+ */
+import { type CaughtFailure } from '@vibesdotdev/kernel';
+/** What an operation produced, or the failure it raised. */
+export type Outcome<T> = {
+    readonly failed: false;
+    readonly value: T;
+} | {
+    readonly failed: true;
+    readonly cause: CaughtFailure;
+};
+/** A caught failure as an `Error`: an `Error` stays itself, a non-Error throw is wrapped with its value as the cause. */
+export declare function asError(failure: CaughtFailure): Error;
+/** Run a synchronous operation; a throw becomes a failed outcome carrying its cause. */
+export declare function attempt<T>(run: () => T): Outcome<T>;
+/** Observe an asynchronous operation; a rejection becomes a failed outcome carrying its cause. */
+export declare function settle<T>(operation: PromiseLike<T>): Promise<Outcome<T>>;
+/** Run an operation that may throw synchronously or reject; either is a failed outcome. */
+export declare function attemptAsync<T>(run: () => T | PromiseLike<T>): Promise<Outcome<T>>;
+//# sourceMappingURL=outcome.d.ts.map

package/dist/jsonrpc/outcome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outcome.d.ts","sourceRoot":"","sources":["../../src/jsonrpc/outcome.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE9E,4DAA4D;AAC5D,MAAM,MAAM,OAAO,CAAC,CAAC,IAClB;IAAE,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GAC7C;IAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAA;CAAE,CAAC;AAE5D,yHAAyH;AACzH,wBAAgB,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,KAAK,CAGrD;AAED,wFAAwF;AACxF,wBAAgB,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAMnD;AAED,kGAAkG;AAClG,wBAAgB,MAAM,CAAC,CAAC,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAKxE;AAED,2FAA2F;AAC3F,wBAAgB,YAAY,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAElF"}

package/dist/jsonrpc/outcome.js

@@ -0,0 +1,32 @@
+/**
+ * Failures as values for the JSON-RPC client.
+ *
+ * A throw or a rejection becomes a value that carries its cause, so the owner
+ * of the decision (fail the client, report a diagnostic, rethrow typed) receives
+ * the failure itself and nothing in between can drop it.
+ */
+import { CaughtFailureSchema } from '@vibesdotdev/kernel';
+/** A caught failure as an `Error`: an `Error` stays itself, a non-Error throw is wrapped with its value as the cause. */
+export function asError(failure) {
+    if (failure instanceof Error)
+        return failure;
+    return new TypeError('A non-Error value was thrown.', { cause: failure.value });
+}
+/** Run a synchronous operation; a throw becomes a failed outcome carrying its cause. */
+export function attempt(run) {
+    try {
+        return { failed: false, value: run() };
+    }
+    catch (cause) {
+        return { failed: true, cause: CaughtFailureSchema.parse(cause) };
+    }
+}
+/** Observe an asynchronous operation; a rejection becomes a failed outcome carrying its cause. */
+export function settle(operation) {
+    return Promise.resolve(operation).then((value) => ({ failed: false, value }), (cause) => ({ failed: true, cause: CaughtFailureSchema.parse(cause) }));
+}
+/** Run an operation that may throw synchronously or reject; either is a failed outcome. */
+export function attemptAsync(run) {
+    return settle((async () => run())());
+}
+//# sourceMappingURL=outcome.js.map

package/dist/jsonrpc/outcome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outcome.js","sourceRoot":"","sources":["../../src/jsonrpc/outcome.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,mBAAmB,EAAsB,MAAM,qBAAqB,CAAC;AAO9E,yHAAyH;AACzH,MAAM,UAAU,OAAO,CAAC,OAAsB;IAC7C,IAAI,OAAO,YAAY,KAAK;QAAE,OAAO,OAAO,CAAC;IAC7C,OAAO,IAAI,SAAS,CAAC,+BAA+B,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;AACjF,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,OAAO,CAAI,GAAY;IACtC,IAAI,CAAC;QACJ,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC;IACxC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;IAClE,CAAC;AACF,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,MAAM,CAAI,SAAyB;IAClD,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CACrC,CAAC,KAAK,EAAc,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EACjD,CAAC,KAAK,EAAc,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAClF,CAAC;AACH,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,YAAY,CAAI,GAA6B;IAC5D,OAAO,MAAM,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;AACtC,CAAC"}

package/dist/jsonrpc/queue.d.ts

@@ -0,0 +1,30 @@
+/**
+ * A bounded async queue: one producer pushes, consumers iterate.
+ *
+ * It never grows past its declared capacity: `push` answers `full` and the
+ * owner decides what a full queue means (the JSON-RPC client fails itself typed,
+ * `jsonrpc-notification-overflow`). `end()` finishes the iteration after the
+ * buffered items drain; `fail(error)` does the same but the first consumer to
+ * reach the end receives `error` (once; later reads are done).
+ *
+ * Breaking out of a `for await` only stops that iteration: the queue and its
+ * remaining items stay for the next one.
+ */
+export type QueuePushResult = 'accepted' | 'full' | 'ended';
+export declare class AsyncQueue<T> implements AsyncIterable<T> {
+    #private;
+    constructor(capacity: number);
+    get capacity(): number;
+    /** Items buffered and not yet consumed. */
+    get size(): number;
+    /** Whether `end()` or `fail()` was called. */
+    get ended(): boolean;
+    push(item: T): QueuePushResult;
+    /** Finish after the buffered items drain. Idempotent. */
+    end(): void;
+    /** Finish after the buffered items drain, delivering `error` to the first consumer that reaches the end. Idempotent: the first call wins. */
+    fail(error: Error): void;
+    next(): Promise<IteratorResult<T, undefined>>;
+    [Symbol.asyncIterator](): AsyncIterator<T, undefined>;
+}
+//# sourceMappingURL=queue.d.ts.map

package/dist/jsonrpc/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/jsonrpc/queue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC;AAU5D,qBAAa,UAAU,CAAC,CAAC,CAAE,YAAW,aAAa,CAAC,CAAC,CAAC;;gBASzC,QAAQ,EAAE,MAAM;IAO5B,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,2CAA2C;IAC3C,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,8CAA8C;IAC9C,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,eAAe;IAY9B,yDAAyD;IACzD,GAAG,IAAI,IAAI;IAMX,6IAA6I;IAC7I,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAOxB,IAAI,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IAa7C,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,CAAC,EAAE,SAAS,CAAC;CA+BrD"}

package/dist/jsonrpc/queue.js

@@ -0,0 +1,113 @@
+/**
+ * A bounded async queue: one producer pushes, consumers iterate.
+ *
+ * It never grows past its declared capacity: `push` answers `full` and the
+ * owner decides what a full queue means (the JSON-RPC client fails itself typed,
+ * `jsonrpc-notification-overflow`). `end()` finishes the iteration after the
+ * buffered items drain; `fail(error)` does the same but the first consumer to
+ * reach the end receives `error` (once; later reads are done).
+ *
+ * Breaking out of a `for await` only stops that iteration: the queue and its
+ * remaining items stay for the next one.
+ */
+/** Consumed items are compacted off the front once this many have been taken. */
+const COMPACT_AT = 1_024;
+export class AsyncQueue {
+    #capacity;
+    /** Boxed so an item that is itself `undefined` is distinguishable from an empty slot. */
+    #items = [];
+    #head = 0;
+    #waiters = [];
+    #ended = false;
+    #failure;
+    constructor(capacity) {
+        if (!Number.isInteger(capacity) || capacity < 1) {
+            throw new RangeError('AsyncQueue capacity must be a positive integer.');
+        }
+        this.#capacity = capacity;
+    }
+    get capacity() {
+        return this.#capacity;
+    }
+    /** Items buffered and not yet consumed. */
+    get size() {
+        return this.#items.length - this.#head;
+    }
+    /** Whether `end()` or `fail()` was called. */
+    get ended() {
+        return this.#ended;
+    }
+    push(item) {
+        if (this.#ended)
+            return 'ended';
+        const waiter = this.#waiters.shift();
+        if (waiter) {
+            waiter.resolve({ done: false, value: item });
+            return 'accepted';
+        }
+        if (this.size >= this.#capacity)
+            return 'full';
+        this.#items.push({ value: item });
+        return 'accepted';
+    }
+    /** Finish after the buffered items drain. Idempotent. */
+    end() {
+        if (this.#ended)
+            return;
+        this.#ended = true;
+        this.#releaseWaiters();
+    }
+    /** Finish after the buffered items drain, delivering `error` to the first consumer that reaches the end. Idempotent: the first call wins. */
+    fail(error) {
+        if (this.#ended)
+            return;
+        this.#failure = error;
+        this.#ended = true;
+        this.#releaseWaiters();
+    }
+    next() {
+        const box = this.#items[this.#head];
+        if (box) {
+            this.#head++;
+            this.#compact();
+            return Promise.resolve({ done: false, value: box.value });
+        }
+        if (this.#ended)
+            return this.#atEnd();
+        return new Promise((resolve, reject) => {
+            this.#waiters.push({ resolve, reject });
+        });
+    }
+    [Symbol.asyncIterator]() {
+        return {
+            next: () => this.next(),
+            return: () => Promise.resolve({ done: true, value: undefined })
+        };
+    }
+    #compact() {
+        if (this.#head >= COMPACT_AT && this.#head * 2 >= this.#items.length) {
+            this.#items = this.#items.slice(this.#head);
+            this.#head = 0;
+        }
+    }
+    /** Nothing is buffered and the queue ended: the failure once, then done. */
+    #atEnd() {
+        const failure = this.#failure;
+        this.#failure = undefined;
+        if (failure)
+            return Promise.reject(failure);
+        return Promise.resolve({ done: true, value: undefined });
+    }
+    #releaseWaiters() {
+        // Waiters only exist while nothing is buffered, so the first one reaches the end.
+        for (const waiter of this.#waiters.splice(0)) {
+            const failure = this.#failure;
+            this.#failure = undefined;
+            if (failure)
+                waiter.reject(failure);
+            else
+                waiter.resolve({ done: true, value: undefined });
+        }
+    }
+}
+//# sourceMappingURL=queue.js.map

package/dist/jsonrpc/queue.js.map

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