@vapi-network/mcp 0.3.0 → 0.5.0

package/dist/agent/deps.d.ts

@@ -0,0 +1,17 @@
+import { type AgentProfile, type ChatRequest, type ChatResult, type SpendCaps, type VapiConfig, type VapiPaymentAccount, type WalletName } from "@vapi-network/core";
+import type { AgentEvent, RunAgentDeps } from "./run.js";
+export declare function createAgentRunDeps(input: {
+    profile: AgentProfile;
+    config: VapiConfig;
+    home: string;
+    account: VapiPaymentAccount;
+    wallet: WalletName;
+    spendCaps: SpendCaps;
+    chat: (req: ChatRequest) => Promise<ChatResult>;
+    approve: RunAgentDeps["approve"];
+    onEvent?: (event: AgentEvent) => void;
+    tty?: boolean;
+    fetchImpl?: typeof fetch;
+    ledgerPath?: string;
+    receiptsPath?: string;
+}): RunAgentDeps;

package/dist/agent/guards.d.ts

@@ -0,0 +1,21 @@
+export declare const UNTRUSTED_NOTICE: string;
+/** Wraps tool output so the model can tell data from instructions. */
+export declare function wrapUntrusted(tool: string, value: unknown): string;
+export type PayDecision = {
+    action: "pay";
+} | {
+    action: "ask";
+    reason: string;
+} | {
+    action: "refuse";
+    reason: string;
+};
+export declare function decidePayment(input: {
+    ref: string;
+    priceUsd: number | null;
+    verification: string;
+    seenRefs: ReadonlySet<string>;
+    verifiedOnly: boolean;
+    approveAboveUsd: number;
+    maxPerCallUsd: number;
+}): PayDecision;

package/dist/agent/run.d.ts

@@ -0,0 +1,72 @@
+import { type AgentProfile, type ChatRequest, type ChatResult, type VapiConfig } from "@vapi-network/core";
+import type { InspectToolResult } from "../tools/inspect.js";
+export type AgentEvent = {
+    type: "step";
+    n: number;
+} | {
+    type: "tool";
+    name: string;
+    summary: string;
+} | {
+    type: "paid";
+    ref: string;
+    amountUsd: number;
+    network: string;
+} | {
+    type: "declined";
+    ref: string;
+    reason: string;
+} | {
+    type: "stopped";
+    reason: "finished" | "max_steps" | "router_budget" | "paused" | "error";
+    detail?: string;
+};
+export type RunAgentDeps = {
+    profile: AgentProfile;
+    config: VapiConfig;
+    home: string;
+    chat: (req: ChatRequest) => Promise<ChatResult>;
+    search: (q: {
+        query: string;
+        network?: string;
+        includeUnverified: boolean;
+    }) => Promise<Array<{
+        ref: string;
+        name: string;
+        priceUsd: number | null;
+        verification: string;
+        description?: string;
+    }>>;
+    inspect: (ref: string) => Promise<InspectToolResult>;
+    pay: (input: {
+        ref: string;
+        body?: unknown;
+        maxPriceUsd: number;
+    }) => Promise<{
+        ok: boolean;
+        status: number;
+        body: unknown;
+        amountUsd: number;
+        network: string;
+    }>;
+    caps: {
+        perCallUsd: number;
+    };
+    approve: (question: {
+        ref: string;
+        priceUsd: number;
+        reason: string;
+    }) => Promise<boolean>;
+    onEvent?: (event: AgentEvent) => void;
+    tty?: boolean;
+    now?: () => Date;
+};
+export type RunAgentResult = {
+    answer: string | null;
+    stoppedBecause: AgentEvent & {
+        type: "stopped";
+    };
+    paidUsd: number;
+    steps: number;
+};
+export declare function runAgent(task: string, deps: RunAgentDeps): Promise<RunAgentResult>;

package/dist/index.d.ts

@@ -4,3 +4,6 @@ export { resolveServiceEndpoint, resolveServiceListing, searchMarketplace, type
 export { getWallet, type WalletAddresses, type WalletBalance } from "./tools/wallet.js";
 export { WalletSession, type SessionWallet, type SessionWalletInfo, type WalletSessionOptions, } from "./wallet-session.js";
 export { buildSIWxProof, parseSIWxResponse } from "./siwx.js";
+export { UNTRUSTED_NOTICE, decidePayment, wrapUntrusted, type PayDecision, } from "./agent/guards.js";
+export { createAgentRunDeps } from "./agent/deps.js";
+export { runAgent, type AgentEvent, type RunAgentDeps, type RunAgentResult } from "./agent/run.js";