@vibesdotdev/host-bun 0.0.0-stage → 1.0.0-rc.3

package/dist/sqlite-driver/sqlite-driver.plugin.js

@@ -0,0 +1,44 @@
+/**
+ * Registers the Bun host's SQLite driver under LocalDB's `localdb/sqlite-driver`
+ * kind. The host owns the kind's registration on the runtimes it builds (as it
+ * owns the paths kinds): the kind is LocalDB's frozen definition, so a second
+ * registration of it by the LocalDB plugin is a no-op. The driver module loads
+ * only when the kind is first resolved.
+ */
+import { createRuntimeImplementation, createRuntimePlugin } from '@vibesdotdev/kernel';
+import { LOCALDB_SQLITE_DRIVER_KIND, sqliteDriverKind } from '@vibesdotdev/localdb/sqlite-driver';
+import { assertNativeBunHost } from "../native-network/native-host.js";
+/** The Bun driver's descriptor. */
+export const bunSqliteDriverDescriptor = {
+    id: 'sqlite-driver-bun',
+    kind: LOCALDB_SQLITE_DRIVER_KIND,
+    name: 'Bun SQLite driver',
+    description: 'LocalDB SQLite driver over bun:sqlite',
+    host: 'bun',
+    hardware: ['consumer', 'cloud']
+};
+/** Register the kind (when absent), the Bun driver's descriptor and its lazy loader on `runtime`. */
+export function registerBunSqliteDriver(runtime) {
+    if (!runtime.hasKind(LOCALDB_SQLITE_DRIVER_KIND))
+        runtime.registerKind(sqliteDriverKind);
+    runtime.registerDescriptor(LOCALDB_SQLITE_DRIVER_KIND, bunSqliteDriverDescriptor);
+    runtime.registerLoader(LOCALDB_SQLITE_DRIVER_KIND, bunSqliteDriverDescriptor.id, async () => {
+        assertNativeBunHost(runtime);
+        const { createBunSqliteDriver } = await import("./sqlite-driver.impl.bun.js");
+        return createRuntimeImplementation({
+            kind: LOCALDB_SQLITE_DRIVER_KIND,
+            id: bunSqliteDriverDescriptor.id,
+            constraint: { hardware: ['consumer', 'cloud'] },
+            implementation: createBunSqliteDriver()
+        });
+    });
+}
+/** The same registration as a plugin, for a host composed from plugins. */
+export const bunSqliteDriverPlugin = createRuntimePlugin({
+    id: 'sqlite-driver-bun',
+    name: 'Bun SQLite driver',
+    onRegister(runtime) {
+        registerBunSqliteDriver(runtime);
+    }
+});
+//# sourceMappingURL=sqlite-driver.plugin.js.map

package/dist/sqlite-driver/sqlite-driver.plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-driver.plugin.js","sourceRoot":"","sources":["../../src/sqlite-driver/sqlite-driver.plugin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,2BAA2B,EAAE,mBAAmB,EAAuC,MAAM,qBAAqB,CAAC;AAC5H,OAAO,EAAE,0BAA0B,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAClG,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAEvE,mCAAmC;AACnC,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACxC,EAAE,EAAE,mBAAmB;IACvB,IAAI,EAAE,0BAA0B;IAChC,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE,uCAAuC;IACpD,IAAI,EAAE,KAAK;IACX,QAAQ,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC;CAC/B,CAAC;AAEF,qGAAqG;AACrG,MAAM,UAAU,uBAAuB,CAAC,OAAmB;IAC1D,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,0BAA0B,CAAC;QAAE,OAAO,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC;IACzF,OAAO,CAAC,kBAAkB,CAAC,0BAA0B,EAAE,yBAAyB,CAAC,CAAC;IAClF,OAAO,CAAC,cAAc,CAAC,0BAA0B,EAAE,yBAAyB,CAAC,EAAE,EAAE,KAAK,IAAI,EAAE;QAC3F,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC7B,MAAM,EAAE,qBAAqB,EAAE,GAAG,MAAM,MAAM,CAAC,6BAA6B,CAAC,CAAC;QAC9E,OAAO,2BAA2B,CAAC;YAClC,IAAI,EAAE,0BAA0B;YAChC,EAAE,EAAE,yBAAyB,CAAC,EAAE;YAChC,UAAU,EAAE,EAAE,QAAQ,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE;YAC/C,cAAc,EAAE,qBAAqB,EAAE;SACvC,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,2EAA2E;AAC3E,MAAM,CAAC,MAAM,qBAAqB,GAAkB,mBAAmB,CAAC;IACvE,EAAE,EAAE,mBAAmB;IACvB,IAAI,EAAE,mBAAmB;IACzB,UAAU,CAAC,OAAO;QACjB,uBAAuB,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;CACD,CAAC,CAAC"}

