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

package/dist/cli/worker/daemon-execution.worker.entry.js

@@ -0,0 +1,220 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import { AttachInputSchema, WorkerInputSchema } from "../../schemas/contracts/cli/daemon-execution.worker.entry.js";
+export { AttachInputSchema, WorkerInputSchema, portSchema } from "../../schemas/contracts/cli/daemon-execution.worker.entry.js";
+/** One native worker owns workspace composition, features, SQLite, watchers and execution. */
+import { createCliHostPlugin } from '@vibesdotdev/cli/bootstrap';
+import { CapabilityError, CaughtFailureSchema, valueFreeFailure } from '@vibesdotdev/kernel';
+import { PluginModuleSchema } from '@vibesdotdev/kernel/bootstrap';
+import { LOCAL_ATTESTED_SOURCE, RUNTIME_PROJECTION_ROOT_METHODS } from '@vibesdotdev/kernel-rpc';
+import { listenMessagePort } from '@vibesdotdev/kernel-rpc/messageport';
+import { RPC_CONNECTION_CLOSED } from '@vibesdotdev/kernel-rpc/unix';
+import * as z from 'zod/v4';
+import { describeDaemonExecutionFailure } from "../../daemon/hosting/execution/execution-failure.js";
+import { DaemonExecutionDetachSchema, DaemonExecutionDrainSchema, DaemonExecutionStateSchema } from "../../daemon/hosting/execution/execution-host.schemas.js";
+import { RuntimeDaemon, applyDeclaredHttpConfig } from "../../daemon/hosting/process/daemon.consumer.js";
+import { RPC_ROOT_METHODS } from "../../daemon/services/api/rpc-root.js";
+import { registerRuntimeDaemonCommands } from "../daemon/runtime.daemon.serve.impl.consumer.js";
+export { isRpcMessagePort } from "../../schemas/contracts/cli/daemon-execution.worker.entry.js";
+/**
+ * Workspace stays an optional peer. A literal import would make kernel-rpc's
+ * build wait on workspace while workspace's build still waits on kernel-rpc
+ * through pm. The specifier is widened so the artifact planner and tsc do not
+ * bind the package.
+ */
+const WORKSPACE_STATE_PLUGIN = '@vibesdotdev/workspace/state.plugin';
+const WORKSPACE_DOCUMENT_PLUGIN = '@vibesdotdev/workspace/document-plugin';
+const WORKSPACE_PROJECT_REF = '@vibesdotdev/workspace/project-ref';
+const WORKSPACE_ENVIRONMENT = '@vibesdotdev/workspace/environment/node';
+function workspaceSpecifier(specifier) {
+    return specifier;
+}
+function isProjectRefModule(value) {
+    return typeof value === 'object' && value !== null && 'resolveProjectRefContext' in value && typeof value.resolveProjectRefContext === 'function';
+}
+function isWorkspaceEnvironmentModule(value) {
+    return typeof value === 'object' && value !== null && 'bindWorkspaceEnvironment' in value && typeof value.bindWorkspaceEnvironment === 'function';
+}
+function workspacePlugin(loaded, specifier) {
+    const parsed = PluginModuleSchema.safeParse(loaded);
+    if (!parsed.success || parsed.data === null) {
+        throw new CapabilityError('Workspace composition did not export a runtime plugin.', 'UNAVAILABLE', {
+            reason: 'workspace-composition-plugin-unavailable',
+            details: { specifier }
+        });
+    }
+    return parsed.data;
+}
+/** The execution worker's workspace floor: the same three plugins, project ref, and environment bind. */
+export async function loadDaemonExecutionWorkspaceComposition() {
+    const stateLoaded = await import(__rewriteRelativeImportExtension(workspaceSpecifier(WORKSPACE_STATE_PLUGIN)));
+    const projectLoaded = await import(__rewriteRelativeImportExtension(workspaceSpecifier(WORKSPACE_PROJECT_REF)));
+    const documentLoaded = await import(__rewriteRelativeImportExtension(workspaceSpecifier(WORKSPACE_DOCUMENT_PLUGIN)));
+    const environmentLoaded = await import(__rewriteRelativeImportExtension(workspaceSpecifier(WORKSPACE_ENVIRONMENT)));
+    if (!isProjectRefModule(projectLoaded)) {
+        throw new CapabilityError('Workspace composition did not export project ref.', 'UNAVAILABLE', {
+            reason: 'workspace-project-ref-unavailable'
+        });
+    }
+    if (!isWorkspaceEnvironmentModule(environmentLoaded)) {
+        throw new CapabilityError('Workspace composition did not export the environment bind.', 'UNAVAILABLE', {
+            reason: 'workspace-environment-bind-unavailable'
+        });
+    }
+    return {
+        state: workspacePlugin(stateLoaded, WORKSPACE_STATE_PLUGIN),
+        projectRef: workspacePlugin(projectLoaded, WORKSPACE_PROJECT_REF),
+        document: workspacePlugin(documentLoaded, WORKSPACE_DOCUMENT_PLUGIN),
+        resolveProjectRefContext: projectLoaded.resolveProjectRefContext,
+        bindWorkspaceEnvironment: environmentLoaded.bindWorkspaceEnvironment
+    };
+}
+export async function runDaemonExecutionWorker(owner, inputData, host) {
+    let runtime;
+    let daemon;
+    const listeners = [];
+    const subscriptions = [];
+    const peerListeners = new Map();
+    /** Each attached client's connection: aborted when it detaches or the worker drains, ending its invocations. */
+    const peerConnections = new Map();
+    const endPeer = (id) => {
+        peerConnections.get(id)?.abort(new CapabilityError('The RPC connection closed.', 'CANCELLED', {
+            reason: RPC_CONNECTION_CLOSED, details: { connectionId: id }
+        }));
+        peerConnections.delete(id);
+        for (const listener of peerListeners.get(id) ?? [])
+            listener.close();
+        peerListeners.delete(id);
+    };
+    let disposal;
+    const dispose = () => disposal ??= (async () => {
+        for (const unsubscribe of subscriptions.splice(0))
+            unsubscribe();
+        // Deleting the entry being visited is safe in a Map iteration.
+        for (const id of peerListeners.keys())
+            endPeer(id);
+        for (const listener of listeners.splice(0))
+            listener.close();
+        if (daemon)
+            await daemon.disposeExecution();
+        else
+            await runtime?.dispose();
+    })();
+    try {
+        const input = WorkerInputSchema.parse(inputData);
+        const { boot } = input;
+        if (boot.host.selfSpawnSource === null)
+            throw new CapabilityError('The execution host has no declared self-spawn source.', 'UNAVAILABLE', {
+                reason: 'daemon-execution-self-spawn-source-unavailable'
+            });
+        // The host's runtime-thread boot: this host's environment from the boot's
+        // facts and the workspace composition, with the execution owner's own
+        // floor after the captured one. It serves runtime RPC and runs no TUI.
+        const workspace = await loadDaemonExecutionWorkspaceComposition();
+        runtime = await host.bootRuntimeThread(boot, {
+            floor: [async () => createCliHostPlugin(boot.buildSurface), async () => workspace.state, async () => workspace.projectRef,
+                async () => workspace.document],
+            omitSurfaces: ['tui']
+        });
+        // Workspace locks, catalog and document state belong to the execution
+        // owner. Main has already admitted this root through the kernel.
+        const root = await runtime.context('runtime/workspace-path');
+        const projectRef = await workspace.resolveProjectRefContext(runtime);
+        await workspace.bindWorkspaceEnvironment(runtime, {
+            sessionId: 'cli', target: 'local', root,
+            projectId: projectRef.resolve({ cwd: root })?.projectId
+        });
+        const http = boot.options?.http;
+        const config = await applyDeclaredHttpConfig({ serveHost: runtime, registerCommands: registerRuntimeDaemonCommands,
+            port: http?.port ?? (http?.enabled === true ? 0 : undefined), host: http?.host,
+            corsAllowedOrigins: http?.corsOrigins, corsAllowAny: http?.corsAllowAny, httpDebug: http?.debug,
+            hotReload: boot.options?.hotReload });
+        daemon = new RuntimeDaemon(config);
+        const execution = await daemon.prepareExecution();
+        await daemon.startHttpExecution();
+        const control = listenMessagePort(input.controlPort, {
+            root: execution.controlRoot, rootMethods: RPC_ROOT_METHODS,
+            pipeline: execution.runtime.invoke, lifecycle: execution.runtime.lifecycle,
+            classifyResult: () => ({ mode: 'inline' }), kindId: 'runtime/rpc',
+            // These initial ports are owned by the spawning host, never exposed to a peer.
+            verifiedPeer: { source: LOCAL_ATTESTED_SOURCE, caller: {} }
+        });
+        listeners.push(control);
+        const projection = listenMessagePort(input.projectionPort, {
+            root: execution.projectionRoot, rootMethods: RUNTIME_PROJECTION_ROOT_METHODS,
+            pipeline: execution.runtime.invoke, lifecycle: execution.runtime.lifecycle,
+            classifyResult: execution.projectionRoot.classifyResult, kindOf: execution.projectionRoot.kindOf,
+            verifiedPeer: { source: LOCAL_ATTESTED_SOURCE, caller: {} }
+        });
+        listeners.push(projection);
+        owner.postMessage(DaemonExecutionStateSchema.parse({
+            state: 'ready', controlRootRef: control.rootRef, projectionRootRef: projection.rootRef,
+            advertisement: execution.projectionRoot.snapshot(), health: await execution.controlRoot.health({})
+        }));
+        const publishAdvertisement = () => owner.postMessage(DaemonExecutionStateSchema.parse({
+            state: 'advertisement', advertisement: execution.projectionRoot.snapshot()
+        }));
+        subscriptions.push(execution.runtime.onDescriptorRevisionChange(publishAdvertisement), execution.runtime.onGenerationChange(publishAdvertisement));
+        owner.on('message', async (message) => {
+            const attachment = AttachInputSchema.safeParse(message);
+            if (attachment.success) {
+                const { admission, controlPort, projectionPort, id } = attachment.data;
+                const control = listenMessagePort(controlPort, {
+                    root: execution.controlRoot, rootMethods: RPC_ROOT_METHODS,
+                    pipeline: execution.runtime.invoke, lifecycle: execution.runtime.lifecycle,
+                    classifyResult: () => ({ mode: 'inline' }), kindId: 'runtime/rpc',
+                    verifiedPeer: admission.verifiedPeer,
+                    runInvocation: work => execution.runtime.runInvocation(work, { workspace: admission.workspace })
+                });
+                // One projection view per attached client: a projected method's signal ends with its client's connection.
+                const connection = new AbortController();
+                peerConnections.set(id, connection);
+                const projection = listenMessagePort(projectionPort, {
+                    root: execution.projectionRoot.forConnection({ signal: connection.signal }), rootMethods: RUNTIME_PROJECTION_ROOT_METHODS,
+                    pipeline: execution.runtime.invoke, lifecycle: execution.runtime.lifecycle,
+                    classifyResult: execution.projectionRoot.classifyResult, kindOf: execution.projectionRoot.kindOf,
+                    verifiedPeer: admission.verifiedPeer,
+                    runInvocation: work => execution.runtime.runInvocation(work, { workspace: admission.workspace })
+                });
+                peerListeners.set(id, [control, projection]);
+                owner.postMessage(DaemonExecutionStateSchema.parse({ state: 'attached', id,
+                    controlRootRef: control.rootRef, projectionRootRef: projection.rootRef }));
+                return;
+            }
+            const detached = DaemonExecutionDetachSchema.safeParse(message);
+            if (detached.success) {
+                endPeer(detached.data.id);
+                return;
+            }
+            const request = DaemonExecutionDrainSchema.safeParse(message);
+            if (!request.success)
+                throw new CapabilityError('Invalid execution owner request.', 'INTERNAL', { reason: 'daemon-execution-request-invalid', cause: request.error });
+            try {
+                await dispose();
+                owner.postMessage(DaemonExecutionStateSchema.parse({ state: 'drained' }));
+                owner.close();
+            }
+            catch (error) {
+                owner.postMessage(DaemonExecutionStateSchema.parse({ state: 'failed', failure: describeDaemonExecutionFailure(CaughtFailureSchema.parse(error)) }));
+                throw new CapabilityError('Daemon execution disposal failed.', 'UNAVAILABLE', { reason: 'daemon-execution-disposal-failed', cause: valueFreeFailure(CaughtFailureSchema.parse(error)) });
+            }
+        });
+    }
+    catch (error) {
+        const outcomes = await Promise.allSettled([dispose()]);
+        const failures = outcomes.filter(outcome => outcome.status === 'rejected').map(outcome => valueFreeFailure(CaughtFailureSchema.parse(outcome.reason)));
+        owner.postMessage(DaemonExecutionStateSchema.parse({ state: 'failed', failure: describeDaemonExecutionFailure(CaughtFailureSchema.parse(error)) }));
+        owner.close();
+        throw new CapabilityError('Daemon execution boot failed.', 'UNAVAILABLE', {
+            reason: 'daemon-execution-boot-failed', cause: valueFreeFailure(CaughtFailureSchema.parse(error)),
+            details: { cleanupFailures: failures.map(failure => ({ name: failure.name, code: failure.code ?? null, reason: failure.reason ?? null })) }
+        });
+    }
+}
+//# sourceMappingURL=daemon-execution.worker.entry.js.map

