@vibesdotdev/kernel-rpc 0.0.0-stage → 1.0.0-rc.2

package/dist/transports/unix/codec/socket-codec.js

@@ -0,0 +1,122 @@
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { frameClose, frameCredit, frameData } from '@vibesdotdev/kernel-rpc';
+import {} from "../../../core/protocol/transport/local-attestation.js";
+import { HOST_FAILURES } from "../../../core/protocol/transport/failure-describer.js";
+import { jsonRequest, jsonResponse } from "../../../core/protocol/wire/json-wire.js";
+import { RPC_MAX_MESSAGE_BYTES, oversize } from "../../../core/protocol/wire/limits.js";
+import { isNumber } from "../../../core/protocol/wire/value-kinds.js";
+export { RecordParser } from "./record-parser.js";
+export { BackpressureWriter } from "./socket-writer.js";
+export { SocketMessageSchema, SocketWireRecordSchema } from "../../../schemas/contracts/transports/unix/socket-codec.js";
+/** Whether a decoded message is a client's wire opt-in. */
+export function isSocketWireRecord(message) {
+    return 'wire' in message;
+}
+export function invalidRecord(cause) {
+    return new CapabilityError('Invalid RPC socket record.', 'INVALID_INPUT', {
+        reason: 'rpc-frame-invalid', retryable: false,
+        cause: cause === undefined ? undefined : HOST_FAILURES.describe(cause)
+    });
+}
+export /** A record header: a 4-byte body length and a 1-byte kind. */ const RECORD_HEADER_BYTES = 5;
+/**
+ * The largest record body this end accepts. A declared length above it is refused before any body byte is
+ * buffered. It is the writer's own ceiling ({@link OUTBOX_HIGH_WATER_BYTES}): no legitimate record exceeds
+ * what the peer's writer will queue.
+ */
+export const RECORD_MAX_BODY_BYTES = RPC_MAX_MESSAGE_BYTES;
+export function recordTooLarge() {
+    return new CapabilityError('An RPC socket record declares more bytes than this end accepts.', 'INVALID_INPUT', {
+        reason: 'rpc-record-too-large', retryable: false
+    });
+}
+/** Whether an encoded record's body is past {@link RECORD_MAX_BODY_BYTES}: the peer's parser refuses it from the header. */
+export function exceedsRecordCeiling(record) {
+    return record.length - RECORD_HEADER_BYTES > RECORD_MAX_BODY_BYTES;
+}
+/**
+ * The refusal of a message this end will not send because its record is past the ceiling the peer accepts. The
+ * writer answers the one request with it instead of a record whose header ends the whole connection.
+ */
+export function messageTooLarge() {
+    return oversize('An RPC socket message exceeds the record ceiling and was not sent.', 'rpc-message-too-large', RECORD_MAX_BODY_BYTES);
+}
+export const REC = {
+    MSG: 0x00,
+    STREAM: 0x01
+};
+/** Encode a length-prefixed record. */
+function encodeRecord(kind, body) {
+    const out = new Uint8Array(5 + body.length);
+    const view = new DataView(out.buffer);
+    view.setUint32(0, body.length, false);
+    out[4] = kind;
+    out.set(body, 5);
+    return out;
+}
+const encoder = new TextEncoder();
+export const decoder = new TextDecoder(undefined, { fatal: true });
+/**
+ * Encode a message as a MSG record. `dates` is the connection's negotiated wire
+ * capability: Date metadata is written only when both peers admitted it.
+ */
+export function encodeMessage(message, dates = false) {
+    const legacy = 'attest' in message || 'wire' in message ? message : 'verb' in message
+        ? jsonRequest(message, dates) : jsonResponse(message, dates);
+    return encodeRecord(REC.MSG, encoder.encode(JSON.stringify(legacy)));
+}
+/** Encode a stream DATA record for a channel. */
+export function encodeStreamData(channelId, payload) {
+    return encodeRecord(REC.STREAM, withChannel(channelId, frameData(payload)));
+}
+/** Encode a stream CLOSE record for a channel; `ending` only where stream credits were negotiated. */
+export function encodeStreamClose(channelId, ending) {
+    return encodeRecord(REC.STREAM, withChannel(channelId, frameClose(ending)));
+}
+/** Encode a stream CREDIT record granting `credits` more DATA frames (negotiated connections only). */
+export function encodeStreamCredit(channelId, credits) {
+    return encodeRecord(REC.STREAM, withChannel(channelId, frameCredit(credits)));
+}
+function withChannel(channelId, frame) {
+    const idBytes = encoder.encode(channelId);
+    const out = new Uint8Array(4 + idBytes.length + frame.length);
+    new DataView(out.buffer).setUint32(0, idBytes.length, false);
+    out.set(idBytes, 4);
+    out.set(frame, 4 + idBytes.length);
+    return out;
+}
+export /**
+ * Queued-bytes ceiling for a stalled peer. A peer that stops reading would
+ * otherwise grow the outbox without bound; past this cap the writer ends the
+ * connection so the close path rejects pending calls loudly instead of the
+ * process heap ballooning. 32MB comfortably exceeds any legitimate RPC frame
+ * (preset-start config pools are hundreds of KB).
+ */ const OUTBOX_HIGH_WATER_BYTES = RPC_MAX_MESSAGE_BYTES;
+/**
+ * Adapt a node:net socket (boolean `write`) to the numeric {@link DuplexSocket}
+ * the {@link BackpressureWriter} expects. node queues the ENTIRE chunk
+ * internally — a `false` return only signals backpressure, never truncation —
+ * so that chunk is fully accepted. Subsequent writes wait for drain while the
+ * shared writer accounts for both its outbox and the native buffer.
+ */
+export function wrapNodeSocket(socket) {
+    let blocked = false;
+    return {
+        get bufferedBytes() { return socket.writableLength ?? 0; },
+        drain() { blocked = false; },
+        write(data) {
+            if (blocked)
+                return 0;
+            const accepted = socket.write(data);
+            blocked = accepted === false;
+            return isNumber(accepted) ? accepted : data.length;
+        },
+        end() {
+            if (socket.destroy)
+                socket.destroy();
+            else
+                socket.end();
+        }
+    };
+}
+//# sourceMappingURL=socket-codec.js.map