package/dist/telemetry/telemetry.d.ts

@@ -0,0 +1,34 @@
+/** Structural contract of the runtime/client host-telemetry capability. */
+import type { RuntimeClient } from '@vibesdotdev/kernel/client';
+import type { HostTelemetry } from '../schemas/telemetry.ts';
+export { HostTelemetrySchema, type HostTelemetry } from '../schemas/telemetry.ts';
+export interface HostTelemetryClient extends RuntimeClient {
+    read(): HostTelemetry;
+    capabilities(): {
+        os: string;
+        kernel: string;
+        cpu: {
+            model: string | undefined;
+            cores: number;
+        };
+        ramMb: number;
+        network: {
+            publicIp: string | undefined;
+            privateIp: string | undefined;
+        };
+    };
+    publicIpv4(): string | undefined;
+    heartbeat(activeJobs: number): {
+        timestamp: string;
+        uptimeSeconds: number;
+        capacity: {
+            cpuCores: number;
+            ramMb: number;
+        };
+        usage: {
+            ramPercent: number | undefined;
+        };
+        activeJobs: number;
+    };
+}
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/telemetry/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/telemetry/telemetry.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAElF,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACzD,IAAI,IAAI,aAAa,CAAC;IACtB,YAAY,IAAI;QACf,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE;YAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;QAC9E,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE;YAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;YAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;SAAE,CAAC;KACxF,CAAC;IACF,UAAU,IAAI,MAAM,GAAG,SAAS,CAAC;IACjC,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG;QAC9B,SAAS,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QACzC,QAAQ,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;QAC9C,KAAK,EAAE;YAAE,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;SAAE,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;KAC9D,CAAC;CACF"}

package/dist/telemetry/telemetry.js

@@ -0,0 +1,2 @@
+export { HostTelemetrySchema } from "../schemas/telemetry.js";
+//# sourceMappingURL=telemetry.js.map

package/dist/telemetry/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../src/telemetry/telemetry.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAsB,MAAM,yBAAyB,CAAC"}

package/dist/telemetry/telemetry.plugin.d.ts

@@ -0,0 +1,4 @@
+import { type HostTelemetry } from '../schemas/telemetry.ts';
+/** Tests may substitute only this native boundary; validation and client ownership stay real. */
+export declare function hostTelemetryPlugin(readNative?: () => HostTelemetry): import("@vibesdotdev/kernel").RuntimePlugin;
+//# sourceMappingURL=telemetry.plugin.d.ts.map

package/dist/telemetry/telemetry.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.plugin.d.ts","sourceRoot":"","sources":["../../src/telemetry/telemetry.plugin.ts"],"names":[],"mappings":"AAKA,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAsBlF,iGAAiG;AACjG,wBAAgB,mBAAmB,CAAC,UAAU,GAAE,MAAM,aAAmC,+CAiDxF"}

package/dist/telemetry/telemetry.plugin.js

