@vendoai/agent 0.4.0

package/dist/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../src/ids.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,kBAAkB;AAClB,wBAAgB,YAAY,IAAI,QAAQ,CAEvC;AAED,iBAAiB;AACjB,wBAAgB,WAAW,IAAI,MAAM,CAEpC"}

package/dist/ids.js

@@ -0,0 +1,9 @@
+/** 03-agent §5 */
+export function mintThreadId() {
+    return `thr_${globalThis.crypto.randomUUID().replaceAll("-", "")}`;
+}
+/** 01-core §7 */
+export function mintAuditId() {
+    return `aud_${globalThis.crypto.randomUUID().replaceAll("-", "")}`;
+}
+//# sourceMappingURL=ids.js.map

package/dist/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../src/ids.ts"],"names":[],"mappings":"AAEA,kBAAkB;AAClB,MAAM,UAAU,YAAY;IAC1B,OAAO,OAAO,UAAU,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC;AACrE,CAAC;AAED,iBAAiB;AACjB,MAAM,UAAU,WAAW;IACzB,OAAO,OAAO,UAAU,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC;AACrE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { createAgent } from "./agent.js";
+export type { VendoAgent } from "./agent.js";
+export type { CapabilityMissConfig } from "./capability-miss.js";
+export { buildVendoToolPack, type VendoPackExecuteOptions, type VendoPackTool, type VendoToolPackCoreOptions, } from "./pack.js";
+export { VENDO_CREATE_APP_TOOL, VENDO_DELEGATE_TOOL, VENDO_TOOL_PACK_PREFIX, type VendoDelegateResult, type VendoToolPackFilter, type VendoToolPackOptions, } from "./tool-pack.js";
+export type { ToolSearchConfig, ToolSearchFn, ToolSearchMatch } from "./tool-search.js";
+export type { Thread, ThreadSummary } from "./threads.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EACL,kBAAkB,EAClB,KAAK,uBAAuB,EAC5B,KAAK,aAAa,EAClB,KAAK,wBAAwB,GAC9B,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,GAC1B,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxF,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { createAgent } from "./agent.js";
+export { buildVendoToolPack, } from "./pack.js";
+export { VENDO_CREATE_APP_TOOL, VENDO_DELEGATE_TOOL, VENDO_TOOL_PACK_PREFIX, } from "./tool-pack.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGzC,OAAO,EACL,kBAAkB,GAInB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,GAIvB,MAAM,gBAAgB,CAAC"}

package/dist/pack.d.ts

@@ -0,0 +1,37 @@
+import { type AgentRunner, type Json, type RunContext, type ToolRegistry } from "@vendoai/core";
+import { type VendoToolPackFilter } from "./tool-pack.js";
+export interface VendoToolPackCoreOptions extends VendoToolPackFilter {
+    /** The guard-bound registry (guard.bind(actions)) — the pack never wraps an
+     *  unbound registry; parking, grants, breakers, and audit all live in the
+     *  binding's execute path. */
+    registry: ToolRegistry;
+    /** Backs `vendo_delegate` (the umbrella passes `agent.asRunner()`). */
+    runner: AgentRunner;
+}
+/** How a pack tool is executed by a format shim. `ctx` is per-call because the
+ *  Mastra shim resolves its principal lazily from the framework's request
+ *  context; the AI SDK shim closes one request-scoped ctx over every call. */
+export interface VendoPackExecuteOptions {
+    ctx: RunContext;
+    /** The host loop's tool-call id, for audit continuity; unset mints one. */
+    callId?: string;
+}
+/** One framework-neutral pack tool: final `vendo_*` name, the descriptor's
+ *  JSON-Schema input, and a guarded execute returning either a versioned
+ *  envelope (`vendo/app-ref@1`, `vendo/approval-ref@1`) or plain data. */
+export interface VendoPackTool {
+    name: string;
+    description: string;
+    inputSchema: Json;
+    execute(input: unknown, options: VendoPackExecuteOptions): Promise<unknown>;
+}
+/**
+ * Build the pack: every registered host tool guard-wrapped under `vendo_`,
+ * plus the two built-ins. Vendo-internal registry tools (names already under
+ * `vendo_` — the apps runtime's `vendo_apps_*`, doctor probes) are never
+ * double-wrapped: the pack's door to app creation is `vendo_create_app`, and
+ * in-app interaction rides the wire, not the host loop. `include`/`exclude`
+ * match FINAL namespaced names exactly; exclude wins.
+ */
+export declare function buildVendoToolPack(options: VendoToolPackCoreOptions): Promise<VendoPackTool[]>;
+//# sourceMappingURL=pack.d.ts.map