package/dist/transports/unix/codec/socket-codec.js.map

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

package/dist/transports/unix/codec/socket-writer.d.ts

@@ -0,0 +1,16 @@
+import type { DuplexSocket } from "../../../schemas/contracts/transports/unix/socket-codec.ts";
+export declare class BackpressureWriter implements DuplexSocket {
+    private readonly socket;
+    private outbox;
+    private queuedBytes;
+    private ended;
+    constructor(socket: DuplexSocket);
+    /** Bytes currently queued behind a full kernel buffer (observability). */
+    get pendingBytes(): number;
+    write(data: Uint8Array): number;
+    private enqueue;
+    /** Flush queued bytes. Call from the Bun socket's `drain` handler. */
+    drain(): void;
+    end(): void;
+}
+//# sourceMappingURL=socket-writer.d.ts.map

package/dist/transports/unix/codec/socket-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-writer.d.ts","sourceRoot":"","sources":["../../../../src/transports/unix/codec/socket-writer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4DAA4D,CAAC;AAG/F,qBAAa,kBAAmB,YAAW,YAAY;IAK1C,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJnC,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,KAAK,CAAS;gBAEO,MAAM,EAAE,YAAY;IAEjD,0EAA0E;IAC1E,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM;IAgB/B,OAAO,CAAC,OAAO;IAUf,sEAAsE;IACtE,KAAK,IAAI,IAAI;IAgBb,GAAG,IAAI,IAAI;CAQX"}

package/dist/transports/unix/codec/socket-writer.js