@@ -0,0 +1,78 @@
+/** Bun-owned native binding of the structural host-telemetry client contract. */
+import { cpus, totalmem, freemem, type, release, version, uptime, networkInterfaces } from 'node:os';
+import { CapabilityError, createRuntimePlugin, settleNow, valueFreeFailure } from '@vibesdotdev/kernel';
+import { BaseRuntimeClient, getVibesClient } from '@vibesdotdev/kernel/client';
+import runtimeClientPlugin from '@vibesdotdev/kernel/client/plugin';
+import { HostTelemetrySchema } from "../schemas/telemetry.js";
+function readNativeTelemetry() {
+    return {
+        cpus: cpus(), totalMemoryBytes: totalmem(), freeMemoryBytes: freemem(),
+        os: { type: type(), release: release(), version: version(), uptimeSeconds: uptime() },
+        interfaces: Object.values(networkInterfaces()).flat().filter(entry => entry !== undefined)
+    };
+}
+function isReservedIpv4(address) {
+    const octets = address.split('.').map(Number);
+    if (octets.length !== 4 || octets.some(octet => !Number.isInteger(octet)))
+        return true;
+    const a = octets[0];
+    const b = octets[1];
+    return a === 0 || a === 10 || a === 127
+        || (a === 100 && b >= 64 && b <= 127)
+        || (a === 169 && b === 254)
+        || (a === 172 && b >= 16 && b <= 31)
+        || (a === 192 && b === 168);
+}
+/** Tests may substitute only this native boundary; validation and client ownership stay real. */
+export function hostTelemetryPlugin(readNative = readNativeTelemetry) {
+    return createRuntimePlugin({
+        id: 'host-telemetry', name: 'Live host telemetry',
+        async onRegister(runtime) {
+            await runtime.registerPlugin(runtimeClientPlugin);
+            runtime.registerDescriptor('runtime/client', { kind: 'runtime/client', id: 'host-telemetry', name: 'Live host telemetry' });
+            runtime.registerLoader('runtime/client', 'host-telemetry', async () => ({
+                impl: class extends BaseRuntimeClient {
+                    capabilities() {
+                        const reading = this.read();
+                        const addresses = reading.interfaces
+                            .flatMap(entry => entry.family === 'IPv4' && !entry.internal ? [entry.address] : []);
+                        return {
+                            os: `${reading.os.type} ${reading.os.release}`,
+                            kernel: reading.os.version,
+                            cpu: { model: reading.cpus[0]?.model, cores: reading.cpus.length },
+                            ramMb: Math.round(reading.totalMemoryBytes / 1024 / 1024),
+                            network: {
+                                publicIp: addresses.find(address => !isReservedIpv4(address)),
+                                privateIp: addresses.find(isReservedIpv4)
+                            }
+                        };
+                    }
+                    publicIpv4() {
+                        return this.capabilities().network.publicIp;
+                    }
+                    heartbeat(activeJobs) {
+                        const reading = this.read();
+                        const usedMemory = Math.max(reading.totalMemoryBytes - reading.freeMemoryBytes, 0);
+                        return {
+                            timestamp: new Date().toISOString(),
+                            uptimeSeconds: Math.floor(reading.os.uptimeSeconds),
+                            capacity: { cpuCores: reading.cpus.length, ramMb: Math.round(reading.totalMemoryBytes / 1024 / 1024) },
+                            usage: { ramPercent: reading.totalMemoryBytes > 0 ? Math.min(usedMemory / reading.totalMemoryBytes * 100, 100) : undefined },
+                            activeJobs
+                        };
+                    }
+                    read() {
+                        const reading = settleNow(() => HostTelemetrySchema.parse(readNative()));
+                        if (reading.ok)
+                            return reading.value;
+                        throw new CapabilityError('The host could not read live telemetry.', 'UNAVAILABLE', {
+                            reason: 'host-telemetry-read-failed', cause: valueFreeFailure(reading.cause)
+                        });
+                    }
+                }
+            }));
+            await getVibesClient('host-telemetry', runtime);
+        }
+    });
+}
+//# sourceMappingURL=telemetry.plugin.js.map

package/dist/telemetry/telemetry.plugin.js.map

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

package/dist/terminal-pty-bridge.impl.bun.d.ts