package/dist/cli/worker/daemon-execution.worker.entry.js.map

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

package/dist/core/descriptor-wire/serialize.d.ts

@@ -0,0 +1,9 @@
+import type { RuntimeDescriptor } from '@vibesdotdev/kernel/schemas/descriptor';
+import type { SerializedDescriptor } from '../../schemas/daemon/daemon-response.ts';
+/**
+ * Serialize a runtime descriptor to a plain JSON-safe object.
+ * Strips implementation details, class prototypes, and Zod schemas
+ * while preserving all metadata fields.
+ */
+export declare function serializeDescriptor<T extends RuntimeDescriptor>(descriptor: T): SerializedDescriptor;
+//# sourceMappingURL=serialize.d.ts.map

package/dist/core/descriptor-wire/serialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../../src/core/descriptor-wire/serialize.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAEhF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAQpF;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,iBAAiB,EAAE,UAAU,EAAE,CAAC,GAAG,oBAAoB,CAyEpG"}

package/dist/core/descriptor-wire/serialize.js

@@ -0,0 +1,88 @@
+/** Descriptor metadata projection; preserves feature fields without carrying implementation objects. */
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { systemToolSchemaToJsonSchema } from '@vibesdotdev/tools/schemas/system-tools';
+import { DeclaredToolSchemaSchema, DescriptorFieldSchema, JsonDocumentSchema, ToolSchemaBagSchema, ZodSchemaProbe } from "../../schemas/descriptor-wire.js";
+/**
+ * Serialize a runtime descriptor to a plain JSON-safe object.
+ * Strips implementation details, class prototypes, and Zod schemas
+ * while preserving all metadata fields.
+ */
+export function serializeDescriptor(descriptor) {
+    const result = {
+        id: descriptor.id,
+        kind: descriptor.kind,
+        name: descriptor.name ?? descriptor.id,
+        enabled: descriptor.enabled ?? true
+    };
+    if (descriptor.description !== undefined)
+        result.description = descriptor.description;
+    if (descriptor.tags !== undefined)
+        result.tags = [...descriptor.tags];
+    if (descriptor.hardware !== undefined)
+        result.hardware = [...descriptor.hardware];
+    const baseKeys = new Set(['id', 'kind', 'name', 'description', 'tags', 'enabled', 'hardware']);
+    for (const [key, value] of Object.entries(descriptor)) {
+        if (baseKeys.has(key))
+            continue;
+        if (value === undefined)
+            continue;
+        // Tool schemas must be converted while Zod instances are still live.
+        // JSON.stringify alone silently turns nested schemas into Zod internals.
+        if (descriptor.kind === 'tools/tool' && key === 'schemas') {
+            const bag = ToolSchemaBagSchema.safeParse(value);
+            if (!bag.success)
+                continue;
+            const schemas = {};
+            for (const [name, schema] of Object.entries(bag.data)) {
+                if (name !== 'input' && name !== 'output') {
+                    const kept = JsonDocumentSchema.safeParse(schema);
+                    if (kept.success)
+                        schemas[name] = kept.data;
+                    continue;
+                }
+                const declared = DeclaredToolSchemaSchema.safeParse(schema);
+                if (!declared.success)
+                    throw new Error(`Cannot publish tool ${descriptor.id}: ${name} schema conversion failed`);
+                const projected = systemToolSchemaToJsonSchema(declared.data);
+                if (projected && (projected['x-vibes-schema-degraded'] || 'def' in projected || '_def' in projected)) {
+                    throw new Error(`Cannot publish tool ${descriptor.id}: ${name} schema conversion failed`);
+                }
+                if (projected !== undefined)
+                    schemas[name] = projected;
+            }
+            result.schemas = schemas;
+            result.inputSchema = schemas.input;
+            result.outputSchema = schemas.output;
+            continue;
+        }
+        if (key === 'payloadSchema' || key === 'schema' || key.endsWith('Schema') || ZodSchemaProbe.safeParse(value).success) {
+            if (ZodSchemaProbe.safeParse(value).success) {
+                // Admit the owner schema before projecting it.
+                const projected = systemToolSchemaToJsonSchema(DeclaredToolSchemaSchema.parse(value));
+                if (projected && !projected['x-vibes-schema-degraded'] && !('def' in projected) && !('_def' in projected)) {
+                    result[key] = projected;
+                    continue;
+                }
+                continue;
+            }
+        }
+        if (value instanceof Function)
+            continue;
+        if (Object.prototype.toString.call(value) === '[object Symbol]')
+            continue;
+        if (ZodSchemaProbe.safeParse(value).success)
+            continue;
+        // A nested `undefined` is an absent key in JSON; drop it rather than refuse the whole descriptor.
+        // The projected field is admitted by the JSON schema after absent members are removed.
+        const projected = DescriptorFieldSchema.safeParse(value);
+        if (!projected.success) {
+            throw new CapabilityError(`Descriptor ${descriptor.id} field ${key} is not JSON.`, 'INVALID_INPUT', {
+                reason: 'descriptor-field-not-json',
+                details: { id: descriptor.id, field: key }
+            });
+        }
+        result[key] = projected.data;
+    }
+    return result;
+}
+//# sourceMappingURL=serialize.js.map