@@ -0,0 +1,69 @@
+import { OUTBOX_HIGH_WATER_BYTES } from "./socket-codec.js";
+export class BackpressureWriter {
+    socket;
+    outbox = [];
+    queuedBytes = 0;
+    ended = false;
+    constructor(socket) {
+        this.socket = socket;
+    }
+    /** Bytes currently queued behind a full kernel buffer (observability). */
+    get pendingBytes() {
+        return this.queuedBytes + (this.socket.bufferedBytes ?? 0);
+    }
+    write(data) {
+        if (this.ended || data.length === 0)
+            return 0;
+        // Never interleave: while a tail is queued, everything queues behind it.
+        if (this.outbox.length > 0) {
+            this.enqueue(data);
+            return 0;
+        }
+        const n = this.socket.write(data);
+        if (this.pendingBytes > OUTBOX_HIGH_WATER_BYTES) {
+            this.end();
+            return 0;
+        }
+        const written = n > 0 ? n : 0;
+        if (written < data.length) {
+            this.enqueue(data.subarray(written));
+        }
+        return written;
+    }
+    enqueue(data) {
+        this.outbox.push(data);
+        this.queuedBytes += data.length;
+        if (this.pendingBytes > OUTBOX_HIGH_WATER_BYTES) {
+            // Stalled peer: fail the connection loudly (close path rejects
+            // pending calls) rather than buffering forever.
+            this.end();
+        }
+    }
+    /** Flush queued bytes. Call from the Bun socket's `drain` handler. */
+    drain() {
+        if (this.ended)
+            return;
+        this.socket.drain?.();
+        while (this.outbox.length > 0) {
+            const head = this.outbox[0];
+            const n = this.socket.write(head);
+            const written = n > 0 ? n : 0;
+            this.queuedBytes -= written;
+            if (written < head.length) {
+                if (written > 0)
+                    this.outbox[0] = head.subarray(written);
+                return; // kernel buffer full again — the next drain resumes here
+            }
+            this.outbox.shift();
+        }
+    }
+    end() {
+        // Closing with a non-empty outbox drops queued bytes — acceptable: every
+        // close path here is a teardown where the peer rejects pending calls anyway.
+        this.ended = true;
+        this.outbox = [];
+        this.queuedBytes = 0;
+        this.socket.end();
+    }
+}
+//# sourceMappingURL=socket-writer.js.map

package/dist/transports/unix/codec/socket-writer.js.map

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

package/dist/transports/unix/consumer/connect-unix.d.ts

@@ -0,0 +1,12 @@
+import { type RpcConnection } from '@vibesdotdev/kernel-rpc';
+import type { LocalAttestationPresentation } from '../../../core/protocol/transport/local-attestation.ts';
+import type { RpcSocketRuntime } from "../../../schemas/contracts/transports/unix/unix-transport.impl.ts";
+/** Open a unix-socket connection to a listening runtime. Returns an */
+export declare function connectUnix(socketPathInput: string, optionsInput: {
+    runtime: RpcSocketRuntime;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+    /** The local attestation and declared launch identity this client presents (RC08). */
+    attestation?: LocalAttestationPresentation;
+}): Promise<RpcConnection>;
+//# sourceMappingURL=connect-unix.d.ts.map

package/dist/transports/unix/consumer/connect-unix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect-unix.d.ts","sourceRoot":"","sources":["../../../../src/transports/unix/consumer/connect-unix.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAKhF,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,uDAAuD,CAAC;AAE1G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mEAAmE,CAAC;AAsB1G,uEAAuE;AACvE,wBAAsB,WAAW,CAChC,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE;IACb,OAAO,EAAE,gBAAgB,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,sFAAsF;IACtF,WAAW,CAAC,EAAE,4BAA4B,CAAC;CAC3C,GACC,OAAO,CAAC,aAAa,CAAC,CAiCxB"}

package/dist/transports/unix/consumer/connect-unix.js