package/dist/pack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack.d.ts","sourceRoot":"","sources":["../src/pack.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,WAAW,EAChB,KAAK,IAAI,EACT,KAAK,UAAU,EAGf,KAAK,YAAY,EAKlB,MAAM,eAAe,CAAC;AACvB,OAAO,EAKL,KAAK,mBAAmB,EACzB,MAAM,gBAAgB,CAAC;AAexB,MAAM,WAAW,wBAAyB,SAAQ,mBAAmB;IACnE;;kCAE8B;IAC9B,QAAQ,EAAE,YAAY,CAAC;IACvB,uEAAuE;IACvE,MAAM,EAAE,WAAW,CAAC;CACrB;AAED;;8EAE8E;AAC9E,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,UAAU,CAAC;IAChB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;0EAE0E;AAC1E,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,IAAI,CAAC;IAClB,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7E;AAqMD;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAiBpG"}

package/dist/pack.js

@@ -0,0 +1,225 @@
+import { VENDO_APPS_CREATE_TOOL, VENDO_APPROVAL_REF_KIND, VENDO_APP_REF_KIND, VENDO_VIEW_STREAM, canonicalJson, } from "@vendoai/core";
+import { VENDO_CREATE_APP_TOOL, VENDO_DELEGATE_TOOL, VENDO_TOOL_PACK_PREFIX, } from "./tool-pack.js";
+/**
+ * Existing-agents seam — the framework-neutral tool pack a BYO agent loop gets
+ * (frozen contract: docs/superpowers/specs/2026-07-20-existing-agents-contracts.md §2).
+ * A promotion of the guard-bound wrapping Vendo's own loop uses (tools.ts):
+ * every pack tool executes through the SAME guard-bound registry, so no tool
+ * reachable from a BYO loop has an unguarded route. The umbrella's `./ai-sdk`
+ * and `./mastra` subpaths are thin format shims over this core.
+ */
+const DRAFT_2020_12 = "https://json-schema.org/draft/2020-12/schema";
+const TITLE_CAP = 80;
+const SUMMARY_CAP = 500;
+function mintCallId() {
+    return `call_${globalThis.crypto.randomUUID()}`;
+}
+function executionError() {
+    return {
+        status: "error",
+        error: { code: "execution", message: "Tool execution failed." },
+    };
+}
+/** One human-readable line describing what is waiting — the tool descriptor
+ *  plus the guard's inputPreview vocabulary (`<tool> <canonical args>`). */
+function approvalSummary(descriptor, args) {
+    let preview;
+    try {
+        preview = canonicalJson(args);
+    }
+    catch {
+        preview = "";
+    }
+    const summary = `Awaiting user approval: ${descriptor.description || descriptor.name} — ${descriptor.name} ${preview}`
+        .replace(/\s+/g, " ")
+        .trim();
+    return summary.length > SUMMARY_CAP ? `${summary.slice(0, SUMMARY_CAP - 1)}…` : summary;
+}
+function approvalRef(approvalId, descriptor, args) {
+    return { kind: VENDO_APPROVAL_REF_KIND, approvalId, summary: approvalSummary(descriptor, args) };
+}
+/** The embed-chrome title known at fast-return time: the prompt itself,
+ *  collapsed to one line and capped. */
+function titleFromPrompt(prompt) {
+    const collapsed = typeof prompt === "string" ? prompt.replace(/\s+/g, " ").trim() : "";
+    if (collapsed.length === 0)
+        return "Vendo app";
+    return collapsed.length > TITLE_CAP ? `${collapsed.slice(0, TITLE_CAP - 1)}…` : collapsed;
+}
+function appRefFromDocument(output, fallbackTitle) {
+    const document = typeof output === "object" && output !== null
+        ? output
+        : undefined;
+    if (typeof document?.id !== "string" || !document.id.startsWith("app_"))
+        return null;
+    return {
+        kind: VENDO_APP_REF_KIND,
+        appId: document.id,
+        title: typeof document.name === "string" && document.name.length > 0 ? document.name : fallbackTitle,
+    };
+}
+async function guardedExecute(registry, call, ctx) {
+    try {
+        return await registry.execute(call, ctx);
+    }
+    catch {
+        return executionError();
+    }
+}
+/** Envelope-or-plain-data mapping shared by every pack tool: parking returns
+ *  the approval ref (no throw, no block — §2); a clean run returns the output
+ *  the way any tool output reads; error/blocked outcomes pass through as plain
+ *  data the model can act on. */
+function mapOutcome(outcome, descriptor, args) {
+    if (outcome.status === "pending-approval")
+        return approvalRef(outcome.approvalId, descriptor, args);
+    if (outcome.status === "ok")
+        return outcome.output;
+    return outcome;
+}
+function applyFilter(names, filter) {
+    const included = filter.include === undefined
+        ? new Set(names)
+        : new Set(names.filter((name) => filter.include.includes(name)));
+    for (const name of filter.exclude ?? [])
+        included.delete(name);
+    return included;
+}
+function wrapHostTool(registry, descriptor) {
+    return {
+        name: `${VENDO_TOOL_PACK_PREFIX}${descriptor.name}`,
+        description: descriptor.description,
+        inputSchema: structuredClone(descriptor.inputSchema),
+        async execute(input, options) {
+            const call = { id: options.callId ?? mintCallId(), tool: descriptor.name, args: input };
+            const outcome = await guardedExecute(registry, call, options.ctx);
+            return mapOutcome(outcome, descriptor, input);
+        },
+    };
+}
+/** `vendo_create_app` — generate UI, returning fast: the FIRST streamed view
+ *  part already carries the app's permanent id, so the app-ref envelope goes
+ *  back to the loop while the build keeps streaming over the wire. Without a
+ *  streamed part the finished document supplies the ref. */
+function createAppTool(registry, descriptor) {
+    return {
+        name: VENDO_CREATE_APP_TOOL,
+        description: "Create a Vendo app (generated UI) from a natural-language prompt. Returns fast with a vendo/app-ref@1 envelope; the build streams to the host's embed over the Vendo wire, so never wait for or report on build completion.",
+        inputSchema: {
+            $schema: DRAFT_2020_12,
+            type: "object",
+            properties: { prompt: { type: "string", minLength: 1 } },
+            required: ["prompt"],
+            additionalProperties: false,
+        },
+        async execute(input, options) {
+            const args = input;
+            const fallbackTitle = titleFromPrompt(args?.prompt);
+            const call = {
+                id: options.callId ?? mintCallId(),
+                tool: VENDO_APPS_CREATE_TOOL,
+                args: input,
+            };
+            let resolveFast;
+            const fast = new Promise((resolve) => { resolveFast = resolve; });
+            Object.defineProperty(call, VENDO_VIEW_STREAM, {
+                value: (update) => {
+                    const appId = update?.part?.appId;
+                    if (typeof appId === "string" && appId.startsWith("app_")) {
+                        resolveFast({ kind: VENDO_APP_REF_KIND, appId, title: fallbackTitle });
+                    }
+                },
+            });
+            const settled = guardedExecute(registry, call, options.ctx).then((outcome) => {
+                if (outcome.status === "ok") {
+                    return appRefFromDocument(outcome.output, fallbackTitle) ?? outcome.output;
+                }
+                return mapOutcome(outcome, descriptor, input);
+            });
+            // The build may still be streaming when the fast ref wins the race; its
+            // completion (and any late failure) belongs to the wire, not this call.
+            settled.catch(() => undefined);
+            return Promise.race([fast, settled]);
+        },
+    };
+}
+/** `vendo_delegate` — whole-task delegation through the same AgentRunner seam
+ *  automations ride. The delegated run executes over THIS registry (guard-bound),
+ *  and everything envelope-worthy it produces comes back as refs. */
+function delegateTool(registry, runner) {
+    return {
+        name: VENDO_DELEGATE_TOOL,
+        description: "Delegate a whole task to Vendo's own agent. Runs to completion server-side and returns { status, summary, refs } — refs carry vendo/app-ref@1 / vendo/approval-ref@1 envelopes for anything the run produced.",
+        inputSchema: {
+            $schema: DRAFT_2020_12,
+            type: "object",
+            properties: { task: { type: "string", minLength: 1 } },
+            required: ["task"],
+            additionalProperties: false,
+        },
+        async execute(input, options) {
+            const task = input?.task;
+            const refs = [];
+            const descriptorsByName = registry.descriptors().then((descriptors) => new Map(descriptors.map((descriptor) => [descriptor.name, descriptor])));
+            descriptorsByName.catch(() => undefined);
+            const capturing = {
+                descriptors: () => registry.descriptors(),
+                async execute(call, runCtx) {
+                    const outcome = await registry.execute(call, runCtx);
+                    if (call.tool === VENDO_APPS_CREATE_TOOL && outcome.status === "ok") {
+                        const ref = appRefFromDocument(outcome.output, titleFromPrompt(call.args?.prompt));
+                        if (ref !== null)
+                            refs.push(ref);
+                    }
+                    else if (outcome.status === "pending-approval") {
+                        const descriptor = (await descriptorsByName.catch(() => undefined))?.get(call.tool)
+                            ?? { name: call.tool, description: "", inputSchema: {}, risk: "write" };
+                        refs.push(approvalRef(outcome.approvalId, descriptor, call.args));
+                    }
+                    return outcome;
+                },
+            };
+            try {
+                const report = await runner({ prompt: typeof task === "string" ? task : "", tools: capturing }, options.ctx);
+                const result = { status: report.status, summary: report.summary, refs };
+                return result;
+            }
+            catch {
+                const result = {
+                    status: "error",
+                    summary: "The delegated run could not be completed.",
+                    refs,
+                };
+                return result;
+            }
+        },
+    };
+}
+/**
+ * Build the pack: every registered host tool guard-wrapped under `vendo_`,
+ * plus the two built-ins. Vendo-internal registry tools (names already under
+ * `vendo_` — the apps runtime's `vendo_apps_*`, doctor probes) are never
+ * double-wrapped: the pack's door to app creation is `vendo_create_app`, and
+ * in-app interaction rides the wire, not the host loop. `include`/`exclude`
+ * match FINAL namespaced names exactly; exclude wins.
+ */
+export async function buildVendoToolPack(options) {
+    const descriptors = await options.registry.descriptors();
+    const byName = new Map();
+    for (const descriptor of descriptors) {
+        if (descriptor.name.startsWith(VENDO_TOOL_PACK_PREFIX))
+            continue;
+        const tool = wrapHostTool(options.registry, descriptor);
+        byName.set(tool.name, tool);
+    }
+    // Built-ins land last: a host tool whose namespaced name collides with one
+    // can never shadow the pack's own doors.
+    const appsCreate = descriptors.find((descriptor) => descriptor.name === VENDO_APPS_CREATE_TOOL);
+    if (appsCreate !== undefined) {
+        byName.set(VENDO_CREATE_APP_TOOL, createAppTool(options.registry, appsCreate));
+    }
+    byName.set(VENDO_DELEGATE_TOOL, delegateTool(options.registry, options.runner));
+    const included = applyFilter([...byName.keys()], options);
+    return [...byName.values()].filter((tool) => included.has(tool.name));
+}
+//# sourceMappingURL=pack.js.map

