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

package/dist/core/protocol/references/consumer.js

@@ -0,0 +1,134 @@
+/**
+ * Consumer-side connection wiring — turns a transport's {@link RpcConnection}
+ * into a usable remote-root proxy, with a symmetric reference table.
+ *
+ * The transport gives us a raw `send(req) → response` and `openStream`. This
+ * module owns the consumer-side reference table (its `idPrefix` namespaces the
+ * consumer end so the two ends of a connection never collide on ref ids) and the
+ * decode path: a response/arg that is a ref becomes a {@link makeRemoteProxy}.
+ *
+ * Symmetry: when the consumer passes a CALLBACK as an arg, the consumer becomes
+ * the owner of that callback ref — so the consumer's `send` must ENCODE args
+ * (retaining callbacks in the consumer table) and must DISPATCH arriving invokes
+ * the owner makes back into those callbacks. That callback-dispatch loop is wired
+ * here too, so a remote `onData` handler the owner invokes lands on the local fn.
+ */
+import { DefaultReferenceTable } from '@vibesdotdev/kernel';
+import { attempt, attemptAsync } from "../lifecycle/attempt.js";
+import { LegFailures } from "../lifecycle/binding-close.js";
+import { isFunction } from "../wire/value-kinds.js";
+import { isInvoke, RPC_ERROR, rpcError, throwWireError, toRpcError } from "../wire/verbs.js";
+import { asRefId, decodeValue, encodeArgs, encodeValue } from "../wire/wire-value.js";
+import { admitsMethod, advertisementOf } from "./advertisement.js";
+import { isDisposed, makeRemoteProxy, RUNTIME_ROOT_METHODS, validateRootMethods } from "./ref-table.js";
+/** A callback passed as an arg is referenceable; plain data is inline. */
+const callbackClassifier = (value) => isFunction(value)
+    ? { mode: 'ref', kind: 'function', methods: ['call'] }
+    : { mode: 'inline' };
+/**
+ * Wire a consumer end onto a transport. Returns the remote-root proxy plus the
+ * consumer table and a callback-dispatch entry point the transport calls when the
+ * owner invokes a consumer-owned ref.
+ */
+export function wireConsumer(transport, idPrefix = 'consumer') {
+    // A `release` is fire-and-forget: the owner frees its entry, no reply is awaited.
+    // A release that could not be sent is kept typed for the holder's close
+    // (`settleReleases`), never an unhandled rejection and never dropped. An error
+    // *answer* (the ref is gone, the connection closed) is already-released.
+    const releases = new LegFailures(idPrefix);
+    const fireRelease = (refId) => {
+        const sent = attempt(() => transport.send({ verb: 'release', id: crypto.randomUUID(), ref: asRefId(refId) }));
+        if (!sent.ok) {
+            releases.keep('release', sent.failure);
+            return;
+        }
+        releases.track('release', Promise.resolve(sent.value).then(response => {
+            if (response.error && response.error.code !== RPC_ERROR.NO_TARGET && response.error.code !== RPC_ERROR.DISCONNECTED) {
+                throwWireError(response.error);
+            }
+        }));
+    };
+    const table = new DefaultReferenceTable(idPrefix, (refId) => {
+        // A consumer-owned proxy was GC'd without disposal: tell the owner to release.
+        fireRelease(refId);
+    });
+    // The connection owns callback refs even when its peer ends the transport.
+    void transport.closed.then(() => table.clear());
+    // Disposing a consumer-owned proxy (or releasing a remote ref) sends `release`.
+    table.setReleaseSink({
+        releaseRemote: (refId) => fireRelease(refId)
+    });
+    // A response's result, decoded: a ref becomes a proxy built by `makeProxy`.
+    function decode(res) {
+        if (res.error)
+            throwWireError(res.error);
+        if (res.result === undefined)
+            return undefined;
+        return decodeValue(res.result, makeProxy);
+    }
+    // `send` ENCODES args: a callback arg is retained in the consumer table and sent
+    // as a ref, so the owner can invoke it back. Plain data is inlined.
+    const send = (req) => {
+        if (req.verb === 'invoke') {
+            const wireReq = { ...req, args: encodeArgs(req.args, table, callbackClassifier) };
+            return transport.send(transport.caller && req.caller === undefined ? { ...wireReq, caller: transport.caller } : wireReq);
+        }
+        return transport.send(req);
+    };
+    const openStream = (ref, channel) => transport.openStream(ref, channel);
+    // Disposing/GC'ing a consumer-side proxy must tell the OWNER to free its entry.
+    const releaseRef = (refId) => fireRelease(refId);
+    const proxyDeps = { table, send, openStream, decode, nextId: () => crypto.randomUUID(), releaseRef };
+    function makeProxy(id, kind, methods, streamChannel, channels) {
+        return makeRemoteProxy(id, kind, methods, proxyDeps, streamChannel, 'absent', channels);
+    }
+    // The root is closed to its declared contract: the runtime root API unless
+    // the transport names another root's methods.
+    const rootMethods = validateRootMethods(transport.rootMethods ?? RUNTIME_ROOT_METHODS);
+    const root = makeRemoteProxy(asRefId(transport.rootRef), 'object', rootMethods, proxyDeps, undefined, 'refused');
+    // When the OWNER invokes a consumer-owned callback ref, the transport routes it
+    // here. We deref the local callback and apply the decoded args.
+    const dispatchCallback = async (req) => {
+        if (!isInvoke(req)) {
+            return { id: req.id, error: rpcError(RPC_ERROR.INVOKE_FAILED, 'not an invoke') };
+        }
+        const fn = table.deref(req.targetRef);
+        if (!isFunction(fn)) {
+            return { id: req.id, error: rpcError(RPC_ERROR.NO_TARGET, `No callback for ref '${req.targetRef}'`) };
+        }
+        // The same admission as forward dispatch: a retained callback advertised
+        // only `call`; any other method is refused and the callback never runs.
+        if (!admitsMethod(advertisementOf(table, req.targetRef), req.method)) {
+            return {
+                id: req.id,
+                error: rpcError(RPC_ERROR.NOT_ADVERTISED, `Method '${req.method}' is not advertised for callback '${req.targetRef}'`)
+            };
+        }
+        const args = req.args.map((w) => decodeValue(w, makeProxy));
+        const outcome = await attemptAsync(async () => encodeValue(await fn(...args), table, callbackClassifier));
+        if (!outcome.ok)
+            return { id: req.id, error: toRpcError(outcome.failure) };
+        return { id: req.id, result: outcome.value };
+    };
+    // Wire the reverse leg: when the transport can route owner-initiated requests
+    // (the owner invoking a consumer-owned callback ref), they land here. A
+    // transport without a reverse leg simply never delivers such a request.
+    transport.onRequest?.(dispatchCallback);
+    const invokeRoot = async (method, args) => {
+        if (isDisposed(root))
+            throw rpcError(RPC_ERROR.DISCONNECTED, 'The remote root is disposed.');
+        if (!rootMethods.includes(method)) {
+            throw rpcError(RPC_ERROR.NOT_ADVERTISED, 'The remote root does not advertise this method.');
+        }
+        const request = {
+            verb: 'invoke', id: crypto.randomUUID(), targetRef: asRefId(transport.rootRef), method,
+            args: encodeArgs(args, table, callbackClassifier)
+        };
+        return await transport.send(transport.caller ? { ...request, caller: transport.caller } : request);
+    };
+    const releaseRoot = () => {
+        root[Symbol.dispose]();
+    };
+    return { root, table, makeProxy, invokeRoot, releaseRoot, dispatchCallback, settleReleases: () => releases.settle() };
+}
+//# sourceMappingURL=consumer.js.map

