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

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

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

package/dist/harness/command-arguments.d.ts

@@ -0,0 +1,54 @@
+/**
+ * How a host's argument string becomes a command's declared positionals.
+ *
+ * A host shows a command as a name and a line of text after it; the command's
+ * descriptor already declares what that line may carry. This is the translation
+ * between the two, and it reads the declaration rather than guessing — a command
+ * that declares no arguments takes none, an argument it declares gets its
+ * declared position, and anything past the last declaration is not invented into
+ * the call. The command's own implementation remains the authority on what it
+ * accepts; this only fills in what the descriptor published.
+ *
+ * It is separate from the boot because it is the same for every host: Pi's
+ * `/vibes session init`, OpenCode's `vibes session init` and a future ACP host
+ * differ in what they draw, not in how a quoted argument survives the trip.
+ */
+import type { CLICommandAssetDescriptor, CommandOptions } from '@vibesdotdev/cli-contracts';
+import type { AgentHostCommand } from './schemas/agent-host.ts';
+/** `session init` for a grouped command, `doctor` for one that declares no group. */
+export declare function commandHostName(descriptor: {
+    id: string;
+    name?: string;
+    group?: string;
+}): string;
+/**
+ * The commands an agent host offers, in registration order.
+ *
+ * Two descriptors are deliberately not offered, and both are the host's honest
+ * answer rather than a limitation:
+ *
+ * - **Interactive commands.** A descriptor carrying an `interactive` contract
+ *   means the CLI surface launches a TUI application in its place. An agent host
+ *   is already inside somebody else's TUI, so offering one would advertise a
+ *   mode the host cannot enter.
+ * - **Internal commands.** `internal: true` is the owner saying "not unless a
+ *   surface opts in", and no host opts in by accident.
+ */
+export declare function agentHostCommands(descriptors: readonly CLICommandAssetDescriptor[]): AgentHostCommand[];
+/**
+ * Split a host's argument string into the positional arguments the descriptor
+ * declares, in the declaration's own order.
+ *
+ * A quoted run stays together, so a path with spaces survives; a `variadic`
+ * declaration collects everything that is left. A missing argument takes the
+ * declared default, and a missing argument with no default is simply absent —
+ * which is how the command's own implementation sees "not supplied".
+ */
+export declare function parseCommandArguments(descriptor: {
+    arguments?: readonly {
+        name: string;
+        default?: unknown;
+        variadic?: boolean;
+    }[];
+}, input: string): CommandOptions;
+//# sourceMappingURL=command-arguments.d.ts.map

package/dist/harness/command-arguments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-arguments.d.ts","sourceRoot":"","sources":["../../src/harness/command-arguments.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,yBAAyB,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,UAAU,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAMjG;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,SAAS,yBAAyB,EAAE,GAAG,gBAAgB,EAAE,CASvG;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACpC,UAAU,EAAE;IAAE,SAAS,CAAC,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,EAAE,CAAA;CAAE,EAC9F,KAAK,EAAE,MAAM,GACX,cAAc,CAmBhB"}

package/dist/harness/command-arguments.js