package/dist/core/descriptor-wire/serialize.js.map

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

package/dist/core/helper.d.ts

@@ -0,0 +1,42 @@
+export { RemoteConnectionInput, RemoteRootSchema } from "../schemas/contracts/core/helper.ts";
+export type { RemoteDescriptorQuery, RemoteDescriptorQueryResult, RemoteOwnerRuntime, RemoteRoot, RemoteRuntime } from "../schemas/contracts/core/helper.ts";
+import type { RemoteOwnerRuntime, RemoteRuntime } from "../schemas/contracts/core/helper.ts";
+/**
+ * `getVibesRemoteFrom(runtime, id)` — SUGAR over `runtime.query('runtime/rpc').withId(id).resolve()`,
+ * on the runtime the caller hands in (never an ambient one).
+ *
+ * Returns a proxy to the remote runtime root. Every method on it routes through
+ * `invoke` over the descriptor's transport. This exists for ergonomics — the
+ * canonical way to reach remote is `query(kind).matching({ host })` / `.on(ref)`
+ * at the call site (the resolver inserts the transport). This helper is never the
+ * primary path (doc 11 §L4, Selection table).
+ *
+ * The returned {@link RemoteRuntime} is disposable: disposing releases the root
+ * ref and closes the connection, so a forgotten remote does not leak.
+ */
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import type { RpcConnection } from './kinds/rpc.kind.ts';
+/**
+ * `remoteRuntimeFromConnection`'s connection, read once: kept by reference (a connection class's methods keep their
+ * receiver), refused unless `send`, `openStream` and `close` are functions; its `rootRef` and `closed` are read
+ * into the snapshot here, never again.
+ */
+/** The root a remote runtime serves: its `query` verb answers a kind id or a descriptor query. */
+/** The wired root proxy, checked to serve `query` (a runtime root always lists it). */
+/**
+ * Wrap a live {@link RpcConnection} into a disposable {@link RemoteRuntime}
+ * owned by `owner`. A remote is a LIVE handle whose socket must outlive the
+ * call frames that opened it (closure references alone do not keep a Bun
+ * socket alive), so the owning runtime pins it: an abort listener on the
+ * runtime's `lifecycle.signal` holds the connection strongly and closes it when
+ * the runtime is disposed. Disposing the remote unpins it. No process-global
+ * set (D39, RC02): each runtime pins only its own remotes.
+ */
+export declare function remoteRuntimeFromConnection(connectionInput: RpcConnection, owner: RemoteOwnerRuntime): RemoteRuntime;
+/**
+ * Convenience over `query('runtime/rpc').withId(id)`. Resolves the registered
+ * `runtime/rpc` impl (a transport), opens its connection, and returns a proxy to
+ * the remote runtime root.
+ */
+export declare function getVibesRemoteFrom(runtime: Pick<RuntimeRef, 'query' | 'lifecycle'>, idInput: string): Promise<RemoteRuntime>;
+//# sourceMappingURL=helper.d.ts.map

