Fresh402 Agent Intelligence

 ⟨35 unchanged words⟩  exclusions and exact JSON Pointer selection via json_pointer, or an ordered projection of up to8 fields via json_pointers (mutually exclusive; JSON only;only, missingany fieldsmissing returnfield 422returns422). One fetch/JSON parse with aggregate work/output limits. Omit json_pointer to retain full-document extraction. max_chars defaults ⟨179 unchanged words⟩ 

 ⟨47 unchanged words⟩ main","url":"https://example.com/docs"}],"not":{"required":["json_pointer","json_pointers"]},"properties":{"ignore_json_paths":{"description":"Optional  ⟨313 unchanged words⟩ [01])*)?$","type":"string"},"json_pointers":{"description":"Optional ordered1-8 unique exact JSON Pointers; mutually exclusive with json_pointer, JSON only. One fetch and JSON parse; exclusions run first. Any missing/excluded field fails the whole operation with422; null is a valid value. Returns data:[{pointer,value},...] and canonical aggregate text/hash. max_chars clips the aggregate; clipped data is omitted. Combined projection limited to200000 UTF-8 bytes and20000 nodes. Example:['/product/price','/product/stock'].","items":{"description":"One exact RFC6901 pointer: up to256 characters/64 segments; '' selects root, '/' the empty key, '~0'/'~1' escape '~'/'/'. Example:'/product/price'; '*' is literal.","maxLength":256,"pattern":"^(?:\\/(?:[^~]|~[01])*)?$","type":"string"},"maxItems":8,"minItems":1,"type":"array","uniqueItems":true},"max_chars":{"default":20000,"description" ⟨159 unchanged words⟩ 