@@ -0,0 +1,113 @@
+/**
+ * How a host's argument string becomes a command's declared positionals.
+ *
+ * A host shows a command as a name and a line of text after it; the command's
+ * descriptor already declares what that line may carry. This is the translation
+ * between the two, and it reads the declaration rather than guessing — a command
+ * that declares no arguments takes none, an argument it declares gets its
+ * declared position, and anything past the last declaration is not invented into
+ * the call. The command's own implementation remains the authority on what it
+ * accepts; this only fills in what the descriptor published.
+ *
+ * It is separate from the boot because it is the same for every host: Pi's
+ * `/vibes session init`, OpenCode's `vibes session init` and a future ACP host
+ * differ in what they draw, not in how a quoted argument survives the trip.
+ */
+import * as z from 'zod/v4';
+/** `session init` for a grouped command, `doctor` for one that declares no group. */
+export function commandHostName(descriptor) {
+    const name = descriptor.name?.trim() || descriptor.id;
+    const group = descriptor.group?.trim();
+    // A descriptor that already spells its group into its name is left alone:
+    // prefixing it twice would show the host a name the registry does not hold.
+    return group && !name.startsWith(`${group}.`) && !name.startsWith(`${group} `) ? `${group} ${name}` : name;
+}
+/**
+ * The commands an agent host offers, in registration order.
+ *
+ * Two descriptors are deliberately not offered, and both are the host's honest
+ * answer rather than a limitation:
+ *
+ * - **Interactive commands.** A descriptor carrying an `interactive` contract
+ *   means the CLI surface launches a TUI application in its place. An agent host
+ *   is already inside somebody else's TUI, so offering one would advertise a
+ *   mode the host cannot enter.
+ * - **Internal commands.** `internal: true` is the owner saying "not unless a
+ *   surface opts in", and no host opts in by accident.
+ */
+export function agentHostCommands(descriptors) {
+    return descriptors
+        .filter((descriptor) => descriptor.internal !== true && descriptor.interactive === undefined)
+        .map((descriptor) => ({
+        name: commandHostName(descriptor),
+        description: descriptor.description,
+        descriptor,
+        parse: (input) => parseCommandArguments(descriptor, input)
+    }));
+}
+/**
+ * Split a host's argument string into the positional arguments the descriptor
+ * declares, in the declaration's own order.
+ *
+ * A quoted run stays together, so a path with spaces survives; a `variadic`
+ * declaration collects everything that is left. A missing argument takes the
+ * declared default, and a missing argument with no default is simply absent —
+ * which is how the command's own implementation sees "not supplied".
+ */
+export function parseCommandArguments(descriptor, input) {
+    const declared = descriptor.arguments ?? [];
+    if (declared.length === 0)
+        return {};
+    const tokens = tokenizeArguments(input);
+    const parsed = {};
+    for (const [index, argument] of declared.entries()) {
+        if (argument.variadic) {
+            parsed[argument.name] = tokens.slice(index);
+            return parsed;
+        }
+        const token = tokens[index];
+        if (token === undefined) {
+            const fallback = CommandArgumentDefaultSchema.safeParse(argument.default);
+            if (fallback.success)
+                parsed[argument.name] = fallback.data;
+            continue;
+        }
+        parsed[argument.name] = token;
+    }
+    return parsed;
+}
+/** A declared default that a command option can actually hold. */
+const CommandArgumentDefaultSchema = z.union([z.string(), z.number(), z.boolean(), z.array(z.string())]);
+/** Shell-ish splitting that keeps a double- or single-quoted run as one token. */
+function tokenizeArguments(input) {
+    const tokens = [];
+    let current = '';
+    let quote;
+    let started = false;
+    for (const character of input.trim()) {
+        if (quote) {
+            if (character === quote)
+                quote = undefined;
+            else
+                current += character;
+            continue;
+        }
+        if (character === '"' || character === "'") {
+            quote = character;
+            started = true;
+            continue;
+        }
+        if (/\s/.test(character)) {
+            if (started || current.length > 0)
+                tokens.push(current);
+            current = '';
+            started = false;
+            continue;
+        }
+        current += character;
+    }
+    if (started || current.length > 0)
+        tokens.push(current);
+    return tokens;
+}
+//# sourceMappingURL=command-arguments.js.map

package/dist/harness/command-arguments.js.map

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

package/dist/harness/command-execution.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Running one `cli/command` in a runtime an agent host already booted.
+ *
+ * This is the path that replaces shelling out to `vibes <command>`: the
+ * command's own implementation runs in the runtime the host already booted,
+ * against the workspace the host already bound. Nothing here re-implements a
+ * command, wraps its arguments, or reaches for a socket — it resolves the
+ * implementation the CLI surface resolves, runs it, and reports what it wrote.
+ *
+ * It is separate from the boot because a failure is a separate concern: a
+ * command that is registered but not implemented, and a command cancelled before
+ * it started, are both refusals the host must be told about, and neither is a
+ * failed run.
+ */
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+import type { CLICommandAssetDescriptor, CommandOptions } from '@vibesdotdev/cli-contracts';
+import type { AgentHostCommandResult, CommandInvocation } from './schemas/agent-host.ts';
+/** Run one `cli/command` here and now, and report what it wrote. */
+export declare function executeHostCommand(runtime: VibesRuntime, command: CLICommandAssetDescriptor, args: CommandOptions, options: CommandOptions, invocation: CommandInvocation): Promise<AgentHostCommandResult>;
+//# sourceMappingURL=command-execution.d.ts.map