package/dist/pack.js.map

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

package/dist/prompt.d.ts

@@ -0,0 +1,8 @@
+import type { Guard, RunContext } from "@vendoai/core";
+/** 03-agent §3: company directions are mandatory policy context and fail closed. */
+export declare function assembleSystemPrompt(guard: Guard, ctx: RunContext, system?: {
+    product?: string;
+    catalog?: string;
+    instructions?: string;
+}, capabilityMiss?: boolean): Promise<string>;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAuBvD,oFAAoF;AACpF,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,UAAU,EACf,MAAM,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,EACtE,cAAc,UAAQ,GACrB,OAAO,CAAC,MAAM,CAAC,CAqBjB"}

package/dist/prompt.js

@@ -0,0 +1,43 @@
+const OPERATING_PROMPT = `You are Vendo's agent.
+Act through the host's available tools on behalf of the signed-in user.
+Stay within the user's request and use the authority available in this context.
+Ask for approval whenever the guard requires it.
+If a call is blocked, explain the constraint and adapt your approach.
+If a call is queued for approval, say what is pending and continue where useful.
+Never claim a tool ran unless its result confirms that it did.
+Never invent tool outputs, records, or side effects.
+For away runs, clearly state what completed and what was left pending.`;
+const CAPABILITY_MISS_PROMPT = `When the user's ask cannot be fulfilled:
+- If no available tool can perform it, call vendo_report_capability_miss with kind "no-matching-tool" before replying.
+- If you explicitly give up after trying available approaches, call vendo_report_capability_miss with kind "agent-give-up" before replying.
+- List only tool names you actually considered. Do not call the reporter for a pending approval or a policy-blocked call.
+Repeated failures are detected automatically; if the reporter says the miss was already recorded, do not call it again.`;
+// 03-agent §3 item (4): the catalog+theme summary rides only where generated
+// trees can actually render — the chat surface and the app venue. Away
+// automation runs and the MCP door get no component vocabulary.
+const TREE_VENUES = new Set(["chat", "app"]);
+/** 03-agent §3: company directions are mandatory policy context and fail closed. */
+export async function assembleSystemPrompt(guard, ctx, system, capabilityMiss = false) {
+    const sections = [OPERATING_PROMPT];
+    if (capabilityMiss)
+        sections.push(CAPABILITY_MISS_PROMPT);
+    const product = system?.product?.trim();
+    if (product)
+        sections.push(`Product\n${product}`);
+    const directions = (await guard.directions(ctx))
+        .map((direction) => direction.trim())
+        .filter(Boolean);
+    if (directions.length > 0) {
+        sections.push(`Directions\n${directions.map((direction) => `- ${direction}`).join("\n")}`);
+    }
+    // 03-agent §3 item (4) — the umbrella assembles the summary (AGENT-1); the
+    // agent places it, venue-gated.
+    const catalog = system?.catalog?.trim();
+    if (catalog && TREE_VENUES.has(ctx.venue))
+        sections.push(catalog);
+    const instructions = system?.instructions?.trim();
+    if (instructions)
+        sections.push(instructions);
+    return sections.join("\n\n");
+}
+//# sourceMappingURL=prompt.js.map