Detect structuralbounded directional compatibility changesevidence in a public JSON OpenAPI 3.0/3.1OpenAPI3.0/3.1 contract: pathspaths/methods, methodsrequired fields, parameterssupported scalar type/enum/null domains, requestand requirementseffective authentication alternatives/scopes. Request acceptance and response schemas.guarantees have opposite compatibility directions. Complex schema composition, custom dialects, ambiguous visibility and unexpanded references remain review/unknown; no general satisfiability or compatibility proof. Use for API contract review; Smart Diff is ⟨213 unchanged words⟩ 

 ⟨29 unchanged words⟩ for Check. Required url plus optional CSS/JSON exclusions and opt-in html_attributes identify the watch; changing rules creates a different  ⟨71 unchanged words⟩ 

 ⟨63 unchanged words⟩ ":"https://example.com/docs"}],"properties":{"html_attributes":{"description":"Optional HTML-only watch rule: up to4 of href,title,alt,aria-label; default[] retains existing text-only normalization. Distinct names are sorted; nonempty rules create a separate version1 watch/baseline. Records bounded meaningful attributes within the saved selector or filtered page, including same-text link destination changes. Cannot be supplied with watch_id, even[]. Unsafe hrefs are hashed, never fetched. Limits:200 elements,2048 characters/value,32768 evidence bytes; excess fails, never clips silently.","items":{"description":"One explicitly observed HTML attribute: href (a/area only),title,alt or aria-label. No class/style/event attributes; links are inert evidence and never fetched.","enum":["alt","aria-label","href","title"],"type":"string"},"maxItems":4,"type":"array"},"ignore_json_paths":{"description":"Optional array of up ⟨258 unchanged words⟩ 

 ⟨50 unchanged words⟩ it when the same-watch snapshot is retained. Up toto200 200content changes; legacyexplicit json_array_keys match unique typed item identities and report moves separately, with pure reorder unchanged and source hashes still order-sensitive. Saved html_attributes rules compare selected links/attributes independently of visible text. Omit new options for existing index/text behavior. Legacy HTML may have text-only fidelity. No LLM,  ⟨166 unchanged words⟩ 

 ⟨112 unchanged words⟩ ,"baseline"],"type":"string"},"json_array_keys":{"description":"Optional1-4 explicit nonoverlapping JSON array identity rules, JSON only. Omit for existing index comparison. Matches unique typed scalar keys, reports moves separately from content changes; pure reorder is changed:false while source hashes remain order-sensitive. At most2000 combined array items/20000 comparison work units, no fallback for ambiguity. Rules affect this comparison only, not the watch/hash; persist identical input for payment recovery. Example:[{path:'/items',key:'/id'}].","items":{"additionalProperties":false,"description":"Explicit JSON array identity rule. Both paths must resolve; missing/duplicate/invalid identities fail422 without index fallback. Source snapshot ordering/hash is retained.","properties":{"key":{"description":"Nonempty exact RFC6901 pointer within each object item, up to256 characters/64 segments; e.g.'/id' or '/product/sku'. Every key must exist and be a unique nonempty string<=256 characters or safe integer; number1 differs from string'1'.","maxLength":256,"minLength":1,"pattern":"^(?:\\/(?:[^~]|~[01])*)?$","type":"string"},"path":{"description":"Exact RFC6901 pointer to an array on both compared JSON documents, up to256 characters/64 segments. Empty string selects a root array. Example:'/items'; no wildcards or automatic ID guessing.","maxLength":256,"pattern":"^(?:\\/(?:[^~]|~[01])*)?$","type":"string"}},"required":["path","key"],"type":"object"},"maxItems":4,"minItems":1,"type":"array"},"previous_hash":{"description":"Optional explicit reference hash ⟨119 unchanged words⟩ 

 ⟨279 unchanged words⟩  embedded credentials, private/local targets or authenticated pages. Fresh402's own service URLs, including its discovery /openapi.json, cannot be targets; choose an external public document. HTML, JSON and plain text are supported; JavaScript ⟨20 unchanged words⟩ 

 ⟨121 unchanged words⟩ "fresh402/prepaid"] containing idempotency_key, tariff_version and max_credits. When root mpp_payments.enabled is true, native MPP EVM charge is another option at the same USDC price: use an authorized Base EIP-712 signer and official mppx client, org.paymentauth/credential metadata and a persisted private recovery token. MPP receipt: org.paymentauth/receipt; see docs/MPP.md. Never combine MPP, prepaid and x402. Discover packages at /v2/prepaid/plans; see docs/AGENT_PREPAID.md for browserless wallet enrollment, bounded early credits and recovery. Optional Circle Gateway x402 is available only when root circle_gateway.enabled is true. Use the GatewayWalletBatched quote, a funded Base Gateway EOA and a persisted private recovery token. Pending batches return 409; replay the original proof/input/token after 60 seconds. Results require Gateway confirmed/completed evidence; never mix providers. No Circle prepaid funding. See docs/CIRCLE_GATEWAY.md.

 ⟨116 unchanged words⟩ "fresh402/prepaid"] containing idempotency_key, tariff_version and max_credits. When root mpp_payments.enabled is true, native MPP EVM charge is another option at the same USDC price: use an authorized Base EIP-712 signer and official mppx client, org.paymentauth/credential metadata and a persisted private recovery token. MPP receipt: org.paymentauth/receipt; see docs/MPP.md. Never combine MPP, prepaid and x402. Discover packages at /v2/prepaid/plans; see docs/AGENT_PREPAID.md for browserless wallet enrollment, bounded early credits and recovery. Optional Circle Gateway x402 is available only when root circle_gateway.enabled is true. Use the GatewayWalletBatched quote, a funded Base Gateway EOA and a persisted private recovery token. Pending batches return 409; replay the original proof/input/token after 60 seconds. Results require Gateway confirmed/completed evidence; never mix providers. No Circle prepaid funding. See docs/CIRCLE_GATEWAY.md.

 ⟨99 unchanged words⟩  native-USDC payer, otherwise returns a payment challenge. Prepaid creditsAlternatively use separateprepaid credits through REST endpoints.or this MCP tool: X-Fresh402-API-Key in HTTP, with params._meta["fresh402/prepaid"] containing idempotency_key, tariff_version and max_credits. Never combine prepaid and x402. Discover packages at /v2/prepaid/plans; see docs/AGENT_PREPAID.md for browserless wallet enrollment, bounded early credits and recovery.

 ⟨94 unchanged words⟩  native-USDC payer, otherwise returns a payment challenge. Prepaid creditsAlternatively use separateprepaid credits through REST endpoints.or this MCP tool: X-Fresh402-API-Key in HTTP, with params._meta["fresh402/prepaid"] containing idempotency_key, tariff_version and max_credits. Never combine prepaid and x402. Discover packages at /v2/prepaid/plans; see docs/AGENT_PREPAID.md for browserless wallet enrollment, bounded early credits and recovery.

Extract mainreadable text, metadata, headings, public links and embedded JSON-LD from aone public URLHTTPS withoutdocument. executingUse JavaScript.to read static HTML, JSON andor plain text; no watch or prior registration is needed. Optional CSS scoping.scope $0.01and USDC.noise exclusions; max_chars defaults to 20000 and limits returned text, not fetch size. Does not render JavaScript, crawl links or compare versions. $0.010 USDC per call on Base mainnet (eip155:8453), requiring an x402-capable MCP payment client and funded native-USDC payer. An ordinary MCP client receives a payment challenge. Prepaid credits use separate REST endpoints.