package/dist/harness/command-execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-execution.d.ts","sourceRoot":"","sources":["../../src/harness/command-execution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAA0E,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEhI,OAAO,KAAK,EAAE,yBAAyB,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAG5F,OAAO,KAAK,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEzF,oEAAoE;AACpE,wBAAsB,kBAAkB,CACvC,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,yBAAyB,EAClC,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,iBAAiB,GAC3B,OAAO,CAAC,sBAAsB,CAAC,CA4BjC"}

package/dist/harness/command-execution.js

@@ -0,0 +1,78 @@
+/**
+ * Running one `cli/command` in a runtime an agent host already booted.
+ *
+ * This is the path that replaces shelling out to `vibes <command>`: the
+ * command's own implementation runs in the runtime the host already booted,
+ * against the workspace the host already bound. Nothing here re-implements a
+ * command, wraps its arguments, or reaches for a socket — it resolves the
+ * implementation the CLI surface resolves, runs it, and reports what it wrote.
+ *
+ * It is separate from the boot because a failure is a separate concern: a
+ * command that is registered but not implemented, and a command cancelled before
+ * it started, are both refusals the host must be told about, and neither is a
+ * failed run.
+ */
+import { CapabilityError, getRuntimeStdioCapture } from '@vibesdotdev/kernel';
+import { resolveCommandImplementation } from '@vibesdotdev/cli/surface';
+import { CommandOutputRecorder, renderCapturedValue, runHostCommand } from "./command-output.js";
+import { readAgentHostSettings } from "./agent-host-settings.js";
+/** Run one `cli/command` here and now, and report what it wrote. */
+export async function executeHostCommand(runtime, command, args, options, invocation) {
+    const resolution = await resolveCommandImplementation(runtime, command.id);
+    if (resolution.kind !== 'implemented') {
+        throw new CapabilityError(`The command '${command.id}' is registered but has no implementation in this runtime scope.`, 'NOT_FOUND', { reason: 'command-not-implemented', retryable: false, details: { id: command.id, why: resolution.reason } });
+    }
+    if (invocation.signal?.aborted) {
+        throw new CapabilityError(`The command '${command.id}' was cancelled before it started.`, 'CANCELLED', {
+            reason: 'command-cancelled',
+            retryable: true,
+            details: { id: command.id }
+        });
+    }
+    const recorder = new CommandOutputRecorder(command.id);
+    const lease = await acquireOutputLease(runtime, recorder);
+    const [commandResult] = await Promise.allSettled([runHostCommand(resolution.execute, args, options, recorder, runtime)]);
+    const [captureClose] = await Promise.allSettled([lease?.close()]);
+    if (commandResult.status === 'rejected') {
+        if (captureClose.status === 'rejected')
+            throw new AggregateError([commandResult.reason, captureClose.reason], 'Command execution and capture cleanup failed.', { cause: commandResult.reason });
+        throw commandResult.reason;
+    }
+    if (captureClose.status === 'rejected')
+        throw captureClose.reason;
+    return commandResult.value;
+}
+/**
+ * The host's selected stdio lease, held for one command. Delivery follows
+ * External's declared configuration: forward by default, or consume in the
+ * recorder when capture-only delivery was explicitly selected.
+ *
+ * A host that publishes no stdio capture service — a headless embed — has no
+ * streams to hold, and the command's own `ui` recorder still returns its answer,
+ * which is the contract a host renders. A host that *does* publish the service
+ * and cannot acquire from it is broken, and is told so rather than quietly
+ * capturing less than it promised.
+ */
+async function acquireOutputLease(runtime, recorder) {
+    if (!runtime.hasContext('runtime/stdio'))
+        return undefined;
+    const capture = await getRuntimeStdioCapture(runtime);
+    const { commandCaptureDelivery: delivery } = await readAgentHostSettings(runtime);
+    return capture.acquire({
+        target: 'both',
+        consoleMethods: ['log', 'info', 'warn', 'error', 'debug'],
+        onWrite: (write, forward, channel) => {
+            recorder.recordBytes(channel === 'stderr' ? 'stderr' : 'stdout', write.bytes);
+            if (delivery === 'capture') {
+                write.complete();
+                return true;
+            }
+            return forward(write.bytes, write.complete);
+        },
+        onConsole: (method, args) => {
+            const line = args.map((argument) => renderCapturedValue(argument)).join(' ');
+            recorder.recordText(method === 'error' || method === 'warn' ? 'stderr' : 'stdout', `${line}\n`);
+        }
+    });
+}
+//# sourceMappingURL=command-execution.js.map

