@vibesdotdev/terminal-client 0.0.0-stage → 1.0.0-rc.2

package/dist/remote-session.js

@@ -0,0 +1,326 @@
+/**
+ * remote-session — adapt an RPC session WIRE-PROXY into a real `ExecutionSession`.
+ *
+ * `openRemoteSession` reaches a fleet host's `runtime/execution` impl over L4's
+ * RPC and calls `session(opts)`. What comes back is NOT an `ExecutionSession` — it
+ * is a kind-agnostic wire proxy (`makeRemoteProxy`) whose surface is:
+ *
+ *   - the methods the OWNER declared when it classified the session as a ref
+ *     (`write` / `resize` / `signal` / `exited` / `kill`) — each an `invoke` that
+ *     resolves to a Promise; and
+ *   - `__openStream(channel)` — opens the raw byte channel (`stream` verb) the PTY
+ *     output rides (the consumer names the channel `'pty'`, never the protocol).
+ *
+ * The terminal-svelte `<Terminal>` component consumes the canonical L3
+ * `ExecutionSession` interface UNCHANGED — synchronous `write`/`resize`/`signal`/
+ * `kill`, an `onOutput(handler) => unsubscribe`, an `exited(): Promise<…>`, and the
+ * readonly `id`/`environmentId`. This adapter is the bridge: it makes a proxy
+ * session look IDENTICAL to a local one so the component never forks on transport
+ * (the whole point of the proxy model — terminal.md §"Target design").
+ *
+ * Remoteness stays VISIBLE in behavior (Correction #1): when the transport drops,
+ * `exited()` rejects with `RPC_DISCONNECTED` (the proxy invoke fails) — which the
+ * component already renders as a disconnect banner. This adapter never silently
+ * swallows a disconnect into a clean exit.
+ *
+ * This module ships NO transport of its own — it composes the proxy `runtime-rpc`
+ * already minted. It only translates async-proxy semantics into the synchronous
+ * `ExecutionSession` shape the renderer expects.
+ */
+import { CapabilityError, settle, CaughtFailureSchema } from '@vibesdotdev/kernel';
+import { getLogger } from '@vibesdotdev/logging';
+import { tryGetVibesClient } from '@vibesdotdev/kernel/client';
+/** The channel name the PTY output/stdin rides. The CONSUMER names it (terminal.md §L4). */
+const PTY_CHANNEL = 'pty';
+import { RemoteSessionProxySchema, RpcChannelSchema, HostIdSchema } from "./schemas/remote.js";
+function invalidRemoteSession(reason, cause) {
+    return new CapabilityError('The remote terminal session contract is invalid.', 'UNAVAILABLE', {
+        reason,
+        retryable: false,
+        cause
+    });
+}
+/**
+ * Wrap a session wire-proxy in the canonical `ExecutionSession` interface.
+ *
+ * @param proxy   the wire proxy returned by `exec.session(opts)` over RPC.
+ * @param hostId  the explicitly-named host (for a stable, descriptive session id).
+ * @param onClose optional teardown run when the session is killed/exited — used by
+ *                the client to dispose the underlying RPC connection so a closed
+ *                terminal frees the remote PTY *and* its socket (no leak).
+ */
+export function adaptRemoteSession(runtime, proxyInput, hostIdInput, onClose) {
+    let proxy;
+    let hostId;
+    try {
+        proxy = RemoteSessionProxySchema.parse(proxyInput);
+        hostId = HostIdSchema.parse(hostIdInput);
+    }
+    catch (cause) {
+        throw invalidRemoteSession('terminal-remote-session-proxy-invalid', CaughtFailureSchema.parse(cause));
+    }
+    const logger = getLogger('terminal.remote-session', runtime);
+    // id/environmentId are not carried on the wire (they were readonly props, not
+    // invoke-able methods). Synthesize a stable, descriptive identity rooted in the
+    // host ref so the renderer + logs can name the session. The component does not
+    // read environmentId (terminal.md §ExecutionSession), so the host id stands in.
+    const client = tryGetVibesClient('terminal', runtime);
+    if (!client)
+        throw invalidRemoteSession('terminal-client-not-active');
+    const id = client.nextRemoteSessionId(hostId);
+    // Subscribers attach synchronously (the component calls onOutput() inside
+    // onMount), but the byte channel opens asynchronously. We open it once on first
+    // subscribe, fan the channel's bytes out to every handler, and queue any output
+    // that arrives before the very first handler registers so nothing is dropped.
+    const handlers = new Set();
+    let channel = null;
+    let channelOpening = null;
+    let closed = false;
+    const earlyBuffer = [];
+    // Stdin written before the byte channel is live. We hold it and flush THROUGH the
+    // channel once it opens, rather than racing a `write` invoke against the
+    // channel's onData binding — if the command ran before the owner bound the
+    // channel, its output would be produced before anything was listening and lost.
+    // Queuing stdin until the channel is up guarantees the renderer sees the echo.
+    const pendingStdin = [];
+    const fanOut = (bytes) => {
+        if (handlers.size === 0) {
+            // No subscriber yet — retain so the renderer never misses the PTY's
+            // opening bytes (prompt/banner) it printed before onOutput ran.
+            earlyBuffer.push(bytes);
+            return;
+        }
+        for (const handler of handlers) {
+            handler(bytes);
+        }
+    };
+    // Drain the queued stdin through the live channel in strict FIFO order. Only ever
+    // called once the channel is open AND its onData binding is in place, so the
+    // command's resulting output is captured rather than produced into the void.
+    const flushPendingStdin = (ch) => {
+        if (pendingStdin.length === 0)
+            return;
+        const queued = pendingStdin.splice(0);
+        for (const bytes of queued) {
+            try {
+                ch.write(bytes);
+            }
+            catch (cause) {
+                throw new CapabilityError('The remote terminal input could not be delivered.', 'UNAVAILABLE', {
+                    reason: 'terminal-remote-stdin-flush-failed',
+                    retryable: true,
+                    cause
+                });
+            }
+        }
+    };
+    const ensureChannel = () => {
+        if (channel || closed)
+            return Promise.resolve();
+        if (channelOpening)
+            return channelOpening;
+        channelOpening = proxy
+            .__openStream(PTY_CHANNEL)
+            .then(async (channelInput) => {
+            const openedChannel = RpcChannelSchema.parse(channelInput);
+            if (closed) {
+                await openedChannel.close();
+                return;
+            }
+            channel = openedChannel;
+            // Bind onData BEFORE flushing queued stdin so the owner is already
+            // streaming output back by the time the queued command bytes land — the
+            // `__openStream('pty')`-before-write ordering the http transport test
+            // relies on. (Flushing first would let the command run and emit output
+            // before anything was listening, dropping the opening bytes.)
+            openedChannel.onData((data) => fanOut(new Uint8Array(data)));
+            flushPendingStdin(openedChannel);
+        })
+            .catch((cause) => {
+            throw new CapabilityError('The remote terminal channel could not be opened.', 'UNAVAILABLE', {
+                reason: 'terminal-remote-channel-open-failed',
+                retryable: true,
+                cause
+            });
+        });
+        return channelOpening;
+    };
+    const observeChannelOpening = () => {
+        void ensureChannel()
+            .then(() => ({ kind: 'success' }), (cause) => ({
+            kind: 'failure',
+            failure: CaughtFailureSchema.parse(cause)
+        }))
+            .then((outcome) => {
+            if (outcome.kind === 'failure' && !runtime.disposed) {
+                logger.error('remote terminal channel failed to open', { error: outcome.failure });
+            }
+        });
+    };
+    // Fire a proxy invoke without awaiting (the ExecutionSession surface is sync).
+    // A rejection (e.g. RPC_DISCONNECTED) is observed here so a keystroke after a
+    // drop does not become an unhandled rejection. The disconnect is also surfaced
+    // authoritatively via exited()'s rejection, which the component listens for.
+    const fireAndForget = (operation) => {
+        void operation
+            .then(() => ({ kind: 'success' }), (cause) => ({
+            kind: 'failure',
+            failure: CaughtFailureSchema.parse(cause)
+        }))
+            .then((outcome) => {
+            if (outcome.kind === 'failure' && !runtime.disposed) {
+                logger.error('remote terminal operation failed', { error: outcome.failure });
+            }
+        });
+    };
+    const captureCleanupFailure = (operation) => {
+        try {
+            operation();
+            return null;
+        }
+        catch (cause) {
+            return CaughtFailureSchema.parse(cause);
+        }
+    };
+    let closing;
+    let exitObservation;
+    const teardown = (terminate = true) => {
+        if (closing)
+            return closing;
+        closed = true;
+        handlers.clear();
+        earlyBuffer.length = 0;
+        pendingStdin.length = 0;
+        const failures = [];
+        const closingChannel = channel;
+        channel = null;
+        closing = (async () => {
+            // Releasing a proxy only releases its reference. Terminate the PTY
+            // explicitly while live. On runtime disposal the kernel connection's
+            // acknowledged owned-reference drain terminates it, including unopened PTYs.
+            if (terminate && !runtime.lifecycle.signal.aborted) {
+                const killed = await settle(() => proxy.kill());
+                if (!killed.ok)
+                    failures.push(killed.cause);
+            }
+            // A stream open may still be in flight. Its closed branch joins the
+            // newly opened channel's close before the connection is released.
+            const opened = await settle(() => channelOpening);
+            if (!opened.ok)
+                failures.push(opened.cause);
+            const channelClosed = await settle(() => closingChannel?.close());
+            if (!channelClosed.ok)
+                failures.push(channelClosed.cause);
+            const disposeFailure = captureCleanupFailure(() => proxy[Symbol.dispose]());
+            if (disposeFailure)
+                failures.push(disposeFailure);
+            const closedRemote = await settle(() => onClose?.());
+            if (!closedRemote.ok)
+                failures.push(closedRemote.cause);
+            if (failures.length === 1)
+                throw failures[0];
+            if (failures.length > 1)
+                throw new AggregateError(failures, 'Remote terminal cleanup failed.');
+        })().finally(() => release());
+        return closing;
+    };
+    const release = client.ownRemoteSession(teardown);
+    const observeExit = () => {
+        exitObservation ??= (async () => {
+            const observed = await settle(async () => {
+                await ensureChannel();
+                return await proxy.exited();
+            });
+            const cleanup = await settle(() => teardown(false));
+            if (!observed.ok && !cleanup.ok) {
+                throw new AggregateError([observed.cause, cleanup.cause], 'Remote terminal exit observation and connection cleanup failed.');
+            }
+            if (!observed.ok)
+                throw observed.cause;
+            if (!cleanup.ok)
+                throw cleanup.cause;
+            return observed.value;
+        })();
+        return exitObservation;
+    };
+    return {
+        id,
+        environmentId: hostId,
+        write(data) {
+            if (closed)
+                return;
+            const admitted = new Uint8Array(data);
+            // Stdin rides the raw stream channel (the PTY fast-path, no per-byte invoke
+            // envelope). Until the channel is open, QUEUE the bytes and open it; the
+            // queue flushes through the channel once its onData binding is live, so the
+            // command's output is never produced before anything is listening for it.
+            //
+            // Ordering hazard (the write-before-channel-open race): a direct
+            // channel.write here must NOT jump ahead of bytes still sitting in
+            // pendingStdin (which flush from inside ensureChannel's stream-open .then).
+            // So we only fast-path a direct write when the channel is open AND the queue
+            // is already drained; otherwise the byte joins the queue and rides the same
+            // strict-FIFO flush. This mirrors the passing http transport ordering
+            // (`__openStream('pty')` is awaited and onData bound BEFORE any write lands).
+            if (channel && pendingStdin.length === 0) {
+                try {
+                    channel.write(admitted);
+                }
+                catch (cause) {
+                    throw new CapabilityError('The remote terminal input could not be delivered.', 'UNAVAILABLE', {
+                        reason: 'terminal-remote-stdin-write-failed',
+                        retryable: true,
+                        cause
+                    });
+                }
+                return;
+            }
+            // Channel not open yet, OR a queued byte is still ahead of this one: append
+            // and let the strict-FIFO flush deliver it. If the channel is already live
+            // (the queue just hasn't drained), flush now; otherwise open it.
+            pendingStdin.push(admitted);
+            if (channel) {
+                flushPendingStdin(channel);
+            }
+            else {
+                observeChannelOpening();
+            }
+        },
+        onOutput(handler) {
+            if (closed)
+                return () => { };
+            handlers.add(handler);
+            // Replay anything that arrived before the first subscriber, then open the
+            // channel (idempotent) so subsequent PTY output flows.
+            if (earlyBuffer.length > 0) {
+                const queued = earlyBuffer.splice(0);
+                for (const bytes of queued)
+                    handler(bytes);
+            }
+            observeChannelOpening();
+            return () => {
+                handlers.delete(handler);
+            };
+        },
+        resize(cols, rows) {
+            if (closed)
+                return;
+            fireAndForget(proxy.resize(cols, rows));
+        },
+        signal(sig) {
+            if (closed)
+                return;
+            fireAndForget(proxy.signal(sig));
+        },
+        exited: observeExit,
+        kill() {
+            if (closed)
+                return;
+            // Observe exit even when the caller drops the handle after killing it.
+            // Cleanup waits for the native exit reply before closing the connection.
+            fireAndForget(observeExit().then(() => undefined));
+            fireAndForget(proxy.kill());
+        }
+    };
+}
+//# sourceMappingURL=remote-session.js.map