@@ -0,0 +1,51 @@
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { attemptRpcConnect } from '@vibesdotdev/kernel-rpc';
+import { getRuntimeSocketService } from '@vibesdotdev/kernel/socket';
+import { attemptAsync } from "../../../core/protocol/lifecycle/attempt.js";
+import { ownedConnection } from "../../../core/protocol/lifecycle/lifecycle-owned.js";
+import { readInput } from "../../../core/protocol/references/caller-input.js";
+import { connectFailure, connectTimeout } from "../../../core/protocol/transport/socket-connect-failure.js";
+import { ConnectUnixInput } from "../../../schemas/contracts/transports/unix/unix-transport.impl.js";
+import { dialSocketSession } from "../socket-handshake.js";
+/** `connectUnix` input, read once (protocol/caller-input.ts). */
+/** `listenUnix` input, read once. */
+/** A handshake failure, typed: the peer connected but never became an RPC session. */
+function handshakeFailure(socketPath, message, code, reason, cause) {
+    // An INTERNAL handshake failure keeps the default (not retryable); the others may be retried.
+    return new CapabilityError(message, code, {
+        reason, retryable: code === 'INTERNAL' ? undefined : true, details: { socketPath }, cause
+    });
+}
+/** Open a unix-socket connection to a listening runtime. Returns an */
+export async function connectUnix(socketPathInput, optionsInput) {
+    const { socketPath, options } = readInput('connectUnix', ConnectUnixInput, { socketPath: socketPathInput, options: optionsInput });
+    const timeoutMs = options.timeoutMs ?? 5000;
+    const sockets = await getRuntimeSocketService(options.runtime);
+    let phase = 'connect';
+    const connection = await attemptRpcConnect({
+        lifecycle: options.runtime.lifecycle,
+        timeoutMs,
+        reason: 'rpc-unix-connect',
+        signal: options.signal,
+        dial: async (signal) => {
+            const startedAt = Date.now();
+            const connected = await attemptAsync(() => sockets.connectLocal(socketPath, { timeoutMs, signal }));
+            if (!connected.ok) {
+                throw connectFailure(socketPath, { socketPath }, connected.failure, timeoutMs > 0 && Date.now() - startedAt >= timeoutMs);
+            }
+            phase = 'handshake';
+            return dialSocketSession(connected.value, signal, {
+                invalid: (message, cause) => handshakeFailure(socketPath, message, 'INTERNAL', 'rpc-handshake-invalid', cause),
+                closed: () => handshakeFailure(socketPath, 'Socket closed before RPC handshake', 'UNAVAILABLE', 'rpc-handshake-closed'),
+                failed: (cause) => handshakeFailure(socketPath, 'Socket failed before RPC handshake', 'UNAVAILABLE', 'rpc-handshake-failed', cause)
+            }, options.attestation);
+        },
+        discard: (late) => late.close(),
+        timedOut: (deadline) => phase === 'connect'
+            ? connectTimeout(`Connecting to ${socketPath} timed out after ${timeoutMs}ms`, { socketPath }, deadline)
+            : handshakeFailure(socketPath, `RPC handshake timed out after ${timeoutMs}ms`, 'TIMEOUT', 'rpc-handshake-timeout', deadline)
+    });
+    // Owned by the runtime that opened it: its disposal closes the connection; the outcome is kept for close().
+    return ownedConnection(connection, options.runtime.lifecycle.signal);
+}
+//# sourceMappingURL=connect-unix.js.map

package/dist/transports/unix/consumer/connect-unix.js.map

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

package/dist/transports/unix/consumer/socket-channel.d.ts

@@ -0,0 +1,45 @@
+import type { CaughtFailure } from '@vibesdotdev/kernel';
+import { type RpcChannel } from '@vibesdotdev/kernel-rpc';
+import { type RpcChannelCloseAck } from '../../../core/protocol/lifecycle/channel-close.ts';
+import { type StreamEnding } from '../../../core/protocol/wire/frame.ts';
+import { type DuplexSocket } from '../codec/socket-codec.ts';
+export declare class SocketChannel implements RpcChannel {
+    private readonly channelId;
+    private readonly socket;
+    private readonly onClose;
+    private readonly handlers;
+    private readonly end;
+    readonly ended: Promise<void>;
+    /** The transport channel is live (neither end has closed it). */
+    private open;
+    /** The owner opened it credit-governed (its open answer said so). */
+    creditGoverned: boolean;
+    /** Admit `credits` more DATA frames; only where this connection negotiated stream credits. */
+    readonly grant?: (credits: number) => void;
+    /** The consumer discarded the channel locally. */
+    private disposed;
+    /**
+     * Bytes delivered before the FIRST `onData` handler attaches. The channel is
+     * registered before the `stream` response is awaited (so the owner's first
+     * frames are never dropped on the wire), but the consumer only attaches its
+     * handler after `openStream` resolves — any DATA frame in that window buffers
+     * here and is flushed, in order, on the first attach. Mirrors the http owner
+     * side's `OwnerChannel.pending`. `null` once a handler has attached.
+     */
+    private pending;
+    constructor(channelId: string, socket: DuplexSocket, onClose: () => void, streamCredits?: boolean);
+    private sendCredit;
+    write(data: Uint8Array): void;
+    onData(handler: (data: Uint8Array) => void): () => void;
+    /** Deliver inbound bytes to subscribers (buffering until the first attaches). */
+    deliver(data: Uint8Array): void;
+    /** The one close outcome; repeated closes return it. */
+    private closing;
+    close(): Promise<RpcChannelCloseAck>;
+    /** The remote end closed the channel. `pending` is kept so a late first
+     * subscriber still receives bytes that arrived while the channel was open. */
+    remoteClosed(ending?: StreamEnding): void;
+    /** The connection closed before the owner ended the channel; `cause` travels on `ended`. */
+    disconnected(cause?: CaughtFailure): void;
+}
+//# sourceMappingURL=socket-channel.d.ts.map

