@vapi-network/mcp 0.5.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

@@ -1,4 +1,4 @@
-import { type AgentProfile, type ChatRequest, type ChatResult, type SpendCaps, type VapiConfig, type VapiPaymentAccount, type WalletName } from "@vapi-network/core";
+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;
@@ -14,4 +14,5 @@ export declare function createAgentRunDeps(input: {
     fetchImpl?: typeof fetch;
     ledgerPath?: string;
     receiptsPath?: string;
+    ceilingSweep?: CeilingSweepHook | false;
 }): RunAgentDeps;

package/dist/agent/run.d.ts

@@ -1,4 +1,5 @@
 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";
@@ -60,6 +61,7 @@ export type RunAgentDeps = {
     onEvent?: (event: AgentEvent) => void;
     tty?: boolean;
     now?: () => Date;
+    forRun?: (run: ActionRunState) => RunAgentDeps;
 };
 export type RunAgentResult = {
     answer: string | null;
@@ -69,4 +71,38 @@ export type RunAgentResult = {
     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

@@ -6,4 +6,9 @@ export { WalletSession, type SessionWallet, type SessionWalletInfo, type WalletS
 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";
+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";