package/dist/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"AAEA,MAAM,gBAAgB,GAAG;;;;;;;;uEAQ8C,CAAC;AAExE,MAAM,sBAAsB,GAAG;;;;wHAIyF,CAAC;AAEzH,6EAA6E;AAC7E,uEAAuE;AACvE,gEAAgE;AAChE,MAAM,WAAW,GAAqC,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;AAE/E,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,KAAY,EACZ,GAAe,EACf,MAAsE,EACtE,cAAc,GAAG,KAAK;IAEtB,MAAM,QAAQ,GAAG,CAAC,gBAAgB,CAAC,CAAC;IACpC,IAAI,cAAc;QAAE,QAAQ,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACxC,IAAI,OAAO;QAAE,QAAQ,CAAC,IAAI,CAAC,YAAY,OAAO,EAAE,CAAC,CAAC;IAElD,MAAM,UAAU,GAAG,CAAC,MAAM,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;SAC7C,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;SACpC,MAAM,CAAC,OAAO,CAAC,CAAC;IACnB,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,QAAQ,CAAC,IAAI,CAAC,eAAe,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,KAAK,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7F,CAAC;IAED,2EAA2E;IAC3E,gCAAgC;IAChC,MAAM,OAAO,GAAG,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACxC,IAAI,OAAO,IAAI,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAElE,MAAM,YAAY,GAAG,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IAClD,IAAI,YAAY;QAAE,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC9C,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC"}

