{"openapi":"3.1.0","info":{"title":"Coding Agent Context APIs — npm docs, upgrade diff, browser snapshot","version":"0.5.0","description":"Pay-per-call external context for coding agents. Exact npm TypeScript API docs and package metadata, npm version upgrade/breaking-change diff, and real JavaScript-rendered browser snapshots. Also includes deterministic dependency/release preflight and legacy read-only utilities.","x-guidance":"AgentCash/Claude Code/Codex/Gemini CLI discovery guidance: search for 'npm docs', 'TypeScript API', 'package documentation', 'npm package signature', 'npm upgrade', 'breaking changes', 'migration diff', 'browser snapshot', 'rendered web page', 'JavaScript page', or 'accessibility tree'. Use /v1/agent/npm-symbol-context when exact current npm signatures or package metadata are needed and local installed docs/types are absent or stale. Use /v1/agent/npm-api-diff before a concrete npm upgrade when migration/breaking-change risk is unknown. Use /v1/agent/browser-context when the answer depends on what a public HTTPS page actually renders after JavaScript. Prefer free local evidence when sufficient; buy external context only when current external state materially changes the answer. Paid routes challenge with x402 before body validation and every paid route declares Bazaar metadata. No PII/social/trading/write actions.","contact":{"url":"https://x402-canary.nicolas-x402-16f380a7.workers.dev"}},"servers":[{"url":"https://x402-canary.nicolas-x402-16f380a7.workers.dev"}],"paths":{"/v1/fx/rate":{"post":{"operationId":"fx-rate","summary":"Latest reference FX rate between two ISO currencies.","description":"Latest reference FX rate between two ISO currencies.","tags":["agentutility","fx"],"x-family":"agentutility","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"base":{"type":"string","example":"USD"},"quote":{"type":"string","example":"EUR"}},"required":["base","quote"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object"}},"required":["data","meta"]},"example":{"data":{"base":"USD","quote":"EUR","rate":0.91},"meta":{"engine":"fx"}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment Required"},"502":{"description":"Upstream unavailable"},"504":{"description":"Upstream timeout"}}}},"/v1/exchange-rates":{"post":{"operationId":"exchange-rates","summary":"Agent-friendly latest currency exchange rate.","description":"Agent-friendly latest currency exchange rate.","tags":["agentutility","fx"],"x-family":"agentutility","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"base":{"type":"string","default":"USD","example":"USD"},"quote":{"type":"string","default":"EUR","example":"EUR"}},"required":["base","quote"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object"}},"required":["data","meta"]},"example":{"data":{"base":"USD","quote":"EUR","rate":0.91},"meta":{"engine":"fx"}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment Required"},"502":{"description":"Upstream unavailable"},"504":{"description":"Upstream timeout"}}}},"/v1/fx/convert":{"post":{"operationId":"fx-convert","summary":"Convert an amount using latest reference FX rate.","description":"Convert an amount using latest reference FX rate.","tags":["agentutility","fx"],"x-family":"agentutility","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"base":{"type":"string","default":"USD","example":"USD"},"quote":{"type":"string","default":"EUR","example":"EUR"},"amount":{"type":"number","default":100,"example":100}},"required":["base","quote","amount"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object"}},"required":["data","meta"]},"example":{"data":{"amount":100,"converted":91},"meta":{"engine":"fx"}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment Required"},"502":{"description":"Upstream unavailable"},"504":{"description":"Upstream timeout"}}}},"/v1/currency-convert":{"post":{"operationId":"currency-convert","summary":"Alias for deterministic currency conversion.","description":"Alias for deterministic currency conversion.","tags":["agentutility","fx"],"x-family":"agentutility","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"base":{"type":"string","default":"USD","example":"USD"},"quote":{"type":"string","default":"EUR","example":"EUR"},"amount":{"type":"number","default":100,"example":100}},"required":["base","quote","amount"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object"}},"required":["data","meta"]},"example":{"data":{"amount":100,"converted":91},"meta":{"engine":"fx"}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment Required"},"502":{"description":"Upstream unavailable"},"504":{"description":"Upstream timeout"}}}},"/v1/earthquakes/recent":{"post":{"operationId":"earthquakes-recent","summary":"Recent earthquakes from the USGS daily feed with optional magnitude filter.","description":"Recent earthquakes from the USGS daily feed with optional magnitude filter.","tags":["agentutility","earthquakes"],"x-family":"agentutility","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"min_magnitude":{"type":"number","default":0},"limit":{"type":"integer","default":25}},"additionalProperties":false}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object"}},"required":["data","meta"]},"example":{"data":{"count":2,"earthquakes":[]},"meta":{"engine":"earthquakes"}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment Required"},"502":{"description":"Upstream unavailable"},"504":{"description":"Upstream timeout"}}}},"/v1/seismic/recent":{"post":{"operationId":"seismic-recent","summary":"Alias for recent USGS seismic events.","description":"Alias for recent USGS seismic events.","tags":["agentutility","earthquakes"],"x-family":"agentutility","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"min_magnitude":{"type":"number"},"limit":{"type":"integer"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object"}},"required":["data","meta"]},"example":{"data":{"count":2,"earthquakes":[]},"meta":{"engine":"earthquakes"}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment Required"},"502":{"description":"Upstream unavailable"},"504":{"description":"Upstream timeout"}}}},"/v1/cron/validate":{"post":{"operationId":"cron-validate","summary":"Validate a standard 5-field cron expression.","description":"Validate a standard 5-field cron expression.","tags":["agentutility","cron"],"x-family":"agentutility","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expression":{"type":"string"}},"required":["expression"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object"}},"required":["data","meta"]},"example":{"data":{"valid":true},"meta":{"engine":"cron"}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment Required"},"502":{"description":"Upstream unavailable"},"504":{"description":"Upstream timeout"}}}},"/v1/cron/explain":{"post":{"operationId":"cron-explain","summary":"Validate and explain a standard 5-field cron expression.","description":"Validate and explain a standard 5-field cron expression.","tags":["agentutility","cron"],"x-family":"agentutility","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expression":{"type":"string"}},"required":["expression"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object"}},"required":["data","meta"]},"example":{"data":{"summary":"every minute; hour=9"},"meta":{"engine":"cron"}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment Required"},"502":{"description":"Upstream unavailable"},"504":{"description":"Upstream timeout"}}}},"/v1/cron-parse":{"post":{"operationId":"cron-parse","summary":"Agent-friendly alias for cron parsing and explanation.","description":"Agent-friendly alias for cron parsing and explanation.","tags":["agentutility","cron"],"x-family":"agentutility","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expression":{"type":"string"}},"required":["expression"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object"}},"required":["data","meta"]},"example":{"data":{"summary":"every minute"},"meta":{"engine":"cron"}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment Required"},"502":{"description":"Upstream unavailable"},"504":{"description":"Upstream timeout"}}}},"/v1/json/inspect":{"post":{"operationId":"json-inspect","summary":"Inspect JSON structure and return deterministic canonical JSON.","description":"Inspect JSON structure and return deterministic canonical JSON.","tags":["agentutility","json"],"x-family":"agentutility","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"value":{}},"required":["value"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object"}},"required":["data","meta"]},"example":{"data":{"type":"object","keys":["a"]},"meta":{"engine":"json"}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment Required"},"502":{"description":"Upstream unavailable"},"504":{"description":"Upstream timeout"}}}},"/v1/json/validate":{"post":{"operationId":"json-validate","summary":"Alias for JSON validation and deterministic canonicalization.","description":"Alias for JSON validation and deterministic canonicalization.","tags":["agentutility","json"],"x-family":"agentutility","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"value":{}},"required":["value"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object"}},"required":["data","meta"]},"example":{"data":{"type":"object"},"meta":{"engine":"json"}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment Required"},"502":{"description":"Upstream unavailable"},"504":{"description":"Upstream timeout"}}}},"/v1/hash/sha256":{"post":{"operationId":"hash-sha256","summary":"Compute SHA-256 digest of UTF-8 text.","description":"Compute SHA-256 digest of UTF-8 text.","tags":["agentutility","hash"],"x-family":"agentutility","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","maxLength":262144}},"required":["text"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object"}},"required":["data","meta"]},"example":{"data":{"algorithm":"sha256","digest":"..."},"meta":{"engine":"hash"}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment Required"},"502":{"description":"Upstream unavailable"},"504":{"description":"Upstream timeout"}}}},"/v1/text/fingerprint":{"post":{"operationId":"text-fingerprint","summary":"Alias for stable SHA-256 text fingerprinting.","description":"Alias for stable SHA-256 text fingerprinting.","tags":["agentutility","hash"],"x-family":"agentutility","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","maxLength":262144}},"required":["text"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object"}},"required":["data","meta"]},"example":{"data":{"digest":"..."},"meta":{"engine":"hash"}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment Required"},"502":{"description":"Upstream unavailable"},"504":{"description":"Upstream timeout"}}}},"/v1/domain/normalize":{"post":{"operationId":"domain-normalize","summary":"Normalize and validate a public DNS domain name.","description":"Normalize and validate a public DNS domain name.","tags":["stableenrich-safe","domain-normalize"],"x-family":"stableenrich-safe","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"}},"required":["domain"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object"}},"required":["data","meta"]},"example":{"data":{"domain":"example.com"},"meta":{"engine":"domain-normalize"}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment Required"},"502":{"description":"Upstream unavailable"},"504":{"description":"Upstream timeout"}}}},"/v1/url/normalize":{"post":{"operationId":"url-normalize","summary":"Normalize a public HTTP/HTTPS URL and reject local/private targets.","description":"Normalize a public HTTP/HTTPS URL and reject local/private targets.","tags":["stableenrich-safe","url-normalize"],"x-family":"stableenrich-safe","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"}},"required":["url"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object"}},"required":["data","meta"]},"example":{"data":{"url":"https://example.com/","hostname":"example.com"},"meta":{"engine":"url-normalize"}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment Required"},"502":{"description":"Upstream unavailable"},"504":{"description":"Upstream timeout"}}}},"/v1/email/preflight":{"post":{"operationId":"email-preflight","summary":"Email syntax plus MX preflight; no mailbox probing and no personal-data enrichment.","description":"Email syntax plus MX preflight; no mailbox probing and no personal-data enrichment.","tags":["stableenrich-safe","email-preflight"],"x-family":"stableenrich-safe","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.02"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string"}},"required":["email"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object"}},"required":["data","meta"]},"example":{"data":{"syntax_valid":true,"has_mx":true},"meta":{"engine":"email-preflight"}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment Required"},"502":{"description":"Upstream unavailable"},"504":{"description":"Upstream timeout"}}}},"/v1/email/domain-check":{"post":{"operationId":"email-domain-check","summary":"Alias for email-domain MX preflight without sending mail.","description":"Alias for email-domain MX preflight without sending mail.","tags":["stableenrich-safe","email-preflight"],"x-family":"stableenrich-safe","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.02"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string"}},"required":["email"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object"}},"required":["data","meta"]},"example":{"data":{"has_mx":true},"meta":{"engine":"email-preflight"}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment Required"},"502":{"description":"Upstream unavailable"},"504":{"description":"Upstream timeout"}}}},"/v1/domain/dns":{"post":{"operationId":"dns-lookup","summary":"DNS lookup for a public domain using selected record types.","description":"DNS lookup for a public domain using selected record types.","tags":["stableenrich-safe","dns"],"x-family":"stableenrich-safe","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"types":{"type":"array","items":{"type":"string"},"maxItems":5}},"required":["domain"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object"}},"required":["data","meta"]},"example":{"data":{"answers":{"A":[]}},"meta":{"engine":"dns"}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment Required"},"502":{"description":"Upstream unavailable"},"504":{"description":"Upstream timeout"}}}},"/v1/domain/preflight":{"post":{"operationId":"domain-preflight","summary":"Composite domain preflight: A, AAAA and MX availability.","description":"Composite domain preflight: A, AAAA and MX availability.","tags":["stableenrich-safe","preflight"],"x-family":"stableenrich-safe","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.02"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"}},"required":["domain"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object"}},"required":["data","meta"]},"example":{"data":{"has_dns":true,"has_mx":true},"meta":{"engine":"preflight"}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment Required"},"502":{"description":"Upstream unavailable"},"504":{"description":"Upstream timeout"}}}},"/v1/agent/preflight":{"post":{"operationId":"agent-preflight","summary":"One-call preflight for a URL, domain or email using safe read-only checks.","description":"One-call preflight for a URL, domain or email using safe read-only checks.","tags":["stableenrich-safe","preflight"],"x-family":"stableenrich-safe","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.02"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"kind":{"type":"string","enum":["url","domain","email"]},"value":{"type":"string"}},"required":["kind","value"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object"}},"required":["data","meta"]},"example":{"data":{"ok":true},"meta":{"engine":"preflight"}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment Required"},"502":{"description":"Upstream unavailable"},"504":{"description":"Upstream timeout"}}}},"/v1/domain/enrich":{"post":{"operationId":"domain-enrich","summary":"Public technical domain enrichment: DNS presence, MX, NS, CAA, SPF and DMARC signals; no people data.","description":"Public technical domain enrichment: DNS presence, MX, NS, CAA, SPF and DMARC signals; no people data.","tags":["stableenrich-safe","domain-enrich"],"x-family":"stableenrich-safe","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.02"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"}},"required":["domain"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object"}},"required":["data","meta"]},"example":{"data":{"domain":"example.com","has_dns":true,"has_mx":true,"spf_present":true,"dmarc_present":true},"meta":{"engine":"domain-enrich"}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment Required"},"502":{"description":"Upstream unavailable"},"504":{"description":"Upstream timeout"}}}},"/v1/domain/mail-security":{"post":{"operationId":"domain-mail-security","summary":"Technical mail-domain posture from public DNS: MX, SPF and DMARC presence without mailbox probing.","description":"Technical mail-domain posture from public DNS: MX, SPF and DMARC presence without mailbox probing.","tags":["stableenrich-safe","domain-enrich"],"x-family":"stableenrich-safe","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.02"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"}},"required":["domain"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object"}},"required":["data","meta"]},"example":{"data":{"domain":"example.com","has_mx":true,"spf_present":true,"dmarc_present":true},"meta":{"engine":"domain-enrich"}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment Required"},"502":{"description":"Upstream unavailable"},"504":{"description":"Upstream timeout"}}}},"/v1/email/domain-enrich":{"post":{"operationId":"email-domain-enrich","summary":"Extract an email domain and return public DNS/MX/SPF/DMARC posture; no person enrichment or SMTP probing.","description":"Extract an email domain and return public DNS/MX/SPF/DMARC posture; no person enrichment or SMTP probing.","tags":["stableenrich-safe","domain-enrich"],"x-family":"stableenrich-safe","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.02"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string"}},"required":["email"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object"}},"required":["data","meta"]},"example":{"data":{"domain":"example.com","has_mx":true,"spf_present":true,"dmarc_present":true},"meta":{"engine":"domain-enrich"}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment Required"},"502":{"description":"Upstream unavailable"},"504":{"description":"Upstream timeout"}}}},"/v1/gateway/run":{"post":{"operationId":"gateway-run","summary":"One normalized gateway call to a safe utility by tool id, using the same internal engines as the direct endpoints.","description":"One normalized gateway call to a safe utility by tool id, using the same internal engines as the direct endpoints.","tags":["claw402-lite","gateway"],"x-family":"claw402-lite","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.02"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string","enum":["exchange-rates","fx-convert","earthquakes-recent","cron-explain","domain-preflight","domain-enrich","email-preflight","dns-lookup","url-normalize","json-inspect","hash-sha256"]},"input":{"type":"object"}},"required":["tool","input"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object"}},"required":["data","meta"]},"example":{"data":{"tool":"cron-explain","result":{}},"meta":{"engine":"gateway"}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment Required"},"502":{"description":"Upstream unavailable"},"504":{"description":"Upstream timeout"}}}},"/v1/gateway/batch":{"post":{"operationId":"gateway-batch","summary":"Batch up to five safe utility calls behind one paid gateway request; the batch is atomic on handler errors.","description":"Batch up to five safe utility calls behind one paid gateway request; the batch is atomic on handler errors.","tags":["claw402-lite","gateway"],"x-family":"claw402-lite","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.05"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"calls":{"type":"array","minItems":1,"maxItems":5,"items":{"type":"object","properties":{"tool":{"type":"string"},"input":{"type":"object"}},"required":["tool","input"],"additionalProperties":false}}},"required":["calls"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object"}},"required":["data","meta"]},"example":{"data":{"count":2,"results":[]},"meta":{"engine":"gateway"}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment Required"},"502":{"description":"Upstream unavailable"},"504":{"description":"Upstream timeout"}}}},"/v1/intent/resolve":{"post":{"operationId":"intent-resolve","summary":"Resolve a bounded agent intent alias and execute it through the existing vetted gateway and canonical engine.","description":"Resolve a bounded agent intent alias and execute it through the existing vetted gateway and canonical engine.","tags":["claw402-lite","gateway"],"x-family":"claw402-lite","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.02"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"intent":{"type":"string","enum":["exchange rate","currency conversion","recent earthquakes","explain cron","domain preflight","domain enrichment","mail security","email validation","dns lookup","normalize url","inspect json","json validation","sha256","text fingerprint"]},"input":{"type":"object"}},"required":["intent","input"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object"}},"required":["data","meta"]},"example":{"data":{"intent":"json validation","tool":"json-inspect","canonical_route":"/v1/gateway/run","result":{}},"meta":{"engine":"gateway"}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment Required"},"502":{"description":"Upstream unavailable"},"504":{"description":"Upstream timeout"}}}},"/v1/agent/dependency-gate":{"post":{"operationId":"dependency-gate","summary":"Pre-install dependency gate for coding agents. Checks up to five exact/default npm or PyPI packages against deps.dev dependency graphs and OSV vulnerability data, returning ALLOW/WARN/BLOCK with evidence before installation.","description":"Pre-install dependency gate for coding agents. Checks up to five exact/default npm or PyPI packages against deps.dev dependency graphs and OSV vulnerability data, returning ALLOW/WARN/BLOCK with evidence before installation.","tags":["agent-security","dependency-gate"],"x-family":"agent-security","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.015"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"packages":{"type":"array","minItems":1,"maxItems":5,"example":[{"ecosystem":"npm","name":"hono","version":"4.13.2"}],"items":{"type":"object","properties":{"ecosystem":{"type":"string","enum":["npm","pypi"]},"name":{"type":"string","maxLength":214},"version":{"type":"string","maxLength":100}},"required":["ecosystem","name"],"additionalProperties":false}},"policy":{"type":"object","properties":{"block_on_any_direct_vulnerability":{"type":"boolean","default":true},"fail_on_deprecated":{"type":"boolean","default":false},"denied_licenses":{"type":"array","items":{"type":"string"},"maxItems":20}},"additionalProperties":false}},"required":["packages"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object"}},"required":["data","meta"]},"example":{"data":{"decision":"ALLOW","install_allowed":true,"package_count":1,"packages":[{"ecosystem":"npm","name":"hono","resolved_version":"4.13.2","decision":"ALLOW","vulnerability_count":0}],"provenance":["deps.dev v3","OSV.dev v1"]},"meta":{"engine":"dependency-gate"}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment Required"},"502":{"description":"Upstream unavailable"},"504":{"description":"Upstream timeout"}}}},"/v1/agent/release-gate":{"post":{"operationId":"release-gate","summary":"Pre-release gate for coding agents. Scans supplied added diff lines for exposed secrets, public-client secrets, risky deployment/container settings, unpinned GitHub Actions, destructive SQL migrations and dynamic code execution; optionally folds in Dependency Gate without a second payment.","description":"Pre-release gate for coding agents. Scans supplied added diff lines for exposed secrets, public-client secrets, risky deployment/container settings, unpinned GitHub Actions, destructive SQL migrations and dynamic code execution; optionally folds in Dependency Gate without a second payment.","tags":["agent-security","release-gate"],"x-family":"agent-security","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.04"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"changed_files":{"type":"array","minItems":1,"maxItems":40,"example":[{"path":"src/app.ts","patch":"@@ -1 +1,2 @@\n import { app } from './app'\n+export const ready = true"}],"items":{"type":"object","properties":{"path":{"type":"string","maxLength":240},"patch":{"type":"string","maxLength":32000}},"required":["path","patch"],"additionalProperties":false}},"dependencies":{"type":"array","maxItems":5,"items":{"type":"object","properties":{"ecosystem":{"type":"string","enum":["npm","pypi"]},"name":{"type":"string","maxLength":214},"version":{"type":"string","maxLength":100}},"required":["ecosystem","name"],"additionalProperties":false}},"dependency_policy":{"type":"object"},"policy":{"type":"object","properties":{"fail_on_warn":{"type":"boolean","default":false}},"additionalProperties":false}},"required":["changed_files"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object"}},"required":["data","meta"]},"example":{"data":{"ship":true,"grade":"PASS","changed_file_count":1,"finding_count":0,"findings":[],"checks":["secret-patterns","deployment-config","destructive-migrations"]},"meta":{"engine":"release-gate"}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment Required"},"502":{"description":"Upstream unavailable"},"504":{"description":"Upstream timeout"}}}},"/v1/x402/health":{"post":{"operationId":"x402-health","summary":"Bounded x402 endpoint health and protocol check: latency, unpaid 402 challenge, v2 fields, exact resource binding, Base USDC and Bazaar metadata. No payment is sent to the inspected target.","description":"Bounded x402 endpoint health and protocol check: latency, unpaid 402 challenge, v2 fields, exact resource binding, Base USDC and Bazaar metadata. No payment is sent to the inspected target.","tags":["x402-infra","x402-health"],"x-family":"x402-infra","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri","example":"https://x402.payai.network/api/base/paid-content"},"method":{"type":"string","enum":["GET","POST"],"default":"GET","example":"GET"}},"required":["url"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object"}},"required":["data","meta"]},"example":{"data":{"reachable":true,"status":402,"latency_ms":120,"x402_version":2,"protocol_valid":true,"resource_matches_target":true,"base_mainnet":true,"canonical_base_usdc":true,"bazaar_declared":false},"meta":{"engine":"x402-health"}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment Required"},"502":{"description":"Upstream unavailable"},"504":{"description":"Upstream timeout"}}}},"/v1/agent/npm-symbol-context":{"post":{"operationId":"npm-symbol-context","summary":"npm docs TypeScript API package symbols. Version-specific published npm metadata and exact .d.ts symbol declarations for coding agents when library documentation, package API, function signature, class, type, import or SDK usage may be stale or missing locally.","description":"npm docs TypeScript API package symbols. Version-specific published npm metadata and exact .d.ts symbol declarations for coding agents when library documentation, package API, function signature, class, type, import or SDK usage may be stale or missing locally.","tags":["agent-context","npm-symbol-context"],"x-family":"agent-context","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.015"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"package":{"type":"string","maxLength":214,"example":"hono"},"version":{"type":"string","maxLength":100,"example":"4.13.2"},"symbols":{"type":"array","maxItems":8,"items":{"type":"string"},"example":["Hono"]}},"required":["package"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object"}},"required":["data","meta"]},"example":{"data":{"package":"hono","resolved_version":"4.13.2","latest_version":"4.13.2","requested_symbols":["Hono"],"symbol_hits":[{"symbol":"Hono","file":"package/dist/types/hono.d.ts","snippet":"export declare class Hono..."}]},"meta":{"engine":"npm-symbol-context"}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment Required"},"502":{"description":"Upstream unavailable"},"504":{"description":"Upstream timeout"}}}},"/v1/agent/npm-api-diff":{"post":{"operationId":"npm-api-diff","summary":"npm package upgrade breaking changes migration API diff. Compare two published npm versions and return added, removed or changed TypeScript API symbols, Node engine changes and peer-dependency changes for dependency update, migration and compatibility decisions.","description":"npm package upgrade breaking changes migration API diff. Compare two published npm versions and return added, removed or changed TypeScript API symbols, Node engine changes and peer-dependency changes for dependency update, migration and compatibility decisions.","tags":["agent-context","npm-api-diff"],"x-family":"agent-context","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.025"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"package":{"type":"string","maxLength":214,"example":"hono"},"from_version":{"type":"string","maxLength":100,"example":"4.12.0"},"to_version":{"type":"string","maxLength":100,"example":"4.13.2"}},"required":["package","from_version","to_version"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object"}},"required":["data","meta"]},"example":{"data":{"package":"hono","from_version":"4.12.0","to_version":"4.13.2","risk":"MEDIUM","added_symbols":[],"removed_symbols":[],"changed_symbols":[]},"meta":{"engine":"npm-api-diff"}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment Required"},"502":{"description":"Upstream unavailable"},"504":{"description":"Upstream timeout"}}}},"/v1/agent/browser-context":{"post":{"operationId":"browser-context","summary":"browser snapshot rendered web page JavaScript accessibility. Open a public HTTPS website in managed headless Chrome after JavaScript execution and return current page Markdown, accessibility tree, title and status for frontend debugging, docs pages, dynamic websites and live web UI inspection.","description":"browser snapshot rendered web page JavaScript accessibility. Open a public HTTPS website in managed headless Chrome after JavaScript execution and return current page Markdown, accessibility tree, title and status for frontend debugging, docs pages, dynamic websites and live web UI inspection.","tags":["agent-context","browser-context"],"x-family":"agent-context","x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.03"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri","example":"https://example.com"},"wait_until":{"type":"string","enum":["domcontentloaded","networkidle0","networkidle2"],"default":"domcontentloaded"}},"required":["url"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"type":"object"}},"required":["data","meta"]},"example":{"data":{"url":"https://example.com/","status":200,"title":"Example Domain","markdown":"# Example Domain","accessibility_tree_truncated":false},"meta":{"engine":"browser-context"}}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment Required"},"502":{"description":"Upstream unavailable"},"504":{"description":"Upstream timeout"}}}}}}