package/dist/transports/unix/consumer/socket-channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-channel.d.ts","sourceRoot":"","sources":["../../../../src/transports/unix/consumer/socket-channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErE,OAAO,EAA6D,KAAK,kBAAkB,EAAE,MAAM,mDAAmD,CAAC;AAEvJ,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAExF,OAAO,EAA2D,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAEtH,qBACM,aAAc,YAAW,UAAU;IAuBvC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAxBzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyC;IAClE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAoB;IACxC,QAAQ,CAAC,KAAK,gBAAkB;IAChC,iEAAiE;IACjE,OAAO,CAAC,IAAI,CAAQ;IACpB,qEAAqE;IACrE,cAAc,UAAS;IACvB,8FAA8F;IAC9F,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,kDAAkD;IAClD,OAAO,CAAC,QAAQ,CAAS;IACzB;;;;;;;OAOG;IACH,OAAO,CAAC,OAAO,CAA2B;gBAGxB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,MAAM,IAAI,EACpC,aAAa,UAAQ;IAKtB,OAAO,CAAC,UAAU;IAOlB,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAQ7B,MAAM,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,GAAG,MAAM,IAAI;IAiBvD,iFAAiF;IACjF,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAQ/B,wDAAwD;IACxD,OAAO,CAAC,OAAO,CAA4C;IAE3D,KAAK,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAoBpC;kFAC8E;IAC9E,YAAY,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI;IASzC,4FAA4F;IAC5F,YAAY,CAAC,KAAK,CAAC,EAAE,aAAa,GAAG,IAAI;CAIzC"}

package/dist/transports/unix/consumer/socket-channel.js

