@vibesdotdev/external 0.0.0-stage → 1.0.0-rc.1

package/dist/harness/runtime-transport.js

@@ -0,0 +1,356 @@
+/**
+ * Warm runtime client transport for external host projections.
+ *
+ * Connects to the per-workspace runtime socket via @vibesdotdev/kernel-rpc/unix.
+ * A tool call cannot spawn a process. The transport locates nothing: the
+ * host that constructs it hands in the socket (named by the runtime daemon's
+ * socket-path owner) and the workspace it serves.
+ *
+ * Everything the socket answers is untrusted: answers are schema-checked, and
+ * failure text reaching a host tool is a typed refusal's message or value-free
+ * facts, never a raw error message.
+ */
+import * as z from 'zod/v4';
+import { resolve } from '@vibesdotdev/filesystem';
+import { CapabilityError, CaughtFailureSchema, isCapabilityError, settle, valueFreeFailure } from '@vibesdotdev/kernel';
+import { JsonValueSchema } from '@vibesdotdev/kernel/schemas/json';
+import {} from '@vibesdotdev/cli-contracts';
+/** The reason a handed runtime socket could not be used (stale, refused, unreadable). */
+export const RUNTIME_SOCKET_UNAVAILABLE = 'runtime-socket-unavailable';
+/** Whether `failure` is a transport's typed "the handed socket is unavailable". */
+export function isRuntimeSocketUnavailable(failure) {
+    return failure instanceof Error && isCapabilityError(failure) && failure.reason === RUNTIME_SOCKET_UNAVAILABLE;
+}
+/** A failure as text: a typed refusal by its own message, anything else by its value-free facts. */
+function failureText(failure) {
+    if (failure instanceof Error && isCapabilityError(failure))
+        return failure.message;
+    const facts = valueFreeFailure(failure);
+    return facts.code ? `${facts.name} (${facts.code})` : facts.name;
+}
+function socketUnavailable(socketPath, workspaceRoot, detail, cause) {
+    const details = cause instanceof Error && isCapabilityError(cause)
+        ? { socketPath, workspaceRoot, socketReason: cause.reason }
+        : { socketPath, workspaceRoot };
+    const options = {
+        reason: RUNTIME_SOCKET_UNAVAILABLE,
+        retryable: true,
+        details
+    };
+    if (cause !== undefined)
+        options.cause = cause;
+    return new CapabilityError(`The runtime socket ${socketPath} for ${workspaceRoot} is unavailable: ${detail}`, 'UNAVAILABLE', options);
+}
+/** A JSON value as the runtime socket carries it. */
+const WireJsonSchema = JsonValueSchema;
+/** The socket root as the wire hands it: each method checked for its request and answer at call time. */
+const RuntimeSocketRootSchema = z.object({
+    invoke: z.function({ input: [z.custom((value) => value instanceof Object)], output: z.promise(WireJsonSchema) }).optional(),
+    query: z.function({ input: [z.custom((value) => value instanceof Object)], output: z.promise(WireJsonSchema) }).optional()
+});
+/** One `tools/tool` descriptor as the runtime catalog answers it. */
+const RuntimeToolDescriptorSchema = z
+    .object({
+    id: z.string(),
+    name: z.string().optional(),
+    description: z.string().optional(),
+    parameters: z.record(z.string(), WireJsonSchema).optional(),
+    schemas: z.object({ input: WireJsonSchema.optional(), output: WireJsonSchema.optional() }).loose().optional()
+})
+    .loose();
+/** A catalog answer: the descriptor list, bare or under `descriptors` / `result`. */
+const CatalogAnswerSchema = z.union([
+    z.array(RuntimeToolDescriptorSchema),
+    z.object({ descriptors: z.array(RuntimeToolDescriptorSchema) }).loose().transform((answer) => answer.descriptors),
+    z.object({ result: z.array(RuntimeToolDescriptorSchema) }).loose().transform((answer) => answer.result)
+]);
+/** An invoke answer's fields a host projection reads. */
+const InvokeAnswerSchema = z
+    .object({ success: z.boolean().optional(), result: WireJsonSchema.optional(), error: z.string().optional() })
+    .loose();
+/** Tool input on the command line: a JSON object. */
+const ToolParamsSchema = z.record(z.string(), WireJsonSchema);
+/** Connect to a runtime socket through `runtime`'s socket service and wire its root. */
+export async function connectRuntimeSocket(socketPath, runtime) {
+    const { connectUnix } = await import('@vibesdotdev/kernel-rpc/unix');
+    const { wireConsumer, asRefId } = await import('@vibesdotdev/kernel-rpc');
+    let connected = await settle(() => connectUnix(socketPath, { runtime, timeoutMs: 60_000 }));
+    for (let retry = 0; !connected.ok &&
+        retry < 3 &&
+        !runtime.lifecycle.signal.aborted &&
+        isCapabilityError(connected.cause) &&
+        (connected.cause.reason === 'rpc-handshake-timeout' ||
+            connected.cause.reason === 'socket-connect-timeout' ||
+            connected.cause.reason === 'rpc-handshake-closed'); retry++) {
+        await runtime.lifecycle.delay(250 * (retry + 1));
+        if (runtime.lifecycle.signal.aborted)
+            break;
+        connected = await settle(() => connectUnix(socketPath, { runtime, timeoutMs: 60_000 }));
+    }
+    if (!connected.ok)
+        throw connected.cause;
+    const conn = connected.value;
+    try {
+        const { root } = wireConsumer({
+            rootRef: conn.rootRef,
+            send: (request) => conn.send(request),
+            openStream: (ref, channel) => conn.openStream(asRefId(ref), channel),
+            closed: conn.closed
+        });
+        return { conn, root: RuntimeSocketRootSchema.parse(root) };
+    }
+    catch (error) {
+        await conn.close();
+        throw error;
+    }
+}
+/** Close a discarded socket; a failure to close is returned value-free, never thrown. */
+async function closeDiscarded(connection) {
+    try {
+        await connection.conn.close();
+        return {};
+    }
+    catch (error) {
+        return { failure: valueFreeFailure(CaughtFailureSchema.parse(error)) };
+    }
+}
+/** The tool input on a `tools run <id> [--input] <json>` command line, or the refusal to read it. */
+function readToolParams(argv, toolId) {
+    for (let i = 3; i < argv.length; i++) {
+        const arg = argv[i];
+        const raw = arg === '--input' ? argv[i + 1] : arg && !arg.startsWith('-') ? arg : undefined;
+        if (raw === undefined)
+            continue;
+        let decoded;
+        try {
+            decoded = JSON.parse(raw);
+        }
+        catch (error) {
+            // A tool never runs on input it could not read.
+            return {
+                refused: {
+                    exitCode: 2,
+                    stdout: '',
+                    stderr: `Tool ${toolId} input is not valid JSON.`,
+                    failure: valueFreeFailure(CaughtFailureSchema.parse(error))
+                }
+            };
+        }
+        const parsed = ToolParamsSchema.safeParse(decoded);
+        if (!parsed.success)
+            return { refused: { exitCode: 2, stdout: '', stderr: `Tool ${toolId} input must be a JSON object.` } };
+        return { params: parsed.data };
+    }
+    return { params: {} };
+}
+/** One host owns one workspace, connection and catalog. Dispose never closes another handle. */
+export function createRuntimeTransport(options) {
+    const workspaceRoot = resolve(options.workspaceRoot);
+    const socketPath = resolve(options.socketPath);
+    const runtime = options.runtime;
+    const connect = options.connect ??
+        (runtime ? (path) => connectRuntimeSocket(path, runtime) : undefined);
+    if (!connect) {
+        throw new CapabilityError('A runtime transport needs the host runtime (its socket service) or an injected connect.', 'INTERNAL', { reason: 'runtime-transport-unconfigured', retryable: false, details: { socketPath, workspaceRoot } });
+    }
+    let connectFailure;
+    let activeConnection = null;
+    let connectionPromise = null;
+    let cachedToolCatalog = null;
+    let catalogPromise = null;
+    let catalogRevision = 0;
+    let disposed = false;
+    let disposal;
+    const invalidateToolCatalog = () => {
+        catalogRevision++;
+        cachedToolCatalog = null;
+        catalogPromise = null;
+    };
+    const dispose = () => {
+        if (disposal)
+            return disposal;
+        disposed = true;
+        options.signal?.removeEventListener('abort', onAbort);
+        invalidateToolCatalog();
+        const connection = activeConnection;
+        activeConnection = null;
+        connectionPromise = null;
+        // A pending opener closes its own late result; disposal need not wait for it.
+        // The socket is being discarded: a failed close leaves nothing to recover.
+        disposal = connection ? closeDiscarded(connection).then(() => undefined) : Promise.resolve();
+        return disposal;
+    };
+    const onAbort = () => {
+        void dispose();
+    };
+    if (options.signal?.aborted)
+        void dispose();
+    else
+        options.signal?.addEventListener('abort', onAbort, { once: true });
+    /** Connect, or the typed "socket unavailable" refusal (with the value-free failure) when it cannot. */
+    const attemptConnect = async () => {
+        try {
+            return { connection: await connect(socketPath) };
+        }
+        catch (error) {
+            // The one outcome a caller may route around: the handed socket is unavailable.
+            const failure = CaughtFailureSchema.parse(error);
+            return {
+                refused: socketUnavailable(socketPath, workspaceRoot, failureText(failure), failure),
+                failure: valueFreeFailure(CaughtFailureSchema.parse(error))
+            };
+        }
+    };
+    /** Open the socket; an unavailable socket is recorded typed (surfaced by `run`) and answers null. */
+    const open = async () => {
+        if (disposed)
+            return null;
+        const attempt = await attemptConnect();
+        if ('refused' in attempt) {
+            connectFailure = attempt.refused;
+            return null;
+        }
+        const { connection } = attempt;
+        if (disposed) {
+            // The transport was disposed while opening; the late socket is discarded.
+            await closeDiscarded(connection);
+            return null;
+        }
+        activeConnection = connection;
+        const closed = () => {
+            if (activeConnection !== connection)
+                return;
+            activeConnection = null;
+            invalidateToolCatalog();
+        };
+        // A close, clean or failed, invalidates the connection; the next `run` reconnects
+        // and surfaces its own typed failure. The failed close's facts are its outcome.
+        void connection.conn.closed?.then(closed, (error) => {
+            closed();
+            return { failure: valueFreeFailure(CaughtFailureSchema.parse(error)) };
+        });
+        return connection;
+    };
+    const getConnection = () => {
+        if (disposed)
+            return Promise.resolve(null);
+        if (activeConnection)
+            return Promise.resolve(activeConnection);
+        if (connectionPromise)
+            return connectionPromise;
+        const opening = open().finally(() => {
+            if (connectionPromise === opening)
+                connectionPromise = null;
+        });
+        connectionPromise = opening;
+        return opening;
+    };
+    const fetchToolCatalog = () => {
+        if (disposed)
+            return Promise.resolve(null);
+        if (cachedToolCatalog)
+            return Promise.resolve(cachedToolCatalog);
+        if (catalogPromise)
+            return catalogPromise;
+        const revision = catalogRevision;
+        const query = (async () => {
+            try {
+                const connection = await getConnection();
+                if (!connection || !connection.root.query || disposed || revision !== catalogRevision)
+                    return null;
+                const answer = await connection.root.query({ kind: 'tools/tool' });
+                if (disposed || revision !== catalogRevision || activeConnection !== connection)
+                    return null;
+                const descriptors = CatalogAnswerSchema.safeParse(answer);
+                if (!descriptors.success)
+                    return null;
+                cachedToolCatalog = descriptors.data;
+                return cachedToolCatalog;
+            }
+            finally {
+                if (revision === catalogRevision)
+                    catalogPromise = null;
+            }
+        })();
+        catalogPromise = query;
+        return query;
+    };
+    const invokeTool = async (transport, invoke, toolId, params) => {
+        const startTime = performance.now();
+        const timeout = z.number().positive().safeParse(params.timeoutMs);
+        const request = timeout.success
+            ? { type: 'runtime-command', invokeType: 'tool', id: toolId, params, caller: 'host-projection', timeout: timeout.data }
+            : { type: 'runtime-command', invokeType: 'tool', id: toolId, params, caller: 'host-projection' };
+        let raw;
+        try {
+            raw = await invoke.call(transport.root, request);
+        }
+        catch (error) {
+            const failure = CaughtFailureSchema.parse(error);
+            return {
+                exitCode: 1,
+                stdout: '',
+                stderr: `Tool ${toolId} failed: ${failureText(failure)}`,
+                durationMs: Math.round(performance.now() - startTime),
+                failure: valueFreeFailure(CaughtFailureSchema.parse(error))
+            };
+        }
+        const durationMs = Math.round(performance.now() - startTime);
+        const answer = InvokeAnswerSchema.safeParse(raw);
+        if (!answer.success) {
+            return { exitCode: 1, stdout: '', stderr: `Tool ${toolId} answered in an unreadable shape.`, durationMs };
+        }
+        if (answer.data.success !== false) {
+            const result = answer.data.result ?? raw;
+            const stdout = z.string().safeParse(result).data ?? JSON.stringify(result, null, 2);
+            return { exitCode: 0, stdout, stderr: '', durationMs };
+        }
+        return {
+            exitCode: 1,
+            stdout: answer.data.result !== undefined ? JSON.stringify(answer.data.result, null, 2) : '',
+            stderr: answer.data.error ?? `Tool ${toolId} failed`,
+            durationMs
+        };
+    };
+    const run = async (argv, runOptions) => {
+        if (disposed) {
+            throw new CapabilityError('The runtime transport was disposed.', 'UNAVAILABLE', {
+                reason: 'runtime-transport-disposed',
+                retryable: false
+            });
+        }
+        if (runOptions?.cwd && resolve(runOptions.cwd) !== workspaceRoot) {
+            throw new CapabilityError('The command cwd does not match the runtime transport workspace.', 'INVALID_INPUT', {
+                reason: 'runtime-transport-cwd-mismatch',
+                retryable: false,
+                details: { workspaceRoot }
+            });
+        }
+        if (runOptions?.signal?.aborted) {
+            return { exitCode: 1, stdout: '', stderr: 'Command aborted', cancelled: true };
+        }
+        const toolId = argv[0] === 'tools' && argv[1] === 'run' ? argv[2] : undefined;
+        if (toolId) {
+            const input = readToolParams(argv, toolId);
+            if ('refused' in input)
+                return input.refused;
+            const transport = await getConnection();
+            if (!transport) {
+                throw connectFailure ?? socketUnavailable(socketPath, workspaceRoot, `tool ${toolId} was not run`);
+            }
+            const invoke = transport.root.invoke;
+            if (!invoke) {
+                throw socketUnavailable(socketPath, workspaceRoot, `the runtime socket exposes no invoke; tool ${toolId} was not run`);
+            }
+            return invokeTool(transport, invoke, toolId, input.params);
+        }
+        // A host command cannot spawn a process.
+        return {
+            exitCode: 1,
+            stdout: '',
+            stderr: `Runtime socket did not run ${argv.join(' ') || 'the command'}.`
+        };
+    };
+    return { getConnection, fetchToolCatalog, invalidateToolCatalog, run, dispose };
+}
+//# sourceMappingURL=runtime-transport.js.map

