@vapi-network/mcp 0.3.0 → 0.7.0

package/dist/actions/register.d.ts

@@ -0,0 +1,342 @@
+import { type AgentProfile } from "@vapi-network/core";
+import type { ActionContext } from "./context.js";
+import type { Action } from "./define.js";
+export declare class ActionDeclinedError extends Error {
+    readonly reason: string;
+    readonly name = "ActionDeclinedError";
+    constructor(reason: string);
+}
+export declare function runAction<I, O>(action: Action<I, O>, rawInput: unknown, ctx: ActionContext): Promise<O>;
+export declare const actions: readonly [Action<{
+    query?: string | undefined;
+    kinds?: ("api" | "service_offer" | "open_request")[] | undefined;
+    network?: string | undefined;
+    limit?: number | undefined;
+    cursor?: string | undefined;
+    includeUnverified?: boolean | undefined;
+}, {
+    [x: string]: unknown;
+    protocol: "vapi.marketplace.discovery/1";
+    items: ({
+        [x: string]: unknown;
+        kind: "api";
+        provenance: "self_listed" | "partner";
+        execution: {
+            [x: string]: unknown;
+            mode: "direct" | "gateway";
+        };
+        action: {
+            [x: string]: unknown;
+            type: "invoke_api";
+            href: string;
+        };
+        verification: "none" | "requested" | "verified";
+        ref: string;
+        card: {
+            [x: string]: unknown;
+            title: string;
+            summary: string;
+            badges: {
+                [x: string]: unknown;
+                code: "partner" | "live_x402" | "payout_wallet_confirmed" | "vapi_verified" | "external_catalog" | "approved_vendor";
+                label: string;
+            }[];
+            facts: {
+                [x: string]: unknown;
+                label: string;
+                value: string;
+            }[];
+            byline?: string | undefined;
+            bylineHref?: string | undefined;
+        };
+        group?: "partner" | "vapi" | "added" | "external" | undefined;
+        fee?: {
+            [x: string]: unknown;
+            bps: number;
+            label: string;
+        } | undefined;
+        liveness?: {
+            [x: string]: unknown;
+            uptime7d: number;
+            latencyP50Ms: number | null;
+            latencyP95Ms: number | null;
+            checks7d: number;
+        } | undefined;
+        conformance?: {
+            [x: string]: unknown;
+            declaredVersion: 1 | 2 | null;
+            versionConformant: boolean;
+            offerTransport: "body" | "header" | "both";
+            issues: string[];
+        } | undefined;
+        identity?: {
+            [x: string]: unknown;
+            erc8004Id: string;
+            reputation?: {
+                [x: string]: unknown;
+                score: number;
+                count: number;
+            } | undefined;
+        } | undefined;
+    } | {
+        [x: string]: unknown;
+        kind: "api";
+        provenance: "indexed";
+        execution: {
+            [x: string]: unknown;
+            mode: "direct";
+            url: string;
+            method: "HEAD" | "POST" | "GET" | "PUT" | "PATCH" | "DELETE" | null;
+            network: string;
+        };
+        action: {
+            [x: string]: unknown;
+            type: "invoke_api";
+            href: string;
+        };
+        verification: "none" | "requested" | "verified";
+        ref: string;
+        card: {
+            [x: string]: unknown;
+            title: string;
+            summary: string;
+            badges: {
+                [x: string]: unknown;
+                code: "partner" | "live_x402" | "payout_wallet_confirmed" | "vapi_verified" | "external_catalog" | "approved_vendor";
+                label: string;
+            }[];
+            facts: {
+                [x: string]: unknown;
+                label: string;
+                value: string;
+            }[];
+            byline?: string | undefined;
+            bylineHref?: string | undefined;
+        };
+        group?: "partner" | "vapi" | "added" | "external" | undefined;
+        fee?: {
+            [x: string]: unknown;
+            bps: number;
+            label: string;
+        } | undefined;
+        liveness?: {
+            [x: string]: unknown;
+            uptime7d: number;
+            latencyP50Ms: number | null;
+            latencyP95Ms: number | null;
+            checks7d: number;
+        } | undefined;
+        conformance?: {
+            [x: string]: unknown;
+            declaredVersion: 1 | 2 | null;
+            versionConformant: boolean;
+            offerTransport: "body" | "header" | "both";
+            issues: string[];
+        } | undefined;
+        identity?: {
+            [x: string]: unknown;
+            erc8004Id: string;
+            reputation?: {
+                [x: string]: unknown;
+                score: number;
+                count: number;
+            } | undefined;
+        } | undefined;
+    } | {
+        [x: string]: unknown;
+        kind: "service_offer";
+        action: {
+            [x: string]: unknown;
+            type: "start_engagement";
+            href: string;
+        };
+        verification: "none" | "requested" | "verified";
+        ref: string;
+        card: {
+            [x: string]: unknown;
+            title: string;
+            summary: string;
+            badges: {
+                [x: string]: unknown;
+                code: "partner" | "live_x402" | "payout_wallet_confirmed" | "vapi_verified" | "external_catalog" | "approved_vendor";
+                label: string;
+            }[];
+            facts: {
+                [x: string]: unknown;
+                label: string;
+                value: string;
+            }[];
+            byline?: string | undefined;
+            bylineHref?: string | undefined;
+        };
+        group?: "partner" | "vapi" | "added" | "external" | undefined;
+        fee?: {
+            [x: string]: unknown;
+            bps: number;
+            label: string;
+        } | undefined;
+        liveness?: {
+            [x: string]: unknown;
+            uptime7d: number;
+            latencyP50Ms: number | null;
+            latencyP95Ms: number | null;
+            checks7d: number;
+        } | undefined;
+        conformance?: {
+            [x: string]: unknown;
+            declaredVersion: 1 | 2 | null;
+            versionConformant: boolean;
+            offerTransport: "body" | "header" | "both";
+            issues: string[];
+        } | undefined;
+        identity?: {
+            [x: string]: unknown;
+            erc8004Id: string;
+            reputation?: {
+                [x: string]: unknown;
+                score: number;
+                count: number;
+            } | undefined;
+        } | undefined;
+    } | {
+        [x: string]: unknown;
+        kind: "open_request";
+        action: {
+            [x: string]: unknown;
+            type: "propose_to_request";
+            href: string;
+        };
+        verification: "none" | "requested" | "verified";
+        ref: string;
+        card: {
+            [x: string]: unknown;
+            title: string;
+            summary: string;
+            badges: {
+                [x: string]: unknown;
+                code: "partner" | "live_x402" | "payout_wallet_confirmed" | "vapi_verified" | "external_catalog" | "approved_vendor";
+                label: string;
+            }[];
+            facts: {
+                [x: string]: unknown;
+                label: string;
+                value: string;
+            }[];
+            byline?: string | undefined;
+            bylineHref?: string | undefined;
+        };
+        group?: "partner" | "vapi" | "added" | "external" | undefined;
+        fee?: {
+            [x: string]: unknown;
+            bps: number;
+            label: string;
+        } | undefined;
+        liveness?: {
+            [x: string]: unknown;
+            uptime7d: number;
+            latencyP50Ms: number | null;
+            latencyP95Ms: number | null;
+            checks7d: number;
+        } | undefined;
+        conformance?: {
+            [x: string]: unknown;
+            declaredVersion: 1 | 2 | null;
+            versionConformant: boolean;
+            offerTransport: "body" | "header" | "both";
+            issues: string[];
+        } | undefined;
+        identity?: {
+            [x: string]: unknown;
+            erc8004Id: string;
+            reputation?: {
+                [x: string]: unknown;
+                score: number;
+                count: number;
+            } | undefined;
+        } | undefined;
+    })[];
+    nextCursor: string | null;
+    unavailableKinds: ("api" | "service_offer" | "open_request")[];
+    rankingVersion: "marketplace-ranking-v1";
+}>, Action<{
+    id: string;
+    endpoint?: string | undefined;
+}, {
+    name: string;
+    method: string | null;
+    url: string;
+    price: string;
+    description: string;
+    verification: "none" | "requested" | "verified";
+    payment: {
+        scheme: "exact";
+        network: string;
+        asset: string;
+        payTo: string;
+        checkedAt: string;
+    } | null;
+    operationId?: string | undefined;
+    requestContentType?: string | undefined;
+    requestSchema?: unknown;
+    responseContentType?: string | undefined;
+    network?: string | undefined;
+    group?: "partner" | "vapi" | "added" | "external" | undefined;
+    fee?: {
+        [x: string]: unknown;
+        bps: number;
+        label: string;
+    } | undefined;
+    liveness?: {
+        [x: string]: unknown;
+        uptime7d: number;
+        latencyP50Ms: number | null;
+        latencyP95Ms: number | null;
+        checks7d: number;
+    } | undefined;
+    conformance?: {
+        [x: string]: unknown;
+        declaredVersion: 1 | 2 | null;
+        versionConformant: boolean;
+        offerTransport: "body" | "header" | "both";
+        issues: string[];
+    } | undefined;
+    identity?: {
+        [x: string]: unknown;
+        erc8004Id: string;
+        reputation?: {
+            [x: string]: unknown;
+            score: number;
+            count: number;
+        } | undefined;
+    } | undefined;
+}>, Action<{
+    id?: string | undefined;
+    url?: string | undefined;
+    method?: string | undefined;
+    endpoint?: string | undefined;
+    body?: unknown;
+    contentType?: string | undefined;
+    network?: string | undefined;
+    expectedPayTo?: string | undefined;
+    maxPriceUsd?: string | number | undefined;
+    wallet?: string | undefined;
+}, {
+    wallet: string;
+} & import("../server.js").CallToolResult>];
+export declare const agentToolNames: AgentProfile["tools"];
+export declare const registeredAgentProfileSchema: import("zod").ZodObject<{
+    tools: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodEnum<{
+        [x: string]: string;
+    }>>>;
+    version: import("zod").ZodLiteral<1>;
+    name: import("zod").ZodString;
+    wallet: import("zod").ZodString;
+    model: import("zod").ZodString;
+    instructions: import("zod").ZodString;
+    verifiedOnly: import("zod").ZodDefault<import("zod").ZodBoolean>;
+    approveAboveUsd: import("zod").ZodDefault<import("zod").ZodNumber>;
+    maxSteps: import("zod").ZodDefault<import("zod").ZodNumber>;
+    paused: import("zod").ZodDefault<import("zod").ZodBoolean>;
+    createdAt: import("zod").ZodString;
+}, import("zod/v4/core").$strip>;
+export declare function findAction(name: string): (typeof actions)[number] | undefined;