package/dist/core/helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../../src/core/helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAC9F,YAAY,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,kBAAkB,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAC7J,OAAO,KAAK,EAAsD,kBAAkB,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAEjJ;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAuC,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAE3F,OAAO,KAAK,EAAE,aAAa,EAA4B,MAAM,qBAAqB,CAAC;AAQnF;;;;GAIG;AAEH,kGAAkG;AAGlG,uFAAuF;AAEvF;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CAAC,eAAe,EAAE,aAAa,EAAE,KAAK,EAAE,kBAAkB,GAAG,aAAa,CAuEpH;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACvC,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,GAAG,WAAW,CAAC,EAChD,OAAO,EAAE,MAAM,GACb,OAAO,CAAC,aAAa,CAAC,CAQxB"}

package/dist/core/helper.js

@@ -0,0 +1,125 @@
+export { RemoteConnectionInput, RemoteRootSchema } from "../schemas/contracts/core/helper.js";
+import { RemoteConnectionInput, RemoteRootSchema } from "../schemas/contracts/core/helper.js";
+/**
+ * `getVibesRemoteFrom(runtime, id)` — SUGAR over `runtime.query('runtime/rpc').withId(id).resolve()`,
+ * on the runtime the caller hands in (never an ambient one).
+ *
+ * Returns a proxy to the remote runtime root. Every method on it routes through
+ * `invoke` over the descriptor's transport. This exists for ergonomics — the
+ * canonical way to reach remote is `query(kind).matching({ host })` / `.on(ref)`
+ * at the call site (the resolver inserts the transport). This helper is never the
+ * primary path (doc 11 §L4, Selection table).
+ *
+ * The returned {@link RemoteRuntime} is disposable: disposing releases the root
+ * ref and closes the connection, so a forgotten remote does not leak.
+ */
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { RuntimeDescriptorQueryResultSchema } from '@vibesdotdev/kernel/schemas/descriptor';
+import { rethrow, settled } from "./protocol/lifecycle/attempt.js";
+import { readInput, TextInput } from "./protocol/references/caller-input.js";
+import { wireConsumer } from "./protocol/references/consumer.js";
+import { isString } from "./protocol/wire/value-kinds.js";
+import { asRefId } from "./protocol/wire/wire-value.js";
+/**
+ * `remoteRuntimeFromConnection`'s connection, read once: kept by reference (a connection class's methods keep their
+ * receiver), refused unless `send`, `openStream` and `close` are functions; its `rootRef` and `closed` are read
+ * into the snapshot here, never again.
+ */
+/** The root a remote runtime serves: its `query` verb answers a kind id or a descriptor query. */
+/** The wired root proxy, checked to serve `query` (a runtime root always lists it). */
+/**
+ * Wrap a live {@link RpcConnection} into a disposable {@link RemoteRuntime}
+ * owned by `owner`. A remote is a LIVE handle whose socket must outlive the
+ * call frames that opened it (closure references alone do not keep a Bun
+ * socket alive), so the owning runtime pins it: an abort listener on the
+ * runtime's `lifecycle.signal` holds the connection strongly and closes it when
+ * the runtime is disposed. Disposing the remote unpins it. No process-global
+ * set (D39, RC02): each runtime pins only its own remotes.
+ */
+export function remoteRuntimeFromConnection(connectionInput, owner) {
+    const { connection, fields } = readInput('remoteRuntimeFromConnection', RemoteConnectionInput, { connection: connectionInput, fields: connectionInput });
+    const transport = {
+        rootRef: fields.rootRef,
+        send: (req) => connection.send(req),
+        openStream: (ref, channel) => connection.openStream(asRefId(ref), channel),
+        closed: fields.closed
+    };
+    // Forward the reverse leg (owner→consumer callback invokes) when the
+    // transport has one, so `wireConsumer` can route them into its callbacks.
+    if (fields.onRequest)
+        transport.onRequest = (handler) => connection.onRequest?.(handler);
+    const { root, settleReleases, releaseRoot } = wireConsumer(transport);
+    const rootObj = RemoteRootSchema.parse(root);
+    async function query(input) {
+        const answer = await rootObj.query(input);
+        if (isString(input)) {
+            // SAFETY: a string query returns the kind's remote implementation, not a
+            // catalog: the root answers a kind id with that kind's proxy, which the caller
+            // types by naming `Implementation`, as `RuntimeRef.query` does.
+            return answer;
+        }
+        const parsed = RuntimeDescriptorQueryResultSchema.safeParse(answer);
+        if (!parsed.success) {
+            throw new CapabilityError('Invalid remote descriptor query result.', 'INVALID_INPUT', {
+                reason: 'rpc-query-result-invalid',
+                retryable: false
+            });
+        }
+        return parsed.data;
+    }
+    // One close outcome (null, or the connection's close failure), never
+    // rejecting, so a dispose keeps it for close() to report.
+    let closing = null;
+    const release = () => {
+        if (closing)
+            return closing;
+        // Release the root ref on the owner, then close the underlying connection.
+        releaseRoot();
+        owner.lifecycle.signal.removeEventListener('abort', release);
+        // Join the connection's close with every release this end sent.
+        closing = Promise.all([settled(connection.close()), settleReleases()]).then(([closed, releaseFailure]) => {
+            const closeFailure = closed.ok ? null : closed.failure;
+            // Independent failures are both kept: the transport's close and the release delivery.
+            if (closeFailure && releaseFailure)
+                return new AggregateError([closeFailure, releaseFailure], 'The remote close and release delivery both failed.');
+            return closeFailure ?? releaseFailure;
+        });
+        return closing;
+    };
+    // The owning runtime pins the connection (this listener holds it) and its
+    // disposal closes it; the outcome is kept for close(). A runtime already
+    // disposed closes the remote at once.
+    if (owner.lifecycle.signal.aborted)
+        void release();
+    else
+        owner.lifecycle.signal.addEventListener('abort', release, { once: true });
+    const close = async () => {
+        const failure = await release();
+        if (failure)
+            rethrow(failure);
+    };
+    return {
+        __refId: asRefId(fields.rootRef),
+        // Pin the connection (and its socket) on the returned object so it stays
+        // strongly reachable for the lifetime of the RemoteRuntime.
+        connection,
+        query,
+        close,
+        [Symbol.dispose]: () => void release()
+    };
+}
+/**
+ * Convenience over `query('runtime/rpc').withId(id)`. Resolves the registered
+ * `runtime/rpc` impl (a transport), opens its connection, and returns a proxy to
+ * the remote runtime root.
+ */
+export async function getVibesRemoteFrom(runtime, idInput) {
+    const id = readInput('getVibesRemoteFrom', TextInput, idInput);
+    const impl = await runtime
+        .query('runtime/rpc')
+        .withId(id)
+        .resolve();
+    const connection = await impl.connect();
+    return remoteRuntimeFromConnection(connection, runtime);
+}
+//# sourceMappingURL=helper.js.map