package/dist/harness/command-execution.js.map

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

package/dist/harness/command-output.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Where a command's output goes while an agent host runs it.
+ *
+ * A command writes two ways, so a host captures two ways: through the `ui`
+ * context it is handed, and through the host's own process streams and console,
+ * which the runtime's stdio capture lease holds for the command's duration.
+ * Both land in one buffer that the host renders with its own surface.
+ *
+ * It is separate from the boot because it is the same for every host, and because
+ * it is a different concern: this module knows how to *capture* and how to report
+ * a command that failed, while `agent-host.ts` knows what a runtime is.
+ */
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+import type { CommandOptions, UIContext } from '@vibesdotdev/cli-contracts';
+import { type AgentHostCommandResult, type CliCommandExecute } from './schemas/agent-host.ts';
+/**
+ * Collects one command's output for the host that ran it.
+ *
+ * The recorder is a `UIContext`, so a command that prints through `ui` needs no
+ * cooperation to be captured. It refuses the three things a host genuinely cannot
+ * do — read a line from stdin, read a secret, ask a yes/no question — with a
+ * typed refusal naming the command, rather than pretending to have answered.
+ */
+export declare class CommandOutputRecorder {
+    readonly ui: UIContext;
+    private readonly out;
+    private readonly err;
+    private answer;
+    constructor(commandId: string);
+    /** Text the command wrote through its `ui` context or through a captured log line. */
+    recordText(channel: 'stdout' | 'stderr', text: string): void;
+    /** Bytes the command wrote straight to a process stream the capture lease held. */
+    recordBytes(channel: 'stdout' | 'stderr', bytes: Uint8Array): void;
+    /** What the command wrote, and the status it ended with. */
+    result(exitCode: number): AgentHostCommandResult;
+    /**
+     * What the command wrote before it failed, with its message on stderr.
+     *
+     * The failure itself is not this method's to hold: the caller keeps the
+     * value-free facts, so nothing that crossed into the recorder can be
+     * re-serialized by accident.
+     */
+    failed(message: string): AgentHostCommandResult;
+}
+/** One captured value as a host text surface shows it; a logger never throws at the code it logs for. */
+export declare function renderCapturedValue(value: unknown): string;
+/**
+ * Run a command's own implementation and report what it wrote.
+ *
+ * The host owns presentation and the runtime owns the failure's shape. A command
+ * that throws ends with a nonzero status, its own message on stderr, and the
+ * value-free facts of the failure in the result — so a host renders the text and
+ * a host that wants the failure shape gets one, without either parsing the other
+ * back out of the text.
+ */
+export declare function runHostCommand(execute: CliCommandExecute, args: CommandOptions, options: CommandOptions, recorder: CommandOutputRecorder, runtime: VibesRuntime): Promise<AgentHostCommandResult>;
+/** Failures lead with stderr so a clipped host notification retains the diagnosis; partial stdout follows. */
+export declare function commandOutputText(result: AgentHostCommandResult): string;
+//# sourceMappingURL=command-output.d.ts.map

