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

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

@@ -0,0 +1,221 @@
+import { isCapabilityError } from '@vibesdotdev/kernel';
+import { RPC_ERROR, isInvoke, rpcError } from '@vibesdotdev/kernel-rpc';
+import { attempt, settled } from "../../../core/protocol/lifecycle/attempt.js";
+import { connectionCloseFailure } from "../../../core/protocol/lifecycle/binding-close.js";
+import { isCreditGovernedOpen } from "../../../core/protocol/references/dispatch.js";
+import { failureMessage, rpcFailure, toRpcError } from "../../../core/protocol/wire/verbs.js";
+import { RecordParser, encodeMessage, exceedsRecordCeiling, messageTooLarge } from "../codec/socket-codec.js";
+import { SocketChannel } from "./socket-channel.js";
+/**
+ * The failure a call still pending at the connection's close rejects with: an Error (never a bare envelope, which
+ * renders as `[object Object]`), carrying the reason and the cause that ended the connection when it had one.
+ */
+function disconnected(cause) {
+    if (cause === undefined)
+        return rpcFailure(RPC_ERROR.DISCONNECTED, 'connection closed');
+    const reason = isCapabilityError(cause) ? cause.reason : undefined;
+    return Object.assign(rpcFailure(RPC_ERROR.DISCONNECTED, `connection closed: ${failureMessage(cause)}`, undefined, reason), { cause });
+}
+/** A connected socket peer the consumer talks through. */
+export class SocketConnection {
+    rootRef;
+    streamCredits;
+    socket = null;
+    pending = new Map();
+    channels = new Map();
+    closedFlag = false;
+    completion = Promise.withResolvers();
+    closed = this.completion.promise;
+    parser;
+    /**
+     * @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, streamCredits = false) {
+        this.rootRef = rootRef;
+        this.streamCredits = streamCredits;
+        this.parser = new RecordParser((record) => this.onRecord(record), () => false, () => this.streamCredits);
+    }
+    /** Bind the underlying socket once connected. */
+    attach(socket) {
+        this.socket = socket;
+    }
+    /** Feed raw inbound bytes (called from the socket's `data` handler). */
+    feed(chunk) {
+        if (this.closedFlag)
+            return;
+        const pushed = attempt(() => this.parser.push(chunk));
+        if (!pushed.ok)
+            this.close(pushed.failure);
+    }
+    /** Owner→consumer callback handler, registered by `wireConsumer` through {@link toConsumerTransport}. */
+    requestHandler = null;
+    /** Register the owner→consumer request handler (the reverse leg). */
+    setRequestHandler(handler) {
+        this.requestHandler = handler;
+    }
+    onRecord(record) {
+        if (record.kind === 'msg') {
+            const message = record.message;
+            if ('attest' in message) {
+                this.close(rpcFailure(RPC_ERROR.DISCONNECTED, 'Invalid owner attestation record.', undefined, 'rpc-frame-invalid'));
+                return;
+            }
+            // A wire opt-in is a client's record; an owner never sends one.
+            if ('wire' in message) {
+                this.close(rpcFailure(RPC_ERROR.DISCONNECTED, 'Invalid owner wire record.', undefined, 'rpc-frame-invalid'));
+                return;
+            }
+            // An OWNER-initiated request (it carries a verb; responses never do):
+            // the owner is invoking a consumer-owned callback ref back across the
+            // socket. Route it into the registered handler — without this, a
+            // callback arg would cross the wire and then silently vanish.
+            if ('verb' in message) {
+                this.handleOwnerRequest(message);
+                return;
+            }
+            // The owner refused this client's attestation (a malformed declared
+            // identity): the connection is over, and its close reports why, typed.
+            if (message.id === 'attest' && message.error) {
+                const { code, message: text, details, reason } = message.error;
+                this.teardownFailure = rpcFailure(code, text, details, reason);
+                this.close();
+                return;
+            }
+            const waiter = this.pending.get(message.id);
+            if (waiter) {
+                this.pending.delete(message.id);
+                waiter.resolve(message);
+            }
+            else if (this.pending.size > 0) {
+                this.close(rpcFailure(RPC_ERROR.DISCONNECTED, 'Uncorrelated RPC response.', undefined, 'rpc-response-invalid'));
+            }
+            return;
+        }
+        // An owner never grants credit: only the consumer admits DATA.
+        if (record.kind === 'stream-credit') {
+            this.close(rpcFailure(RPC_ERROR.DISCONNECTED, 'Invalid owner credit record.', undefined, 'rpc-frame-invalid'));
+            return;
+        }
+        const channel = this.channels.get(record.channelId);
+        if (!channel)
+            return;
+        if (record.kind === 'stream-data')
+            channel.deliver(record.payload);
+        else
+            channel.remoteClosed(record.ending);
+    }
+    /** Dispatch and answer owner callbacks through the consumer table, keeping the reverse leg symmetric. */
+    handleOwnerRequest(req) {
+        // Only `invoke` crosses owner→consumer (release/stream target owner refs).
+        if (!isInvoke(req))
+            return;
+        const respond = (res) => {
+            if (this.closedFlag)
+                return;
+            // An answer past the owner's record ceiling is refused typed, not sent to end the connection.
+            const encoded = encodeMessage(res);
+            const record = exceedsRecordCeiling(encoded) ? encodeMessage({ id: req.id, error: toRpcError(messageTooLarge()) }) : encoded;
+            // A socket that refuses a write is dead: fail the connection closed,
+            // keeping why for its close outcome.
+            const written = attempt(() => this.socket?.write(record));
+            if (!written.ok)
+                this.close(written.failure);
+        };
+        const handler = this.requestHandler;
+        if (!handler) {
+            respond({ id: req.id, error: rpcError(RPC_ERROR.NO_TARGET, 'no consumer request handler wired') });
+            return;
+        }
+        void settled(handler(req)).then((answer) => respond(answer.ok
+            ? answer.value
+            : { id: req.id, error: rpcError(RPC_ERROR.INVOKE_FAILED, failureMessage(answer.failure)) }));
+    }
+    send(req) {
+        if (this.closedFlag || !this.socket) {
+            return Promise.resolve({ id: req.id, error: rpcError(RPC_ERROR.DISCONNECTED, 'connection closed') });
+        }
+        if (this.pending.has(req.id)) {
+            return Promise.reject(rpcFailure(RPC_ERROR.INVOKE_FAILED, 'RPC request ID is already pending.', undefined, 'rpc-request-duplicate'));
+        }
+        const record = encodeMessage(req);
+        // A request past the owner's record ceiling is refused here, typed: sent, its header would end the connection.
+        if (exceedsRecordCeiling(record))
+            return Promise.reject(messageTooLarge());
+        return new Promise((resolve, reject) => {
+            this.pending.set(req.id, { verb: req.verb, resolve, reject });
+            const written = attempt(() => this.socket.write(record));
+            if (!written.ok) {
+                this.pending.delete(req.id);
+                reject(req.verb === 'release' ? written.failure : rpcError(RPC_ERROR.DISCONNECTED, failureMessage(written.failure)));
+            }
+        });
+    }
+    async openStream(ref, channelName) {
+        if (this.closedFlag || !this.socket)
+            throw rpcError(RPC_ERROR.DISCONNECTED, 'connection closed');
+        // The `stream` verb opens the channel on the owner; the request `id` IS the
+        // channelId both ends tag their frames with. Register the channel BEFORE
+        // awaiting the response so the owner's first frames are never dropped.
+        const channelId = crypto.randomUUID();
+        const channel = new SocketChannel(channelId, this.socket, () => this.channels.delete(channelId), this.streamCredits);
+        this.channels.set(channelId, channel);
+        const res = await this.send({ verb: 'stream', id: channelId, ref, channel: channelName });
+        if (res.error) {
+            this.channels.delete(channelId);
+            throw rpcError(res.error.code, res.error.message, undefined, res.error.reason);
+        }
+        if (isCreditGovernedOpen(res))
+            channel.creditGoverned = true;
+        return channel;
+    }
+    /** Close pending calls and channels. Owned releases settle as disconnected; failures reject and remain available through {@link closeFailure}. */
+    close(cause) {
+        if (this.closedFlag)
+            return;
+        this.closedFlag = true;
+        if (cause !== undefined)
+            this.teardownFailure = connectionCloseFailure(this.rootRef, cause);
+        for (const [id, waiter] of this.pending) {
+            if (waiter.verb === 'release') {
+                if (cause === undefined)
+                    waiter.resolve({ id, error: rpcError(RPC_ERROR.DISCONNECTED, 'connection closed') });
+                else
+                    waiter.reject(cause);
+            }
+            else
+                waiter.reject(disconnected(cause));
+        }
+        this.pending.clear();
+        for (const channel of this.channels.values())
+            channel.disconnected();
+        this.channels.clear();
+        const ended = attempt(() => this.socket?.end());
+        if (!ended.ok) {
+            const refusedEnd = connectionCloseFailure(this.rootRef, ended.failure);
+            this.teardownFailure = this.teardownFailure
+                ? connectionCloseFailure(this.rootRef, new AggregateError([this.teardownFailure, refusedEnd], 'The socket failure and native end both failed.'))
+                : refusedEnd;
+        }
+        this.completion.resolve();
+    }
+    /** The connection's kept teardown failure, if its close (or a fail-closed) had one. */
+    teardownFailure = null;
+    /** Take the kept teardown failure once: the holder's close reports it. */
+    closeFailure() {
+        const failure = this.teardownFailure;
+        this.teardownFailure = null;
+        return failure;
+    }
+    /** Adapt to the {@link ConsumerTransport} `wireConsumer` consumes. */
+    toConsumerTransport() {
+        return {
+            rootRef: this.rootRef,
+            send: (req) => this.send(req),
+            openStream: (ref, channel) => this.openStream(ref, channel),
+            closed: this.closed,
+            onRequest: (handler) => this.setRequestHandler(handler)
+        };
+    }
+}
+//# sourceMappingURL=socket-connection.js.map

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

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

