@vendoai/agent 0.4.0

package/dist/tool-search.d.ts

@@ -0,0 +1,72 @@
+import { type RiskLabel, type RunContext, type ToolDescriptor } from "@vendoai/core";
+import { type ToolSet } from "ai";
+/** The meta-tool the agent uses to discover and load host tools mid-run. */
+export declare const VENDO_TOOLS_SEARCH_TOOL_NAME = "vendo_tools_search";
+/** Default bound on the uncurated initial loadout. A large host (dub ≈ 617
+ * tools, papermark ≈ 388) would otherwise flood the model's context; the rest
+ * stay reachable through {@link VENDO_TOOLS_SEARCH_TOOL_NAME}. */
+export declare const DEFAULT_MAX_INITIAL_TOOLS = 128;
+/** A hit from the injected search seam — the structural twin of actions'
+ * `ToolSearchMatch` (the agent block depends on core only, so it cannot import
+ * the actions type). */
+export interface ToolSearchMatch {
+    name: string;
+    description: string;
+    risk: RiskLabel;
+    score: number;
+}
+/** Ranks the merged, enabled, guard-bound tool surface against a free-text
+ * intent. The umbrella wires this to `ActionsRegistry.search`. */
+export type ToolSearchFn = (query: string, options?: {
+    limit?: number;
+}) => Promise<ToolSearchMatch[]>;
+export interface ToolSearchConfig {
+    /** The registry query seam (umbrella wires it to the guard-bound registry). */
+    search: ToolSearchFn;
+    /** Uncurated loadout cap. Defaults to {@link DEFAULT_MAX_INITIAL_TOOLS}. */
+    maxInitialTools?: number;
+    /** Explicit curated initial loadout by tool name. When set, exactly these
+     *  (that exist and are enabled) start active; the cap is not applied. */
+    loadout?: string[];
+    /** Per-turn initial-loadout seed (connection-scoped tool loading, spec
+     *  2026-07-20): typically the connected toolkits' tools — the umbrella
+     *  wires this to registry.loadoutSeed(connectedToolkits). Runs BEFORE the
+     *  toolset is built so freshly expanded tools are included. A failure
+     *  degrades to the risk/name fallback, never the turn. */
+    seed?: (ctx: RunContext) => Promise<string[] | undefined>;
+}
+/**
+ * The INITIAL enabled set (loadout policy, ENG-252 spec §4):
+ *  - Explicit `loadout` present → exactly those names that exist, deduped
+ *    (curation, e.g. derived from overrides).
+ *  - Otherwise, if the enabled host surface fits the cap → the whole surface.
+ *  - Otherwise (uncurated + large) → a deterministic bounded default: safest
+ *    risk first (read < write < destructive), then name, capped. The remainder
+ *    stays discoverable via search.
+ * Vendo's own `vendo_*` tools are always active and excluded from the cap.
+ */
+export declare function computeInitialLoadout(descriptors: readonly ToolDescriptor[], config: ToolSearchConfig, seedNames?: readonly string[]): Set<string>;
+export interface ToolSearchSession {
+    /** Names the model may call this step: initial loadout ∪ everything loaded so
+     *  far ∪ the always-active `vendo_*` tools (which include this meta-tool). */
+    activeToolNames(): string[];
+    /** Register `vendo_tools_search` into the run's toolset. */
+    attach(tools: ToolSet): void;
+}
+export interface ToolSearchSessionOptions {
+    config: ToolSearchConfig;
+    /** The full built toolset's descriptors (names available to load). */
+    descriptors: readonly ToolDescriptor[];
+    /** Per-run loaded set — persists across turns within a thread. Mutated here. */
+    loaded: Set<string>;
+    /** Per-turn seed for the initial loadout (see ToolSearchConfig.seed). */
+    seedNames?: readonly string[];
+    /** Full descriptors for names search returned that are NOT yet in the built
+     * toolset — they were lazily expanded during the search itself. */
+    resolve?: (names: string[]) => Promise<ToolDescriptor[]>;
+    /** Add a freshly resolved descriptor into the LIVE toolset. prepareStep
+     * re-reads activeToolNames() each step, so it's callable next step. */
+    materialize?: (descriptor: ToolDescriptor) => void;
+}
+export declare function createToolSearchSession(options: ToolSearchSessionOptions): ToolSearchSession;
+//# sourceMappingURL=tool-search.d.ts.map