@@ -0,0 +1,31 @@
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import { type ExecutionSession, type SessionOptions } from '@vibesdotdev/kernel/execution';
+export interface PtyServerConfig extends Omit<SessionOptions, 'cols' | 'rows'> {
+    port: number;
+    cols?: number;
+    rows?: number;
+    hostname?: string;
+    /** Host admission for input queued while session opening is pending; default 64 KiB. */
+    maxOpeningInputBytes?: number;
+}
+interface PtyConnection {
+    closed: boolean;
+    pending: Array<string | Uint8Array>;
+    pendingBytes: number;
+    session?: ExecutionSession;
+    opening?: Promise<ExecutionSession>;
+    completion?: Promise<void>;
+    cleanup?: Promise<void>;
+    unsubscribe?: () => void;
+}
+/** Caller owns close(), followed by disposal of its runtime. */
+export declare function startPtyWsServer(runtime: RuntimeRef, input: PtyServerConfig): Promise<{
+    server: Bun.Server<PtyConnection>;
+    close(): Promise<void>;
+}>;
+/** Parse only captured host input; environment selection remains execution-owned. */
+export declare function ptyServerConfigFromEnv(runtime: RuntimeRef, argv?: string[]): PtyServerConfig;
+/** Executable boundary: caller supplies the installed module-graph root. */
+export declare function runPtyWsServerFromCli(hostRoot?: string): Promise<void>;
+export {};
+//# sourceMappingURL=terminal-pty-bridge.impl.bun.d.ts.map

package/dist/terminal-pty-bridge.impl.bun.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-pty-bridge.impl.bun.d.ts","sourceRoot":"","sources":["../src/terminal-pty-bridge.impl.bun.ts"],"names":[],"mappings":"AAEA,OAAO,EAON,KAAK,UAAU,EACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAQN,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,MAAM,+BAA+B,CAAC;AAcvC,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wFAAwF;IACxF,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,UAAU,aAAa;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,KAAK,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACpC,UAAU,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;CACzB;AAeD,gEAAgE;AAChE,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,eAAe;;aA4MvE,OAAO,CAAC,IAAI,CAAC;GAgBvB;AAED,qFAAqF;AACrF,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,GAAE,MAAM,EAAO,GAAG,eAAe,CA8ChG;AAED,4EAA4E;AAC5E,wBAAsB,qBAAqB,CAAC,QAAQ,GAAE,MAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8C1F"}

package/dist/terminal-pty-bridge.impl.bun.js

