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

package/dist/harness/agent-host.js

@@ -0,0 +1,203 @@
+/**
+ * The agent-host runtime: one booted Vibes runtime, queried for whatever the
+ * host can present.
+ *
+ * A coding-agent host (Pi, OpenCode, ACP, any future one) is not a second package
+ * manager and not a second catalog. It boots ONE real runtime through the
+ * kernel's own entry — the same composition the `vibes` binary uses: the CLI
+ * host's plugin floor, then the global scope, then the workspace the host runs
+ * in — and then *queries* it. Every tool, command, prompt, model and provider a
+ * host shows the model is a view over a kind that runtime already holds, and a
+ * host that cannot ask a kind has no equivalent for it, so it maps nothing.
+ *
+ * Why the mapping lives in Framework rather than in a host package is that every
+ * one of these mappings is the SAME mapping: Pi and OpenCode differ in how they
+ * render a tool row and how they name a command, never in where the descriptor
+ * comes from. The environment is injected, never imported — a host runs on Node
+ * or Bun and declares its own, so Framework holds the portable policy and the
+ * host holds the composition root.
+ *
+ * The scope it boots under is `agent-host-scope.ts`; the contracts are in
+ * `schemas/agent-host.ts`; running, capturing and parsing a command are
+ * `command-execution.ts`, `command-output.ts` and `command-arguments.ts`.
+ */
+import { bootstrapVibesRuntime, CapabilityError, CaughtFailureSchema } from '@vibesdotdev/kernel';
+import { invokeToolAsCaller } from '@vibesdotdev/tools/execution';
+import { serializeDescriptor } from '@vibesdotdev/kernel-rpc/descriptor-wire';
+import { HostToolInputSchema, LiveToolDescriptorSchema } from "./live-tools.js";
+import { executeHostCommand } from "./command-execution.js";
+import { ExecutionQueue } from "./execution-queue.js";
+import { conciseValidationFailure } from "./validation-errors.js";
+import { JsonValueFromReaderSchema } from '@vibesdotdev/kernel/schemas/json';
+import {} from "./schemas/agent-host.js";
+export { agentHostSettingsPlugin } from "./agent-host-settings.js";
+/** The kinds this host projection knows how to ask. A kind it cannot map is simply not queried. */
+export const AGENT_HOST_KINDS = {
+    tools: 'tools/tool',
+    groups: 'cli/group',
+    commands: 'cli/command',
+    prompts: 'prompts/manifest',
+    models: 'ai/model',
+    providers: 'ai/provider'
+};
+/**
+ * One kind's enabled descriptors, or an empty list when a plugin did not register
+ * the kind. `T` is the descriptor the kind declares: the kernel already parsed
+ * each one against that schema at registration, so a second parse here would
+ * assert a fact the registry has already established.
+ */
+function descriptorsOf(runtime, kind) {
+    if (!runtime.hasKind(kind))
+        return [];
+    // SAFETY: the runtime registered these descriptors under `kind`, whose
+    // descriptorSchema validated each one at registration; `T` names that shape.
+    return runtime.query(kind).enabled().descriptors();
+}
+/**
+ * One booted runtime, queried.
+ *
+ * The class owns the runtime's whole life: it boots it, and `dispose` releases
+ * it exactly once however many times a host calls it. A host that switches
+ * workspaces disposes the previous host before booting the next, so two runtimes
+ * never own the same workspace.
+ */
+export class VibesAgentHost {
+    runtime;
+    root;
+    workspaceRoot;
+    calls = 0;
+    /** One execution at a time: the CLI's own invariant, kept for the same exclusive stdio lease. */
+    executions = new ExecutionQueue();
+    constructor(runtime, root, workspaceRoot) {
+        this.runtime = runtime;
+        this.root = root;
+        this.workspaceRoot = workspaceRoot;
+    }
+    /**
+     * Boot one runtime for an agent host session.
+     *
+     * The composition is a workspace composition, so the kernel finds the
+     * workspace's own `vibes.config` and composes its plugins on top of the host's
+     * floor. This headless harness omits package exports that declare the TUI
+     * surface while keeping the rest of the selected workspace graph.
+     */
+    static async boot(options) {
+        const runtime = await bootstrapVibesRuntime({
+            environment: options.environment,
+            composition: {
+                kind: 'workspace',
+                floor: { plugins: [...options.composition.floor], config: options.composition.config },
+                global: true,
+                failurePolicy: 'abort',
+                omitSurfaces: ['tui']
+            },
+            binding: options.binding ?? 'default',
+            activation: 'boot'
+        });
+        return new VibesAgentHost(runtime, options.root, options.workspaceRoot);
+    }
+    /** Every registry this host can answer, read in one pass over the kernel's own kind list. */
+    catalogs() {
+        return {
+            tools: this.catalog(),
+            groups: this.groups(),
+            commands: this.commands(),
+            prompts: this.prompts(),
+            models: this.models(),
+            providers: this.providers()
+        };
+    }
+    /**
+     * The live `tools/tool` registry in its wire form, through the daemon socket's
+     * own serializer — so a host receives JSON Schema exactly as the socket served
+     * it, one schema path for every transport rather than one per host.
+     */
+    catalog() {
+        return descriptorsOf(this.runtime, AGENT_HOST_KINDS.tools).map((descriptor) => LiveToolDescriptorSchema.parse(serializeDescriptor(descriptor)));
+    }
+    /** The live `cli/group` registry: how the host nests commands under a prefix. */
+    groups() {
+        return descriptorsOf(this.runtime, AGENT_HOST_KINDS.groups);
+    }
+    /** The live `cli/command` registry: the commands this host can offer. */
+    commands() {
+        return descriptorsOf(this.runtime, AGENT_HOST_KINDS.commands).filter((descriptor) => descriptor.internal !== true);
+    }
+    /** The live `prompts/manifest` registry: the prompts this host can render. */
+    prompts() {
+        return descriptorsOf(this.runtime, AGENT_HOST_KINDS.prompts);
+    }
+    /** The live `ai/model` and `ai/provider` registries, when the workspace composed the AI plugin. */
+    models() {
+        return descriptorsOf(this.runtime, AGENT_HOST_KINDS.models);
+    }
+    providers() {
+        return descriptorsOf(this.runtime, AGENT_HOST_KINDS.providers);
+    }
+    /**
+     * Run `toolId` as the caller this host session names, through the same path
+     * `vibes tools run` uses; the host's abort signal reaches the tool. Both
+     * ends are JSON because a host bridge carries JSON; a tool whose output is
+     * not JSON fails at this boundary rather than handing a host a value it
+     * cannot render or forward.
+     */
+    async invokeTool(toolId, input, options = {}) {
+        return this.executions.run(async () => {
+            let parsedInput;
+            try {
+                parsedInput = HostToolInputSchema.safeParse(input);
+            }
+            catch (error) {
+                throw new CapabilityError('Tool input could not be validated.', 'INVALID_INPUT', {
+                    reason: 'agent-host-input-invalid',
+                    cause: CaughtFailureSchema.parse(error)
+                });
+            }
+            if (!parsedInput.success) {
+                throw new CapabilityError(conciseValidationFailure(parsedInput.error), 'INVALID_INPUT', {
+                    reason: 'agent-host-input-invalid',
+                    cause: parsedInput.error
+                });
+            }
+            const output = await invokeToolAsCaller(this.runtime, {
+                toolId,
+                input: parsedInput.data,
+                callId: `agent_${Date.now()}_${++this.calls}`,
+                loggerId: 'external:agent-host',
+                session: options.session,
+                harness: options.harness,
+                harnessSessionId: options.harnessSessionId,
+                signal: options.signal
+            });
+            let parsedOutput;
+            try {
+                parsedOutput = JsonValueFromReaderSchema.safeParse(output);
+            }
+            catch (error) {
+                throw new CapabilityError('Tool output could not be validated.', 'INTERNAL', {
+                    reason: 'agent-host-output-invalid',
+                    cause: CaughtFailureSchema.parse(error)
+                });
+            }
+            if (!parsedOutput.success) {
+                throw new CapabilityError(conciseValidationFailure(parsedOutput.error), 'INTERNAL', {
+                    reason: 'agent-host-output-invalid',
+                    cause: parsedOutput.error
+                });
+            }
+            return parsedOutput.data;
+        });
+    }
+    /**
+     * Run one `cli/command` in this runtime and return what it wrote. The host's
+     * process exit code is untouched; this never calls `process.exit`.
+     */
+    runCommand(command, args = {}, options = {}, invocation = {}) {
+        return this.executions.run(() => executeHostCommand(this.runtime, command, args, options, invocation));
+    }
+    /** Release the runtime. Idempotent: several callers may race a disposal. */
+    dispose() {
+        return this.runtime.dispose();
+    }
+}
+//# sourceMappingURL=agent-host.js.map

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"}