package/dist/tool-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-search.d.ts","sourceRoot":"","sources":["../src/tool-search.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,cAAc,EAEpB,MAAM,eAAe,CAAC;AACvB,OAAO,EAA2B,KAAK,OAAO,EAAE,MAAM,IAAI,CAAC;AAE3D,4EAA4E;AAC5E,eAAO,MAAM,4BAA4B,uBAAuB,CAAC;AAEjE;;kEAEkE;AAClE,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAI7C;;wBAEwB;AACxB,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;kEACkE;AAClE,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;AAEvG,MAAM,WAAW,gBAAgB;IAC/B,+EAA+E;IAC/E,MAAM,EAAE,YAAY,CAAC;IACrB,4EAA4E;IAC5E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;6EACyE;IACzE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB;;;;8DAI0D;IAC1D,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;CAC3D;AAoBD;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,SAAS,cAAc,EAAE,EACtC,MAAM,EAAE,gBAAgB,EACxB,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,GAC5B,GAAG,CAAC,MAAM,CAAC,CAwBb;AAED,MAAM,WAAW,iBAAiB;IAChC;kFAC8E;IAC9E,eAAe,IAAI,MAAM,EAAE,CAAC;IAC5B,4DAA4D;IAC5D,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,gBAAgB,CAAC;IACzB,sEAAsE;IACtE,WAAW,EAAE,SAAS,cAAc,EAAE,CAAC;IACvC,gFAAgF;IAChF,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACpB,yEAAyE;IACzE,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B;uEACmE;IACnE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IACzD;2EACuE;IACvE,WAAW,CAAC,EAAE,CAAC,UAAU,EAAE,cAAc,KAAK,IAAI,CAAC;CACpD;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,wBAAwB,GAAG,iBAAiB,CAwE5F"}

package/dist/tool-search.js