package/dist/core/protocol/references/consumer.js.map

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

package/dist/core/protocol/references/descriptor-input.d.ts

@@ -0,0 +1,15 @@
+import type { RpcDescriptorFor } from "../../../schemas/contracts/protocol/references/descriptor-input.ts";
+export type { RpcDescriptorFor } from "../../../schemas/contracts/protocol/references/descriptor-input.ts";
+/**
+ * A `runtime/rpc` descriptor handed to a transport's implementation factory or loader registration, read once
+ * (class checklist 1): parsed by `RuntimeRpcDescriptorSchema` into a snapshot through {@link readInput}, so a hostile
+ * descriptor (a throwing getter, a Proxy or a revoked one, a wrong-typed field) is refused `INVALID_INPUT`
+ * `rpc-input-invalid` naming the entry and issue paths only. A descriptor for another transport is refused the same
+ * way, naming `target.transport`, never echoing the transport it named.
+ */
+import { type RpcTransport, type RuntimeRpcDescriptor } from '../../kinds/rpc.kind.ts';
+/** Read `descriptor` once for `entry`; refuse it typed unless it is a valid descriptor for `transport`. */
+export declare function readRpcDescriptor<T extends RpcTransport>(entry: string, descriptor: RuntimeRpcDescriptor, transport: T): RpcDescriptorFor<T>;
+/** Read `descriptor` once for `entry`, any transport. */
+export declare function readAnyRpcDescriptor(entry: string, descriptor: RuntimeRpcDescriptor): RuntimeRpcDescriptor;
+//# sourceMappingURL=descriptor-input.d.ts.map

package/dist/core/protocol/references/descriptor-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor-input.d.ts","sourceRoot":"","sources":["../../../../src/core/protocol/references/descriptor-input.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oEAAoE,CAAC;AAC3G,YAAY,EAAE,gBAAgB,EAAE,MAAM,oEAAoE,CAAC;AAC3G;;;;;;GAMG;AACH,OAAO,EAA8B,KAAK,YAAY,EAAE,KAAK,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AASnH,2GAA2G;AAC3G,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,oBAAoB,EAAE,SAAS,EAAE,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAI5I;AAED,yDAAyD;AACzD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,oBAAoB,GAAG,oBAAoB,CAE1G"}

package/dist/core/protocol/references/descriptor-input.js

@@ -0,0 +1,25 @@
+/**
+ * A `runtime/rpc` descriptor handed to a transport's implementation factory or loader registration, read once
+ * (class checklist 1): parsed by `RuntimeRpcDescriptorSchema` into a snapshot through {@link readInput}, so a hostile
+ * descriptor (a throwing getter, a Proxy or a revoked one, a wrong-typed field) is refused `INVALID_INPUT`
+ * `rpc-input-invalid` naming the entry and issue paths only. A descriptor for another transport is refused the same
+ * way, naming `target.transport`, never echoing the transport it named.
+ */
+import { RuntimeRpcDescriptorSchema } from "../../kinds/rpc.kind.js";
+import { inputInvalid, readInput } from "./caller-input.js";
+/** A descriptor whose target is `T`'s. */
+function isFor(descriptor, transport) {
+    return descriptor.target.transport === transport;
+}
+/** Read `descriptor` once for `entry`; refuse it typed unless it is a valid descriptor for `transport`. */
+export function readRpcDescriptor(entry, descriptor, transport) {
+    const read = readInput(entry, RuntimeRpcDescriptorSchema, descriptor);
+    if (!isFor(read, transport))
+        throw inputInvalid(entry, ['target.transport']);
+    return read;
+}
+/** Read `descriptor` once for `entry`, any transport. */
+export function readAnyRpcDescriptor(entry, descriptor) {
+    return readInput(entry, RuntimeRpcDescriptorSchema, descriptor);
+}
+//# sourceMappingURL=descriptor-input.js.map

