@vapi-network/sources 0.3.0 → 0.7.0

package/README.md

@@ -10,5 +10,30 @@ 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.
+## Exports
+
+### Runtime exports
+
+| Name                      | What it is                                                                                                                                                         | Since            |
+| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------- |
+| `bazaarSource`            | function (facilitatorUrl: string, options: BazaarSourceOptions = {}): Source                                                                                       | 0.5.0 or earlier |
+| `findMarketplaceApiByRef` | function (ref: string, config: VapiRegistryConfig, fetchImpl?: Fetch): Promise<MarketplaceHit \| null>                                                             | 0.5.0 or earlier |
+| `localFileSource`         | function (path: string): Source                                                                                                                                    | 0.5.0 or earlier |
+| `mapBazaarItem`           | function (value: unknown, sourceUrl: string): Listing \| undefined                                                                                                 | 0.5.0 or earlier |
+| `resolveServiceEndpoint`  | function (id: string, config: VapiRegistryConfig, fetchImpl?: Fetch, endpointName?: string): Promise<DiscoveryEndpoint>                                            | 0.5.0 or earlier |
+| `resolveServiceListing`   | function (id: string, config: VapiRegistryConfig, fetchImpl?: Fetch, endpointName?: string): Promise<ResolvedListing>                                              | 0.5.0 or earlier |
+| `searchMarketplace`       | function (input: MarketplaceSearchInput, config: VapiRegistryConfig, fetchImpl?: Fetch, options: MarketplaceSearchOptions = {}): Promise<MarketplaceDiscoveryPage> | 0.5.0 or earlier |
+| `vapiRegistrySource`      | function (baseUrl: string, options: VapiRegistrySourceOptions = {}): Source                                                                                        | 0.5.0 or earlier |
+| `x402scanSource`          | function (): Source                                                                                                                                                | 0.5.0 or earlier |
+
+### Types
+
+| Name                        | What it is                                                                                                                                                                                                                              | Since            |
+| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------- |
+| `BazaarSourceOptions`       | type BazaarSourceOptions = GuardedSourceOptions                                                                                                                                                                                         | 0.5.0 or earlier |
+| `MarketplaceSearchInput`    | type MarketplaceSearchInput = { query?: string; kinds?: MarketplaceKind[]; network?: string; limit?: number; cursor?: string; includeUnverified?: boolean; }                                                                            | 0.5.0 or earlier |
+| `MarketplaceSearchOptions`  | type MarketplaceSearchOptions = Readonly<{ searchesPath?: string; now?: Date; nowMs?: () => number; notice?: (message: string) => void; }>                                                                                              | 0.5.0 or earlier |
+| `VapiRegistryConfig`        | type VapiRegistryConfig = Readonly<{ discoveryUrl: string; marketplaceDiscoveryUrl: string; registryFallbacks?: ReadonlyArray< Readonly<{ discoveryUrl: string; marketplaceDiscoveryUrl: string }> >; allowPrivateNetwork?: boolean; }> | 0.5.0 or earlier |
+| `VapiRegistrySourceOptions` | type VapiRegistrySourceOptions = GuardedSourceOptions & Readonly<{ discoveryUrl?: string; }>                                                                                                                                            | 0.5.0 or earlier |
+
+See the [root README](https://github.com/vAPI-Network/vapi-network/blob/main/docs/call.md) 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)
 });
 
@@ -20247,7 +20280,18 @@ var NETWORKS = {
     usdc: CANONICAL_X402_USDC_NETWORKS[BASE_MAINNET_CAIP2].usdc,
     gasToken: "ETH",
     rpcEnv: "BASE_RPC_URL",
-    publicRpcUrl: "https://mainnet.base.org"
+    publicRpcUrl: "https://mainnet.base.org",
+    explorerUrl: "https://basescan.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",
@@ -20340,7 +20384,8 @@ var configSchema = external_exports.object({
       }).optional()
     })
   ),
-  spendCaps: spendCapsSchema
+  spendCaps: spendCapsSchema,
+  device: external_exports.string().regex(/^[a-z0-9][a-z0-9-]{0,31}$/).optional()
 }).superRefine((config2, context) => {
   for (const [network, configured] of Object.entries(config2.networks)) {
     if (isSolanaNetwork(network)) {
@@ -20354,7 +20399,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 +20419,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 +20723,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 +20743,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 +20776,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 +20791,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 +20831,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 +20861,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 +20891,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 },