package/dist/harness/runtime-transport.js.map

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

package/dist/harness/schemas/agent-host.d.ts

@@ -0,0 +1,146 @@
+/**
+ * The agent host's contracts.
+ *
+ * R-SCHEMA-001 keeps an exported interface or type alias in a schemas directory,
+ * so every type a host reads from this module is declared here and
+ * `./agent-host.ts` carries only behaviour. Each shape is derived from the
+ * contract it describes rather than restated: a runtime descriptor is a
+ * `RuntimeDescriptor`, a command is a `cli/command` asset, a prompt is a
+ * `prompts/manifest` asset. Nothing here invents a parallel vocabulary.
+ */
+import * as z from 'zod/v4';
+import type { CLICommandAssetDescriptor, CLIGroupAssetDescriptor, CommandContext, CommandOptions } from '@vibesdotdev/cli-contracts';
+import type { RuntimeDescriptor, RuntimePlugin, RuntimeWorkspaceCompositionRequest, ValueFreeFailure } from '@vibesdotdev/kernel';
+import type { PromptsManifestDescriptor } from '@vibesdotdev/ai-schemas';
+import type { LiveToolDescriptor } from '../live-tools.ts';
+/**
+ * A JSON value, which is all that crosses a host bridge.
+ *
+ * A coding-agent host is a separate process behind a JSON boundary, so both
+ * ends of every host call are this and nothing richer: a tool's arguments
+ * arrive as JSON and its answer leaves as JSON. A value that is not JSON fails at
+ * the boundary rather than reaching a host that cannot render or forward it.
+ */
+export declare const HostJsonSchema: z.ZodType<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>>;
+export type HostJson = z.output<typeof HostJsonSchema>;
+/**
+ * A descriptor a host reads as identity and metadata — `ai/model`, `ai/provider`
+ * and every other kind that has no richer host contract.
+ *
+ * This is the runtime's own descriptor, not a second shape beside it: a host
+ * reads `id`, `name`, `description` and `tags`, and the owner payload a
+ * descriptor may carry is never part of what a host shows.
+ */
+export type AgentHostDescriptor = RuntimeDescriptor;
+/** One command's result, as a host presents it: the text it wrote, and whether it failed. */
+export type AgentHostCommandResult = {
+    readonly exitCode: number;
+    readonly stdout: string;
+    readonly stderr: string;
+    /** The command's own answer, recorded when it published one through `ui.json`. */
+    readonly json?: HostJson;
+    /**
+     * The failure that ended the command, with its value withheld: the bounded
+     * facts a host reports by. Absent when the command ended on its own terms.
+     */
+    readonly failure?: ValueFreeFailure;
+};
+/** How a host asks for a command to stop before it finishes. */
+export type CommandInvocation = {
+    readonly signal?: AbortSignal;
+};
+export type AgentHostInvokeOptions = {
+    /** The caller session tool calls are attributed to. */
+    readonly session?: string;
+    /** The harness driving this host's caller (for example `pi`). */
+    readonly harness?: string;
+    /** The harness's own conversation id: one conversation is one seat (one instance). */
+    readonly harnessSessionId?: string;
+    readonly signal?: AbortSignal;
+};
+/** The scope an agent host declares. It is the CLI host's own declaration for a persistent, interactive, local session. */
+export type AgentHostScopeInput = {
+    /** The workspace the host session runs in. */
+    readonly workspaceRoot: string;
+    /** A released agent host declares `false`; a host running from source may omit it. */
+    readonly dev?: boolean;
+};
+/** The runtime scope an agent host declares, resolved by `agentHostScope`. */
+export type AgentHostScope = {
+    readonly surface: 'agent';
+    readonly hardware: 'consumer';
+    readonly purpose: 'projection';
+    readonly lifecycle: 'persistent';
+    readonly hosting: {
+        readonly mode: 'local';
+        readonly owner: 'consumer';
+        readonly venue: 'user-device';
+    };
+    readonly capabilities: {
+        readonly interactiveSession: true;
+    };
+    readonly workspace: {
+        readonly root: string;
+        readonly access: 'write';
+    };
+    readonly qualifiers?: {
+        readonly dev: boolean;
+    };
+};
+/** Commands forward by default; a terminal host may declare capture-only delivery. */
+export declare const AgentHostSettingsSchema: z.ZodObject<{
+    commandCaptureDelivery: z.ZodDefault<z.ZodEnum<{
+        capture: "capture";
+        forward: "forward";
+    }>>;
+}, z.core.$strict>;
+export type AgentHostSettings = z.output<typeof AgentHostSettingsSchema>;
+/** The composition an agent host boots: the host's floor, the global scope, the bound workspace. */
+export type AgentHostComposition = {
+    /** Plugins every agent host composes under the global and workspace scopes. */
+    readonly floor: readonly (() => Promise<RuntimePlugin>)[];
+    /** Host defaults passed to the kernel; workspace values may override them with their owner selected by workspace/global. */
+    readonly config?: RuntimeWorkspaceCompositionRequest['floor']['config'];
+};
+export type BootAgentHostOptions = {
+    /** The host's own environment plugin (Node, Bun, …). The host builds it; this module never imports one. */
+    readonly environment: RuntimePlugin;
+    readonly composition: AgentHostComposition;
+    /** The workspace the host session runs in. */
+    readonly workspaceRoot: string;
+    /**
+     * R: the root whose `node_modules` supplies the framework. One per process;
+     * every first-party name must resolve under it. The host resolves it by its own
+     * rules and hands it here.
+     */
+    readonly root: string;
+    /** `owned` leaves the default binding alone; `default` binds it. */
+    readonly binding?: 'default' | 'owned';
+};
+/**
+ * One `cli/command` as a host presents it: the name the host shows, the
+ * description it lists, and a parser from the host's argument string into the
+ * positional arguments the descriptor declares.
+ */
+export type AgentHostCommand = {
+    /** Group path and name, e.g. `session init`; a group-less command is just its name. */
+    readonly name: string;
+    readonly description: string;
+    readonly descriptor: CLICommandAssetDescriptor;
+    /** Parse the host's argument string into this command's declared positionals. */
+    parse(input: string): CommandOptions;
+};
+/** The registries and results `VibesAgentHost` answers. */
+export type AgentHostCatalog = {
+    readonly tools: readonly LiveToolDescriptor[];
+    readonly groups: readonly CLIGroupAssetDescriptor[];
+    readonly commands: readonly CLICommandAssetDescriptor[];
+    readonly prompts: readonly PromptsManifestDescriptor[];
+    readonly models: readonly AgentHostDescriptor[];
+    readonly providers: readonly AgentHostDescriptor[];
+};
+/** A command implementation's entry, as the CLI surface resolves it. */
+export type CliCommandExecute = (args: CommandOptions, opts: CommandOptions, context: CommandContext) => Promise<void | HostJson>;
+/** The command's exit status: a thrown failure is a nonzero status with its message as stderr. */
+export type CommandExitStatus = number;
+//# sourceMappingURL=agent-host.d.ts.map