{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false,"description":"Extract a required public URL without creating or requiring a watch. Optional content rules scope/remove noise; max_chars limits returned text and the two include flags control supplementary HTML data. Unknown fields are rejected.","examples":[{"include_links":true,"include_structured_data":false,"max_chars":20000,"selector":"main","url":"https://example.com/docs"}],"properties":{"ignore_json_paths":{"description":"Optional array of up to 20 JSON Pointer-style paths to remove before JSON normalization and hashing. Each must start with '/' and be 1-256 characters; supports '*' segments. Default: [] (no exclusions). JSON only. Example: ['/updated_at', '/items/*/request_id'].","items":{"description":"JSON Pointer-style path, 1-256 characters, starting with '/'. Decode '~0' as '~' and '~1' as '/'; '*' matches all object keys or array elements. Example: '/items/*/updated_at'.","maxLength":256,"minLength":1,"pattern":" ⟨5 unchanged words⟩ ,"type":"array"},"ignore_selectors":{"description":"Optional array of up to 20 CSS selectors (each 1-256 characters) to remove from HTML in addition to built-in noise filtering. Default: no extra exclusions ([]). HTML only; use ignore_json_paths for JSON. Example: ['.timestamp', '.ad'].","items":{"description":"HTML element(s) to remove before normalization: a supported CSS selector, 1-256 characters, e.g. '.timestamp' or 'nav'.","maxLength":256,"minLength":1,"type":" ⟨4 unchanged words⟩ array"},"include_links":{"default":true,"description":"Optional boolean, default true. Include bounded public links extracted from HTML. False returns an empty links array without changing normalized text or its hash. Does not crawl linked pages; JSON/plain text do not provide HTML links.","type":"boolean"},"include_structured_data":{"default":true,"description":"Optional boolean, default true. Include embedded JSON-LD extracted from HTML in structured_data. False returns an empty structured_data array. This does not control the parsed data field for a JSON document, and does not fetch external linked data.","

CompareDetect astructural registeredcompatibility changes in a public JSON OpenAPI 3.0/3.1 contract: againstpaths, itsmethods, baselineparameters, request requirements and response schemas. Use for API contract review; Smart Diff is for general documents. First register the contract URL with free fresh402_register, without selectors or ignore rules, then reuse watch_id. compare_to accepts previous snapshot.(default) Deterministicor structuralbaseline; compatibilityan evidence;available nosame-watch remoteprevious_hash referencesoverrides it. Limits include 256000 decoded document bytes, 100 paths and 500 operations. No YAML, external reference fetching, API-operation execution, LLM or LLM.complete compatibility guarantee. $0.020 USDC per call on Base mainnet (eip155:8453); requires an x402-capable MCP payment client and funded native-USDC payer, otherwise returns a payment challenge. Prepaid credits use separate REST endpoints.

{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false,"description":"Compare a registered, unfiltered public JSON OpenAPI 3.0/3.1 contract; watch_id is required, compare_to defaults to previous, and optional previous_hash overrides it. Bounded structural analysis, not a complete compatibility proof; no YAML, external reference fetching or execution of described API operations. Unknown fields are rejected.","properties":{"compare_to":{"default":"previous","description":"Optional mode: 'previous' (default) compares with the latest saved OpenAPI Contract Diff snapshot; 'baseline' uses its fixed saved baseline. Before contract history exists, the current registered watch state seeds the initial baseline. previous_hash overrides the mode. 'hash' appears only in results, not as an accepted input mode.","enum":["previous","baseline"],"type":"string"},"previous_hash":{"description":"Optional 64-character hexadecimal reference hash, case-insensitive. Prefer a hash returned by OpenAPI Contract Diff for this same watch, matching a retained contract snapshot or fixed baseline. The current registered core hash is also accepted as a fallback: without a matching contract snapshot, the fixed baseline (or registered state if no baseline exists) is used. Overrides compare_to; unavailable hashes return 404. Omit to use the selected mode.","pattern":"^[a-fA-F0-9]{64}$","type":"string"},"watch_id":{"description":"Required existing watch ID: 'w_' plus 32 lowercase hexadecimal characters. Obtain it with free fresh402_register or POST /v1/register using the public JSON OpenAPI 3.0/3.1 URL and no selector or ignore rules. Reuses the saved URL; do not pass url here. YAML, non-OpenAPI documents and scoped/filtered watches are unsupported. Illustrative IDs must be replaced.","pattern":"^w_[a-f0-9]{32}$"," ⟨6 unchanged words⟩ 

Create or retrieve a free persistent baseline.baseline Existingfor registrationspublic HTTPS HTML, JSON or plain text. Use before Smart Diff or OpenAPI Contract Diff, or to obtain a reusable watch_id/hash for Check. Required url plus optional CSS/JSON exclusions identify the watch; changing rules creates a different watch. Repeating the same registration returns existing state without fetching or refreshing it. Reuse the actual returned watch_id; never refetchinvent an ID. Registration is free ($0), subject to quotas, and requires no x402 payment client; subsequent comparison tools are paid. Check also accepts url directly and can create its watch during the target.paid call. No JavaScript execution.execution or background monitoring. For OpenAPI comparisons register the JSON contract without any content rules.

{"$schema":"https://json-schema.org/draft/2020-12/schema","description":"Register a free baseline using a required URL and optional content rules. The canonical URL plus rules identify the watch; changing rules creates a different watch. Repeating the same registration returns its existing watch_id/hash without fetching or refreshing it. Quotas apply. Reuse the returned watch_id in Check, Smart Diff or OpenAPI Contract Diff.","examples":[{"ignore_selectors":[".timestamp"],"selector":"main","url":"https://example.com/docs"}],"properties":{"ignore_json_paths":{"description":"Optional array of up to 20 JSON Pointer-style paths to remove before JSON normalization and hashing. Each must start with '/' and be 1-256 characters; supports '*' segments. Default: [] (no exclusions). JSON only. Example: ['/updated_at', '/items/*/request_id'].","items":{"description":"JSON Pointer-style path, 1-256 characters, starting with '/'. Decode '~0' as '~' and '~1' as '/'; '*' matches all object keys or array elements. Example: '/items/*/updated_at'.","maxLength":256,"minLength":1,"pattern":" ⟨5 unchanged words⟩ ,"type":"array"},"ignore_selectors":{"description":"Optional array of up to 20 CSS selectors (each 1-256 characters) to remove from HTML in addition to built-in noise filtering. Default: no extra exclusions ([]). HTML only; use ignore_json_paths for JSON. Example: ['.timestamp', '.ad'].","items":{"description":"HTML element(s) to remove before normalization: a supported CSS selector, 1-256 characters, e.g. '.timestamp' or 'nav'.","maxLength":256,"minLength":1,"type":" ⟨3 unchanged words⟩ ,"type":"array"},"selector":{"description":"Optional HTML scope: a supported CSS selector, 1-256 characters, e.g. 'main' or 'article .content'. Only matching text is normalized; no match returns 422. Omit to normalize the page after built-in noise removal. Not supported for JSON or plain text.","maxLength":256,"minLength":1,"type":"string"},"url":{"description":"Required absolute public HTTPS document URL, at most 4096 characters, e.g. 'https://example.com/docs'. Only port 443; no embedded credentials, private/local targets or authenticated pages. HTML, JSON and plain text are supported; JavaScript is not executed. DNS, redirect and size limits also apply.","format":"uri","maxLength":4096,"type ⟨5 unchanged words⟩ 

Compare a watch with itsExplain previousstructured Smartchanges Diffin snapshota orregistered fixedpublic baseline.document: JSON Pointer changes, HTML block changes and explaineddeterministic significance rules;hints. deterministicUse instead of Check when a changed/unchanged flag or short text diff is insufficient. First obtain watch_id with free fresh402_register; saved URL/rules are reused. compare_to is previous (default) or baseline; previous_hash overrides it when the same-watch snapshot is retained. Up to 200 changes; legacy HTML may have text-only fidelity. No LLM, noJavaScript LLM.rendering or complete API compatibility guarantee. $0.015 USDC.USDC per call on Base mainnet (eip155:8453); requires an x402-capable MCP payment client and funded native-USDC payer, otherwise returns a payment challenge. Prepaid credits use separate REST endpoints.

{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false,"description":"Compare a required existing watch against previous or baseline (default previous), or use previous_hash to override the mode. Fetches the current source using saved rules; no cache-age option. Truncated or incompatible legacy baselines can return 409; legacy HTML may have text-only fidelity. Unknown fields are rejected.","properties":{"compare_to":{"default":"previous","description":"Optional comparison mode: 'previous' (default) uses the latest Smart Diff snapshot, falling back to the current registered watch state on the first call. 'baseline' uses the fixed Smart Diff baseline, initially seeded from the earliest retained compatible watch snapshot. previous_hash overrides either mode. 'hash' is a result label, not an accepted input value.","enum":["previous","baseline"],"type":"string"},"previous_hash":{"description":"Optional explicit reference hash: 64 hexadecimal characters, case-insensitive, from this same watch's retained Smart Diff snapshot, fixed baseline or retained registration/Check snapshot. Overrides compare_to. Unknown or pruned hashes return 404; recent snapshot history is limited to 20 per store, with the fixed Smart Diff baseline retained separately. Omit for the selected mode.","pattern":"^[a-fA-F0-9]{64}$","type":"string"},"watch_id":{"description":"Required existing watch ID: 'w_' plus 32 lowercase hexadecimal characters, returned by free fresh402_register or POST /v1/register./v1/register Example(a IDsURL-based areCheck