agentcash 0.12.0 → 0.13.0

package/dist/cjs/run-server.cjs

@@ -80672,13 +80672,13 @@ var require_common = __commonJS({
           }
         }
       }
-      function matchesTemplate(search, template) {
+      function matchesTemplate(search2, template) {
         let searchIndex = 0;
         let templateIndex = 0;
         let starIndex = -1;
         let matchIndex = 0;
-        while (searchIndex < search.length) {
-          if (templateIndex < template.length && (template[templateIndex] === search[searchIndex] || template[templateIndex] === "*")) {
+        while (searchIndex < search2.length) {
+          if (templateIndex < template.length && (template[templateIndex] === search2[searchIndex] || template[templateIndex] === "*")) {
             if (template[templateIndex] === "*") {
               starIndex = templateIndex;
               matchIndex = searchIndex;
@@ -135518,7 +135518,7 @@ var handlerMap = {
 init_cjs_shims();
 function buildRequest2(input, context2) {
   const headers = buildRequestHeaders(input.headers, context2);
-  if (input.body && headers.get("Content-Type") === void 0) {
+  if (input.body && headers.get("Content-Type") === null) {
     headers.set("Content-Type", "application/json");
   }
   return new Request(input.url, {
@@ -135874,6 +135874,12 @@ ${PRIMARY_ORIGINS.flatMap((o3) => ORIGIN_METADATA[o3] ? [`  ${o3} \u2014 ${ORIGI
   try: {
     cli: `Fetch a new origin for its resources and return a prompt guiding the user through the process of calling the first endpoint.`
   },
+  search: {
+    mcp: `Search for relevant paid API services by describing what you need in natural language. Returns the best matching origins with endpoint details and pricing. The top result includes the full input/output schema so you can call it immediately via fetch.
+
+Use this FIRST when the user wants to accomplish something that your built-in capabilities don't support \u2014 before manually browsing origins or guessing URLs. If search returns results, proceed with check_endpoint_schema and fetch. If it returns empty, the capability isn't available as a paid API.`,
+    cli: `Search for paid API services by natural language query. Returns matching origins with endpoints and pricing. Use this to find APIs before calling discover or fetch.`
+  },
   reportError: {
     mcp: `EMERGENCY ONLY. Report critical MCP tool bugs. Do NOT use for normal errors (balance, network, 4xx) \u2014 those are recoverable.`,
     cli: `Report a critical bug to the agentcash team (emergency only). Do NOT use for normal errors like low balance, network timeouts, or 4xx responses \u2014 those are recoverable without filing a report.`
@@ -135891,9 +135897,10 @@ var WORKFLOW = [
   `Workflow:`,
   `1. If you don't already know your balance, call get_balance. You need a balance for paid endpoints. SIWX endpoints don't require one. You don't need to call this every turn, just before your first paid call or whenever you're unsure.`,
   `2. If the balance is zero, or if the user needs a funding link or wallet addresses, call list_accounts and share the relevant deposit link. If onboardingCta is present, show it to the user.`,
-  `3. Call discover_api_endpoints() to get the endpoint index \u2014 a list of available routes with descriptions and auth modes. The auth mode is advisory and tells you what the route may require.`,
-  `4. Call check_endpoint_schema() to get the exact input/output schema and auth mode for the endpoint you want to call, so you know what fields to pass and what the response contains. Both discover_api_endpoints and check_endpoint_schema return the auth mode.`,
-  `5. Call fetch with the correct input schema. It will attempt SIWX first when available and only pay if the route still returns 402.`
+  `3. If the task could be served by a paid API but you're not sure which origin, call search() first to find the right one. Search returns the best matching origins with endpoint schemas so you can often skip straight to fetch.`,
+  `4. Call discover_api_endpoints() to get the endpoint index \u2014 a list of available routes with descriptions and auth modes. The auth mode is advisory and tells you what the route may require.`,
+  `5. Call check_endpoint_schema() to get the exact input/output schema and auth mode for the endpoint you want to call, so you know what fields to pass and what the response contains. Both discover_api_endpoints and check_endpoint_schema return the auth mode.`,
+  `6. Call fetch with the correct input schema. It will attempt SIWX first when available and only pay if the route still returns 402.`
 ].join("\n");
 function buildServerInstructions(userOrigins = []) {
   const allOrigins = [
@@ -135906,7 +135913,7 @@ function buildServerInstructions(userOrigins = []) {
     `AgentCash lets you call protected APIs \u2014 handling both x402 micropayments and SIWX authentication seamlessly. It manages a USDC wallet for paid endpoints and signs wallet proofs for identity-gated endpoints through fetch.`,
     `The user has installed agentcash because they want to use paid and SIWX-protected APIs as their preferred way to accomplish related tasks.`,
     `Paid endpoints require a wallet balance. SIWX endpoints are free \u2014 they only require a wallet identity.`,
-    `If a task could be accomplished by one of these registered origins, run the workflow below:
+    `If a task could be accomplished by one of these registered origins, run the workflow below. If you're unsure which origin to use, or the task doesn't match a registered origin, call search() to find relevant APIs.
 ${allOrigins}`,
     `discover_api_endpoints also works with any origin beyond this list. If you identify another origin that would be useful for a task, you can use it.`,
     WORKFLOW,
@@ -135966,6 +135973,9 @@ var TOOL_PARAMS = {
       txHash: "Transaction hash on Base"
     }
   },
+  search: {
+    query: 'Natural language description of what you need (e.g. "send physical mail", "generate music", "flight prices")'
+  },
   discoverApiEndpoints: {
     url: "The origin URL to discover endpoints on (e.g. https://stableenrich.dev)",
     includeGuidance: "Request the origin's usage guidance. true=always include, false=never include, omit=auto (included when compact). Guidance explains how to compose multiple endpoints and covers edge cases."
@@ -151156,7 +151166,7 @@ var import_path2 = require("path");
 var import_url2 = require("url");
 function getVersion3() {
   if (true) {
-    return "0.12.0";
+    return "0.13.0";
   }
   const __dirname2 = (0, import_path2.dirname)((0, import_url2.fileURLToPath)(importMetaUrl));
   const pkg2 = JSON.parse(
@@ -158497,6 +158507,125 @@ var registerBridgeTool = ({
   );
 };
 
+// src/server/tools/search.ts
+init_cjs_shims();
+
+// src/operations/search.ts
+init_cjs_shims();
+var AGENTCASH_SEARCH_URL = process.env.AGENTCASH_SEARCH_URL ?? "https://agentcash.dev/api/search";
+var searchSchema = zod_default.object({
+  query: zod_default.string().min(1).describe(TOOL_PARAMS.search.query)
+});
+async function search(args, options) {
+  const parsed = searchSchema.safeParse(args);
+  if (!parsed.success) {
+    return {
+      success: false,
+      cause: "invalid_input",
+      message: parsed.error.message
+    };
+  }
+  const { surface, wallets, flags } = options;
+  log.info(`[search] Searching for: ${parsed.data.query}`);
+  const fetchResult = await executeFetch(
+    {
+      url: AGENTCASH_SEARCH_URL,
+      method: "POST" /* POST */,
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ query: parsed.data.query })
+    },
+    {
+      surface,
+      wallets,
+      flags,
+      params: {}
+    }
+  );
+  if (fetchResult.isErr()) {
+    return {
+      success: false,
+      cause: fetchResult.error.cause,
+      message: fetchResult.error.message
+    };
+  }
+  const { response } = fetchResult.value;
+  if (!response.ok) {
+    const parseResult2 = await safeParseResponse(surface, response);
+    return {
+      success: false,
+      cause: "http",
+      message: `Search API returned ${response.status}: ${response.statusText}`,
+      details: parseResult2.match(
+        (data) => data.type === "json" || data.type === "text" ? data.data : void 0,
+        () => void 0
+      )
+    };
+  }
+  const parseResult = await safeParseResponse(surface, response);
+  if (parseResult.isErr()) {
+    return {
+      success: false,
+      cause: parseResult.error.cause,
+      message: parseResult.error.message
+    };
+  }
+  const parsedResponse = parseResult.value;
+  return {
+    success: true,
+    results: parsedResponse.type === "json" || parsedResponse.type === "text" ? parsedResponse.data : { type: parsedResponse.type }
+  };
+}
+
+// src/server/tools/search.ts
+var TOOL_NAME2 = "search";
+var registerSearchTool = ({
+  server,
+  wallets,
+  flags
+}) => {
+  server.registerTool(
+    TOOL_NAME2,
+    {
+      title: "Search APIs",
+      description: DESCRIPTIONS.search.mcp,
+      inputSchema: searchSchema,
+      annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true
+      }
+    },
+    safeHandler(async (args) => {
+      log.info(`[search] query: ${args.query}`);
+      const searchResult = await resultFromPromise(
+        "search",
+        TOOL_NAME2,
+        search(args, { surface: TOOL_NAME2, wallets, flags }),
+        (e5) => ({
+          cause: "search",
+          message: e5 instanceof Error ? e5.message : String(e5)
+        })
+      );
+      if (searchResult.isErr()) {
+        return mcpError(searchResult);
+      }
+      const result = searchResult.value;
+      if (!result.success) {
+        return mcpErrorJson({
+          error: result.message,
+          cause: result.cause,
+          details: result.details
+        });
+      }
+      return mcpSuccessJson({
+        success: result.success,
+        results: result.results
+      });
+    })
+  );
+};
+
 // src/server/lib/version.ts
 init_cjs_shims();
 var import_fs8 = require("fs");
@@ -158504,7 +158633,7 @@ var import_path3 = require("path");
 var import_url5 = require("url");
 function getVersion4() {
   if (true) {
-    return "0.12.0";
+    return "0.13.0";
   }
   const __dirname2 = (0, import_path3.dirname)((0, import_url5.fileURLToPath)(importMetaUrl));
   const pkg2 = JSON.parse(
@@ -158897,6 +159026,7 @@ var startServer = async (flags) => {
   registerTelemetryTools(props);
   registerSettingsTools(props);
   registerBridgeTool(props);
+  registerSearchTool(props);
   const transport = new StdioServerTransport();
   await server.connect(transport);
   const shutdown = async () => {

package/dist/esm/{add-skill-4UF4QK5J.js → add-skill-3SHARVQA.js}

@@ -1,6 +1,6 @@
 import {
   resolveOrigin
-} from "./chunk-G2MVRSCD.js";
+} from "./chunk-RVJ22H4S.js";
 import {
   installSkills
 } from "./chunk-4JNU4ZDR.js";
@@ -8,22 +8,22 @@ import {
   addUserOrigin
 } from "./chunk-TX4UYXJO.js";
 import "./chunk-LNQRIXFK.js";
-import "./chunk-337V46UN.js";
+import "./chunk-HOGMCHWI.js";
 import {
   safeMkdir,
   safeMkdtemp,
   safeRm,
   safeWriteFile
 } from "./chunk-Y4VZACTC.js";
-import "./chunk-GIDAKG7I.js";
+import "./chunk-EMQMCXIC.js";
 import "./chunk-VDBUUHJF.js";
 import "./chunk-ITCDZXBZ.js";
+import "./chunk-FB5CMO3J.js";
 import {
   errorResponse,
   outputAndExit,
   successResponse
 } from "./chunk-7EBJ4BCH.js";
-import "./chunk-FB5CMO3J.js";
 import "./chunk-C7KWYVS3.js";
 
 // src/shared/skills/origin.ts
@@ -96,4 +96,4 @@ var addSkillCommand = async (input) => {
 export {
   addSkillCommand
 };
-//# sourceMappingURL=add-skill-4UF4QK5J.js.map
+//# sourceMappingURL=add-skill-3SHARVQA.js.map

package/dist/esm/{bridge-TRYZXGYM.js → bridge-55J4MKZR.js}

@@ -1,21 +1,21 @@
 import {
   bridge,
   bridgeSchema
-} from "./chunk-U2Z3IFDC.js";
+} from "./chunk-EJDPIURX.js";
 import {
   getWalletOrExit
-} from "./chunk-OZD4QBHS.js";
-import "./chunk-SIBQDIAW.js";
+} from "./chunk-QOYH6AOG.js";
+import "./chunk-HFEYSQRZ.js";
 import "./chunk-NPJV7AMV.js";
-import "./chunk-QZBSRYSW.js";
-import "./chunk-NROPRHIC.js";
 import "./chunk-LNQRIXFK.js";
 import "./chunk-Y4VZACTC.js";
 import {
   DESCRIPTIONS
-} from "./chunk-GIDAKG7I.js";
+} from "./chunk-EMQMCXIC.js";
 import "./chunk-VDBUUHJF.js";
 import "./chunk-ITCDZXBZ.js";
+import "./chunk-QZBSRYSW.js";
+import "./chunk-NROPRHIC.js";
 import {
   errorResponse,
   fromNeverthrowError,
@@ -54,4 +54,4 @@ var bridgeCommand = async (args) => {
 export {
   bridgeCommand
 };
-//# sourceMappingURL=bridge-TRYZXGYM.js.map
+//# sourceMappingURL=bridge-55J4MKZR.js.map

package/dist/esm/{check-MSPK44AN.js → check-V262JV5M.js}

@@ -1,30 +1,31 @@
 import {
   checkEndpoint
-} from "./chunk-KGGPN7W5.js";
+} from "./chunk-DFHVSUHX.js";
 import {
   cliRequestSchema
-} from "./chunk-JPFKXA27.js";
-import "./chunk-S3Q7HU4U.js";
+} from "./chunk-WUNL7OYW.js";
+import "./chunk-BQRFNAMV.js";
+import "./chunk-IKPLMFAK.js";
 import {
   RequestMethod
-} from "./chunk-JWOPPEMV.js";
+} from "./chunk-LNJIXYCU.js";
 import {
   getWalletOrExit
-} from "./chunk-OZD4QBHS.js";
-import "./chunk-SIBQDIAW.js";
+} from "./chunk-QOYH6AOG.js";
+import "./chunk-HFEYSQRZ.js";
 import "./chunk-NPJV7AMV.js";
-import "./chunk-NROPRHIC.js";
 import "./chunk-LNQRIXFK.js";
 import "./chunk-Y4VZACTC.js";
-import "./chunk-GIDAKG7I.js";
+import "./chunk-EMQMCXIC.js";
 import "./chunk-VDBUUHJF.js";
 import "./chunk-ITCDZXBZ.js";
+import "./chunk-NROPRHIC.js";
+import "./chunk-FB5CMO3J.js";
 import {
   errorResponse,
   outputAndExit,
   successResponse
 } from "./chunk-7EBJ4BCH.js";
-import "./chunk-FB5CMO3J.js";
 import "./chunk-C7KWYVS3.js";
 
 // src/cli/commands/check.ts
@@ -69,4 +70,4 @@ var checkCommand = async (args) => {
 export {
   checkCommand
 };
-//# sourceMappingURL=check-MSPK44AN.js.map
+//# sourceMappingURL=check-V262JV5M.js.map

package/dist/esm/{check-MSPK44AN.js.map → check-V262JV5M.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../../src/cli/commands/check.ts"],"sourcesContent":["import z from 'zod';\n\nimport { successResponse, outputAndExit, errorResponse } from '@/cli/output';\n\nimport { checkEndpoint } from '@/operations/check-endpoint';\n\nimport { getWalletOrExit } from '../lib/get-wallet-or-exit';\n\nimport type { Command } from '@/types';\nimport { cliRequestSchema } from '@/shared/request/schemas/cli';\nimport { RequestMethod } from '@/shared/request/types';\n\nconst SURFACE = 'cli:check';\n\nexport const checkCommand: Command<\n  z.input<typeof cliRequestSchema>\n> = async args => {\n  const requestInput = cliRequestSchema\n    .extend({\n      method: z.enum(RequestMethod).optional(),\n    })\n    .safeParse(args);\n  if (!requestInput.success) {\n    return outputAndExit(\n      errorResponse({\n        code: 'INVALID_INPUT',\n        message: requestInput.error.message,\n        surface: SURFACE,\n        cause: 'validation',\n      }),\n      args\n    );\n  }\n  const wallets = await getWalletOrExit(args);\n\n  const result = await checkEndpoint(SURFACE, requestInput.data, {\n    wallets,\n    flags: args,\n  });\n\n  if (!result.found) {\n    return outputAndExit(\n      successResponse({\n        url: args.url,\n        results: [],\n        error: result.cause,\n        message: result.message,\n      }),\n      args\n    );\n  }\n\n  return outputAndExit(\n    successResponse({ url: args.url, results: result.advisories }),\n    args\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,OAAO;AAYd,IAAM,UAAU;AAET,IAAM,eAET,OAAM,SAAQ;AAChB,QAAM,eAAe,iBAClB,OAAO;AAAA,IACN,QAAQ,EAAE,KAAK,aAAa,EAAE,SAAS;AAAA,EACzC,CAAC,EACA,UAAU,IAAI;AACjB,MAAI,CAAC,aAAa,SAAS;AACzB,WAAO;AAAA,MACL,cAAc;AAAA,QACZ,MAAM;AAAA,QACN,SAAS,aAAa,MAAM;AAAA,QAC5B,SAAS;AAAA,QACT,OAAO;AAAA,MACT,CAAC;AAAA,MACD;AAAA,IACF;AAAA,EACF;AACA,QAAM,UAAU,MAAM,gBAAgB,IAAI;AAE1C,QAAM,SAAS,MAAM,cAAc,SAAS,aAAa,MAAM;AAAA,IAC7D;AAAA,IACA,OAAO;AAAA,EACT,CAAC;AAED,MAAI,CAAC,OAAO,OAAO;AACjB,WAAO;AAAA,MACL,gBAAgB;AAAA,QACd,KAAK,KAAK;AAAA,QACV,SAAS,CAAC;AAAA,QACV,OAAO,OAAO;AAAA,QACd,SAAS,OAAO;AAAA,MAClB,CAAC;AAAA,MACD;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AAAA,IACL,gBAAgB,EAAE,KAAK,KAAK,KAAK,SAAS,OAAO,WAAW,CAAC;AAAA,IAC7D;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../../src/cli/commands/check.ts"],"sourcesContent":["import z from 'zod';\n\nimport { successResponse, outputAndExit, errorResponse } from '@/cli/output';\n\nimport { checkEndpoint } from '@/operations/check-endpoint';\n\nimport { getWalletOrExit } from '../lib/get-wallet-or-exit';\n\nimport type { Command } from '@/types';\nimport { cliRequestSchema } from '@/shared/request/schemas/cli';\nimport { RequestMethod } from '@/shared/request/types';\n\nconst SURFACE = 'cli:check';\n\nexport const checkCommand: Command<\n  z.input<typeof cliRequestSchema>\n> = async args => {\n  const requestInput = cliRequestSchema\n    .extend({\n      method: z.enum(RequestMethod).optional(),\n    })\n    .safeParse(args);\n  if (!requestInput.success) {\n    return outputAndExit(\n      errorResponse({\n        code: 'INVALID_INPUT',\n        message: requestInput.error.message,\n        surface: SURFACE,\n        cause: 'validation',\n      }),\n      args\n    );\n  }\n  const wallets = await getWalletOrExit(args);\n\n  const result = await checkEndpoint(SURFACE, requestInput.data, {\n    wallets,\n    flags: args,\n  });\n\n  if (!result.found) {\n    return outputAndExit(\n      successResponse({\n        url: args.url,\n        results: [],\n        error: result.cause,\n        message: result.message,\n      }),\n      args\n    );\n  }\n\n  return outputAndExit(\n    successResponse({ url: args.url, results: result.advisories }),\n    args\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,OAAO;AAYd,IAAM,UAAU;AAET,IAAM,eAET,OAAM,SAAQ;AAChB,QAAM,eAAe,iBAClB,OAAO;AAAA,IACN,QAAQ,EAAE,KAAK,aAAa,EAAE,SAAS;AAAA,EACzC,CAAC,EACA,UAAU,IAAI;AACjB,MAAI,CAAC,aAAa,SAAS;AACzB,WAAO;AAAA,MACL,cAAc;AAAA,QACZ,MAAM;AAAA,QACN,SAAS,aAAa,MAAM;AAAA,QAC5B,SAAS;AAAA,QACT,OAAO;AAAA,MACT,CAAC;AAAA,MACD;AAAA,IACF;AAAA,EACF;AACA,QAAM,UAAU,MAAM,gBAAgB,IAAI;AAE1C,QAAM,SAAS,MAAM,cAAc,SAAS,aAAa,MAAM;AAAA,IAC7D;AAAA,IACA,OAAO;AAAA,EACT,CAAC;AAED,MAAI,CAAC,OAAO,OAAO;AACjB,WAAO;AAAA,MACL,gBAAgB;AAAA,QACd,KAAK,KAAK;AAAA,QACV,SAAS,CAAC;AAAA,QACV,OAAO,OAAO;AAAA,QACd,SAAS,OAAO;AAAA,MAClB,CAAC;AAAA,MACD;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AAAA,IACL,gBAAgB,EAAE,KAAK,KAAK,KAAK,SAAS,OAAO,WAAW,CAAC;AAAA,IAC7D;AAAA,EACF;AACF;","names":[]}

package/dist/esm/{chunk-5ABKHXAY.js → chunk-3UDQHC6S.js}

@@ -1,6 +1,6 @@
 import {
   MCP_VERSION
-} from "./chunk-QX2H4FUE.js";
+} from "./chunk-WXR2KGLL.js";
 import {
   getBaseUrl,
   safeFetchJson
@@ -49,4 +49,4 @@ async function submitErrorReport(surface, input, address, dev) {
 export {
   submitErrorReport
 };
-//# sourceMappingURL=chunk-5ABKHXAY.js.map
+//# sourceMappingURL=chunk-3UDQHC6S.js.map

package/dist/esm/{chunk-DYEEHIRQ.js → chunk-6L7ONOXE.js}

@@ -6,7 +6,7 @@ import {
 } from "./chunk-27DZCYDB.js";
 import {
   INSTALL_PACKAGE_SPECIFIER
-} from "./chunk-QX2H4FUE.js";
+} from "./chunk-WXR2KGLL.js";
 import {
   log,
   safeReadFile,
@@ -610,4 +610,4 @@ export {
   tryAddServer,
   addServer
 };
-//# sourceMappingURL=chunk-DYEEHIRQ.js.map
+//# sourceMappingURL=chunk-6L7ONOXE.js.map

package/dist/esm/{chunk-JWOPPEMV.js → chunk-BQRFNAMV.js}

@@ -1,21 +1,14 @@
+import {
+  RequestMethod
+} from "./chunk-LNJIXYCU.js";
 import {
   REQUEST_FETCH_PARAMS,
   REQUEST_PARAMS
-} from "./chunk-GIDAKG7I.js";
+} from "./chunk-EMQMCXIC.js";
 import {
   zodUrl
 } from "./chunk-FB5CMO3J.js";
 
-// src/shared/request/types.ts
-var RequestMethod = /* @__PURE__ */ ((RequestMethod2) => {
-  RequestMethod2["GET"] = "GET";
-  RequestMethod2["POST"] = "POST";
-  RequestMethod2["PUT"] = "PUT";
-  RequestMethod2["DELETE"] = "DELETE";
-  RequestMethod2["PATCH"] = "PATCH";
-  return RequestMethod2;
-})(RequestMethod || {});
-
 // src/shared/request/schemas/core.ts
 import z from "zod";
 var requestMethodValues = Object.values(RequestMethod);
@@ -41,11 +34,10 @@ var fetchShape = {
 };
 
 export {
-  RequestMethod,
   requestMethodValues,
   coreRequestSchema,
   paymentNetworks,
   paymentProtocols,
   fetchShape
 };
-//# sourceMappingURL=chunk-JWOPPEMV.js.map
+//# sourceMappingURL=chunk-BQRFNAMV.js.map

package/dist/esm/chunk-BQRFNAMV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/shared/request/schemas/core.ts"],"sourcesContent":["import z from 'zod';\n\nimport { REQUEST_PARAMS, REQUEST_FETCH_PARAMS } from '@/shared/descriptions';\nimport { PaymentProtocol } from '@/shared/protocols/types';\nimport { Network } from '@agentcash/networks';\nimport { zodUrl } from '@/shared/url';\n\nimport { RequestMethod } from '../types';\n\nexport const requestMethodValues: readonly RequestMethod[] =\n  Object.values(RequestMethod);\n\nconst methodSchema = z\n  .enum(RequestMethod)\n  .optional()\n  .default(RequestMethod.GET)\n  .describe(REQUEST_PARAMS.method);\n\nexport const coreRequestSchema = z.object({\n  url: zodUrl.describe(REQUEST_PARAMS.url),\n  method: methodSchema,\n});\n\nexport const paymentNetworks: Network[] = [\n  Network.BASE,\n  Network.SOLANA,\n  Network.TEMPO,\n];\n\nexport const paymentProtocols: PaymentProtocol[] = [\n  PaymentProtocol.X402,\n  PaymentProtocol.MPP,\n];\n\nexport const fetchShape = {\n  paymentNetwork: z\n    .enum(paymentNetworks)\n    .optional()\n    .describe(REQUEST_FETCH_PARAMS.paymentNetwork),\n  paymentProtocol: z\n    .enum(paymentProtocols)\n    .optional()\n    .describe(REQUEST_FETCH_PARAMS.paymentProtocol),\n  maxAmount: z\n    .number()\n    .positive()\n    .optional()\n    .describe(REQUEST_FETCH_PARAMS.maxAmount),\n  timeout: z\n    .number()\n    .int()\n    .positive()\n    .optional()\n    .describe(REQUEST_PARAMS.timeout),\n};\n"],"mappings":";;;;;;;;;;;;AAAA,OAAO,OAAO;AASP,IAAM,sBACX,OAAO,OAAO,aAAa;AAE7B,IAAM,eAAe,EAClB,KAAK,aAAa,EAClB,SAAS,EACT,uBAAyB,EACzB,SAAS,eAAe,MAAM;AAE1B,IAAM,oBAAoB,EAAE,OAAO;AAAA,EACxC,KAAK,OAAO,SAAS,eAAe,GAAG;AAAA,EACvC,QAAQ;AACV,CAAC;AAEM,IAAM,kBAA6B;AAAA;AAAA;AAAA;AAI1C;AAEO,IAAM,mBAAsC;AAAA;AAAA;AAGnD;AAEO,IAAM,aAAa;AAAA,EACxB,gBAAgB,EACb,KAAK,eAAe,EACpB,SAAS,EACT,SAAS,qBAAqB,cAAc;AAAA,EAC/C,iBAAiB,EACd,KAAK,gBAAgB,EACrB,SAAS,EACT,SAAS,qBAAqB,eAAe;AAAA,EAChD,WAAW,EACR,OAAO,EACP,SAAS,EACT,SAAS,EACT,SAAS,qBAAqB,SAAS;AAAA,EAC1C,SAAS,EACN,OAAO,EACP,IAAI,EACJ,SAAS,EACT,SAAS,EACT,SAAS,eAAe,OAAO;AACpC;","names":[]}

package/dist/esm/{chunk-PH5ZST4Z.js → chunk-BYLBPP4V.js}

@@ -1,7 +1,3 @@
-import {
-  safeFetch,
-  safeFetchJson
-} from "./chunk-QZBSRYSW.js";
 import {
   installSkills
 } from "./chunk-4JNU4ZDR.js";
@@ -11,6 +7,10 @@ import {
   safeRm,
   safeWriteFile
 } from "./chunk-Y4VZACTC.js";
+import {
+  safeFetch,
+  safeFetchJson
+} from "./chunk-QZBSRYSW.js";
 import {
   err,
   ok,
@@ -163,4 +163,4 @@ async function installGitHubSkill(surface, source, options) {
 export {
   installGitHubSkill
 };
-//# sourceMappingURL=chunk-PH5ZST4Z.js.map
+//# sourceMappingURL=chunk-BYLBPP4V.js.map

package/dist/esm/{chunk-KGGPN7W5.js → chunk-DFHVSUHX.js}

@@ -1,6 +1,6 @@
 import {
   buildRequestHeaders
-} from "./chunk-S3Q7HU4U.js";
+} from "./chunk-IKPLMFAK.js";
 import {
   safeParseJson,
   safeToJsonObject
@@ -69,4 +69,4 @@ async function checkEndpoint(surface, requestInput, context) {
 export {
   checkEndpoint
 };
-//# sourceMappingURL=chunk-KGGPN7W5.js.map
+//# sourceMappingURL=chunk-DFHVSUHX.js.map

package/dist/esm/chunk-E5SPXKCI.js

@@ -0,0 +1,84 @@
+import {
+  executeFetch
+} from "./chunk-Q5SPIJGE.js";
+import {
+  log
+} from "./chunk-Y4VZACTC.js";
+import {
+  TOOL_PARAMS
+} from "./chunk-EMQMCXIC.js";
+import {
+  safeParseResponse
+} from "./chunk-QZBSRYSW.js";
+
+// src/operations/search.ts
+import z from "zod";
+var AGENTCASH_SEARCH_URL = process.env.AGENTCASH_SEARCH_URL ?? "https://agentcash.dev/api/search";
+var searchSchema = z.object({
+  query: z.string().min(1).describe(TOOL_PARAMS.search.query)
+});
+async function search(args, options) {
+  const parsed = searchSchema.safeParse(args);
+  if (!parsed.success) {
+    return {
+      success: false,
+      cause: "invalid_input",
+      message: parsed.error.message
+    };
+  }
+  const { surface, wallets, flags } = options;
+  log.info(`[search] Searching for: ${parsed.data.query}`);
+  const fetchResult = await executeFetch(
+    {
+      url: AGENTCASH_SEARCH_URL,
+      method: "POST" /* POST */,
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ query: parsed.data.query })
+    },
+    {
+      surface,
+      wallets,
+      flags,
+      params: {}
+    }
+  );
+  if (fetchResult.isErr()) {
+    return {
+      success: false,
+      cause: fetchResult.error.cause,
+      message: fetchResult.error.message
+    };
+  }
+  const { response } = fetchResult.value;
+  if (!response.ok) {
+    const parseResult2 = await safeParseResponse(surface, response);
+    return {
+      success: false,
+      cause: "http",
+      message: `Search API returned ${response.status}: ${response.statusText}`,
+      details: parseResult2.match(
+        (data) => data.type === "json" || data.type === "text" ? data.data : void 0,
+        () => void 0
+      )
+    };
+  }
+  const parseResult = await safeParseResponse(surface, response);
+  if (parseResult.isErr()) {
+    return {
+      success: false,
+      cause: parseResult.error.cause,
+      message: parseResult.error.message
+    };
+  }
+  const parsedResponse = parseResult.value;
+  return {
+    success: true,
+    results: parsedResponse.type === "json" || parsedResponse.type === "text" ? parsedResponse.data : { type: parsedResponse.type }
+  };
+}
+
+export {
+  searchSchema,
+  search
+};
+//# sourceMappingURL=chunk-E5SPXKCI.js.map

package/dist/esm/chunk-E5SPXKCI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/operations/search.ts"],"sourcesContent":["import z from 'zod';\n\nimport { log } from '@/shared/log';\nimport { executeFetch } from './fetch';\nimport { safeParseResponse } from '@/shared/neverthrow/fetch';\nimport { TOOL_PARAMS } from '@/shared/descriptions';\nimport { RequestMethod } from '@/shared/request/types';\n\nimport type { JsonStringifyValue } from '@/shared/neverthrow/json/types';\nimport type { Wallets } from '@/wallet';\nimport type { GlobalFlags } from '@/types';\n\nconst AGENTCASH_SEARCH_URL =\n  process.env.AGENTCASH_SEARCH_URL ?? 'https://agentcash.dev/api/search';\n\nexport const searchSchema = z.object({\n  query: z.string().min(1).describe(TOOL_PARAMS.search.query),\n});\n\nexport type SearchInput = z.input<typeof searchSchema>;\n\nexport interface SearchOptions {\n  surface: string;\n  wallets: Wallets;\n  flags: GlobalFlags;\n}\n\nexport type SearchResult =\n  | { success: true; results: JsonStringifyValue }\n  | {\n      success: false;\n      cause: string;\n      message: string;\n      details?: JsonStringifyValue;\n    };\n\n/**\n * Search for relevant paid API services by natural language query.\n * Calls the agentcash search API with SIWX auth via executeFetch.\n */\nexport async function search(\n  args: SearchInput,\n  options: SearchOptions\n): Promise<SearchResult> {\n  const parsed = searchSchema.safeParse(args);\n  if (!parsed.success) {\n    return {\n      success: false,\n      cause: 'invalid_input',\n      message: parsed.error.message,\n    };\n  }\n\n  const { surface, wallets, flags } = options;\n\n  log.info(`[search] Searching for: ${parsed.data.query}`);\n\n  const fetchResult = await executeFetch(\n    {\n      url: AGENTCASH_SEARCH_URL,\n      method: RequestMethod.POST,\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify({ query: parsed.data.query }),\n    },\n    {\n      surface,\n      wallets,\n      flags,\n      params: {},\n    }\n  );\n\n  if (fetchResult.isErr()) {\n    return {\n      success: false,\n      cause: fetchResult.error.cause,\n      message: fetchResult.error.message,\n    };\n  }\n\n  const { response } = fetchResult.value;\n\n  if (!response.ok) {\n    const parseResult = await safeParseResponse(surface, response);\n    return {\n      success: false,\n      cause: 'http',\n      message: `Search API returned ${response.status}: ${response.statusText}`,\n      details: parseResult.match(\n        data =>\n          data.type === 'json' || data.type === 'text'\n            ? (data.data as JsonStringifyValue)\n            : undefined,\n        () => undefined\n      ),\n    };\n  }\n\n  const parseResult = await safeParseResponse(surface, response);\n\n  if (parseResult.isErr()) {\n    return {\n      success: false,\n      cause: parseResult.error.cause,\n      message: parseResult.error.message,\n    };\n  }\n\n  const parsedResponse = parseResult.value;\n\n  return {\n    success: true,\n    results:\n      parsedResponse.type === 'json' || parsedResponse.type === 'text'\n        ? (parsedResponse.data as JsonStringifyValue)\n        : { type: parsedResponse.type },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;AAAA,OAAO,OAAO;AAYd,IAAM,uBACJ,QAAQ,IAAI,wBAAwB;AAE/B,IAAM,eAAe,EAAE,OAAO;AAAA,EACnC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,YAAY,OAAO,KAAK;AAC5D,CAAC;AAuBD,eAAsB,OACpB,MACA,SACuB;AACvB,QAAM,SAAS,aAAa,UAAU,IAAI;AAC1C,MAAI,CAAC,OAAO,SAAS;AACnB,WAAO;AAAA,MACL,SAAS;AAAA,MACT,OAAO;AAAA,MACP,SAAS,OAAO,MAAM;AAAA,IACxB;AAAA,EACF;AAEA,QAAM,EAAE,SAAS,SAAS,MAAM,IAAI;AAEpC,MAAI,KAAK,2BAA2B,OAAO,KAAK,KAAK,EAAE;AAEvD,QAAM,cAAc,MAAM;AAAA,IACxB;AAAA,MACE,KAAK;AAAA,MACL;AAAA,MACA,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,MAC9C,MAAM,KAAK,UAAU,EAAE,OAAO,OAAO,KAAK,MAAM,CAAC;AAAA,IACnD;AAAA,IACA;AAAA,MACE;AAAA,MACA;AAAA,MACA;AAAA,MACA,QAAQ,CAAC;AAAA,IACX;AAAA,EACF;AAEA,MAAI,YAAY,MAAM,GAAG;AACvB,WAAO;AAAA,MACL,SAAS;AAAA,MACT,OAAO,YAAY,MAAM;AAAA,MACzB,SAAS,YAAY,MAAM;AAAA,IAC7B;AAAA,EACF;AAEA,QAAM,EAAE,SAAS,IAAI,YAAY;AAEjC,MAAI,CAAC,SAAS,IAAI;AAChB,UAAMA,eAAc,MAAM,kBAAkB,SAAS,QAAQ;AAC7D,WAAO;AAAA,MACL,SAAS;AAAA,MACT,OAAO;AAAA,MACP,SAAS,uBAAuB,SAAS,MAAM,KAAK,SAAS,UAAU;AAAA,MACvE,SAASA,aAAY;AAAA,QACnB,UACE,KAAK,SAAS,UAAU,KAAK,SAAS,SACjC,KAAK,OACN;AAAA,QACN,MAAM;AAAA,MACR;AAAA,IACF;AAAA,EACF;AAEA,QAAM,cAAc,MAAM,kBAAkB,SAAS,QAAQ;AAE7D,MAAI,YAAY,MAAM,GAAG;AACvB,WAAO;AAAA,MACL,SAAS;AAAA,MACT,OAAO,YAAY,MAAM;AAAA,MACzB,SAAS,YAAY,MAAM;AAAA,IAC7B;AAAA,EACF;AAEA,QAAM,iBAAiB,YAAY;AAEnC,SAAO;AAAA,IACL,SAAS;AAAA,IACT,SACE,eAAe,SAAS,UAAU,eAAe,SAAS,SACrD,eAAe,OAChB,EAAE,MAAM,eAAe,KAAK;AAAA,EACpC;AACF;","names":["parseResult"]}

package/dist/esm/{chunk-U2Z3IFDC.js → chunk-EJDPIURX.js}

@@ -6,13 +6,13 @@ import {
   typedAddressSchema,
   usdc
 } from "./chunk-NPJV7AMV.js";
+import {
+  TOOL_PARAMS
+} from "./chunk-EMQMCXIC.js";
 import {
   getBaseUrl,
   safeFetchJson
 } from "./chunk-QZBSRYSW.js";
-import {
-  TOOL_PARAMS
-} from "./chunk-GIDAKG7I.js";
 import {
   resultFromPromise
 } from "./chunk-C7KWYVS3.js";
@@ -539,4 +539,4 @@ export {
   bridgeSchema,
   bridge
 };
-//# sourceMappingURL=chunk-U2Z3IFDC.js.map
+//# sourceMappingURL=chunk-EJDPIURX.js.map

package/dist/esm/{chunk-GIDAKG7I.js → chunk-EMQMCXIC.js}

@@ -120,6 +120,12 @@ ${PRIMARY_ORIGINS.flatMap((o) => ORIGIN_METADATA[o] ? [`  ${o} \u2014 ${ORIGIN_M
   try: {
     cli: `Fetch a new origin for its resources and return a prompt guiding the user through the process of calling the first endpoint.`
   },
+  search: {
+    mcp: `Search for relevant paid API services by describing what you need in natural language. Returns the best matching origins with endpoint details and pricing. The top result includes the full input/output schema so you can call it immediately via fetch.
+
+Use this FIRST when the user wants to accomplish something that your built-in capabilities don't support \u2014 before manually browsing origins or guessing URLs. If search returns results, proceed with check_endpoint_schema and fetch. If it returns empty, the capability isn't available as a paid API.`,
+    cli: `Search for paid API services by natural language query. Returns matching origins with endpoints and pricing. Use this to find APIs before calling discover or fetch.`
+  },
   reportError: {
     mcp: `EMERGENCY ONLY. Report critical MCP tool bugs. Do NOT use for normal errors (balance, network, 4xx) \u2014 those are recoverable.`,
     cli: `Report a critical bug to the agentcash team (emergency only). Do NOT use for normal errors like low balance, network timeouts, or 4xx responses \u2014 those are recoverable without filing a report.`
@@ -137,9 +143,10 @@ var WORKFLOW = [
   `Workflow:`,
   `1. If you don't already know your balance, call get_balance. You need a balance for paid endpoints. SIWX endpoints don't require one. You don't need to call this every turn, just before your first paid call or whenever you're unsure.`,
   `2. If the balance is zero, or if the user needs a funding link or wallet addresses, call list_accounts and share the relevant deposit link. If onboardingCta is present, show it to the user.`,
-  `3. Call discover_api_endpoints() to get the endpoint index \u2014 a list of available routes with descriptions and auth modes. The auth mode is advisory and tells you what the route may require.`,
-  `4. Call check_endpoint_schema() to get the exact input/output schema and auth mode for the endpoint you want to call, so you know what fields to pass and what the response contains. Both discover_api_endpoints and check_endpoint_schema return the auth mode.`,
-  `5. Call fetch with the correct input schema. It will attempt SIWX first when available and only pay if the route still returns 402.`
+  `3. If the task could be served by a paid API but you're not sure which origin, call search() first to find the right one. Search returns the best matching origins with endpoint schemas so you can often skip straight to fetch.`,
+  `4. Call discover_api_endpoints() to get the endpoint index \u2014 a list of available routes with descriptions and auth modes. The auth mode is advisory and tells you what the route may require.`,
+  `5. Call check_endpoint_schema() to get the exact input/output schema and auth mode for the endpoint you want to call, so you know what fields to pass and what the response contains. Both discover_api_endpoints and check_endpoint_schema return the auth mode.`,
+  `6. Call fetch with the correct input schema. It will attempt SIWX first when available and only pay if the route still returns 402.`
 ].join("\n");
 function buildServerInstructions(userOrigins = []) {
   const allOrigins = [
@@ -152,7 +159,7 @@ function buildServerInstructions(userOrigins = []) {
     `AgentCash lets you call protected APIs \u2014 handling both x402 micropayments and SIWX authentication seamlessly. It manages a USDC wallet for paid endpoints and signs wallet proofs for identity-gated endpoints through fetch.`,
     `The user has installed agentcash because they want to use paid and SIWX-protected APIs as their preferred way to accomplish related tasks.`,
     `Paid endpoints require a wallet balance. SIWX endpoints are free \u2014 they only require a wallet identity.`,
-    `If a task could be accomplished by one of these registered origins, run the workflow below:
+    `If a task could be accomplished by one of these registered origins, run the workflow below. If you're unsure which origin to use, or the task doesn't match a registered origin, call search() to find relevant APIs.
 ${allOrigins}`,
     `discover_api_endpoints also works with any origin beyond this list. If you identify another origin that would be useful for a task, you can use it.`,
     WORKFLOW,
@@ -212,6 +219,9 @@ var TOOL_PARAMS = {
       txHash: "Transaction hash on Base"
     }
   },
+  search: {
+    query: 'Natural language description of what you need (e.g. "send physical mail", "generate music", "flight prices")'
+  },
   discoverApiEndpoints: {
     url: "The origin URL to discover endpoints on (e.g. https://stableenrich.dev)",
     includeGuidance: "Request the origin's usage guidance. true=always include, false=never include, omit=auto (included when compact). Guidance explains how to compose multiple endpoints and covers edge cases."
@@ -240,4 +250,4 @@ export {
   REQUEST_FETCH_PARAMS,
   TOOL_PARAMS
 };
-//# sourceMappingURL=chunk-GIDAKG7I.js.map
+//# sourceMappingURL=chunk-EMQMCXIC.js.map