package/dist/harness/schemas/agent-host.d.ts.map

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

package/dist/harness/schemas/agent-host.js

@@ -0,0 +1,26 @@
+/**
+ * The agent host's contracts.
+ *
+ * R-SCHEMA-001 keeps an exported interface or type alias in a schemas directory,
+ * so every type a host reads from this module is declared here and
+ * `./agent-host.ts` carries only behaviour. Each shape is derived from the
+ * contract it describes rather than restated: a runtime descriptor is a
+ * `RuntimeDescriptor`, a command is a `cli/command` asset, a prompt is a
+ * `prompts/manifest` asset. Nothing here invents a parallel vocabulary.
+ */
+import * as z from 'zod/v4';
+import { JsonValueSchema } from '@vibesdotdev/kernel/schemas/json';
+/**
+ * A JSON value, which is all that crosses a host bridge.
+ *
+ * A coding-agent host is a separate process behind a JSON boundary, so both
+ * ends of every host call are this and nothing richer: a tool's arguments
+ * arrive as JSON and its answer leaves as JSON. A value that is not JSON fails at
+ * the boundary rather than reaching a host that cannot render or forward it.
+ */
+export const HostJsonSchema = JsonValueSchema;
+/** Commands forward by default; a terminal host may declare capture-only delivery. */
+export const AgentHostSettingsSchema = z.strictObject({
+    commandCaptureDelivery: z.enum(['forward', 'capture']).default('forward')
+});
+//# sourceMappingURL=agent-host.js.map