package/dist/core/protocol/references/descriptor-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor-input.js","sourceRoot":"","sources":["../../../../src/core/protocol/references/descriptor-input.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,OAAO,EAAE,0BAA0B,EAAgD,MAAM,yBAAyB,CAAC;AACnH,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE5D,0CAA0C;AAE1C,SAAS,KAAK,CAAyB,UAAgC,EAAE,SAAY;IACpF,OAAO,UAAU,CAAC,MAAM,CAAC,SAAS,KAAK,SAAS,CAAC;AAClD,CAAC;AAED,2GAA2G;AAC3G,MAAM,UAAU,iBAAiB,CAAyB,KAAa,EAAE,UAAgC,EAAE,SAAY;IACtH,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,EAAE,0BAA0B,EAAE,UAAU,CAAC,CAAC;IACtE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC;QAAE,MAAM,YAAY,CAAC,KAAK,EAAE,CAAC,kBAAkB,CAAC,CAAC,CAAC;IAC7E,OAAO,IAAI,CAAC;AACb,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,oBAAoB,CAAC,KAAa,EAAE,UAAgC;IACnF,OAAO,SAAS,CAAC,KAAK,EAAE,0BAA0B,EAAE,UAAU,CAAC,CAAC;AACjE,CAAC"}

package/dist/core/protocol/references/dispatch.d.ts

@@ -0,0 +1,24 @@
+import type { DispatchDeps, StreamBinding } from "../../../schemas/contracts/protocol/references/dispatch.ts";
+export { CreditGovernedOpenSchema, RequestIdSchema } from "../../../schemas/contracts/protocol/references/dispatch.ts";
+export type { ChannelBinder, DispatchDeps, KindOf, OwnerTarget, StreamBinding } from "../../../schemas/contracts/protocol/references/dispatch.ts";
+/** Owner-side dispatch — decode an arriving {@link RpcRequest} and run it through L1's invoke pipeline (`authz → friction → dispatch`), the SAME chain a local */
+import type { RefKind } from '@vibesdotdev/kernel';
+import { type RpcRequest, type RpcResponse } from '../wire/verbs.ts';
+import { type RefId, type WireValue, asRefId } from '../wire/wire-value.ts';
+/** The args classifier for the OWNER side: a returned value or callback that is non-serializable becomes a ref. The listen side supplies it (it knows which */
+export type { WireClassifier } from '../wire/wire-value.ts';
+/** The id a malformed request carries, or `unknown` when it has none. */
+/** The open answer of a credit-governed stream channel. */
+export declare const CREDIT_GOVERNED_OPEN: WireValue;
+/** Whether a stream open answer marks its channel credit-governed. */
+export declare function isCreditGovernedOpen(response: RpcResponse): boolean;
+/** Handle one arriving request. Pure-ish: it resolves the target, runs the method */
+export declare function dispatchRequest(req: RpcRequest, deps: DispatchDeps): Promise<{
+    response: RpcResponse;
+    binding?: StreamBinding;
+}>;
+/** Convenience: the canonical RefKind for a referenceable return value. */
+export declare function refKindFor<T>(value: T): RefKind;
+export { asRefId };
+export type { RefId };
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/core/protocol/references/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../../../src/core/protocol/references/dispatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,4DAA4D,CAAC;AAE9G,OAAO,EAAE,wBAAwB,EAAE,eAAe,EAAE,MAAM,4DAA4D,CAAC;AACvH,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,4DAA4D,CAAC;AAClJ,kKAAkK;AAElK,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAKnD,OAAO,EACP,KAAK,UAAU,EACf,KAAK,WAAW,EAQf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,KAAK,KAAK,EAAE,KAAK,SAAS,EAAE,OAAO,EAAe,MAAM,uBAAuB,CAAC;AAGzF,+JAA+J;AAC/J,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,yEAAyE;AAEzE,2DAA2D;AAC3D,eAAO,MAAM,oBAAoB,EAAE,SAA+C,CAAC;AAEnF,sEAAsE;AACtE,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,CAEnE;AAED,qFAAqF;AACrF,wBAAsB,eAAe,CACpC,GAAG,EAAE,UAAU,EACf,IAAI,EAAE,YAAY,GAChB,OAAO,CAAC;IAAE,QAAQ,EAAE,WAAW,CAAC;IAAC,OAAO,CAAC,EAAE,aAAa,CAAA;CAAE,CAAC,CAuH7D;AAED,2EAA2E;AAC3E,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAG/C;AAED,OAAO,EAAE,OAAO,EAAE,CAAC;AACnB,YAAY,EAAE,KAAK,EAAE,CAAC"}

package/dist/core/protocol/references/dispatch.js