@@ -0,0 +1,333 @@
+/** Bun websocket host for the runtime-owned terminal PTY bridge contract. */
+import { join } from 'node:path';
+import { bootstrapVibesRuntime, CapabilityError, CaughtFailureSchema, getRuntimeStdio, readEnv } from '@vibesdotdev/kernel';
+import { decodeTerminalPtyClientFrame, encodeTerminalPtyExitFrame, requireExecutionEnvironmentMode, SessionOptionsSchema, terminalPtyBase64ToBytes } from '@vibesdotdev/kernel/execution';
+import { createRuntimeEnvironmentBunPlugin } from "./index.js";
+import * as z from 'zod/v4';
+const CONTROL_KEYS = [
+    'PTY_WS_PORT',
+    'PTY_WS_COMMAND',
+    'PTY_WS_ARGS',
+    'PTY_WS_CWD',
+    'PTY_WS_COLS',
+    'PTY_WS_ROWS',
+    'PTY_WS_ENV_POLICY'
+];
+const PtySocketMessageSchema = z.union([
+    z.string().transform((data) => ({
+        kind: 'text',
+        data,
+        byteLength: new TextEncoder().encode(data).byteLength
+    })),
+    z.instanceof(Uint8Array).transform((data) => ({
+        kind: 'bytes',
+        data: new Uint8Array(data),
+        byteLength: data.byteLength
+    }))
+]);
+/** Caller owns close(), followed by disposal of its runtime. */
+export async function startPtyWsServer(runtime, input) {
+    requireExecutionEnvironmentMode(input);
+    if (CONTROL_KEYS.some((key) => Object.hasOwn(input.env ?? {}, key))) {
+        throw new CapabilityError('PTY workload environment collides with a reserved bridge control key.', 'INVALID_INPUT', { reason: 'pty-environment-control-collision', retryable: false });
+    }
+    const maxOpeningInputBytes = input.maxOpeningInputBytes ?? 65_536;
+    if (!Number.isSafeInteger(maxOpeningInputBytes) || maxOpeningInputBytes < 0) {
+        throw new CapabilityError('Invalid PTY opening input budget.', 'INVALID_INPUT', {
+            reason: 'pty-opening-input-budget-invalid',
+            retryable: false
+        });
+    }
+    const parsed = SessionOptionsSchema.safeParse({
+        ...input,
+        cols: input.cols ?? 80,
+        rows: input.rows ?? 24
+    });
+    if (!parsed.success) {
+        throw new CapabilityError('Invalid PTY session request.', 'INVALID_INPUT', {
+            reason: 'pty-session-request-invalid',
+            retryable: false
+        });
+    }
+    const config = {
+        ...parsed.data,
+        unsetEnv: [...(parsed.data.unsetEnv ?? []), ...CONTROL_KEYS],
+        port: input.port,
+        hostname: input.hostname
+    };
+    const execution = await runtime
+        .query('runtime/execution')
+        .resolve();
+    const connections = new Set();
+    const failures = [];
+    let closing;
+    const captureFailure = (operation) => {
+        try {
+            operation();
+            return null;
+        }
+        catch (cause) {
+            return CaughtFailureSchema.parse(cause);
+        }
+    };
+    function deliver(session, message) {
+        if (message instanceof Uint8Array) {
+            session.write(new Uint8Array(message));
+            return;
+        }
+        const frame = decodeTerminalPtyClientFrame(message);
+        if (frame.t === 'stdin')
+            session.write(terminalPtyBase64ToBytes(frame.d));
+        else if (frame.t === 'resize')
+            session.resize(frame.cols, frame.rows);
+        else
+            session.signal(frame.name);
+    }
+    function cleanup(connection) {
+        connection.closed = true;
+        connection.pending = [];
+        connection.pendingBytes = 0;
+        connection.cleanup ??= (async () => {
+            const session = connection.session ?? (await connection.opening);
+            if (session) {
+                session.kill();
+                await session.exited();
+            }
+            await connection.completion;
+            connection.unsubscribe?.();
+            connections.delete(connection);
+        })();
+        return connection.cleanup;
+    }
+    function observeCleanup(connection) {
+        void cleanup(connection)
+            .then(() => ({ kind: 'success' }), (cause) => ({
+            kind: 'failure',
+            failure: CaughtFailureSchema.parse(cause)
+        }))
+            .then((outcome) => {
+            if (outcome.kind === 'failure')
+                failures.push(outcome.failure);
+        });
+    }
+    const server = Bun.serve({
+        port: config.port,
+        hostname: config.hostname ?? '0.0.0.0',
+        fetch(request, nativeServer) {
+            if (closing)
+                return new Response('closing', { status: 503 });
+            if (nativeServer.upgrade(request, {
+                data: { closed: false, pending: [], pendingBytes: 0 }
+            })) {
+                return undefined;
+            }
+            return new Response('terminal-pty-bridge: websocket upgrade required', { status: 426 });
+        },
+        websocket: {
+            perMessageDeflate: false,
+            open(socket) {
+                const connection = socket.data;
+                connections.add(connection);
+                connection.opening = Promise.resolve().then(() => execution.session({
+                    command: config.command,
+                    args: config.args,
+                    cwd: config.cwd,
+                    env: config.env,
+                    envMode: config.envMode,
+                    inheritReason: config.inheritReason,
+                    unsetEnv: config.unsetEnv,
+                    cols: config.cols ?? 80,
+                    rows: config.rows ?? 24
+                }));
+                connection.completion = connection.opening
+                    .then(async (session) => {
+                    connection.session = session;
+                    if (connection.closed)
+                        return;
+                    connection.unsubscribe = session.onOutput((bytes) => {
+                        if (!connection.closed)
+                            socket.sendBinary(bytes);
+                    });
+                    for (const message of connection.pending)
+                        deliver(session, message);
+                    connection.pending = [];
+                    connection.pendingBytes = 0;
+                    const { exitCode } = await session.exited();
+                    if (!connection.closed) {
+                        socket.send(encodeTerminalPtyExitFrame(exitCode));
+                        socket.close(1000, 'pty-exit');
+                    }
+                })
+                    .then(() => ({ kind: 'success' }), (cause) => ({
+                    kind: 'failure',
+                    failure: CaughtFailureSchema.parse(cause)
+                }))
+                    .then((outcome) => {
+                    if (outcome.kind !== 'failure')
+                        return;
+                    failures.push(outcome.failure);
+                    const closeFailure = captureFailure(() => socket.close(1011, 'pty-session-failed'));
+                    if (closeFailure)
+                        failures.push(closeFailure);
+                    observeCleanup(connection);
+                });
+            },
+            message(socket, message) {
+                const connection = socket.data;
+                if (connection.closed)
+                    return;
+                const parsed = PtySocketMessageSchema.safeParse(message);
+                if (!parsed.success) {
+                    failures.push(new CapabilityError('Invalid PTY websocket message.', 'INVALID_INPUT', {
+                        reason: 'pty-websocket-message-invalid',
+                        retryable: false,
+                        cause: parsed.error
+                    }));
+                    const closeFailure = captureFailure(() => socket.close(1011, 'pty-session-failed'));
+                    if (closeFailure)
+                        failures.push(closeFailure);
+                    observeCleanup(connection);
+                    return;
+                }
+                const admitted = parsed.data;
+                const session = connection.session;
+                if (!session) {
+                    connection.pendingBytes += admitted.byteLength;
+                    if (connection.pendingBytes > maxOpeningInputBytes) {
+                        socket.close(1009, 'pty-opening-input-limit');
+                        observeCleanup(connection);
+                        return;
+                    }
+                    connection.pending.push(admitted.data);
+                    return;
+                }
+                const deliveryFailure = captureFailure(() => deliver(session, admitted.data));
+                if (deliveryFailure) {
+                    failures.push(deliveryFailure);
+                    const closeFailure = captureFailure(() => socket.close(1011, 'pty-session-failed'));
+                    if (closeFailure)
+                        failures.push(closeFailure);
+                    observeCleanup(connection);
+                }
+            },
+            close(socket) {
+                observeCleanup(socket.data);
+            }
+        }
+    });
+    return {
+        server,
+        close() {
+            closing ??= (async () => {
+                server.stop(true);
+                await runtime.lifecycle.wait(async () => {
+                    await Promise.all([...connections].map(cleanup));
+                }, { timeoutMs: 10_000, reason: 'pty-bridge-session-cleanup' });
+                if (failures.length > 0) {
+                    throw new AggregateError(failures, 'PTY bridge session cleanup failed');
+                }
+            })();
+            return closing;
+        }
+    };
+}
+/** Parse only captured host input; environment selection remains execution-owned. */
+export function ptyServerConfigFromEnv(runtime, argv = []) {
+    const host = {
+        platform: runtime.localEnvironment.getPlatform?.(),
+        snapshot: runtime.getEnvSnapshot()
+    };
+    const read = (key) => readEnv(host, key);
+    const port = Number(read('PTY_WS_PORT') ?? argv[0] ?? '7681');
+    if (!Number.isInteger(port) || port <= 0 || port > 65_535) {
+        throw new CapabilityError('Invalid PTY bridge port.', 'INVALID_INPUT', {
+            reason: 'pty-port-invalid',
+            retryable: false
+        });
+    }
+    let policy;
+    try {
+        policy = JSON.parse(read('PTY_WS_ENV_POLICY') ?? 'null');
+    }
+    catch (cause) {
+        throw new CapabilityError('Invalid PTY environment policy.', 'INVALID_INPUT', {
+            reason: 'pty-environment-policy-invalid',
+            retryable: false,
+            cause
+        });
+    }
+    requireExecutionEnvironmentMode(policy);
+    let args = argv.slice(2);
+    const argsJson = read('PTY_WS_ARGS');
+    if (argsJson !== undefined) {
+        try {
+            args = JSON.parse(argsJson);
+        }
+        catch (cause) {
+            throw new CapabilityError('Invalid PTY argument list.', 'INVALID_INPUT', {
+                reason: 'pty-arguments-invalid',
+                retryable: false,
+                cause
+            });
+        }
+    }
+    return {
+        ...policy,
+        port,
+        command: read('PTY_WS_COMMAND') ?? argv[1] ?? 'bash',
+        args,
+        cwd: read('PTY_WS_CWD'),
+        cols: read('PTY_WS_COLS') ? Number(read('PTY_WS_COLS')) : undefined,
+        rows: read('PTY_WS_ROWS') ? Number(read('PTY_WS_ROWS')) : undefined
+    };
+}
+/** Executable boundary: caller supplies the installed module-graph root. */
+export async function runPtyWsServerFromCli(hostRoot = Bun.argv[2]) {
+    if (!hostRoot) {
+        throw new CapabilityError('PTY bridge requires its host module root.', 'INVALID_INPUT', {
+            reason: 'pty-host-root-missing',
+            retryable: false
+        });
+    }
+    const runtime = await bootstrapVibesRuntime({
+        binding: 'owned',
+        environment: createRuntimeEnvironmentBunPlugin({
+            host: { root: hostRoot },
+            heldLaunch: { manifestPath: join(hostRoot, 'native/held-launch/manifest.json') },
+            scope: {
+                surface: 'cli',
+                hardware: 'consumer',
+                purpose: 'direct',
+                lifecycle: 'persistent',
+                hosting: { mode: 'local', owner: 'consumer', venue: 'user-device' }
+            }
+        }),
+        composition: { kind: 'literal', plugins: [] }
+    });
+    let bridge;
+    try {
+        bridge = await startPtyWsServer(runtime, ptyServerConfigFromEnv(runtime, Bun.argv.slice(3)));
+        const stdio = await getRuntimeStdio(runtime);
+        stdio.write('stdout', `[terminal-pty-bridge] listening on ${bridge.server.hostname}:${bridge.server.port}\n`);
+        await new Promise((resolve) => {
+            const stop = () => {
+                process.off('SIGTERM', stop);
+                process.off('SIGINT', stop);
+                resolve();
+            };
+            process.once('SIGTERM', stop);
+            process.once('SIGINT', stop);
+        });
+    }
+    finally {
+        try {
+            await bridge?.close();
+        }
+        finally {
+            await runtime.dispose();
+        }
+    }
+}
+if (import.meta.main)
+    await runPtyWsServerFromCli();
+//# sourceMappingURL=terminal-pty-bridge.impl.bun.js.map