package/dist/core/helper.js.map

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

package/dist/core/kinds/rpc.kind.d.ts

@@ -0,0 +1,48 @@
+import type { RuntimeRpcDescriptor, RuntimeRpcImplementation } from "../../schemas/contracts/core/kinds/rpc.kind.ts";
+export { CREDENTIAL_FREE_TRANSPORTS, RemoteScopeHintSchema, RPC_TRANSPORTS, RpcTargetSchema, RuntimeRpcDescriptorSchema } from "../../schemas/contracts/core/kinds/rpc.kind.ts";
+export type { RemoteScopeHint, RpcConnection, RpcTarget, RpcTransport, RuntimeRpcDescriptor, RuntimeRpcImplementation } from "../../schemas/contracts/core/kinds/rpc.kind.ts";
+/**
+ * The `runtime/rpc` kind — how the resolver reaches a non-local candidate.
+ *
+ * A reachable runtime surfaces as a REGISTERED `runtime/rpc` descriptor, never as
+ * a client `discover()` method (doc 11 Part 3/L4). L1's resolver walks the
+ * registered `runtime/rpc` descriptors to extend the candidate set for any kind;
+ * this lane only provides the descriptor shape + the transport impls behind it.
+ *
+ * The descriptor is FROZEN in phase 3: `transport` + `target` + `auth`. The phase-4
+ * http transport adds NO new top-level field — the `target.transport: 'http'`
+ * variant is already declared here. (Acceptance criterion #9.)
+ *
+ * The impl of this kind IS a transport. Implementations and their registration
+ * helpers are exposed through explicit `@vibesdotdev/kernel-rpc/*` subpaths.
+ * There is no `RuntimeRpc.query()` method — the resolver uses the impl to
+ * `connect()` and obtain the remote root ref, then routes invokes. The consumer
+ * never sees a transport.
+ */
+import type { KindContext, RuntimeKindDescriptor } from '@vibesdotdev/kernel/schemas/kind';
+/**
+ * Connection credential reference: the kernel's own (D-RC05). It names a secret
+ * (`{ source: 'secret', key, store? }`), never a value; there is no env arm.
+ * The transport resolves it at connect time only through
+ * `runtime.resolveCredential`.
+ */
+export { CredentialReferenceSchema, type CredentialReference } from '@vibesdotdev/kernel/credentials';
+/** One transport name, for comparing against a peer's reported transport. */
+export declare const RPC_TRANSPORT: {
+    readonly unix: "unix";
+    readonly tcp: "tcp";
+    readonly http: "http";
+    readonly relay: "relay";
+    readonly cef: "cef";
+    readonly messageport: "messageport";
+    readonly tauri: "tauri";
+};
+/**
+ * A raw bidirectional byte channel for the `stream` verb (re-export so transport
+ * consumers have one import).
+ */
+export type { RpcChannel } from '../protocol/references/ref-table.ts';
+/** The `runtime/rpc` kind descriptor. No `selectionBias` — it is not a destination kind. */
+export declare const rpcKind: RuntimeKindDescriptor<RuntimeRpcDescriptor, RuntimeRpcImplementation, KindContext>;
+export default rpcKind;
+//# sourceMappingURL=rpc.kind.d.ts.map