package/dist/transports/unix/descriptors/unix.rpc.descriptor.d.ts

@@ -0,0 +1,17 @@
+export { UnixDescriptorInput } from "../../../schemas/contracts/transports/unix/descriptors/unix.rpc.descriptor.ts";
+/**
+ * The local-daemon unix `runtime/rpc` descriptor.
+ *
+ * Discovery is REGISTRATION (acceptance criterion #5): reaching the local daemon
+ * is a registered `runtime/rpc` descriptor the L1 resolver walks — never a client
+ * `discover()` method. The socket path mirrors the daemon's convention
+ * (`~/.vibes/pm/sock/vibes-runtime-{workspace}.sock`); the bootstrap layer may
+ * override `target.socketPath`.
+ */
+import { type RuntimeRpcDescriptor } from '../../../core/kinds/rpc.kind.ts';
+/** Default local-daemon unix descriptor id. */
+export declare const LOCAL_DAEMON_RPC_ID = "local-daemon";
+/** Build a unix `runtime/rpc` descriptor for a socket path. */
+export declare function createUnixRpcDescriptor(socketPath: string, id?: string): RuntimeRpcDescriptor;
+export default createUnixRpcDescriptor;
+//# sourceMappingURL=unix.rpc.descriptor.d.ts.map

package/dist/transports/unix/descriptors/unix.rpc.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unix.rpc.descriptor.d.ts","sourceRoot":"","sources":["../../../../src/transports/unix/descriptors/unix.rpc.descriptor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,+EAA+E,CAAC;AACpH;;;;;;;;GAQG;AAEH,OAAO,EAA8B,KAAK,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAGxG,+CAA+C;AAC/C,eAAO,MAAM,mBAAmB,iBAAiB,CAAC;AAElD,+DAA+D;AAC/D,wBAAgB,uBAAuB,CACtC,UAAU,EAAE,MAAM,EAClB,EAAE,GAAE,MAA4B,GAC9B,oBAAoB,CAYtB;AAED,eAAe,uBAAuB,CAAC"}