@@ -0,0 +1,130 @@
+import { CreditGovernedOpenSchema, RequestIdSchema } from "../../../schemas/contracts/protocol/references/dispatch.js";
+export { CreditGovernedOpenSchema, RequestIdSchema } from "../../../schemas/contracts/protocol/references/dispatch.js";
+import { WireInvokeCallerSchema } from '@vibesdotdev/kernel/schemas';
+import { attempt, attemptAsync } from "../lifecycle/attempt.js";
+import { hasMembers, isFunction } from "../wire/value-kinds.js";
+import { RPC_ERROR, isInvoke, isRelease, isStream, rpcError, rpcFailure, toRpcError } from "../wire/verbs.js";
+import { asRefId, encodeValue } from "../wire/wire-value.js";
+import { admitsMethod, admitsStream, advertisementOf, forgetAdvertisement } from "./advertisement.js";
+/** The id a malformed request carries, or `unknown` when it has none. */
+/** The open answer of a credit-governed stream channel. */
+export const CREDIT_GOVERNED_OPEN = { t: 'json', v: { credits: true } };
+/** Whether a stream open answer marks its channel credit-governed. */
+export function isCreditGovernedOpen(response) {
+    return CreditGovernedOpenSchema.safeParse(response.result).success;
+}
+/** Handle one arriving request. Pure-ish: it resolves the target, runs the method */
+export async function dispatchRequest(req, deps) {
+    if (isRelease(req)) {
+        // Idempotent: free what the owner retained under this id.
+        deps.table.release(req.ref);
+        forgetAdvertisement(deps.table, req.ref);
+        return { response: { id: req.id } };
+    }
+    if (isStream(req)) {
+        if (!admitsStream(advertisementOf(deps.table, req.ref), req.channel)) {
+            return {
+                response: {
+                    id: req.id,
+                    error: rpcError(RPC_ERROR.NOT_ADVERTISED, `Ref '${req.ref}' advertised no stream channel '${req.channel}'`)
+                }
+            };
+        }
+        const target = deps.table.deref(req.ref);
+        if (target === undefined || target === null) {
+            return {
+                response: { id: req.id, error: rpcError(RPC_ERROR.NO_TARGET, `No object for ref '${req.ref}'`) }
+            };
+        }
+        const binding = deps.bindChannel(target, req.channel);
+        if (!binding) {
+            return {
+                response: {
+                    id: req.id,
+                    error: rpcError(RPC_ERROR.NO_CHANNEL, `Object has no stream channel '${req.channel}'`)
+                }
+            };
+        }
+        if (binding.demand && deps.streamCredits !== true) {
+            // The binding is still handed back: the transport closes it, keeping any close failure.
+            return {
+                response: {
+                    id: req.id,
+                    error: rpcError(RPC_ERROR.NO_CHANNEL, `Channel '${req.channel}' is credit-governed and this connection did not negotiate stream credits`, undefined, 'rpc-stream-credits-unnegotiated')
+                },
+                binding
+            };
+        }
+        // A credit-governed channel says so in its open answer: the consumer (or a forwarding hop) grants before any DATA.
+        return { response: binding.demand ? { id: req.id, result: CREDIT_GOVERNED_OPEN } : { id: req.id }, binding };
+    }
+    if (isInvoke(req)) {
+        const target = deps.table.deref(req.targetRef);
+        if (!hasMembers(target)) {
+            return {
+                response: { id: req.id, error: rpcError(RPC_ERROR.NO_TARGET, `No object for ref '${req.targetRef}'`) }
+            };
+        }
+        // Admission before anything runs: only a method this ref (or the root's
+        // declared list) advertised may be invoked; the target is not touched.
+        if (!admitsMethod(advertisementOf(deps.table, req.targetRef), req.method)) {
+            return {
+                response: {
+                    id: req.id,
+                    error: rpcError(RPC_ERROR.NOT_ADVERTISED, `Method '${req.method}' is not advertised for ref '${req.targetRef}'`)
+                }
+            };
+        }
+        if (!isFunction(target[req.method])) {
+            return {
+                response: { id: req.id, error: rpcError(RPC_ERROR.NO_METHOD, `No method '${req.method}'`) }
+            };
+        }
+        // Wrap the target with the L1 pipeline so authz → friction run on THIS
+        // arriving invoke exactly as for a local call. With zero interceptors the
+        // pipeline returns the target unchanged (identity), so the no-gate path is
+        // byte-identical to a direct call.
+        // The wrap admits the invoke's declared caller against what the transport
+        // verified (RC08) before any gate runs; a refusal is answered typed.
+        const wrapped = attempt(() => deps.pipeline.wrap(target, {
+            kind: deps.kindOf(target),
+            implId: req.targetRef,
+            origin: 'remote',
+            remotePeer: deps.remotePeer,
+            caller: WireInvokeCallerSchema.parse(req.caller)
+        }));
+        if (!wrapped.ok)
+            return { response: { id: req.id, error: toRpcError(wrapped.failure) } };
+        const guarded = wrapped.value;
+        const args = deps.decodeArgs(req.args);
+        const invoked = await attemptAsync(async () => {
+            const guardedMethod = guarded[req.method];
+            if (!isFunction(guardedMethod))
+                throw rpcFailure(RPC_ERROR.NO_METHOD, `No method '${req.method}'`);
+            const result = await Promise.resolve(guardedMethod.apply(guarded, args));
+            return encodeValue(result, deps.table, deps.classifyResult);
+        });
+        // A gate veto (authz/friction) or a method throw both surface as an error
+        // response. A gate that threw a coded error keeps its code; anything else
+        // is RPC_INVOKE_FAILED. A rethrown wire envelope passes through
+        // untouched so a forwarding hop never destroys the root cause into
+        // "[object Object]" on its way to the caller.
+        if (!invoked.ok)
+            return { response: { id: req.id, error: toRpcError(invoked.failure) } };
+        return { response: { id: req.id, result: invoked.value } };
+    }
+    return {
+        response: {
+            id: RequestIdSchema.parse(req).id,
+            error: rpcError(RPC_ERROR.INVOKE_FAILED, `Unknown verb`)
+        }
+    };
+}
+/** Convenience: the canonical RefKind for a referenceable return value. */
+export function refKindFor(value) {
+    if (isFunction(value))
+        return 'function';
+    return 'object';
+}
+export { asRefId };
+//# sourceMappingURL=dispatch.js.map

