@agentcash/discovery 0.1.1 → 0.1.3

package/README.md

@@ -75,6 +75,7 @@ import {
   auditContextHarness,
   discover,
   discoverDetailed,
+  validatePaymentRequiredDetailed,
   type HarnessClientId,
 } from '@agentcash/discovery';
 
@@ -96,8 +97,49 @@ const harness = await auditContextHarness({
   contextWindowTokens: 200000,
   compatMode: 'on',
 });
+
+const validation = validatePaymentRequiredDetailed(payload, {
+  compatMode: 'strict',
+  metadata: {
+    title: 'Example API',
+    description: 'Sample description',
+    favicon: 'https://example.com/favicon.ico',
+    ogImages: [{ url: 'https://example.com/og.png' }],
+  },
+});
 ```
 
+## MCP Adapter Contract
+
+This section is the canonical contract for MCP-facing discovery adapters:
+
+- `discoverForMcp(options)` for L2 resources + L4 guidance policy projection.
+- `inspectEndpointForMcp(options)` for L3 OpenAPI advisory projection.
+
+`discoverForMcp` guarantees:
+
+- `guidanceAvailable` is always present.
+- `guidanceTokens` is present when guidance exists.
+- `guidance` is included when `includeGuidance=true`, excluded when
+  `includeGuidance=false`, and auto-included under the token threshold when not
+  specified.
+
+`inspectEndpointForMcp` guarantees:
+
+- Spec-derived HTTP methods for the selected endpoint path.
+- Per-method advisory data: summary, estimated price, protocols, auth mode, and
+  input schema.
+
+Ownership boundary:
+
+- `@agentcash/discovery` owns discovery/advisory contracts.
+- Runtime probe truth (live 402 parsing/payment option extraction/divergence)
+  belongs to the `agentcash` MCP package.
+
+Reference integration boundary:
+
+- `https://github.com/Merit-Systems/agentcash/blob/main/packages/external/mcp/docs/discovery-boundary.md`
+
 ## Discovery Waterfall
 
 Default order:
@@ -113,6 +155,11 @@ Behavior:
 - `discover(...)` stops at first valid non-empty stage.
 - `discoverDetailed(...)` runs full waterfall and merges deterministically.
 
+Validation behavior:
+
+- `validatePaymentRequiredDetailed(...)` uses Coinbase `@x402/core` schemas as the structural base gate.
+- Product policy diagnostics (network/schema/metadata) are layered on top with stable issue codes.
+
 ## Compatibility Modes
 
 - `on` (default): legacy adapters enabled.
@@ -164,3 +211,7 @@ Output:
 ## Deeper Docs
 
 Architecture and planning artifacts live in `.claude/`.
+
+Validation design doc:
+
+- `docs/VALIDATION_DIAGNOSTICS_DESIGN_2026-03-03.md`

package/dist/cli.cjs

@@ -637,7 +637,7 @@ function renderJson(run, options) {
 }
 
 // src/mmm-enabled.ts
-var isMmmEnabled = () => "0.1.1".includes("-mmm");
+var isMmmEnabled = () => "0.1.3".includes("-mmm");
 
 // src/core/constants.ts
 var OPENAPI_PATH_CANDIDATES = ["/openapi.json", "/.well-known/openapi.json"];
@@ -2025,6 +2025,9 @@ async function runDiscovery({
   };
 }
 
+// src/validation/payment-required.ts
+var import_schemas = require("@x402/core/schemas");
+
 // src/harness.ts
 var INTENT_TRIGGERS = ["x402", "mpp", "pay for", "micropayment", "agentic commerce"];
 var CLIENT_PROFILES = {

package/dist/cli.js

@@ -611,7 +611,7 @@ function renderJson(run, options) {
 }
 
 // src/mmm-enabled.ts
-var isMmmEnabled = () => "0.1.1".includes("-mmm");
+var isMmmEnabled = () => "0.1.3".includes("-mmm");
 
 // src/core/constants.ts
 var OPENAPI_PATH_CANDIDATES = ["/openapi.json", "/.well-known/openapi.json"];
@@ -1999,6 +1999,9 @@ async function runDiscovery({
   };
 }
 
+// src/validation/payment-required.ts
+import { parsePaymentRequired } from "@x402/core/schemas";
+
 // src/harness.ts
 var INTENT_TRIGGERS = ["x402", "mpp", "pay for", "micropayment", "agentic commerce"];
 var CLIENT_PROFILES = {