package/dist/harness/command-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-output.d.ts","sourceRoot":"","sources":["../../src/harness/command-output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAA0D,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEhH,OAAO,KAAK,EAAkB,cAAc,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC5F,OAAO,EAAkB,KAAK,sBAAsB,EAAE,KAAK,iBAAiB,EAAiB,MAAM,yBAAyB,CAAC;AA4C7H;;;;;;;GAOG;AACH,qBAAa,qBAAqB;IACjC,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAgB;IACpC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAgB;IACpC,OAAO,CAAC,MAAM,CAAuB;gBAEzB,SAAS,EAAE,MAAM;IA4C7B,sFAAsF;IACtF,UAAU,CAAC,OAAO,EAAE,QAAQ,GAAG,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAI5D,mFAAmF;IACnF,WAAW,CAAC,OAAO,EAAE,QAAQ,GAAG,QAAQ,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI;IAIlE,4DAA4D;IAC5D,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,sBAAsB;IAMhD;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,sBAAsB;CAI/C;AAED,yGAAyG;AACzG,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE1D;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CACnC,OAAO,EAAE,iBAAiB,EAC1B,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,qBAAqB,EAC/B,OAAO,EAAE,YAAY,GACnB,OAAO,CAAC,sBAAsB,CAAC,CAUjC;AAED,8GAA8G;AAC9G,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CAMxE"}

package/dist/harness/command-output.js