package/dist/remote-session.js.map

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

package/dist/schemas/http.d.ts

@@ -0,0 +1,61 @@
+import { type CapabilityErrorCode } from '@vibesdotdev/kernel';
+import * as z from 'zod/v4';
+export declare const HttpSessionOpenResponseSchema: z.ZodObject<{
+    id: z.ZodString;
+    environmentId: z.ZodString;
+}, z.core.$strict>;
+export declare const HttpSessionExitEventSchema: z.ZodObject<{
+    exitCode: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const HttpSessionFailureEventSchema: z.ZodObject<{
+    code: z.ZodCustom<CapabilityErrorCode, CapabilityErrorCode>;
+    reason: z.ZodString;
+    message: z.ZodString;
+    retryable: z.ZodBoolean;
+}, z.core.$loose>;
+export declare const ReconnectOptionsSchema: z.ZodObject<{
+    maxAttempts: z.ZodDefault<z.ZodNumber>;
+    baseDelayMs: z.ZodDefault<z.ZodNumber>;
+    maxDelayMs: z.ZodDefault<z.ZodNumber>;
+    onReconnecting: z.ZodOptional<z.ZodCustom<(attempt: number, delayMs: number) => void, (attempt: number, delayMs: number) => void>>;
+    onReconnected: z.ZodOptional<z.ZodCustom<(attempt: number) => void, (attempt: number) => void>>;
+}, z.core.$strict>;
+export declare const OpenHttpSessionOptionsSchema: z.ZodObject<{
+    command: z.ZodOptional<z.ZodString>;
+    args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    cols: z.ZodNumber;
+    rows: z.ZodNumber;
+    baseUrl: z.ZodDefault<z.ZodString>;
+    timeoutMs: z.ZodDefault<z.ZodNumber>;
+    signal: z.ZodOptional<z.ZodCustom<AbortSignal, AbortSignal>>;
+    extra: z.ZodOptional<z.ZodType<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/schemas/json").JsonObject, import("@vibesdotdev/kernel/schemas/json").JsonObject>>>;
+    reconnect: z.ZodPrefault<z.ZodUnion<readonly [z.ZodObject<{
+        maxAttempts: z.ZodDefault<z.ZodNumber>;
+        baseDelayMs: z.ZodDefault<z.ZodNumber>;
+        maxDelayMs: z.ZodDefault<z.ZodNumber>;
+        onReconnecting: z.ZodOptional<z.ZodCustom<(attempt: number, delayMs: number) => void, (attempt: number, delayMs: number) => void>>;
+        onReconnected: z.ZodOptional<z.ZodCustom<(attempt: number) => void, (attempt: number) => void>>;
+    }, z.core.$strict>, z.ZodLiteral<false>]>>;
+    existingId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type ReconnectOptions = z.input<typeof ReconnectOptionsSchema>;
+export type OpenHttpSessionOptions = z.input<typeof OpenHttpSessionOptionsSchema>;
+export declare const MessageEventDataSchema: z.ZodObject<{
+    data: z.ZodString;
+}, z.core.$strip>;
+export interface TerminalEventSource extends EventTarget {
+    close(): void;
+    onerror: ((event: Event) => void) | null;
+}
+export interface TerminalEventSourceConstructor {
+    new (url: string): TerminalEventSource;
+}
+export declare const TerminalEventSourceConstructorSchema: z.ZodCustom<TerminalEventSourceConstructor, TerminalEventSourceConstructor>;
+export declare const TerminalHttpVerbSchema: z.ZodEnum<{
+    write: "write";
+    signal: "signal";
+    resize: "resize";
+    kill: "kill";
+}>;
+export type TerminalHttpVerb = z.infer<typeof TerminalHttpVerbSchema>;
+//# sourceMappingURL=http.d.ts.map

package/dist/schemas/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/schemas/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACtF,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAI5B,eAAO,MAAM,6BAA6B;;;kBAG/B,CAAC;AAEZ,eAAO,MAAM,0BAA0B;;kBAE5B,CAAC;AAEZ,eAAO,MAAM,6BAA6B;;;;;iBAQ1B,CAAC;AAEjB,eAAO,MAAM,sBAAsB;;;;wDAIC,MAAM,WAAW,MAAM,KAAK,IAAI,YAAhC,MAAM,WAAW,MAAM,KAAK,IAAI;uDAGjC,MAAM,KAAK,IAAI,YAAf,MAAM,KAAK,IAAI;kBAGvC,CAAC;AAEZ,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;4DARL,MAAM,WAAW,MAAM,KAAK,IAAI,YAAhC,MAAM,WAAW,MAAM,KAAK,IAAI;2DAGjC,MAAM,KAAK,IAAI,YAAf,MAAM,KAAK,IAAI;;;kBAkBvC,CAAC;AAEZ,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF,eAAO,MAAM,sBAAsB;;iBAAiC,CAAC;AAErE,MAAM,WAAW,mBAAoB,SAAQ,WAAW;IACvD,KAAK,IAAI,IAAI,CAAC;IACd,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,8BAA8B;IAC9C,KAAK,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAAC;CACvC;AAED,eAAO,MAAM,oCAAoC,6EAEhD,CAAC;AAEF,eAAO,MAAM,sBAAsB;;;;;EAAgD,CAAC;AACpF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/schemas/http.js

@@ -0,0 +1,45 @@
+import { isCapabilityErrorCode } from '@vibesdotdev/kernel';
+import * as z from 'zod/v4';
+import { OpenTerminalOptionsSchema } from "./session.js";
+import { JsonObjectSchema } from '@vibesdotdev/kernel/schemas/json';
+export const HttpSessionOpenResponseSchema = z.object({
+    id: z.string().min(1),
+    environmentId: z.string().min(1)
+}).strict();
+export const HttpSessionExitEventSchema = z.object({
+    exitCode: z.number().int().nullable()
+}).strict();
+export const HttpSessionFailureEventSchema = z.object({
+    code: z.custom(value => {
+        const parsed = z.string().safeParse(value);
+        return parsed.success && isCapabilityErrorCode(parsed.data);
+    }),
+    reason: z.string().min(1),
+    message: z.string().min(1),
+    retryable: z.boolean()
+}).passthrough();
+export const ReconnectOptionsSchema = z.object({
+    maxAttempts: z.number().int().nonnegative().default(8),
+    baseDelayMs: z.number().int().nonnegative().default(200),
+    maxDelayMs: z.number().int().nonnegative().default(10_000),
+    onReconnecting: z.custom((value) => z.function().safeParse(value).success).optional(),
+    onReconnected: z.custom((value) => z.function().safeParse(value).success).optional()
+}).strict();
+export const OpenHttpSessionOptionsSchema = z.object({
+    command: OpenTerminalOptionsSchema.shape.command.optional(),
+    args: OpenTerminalOptionsSchema.shape.args,
+    cols: OpenTerminalOptionsSchema.shape.cols,
+    rows: OpenTerminalOptionsSchema.shape.rows,
+    baseUrl: z.string().default(''),
+    /** Bound HTTP admission and control requests through the owning lifecycle. */
+    timeoutMs: z.number().int().positive().max(120_000).default(30_000),
+    /** Cancels admission; it does not terminate an already-open session. */
+    signal: z.custom(value => value instanceof AbortSignal).optional(),
+    extra: JsonObjectSchema.optional(),
+    reconnect: z.union([ReconnectOptionsSchema, z.literal(false)]).prefault({}),
+    existingId: z.string().min(1).optional()
+}).strict();
+export const MessageEventDataSchema = z.object({ data: z.string() });
+export const TerminalEventSourceConstructorSchema = z.custom((value) => z.function().safeParse(value).success);
+export const TerminalHttpVerbSchema = z.enum(['write', 'resize', 'signal', 'kill']);
+//# sourceMappingURL=http.js.map

package/dist/schemas/http.js.map

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

package/dist/schemas/remote.d.ts

@@ -0,0 +1,25 @@
+import * as z from 'zod/v4';
+import type { RpcChannel } from '@vibesdotdev/kernel-rpc';
+export declare const RemoteSessionProxySchema: z.ZodCustom<{
+    write: (data: Uint8Array) => Promise<void>;
+    resize: (cols: number, rows: number) => Promise<void>;
+    signal: (signal: string) => Promise<void>;
+    exited: () => Promise<{
+        exitCode: number | null;
+    }>;
+    kill: () => Promise<void>;
+    __openStream: (channel: string) => Promise<RpcChannel>;
+} & Disposable, {
+    write: (data: Uint8Array) => Promise<void>;
+    resize: (cols: number, rows: number) => Promise<void>;
+    signal: (signal: string) => Promise<void>;
+    exited: () => Promise<{
+        exitCode: number | null;
+    }>;
+    kill: () => Promise<void>;
+    __openStream: (channel: string) => Promise<RpcChannel>;
+} & Disposable>;
+export declare const RpcChannelSchema: z.ZodCustom<RpcChannel, RpcChannel>;
+export declare const HostIdSchema: z.ZodString;
+export type RemoteSessionProxy = z.infer<typeof RemoteSessionProxySchema>;
+//# sourceMappingURL=remote.d.ts.map

package/dist/schemas/remote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../../src/schemas/remote.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAoB1D,eAAO,MAAM,wBAAwB;kBAdb,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC;mBAC3B,MAAM,QAAQ,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC;qBACpC,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC;kBAC3B,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;gBACtC,OAAO,CAAC,IAAI,CAAC;4BACD,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC;;kBALxC,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC;mBAC3B,MAAM,QAAQ,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC;qBACpC,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC;kBAC3B,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;gBACtC,OAAO,CAAC,IAAI,CAAC;4BACD,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC;eAY9D,CAAC;AACH,eAAO,MAAM,gBAAgB,qCAE5B,CAAC;AACF,eAAO,MAAM,YAAY,aAAoC,CAAC;AAG9D,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/schemas/remote.js

@@ -0,0 +1,23 @@
+import * as z from 'zod/v4';
+const CallableSchema = z.function();
+const callable = () => z.custom(value => CallableSchema.safeParse(value).success);
+const RemoteSessionProxyContractSchema = z.object({
+    write: callable(),
+    resize: callable(),
+    signal: callable(),
+    exited: callable(),
+    kill: callable(),
+    __openStream: callable()
+});
+const DisposableCandidateSchema = z.custom((value) => z.object({}).passthrough().safeParse(value).success);
+const DisposableContractSchema = z.custom((value) => {
+    const parsed = DisposableCandidateSchema.safeParse(value);
+    return parsed.success && CallableSchema.safeParse(parsed.data[Symbol.dispose]).success;
+});
+export const RemoteSessionProxySchema = z.custom((value) => {
+    return RemoteSessionProxyContractSchema.safeParse(value).success &&
+        DisposableContractSchema.safeParse(value).success;
+});
+export const RpcChannelSchema = z.custom((value) => z.object({ write: CallableSchema, onData: CallableSchema, close: CallableSchema }).safeParse(value).success);
+export const HostIdSchema = z.string().trim().min(1).max(256);
+//# sourceMappingURL=remote.js.map

package/dist/schemas/remote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote.js","sourceRoot":"","sources":["../../src/schemas/remote.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B,MAAM,cAAc,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC;AACpC,MAAM,QAAQ,GAAG,GAAM,EAAE,CACxB,CAAC,CAAC,MAAM,CAAI,KAAK,CAAC,EAAE,CAAC,cAAc,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC;AAC/D,MAAM,gCAAgC,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,KAAK,EAAE,QAAQ,EAAuC;IACtD,MAAM,EAAE,QAAQ,EAAiD;IACjE,MAAM,EAAE,QAAQ,EAAqC;IACrD,MAAM,EAAE,QAAQ,EAA8C;IAC9D,IAAI,EAAE,QAAQ,EAAuB;IACrC,YAAY,EAAE,QAAQ,EAA4C;CAClE,CAAC,CAAC;AACH,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CACzC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAC9D,CAAC;AACF,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAa,CAAC,KAAK,EAAE,EAAE;IAC/D,MAAM,MAAM,GAAG,yBAAyB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC1D,OAAO,MAAM,CAAC,OAAO,IAAI,cAAc,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;AACxF,CAAC,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAgE,CAAC,KAAK,EAAE,EAAE;IACzH,OAAO,gCAAgC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO;QAC/D,wBAAwB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;AACpD,CAAC,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAa,CAAC,KAAK,EAAE,EAAE,CAC9D,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAC3G,CAAC;AACF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC"}

package/dist/schemas/session.d.ts

@@ -0,0 +1,26 @@
+import * as z from 'zod/v4';
+export declare const OpenTerminalOptionsSchema: z.ZodObject<{
+    command: z.ZodString;
+    args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    cols: z.ZodNumber;
+    rows: z.ZodNumber;
+    cwd: z.ZodOptional<z.ZodString>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strict>;
+export type OpenTerminalOptions = z.infer<typeof OpenTerminalOptionsSchema>;
+/** Kernel RuntimeRefHandle wire shape; kernel currently exports its type only. */
+export declare const TerminalHostRefSchema: z.ZodObject<{
+    runtimeId: z.ZodString;
+    local: z.ZodBoolean;
+    mountGeneration: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const SessionOpenOptionsSchema: z.ZodObject<{
+    command: z.ZodString;
+    args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    cols: z.ZodNumber;
+    rows: z.ZodNumber;
+    cwd: z.ZodOptional<z.ZodString>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strict>;
+export type SessionOpenOptions = z.infer<typeof SessionOpenOptionsSchema>;
+//# sourceMappingURL=session.d.ts.map

package/dist/schemas/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/schemas/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,eAAO,MAAM,yBAAyB;;;;;;;kBAO3B,CAAC;AACZ,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,kFAAkF;AAClF,eAAO,MAAM,qBAAqB;;;;iBAIhC,CAAC;AACH,eAAO,MAAM,wBAAwB;;;;;;;kBAA4B,CAAC;AAClE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/schemas/session.js

@@ -0,0 +1,17 @@
+import * as z from 'zod/v4';
+export const OpenTerminalOptionsSchema = z.object({
+    command: z.string().min(1),
+    args: z.array(z.string()).optional(),
+    cols: z.number().int().positive(),
+    rows: z.number().int().positive(),
+    cwd: z.string().min(1).optional(),
+    env: z.record(z.string(), z.string()).optional()
+}).strict();
+/** Kernel RuntimeRefHandle wire shape; kernel currently exports its type only. */
+export const TerminalHostRefSchema = z.object({
+    runtimeId: z.string().trim().min(1),
+    local: z.boolean(),
+    mountGeneration: z.number().int().nonnegative().optional()
+});
+export const SessionOpenOptionsSchema = OpenTerminalOptionsSchema;
+//# sourceMappingURL=session.js.map

package/dist/schemas/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/schemas/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACjC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACjC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACjC,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CAChD,CAAC,CAAC,MAAM,EAAE,CAAC;AAGZ,kFAAkF;AAClF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACnC,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE;IAClB,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;CAC1D,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,yBAAyB,CAAC"}

package/dist/schemas/store.d.ts

@@ -0,0 +1,29 @@
+import * as z from 'zod/v4';
+import type { ExecutionSession } from '@vibesdotdev/kernel/execution';
+import type { SessionOpenOptions } from './session.ts';
+export declare const TerminalSessionStoreOptionsSchema: z.ZodObject<{
+    maxSessions: z.ZodDefault<z.ZodNumber>;
+    idleTimeoutMs: z.ZodDefault<z.ZodNumber>;
+    reaperIntervalMs: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+export type TerminalSessionStoreOptions = z.input<typeof TerminalSessionStoreOptionsSchema>;
+export declare const SessionOpenerSchema: z.ZodCustom<(opts: SessionOpenOptions) => Promise<ExecutionSession>, (opts: SessionOpenOptions) => Promise<ExecutionSession>>;
+export declare const ExecutionSessionContractSchema: z.ZodObject<{
+    id: z.ZodString;
+    environmentId: z.ZodString;
+    write: z.ZodFunction<z.core.$ZodFunctionArgs, z.core.$ZodFunctionOut>;
+    onOutput: z.ZodFunction<z.core.$ZodFunctionArgs, z.core.$ZodFunctionOut>;
+    resize: z.ZodFunction<z.core.$ZodFunctionArgs, z.core.$ZodFunctionOut>;
+    signal: z.ZodFunction<z.core.$ZodFunctionArgs, z.core.$ZodFunctionOut>;
+    exited: z.ZodFunction<z.core.$ZodFunctionArgs, z.core.$ZodFunctionOut>;
+    kill: z.ZodFunction<z.core.$ZodFunctionArgs, z.core.$ZodFunctionOut>;
+}, z.core.$strip>;
+export declare const ExecutionSessionSchema: z.ZodCustom<ExecutionSession, ExecutionSession>;
+export declare const SessionIdentitySchema: z.ZodString;
+export declare const ResizeSchema: z.ZodObject<{
+    cols: z.ZodNumber;
+    rows: z.ZodNumber;
+}, z.core.$strict>;
+export declare const SignalSchema: z.ZodString;
+export type SessionOpener = z.infer<typeof SessionOpenerSchema>;
+//# sourceMappingURL=store.d.ts.map

package/dist/schemas/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/schemas/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD,eAAO,MAAM,iCAAiC;;;;kBAInC,CAAC;AAEZ,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAE5F,eAAO,MAAM,mBAAmB,qBAAmB,kBAAkB,KAAK,OAAO,CAAC,gBAAgB,CAAC,SAAhD,kBAAkB,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAmD,CAAC;AACvJ,eAAO,MAAM,8BAA8B;;;;;;;;;iBASzC,CAAC;AACH,eAAO,MAAM,sBAAsB,iDAElC,CAAC;AACF,eAAO,MAAM,qBAAqB,aAA6B,CAAC;AAChE,eAAO,MAAM,YAAY;;;kBAA8F,CAAC;AACxH,eAAO,MAAM,YAAY,aAAmC,CAAC;AAE7D,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/schemas/store.js

@@ -0,0 +1,22 @@
+import * as z from 'zod/v4';
+export const TerminalSessionStoreOptionsSchema = z.object({
+    maxSessions: z.number().int().nonnegative().default(0),
+    idleTimeoutMs: z.number().int().positive().default(30 * 60_000),
+    reaperIntervalMs: z.number().int().positive().default(60_000)
+}).strict();
+export const SessionOpenerSchema = z.custom((value) => z.function().safeParse(value).success);
+export const ExecutionSessionContractSchema = z.object({
+    id: z.string().min(1),
+    environmentId: z.string().min(1),
+    write: z.function(),
+    onOutput: z.function(),
+    resize: z.function(),
+    signal: z.function(),
+    exited: z.function(),
+    kill: z.function()
+});
+export const ExecutionSessionSchema = z.custom((value) => ExecutionSessionContractSchema.safeParse(value).success);
+export const SessionIdentitySchema = z.string().min(1).max(512);
+export const ResizeSchema = z.object({ cols: z.number().int().positive(), rows: z.number().int().positive() }).strict();
+export const SignalSchema = z.string().trim().min(1).max(64);
+//# sourceMappingURL=store.js.map

package/dist/schemas/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/schemas/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAI5B,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,CAAC,MAAM,CAAC;IACzD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACtD,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,GAAG,MAAM,CAAC;IAC/D,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;CAC7D,CAAC,CAAC,MAAM,EAAE,CAAC;AAIZ,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAA0D,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC;AACvJ,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC;IACtD,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAChC,KAAK,EAAE,CAAC,CAAC,QAAQ,EAAE;IACnB,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE;IACtB,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpB,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpB,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpB,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE;CAClB,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAC7C,CAAC,KAAK,EAAE,EAAE,CAAC,8BAA8B,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAClE,CAAC;AACF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAChE,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AACxH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC"}