package/dist/transports/unix/descriptors/unix.rpc.descriptor.js

@@ -0,0 +1,31 @@
+import { UnixDescriptorInput } from "../../../schemas/contracts/transports/unix/descriptors/unix.rpc.descriptor.js";
+export { UnixDescriptorInput } from "../../../schemas/contracts/transports/unix/descriptors/unix.rpc.descriptor.js";
+/**
+ * The local-daemon unix `runtime/rpc` descriptor.
+ *
+ * Discovery is REGISTRATION (acceptance criterion #5): reaching the local daemon
+ * is a registered `runtime/rpc` descriptor the L1 resolver walks — never a client
+ * `discover()` method. The socket path mirrors the daemon's convention
+ * (`~/.vibes/pm/sock/vibes-runtime-{workspace}.sock`); the bootstrap layer may
+ * override `target.socketPath`.
+ */
+import { RuntimeRpcDescriptorSchema } from "../../../core/kinds/rpc.kind.js";
+import { readInput } from "../../../core/protocol/references/caller-input.js";
+/** Default local-daemon unix descriptor id. */
+export const LOCAL_DAEMON_RPC_ID = 'local-daemon';
+/** Build a unix `runtime/rpc` descriptor for a socket path. */
+export function createUnixRpcDescriptor(socketPath, id = LOCAL_DAEMON_RPC_ID) {
+    const input = readInput('createUnixRpcDescriptor', UnixDescriptorInput, { socketPath, id });
+    return readInput('createUnixRpcDescriptor', RuntimeRpcDescriptorSchema, {
+        id: input.id,
+        kind: 'runtime/rpc',
+        name: 'Local runtime daemon (unix)',
+        description: 'The local vibes runtime, reachable over a unix socket via the three-verb RPC protocol.',
+        enabled: true,
+        transport: 'unix',
+        target: { transport: 'unix', socketPath: input.socketPath },
+        remoteScope: { hardware: 'consumer' }
+    });
+}
+export default createUnixRpcDescriptor;
+//# sourceMappingURL=unix.rpc.descriptor.js.map