package/dist/runner.d.ts

@@ -0,0 +1,20 @@
+import { type AgentRunner, type Guard } from "@vendoai/core";
+import { type LanguageModel } from "ai";
+import { type CapabilityMissConfig } from "./capability-miss.js";
+/** 03-agent §2 */
+export interface RunnerConfig {
+    model: LanguageModel;
+    guard: Guard;
+    system?: {
+        product?: string;
+        instructions?: string;
+    };
+    context?: {
+        maxOutputTokens?: number;
+        toolOutputCap?: number;
+    };
+    capabilityMiss?: CapabilityMissConfig;
+}
+/** 03-agent §2 */
+export declare function createRunner(config: RunnerConfig): AgentRunner;
+//# sourceMappingURL=runner.d.ts.map

package/dist/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,WAAW,EAEhB,KAAK,KAAK,EAIX,MAAM,eAAe,CAAC;AACvB,OAAO,EAGL,KAAK,aAAa,EAGnB,MAAM,IAAI,CAAC;AAIZ,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,sBAAsB,CAAC;AAE9B,kBAAkB;AAClB,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,aAAa,CAAC;IACrB,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD,OAAO,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/D,cAAc,CAAC,EAAE,oBAAoB,CAAC;CACvC;AAeD,kBAAkB;AAClB,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,WAAW,CAsG9D"}