@@ -0,0 +1,125 @@
+import { RPC_ERROR } from '@vibesdotdev/kernel-rpc';
+import { attempt } from "../../../core/protocol/lifecycle/attempt.js";
+import { channelCloseRefused, closeUnacknowledged, observableClose } from "../../../core/protocol/lifecycle/channel-close.js";
+import { ChannelEnd } from "../../../core/protocol/lifecycle/channel-end.js";
+import { isCreditGrant } from "../../../core/protocol/wire/frame.js";
+import { rpcFailure } from "../../../core/protocol/wire/verbs.js";
+import { encodeStreamClose, encodeStreamCredit, encodeStreamData } from "../codec/socket-codec.js";
+export /** A raw stream channel multiplexed over the socket. */ class SocketChannel {
+    channelId;
+    socket;
+    onClose;
+    handlers = new Set();
+    end = new ChannelEnd();
+    ended = this.end.ended;
+    /** The transport channel is live (neither end has closed it). */
+    open = true;
+    /** The owner opened it credit-governed (its open answer said so). */
+    creditGoverned = false;
+    /** Admit `credits` more DATA frames; only where this connection negotiated stream credits. */
+    grant;
+    /** The consumer discarded the channel locally. */
+    disposed = false;
+    /**
+     * Bytes delivered before the FIRST `onData` handler attaches. The channel is
+     * registered before the `stream` response is awaited (so the owner's first
+     * frames are never dropped on the wire), but the consumer only attaches its
+     * handler after `openStream` resolves — any DATA frame in that window buffers
+     * here and is flushed, in order, on the first attach. Mirrors the http owner
+     * side's `OwnerChannel.pending`. `null` once a handler has attached.
+     */
+    pending = [];
+    constructor(channelId, socket, onClose, streamCredits = false) {
+        this.channelId = channelId;
+        this.socket = socket;
+        this.onClose = onClose;
+        if (streamCredits)
+            this.grant = (credits) => this.sendCredit(credits);
+    }
+    sendCredit(credits) {
+        if (!this.open)
+            return;
+        if (!isCreditGrant(credits))
+            throw rpcFailure(RPC_ERROR.NO_CHANNEL, 'A grant must be 1..1024 credits.', undefined, 'rpc-stream-credit-overflow');
+        const written = attempt(() => this.socket.write(encodeStreamCredit(this.channelId, credits)));
+        if (!written.ok)
+            this.disconnected(written.failure);
+    }
+    write(data) {
+        if (!this.open)
+            return;
+        // A socket that refuses the write is dead: the channel disconnects, and
+        // `ended` rejects carrying why.
+        const written = attempt(() => this.socket.write(encodeStreamData(this.channelId, data)));
+        if (!written.ok)
+            this.disconnected(written.failure);
+    }
+    onData(handler) {
+        if (this.disposed)
+            return () => { };
+        // First subscriber: flush whatever arrived before it attached, in order.
+        // This runs even after a remote close — bytes received while the channel
+        // was open are never lost to the attach race.
+        if (this.pending) {
+            const buffered = this.pending;
+            this.pending = null;
+            for (const data of buffered)
+                handler(data);
+            this.end.flushed();
+        }
+        // An ended channel delivers nothing more: keep no reference to the handler.
+        if (!this.open)
+            return () => { };
+        this.handlers.add(handler);
+        return () => this.handlers.delete(handler);
+    }
+    /** Deliver inbound bytes to subscribers (buffering until the first attaches). */
+    deliver(data) {
+        if (this.pending) {
+            this.pending.push(data);
+            return;
+        }
+        for (const h of this.handlers)
+            h(data);
+    }
+    /** The one close outcome; repeated closes return it. */
+    closing = null;
+    close() {
+        // A LOCAL close always discards and settles, even after the owner ended the
+        // channel; only a still-open transport channel gets an outbound CLOSE.
+        if (this.closing)
+            return this.closing;
+        this.disposed = true;
+        // The CLOSE frame has no answer on this transport.
+        this.closing = Promise.resolve(closeUnacknowledged(this.open ? 'unacknowledged-transport' : 'already-ended'));
+        if (this.open) {
+            this.open = false;
+            const written = attempt(() => this.socket.write(encodeStreamClose(this.channelId)));
+            // The CLOSE never left: the close is refused, typed, never read as sent.
+            if (!written.ok)
+                this.closing = observableClose(Promise.reject(channelCloseRefused(this.channelId, { cause: written.failure })));
+            this.onClose();
+        }
+        this.handlers.clear();
+        this.pending = null;
+        this.end.closedLocally();
+        return this.closing;
+    }
+    /** The remote end closed the channel. `pending` is kept so a late first
+     * subscriber still receives bytes that arrived while the channel was open. */
+    remoteClosed(ending) {
+        if (!this.open)
+            return;
+        this.open = false;
+        // Every byte before the CLOSE frame was dispatched first, in order.
+        this.end.remoteEnded(!this.pending?.length, ending);
+        this.handlers.clear();
+        this.onClose();
+    }
+    /** The connection closed before the owner ended the channel; `cause` travels on `ended`. */
+    disconnected(cause) {
+        this.end.disconnected(cause);
+        this.remoteClosed();
+    }
+}
+//# sourceMappingURL=socket-channel.js.map

package/dist/transports/unix/consumer/socket-channel.js.map

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

package/dist/transports/unix/consumer/socket-connection.d.ts