package/dist/agent/deps.d.ts

@@ -0,0 +1,18 @@
+import { type AgentProfile, type CeilingSweepHook, 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;
+    ceilingSweep?: CeilingSweepHook | false;
+}): 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,108 @@
+import { type AgentProfile, type ChatRequest, type ChatResult, type VapiConfig } from "@vapi-network/core";
+import { type ActionRunState } from "../actions/context.js";
+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;
+    forRun?: (run: ActionRunState) => RunAgentDeps;
+};
+export type RunAgentResult = {
+    answer: string | null;
+    stoppedBecause: AgentEvent & {
+        type: "stopped";
+    };
+    paidUsd: number;
+    steps: number;
+};
+export declare function loopToolsForProfile(profile: {
+    tools: readonly string[];
+}): ({
+    readonly type: "function";
+    readonly function: {
+        readonly name: "finish";
+        readonly description: "Finish the run with the final answer.";
+        readonly strict: true;
+        readonly parameters: {
+            readonly type: "object";
+            readonly properties: {
+                readonly answer: {
+                    readonly type: "string";
+                };
+            };
+            readonly required: readonly ["answer"];
+            readonly additionalProperties: false;
+        };
+    };
+} | {
+    profileName: string;
+    type: "function";
+    function: {
+        name: string;
+        description: string;
+        strict: true;
+        parameters: {
+            type: "object";
+            properties: Record<string, unknown>;
+            required: string[];
+            additionalProperties: false;
+        };
+    };
+})[];
+export declare function runAgent(task: string, deps: RunAgentDeps): Promise<RunAgentResult>;

package/dist/index.d.ts

@@ -4,3 +4,11 @@ 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 { loopToolsForProfile, runAgent, type AgentEvent, type RunAgentDeps, type RunAgentResult, } from "./agent/run.js";
+export { callInspect, callInspectInputSchema, callPay, callPayInputSchema, callSearch, callSearchInputSchema, callToolResultSchema, createCallPort, inspectToolResultSchema, MAX_CACHED_MARKETPLACE_REFS, walletArgument, type CreateCallPortOptions, type PaymentResolution, } from "./actions/call.js";
+export { createRunState, inspectionCacheKey, type ActionContext, type ActionRunState, type ActionSurface, type CallPort, } from "./actions/context.js";
+export { defineAction, toLoopName, type Action, type ActionGrant, type ActionMoney, } from "./actions/define.js";
+export { checkAction, exactUsdcPrice, type PolicyDecision } from "./actions/policy.js";
+export { ActionDeclinedError, actions, agentToolNames, findAction, registeredAgentProfileSchema, runAction, } from "./actions/register.js";