package/dist/core/kinds/rpc.kind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.kind.d.ts","sourceRoot":"","sources":["../../../src/core/kinds/rpc.kind.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,gDAAgD,CAAC;AAErH,OAAO,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,cAAc,EAAE,eAAe,EAAE,0BAA0B,EAAE,MAAM,gDAAgD,CAAC;AAChL,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,gDAAgD,CAAC;AAC9K;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAE3F;;;;;GAKG;AACH,OAAO,EAAE,yBAAyB,EAAE,KAAK,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAEtG,6EAA6E;AAC7E,eAAO,MAAM,aAAa;;;;;;;;CAQ0C,CAAC;AAErE;;;GAGG;AACH,YAAY,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AAEtE,4FAA4F;AAC5F,eAAO,MAAM,OAAO,EAAE,qBAAqB,CAAC,oBAAoB,EAAE,wBAAwB,EAAE,WAAW,CAItG,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/dist/core/kinds/rpc.kind.js

@@ -0,0 +1,27 @@
+import { RPC_TRANSPORTS, RuntimeRpcDescriptorSchema } from "../../schemas/contracts/core/kinds/rpc.kind.js";
+export { CREDENTIAL_FREE_TRANSPORTS, RemoteScopeHintSchema, RPC_TRANSPORTS, RpcTargetSchema, RuntimeRpcDescriptorSchema } from "../../schemas/contracts/core/kinds/rpc.kind.js";
+/**
+ * Connection credential reference: the kernel's own (D-RC05). It names a secret
+ * (`{ source: 'secret', key, store? }`), never a value; there is no env arm.
+ * The transport resolves it at connect time only through
+ * `runtime.resolveCredential`.
+ */
+export { CredentialReferenceSchema } from '@vibesdotdev/kernel/credentials';
+/** One transport name, for comparing against a peer's reported transport. */
+export const RPC_TRANSPORT = {
+    unix: 'unix',
+    tcp: 'tcp',
+    http: 'http',
+    relay: 'relay',
+    cef: 'cef',
+    messageport: 'messageport',
+    tauri: 'tauri'
+};
+/** The `runtime/rpc` kind descriptor. No `selectionBias` — it is not a destination kind. */
+export const rpcKind = {
+    id: 'runtime/rpc',
+    descriptorSchema: RuntimeRpcDescriptorSchema,
+    contexts: []
+};
+export default rpcKind;
+//# sourceMappingURL=rpc.kind.js.map