@@ -0,0 +1,135 @@
+import { VendoError, } from "@vendoai/core";
+import { dynamicTool, jsonSchema } from "ai";
+/** The meta-tool the agent uses to discover and load host tools mid-run. */
+export const VENDO_TOOLS_SEARCH_TOOL_NAME = "vendo_tools_search";
+/** Default bound on the uncurated initial loadout. A large host (dub ≈ 617
+ * tools, papermark ≈ 388) would otherwise flood the model's context; the rest
+ * stay reachable through {@link VENDO_TOOLS_SEARCH_TOOL_NAME}. */
+export const DEFAULT_MAX_INITIAL_TOOLS = 128;
+const RISK_ORDER = { read: 0, write: 1, destructive: 2 };
+const SEARCH_INPUT_SCHEMA = {
+    type: "object",
+    properties: {
+        query: { type: "string", minLength: 1, maxLength: 200 },
+        limit: { type: "integer", minimum: 1, maximum: 25 },
+    },
+    required: ["query"],
+    additionalProperties: false,
+};
+/** Vendo's own always-available tools (apps, connect, the meta-tools) are never
+ * loadout-gated: they are not host API tools that explode in number, and gating
+ * them out would break the product surface. Everything `vendo_`-prefixed stays
+ * active; host tools are what the loadout bounds. */
+function isAlwaysActive(name) {
+    return name.startsWith("vendo_");
+}
+/**
+ * The INITIAL enabled set (loadout policy, ENG-252 spec §4):
+ *  - Explicit `loadout` present → exactly those names that exist, deduped
+ *    (curation, e.g. derived from overrides).
+ *  - Otherwise, if the enabled host surface fits the cap → the whole surface.
+ *  - Otherwise (uncurated + large) → a deterministic bounded default: safest
+ *    risk first (read < write < destructive), then name, capped. The remainder
+ *    stays discoverable via search.
+ * Vendo's own `vendo_*` tools are always active and excluded from the cap.
+ */
+export function computeInitialLoadout(descriptors, config, seedNames) {
+    const available = new Set(descriptors.map((descriptor) => descriptor.name));
+    const alwaysActive = descriptors.filter((descriptor) => isAlwaysActive(descriptor.name)).map((d) => d.name);
+    const hostTools = descriptors.filter((descriptor) => !isAlwaysActive(descriptor.name));
+    if (config.loadout !== undefined) {
+        return new Set([...alwaysActive, ...config.loadout.filter((name) => available.has(name))]);
+    }
+    const cap = Math.max(Math.trunc(config.maxInitialTools ?? DEFAULT_MAX_INITIAL_TOOLS), 1);
+    // Connection-scoped seed: exactly the relevant tools (host tools + the
+    // principal's connected toolkits), capped — never an alphabetical slice.
+    if (seedNames !== undefined) {
+        const seeded = seedNames.filter((name) => available.has(name) && !isAlwaysActive(name)).slice(0, cap);
+        return new Set([...alwaysActive, ...seeded]);
+    }
+    if (hostTools.length <= cap)
+        return new Set([...alwaysActive, ...hostTools.map((d) => d.name)]);
+    const bounded = [...hostTools]
+        .sort((a, b) => (RISK_ORDER[a.risk] - RISK_ORDER[b.risk]) || (a.name < b.name ? -1 : a.name > b.name ? 1 : 0))
+        .slice(0, cap)
+        .map((descriptor) => descriptor.name);
+    return new Set([...alwaysActive, ...bounded]);
+}
+export function createToolSearchSession(options) {
+    const available = new Set(options.descriptors.map((descriptor) => descriptor.name));
+    const initial = computeInitialLoadout(options.descriptors, options.config, options.seedNames);
+    // Captured at attach: the full run toolset. Every Vendo-owned `vendo_*` tool
+    // in it stays active regardless of loadout — including the OTHER meta-tools
+    // (notably `vendo_report_capability_miss`) that are attached after the host
+    // descriptors and so are NOT in `options.descriptors`. Gating them out would
+    // silently disable miss capture whenever tool search is on.
+    let attached;
+    return {
+        activeToolNames() {
+            const active = new Set(initial);
+            active.add(VENDO_TOOLS_SEARCH_TOOL_NAME);
+            for (const name of Object.keys(attached ?? {}))
+                if (isAlwaysActive(name))
+                    active.add(name);
+            for (const name of options.loaded)
+                if (available.has(name))
+                    active.add(name);
+            return [...active];
+        },
+        attach(tools) {
+            attached = tools;
+            if (tools[VENDO_TOOLS_SEARCH_TOOL_NAME] !== undefined) {
+                throw new VendoError("conflict", `Reserved internal tool name: ${VENDO_TOOLS_SEARCH_TOOL_NAME}`);
+            }
+            tools[VENDO_TOOLS_SEARCH_TOOL_NAME] = dynamicTool({
+                description: "Search ALL of this product's tools and connected-service tools by intent, and LOAD the matches so you can call them this run. "
+                    + "Results may include tools for services the user has NOT connected yet — calling one is safe and correct: the user is prompted to connect in-line. "
+                    + "Use this whenever no currently-available tool fits the ask.",
+                inputSchema: jsonSchema(SEARCH_INPUT_SCHEMA),
+                execute: async (input) => {
+                    const parsed = input;
+                    const query = typeof parsed?.query === "string" ? parsed.query : "";
+                    if (query.trim().length === 0) {
+                        return { status: "error", error: { code: "validation", message: "query must be a non-empty string" } };
+                    }
+                    const limit = typeof parsed?.limit === "number" ? parsed.limit : undefined;
+                    let matches;
+                    try {
+                        matches = await options.config.search(query, limit === undefined ? undefined : { limit });
+                    }
+                    catch {
+                        return { status: "error", error: { code: "execution", message: "Tool search failed." } };
+                    }
+                    // Names outside the built toolset were lazily expanded during this
+                    // very search — resolve their full descriptors and materialize them
+                    // into the LIVE toolset so they are callable next step.
+                    const missing = matches.filter((match) => !available.has(match.name)).map((match) => match.name);
+                    if (missing.length > 0 && options.resolve !== undefined && options.materialize !== undefined) {
+                        try {
+                            for (const descriptor of await options.resolve(missing)) {
+                                options.materialize(descriptor);
+                                available.add(descriptor.name);
+                            }
+                        }
+                        catch {
+                            // Unresolved names simply stay unloadable below.
+                        }
+                    }
+                    // Only load names that actually exist in this run's guard-bound toolset
+                    // — a stale or drifting search seam can never conjure an unbound tool.
+                    const loadable = matches.filter((match) => available.has(match.name));
+                    for (const match of loadable)
+                        options.loaded.add(match.name);
+                    return {
+                        status: "ok",
+                        output: {
+                            loaded: loadable.map((match) => match.name),
+                            tools: loadable.map((match) => ({ name: match.name, description: match.description, risk: match.risk })),
+                        },
+                    };
+                },
+            });
+        },
+    };
+}
+//# sourceMappingURL=tool-search.js.map

package/dist/tool-search.js.map

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

package/dist/tools.d.ts