package/dist/core/protocol/references/dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.js","sourceRoot":"","sources":["../../../../src/core/protocol/references/dispatch.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,eAAe,EAAE,MAAM,4DAA4D,CAAC;AACvH,OAAO,EAAE,wBAAwB,EAAE,eAAe,EAAE,MAAM,4DAA4D,CAAC;AAKvH,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAGP,SAAS,EACT,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,UAAU,EACT,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAA8B,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzF,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAKtG,yEAAyE;AAEzE,2DAA2D;AAC3D,MAAM,CAAC,MAAM,oBAAoB,GAAc,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;AAEnF,sEAAsE;AACtE,MAAM,UAAU,oBAAoB,CAAC,QAAqB;IACzD,OAAO,wBAAwB,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;AACpE,CAAC;AAED,qFAAqF;AACrF,MAAM,CAAC,KAAK,UAAU,eAAe,CACpC,GAAe,EACf,IAAkB;IAElB,IAAI,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;QACpB,0DAA0D;QAC1D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,mBAAmB,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;QACzC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC;IACrC,CAAC;IAED,IAAI,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACnB,IAAI,CAAC,YAAY,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YACtE,OAAO;gBACN,QAAQ,EAAE;oBACT,EAAE,EAAE,GAAG,CAAC,EAAE;oBACV,KAAK,EAAE,QAAQ,CACd,SAAS,CAAC,cAAc,EACxB,QAAQ,GAAG,CAAC,GAAG,mCAAmC,GAAG,CAAC,OAAO,GAAG,CAChE;iBACD;aACD,CAAC;QACH,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAY,GAAG,CAAC,GAAG,CAAC,CAAC;QACpD,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YAC7C,OAAO;gBACN,QAAQ,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,SAAS,EAAE,sBAAsB,GAAG,CAAC,GAAG,GAAG,CAAC,EAAE;aAChG,CAAC;QACH,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QACtD,IAAI,CAAC,OAAO,EAAE,CAAC;YACd,OAAO;gBACN,QAAQ,EAAE;oBACT,EAAE,EAAE,GAAG,CAAC,EAAE;oBACV,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,UAAU,EAAE,iCAAiC,GAAG,CAAC,OAAO,GAAG,CAAC;iBACtF;aACD,CAAC;QACH,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,aAAa,KAAK,IAAI,EAAE,CAAC;YACnD,wFAAwF;YACxF,OAAO;gBACN,QAAQ,EAAE;oBACT,EAAE,EAAE,GAAG,CAAC,EAAE;oBACV,KAAK,EAAE,QAAQ,CACd,SAAS,CAAC,UAAU,EACpB,YAAY,GAAG,CAAC,OAAO,2EAA2E,EAClG,SAAS,EACT,iCAAiC,CACjC;iBACD;gBACD,OAAO;aACP,CAAC;QACH,CAAC;QACD,mHAAmH;QACnH,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC;IAC9G,CAAC;IAED,IAAI,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACnB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAY,GAAG,CAAC,SAAS,CAAC,CAAC;QAC1D,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACzB,OAAO;gBACN,QAAQ,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,SAAS,EAAE,sBAAsB,GAAG,CAAC,SAAS,GAAG,CAAC,EAAE;aACtG,CAAC;QACH,CAAC;QACD,wEAAwE;QACxE,uEAAuE;QACvE,IAAI,CAAC,YAAY,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3E,OAAO;gBACN,QAAQ,EAAE;oBACT,EAAE,EAAE,GAAG,CAAC,EAAE;oBACV,KAAK,EAAE,QAAQ,CACd,SAAS,CAAC,cAAc,EACxB,WAAW,GAAG,CAAC,MAAM,gCAAgC,GAAG,CAAC,SAAS,GAAG,CACrE;iBACD;aACD,CAAC;QACH,CAAC;QAED,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;YACrC,OAAO;gBACN,QAAQ,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,SAAS,EAAE,cAAc,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE;aAC3F,CAAC;QACH,CAAC;QAED,uEAAuE;QACvE,0EAA0E;QAC1E,2EAA2E;QAC3E,mCAAmC;QACnC,0EAA0E;QAC1E,qEAAqE;QACrE,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE;YACxD,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;YACzB,MAAM,EAAE,GAAG,CAAC,SAAS;YACrB,MAAM,EAAE,QAAQ;YAChB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,MAAM,EAAE,sBAAsB,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC;SAChD,CAAC,CAAC,CAAC;QACJ,IAAI,CAAC,OAAO,CAAC,EAAE;YAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;QACzF,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC;QAE9B,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,KAAK,IAAwB,EAAE;YACjE,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC1C,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC;gBAAE,MAAM,UAAU,CAAC,SAAS,CAAC,SAAS,EAAE,cAAc,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;YACnG,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;YACzE,OAAO,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;QACH,0EAA0E;QAC1E,0EAA0E;QAC1E,gEAAgE;QAChE,mEAAmE;QACnE,8CAA8C;QAC9C,IAAI,CAAC,OAAO,CAAC,EAAE;YAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;QACzF,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;IAC5D,CAAC;IAED,OAAO;QACN,QAAQ,EAAE;YACT,EAAE,EAAE,eAAe,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE;YACjC,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,aAAa,EAAE,cAAc,CAAC;SACxD;KACD,CAAC;AACH,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,UAAU,CAAI,KAAQ;IACrC,IAAI,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,UAAU,CAAC;IACzC,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/core/protocol/references/function-callbacks.d.ts