package/dist/core/kinds/rpc.kind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.kind.js","sourceRoot":"","sources":["../../../src/core/kinds/rpc.kind.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,gDAAgD,CAAC;AAC5G,OAAO,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,cAAc,EAAE,eAAe,EAAE,0BAA0B,EAAE,MAAM,gDAAgD,CAAC;AAuBhL;;;;;GAKG;AACH,OAAO,EAAE,yBAAyB,EAA4B,MAAM,iCAAiC,CAAC;AAEtG,6EAA6E;AAC7E,MAAM,CAAC,MAAM,aAAa,GAAG;IAC5B,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,KAAK;IACV,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;IACd,GAAG,EAAE,KAAK;IACV,WAAW,EAAE,aAAa;IAC1B,KAAK,EAAE,OAAO;CACqD,CAAC;AAQrE,4FAA4F;AAC5F,MAAM,CAAC,MAAM,OAAO,GAAuF;IAC1G,EAAE,EAAE,aAAa;IACjB,gBAAgB,EAAE,0BAA0B;IAC5C,QAAQ,EAAE,EAAE;CACZ,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/dist/core/lifecycle-repeat.d.ts

@@ -0,0 +1,11 @@
+import { type RuntimeLifecycle, type RuntimeRef } from '@vibesdotdev/kernel';
+import type { LifecycleRepeat } from "../schemas/contracts/core/lifecycle-repeat.ts";
+export type { LifecycleRepeat } from "../schemas/contracts/core/lifecycle-repeat.ts";
+/**
+ * Repeat `tick` every `ms` on a persistent host via `lifecycle.interval`.
+ * A finite host refuses interval; the same cadence continues on a
+ * `lifecycle.delay` loop bound to the returned stopper. The refusal stays
+ * on the handle.
+ */
+export declare function startLifecycleRepeat(runtime: RuntimeRef, lifecycle: Pick<RuntimeLifecycle, 'interval' | 'delay'>, ms: number, tick: () => void): LifecycleRepeat;
+//# sourceMappingURL=lifecycle-repeat.d.ts.map