package/dist/harness/schemas/agent-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-host.js","sourceRoot":"","sources":["../../../src/harness/schemas/agent-host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAInE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,eAAe,CAAC;AA8D9C,sFAAsF;AACtF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,YAAY,CAAC;IACrD,sBAAsB,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;CACzE,CAAC,CAAC"}

package/dist/harness/stdio-sink.d.ts

@@ -0,0 +1,35 @@
+/**
+ * The in-memory stdio sink: what a host that owns the terminal hands the
+ * environment's `textStreams` so command output is captured before it ever
+ * touches the host's screen — no process-stream hooking, no lease, nothing for
+ * a host render loop to collide with.
+ */
+/** One mark per channel: where the sink stood when a command began. */
+export interface StdioSinkMark {
+    readonly stdout: number;
+    readonly stderr: number;
+}
+/** What a command wrote since its mark, per channel. */
+export interface StdioSinkDrain {
+    stdout: string;
+    stderr: string;
+}
+/** The sink the agent host drains around one command's execution. */
+export interface CommandOutputSink {
+    /** Where both channels stand now. */
+    mark(): StdioSinkMark;
+    /** Everything written since `mark`, consumed per channel. */
+    drain(mark: StdioSinkMark): StdioSinkDrain;
+    /** The `textStreams` shape the environment's stdio writes into. */
+    readonly textStreams: {
+        readonly stdout: {
+            write(chunk: Uint8Array | string): boolean;
+        };
+        readonly stderr: {
+            write(chunk: Uint8Array | string): boolean;
+        };
+    };
+}
+/** An unbounded in-memory sink; the agent host drains it per command. */
+export declare function createMemoryCommandSink(): CommandOutputSink;
+//# sourceMappingURL=stdio-sink.d.ts.map