@@ -0,0 +1,22 @@
+import { type ApprovalId, type Guard, type RiskLabel, type RunContext, type ToolCall, type ToolDescriptor, type ToolOutcome, type ToolRegistry, type VendoApprovalPart } from "@vendoai/core";
+import { type ToolSet, type UIMessage, type UIMessageStreamWriter } from "ai";
+/** 03-agent §2 */
+export interface ToolBridgeOptions {
+    registry: ToolRegistry;
+    ctx: RunContext;
+    guard?: Guard;
+    writer?: UIMessageStreamWriter<UIMessage>;
+    toolOutputCap?: number;
+    gate?: (call: ToolCall) => ToolOutcome | undefined;
+    onCall?: (call: ToolCall) => (outcome: ToolOutcome) => void;
+}
+/** The flat §16 approval part shared by every consent surface (native
+ *  needsApproval, pending-approval outcomes). */
+export declare function approvalPart(toolCallId: string, risk: RiskLabel, approvalId: ApprovalId, invalidatedGrant?: VendoApprovalPart["invalidatedGrant"]): VendoApprovalPart;
+/** 03-agent §2 */
+export declare function buildAgentTools(options: ToolBridgeOptions): Promise<ToolSet>;
+/** Build ONE guard-bound agent tool and insert it into `tools`. Exported so a
+ * tool lazily expanded mid-turn (vendo_tools_search, spec 2026-07-20)
+ * materializes with the exact wrapper the boot-time toolset uses. */
+export declare function addAgentTool(tools: ToolSet, descriptor: ToolDescriptor, options: ToolBridgeOptions): void;
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,UAAU,EACf,KAAK,KAAK,EACV,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EAIvB,MAAM,eAAe,CAAC;AACvB,OAAO,EAGL,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,qBAAqB,EAC3B,MAAM,IAAI,CAAC;AAIZ,kBAAkB;AAClB,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,YAAY,CAAC;IACvB,GAAG,EAAE,UAAU,CAAC;IAChB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,MAAM,CAAC,EAAE,qBAAqB,CAAC,SAAS,CAAC,CAAC;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,WAAW,GAAG,SAAS,CAAC;IACnD,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;CAC7D;AAcD;iDACiD;AACjD,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,SAAS,EACf,UAAU,EAAE,UAAU,EACtB,gBAAgB,CAAC,EAAE,iBAAiB,CAAC,kBAAkB,CAAC,GACvD,iBAAiB,CAQnB;AA+BD,kBAAkB;AAClB,wBAAsB,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAKlF;AAED;;qEAEqE;AACrE,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,iBAAiB,GAAG,IAAI,CA6FzG"}

package/dist/tools.js

