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

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":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,gBAAgB,EAAqB,MAAM,qBAAqB,CAAC;AAChH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,EAAE,cAAc,EAAsE,MAAM,yBAAyB,CAAC;AAE7H,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;AAE9B;;;;;;;;GAQG;AACH,MAAM,mBAAmB,GAAG,CAAC;KAC3B,OAAO,EAAE;KACT,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE;IACpB,MAAM,IAAI,GAAG,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACzC,IAAI,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC;IACnC,MAAM,IAAI,GAAG,cAAc,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC;AAC1E,CAAC,CAAC;KACD,KAAK,CAAC,sBAAsB,CAAC,CAAC;AAEhC;;;;;;GAMG;AACH,MAAM,0BAA0B,GAAG,CAAC;KAClC,OAAO,EAAE;KACT,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;AAE9G;;;;GAIG;AACH,MAAM,iBAAiB,GAAG,CAAC;KACzB,WAAW,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,QAAQ,EAAE,EAAE,WAAW,EAAE,UAAU,CAAC,QAAQ,EAAE,EAAE,CAAC;KACnF,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,WAAW,IAAI,+BAA+B,CAAC;KAC3F,KAAK,CAAC,+BAA+B,CAAC,CAAC;AAEzC;;;;;;;GAOG;AACH,MAAM,OAAO,qBAAqB;IACxB,EAAE,CAAY;IACN,GAAG,GAAa,EAAE,CAAC;IACnB,GAAG,GAAa,EAAE,CAAC;IAC5B,MAAM,CAAuB;IAErC,YAAY,SAAiB;QAC5B,MAAM,IAAI,GAAG,CAAC,OAAe,EAAQ,EAAE;YACtC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;QAC/B,CAAC,CAAC;QACF,MAAM,IAAI,GAAG,CAAC,OAAe,EAAQ,EAAE;YACtC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;QAC/B,CAAC,CAAC;QACF,0EAA0E;QAC1E,8CAA8C;QAC9C,MAAM,MAAM,GAAG,GAAU,EAAE;YAC1B,MAAM,IAAI,eAAe,CAAC,gBAAgB,SAAS,4CAA4C,EAAE,aAAa,EAAE;gBAC/G,MAAM,EAAE,eAAe;gBACvB,SAAS,EAAE,KAAK;gBAChB,OAAO,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE;aAC1B,CAAC,CAAC;QACJ,CAAC,CAAC;QACF,MAAM,MAAM,GAAG,CAAC,IAAa,EAAQ,EAAE;YACtC,MAAM,QAAQ,GAAG,0BAA0B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACxD,sEAAsE;YACtE,+DAA+D;YAC/D,IAAI,QAAQ,CAAC,MAAM,CAAC,OAAO;gBAAE,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC;YAChE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC,CAAC;QACF,IAAI,CAAC,EAAE,GAAG;YACT,IAAI;YACJ,OAAO,EAAE,IAAI;YACb,GAAG,EAAE,IAAI;YACT,IAAI;YACJ,KAAK,EAAE,IAAI;YACX,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,MAAM;YACb,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE;gBAClB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;oBAAE,IAAI,CAAC,GAAG,GAAG,KAAK,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAChG,CAAC;YACD,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,MAAM,EAAE;YAC5B,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC,MAAM,EAAE;YAC9B,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,KAAK;YAC1B,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC;YAC1E,SAAS,EAAE,GAAG,EAAE,GAAE,CAAC;YACnB,MAAM;SACN,CAAC;IACH,CAAC;IAED,sFAAsF;IACtF,UAAU,CAAC,OAA4B,EAAE,IAAY;QACpD,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzD,CAAC;IAED,mFAAmF;IACnF,WAAW,CAAC,OAA4B,EAAE,KAAiB;QAC1D,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED,4DAA4D;IAC5D,MAAM,CAAC,QAAgB;QACtB,MAAM,IAAI,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QAChF,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QAC3C,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;IACvC,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,OAAe;QACrB,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,GAAG,OAAO,IAAI,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;CACD;AAED,yGAAyG;AACzG,MAAM,UAAU,mBAAmB,CAAC,KAAc;IACjD,OAAO,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACzC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CACnC,OAA0B,EAC1B,IAAoB,EACpB,OAAuB,EACvB,QAA+B,EAC/B,OAAqB;IAErB,MAAM,OAAO,GAAmB,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC;IAC7D,IAAI,CAAC;QACJ,MAAM,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACtC,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAChD,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACzC,OAAO,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,iBAAiB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;IACzE,CAAC;AACF,CAAC;AAED,8GAA8G;AAC9G,MAAM,UAAU,iBAAiB,CAAC,MAA8B;IAC/D,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,KAAK,CAAC;QACjC,CAAC,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM;QAChC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3F,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC;AACrD,CAAC"}

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