@@ -0,0 +1,173 @@
+/**
+ * Where a command's output goes while an agent host runs it.
+ *
+ * A command writes two ways, so a host captures two ways: through the `ui`
+ * context it is handed, and through the host's own process streams and console,
+ * which the runtime's stdio capture lease holds for the command's duration.
+ * Both land in one buffer that the host renders with its own surface.
+ *
+ * It is separate from the boot because it is the same for every host, and because
+ * it is a different concern: this module knows how to *capture* and how to report
+ * a command that failed, while `agent-host.ts` knows what a runtime is.
+ */
+import { CaughtFailureSchema, CapabilityError, valueFreeFailure } from '@vibesdotdev/kernel';
+import * as z from 'zod/v4';
+import { HostJsonSchema } from "./schemas/agent-host.js";
+const TextSchema = z.string();
+/**
+ * One captured value as a host text surface shows it.
+ *
+ * A string is the text itself, because logging `'a'` then `'b'` means "a b";
+ * anything else is rendered as JSON, which is the text the host would otherwise
+ * have had to produce itself. A value that is neither — a function, a symbol —
+ * has no honest rendering, so it is named as unrenderable rather than stringified
+ * into something that looks like data.
+ */
+const RenderedValueSchema = z
+    .unknown()
+    .transform((value) => {
+    const text = TextSchema.safeParse(value);
+    if (text.success)
+        return text.data;
+    const json = HostJsonSchema.safeParse(value);
+    return json.success ? JSON.stringify(json.data) : '(unrenderable value)';
+})
+    .catch('(unrenderable value)');
+/**
+ * One value a command asked to render: the machine-readable answer when it has
+ * one, and the text a host shows either way.
+ *
+ * Both come from one parse of one value, so the text a host renders and the
+ * answer a host forwards can never disagree about what the command published.
+ */
+const RenderedCommandValueSchema = z
+    .unknown()
+    .transform((value) => ({ answer: HostJsonSchema.safeParse(value), text: RenderedValueSchema.parse(value) }));
+/**
+ * The text a host shows for a caught failure: an `Error`'s own message, or the
+ * description a thrown non-Error carries. A message is never read twice and never
+ * reconstructed, so what the host shows is what the command threw.
+ */
+const FailureTextSchema = z
+    .looseObject({ message: TextSchema.optional(), description: TextSchema.optional() })
+    .transform((value) => value.message ?? value.description ?? '(failure with no description)')
+    .catch('(failure with no description)');
+/**
+ * Collects one command's output for the host that ran it.
+ *
+ * The recorder is a `UIContext`, so a command that prints through `ui` needs no
+ * cooperation to be captured. It refuses the three things a host genuinely cannot
+ * do — read a line from stdin, read a secret, ask a yes/no question — with a
+ * typed refusal naming the command, rather than pretending to have answered.
+ */
+export class CommandOutputRecorder {
+    ui;
+    out = [];
+    err = [];
+    answer;
+    constructor(commandId) {
+        const info = (message) => {
+            this.out.push(`${message}\n`);
+        };
+        const warn = (message) => {
+            this.err.push(`${message}\n`);
+        };
+        // A host with no stdin cannot answer a question, and pretending otherwise
+        // would hand the model an answer nobody gave.
+        const refuse = () => {
+            throw new CapabilityError(`The command '${commandId}' asked for input on a host with no stdin.`, 'UNAVAILABLE', {
+                reason: 'host-no-stdin',
+                retryable: false,
+                details: { id: commandId }
+            });
+        };
+        const render = (data) => {
+            const rendered = RenderedCommandValueSchema.parse(data);
+            // A command that published JSON has answered machine-readably, so the
+            // host gets that value rather than re-parsing a printed table.
+            if (rendered.answer.success)
+                this.answer = rendered.answer.data;
+            info(rendered.text);
+        };
+        this.ui = {
+            info,
+            success: info,
+            log: info,
+            warn,
+            error: warn,
+            json: render,
+            yaml: render,
+            table: render,
+            keyValue: (rows) => {
+                for (const [key, value] of Object.entries(rows))
+                    info(`${key}: ${renderCapturedValue(value)}`);
+            },
+            prompt: async () => refuse(),
+            password: async () => refuse(),
+            confirm: async () => false,
+            progress: () => ({ update: () => { }, complete: () => { }, fail: () => { } }),
+            setFormat: () => { },
+            render
+        };
+    }
+    /** Text the command wrote through its `ui` context or through a captured log line. */
+    recordText(channel, text) {
+        (channel === 'stdout' ? this.out : this.err).push(text);
+    }
+    /** Bytes the command wrote straight to a process stream the capture lease held. */
+    recordBytes(channel, bytes) {
+        this.recordText(channel, new TextDecoder().decode(bytes));
+    }
+    /** What the command wrote, and the status it ended with. */
+    result(exitCode) {
+        const base = { exitCode, stdout: this.out.join(''), stderr: this.err.join('') };
+        if (this.answer === undefined)
+            return base;
+        return { ...base, json: this.answer };
+    }
+    /**
+     * What the command wrote before it failed, with its message on stderr.
+     *
+     * The failure itself is not this method's to hold: the caller keeps the
+     * value-free facts, so nothing that crossed into the recorder can be
+     * re-serialized by accident.
+     */
+    failed(message) {
+        this.recordText('stderr', `${message}\n`);
+        return this.result(1);
+    }
+}
+/** One captured value as a host text surface shows it; a logger never throws at the code it logs for. */
+export function renderCapturedValue(value) {
+    return RenderedValueSchema.parse(value);
+}
+/**
+ * Run a command's own implementation and report what it wrote.
+ *
+ * The host owns presentation and the runtime owns the failure's shape. A command
+ * that throws ends with a nonzero status, its own message on stderr, and the
+ * value-free facts of the failure in the result — so a host renders the text and
+ * a host that wants the failure shape gets one, without either parsing the other
+ * back out of the text.
+ */
+export async function runHostCommand(execute, args, options, recorder, runtime) {
+    const context = { runtime, ui: recorder.ui };
+    try {
+        await execute(args, options, context);
+        return recorder.result(0);
+    }
+    catch (error) {
+        const caught = CaughtFailureSchema.parse(error);
+        const failure = valueFreeFailure(caught);
+        return { ...recorder.failed(FailureTextSchema.parse(caught)), failure };
+    }
+}
+/** Failures lead with stderr so a clipped host notification retains the diagnosis; partial stdout follows. */
+export function commandOutputText(result) {
+    const body = result.exitCode === 0
+        ? result.stdout || result.stderr
+        : [result.stderr.trim(), result.stdout.trim()].filter(text => text.length > 0).join('\n');
+    const trimmed = body.trim();
+    return trimmed.length > 0 ? trimmed : '(no output)';
+}
+//# sourceMappingURL=command-output.js.map

package/dist/harness/command-output.js.map

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