package/dist/harness/stdio-sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio-sink.d.ts","sourceRoot":"","sources":["../../src/harness/stdio-sink.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,uEAAuE;AACvE,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACxB;AAED,wDAAwD;AACxD,MAAM,WAAW,cAAc;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CACf;AAED,qEAAqE;AACrE,MAAM,WAAW,iBAAiB;IACjC,qCAAqC;IACrC,IAAI,IAAI,aAAa,CAAC;IACtB,6DAA6D;IAC7D,KAAK,CAAC,IAAI,EAAE,aAAa,GAAG,cAAc,CAAC;IAC3C,mEAAmE;IACnE,QAAQ,CAAC,WAAW,EAAE;QACrB,QAAQ,CAAC,MAAM,EAAE;YAAE,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO,CAAA;SAAE,CAAC;QAChE,QAAQ,CAAC,MAAM,EAAE;YAAE,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO,CAAA;SAAE,CAAC;KAChE,CAAC;CACF;AAWD,yEAAyE;AACzE,wBAAgB,uBAAuB,IAAI,iBAAiB,CAkB3D"}

package/dist/harness/stdio-sink.js

@@ -0,0 +1,34 @@
+/**
+ * The in-memory stdio sink: what a host that owns the terminal hands the
+ * environment's `textStreams` so command output is captured before it ever
+ * touches the host's screen — no process-stream hooking, no lease, nothing for
+ * a host render loop to collide with.
+ */
+import * as z from 'zod/v4';
+/** One stream chunk as text: a string passes through, bytes decode — parsed at the boundary. */
+const ChunkTextSchema = z.union([
+    z.string(),
+    z.instanceof(Uint8Array).transform((bytes) => new TextDecoder().decode(bytes))
+]);
+const chunkText = (chunk) => ChunkTextSchema.parse(chunk);
+/** An unbounded in-memory sink; the agent host drains it per command. */
+export function createMemoryCommandSink() {
+    let out = '';
+    let err = '';
+    const textStreams = {
+        stdout: { write: (chunk) => { out += chunkText(chunk); return true; } },
+        stderr: { write: (chunk) => { err += chunkText(chunk); return true; } }
+    };
+    return {
+        textStreams,
+        mark: () => ({ stdout: out.length, stderr: err.length }),
+        drain: (mark) => {
+            const stdout = out.slice(mark.stdout);
+            const stderr = err.slice(mark.stderr);
+            out = out.slice(0, mark.stdout);
+            err = err.slice(0, mark.stderr);
+            return { stdout, stderr };
+        }
+    };
+}
+//# sourceMappingURL=stdio-sink.js.map