@@ -0,0 +1,151 @@
+import { VENDO_APPS_CREATE_TOOL, VENDO_APPS_TOOL_PREFIX, VENDO_VIEW_STREAM, toVendoWirePart, vendoViewStreamId, vendoViewPartSchema, } from "@vendoai/core";
+import { dynamicTool, jsonSchema, } from "ai";
+function writePart(writer, part, id) {
+    if (!writer)
+        return;
+    // The ai-SDK UI message stream requires custom data chunks to carry their
+    // payload under `data` ({ type: "data-*", data }); the stock client's chunk
+    // schema hard-rejects the flat form. Core owns that envelope (AGENT-10).
+    writer.write(toVendoWirePart(part, id));
+}
+/** The flat §16 approval part shared by every consent surface (native
+ *  needsApproval, pending-approval outcomes). */
+export function approvalPart(toolCallId, risk, approvalId, invalidatedGrant) {
+    return {
+        type: "data-vendo-approval",
+        toolCallId,
+        risk,
+        approvalId,
+        ...(invalidatedGrant === undefined ? {} : { invalidatedGrant }),
+    };
+}
+function executionError() {
+    return {
+        status: "error",
+        error: {
+            code: "execution",
+            message: "Tool execution failed.",
+        },
+    };
+}
+function capOutcome(outcome, cap) {
+    if (outcome.status !== "ok" || cap === undefined)
+        return outcome;
+    let serialized;
+    try {
+        serialized = JSON.stringify(outcome.output);
+    }
+    catch {
+        return executionError();
+    }
+    if (serialized === undefined || serialized.length <= cap)
+        return outcome;
+    return {
+        status: "ok",
+        output: {
+            truncated: true,
+            chars: serialized.length,
+            preview: serialized.slice(0, cap),
+        },
+    };
+}
+/** 03-agent §2 */
+export async function buildAgentTools(options) {
+    const descriptors = await options.registry.descriptors();
+    const tools = {};
+    for (const descriptor of descriptors)
+        addAgentTool(tools, descriptor, options);
+    return tools;
+}
+/** Build ONE guard-bound agent tool and insert it into `tools`. Exported so a
+ * tool lazily expanded mid-turn (vendo_tools_search, spec 2026-07-20)
+ * materializes with the exact wrapper the boot-time toolset uses. */
+export function addAgentTool(tools, descriptor, options) {
+    {
+        const execute = async (input, { toolCallId }) => {
+            const call = { id: toolCallId, tool: descriptor.name, args: input };
+            if (descriptor.name === VENDO_APPS_CREATE_TOOL && options.writer !== undefined) {
+                Object.defineProperty(call, VENDO_VIEW_STREAM, {
+                    value: (update) => {
+                        const view = vendoViewPartSchema.safeParse(update.part);
+                        if (view.success)
+                            writePart(options.writer, view.data, update.id);
+                    },
+                });
+            }
+            const finishCall = options.onCall?.(call);
+            let outcome = options.gate?.(call);
+            if (outcome === undefined) {
+                try {
+                    outcome = await options.registry.execute(call, options.ctx);
+                }
+                catch {
+                    outcome = executionError();
+                }
+            }
+            // A view part is emitted ONLY from the app runtime's own view-producing
+            // tools returning a tree OpenSurface (06 §1) — never by duck-typing an
+            // arbitrary host tool's output, which could otherwise smuggle an unrelated
+            // result onto the app-view channel and mis-route its actions (01 §16).
+            const producesView = descriptor.name.startsWith(VENDO_APPS_TOOL_PREFIX);
+            if (outcome.status === "ok" && producesView) {
+                const surface = typeof outcome.output === "object" && outcome.output !== null
+                    ? outcome.output
+                    : undefined;
+                const args = typeof input === "object" && input !== null
+                    ? input
+                    : undefined;
+                const candidate = surface?.kind === "tree" && surface.payload !== undefined
+                    ? {
+                        type: "data-vendo-view",
+                        // OpenSurface carries no app id (06 §1); the open call's own appId
+                        // argument identifies the app this payload belongs to.
+                        appId: surface.appId ?? args?.appId,
+                        payload: surface.payload,
+                    }
+                    : null;
+                const view = vendoViewPartSchema.safeParse(candidate);
+                if (view.success)
+                    writePart(options.writer, view.data, vendoViewStreamId(view.data.appId));
+            }
+            else if (outcome.status === "pending-approval") {
+                writePart(options.writer, approvalPart(toolCallId, descriptor.risk, outcome.approvalId));
+            }
+            else if (outcome.status === "connect-required") {
+                // The inline connect card (04-actions §3): emitted beside the native
+                // tool part exactly like the approval part, keyed by toolCallId.
+                writePart(options.writer, {
+                    type: "data-vendo-connect",
+                    toolCallId,
+                    connector: outcome.connect.connector,
+                    toolkit: outcome.connect.toolkit,
+                    message: outcome.connect.message,
+                });
+            }
+            const modelOutcome = capOutcome(outcome, options.toolOutputCap);
+            finishCall?.(modelOutcome);
+            return modelOutcome;
+        };
+        const needsApproval = options.guard
+            ? async (input, { toolCallId }) => {
+                try {
+                    const decision = await options.guard.check({ id: toolCallId, tool: descriptor.name, args: input }, descriptor, options.ctx);
+                    if (decision.action !== "ask")
+                        return false;
+                    writePart(options.writer, approvalPart(toolCallId, descriptor.risk, decision.approval.id, decision.approval.invalidatedGrant));
+                    return true;
+                }
+                catch {
+                    return true;
+                }
+            }
+            : undefined;
+        tools[descriptor.name] = dynamicTool({
+            description: descriptor.description,
+            inputSchema: jsonSchema(descriptor.inputSchema),
+            execute,
+            ...(needsApproval ? { needsApproval } : {}),
+        });
+    }
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@vendoai/agent",
+  "version": "0.4.0",
+  "description": "The Vendo agent loop: streaming, tool-calling, context engineering — BYO ai-SDK LanguageModel, guard-bound tools, thread persistence via the store seam.",
+  "keywords": [
+    "ai",
+    "agent",
+    "vendo",
+    "llm",
+    "streaming"
+  ],
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/runvendo/vendo.git",
+    "directory": "packages/agent"
+  },
+  "homepage": "https://vendo.run",
+  "bugs": "https://github.com/runvendo/vendo/issues",
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "zod": "^3.25.76",
+    "@vendoai/core": "0.4.0"
+  },
+  "peerDependencies": {
+    "ai": ">=6.0.0 <7"
+  },
+  "devDependencies": {
+    "@ai-sdk/anthropic": "3.0.12",
+    "@ai-sdk/openai": "3.0.9",
+    "@ai-sdk/openai-compatible": "2.0.9",
+    "@types/node": "^22.0.0",
+    "ai": "6.0.28",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "conformance": "vitest run src/conformance.test.ts src/wire.test.ts src/stream-client.test.ts src/provider-wire.conformance.test.ts",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test:coverage": "vitest run --coverage"
+  }
+}