package/dist/transports/unix/descriptors/unix.rpc.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unix.rpc.descriptor.js","sourceRoot":"","sources":["../../../../src/transports/unix/descriptors/unix.rpc.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,+EAA+E,CAAC;AACpH,OAAO,EAAE,mBAAmB,EAAE,MAAM,+EAA+E,CAAC;AACpH;;;;;;;;GAQG;AAEH,OAAO,EAAE,0BAA0B,EAA6B,MAAM,iCAAiC,CAAC;AACxG,OAAO,EAAE,SAAS,EAAE,MAAM,mDAAmD,CAAC;AAE9E,+CAA+C;AAC/C,MAAM,CAAC,MAAM,mBAAmB,GAAG,cAAc,CAAC;AAElD,+DAA+D;AAC/D,MAAM,UAAU,uBAAuB,CACtC,UAAkB,EAClB,KAAa,mBAAmB;IAEhC,MAAM,KAAK,GAAG,SAAS,CAAC,yBAAyB,EAAE,mBAAmB,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;IAC5F,OAAO,SAAS,CAAC,yBAAyB,EAAE,0BAA0B,EAAE;QACvE,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,6BAA6B;QACnC,WAAW,EAAE,wFAAwF;QACrG,OAAO,EAAE,IAAI;QACb,SAAS,EAAE,MAAM;QACjB,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE;QAC3D,WAAW,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE;KACrC,CAAC,CAAC;AACJ,CAAC;AAED,eAAe,uBAAuB,CAAC"}

package/dist/transports/unix/in-process/in-process-channel.d.ts

