Endpoints: 76,849MCP servers: 32,725Payout addresses: 3,825Paid calls: 6,134Letters: 84Defects: 3,888counted 4 min ago
teppi

Server definition

Hash
sha256:992efd5e79b3b4746b852ca63bf391fd891a852403d848181b7b2dc22eb326fa
What it is
What a remote MCP server returned when asked what it offers: 12 tools

The blob, as servednamed by its sha256

{ "instructions": null, "tools": [ { "description": "Compare explicit contracts:{before,after} JSON or bounded YAML 1.2 strings for CI without fetching or retaining source state, or seed/review a public JSON OpenAPI 3.0/3.1 URL against saved observations. Returns directional findings and a conservative CI verdict; YAML is supplied-pair only; no external-ref crawling or live API proof. Release Guardian review exposes stable finding/result IDs, directional rules, affected operations, bounded before/after excerpts, grouped evidence and conservative CI0/1/2. Seed/hash-unchanged observations explicitly report not_compared (CI2). Optional stored-source export_snapshot/baseline_snapshot carries private source context across sessions for the same principal/workflow/environment/scope,30days from observation; not financial authority. One fixed workflow charge; internal steps never create separate customer charges. Explicit API contracts pairs compare immediately without fetching or saved observation state; supplied before/after URNs identify canonical input hashes, not fetched URLs. First URL source use seeds state in this same operation; compatible source_watch_id adopts retained public Register evidence for a genuine first comparison with original scope/time, not ownership. For continuation, later observations use returned owned observation_id. State expires seven days after creation; reads/writes never extend it. Auth: authorized native-USDC x402 v2 on Base, enabled MPP, or an eligible prepaid key plus exact tariff 5 and max_credits. Ordinary unpaid calls return a challenge, not execution. Persist original input, proof and recovery token before submission; exact replay returns retained results without fresh work or another charge. Choose evidence detail before authorization. No free-trial or automatic paid fallback. 0.010 USDC or 4 credits. Limits and scope are authoritative, not a complete audit or compatibility guarantee. The same fixed x402 service price may also be paid in native Circle USDC on Solana Mainnet (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp), when advertised by the unpaid challenge. Explicitly select one accepted network and pin its mint, merchant, amount and sponsored fee payer before signing. Solana payers need no Base wallet; Standalone native Solana MPP solana/charge is also advertised; its client pays a separately authorized SOL network fee, with no server fee sponsorship. Prepaid MPP funding remains Base-only. Payment network does not change the observed chain: blockchain products still inspect finalized Base. Solana delivery requires finalized matching USDC evidence. Persist the original network, resource, input, proof and private recovery capability; never switch networks or authorize a replacement after uncertainty.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "oneOf": [ { "not": { "anyOf": [ { "required": [ "source_watch_id" ] }, { "required": [ "observation_id" ] }, { "required": [ "baseline_snapshot" ] }, { "required": [ "contracts" ] } ] }, "required": [ "url" ] }, { "not": { "anyOf": [ { "required": [ "url" ] }, { "required": [ "observation_id" ] }, { "required": [ "scope" ] }, { "required": [ "baseline_snapshot" ] }, { "required": [ "contracts" ] } ] }, "required": [ "source_watch_id" ] }, { "not": { "anyOf": [ { "required": [ "url" ] }, { "required": [ "source_watch_id" ] }, { "required": [ "scope" ] }, { "required": [ "baseline_snapshot" ] }, { "required": [ "contracts" ] } ] }, "required": [ "observation_id" ] }, { "not": { "anyOf": [ { "required": [ "url" ] }, { "required": [ "source_watch_id" ] }, { "required": [ "observation_id" ] }, { "required": [ "scope" ] }, { "required": [ "contracts" ] } ] }, "properties": { "compare_to": { "const": "previous" } }, "required": [ "baseline_snapshot" ] }, { "not": { "anyOf": [ { "required": [ "url" ] }, { "required": [ "source_watch_id" ] }, { "required": [ "observation_id" ] }, { "required": [ "baseline_snapshot" ] } ] }, "properties": { "compare_to": { "const": "previous" }, "export_snapshot": { "const": false } }, "required": [ "contracts" ] } ], "properties": { "baseline_snapshot": { "description": "Optional private caller-retained Fresh402 snapshot token, at most44,000 characters, as the sole source identity instead of url/source_watch_id/observation_id/contracts. Same verified billing principal, workflow, environment and immutable scope only; compare_to must be previous. Expires30days after source observation. Contains source evidence, not a payment capability or proof of current freshness. Tampered/foreign/expired tokens fail before fetching; never send them to analytics or public repositories.", "maxLength": 44000, "minLength": 1, "pattern": "^fs1\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]{43}$", "type": "string" }, "compare_to": { "default": "previous", "description": "Default previous compares with the latest successful workflow observation; baseline compares with its original seed. Seeding is one paid workflow operation and reports no comparison, never a second internal charge.", "enum": [ "previous", "baseline" ], "type": "string" }, "contracts": { "additionalProperties": false, "description": "Explicit CI comparison, exclusive with a stored source/watch. Combined contract text <=512,000 UTF-8 bytes; only these two supplied-OpenAPI products allow a complete HTTP/MCP envelope <=786,432 bytes, including JSON escaping and payment metadata. All parser, reference, work and output budgets still apply. No source fetches or saved observation; the original authorized operation remains durably recoverable.", "properties": { "after": { "description": "New complete OpenAPI 3.0/3.1 contract serialized as JSON or bounded YAML 1.2; at most 256,000 characters and 256,000 UTF-8 bytes, same restrictions as before. Direction is before to after; source authenticity and deployed behavior are not verified.", "maxLength": 256000, "minLength": 1, "type": "string" }, "before": { "description": "Old complete OpenAPI 3.0/3.1 contract serialized as JSON or bounded YAML 1.2; at most 256,000 characters and 256,000 UTF-8 bytes. Duplicate JSON names are rejected. YAML rejects anchors/aliases, tags, merges, duplicate or complex keys and nonfinite values. No executed code or remote-reference fetching.", "maxLength": 256000, "minLength": 1, "type": "string" } }, "required": [ "before", "after" ], "type": "object" }, "detail": { "default": "compact", "description": "Default compact: at most 20 evidence items per section. Expanded allows at most 200 document findings or 100 Base events and retains raw validated logs/getter ABI details within the same fixed work/output ceiling. Counts and omitted-evidence warnings remain explicit.", "enum": [ "compact", "expanded" ], "type": "string" }, "export_snapshot": { "description": "Optional, default false. Request a caller-retained integrity-protected snapshot of this operation's new source observation, within the existing paid workflow price. Supported only for Website Change Intelligence and stored-source API Compatibility Review. At most32,768 payload bytes/44,000 token characters; oversized evidence reports omitted_size without corrupting the main result. Expires30days after observation; seven-day server state and original financial recovery do not extend. Keep the token private.", "type": "boolean" }, "observation_id": { "description": "Owned observation_id returned by this same workflow. Reuses its immutable source/scope and saved baseline/latest observations; not a primitive watch_id. Seven-day state retention. Missing, foreign or expired IDs never silently rebaseline.", "pattern": "^wf_[a-f0-9]{64}$", "type": "string" }, "source_watch_id": { "description": "Adopt the current retained public Register observation as the prior baseline, with its exact immutable URL/scope and original timestamp. No baseline refetch or ownership grant. Exactly one of url, source_watch_id or observation_id; omit scope. Complete compatible normalizer-v2 evidence required; API review additionally requires unfiltered JSON OpenAPI. One paid new observation is compared; save returned owned observation_id for continuation. Missing/incomplete baselines fail explicitly, never silently reseed.", "pattern": "^w_[a-f0-9]{32}$", "type": "string" }, "url": { "description": "Public HTTPS source for a new or existing canonical source/scope identity. Exactly one of url, source_watch_id or observation_id. A new URL identity seeds once; the next operation compares.", "format": "uri", "maxLength": 4096, "pattern": "^[Hh][Tt][Tt][Pp][Ss]:\\/\\/", "type": "string" } }, "type": "object" }, "name": "fresh402_api_compatibility_review", "outputSchema": { "anyOf": [ { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "accounting": { "additionalProperties": {}, "description": "Actual bounded execution counters, not inferred model-token savings or a billing invoice.", "propertyNames": { "type": "string" }, "type": "object" }, "billing": { "additionalProperties": false, "properties": { "atomic_usdc": { "pattern": "^\\d+$", "type": "string" }, "credits": { "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "internal_charges": { "const": 0, "type": "number" }, "one_financial_operation": { "const": true, "type": "boolean" }, "tariff_version": { "const": 5, "type": "number" } }, "required": [ "internal_charges", "one_financial_operation", "tariff_version", "credits", "atomic_usdc" ], "type": "object" }, "completeness": { "additionalProperties": {}, "description": "Scope and uncertainty are authoritative; wallet history and independent provider consensus are never asserted.", "propertyNames": { "type": "string" }, "type": "object" }, "evidence": { "additionalProperties": false, "properties": { "api": { "additionalProperties": false, "properties": { "changed": { "type": [ "boolean", "null" ] }, "comparison": { "anyOf": [ { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, { "type": "null" } ] }, "comparison_executed": { "type": "boolean" }, "completeness": { "additionalProperties": {}, "description": "Explicit scope, omitted-evidence count and truncation; no browser or external-reference crawl. Warnings are deduplicated at the result root.", "propertyNames": { "type": "string" }, "type": "object" }, "evidence": { "description": "Bounded structural changes or directional API findings; API entries include classification, rule and JSON Pointer path. Counts survive compaction.", "items": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "maxItems": 200, "type": "array" }, "hash": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "previous_hash": { "anyOf": [ { "pattern": "^[a-f0-9]{64}$", "type": "string" }, { "type": "null" } ] }, "review": { "additionalProperties": false, "description": "Versioned Release Guardian evidence. Findings and excerpts are bounded; pointers refer to the full original result. A skipped comparator reports not_compared/CI2, never automatic approval. No customer code, live API behavior or deployment safety is established.", "properties": { "comparison_performed": { "type": "boolean" }, "complete": { "type": "boolean" }, "findings": { "items": { "additionalProperties": false, "properties": { "affected_path": { "type": "string" }, "after": { "type": [ "string", "null" ] }, "before": { "type": [ "string", "null" ] }, "compatibility_direction": { "enum": [ "request", "response", "authentication", "operation_or_shared" ], "type": "string" }, "complete": { "type": "boolean" }, "confidence": { "enum": [ "supported_rule", "requires_review" ], "type": "string" }, "evidence": { "additionalProperties": false, "properties": { "after_sha256": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "after_source_pointer": { "type": [ "string", "null" ] }, "before_sha256": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "before_source_pointer": { "type": [ "string", "null" ] }, "change_pointer": { "type": "string" }, "change_pointer_scope": { "const": "full_original_result", "type": "string" }, "excerpts_may_be_truncated": { "const": true, "type": "boolean" }, "source_pointer_scope": { "const": "parsed_original_contract_declaration", "type": "string" } }, "required": [ "change_pointer", "change_pointer_scope", "before_sha256", "after_sha256", "excerpts_may_be_truncated" ], "type": "object" }, "explanation": { "type": "string" }, "finding_id": { "pattern": "^cf_[a-f0-9]{64}$", "type": "string" }, "operations": { "items": { "type": "string" }, "maxItems": 8, "type": "array" }, "recommended_action": { "enum": [ "block_and_review", "inspect_with_other_findings", "manual_review" ], "type": "string" }, "rule_id": { "type": "string" }, "severity": { "enum": [ "error", "warning", "info" ], "type": "string" } }, "required": [ "finding_id", "rule_id", "severity", "compatibility_direction", "affected_path", "operations", "complete", "before", "after", "explanation", "evidence", "confidence", "recommended_action" ], "type": "object" }, "maxItems": 20, "type": "array" }, "findings_omitted": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "findings_total": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "groups": { "additionalProperties": { "items": { "type": "string" }, "maxItems": 20, "type": "array" }, "propertyNames": { "type": "string" }, "type": "object" }, "input_fingerprints": { "additionalProperties": false, "properties": { "after_sha256": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "before_sha256": { "anyOf": [ { "pattern": "^[a-f0-9]{64}$", "type": "string" }, { "type": "null" } ] } }, "required": [ "before_sha256", "after_sha256" ], "type": "object" }, "reason": { "enum": [ "baseline_seeded", "hash_unchanged" ], "type": "string" }, "result_id": { "pattern": "^review_[a-f0-9]{64}$", "type": "string" }, "schema": { "const": "fresh402-contract-review-v1", "type": "string" }, "scope": { "type": "string" }, "verdict": { "additionalProperties": false, "properties": { "ci_exit_code": { "anyOf": [ { "const": 0, "type": "number" }, { "const": 1, "type": "number" }, { "const": 2, "type": "number" } ] }, "live_api_verified": { "const": false, "type": "boolean" }, "scope": { "type": "string" }, "status": { "enum": [ "breaking", "review_required", "no_breaking_change_observed", "not_compared" ], "type": "string" }, "unsupported_features_require_review": { "const": true, "type": "boolean" } }, "required": [ "status", "ci_exit_code", "live_api_verified" ], "type": "object" } }, "required": [ "schema", "comparison_performed", "verdict", "input_fingerprints", "findings", "findings_total", "findings_omitted", "groups", "complete" ], "type": "object" }, "scope": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "status": { "enum": [ "baseline_seeded", "no_supported_contract_change", "unchanged_in_scope", "changed_in_scope", "review_required", "descriptive_only" ], "type": "string" }, "summary": { "anyOf": [ { "type": "string" }, { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" } ] } }, "required": [ "status", "changed", "scope", "hash", "previous_hash", "summary", "evidence", "comparison", "comparison_executed", "completeness" ], "type": "object" } }, "required": [ "api" ], "type": "object" }, "observation_id": { "pattern": "^wf_[a-f0-9]{64}$", "type": "string" }, "observed_at": { "type": "string" }, "persistence_error": { "type": "string" }, "portable_state": { "anyOf": [ { "additionalProperties": false, "properties": { "caller_retention_days": { "const": 30, "type": "number" }, "expires_at": { "type": "string" }, "observed_at": { "type": "string" }, "payload_bytes": { "maximum": 32768, "minimum": 0, "type": "integer" }, "payment_authority": { "const": false, "type": "boolean" }, "retention_extended": { "const": false, "type": "boolean" }, "server_retention_days": { "const": 7, "type": "number" }, "source_freshness_verified": { "const": false, "type": "boolean" }, "status": { "const": "available", "type": "string" }, "token": { "maxLength": 44000, "type": "string" } }, "required": [ "status", "token", "expires_at", "observed_at", "payload_bytes", "server_retention_days", "caller_retention_days", "retention_extended", "payment_authority", "source_freshness_verified" ], "type": "object" }, { "additionalProperties": false, "properties": { "max_payload_bytes": { "const": 32768, "type": "number" }, "retention_extended": { "const": false, "type": "boolean" }, "status": { "const": "omitted_size", "type": "string" } }, "required": [ "status", "max_payload_bytes", "retention_extended" ], "type": "object" } ], "description": "Opt-in private caller-retained source evidence, independently integrity-protected and bound to principal/workflow/environment/scope. Not encryption, payment authority, current freshness or an extension of original-result/server retention." }, "provenance": { "additionalProperties": false, "properties": { "api": { "additionalProperties": false, "properties": { "content_type": { "type": "string" }, "final_url": { "format": "uri", "type": "string" }, "observed_at": { "type": "string" }, "raw_source_hash": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "requested_url": { "format": "uri", "type": "string" } }, "required": [ "requested_url", "final_url", "raw_source_hash", "observed_at", "content_type" ], "type": "object" }, "portable_baseline": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "previous_observation": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "register_baseline": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "scope_identity": { "type": "string" }, "supplied_contracts": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" } }, "required": [ "api", "scope_identity" ], "type": "object" }, "snapshot_saved": { "type": "boolean" }, "state_expires_at": { "type": "string" }, "status": { "enum": [ "baseline_seeded", "no_supported_contract_change", "unchanged_in_scope", "changed_in_scope", "review_required", "descriptive_only", "evidence_ready" ], "type": "string" }, "summary": { "additionalProperties": {}, "description": "Task-level result; a seeded baseline is not a comparison, and evidence does not prove deployment or causation.", "properties": { "changed": { "type": [ "boolean", "null" ] }, "comparison": { "enum": [ "seeded", "previous", "baseline", "supplied", "portable" ], "type": "string" }, "consistency": { "const": "not_established", "type": "string" }, "findings": { "anyOf": [ { "type": "string" }, { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" } ] }, "release_label": { "type": "string" } }, "type": "object" }, "version": { "const": 1, "type": "number" }, "warnings": { "items": { "type": "string" }, "maxItems": 50, "type": "array" }, "workflow": { "const": "api_compatibility_review", "type": "string" }, "workflow_state_saved": { "type": "boolean" } }, "required": [ "workflow", "version", "status", "observed_at", "summary", "evidence", "provenance", "completeness", "warnings", "accounting", "billing" ], "type": "object" }, { "description": "Tool error only; accompanied by isError=true.", "properties": { "error": { "minLength": 1, "type": "string" }, "retryable": { "type": "boolean" }, "status": { "type": "integer" } }, "required": [ "error" ], "type": "object" }, { "description": "Unpaid x402 v2 quote only; accompanied by isError=true. No product execution or financial authorization.", "properties": { "accepts": { "minItems": 1, "type": "array" }, "resource": { "type": "object" }, "x402Version": { "const": 2 } }, "required": [ "x402Version", "accepts" ], "type": "object" } ], "description": "A successful tool execution follows the canonical result branch. isError=true denotes an error or unpaid payment challenge, never successful execution or payment. Inspect isError before interpreting structuredContent.", "properties": { "accounting": { "additionalProperties": {}, "description": "Actual bounded execution counters, not inferred model-token savings or a billing invoice.", "propertyNames": { "type": "string" }, "type": "object" }, "billing": { "additionalProperties": false, "properties": { "atomic_usdc": { "pattern": "^\\d+$", "type": "string" }, "credits": { "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "internal_charges": { "const": 0, "type": "number" }, "one_financial_operation": { "const": true, "type": "boolean" }, "tariff_version": { "const": 5, "type": "number" } }, "required": [ "internal_charges", "one_financial_operation", "tariff_version", "credits", "atomic_usdc" ], "type": "object" }, "completeness": { "additionalProperties": {}, "description": "Scope and uncertainty are authoritative; wallet history and independent provider consensus are never asserted.", "propertyNames": { "type": "string" }, "type": "object" }, "evidence": { "additionalProperties": false, "properties": { "api": { "additionalProperties": false, "properties": { "changed": { "type": [ "boolean", "null" ] }, "comparison": { "anyOf": [ { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, { "type": "null" } ] }, "comparison_executed": { "type": "boolean" }, "completeness": { "additionalProperties": {}, "description": "Explicit scope, omitted-evidence count and truncation; no browser or external-reference crawl. Warnings are deduplicated at the result root.", "propertyNames": { "type": "string" }, "type": "object" }, "evidence": { "description": "Bounded structural changes or directional API findings; API entries include classification, rule and JSON Pointer path. Counts survive compaction.", "items": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "maxItems": 200, "type": "array" }, "hash": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "previous_hash": { "anyOf": [ { "pattern": "^[a-f0-9]{64}$", "type": "string" }, { "type": "null" } ] }, "review": { "additionalProperties": false, "description": "Versioned Release Guardian evidence. Findings and excerpts are bounded; pointers refer to the full original result. A skipped comparator reports not_compared/CI2, never automatic approval. No customer code, live API behavior or deployment safety is established.", "properties": { "comparison_performed": { "type": "boolean" }, "complete": { "type": "boolean" }, "findings": { "items": { "additionalProperties": false, "properties": { "affected_path": { "type": "string" }, "after": { "type": [ "string", "null" ] }, "before": { "type": [ "string", "null" ] }, "compatibility_direction": { "enum": [ "request", "response", "authentication", "operation_or_shared" ], "type": "string" }, "complete": { "type": "boolean" }, "confidence": { "enum": [ "supported_rule", "requires_review" ], "type": "string" }, "evidence": { "additionalProperties": false, "properties": { "after_sha256": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "after_source_pointer": { "type": [ "string", "null" ] }, "before_sha256": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "before_source_pointer": { "type": [ "string", "null" ] }, "change_pointer": { "type": "string" }, "change_pointer_scope": { "const": "full_original_result", "type": "string" }, "excerpts_may_be_truncated": { "const": true, "type": "boolean" }, "source_pointer_scope": { "const": "parsed_original_contract_declaration", "type": "string" } }, "required": [ "change_pointer", "change_pointer_scope", "before_sha256", "after_sha256", "excerpts_may_be_truncated" ], "type": "object" }, "explanation": { "type": "string" }, "finding_id": { "pattern": "^cf_[a-f0-9]{64}$", "type": "string" }, "operations": { "items": { "type": "string" }, "maxItems": 8, "type": "array" }, "recommended_action": { "enum": [ "block_and_review", "inspect_with_other_findings", "manual_review" ], "type": "string" }, "rule_id": { "type": "string" }, "severity": { "enum": [ "error", "warning", "info" ], "type": "string" } }, "required": [ "finding_id", "rule_id", "severity", "compatibility_direction", "affected_path", "operations", "complete", "before", "after", "explanation", "evidence", "confidence", "recommended_action" ], "type": "object" }, "maxItems": 20, "type": "array" }, "findings_omitted": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "findings_total": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "groups": { "additionalProperties": { "items": { "type": "string" }, "maxItems": 20, "type": "array" }, "propertyNames": { "type": "string" }, "type": "object" }, "input_fingerprints": { "additionalProperties": false, "properties": { "after_sha256": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "before_sha256": { "anyOf": [ { "pattern": "^[a-f0-9]{64}$", "type": "string" }, { "type": "null" } ] } }, "required": [ "before_sha256", "after_sha256" ], "type": "object" }, "reason": { "enum": [ "baseline_seeded", "hash_unchanged" ], "type": "string" }, "result_id": { "pattern": "^review_[a-f0-9]{64}$", "type": "string" }, "schema": { "const": "fresh402-contract-review-v1", "type": "string" }, "scope": { "type": "string" }, "verdict": { "additionalProperties": false, "properties": { "ci_exit_code": { "anyOf": [ { "const": 0, "type": "number" }, { "const": 1, "type": "number" }, { "const": 2, "type": "number" } ] }, "live_api_verified": { "const": false, "type": "boolean" }, "scope": { "type": "string" }, "status": { "enum": [ "breaking", "review_required", "no_breaking_change_observed", "not_compared" ], "type": "string" }, "unsupported_features_require_review": { "const": true, "type": "boolean" } }, "required": [ "status", "ci_exit_code", "live_api_verified" ], "type": "object" } }, "required": [ "schema", "comparison_performed", "verdict", "input_fingerprints", "findings", "findings_total", "findings_omitted", "groups", "complete" ], "type": "object" }, "scope": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "status": { "enum": [ "baseline_seeded", "no_supported_contract_change", "unchanged_in_scope", "changed_in_scope", "review_required", "descriptive_only" ], "type": "string" }, "summary": { "anyOf": [ { "type": "string" }, { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" } ] } }, "required": [ "status", "changed", "scope", "hash", "previous_hash", "summary", "evidence", "comparison", "comparison_executed", "completeness" ], "type": "object" } }, "required": [ "api" ], "type": "object" }, "observation_id": { "pattern": "^wf_[a-f0-9]{64}$", "type": "string" }, "observed_at": { "type": "string" }, "persistence_error": { "type": "string" }, "portable_state": { "anyOf": [ { "additionalProperties": false, "properties": { "caller_retention_days": { "const": 30, "type": "number" }, "expires_at": { "type": "string" }, "observed_at": { "type": "string" }, "payload_bytes": { "maximum": 32768, "minimum": 0, "type": "integer" }, "payment_authority": { "const": false, "type": "boolean" }, "retention_extended": { "const": false, "type": "boolean" }, "server_retention_days": { "const": 7, "type": "number" }, "source_freshness_verified": { "const": false, "type": "boolean" }, "status": { "const": "available", "type": "string" }, "token": { "maxLength": 44000, "type": "string" } }, "required": [ "status", "token", "expires_at", "observed_at", "payload_bytes", "server_retention_days", "caller_retention_days", "retention_extended", "payment_authority", "source_freshness_verified" ], "type": "object" }, { "additionalProperties": false, "properties": { "max_payload_bytes": { "const": 32768, "type": "number" }, "retention_extended": { "const": false, "type": "boolean" }, "status": { "const": "omitted_size", "type": "string" } }, "required": [ "status", "max_payload_bytes", "retention_extended" ], "type": "object" } ], "description": "Opt-in private caller-retained source evidence, independently integrity-protected and bound to principal/workflow/environment/scope. Not encryption, payment authority, current freshness or an extension of original-result/server retention." }, "provenance": { "additionalProperties": false, "properties": { "api": { "additionalProperties": false, "properties": { "content_type": { "type": "string" }, "final_url": { "format": "uri", "type": "string" }, "observed_at": { "type": "string" }, "raw_source_hash": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "requested_url": { "format": "uri", "type": "string" } }, "required": [ "requested_url", "final_url", "raw_source_hash", "observed_at", "content_type" ], "type": "object" }, "portable_baseline": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "previous_observation": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "register_baseline": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "scope_identity": { "type": "string" }, "supplied_contracts": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" } }, "required": [ "api", "scope_identity" ], "type": "object" }, "snapshot_saved": { "type": "boolean" }, "state_expires_at": { "type": "string" }, "status": { "enum": [ "baseline_seeded", "no_supported_contract_change", "unchanged_in_scope", "changed_in_scope", "review_required", "descriptive_only", "evidence_ready" ], "type": "string" }, "summary": { "additionalProperties": {}, "description": "Task-level result; a seeded baseline is not a comparison, and evidence does not prove deployment or causation.", "properties": { "changed": { "type": [ "boolean", "null" ] }, "comparison": { "enum": [ "seeded", "previous", "baseline", "supplied", "portable" ], "type": "string" }, "consistency": { "const": "not_established", "type": "string" }, "findings": { "anyOf": [ { "type": "string" }, { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" } ] }, "release_label": { "type": "string" } }, "type": "object" }, "version": { "const": 1, "type": "number" }, "warnings": { "items": { "type": "string" }, "maxItems": 50, "type": "array" }, "workflow": { "const": "api_compatibility_review", "type": "string" }, "workflow_state_saved": { "type": "boolean" } }, "type": "object" } }, { "description": "Observes public documents without modifying their source. Execution can charge USDC or prepaid credits, consume trial quota and update Fresh402 records. A new charge requires prior spending authorization. Without billing/trial credentials and with evaluation:true omitted, a valid call returns an unpaid quote without executing the observation. Use Check for on-demand changed/unchanged, hash, cache status and optional text diff across sessions. Exactly one url or real watch_id; URL/rules can create a watch, while watch_id reuses rules and forbids overrides. Save returned ID/hash. First URL observation may return changed:null. max_age_seconds defaults0 (conditional revalidation); positive age permits cached evidence. html_attributes observes selected same-text attribute changes. Public HTTPS, no JavaScript or scheduler. Use Smart Diff for structured changes; when advertised, Website Change Intelligence combines observation and supported evidence in one charge. Walletless first Check: require root instant_evaluation.enabled, then set evaluation:true with valid URL/watch input. One attempt per verified network prefix per approved period, sharing finite capacity; no wallet, key, custom header or proprietary SDK. Exact replay returns retained evidence, not a new fetch;429 never authorizes payment. $0.005 USDC/call on Base (eip155:8453), including cache hits. Needs an x402-capable MCP payment client and funded native-USDC payer; ordinary MCP returns a payment challenge. Optional MPP (root mpp_payments.enabled): mppx, org.paymentauth/credential. Prepaid: X-Fresh402-API-Key plus params._meta[\"fresh402/prepaid\"] {idempotency_key,tariff_version,max_credits}; inspect authenticated quote. Choose one billing method; never auto-pay. Persist original proof/input/private recovery token; recover originals after uncertainty. Circle only if root circle_gateway.enabled. Clients, limits and recovery: https://fresh402.com/docs#payments. Free signed trial: /v3/agent-trial requires an unfunded EOA ownership signature; human Web trial: /v2/trial. Eligibility/capacity may return429. Use only X-Fresh402-Trial-Key plus persisted Idempotency-Key; replay exact tool/input/key. Exhaustion never authorizes a charge. The same fixed x402 service price may also be paid in native Circle USDC on Solana Mainnet (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp), when advertised by the unpaid challenge. Explicitly select one accepted network and pin its mint, merchant, amount and sponsored fee payer before signing. Solana payers need no Base wallet; Standalone native Solana MPP solana/charge is also advertised; its client pays a separately authorized SOL network fee, with no server fee sponsorship. Prepaid MPP funding remains Base-only. Payment network does not change the observed chain: blockchain products still inspect finalized Base. Solana delivery requires finalized matching USDC evidence. Persist the original network, resource, input, proof and private recovery capability; never switch networks or authorize a replacement after uncertainty.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "description": "Paid Check input: exactly one of url or watch_id is required. Content rules are allowed only on the url path; watch_id always reuses saved rules. Optional previous_hash overrides the reference hash; max_age_seconds controls cache reuse and include_diff controls text-diff output.", "examples": [ { "include_diff": true, "max_age_seconds": 0, "selector": "main", "url": "https://example.com/docs" } ], "oneOf": [ { "not": { "required": [ "watch_id" ] }, "required": [ "url" ] }, { "not": { "anyOf": [ { "required": [ "url" ] }, { "required": [ "selector" ] }, { "required": [ "ignore_selectors" ] }, { "required": [ "ignore_json_paths" ] }, { "required": [ "html_attributes" ] } ] }, "required": [ "watch_id" ] } ], "properties": { "evaluation": { "description": "Optional, default false. Set true to request one walletless Check attempt per verified network prefix during the current approved evaluation period. No wallet, API key or payment header is needed. Shared capacity and source limits apply; repeat the identical input to recover its retained result. A network is not a unique agent. Never combine true with paid/prepaid/trial credentials. False or omission keeps normal paid behavior. Inspect live availability before requesting evaluation.", "type": "boolean" }, "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 JSON-only exclusions, up to 20 paths of 1-256 characters starting with '/'; '~0'/'~1' escapes and '*' segments are supported. Example: ['/updated_at']. Accepted only with url; default []. With watch_id, omit entirely (including []): saved paths are reused.", "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": "^\\/", "type": "string" }, "maxItems": 20, "type": "array" }, "ignore_selectors": { "description": "Optional HTML-only exclusion array, up to 20 supported CSS selectors of 1-256 characters each, e.g. ['.timestamp']. Accepted only with url; default []. With watch_id, omit the field entirely (including []): saved exclusions are reused.", "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": "string" }, "maxItems": 20, "type": "array" }, "include_diff": { "description": "Optional boolean; runtime default: true. Request a compact deterministic text diff when content changed and compatible prior text is retained. False omits the diff; true cannot recover unavailable old content and does not enable Smart Diff's structural analysis.", "type": "boolean" }, "max_age_seconds": { "description": "Optional integer cache age in seconds, 0-86400; runtime default: 0. A positive value permits reuse of a sufficiently recent watch result without fetching. Zero contacts the source (conditional HTTP may return 304). Cached Checks still require payment; this does not schedule background polling.", "maximum": 86400, "minimum": 0, "type": "integer" }, "previous_hash": { "description": "Optional previous Fresh402 content hash: exactly 64 hexadecimal characters, case-insensitive. Overrides comparison with the watch's current stored hash. Omit to use that stored hash; a new URL watch without a prior hash returns changed:null. Hash comparison does not require retained old text, but a text diff does; a hash cannot reconstruct missing content.", "pattern": "^[a-fA-F0-9]{64}$", "type": "string" }, "selector": { "description": "Optional HTML CSS scope, 1-256 characters, e.g. 'main'; accepted only with url. Omit for the page after built-in noise removal. No match returns 422; not supported for JSON/plain text. With watch_id, omit this field: the saved selector is reused.", "maxLength": 256, "minLength": 1, "type": "string" }, "url": { "description": "Supply exactly one of url or watch_id. URL must be absolute public HTTPS on port 443, at most 4096 characters, with no credentials/private targets, e.g. 'https://example.com/docs'. Fresh402's own service URLs, including its discovery /openapi.json, cannot be targets; choose an external public document. With url, optional content rules identify the watch; an existing watch is reused or a new one is created by this paid Check. Separate registration is not required. No JavaScript rendering.", "format": "uri", "maxLength": 4096, "pattern": "^[Hh][Tt][Tt][Pp][Ss]:\\/\\/", "type": "string" }, "watch_id": { "description": "Supply exactly one of watch_id or url. An existing ID returned by fresh402_register (free), POST /v1/register, or a URL-based Check: 'w_' followed by 32 lowercase hexadecimal characters. Reuses that watch's stored URL and rules. When supplied, omit selector, ignore_selectors and ignore_json_paths entirely, even empty arrays. Do not invent an ID.", "pattern": "^w_[a-f0-9]{32}$", "type": "string" } }, "type": "object" }, "name": "fresh402_check", "outputSchema": { "$defs": { "TextDiff": { "properties": { "added_excerpt": { "type": "string" }, "available": { "type": "boolean" }, "change_ratio": { "type": "number" }, "changed": { "type": "boolean" }, "content_truncated": { "type": "boolean" }, "excerpt_truncated": { "description": "True when bounded contextual added/removed excerpts were clipped; independent of retained snapshot completeness.", "type": "boolean" }, "reason": { "type": "string" }, "removed_excerpt": { "type": "string" } }, "type": "object" } }, "anyOf": [ { "properties": { "cache_status": { "type": "string" }, "cached": { "type": "boolean" }, "changed": { "type": [ "boolean", "null" ] }, "checked_at": { "type": "string" }, "comparison_source": { "type": "string" }, "content_kind": { "type": "string" }, "diff": { "$ref": "#/$defs/TextDiff" }, "final_url": { "type": "string" }, "hash": { "type": "string" }, "html_attribute_rules_version": { "const": 1 }, "html_attributes": { "items": { "enum": [ "href", "title", "alt", "aria-label" ] }, "type": "array" }, "network_fetched": { "type": "boolean" }, "noise_detected": { "type": "boolean" }, "normalizer_version": { "type": "integer" }, "observation": { "description": "Scoped observation status, exact observation time and live-versus-retained execution; no claim about excluded fields or runtime API behavior.", "type": "object" }, "persistence_error": { "type": "string" }, "previous_hash": { "type": [ "string", "null" ] }, "raw_changed": { "type": [ "boolean", "null" ] }, "snapshot_saved": { "type": "boolean" }, "snapshot_truncated": { "type": "boolean" }, "url": { "type": "string" }, "watch_id": { "type": "string" } }, "required": [ "watch_id", "hash", "changed", "content_kind" ], "type": "object" }, { "description": "Tool error only; accompanied by isError=true.", "properties": { "error": { "minLength": 1, "type": "string" }, "retryable": { "type": "boolean" }, "status": { "type": "integer" } }, "required": [ "error" ], "type": "object" }, { "description": "Unpaid x402 v2 quote only; accompanied by isError=true. No product execution or financial authorization.", "properties": { "accepts": { "minItems": 1, "type": "array" }, "resource": { "type": "object" }, "x402Version": { "const": 2 } }, "required": [ "x402Version", "accepts" ], "type": "object" } ], "description": "A successful tool execution follows the canonical result branch. isError=true denotes an error or unpaid payment challenge, never successful execution or payment. Inspect isError before interpreting structuredContent.", "properties": { "cache_status": { "type": "string" }, "cached": { "type": "boolean" }, "changed": { "type": [ "boolean", "null" ] }, "checked_at": { "type": "string" }, "comparison_source": { "type": "string" }, "content_kind": { "type": "string" }, "diff": { "$ref": "#/$defs/TextDiff" }, "final_url": { "type": "string" }, "hash": { "type": "string" }, "html_attribute_rules_version": { "const": 1 }, "html_attributes": { "items": { "enum": [ "href", "title", "alt", "aria-label" ] }, "type": "array" }, "network_fetched": { "type": "boolean" }, "noise_detected": { "type": "boolean" }, "normalizer_version": { "type": "integer" }, "observation": { "description": "Scoped observation status, exact observation time and live-versus-retained execution; no claim about excluded fields or runtime API behavior.", "type": "object" }, "persistence_error": { "type": "string" }, "previous_hash": { "type": [ "string", "null" ] }, "raw_changed": { "type": [ "boolean", "null" ] }, "snapshot_saved": { "type": "boolean" }, "snapshot_truncated": { "type": "boolean" }, "url": { "type": "string" }, "watch_id": { "type": "string" } }, "type": "object" } }, { "description": "Reads blockchain state; the observation does not execute transactions or modify the target wallet/contract. An authorized USDC service payment is separate. Execution can charge USDC or prepaid credits, consume trial quota and update Fresh402 records. A new charge requires prior spending authorization. Without billing/trial credentials, a valid call returns an unpaid quote without executing the observation. Observe code, standard proxy slots, common getters, explicitly selected storage/ABI and bounded selected events at one finalized Base address; optionally compare an owned prior snapshot. Selected single-provider evidence only; unknown controls remain unknown. $0.010000 native USDC/call on Base (eip155:8453); compatible x402 or enabled native MPP client required, no Fresh402 token for first purchase. Save proof/input and private recovery token BEFORE paying for full-response-loss protection: REST X-Fresh402-Recovery-Token; MCP params._meta['fresh402/recovery-token']. Recover originals without new RPC/debit; foreign snapshot/cursor forbidden. Provider failure/partial scan is not paid success. observation_saved=false/persistence_error: recover only, never use unsaved IDs. Prepaid needs eligible finalized all-service credits or an original explicit service-specific tariff4 grant; inspect /v3/prepaid/quote/contract_watch and /v3/prepaid/all-services. Historical Web rights unchanged; paying agents do not need their own RPC credentials. Observations30days, private financial recovery7days. Not full history, financial advice or security audit. Clients: https://fresh402.com/docs#payments. Free signed trial: /v3/agent-trial requires an unfunded EOA ownership signature; human Web trial: /v2/trial. Eligibility/capacity may return429. Use only X-Fresh402-Trial-Key plus persisted Idempotency-Key; replay exact tool/input/key. Exhaustion never authorizes a charge. The same fixed x402 service price may also be paid in native Circle USDC on Solana Mainnet (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp), when advertised by the unpaid challenge. Explicitly select one accepted network and pin its mint, merchant, amount and sponsored fee payer before signing. Solana payers need no Base wallet; Standalone native Solana MPP solana/charge is also advertised; its client pays a separately authorized SOL network fee, with no server fee sponsorship. Prepaid MPP funding remains Base-only. Payment network does not change the observed chain: blockchain products still inspect finalized Base. Solana delivery requires finalized matching USDC evidence. Persist the original network, resource, input, proof and private recovery capability; never switch networks or authorize a replacement after uncertainty.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "address": { "description": "20-byte Ethereum address; lowercase/uppercase accepted, mixed case must have a valid EIP-55 checksum. Normalized to checksummed form.", "maxLength": 42, "minLength": 42, "pattern": "^0x[a-fA-F0-9]{40}$", "type": "string" }, "block": { "const": "finalized", "default": "finalized", "description": "Finalized only. Every state read pins the selected block hash with requireCanonical:true; no latest/number fallback.", "type": "string" }, "chain_id": { "const": 8453, "description": "Base mainnet only; returned provider chain must match.", "type": "number" }, "event_topics": { "default": [], "description": "At most one exact topic0 at this contract, bounded to the existing lookback/call limit. Dense or excessive work fails the whole paid operation; no partial success.", "items": { "pattern": "^0x[a-fA-F0-9]{64}$", "type": "string" }, "maxItems": 1, "type": "array" }, "events_from_block": { "description": "Optional first event block; otherwise previous snapshot block+1, or current block initially. Older than 32 blocks returns lookback_gap, without skipping to recent history.", "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "previous_snapshot": { "description": "Optional owned snapshot_id from a successful saved contract_watch result, retained for30days. Same payer or prepaid account, chain, address and provider required. Foreign/missing IDs return404; expired IDs return410 without silently starting a new baseline.", "pattern": "^s_[a-f0-9]{64}$", "type": "string" }, "reads": { "default": [], "description": "At most one unverified zero-argument view/pure ABI read with one supported static output.", "items": { "additionalProperties": false, "properties": { "inputs": { "items": { "not": {} }, "maxItems": 0, "minItems": 0, "type": "array" }, "name": { "pattern": "^[a-zA-Z_][a-zA-Z0-9_]{0,63}$", "type": "string" }, "outputs": { "items": { "additionalProperties": false, "properties": { "type": { "enum": [ "uint256", "uint8", "address", "bool", "bytes32" ], "type": "string" } }, "required": [ "type" ], "type": "object" }, "maxItems": 1, "minItems": 1, "type": "array" }, "stateMutability": { "enum": [ "view", "pure" ], "type": "string" }, "type": { "const": "function", "type": "string" } }, "required": [ "type", "name", "stateMutability", "inputs", "outputs" ], "type": "object" }, "maxItems": 1, "type": "array" }, "slots": { "default": [], "description": "At most one exact bytes32 storage slot; no inferred layout.", "items": { "pattern": "^0x[a-fA-F0-9]{64}$", "type": "string" }, "maxItems": 1, "type": "array" } }, "required": [ "chain_id", "address" ], "type": "object" }, "name": "fresh402_contract_watch", "outputSchema": { "anyOf": [ { "$schema": "https://json-schema.org/draft/2020-12/schema", "anyOf": [ { "additionalProperties": {}, "properties": { "accounting": { "additionalProperties": {}, "properties": { "response_bytes": { "maximum": 4194304, "minimum": 0, "type": "integer" }, "rpc_requests": { "maximum": 18, "minimum": 1, "type": "integer" }, "scope": { "minLength": 1, "type": "string" }, "wire_response_bytes": { "maximum": 4194304, "minimum": 0, "type": "integer" } }, "required": [ "rpc_requests", "response_bytes", "wire_response_bytes", "scope" ], "type": "object" }, "comparison": { "additionalProperties": {}, "properties": { "changes": { "items": {}, "maxItems": 32, "type": "array" }, "status": { "enum": [ "unknown", "changed", "unchanged" ], "type": "string" } }, "required": [ "status", "changes" ], "type": "object" }, "event_coverage": { "additionalProperties": {}, "properties": { "status": { "type": "string" } }, "required": [ "status" ], "type": "object" }, "events": { "items": {}, "maxItems": 100, "type": "array" }, "limitations": { "items": { "maxLength": 1024, "type": "string" }, "maxItems": 20, "minItems": 1, "type": "array" }, "observation_saved": { "const": true, "type": "boolean" }, "persistence": { "enum": [ "atomic_with_financial_delivery", "atomic_with_entitlement_delivery" ], "type": "string" }, "snapshot": { "additionalProperties": {}, "properties": { "address": { "pattern": "^0x[a-fA-F0-9]{40}$", "type": "string" }, "block": { "additionalProperties": {}, "properties": { "chain_id": { "const": 8453, "type": "number" }, "finalized": { "const": true, "type": "boolean" }, "hash": { "pattern": "^0x[a-f0-9]{64}$", "type": "string" }, "number": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "observed_at": { "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$", "type": "string" }, "parent_hash": { "pattern": "^0x[a-f0-9]{64}$", "type": "string" }, "policy": { "const": "finalized", "type": "string" }, "source": { "pattern": "^[a-z0-9_-]{3,64}$", "type": "string" }, "timestamp": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "trust": { "maxLength": 256, "minLength": 1, "type": "string" } }, "required": [ "number", "hash", "parent_hash", "timestamp", "chain_id", "policy", "finalized", "source", "observed_at", "trust" ], "type": "object" }, "fields": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "required": [ "address", "block", "fields", "warnings" ], "type": "object" }, "snapshot_id": { "pattern": "^s_[a-f0-9]{64}$", "type": "string" }, "snapshot_saved": { "const": true, "type": "boolean" }, "tool": { "const": "fresh402_contract_watch", "type": "string" } }, "required": [ "observation_saved", "snapshot_saved", "persistence", "accounting", "limitations", "tool", "snapshot_id", "snapshot", "comparison", "events", "event_coverage" ], "type": "object" }, { "additionalProperties": {}, "properties": { "accounting": { "additionalProperties": {}, "properties": { "response_bytes": { "maximum": 4194304, "minimum": 0, "type": "integer" }, "rpc_requests": { "maximum": 18, "minimum": 1, "type": "integer" }, "scope": { "minLength": 1, "type": "string" }, "wire_response_bytes": { "maximum": 4194304, "minimum": 0, "type": "integer" } }, "required": [ "rpc_requests", "response_bytes", "wire_response_bytes", "scope" ], "type": "object" }, "comparison": { "additionalProperties": {}, "properties": { "changes": { "items": {}, "maxItems": 32, "type": "array" }, "status": { "enum": [ "unknown", "changed", "unchanged" ], "type": "string" } }, "required": [ "status", "changes" ], "type": "object" }, "cursor_saved": { "const": false, "type": "boolean" }, "event_coverage": { "additionalProperties": {}, "properties": { "status": { "type": "string" } }, "required": [ "status" ], "type": "object" }, "events": { "items": {}, "maxItems": 100, "type": "array" }, "limitations": { "items": { "maxLength": 1024, "type": "string" }, "maxItems": 20, "minItems": 1, "type": "array" }, "observation_saved": { "const": false, "type": "boolean" }, "persistence": { "enum": [ "atomic_with_financial_delivery", "atomic_with_entitlement_delivery" ], "type": "string" }, "persistence_error": { "maxLength": 512, "minLength": 1, "type": "string" }, "snapshot": { "additionalProperties": {}, "properties": { "address": { "pattern": "^0x[a-fA-F0-9]{40}$", "type": "string" }, "block": { "additionalProperties": {}, "properties": { "chain_id": { "const": 8453, "type": "number" }, "finalized": { "const": true, "type": "boolean" }, "hash": { "pattern": "^0x[a-f0-9]{64}$", "type": "string" }, "number": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "observed_at": { "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$", "type": "string" }, "parent_hash": { "pattern": "^0x[a-f0-9]{64}$", "type": "string" }, "policy": { "const": "finalized", "type": "string" }, "source": { "pattern": "^[a-z0-9_-]{3,64}$", "type": "string" }, "timestamp": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "trust": { "maxLength": 256, "minLength": 1, "type": "string" } }, "required": [ "number", "hash", "parent_hash", "timestamp", "chain_id", "policy", "finalized", "source", "observed_at", "trust" ], "type": "object" }, "fields": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "required": [ "address", "block", "fields", "warnings" ], "type": "object" }, "snapshot_id": { "pattern": "^s_[a-f0-9]{64}$", "type": "string" }, "snapshot_saved": { "const": false, "type": "boolean" }, "tool": { "const": "fresh402_contract_watch", "type": "string" } }, "required": [ "observation_saved", "snapshot_saved", "persistence", "accounting", "limitations", "tool", "snapshot_id", "snapshot", "comparison", "events", "event_coverage", "cursor_saved", "persistence_error" ], "type": "object" } ] }, { "description": "Tool error only; accompanied by isError=true.", "properties": { "error": { "minLength": 1, "type": "string" }, "retryable": { "type": "boolean" }, "status": { "type": "integer" } }, "required": [ "error" ], "type": "object" }, { "description": "Unpaid x402 v2 quote only; accompanied by isError=true. No product execution or financial authorization.", "properties": { "accepts": { "minItems": 1, "type": "array" }, "resource": { "type": "object" }, "x402Version": { "const": 2 } }, "required": [ "x402Version", "accepts" ], "type": "object" } ], "description": "A successful tool execution follows the canonical result branch. isError=true denotes an error or unpaid payment challenge, never successful execution or payment. Inspect isError before interpreting structuredContent.", "type": "object" } }, { "description": "Combine one scoped website, an optional JSON OpenAPI comparison and selected finalized Base evidence into one bounded release brief. Separate provenance and missing/conflicting evidence; a release-label mention never proves deployment or causality. One fixed workflow charge; internal steps never create separate customer charges. First URL source use seeds state in this same operation; compatible source_watch_id adopts retained public Register evidence for a genuine first comparison with original scope/time, not ownership. For continuation, later observations use returned owned observation_id. State expires seven days after creation; reads/writes never extend it. Auth: authorized native-USDC x402 v2 on Base, enabled MPP, or an eligible prepaid key plus exact tariff 5 and max_credits. Ordinary unpaid calls return a challenge, not execution. Persist original input, proof and recovery token before submission; exact replay returns retained results without fresh work or another charge. Choose evidence detail before authorization. No free-trial or automatic paid fallback. 0.040 USDC or 16 credits. Limits and scope are authoritative, not a complete audit or compatibility guarantee. The same fixed x402 service price may also be paid in native Circle USDC on Solana Mainnet (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp), when advertised by the unpaid challenge. Explicitly select one accepted network and pin its mint, merchant, amount and sponsored fee payer before signing. Solana payers need no Base wallet; Standalone native Solana MPP solana/charge is also advertised; its client pays a separately authorized SOL network fee, with no server fee sponsorship. Prepaid MPP funding remains Base-only. Payment network does not change the observed chain: blockchain products still inspect finalized Base. Solana delivery requires finalized matching USDC evidence. Persist the original network, resource, input, proof and private recovery capability; never switch networks or authorize a replacement after uncertainty.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "oneOf": [ { "not": { "anyOf": [ { "required": [ "source_watch_id" ] }, { "required": [ "observation_id" ] } ] }, "required": [ "url", "onchain" ] }, { "not": { "anyOf": [ { "required": [ "url" ] }, { "required": [ "observation_id" ] }, { "required": [ "scope" ] } ] }, "required": [ "source_watch_id", "onchain" ] }, { "not": { "anyOf": [ { "required": [ "url" ] }, { "required": [ "source_watch_id" ] }, { "required": [ "scope" ] }, { "required": [ "api_url" ] }, { "required": [ "onchain" ] } ] }, "required": [ "observation_id" ] } ], "properties": { "api_url": { "description": "Optional explicit JSON OpenAPI source for a new cross-domain identity; no link discovery. Saved observation_id freezes this URL too. source_watch_id adopts only the website; this API source seeds separately.", "format": "uri", "maxLength": 4096, "pattern": "^[Hh][Tt][Tt][Pp][Ss]:\\/\\/", "type": "string" }, "compare_to": { "default": "previous", "description": "Default previous compares with the latest successful workflow observation; baseline compares with its original seed. Seeding is one paid workflow operation and reports no comparison, never a second internal charge.", "enum": [ "previous", "baseline" ], "type": "string" }, "detail": { "default": "compact", "description": "Default compact: at most 20 evidence items per section. Expanded allows at most 200 document findings or 100 Base events and retains raw validated logs/getter ABI details within the same fixed work/output ceiling. Counts and omitted-evidence warnings remain explicit.", "enum": [ "compact", "expanded" ], "type": "string" }, "json_array_keys": { "description": "Optional bounded explicit JSON record identities for the website/JSON component only; not API or chain data. Same validation as Smart Diff; omit for index comparison. Comparison policy does not alter source ownership, saved hashes or paid recovery identity.", "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" }, "observation_id": { "description": "Owned observation_id returned by this same workflow. Reuses its immutable source/scope and saved baseline/latest observations; not a primitive watch_id. Seven-day state retention. Missing, foreign or expired IDs never silently rebaseline.", "pattern": "^wf_[a-f0-9]{64}$", "type": "string" }, "onchain": { "additionalProperties": false, "description": "Required with url or source_watch_id for a new cross-domain identity. One narrow finalized Base brief; its addresses become immutable and share one existing 18-RPC reservation.", "properties": { "chain_id": { "const": 8453, "description": "Base mainnet only; provider chain is verified. All state is pinned to one selected finalized block.", "type": "number" }, "contract_address": { "description": "One selected contract which is also the token-facts and Transfer-log contract. The workflow does not infer that arbitrary bytecode is a safe or compliant token.", "maxLength": 42, "minLength": 42, "pattern": "^0x[a-fA-F0-9]{40}$", "type": "string" }, "wallet_address": { "description": "One selected wallet. Returns its exact native-ETH balance and this contract's provider-reported Transfer events at the single selected finalized block, not complete wallet history.", "maxLength": 42, "minLength": 42, "pattern": "^0x[a-fA-F0-9]{40}$", "type": "string" } }, "required": [ "chain_id", "contract_address", "wallet_address" ], "type": "object" }, "release_label": { "description": "Claimed release identifier. Exact source mentions are evidence only, never authentication, deployment proof or causality. May change between observations without changing source identity.", "maxLength": 128, "minLength": 1, "type": "string" }, "scope": { "additionalProperties": false, "description": "Immutable supported normalization rules. Selected attributes participate in change detection; ignored fields are outside the reported scope. No browser execution or linked-page crawling.", "properties": { "html_attributes": { "description": "For workflow HTML, default is all four supported attributes: href,title,alt,aria-label. Explicit [] requests text-only comparison and is reported as limited scope. Ignored selectors apply to both text and attribute evidence. Not applied to JSON/text.", "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 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": "^\\/", "type": "string" }, "maxItems": 20, "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": "string" }, "maxItems": 20, "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" } }, "type": "object" }, "source_watch_id": { "description": "Adopt the current retained public Register observation as the prior baseline, with its exact immutable URL/scope and original timestamp. No baseline refetch or ownership grant. Exactly one of url, source_watch_id or observation_id; omit scope. Complete compatible normalizer-v2 evidence required; API review additionally requires unfiltered JSON OpenAPI. One paid new observation is compared; save returned owned observation_id for continuation. Missing/incomplete baselines fail explicitly, never silently reseed.", "pattern": "^w_[a-f0-9]{32}$", "type": "string" }, "url": { "description": "Public HTTPS source for a new or existing canonical source/scope identity. Exactly one of url, source_watch_id or observation_id. A new URL identity seeds once; the next operation compares.", "format": "uri", "maxLength": 4096, "pattern": "^[Hh][Tt][Tt][Pp][Ss]:\\/\\/", "type": "string" } }, "required": [ "release_label" ], "type": "object" }, "name": "fresh402_cross_domain_release_evidence", "outputSchema": { "anyOf": [ { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "accounting": { "additionalProperties": {}, "description": "Actual bounded execution counters, not inferred model-token savings or a billing invoice.", "propertyNames": { "type": "string" }, "type": "object" }, "billing": { "additionalProperties": false, "properties": { "atomic_usdc": { "pattern": "^\\d+$", "type": "string" }, "credits": { "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "internal_charges": { "const": 0, "type": "number" }, "one_financial_operation": { "const": true, "type": "boolean" }, "tariff_version": { "const": 5, "type": "number" } }, "required": [ "internal_charges", "one_financial_operation", "tariff_version", "credits", "atomic_usdc" ], "type": "object" }, "completeness": { "additionalProperties": {}, "description": "Scope and uncertainty are authoritative; wallet history and independent provider consensus are never asserted.", "propertyNames": { "type": "string" }, "type": "object" }, "evidence": { "additionalProperties": false, "properties": { "api": { "additionalProperties": false, "properties": { "changed": { "type": [ "boolean", "null" ] }, "comparison": { "anyOf": [ { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, { "type": "null" } ] }, "comparison_executed": { "type": "boolean" }, "completeness": { "additionalProperties": {}, "description": "Explicit scope, omitted-evidence count and truncation; no browser or external-reference crawl. Warnings are deduplicated at the result root.", "propertyNames": { "type": "string" }, "type": "object" }, "evidence": { "description": "Bounded structural changes or directional API findings; API entries include classification, rule and JSON Pointer path. Counts survive compaction.", "items": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "maxItems": 200, "type": "array" }, "hash": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "previous_hash": { "anyOf": [ { "pattern": "^[a-f0-9]{64}$", "type": "string" }, { "type": "null" } ] }, "review": { "additionalProperties": false, "description": "Versioned Release Guardian evidence. Findings and excerpts are bounded; pointers refer to the full original result. A skipped comparator reports not_compared/CI2, never automatic approval. No customer code, live API behavior or deployment safety is established.", "properties": { "comparison_performed": { "type": "boolean" }, "complete": { "type": "boolean" }, "findings": { "items": { "additionalProperties": false, "properties": { "affected_path": { "type": "string" }, "after": { "type": [ "string", "null" ] }, "before": { "type": [ "string", "null" ] }, "compatibility_direction": { "enum": [ "request", "response", "authentication", "operation_or_shared" ], "type": "string" }, "complete": { "type": "boolean" }, "confidence": { "enum": [ "supported_rule", "requires_review" ], "type": "string" }, "evidence": { "additionalProperties": false, "properties": { "after_sha256": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "after_source_pointer": { "type": [ "string", "null" ] }, "before_sha256": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "before_source_pointer": { "type": [ "string", "null" ] }, "change_pointer": { "type": "string" }, "change_pointer_scope": { "const": "full_original_result", "type": "string" }, "excerpts_may_be_truncated": { "const": true, "type": "boolean" }, "source_pointer_scope": { "const": "parsed_original_contract_declaration", "type": "string" } }, "required": [ "change_pointer", "change_pointer_scope", "before_sha256", "after_sha256", "excerpts_may_be_truncated" ], "type": "object" }, "explanation": { "type": "string" }, "finding_id": { "pattern": "^cf_[a-f0-9]{64}$", "type": "string" }, "operations": { "items": { "type": "string" }, "maxItems": 8, "type": "array" }, "recommended_action": { "enum": [ "block_and_review", "inspect_with_other_findings", "manual_review" ], "type": "string" }, "rule_id": { "type": "string" }, "severity": { "enum": [ "error", "warning", "info" ], "type": "string" } }, "required": [ "finding_id", "rule_id", "severity", "compatibility_direction", "affected_path", "operations", "complete", "before", "after", "explanation", "evidence", "confidence", "recommended_action" ], "type": "object" }, "maxItems": 20, "type": "array" }, "findings_omitted": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "findings_total": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "groups": { "additionalProperties": { "items": { "type": "string" }, "maxItems": 20, "type": "array" }, "propertyNames": { "type": "string" }, "type": "object" }, "input_fingerprints": { "additionalProperties": false, "properties": { "after_sha256": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "before_sha256": { "anyOf": [ { "pattern": "^[a-f0-9]{64}$", "type": "string" }, { "type": "null" } ] } }, "required": [ "before_sha256", "after_sha256" ], "type": "object" }, "reason": { "enum": [ "baseline_seeded", "hash_unchanged" ], "type": "string" }, "result_id": { "pattern": "^review_[a-f0-9]{64}$", "type": "string" }, "schema": { "const": "fresh402-contract-review-v1", "type": "string" }, "scope": { "type": "string" }, "verdict": { "additionalProperties": false, "properties": { "ci_exit_code": { "anyOf": [ { "const": 0, "type": "number" }, { "const": 1, "type": "number" }, { "const": 2, "type": "number" } ] }, "live_api_verified": { "const": false, "type": "boolean" }, "scope": { "type": "string" }, "status": { "enum": [ "breaking", "review_required", "no_breaking_change_observed", "not_compared" ], "type": "string" }, "unsupported_features_require_review": { "const": true, "type": "boolean" } }, "required": [ "status", "ci_exit_code", "live_api_verified" ], "type": "object" } }, "required": [ "schema", "comparison_performed", "verdict", "input_fingerprints", "findings", "findings_total", "findings_omitted", "groups", "complete" ], "type": "object" }, "scope": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "status": { "enum": [ "baseline_seeded", "no_supported_contract_change", "unchanged_in_scope", "changed_in_scope", "review_required", "descriptive_only" ], "type": "string" }, "summary": { "anyOf": [ { "type": "string" }, { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" } ] } }, "required": [ "status", "changed", "scope", "hash", "previous_hash", "summary", "evidence", "comparison", "comparison_executed", "completeness" ], "type": "object" }, "onchain": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "website": { "additionalProperties": false, "properties": { "changed": { "type": [ "boolean", "null" ] }, "comparison": { "anyOf": [ { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, { "type": "null" } ] }, "comparison_executed": { "type": "boolean" }, "completeness": { "additionalProperties": {}, "description": "Explicit scope, omitted-evidence count and truncation; no browser or external-reference crawl. Warnings are deduplicated at the result root.", "propertyNames": { "type": "string" }, "type": "object" }, "evidence": { "description": "Bounded structural changes or directional API findings; API entries include classification, rule and JSON Pointer path. Counts survive compaction.", "items": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "maxItems": 200, "type": "array" }, "hash": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "previous_hash": { "anyOf": [ { "pattern": "^[a-f0-9]{64}$", "type": "string" }, { "type": "null" } ] }, "review": { "additionalProperties": false, "description": "Versioned Release Guardian evidence. Findings and excerpts are bounded; pointers refer to the full original result. A skipped comparator reports not_compared/CI2, never automatic approval. No customer code, live API behavior or deployment safety is established.", "properties": { "comparison_performed": { "type": "boolean" }, "complete": { "type": "boolean" }, "findings": { "items": { "additionalProperties": false, "properties": { "affected_path": { "type": "string" }, "after": { "type": [ "string", "null" ] }, "before": { "type": [ "string", "null" ] }, "compatibility_direction": { "enum": [ "request", "response", "authentication", "operation_or_shared" ], "type": "string" }, "complete": { "type": "boolean" }, "confidence": { "enum": [ "supported_rule", "requires_review" ], "type": "string" }, "evidence": { "additionalProperties": false, "properties": { "after_sha256": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "after_source_pointer": { "type": [ "string", "null" ] }, "before_sha256": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "before_source_pointer": { "type": [ "string", "null" ] }, "change_pointer": { "type": "string" }, "change_pointer_scope": { "const": "full_original_result", "type": "string" }, "excerpts_may_be_truncated": { "const": true, "type": "boolean" }, "source_pointer_scope": { "const": "parsed_original_contract_declaration", "type": "string" } }, "required": [ "change_pointer", "change_pointer_scope", "before_sha256", "after_sha256", "excerpts_may_be_truncated" ], "type": "object" }, "explanation": { "type": "string" }, "finding_id": { "pattern": "^cf_[a-f0-9]{64}$", "type": "string" }, "operations": { "items": { "type": "string" }, "maxItems": 8, "type": "array" }, "recommended_action": { "enum": [ "block_and_review", "inspect_with_other_findings", "manual_review" ], "type": "string" }, "rule_id": { "type": "string" }, "severity": { "enum": [ "error", "warning", "info" ], "type": "string" } }, "required": [ "finding_id", "rule_id", "severity", "compatibility_direction", "affected_path", "operations", "complete", "before", "after", "explanation", "evidence", "confidence", "recommended_action" ], "type": "object" }, "maxItems": 20, "type": "array" }, "findings_omitted": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "findings_total": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "groups": { "additionalProperties": { "items": { "type": "string" }, "maxItems": 20, "type": "array" }, "propertyNames": { "type": "string" }, "type": "object" }, "input_fingerprints": { "additionalProperties": false, "properties": { "after_sha256": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "before_sha256": { "anyOf": [ { "pattern": "^[a-f0-9]{64}$", "type": "string" }, { "type": "null" } ] } }, "required": [ "before_sha256", "after_sha256" ], "type": "object" }, "reason": { "enum": [ "baseline_seeded", "hash_unchanged" ], "type": "string" }, "result_id": { "pattern": "^review_[a-f0-9]{64}$", "type": "string" }, "schema": { "const": "fresh402-contract-review-v1", "type": "string" }, "scope": { "type": "string" }, "verdict": { "additionalProperties": false, "properties": { "ci_exit_code": { "anyOf": [ { "const": 0, "type": "number" }, { "const": 1, "type": "number" }, { "const": 2, "type": "number" } ] }, "live_api_verified": { "const": false, "type": "boolean" }, "scope": { "type": "string" }, "status": { "enum": [ "breaking", "review_required", "no_breaking_change_observed", "not_compared" ], "type": "string" }, "unsupported_features_require_review": { "const": true, "type": "boolean" } }, "required": [ "status", "ci_exit_code", "live_api_verified" ], "type": "object" } }, "required": [ "schema", "comparison_performed", "verdict", "input_fingerprints", "findings", "findings_total", "findings_omitted", "groups", "complete" ], "type": "object" }, "scope": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "status": { "enum": [ "baseline_seeded", "no_supported_contract_change", "unchanged_in_scope", "changed_in_scope", "review_required", "descriptive_only" ], "type": "string" }, "summary": { "anyOf": [ { "type": "string" }, { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" } ] } }, "required": [ "status", "changed", "scope", "hash", "previous_hash", "summary", "evidence", "comparison", "comparison_executed", "completeness" ], "type": "object" } }, "required": [ "website", "onchain" ], "type": "object" }, "observation_id": { "pattern": "^wf_[a-f0-9]{64}$", "type": "string" }, "observed_at": { "type": "string" }, "persistence_error": { "type": "string" }, "portable_state": { "anyOf": [ { "additionalProperties": false, "properties": { "caller_retention_days": { "const": 30, "type": "number" }, "expires_at": { "type": "string" }, "observed_at": { "type": "string" }, "payload_bytes": { "maximum": 32768, "minimum": 0, "type": "integer" }, "payment_authority": { "const": false, "type": "boolean" }, "retention_extended": { "const": false, "type": "boolean" }, "server_retention_days": { "const": 7, "type": "number" }, "source_freshness_verified": { "const": false, "type": "boolean" }, "status": { "const": "available", "type": "string" }, "token": { "maxLength": 44000, "type": "string" } }, "required": [ "status", "token", "expires_at", "observed_at", "payload_bytes", "server_retention_days", "caller_retention_days", "retention_extended", "payment_authority", "source_freshness_verified" ], "type": "object" }, { "additionalProperties": false, "properties": { "max_payload_bytes": { "const": 32768, "type": "number" }, "retention_extended": { "const": false, "type": "boolean" }, "status": { "const": "omitted_size", "type": "string" } }, "required": [ "status", "max_payload_bytes", "retention_extended" ], "type": "object" } ], "description": "Opt-in private caller-retained source evidence, independently integrity-protected and bound to principal/workflow/environment/scope. Not encryption, payment authority, current freshness or an extension of original-result/server retention." }, "provenance": { "additionalProperties": false, "properties": { "api": { "additionalProperties": false, "properties": { "content_type": { "type": "string" }, "final_url": { "format": "uri", "type": "string" }, "observed_at": { "type": "string" }, "raw_source_hash": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "requested_url": { "format": "uri", "type": "string" } }, "required": [ "requested_url", "final_url", "raw_source_hash", "observed_at", "content_type" ], "type": "object" }, "onchain": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "portable_baseline": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "previous_observation": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "register_baseline": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "scope_identity": { "type": "string" }, "supplied_contracts": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "website": { "additionalProperties": false, "properties": { "content_type": { "type": "string" }, "final_url": { "format": "uri", "type": "string" }, "observed_at": { "type": "string" }, "raw_source_hash": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "requested_url": { "format": "uri", "type": "string" } }, "required": [ "requested_url", "final_url", "raw_source_hash", "observed_at", "content_type" ], "type": "object" } }, "required": [ "website", "onchain", "scope_identity" ], "type": "object" }, "snapshot_saved": { "type": "boolean" }, "state_expires_at": { "type": "string" }, "status": { "enum": [ "baseline_seeded", "no_supported_contract_change", "unchanged_in_scope", "changed_in_scope", "review_required", "descriptive_only", "evidence_ready" ], "type": "string" }, "summary": { "additionalProperties": {}, "description": "Task-level result; a seeded baseline is not a comparison, and evidence does not prove deployment or causation.", "properties": { "changed": { "type": [ "boolean", "null" ] }, "comparison": { "enum": [ "seeded", "previous", "baseline", "supplied", "portable" ], "type": "string" }, "consistency": { "const": "not_established", "type": "string" }, "findings": { "anyOf": [ { "type": "string" }, { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" } ] }, "release_label": { "type": "string" } }, "type": "object" }, "version": { "const": 1, "type": "number" }, "warnings": { "items": { "type": "string" }, "maxItems": 50, "type": "array" }, "workflow": { "const": "cross_domain_release_evidence", "type": "string" }, "workflow_state_saved": { "type": "boolean" } }, "required": [ "workflow", "version", "status", "observed_at", "summary", "evidence", "provenance", "completeness", "warnings", "accounting", "billing" ], "type": "object" }, { "description": "Tool error only; accompanied by isError=true.", "properties": { "error": { "minLength": 1, "type": "string" }, "retryable": { "type": "boolean" }, "status": { "type": "integer" } }, "required": [ "error" ], "type": "object" }, { "description": "Unpaid x402 v2 quote only; accompanied by isError=true. No product execution or financial authorization.", "properties": { "accepts": { "minItems": 1, "type": "array" }, "resource": { "type": "object" }, "x402Version": { "const": 2 } }, "required": [ "x402Version", "accepts" ], "type": "object" } ], "description": "A successful tool execution follows the canonical result branch. isError=true denotes an error or unpaid payment challenge, never successful execution or payment. Inspect isError before interpreting structuredContent.", "properties": { "accounting": { "additionalProperties": {}, "description": "Actual bounded execution counters, not inferred model-token savings or a billing invoice.", "propertyNames": { "type": "string" }, "type": "object" }, "billing": { "additionalProperties": false, "properties": { "atomic_usdc": { "pattern": "^\\d+$", "type": "string" }, "credits": { "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "internal_charges": { "const": 0, "type": "number" }, "one_financial_operation": { "const": true, "type": "boolean" }, "tariff_version": { "const": 5, "type": "number" } }, "required": [ "internal_charges", "one_financial_operation", "tariff_version", "credits", "atomic_usdc" ], "type": "object" }, "completeness": { "additionalProperties": {}, "description": "Scope and uncertainty are authoritative; wallet history and independent provider consensus are never asserted.", "propertyNames": { "type": "string" }, "type": "object" }, "evidence": { "additionalProperties": false, "properties": { "api": { "additionalProperties": false, "properties": { "changed": { "type": [ "boolean", "null" ] }, "comparison": { "anyOf": [ { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, { "type": "null" } ] }, "comparison_executed": { "type": "boolean" }, "completeness": { "additionalProperties": {}, "description": "Explicit scope, omitted-evidence count and truncation; no browser or external-reference crawl. Warnings are deduplicated at the result root.", "propertyNames": { "type": "string" }, "type": "object" }, "evidence": { "description": "Bounded structural changes or directional API findings; API entries include classification, rule and JSON Pointer path. Counts survive compaction.", "items": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "maxItems": 200, "type": "array" }, "hash": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "previous_hash": { "anyOf": [ { "pattern": "^[a-f0-9]{64}$", "type": "string" }, { "type": "null" } ] }, "review": { "additionalProperties": false, "description": "Versioned Release Guardian evidence. Findings and excerpts are bounded; pointers refer to the full original result. A skipped comparator reports not_compared/CI2, never automatic approval. No customer code, live API behavior or deployment safety is established.", "properties": { "comparison_performed": { "type": "boolean" }, "complete": { "type": "boolean" }, "findings": { "items": { "additionalProperties": false, "properties": { "affected_path": { "type": "string" }, "after": { "type": [ "string", "null" ] }, "before": { "type": [ "string", "null" ] }, "compatibility_direction": { "enum": [ "request", "response", "authentication", "operation_or_shared" ], "type": "string" }, "complete": { "type": "boolean" }, "confidence": { "enum": [ "supported_rule", "requires_review" ], "type": "string" }, "evidence": { "additionalProperties": false, "properties": { "after_sha256": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "after_source_pointer": { "type": [ "string", "null" ] }, "before_sha256": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "before_source_pointer": { "type": [ "string", "null" ] }, "change_pointer": { "type": "string" }, "change_pointer_scope": { "const": "full_original_result", "type": "string" }, "excerpts_may_be_truncated": { "const": true, "type": "boolean" }, "source_pointer_scope": { "const": "parsed_original_contract_declaration", "type": "string" } }, "required": [ "change_pointer", "change_pointer_scope", "before_sha256", "after_sha256", "excerpts_may_be_truncated" ], "type": "object" }, "explanation": { "type": "string" }, "finding_id": { "pattern": "^cf_[a-f0-9]{64}$", "type": "string" }, "operations": { "items": { "type": "string" }, "maxItems": 8, "type": "array" }, "recommended_action": { "enum": [ "block_and_review", "inspect_with_other_findings", "manual_review" ], "type": "string" }, "rule_id": { "type": "string" }, "severity": { "enum": [ "error", "warning", "info" ], "type": "string" } }, "required": [ "finding_id", "rule_id", "severity", "compatibility_direction", "affected_path", "operations", "complete", "before", "after", "explanation", "evidence", "confidence", "recommended_action" ], "type": "object" }, "maxItems": 20, "type": "array" }, "findings_omitted": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "findings_total": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "groups": { "additionalProperties": { "items": { "type": "string" }, "maxItems": 20, "type": "array" }, "propertyNames": { "type": "string" }, "type": "object" }, "input_fingerprints": { "additionalProperties": false, "properties": { "after_sha256": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "before_sha256": { "anyOf": [ { "pattern": "^[a-f0-9]{64}$", "type": "string" }, { "type": "null" } ] } }, "required": [ "before_sha256", "after_sha256" ], "type": "object" }, "reason": { "enum": [ "baseline_seeded", "hash_unchanged" ], "type": "string" }, "result_id": { "pattern": "^review_[a-f0-9]{64}$", "type": "string" }, "schema": { "const": "fresh402-contract-review-v1", "type": "string" }, "scope": { "type": "string" }, "verdict": { "additionalProperties": false, "properties": { "ci_exit_code": { "anyOf": [ { "const": 0, "type": "number" }, { "const": 1, "type": "number" }, { "const": 2, "type": "number" } ] }, "live_api_verified": { "const": false, "type": "boolean" }, "scope": { "type": "string" }, "status": { "enum": [ "breaking", "review_required", "no_breaking_change_observed", "not_compared" ], "type": "string" }, "unsupported_features_require_review": { "const": true, "type": "boolean" } }, "required": [ "status", "ci_exit_code", "live_api_verified" ], "type": "object" } }, "required": [ "schema", "comparison_performed", "verdict", "input_fingerprints", "findings", "findings_total", "findings_omitted", "groups", "complete" ], "type": "object" }, "scope": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "status": { "enum": [ "baseline_seeded", "no_supported_contract_change", "unchanged_in_scope", "changed_in_scope", "review_required", "descriptive_only" ], "type": "string" }, "summary": { "anyOf": [ { "type": "string" }, { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" } ] } }, "required": [ "status", "changed", "scope", "hash", "previous_hash", "summary", "evidence", "comparison", "comparison_executed", "completeness" ], "type": "object" }, "onchain": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "website": { "additionalProperties": false, "properties": { "changed": { "type": [ "boolean", "null" ] }, "comparison": { "anyOf": [ { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, { "type": "null" } ] }, "comparison_executed": { "type": "boolean" }, "completeness": { "additionalProperties": {}, "description": "Explicit scope, omitted-evidence count and truncation; no browser or external-reference crawl. Warnings are deduplicated at the result root.", "propertyNames": { "type": "string" }, "type": "object" }, "evidence": { "description": "Bounded structural changes or directional API findings; API entries include classification, rule and JSON Pointer path. Counts survive compaction.", "items": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "maxItems": 200, "type": "array" }, "hash": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "previous_hash": { "anyOf": [ { "pattern": "^[a-f0-9]{64}$", "type": "string" }, { "type": "null" } ] }, "review": { "additionalProperties": false, "description": "Versioned Release Guardian evidence. Findings and excerpts are bounded; pointers refer to the full original result. A skipped comparator reports not_compared/CI2, never automatic approval. No customer code, live API behavior or deployment safety is established.", "properties": { "comparison_performed": { "type": "boolean" }, "complete": { "type": "boolean" }, "findings": { "items": { "additionalProperties": false, "properties": { "affected_path": { "type": "string" }, "after": { "type": [ "string", "null" ] }, "before": { "type": [ "string", "null" ] }, "compatibility_direction": { "enum": [ "request", "response", "authentication", "operation_or_shared" ], "type": "string" }, "complete": { "type": "boolean" }, "confidence": { "enum": [ "supported_rule", "requires_review" ], "type": "string" }, "evidence": { "additionalProperties": false, "properties": { "after_sha256": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "after_source_pointer": { "type": [ "string", "null" ] }, "before_sha256": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "before_source_pointer": { "type": [ "string", "null" ] }, "change_pointer": { "type": "string" }, "change_pointer_scope": { "const": "full_original_result", "type": "string" }, "excerpts_may_be_truncated": { "const": true, "type": "boolean" }, "source_pointer_scope": { "const": "parsed_original_contract_declaration", "type": "string" } }, "required": [ "change_pointer", "change_pointer_scope", "before_sha256", "after_sha256", "excerpts_may_be_truncated" ], "type": "object" }, "explanation": { "type": "string" }, "finding_id": { "pattern": "^cf_[a-f0-9]{64}$", "type": "string" }, "operations": { "items": { "type": "string" }, "maxItems": 8, "type": "array" }, "recommended_action": { "enum": [ "block_and_review", "inspect_with_other_findings", "manual_review" ], "type": "string" }, "rule_id": { "type": "string" }, "severity": { "enum": [ "error", "warning", "info" ], "type": "string" } }, "required": [ "finding_id", "rule_id", "severity", "compatibility_direction", "affected_path", "operations", "complete", "before", "after", "explanation", "evidence", "confidence", "recommended_action" ], "type": "object" }, "maxItems": 20, "type": "array" }, "findings_omitted": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "findings_total": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "groups": { "additionalProperties": { "items": { "type": "string" }, "maxItems": 20, "type": "array" }, "propertyNames": { "type": "string" }, "type": "object" }, "input_fingerprints": { "additionalProperties": false, "properties": { "after_sha256": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "before_sha256": { "anyOf": [ { "pattern": "^[a-f0-9]{64}$", "type": "string" }, { "type": "null" } ] } }, "required": [ "before_sha256", "after_sha256" ], "type": "object" }, "reason": { "enum": [ "baseline_seeded", "hash_unchanged" ], "type": "string" }, "result_id": { "pattern": "^review_[a-f0-9]{64}$", "type": "string" }, "schema": { "const": "fresh402-contract-review-v1", "type": "string" }, "scope": { "type": "string" }, "verdict": { "additionalProperties": false, "properties": { "ci_exit_code": { "anyOf": [ { "const": 0, "type": "number" }, { "const": 1, "type": "number" }, { "const": 2, "type": "number" } ] }, "live_api_verified": { "const": false, "type": "boolean" }, "scope": { "type": "string" }, "status": { "enum": [ "breaking", "review_required", "no_breaking_change_observed", "not_compared" ], "type": "string" }, "unsupported_features_require_review": { "const": true, "type": "boolean" } }, "required": [ "status", "ci_exit_code", "live_api_verified" ], "type": "object" } }, "required": [ "schema", "comparison_performed", "verdict", "input_fingerprints", "findings", "findings_total", "findings_omitted", "groups", "complete" ], "type": "object" }, "scope": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "status": { "enum": [ "baseline_seeded", "no_supported_contract_change", "unchanged_in_scope", "changed_in_scope", "review_required", "descriptive_only" ], "type": "string" }, "summary": { "anyOf": [ { "type": "string" }, { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" } ] } }, "required": [ "status", "changed", "scope", "hash", "previous_hash", "summary", "evidence", "comparison", "comparison_executed", "completeness" ], "type": "object" } }, "required": [ "website", "onchain" ], "type": "object" }, "observation_id": { "pattern": "^wf_[a-f0-9]{64}$", "type": "string" }, "observed_at": { "type": "string" }, "persistence_error": { "type": "string" }, "portable_state": { "anyOf": [ { "additionalProperties": false, "properties": { "caller_retention_days": { "const": 30, "type": "number" }, "expires_at": { "type": "string" }, "observed_at": { "type": "string" }, "payload_bytes": { "maximum": 32768, "minimum": 0, "type": "integer" }, "payment_authority": { "const": false, "type": "boolean" }, "retention_extended": { "const": false, "type": "boolean" }, "server_retention_days": { "const": 7, "type": "number" }, "source_freshness_verified": { "const": false, "type": "boolean" }, "status": { "const": "available", "type": "string" }, "token": { "maxLength": 44000, "type": "string" } }, "required": [ "status", "token", "expires_at", "observed_at", "payload_bytes", "server_retention_days", "caller_retention_days", "retention_extended", "payment_authority", "source_freshness_verified" ], "type": "object" }, { "additionalProperties": false, "properties": { "max_payload_bytes": { "const": 32768, "type": "number" }, "retention_extended": { "const": false, "type": "boolean" }, "status": { "const": "omitted_size", "type": "string" } }, "required": [ "status", "max_payload_bytes", "retention_extended" ], "type": "object" } ], "description": "Opt-in private caller-retained source evidence, independently integrity-protected and bound to principal/workflow/environment/scope. Not encryption, payment authority, current freshness or an extension of original-result/server retention." }, "provenance": { "additionalProperties": false, "properties": { "api": { "additionalProperties": false, "properties": { "content_type": { "type": "string" }, "final_url": { "format": "uri", "type": "string" }, "observed_at": { "type": "string" }, "raw_source_hash": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "requested_url": { "format": "uri", "type": "string" } }, "required": [ "requested_url", "final_url", "raw_source_hash", "observed_at", "content_type" ], "type": "object" }, "onchain": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "portable_baseline": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "previous_observation": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "register_baseline": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "scope_identity": { "type": "string" }, "supplied_contracts": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "website": { "additionalProperties": false, "properties": { "content_type": { "type": "string" }, "final_url": { "format": "uri", "type": "string" }, "observed_at": { "type": "string" }, "raw_source_hash": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "requested_url": { "format": "uri", "type": "string" } }, "required": [ "requested_url", "final_url", "raw_source_hash", "observed_at", "content_type" ], "type": "object" } }, "required": [ "website", "onchain", "scope_identity" ], "type": "object" }, "snapshot_saved": { "type": "boolean" }, "state_expires_at": { "type": "string" }, "status": { "enum": [ "baseline_seeded", "no_supported_contract_change", "unchanged_in_scope", "changed_in_scope", "review_required", "descriptive_only", "evidence_ready" ], "type": "string" }, "summary": { "additionalProperties": {}, "description": "Task-level result; a seeded baseline is not a comparison, and evidence does not prove deployment or causation.", "properties": { "changed": { "type": [ "boolean", "null" ] }, "comparison": { "enum": [ "seeded", "previous", "baseline", "supplied", "portable" ], "type": "string" }, "consistency": { "const": "not_established", "type": "string" }, "findings": { "anyOf": [ { "type": "string" }, { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" } ] }, "release_label": { "type": "string" } }, "type": "object" }, "version": { "const": 1, "type": "number" }, "warnings": { "items": { "type": "string" }, "maxItems": 50, "type": "array" }, "workflow": { "const": "cross_domain_release_evidence", "type": "string" }, "workflow_state_saved": { "type": "boolean" } }, "type": "object" } }, { "description": "Observes public documents without modifying their source. Execution can charge USDC or prepaid credits, consume trial quota and update Fresh402 records. A new charge requires prior spending authorization. Without billing/trial credentials, a valid call returns an unpaid quote without executing the observation. Use Extract for text, metadata, headings, links, JSON-LD and content hash from one public document; no watch required. No comparison, crawl or JavaScript. CSS scopes HTML; json_pointer selects one JSON value, json_pointers selects1-8 ordered fields; missing selections fail422. feed_mode:entries projects bounded RSS2/Atom; omit for XML-as-text. max_chars defaults20000, clips text but not the full hash; clipped structured data is omitted. For repeat observations use Check, then separately authorize Extract if needed. Use the retained source identity and scoped output to keep agent evidence consistent across sessions. Optional records extracts 1-25 repeated JSON objects or static HTML/table rows with 1-12 named typed fields, per-field status and source pointers. It is exclusive with fields/json_pointer/json_pointers/feed_mode. Default record limit20, shared16,384 selected-value bytes; no schema inference, currency coercion, pagination or browser. Missing/invalid/ambiguous/truncated/unsupported values are reported explicitly. The existing fields mode projects one JSON object. Price and one-source-fetch limit are unchanged. $0.01 USDC/call on Base (eip155:8453), including cache hits. Needs an x402-capable MCP payment client and funded native-USDC payer; ordinary MCP returns a payment challenge. Optional MPP (root mpp_payments.enabled): mppx, org.paymentauth/credential. Prepaid: X-Fresh402-API-Key plus params._meta[\"fresh402/prepaid\"] {idempotency_key,tariff_version,max_credits}; inspect authenticated quote. Choose one billing method; never auto-pay. Persist original proof/input/private recovery token; recover originals after uncertainty. Circle only if root circle_gateway.enabled. Clients, limits and recovery: https://fresh402.com/docs#payments. Free signed trial: /v3/agent-trial requires an unfunded EOA ownership signature; human Web trial: /v2/trial. Eligibility/capacity may return429. Use only X-Fresh402-Trial-Key plus persisted Idempotency-Key; replay exact tool/input/key. Exhaustion never authorizes a charge. The same fixed x402 service price may also be paid in native Circle USDC on Solana Mainnet (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp), when advertised by the unpaid challenge. Explicitly select one accepted network and pin its mint, merchant, amount and sponsored fee payer before signing. Solana payers need no Base wallet; Standalone native Solana MPP solana/charge is also advertised; its client pays a separately authorized SOL network fee, with no server fee sponsorship. Prepaid MPP funding remains Base-only. Payment network does not change the observed chain: blockchain products still inspect finalized Base. Solana delivery requires finalized matching USDC evidence. Persist the original network, resource, input, proof and private recovery capability; never switch networks or authorize a replacement after uncertainty.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "allOf": [ { "not": { "anyOf": [ { "required": [ "fields" ] }, { "required": [ "json_pointer" ] }, { "required": [ "json_pointers" ] }, { "required": [ "feed_mode" ] } ], "required": [ "records" ] } }, { "not": { "anyOf": [ { "required": [ "selector" ] }, { "required": [ "ignore_selectors" ] }, { "required": [ "ignore_json_paths" ] }, { "required": [ "json_pointer" ] }, { "required": [ "json_pointers" ] } ], "required": [ "feed_mode" ] } }, { "not": { "anyOf": [ { "required": [ "json_pointer" ] }, { "required": [ "json_pointers" ] }, { "required": [ "feed_mode" ] } ], "required": [ "fields" ] } } ], "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. Opt-in feed_mode:'entries' projects bounded RSS2/Atom; omit to preserve original extraction. Unknown fields are rejected.", "examples": [ { "include_links": true, "include_structured_data": false, "max_chars": 20000, "selector": "main", "url": "https://example.com/docs" } ], "not": { "required": [ "json_pointer", "json_pointers" ] }, "properties": { "feed_mode": { "const": "entries", "description": "Optional RSS2/Atom projection: 'entries'. Omit for unchanged XML-as-text extraction and existing hashes. Accepts XML/+xml/text/plain with an RSS2 root or namespaced Atom feed; no RSS1/RDF, HTML repair, DTD or external entity/content fetching. Cannot combine with CSS/JSON selection or exclusions. Limits:262144 UTF-8 source bytes,4096 XML elements,depth32,100 entries,16384 characters/field,131072 projected bytes; excess fails explicitly. Returns feed identity, inert declared links, entry IDs/timestamps/content fingerprints and indexed source evidence. Identical duplicate entries deduplicate; conflicting IDs fail422. Feed text/hash cover the canonical projection; max_chars clips text and omits structured feed when clipped. Existing registration/watch semantics remain unchanged.", "type": "string" }, "fields": { "description": "Optional 1-12 named typed fields for JSON sources only, exclusive with json_pointer/json_pointers/feed_mode. Every name must be distinct across the array, even when pointers or types differ; this runtime rule is stricter than whole-object uniqueItems. Uses one existing fetch/parse after ignore_json_paths. Missing/type-mismatched fields are reported individually, never silently coerced. Each selected value <=4,096 UTF-8 bytes; total values <=16,384 bytes/2,000 nodes. Over-budget fields are omitted explicitly. HTML/text retain ordinary extraction; no semantic or browser extraction.", "items": { "additionalProperties": false, "description": "One named typed field: exact source pointer, accepted JSON type and explicit requiredness. Missing/type-mismatched/over-budget values are reported, never invented or coerced.", "properties": { "name": { "description": "Unique output property name, 1-48 ASCII letters/digits/underscores, starting with a letter.", "pattern": "^[A-Za-z][A-Za-z0-9_]{0,47}$", "type": "string" }, "pointer": { "description": "Exact RFC6901 JSON Pointer after exclusions; empty string selects root, ~0/~1 escape ~ and /. No wildcards, inference or linked-source fetching.", "maxLength": 256, "pattern": "^(?:\\/(?:[^~]|~[01])*)?$", "type": "string" }, "required": { "default": true, "description": "Default true. A missing required value makes complete:false; optional missing values are still reported. No invented default or placeholder value.", "type": "boolean" }, "type": { "description": "Required exact JSON value type. No string-to-number coercion; integer requires a safe integer. object excludes arrays/null.", "enum": [ "string", "number", "integer", "boolean", "object", "array", "null" ], "type": "string" } }, "required": [ "name", "pointer", "type" ], "type": "object" }, "maxItems": 12, "minItems": 1, "type": "array", "uniqueItems": true }, "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": "^\\/", "type": "string" }, "maxItems": 20, "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": "string" }, "maxItems": 20, "type": "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.", "type": "boolean" }, "json_pointer": { "description": "Optional exact RFC 6901 JSON Pointer, at most 256 characters, e.g. '/product/price' or '/items/0/name'. JSON documents only; '~0' means '~' and '~1' means '/'. Empty string selects the whole document. Omit to extract the entire normalized document. Selection runs after ignore_json_paths; a missing or excluded target returns 422. Array indices are zero-based canonical integers; '*' is a literal key, not a wildcard. Returned text/data/hash cover the selected value; max_chars and data_omitted still apply.", "maxLength": 256, "pattern": "^(?:\\/(?:[^~]|~[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": "Optional integer limit on returned normalized text: 100-50000 characters, default 20000. Does not raise fetch/parser limits; the hash covers full normalized text before truncation. If JSON text is truncated, parsed data is omitted (data:null, data_omitted:true).", "maximum": 50000, "minimum": 100, "type": "integer" }, "records": { "description": "Optional bounded repeated-record extraction, exclusive with fields/json_pointer/json_pointers/feed_mode. JSON arrays or static HTML records/tables only, one original source fetch. Up to25 records and12 fields, globally16,384 selected-value bytes/2,000nodes. Every field has a source reference and explicit missing/invalid/ambiguous/truncated/unsupported status. No inferred table headers, currency conversion, browser, linked-page crawl or semantic model.", "oneOf": [ { "additionalProperties": false, "properties": { "fields": { "description": "Required 1-12 distinct named typed fields. Each exact RFC6901 pointer is relative to a single selected array item. Required defaults true; no coercion. One shared 16,384-byte/2,000-node value budget across all records.", "items": { "additionalProperties": false, "description": "One named typed field: exact source pointer, accepted JSON type and explicit requiredness. Missing/type-mismatched/over-budget values are reported, never invented or coerced.", "properties": { "name": { "description": "Unique output property name, 1-48 ASCII letters/digits/underscores, starting with a letter.", "pattern": "^[A-Za-z][A-Za-z0-9_]{0,47}$", "type": "string" }, "pointer": { "description": "Exact RFC6901 JSON Pointer after exclusions; empty string selects root, ~0/~1 escape ~ and /. No wildcards, inference or linked-source fetching.", "maxLength": 256, "pattern": "^(?:\\/(?:[^~]|~[01])*)?$", "type": "string" }, "required": { "default": true, "description": "Default true. A missing required value makes complete:false; optional missing values are still reported. No invented default or placeholder value.", "type": "boolean" }, "type": { "description": "Required exact JSON value type. No string-to-number coercion; integer requires a safe integer. object excludes arrays/null.", "enum": [ "string", "number", "integer", "boolean", "object", "array", "null" ], "type": "string" } }, "required": [ "name", "pointer", "type" ], "type": "object" }, "maxItems": 12, "minItems": 1, "type": "array", "uniqueItems": true }, "limit": { "default": 20, "description": "Maximum returned records, 1-25, default20. Excess records are counted as omitted; no automatic pagination, crawling or larger output budget. A shared16,384 selected-value byte/2,000-node budget applies across every record.", "maximum": 25, "minimum": 1, "type": "integer" }, "pointer": { "description": "Required exact RFC6901 pointer selecting an array after exclusions; empty string selects root. At most256 characters/64 segments, ~0/~1 escaping, no wildcard. Each field pointer is relative to an individual array item.", "maxLength": 256, "pattern": "^(?:\\/(?:[^~]|~[01])*)?$", "type": "string" }, "source": { "const": "json", "description": "Select already parsed JSON after ignore_json_paths; no additional fetch or parse.", "type": "string" } }, "required": [ "source", "pointer", "fields" ], "type": "object" }, { "additionalProperties": false, "properties": { "fields": { "description": "1-12 fields with distinct names. CSS selectors are relative descendant queries inside a record. String types return normalized text; other types require exact JSON literals and existing safe-integer/finite-number validation. Required defaults true; unsupported features are rejected.", "items": { "additionalProperties": false, "description": "One named HTML field within each record. Exactly one matching descendant is required for a value; multiple matches are ambiguous, missing attributes/text nodes are not invented. The explicit type parses only an exact JSON scalar/object/array literal for non-string types; no currency stripping or locale coercion.", "properties": { "attribute": { "description": "Optional explicitly selected inert attribute. Allowed: href/src/alt/title/content/value/aria-label or data-* (1-48 lowercase letters/digits/underscores/hyphens). Omit for normalized descendant text. URLs are returned as untrusted strings, never fetched.", "pattern": "^(?:data-[a-z0-9_-]{1,48}|href|src|alt|title|content|value|aria-label)$", "type": "string" }, "name": { "description": "Unique output property name, 1-48 ASCII letters/digits/underscores, starting with a letter.", "pattern": "^[A-Za-z][A-Za-z0-9_]{0,47}$", "type": "string" }, "required": { "default": true, "description": "Default true. A missing required value makes complete:false; optional missing values are still reported. No invented default or placeholder value.", "type": "boolean" }, "selector": { "description": "One supported CSS selector, 1-256 characters, without comma groups or :scope. Matches static descendants only; no XPath, scripts, browser layout or linked-source fetching. Example: td:nth-child(2).", "maxLength": 256, "minLength": 1, "type": "string" }, "type": { "description": "Required exact JSON value type. No string-to-number coercion; integer requires a safe integer. object excludes arrays/null.", "enum": [ "string", "number", "integer", "boolean", "object", "array", "null" ], "type": "string" } }, "required": [ "name", "type", "selector" ], "type": "object" }, "maxItems": 12, "minItems": 1, "type": "array" }, "limit": { "default": 20, "description": "Maximum returned records, 1-25, default20. Excess records are counted as omitted; no automatic pagination, crawling or larger output budget. A shared16,384 selected-value byte/2,000-node budget applies across every record.", "maximum": 25, "minimum": 1, "type": "integer" }, "row_selector": { "description": "Required selector for repeated record elements, e.g. .product or tbody tr. No comma groups/:scope. Nested matching records and table rowspan/colspan other than1 are unsupported, never silently flattened.", "maxLength": 256, "minLength": 1, "type": "string" }, "source": { "const": "html", "description": "Select static HTML after the same normal exclusions and scope as ordinary Extract; JavaScript is never run.", "type": "string" } }, "required": [ "source", "row_selector", "fields" ], "type": "object" } ] }, "selector": { "description": "Optional HTML CSS scope, 1-256 characters, e.g. 'article'. If omitted, choose main, then article, then body, then the document. Explicit scope must match (otherwise 422). Built-in noise and ignore_selectors are removed. Not supported for JSON/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. 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 is not executed. DNS, redirect and size limits also apply.", "format": "uri", "maxLength": 4096, "pattern": "^[Hh][Tt][Tt][Pp][Ss]:\\/\\/", "type": "string" } }, "required": [ "url" ], "type": "object" }, "name": "fresh402_extract", "outputSchema": { "anyOf": [ { "properties": { "canonical_url": { "type": [ "string", "null" ] }, "content_kind": { "enum": [ "html", "json", "text" ] }, "data": {}, "data_omitted": { "type": "boolean" }, "description": { "type": [ "string", "null" ] }, "extractor_version": { "type": "integer" }, "feed": { "anyOf": [ { "properties": { "description": { "type": [ "string", "null" ] }, "entries": { "items": { "properties": { "content": { "type": [ "string", "null" ] }, "content_hash": { "description": "SHA256 of title,link,normalized publication time,summary and content; excludes poll/update timestamps and source position. Compare the same ID across retained client projections; does not prove semantic importance.", "type": "string" }, "evidence": { "properties": { "entry_index": { "type": "integer" }, "path": { "type": "string" } }, "required": [ "entry_index", "path" ], "type": "object" }, "id": { "type": "string" }, "identity_source": { "enum": [ "declared", "link", "content_hash" ] }, "link": { "type": [ "string", "null" ] }, "published_at": { "type": [ "string", "null" ] }, "published_raw": { "type": [ "string", "null" ] }, "summary": { "type": [ "string", "null" ] }, "title": { "type": [ "string", "null" ] }, "updated_at": { "type": [ "string", "null" ] }, "updated_raw": { "type": [ "string", "null" ] } }, "required": [ "id", "identity_source", "content_hash", "evidence" ], "type": "object" }, "maxItems": 100, "type": "array" }, "entries_deduplicated": { "type": "integer" }, "format": { "enum": [ "rss2", "atom" ] }, "id": { "type": "string" }, "identity_source": { "enum": [ "declared", "link", "source_url" ] }, "link": { "type": [ "string", "null" ] }, "parser_version": { "const": 1 }, "source_url": { "type": "string" }, "title": { "type": [ "string", "null" ] }, "updated_at": { "type": [ "string", "null" ] }, "updated_raw": { "type": [ "string", "null" ] }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "required": [ "format", "parser_version", "source_url", "id", "identity_source", "entries", "entries_deduplicated", "warnings" ], "type": "object" }, { "type": "null" } ], "description": "Only for feed_mode:entries; null when canonical projected text was clipped. Inert source-declared URLs are never crawled; raw timestamp evidence can be unrecognized. Feed/entry identity fallbacks are explicit." }, "feed_omitted": { "type": "boolean" }, "fetched_at": { "type": "string" }, "final_url": { "type": "string" }, "hash": { "type": "string" }, "headings": { "items": { "properties": { "level": { "type": "integer" }, "text": { "type": "string" } }, "type": "object" }, "type": "array" }, "json_pointer": { "description": "Present only for an explicitly selected exact JSON Pointer; text, data and hash describe that selected value after exclusions.", "type": "string" }, "json_pointers": { "items": { "description": "Ordered exact RFC6901 selection metadata; data/text/hash describe the full aggregate projection before clipping.", "type": "string" }, "type": "array" }, "links": { "items": { "properties": { "text": { "type": "string" }, "url": { "type": "string" } }, "type": "object" }, "type": "array" }, "records": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "description": "Typed repeated records from the one original JSON/static-HTML source. Every field has source evidence/status; global value budget and omitted-record counts are explicit. No browser, linked fetch, fabricated values or inferred business meaning.", "properties": { "complete": { "type": "boolean" }, "limit": { "maximum": 25, "minimum": 1, "type": "integer" }, "partial": { "type": "boolean" }, "records": { "items": { "additionalProperties": false, "properties": { "complete": { "type": "boolean" }, "data": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "fields": { "items": { "additionalProperties": false, "properties": { "name": { "type": "string" }, "required": { "type": "boolean" }, "source": { "additionalProperties": false, "properties": { "attribute": { "type": "string" }, "json_pointer": { "type": "string" }, "record_index": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "representation": { "enum": [ "normalized_json_after_exclusions", "static_html_after_exclusions" ], "type": "string" }, "row_selector": { "type": "string" }, "selector": { "type": "string" } }, "required": [ "representation" ], "type": "object" }, "status": { "enum": [ "ok", "missing", "invalid_type", "omitted_budget", "ambiguous", "truncated", "unsupported" ], "type": "string" }, "type": { "type": "string" }, "value": {} }, "required": [ "name", "required", "type", "status", "source" ], "type": "object" }, "maxItems": 12, "type": "array" }, "index": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "partial": { "type": "boolean" } }, "required": [ "index", "data", "fields", "complete", "partial" ], "type": "object" }, "maxItems": 25, "type": "array" }, "records_omitted": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "records_seen": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "schema": { "const": "fresh402-records-v1", "type": "string" }, "semantic_model_used": { "const": false, "type": "boolean" }, "source": { "enum": [ "html", "json" ], "type": "string" }, "source_authenticity": { "const": "not_verified", "type": "string" }, "value_bytes": { "maximum": 16384, "minimum": 0, "type": "integer" } }, "required": [ "schema", "source", "records", "records_seen", "records_omitted", "limit", "complete", "partial", "value_bytes", "semantic_model_used", "source_authenticity" ], "type": "object" }, "records_hash": { "type": "string" }, "representation": { "const": "feed_entries_v1", "description": "Present only for explicit feed_mode:entries. Existing content_kind remains text; existing watch/hash normalization is untouched." }, "structured": { "properties": { "complete": { "type": "boolean" }, "data": { "type": "object" }, "fields": { "items": { "properties": { "name": { "type": "string" }, "required": { "type": "boolean" }, "source": { "properties": { "json_pointer": { "type": "string" }, "representation": { "type": "string" } }, "type": "object" }, "status": { "enum": [ "ok", "missing", "invalid_type", "omitted_budget" ] }, "type": { "type": "string" }, "value": {} }, "required": [ "name", "required", "type", "status", "source" ], "type": "object" }, "type": "array" }, "invalid_fields": { "items": { "type": "string" }, "type": "array" }, "missing_fields": { "items": { "type": "string" }, "type": "array" }, "omitted_fields": { "items": { "type": "string" }, "type": "array" }, "partial": { "type": "boolean" }, "schema": { "const": "fresh402-typed-projection-v1" }, "semantic_model_used": { "type": "boolean" }, "source_authenticity": { "type": "string" }, "value_bytes": { "type": "integer" } }, "type": "object" }, "structured_data": { "items": {}, "type": "array" }, "structured_hash": { "type": "string" }, "text": { "type": "string" }, "text_length": { "type": "integer" }, "title": { "type": [ "string", "null" ] }, "truncated": { "type": "boolean" }, "url": { "type": "string" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "required": [ "url", "final_url", "content_kind", "text", "truncated", "hash" ], "type": "object" }, { "description": "Tool error only; accompanied by isError=true.", "properties": { "error": { "minLength": 1, "type": "string" }, "retryable": { "type": "boolean" }, "status": { "type": "integer" } }, "required": [ "error" ], "type": "object" }, { "description": "Unpaid x402 v2 quote only; accompanied by isError=true. No product execution or financial authorization.", "properties": { "accepts": { "minItems": 1, "type": "array" }, "resource": { "type": "object" }, "x402Version": { "const": 2 } }, "required": [ "x402Version", "accepts" ], "type": "object" } ], "description": "A successful tool execution follows the canonical result branch. isError=true denotes an error or unpaid payment challenge, never successful execution or payment. Inspect isError before interpreting structuredContent.", "properties": { "canonical_url": { "type": [ "string", "null" ] }, "content_kind": { "enum": [ "html", "json", "text" ] }, "data": {}, "data_omitted": { "type": "boolean" }, "description": { "type": [ "string", "null" ] }, "extractor_version": { "type": "integer" }, "feed": { "anyOf": [ { "properties": { "description": { "type": [ "string", "null" ] }, "entries": { "items": { "properties": { "content": { "type": [ "string", "null" ] }, "content_hash": { "description": "SHA256 of title,link,normalized publication time,summary and content; excludes poll/update timestamps and source position. Compare the same ID across retained client projections; does not prove semantic importance.", "type": "string" }, "evidence": { "properties": { "entry_index": { "type": "integer" }, "path": { "type": "string" } }, "required": [ "entry_index", "path" ], "type": "object" }, "id": { "type": "string" }, "identity_source": { "enum": [ "declared", "link", "content_hash" ] }, "link": { "type": [ "string", "null" ] }, "published_at": { "type": [ "string", "null" ] }, "published_raw": { "type": [ "string", "null" ] }, "summary": { "type": [ "string", "null" ] }, "title": { "type": [ "string", "null" ] }, "updated_at": { "type": [ "string", "null" ] }, "updated_raw": { "type": [ "string", "null" ] } }, "required": [ "id", "identity_source", "content_hash", "evidence" ], "type": "object" }, "maxItems": 100, "type": "array" }, "entries_deduplicated": { "type": "integer" }, "format": { "enum": [ "rss2", "atom" ] }, "id": { "type": "string" }, "identity_source": { "enum": [ "declared", "link", "source_url" ] }, "link": { "type": [ "string", "null" ] }, "parser_version": { "const": 1 }, "source_url": { "type": "string" }, "title": { "type": [ "string", "null" ] }, "updated_at": { "type": [ "string", "null" ] }, "updated_raw": { "type": [ "string", "null" ] }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "required": [ "format", "parser_version", "source_url", "id", "identity_source", "entries", "entries_deduplicated", "warnings" ], "type": "object" }, { "type": "null" } ], "description": "Only for feed_mode:entries; null when canonical projected text was clipped. Inert source-declared URLs are never crawled; raw timestamp evidence can be unrecognized. Feed/entry identity fallbacks are explicit." }, "feed_omitted": { "type": "boolean" }, "fetched_at": { "type": "string" }, "final_url": { "type": "string" }, "hash": { "type": "string" }, "headings": { "items": { "properties": { "level": { "type": "integer" }, "text": { "type": "string" } }, "type": "object" }, "type": "array" }, "json_pointer": { "description": "Present only for an explicitly selected exact JSON Pointer; text, data and hash describe that selected value after exclusions.", "type": "string" }, "json_pointers": { "items": { "description": "Ordered exact RFC6901 selection metadata; data/text/hash describe the full aggregate projection before clipping.", "type": "string" }, "type": "array" }, "links": { "items": { "properties": { "text": { "type": "string" }, "url": { "type": "string" } }, "type": "object" }, "type": "array" }, "records": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "description": "Typed repeated records from the one original JSON/static-HTML source. Every field has source evidence/status; global value budget and omitted-record counts are explicit. No browser, linked fetch, fabricated values or inferred business meaning.", "properties": { "complete": { "type": "boolean" }, "limit": { "maximum": 25, "minimum": 1, "type": "integer" }, "partial": { "type": "boolean" }, "records": { "items": { "additionalProperties": false, "properties": { "complete": { "type": "boolean" }, "data": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "fields": { "items": { "additionalProperties": false, "properties": { "name": { "type": "string" }, "required": { "type": "boolean" }, "source": { "additionalProperties": false, "properties": { "attribute": { "type": "string" }, "json_pointer": { "type": "string" }, "record_index": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "representation": { "enum": [ "normalized_json_after_exclusions", "static_html_after_exclusions" ], "type": "string" }, "row_selector": { "type": "string" }, "selector": { "type": "string" } }, "required": [ "representation" ], "type": "object" }, "status": { "enum": [ "ok", "missing", "invalid_type", "omitted_budget", "ambiguous", "truncated", "unsupported" ], "type": "string" }, "type": { "type": "string" }, "value": {} }, "required": [ "name", "required", "type", "status", "source" ], "type": "object" }, "maxItems": 12, "type": "array" }, "index": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "partial": { "type": "boolean" } }, "required": [ "index", "data", "fields", "complete", "partial" ], "type": "object" }, "maxItems": 25, "type": "array" }, "records_omitted": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "records_seen": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "schema": { "const": "fresh402-records-v1", "type": "string" }, "semantic_model_used": { "const": false, "type": "boolean" }, "source": { "enum": [ "html", "json" ], "type": "string" }, "source_authenticity": { "const": "not_verified", "type": "string" }, "value_bytes": { "maximum": 16384, "minimum": 0, "type": "integer" } }, "required": [ "schema", "source", "records", "records_seen", "records_omitted", "limit", "complete", "partial", "value_bytes", "semantic_model_used", "source_authenticity" ], "type": "object" }, "records_hash": { "type": "string" }, "representation": { "const": "feed_entries_v1", "description": "Present only for explicit feed_mode:entries. Existing content_kind remains text; existing watch/hash normalization is untouched." }, "structured": { "properties": { "complete": { "type": "boolean" }, "data": { "type": "object" }, "fields": { "items": { "properties": { "name": { "type": "string" }, "required": { "type": "boolean" }, "source": { "properties": { "json_pointer": { "type": "string" }, "representation": { "type": "string" } }, "type": "object" }, "status": { "enum": [ "ok", "missing", "invalid_type", "omitted_budget" ] }, "type": { "type": "string" }, "value": {} }, "required": [ "name", "required", "type", "status", "source" ], "type": "object" }, "type": "array" }, "invalid_fields": { "items": { "type": "string" }, "type": "array" }, "missing_fields": { "items": { "type": "string" }, "type": "array" }, "omitted_fields": { "items": { "type": "string" }, "type": "array" }, "partial": { "type": "boolean" }, "schema": { "const": "fresh402-typed-projection-v1" }, "semantic_model_used": { "type": "boolean" }, "source_authenticity": { "type": "string" }, "value_bytes": { "type": "integer" } }, "type": "object" }, "structured_data": { "items": {}, "type": "array" }, "structured_hash": { "type": "string" }, "text": { "type": "string" }, "text_length": { "type": "integer" }, "title": { "type": [ "string", "null" ] }, "truncated": { "type": "boolean" }, "url": { "type": "string" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "type": "object" } }, { "description": "Combine selected code/proxy observations, contract-reported token facts and one wallet's single-block ETH/Transfer evidence at one finalized Base block. Shared RPC cache; at most 18 reads. Wallet scope remains a restricted pilot; no complete history or security score. One fixed workflow charge; internal steps never create separate customer charges. Each call selects one finalized Base block. Reuse its contract_snapshot_id only as previous_contract_snapshot for compatible contract comparison; this workflow accepts no observation_id. Auth: authorized native-USDC x402 v2 on Base, enabled MPP, or an eligible prepaid key plus exact tariff 5 and max_credits. Ordinary unpaid calls return a challenge, not execution. Persist original input, proof and recovery token before submission; exact replay returns retained results without fresh work or another charge. Choose evidence detail before authorization. No free-trial or automatic paid fallback. 0.025 USDC or 10 credits. Limits and scope are authoritative, not a complete audit or compatibility guarantee. The same fixed x402 service price may also be paid in native Circle USDC on Solana Mainnet (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp), when advertised by the unpaid challenge. Explicitly select one accepted network and pin its mint, merchant, amount and sponsored fee payer before signing. Solana payers need no Base wallet; Standalone native Solana MPP solana/charge is also advertised; its client pays a separately authorized SOL network fee, with no server fee sponsorship. Prepaid MPP funding remains Base-only. Payment network does not change the observed chain: blockchain products still inspect finalized Base. Solana delivery requires finalized matching USDC evidence. Persist the original network, resource, input, proof and private recovery capability; never switch networks or authorize a replacement after uncertainty.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "chain_id": { "const": 8453, "description": "Base mainnet only; provider chain is verified. All state is pinned to one selected finalized block.", "type": "number" }, "contract_address": { "description": "One selected contract which is also the token-facts and Transfer-log contract. The workflow does not infer that arbitrary bytecode is a safe or compliant token.", "maxLength": 42, "minLength": 42, "pattern": "^0x[a-fA-F0-9]{40}$", "type": "string" }, "detail": { "default": "compact", "description": "Default compact: at most 20 evidence items per section. Expanded allows at most 200 document findings or 100 Base events and retains raw validated logs/getter ABI details within the same fixed work/output ceiling. Counts and omitted-evidence warnings remain explicit.", "enum": [ "compact", "expanded" ], "type": "string" }, "previous_contract_snapshot": { "description": "Optional owned contract_snapshot_id from this workflow's same narrow code/proxy scope; incompatible primitive snapshots are rejected. Allows bounded selected-contract comparison.", "pattern": "^s_[a-f0-9]{64}$", "type": "string" }, "wallet_address": { "description": "One selected wallet. Returns its exact native-ETH balance and this contract's provider-reported Transfer events at the single selected finalized block, not complete wallet history.", "maxLength": 42, "minLength": 42, "pattern": "^0x[a-fA-F0-9]{40}$", "type": "string" } }, "required": [ "chain_id", "contract_address", "wallet_address" ], "type": "object" }, "name": "fresh402_onchain_evidence_brief", "outputSchema": { "anyOf": [ { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "accounting": { "additionalProperties": {}, "description": "Actual bounded execution counters, not inferred model-token savings or a billing invoice.", "propertyNames": { "type": "string" }, "type": "object" }, "billing": { "additionalProperties": false, "properties": { "atomic_usdc": { "pattern": "^\\d+$", "type": "string" }, "credits": { "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "internal_charges": { "const": 0, "type": "number" }, "one_financial_operation": { "const": true, "type": "boolean" }, "tariff_version": { "const": 5, "type": "number" } }, "required": [ "internal_charges", "one_financial_operation", "tariff_version", "credits", "atomic_usdc" ], "type": "object" }, "completeness": { "additionalProperties": {}, "description": "Scope and uncertainty are authoritative; wallet history and independent provider consensus are never asserted.", "propertyNames": { "type": "string" }, "type": "object" }, "evidence": { "additionalProperties": false, "properties": { "contract": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "token": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "wallet": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" } }, "required": [ "contract", "token", "wallet" ], "type": "object" }, "observation_id": { "pattern": "^wf_[a-f0-9]{64}$", "type": "string" }, "observed_at": { "type": "string" }, "persistence_error": { "type": "string" }, "portable_state": { "anyOf": [ { "additionalProperties": false, "properties": { "caller_retention_days": { "const": 30, "type": "number" }, "expires_at": { "type": "string" }, "observed_at": { "type": "string" }, "payload_bytes": { "maximum": 32768, "minimum": 0, "type": "integer" }, "payment_authority": { "const": false, "type": "boolean" }, "retention_extended": { "const": false, "type": "boolean" }, "server_retention_days": { "const": 7, "type": "number" }, "source_freshness_verified": { "const": false, "type": "boolean" }, "status": { "const": "available", "type": "string" }, "token": { "maxLength": 44000, "type": "string" } }, "required": [ "status", "token", "expires_at", "observed_at", "payload_bytes", "server_retention_days", "caller_retention_days", "retention_extended", "payment_authority", "source_freshness_verified" ], "type": "object" }, { "additionalProperties": false, "properties": { "max_payload_bytes": { "const": 32768, "type": "number" }, "retention_extended": { "const": false, "type": "boolean" }, "status": { "const": "omitted_size", "type": "string" } }, "required": [ "status", "max_payload_bytes", "retention_extended" ], "type": "object" } ], "description": "Opt-in private caller-retained source evidence, independently integrity-protected and bound to principal/workflow/environment/scope. Not encryption, payment authority, current freshness or an extension of original-result/server retention." }, "provenance": { "additionalProperties": false, "properties": { "block": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "contract_snapshot_id": { "type": "string" }, "observation_saved": { "type": "boolean" } }, "required": [ "block", "contract_snapshot_id", "observation_saved" ], "type": "object" }, "snapshot_saved": { "type": "boolean" }, "state_expires_at": { "type": "string" }, "status": { "enum": [ "baseline_seeded", "no_supported_contract_change", "unchanged_in_scope", "changed_in_scope", "review_required", "descriptive_only", "evidence_ready" ], "type": "string" }, "summary": { "additionalProperties": {}, "description": "Task-level result; a seeded baseline is not a comparison, and evidence does not prove deployment or causation.", "properties": { "changed": { "type": [ "boolean", "null" ] }, "comparison": { "enum": [ "seeded", "previous", "baseline", "supplied", "portable" ], "type": "string" }, "consistency": { "const": "not_established", "type": "string" }, "findings": { "anyOf": [ { "type": "string" }, { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" } ] }, "release_label": { "type": "string" } }, "type": "object" }, "version": { "const": 1, "type": "number" }, "warnings": { "items": { "type": "string" }, "maxItems": 50, "type": "array" }, "workflow": { "const": "onchain_evidence_brief", "type": "string" }, "workflow_state_saved": { "type": "boolean" } }, "required": [ "workflow", "version", "status", "observed_at", "summary", "evidence", "provenance", "completeness", "warnings", "accounting", "billing" ], "type": "object" }, { "description": "Tool error only; accompanied by isError=true.", "properties": { "error": { "minLength": 1, "type": "string" }, "retryable": { "type": "boolean" }, "status": { "type": "integer" } }, "required": [ "error" ], "type": "object" }, { "description": "Unpaid x402 v2 quote only; accompanied by isError=true. No product execution or financial authorization.", "properties": { "accepts": { "minItems": 1, "type": "array" }, "resource": { "type": "object" }, "x402Version": { "const": 2 } }, "required": [ "x402Version", "accepts" ], "type": "object" } ], "description": "A successful tool execution follows the canonical result branch. isError=true denotes an error or unpaid payment challenge, never successful execution or payment. Inspect isError before interpreting structuredContent.", "properties": { "accounting": { "additionalProperties": {}, "description": "Actual bounded execution counters, not inferred model-token savings or a billing invoice.", "propertyNames": { "type": "string" }, "type": "object" }, "billing": { "additionalProperties": false, "properties": { "atomic_usdc": { "pattern": "^\\d+$", "type": "string" }, "credits": { "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "internal_charges": { "const": 0, "type": "number" }, "one_financial_operation": { "const": true, "type": "boolean" }, "tariff_version": { "const": 5, "type": "number" } }, "required": [ "internal_charges", "one_financial_operation", "tariff_version", "credits", "atomic_usdc" ], "type": "object" }, "completeness": { "additionalProperties": {}, "description": "Scope and uncertainty are authoritative; wallet history and independent provider consensus are never asserted.", "propertyNames": { "type": "string" }, "type": "object" }, "evidence": { "additionalProperties": false, "properties": { "contract": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "token": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "wallet": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" } }, "required": [ "contract", "token", "wallet" ], "type": "object" }, "observation_id": { "pattern": "^wf_[a-f0-9]{64}$", "type": "string" }, "observed_at": { "type": "string" }, "persistence_error": { "type": "string" }, "portable_state": { "anyOf": [ { "additionalProperties": false, "properties": { "caller_retention_days": { "const": 30, "type": "number" }, "expires_at": { "type": "string" }, "observed_at": { "type": "string" }, "payload_bytes": { "maximum": 32768, "minimum": 0, "type": "integer" }, "payment_authority": { "const": false, "type": "boolean" }, "retention_extended": { "const": false, "type": "boolean" }, "server_retention_days": { "const": 7, "type": "number" }, "source_freshness_verified": { "const": false, "type": "boolean" }, "status": { "const": "available", "type": "string" }, "token": { "maxLength": 44000, "type": "string" } }, "required": [ "status", "token", "expires_at", "observed_at", "payload_bytes", "server_retention_days", "caller_retention_days", "retention_extended", "payment_authority", "source_freshness_verified" ], "type": "object" }, { "additionalProperties": false, "properties": { "max_payload_bytes": { "const": 32768, "type": "number" }, "retention_extended": { "const": false, "type": "boolean" }, "status": { "const": "omitted_size", "type": "string" } }, "required": [ "status", "max_payload_bytes", "retention_extended" ], "type": "object" } ], "description": "Opt-in private caller-retained source evidence, independently integrity-protected and bound to principal/workflow/environment/scope. Not encryption, payment authority, current freshness or an extension of original-result/server retention." }, "provenance": { "additionalProperties": false, "properties": { "block": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "contract_snapshot_id": { "type": "string" }, "observation_saved": { "type": "boolean" } }, "required": [ "block", "contract_snapshot_id", "observation_saved" ], "type": "object" }, "snapshot_saved": { "type": "boolean" }, "state_expires_at": { "type": "string" }, "status": { "enum": [ "baseline_seeded", "no_supported_contract_change", "unchanged_in_scope", "changed_in_scope", "review_required", "descriptive_only", "evidence_ready" ], "type": "string" }, "summary": { "additionalProperties": {}, "description": "Task-level result; a seeded baseline is not a comparison, and evidence does not prove deployment or causation.", "properties": { "changed": { "type": [ "boolean", "null" ] }, "comparison": { "enum": [ "seeded", "previous", "baseline", "supplied", "portable" ], "type": "string" }, "consistency": { "const": "not_established", "type": "string" }, "findings": { "anyOf": [ { "type": "string" }, { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" } ] }, "release_label": { "type": "string" } }, "type": "object" }, "version": { "const": 1, "type": "number" }, "warnings": { "items": { "type": "string" }, "maxItems": 50, "type": "array" }, "workflow": { "const": "onchain_evidence_brief", "type": "string" }, "workflow_state_saved": { "type": "boolean" } }, "type": "object" } }, { "description": "Observes public documents without modifying their source. Execution can charge USDC or prepaid credits, consume trial quota and update Fresh402 records. A new charge requires prior spending authorization. Without billing/trial credentials, a valid call returns an unpaid quote without executing the observation. Use for bounded directional OpenAPI3.0/3.1 JSON contract-change evidence, including supported paths/operations, required fields, types/enums/null and authentication. Use exactly one real watch_id from free unfiltered registration or contracts:{before,after} serialized JSON or bounded YAML 1.2 strings (256,000 characters and UTF-8 bytes each/512,000 combined bytes; only supplied-OpenAPI requests allow a 786,432-byte total envelope). Supplied pairs compare before to after without a fetch or saved watch; omit comparison overrides. Same price and original-operation recovery. Stored mode has no URL override. compare_to: previous(default) or baseline; previous_hash overrides with supported retained evidence. First stored-watch call seeds contract history; explicit pairs compare immediately and return a conservative CI verdict. No YAML watch sources, external-reference fetch or endpoint execution; bounded YAML is supplied-pair only; uncertainty requires review, not a complete compatibility proof. Save and reuse watch IDs across sessions. For a complete single-charge server workflow, use API Compatibility Review when advertised. Rules v3 adds finite numeric/exclusive integer bounds, scalar const in3.1, scalar-item array cardinality and otherwise-identical boolean object closure. Unsupported constraint interactions remain review_required. Optional review contains stable finding IDs, affected operations, bounded excerpts and CI0/1/2; no customer-code inspection or release-safety guarantee. $0.020 USDC/call on Base (eip155:8453), including cache hits. Needs an x402-capable MCP payment client and funded native-USDC payer; ordinary MCP returns a payment challenge. Optional MPP (root mpp_payments.enabled): mppx, org.paymentauth/credential. Prepaid: X-Fresh402-API-Key plus params._meta[\"fresh402/prepaid\"] {idempotency_key,tariff_version,max_credits}; inspect authenticated quote. Choose one billing method; never auto-pay. Persist original proof/input/private recovery token; recover originals after uncertainty. Circle only if root circle_gateway.enabled. Clients, limits and recovery: https://fresh402.com/docs#payments. Free signed trial: /v3/agent-trial requires an unfunded EOA ownership signature; human Web trial: /v2/trial. Eligibility/capacity may return429. Use only X-Fresh402-Trial-Key plus persisted Idempotency-Key; replay exact tool/input/key. Exhaustion never authorizes a charge. The same fixed x402 service price may also be paid in native Circle USDC on Solana Mainnet (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp), when advertised by the unpaid challenge. Explicitly select one accepted network and pin its mint, merchant, amount and sponsored fee payer before signing. Solana payers need no Base wallet; Standalone native Solana MPP solana/charge is also advertised; its client pays a separately authorized SOL network fee, with no server fee sponsorship. Prepaid MPP funding remains Base-only. Payment network does not change the observed chain: blockchain products still inspect finalized Base. Solana delivery requires finalized matching USDC evidence. Persist the original network, resource, input, proof and private recovery capability; never switch networks or authorize a replacement after uncertainty.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "description": "Compare exactly one registered watch or an explicit contracts:{before,after} pair. Stored mode preserves previous/baseline/hash behavior. Supplied mode uses before to after, no fetch, no watch mutation or saved observation; omit comparison overrides. Same existing fixed price and original-operation recovery. Bounded document evidence, not live compatibility proof.", "oneOf": [ { "not": { "required": [ "contracts" ] }, "required": [ "watch_id" ] }, { "not": { "anyOf": [ { "required": [ "watch_id" ] }, { "required": [ "previous_hash" ] } ] }, "properties": { "compare_to": { "const": "previous" } }, "required": [ "contracts" ] } ], "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" }, "contracts": { "additionalProperties": false, "description": "Explicit CI comparison, exclusive with a stored source/watch. Combined contract text <=512,000 UTF-8 bytes; only these two supplied-OpenAPI products allow a complete HTTP/MCP envelope <=786,432 bytes, including JSON escaping and payment metadata. All parser, reference, work and output budgets still apply. No source fetches or saved observation; the original authorized operation remains durably recoverable.", "properties": { "after": { "description": "New complete OpenAPI 3.0/3.1 contract serialized as JSON or bounded YAML 1.2; at most 256,000 characters and 256,000 UTF-8 bytes, same restrictions as before. Direction is before to after; source authenticity and deployed behavior are not verified.", "maxLength": 256000, "minLength": 1, "type": "string" }, "before": { "description": "Old complete OpenAPI 3.0/3.1 contract serialized as JSON or bounded YAML 1.2; at most 256,000 characters and 256,000 UTF-8 bytes. Duplicate JSON names are rejected. YAML rejects anchors/aliases, tags, merges, duplicate or complex keys and nonfinite values. No executed code or remote-reference fetching.", "maxLength": 256000, "minLength": 1, "type": "string" } }, "required": [ "before", "after" ], "type": "object" }, "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": "Existing watch ID: 'w_' plus 32 lowercase hexadecimal characters. Required unless contracts is supplied; these inputs are exclusive. Obtain it with free Register using the public JSON OpenAPI 3.0/3.1 URL and no selector or ignore rules. Reuses the saved URL. No URL override, YAML or scoped/filtered watches.", "pattern": "^w_[a-f0-9]{32}$", "type": "string" } }, "type": "object" }, "name": "fresh402_openapi_contract_diff", "outputSchema": { "anyOf": [ { "oneOf": [ { "not": { "required": [ "input_source" ] }, "required": [ "watch_id" ] }, { "not": { "required": [ "watch_id" ] }, "properties": { "input_source": { "const": "supplied_contracts" } }, "required": [ "input_source", "verdict", "compared_at", "source_fetches", "observation_saved" ] } ], "properties": { "algorithm": { "type": "string" }, "assumptions": { "items": { "type": "string" }, "type": "array" }, "changed": { "type": "boolean" }, "changes": { "items": { "properties": { "after": { "type": "string" }, "before": { "type": "string" }, "classification": { "enum": [ "definitely_breaking", "potentially_breaking", "additive", "unclassified" ] }, "evidence_index": { "description": "Opt-in contract view only: index in the full original durable changes list.", "minimum": 0, "type": "integer" }, "path": { "type": "string" }, "rule": { "type": "string" }, "scope": { "enum": [ "selected_operation", "shared_or_unknown" ] } }, "required": [ "classification", "rule", "path" ], "type": "object" }, "type": "array" }, "changes_truncated": { "type": "boolean" }, "compare_to": { "enum": [ "previous", "baseline", "hash", "supplied" ] }, "compared_at": { "type": "string" }, "comparison_source": { "type": "string" }, "contract_view": { "properties": { "counts_scope": { "const": "full_document" }, "excluded_operation_changes": { "type": "integer" }, "hash_scope": { "type": "string" }, "limitation": { "type": "string" }, "original_result_sha256": { "type": "string" }, "representation": { "const": "contract-impact-v1" }, "status": { "enum": [ "breaking", "review_required", "no_breaking_change_observed" ] }, "used_operations": { "items": { "properties": { "method": { "enum": [ "get", "put", "post", "delete", "options", "head", "patch", "trace" ] }, "path": { "type": "string" } }, "required": [ "path", "method" ], "type": "object" }, "type": "array" } }, "type": "object" }, "counts": { "properties": { "additive": { "type": "integer" }, "definitely_breaking": { "type": "integer" }, "potentially_breaking": { "type": "integer" }, "unclassified": { "type": "integer" } }, "type": "object" }, "descriptive_only": { "type": "boolean" }, "fetched_at": { "type": "string" }, "final_url": { "type": "string" }, "hash": { "type": "string" }, "input_source": { "const": "supplied_contracts" }, "observation_saved": { "type": "boolean" }, "openapi_versions": { "properties": { "after": { "type": "string" }, "before": { "type": "string" } }, "type": "object" }, "previous_hash": { "type": "string" }, "reference_resolutions": { "type": "integer" }, "review": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "description": "Versioned Release Guardian evidence. Findings and excerpts are bounded; pointers refer to the full original result. A skipped comparator reports not_compared/CI2, never automatic approval. No customer code, live API behavior or deployment safety is established.", "properties": { "comparison_performed": { "type": "boolean" }, "complete": { "type": "boolean" }, "findings": { "items": { "additionalProperties": false, "properties": { "affected_path": { "type": "string" }, "after": { "type": [ "string", "null" ] }, "before": { "type": [ "string", "null" ] }, "compatibility_direction": { "enum": [ "request", "response", "authentication", "operation_or_shared" ], "type": "string" }, "complete": { "type": "boolean" }, "confidence": { "enum": [ "supported_rule", "requires_review" ], "type": "string" }, "evidence": { "additionalProperties": false, "properties": { "after_sha256": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "after_source_pointer": { "type": [ "string", "null" ] }, "before_sha256": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "before_source_pointer": { "type": [ "string", "null" ] }, "change_pointer": { "type": "string" }, "change_pointer_scope": { "const": "full_original_result", "type": "string" }, "excerpts_may_be_truncated": { "const": true, "type": "boolean" }, "source_pointer_scope": { "const": "parsed_original_contract_declaration", "type": "string" } }, "required": [ "change_pointer", "change_pointer_scope", "before_sha256", "after_sha256", "excerpts_may_be_truncated" ], "type": "object" }, "explanation": { "type": "string" }, "finding_id": { "pattern": "^cf_[a-f0-9]{64}$", "type": "string" }, "operations": { "items": { "type": "string" }, "maxItems": 8, "type": "array" }, "recommended_action": { "enum": [ "block_and_review", "inspect_with_other_findings", "manual_review" ], "type": "string" }, "rule_id": { "type": "string" }, "severity": { "enum": [ "error", "warning", "info" ], "type": "string" } }, "required": [ "finding_id", "rule_id", "severity", "compatibility_direction", "affected_path", "operations", "complete", "before", "after", "explanation", "evidence", "confidence", "recommended_action" ], "type": "object" }, "maxItems": 20, "type": "array" }, "findings_omitted": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "findings_total": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "groups": { "additionalProperties": { "items": { "type": "string" }, "maxItems": 20, "type": "array" }, "propertyNames": { "type": "string" }, "type": "object" }, "input_fingerprints": { "additionalProperties": false, "properties": { "after_sha256": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "before_sha256": { "anyOf": [ { "pattern": "^[a-f0-9]{64}$", "type": "string" }, { "type": "null" } ] } }, "required": [ "before_sha256", "after_sha256" ], "type": "object" }, "reason": { "enum": [ "baseline_seeded", "hash_unchanged" ], "type": "string" }, "result_id": { "pattern": "^review_[a-f0-9]{64}$", "type": "string" }, "schema": { "const": "fresh402-contract-review-v1", "type": "string" }, "scope": { "type": "string" }, "verdict": { "additionalProperties": false, "properties": { "ci_exit_code": { "anyOf": [ { "const": 0, "type": "number" }, { "const": 1, "type": "number" }, { "const": 2, "type": "number" } ] }, "live_api_verified": { "const": false, "type": "boolean" }, "scope": { "type": "string" }, "status": { "enum": [ "breaking", "review_required", "no_breaking_change_observed", "not_compared" ], "type": "string" }, "unsupported_features_require_review": { "const": true, "type": "boolean" } }, "required": [ "status", "ci_exit_code", "live_api_verified" ], "type": "object" } }, "required": [ "schema", "comparison_performed", "verdict", "input_fingerprints", "findings", "findings_total", "findings_omitted", "groups", "complete" ], "type": "object" }, "rules_version": { "type": "integer" }, "semantic_model_used": { "type": "boolean" }, "source_fetches": { "type": "integer" }, "source_provenance": { "properties": { "after_input_sha256": { "type": "string" }, "after_sha256": { "type": "string" }, "baseline_at": { "type": "string" }, "baseline_url": { "type": "string" }, "before_input_sha256": { "type": "string" }, "before_sha256": { "type": "string" }, "final_url": { "type": "string" }, "fingerprint_scope": { "type": "string" }, "input_source": { "type": "string" }, "raw_source_hash": { "type": "string" }, "registered_core_hash": { "type": "string" }, "requested_url": { "type": "string" }, "source_authenticity": { "type": "string" } }, "type": "object" }, "url": { "type": "string" }, "verdict": { "properties": { "ci_exit_code": { "type": "integer" }, "live_api_verified": { "type": "boolean" }, "scope": { "type": "string" }, "status": { "enum": [ "breaking", "review_required", "no_breaking_change_observed" ] }, "unsupported_features_require_review": { "type": "boolean" } }, "type": "object" }, "warnings": { "items": { "type": "string" }, "type": "array" }, "watch_id": { "type": "string" }, "work_units": { "type": "integer" } }, "required": [ "hash", "previous_hash", "changed", "changes", "counts", "source_provenance", "rules_version" ], "type": "object" }, { "description": "Tool error only; accompanied by isError=true.", "properties": { "error": { "minLength": 1, "type": "string" }, "retryable": { "type": "boolean" }, "status": { "type": "integer" } }, "required": [ "error" ], "type": "object" }, { "description": "Unpaid x402 v2 quote only; accompanied by isError=true. No product execution or financial authorization.", "properties": { "accepts": { "minItems": 1, "type": "array" }, "resource": { "type": "object" }, "x402Version": { "const": 2 } }, "required": [ "x402Version", "accepts" ], "type": "object" } ], "description": "A successful tool execution follows the canonical result branch. isError=true denotes an error or unpaid payment challenge, never successful execution or payment. Inspect isError before interpreting structuredContent.", "properties": { "algorithm": { "type": "string" }, "assumptions": { "items": { "type": "string" }, "type": "array" }, "changed": { "type": "boolean" }, "changes": { "items": { "properties": { "after": { "type": "string" }, "before": { "type": "string" }, "classification": { "enum": [ "definitely_breaking", "potentially_breaking", "additive", "unclassified" ] }, "evidence_index": { "description": "Opt-in contract view only: index in the full original durable changes list.", "minimum": 0, "type": "integer" }, "path": { "type": "string" }, "rule": { "type": "string" }, "scope": { "enum": [ "selected_operation", "shared_or_unknown" ] } }, "required": [ "classification", "rule", "path" ], "type": "object" }, "type": "array" }, "changes_truncated": { "type": "boolean" }, "compare_to": { "enum": [ "previous", "baseline", "hash", "supplied" ] }, "compared_at": { "type": "string" }, "comparison_source": { "type": "string" }, "contract_view": { "properties": { "counts_scope": { "const": "full_document" }, "excluded_operation_changes": { "type": "integer" }, "hash_scope": { "type": "string" }, "limitation": { "type": "string" }, "original_result_sha256": { "type": "string" }, "representation": { "const": "contract-impact-v1" }, "status": { "enum": [ "breaking", "review_required", "no_breaking_change_observed" ] }, "used_operations": { "items": { "properties": { "method": { "enum": [ "get", "put", "post", "delete", "options", "head", "patch", "trace" ] }, "path": { "type": "string" } }, "required": [ "path", "method" ], "type": "object" }, "type": "array" } }, "type": "object" }, "counts": { "properties": { "additive": { "type": "integer" }, "definitely_breaking": { "type": "integer" }, "potentially_breaking": { "type": "integer" }, "unclassified": { "type": "integer" } }, "type": "object" }, "descriptive_only": { "type": "boolean" }, "fetched_at": { "type": "string" }, "final_url": { "type": "string" }, "hash": { "type": "string" }, "input_source": { "const": "supplied_contracts" }, "observation_saved": { "type": "boolean" }, "openapi_versions": { "properties": { "after": { "type": "string" }, "before": { "type": "string" } }, "type": "object" }, "previous_hash": { "type": "string" }, "reference_resolutions": { "type": "integer" }, "review": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "description": "Versioned Release Guardian evidence. Findings and excerpts are bounded; pointers refer to the full original result. A skipped comparator reports not_compared/CI2, never automatic approval. No customer code, live API behavior or deployment safety is established.", "properties": { "comparison_performed": { "type": "boolean" }, "complete": { "type": "boolean" }, "findings": { "items": { "additionalProperties": false, "properties": { "affected_path": { "type": "string" }, "after": { "type": [ "string", "null" ] }, "before": { "type": [ "string", "null" ] }, "compatibility_direction": { "enum": [ "request", "response", "authentication", "operation_or_shared" ], "type": "string" }, "complete": { "type": "boolean" }, "confidence": { "enum": [ "supported_rule", "requires_review" ], "type": "string" }, "evidence": { "additionalProperties": false, "properties": { "after_sha256": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "after_source_pointer": { "type": [ "string", "null" ] }, "before_sha256": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "before_source_pointer": { "type": [ "string", "null" ] }, "change_pointer": { "type": "string" }, "change_pointer_scope": { "const": "full_original_result", "type": "string" }, "excerpts_may_be_truncated": { "const": true, "type": "boolean" }, "source_pointer_scope": { "const": "parsed_original_contract_declaration", "type": "string" } }, "required": [ "change_pointer", "change_pointer_scope", "before_sha256", "after_sha256", "excerpts_may_be_truncated" ], "type": "object" }, "explanation": { "type": "string" }, "finding_id": { "pattern": "^cf_[a-f0-9]{64}$", "type": "string" }, "operations": { "items": { "type": "string" }, "maxItems": 8, "type": "array" }, "recommended_action": { "enum": [ "block_and_review", "inspect_with_other_findings", "manual_review" ], "type": "string" }, "rule_id": { "type": "string" }, "severity": { "enum": [ "error", "warning", "info" ], "type": "string" } }, "required": [ "finding_id", "rule_id", "severity", "compatibility_direction", "affected_path", "operations", "complete", "before", "after", "explanation", "evidence", "confidence", "recommended_action" ], "type": "object" }, "maxItems": 20, "type": "array" }, "findings_omitted": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "findings_total": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "groups": { "additionalProperties": { "items": { "type": "string" }, "maxItems": 20, "type": "array" }, "propertyNames": { "type": "string" }, "type": "object" }, "input_fingerprints": { "additionalProperties": false, "properties": { "after_sha256": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "before_sha256": { "anyOf": [ { "pattern": "^[a-f0-9]{64}$", "type": "string" }, { "type": "null" } ] } }, "required": [ "before_sha256", "after_sha256" ], "type": "object" }, "reason": { "enum": [ "baseline_seeded", "hash_unchanged" ], "type": "string" }, "result_id": { "pattern": "^review_[a-f0-9]{64}$", "type": "string" }, "schema": { "const": "fresh402-contract-review-v1", "type": "string" }, "scope": { "type": "string" }, "verdict": { "additionalProperties": false, "properties": { "ci_exit_code": { "anyOf": [ { "const": 0, "type": "number" }, { "const": 1, "type": "number" }, { "const": 2, "type": "number" } ] }, "live_api_verified": { "const": false, "type": "boolean" }, "scope": { "type": "string" }, "status": { "enum": [ "breaking", "review_required", "no_breaking_change_observed", "not_compared" ], "type": "string" }, "unsupported_features_require_review": { "const": true, "type": "boolean" } }, "required": [ "status", "ci_exit_code", "live_api_verified" ], "type": "object" } }, "required": [ "schema", "comparison_performed", "verdict", "input_fingerprints", "findings", "findings_total", "findings_omitted", "groups", "complete" ], "type": "object" }, "rules_version": { "type": "integer" }, "semantic_model_used": { "type": "boolean" }, "source_fetches": { "type": "integer" }, "source_provenance": { "properties": { "after_input_sha256": { "type": "string" }, "after_sha256": { "type": "string" }, "baseline_at": { "type": "string" }, "baseline_url": { "type": "string" }, "before_input_sha256": { "type": "string" }, "before_sha256": { "type": "string" }, "final_url": { "type": "string" }, "fingerprint_scope": { "type": "string" }, "input_source": { "type": "string" }, "raw_source_hash": { "type": "string" }, "registered_core_hash": { "type": "string" }, "requested_url": { "type": "string" }, "source_authenticity": { "type": "string" } }, "type": "object" }, "url": { "type": "string" }, "verdict": { "properties": { "ci_exit_code": { "type": "integer" }, "live_api_verified": { "type": "boolean" }, "scope": { "type": "string" }, "status": { "enum": [ "breaking", "review_required", "no_breaking_change_observed" ] }, "unsupported_features_require_review": { "type": "boolean" } }, "type": "object" }, "warnings": { "items": { "type": "string" }, "type": "array" }, "watch_id": { "type": "string" }, "work_units": { "type": "integer" } }, "type": "object" } }, { "description": "Observes public content without modifying its source. Adds a Fresh402 baseline and uses free registration capacity for new watches; never charges USDC or credits. Use free ($0) Register to save a public HTTPS baseline; no trial key, wallet or payment. Required url plus optional content/attribute rules identifies the watch. Save returned watch_id/hash for Check, Smart Diff or OpenAPI Contract Diff. When flagship workflows are advertised, compatible Website/API workflows accept source_watch_id to adopt this public baseline with its exact rules/time for one separately authorized comparison; it grants no private ownership and performs no extra baseline fetch. Same URL/rules returns existing state without fetching or refreshing; different rules identify another watch. It is not continuous monitoring. HTML/JSON/text only; no JavaScript, private or authenticated targets. DNS/fetch/quota limits apply, including on repeat calls. For walletless first Check inspect root instant_evaluation.enabled and set evaluation:true; separate /v3/agent-trial requires ownership signing. Connection grants no signing or payment authority.", "inputSchema": { "$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": { "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 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": "^\\/", "type": "string" }, "maxItems": 20, "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": "string" }, "maxItems": 20, "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. 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 is not executed. DNS, redirect and size limits also apply.", "format": "uri", "maxLength": 4096, "pattern": "^[Hh][Tt][Tt][Pp][Ss]:\\/\\/", "type": "string" } }, "required": [ "url" ], "type": "object" }, "name": "fresh402_register", "outputSchema": { "anyOf": [ { "properties": { "baseline_created": { "type": "boolean" }, "checked_at": { "type": "string" }, "content_kind": { "enum": [ "html", "json", "text" ] }, "content_length": { "type": "integer" }, "created": { "type": "boolean" }, "created_at": { "type": "string" }, "fetch_time_ms": { "type": "integer" }, "final_url": { "type": "string" }, "first_seen_at": { "type": "string" }, "hash": { "type": "string" }, "html_attribute_rules_version": { "const": 1 }, "html_attributes": { "items": { "enum": [ "href", "title", "alt", "aria-label" ] }, "type": "array" }, "next_step": { "type": "string" }, "normalizer_version": { "type": "integer" }, "note": { "type": "string" }, "raw_hash": { "type": "string" }, "snapshot_truncated": { "type": "boolean" }, "url": { "type": "string" }, "watch_id": { "type": "string" }, "workflow_baseline": { "properties": { "candidates": { "items": { "properties": { "additional_required_inputs": { "items": { "type": "string" }, "type": "array" }, "additional_validation": { "type": "string" }, "adopted_component": { "type": "string" }, "endpoint": { "type": "string" }, "requires_explicit_paid_authorization": { "const": true }, "source_input": { "properties": { "source_watch_id": { "type": "string" } }, "type": "object" }, "tool": { "type": "string" } }, "type": "object" }, "type": "array" }, "compatible_retained_content": { "type": "boolean" }, "limitation": { "type": "string" }, "normalizer_version": { "type": "integer" }, "ownership_granted": { "const": false }, "public_evidence": { "const": true }, "scope_override_allowed": { "const": false }, "selected_snapshot_time": { "type": "string" }, "source_watch_id": { "type": "string" } }, "type": "object" } }, "required": [ "watch_id", "url", "created", "baseline_created", "hash" ], "type": "object" }, { "description": "Tool error only; accompanied by isError=true.", "properties": { "error": { "minLength": 1, "type": "string" }, "retryable": { "type": "boolean" }, "status": { "type": "integer" } }, "required": [ "error" ], "type": "object" }, { "description": "Unpaid x402 v2 quote only; accompanied by isError=true. No product execution or financial authorization.", "properties": { "accepts": { "minItems": 1, "type": "array" }, "resource": { "type": "object" }, "x402Version": { "const": 2 } }, "required": [ "x402Version", "accepts" ], "type": "object" } ], "description": "A successful tool execution follows the canonical result branch. isError=true denotes an error or unpaid payment challenge, never successful execution or payment. Inspect isError before interpreting structuredContent.", "properties": { "baseline_created": { "type": "boolean" }, "checked_at": { "type": "string" }, "content_kind": { "enum": [ "html", "json", "text" ] }, "content_length": { "type": "integer" }, "created": { "type": "boolean" }, "created_at": { "type": "string" }, "fetch_time_ms": { "type": "integer" }, "final_url": { "type": "string" }, "first_seen_at": { "type": "string" }, "hash": { "type": "string" }, "html_attribute_rules_version": { "const": 1 }, "html_attributes": { "items": { "enum": [ "href", "title", "alt", "aria-label" ] }, "type": "array" }, "next_step": { "type": "string" }, "normalizer_version": { "type": "integer" }, "note": { "type": "string" }, "raw_hash": { "type": "string" }, "snapshot_truncated": { "type": "boolean" }, "url": { "type": "string" }, "watch_id": { "type": "string" }, "workflow_baseline": { "properties": { "candidates": { "items": { "properties": { "additional_required_inputs": { "items": { "type": "string" }, "type": "array" }, "additional_validation": { "type": "string" }, "adopted_component": { "type": "string" }, "endpoint": { "type": "string" }, "requires_explicit_paid_authorization": { "const": true }, "source_input": { "properties": { "source_watch_id": { "type": "string" } }, "type": "object" }, "tool": { "type": "string" } }, "type": "object" }, "type": "array" }, "compatible_retained_content": { "type": "boolean" }, "limitation": { "type": "string" }, "normalizer_version": { "type": "integer" }, "ownership_granted": { "const": false }, "public_evidence": { "const": true }, "scope_override_allowed": { "const": false }, "selected_snapshot_time": { "type": "string" }, "source_watch_id": { "type": "string" } }, "type": "object" } }, "type": "object" } }, { "description": "Observes public documents without modifying their source. Execution can charge USDC or prepaid credits, consume trial quota and update Fresh402 records. A new charge requires prior spending authorization. Without billing/trial credentials, a valid call returns an unpaid quote without executing the observation. Use Smart Diff for bounded JSON Pointer/HTML block changes and deterministic significance evidence across sessions. Requires real registered watch_id; fetches using saved rules. compare_to: previous(default) or baseline; previous_hash overrides with compatible retained same-watch evidence. json_array_keys explicitly matches unique typed identities; ambiguity fails. No cache-age option or scheduler. Missing history404; truncated/incompatible baseline409. Not complete semantic proof. Use Check for a focused changed/unchanged signal; choose the advertised Website Change Intelligence workflow for combined supported observation and comparison. change_evidence supplies bounded stable mechanical change IDs and pointers; these are not a business-impact or authenticity assessment. $0.015 USDC/call on Base (eip155:8453), including cache hits. Needs an x402-capable MCP payment client and funded native-USDC payer; ordinary MCP returns a payment challenge. Optional MPP (root mpp_payments.enabled): mppx, org.paymentauth/credential. Prepaid: X-Fresh402-API-Key plus params._meta[\"fresh402/prepaid\"] {idempotency_key,tariff_version,max_credits}; inspect authenticated quote. Choose one billing method; never auto-pay. Persist original proof/input/private recovery token; recover originals after uncertainty. Circle only if root circle_gateway.enabled. Clients, limits and recovery: https://fresh402.com/docs#payments. Free signed trial: /v3/agent-trial requires an unfunded EOA ownership signature; human Web trial: /v2/trial. Eligibility/capacity may return429. Use only X-Fresh402-Trial-Key plus persisted Idempotency-Key; replay exact tool/input/key. Exhaustion never authorizes a charge. The same fixed x402 service price may also be paid in native Circle USDC on Solana Mainnet (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp), when advertised by the unpaid challenge. Explicitly select one accepted network and pin its mint, merchant, amount and sponsored fee payer before signing. Solana payers need no Base wallet; Standalone native Solana MPP solana/charge is also advertised; its client pays a separately authorized SOL network fee, with no server fee sponsorship. Prepaid MPP funding remains Base-only. Payment network does not change the observed chain: blockchain products still inspect finalized Base. Solana delivery requires finalized matching USDC evidence. Persist the original network, resource, input, proof and private recovery capability; never switch networks or authorize a replacement after uncertainty.", "inputSchema": { "$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" }, "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: 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 (a URL-based Check can also create it). Reuses the saved public URL and content rules; do not pass url or new rules here. Replace illustrative IDs with a real returned ID before paying.", "pattern": "^w_[a-f0-9]{32}$", "type": "string" } }, "required": [ "watch_id" ], "type": "object" }, "name": "fresh402_smart_diff", "outputSchema": { "anyOf": [ { "properties": { "algorithm": { "type": "string" }, "array_move_count": { "type": "integer" }, "array_moves": { "items": { "properties": { "after_path": { "type": "string" }, "array_key": { "properties": { "pointer": { "type": "string" }, "value": { "type": [ "string", "integer" ] } }, "required": [ "pointer", "value" ], "type": "object" }, "before_path": { "type": "string" } }, "required": [ "before_path", "after_path", "array_key" ], "type": "object" }, "type": "array" }, "array_moves_truncated": { "type": "boolean" }, "change_evidence": { "description": "fresh402-mechanical-change-index-v1: up to20 stable change IDs and original /changes list pointers, kinds and omissions. Content identifiers are neither access capabilities nor assessed business impact.", "type": "object" }, "changed": { "type": "boolean" }, "changes": { "properties": { "added": { "items": { "properties": { "after": {}, "after_path": { "type": "string" }, "array_key": { "properties": { "pointer": { "type": "string" }, "value": { "type": [ "string", "integer" ] } }, "required": [ "pointer", "value" ], "type": "object" }, "before": {}, "before_path": { "type": "string" }, "path": { "type": "string" } }, "required": [ "path" ], "type": "object" }, "type": "array" }, "modified": { "items": { "properties": { "after": {}, "after_path": { "type": "string" }, "array_key": { "properties": { "pointer": { "type": "string" }, "value": { "type": [ "string", "integer" ] } }, "required": [ "pointer", "value" ], "type": "object" }, "before": {}, "before_path": { "type": "string" }, "path": { "type": "string" } }, "required": [ "path" ], "type": "object" }, "type": "array" }, "removed": { "items": { "properties": { "after": {}, "after_path": { "type": "string" }, "array_key": { "properties": { "pointer": { "type": "string" }, "value": { "type": [ "string", "integer" ] } }, "required": [ "pointer", "value" ], "type": "object" }, "before": {}, "before_path": { "type": "string" }, "path": { "type": "string" } }, "required": [ "path" ], "type": "object" }, "type": "array" } }, "type": "object" }, "changes_truncated": { "type": "boolean" }, "compare_to": { "enum": [ "previous", "baseline", "hash" ] }, "comparison_quality": { "enum": [ "structural", "legacy_text" ] }, "comparison_source": { "type": "string" }, "content_kind": { "type": "string" }, "counts": { "properties": { "added": { "type": "integer" }, "modified": { "type": "integer" }, "removed": { "type": "integer" } }, "type": "object" }, "evidence_assessment": { "description": "At most20 deduplicated mechanical inspection targets with explicit omissions; no inferred causality or semantic certainty.", "type": "object" }, "fetched_at": { "type": "string" }, "final_url": { "type": "string" }, "hash": { "type": "string" }, "html_attribute_rules_version": { "const": 1 }, "html_attributes": { "items": { "enum": [ "href", "title", "alt", "aria-label" ] }, "type": "array" }, "json_array_keys": { "items": { "properties": { "key": { "type": "string" }, "path": { "type": "string" } }, "required": [ "path", "key" ], "type": "object" }, "type": "array" }, "persistence_error": { "type": "string" }, "previous_hash": { "type": "string" }, "semantic_model_used": { "type": "boolean" }, "significance": { "properties": { "level": { "enum": [ "none", "low", "medium", "high" ] }, "reasons": { "items": { "type": "string" }, "type": "array" }, "rules_version": { "type": "integer" }, "score": { "type": "integer" } }, "type": "object" }, "url": { "type": "string" }, "warnings": { "items": { "type": "string" }, "type": "array" }, "watch_id": { "type": "string" } }, "required": [ "watch_id", "hash", "changed", "changes", "counts", "significance" ], "type": "object" }, { "description": "Tool error only; accompanied by isError=true.", "properties": { "error": { "minLength": 1, "type": "string" }, "retryable": { "type": "boolean" }, "status": { "type": "integer" } }, "required": [ "error" ], "type": "object" }, { "description": "Unpaid x402 v2 quote only; accompanied by isError=true. No product execution or financial authorization.", "properties": { "accepts": { "minItems": 1, "type": "array" }, "resource": { "type": "object" }, "x402Version": { "const": 2 } }, "required": [ "x402Version", "accepts" ], "type": "object" } ], "description": "A successful tool execution follows the canonical result branch. isError=true denotes an error or unpaid payment challenge, never successful execution or payment. Inspect isError before interpreting structuredContent.", "properties": { "algorithm": { "type": "string" }, "array_move_count": { "type": "integer" }, "array_moves": { "items": { "properties": { "after_path": { "type": "string" }, "array_key": { "properties": { "pointer": { "type": "string" }, "value": { "type": [ "string", "integer" ] } }, "required": [ "pointer", "value" ], "type": "object" }, "before_path": { "type": "string" } }, "required": [ "before_path", "after_path", "array_key" ], "type": "object" }, "type": "array" }, "array_moves_truncated": { "type": "boolean" }, "change_evidence": { "description": "fresh402-mechanical-change-index-v1: up to20 stable change IDs and original /changes list pointers, kinds and omissions. Content identifiers are neither access capabilities nor assessed business impact.", "type": "object" }, "changed": { "type": "boolean" }, "changes": { "properties": { "added": { "items": { "properties": { "after": {}, "after_path": { "type": "string" }, "array_key": { "properties": { "pointer": { "type": "string" }, "value": { "type": [ "string", "integer" ] } }, "required": [ "pointer", "value" ], "type": "object" }, "before": {}, "before_path": { "type": "string" }, "path": { "type": "string" } }, "required": [ "path" ], "type": "object" }, "type": "array" }, "modified": { "items": { "properties": { "after": {}, "after_path": { "type": "string" }, "array_key": { "properties": { "pointer": { "type": "string" }, "value": { "type": [ "string", "integer" ] } }, "required": [ "pointer", "value" ], "type": "object" }, "before": {}, "before_path": { "type": "string" }, "path": { "type": "string" } }, "required": [ "path" ], "type": "object" }, "type": "array" }, "removed": { "items": { "properties": { "after": {}, "after_path": { "type": "string" }, "array_key": { "properties": { "pointer": { "type": "string" }, "value": { "type": [ "string", "integer" ] } }, "required": [ "pointer", "value" ], "type": "object" }, "before": {}, "before_path": { "type": "string" }, "path": { "type": "string" } }, "required": [ "path" ], "type": "object" }, "type": "array" } }, "type": "object" }, "changes_truncated": { "type": "boolean" }, "compare_to": { "enum": [ "previous", "baseline", "hash" ] }, "comparison_quality": { "enum": [ "structural", "legacy_text" ] }, "comparison_source": { "type": "string" }, "content_kind": { "type": "string" }, "counts": { "properties": { "added": { "type": "integer" }, "modified": { "type": "integer" }, "removed": { "type": "integer" } }, "type": "object" }, "evidence_assessment": { "description": "At most20 deduplicated mechanical inspection targets with explicit omissions; no inferred causality or semantic certainty.", "type": "object" }, "fetched_at": { "type": "string" }, "final_url": { "type": "string" }, "hash": { "type": "string" }, "html_attribute_rules_version": { "const": 1 }, "html_attributes": { "items": { "enum": [ "href", "title", "alt", "aria-label" ] }, "type": "array" }, "json_array_keys": { "items": { "properties": { "key": { "type": "string" }, "path": { "type": "string" } }, "required": [ "path", "key" ], "type": "object" }, "type": "array" }, "persistence_error": { "type": "string" }, "previous_hash": { "type": "string" }, "semantic_model_used": { "type": "boolean" }, "significance": { "properties": { "level": { "enum": [ "none", "low", "medium", "high" ] }, "reasons": { "items": { "type": "string" }, "type": "array" }, "rules_version": { "type": "integer" }, "score": { "type": "integer" } }, "type": "object" }, "url": { "type": "string" }, "warnings": { "items": { "type": "string" }, "type": "array" }, "watch_id": { "type": "string" } }, "type": "object" } }, { "description": "Reads blockchain state; the observation does not execute transactions or modify the target wallet/contract. An authorized USDC service payment is separate. Execution can charge USDC or prepaid credits, consume trial quota and update Fresh402 records. A new charge requires prior spending authorization. Without billing/trial credentials, a valid call returns an unpaid quote without executing the observation. Read contract-reported token identity, metadata, supply and limited control facts at one pinned finalized Base block. No safety score, honeypot/trading simulation, verified-source claim or inferred absence of privileges. Missing or deceptive getter evidence remains unknown/not_assessed. $0.010000 native USDC/call on Base (eip155:8453); compatible x402 or enabled native MPP client required, no Fresh402 token for first purchase. Save proof/input and private recovery token BEFORE paying for full-response-loss protection: REST X-Fresh402-Recovery-Token; MCP params._meta['fresh402/recovery-token']. Recover originals without new RPC/debit; foreign snapshot/cursor forbidden. Provider failure/partial scan is not paid success. observation_saved=false/persistence_error: recover only, never use unsaved IDs. Prepaid needs eligible finalized all-service credits or an original explicit service-specific tariff4 grant; inspect /v3/prepaid/quote/token_facts and /v3/prepaid/all-services. Historical Web rights unchanged; paying agents do not need their own RPC credentials. Observations30days, private financial recovery7days. Not full history, financial advice or security audit. Clients: https://fresh402.com/docs#payments. Free signed trial: /v3/agent-trial requires an unfunded EOA ownership signature; human Web trial: /v2/trial. Eligibility/capacity may return429. Use only X-Fresh402-Trial-Key plus persisted Idempotency-Key; replay exact tool/input/key. Exhaustion never authorizes a charge. The same fixed x402 service price may also be paid in native Circle USDC on Solana Mainnet (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp), when advertised by the unpaid challenge. Explicitly select one accepted network and pin its mint, merchant, amount and sponsored fee payer before signing. Solana payers need no Base wallet; Standalone native Solana MPP solana/charge is also advertised; its client pays a separately authorized SOL network fee, with no server fee sponsorship. Prepaid MPP funding remains Base-only. Payment network does not change the observed chain: blockchain products still inspect finalized Base. Solana delivery requires finalized matching USDC evidence. Persist the original network, resource, input, proof and private recovery capability; never switch networks or authorize a replacement after uncertainty.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "address": { "description": "20-byte Ethereum address; lowercase/uppercase accepted, mixed case must have a valid EIP-55 checksum. Normalized to checksummed form.", "maxLength": 42, "minLength": 42, "pattern": "^0x[a-fA-F0-9]{40}$", "type": "string" }, "block": { "const": "finalized", "default": "finalized", "description": "Finalized only. Every state read pins the selected block hash with requireCanonical:true; no latest/number fallback.", "type": "string" }, "categories": { "default": [ "identity", "controls", "supply" ], "description": "Requested categories, default all. Unsupported evidence remains unknown/not_assessed; never a safety score.", "items": { "enum": [ "identity", "controls", "supply" ], "type": "string" }, "maxItems": 3, "minItems": 1, "type": "array" }, "chain_id": { "const": 8453, "description": "Base mainnet only; returned provider chain must match.", "type": "number" } }, "required": [ "chain_id", "address" ], "type": "object" }, "name": "fresh402_token_facts", "outputSchema": { "anyOf": [ { "$schema": "https://json-schema.org/draft/2020-12/schema", "anyOf": [ { "additionalProperties": {}, "properties": { "accounting": { "additionalProperties": {}, "properties": { "response_bytes": { "maximum": 4194304, "minimum": 0, "type": "integer" }, "rpc_requests": { "maximum": 18, "minimum": 1, "type": "integer" }, "scope": { "minLength": 1, "type": "string" }, "wire_response_bytes": { "maximum": 4194304, "minimum": 0, "type": "integer" } }, "required": [ "rpc_requests", "response_bytes", "wire_response_bytes", "scope" ], "type": "object" }, "address": { "pattern": "^0x[a-fA-F0-9]{40}$", "type": "string" }, "assessment_status": { "const": "facts_only", "type": "string" }, "block": { "additionalProperties": {}, "properties": { "chain_id": { "const": 8453, "type": "number" }, "finalized": { "const": true, "type": "boolean" }, "hash": { "pattern": "^0x[a-f0-9]{64}$", "type": "string" }, "number": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "observed_at": { "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$", "type": "string" }, "parent_hash": { "pattern": "^0x[a-f0-9]{64}$", "type": "string" }, "policy": { "const": "finalized", "type": "string" }, "source": { "pattern": "^[a-z0-9_-]{3,64}$", "type": "string" }, "timestamp": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "trust": { "maxLength": 256, "minLength": 1, "type": "string" } }, "required": [ "number", "hash", "parent_hash", "timestamp", "chain_id", "policy", "finalized", "source", "observed_at", "trust" ], "type": "object" }, "coverage": { "additionalProperties": false, "properties": { "categories": { "items": { "enum": [ "identity", "controls", "supply" ], "type": "string" }, "maxItems": 3, "minItems": 1, "type": "array" }, "trading_simulation": { "const": false, "type": "boolean" }, "verified_source": { "const": false, "type": "boolean" } }, "required": [ "verified_source", "trading_simulation", "categories" ], "type": "object" }, "facts": { "items": { "additionalProperties": {}, "properties": { "category": { "type": "string" }, "observation_confidence": { "enum": [ "none", "low", "medium", "high" ], "type": "string" }, "status": { "enum": [ "detected", "not_detected_with_sufficient_coverage", "unknown", "not_assessed" ], "type": "string" } }, "required": [ "category", "status", "observation_confidence" ], "type": "object" }, "maxItems": 32, "type": "array" }, "limitations": { "items": { "maxLength": 1024, "type": "string" }, "maxItems": 20, "minItems": 1, "type": "array" }, "metadata": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "observation_saved": { "const": true, "type": "boolean" }, "persistence": { "enum": [ "atomic_with_financial_delivery", "atomic_with_entitlement_delivery" ], "type": "string" }, "snapshot_id": { "pattern": "^s_[a-f0-9]{64}$", "type": "string" }, "snapshot_saved": { "const": true, "type": "boolean" }, "tool": { "const": "fresh402_token_facts", "type": "string" } }, "required": [ "observation_saved", "snapshot_saved", "persistence", "accounting", "limitations", "tool", "snapshot_id", "address", "block", "assessment_status", "facts", "metadata", "coverage" ], "type": "object" }, { "additionalProperties": {}, "properties": { "accounting": { "additionalProperties": {}, "properties": { "response_bytes": { "maximum": 4194304, "minimum": 0, "type": "integer" }, "rpc_requests": { "maximum": 18, "minimum": 1, "type": "integer" }, "scope": { "minLength": 1, "type": "string" }, "wire_response_bytes": { "maximum": 4194304, "minimum": 0, "type": "integer" } }, "required": [ "rpc_requests", "response_bytes", "wire_response_bytes", "scope" ], "type": "object" }, "address": { "pattern": "^0x[a-fA-F0-9]{40}$", "type": "string" }, "assessment_status": { "const": "facts_only", "type": "string" }, "block": { "additionalProperties": {}, "properties": { "chain_id": { "const": 8453, "type": "number" }, "finalized": { "const": true, "type": "boolean" }, "hash": { "pattern": "^0x[a-f0-9]{64}$", "type": "string" }, "number": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "observed_at": { "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$", "type": "string" }, "parent_hash": { "pattern": "^0x[a-f0-9]{64}$", "type": "string" }, "policy": { "const": "finalized", "type": "string" }, "source": { "pattern": "^[a-z0-9_-]{3,64}$", "type": "string" }, "timestamp": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "trust": { "maxLength": 256, "minLength": 1, "type": "string" } }, "required": [ "number", "hash", "parent_hash", "timestamp", "chain_id", "policy", "finalized", "source", "observed_at", "trust" ], "type": "object" }, "coverage": { "additionalProperties": false, "properties": { "categories": { "items": { "enum": [ "identity", "controls", "supply" ], "type": "string" }, "maxItems": 3, "minItems": 1, "type": "array" }, "trading_simulation": { "const": false, "type": "boolean" }, "verified_source": { "const": false, "type": "boolean" } }, "required": [ "verified_source", "trading_simulation", "categories" ], "type": "object" }, "cursor_saved": { "const": false, "type": "boolean" }, "facts": { "items": { "additionalProperties": {}, "properties": { "category": { "type": "string" }, "observation_confidence": { "enum": [ "none", "low", "medium", "high" ], "type": "string" }, "status": { "enum": [ "detected", "not_detected_with_sufficient_coverage", "unknown", "not_assessed" ], "type": "string" } }, "required": [ "category", "status", "observation_confidence" ], "type": "object" }, "maxItems": 32, "type": "array" }, "limitations": { "items": { "maxLength": 1024, "type": "string" }, "maxItems": 20, "minItems": 1, "type": "array" }, "metadata": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "observation_saved": { "const": false, "type": "boolean" }, "persistence": { "enum": [ "atomic_with_financial_delivery", "atomic_with_entitlement_delivery" ], "type": "string" }, "persistence_error": { "maxLength": 512, "minLength": 1, "type": "string" }, "snapshot_id": { "pattern": "^s_[a-f0-9]{64}$", "type": "string" }, "snapshot_saved": { "const": false, "type": "boolean" }, "tool": { "const": "fresh402_token_facts", "type": "string" } }, "required": [ "observation_saved", "snapshot_saved", "persistence", "accounting", "limitations", "tool", "snapshot_id", "address", "block", "assessment_status", "facts", "metadata", "coverage", "cursor_saved", "persistence_error" ], "type": "object" } ] }, { "description": "Tool error only; accompanied by isError=true.", "properties": { "error": { "minLength": 1, "type": "string" }, "retryable": { "type": "boolean" }, "status": { "type": "integer" } }, "required": [ "error" ], "type": "object" }, { "description": "Unpaid x402 v2 quote only; accompanied by isError=true. No product execution or financial authorization.", "properties": { "accepts": { "minItems": 1, "type": "array" }, "resource": { "type": "object" }, "x402Version": { "const": 2 } }, "required": [ "x402Version", "accepts" ], "type": "object" } ], "description": "A successful tool execution follows the canonical result branch. isError=true denotes an error or unpaid payment challenge, never successful execution or payment. Inspect isError before interpreting structuredContent.", "type": "object" } }, { "description": "Reads blockchain state; the observation does not execute transactions or modify the target wallet/contract. An authorized USDC service payment is separate. Execution can charge USDC or prepaid credits, consume trial quota and update Fresh402 records. A new charge requires prior spending authorization. Without billing/trial credentials, a valid call returns an unpaid quote without executing the observation. Read ETH balance snapshots and selected ERC-20-shaped Transfer events for one wallet in a completed bounded finalized page. Save the owned cursor and use a new paid operation for the next page. Not full native/internal/NFT/transaction history; provider-reported logs cannot prove completeness. $0.020000 native USDC/call on Base (eip155:8453); compatible x402 or enabled native MPP client required, no Fresh402 token for first purchase. Save proof/input and private recovery token BEFORE paying for full-response-loss protection: REST X-Fresh402-Recovery-Token; MCP params._meta['fresh402/recovery-token']. Recover originals without new RPC/debit; foreign snapshot/cursor forbidden. Provider failure/partial scan is not paid success. observation_saved=false/persistence_error: recover only, never use unsaved IDs. Prepaid needs eligible finalized all-service credits or an original explicit service-specific tariff4 grant; inspect /v3/prepaid/quote/wallet_watch and /v3/prepaid/all-services. Historical Web rights unchanged; paying agents do not need their own RPC credentials. Observations30days, private financial recovery7days. Not full history, financial advice or security audit. Clients: https://fresh402.com/docs#payments. Free signed trial: /v3/agent-trial requires an unfunded EOA ownership signature; human Web trial: /v2/trial. Eligibility/capacity may return429. Use only X-Fresh402-Trial-Key plus persisted Idempotency-Key; replay exact tool/input/key. Exhaustion never authorizes a charge. The same fixed x402 service price may also be paid in native Circle USDC on Solana Mainnet (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp), when advertised by the unpaid challenge. Explicitly select one accepted network and pin its mint, merchant, amount and sponsored fee payer before signing. Solana payers need no Base wallet; Standalone native Solana MPP solana/charge is also advertised; its client pays a separately authorized SOL network fee, with no server fee sponsorship. Prepaid MPP funding remains Base-only. Payment network does not change the observed chain: blockchain products still inspect finalized Base. Solana delivery requires finalized matching USDC evidence. Persist the original network, resource, input, proof and private recovery capability; never switch networks or authorize a replacement after uncertainty.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "not": { "required": [ "cursor", "from_block" ] }, "properties": { "address": { "description": "20-byte Ethereum address; lowercase/uppercase accepted, mixed case must have a valid EIP-55 checksum. Normalized to checksummed form.", "maxLength": 42, "minLength": 42, "pattern": "^0x[a-fA-F0-9]{40}$", "type": "string" }, "block": { "const": "finalized", "default": "finalized", "description": "Finalized only. Every state read pins the selected block hash with requireCanonical:true; no latest/number fallback.", "type": "string" }, "chain_id": { "const": 8453, "description": "Base mainnet only; returned provider chain must match.", "type": "number" }, "chunk_size": { "const": 4, "default": 4, "description": "Single bounded chunk; four-block maximum and no automatic retry.", "type": "number" }, "cursor": { "description": "Owned opaque cursor from a prior successful wallet_watch. Scope, wallet, tokens, provider and policy must match.", "pattern": "^c_[a-f0-9]{64}$", "type": "string" }, "from_block": { "description": "Initial first block; cannot be supplied with cursor. Default last four finalized blocks; a gap beyond32 fails without skipping history.", "maximum": 9007199254740991, "minimum": 1, "type": "integer" }, "max_blocks": { "default": 4, "description": "At most four blocks in this paid page; default4. has_more describes a completed bounded page, not permission to charge a failed partial scan.", "maximum": 4, "minimum": 1, "type": "integer" }, "tokens": { "description": "One to four selected ERC-20 contracts; no full wallet transaction history.", "items": { "description": "20-byte Ethereum address; lowercase/uppercase accepted, mixed case must have a valid EIP-55 checksum. Normalized to checksummed form.", "maxLength": 42, "minLength": 42, "pattern": "^0x[a-fA-F0-9]{40}$", "type": "string" }, "maxItems": 4, "minItems": 1, "type": "array" } }, "required": [ "chain_id", "address", "tokens" ], "type": "object" }, "name": "fresh402_wallet_watch", "outputSchema": { "anyOf": [ { "$schema": "https://json-schema.org/draft/2020-12/schema", "anyOf": [ { "additionalProperties": {}, "properties": { "accounting": { "additionalProperties": {}, "properties": { "response_bytes": { "maximum": 4194304, "minimum": 0, "type": "integer" }, "rpc_requests": { "maximum": 18, "minimum": 1, "type": "integer" }, "scope": { "minLength": 1, "type": "string" }, "wire_response_bytes": { "maximum": 4194304, "minimum": 0, "type": "integer" } }, "required": [ "rpc_requests", "response_bytes", "wire_response_bytes", "scope" ], "type": "object" }, "block": { "additionalProperties": {}, "properties": { "chain_id": { "const": 8453, "type": "number" }, "finalized": { "const": true, "type": "boolean" }, "hash": { "pattern": "^0x[a-f0-9]{64}$", "type": "string" }, "number": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "observed_at": { "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$", "type": "string" }, "parent_hash": { "pattern": "^0x[a-f0-9]{64}$", "type": "string" }, "policy": { "const": "finalized", "type": "string" }, "source": { "pattern": "^[a-z0-9_-]{3,64}$", "type": "string" }, "timestamp": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "trust": { "maxLength": 256, "minLength": 1, "type": "string" } }, "required": [ "number", "hash", "parent_hash", "timestamp", "chain_id", "policy", "finalized", "source", "observed_at", "trust" ], "type": "object" }, "coverage": { "additionalProperties": {}, "properties": { "requested_to_block": { "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "selected_tokens": { "items": { "pattern": "^0x[a-fA-F0-9]{40}$", "type": "string" }, "maxItems": 4, "minItems": 1, "type": "array" } }, "required": [ "selected_tokens", "requested_to_block" ], "type": "object" }, "cursor_saved": { "const": true, "type": "boolean" }, "events": { "items": {}, "maxItems": 100, "type": "array" }, "has_more": { "type": "boolean" }, "interruption": { "type": "null" }, "limitations": { "items": { "maxLength": 1024, "type": "string" }, "maxItems": 20, "minItems": 1, "type": "array" }, "native_balance": { "additionalProperties": {}, "properties": { "asset": { "const": "ETH", "type": "string" }, "meaning": { "type": "string" }, "raw": { "pattern": "^\\d+$", "type": "string" } }, "required": [ "asset", "raw", "meaning" ], "type": "object" }, "next_cursor": { "pattern": "^c_[a-f0-9]{64}$", "type": "string" }, "observation_saved": { "const": true, "type": "boolean" }, "persistence": { "enum": [ "atomic_with_financial_delivery", "atomic_with_entitlement_delivery" ], "type": "string" }, "snapshot_saved": { "const": false, "type": "boolean" }, "state": { "enum": [ "page", "complete" ], "type": "string" }, "tool": { "const": "fresh402_wallet_watch", "type": "string" } }, "required": [ "observation_saved", "snapshot_saved", "persistence", "accounting", "limitations", "tool", "cursor_saved", "state", "block", "next_cursor", "events", "has_more", "interruption", "native_balance", "coverage" ], "type": "object" }, { "additionalProperties": {}, "properties": { "accounting": { "additionalProperties": {}, "properties": { "response_bytes": { "maximum": 4194304, "minimum": 0, "type": "integer" }, "rpc_requests": { "maximum": 18, "minimum": 1, "type": "integer" }, "scope": { "minLength": 1, "type": "string" }, "wire_response_bytes": { "maximum": 4194304, "minimum": 0, "type": "integer" } }, "required": [ "rpc_requests", "response_bytes", "wire_response_bytes", "scope" ], "type": "object" }, "block": { "additionalProperties": {}, "properties": { "chain_id": { "const": 8453, "type": "number" }, "finalized": { "const": true, "type": "boolean" }, "hash": { "pattern": "^0x[a-f0-9]{64}$", "type": "string" }, "number": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "observed_at": { "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$", "type": "string" }, "parent_hash": { "pattern": "^0x[a-f0-9]{64}$", "type": "string" }, "policy": { "const": "finalized", "type": "string" }, "source": { "pattern": "^[a-z0-9_-]{3,64}$", "type": "string" }, "timestamp": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "trust": { "maxLength": 256, "minLength": 1, "type": "string" } }, "required": [ "number", "hash", "parent_hash", "timestamp", "chain_id", "policy", "finalized", "source", "observed_at", "trust" ], "type": "object" }, "coverage": { "additionalProperties": {}, "properties": { "requested_to_block": { "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "selected_tokens": { "items": { "pattern": "^0x[a-fA-F0-9]{40}$", "type": "string" }, "maxItems": 4, "minItems": 1, "type": "array" } }, "required": [ "selected_tokens", "requested_to_block" ], "type": "object" }, "cursor_saved": { "const": false, "type": "boolean" }, "events": { "items": {}, "maxItems": 100, "type": "array" }, "has_more": { "type": "boolean" }, "interruption": { "type": "null" }, "limitations": { "items": { "maxLength": 1024, "type": "string" }, "maxItems": 20, "minItems": 1, "type": "array" }, "native_balance": { "additionalProperties": {}, "properties": { "asset": { "const": "ETH", "type": "string" }, "meaning": { "type": "string" }, "raw": { "pattern": "^\\d+$", "type": "string" } }, "required": [ "asset", "raw", "meaning" ], "type": "object" }, "next_cursor": { "pattern": "^c_[a-f0-9]{64}$", "type": "string" }, "observation_saved": { "const": false, "type": "boolean" }, "persistence": { "enum": [ "atomic_with_financial_delivery", "atomic_with_entitlement_delivery" ], "type": "string" }, "persistence_error": { "maxLength": 512, "minLength": 1, "type": "string" }, "snapshot_saved": { "const": false, "type": "boolean" }, "state": { "enum": [ "page", "complete" ], "type": "string" }, "tool": { "const": "fresh402_wallet_watch", "type": "string" } }, "required": [ "observation_saved", "snapshot_saved", "persistence", "accounting", "limitations", "tool", "cursor_saved", "state", "block", "next_cursor", "events", "has_more", "interruption", "native_balance", "coverage", "persistence_error" ], "type": "object" } ] }, { "description": "Tool error only; accompanied by isError=true.", "properties": { "error": { "minLength": 1, "type": "string" }, "retryable": { "type": "boolean" }, "status": { "type": "integer" } }, "required": [ "error" ], "type": "object" }, { "description": "Unpaid x402 v2 quote only; accompanied by isError=true. No product execution or financial authorization.", "properties": { "accepts": { "minItems": 1, "type": "array" }, "resource": { "type": "object" }, "x402Version": { "const": 2 } }, "required": [ "x402Version", "accepts" ], "type": "object" } ], "description": "A successful tool execution follows the canonical result branch. isError=true denotes an error or unpaid payment challenge, never successful execution or payment. Inspect isError before interpreting structuredContent.", "type": "object" } }, { "description": "Seed or compare one owned scoped public document with one validated fetch and bounded structural evidence. Optional JSON record identities; optional private portable source snapshot, same principal/workflow/scope/environment,30day expiry. Server state remains seven days. Mechanical findings are not business-impact or freshness certification. One fixed workflow charge; internal steps never create separate customer charges. First URL source use seeds state in this same operation; compatible source_watch_id adopts retained public Register evidence for a genuine first comparison with original scope/time, not ownership. For continuation, later observations use returned owned observation_id. State expires seven days after creation; reads/writes never extend it. Auth: authorized native-USDC x402 v2 on Base, enabled MPP, or an eligible prepaid key plus exact tariff 5 and max_credits. Ordinary unpaid calls return a challenge, not execution. Persist original input, proof and recovery token before submission; exact replay returns retained results without fresh work or another charge. Choose evidence detail before authorization. No free-trial or automatic paid fallback. 0.005 USDC or 2 credits. Limits and scope are authoritative, not a complete audit or compatibility guarantee. The same fixed x402 service price may also be paid in native Circle USDC on Solana Mainnet (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp), when advertised by the unpaid challenge. Explicitly select one accepted network and pin its mint, merchant, amount and sponsored fee payer before signing. Solana payers need no Base wallet; Standalone native Solana MPP solana/charge is also advertised; its client pays a separately authorized SOL network fee, with no server fee sponsorship. Prepaid MPP funding remains Base-only. Payment network does not change the observed chain: blockchain products still inspect finalized Base. Solana delivery requires finalized matching USDC evidence. Persist the original network, resource, input, proof and private recovery capability; never switch networks or authorize a replacement after uncertainty.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "oneOf": [ { "not": { "anyOf": [ { "required": [ "source_watch_id" ] }, { "required": [ "observation_id" ] }, { "required": [ "baseline_snapshot" ] } ] }, "required": [ "url" ] }, { "not": { "anyOf": [ { "required": [ "url" ] }, { "required": [ "observation_id" ] }, { "required": [ "scope" ] }, { "required": [ "baseline_snapshot" ] } ] }, "required": [ "source_watch_id" ] }, { "not": { "anyOf": [ { "required": [ "url" ] }, { "required": [ "source_watch_id" ] }, { "required": [ "scope" ] }, { "required": [ "baseline_snapshot" ] } ] }, "required": [ "observation_id" ] }, { "not": { "anyOf": [ { "required": [ "url" ] }, { "required": [ "source_watch_id" ] }, { "required": [ "observation_id" ] }, { "required": [ "scope" ] } ] }, "properties": { "compare_to": { "const": "previous" } }, "required": [ "baseline_snapshot" ] } ], "properties": { "baseline_snapshot": { "description": "Optional private caller-retained Fresh402 snapshot token, at most44,000 characters, as the sole source identity instead of url/source_watch_id/observation_id/contracts. Same verified billing principal, workflow, environment and immutable scope only; compare_to must be previous. Expires30days after source observation. Contains source evidence, not a payment capability or proof of current freshness. Tampered/foreign/expired tokens fail before fetching; never send them to analytics or public repositories.", "maxLength": 44000, "minLength": 1, "pattern": "^fs1\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]{43}$", "type": "string" }, "compare_to": { "default": "previous", "description": "Default previous compares with the latest successful workflow observation; baseline compares with its original seed. Seeding is one paid workflow operation and reports no comparison, never a second internal charge.", "enum": [ "previous", "baseline" ], "type": "string" }, "detail": { "default": "compact", "description": "Default compact: at most 20 evidence items per section. Expanded allows at most 200 document findings or 100 Base events and retains raw validated logs/getter ABI details within the same fixed work/output ceiling. Counts and omitted-evidence warnings remain explicit.", "enum": [ "compact", "expanded" ], "type": "string" }, "export_snapshot": { "description": "Optional, default false. Request a caller-retained integrity-protected snapshot of this operation's new source observation, within the existing paid workflow price. Supported only for Website Change Intelligence and stored-source API Compatibility Review. At most32,768 payload bytes/44,000 token characters; oversized evidence reports omitted_size without corrupting the main result. Expires30days after observation; seven-day server state and original financial recovery do not extend. Keep the token private.", "type": "boolean" }, "json_array_keys": { "description": "Optional per-comparison JSON array identity rules, same bounds as Smart Diff. JSON source only; duplicate/missing keys fail explicitly. Does not change stored source normalization or hashes. Persist the exact request for financial recovery.", "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" }, "observation_id": { "description": "Owned observation_id returned by this same workflow. Reuses its immutable source/scope and saved baseline/latest observations; not a primitive watch_id. Seven-day state retention. Missing, foreign or expired IDs never silently rebaseline.", "pattern": "^wf_[a-f0-9]{64}$", "type": "string" }, "scope": { "additionalProperties": false, "description": "Immutable supported normalization rules. Selected attributes participate in change detection; ignored fields are outside the reported scope. No browser execution or linked-page crawling.", "properties": { "html_attributes": { "description": "For workflow HTML, default is all four supported attributes: href,title,alt,aria-label. Explicit [] requests text-only comparison and is reported as limited scope. Ignored selectors apply to both text and attribute evidence. Not applied to JSON/text.", "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 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": "^\\/", "type": "string" }, "maxItems": 20, "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": "string" }, "maxItems": 20, "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" } }, "type": "object" }, "source_watch_id": { "description": "Adopt the current retained public Register observation as the prior baseline, with its exact immutable URL/scope and original timestamp. No baseline refetch or ownership grant. Exactly one of url, source_watch_id or observation_id; omit scope. Complete compatible normalizer-v2 evidence required; API review additionally requires unfiltered JSON OpenAPI. One paid new observation is compared; save returned owned observation_id for continuation. Missing/incomplete baselines fail explicitly, never silently reseed.", "pattern": "^w_[a-f0-9]{32}$", "type": "string" }, "url": { "description": "Public HTTPS source for a new or existing canonical source/scope identity. Exactly one of url, source_watch_id or observation_id. A new URL identity seeds once; the next operation compares.", "format": "uri", "maxLength": 4096, "pattern": "^[Hh][Tt][Tt][Pp][Ss]:\\/\\/", "type": "string" } }, "type": "object" }, "name": "fresh402_website_change_intelligence", "outputSchema": { "anyOf": [ { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "accounting": { "additionalProperties": {}, "description": "Actual bounded execution counters, not inferred model-token savings or a billing invoice.", "propertyNames": { "type": "string" }, "type": "object" }, "billing": { "additionalProperties": false, "properties": { "atomic_usdc": { "pattern": "^\\d+$", "type": "string" }, "credits": { "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "internal_charges": { "const": 0, "type": "number" }, "one_financial_operation": { "const": true, "type": "boolean" }, "tariff_version": { "const": 5, "type": "number" } }, "required": [ "internal_charges", "one_financial_operation", "tariff_version", "credits", "atomic_usdc" ], "type": "object" }, "completeness": { "additionalProperties": {}, "description": "Scope and uncertainty are authoritative; wallet history and independent provider consensus are never asserted.", "propertyNames": { "type": "string" }, "type": "object" }, "evidence": { "additionalProperties": false, "properties": { "website": { "additionalProperties": false, "properties": { "changed": { "type": [ "boolean", "null" ] }, "comparison": { "anyOf": [ { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, { "type": "null" } ] }, "comparison_executed": { "type": "boolean" }, "completeness": { "additionalProperties": {}, "description": "Explicit scope, omitted-evidence count and truncation; no browser or external-reference crawl. Warnings are deduplicated at the result root.", "propertyNames": { "type": "string" }, "type": "object" }, "evidence": { "description": "Bounded structural changes or directional API findings; API entries include classification, rule and JSON Pointer path. Counts survive compaction.", "items": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "maxItems": 200, "type": "array" }, "hash": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "previous_hash": { "anyOf": [ { "pattern": "^[a-f0-9]{64}$", "type": "string" }, { "type": "null" } ] }, "review": { "additionalProperties": false, "description": "Versioned Release Guardian evidence. Findings and excerpts are bounded; pointers refer to the full original result. A skipped comparator reports not_compared/CI2, never automatic approval. No customer code, live API behavior or deployment safety is established.", "properties": { "comparison_performed": { "type": "boolean" }, "complete": { "type": "boolean" }, "findings": { "items": { "additionalProperties": false, "properties": { "affected_path": { "type": "string" }, "after": { "type": [ "string", "null" ] }, "before": { "type": [ "string", "null" ] }, "compatibility_direction": { "enum": [ "request", "response", "authentication", "operation_or_shared" ], "type": "string" }, "complete": { "type": "boolean" }, "confidence": { "enum": [ "supported_rule", "requires_review" ], "type": "string" }, "evidence": { "additionalProperties": false, "properties": { "after_sha256": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "after_source_pointer": { "type": [ "string", "null" ] }, "before_sha256": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "before_source_pointer": { "type": [ "string", "null" ] }, "change_pointer": { "type": "string" }, "change_pointer_scope": { "const": "full_original_result", "type": "string" }, "excerpts_may_be_truncated": { "const": true, "type": "boolean" }, "source_pointer_scope": { "const": "parsed_original_contract_declaration", "type": "string" } }, "required": [ "change_pointer", "change_pointer_scope", "before_sha256", "after_sha256", "excerpts_may_be_truncated" ], "type": "object" }, "explanation": { "type": "string" }, "finding_id": { "pattern": "^cf_[a-f0-9]{64}$", "type": "string" }, "operations": { "items": { "type": "string" }, "maxItems": 8, "type": "array" }, "recommended_action": { "enum": [ "block_and_review", "inspect_with_other_findings", "manual_review" ], "type": "string" }, "rule_id": { "type": "string" }, "severity": { "enum": [ "error", "warning", "info" ], "type": "string" } }, "required": [ "finding_id", "rule_id", "severity", "compatibility_direction", "affected_path", "operations", "complete", "before", "after", "explanation", "evidence", "confidence", "recommended_action" ], "type": "object" }, "maxItems": 20, "type": "array" }, "findings_omitted": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "findings_total": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "groups": { "additionalProperties": { "items": { "type": "string" }, "maxItems": 20, "type": "array" }, "propertyNames": { "type": "string" }, "type": "object" }, "input_fingerprints": { "additionalProperties": false, "properties": { "after_sha256": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "before_sha256": { "anyOf": [ { "pattern": "^[a-f0-9]{64}$", "type": "string" }, { "type": "null" } ] } }, "required": [ "before_sha256", "after_sha256" ], "type": "object" }, "reason": { "enum": [ "baseline_seeded", "hash_unchanged" ], "type": "string" }, "result_id": { "pattern": "^review_[a-f0-9]{64}$", "type": "string" }, "schema": { "const": "fresh402-contract-review-v1", "type": "string" }, "scope": { "type": "string" }, "verdict": { "additionalProperties": false, "properties": { "ci_exit_code": { "anyOf": [ { "const": 0, "type": "number" }, { "const": 1, "type": "number" }, { "const": 2, "type": "number" } ] }, "live_api_verified": { "const": false, "type": "boolean" }, "scope": { "type": "string" }, "status": { "enum": [ "breaking", "review_required", "no_breaking_change_observed", "not_compared" ], "type": "string" }, "unsupported_features_require_review": { "const": true, "type": "boolean" } }, "required": [ "status", "ci_exit_code", "live_api_verified" ], "type": "object" } }, "required": [ "schema", "comparison_performed", "verdict", "input_fingerprints", "findings", "findings_total", "findings_omitted", "groups", "complete" ], "type": "object" }, "scope": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "status": { "enum": [ "baseline_seeded", "no_supported_contract_change", "unchanged_in_scope", "changed_in_scope", "review_required", "descriptive_only" ], "type": "string" }, "summary": { "anyOf": [ { "type": "string" }, { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" } ] } }, "required": [ "status", "changed", "scope", "hash", "previous_hash", "summary", "evidence", "comparison", "comparison_executed", "completeness" ], "type": "object" } }, "required": [ "website" ], "type": "object" }, "observation_id": { "pattern": "^wf_[a-f0-9]{64}$", "type": "string" }, "observed_at": { "type": "string" }, "persistence_error": { "type": "string" }, "portable_state": { "anyOf": [ { "additionalProperties": false, "properties": { "caller_retention_days": { "const": 30, "type": "number" }, "expires_at": { "type": "string" }, "observed_at": { "type": "string" }, "payload_bytes": { "maximum": 32768, "minimum": 0, "type": "integer" }, "payment_authority": { "const": false, "type": "boolean" }, "retention_extended": { "const": false, "type": "boolean" }, "server_retention_days": { "const": 7, "type": "number" }, "source_freshness_verified": { "const": false, "type": "boolean" }, "status": { "const": "available", "type": "string" }, "token": { "maxLength": 44000, "type": "string" } }, "required": [ "status", "token", "expires_at", "observed_at", "payload_bytes", "server_retention_days", "caller_retention_days", "retention_extended", "payment_authority", "source_freshness_verified" ], "type": "object" }, { "additionalProperties": false, "properties": { "max_payload_bytes": { "const": 32768, "type": "number" }, "retention_extended": { "const": false, "type": "boolean" }, "status": { "const": "omitted_size", "type": "string" } }, "required": [ "status", "max_payload_bytes", "retention_extended" ], "type": "object" } ], "description": "Opt-in private caller-retained source evidence, independently integrity-protected and bound to principal/workflow/environment/scope. Not encryption, payment authority, current freshness or an extension of original-result/server retention." }, "provenance": { "additionalProperties": false, "properties": { "portable_baseline": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "previous_observation": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "register_baseline": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "scope_identity": { "type": "string" }, "supplied_contracts": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "website": { "additionalProperties": false, "properties": { "content_type": { "type": "string" }, "final_url": { "format": "uri", "type": "string" }, "observed_at": { "type": "string" }, "raw_source_hash": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "requested_url": { "format": "uri", "type": "string" } }, "required": [ "requested_url", "final_url", "raw_source_hash", "observed_at", "content_type" ], "type": "object" } }, "required": [ "website", "scope_identity" ], "type": "object" }, "snapshot_saved": { "type": "boolean" }, "state_expires_at": { "type": "string" }, "status": { "enum": [ "baseline_seeded", "no_supported_contract_change", "unchanged_in_scope", "changed_in_scope", "review_required", "descriptive_only", "evidence_ready" ], "type": "string" }, "summary": { "additionalProperties": {}, "description": "Task-level result; a seeded baseline is not a comparison, and evidence does not prove deployment or causation.", "properties": { "changed": { "type": [ "boolean", "null" ] }, "comparison": { "enum": [ "seeded", "previous", "baseline", "supplied", "portable" ], "type": "string" }, "consistency": { "const": "not_established", "type": "string" }, "findings": { "anyOf": [ { "type": "string" }, { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" } ] }, "release_label": { "type": "string" } }, "type": "object" }, "version": { "const": 1, "type": "number" }, "warnings": { "items": { "type": "string" }, "maxItems": 50, "type": "array" }, "workflow": { "const": "website_change_intelligence", "type": "string" }, "workflow_state_saved": { "type": "boolean" } }, "required": [ "workflow", "version", "status", "observed_at", "summary", "evidence", "provenance", "completeness", "warnings", "accounting", "billing" ], "type": "object" }, { "description": "Tool error only; accompanied by isError=true.", "properties": { "error": { "minLength": 1, "type": "string" }, "retryable": { "type": "boolean" }, "status": { "type": "integer" } }, "required": [ "error" ], "type": "object" }, { "description": "Unpaid x402 v2 quote only; accompanied by isError=true. No product execution or financial authorization.", "properties": { "accepts": { "minItems": 1, "type": "array" }, "resource": { "type": "object" }, "x402Version": { "const": 2 } }, "required": [ "x402Version", "accepts" ], "type": "object" } ], "description": "A successful tool execution follows the canonical result branch. isError=true denotes an error or unpaid payment challenge, never successful execution or payment. Inspect isError before interpreting structuredContent.", "properties": { "accounting": { "additionalProperties": {}, "description": "Actual bounded execution counters, not inferred model-token savings or a billing invoice.", "propertyNames": { "type": "string" }, "type": "object" }, "billing": { "additionalProperties": false, "properties": { "atomic_usdc": { "pattern": "^\\d+$", "type": "string" }, "credits": { "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "internal_charges": { "const": 0, "type": "number" }, "one_financial_operation": { "const": true, "type": "boolean" }, "tariff_version": { "const": 5, "type": "number" } }, "required": [ "internal_charges", "one_financial_operation", "tariff_version", "credits", "atomic_usdc" ], "type": "object" }, "completeness": { "additionalProperties": {}, "description": "Scope and uncertainty are authoritative; wallet history and independent provider consensus are never asserted.", "propertyNames": { "type": "string" }, "type": "object" }, "evidence": { "additionalProperties": false, "properties": { "website": { "additionalProperties": false, "properties": { "changed": { "type": [ "boolean", "null" ] }, "comparison": { "anyOf": [ { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, { "type": "null" } ] }, "comparison_executed": { "type": "boolean" }, "completeness": { "additionalProperties": {}, "description": "Explicit scope, omitted-evidence count and truncation; no browser or external-reference crawl. Warnings are deduplicated at the result root.", "propertyNames": { "type": "string" }, "type": "object" }, "evidence": { "description": "Bounded structural changes or directional API findings; API entries include classification, rule and JSON Pointer path. Counts survive compaction.", "items": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "maxItems": 200, "type": "array" }, "hash": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "previous_hash": { "anyOf": [ { "pattern": "^[a-f0-9]{64}$", "type": "string" }, { "type": "null" } ] }, "review": { "additionalProperties": false, "description": "Versioned Release Guardian evidence. Findings and excerpts are bounded; pointers refer to the full original result. A skipped comparator reports not_compared/CI2, never automatic approval. No customer code, live API behavior or deployment safety is established.", "properties": { "comparison_performed": { "type": "boolean" }, "complete": { "type": "boolean" }, "findings": { "items": { "additionalProperties": false, "properties": { "affected_path": { "type": "string" }, "after": { "type": [ "string", "null" ] }, "before": { "type": [ "string", "null" ] }, "compatibility_direction": { "enum": [ "request", "response", "authentication", "operation_or_shared" ], "type": "string" }, "complete": { "type": "boolean" }, "confidence": { "enum": [ "supported_rule", "requires_review" ], "type": "string" }, "evidence": { "additionalProperties": false, "properties": { "after_sha256": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "after_source_pointer": { "type": [ "string", "null" ] }, "before_sha256": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "before_source_pointer": { "type": [ "string", "null" ] }, "change_pointer": { "type": "string" }, "change_pointer_scope": { "const": "full_original_result", "type": "string" }, "excerpts_may_be_truncated": { "const": true, "type": "boolean" }, "source_pointer_scope": { "const": "parsed_original_contract_declaration", "type": "string" } }, "required": [ "change_pointer", "change_pointer_scope", "before_sha256", "after_sha256", "excerpts_may_be_truncated" ], "type": "object" }, "explanation": { "type": "string" }, "finding_id": { "pattern": "^cf_[a-f0-9]{64}$", "type": "string" }, "operations": { "items": { "type": "string" }, "maxItems": 8, "type": "array" }, "recommended_action": { "enum": [ "block_and_review", "inspect_with_other_findings", "manual_review" ], "type": "string" }, "rule_id": { "type": "string" }, "severity": { "enum": [ "error", "warning", "info" ], "type": "string" } }, "required": [ "finding_id", "rule_id", "severity", "compatibility_direction", "affected_path", "operations", "complete", "before", "after", "explanation", "evidence", "confidence", "recommended_action" ], "type": "object" }, "maxItems": 20, "type": "array" }, "findings_omitted": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "findings_total": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "groups": { "additionalProperties": { "items": { "type": "string" }, "maxItems": 20, "type": "array" }, "propertyNames": { "type": "string" }, "type": "object" }, "input_fingerprints": { "additionalProperties": false, "properties": { "after_sha256": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "before_sha256": { "anyOf": [ { "pattern": "^[a-f0-9]{64}$", "type": "string" }, { "type": "null" } ] } }, "required": [ "before_sha256", "after_sha256" ], "type": "object" }, "reason": { "enum": [ "baseline_seeded", "hash_unchanged" ], "type": "string" }, "result_id": { "pattern": "^review_[a-f0-9]{64}$", "type": "string" }, "schema": { "const": "fresh402-contract-review-v1", "type": "string" }, "scope": { "type": "string" }, "verdict": { "additionalProperties": false, "properties": { "ci_exit_code": { "anyOf": [ { "const": 0, "type": "number" }, { "const": 1, "type": "number" }, { "const": 2, "type": "number" } ] }, "live_api_verified": { "const": false, "type": "boolean" }, "scope": { "type": "string" }, "status": { "enum": [ "breaking", "review_required", "no_breaking_change_observed", "not_compared" ], "type": "string" }, "unsupported_features_require_review": { "const": true, "type": "boolean" } }, "required": [ "status", "ci_exit_code", "live_api_verified" ], "type": "object" } }, "required": [ "schema", "comparison_performed", "verdict", "input_fingerprints", "findings", "findings_total", "findings_omitted", "groups", "complete" ], "type": "object" }, "scope": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "status": { "enum": [ "baseline_seeded", "no_supported_contract_change", "unchanged_in_scope", "changed_in_scope", "review_required", "descriptive_only" ], "type": "string" }, "summary": { "anyOf": [ { "type": "string" }, { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" } ] } }, "required": [ "status", "changed", "scope", "hash", "previous_hash", "summary", "evidence", "comparison", "comparison_executed", "completeness" ], "type": "object" } }, "required": [ "website" ], "type": "object" }, "observation_id": { "pattern": "^wf_[a-f0-9]{64}$", "type": "string" }, "observed_at": { "type": "string" }, "persistence_error": { "type": "string" }, "portable_state": { "anyOf": [ { "additionalProperties": false, "properties": { "caller_retention_days": { "const": 30, "type": "number" }, "expires_at": { "type": "string" }, "observed_at": { "type": "string" }, "payload_bytes": { "maximum": 32768, "minimum": 0, "type": "integer" }, "payment_authority": { "const": false, "type": "boolean" }, "retention_extended": { "const": false, "type": "boolean" }, "server_retention_days": { "const": 7, "type": "number" }, "source_freshness_verified": { "const": false, "type": "boolean" }, "status": { "const": "available", "type": "string" }, "token": { "maxLength": 44000, "type": "string" } }, "required": [ "status", "token", "expires_at", "observed_at", "payload_bytes", "server_retention_days", "caller_retention_days", "retention_extended", "payment_authority", "source_freshness_verified" ], "type": "object" }, { "additionalProperties": false, "properties": { "max_payload_bytes": { "const": 32768, "type": "number" }, "retention_extended": { "const": false, "type": "boolean" }, "status": { "const": "omitted_size", "type": "string" } }, "required": [ "status", "max_payload_bytes", "retention_extended" ], "type": "object" } ], "description": "Opt-in private caller-retained source evidence, independently integrity-protected and bound to principal/workflow/environment/scope. Not encryption, payment authority, current freshness or an extension of original-result/server retention." }, "provenance": { "additionalProperties": false, "properties": { "portable_baseline": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "previous_observation": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "register_baseline": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "scope_identity": { "type": "string" }, "supplied_contracts": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "website": { "additionalProperties": false, "properties": { "content_type": { "type": "string" }, "final_url": { "format": "uri", "type": "string" }, "observed_at": { "type": "string" }, "raw_source_hash": { "pattern": "^[a-f0-9]{64}$", "type": "string" }, "requested_url": { "format": "uri", "type": "string" } }, "required": [ "requested_url", "final_url", "raw_source_hash", "observed_at", "content_type" ], "type": "object" } }, "required": [ "website", "scope_identity" ], "type": "object" }, "snapshot_saved": { "type": "boolean" }, "state_expires_at": { "type": "string" }, "status": { "enum": [ "baseline_seeded", "no_supported_contract_change", "unchanged_in_scope", "changed_in_scope", "review_required", "descriptive_only", "evidence_ready" ], "type": "string" }, "summary": { "additionalProperties": {}, "description": "Task-level result; a seeded baseline is not a comparison, and evidence does not prove deployment or causation.", "properties": { "changed": { "type": [ "boolean", "null" ] }, "comparison": { "enum": [ "seeded", "previous", "baseline", "supplied", "portable" ], "type": "string" }, "consistency": { "const": "not_established", "type": "string" }, "findings": { "anyOf": [ { "type": "string" }, { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" } ] }, "release_label": { "type": "string" } }, "type": "object" }, "version": { "const": 1, "type": "number" }, "warnings": { "items": { "type": "string" }, "maxItems": 50, "type": "array" }, "workflow": { "const": "website_change_intelligence", "type": "string" }, "workflow_state_saved": { "type": "boolean" } }, "type": "object" } } ] }
Verify it yourselfcurl -s https://api.teppi.xyz/v1/evidence/sha256:992efd5e79b3b4746b852ca63bf391fd891a852403d848181b7b2dc22eb326fa | sha256sum