package/dist/terminal-pty-bridge.impl.bun.js.map

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

package/dist/test-tooling/lazy-environment.impl.bun.d.ts

@@ -0,0 +1,16 @@
+import type { RuntimePlugin, RuntimeScope } from '@vibesdotdev/kernel';
+import type { createRuntimeEnvironmentBunPlugin as EnvironmentFactory } from '../index.ts';
+import type { bunHttpListenerPlugin as HttpListenerFactory } from '../http-listener.impl.bun.ts';
+import type { bunLocalExecutionPlugin as LocalExecutionFactory } from '../local-execution.impl.bun.ts';
+/** The environment plugin factory of the package root, loaded on first call. */
+export declare const createRuntimeEnvironmentBunPlugin: typeof EnvironmentFactory;
+/** The local-execution plugin factory of `./local-execution`, loaded on first call. */
+export declare const bunLocalExecutionPlugin: typeof LocalExecutionFactory;
+/** The HTTP-listener plugin factory of `./http-listener`, loaded on first call. */
+export declare const bunHttpListenerPlugin: typeof HttpListenerFactory;
+/** The environment a test execution runtime composes when the test supplies none: the Bun host over one fixture home. */
+export declare function createBunTestExecutionEnvironment(options: {
+    scope: RuntimeScope;
+    home: string;
+}): RuntimePlugin;
+//# sourceMappingURL=lazy-environment.impl.bun.d.ts.map