package/dist/harness/execution-queue.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The per-host execution queue: one invocation at a time, exactly like the CLI
+ * surface, whose exclusive stdio-capture lease this invariant exists to match.
+ * A host session fires tool calls and commands concurrently (a session bind
+ * racing the first tool call); the runtime's capture service is exclusive by
+ * design, so the host serializes rather than letting two executions fight for
+ * one lease and surface a CONFLICT neither caller caused.
+ */
+/** One queued step runs after the previous settles, successfully or not. */
+export declare class ExecutionQueue {
+    private tail;
+    run<T>(step: () => Promise<T>): Promise<T>;
+}
+//# sourceMappingURL=execution-queue.d.ts.map

package/dist/harness/execution-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-queue.d.ts","sourceRoot":"","sources":["../../src/harness/execution-queue.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,4EAA4E;AAC5E,qBAAa,cAAc;IAC1B,OAAO,CAAC,IAAI,CAAuC;IACnD,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAY1C"}

package/dist/harness/execution-queue.js

@@ -0,0 +1,23 @@
+/**
+ * The per-host execution queue: one invocation at a time, exactly like the CLI
+ * surface, whose exclusive stdio-capture lease this invariant exists to match.
+ * A host session fires tool calls and commands concurrently (a session bind
+ * racing the first tool call); the runtime's capture service is exclusive by
+ * design, so the host serializes rather than letting two executions fight for
+ * one lease and surface a CONFLICT neither caller caused.
+ */
+import { CaughtFailureSchema } from '@vibesdotdev/kernel';
+/** One queued step runs after the previous settles, successfully or not. */
+export class ExecutionQueue {
+    tail = Promise.resolve();
+    run(step) {
+        const next = this.tail.then(step, step);
+        // SAFETY: the step's failure is already held by `next` and its caller;
+        // the tail records settlement (carrying the parsed failure as its
+        // value, never rejecting) so the queue keeps ordering after a failed
+        // step.
+        this.tail = next.then(() => undefined, (cause) => CaughtFailureSchema.parse(cause));
+        return next;
+    }
+}
+//# sourceMappingURL=execution-queue.js.map

package/dist/harness/execution-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-queue.js","sourceRoot":"","sources":["../../src/harness/execution-queue.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,4EAA4E;AAC5E,MAAM,OAAO,cAAc;IAClB,IAAI,GAAqB,OAAO,CAAC,OAAO,EAAE,CAAC;IACnD,GAAG,CAAI,IAAsB;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACxC,uEAAuE;QACvE,kEAAkE;QAClE,qEAAqE;QACrE,QAAQ;QACR,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CACpB,GAAG,EAAE,CAAC,SAAS,EACf,CAAC,KAAc,EAAE,EAAE,CAAC,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,CACpD,CAAC;QACF,OAAO,IAAI,CAAC;IACb,CAAC;CACD"}

package/dist/harness/index.d.ts

@@ -0,0 +1,15 @@
+/** Runtime host values live on the consumer/node entry. */
+export type * from './schemas/agent-host.ts';
+export type { VibesAgentHost } from './agent-host.ts';
+export * from './agent-host-scope.ts';
+export * from './command-arguments.ts';
+export * from './command-execution.ts';
+export * from './command-output.ts';
+export * from './markers.ts';
+export * from './managed-block.ts';
+export * from './prompt.ts';
+export * from './role-prompt.ts';
+export * from './stdio-sink.ts';
+export * from './validation-errors.ts';
+export * from './strip-undefined.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/harness/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/harness/index.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,mBAAmB,yBAAyB,CAAC;AAC7C,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC"}

package/dist/harness/index.js

@@ -0,0 +1,12 @@
+export * from "./agent-host-scope.js";
+export * from "./command-arguments.js";
+export * from "./command-execution.js";
+export * from "./command-output.js";
+export * from "./markers.js";
+export * from "./managed-block.js";
+export * from "./prompt.js";
+export * from "./role-prompt.js";
+export * from "./stdio-sink.js";
+export * from "./validation-errors.js";
+export * from "./strip-undefined.js";
+//# sourceMappingURL=index.js.map

package/dist/harness/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/harness/index.ts"],"names":[],"mappings":"AAGA,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC"}