package/dist/harness/stdio-sink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio-sink.js","sourceRoot":"","sources":["../../src/harness/stdio-sink.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA2BH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,gGAAgG;AAChG,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC;IAC/B,CAAC,CAAC,MAAM,EAAE;IACV,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;CAC9E,CAAC,CAAC;AACH,MAAM,SAAS,GAAG,CAAC,KAA0B,EAAU,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAEvF,yEAAyE;AACzE,MAAM,UAAU,uBAAuB;IACtC,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,MAAM,WAAW,GAAG;QACnB,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,KAA0B,EAAW,EAAE,GAAG,GAAG,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE;QACrG,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,KAA0B,EAAW,EAAE,GAAG,GAAG,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE;KACrG,CAAC;IACF,OAAO;QACN,WAAW;QACX,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC;QACxD,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE;YACf,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACtC,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACtC,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YAChC,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YAChC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAC3B,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/harness/strip-undefined.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Compatibility projection over Runtime's reader-to-wire JSON schema.
+ * Non-JSON values stay unchanged so the caller's output boundary can refuse
+ * them with its own error contract.
+ */
+import { type ReadonlyJsonValue } from '@vibesdotdev/kernel/schemas/json';
+export type { JsonValue as CleanJson } from '@vibesdotdev/kernel/schemas/json';
+export declare function stripUndefined(value: ReadonlyJsonValue): ReadonlyJsonValue;
+//# sourceMappingURL=strip-undefined.d.ts.map