Merge pull request #755 from Merit-Systems/br/bump-discovery-1.5.0

Bump @agentcash/discovery to 1.5.0, adopt structured x-payment-info

Author: zdql

apps/scan/package.json

@@ -21,7 +21,7 @@
     "format:check": "pnpm -w format:check:dir ./apps/scan"
   },
   "dependencies": {
-    "@agentcash/discovery": "1.4.5",
+    "@agentcash/discovery": "1.5.0",
     "@agentcash/router": "1.2.5",
     "@ai-sdk/openai": "^2.0.52",
     "@ai-sdk/react": "^2.0.68",

apps/scan/src/app/(app)/(home)/integration-spec/discovery-strategy-panel.tsx

@@ -31,7 +31,7 @@ const strategies: Strategy[] = [
     requirements: [
       'Top-level fields: openapi, info.title, info.x-guidance, info.version, paths.',
       'For paid operations: responses.402 and x-payment-info.',
-      'Set x-payment-info.protocols and one pricing mode (fixed, range, quote).',
+      'Set x-payment-info.protocols and one pricing mode (fixed or dynamic).',
       'Use OpenAPI security + components.securitySchemes for auth declaration.',
       'Add high-level guidance in info.x-guidance for user-friendly discovery.',
     ],
@@ -44,8 +44,7 @@ const strategies: Strategy[] = [
         "responses": { "402": { "description": "Payment Required" } },
         "x-payment-info": {
           "protocols": ["x402"],
-          "pricingMode": "fixed",
-          "price": "0.05"
+          "price": { "mode": "fixed", "currency": "USD", "amount": "0.05" }
         }
       }
     }

apps/scan/src/app/(app)/(home)/integration-spec/page.tsx

@@ -41,11 +41,9 @@ Schema guidance (important):
 OpenAPI payable operation must include ALL:
 - x-payment-info with:
   - protocols: ["x402"]
-  - pricingMode + fields:
-    - fixed: { pricingMode: "fixed", price: "<amount>" }
-    - range: { pricingMode: "range", minPrice: "<min>", maxPrice: "<max>" }
-    - quote: { pricingMode: "quote" }
-  - IMPORTANT: for fixed pricing use "price" (not "amount")
+  - price (structured object):
+    - fixed: { mode: "fixed", currency: "USD", amount: "<amount>" }
+    - dynamic: { mode: "dynamic", currency: "USD", min: "<min>", max: "<max>" }
 - responses: { "402": { description: "Payment Required" } }
 
 /.well-known/x402 must be exactly:
@@ -57,7 +55,7 @@ OpenAPI payable operation must include ALL:
 
 Rules:
 - Runtime 402 behavior is authoritative over static metadata.
-- "amount" is for runtime accepts; "price" is for x-payment-info fixed pricing.
+- "amount" is for both runtime accepts and x-payment-info fixed pricing.
 
 Workflow:
 0) Install the agentcash MCP server:

docs/DISCOVERY.md

@@ -38,10 +38,9 @@ For each paid operation:
 - declare `x-payment-info`
 - include a `402` response in `responses`
 - include `x-payment-info.protocols` (for example `"x402"`)
-- include valid pricing metadata:
-  - `pricingMode: "fixed"` + `price`
-  - or `pricingMode: "range"` + `minPrice` + `maxPrice`
-  - or `pricingMode: "quote"`
+- include valid pricing metadata via `x-payment-info.price`:
+  - fixed: `{ mode: "fixed", currency: "USD", amount: "0.05" }`
+  - dynamic: `{ mode: "dynamic", currency: "USD", min: "0.01", max: "1.00" }`
 
 ### Auth requirements
 

evals/prompts/copy-for-agents-v3.txt

@@ -14,11 +14,9 @@ Schema guidance (important):
 OpenAPI payable operation must include ALL:
 - x-payment-info with:
   - protocols: ["x402"]
-  - pricingMode + fields:
-    - fixed: { pricingMode: "fixed", price: "<amount>" }
-    - range: { pricingMode: "range", minPrice: "<min>", maxPrice: "<max>" }
-    - quote: { pricingMode: "quote" }
-  - IMPORTANT: for fixed pricing use "price" (not "amount")
+  - price (structured object, canonical format):
+    - fixed: { mode: "fixed", currency: "USD", amount: "<amount>" }
+    - dynamic: { mode: "dynamic", currency: "USD", min: "<min>", max: "<max>" }
 - responses: { "402": { description: "Payment Required" } }
 
 /.well-known/x402 must be exactly:
@@ -30,7 +28,7 @@ OpenAPI payable operation must include ALL:
 
 Rules:
 - Runtime 402 behavior is authoritative over static metadata.
-- "amount" is for runtime accepts; "price" is for x-payment-info fixed pricing.
+- "amount" is for both runtime accepts and x-payment-info fixed pricing.
 
 Workflow:
 1) Audit discovery and probe failures.