@@ -0,0 +1,42 @@
+import { type CaughtFailure } from '@vibesdotdev/kernel';
+import { type ConsumerTransport, type RefId, type RpcChannel, type RpcInvoke, type RpcRequest, type RpcResponse } from '@vibesdotdev/kernel-rpc';
+import { RecordParser, type DuplexSocket } from '../codec/socket-codec.ts';
+/** A connected socket peer the consumer talks through. */
+export declare class SocketConnection {
+    readonly rootRef: string;
+    readonly streamCredits: boolean;
+    private socket;
+    private readonly pending;
+    private readonly channels;
+    private closedFlag;
+    private readonly completion;
+    readonly closed: Promise<void>;
+    readonly parser: RecordParser;
+    /**
+     * @param rootRef the remote root object id (advertised by the listen side at connect).
+     * @param streamCredits this connection opted in to the owner's advertised stream credits.
+     */
+    constructor(rootRef: string, streamCredits?: boolean);
+    /** Bind the underlying socket once connected. */
+    attach(socket: DuplexSocket): void;
+    /** Feed raw inbound bytes (called from the socket's `data` handler). */
+    feed(chunk: Uint8Array): void;
+    /** Owner→consumer callback handler, registered by `wireConsumer` through {@link toConsumerTransport}. */
+    private requestHandler;
+    /** Register the owner→consumer request handler (the reverse leg). */
+    setRequestHandler(handler: (req: RpcInvoke) => Promise<RpcResponse>): void;
+    private onRecord;
+    /** Dispatch and answer owner callbacks through the consumer table, keeping the reverse leg symmetric. */
+    private handleOwnerRequest;
+    send(req: RpcRequest): Promise<RpcResponse>;
+    openStream(ref: RefId, channelName: string): Promise<RpcChannel>;
+    /** Close pending calls and channels. Owned releases settle as disconnected; failures reject and remain available through {@link closeFailure}. */
+    close(cause?: CaughtFailure): void;
+    /** The connection's kept teardown failure, if its close (or a fail-closed) had one. */
+    private teardownFailure;
+    /** Take the kept teardown failure once: the holder's close reports it. */
+    closeFailure(): Error | null;
+    /** Adapt to the {@link ConsumerTransport} `wireConsumer` consumes. */
+    toConsumerTransport(): ConsumerTransport;
+}
+//# sourceMappingURL=socket-connection.d.ts.map

package/dist/transports/unix/consumer/socket-connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-connection.d.ts","sourceRoot":"","sources":["../../../../src/transports/unix/consumer/socket-connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAiC,KAAK,iBAAiB,EAAE,KAAK,KAAK,EAAE,KAAK,UAAU,EAAiB,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAK/L,OAAO,EAAE,YAAY,EAAwD,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAajI,0DAA0D;AAC1D,qBAAa,gBAAgB;IAahB,QAAQ,CAAC,OAAO,EAAE,MAAM;IAAE,QAAQ,CAAC,aAAa;IAZ5D,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6H;IACrJ,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;IAC7D,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiC;IAC5D,QAAQ,CAAC,MAAM,gBAA2B;IAC1C,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAE9B;;;OAGG;gBACkB,OAAO,EAAE,MAAM,EAAW,aAAa,UAAQ;IAIpE,iDAAiD;IACjD,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAIlC,wEAAwE;IACxE,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAM7B,yGAAyG;IACzG,OAAO,CAAC,cAAc,CAA2D;IAEjF,qEAAqE;IACrE,iBAAiB,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,SAAS,KAAK,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI;IAI1E,OAAO,CAAC,QAAQ;IAgDhB,yGAAyG;IACzG,OAAO,CAAC,kBAAkB;IAyB1B,IAAI,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;IAoBrC,UAAU,CAAC,GAAG,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAiBtE,kJAAkJ;IAClJ,KAAK,CAAC,KAAK,CAAC,EAAE,aAAa,GAAG,IAAI;IAuBlC,uFAAuF;IACvF,OAAO,CAAC,eAAe,CAAsB;IAE7C,0EAA0E;IAC1E,YAAY,IAAI,KAAK,GAAG,IAAI;IAM5B,sEAAsE;IACtE,mBAAmB,IAAI,iBAAiB;CASxC"}