package/dist/runner.js

@@ -0,0 +1,114 @@
+import { VendoError, } from "@vendoai/core";
+import { generateText, stepCountIs, } from "ai";
+import { mintAuditId } from "./ids.js";
+import { assembleSystemPrompt } from "./prompt.js";
+import { buildAgentTools } from "./tools.js";
+import { createCapabilityMissDetector, scrubCapabilityMissText, } from "./capability-miss.js";
+function fallbackSummary(status, calls) {
+    if (status === "error")
+        return "The run could not be completed.";
+    if (status === "stopped")
+        return "The run stopped after reaching its tool-call budget.";
+    const pending = calls.filter((entry) => entry.outcome === "pending-approval").length;
+    if (pending > 0)
+        return `The run completed with ${pending} tool call${pending === 1 ? "" : "s"} pending approval.`;
+    return `The run completed with ${calls.length} tool call${calls.length === 1 ? "" : "s"}.`;
+}
+/** 03-agent §2 */
+export function createRunner(config) {
+    return async (task, ctx) => {
+        const cap = task.budget?.maxToolCalls ?? 20;
+        if (!Number.isInteger(cap) || cap < 1) {
+            throw new VendoError("validation", "maxToolCalls must be a positive integer");
+        }
+        const awayCtx = { ...ctx, presence: "away" };
+        const recorded = [];
+        let startedCalls = 0;
+        let refusedCall = false;
+        let report;
+        try {
+            const system = await assembleSystemPrompt(config.guard, awayCtx, config.system, config.capabilityMiss !== undefined);
+            const missDetector = config.capabilityMiss === undefined
+                ? undefined
+                : createCapabilityMissDetector({
+                    config: config.capabilityMiss,
+                    ctx: awayCtx,
+                    intent: scrubCapabilityMissText(task.prompt),
+                });
+            const tools = await buildAgentTools({
+                registry: task.tools,
+                ctx: awayCtx,
+                toolOutputCap: config.context?.toolOutputCap,
+                gate: () => {
+                    if (startedCalls >= cap) {
+                        refusedCall = true;
+                        return {
+                            status: "error",
+                            error: {
+                                code: "budget-exhausted",
+                                message: "Tool-call budget exhausted",
+                            },
+                        };
+                    }
+                    startedCalls += 1;
+                    return undefined;
+                },
+                onCall: (call) => {
+                    const entry = { call, outcome: "error" };
+                    recorded.push(entry);
+                    const finishMissCall = missDetector?.onCall(call);
+                    return (outcome) => {
+                        entry.outcome = outcome.status;
+                        finishMissCall?.(outcome);
+                    };
+                },
+            });
+            missDetector?.attach(tools);
+            const toolCallCap = ({ steps }) => steps.reduce((count, step) => count + step.toolCalls.length, 0) >= cap;
+            const result = await generateText({
+                model: config.model,
+                system,
+                prompt: task.prompt,
+                tools,
+                stopWhen: [stepCountIs(cap), toolCallCap],
+                maxOutputTokens: config.context?.maxOutputTokens,
+                abortSignal: task.abortSignal,
+            });
+            const status = refusedCall || (result.finishReason === "tool-calls" && recorded.length >= cap)
+                ? "stopped"
+                : "ok";
+            report = {
+                status,
+                summary: result.text.trim() || fallbackSummary(status, recorded),
+                toolCalls: recorded,
+            };
+        }
+        catch {
+            const stopped = task.abortSignal?.aborted === true;
+            report = {
+                status: stopped ? "stopped" : "error",
+                summary: stopped ? "The run was stopped." : fallbackSummary("error", recorded),
+                toolCalls: recorded,
+            };
+        }
+        try {
+            await config.guard.report({
+                id: mintAuditId(),
+                at: new Date().toISOString(),
+                kind: "run",
+                principal: awayCtx.principal,
+                venue: awayCtx.venue,
+                presence: awayCtx.presence,
+                appId: awayCtx.appId,
+                trigger: awayCtx.trigger,
+                outcome: undefined,
+                detail: { status: report.status, toolCallCount: report.toolCalls.length },
+            });
+        }
+        catch {
+            // A reporting failure cannot change the completed run's result.
+        }
+        return report;
+    };
+}
+//# sourceMappingURL=runner.js.map