@@ -0,0 +1,11 @@
+import { type CapabilityError, type CaughtFailure } from '@vibesdotdev/kernel';
+import { type RpcChannel, type StreamBinding } from '@vibesdotdev/kernel-rpc';
+export declare function makeInProcessChannel(binding: StreamBinding, live: Set<{
+    close(): void;
+    disconnected(): void;
+}>, 
+/** Close the owner binding now; resolves to its typed failure (also kept for the connection's close). */
+closeBinding: () => Promise<CapabilityError | null>, 
+/** Keep a failure outside the binding's close (an unsubscribe that threw) for the connection's close. */
+keepFailure: (cause: CaughtFailure) => void): RpcChannel;
+//# sourceMappingURL=in-process-channel.d.ts.map

package/dist/transports/unix/in-process/in-process-channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-process-channel.d.ts","sourceRoot":"","sources":["../../../../src/transports/unix/in-process/in-process-channel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAa,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAOzF,wBACS,oBAAoB,CAC5B,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,GAAG,CAAC;IAAE,KAAK,IAAI,IAAI,CAAC;IAAC,YAAY,IAAI,IAAI,CAAA;CAAE,CAAC;AAClD,yGAAyG;AACzG,YAAY,EAAE,MAAM,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;AACnD,yGAAyG;AACzG,WAAW,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GACzC,UAAU,CAqGZ"}

package/dist/transports/unix/in-process/in-process-channel.js

