@vapi-network/sources 0.2.3 → 0.5.0

package/README.md

@@ -1,8 +1,14 @@
 # `@vapi-network/sources`
 
-Discovery adapters for the vAPI registry, the x402 Bazaar, and local JSON files.
-Results implement the `Source` and `Listing` contracts from `@vapi-network/core`
-and retain their source provenance.
+Discovery adapters for [vAPI Network](https://github.com/vAPI-Network/vapi-network):
+the vAPI Registry, the Coinbase Bazaar `/discovery/resources` catalogue, and
+local JSON files. Results implement the `Source` and `Listing` contracts from
+`@vapi-network/core` and keep their source provenance, so a caller never needs
+a source-specific branch.
 
-The x402scan adapter is intentionally a stub until x402scan documents a stable
-public read API.
+One entry point, `@vapi-network/sources`, exporting `vapiRegistrySource`,
+`bazaarSource`, `localFileSource` and `x402scanSource`. The x402scan adapter is
+intentionally a stub until x402scan documents a stable public read API.
+
+See the [root README](https://github.com/vAPI-Network/vapi-network#readme) for
+how the client merges and de-duplicates sources.

package/dist/index.js

@@ -19696,9 +19696,35 @@ var listingFeeSchema = external_exports.looseObject({
   bps: external_exports.number().int().min(0),
   label: external_exports.string()
 });
+var LISTING_VERIFICATIONS = ["none", "requested", "verified"];
+var listingVerificationSchema = external_exports.enum(LISTING_VERIFICATIONS);
+var listingVerificationFieldSchema = listingVerificationSchema.default("none").catch("none");
+var listingLivenessSchema = external_exports.looseObject({
+  uptime7d: external_exports.number().min(0).max(1),
+  latencyP50Ms: external_exports.number().nonnegative().nullable(),
+  latencyP95Ms: external_exports.number().nonnegative().nullable(),
+  checks7d: external_exports.number().int().nonnegative()
+});
+var listingConformanceSchema = external_exports.looseObject({
+  declaredVersion: external_exports.union([external_exports.literal(1), external_exports.literal(2)]).nullable(),
+  versionConformant: external_exports.boolean(),
+  offerTransport: external_exports.enum(["body", "header", "both"]),
+  issues: external_exports.array(external_exports.string())
+});
+var listingIdentitySchema = external_exports.looseObject({
+  erc8004Id: external_exports.string().trim().min(1),
+  reputation: external_exports.looseObject({
+    score: external_exports.number().finite(),
+    count: external_exports.number().int().nonnegative()
+  }).optional().catch(void 0)
+});
 var listingDisclosureShape = {
   group: listingGroupSchema.optional(),
-  fee: listingFeeSchema.optional()
+  fee: listingFeeSchema.optional(),
+  verification: listingVerificationFieldSchema,
+  liveness: listingLivenessSchema.optional().catch(void 0),
+  conformance: listingConformanceSchema.optional().catch(void 0),
+  identity: listingIdentitySchema.optional().catch(void 0)
 };
 var marketplaceBadgeCodeSchema = external_exports.enum([
   "live_x402",
@@ -20005,6 +20031,7 @@ init_getAddress();
 
 // ../core/src/x402-networks.ts
 var BASE_MAINNET_CAIP2 = "eip155:8453";
+var ARC_MAINNET_CAIP2 = "eip155:5042";
 var ARC_TESTNET_CAIP2 = "eip155:5042002";
 var SOLANA_MAINNET_CAIP2 = "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpKuc147dw2N9d";
 var X402_SOLANA_MAINNET_CAIP2 = "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
@@ -20023,8 +20050,13 @@ var arcTestnetUsdc = canonicalIdentity("0x36000000000000000000000000000000000000
   name: "USDC",
   version: "2"
 });
+var arcMainnetUsdc = canonicalIdentity("0x3600000000000000000000000000000000000000", {
+  name: "USDC",
+  version: "2"
+});
 var CANONICAL_X402_USDC_NETWORKS = Object.freeze({
   [BASE_MAINNET_CAIP2]: baseMainnetUsdc,
+  [ARC_MAINNET_CAIP2]: arcMainnetUsdc,
   [ARC_TESTNET_CAIP2]: arcTestnetUsdc
 });
 function browserNetwork(identity) {
@@ -20036,6 +20068,7 @@ function browserNetwork(identity) {
 }
 var BROWSER_ENABLED_X402_NETWORK_CONFIG = Object.freeze({
   [BASE_MAINNET_CAIP2]: browserNetwork(baseMainnetUsdc),
+  [ARC_MAINNET_CAIP2]: browserNetwork(arcMainnetUsdc),
   [ARC_TESTNET_CAIP2]: browserNetwork(arcTestnetUsdc)
 });
 
@@ -20249,6 +20282,16 @@ var NETWORKS = {
     rpcEnv: "BASE_RPC_URL",
     publicRpcUrl: "https://mainnet.base.org"
   },
+  [ARC_MAINNET_CAIP2]: {
+    family: "evm",
+    chainId: 5042,
+    name: "Arc mainnet",
+    usdc: CANONICAL_X402_USDC_NETWORKS[ARC_MAINNET_CAIP2].usdc,
+    gasToken: "USDC",
+    rpcEnv: "ARC_RPC_URL",
+    publicRpcUrl: "https://rpc.mainnet.arc.io",
+    explorerUrl: "https://explorer.arc.io"
+  },
   [ARC_TESTNET_CAIP2]: {
     family: "evm",
     chainId: 5042002,
@@ -20354,7 +20397,14 @@ var configSchema = external_exports.object({
       continue;
     }
     try {
-      getAddress(configured.usdc);
+      const usdc = getAddress(configured.usdc);
+      if ((network === ARC_MAINNET_CAIP2 || network === ARC_TESTNET_CAIP2) && usdc !== getAddress(NETWORKS[network].usdc)) {
+        context.addIssue({
+          code: "custom",
+          path: ["networks", network, "usdc"],
+          message: "Expected the canonical Arc USDC predeploy."
+        });
+      }
     } catch {
       context.addIssue({
         code: "custom",
@@ -20367,6 +20417,7 @@ var configSchema = external_exports.object({
 function getVapiPaths(directory = process.env.VAPI_HOME?.trim() || join(homedir(), ".vapi")) {
   return {
     directory,
+    agentsDir: join(directory, "agents"),
     config: join(directory, "config.json"),
     keystore: join(directory, "keystore.json"),
     receipts: join(directory, "receipts.jsonl"),
@@ -20670,7 +20721,8 @@ async function searchMarketplace(input2, config2, fetchImpl, options = {}) {
     kinds: input2.kinds,
     network: input2.network,
     limit: input2.limit,
-    cursor: input2.cursor
+    cursor: input2.cursor,
+    includeUnverified: input2.includeUnverified
   });
   const startedAt = options.now ?? /* @__PURE__ */ new Date();
   const attempts = [];
@@ -20689,6 +20741,9 @@ async function searchMarketplace(input2, config2, fetchImpl, options = {}) {
         if (normalized.network !== void 0) url2.searchParams.set("network", normalized.network);
         if (normalized.limit !== void 0) url2.searchParams.set("limit", String(normalized.limit));
         if (normalized.cursor !== void 0) url2.searchParams.set("cursor", normalized.cursor);
+        if (normalized.includeUnverified === true) {
+          url2.searchParams.set("includeUnverified", "true");
+        }
       }
     });
     const page = marketplaceDiscoveryPageSchema.parse(await response.json());
@@ -20719,7 +20774,7 @@ async function resolveServiceListing(id, config2, fetchImpl, endpointName) {
 }
 async function findMarketplaceApiByRef(ref, config2, fetchImpl) {
   const page = await searchMarketplace(
-    { query: ref, kinds: ["api"], limit: 50 },
+    { query: ref, kinds: ["api"], limit: 50, includeUnverified: true },
     config2,
     fetchImpl
   );
@@ -20734,37 +20789,36 @@ function vapiRegistrySource(baseUrl, options = {}) {
   const fetchImpl = sourceFetch(options);
   return {
     id: "vapi",
-    async search(query) {
-      const page = await searchMarketplace({ query, kinds: ["api"] }, config2, fetchImpl);
+    async search(query, searchOptions) {
+      const page = await searchMarketplace(
+        {
+          query,
+          kinds: ["api"],
+          ...searchOptions?.includeUnverified === void 0 ? {} : { includeUnverified: searchOptions.includeUnverified }
+        },
+        config2,
+        fetchImpl
+      );
       const mapped = await Promise.all(
         page.items.map(async (hit) => {
           if (hit.kind !== "api") return null;
           if (hit.provenance === "indexed") {
-            return {
-              resource: { url: hit.execution.url, description: hit.card.summary },
-              name: hit.card.title,
-              description: hit.card.summary,
-              ...hit.execution.method === null ? {} : { method: hit.execution.method },
-              network: hit.execution.network,
-              ...optionalPrice(hit.card.facts),
-              metadata: { card: hit.card, action: hit.action, execution: hit.execution },
-              provenance: [
-                {
-                  source: "vapi",
-                  sourceUrl: config2.marketplaceDiscoveryUrl,
-                  ref: hit.ref
-                }
-              ]
-            };
+            return mirroredListing(hit, config2);
           }
           try {
             const endpoint = await resolveServiceEndpoint(hit.ref, config2, fetchImpl);
-            return endpointListing(endpoint, hit.ref, config2, {
-              card: hit.card,
-              action: hit.action,
-              execution: hit.execution,
-              registryProvenance: hit.provenance
-            });
+            return endpointListing(
+              endpoint,
+              hit.ref,
+              config2,
+              {
+                card: hit.card,
+                action: hit.action,
+                execution: hit.execution,
+                registryProvenance: hit.provenance
+              },
+              hit.verification
+            );
           } catch (error61) {
             if (!(error61 instanceof DiscoveryCatalogError)) throw error61;
             return null;
@@ -20775,31 +20829,20 @@ function vapiRegistrySource(baseUrl, options = {}) {
     },
     async inspect(ref) {
       try {
-        const endpoint = await resolveServiceEndpoint(ref, config2, fetchImpl);
-        return endpointListing(endpoint, ref, config2);
+        const { endpoint, service } = await resolveServiceListing(ref, config2, fetchImpl);
+        return endpointListing(endpoint, ref, config2, {}, service.verification);
       } catch (resolutionError) {
         if (!(resolutionError instanceof DiscoveryCatalogError) || resolutionError.code !== "service_not_found") {
           throw resolutionError;
         }
-        const page = await searchMarketplace({ query: ref, kinds: ["api"] }, config2, fetchImpl);
+        const page = await searchMarketplace(
+          { query: ref, kinds: ["api"], includeUnverified: true },
+          config2,
+          fetchImpl
+        );
         const hit = page.items.find((item) => item.kind === "api" && item.ref === ref);
         if (hit?.kind === "api" && hit.provenance === "indexed") {
-          return {
-            resource: { url: hit.execution.url, description: hit.card.summary },
-            name: hit.card.title,
-            description: hit.card.summary,
-            ...hit.execution.method === null ? {} : { method: hit.execution.method },
-            network: hit.execution.network,
-            ...optionalPrice(hit.card.facts),
-            metadata: { card: hit.card, action: hit.action, execution: hit.execution },
-            provenance: [
-              {
-                source: "vapi",
-                sourceUrl: config2.marketplaceDiscoveryUrl,
-                ref: hit.ref
-              }
-            ]
-          };
+          return mirroredListing(hit, config2);
         }
         if (page.items.some((item) => item.kind === "api" && item.ref === ref)) {
           throw resolutionError;
@@ -20816,11 +20859,25 @@ async function fetchCallsDiscovery(query, config2, fetchImpl) {
     request: fetchImpl,
     configureUrl(url2) {
       url2.searchParams.set("q", query);
+      url2.searchParams.set("includeUnverified", "true");
     }
   });
   return parseDiscovery(await response.json());
 }
-function endpointListing(endpoint, ref, config2, metadata = {}) {
+function mirroredListing(hit, config2) {
+  return {
+    resource: { url: hit.execution.url, description: hit.card.summary },
+    name: hit.card.title,
+    description: hit.card.summary,
+    ...hit.execution.method === null ? {} : { method: hit.execution.method },
+    network: hit.execution.network,
+    ...optionalPrice(hit.card.facts),
+    verification: hit.verification,
+    metadata: { card: hit.card, action: hit.action, execution: hit.execution },
+    provenance: [{ source: "vapi", sourceUrl: config2.marketplaceDiscoveryUrl, ref: hit.ref }]
+  };
+}
+function endpointListing(endpoint, ref, config2, metadata = {}, verification) {
   return {
     resource: {
       url: endpoint.url,
@@ -20832,6 +20889,7 @@ function endpointListing(endpoint, ref, config2, metadata = {}) {
     method: endpoint.method,
     ...endpoint.payment?.network === void 0 ? {} : { network: endpoint.payment.network },
     price: endpoint.price,
+    ...verification === void 0 ? {} : { verification },
     metadata: {
       ...metadata,
       ...endpoint.operationId === void 0 ? {} : { operationId: endpoint.operationId },