@@ -0,0 +1,19 @@
+import { DefaultReferenceTable } from '@vibesdotdev/kernel';
+import { type RpcResponse, type WireClassifier } from '@vibesdotdev/kernel-rpc';
+import type { RpcSource } from '../wire/rpc-data.ts';
+import { type RpcInvoke } from '../wire/verbs.ts';
+import type { RpcLifecycle } from '@vibesdotdev/kernel-rpc';
+export interface FunctionCallbackOwner {
+    lifecycle: RpcLifecycle;
+    deadlineMs: number;
+    maxRefs: number;
+    classifyResult?: WireClassifier;
+}
+/** Shared function-reference behavior; each transport supplies its actual reverse delivery. */
+export declare function createFunctionCallbacks(table: DefaultReferenceTable, target: FunctionCallbackOwner, post: (request: RpcInvoke) => void, isClosed: () => boolean): {
+    callbackFor: (refId: string) => ((...values: unknown[]) => Promise<RpcSource | undefined>);
+    classifyOwnerResult: WireClassifier;
+    classifyCallbackResult: WireClassifier;
+    callbackAnswers: Map<string, (res: RpcResponse) => void>;
+};
+//# sourceMappingURL=function-callbacks.d.ts.map

package/dist/core/protocol/references/function-callbacks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"function-callbacks.d.ts","sourceRoot":"","sources":["../../../../src/core/protocol/references/function-callbacks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAGP,KAAK,WAAW,EAChB,KAAK,cAAc,EAClB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D,MAAM,WAAW,qBAAqB;IACrC,SAAS,EAAE,YAAY,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,cAAc,CAAC;CAChC;AAED,+FAA+F;AAC/F,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,qBAAqB,EAAE,MAAM,EAAE,qBAAqB,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,SAAS,KAAK,IAAI,EAAE,QAAQ,EAAE,MAAM,OAAO;yBAkBnI,MAAM,KAAG,CAAC,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;;;uCAhBjD,WAAW,KAAK,IAAI;EA0ElE"}

package/dist/core/protocol/references/function-callbacks.js

@@ -0,0 +1,84 @@
+import { CapabilityError, DefaultReferenceTable } from '@vibesdotdev/kernel';
+import { encodeValue, asRefId } from '@vibesdotdev/kernel-rpc';
+import { attempt, attemptAsync, rethrow } from "../lifecycle/attempt.js";
+import { isFunction } from "../wire/value-kinds.js";
+import { throwWireError } from "../wire/verbs.js";
+/** Shared function-reference behavior; each transport supplies its actual reverse delivery. */
+export function createFunctionCallbacks(table, target, post, isClosed) {
+    /** The host's calls into applet callbacks, waiting for the frame's answer. */
+    const callbackAnswers = new Map();
+    /** Applet callbacks the host still holds (each one a ref into the frame's table). */
+    let liveCallbacks = 0;
+    const forgotten = new FinalizationRegistry(() => {
+        liveCallbacks -= 1;
+    });
+    const limit = (direction) => new CapabilityError(`An applet connection holds at most ${target.maxRefs} live callback refs (${direction}).`, 'INVALID_INPUT', {
+        reason: 'rpc-applet-callback-limit',
+        details: { limit: target.maxRefs, direction }
+    });
+    /**
+     * A host-side callable for an applet callback ref. It carries NO host authority: calling it asks
+     * the frame to run its own function with bounded JSON, and the answer is untrusted bounded JSON.
+     */
+    const callbackFor = (refId) => {
+        if (liveCallbacks >= target.maxRefs)
+            throw limit('applet callbacks held by the host');
+        liveCallbacks += 1;
+        const callback = async (...values) => {
+            if (isClosed()) {
+                throw new CapabilityError('The applet connection closed; its callbacks are released.', 'UNAVAILABLE', {
+                    reason: 'rpc-applet-callback-released',
+                    retryable: false
+                });
+            }
+            const id = crypto.randomUUID();
+            const answered = new Promise((resolve) => callbackAnswers.set(id, resolve));
+            const sent = attempt(() => post({ id, verb: 'invoke', targetRef: asRefId(refId), method: 'call', args: values.map((value) => encodeValue(value, table, classifyAppletResult)) }));
+            if (!sent.ok) {
+                callbackAnswers.delete(id);
+                return rethrow(sent.failure);
+            }
+            const waited = await attemptAsync(() => target.lifecycle.wait(() => answered, { timeoutMs: target.deadlineMs, reason: 'applet-callback' }));
+            callbackAnswers.delete(id);
+            if (!waited.ok)
+                return rethrow(waited.failure);
+            const res = waited.value;
+            if (res.error)
+                return throwWireError(res.error);
+            if (res.result === undefined)
+                return undefined;
+            if (res.result.t !== 'json') {
+                throw new CapabilityError('An applet callback answered something other than bounded JSON.', 'INVALID_INPUT', {
+                    reason: 'rpc-applet-callback-answer-invalid'
+                });
+            }
+            return res.result.v;
+        };
+        forgotten.register(callback, undefined);
+        return callback;
+    };
+    /** Host results: a function (an unsubscribe) becomes a `call`-only ref, capped; everything else stays inline JSON. */
+    const classifyAppletResult = (value) => {
+        if (!isFunction(value))
+            return { mode: 'inline' };
+        // The table holds the root plus every live host function ref the applet was handed.
+        if (table.size - 1 >= target.maxRefs)
+            throw limit('host functions held by the applet');
+        return { mode: 'ref', kind: 'function', methods: ['call'] };
+    };
+    const classifyOwnerResult = (value) => {
+        const hint = target.classifyResult ? target.classifyResult(value) : classifyAppletResult(value);
+        if (hint.mode === 'inline')
+            return hint;
+        if (hint.kind === 'stream' || hint.channel !== undefined || hint.channels !== undefined) {
+            throw new CapabilityError('MessagePort owner results cannot advertise streams.', 'INVALID_INPUT', {
+                reason: 'rpc-messageport-stream-ref-refused'
+            });
+        }
+        if (table.size - 1 >= target.maxRefs)
+            throw limit('owner refs held by the peer');
+        return hint;
+    };
+    return { callbackFor, classifyOwnerResult, classifyCallbackResult: classifyAppletResult, callbackAnswers };
+}
+//# sourceMappingURL=function-callbacks.js.map