@@ -0,0 +1,126 @@
+import {} from '@vibesdotdev/kernel';
+import { RPC_ERROR } from '@vibesdotdev/kernel-rpc';
+import { attempt } from "../../../core/protocol/lifecycle/attempt.js";
+import { CLOSE_ACKNOWLEDGED, 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";
+export /** Wrap an owner {@link StreamBinding} into a consumer {@link RpcChannel}, pumping bytes directly. */ function makeInProcessChannel(binding, live, 
+/** Close the owner binding now; resolves to its typed failure (also kept for the connection's close). */
+closeBinding, 
+/** Keep a failure outside the binding's close (an unsubscribe that threw) for the connection's close. */
+keepFailure) {
+    /** The one close outcome; repeated closes return it. */
+    let closing = null;
+    const handlers = new Set();
+    const end = new ChannelEnd();
+    // Bytes the owner emits before the FIRST consumer handler attaches buffer here
+    // and flush, in order, on attach — an owner emitting synchronously on subscribe
+    // must not lose its first chunk(s). `null` once a handler has attached.
+    let pending = [];
+    const unsub = binding.onData((data) => {
+        if (pending) {
+            pending.push(data);
+            return;
+        }
+        for (const h of handlers)
+            h(data);
+    });
+    /** The channel is live (neither end has closed it). */
+    let open = true;
+    /** The consumer discarded the channel locally. */
+    let disposed = false;
+    // The owner's end: every byte before it was dispatched above, in order.
+    const unsubEnd = binding.onEnd?.((ending) => {
+        if (!open)
+            return;
+        open = false;
+        const released = attempt(() => unsub());
+        if (!released.ok)
+            keepFailure(released.failure);
+        handlers.clear();
+        live.delete(channel);
+        end.remoteEnded(!pending?.length, ending);
+    });
+    const demand = binding.demand?.bind(binding);
+    const channel = {
+        ended: end.ended,
+        creditGoverned: demand !== undefined,
+        grant(credits) {
+            if (!open)
+                return;
+            if (!isCreditGrant(credits))
+                throw rpcFailure(RPC_ERROR.NO_CHANNEL, 'A grant must be 1..1024 credits.', undefined, 'rpc-stream-credit-overflow');
+            demand?.(credits);
+        },
+        write(data) {
+            if (!open)
+                return;
+            binding.write(data);
+        },
+        onData(handler) {
+            if (disposed)
+                return () => { };
+            if (pending) {
+                const buffered = pending;
+                pending = null;
+                for (const data of buffered)
+                    handler(data);
+                end.flushed();
+            }
+            // An ended channel delivers nothing more: keep no reference to the handler.
+            if (!open)
+                return () => { };
+            handlers.add(handler);
+            return () => handlers.delete(handler);
+        },
+        close() {
+            // A LOCAL close always discards and settles; only a live channel tears the owner down.
+            if (closing)
+                return closing;
+            disposed = true;
+            pending = null;
+            handlers.clear();
+            end.closedLocally();
+            if (!open) {
+                closing = Promise.resolve(closeUnacknowledged('already-ended'));
+                return closing;
+            }
+            open = false;
+            const released = attempt(() => {
+                unsub();
+                unsubEnd?.();
+            });
+            if (!released.ok)
+                keepFailure(released.failure);
+            // Started now; in process the owner's settle is the acknowledgement.
+            closing = observableClose(closeBinding().then((failure) => {
+                if (failure)
+                    throw failure;
+                return CLOSE_ACKNOWLEDGED;
+            }));
+            live.delete(channel);
+            return closing;
+        },
+        /** The connection closed: before the owner's end the output is incomplete. */
+        disconnected() {
+            end.disconnected();
+            if (!open)
+                return;
+            open = false;
+            const released = attempt(() => {
+                unsub();
+                unsubEnd?.();
+            });
+            if (!released.ok)
+                keepFailure(released.failure);
+            // Started now; a failure is kept for the connection's close.
+            void closeBinding();
+            handlers.clear();
+            live.delete(channel);
+        }
+    };
+    live.add(channel);
+    return channel;
+}
+//# sourceMappingURL=in-process-channel.js.map

package/dist/transports/unix/in-process/in-process-channel.js.map

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

package/dist/transports/unix/in-process/in-process.transport.d.ts

@@ -0,0 +1,13 @@
+import { isInvoke, refKindFor, type RefId, type StreamBinding } from '@vibesdotdev/kernel-rpc';
+import type { InProcessConnection, InProcessOptions } from "../../../schemas/contracts/transports/unix/in-process.transport.ts";
+export { InProcessInput } from "../../../schemas/contracts/transports/unix/in-process.transport.ts";
+export type { InProcessConnection, InProcessOptions } from "../../../schemas/contracts/transports/unix/in-process.transport.ts";
+/**
+ * Stand up an in-process connection. The owner retains `root` as ref `'root'`;
+ * the consumer receives that id and builds a root proxy. Every consumer invoke
+ * is dispatched on the owner through the L1 pipeline.
+ */
+export declare function connectInProcess(optionsInput: InProcessOptions): InProcessConnection;
+export { isInvoke, refKindFor };
+export type { RefId, StreamBinding };
+//# sourceMappingURL=in-process.transport.d.ts.map

package/dist/transports/unix/in-process/in-process.transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-process.transport.d.ts","sourceRoot":"","sources":["../../../../src/transports/unix/in-process/in-process.transport.ts"],"names":[],"mappings":"AACA,OAAO,EAA6C,QAAQ,EAAE,UAAU,EAA6F,KAAK,KAAK,EAAsE,KAAK,aAAa,EAAkB,MAAM,yBAAyB,CAAC;AAKzT,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,oEAAoE,CAAC;AAIhI,OAAO,EAAE,cAAc,EAAE,MAAM,oEAAoE,CAAC;AAEpG,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,oEAAoE,CAAC;AAOhI;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,gBAAgB,GAAG,mBAAmB,CA2HpF;AAED,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;AAEhC,YAAY,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC"}

package/dist/transports/unix/in-process/in-process.transport.js

@@ -0,0 +1,119 @@
+import { DefaultReferenceTable } from '@vibesdotdev/kernel';
+import { decodeValue, dispatchRequest, encodeValue, isInvoke, refKindFor, RPC_ERROR, rpcError, wireConsumer } from '@vibesdotdev/kernel-rpc';
+import { BindingCloses } from "../../../core/protocol/lifecycle/binding-close.js";
+import { recordRootAdvertisement } from "../../../core/protocol/references/advertisement.js";
+import { readInput } from "../../../core/protocol/references/caller-input.js";
+import { InProcessInput } from "../../../schemas/contracts/transports/unix/in-process.transport.js";
+import { makeInProcessChannel } from "./in-process-channel.js";
+export { InProcessInput } from "../../../schemas/contracts/transports/unix/in-process.transport.js";
+/**
+ * Stand up an in-process connection. The owner retains `root` as ref `'root'`;
+ * the consumer receives that id and builds a root proxy. Every consumer invoke
+ * is dispatched on the owner through the L1 pipeline.
+ */
+export function connectInProcess(optionsInput) {
+    const options = readInput('connectInProcess', InProcessInput, optionsInput);
+    const ownerTable = new DefaultReferenceTable('owner');
+    const rootRef = ownerTable.retain(options.root, 'object');
+    recordRootAdvertisement(ownerTable, rootRef.id, options.rootMethods);
+    const remotePeer = options.remotePeer ?? {
+        runtimeId: 'in-process',
+        transport: 'in-process',
+        connectionId: crypto.randomUUID()
+    };
+    let closed = false;
+    let resolveClosed = () => { };
+    const closedPromise = new Promise((r) => {
+        resolveClosed = r;
+    });
+    // Live stream channels, so close() can tear them down.
+    const liveChannels = new Set();
+    /** Every binding close this connection started; failures kept typed until its close reports them. */
+    const bindingCloses = new BindingCloses();
+    // Forward declaration: the consumer end's proxy factory + callback dispatch.
+    let consumer;
+    /** Decode wire args into local values, building proxies for any ref the consumer passed. */
+    const decodeArgs = (wire) => wire.map((w) => decodeValue(w, (id, kind, methods, channel) => ownerCallbackProxy(id, kind, methods, channel)));
+    /**
+     * The owner builds a proxy for a CONSUMER-owned ref (a callback the consumer
+     * passed). Invoking it routes BACK to the consumer's callback-dispatch — the
+     * symmetric direction. In-process, that is a direct call into `consumer`.
+     */
+    const ownerCallbackProxy = (id, _kind, _methods) => {
+        return (...args) => {
+            const req = {
+                verb: 'invoke',
+                id: crypto.randomUUID(),
+                targetRef: id,
+                method: 'call',
+                args: args.map((a) => encodeValue(a, ownerTable, () => ({ mode: 'inline' })))
+            };
+            return consumer.dispatchCallback(req).then((res) => {
+                if (res.error)
+                    throw rpcError(res.error.code, res.error.message, res.error.details);
+                return res.result === undefined
+                    ? undefined
+                    : decodeValue(res.result, ownerCallbackProxy);
+            });
+        };
+    };
+    const dispatchDeps = {
+        table: ownerTable,
+        pipeline: options.pipeline,
+        remotePeer,
+        decodeArgs,
+        classifyResult: options.classifyResult,
+        bindChannel: options.bindChannel,
+        kindOf: options.kindOf ?? (() => 'runtime/rpc'),
+        // In process there is no wire to negotiate: a grant reaches the binding directly.
+        streamCredits: true
+    };
+    /** The transport's raw send: dispatch on the owner, return the response. */
+    const send = async (req) => {
+        if (closed) {
+            return { id: req.id, error: rpcError(RPC_ERROR.DISCONNECTED, 'connection closed') };
+        }
+        const { response } = await dispatchRequest(req, dispatchDeps);
+        return response;
+    };
+    /** The transport's openStream: bind the owner channel, pump bytes both ways. */
+    const openStream = async (ref, channel) => {
+        if (closed)
+            throw rpcError(RPC_ERROR.DISCONNECTED, 'connection closed');
+        const channelId = crypto.randomUUID();
+        const { response, binding } = await dispatchRequest({ verb: 'stream', id: channelId, ref, channel }, dispatchDeps);
+        if (response.error)
+            throw rpcError(response.error.code, response.error.message);
+        if (!binding)
+            throw rpcError(RPC_ERROR.NO_CHANNEL, `no binding for channel '${channel}'`);
+        return makeInProcessChannel(binding, liveChannels, () => bindingCloses.close(binding, channelId), (cause) => bindingCloses.keepFailure(channelId, cause));
+    };
+    consumer = wireConsumer({
+        rootRef: rootRef.id,
+        rootMethods: options.rootMethods,
+        send,
+        openStream,
+        closed: closedPromise
+    }, 'consumer');
+    const close = async () => {
+        if (closed)
+            return;
+        closed = true;
+        // `disconnected` keeps its own failures (an unsubscribe that threw) for the drain below.
+        for (const ch of liveChannels)
+            ch.disconnected();
+        liveChannels.clear();
+        resolveClosed();
+        // Every channel is torn down; report any binding that did not close cleanly, typed.
+        await bindingCloses.drain();
+    };
+    return {
+        root: consumer.root,
+        consumer,
+        ownerTable,
+        close,
+        closed: closedPromise
+    };
+}
+export { isInvoke, refKindFor };
+//# sourceMappingURL=in-process.transport.js.map

package/dist/transports/unix/in-process/in-process.transport.js.map

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

package/dist/transports/unix/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @vibesdotdev/kernel-rpc/unix
+ *
+ * The in-process + unix-socket transport for the `runtime/rpc` kind (PHASE 3).
+ *
+ *   - in-process: two connection ends wired directly (no socket) — the substrate
+ *     the no-leak acceptance bar validates against FIRST.
+ *   - unix:       `connect()`/`listen()` over the runtime socket capability
+ *     (`@vibesdotdev/kernel/socket`: a Unix domain socket, or a named pipe on
+ *     Windows), using the shared length-prefixed codec.
+ *
+ * Both run arriving invokes through L1's invoke pipeline (`authz → friction`) via
+ * the protocol's `dispatchRequest`. This is the rebuilt listen side that subsumes
+ * `runtime-surface-daemon`'s hardcoded `POST /rpc` router — built fresh, not
+ * adopted.
+ */
+export { connectInProcess, type InProcessConnection, type InProcessOptions } from './in-process/in-process.transport.ts';
+export { connectUnix, createUnixRpcImplementation, listenUnix, type ListenTarget, type RpcSocketRuntime, type UnixListener } from './unix-transport.impl.ts';
+export { BackpressureWriter, REC, RecordParser, encodeMessage, encodeStreamClose, encodeStreamData, wrapNodeSocket, type DecodedRecord, type DuplexSocket, type RecordKind } from './codec/socket-codec.ts';
+export { SocketConnection } from './consumer/socket-connection.ts';
+export { RPC_CONNECTION_CLOSED, SocketListenerSession, type ConnectionRootFactory, type RpcListenConnection } from './listener/socket-listener.ts';
+export { dialSocketSession, type SocketHandshake, type SocketHandshakeFailures } from './socket-handshake.ts';
+export { LOCAL_DAEMON_RPC_ID, createUnixRpcDescriptor } from './descriptors/unix.rpc.descriptor.ts';
+export { createRuntimeRpcUnixPlugin, default, runtimeRpcUnixPlugin, type RuntimeRpcUnixPluginOptions } from './runtime-rpc-unix.plugin.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/transports/unix/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/transports/unix/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EACP,gBAAgB,EAAE,KAAK,mBAAmB,EAC1C,KAAK,gBAAgB,EACpB,MAAM,sCAAsC,CAAC;AAG9C,OAAO,EACP,WAAW,EAAE,2BAA2B,EAAE,UAAU,EAAE,KAAK,YAAY,EACvE,KAAK,gBAAgB,EAAE,KAAK,YAAY,EACvC,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACP,kBAAkB,EAAE,GAAG,EAAE,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,cAAc,EAAE,KAAK,aAAa,EAC7H,KAAK,YAAY,EAAE,KAAK,UAAU,EACjC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EACP,qBAAqB,EAAE,qBAAqB,EAAE,KAAK,qBAAqB,EACxE,KAAK,mBAAmB,EACvB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACP,iBAAiB,EACjB,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAC3B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACP,mBAAmB,EACnB,uBAAuB,EACtB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACP,0BAA0B,EAAE,OAAO,EAAE,oBAAoB,EACzD,KAAK,2BAA2B,EAC/B,MAAM,8BAA8B,CAAC"}