package/dist/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,GAOX,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,YAAY,EACZ,WAAW,GAIZ,MAAM,IAAI,CAAC;AACZ,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EACL,4BAA4B,EAC5B,uBAAuB,GAExB,MAAM,sBAAsB,CAAC;AAgB9B,SAAS,eAAe,CAAC,MAAgC,EAAE,KAAqB;IAC9E,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,iCAAiC,CAAC;IACjE,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,sDAAsD,CAAC;IACxF,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,KAAK,kBAAkB,CAAC,CAAC,MAAM,CAAC;IACrF,IAAI,OAAO,GAAG,CAAC;QAAE,OAAO,0BAA0B,OAAO,aAAa,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,oBAAoB,CAAC;IACnH,OAAO,0BAA0B,KAAK,CAAC,MAAM,aAAa,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;AAC7F,CAAC;AAED,kBAAkB;AAClB,MAAM,UAAU,YAAY,CAAC,MAAoB;IAC/C,OAAO,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QACzB,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,YAAY,IAAI,EAAE,CAAC;QAC5C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,UAAU,CAAC,YAAY,EAAE,yCAAyC,CAAC,CAAC;QAChF,CAAC;QAED,MAAM,OAAO,GAAe,EAAE,GAAG,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QACzD,MAAM,QAAQ,GAAmB,EAAE,CAAC;QACpC,IAAI,YAAY,GAAG,CAAC,CAAC;QACrB,IAAI,WAAW,GAAG,KAAK,CAAC;QACxB,IAAI,MAAsB,CAAC;QAE3B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,oBAAoB,CACvC,MAAM,CAAC,KAAK,EACZ,OAAO,EACP,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,cAAc,KAAK,SAAS,CACpC,CAAC;YACF,MAAM,YAAY,GAAG,MAAM,CAAC,cAAc,KAAK,SAAS;gBACtD,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,4BAA4B,CAAC;oBAC3B,MAAM,EAAE,MAAM,CAAC,cAAc;oBAC7B,GAAG,EAAE,OAAO;oBACZ,MAAM,EAAE,uBAAuB,CAAC,IAAI,CAAC,MAAM,CAAC;iBAC7C,CAAC,CAAC;YACP,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC;gBAClC,QAAQ,EAAE,IAAI,CAAC,KAAK;gBACpB,GAAG,EAAE,OAAO;gBACZ,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,aAAa;gBAC5C,IAAI,EAAE,GAAG,EAAE;oBACT,IAAI,YAAY,IAAI,GAAG,EAAE,CAAC;wBACxB,WAAW,GAAG,IAAI,CAAC;wBACnB,OAAO;4BACL,MAAM,EAAE,OAAO;4BACf,KAAK,EAAE;gCACL,IAAI,EAAE,kBAAkB;gCACxB,OAAO,EAAE,4BAA4B;6BACtC;yBACF,CAAC;oBACJ,CAAC;oBACD,YAAY,IAAI,CAAC,CAAC;oBAClB,OAAO,SAAS,CAAC;gBACnB,CAAC;gBACD,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;oBACf,MAAM,KAAK,GAAiB,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;oBACvD,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBACrB,MAAM,cAAc,GAAG,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;oBAClD,OAAO,CAAC,OAAO,EAAE,EAAE;wBACjB,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;wBAC/B,cAAc,EAAE,CAAC,OAAO,CAAC,CAAC;oBAC5B,CAAC,CAAC;gBACJ,CAAC;aACF,CAAC,CAAC;YACH,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5B,MAAM,WAAW,GAA2B,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CACxD,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC;YACzE,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC;gBAChC,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,MAAM;gBACN,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,KAAK;gBACL,QAAQ,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,WAAW,CAAC;gBACzC,eAAe,EAAE,MAAM,CAAC,OAAO,EAAE,eAAe;gBAChD,WAAW,EAAE,IAAI,CAAC,WAAW;aAC9B,CAAC,CAAC;YACH,MAAM,MAAM,GAAG,WAAW,IAAI,CAAC,MAAM,CAAC,YAAY,KAAK,YAAY,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,CAAC;gBAC5F,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,IAAI,CAAC;YACT,MAAM,GAAG;gBACP,MAAM;gBACN,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC;gBAChE,SAAS,EAAE,QAAQ;aACpB,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,OAAO,KAAK,IAAI,CAAC;YACnD,MAAM,GAAG;gBACP,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO;gBACrC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,eAAe,CAAC,OAAO,EAAE,QAAQ,CAAC;gBAC9E,SAAS,EAAE,QAAQ;aACpB,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;gBACxB,EAAE,EAAE,WAAW,EAAE;gBACjB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBAC5B,IAAI,EAAE,KAAK;gBACX,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,OAAO,EAAE,SAAS;gBAClB,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE;aAC1E,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,gEAAgE;QAClE,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC"}

