plugin-x402-endpoints 0.1.0 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "plugin-x402-endpoints",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "ElizaOS plugin exposing the x402-endpoints catalogue (28 paid data endpoints: official EU/global registries + crypto pre-trade data) as native agent actions, billed per call via x402 (USDC on Base mainnet).",
   "type": "module",
   "main": "dist/index.cjs",
@@ -87,4 +87,4 @@
       }
     }
   }
-}
+}

package/dist/index.d.cts

@@ -1,150 +0,0 @@
-import { Provider, Action, Plugin } from '@elizaos/core';
-
-/**
- * Types describing the x402 catalogue consumed by the plugin.
- *
- * The catalogue (src/catalog.json) is the single source of truth: one entry per
- * deployed x402 endpoint. The plugin turns each entry into an ElizaOS Action and
- * lists them in a Provider, so an Eliza agent discovers and calls them natively.
- */
-interface CatalogInputSchema {
-    type: "object";
-    properties: Record<string, {
-        type: string;
-        description?: string;
-        pattern?: string;
-    }>;
-    required?: string[];
-}
-interface CatalogEndpoint {
-    /** Short tool id, e.g. "gleif_lei". */
-    tool: string;
-    /** ElizaOS action name, e.g. "X402_GLEIF_LEI". */
-    action: string;
-    /** API path, e.g. "/gleif/lei". */
-    path: string;
-    /** HTTP method (all GET today). */
-    method: string;
-    /** Human price label, e.g. "$0.01". */
-    price: string;
-    /** Authority-rich semantic description (drives discovery). */
-    description: string;
-    /** Dense usage prompt for LLM agents. */
-    llm_usage_prompt?: string;
-    /** Semantic tags. */
-    tags?: string[];
-    /** JSON Schema for the query parameters. */
-    inputSchema: CatalogInputSchema;
-    /** A real example response (helps the agent before paying). */
-    outputExample?: unknown;
-    /** Payment metadata (mirrors the global values). */
-    payTo?: string;
-    network?: string;
-    asset?: string;
-}
-interface Catalog {
-    name: string;
-    baseUrl: string;
-    network: string;
-    asset: string;
-    payTo: string;
-    facilitator: string;
-    endpoints: CatalogEndpoint[];
-}
-/** Result of a paid (or discovery) call to an endpoint. */
-type CallResult = {
-    kind: "data";
-    status: number;
-    data: unknown;
-} | {
-    kind: "payment_required";
-    terms: PaymentTerms;
-} | {
-    kind: "error";
-    status?: number;
-    message: string;
-    detail?: string;
-};
-interface PaymentTerms {
-    x402PaymentRequired: true;
-    tool: string;
-    resource: string;
-    price: string;
-    network: string;
-    asset?: string;
-    payTo?: string;
-    scheme: string;
-    maxTimeoutSeconds: number;
-    howToPay: string;
-    exampleOutput?: unknown;
-}
-
-/**
- * Loads and exposes the bundled x402 catalogue.
- *
- * catalog.json is embedded at build time (resolveJsonModule), so the published
- * plugin is self-contained and never diverges from the deployed catalogue it was
- * built from. Runtime settings can still override baseUrl/network if needed.
- */
-
-declare const catalog: Catalog;
-declare const endpoints: CatalogEndpoint[];
-declare const ENDPOINT_COUNT: number;
-
-/**
- * Provider that injects the x402 catalogue into the agent's context, so the agent
- * is aware of every paid tool it can call (drives tool selection / discovery).
- */
-
-declare const x402CatalogProvider: Provider;
-
-/**
- * Builds one ElizaOS Action per catalogue endpoint.
- *
- * Each action:
- *  - is named after the endpoint (e.g. X402_GLEIF_LEI),
- *  - carries a dense, discovery-friendly description (+ price + usage prompt),
- *  - extracts call parameters from explicit options, structured content, or the
- *    natural-language message (via the runtime model), validating required fields,
- *  - calls the endpoint (auto-pay or discovery) and reports the result via callback.
- */
-
-declare function buildActions(): Action[];
-
-/**
- * x402 HTTP client for the plugin.
- *
- * Two modes, mirroring the MCP server:
- *  - auto-pay  : a funded Base buyer key is configured -> pays the 402 and returns live data.
- *  - discovery : no key (or auto-pay disabled) -> returns the exact payment terms.
- *
- * x402-fetch + viem are imported lazily so an agent that never auto-pays does not
- * need a signer at runtime.
- */
-
-interface ClientConfig {
-    baseUrl: string;
-    network: string;
-    buyerPrivateKey?: string;
-    autoPay: boolean;
-}
-type GetSetting = (key: string) => unknown;
-/** Resolve runtime config from agent settings, falling back to the bundled catalogue. */
-declare function resolveConfig(getSetting: GetSetting): ClientConfig;
-/** Call one endpoint. Auto-pays when configured and funded; otherwise returns terms. */
-declare function callEndpoint(ep: CatalogEndpoint, params: Record<string, unknown>, cfg: ClientConfig): Promise<CallResult>;
-
-/**
- * @x402-endpoints/plugin-elizaos
- *
- * ElizaOS plugin exposing the x402-endpoints catalogue (28 paid data endpoints:
- * official EU/global registries + crypto pre-trade data) as native Eliza actions,
- * billed per call via the x402 protocol (USDC on Base mainnet).
- *
- * Configure X402_BUYER_PRIVATE_KEY (a funded Base wallet) to auto-pay and receive
- * live data; otherwise actions return the exact payment terms (discovery).
- */
-
-declare const x402Plugin: Plugin;
-
-export { type CallResult, type Catalog, type CatalogEndpoint, type CatalogInputSchema, ENDPOINT_COUNT, type PaymentTerms, buildActions, callEndpoint, catalog, x402Plugin as default, endpoints, resolveConfig, x402CatalogProvider, x402Plugin };