package/dist/test-tooling/lazy-environment.impl.bun.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy-environment.impl.bun.d.ts","sourceRoot":"","sources":["../../src/test-tooling/lazy-environment.impl.bun.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,KAAK,EAAE,iCAAiC,IAAI,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAC3F,OAAO,KAAK,EAAE,qBAAqB,IAAI,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACjG,OAAO,KAAK,EAAE,uBAAuB,IAAI,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAsBvG,gFAAgF;AAChF,eAAO,MAAM,iCAAiC,EAAE,OAAO,kBACQ,CAAC;AAEhE,uFAAuF;AACvF,eAAO,MAAM,uBAAuB,EAAE,OAAO,qBACW,CAAC;AAEzD,mFAAmF;AACnF,eAAO,MAAM,qBAAqB,EAAE,OAAO,mBACS,CAAC;AAErD,yHAAyH;AACzH,wBAAgB,iCAAiC,CAAC,OAAO,EAAE;IAAE,KAAK,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,aAAa,CAE/G"}

package/dist/test-tooling/lazy-environment.impl.bun.js

@@ -0,0 +1,36 @@
+/**
+ * The Bun host's plugin factories for test composition roots, loaded on first call.
+ *
+ * `@vibesdotdev/testing/test-environment` offers these under the Bun host's own names. They must not be
+ * reachable from that root's import graph: the host's restricted-execution supervisor is a Bun-only
+ * `with { type: 'text' }` import, and a Vite-evaluated graph (a Vitest file) executes that supervisor as
+ * a module and blocks on its descriptor read. This module's graph holds types and `node:module` only; each
+ * factory loads the real host through the host's own module loader when it is first called, where Bun's
+ * native loader resolves the text import.
+ */
+import { createRequire } from 'node:module';
+const loadHost = createRequire(import.meta.url);
+// The specifiers are the package's own subpaths, resolved from this file's package, so source and dist agree.
+function environmentModule() {
+    // SAFETY: the specifier names this package's `.` export, whose shape `EnvironmentModule` states.
+    return loadHost('@vibesdotdev/host-bun');
+}
+function localExecutionModule() {
+    // SAFETY: the specifier names this package's `./local-execution` export, whose shape `LocalExecutionModule` states.
+    return loadHost('@vibesdotdev/host-bun/local-execution');
+}
+function httpListenerModule() {
+    // SAFETY: the specifier names this package's `./http-listener` export, whose shape `HttpListenerModule` states.
+    return loadHost('@vibesdotdev/host-bun/http-listener');
+}
+/** The environment plugin factory of the package root, loaded on first call. */
+export const createRuntimeEnvironmentBunPlugin = (...args) => environmentModule().createRuntimeEnvironmentBunPlugin(...args);
+/** The local-execution plugin factory of `./local-execution`, loaded on first call. */
+export const bunLocalExecutionPlugin = (...args) => localExecutionModule().bunLocalExecutionPlugin(...args);
+/** The HTTP-listener plugin factory of `./http-listener`, loaded on first call. */
+export const bunHttpListenerPlugin = (...args) => httpListenerModule().bunHttpListenerPlugin(...args);
+/** The environment a test execution runtime composes when the test supplies none: the Bun host over one fixture home. */
+export function createBunTestExecutionEnvironment(options) {
+    return createRuntimeEnvironmentBunPlugin({ scope: options.scope, paths: { vibesHome: options.home } });
+}
+//# sourceMappingURL=lazy-environment.impl.bun.js.map