package/dist/harness/live-tools.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Live tool catalog for foreign hosts.
+ *
+ * The runtime's `tools/tool` registry is the only catalog. This module is the
+ * single shared projection hosts use to enumerate it: normalize one registry
+ * descriptor (warm-socket query or `vibes tools list --format json` row) into
+ * host-neutral tool data, and fetch that data over the CLI transport. Host
+ * adapters (Pi, OpenCode) add only their own registration mechanics on top;
+ * they never keep a tool list of their own.
+ */
+import * as z from 'zod/v4';
+import type { RunVibesFn, RunVibesSyncFn, RunVibesOptions } from '@vibesdotdev/cli-contracts';
+import type { RuntimeHardware, RuntimePurpose, RuntimeScope } from '@vibesdotdev/kernel/schemas/scope';
+import type { RuntimeInvokeCaller } from '@vibesdotdev/kernel/schemas/invoke-caller';
+/** A JSON value as a registry descriptor carries it. */
+declare const LiveJsonSchema: 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 LiveJson = z.output<typeof LiveJsonSchema>;
+/**
+ * Structural descriptor subset a host projection consumes. Satisfied by
+ * warm-socket `tools/tool` descriptors and by CLI `tools list` JSON rows;
+ * both are just views over the same registry.
+ */
+export declare const LiveToolDescriptorSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    mcpDescription: z.ZodOptional<z.ZodString>;
+    inputSchema: z.ZodOptional<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>>>;
+    schemas: z.ZodOptional<z.ZodObject<{
+        input: z.ZodOptional<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>>>;
+        output: z.ZodOptional<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>>>;
+        actionSafety: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$loose>>;
+    safety: z.ZodOptional<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>>>;
+    requiresApproval: z.ZodOptional<z.ZodBoolean>;
+    purpose: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    hardware: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    source: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+export type LiveToolDescriptor = z.output<typeof LiveToolDescriptorSchema>;
+export type LiveToolSchemaSource = 'runtime-schema' | 'open-object';
+/** A published object JSON Schema: `type: "object"` and whatever else it declares. */
+declare const ObjectJsonSchemaSchema: z.ZodObject<{
+    type: z.ZodLiteral<"object">;
+}, z.core.$catchall<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 LiveToolInputSchema = z.output<typeof ObjectJsonSchemaSchema>;
+export type NormalizedLiveTool = {
+    id: string;
+    label: string;
+    description: string;
+    inputSchema: LiveToolInputSchema;
+    /** The runtime's published output schema, when the tool has one; a host that supports structured output projects it. */
+    outputSchema?: LiveJson;
+    schemaSource: LiveToolSchemaSource;
+    safety?: LiveJson;
+    requiresApproval?: boolean;
+    schemas?: {
+        actionSafety?: Record<string, string>;
+    };
+};
+/**
+ * One registry descriptor becomes one host-neutral tool. Prefers the
+ * registry-published input schema (the same projection the native agent loop
+ * uses); degrades to an open object and says so in the description rather
+ * than silently accepting anything.
+ */
+export declare function normalizeLiveTool(descriptor: LiveToolDescriptor): NormalizedLiveTool;
+export type LiveToolCatalogOptions = Pick<RunVibesOptions, 'cwd' | 'signal' | 'env' | 'hostEnv'> & {
+    purpose?: RuntimePurpose;
+    hardware?: RuntimeHardware;
+    caller?: RuntimeInvokeCaller;
+};
+/**
+ * The hardware a runtime's host declared. Hardware is read from the declared
+ * scope, never guessed from the environment; a host with no runtime passes no
+ * hardware and the child CLI answers from its own declaration.
+ */
+export declare function resolveExternalRuntimeHardware(runtime: {
+    readonly declaredScope: Pick<RuntimeScope, 'hardware'>;
+}): RuntimeHardware;
+/** Project caller and hardware identity into child CLI processes. */
+export declare function withExternalHostEnvironment(environment?: Readonly<Record<string, string | undefined>>, context?: {
+    hardware?: RuntimeHardware;
+    caller?: RuntimeInvokeCaller;
+    env?: Record<string, string | undefined>;
+}): {
+    [x: string]: string | undefined;
+};
+/** A host tool call's input as the projection reads it: a JSON object. */
+export declare const HostToolInputSchema: z.ZodReadonly<z.ZodRecord<z.ZodString, z.ZodOptional<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 HostToolInput = z.infer<typeof HostToolInputSchema>;
+/**
+ * One approval decision for every native host projection. Only a declared
+ * `read` safety (the selected action's, else the tool's) runs unapproved; a
+ * missing or unrecognised declaration requires approval.
+ */
+export declare function requiresExternalHostApproval(descriptor: Pick<LiveToolDescriptor, 'id' | 'safety' | 'requiresApproval' | 'schemas'>, input?: HostToolInput): boolean;
+/** Apply the host's scope and identity to the canonical CLI fallback path. */
+export declare function withExternalHostToolContext(argv: string[], context: {
+    purpose?: RuntimePurpose;
+    hardware?: RuntimeHardware;
+    caller?: RuntimeInvokeCaller;
+    env?: Record<string, string | undefined>;
+}): string[];
+export type LiveCatalogSkipped = {
+    id: string;
+    reason: string;
+};
+export type LiveCatalogResult = {
+    tools: LiveToolDescriptor[];
+    skipped: LiveCatalogSkipped[];
+};
+/**
+ * Parse `vibes tools list --format json` stdout. `--format json` promises one
+ * parseable document: a row array on success. Anything else is a loud, typed
+ * failure, never an empty catalog masquerading as truth.
+ */
+export declare function parseLiveToolsOutput(stdout: string): LiveCatalogResult;
+/** Synchronous variant for hosts that register before they can await. */
+export declare function fetchLiveToolsViaCliSync(run: RunVibesSyncFn, options: LiveToolCatalogOptions): LiveCatalogResult;
+/**
+ * Ask the local CLI for the live registry. Fails closed with an actionable
+ * typed error; hosts register nothing on failure rather than a stale subset.
+ */
+export declare function fetchLiveToolsViaCli(run: RunVibesFn, options: LiveToolCatalogOptions): Promise<LiveCatalogResult>;
+/** Read a catalog row through the descriptor schema; `undefined` when it is not one. */
+export declare function parseLiveToolDescriptor(row: LiveJson): LiveToolDescriptor | undefined;
+export {};
+//# sourceMappingURL=live-tools.d.ts.map

package/dist/harness/live-tools.d.ts.map

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