package/dist/test-helpers.d.ts

@@ -0,0 +1,55 @@
+import type { ApprovalId, ApprovalRequest, AuditEvent, Guard, Json, RunContext, ToolCall, ToolDescriptor, ToolRegistry } from "@vendoai/core";
+import type { UIMessage } from "ai";
+import { MockLanguageModelV3 } from "ai/test";
+type LanguageModelV3Prompt = Parameters<MockLanguageModelV3["doStream"]>[0]["prompt"];
+type LanguageModelV3StreamPart = Awaited<ReturnType<MockLanguageModelV3["doStream"]>>["stream"] extends ReadableStream<infer Part> ? Part : never;
+export declare const ZERO_USAGE: {
+    readonly inputTokens: {
+        readonly total: 0;
+        readonly noCache: 0;
+        readonly cacheRead: 0;
+        readonly cacheWrite: 0;
+    };
+    readonly outputTokens: {
+        readonly total: 0;
+        readonly text: 0;
+        readonly reasoning: 0;
+    };
+};
+export declare function textTurn(text: string, id?: string): LanguageModelV3StreamPart[];
+export declare function toolCallTurn(toolName: string, input: unknown, toolCallId?: string): LanguageModelV3StreamPart[];
+export type ScriptedModel = MockLanguageModelV3 & {
+    prompts: LanguageModelV3Prompt[];
+    /** The tool names offered to the model on each call, in order — i.e. the
+     *  effective loadout after `activeTools`/`prepareStep` filtering (ENG-252). */
+    toolNamesPerCall: string[][];
+};
+export declare function scriptedModel(turns: LanguageModelV3StreamPart[][]): ScriptedModel;
+export type TestGuard = Guard & {
+    events: AuditEvent[];
+    directionValues: string[];
+    /** AGENT-6: approval ids resolved through abandonApprovals, in call order. */
+    abandoned: ApprovalId[];
+    decide(approvalId: ApprovalId, approved: boolean): void;
+    pending(): ApprovalRequest[];
+};
+export declare function testGuard(policy: Record<string, "run" | "ask" | "block">, directions?: string[]): TestGuard;
+export interface TestToolImplementation {
+    descriptor: ToolDescriptor;
+    execute(args: Json, ctx: RunContext, call: ToolCall): Json | Promise<Json>;
+}
+export type BoundRegistry = ToolRegistry & {
+    invocations: Record<string, number>;
+};
+export declare function boundRegistry(implementations: Record<string, TestToolImplementation>, guard: Guard): BoundRegistry;
+export { memoryStoreAdapter as memoryStore } from "@vendoai/core/conformance";
+export declare function readSse(response: Response): Promise<{
+    rawFrames: string[];
+    parts: Array<Record<string, unknown>>;
+}>;
+export declare function ctx(overrides?: Partial<RunContext>): RunContext;
+/** A minimal single-text-part user UIMessage — the shape every suite feeds stream(). */
+export declare function userMessage(id: string, text: string): UIMessage;
+/** The first assembled UIMessage part of a given type (e.g. "data-vendo-view"). */
+export declare function partOfType(message: UIMessage, type: string): Record<string, unknown> | undefined;
+//# sourceMappingURL=test-helpers.d.ts.map

package/dist/test-helpers.d.ts.map

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