package/dist/core/protocol/references/function-callbacks.js.map

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

package/dist/core/protocol/references/projection-consumer.d.ts

@@ -0,0 +1,12 @@
+/** Canonical projection semantics over the actual RPC consumer boundary. */
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { type RuntimeProjectionSnapshot } from '@vibesdotdev/kernel/federation';
+import { type ConsumerTransport } from './consumer.ts';
+/** The snapshot is schema-derived; resolved capabilities are validated as actual objects. */
+export declare function projectionConsumer(transport: ConsumerTransport, idPrefix: string): {
+    snapshot(): Promise<RuntimeProjectionSnapshot>;
+    resolve(kindId: string, assetId: string): Promise<object>;
+    releaseRoot: () => void;
+    settleReleases: () => Promise<CapabilityError | null>;
+};
+//# sourceMappingURL=projection-consumer.d.ts.map

package/dist/core/protocol/references/projection-consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection-consumer.d.ts","sourceRoot":"","sources":["../../../../src/core/protocol/references/projection-consumer.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAE5E,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAEP,KAAK,yBAAyB,EAC7B,MAAM,gCAAgC,CAAC;AAIxC,OAAO,EAAgB,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAQrE,6FAA6F;AAC7F,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM;gBAG7D,OAAO,CAAC,yBAAyB,CAAC;oBAQ9B,MAAM,WAAW,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;;0BAS3C,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;EAEpD"}

package/dist/core/protocol/references/projection-consumer.js

@@ -0,0 +1,43 @@
+/** Canonical projection semantics over the actual RPC consumer boundary. */
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { RuntimeProjectionSnapshotSchema } from '@vibesdotdev/kernel/federation';
+import { isFunction, isObject } from "../wire/value-kinds.js";
+import { throwWireError } from "../wire/verbs.js";
+import { decodeValue } from "../wire/wire-value.js";
+import { wireConsumer } from "./consumer.js";
+function invalidProjection() {
+    return new CapabilityError('The remote runtime projection is invalid.', 'INVALID_INPUT', {
+        reason: 'rpc-projection-invalid', retryable: false
+    });
+}
+/** The snapshot is schema-derived; resolved capabilities are validated as actual objects. */
+export function projectionConsumer(transport, idPrefix) {
+    const consumer = wireConsumer(transport, idPrefix);
+    return {
+        async snapshot() {
+            const response = await consumer.invokeRoot('snapshot', []);
+            if (response.error)
+                throwWireError(response.error);
+            if (!response.result)
+                throw invalidProjection();
+            const parsed = RuntimeProjectionSnapshotSchema.safeParse(decodeValue(response.result, consumer.makeProxy));
+            if (!parsed.success)
+                throw invalidProjection();
+            return parsed.data;
+        },
+        async resolve(kindId, assetId) {
+            const response = await consumer.invokeRoot('resolve', [kindId, assetId]);
+            if (response.error)
+                throwWireError(response.error);
+            if (!response.result)
+                throw invalidProjection();
+            const value = decodeValue(response.result, consumer.makeProxy);
+            if (!isObject(value) && !isFunction(value))
+                throw invalidProjection();
+            return value;
+        },
+        releaseRoot: () => consumer.releaseRoot(),
+        settleReleases: () => consumer.settleReleases()
+    };
+}
+//# sourceMappingURL=projection-consumer.js.map

package/dist/core/protocol/references/projection-consumer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection-consumer.js","sourceRoot":"","sources":["../../../../src/core/protocol/references/projection-consumer.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAE5E,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EACP,+BAA+B,EAE9B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,YAAY,EAA0B,MAAM,eAAe,CAAC;AAErE,SAAS,iBAAiB;IACzB,OAAO,IAAI,eAAe,CAAC,2CAA2C,EAAE,eAAe,EAAE;QACxF,MAAM,EAAE,wBAAwB,EAAE,SAAS,EAAE,KAAK;KAClD,CAAC,CAAC;AACJ,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,kBAAkB,CAAC,SAA4B,EAAE,QAAgB;IAChF,MAAM,QAAQ,GAAG,YAAY,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACnD,OAAO;QACN,KAAK,CAAC,QAAQ;YACb,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,UAAU,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;YAC3D,IAAI,QAAQ,CAAC,KAAK;gBAAE,cAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YACnD,IAAI,CAAC,QAAQ,CAAC,MAAM;gBAAE,MAAM,iBAAiB,EAAE,CAAC;YAChD,MAAM,MAAM,GAAG,+BAA+B,CAAC,SAAS,CAAC,WAAW,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;YAC3G,IAAI,CAAC,MAAM,CAAC,OAAO;gBAAE,MAAM,iBAAiB,EAAE,CAAC;YAC/C,OAAO,MAAM,CAAC,IAAI,CAAC;QACpB,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,MAAc,EAAE,OAAe;YAC5C,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;YACzE,IAAI,QAAQ,CAAC,KAAK;gBAAE,cAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YACnD,IAAI,CAAC,QAAQ,CAAC,MAAM;gBAAE,MAAM,iBAAiB,EAAE,CAAC;YAChD,MAAM,KAAK,GAAG,WAAW,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;YAC/D,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;gBAAE,MAAM,iBAAiB,EAAE,CAAC;YACtE,OAAO,KAAK,CAAC;QACd,CAAC;QACD,WAAW,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,WAAW,EAAE;QACzC,cAAc,EAAE,GAAoC,EAAE,CAAC,QAAQ,CAAC,cAAc,EAAE;KAChF,CAAC;AACH,CAAC"}

package/dist/core/protocol/references/ref-table.d.ts

@@ -0,0 +1,33 @@
+import type { RefKind } from '@vibesdotdev/kernel';
+import type { ProxyDeps, RemoteProxy, RemoteRef } from "../../../schemas/contracts/protocol/references/ref-table.ts";
+import type { RefId } from '../wire/wire-value.ts';
+export { RUNTIME_PROJECTION_ROOT_METHODS, RUNTIME_ROOT_METHODS, validateRootMethods } from "./root-methods.ts";
+export { RootMethodSchema } from "../../../schemas/contracts/protocol/references/ref-table.ts";
+export type { OpenStreamFn, ProxyDeps, RemoteProxy, RemoteRef, ResultDecoder, RpcChannel, SendFn, StreamCapable } from "../../../schemas/contracts/protocol/references/ref-table.ts";
+export declare const NEVER_REMOTE_KEYS: ReadonlySet<string>;
+/**
+ * Build a consumer-side proxy for a `RefId` received on the wire.
+ *
+ * Every property access that yields a (declared) method returns a function that,
+ * when called, sends `invoke(refId, method, args)` and resolves to the decoded
+ * result. `Symbol.dispose` releases the ref locally (which drives the wire
+ * `release` verb via the L1 table's release sink). A `FinalizationRegistry`
+ * (owned by the L1 table) releases the ref if this proxy is GC'd undisposed.
+ *
+ * @param refId   the far-side object id
+ * @param kind    the L1 RefKind (object | function | stream)
+ * @param methods declared callable method names; only these reach the
+ *                owner (an empty set exposes none).
+ * @param unlisted how an unlisted property reads: `absent` (a ref: undefined,
+ *                like a local object) or `refused` (the root: a function that
+ *                rejects typed `rpc-root-method-unlisted`, so a caller learns why).
+ *                `then` and symbol keys are always absent.
+ * @param deps    transport-supplied send/openStream/decode/table
+ * @param streamChannel  when set, the ref is stream-capable on this channel
+ */
+export declare function makeRemoteProxy(refId: RefId, kind: RefKind, methods: readonly string[], deps: ProxyDeps, streamChannel?: string, unlisted?: 'absent' | 'refused', channels?: readonly string[]): RemoteProxy;
+/** Whether a proxy built by {@link makeRemoteProxy} has been disposed. */
+export declare function isDisposed(proxy: RemoteProxy): boolean;
+/** Read the ref id off a proxy built by {@link makeRemoteProxy}. */
+export declare function refIdOf(proxy: Partial<RemoteRef> | null | undefined): RefId | undefined;
+//# sourceMappingURL=ref-table.d.ts.map

package/dist/core/protocol/references/ref-table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref-table.d.ts","sourceRoot":"","sources":["../../../../src/core/protocol/references/ref-table.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAc,MAAM,6DAA6D,CAAC;AAKjI,OAAO,KAAK,EAAE,KAAK,EAAc,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,+BAA+B,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE/G,OAAO,EAAE,gBAAgB,EAAE,MAAM,6DAA6D,CAAC;AAE/F,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,6DAA6D,CAAC;AAKrL,eACA,MAAM,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAAkE,CAAC;AAE9G;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,eAAe,CAC9B,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,IAAI,EAAE,SAAS,EACf,aAAa,CAAC,EAAE,MAAM,EACtB,QAAQ,GAAE,QAAQ,GAAG,SAAoB,EACzC,QAAQ,GAAE,SAAS,MAAM,EAAO,GAC9B,WAAW,CAwGb;AAED,0EAA0E;AAC1E,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAEtD;AAED,oEAAoE;AACpE,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK,GAAG,SAAS,CAEvF"}