MCP 服务器

SITEBORNE Utility Network

net.siteborne/utility
知识与文档 搜索与研究 公开且可连接 MCP 2025-11-25

此 MCP 可以做什么

Retrieves and verifies evidence from websites and documents, builds company evidence graphs, and evaluates agent outputs against claims or schemas.

siteborne_build_company_evidence_graph
Build company evidence graph
Build a proof-carrying graph of public company identity, SEC filings, website observations, regulatory mentions, and repository signals. Use when: the request needs entity-level evidence synthesized across sources. Do not use when: one URL is the subject (use siteborne_retrieve_verified_web_context), one document is the subject (use siteborne_extract_document_evidence_json), or an existing agent output needs evaluation (use siteborne_verify_agent_output). Parameters: authoritative identifiers (cik, lei, isin, cusip, figi) resolve entities more reliably than company_name, ticker or domain alone, and combining them reduces ambiguity; requested_field_groups narrows provider work; maximum_authorized_price only constrains payment and never widens scope. Behavior: open-world: a paid request queries public data providers over the network and persists governed payment, audit, job and Workflow state; an unpaid request returns payment_required; a repeated identical request with the same payment is replay-protected and is not charged twice. This service is currently production-disabled and rejects execution. Economics: exact price of $0.0312 USD per request; the payment challenge requires that amount and the charge settles at exactly that amount. Failure: input that fails schema validation is rejected before any payment challenge; provider or service unavailability returns a structured MCP error. Returns: a company evidence graph with provenance, completeness, verification, and PCC context—not a raw webpage or document extraction.
可访问外部资源 幂等
输入模式
{'$id': 'https://siteborne.net/schemas/services/company-evidence-input.schema.json', 'type': 'object', 'anyOf': [{'required': ['company_name']}, {'required': ['ticker']}, {'required': ['domain']}, {'required': ['identifiers']}], 'title': 'Company Evidence Graph Input', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'examples': [{'domain': 'acme.example.com', 'company_name': 'Acme Corporation', 'freshness_seconds': 86400, 'requested_field_groups': ['identity', 'sec_submissions', 'website_evidence'], 'minimum_verification_score': 0.7}], 'required': [], 'properties': {'domain': {'type': 'string', 'format': 'hostname', 'maxLength': 253, 'description': 'Primary website hostname only, without a URL path; links first-party web evidence to the company identity.'}, 'ticker': {'type': 'string', 'pattern': '^[A-Z]{1,5}$', 'maxLength': 5, 'description': 'One-to-five uppercase exchange ticker symbols; narrows public-company resolution but is not globally unique without other signals.'}, 'buyer_urls': {'type': 'array', 'items': {'type': 'string', 'format': 'uri', 'maxLength': 2048}, 'maxItems': 20, 'description': 'Up to twenty public supplemental evidence URLs supplied by the buyer; these are additional sources, not replacements for entity resolution.'}, 'identifiers': {'type': 'object', 'properties': {'cik': {'type': 'string', 'pattern': '^[0-9]{10}$', 'description': 'Exactly ten decimal digits identifying the company in SEC EDGAR.'}, 'lei': {'type': 'string', 'pattern': '^[A-Z0-9]{20}$', 'description': 'Exactly twenty uppercase alphanumeric characters for the Legal Entity Identifier.'}, 'figi': {'type': 'string', 'pattern': '^BBG[0-9A-Z]{9}$', 'description': 'Twelve-character OpenFIGI identifier beginning with BBG.'}, 'isin': {'type': 'string', 'pattern': '^[A-Z]{2}[A-Z0-9]{9}[0-9]$', 'description': 'Twelve-character International Securities Identification Number.'}, 'cusip': {'type': 'string', 'pattern': '^[A-Z0-9]{9}$', 'description': 'Nine-character CUSIP security identifier.'}, 'exchange': {'type': 'string', 'maxLength': 16, 'description': 'Primary listing exchange name or code, up to sixteen characters; disambiguates reused ticker symbols.'}, 'ticker_symbol': {'type': 'string', 'pattern': '^[A-Z]{1,5}$', 'description': 'One-to-five uppercase characters for the primary listed ticker when it differs from ticker.'}}, 'description': 'Known authoritative entity identifiers; supplying precise identifiers reduces ambiguous name, ticker, or domain matching.', 'maxProperties': 10, 'additionalProperties': False}, 'company_name': {'type': 'string', 'maxLength': 256, 'minLength': 1, 'description': 'Legal or commonly used company name; supplies an entity-resolution signal when authoritative identifiers are unavailable.'}, 'freshness_seconds': {'type': 'integer', 'default': 86400, 'maximum': 2592000, 'minimum': 0, 'description': 'Maximum acceptable source age in seconds, from 0 through 2,592,000; lower values demand fresher evidence.'}, 'jurisdiction_hints': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[A-Z]{2}$', 'maxLength': 2}, 'maxItems': 5, 'description': 'Up to five two-letter uppercase jurisdiction codes used to focus regulatory context; hints do not assert incorporation.'}, 'minimum_completeness': {'type': 'number', 'default': 0.5, 'maximum': 1, 'minimum': 0, 'description': 'Required completeness ratio from 0 through 1; results below this threshold fail the requested acceptance condition.'}, 'requested_field_groups': {'type': 'array', 'items': {'enum': ['identity', 'sec_submissions', 'xbrl_facts', 'recent_filings', 'website_evidence', 'regulatory_mentions', 'public_repository_signals'], 'type': 'string'}, 'default': ['identity', 'sec_submissions', 'recent_filings', 'website_evidence'], 'maxItems': 7, 'description': 'Unique evidence categories to collect; omitted values use the schema default, while a smaller list limits provider work and result scope.', 'uniqueItems': True}, 'maximum_authorized_price': {'type': 'object', 'title': 'Decimal Money', 'examples': [{'amount': '0.039', 'currency': 'USD'}, {'asset': 'USDC', 'amount': '0.19', 'network': 'base-mainnet', 'currency': 'USD'}], 'required': ['amount', 'currency'], 'properties': {'asset': {'type': 'string', 'pattern': '^[A-Z0-9]{3,10}$', 'description': "Payment asset identifier (e.g., 'USDC', 'ETH'). Optional for non-payment contexts."}, 'amount': {'type': 'string', 'pattern': '^(0|[1-9][0-9]*)(\\.[0-9]{1,18})?$', 'examples': ['0', '0.009', '0.012', '0.019', '0.029', '0.039', '0.049', '0.19'], 'description': "Canonical decimal string. No scientific notation, no leading zeros (except single '0'), no trailing zeros unless significant, no sign. Maximum 18 decimal places."}, 'network': {'type': 'string', 'pattern': '^[a-z0-9-]+$', 'maxLength': 64, 'description': "Payment network identifier (e.g., 'base-mainnet', 'base-sepolia'). Optional for non-payment contexts."}, 'currency': {'enum': ['USD'], 'type': 'string', 'default': 'USD', 'pattern': '^[A-Z]{3}$', 'description': 'ISO 4217 currency code.'}, 'precision': {'type': 'integer', 'default': 6, 'maximum': 18, 'minimum': 0, 'description': 'Maximum decimal places supported by the asset/network. Metadata only.'}}, 'description': 'Buyerâ\x80\x99s decimal-safe maximum authorized price; constrains the payment requirement and never expands provider scope.', 'additionalProperties': False}, 'minimum_verification_score': {'type': 'number', 'default': 0.7, 'maximum': 1, 'minimum': 0, 'description': 'Required PCC verification ratio from 0 through 1; raising it makes result acceptance stricter.'}}, 'description': 'Input schema for company_evidence_graph.v1 service. At least one identity signal is required.', 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['result'], 'properties': {'result': {'$id': 'https://siteborne.net/schemas/services/company-evidence-output.schema.json', '$defs': {'pcc': {'type': 'object', 'title': 'Proof-Carrying Context (PCC) v1.0.0', 'required': ['pcc_version', 'job_id', 'contract', 'subject', 'claims', 'evidence', 'completeness', 'provenance', 'verification', 'receipt'], 'properties': {'claims': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/claim'}, 'uniqueItems': True}, 'job_id': {'$ref': '#/$defs/pcc/definitions/job_id'}, 'receipt': {'$ref': '#/$defs/pcc/definitions/receipt'}, 'subject': {'$ref': '#/$defs/pcc/definitions/subject'}, 'contract': {'$ref': '#/$defs/pcc/definitions/contract'}, 'evidence': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/evidence_item'}, 'uniqueItems': True}, 'extensions': {'$ref': '#/$defs/pcc/definitions/extension_container'}, 'provenance': {'$ref': '#/$defs/pcc/definitions/provenance'}, 'pcc_version': {'$ref': '#/$defs/pcc/definitions/pcc_version'}, 'completeness': {'$ref': '#/$defs/pcc/definitions/completeness'}, 'verification': {'$ref': '#/$defs/pcc/definitions/verification'}}, 'definitions': {'hash': {'type': 'string', 'pattern': '^sha256:[a-f0-9]{64}$', 'description': 'SHA-256 hash with algorithm tag'}, 'claim': {'type': 'object', 'required': ['claim_id', 'predicate', 'value', 'confidence', 'evidence_ids', 'materiality', 'verification_status'], 'properties': {'value': {'type': ['string', 'number', 'boolean', 'object', 'array', 'null']}, 'claim_id': {'$ref': '#/$defs/pcc/definitions/claim_id'}, 'predicate': {'type': 'string', 'minLength': 1}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'materiality': {'$ref': '#/$defs/pcc/definitions/materiality'}, 'evidence_ids': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/evidence_id'}}, 'verification_status': {'$ref': '#/$defs/pcc/definitions/verification_status'}}, 'additionalProperties': False}, 'job_id': {'type': 'string', 'pattern': '^job_[a-z0-9]{24}$', 'description': 'Unique job identifier'}, 'key_id': {'type': 'string', 'pattern': '^kid_[a-z0-9]{24}$', 'description': 'Key identifier'}, 'locator': {'type': 'object', 'required': ['type', 'value'], 'properties': {'type': {'$ref': '#/$defs/pcc/definitions/locator_type'}, 'value': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'receipt': {'type': 'object', 'required': ['output_hash', 'canonicalization_algorithm', 'policy_hash', 'schema_hash', 'signature_algorithm', 'signing_key_id', 'signature', 'signed_at'], 'properties': {'signature': {'type': 'string', 'pattern': '^[A-Za-z0-9_-]{86,88}$'}, 'signed_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'output_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'policy_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'schema_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'signing_key_id': {'$ref': '#/$defs/pcc/definitions/key_id'}, 'signature_algorithm': {'$ref': '#/$defs/pcc/definitions/signature_algorithm'}, 'canonicalization_algorithm': {'$ref': '#/$defs/pcc/definitions/canonicalization_algorithm'}}, 'additionalProperties': False}, 'subject': {'type': 'object', 'required': ['type', 'canonical_name'], 'properties': {'type': {'$ref': '#/$defs/pcc/definitions/subject_type'}, 'identifiers': {'type': 'object', 'additionalProperties': {'type': 'string'}}, 'canonical_name': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'claim_id': {'type': 'string', 'pattern': '^clm_[a-z0-9]{24}$', 'description': 'Claim identifier'}, 'contract': {'type': 'object', 'required': ['service_id', 'service_version', 'input_hash', 'input_schema_hash', 'output_schema_hash', 'quote_id', 'mode', 'currency', 'minimum_quality', 'freshness_seconds', 'issued_at', 'expires_at', 'idempotency_key'], 'properties': {'mode': {'$ref': '#/$defs/pcc/definitions/contract_mode'}, 'price': {'$ref': '#/$defs/pcc/definitions/decimal_string'}, 'network': {'enum': ['base', 'base-testnet'], 'type': 'string'}, 'currency': {'$ref': '#/$defs/pcc/definitions/currency'}, 'quote_id': {'$ref': '#/$defs/pcc/definitions/quote_id'}, 'issued_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'expires_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'input_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'service_id': {'$ref': '#/$defs/pcc/definitions/service_id'}, 'idempotency_key': {'$ref': '#/$defs/pcc/definitions/idempotency_key'}, 'minimum_quality': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'service_version': {'$ref': '#/$defs/pcc/definitions/service_version'}, 'freshness_seconds': {'type': 'integer', 'minimum': 1}, 'input_schema_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'output_schema_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'maximum_authorized_price': {'$ref': '#/$defs/pcc/definitions/decimal_string'}}, 'additionalProperties': False}, 'currency': {'enum': ['USD', 'USDC'], 'type': 'string', 'description': 'Permitted currencies'}, 'quote_id': {'type': 'string', 'pattern': '^qte_[a-z0-9]{24}$', 'description': 'Quote identifier'}, 'policy_id': {'type': 'string', 'pattern': '^pol_[a-z0-9]{24}$', 'description': 'Policy identifier'}, 'provenance': {'type': 'object', 'required': ['routes', 'providers', 'tools', 'models', 'software_versions', 'policy_versions', 'transformations', 'cache_provenance', 'execution_environment', 'verification_routes'], 'properties': {'tools': {'type': 'object', 'description': 'Tool name to version mapping', 'additionalProperties': {'type': 'string'}}, 'models': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'version', 'provider'], 'properties': {'name': {'type': 'string', 'minLength': 1}, 'version': {'type': 'string', 'minLength': 1}, 'provider': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}}, 'routes': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/provenance_route'}}, 'providers': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'version', 'capabilities'], 'properties': {'name': {'type': 'string', 'minLength': 1}, 'version': {'type': 'string', 'minLength': 1}, 'capabilities': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}}, 'policy_versions': {'type': 'object', 'description': 'Policy name to version mapping', 'additionalProperties': {'type': 'string'}}, 'transformations': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/transformation'}}, 'cache_provenance': {'type': 'object', 'required': ['enabled', 'hit'], 'properties': {'hit': {'type': 'boolean'}, 'enabled': {'type': 'boolean'}, 'cache_key': {'type': 'string'}, 'stored_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}}, 'additionalProperties': False}, 'software_versions': {'type': 'object', 'description': 'Component name to version mapping', 'additionalProperties': {'type': 'string'}}, 'verification_routes': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/provenance_route'}}, 'execution_environment': {'type': 'object', 'required': ['runtime', 'version', 'platform'], 'properties': {'runtime': {'type': 'string', 'minLength': 1}, 'version': {'type': 'string', 'minLength': 1}, 'platform': {'type': 'string', 'minLength': 1}, 'container_image': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'service_id': {'enum': ['company_evidence_graph.v1', 'web_context_verified.v1', 'document_evidence_json.v1', 'verify_agent_output.v1', 'company_evidence_graph.v2', 'web_context_verified.v2', 'document_evidence_json.v2', 'verify_agent_output.v2'], 'type': 'string', 'description': 'Service identifier'}, 'evidence_id': {'type': 'string', 'pattern': '^evd_[a-z0-9]{24}$', 'description': 'Evidence identifier'}, 'materiality': {'enum': ['material', 'supporting', 'contextual'], 'type': 'string', 'description': 'Claim materiality classification'}, 'pcc_version': {'type': 'string', 'const': '1.0.0', 'description': 'PCC specification version'}, 'completeness': {'type': 'object', 'required': ['requested_fields', 'populated_fields', 'supported_fields', 'score', 'missing_fields', 'unsupported_fields', 'stale_fields', 'vector'], 'properties': {'score': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'vector': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/completeness_vector_entry'}}, 'stale_fields': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}}, 'missing_fields': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}}, 'populated_fields': {'type': 'integer', 'minimum': 0}, 'requested_fields': {'type': 'integer', 'minimum': 0}, 'supported_fields': {'type': 'integer', 'minimum': 0}, 'unsupported_fields': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}}}, 'additionalProperties': False}, 'locator_type': {'enum': ['json_pointer', 'xpath', 'css_selector', 'text_quote', 'page_region', 'byte_range', 'database_record', 'artifact_pointer'], 'type': 'string', 'description': 'Evidence locator type'}, 'subject_type': {'enum': ['organization', 'person', 'document', 'webpage', 'other'], 'type': 'string', 'description': 'Subject type'}, 'verification': {'type': 'object', 'required': ['schema_valid', 'material_claims_supported', 'evidence_accessibility', 'freshness', 'completeness', 'cross_source_agreement', 'provenance_valid', 'prompt_injection_result', 'deterministic_failures', 'verifier_versions', 'policy', 'decision', 'score', 'failed_requirements'], 'properties': {'score': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'policy': {'$ref': '#/$defs/pcc/definitions/policy_id'}, 'decision': {'$ref': '#/$defs/pcc/definitions/verification_decision'}, 'freshness': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'completeness': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'schema_valid': {'type': 'boolean'}, 'provenance_valid': {'type': 'boolean'}, 'verifier_versions': {'type': 'object', 'additionalProperties': {'type': 'string'}}, 'failed_requirements': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}}, 'cross_source_agreement': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'deterministic_failures': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}}, 'evidence_accessibility': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'prompt_injection_result': {'type': 'object', 'required': ['checked', 'result'], 'properties': {'result': {'enum': ['clean', 'suspected', 'confirmed'], 'type': 'string'}, 'checked': {'type': 'boolean'}, 'details': {'type': 'string'}}, 'additionalProperties': False}, 'material_claims_supported': {'type': 'boolean'}}, 'additionalProperties': False}, 'contract_mode': {'enum': ['paid', 'benchmark', 'offline_verification'], 'type': 'string', 'description': 'Contract mode determines required fields'}, 'evidence_item': {'type': 'object', 'required': ['evidence_id', 'source_uri', 'retrieved_at', 'content_hash', 'media_type', 'locator', 'accessibility_status', 'transformation_history', 'authorization_classification', 'freshness_status'], 'properties': {'locator': {'$ref': '#/$defs/pcc/definitions/locator'}, 'media_type': {'type': 'string', 'minLength': 1}, 'source_uri': {'type': 'string', 'format': 'uri', 'minLength': 1}, 'evidence_id': {'$ref': '#/$defs/pcc/definitions/evidence_id'}, 'content_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'retrieved_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'freshness_status': {'$ref': '#/$defs/pcc/definitions/freshness_status'}, 'source_timestamp': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'accessibility_status': {'$ref': '#/$defs/pcc/definitions/accessibility_status'}, 'transformation_history': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/transformation'}}, 'authorization_classification': {'$ref': '#/$defs/pcc/definitions/authorization_classification'}}, 'additionalProperties': False}, 'decimal_string': {'type': 'string', 'pattern': '^(0|[1-9]\\d*)(\\.\\d+)?$', 'description': 'Non-negative decimal string, no scientific notation, no leading zeros except single zero'}, 'transformation': {'type': 'object', 'required': ['type', 'timestamp', 'tool_version'], 'properties': {'type': {'type': 'string', 'minLength': 1}, 'timestamp': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'parameters': {'type': 'object', 'additionalProperties': True}, 'tool_version': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'extension_value': {'type': 'object', 'description': 'Bounded JSON data payload for a single namespaced extension (PCC 1.0.1). Must be a JSON object; unbounded, executable, or policy-changing structures are out of scope for structural validation. Individual services may further narrow this shape for their own namespace via allOf composition.', 'maxProperties': 200, 'additionalProperties': True}, 'idempotency_key': {'type': 'string', 'pattern': '^idk_[a-z0-9]{24}$', 'description': 'Idempotency key'}, 'service_version': {'type': 'string', 'pattern': '^v\\d+(\\.\\d+)*$', 'description': 'Service version'}, 'freshness_status': {'enum': ['fresh', 'stale', 'unknown'], 'type': 'string', 'description': 'Evidence freshness status'}, 'provenance_route': {'type': 'object', 'required': ['type', 'provider', 'version'], 'properties': {'type': {'enum': ['cache', 'direct', 'deterministic', 'model', 'hybrid'], 'type': 'string'}, 'version': {'type': 'string', 'minLength': 1}, 'provider': {'type': 'string', 'minLength': 1}, 'model_name': {'type': 'string'}, 'parameters': {'type': 'object', 'additionalProperties': True}, 'model_version': {'type': 'string'}}, 'additionalProperties': False}, 'timestamp_rfc3339': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?Z$', 'description': 'RFC 3339 UTC timestamp with Z suffix, normalized fractional seconds'}, 'extension_container': {'type': 'object', 'description': 'Controlled extension container. Keys must use reverse-domain qualified namespaces with at least three DNS-safe labels (e.g., net.siteborne.verification.v1, com.example.custom-metrics.v1). Underscores, leading/trailing hyphens, empty labels, and uppercase are forbidden. Maximum 10 extensions. Maximum total namespace key length: 253 characters. Each value must conform to extension_value (bounded JSON data).', 'maxProperties': 10, 'propertyNames': {'type': 'string', 'pattern': '^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?){2,}$', 'maxLength': 253, 'minLength': 5}, 'patternProperties': {'^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?){2,}$': {'$ref': '#/$defs/pcc/definitions/extension_value'}}, 'additionalProperties': False}, 'signature_algorithm': {'type': 'string', 'const': 'Ed25519', 'description': 'Signature algorithm'}, 'verification_status': {'enum': ['verified', 'unsupported', 'disputed', 'pending'], 'type': 'string', 'description': 'Claim verification status'}, 'accessibility_status': {'enum': ['accessible', 'unavailable', 'restricted', 'requires_authorization'], 'type': 'string', 'description': 'Evidence accessibility status'}, 'verification_decision': {'enum': ['pass', 'conditional', 'fail', 'quarantined'], 'type': 'string', 'description': 'Verification decision'}, 'completeness_vector_entry': {'type': 'object', 'required': ['dimension', 'requested', 'populated', 'supported', 'score'], 'properties': {'score': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'dimension': {'type': 'string', 'minLength': 1}, 'populated': {'type': 'integer', 'minimum': 0}, 'requested': {'type': 'integer', 'minimum': 0}, 'supported': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, 'canonicalization_algorithm': {'type': 'string', 'const': 'RFC8785-JCS', 'description': 'Canonicalization algorithm'}, 'authorization_classification': {'enum': ['public', 'buyer_authorized', 'restricted', 'confidential'], 'type': 'string', 'description': 'Evidence authorization classification'}}, 'description': 'Normative schema for Proof-Carrying Context 1.0.0. Frozen after compatibility validation passes. Schema patch 1.0.1 (SUN-0100 correction): extension_container now structurally permits qualified extension keys via patternProperties, matching documented semantics; pcc_version (document content compatibility) is unchanged at 1.0.0. Schema minor 1.1.0 (SUN-1000 checkpoint 1M): service_id enum gains 4 new .v2 members (additive-only per packages/pcc-schema/policy/COMPATIBILITY.md section 1/section 4, which explicitly classifies new enum values as minor-compatible -- not the docs/contracts/COMPATIBILITY_POLICY.md service-contract-release taxonomy, which does not govern this file); the 4 existing .v1 members are unchanged and remain valid; pcc_version is unchanged at 1.0.0.', 'pcc_version': '1.0.0', 'additionalProperties': False}, 'money': {'type': 'object', 'title': 'Decimal Money', 'examples': [{'amount': '0.039', 'currency': 'USD'}, {'asset': 'USDC', 'amount': '0.19', 'network': 'base-mainnet', 'currency': 'USD'}], 'required': ['amount', 'currency'], 'properties': {'asset': {'type': 'string', 'pattern': '^[A-Z0-9]{3,10}$', 'description': "Payment asset identifier (e.g., 'USDC', 'ETH'). Optional for non-payment contexts."}, 'amount': {'type': 'string', 'pattern': '^(0|[1-9][0-9]*)(\\.[0-9]{1,18})?$', 'examples': ['0', '0.009', '0.012', '0.019', '0.029', '0.039', '0.049', '0.19'], 'description': "Canonical decimal string. No scientific notation, no leading zeros (except single '0'), no trailing zeros unless significant, no sign. Maximum 18 decimal places."}, 'network': {'type': 'string', 'pattern': '^[a-z0-9-]+$', 'maxLength': 64, 'description': "Payment network identifier (e.g., 'base-mainnet', 'base-sepolia'). Optional for non-payment contexts."}, 'currency': {'enum': ['USD'], 'type': 'string', 'default': 'USD', 'pattern': '^[A-Z]{3}$', 'description': 'ISO 4217 currency code.'}, 'precision': {'type': 'integer', 'default': 6, 'maximum': 18, 'minimum': 0, 'description': 'Maximum decimal places supported by the asset/network. Metadata only.'}}, 'description': 'Canonical decimal-safe money representation. No binary floating-point. Amount is a canonical decimal string.', 'additionalProperties': False}}, 'allOf': [{'$ref': '#/$defs/pcc'}, {'type': 'object', 'required': ['contract', 'extensions'], 'properties': {'contract': {'type': 'object', 'required': ['service_id', 'service_version', 'output_schema_hash'], 'properties': {'service_id': {'enum': ['company_evidence_graph.v1', 'company_evidence_graph.v2']}, 'service_version': {'enum': ['v1', 'v2']}, 'output_schema_hash': {'type': 'string', 'pattern': '^sha256:[a-f0-9]{64}$'}}}, 'extensions': {'type': 'object', 'required': ['net.siteborne.company-evidence.v1'], 'properties': {'net.siteborne.company-evidence.v1': {'type': 'object', 'properties': {'conflicts': {'type': 'array', 'items': {'type': 'object', 'properties': {'field': {'type': 'string'}, 'values': {'type': 'array', 'items': {'type': 'string'}}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'resolution': {'type': 'string'}}, 'additionalProperties': False}, 'maxItems': 20}, 'limitations': {'type': 'array', 'items': {'type': 'string', 'maxLength': 256}, 'maxItems': 20}, 'cache_status': {'type': 'object', 'properties': {'hit': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'freshness_seconds': {'type': 'integer'}}, 'additionalProperties': False}, 'field_groups': {'type': 'object', 'description': 'Requested field groups with completion state.', 'patternProperties': {'^(identity|sec_submissions|xbrl_facts|recent_filings|website_evidence|regulatory_mentions|public_repository_signals)$': {'type': 'object', 'properties': {'items': {'type': 'array', 'items': {'type': 'object'}}, 'status': {'enum': ['complete', 'partial', 'empty', 'unavailable'], 'type': 'string'}, 'evidence_ids': {'type': 'array', 'items': {'type': 'string'}}, 'source_count': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'filing_summaries': {'type': 'array', 'items': {'type': 'object', 'properties': {'period_end': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$'}, 'filing_date': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$'}, 'filing_type': {'type': 'string'}, 'evidence_ids': {'type': 'array', 'items': {'type': 'string'}}, 'xbrl_available': {'type': 'boolean'}, 'accession_number': {'type': 'string'}}, 'additionalProperties': False}, 'maxItems': 50}, 'normalized_facts': {'type': 'object', 'description': 'Normalized XBRL facts keyed by concept.', 'additionalProperties': {'type': ['string', 'number', 'boolean']}}, 'verified_absences': {'type': 'array', 'items': {'type': 'object', 'required': ['claim', 'scope', 'sources_checked', 'confidence'], 'properties': {'claim': {'type': 'string', 'description': 'The claim that was verified absent.'}, 'scope': {'type': 'string', 'description': 'Search scope.'}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'limitations': {'type': 'string'}, 'evidence_ids': {'type': 'array', 'items': {'type': 'string'}}, 'search_window': {'type': 'string', 'description': 'Time window searched.'}, 'sources_checked': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}, 'maxItems': 20}, 'canonical_identity': {'type': 'object', 'properties': {'domain': {'type': 'string', 'format': 'hostname'}, 'ticker': {'type': 'string', 'pattern': '^[A-Z]{1,5}$'}, 'legal_name': {'type': 'string', 'maxLength': 256}, 'common_name': {'type': 'string', 'maxLength': 256}, 'resolved_identifiers': {'type': 'object', 'maxProperties': 10, 'additionalProperties': {'type': 'string'}}}, 'description': 'Canonical resolved organization identity.', 'additionalProperties': False}, 'declared_freshness': {'type': 'string', 'pattern': '^P(\\d+D)?(T(\\d+H)?(\\d+M)?(\\d+S)?)?$', 'description': 'ISO 8601 duration of freshness guarantee.'}, 'repository_signals': {'type': 'array', 'items': {'type': 'object', 'properties': {'repo': {'type': 'string'}, 'owner': {'type': 'string'}, 'stars': {'type': 'integer', 'minimum': 0}, 'platform': {'type': 'string'}, 'last_push': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?Z$'}, 'evidence_ids': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}, 'maxItems': 20}, 'resolved_identifiers': {'type': 'object', 'description': 'All resolved authoritative identifiers.', 'maxProperties': 10, 'additionalProperties': {'type': 'string'}}, 'website_observations': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'content_hash': {'type': 'string', 'pattern': '^sha256:[a-f0-9]{64}$'}, 'evidence_ids': {'type': 'array', 'items': {'type': 'string'}}, 'extracted_at': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?Z$'}}, 'additionalProperties': False}, 'maxItems': 20}, 'regulatory_references': {'type': 'array', 'items': {'type': 'object', 'properties': {'date': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$'}, 'source': {'type': 'string'}, 'description': {'type': 'string'}, 'evidence_ids': {'type': 'array', 'items': {'type': 'string'}}, 'reference_id': {'type': 'string'}}, 'additionalProperties': False}, 'maxItems': 30}, 'source_coverage_summary': {'type': 'object', 'properties': {'sec': {'type': 'boolean'}, 'website': {'type': 'boolean'}, 'regulatory': {'type': 'boolean'}, 'repositories': {'type': 'boolean'}}, 'additionalProperties': False}}, 'description': 'Company evidence extension payload.', 'additionalProperties': False}}, 'propertyNames': {'type': 'string', 'pattern': '^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?){2,}$', 'maxLength': 253, 'minLength': 5}}}}], 'title': 'Company Evidence Graph Output', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'examples': [{'claims': [], 'job_id': 'job_aaaaaaaaaaaaaaaaaaaaaaaa', 'receipt': {'signature': 'AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA', 'signed_at': '2026-08-05T10:00:00Z', 'output_hash': 'sha256:eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee', 'policy_hash': 'sha256:ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff', 'schema_hash': 'sha256:0000000000000000000000000000000000000000000000000000000000000000', 'signing_key_id': 'kid_aaaaaaaaaaaaaaaaaaaaaaaa', 'signature_algorithm': 'Ed25519', 'canonicalization_algorithm': 'RFC8785-JCS'}, 'subject': {'type': 'organization', 'identifiers': {'domain': 'acme.example.com'}, 'canonical_name': 'Acme Example Corp'}, 'contract': {'mode': 'paid', 'currency': 'USD', 'quote_id': 'qte_aaaaaaaaaaaaaaaaaaaaaaaa', 'issued_at': '2026-08-05T10:00:00Z', 'expires_at': '2026-08-06T10:00:00Z', 'input_hash': 'sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa', 'service_id': 'company_evidence_graph.v1', 'idempotency_key': 'idk_aaaaaaaaaaaaaaaaaaaaaaaa', 'minimum_quality': 0.8, 'service_version': 'v1', 'freshness_seconds': 3600, 'input_schema_hash': 'sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb', 'output_schema_hash': 'sha256:abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890'}, 'evidence': [], 'extensions': {'net.siteborne.company-evidence.v1': {'limitations': ['cache-only SEC data', 'no real-time price data'], 'field_groups': {'identity': {'status': 'complete', 'source_count': 3}, 'sec_submissions': {'status': 'partial', 'source_count': 2}, 'website_evidence': {'status': 'complete', 'source_count': 1}}, 'canonical_identity': {'domain': 'acme.example.com', 'ticker': 'ACME', 'legal_name': 'Acme Corporation'}, 'declared_freshness': 'P1D'}}, 'provenance': {'tools': {'curl': '8.0.0'}, 'models': [], 'routes': [{'type': 'direct', 'version': '1.0.0', 'provider': 'web'}], 'providers': [{'name': 'web', 'version': '1.0.0', 'capabilities': ['fetch']}], 'policy_versions': {'verification': '1.0.0'}, 'transformations': [], 'cache_provenance': {'hit': False, 'enabled': False}, 'software_versions': {'pcc': '1.0.0'}, 'verification_routes': [], 'execution_environment': {'runtime': 'node', 'version': '22.0.0', 'platform': 'linux'}}, 'pcc_version': '1.0.0', 'completeness': {'score': 0.8, 'vector': [{'score': 0.8, 'dimension': 'general', 'populated': 4, 'requested': 5, 'supported': 4}], 'stale_fields': [], 'missing_fields': ['ceo_name'], 'populated_fields': 4, 'requested_fields': 5, 'supported_fields': 4, 'unsupported_fields': []}, 'verification': {'score': 0.9, 'policy': 'pol_aaaaaaaaaaaaaaaaaaaaaaaa', 'decision': 'pass', 'freshness': 1, 'completeness': 0.8, 'schema_valid': True, 'provenance_valid': True, 'verifier_versions': {'pcc': '1.0.0'}, 'failed_requirements': [], 'cross_source_agreement': 1, 'deterministic_failures': [], 'evidence_accessibility': 1, 'prompt_injection_result': {'result': 'clean', 'checked': True}, 'material_claims_supported': True}}], 'description': 'Output schema for company_evidence_graph.v1 service. Must be a valid PCC 1.0.0 document with required net.siteborne.company-evidence.v1 extension.'}}}
siteborne_build_company_evidence_graph_v3_candidate
Build company evidence graph (v3 candidate)
Build a proof-carrying graph of public company identity, SEC filings, website observations, regulatory mentions, and repository signals. Use when: the request needs entity-level evidence synthesized across sources. Do not use when: one URL is the subject (use siteborne_retrieve_verified_web_context), one document is the subject (use siteborne_extract_document_evidence_json), or an existing agent output needs evaluation (use siteborne_verify_agent_output). Parameters: authoritative identifiers (cik, lei, isin, cusip, figi) resolve entities more reliably than company_name, ticker or domain alone, and combining them reduces ambiguity; requested_field_groups narrows provider work; maximum_authorized_price only constrains payment and never widens scope. Behavior: open-world: a paid request queries public data providers over the network and persists governed payment, audit, job and Workflow state; an unpaid request returns payment_required; a repeated identical request with the same payment is replay-protected and is not charged twice. This service is currently production-disabled and rejects execution. Economics: exact price of $0.0312 USD per request; the payment challenge requires that amount and the charge settles at exactly that amount. Failure: input that fails schema validation is rejected before any payment challenge; provider or service unavailability returns a structured MCP error. Returns: a company evidence graph with provenance, completeness, verification, and PCC context—not a raw webpage or document extraction.
可访问外部资源 幂等
输入模式
{'$id': 'https://siteborne.net/schemas/services/company-evidence-input.schema.json', 'type': 'object', 'anyOf': [{'required': ['company_name']}, {'required': ['ticker']}, {'required': ['domain']}, {'required': ['identifiers']}], 'title': 'Company Evidence Graph Input', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'examples': [{'domain': 'acme.example.com', 'company_name': 'Acme Corporation', 'freshness_seconds': 86400, 'requested_field_groups': ['identity', 'sec_submissions', 'website_evidence'], 'minimum_verification_score': 0.7}], 'required': [], 'properties': {'domain': {'type': 'string', 'format': 'hostname', 'maxLength': 253, 'description': 'Primary website hostname only, without a URL path; links first-party web evidence to the company identity.'}, 'ticker': {'type': 'string', 'pattern': '^[A-Z]{1,5}$', 'maxLength': 5, 'description': 'One-to-five uppercase exchange ticker symbols; narrows public-company resolution but is not globally unique without other signals.'}, 'buyer_urls': {'type': 'array', 'items': {'type': 'string', 'format': 'uri', 'maxLength': 2048}, 'maxItems': 20, 'description': 'Up to twenty public supplemental evidence URLs supplied by the buyer; these are additional sources, not replacements for entity resolution.'}, 'identifiers': {'type': 'object', 'properties': {'cik': {'type': 'string', 'pattern': '^[0-9]{10}$', 'description': 'Exactly ten decimal digits identifying the company in SEC EDGAR.'}, 'lei': {'type': 'string', 'pattern': '^[A-Z0-9]{20}$', 'description': 'Exactly twenty uppercase alphanumeric characters for the Legal Entity Identifier.'}, 'figi': {'type': 'string', 'pattern': '^BBG[0-9A-Z]{9}$', 'description': 'Twelve-character OpenFIGI identifier beginning with BBG.'}, 'isin': {'type': 'string', 'pattern': '^[A-Z]{2}[A-Z0-9]{9}[0-9]$', 'description': 'Twelve-character International Securities Identification Number.'}, 'cusip': {'type': 'string', 'pattern': '^[A-Z0-9]{9}$', 'description': 'Nine-character CUSIP security identifier.'}, 'exchange': {'type': 'string', 'maxLength': 16, 'description': 'Primary listing exchange name or code, up to sixteen characters; disambiguates reused ticker symbols.'}, 'ticker_symbol': {'type': 'string', 'pattern': '^[A-Z]{1,5}$', 'description': 'One-to-five uppercase characters for the primary listed ticker when it differs from ticker.'}}, 'description': 'Known authoritative entity identifiers; supplying precise identifiers reduces ambiguous name, ticker, or domain matching.', 'maxProperties': 10, 'additionalProperties': False}, 'company_name': {'type': 'string', 'maxLength': 256, 'minLength': 1, 'description': 'Legal or commonly used company name; supplies an entity-resolution signal when authoritative identifiers are unavailable.'}, 'freshness_seconds': {'type': 'integer', 'default': 86400, 'maximum': 2592000, 'minimum': 0, 'description': 'Maximum acceptable source age in seconds, from 0 through 2,592,000; lower values demand fresher evidence.'}, 'jurisdiction_hints': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[A-Z]{2}$', 'maxLength': 2}, 'maxItems': 5, 'description': 'Up to five two-letter uppercase jurisdiction codes used to focus regulatory context; hints do not assert incorporation.'}, 'minimum_completeness': {'type': 'number', 'default': 0.5, 'maximum': 1, 'minimum': 0, 'description': 'Required completeness ratio from 0 through 1; results below this threshold fail the requested acceptance condition.'}, 'requested_field_groups': {'type': 'array', 'items': {'enum': ['identity', 'sec_submissions', 'xbrl_facts', 'recent_filings', 'website_evidence', 'regulatory_mentions', 'public_repository_signals'], 'type': 'string'}, 'default': ['identity', 'sec_submissions', 'recent_filings', 'website_evidence'], 'maxItems': 7, 'description': 'Unique evidence categories to collect; omitted values use the schema default, while a smaller list limits provider work and result scope.', 'uniqueItems': True}, 'maximum_authorized_price': {'type': 'object', 'title': 'Decimal Money', 'examples': [{'amount': '0.039', 'currency': 'USD'}, {'asset': 'USDC', 'amount': '0.19', 'network': 'base-mainnet', 'currency': 'USD'}], 'required': ['amount', 'currency'], 'properties': {'asset': {'type': 'string', 'pattern': '^[A-Z0-9]{3,10}$', 'description': "Payment asset identifier (e.g., 'USDC', 'ETH'). Optional for non-payment contexts."}, 'amount': {'type': 'string', 'pattern': '^(0|[1-9][0-9]*)(\\.[0-9]{1,18})?$', 'examples': ['0', '0.009', '0.012', '0.019', '0.029', '0.039', '0.049', '0.19'], 'description': "Canonical decimal string. No scientific notation, no leading zeros (except single '0'), no trailing zeros unless significant, no sign. Maximum 18 decimal places."}, 'network': {'type': 'string', 'pattern': '^[a-z0-9-]+$', 'maxLength': 64, 'description': "Payment network identifier (e.g., 'base-mainnet', 'base-sepolia'). Optional for non-payment contexts."}, 'currency': {'enum': ['USD'], 'type': 'string', 'default': 'USD', 'pattern': '^[A-Z]{3}$', 'description': 'ISO 4217 currency code.'}, 'precision': {'type': 'integer', 'default': 6, 'maximum': 18, 'minimum': 0, 'description': 'Maximum decimal places supported by the asset/network. Metadata only.'}}, 'description': 'Buyerâ\x80\x99s decimal-safe maximum authorized price; constrains the payment requirement and never expands provider scope.', 'additionalProperties': False}, 'minimum_verification_score': {'type': 'number', 'default': 0.7, 'maximum': 1, 'minimum': 0, 'description': 'Required PCC verification ratio from 0 through 1; raising it makes result acceptance stricter.'}}, 'description': 'Input schema for company_evidence_graph.v1 service. At least one identity signal is required.', 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['result'], 'properties': {'result': {'$id': 'https://utility.siteborne.net/contracts/3.0.0/schemas/services/company-evidence-output.schema.json', '$defs': {'pcc': {'type': 'object', 'title': 'Proof-Carrying Context (PCC) v2.0.0', 'required': ['pcc_version', 'job_id', 'contract', 'subject', 'claims', 'evidence', 'completeness', 'provenance', 'verification', 'receipt'], 'properties': {'claims': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/claim'}, 'uniqueItems': True}, 'job_id': {'$ref': '#/$defs/pcc/definitions/job_id'}, 'receipt': {'$ref': '#/$defs/pcc/definitions/receipt'}, 'subject': {'$ref': '#/$defs/pcc/definitions/subject'}, 'contract': {'$ref': '#/$defs/pcc/definitions/contract'}, 'evidence': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/evidence_item'}, 'uniqueItems': True}, 'extensions': {'allOf': [{'$ref': '#/$defs/pcc/definitions/extension_container'}, {'type': 'object', 'required': ['net.siteborne.verification-proof.v1'], 'properties': {'net.siteborne.verification-proof.v1': {'$ref': '#/$defs/pcc/definitions/verification_proof_v1'}}}]}, 'provenance': {'$ref': '#/$defs/pcc/definitions/provenance'}, 'pcc_version': {'$ref': '#/$defs/pcc/definitions/pcc_version'}, 'completeness': {'$ref': '#/$defs/pcc/definitions/completeness'}, 'verification': {'$ref': '#/$defs/pcc/definitions/verification'}}, 'definitions': {'hash': {'type': 'string', 'pattern': '^sha256:[a-f0-9]{64}$', 'description': 'SHA-256 hash with algorithm tag'}, 'claim': {'type': 'object', 'required': ['claim_id', 'predicate', 'value', 'confidence', 'evidence_ids', 'materiality', 'verification_status'], 'properties': {'value': {'type': ['string', 'number', 'boolean', 'object', 'array', 'null']}, 'claim_id': {'$ref': '#/$defs/pcc/definitions/claim_id'}, 'predicate': {'type': 'string', 'minLength': 1}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'materiality': {'$ref': '#/$defs/pcc/definitions/materiality'}, 'evidence_ids': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/evidence_id'}}, 'verification_status': {'$ref': '#/$defs/pcc/definitions/verification_status'}}, 'additionalProperties': False}, 'job_id': {'type': 'string', 'pattern': '^job_[a-z0-9]{24}$', 'description': 'Unique job identifier'}, 'key_id': {'type': 'string', 'pattern': '^kid_[a-z0-9]{24}$', 'description': 'Key identifier'}, 'locator': {'type': 'object', 'required': ['type', 'value'], 'properties': {'type': {'$ref': '#/$defs/pcc/definitions/locator_type'}, 'value': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'receipt': {'type': 'object', 'required': ['output_hash', 'canonicalization_algorithm', 'policy_hash', 'schema_hash', 'signature_algorithm', 'signing_key_id', 'signature', 'signed_at'], 'properties': {'signature': {'type': 'string', 'pattern': '^[A-Za-z0-9_-]{86,88}$'}, 'signed_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'output_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'policy_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'schema_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'signing_key_id': {'$ref': '#/$defs/pcc/definitions/key_id'}, 'signature_algorithm': {'$ref': '#/$defs/pcc/definitions/signature_algorithm'}, 'canonicalization_algorithm': {'$ref': '#/$defs/pcc/definitions/canonicalization_algorithm'}}, 'additionalProperties': False}, 'subject': {'type': 'object', 'required': ['type', 'canonical_name'], 'properties': {'type': {'$ref': '#/$defs/pcc/definitions/subject_type'}, 'identifiers': {'type': 'object', 'additionalProperties': {'type': 'string'}}, 'canonical_name': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'claim_id': {'type': 'string', 'pattern': '^clm_[a-z0-9]{24}$', 'description': 'Claim identifier'}, 'contract': {'type': 'object', 'required': ['service_id', 'service_version', 'input_hash', 'input_schema_hash', 'output_schema_hash', 'quote_id', 'mode', 'currency', 'minimum_quality', 'freshness_seconds', 'issued_at', 'expires_at', 'idempotency_key'], 'properties': {'mode': {'$ref': '#/$defs/pcc/definitions/contract_mode'}, 'price': {'$ref': '#/$defs/pcc/definitions/decimal_string'}, 'network': {'enum': ['base', 'base-testnet'], 'type': 'string'}, 'currency': {'$ref': '#/$defs/pcc/definitions/currency'}, 'quote_id': {'$ref': '#/$defs/pcc/definitions/quote_id'}, 'issued_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'expires_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'input_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'service_id': {'$ref': '#/$defs/pcc/definitions/service_id'}, 'idempotency_key': {'$ref': '#/$defs/pcc/definitions/idempotency_key'}, 'minimum_quality': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'service_version': {'$ref': '#/$defs/pcc/definitions/service_version'}, 'freshness_seconds': {'type': 'integer', 'minimum': 1}, 'input_schema_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'output_schema_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'maximum_authorized_price': {'$ref': '#/$defs/pcc/definitions/decimal_string'}}, 'additionalProperties': False}, 'currency': {'enum': ['USD', 'USDC'], 'type': 'string', 'description': 'Permitted currencies'}, 'quote_id': {'type': 'string', 'pattern': '^qte_[a-z0-9]{24}$', 'description': 'Quote identifier'}, 'policy_id': {'type': 'string', 'pattern': '^pol_[a-z0-9]{24}$', 'description': 'Policy identifier'}, 'provenance': {'type': 'object', 'required': ['routes', 'providers', 'tools', 'models', 'software_versions', 'policy_versions', 'transformations', 'cache_provenance', 'execution_environment', 'verification_routes'], 'properties': {'tools': {'type': 'object', 'description': 'Tool name to version mapping', 'additionalProperties': {'type': 'string'}}, 'models': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'version', 'provider'], 'properties': {'name': {'type': 'string', 'minLength': 1}, 'version': {'type': 'string', 'minLength': 1}, 'provider': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}}, 'routes': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/provenance_route'}}, 'providers': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'version', 'capabilities'], 'properties': {'name': {'type': 'string', 'minLength': 1}, 'version': {'type': 'string', 'minLength': 1}, 'capabilities': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}}, 'policy_versions': {'type': 'object', 'description': 'Policy name to version mapping', 'additionalProperties': {'type': 'string'}}, 'transformations': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/transformation'}}, 'cache_provenance': {'type': 'object', 'required': ['enabled', 'hit'], 'properties': {'hit': {'type': 'boolean'}, 'enabled': {'type': 'boolean'}, 'cache_key': {'type': 'string'}, 'stored_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}}, 'additionalProperties': False}, 'software_versions': {'type': 'object', 'description': 'Component name to version mapping', 'additionalProperties': {'type': 'string'}}, 'verification_routes': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/provenance_route'}}, 'execution_environment': {'type': 'object', 'required': ['runtime', 'version', 'platform'], 'properties': {'runtime': {'type': 'string', 'minLength': 1}, 'version': {'type': 'string', 'minLength': 1}, 'platform': {'type': 'string', 'minLength': 1}, 'container_image': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'service_id': {'enum': ['company_evidence_graph.v1', 'web_context_verified.v1', 'document_evidence_json.v1', 'verify_agent_output.v1', 'company_evidence_graph.v2', 'web_context_verified.v2', 'document_evidence_json.v2', 'verify_agent_output.v2', 'company_evidence_graph.v3', 'web_context_verified.v3', 'document_evidence_json.v3', 'verify_agent_output.v3'], 'type': 'string', 'description': 'Service identifier'}, 'evidence_id': {'type': 'string', 'pattern': '^evd_[a-z0-9]{24}$', 'description': 'Evidence identifier'}, 'materiality': {'enum': ['material', 'supporting', 'contextual'], 'type': 'string', 'description': 'Claim materiality classification'}, 'pcc_version': {'type': 'string', 'const': '2.0.0', 'description': 'PCC specification version'}, 'completeness': {'type': 'object', 'required': ['requested_fields', 'populated_fields', 'supported_fields', 'score', 'missing_fields', 'unsupported_fields', 'stale_fields', 'vector'], 'properties': {'score': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'vector': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/completeness_vector_entry'}}, 'stale_fields': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}}, 'missing_fields': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}}, 'populated_fields': {'type': 'integer', 'minimum': 0}, 'requested_fields': {'type': 'integer', 'minimum': 0}, 'supported_fields': {'type': 'integer', 'minimum': 0}, 'unsupported_fields': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}}}, 'additionalProperties': False}, 'locator_type': {'enum': ['json_pointer', 'xpath', 'css_selector', 'text_quote', 'page_region', 'byte_range', 'database_record', 'artifact_pointer'], 'type': 'string', 'description': 'Evidence locator type'}, 'subject_type': {'enum': ['organization', 'person', 'document', 'webpage', 'other'], 'type': 'string', 'description': 'Subject type'}, 'verification': {'type': 'object', 'required': ['schema_valid', 'material_claims_supported', 'evidence_accessibility', 'freshness', 'completeness', 'cross_source_agreement', 'provenance_valid', 'prompt_injection_result', 'deterministic_failures', 'verifier_versions', 'policy', 'decision', 'score', 'failed_requirements'], 'properties': {'score': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'policy': {'$ref': '#/$defs/pcc/definitions/policy_id'}, 'decision': {'$ref': '#/$defs/pcc/definitions/verification_decision'}, 'freshness': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'completeness': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'schema_valid': {'type': 'boolean'}, 'provenance_valid': {'type': 'boolean'}, 'verifier_versions': {'type': 'object', 'additionalProperties': {'type': 'string'}}, 'failed_requirements': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}}, 'cross_source_agreement': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'deterministic_failures': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}}, 'evidence_accessibility': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'prompt_injection_result': {'type': 'object', 'required': ['checked', 'result'], 'properties': {'result': {'enum': ['clean', 'suspected', 'confirmed'], 'type': 'string'}, 'checked': {'type': 'boolean'}, 'details': {'type': 'string'}}, 'additionalProperties': False}, 'material_claims_supported': {'type': 'boolean'}}, 'additionalProperties': False}, 'contract_mode': {'enum': ['paid', 'benchmark', 'offline_verification'], 'type': 'string', 'description': 'Contract mode determines required fields'}, 'evidence_item': {'type': 'object', 'required': ['evidence_id', 'source_uri', 'retrieved_at', 'content_hash', 'media_type', 'locator', 'accessibility_status', 'transformation_history', 'authorization_classification', 'freshness_status'], 'properties': {'locator': {'$ref': '#/$defs/pcc/definitions/locator'}, 'media_type': {'type': 'string', 'minLength': 1}, 'source_uri': {'type': 'string', 'format': 'uri', 'minLength': 1}, 'evidence_id': {'$ref': '#/$defs/pcc/definitions/evidence_id'}, 'content_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'retrieved_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'freshness_status': {'$ref': '#/$defs/pcc/definitions/freshness_status'}, 'source_timestamp': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'accessibility_status': {'$ref': '#/$defs/pcc/definitions/accessibility_status'}, 'transformation_history': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/transformation'}}, 'authorization_classification': {'$ref': '#/$defs/pcc/definitions/authorization_classification'}}, 'additionalProperties': False}, 'vnext_receipt': {'type': 'object', 'required': ['domain', 'proof_version', 'receipt_version', 'job_id', 'request_id', 'service_id', 'service_version', 'contract_release', 'pcc_schema_release', 'pcc_schema_hash', 'input_hash', 'output_schema_hash', 'output_hash', 'pcc_document_hash', 'evidence_hash', 'policy_hash', 'verifier_set_hash', 'decision', 'completeness', 'verification_mode', 'limitations', 'signing_key_id', 'canonicalization_algorithm', 'signature_algorithm', 'issued_at', 'receipt_id', 'signature'], 'properties': {'domain': {'type': 'string', 'const': 'SITEBORNE-PCC-VERIFICATION-PROOF-V1'}, 'job_id': {'$ref': '#/$defs/pcc/definitions/job_id'}, 'decision': {'$ref': '#/$defs/pcc/definitions/verification_decision'}, 'issued_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'signature': {'type': 'string', 'pattern': '^[A-Za-z0-9_-]{86}$'}, 'input_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'receipt_id': {'type': 'string', 'pattern': '^rcpt_[a-f0-9]{24}$'}, 'request_id': {'type': 'string', 'minLength': 1}, 'service_id': {'$ref': '#/$defs/pcc/definitions/service_id'}, 'limitations': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'maxItems': 200}, 'output_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'policy_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'completeness': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'evidence_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'proof_version': {'type': 'string', 'const': '1.0.0'}, 'signing_key_id': {'type': 'string', 'minLength': 1}, 'pcc_schema_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'receipt_version': {'type': 'string', 'const': '2.0.0'}, 'service_version': {'$ref': '#/$defs/pcc/definitions/service_version'}, 'contract_release': {'type': 'string', 'const': '3.0.0'}, 'pcc_document_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'verification_mode': {'enum': ['standard', 'independent_reproduction'], 'type': 'string'}, 'verifier_set_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'output_schema_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'pcc_schema_release': {'type': 'string', 'const': '2.0.0'}, 'signature_algorithm': {'type': 'string', 'const': 'Ed25519'}, 'canonicalization_algorithm': {'type': 'string', 'const': 'RFC8785-JCS'}}, 'additionalProperties': False}, 'decimal_string': {'type': 'string', 'pattern': '^(0|[1-9]\\d*)(\\.\\d+)?$', 'description': 'Non-negative decimal string, no scientific notation, no leading zeros except single zero'}, 'transformation': {'type': 'object', 'required': ['type', 'timestamp', 'tool_version'], 'properties': {'type': {'type': 'string', 'minLength': 1}, 'timestamp': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'parameters': {'type': 'object', 'additionalProperties': True}, 'tool_version': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'extension_value': {'type': 'object', 'description': 'Bounded JSON data payload for a single namespaced extension (PCC 1.0.1). Must be a JSON object; unbounded, executable, or policy-changing structures are out of scope for structural validation. Individual services may further narrow this shape for their own namespace via allOf composition.', 'maxProperties': 200, 'additionalProperties': True}, 'idempotency_key': {'type': 'string', 'pattern': '^idk_[a-z0-9]{24}$', 'description': 'Idempotency key'}, 'service_version': {'type': 'string', 'pattern': '^v\\d+(\\.\\d+)*$', 'description': 'Service version'}, 'freshness_status': {'enum': ['fresh', 'stale', 'unknown'], 'type': 'string', 'description': 'Evidence freshness status'}, 'provenance_route': {'type': 'object', 'required': ['type', 'provider', 'version'], 'properties': {'type': {'enum': ['cache', 'direct', 'deterministic', 'model', 'hybrid'], 'type': 'string'}, 'version': {'type': 'string', 'minLength': 1}, 'provider': {'type': 'string', 'minLength': 1}, 'model_name': {'type': 'string'}, 'parameters': {'type': 'object', 'additionalProperties': True}, 'model_version': {'type': 'string'}}, 'additionalProperties': False}, 'timestamp_rfc3339': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?Z$', 'description': 'RFC 3339 UTC timestamp with Z suffix, normalized fractional seconds'}, 'extension_container': {'type': 'object', 'description': 'Controlled extension container. Keys must use reverse-domain qualified namespaces with at least three DNS-safe labels (e.g., net.siteborne.verification.v1, com.example.custom-metrics.v1). Underscores, leading/trailing hyphens, empty labels, and uppercase are forbidden. Maximum 10 extensions. Maximum total namespace key length: 253 characters. Each value must conform to extension_value (bounded JSON data).', 'maxProperties': 10, 'propertyNames': {'type': 'string', 'pattern': '^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?){2,}$', 'maxLength': 253, 'minLength': 5}, 'patternProperties': {'^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?){2,}$': {'$ref': '#/$defs/pcc/definitions/extension_value'}}, 'additionalProperties': False}, 'signature_algorithm': {'type': 'string', 'const': 'Ed25519', 'description': 'Signature algorithm'}, 'verification_status': {'enum': ['verified', 'unsupported', 'disputed', 'pending'], 'type': 'string', 'description': 'Claim verification status'}, 'accessibility_status': {'enum': ['accessible', 'unavailable', 'restricted', 'requires_authorization'], 'type': 'string', 'description': 'Evidence accessibility status'}, 'verification_decision': {'enum': ['pass', 'conditional', 'fail', 'quarantined'], 'type': 'string', 'description': 'Verification decision'}, 'verification_proof_v1': {'type': 'object', 'required': ['proof_version', 'receipt', 'verification_material'], 'properties': {'receipt': {'$ref': '#/$defs/pcc/definitions/vnext_receipt'}, 'proof_version': {'type': 'string', 'const': '1.0.0'}, 'verification_material': {'type': 'object', 'required': ['verifier_results'], 'properties': {'verifier_results': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/public_verifier_result'}, 'maxItems': 100}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'public_verifier_result': {'type': 'object', 'required': ['verifier_id', 'status', 'findings', 'failure_codes'], 'properties': {'status': {'type': 'string', 'minLength': 1}, 'findings': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'severity'], 'properties': {'code': {'type': 'string', 'minLength': 1}, 'severity': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'maxItems': 200}, 'verifier_id': {'type': 'string', 'minLength': 1}, 'failure_codes': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'maxItems': 200}}, 'additionalProperties': False}, 'vnext_receipt_preimage': {'type': 'object', 'required': ['domain', 'proof_version', 'receipt_version', 'job_id', 'request_id', 'service_id', 'service_version', 'contract_release', 'pcc_schema_release', 'pcc_schema_hash', 'input_hash', 'output_schema_hash', 'output_hash', 'pcc_document_hash', 'evidence_hash', 'policy_hash', 'verifier_set_hash', 'decision', 'completeness', 'verification_mode', 'limitations', 'signing_key_id', 'canonicalization_algorithm', 'signature_algorithm', 'issued_at'], 'properties': {'domain': {'type': 'string', 'const': 'SITEBORNE-PCC-VERIFICATION-PROOF-V1'}, 'job_id': {'$ref': '#/$defs/pcc/definitions/job_id'}, 'decision': {'$ref': '#/$defs/pcc/definitions/verification_decision'}, 'issued_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'input_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'request_id': {'type': 'string', 'minLength': 1}, 'service_id': {'$ref': '#/$defs/pcc/definitions/service_id'}, 'limitations': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'maxItems': 200}, 'output_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'policy_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'completeness': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'evidence_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'proof_version': {'type': 'string', 'const': '1.0.0'}, 'signing_key_id': {'type': 'string', 'minLength': 1}, 'pcc_schema_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'receipt_version': {'type': 'string', 'const': '2.0.0'}, 'service_version': {'$ref': '#/$defs/pcc/definitions/service_version'}, 'contract_release': {'type': 'string', 'const': '3.0.0'}, 'pcc_document_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'verification_mode': {'enum': ['standard', 'independent_reproduction'], 'type': 'string'}, 'verifier_set_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'output_schema_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'pcc_schema_release': {'type': 'string', 'const': '2.0.0'}, 'signature_algorithm': {'type': 'string', 'const': 'Ed25519'}, 'canonicalization_algorithm': {'type': 'string', 'const': 'RFC8785-JCS'}}, 'additionalProperties': False}, 'completeness_vector_entry': {'type': 'object', 'required': ['dimension', 'requested', 'populated', 'supported', 'score'], 'properties': {'score': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'dimension': {'type': 'string', 'minLength': 1}, 'populated': {'type': 'integer', 'minimum': 0}, 'requested': {'type': 'integer', 'minimum': 0}, 'supported': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, 'canonicalization_algorithm': {'type': 'string', 'const': 'RFC8785-JCS', 'description': 'Canonicalization algorithm'}, 'authorization_classification': {'enum': ['public', 'buyer_authorized', 'restricted', 'confidential'], 'type': 'string', 'description': 'Evidence authorization classification'}}, 'description': 'Normative PCC 2.0.0 candidate. Requires a governed, reconstructible self-verifying receipt proof at extensions["net.siteborne.verification-proof.v1"]. The full PCC is the successful result root.', 'pcc_version': '2.0.0', 'additionalProperties': False}, 'money': {'type': 'object', 'title': 'Decimal Money', 'examples': [{'amount': '0.039', 'currency': 'USD'}, {'asset': 'USDC', 'amount': '0.19', 'network': 'base-mainnet', 'currency': 'USD'}], 'required': ['amount', 'currency'], 'properties': {'asset': {'type': 'string', 'pattern': '^[A-Z0-9]{3,10}$', 'description': "Payment asset identifier (e.g., 'USDC', 'ETH'). Optional for non-payment contexts."}, 'amount': {'type': 'string', 'pattern': '^(0|[1-9][0-9]*)(\\.[0-9]{1,18})?$', 'examples': ['0', '0.009', '0.012', '0.019', '0.029', '0.039', '0.049', '0.19'], 'description': "Canonical decimal string. No scientific notation, no leading zeros (except single '0'), no trailing zeros unless significant, no sign. Maximum 18 decimal places."}, 'network': {'type': 'string', 'pattern': '^[a-z0-9-]+$', 'maxLength': 64, 'description': "Payment network identifier (e.g., 'base-mainnet', 'base-sepolia'). Optional for non-payment contexts."}, 'currency': {'enum': ['USD'], 'type': 'string', 'default': 'USD', 'pattern': '^[A-Z]{3}$', 'description': 'ISO 4217 currency code.'}, 'precision': {'type': 'integer', 'default': 6, 'maximum': 18, 'minimum': 0, 'description': 'Maximum decimal places supported by the asset/network. Metadata only.'}}, 'description': 'Canonical decimal-safe money representation. No binary floating-point. Amount is a canonical decimal string.', 'additionalProperties': False}}, 'allOf': [{'$ref': '#/$defs/pcc'}, {'type': 'object', 'required': ['contract', 'extensions'], 'properties': {'contract': {'type': 'object', 'required': ['service_id', 'service_version', 'output_schema_hash'], 'properties': {'service_id': {'enum': ['company_evidence_graph.v3']}, 'service_version': {'enum': ['v3']}, 'output_schema_hash': {'type': 'string', 'pattern': '^sha256:[a-f0-9]{64}$'}}}, 'extensions': {'type': 'object', 'required': ['net.siteborne.company-evidence.v1'], 'properties': {'net.siteborne.company-evidence.v1': {'type': 'object', 'properties': {'conflicts': {'type': 'array', 'items': {'type': 'object', 'properties': {'field': {'type': 'string'}, 'values': {'type': 'array', 'items': {'type': 'string'}}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'resolution': {'type': 'string'}}, 'additionalProperties': False}, 'maxItems': 20}, 'limitations': {'type': 'array', 'items': {'type': 'string', 'maxLength': 256}, 'maxItems': 20}, 'cache_status': {'type': 'object', 'properties': {'hit': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'freshness_seconds': {'type': 'integer'}}, 'additionalProperties': False}, 'field_groups': {'type': 'object', 'description': 'Requested field groups with completion state.', 'patternProperties': {'^(identity|sec_submissions|xbrl_facts|recent_filings|website_evidence|regulatory_mentions|public_repository_signals)$': {'type': 'object', 'properties': {'items': {'type': 'array', 'items': {'type': 'object'}}, 'status': {'enum': ['complete', 'partial', 'empty', 'unavailable'], 'type': 'string'}, 'evidence_ids': {'type': 'array', 'items': {'type': 'string'}}, 'source_count': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'filing_summaries': {'type': 'array', 'items': {'type': 'object', 'properties': {'period_end': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$'}, 'filing_date': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$'}, 'filing_type': {'type': 'string'}, 'evidence_ids': {'type': 'array', 'items': {'type': 'string'}}, 'xbrl_available': {'type': 'boolean'}, 'accession_number': {'type': 'string'}}, 'additionalProperties': False}, 'maxItems': 50}, 'normalized_facts': {'type': 'object', 'description': 'Normalized XBRL facts keyed by concept.', 'additionalProperties': {'type': ['string', 'number', 'boolean']}}, 'verified_absences': {'type': 'array', 'items': {'type': 'object', 'required': ['claim', 'scope', 'sources_checked', 'confidence'], 'properties': {'claim': {'type': 'string', 'description': 'The claim that was verified absent.'}, 'scope': {'type': 'string', 'description': 'Search scope.'}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'limitations': {'type': 'string'}, 'evidence_ids': {'type': 'array', 'items': {'type': 'string'}}, 'search_window': {'type': 'string', 'description': 'Time window searched.'}, 'sources_checked': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}, 'maxItems': 20}, 'canonical_identity': {'type': 'object', 'properties': {'domain': {'type': 'string', 'format': 'hostname'}, 'ticker': {'type': 'string', 'pattern': '^[A-Z]{1,5}$'}, 'legal_name': {'type': 'string', 'maxLength': 256}, 'common_name': {'type': 'string', 'maxLength': 256}, 'resolved_identifiers': {'type': 'object', 'maxProperties': 10, 'additionalProperties': {'type': 'string'}}}, 'description': 'Canonical resolved organization identity.', 'additionalProperties': False}, 'declared_freshness': {'type': 'string', 'pattern': '^P(\\d+D)?(T(\\d+H)?(\\d+M)?(\\d+S)?)?$', 'description': 'ISO 8601 duration of freshness guarantee.'}, 'repository_signals': {'type': 'array', 'items': {'type': 'object', 'properties': {'repo': {'type': 'string'}, 'owner': {'type': 'string'}, 'stars': {'type': 'integer', 'minimum': 0}, 'platform': {'type': 'string'}, 'last_push': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?Z$'}, 'evidence_ids': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}, 'maxItems': 20}, 'resolved_identifiers': {'type': 'object', 'description': 'All resolved authoritative identifiers.', 'maxProperties': 10, 'additionalProperties': {'type': 'string'}}, 'website_observations': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'content_hash': {'type': 'string', 'pattern': '^sha256:[a-f0-9]{64}$'}, 'evidence_ids': {'type': 'array', 'items': {'type': 'string'}}, 'extracted_at': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?Z$'}}, 'additionalProperties': False}, 'maxItems': 20}, 'regulatory_references': {'type': 'array', 'items': {'type': 'object', 'properties': {'date': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$'}, 'source': {'type': 'string'}, 'description': {'type': 'string'}, 'evidence_ids': {'type': 'array', 'items': {'type': 'string'}}, 'reference_id': {'type': 'string'}}, 'additionalProperties': False}, 'maxItems': 30}, 'source_coverage_summary': {'type': 'object', 'properties': {'sec': {'type': 'boolean'}, 'website': {'type': 'boolean'}, 'regulatory': {'type': 'boolean'}, 'repositories': {'type': 'boolean'}}, 'additionalProperties': False}}, 'description': 'Company evidence extension payload.', 'additionalProperties': False}}, 'propertyNames': {'type': 'string', 'pattern': '^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?){2,}$', 'maxLength': 253, 'minLength': 5}}}}], 'title': 'Company Evidence Graph Output', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'description': 'Output schema for company_evidence_graph.v1 service. Must be a valid PCC 1.0.0 document with required net.siteborne.company-evidence.v1 extension. Governed candidate output for Service Contract 3.0.0 / PCC 2.0.0.'}}}
siteborne_extract_document_evidence_json
Extract document evidence JSON
Extract and verify structured evidence from exactly one authorized artifact, prior SITEBORNE upload, or public document URL. Use when: the source of truth is a PDF or supported image and the desired result is evidence JSON. Do not use when: a webpage alone is sufficient (use siteborne_retrieve_verified_web_context), company-wide public evidence is needed (use siteborne_build_company_evidence_graph), or an existing agent response needs evaluation (use siteborne_verify_agent_output). Parameters: provide exactly one reference mode: artifact_reference (an authorized stored artifact), upload_reference (a prior SITEBORNE upload handle, not document bytes) or document_url (a public URL, no credentials). ocr_permission must be true before image-based content is read by OCR, and OCR pages bill at the OCR tier; extraction_request.extract_tables and table_extraction_request request table extraction, and pages with tables bill at the table tier; declared_page_count and page_range are bounded by the page limit below; maximum_authorized_price only constrains payment. Behavior: open-world: a paid request may read governed artifact storage or fetch a public document URL, calls the document provider, and persists payment, audit, job and Workflow state; an unpaid request returns payment_required; a repeated identical request with the same payment is replay-protected and is not charged twice. This service is currently production-disabled and rejects execution. Economics: upto pricing: the payment challenge authorizes a maximum of $0.19 USD per job; the actual charge is measured per processed page (native-text $0.0098, OCR $0.0156, table $0.0238 per page, the highest applicable tier per page) and never exceeds the authorization. The authorization is a ceiling, not the charge. Documents are limited to 10 pages per job. Failure: schema-invalid input is rejected before any payment challenge; a document over the page limit, an unreadable or encrypted document, or an unavailable provider returns a structured MCP error. Returns: extracted document evidence, integrity/provenance findings, and PCC verification—not an uploaded file.
可访问外部资源 幂等
输入模式
{'$id': 'https://siteborne.net/schemas/services/document-evidence-input.schema.json', 'type': 'object', 'oneOf': [{'required': ['artifact_reference']}, {'required': ['upload_reference']}, {'required': ['document_url']}], 'title': 'Document Evidence JSON Input', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'examples': [{'ocr_permission': True, 'artifact_reference': {'media_type': 'application/pdf', 'page_count': 5, 'size_bytes': 2048576, 'artifact_id': 'doc/abc123/contract.pdf', 'content_hash': 'sha256:abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890', 'authorization': 'buyer_authorized'}, 'extraction_request': {'extract_tables': True, 'extract_key_values': True}, 'maximum_authorized_price': {'amount': '0.19', 'currency': 'USD'}}], 'properties': {'page_range': {'type': 'object', 'properties': {'end': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Last one-indexed page to process, inclusive and not before start.'}, 'start': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'First one-indexed page to process, inclusive.'}}, 'description': 'Optional one-indexed inclusive page range to process; both bounds are limited to pages 1 through 10.', 'additionalProperties': False}, 'document_url': {'type': 'string', 'format': 'uri', 'maxLength': 2048, 'description': 'Public document URL for reference mode 3; use exactly one reference mode and never put credentials in this URL.'}, 'language_hints': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[a-z]{2,3}(-[A-Z]{2})?$'}, 'maxItems': 5, 'description': 'Up to five BCP 47 language hints used by OCR and extraction; hints do not translate the document.'}, 'ocr_permission': {'type': 'boolean', 'default': False, 'description': 'Explicit permission to use OCR for image-based content; false prevents OCR even when text is not embedded.'}, 'upload_reference': {'type': 'object', 'required': ['upload_id', 'media_type', 'size_bytes'], 'properties': {'upload_id': {'type': 'string', 'maxLength': 512, 'description': 'Opaque SITEBORNE upload identifier, up to 512 characters, that selects the already admitted artifact.'}, 'media_type': {'enum': ['application/pdf', 'image/png', 'image/jpeg'], 'type': 'string', 'description': 'Declared parser media type: PDF, PNG, or JPEG; it must match the stored artifact.'}, 'size_bytes': {'type': 'integer', 'maximum': 10485760, 'minimum': 1, 'description': 'Declared artifact size in bytes, from 1 through 10,485,760; it is checked against stored metadata.'}, 'content_hash': {'type': 'string', 'pattern': '^sha256:[a-f0-9]{64}$', 'description': 'Optional lowercase SHA-256 integrity identifier in sha256:<64 hex> form; when supplied it must match the artifact.'}}, 'description': 'Previously issued SITEBORNE upload handle and declared file metadata for reference mode 2; it does not upload document bytes.', 'additionalProperties': False}, 'artifact_reference': {'type': 'object', 'title': 'Authorized Artifact Reference', 'examples': [{'media_type': 'application/pdf', 'page_count': 5, 'size_bytes': 2048576, 'artifact_id': 'doc/abc123/evidence.pdf', 'content_hash': 'sha256:abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890', 'authorization': 'buyer_authorized'}], 'required': ['artifact_id', 'media_type', 'size_bytes'], 'properties': {'media_type': {'enum': ['application/pdf', 'image/png', 'image/jpeg'], 'type': 'string', 'description': 'Declared MIME type of the artifact.'}, 'page_count': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Declared page count when known.'}, 'size_bytes': {'type': 'integer', 'maximum': 10485760, 'minimum': 1, 'description': 'Declared size in bytes.'}, 'artifact_id': {'type': 'string', 'maxLength': 512, 'description': 'Unique artifact identifier (e.g., R2 object key, artifact registry ID).'}, 'access_token': {'type': 'string', 'maxLength': 2048, 'description': 'Short-lived access token for private artifacts. Must not be logged.'}, 'content_hash': {'type': 'string', 'pattern': '^sha256:[a-f0-9]{64}$', 'description': 'SHA-256 content hash for integrity verification.'}, 'authorization': {'enum': ['public', 'buyer_authorized'], 'type': 'string', 'description': 'Authorization classification.'}}, 'description': 'Authorized stored-artifact descriptor for reference mode 1; use exactly one of artifact_reference, upload_reference, or document_url.', 'additionalProperties': False}, 'extraction_request': {'type': 'object', 'properties': {'buyer_schema': {'type': 'object', 'maxDepth': 5, 'description': 'Optional JSON Schema, bounded to fifty properties and depth five, used to validate buyer-shaped extracted data.', 'maxProperties': 50, 'additionalProperties': True}, 'extract_text': {'type': 'boolean', 'default': True, 'description': 'Whether normalized text extraction is requested; defaults to true.'}, 'extract_tables': {'type': 'boolean', 'default': False, 'description': 'Whether bounded table extraction is requested; defaults to false and may increase processing work.'}, 'extract_key_values': {'type': 'boolean', 'default': False, 'description': 'Whether key-value extraction is requested; defaults to false.'}}, 'description': 'Selects text, table, key-value, and buyer-schema extraction outputs; omitted switches retain their documented defaults.', 'additionalProperties': False}, 'declared_page_count': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Optional declared page count from 1 through 10; enables early scope validation but does not override the observed document.'}, 'retention_preference': {'enum': ['none', 'temporary', 'permanent'], 'type': 'string', 'default': 'temporary', 'description': 'Requested retention classâ\x80\x94none, temporary, or permanentâ\x80\x94subject to server policy; it cannot override mandatory retention limits.'}, 'maximum_authorized_price': {'type': 'object', 'title': 'Decimal Money', 'examples': [{'amount': '0.039', 'currency': 'USD'}, {'asset': 'USDC', 'amount': '0.19', 'network': 'base-mainnet', 'currency': 'USD'}], 'required': ['amount', 'currency'], 'properties': {'asset': {'type': 'string', 'pattern': '^[A-Z0-9]{3,10}$', 'description': "Payment asset identifier (e.g., 'USDC', 'ETH'). Optional for non-payment contexts."}, 'amount': {'type': 'string', 'pattern': '^(0|[1-9][0-9]*)(\\.[0-9]{1,18})?$', 'examples': ['0', '0.009', '0.012', '0.019', '0.029', '0.039', '0.049', '0.19'], 'description': "Canonical decimal string. No scientific notation, no leading zeros (except single '0'), no trailing zeros unless significant, no sign. Maximum 18 decimal places."}, 'network': {'type': 'string', 'pattern': '^[a-z0-9-]+$', 'maxLength': 64, 'description': "Payment network identifier (e.g., 'base-mainnet', 'base-sepolia'). Optional for non-payment contexts."}, 'currency': {'enum': ['USD'], 'type': 'string', 'default': 'USD', 'pattern': '^[A-Z]{3}$', 'description': 'ISO 4217 currency code.'}, 'precision': {'type': 'integer', 'default': 6, 'maximum': 18, 'minimum': 0, 'description': 'Maximum decimal places supported by the asset/network. Metadata only.'}}, 'description': 'Buyerâ\x80\x99s decimal-safe maximum authorized price; constrains the payment requirement and not retention or extraction policy.', 'additionalProperties': False}, 'table_extraction_request': {'type': 'boolean', 'default': False, 'description': 'Explicit top-level request for table extraction; false leaves tables unrequested.'}, 'minimum_verification_score': {'type': 'number', 'default': 0.7, 'maximum': 1, 'minimum': 0, 'description': 'Required PCC verification ratio from 0 through 1; raising it makes extracted-evidence acceptance stricter.'}}, 'description': 'Input schema for document_evidence_json.v1 service. Exactly one document reference mode required.', 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['result'], 'properties': {'result': {'$id': 'https://siteborne.net/schemas/services/document-evidence-output.schema.json', '$defs': {'pcc': {'type': 'object', 'title': 'Proof-Carrying Context (PCC) v1.0.0', 'required': ['pcc_version', 'job_id', 'contract', 'subject', 'claims', 'evidence', 'completeness', 'provenance', 'verification', 'receipt'], 'properties': {'claims': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/claim'}, 'uniqueItems': True}, 'job_id': {'$ref': '#/$defs/pcc/definitions/job_id'}, 'receipt': {'$ref': '#/$defs/pcc/definitions/receipt'}, 'subject': {'$ref': '#/$defs/pcc/definitions/subject'}, 'contract': {'$ref': '#/$defs/pcc/definitions/contract'}, 'evidence': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/evidence_item'}, 'uniqueItems': True}, 'extensions': {'$ref': '#/$defs/pcc/definitions/extension_container'}, 'provenance': {'$ref': '#/$defs/pcc/definitions/provenance'}, 'pcc_version': {'$ref': '#/$defs/pcc/definitions/pcc_version'}, 'completeness': {'$ref': '#/$defs/pcc/definitions/completeness'}, 'verification': {'$ref': '#/$defs/pcc/definitions/verification'}}, 'definitions': {'hash': {'type': 'string', 'pattern': '^sha256:[a-f0-9]{64}$', 'description': 'SHA-256 hash with algorithm tag'}, 'claim': {'type': 'object', 'required': ['claim_id', 'predicate', 'value', 'confidence', 'evidence_ids', 'materiality', 'verification_status'], 'properties': {'value': {'type': ['string', 'number', 'boolean', 'object', 'array', 'null']}, 'claim_id': {'$ref': '#/$defs/pcc/definitions/claim_id'}, 'predicate': {'type': 'string', 'minLength': 1}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'materiality': {'$ref': '#/$defs/pcc/definitions/materiality'}, 'evidence_ids': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/evidence_id'}}, 'verification_status': {'$ref': '#/$defs/pcc/definitions/verification_status'}}, 'additionalProperties': False}, 'job_id': {'type': 'string', 'pattern': '^job_[a-z0-9]{24}$', 'description': 'Unique job identifier'}, 'key_id': {'type': 'string', 'pattern': '^kid_[a-z0-9]{24}$', 'description': 'Key identifier'}, 'locator': {'type': 'object', 'required': ['type', 'value'], 'properties': {'type': {'$ref': '#/$defs/pcc/definitions/locator_type'}, 'value': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'receipt': {'type': 'object', 'required': ['output_hash', 'canonicalization_algorithm', 'policy_hash', 'schema_hash', 'signature_algorithm', 'signing_key_id', 'signature', 'signed_at'], 'properties': {'signature': {'type': 'string', 'pattern': '^[A-Za-z0-9_-]{86,88}$'}, 'signed_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'output_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'policy_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'schema_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'signing_key_id': {'$ref': '#/$defs/pcc/definitions/key_id'}, 'signature_algorithm': {'$ref': '#/$defs/pcc/definitions/signature_algorithm'}, 'canonicalization_algorithm': {'$ref': '#/$defs/pcc/definitions/canonicalization_algorithm'}}, 'additionalProperties': False}, 'subject': {'type': 'object', 'required': ['type', 'canonical_name'], 'properties': {'type': {'$ref': '#/$defs/pcc/definitions/subject_type'}, 'identifiers': {'type': 'object', 'additionalProperties': {'type': 'string'}}, 'canonical_name': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'claim_id': {'type': 'string', 'pattern': '^clm_[a-z0-9]{24}$', 'description': 'Claim identifier'}, 'contract': {'type': 'object', 'required': ['service_id', 'service_version', 'input_hash', 'input_schema_hash', 'output_schema_hash', 'quote_id', 'mode', 'currency', 'minimum_quality', 'freshness_seconds', 'issued_at', 'expires_at', 'idempotency_key'], 'properties': {'mode': {'$ref': '#/$defs/pcc/definitions/contract_mode'}, 'price': {'$ref': '#/$defs/pcc/definitions/decimal_string'}, 'network': {'enum': ['base', 'base-testnet'], 'type': 'string'}, 'currency': {'$ref': '#/$defs/pcc/definitions/currency'}, 'quote_id': {'$ref': '#/$defs/pcc/definitions/quote_id'}, 'issued_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'expires_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'input_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'service_id': {'$ref': '#/$defs/pcc/definitions/service_id'}, 'idempotency_key': {'$ref': '#/$defs/pcc/definitions/idempotency_key'}, 'minimum_quality': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'service_version': {'$ref': '#/$defs/pcc/definitions/service_version'}, 'freshness_seconds': {'type': 'integer', 'minimum': 1}, 'input_schema_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'output_schema_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'maximum_authorized_price': {'$ref': '#/$defs/pcc/definitions/decimal_string'}}, 'additionalProperties': False}, 'currency': {'enum': ['USD', 'USDC'], 'type': 'string', 'description': 'Permitted currencies'}, 'quote_id': {'type': 'string', 'pattern': '^qte_[a-z0-9]{24}$', 'description': 'Quote identifier'}, 'policy_id': {'type': 'string', 'pattern': '^pol_[a-z0-9]{24}$', 'description': 'Policy identifier'}, 'provenance': {'type': 'object', 'required': ['routes', 'providers', 'tools', 'models', 'software_versions', 'policy_versions', 'transformations', 'cache_provenance', 'execution_environment', 'verification_routes'], 'properties': {'tools': {'type': 'object', 'description': 'Tool name to version mapping', 'additionalProperties': {'type': 'string'}}, 'models': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'version', 'provider'], 'properties': {'name': {'type': 'string', 'minLength': 1}, 'version': {'type': 'string', 'minLength': 1}, 'provider': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}}, 'routes': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/provenance_route'}}, 'providers': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'version', 'capabilities'], 'properties': {'name': {'type': 'string', 'minLength': 1}, 'version': {'type': 'string', 'minLength': 1}, 'capabilities': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}}, 'policy_versions': {'type': 'object', 'description': 'Policy name to version mapping', 'additionalProperties': {'type': 'string'}}, 'transformations': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/transformation'}}, 'cache_provenance': {'type': 'object', 'required': ['enabled', 'hit'], 'properties': {'hit': {'type': 'boolean'}, 'enabled': {'type': 'boolean'}, 'cache_key': {'type': 'string'}, 'stored_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}}, 'additionalProperties': False}, 'software_versions': {'type': 'object', 'description': 'Component name to version mapping', 'additionalProperties': {'type': 'string'}}, 'verification_routes': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/provenance_route'}}, 'execution_environment': {'type': 'object', 'required': ['runtime', 'version', 'platform'], 'properties': {'runtime': {'type': 'string', 'minLength': 1}, 'version': {'type': 'string', 'minLength': 1}, 'platform': {'type': 'string', 'minLength': 1}, 'container_image': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'service_id': {'enum': ['company_evidence_graph.v1', 'web_context_verified.v1', 'document_evidence_json.v1', 'verify_agent_output.v1', 'company_evidence_graph.v2', 'web_context_verified.v2', 'document_evidence_json.v2', 'verify_agent_output.v2'], 'type': 'string', 'description': 'Service identifier'}, 'evidence_id': {'type': 'string', 'pattern': '^evd_[a-z0-9]{24}$', 'description': 'Evidence identifier'}, 'materiality': {'enum': ['material', 'supporting', 'contextual'], 'type': 'string', 'description': 'Claim materiality classification'}, 'pcc_version': {'type': 'string', 'const': '1.0.0', 'description': 'PCC specification version'}, 'completeness': {'type': 'object', 'required': ['requested_fields', 'populated_fields', 'supported_fields', 'score', 'missing_fields', 'unsupported_fields', 'stale_fields', 'vector'], 'properties': {'score': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'vector': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/completeness_vector_entry'}}, 'stale_fields': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}}, 'missing_fields': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}}, 'populated_fields': {'type': 'integer', 'minimum': 0}, 'requested_fields': {'type': 'integer', 'minimum': 0}, 'supported_fields': {'type': 'integer', 'minimum': 0}, 'unsupported_fields': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}}}, 'additionalProperties': False}, 'locator_type': {'enum': ['json_pointer', 'xpath', 'css_selector', 'text_quote', 'page_region', 'byte_range', 'database_record', 'artifact_pointer'], 'type': 'string', 'description': 'Evidence locator type'}, 'subject_type': {'enum': ['organization', 'person', 'document', 'webpage', 'other'], 'type': 'string', 'description': 'Subject type'}, 'verification': {'type': 'object', 'required': ['schema_valid', 'material_claims_supported', 'evidence_accessibility', 'freshness', 'completeness', 'cross_source_agreement', 'provenance_valid', 'prompt_injection_result', 'deterministic_failures', 'verifier_versions', 'policy', 'decision', 'score', 'failed_requirements'], 'properties': {'score': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'policy': {'$ref': '#/$defs/pcc/definitions/policy_id'}, 'decision': {'$ref': '#/$defs/pcc/definitions/verification_decision'}, 'freshness': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'completeness': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'schema_valid': {'type': 'boolean'}, 'provenance_valid': {'type': 'boolean'}, 'verifier_versions': {'type': 'object', 'additionalProperties': {'type': 'string'}}, 'failed_requirements': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}}, 'cross_source_agreement': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'deterministic_failures': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}}, 'evidence_accessibility': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'prompt_injection_result': {'type': 'object', 'required': ['checked', 'result'], 'properties': {'result': {'enum': ['clean', 'suspected', 'confirmed'], 'type': 'string'}, 'checked': {'type': 'boolean'}, 'details': {'type': 'string'}}, 'additionalProperties': False}, 'material_claims_supported': {'type': 'boolean'}}, 'additionalProperties': False}, 'contract_mode': {'enum': ['paid', 'benchmark', 'offline_verification'], 'type': 'string', 'description': 'Contract mode determines required fields'}, 'evidence_item': {'type': 'object', 'required': ['evidence_id', 'source_uri', 'retrieved_at', 'content_hash', 'media_type', 'locator', 'accessibility_status', 'transformation_history', 'authorization_classification', 'freshness_status'], 'properties': {'locator': {'$ref': '#/$defs/pcc/definitions/locator'}, 'media_type': {'type': 'string', 'minLength': 1}, 'source_uri': {'type': 'string', 'format': 'uri', 'minLength': 1}, 'evidence_id': {'$ref': '#/$defs/pcc/definitions/evidence_id'}, 'content_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'retrieved_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'freshness_status': {'$ref': '#/$defs/pcc/definitions/freshness_status'}, 'source_timestamp': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'accessibility_status': {'$ref': '#/$defs/pcc/definitions/accessibility_status'}, 'transformation_history': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/transformation'}}, 'authorization_classification': {'$ref': '#/$defs/pcc/definitions/authorization_classification'}}, 'additionalProperties': False}, 'decimal_string': {'type': 'string', 'pattern': '^(0|[1-9]\\d*)(\\.\\d+)?$', 'description': 'Non-negative decimal string, no scientific notation, no leading zeros except single zero'}, 'transformation': {'type': 'object', 'required': ['type', 'timestamp', 'tool_version'], 'properties': {'type': {'type': 'string', 'minLength': 1}, 'timestamp': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'parameters': {'type': 'object', 'additionalProperties': True}, 'tool_version': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'extension_value': {'type': 'object', 'description': 'Bounded JSON data payload for a single namespaced extension (PCC 1.0.1). Must be a JSON object; unbounded, executable, or policy-changing structures are out of scope for structural validation. Individual services may further narrow this shape for their own namespace via allOf composition.', 'maxProperties': 200, 'additionalProperties': True}, 'idempotency_key': {'type': 'string', 'pattern': '^idk_[a-z0-9]{24}$', 'description': 'Idempotency key'}, 'service_version': {'type': 'string', 'pattern': '^v\\d+(\\.\\d+)*$', 'description': 'Service version'}, 'freshness_status': {'enum': ['fresh', 'stale', 'unknown'], 'type': 'string', 'description': 'Evidence freshness status'}, 'provenance_route': {'type': 'object', 'required': ['type', 'provider', 'version'], 'properties': {'type': {'enum': ['cache', 'direct', 'deterministic', 'model', 'hybrid'], 'type': 'string'}, 'version': {'type': 'string', 'minLength': 1}, 'provider': {'type': 'string', 'minLength': 1}, 'model_name': {'type': 'string'}, 'parameters': {'type': 'object', 'additionalProperties': True}, 'model_version': {'type': 'string'}}, 'additionalProperties': False}, 'timestamp_rfc3339': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?Z$', 'description': 'RFC 3339 UTC timestamp with Z suffix, normalized fractional seconds'}, 'extension_container': {'type': 'object', 'description': 'Controlled extension container. Keys must use reverse-domain qualified namespaces with at least three DNS-safe labels (e.g., net.siteborne.verification.v1, com.example.custom-metrics.v1). Underscores, leading/trailing hyphens, empty labels, and uppercase are forbidden. Maximum 10 extensions. Maximum total namespace key length: 253 characters. Each value must conform to extension_value (bounded JSON data).', 'maxProperties': 10, 'propertyNames': {'type': 'string', 'pattern': '^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?){2,}$', 'maxLength': 253, 'minLength': 5}, 'patternProperties': {'^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?){2,}$': {'$ref': '#/$defs/pcc/definitions/extension_value'}}, 'additionalProperties': False}, 'signature_algorithm': {'type': 'string', 'const': 'Ed25519', 'description': 'Signature algorithm'}, 'verification_status': {'enum': ['verified', 'unsupported', 'disputed', 'pending'], 'type': 'string', 'description': 'Claim verification status'}, 'accessibility_status': {'enum': ['accessible', 'unavailable', 'restricted', 'requires_authorization'], 'type': 'string', 'description': 'Evidence accessibility status'}, 'verification_decision': {'enum': ['pass', 'conditional', 'fail', 'quarantined'], 'type': 'string', 'description': 'Verification decision'}, 'completeness_vector_entry': {'type': 'object', 'required': ['dimension', 'requested', 'populated', 'supported', 'score'], 'properties': {'score': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'dimension': {'type': 'string', 'minLength': 1}, 'populated': {'type': 'integer', 'minimum': 0}, 'requested': {'type': 'integer', 'minimum': 0}, 'supported': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, 'canonicalization_algorithm': {'type': 'string', 'const': 'RFC8785-JCS', 'description': 'Canonicalization algorithm'}, 'authorization_classification': {'enum': ['public', 'buyer_authorized', 'restricted', 'confidential'], 'type': 'string', 'description': 'Evidence authorization classification'}}, 'description': 'Normative schema for Proof-Carrying Context 1.0.0. Frozen after compatibility validation passes. Schema patch 1.0.1 (SUN-0100 correction): extension_container now structurally permits qualified extension keys via patternProperties, matching documented semantics; pcc_version (document content compatibility) is unchanged at 1.0.0. Schema minor 1.1.0 (SUN-1000 checkpoint 1M): service_id enum gains 4 new .v2 members (additive-only per packages/pcc-schema/policy/COMPATIBILITY.md section 1/section 4, which explicitly classifies new enum values as minor-compatible -- not the docs/contracts/COMPATIBILITY_POLICY.md service-contract-release taxonomy, which does not govern this file); the 4 existing .v1 members are unchanged and remain valid; pcc_version is unchanged at 1.0.0.', 'pcc_version': '1.0.0', 'additionalProperties': False}, 'money': {'type': 'object', 'title': 'Decimal Money', 'examples': [{'amount': '0.039', 'currency': 'USD'}, {'asset': 'USDC', 'amount': '0.19', 'network': 'base-mainnet', 'currency': 'USD'}], 'required': ['amount', 'currency'], 'properties': {'asset': {'type': 'string', 'pattern': '^[A-Z0-9]{3,10}$', 'description': "Payment asset identifier (e.g., 'USDC', 'ETH'). Optional for non-payment contexts."}, 'amount': {'type': 'string', 'pattern': '^(0|[1-9][0-9]*)(\\.[0-9]{1,18})?$', 'examples': ['0', '0.009', '0.012', '0.019', '0.029', '0.039', '0.049', '0.19'], 'description': "Canonical decimal string. No scientific notation, no leading zeros (except single '0'), no trailing zeros unless significant, no sign. Maximum 18 decimal places."}, 'network': {'type': 'string', 'pattern': '^[a-z0-9-]+$', 'maxLength': 64, 'description': "Payment network identifier (e.g., 'base-mainnet', 'base-sepolia'). Optional for non-payment contexts."}, 'currency': {'enum': ['USD'], 'type': 'string', 'default': 'USD', 'pattern': '^[A-Z]{3}$', 'description': 'ISO 4217 currency code.'}, 'precision': {'type': 'integer', 'default': 6, 'maximum': 18, 'minimum': 0, 'description': 'Maximum decimal places supported by the asset/network. Metadata only.'}}, 'description': 'Canonical decimal-safe money representation. No binary floating-point. Amount is a canonical decimal string.', 'additionalProperties': False}}, 'allOf': [{'$ref': '#/$defs/pcc'}, {'type': 'object', 'required': ['contract', 'extensions'], 'properties': {'contract': {'type': 'object', 'required': ['service_id', 'service_version', 'output_schema_hash'], 'properties': {'service_id': {'enum': ['document_evidence_json.v1', 'document_evidence_json.v2']}, 'service_version': {'enum': ['v1', 'v2']}, 'output_schema_hash': {'type': 'string', 'pattern': '^sha256:[a-f0-9]{64}$'}}}, 'extensions': {'type': 'object', 'required': ['net.siteborne.document-evidence.v1'], 'properties': {'net.siteborne.document-evidence.v1': {'type': 'object', 'properties': {'tables': {'type': 'array', 'items': {'type': 'object', 'properties': {'bbox': {'type': 'array', 'items': {'type': 'number'}, 'maxItems': 4, 'minItems': 4}, 'page': {'type': 'integer', 'minimum': 1}, 'rows': {'type': 'array', 'items': {'type': 'array', 'items': {'type': 'string'}}}, 'headers': {'type': 'array', 'items': {'type': 'string'}}, 'table_index': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, 'maxItems': 50}, 'truncation': {'type': 'object', 'properties': {'truncated': {'type': 'boolean'}, 'pages_omitted': {'type': 'array', 'items': {'type': 'integer'}}}, 'additionalProperties': False}, 'limitations': {'type': 'array', 'items': {'type': 'string', 'maxLength': 256}, 'maxItems': 20}, 'text_blocks': {'type': 'array', 'items': {'type': 'object', 'properties': {'bbox': {'type': 'array', 'items': {'type': 'number'}, 'maxItems': 4, 'minItems': 4}, 'page': {'type': 'integer', 'minimum': 1}, 'text': {'type': 'string'}}, 'additionalProperties': False}, 'maxItems': 100}, 'total_pages': {'type': 'integer', 'maximum': 10, 'minimum': 1}, 'page_warnings': {'type': 'array', 'items': {'type': 'object', 'properties': {'page': {'type': 'integer', 'minimum': 1}, 'warning': {'type': 'string'}, 'severity': {'enum': ['low', 'medium', 'high'], 'type': 'string'}}, 'additionalProperties': False}, 'maxItems': 50}, 'extracted_data': {'type': 'object', 'description': 'Structured extraction results.', 'additionalProperties': True}, 'ocr_confidence': {'type': 'array', 'items': {'type': 'object', 'properties': {'page': {'type': 'integer', 'minimum': 1}, 'mean_confidence': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'low_confidence_regions': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}, 'maxItems': 10}, 'processed_pages': {'type': 'integer', 'maximum': 10, 'minimum': 0}, 'retention_result': {'type': 'object', 'properties': {'stored': {'type': 'boolean'}, 'expires_at': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?Z$'}}, 'additionalProperties': False}, 'unsupported_content': {'type': 'array', 'items': {'type': 'object', 'properties': {'page': {'type': 'integer', 'minimum': 1}, 'reason': {'type': 'string'}}, 'additionalProperties': False}, 'maxItems': 20}, 'media_type_confirmed': {'type': 'string'}, 'page_classifications': {'type': 'array', 'items': {'type': 'object', 'required': ['page_number', 'classification'], 'properties': {'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'page_number': {'type': 'integer', 'minimum': 1}, 'classification': {'enum': ['native_text', 'ocr', 'table_heavy', 'image_only', 'unsupported'], 'type': 'string'}, 'extraction_method': {'enum': ['native', 'ocr', 'hybrid', 'none'], 'type': 'string'}}, 'additionalProperties': False}, 'maxItems': 10}, 'size_bytes_confirmed': {'type': 'integer', 'minimum': 1}, 'document_classification': {'enum': ['contract', 'invoice', 'report', 'form', 'letter', 'financial_statement', 'regulatory_filing', 'other'], 'type': 'string'}, 'calculated_billable_units': {'type': 'object', 'properties': {'ocr_pages': {'type': 'integer', 'minimum': 0}, 'table_pages': {'type': 'integer', 'minimum': 0}, 'total_billable': {'type': 'integer', 'minimum': 0}, 'native_text_pages': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, 'estimated_or_final_amount': {'$ref': '#/$defs/money'}}, 'description': 'Document evidence extension payload.', 'additionalProperties': False}}, 'propertyNames': {'type': 'string', 'pattern': '^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?){2,}$', 'maxLength': 253, 'minLength': 5}}}}], 'title': 'Document Evidence JSON Output', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'examples': [{'claims': [], 'job_id': 'job_aaaaaaaaaaaaaaaaaaaaaaaa', 'receipt': {'signature': 'AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA', 'signed_at': '2026-08-05T10:00:00Z', 'output_hash': 'sha256:eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee', 'policy_hash': 'sha256:ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff', 'schema_hash': 'sha256:0000000000000000000000000000000000000000000000000000000000000000', 'signing_key_id': 'kid_aaaaaaaaaaaaaaaaaaaaaaaa', 'signature_algorithm': 'Ed25519', 'canonicalization_algorithm': 'RFC8785-JCS'}, 'subject': {'type': 'organization', 'identifiers': {'domain': 'acme.example.com'}, 'canonical_name': 'Acme Example Corp'}, 'contract': {'mode': 'paid', 'currency': 'USD', 'quote_id': 'qte_aaaaaaaaaaaaaaaaaaaaaaaa', 'issued_at': '2026-08-05T10:00:00Z', 'expires_at': '2026-08-06T10:00:00Z', 'input_hash': 'sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa', 'service_id': 'document_evidence_json.v1', 'idempotency_key': 'idk_aaaaaaaaaaaaaaaaaaaaaaaa', 'minimum_quality': 0.8, 'service_version': 'v1', 'freshness_seconds': 3600, 'input_schema_hash': 'sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb', 'output_schema_hash': 'sha256:abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890'}, 'evidence': [], 'extensions': {'net.siteborne.document-evidence.v1': {'limitations': ['tables on page 2 may need review'], 'total_pages': 5, 'processed_pages': 5, 'media_type_confirmed': 'application/pdf', 'page_classifications': [{'page_number': 1, 'classification': 'native_text', 'extraction_method': 'native'}, {'page_number': 2, 'classification': 'table_heavy', 'extraction_method': 'native'}, {'page_number': 3, 'classification': 'native_text', 'extraction_method': 'native'}], 'size_bytes_confirmed': 2048576, 'document_classification': 'contract', 'calculated_billable_units': {'table_pages': 1, 'total_billable': 3, 'native_text_pages': 2}}}, 'provenance': {'tools': {'curl': '8.0.0'}, 'models': [], 'routes': [{'type': 'direct', 'version': '1.0.0', 'provider': 'web'}], 'providers': [{'name': 'web', 'version': '1.0.0', 'capabilities': ['fetch']}], 'policy_versions': {'verification': '1.0.0'}, 'transformations': [], 'cache_provenance': {'hit': False, 'enabled': False}, 'software_versions': {'pcc': '1.0.0'}, 'verification_routes': [], 'execution_environment': {'runtime': 'node', 'version': '22.0.0', 'platform': 'linux'}}, 'pcc_version': '1.0.0', 'completeness': {'score': 0.8, 'vector': [{'score': 0.8, 'dimension': 'general', 'populated': 4, 'requested': 5, 'supported': 4}], 'stale_fields': [], 'missing_fields': ['ceo_name'], 'populated_fields': 4, 'requested_fields': 5, 'supported_fields': 4, 'unsupported_fields': []}, 'verification': {'score': 0.9, 'policy': 'pol_aaaaaaaaaaaaaaaaaaaaaaaa', 'decision': 'pass', 'freshness': 1, 'completeness': 0.8, 'schema_valid': True, 'provenance_valid': True, 'verifier_versions': {'pcc': '1.0.0'}, 'failed_requirements': [], 'cross_source_agreement': 1, 'deterministic_failures': [], 'evidence_accessibility': 1, 'prompt_injection_result': {'result': 'clean', 'checked': True}, 'material_claims_supported': True}}], 'description': 'Output schema for document_evidence_json.v1 service. Must be a valid PCC 1.0.0 document with required net.siteborne.document-evidence.v1 extension.'}}}
siteborne_extract_document_evidence_json_v3_candidate
Extract document evidence JSON (v3 candidate)
Extract and verify structured evidence from exactly one authorized artifact, prior SITEBORNE upload, or public document URL. Use when: the source of truth is a PDF or supported image and the desired result is evidence JSON. Do not use when: a webpage alone is sufficient (use siteborne_retrieve_verified_web_context), company-wide public evidence is needed (use siteborne_build_company_evidence_graph), or an existing agent response needs evaluation (use siteborne_verify_agent_output). Parameters: provide exactly one reference mode: artifact_reference (an authorized stored artifact), upload_reference (a prior SITEBORNE upload handle, not document bytes) or document_url (a public URL, no credentials). ocr_permission must be true before image-based content is read by OCR, and OCR pages bill at the OCR tier; extraction_request.extract_tables and table_extraction_request request table extraction, and pages with tables bill at the table tier; declared_page_count and page_range are bounded by the page limit below; maximum_authorized_price only constrains payment. Behavior: open-world: a paid request may read governed artifact storage or fetch a public document URL, calls the document provider, and persists payment, audit, job and Workflow state; an unpaid request returns payment_required; a repeated identical request with the same payment is replay-protected and is not charged twice. This service is currently production-disabled and rejects execution. Economics: upto pricing: the payment challenge authorizes a maximum of $0.19 USD per job; the actual charge is measured per processed page (native-text $0.0098, OCR $0.0156, table $0.0238 per page, the highest applicable tier per page) and never exceeds the authorization. The authorization is a ceiling, not the charge. Documents are limited to 10 pages per job. Failure: schema-invalid input is rejected before any payment challenge; a document over the page limit, an unreadable or encrypted document, or an unavailable provider returns a structured MCP error. Returns: extracted document evidence, integrity/provenance findings, and PCC verification—not an uploaded file.
可访问外部资源 幂等
输入模式
{'$id': 'https://siteborne.net/schemas/services/document-evidence-input.schema.json', 'type': 'object', 'oneOf': [{'required': ['artifact_reference']}, {'required': ['upload_reference']}, {'required': ['document_url']}], 'title': 'Document Evidence JSON Input', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'examples': [{'ocr_permission': True, 'artifact_reference': {'media_type': 'application/pdf', 'page_count': 5, 'size_bytes': 2048576, 'artifact_id': 'doc/abc123/contract.pdf', 'content_hash': 'sha256:abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890', 'authorization': 'buyer_authorized'}, 'extraction_request': {'extract_tables': True, 'extract_key_values': True}, 'maximum_authorized_price': {'amount': '0.19', 'currency': 'USD'}}], 'properties': {'page_range': {'type': 'object', 'properties': {'end': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Last one-indexed page to process, inclusive and not before start.'}, 'start': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'First one-indexed page to process, inclusive.'}}, 'description': 'Optional one-indexed inclusive page range to process; both bounds are limited to pages 1 through 10.', 'additionalProperties': False}, 'document_url': {'type': 'string', 'format': 'uri', 'maxLength': 2048, 'description': 'Public document URL for reference mode 3; use exactly one reference mode and never put credentials in this URL.'}, 'language_hints': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[a-z]{2,3}(-[A-Z]{2})?$'}, 'maxItems': 5, 'description': 'Up to five BCP 47 language hints used by OCR and extraction; hints do not translate the document.'}, 'ocr_permission': {'type': 'boolean', 'default': False, 'description': 'Explicit permission to use OCR for image-based content; false prevents OCR even when text is not embedded.'}, 'upload_reference': {'type': 'object', 'required': ['upload_id', 'media_type', 'size_bytes'], 'properties': {'upload_id': {'type': 'string', 'maxLength': 512, 'description': 'Opaque SITEBORNE upload identifier, up to 512 characters, that selects the already admitted artifact.'}, 'media_type': {'enum': ['application/pdf', 'image/png', 'image/jpeg'], 'type': 'string', 'description': 'Declared parser media type: PDF, PNG, or JPEG; it must match the stored artifact.'}, 'size_bytes': {'type': 'integer', 'maximum': 10485760, 'minimum': 1, 'description': 'Declared artifact size in bytes, from 1 through 10,485,760; it is checked against stored metadata.'}, 'content_hash': {'type': 'string', 'pattern': '^sha256:[a-f0-9]{64}$', 'description': 'Optional lowercase SHA-256 integrity identifier in sha256:<64 hex> form; when supplied it must match the artifact.'}}, 'description': 'Previously issued SITEBORNE upload handle and declared file metadata for reference mode 2; it does not upload document bytes.', 'additionalProperties': False}, 'artifact_reference': {'type': 'object', 'title': 'Authorized Artifact Reference', 'examples': [{'media_type': 'application/pdf', 'page_count': 5, 'size_bytes': 2048576, 'artifact_id': 'doc/abc123/evidence.pdf', 'content_hash': 'sha256:abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890', 'authorization': 'buyer_authorized'}], 'required': ['artifact_id', 'media_type', 'size_bytes'], 'properties': {'media_type': {'enum': ['application/pdf', 'image/png', 'image/jpeg'], 'type': 'string', 'description': 'Declared MIME type of the artifact.'}, 'page_count': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Declared page count when known.'}, 'size_bytes': {'type': 'integer', 'maximum': 10485760, 'minimum': 1, 'description': 'Declared size in bytes.'}, 'artifact_id': {'type': 'string', 'maxLength': 512, 'description': 'Unique artifact identifier (e.g., R2 object key, artifact registry ID).'}, 'access_token': {'type': 'string', 'maxLength': 2048, 'description': 'Short-lived access token for private artifacts. Must not be logged.'}, 'content_hash': {'type': 'string', 'pattern': '^sha256:[a-f0-9]{64}$', 'description': 'SHA-256 content hash for integrity verification.'}, 'authorization': {'enum': ['public', 'buyer_authorized'], 'type': 'string', 'description': 'Authorization classification.'}}, 'description': 'Authorized stored-artifact descriptor for reference mode 1; use exactly one of artifact_reference, upload_reference, or document_url.', 'additionalProperties': False}, 'extraction_request': {'type': 'object', 'properties': {'buyer_schema': {'type': 'object', 'maxDepth': 5, 'description': 'Optional JSON Schema, bounded to fifty properties and depth five, used to validate buyer-shaped extracted data.', 'maxProperties': 50, 'additionalProperties': True}, 'extract_text': {'type': 'boolean', 'default': True, 'description': 'Whether normalized text extraction is requested; defaults to true.'}, 'extract_tables': {'type': 'boolean', 'default': False, 'description': 'Whether bounded table extraction is requested; defaults to false and may increase processing work.'}, 'extract_key_values': {'type': 'boolean', 'default': False, 'description': 'Whether key-value extraction is requested; defaults to false.'}}, 'description': 'Selects text, table, key-value, and buyer-schema extraction outputs; omitted switches retain their documented defaults.', 'additionalProperties': False}, 'declared_page_count': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Optional declared page count from 1 through 10; enables early scope validation but does not override the observed document.'}, 'retention_preference': {'enum': ['none', 'temporary', 'permanent'], 'type': 'string', 'default': 'temporary', 'description': 'Requested retention classâ\x80\x94none, temporary, or permanentâ\x80\x94subject to server policy; it cannot override mandatory retention limits.'}, 'maximum_authorized_price': {'type': 'object', 'title': 'Decimal Money', 'examples': [{'amount': '0.039', 'currency': 'USD'}, {'asset': 'USDC', 'amount': '0.19', 'network': 'base-mainnet', 'currency': 'USD'}], 'required': ['amount', 'currency'], 'properties': {'asset': {'type': 'string', 'pattern': '^[A-Z0-9]{3,10}$', 'description': "Payment asset identifier (e.g., 'USDC', 'ETH'). Optional for non-payment contexts."}, 'amount': {'type': 'string', 'pattern': '^(0|[1-9][0-9]*)(\\.[0-9]{1,18})?$', 'examples': ['0', '0.009', '0.012', '0.019', '0.029', '0.039', '0.049', '0.19'], 'description': "Canonical decimal string. No scientific notation, no leading zeros (except single '0'), no trailing zeros unless significant, no sign. Maximum 18 decimal places."}, 'network': {'type': 'string', 'pattern': '^[a-z0-9-]+$', 'maxLength': 64, 'description': "Payment network identifier (e.g., 'base-mainnet', 'base-sepolia'). Optional for non-payment contexts."}, 'currency': {'enum': ['USD'], 'type': 'string', 'default': 'USD', 'pattern': '^[A-Z]{3}$', 'description': 'ISO 4217 currency code.'}, 'precision': {'type': 'integer', 'default': 6, 'maximum': 18, 'minimum': 0, 'description': 'Maximum decimal places supported by the asset/network. Metadata only.'}}, 'description': 'Buyerâ\x80\x99s decimal-safe maximum authorized price; constrains the payment requirement and not retention or extraction policy.', 'additionalProperties': False}, 'table_extraction_request': {'type': 'boolean', 'default': False, 'description': 'Explicit top-level request for table extraction; false leaves tables unrequested.'}, 'minimum_verification_score': {'type': 'number', 'default': 0.7, 'maximum': 1, 'minimum': 0, 'description': 'Required PCC verification ratio from 0 through 1; raising it makes extracted-evidence acceptance stricter.'}}, 'description': 'Input schema for document_evidence_json.v1 service. Exactly one document reference mode required.', 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['result'], 'properties': {'result': {'$id': 'https://utility.siteborne.net/contracts/3.0.0/schemas/services/document-evidence-output.schema.json', '$defs': {'pcc': {'type': 'object', 'title': 'Proof-Carrying Context (PCC) v2.0.0', 'required': ['pcc_version', 'job_id', 'contract', 'subject', 'claims', 'evidence', 'completeness', 'provenance', 'verification', 'receipt'], 'properties': {'claims': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/claim'}, 'uniqueItems': True}, 'job_id': {'$ref': '#/$defs/pcc/definitions/job_id'}, 'receipt': {'$ref': '#/$defs/pcc/definitions/receipt'}, 'subject': {'$ref': '#/$defs/pcc/definitions/subject'}, 'contract': {'$ref': '#/$defs/pcc/definitions/contract'}, 'evidence': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/evidence_item'}, 'uniqueItems': True}, 'extensions': {'allOf': [{'$ref': '#/$defs/pcc/definitions/extension_container'}, {'type': 'object', 'required': ['net.siteborne.verification-proof.v1'], 'properties': {'net.siteborne.verification-proof.v1': {'$ref': '#/$defs/pcc/definitions/verification_proof_v1'}}}]}, 'provenance': {'$ref': '#/$defs/pcc/definitions/provenance'}, 'pcc_version': {'$ref': '#/$defs/pcc/definitions/pcc_version'}, 'completeness': {'$ref': '#/$defs/pcc/definitions/completeness'}, 'verification': {'$ref': '#/$defs/pcc/definitions/verification'}}, 'definitions': {'hash': {'type': 'string', 'pattern': '^sha256:[a-f0-9]{64}$', 'description': 'SHA-256 hash with algorithm tag'}, 'claim': {'type': 'object', 'required': ['claim_id', 'predicate', 'value', 'confidence', 'evidence_ids', 'materiality', 'verification_status'], 'properties': {'value': {'type': ['string', 'number', 'boolean', 'object', 'array', 'null']}, 'claim_id': {'$ref': '#/$defs/pcc/definitions/claim_id'}, 'predicate': {'type': 'string', 'minLength': 1}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'materiality': {'$ref': '#/$defs/pcc/definitions/materiality'}, 'evidence_ids': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/evidence_id'}}, 'verification_status': {'$ref': '#/$defs/pcc/definitions/verification_status'}}, 'additionalProperties': False}, 'job_id': {'type': 'string', 'pattern': '^job_[a-z0-9]{24}$', 'description': 'Unique job identifier'}, 'key_id': {'type': 'string', 'pattern': '^kid_[a-z0-9]{24}$', 'description': 'Key identifier'}, 'locator': {'type': 'object', 'required': ['type', 'value'], 'properties': {'type': {'$ref': '#/$defs/pcc/definitions/locator_type'}, 'value': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'receipt': {'type': 'object', 'required': ['output_hash', 'canonicalization_algorithm', 'policy_hash', 'schema_hash', 'signature_algorithm', 'signing_key_id', 'signature', 'signed_at'], 'properties': {'signature': {'type': 'string', 'pattern': '^[A-Za-z0-9_-]{86,88}$'}, 'signed_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'output_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'policy_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'schema_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'signing_key_id': {'$ref': '#/$defs/pcc/definitions/key_id'}, 'signature_algorithm': {'$ref': '#/$defs/pcc/definitions/signature_algorithm'}, 'canonicalization_algorithm': {'$ref': '#/$defs/pcc/definitions/canonicalization_algorithm'}}, 'additionalProperties': False}, 'subject': {'type': 'object', 'required': ['type', 'canonical_name'], 'properties': {'type': {'$ref': '#/$defs/pcc/definitions/subject_type'}, 'identifiers': {'type': 'object', 'additionalProperties': {'type': 'string'}}, 'canonical_name': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'claim_id': {'type': 'string', 'pattern': '^clm_[a-z0-9]{24}$', 'description': 'Claim identifier'}, 'contract': {'type': 'object', 'required': ['service_id', 'service_version', 'input_hash', 'input_schema_hash', 'output_schema_hash', 'quote_id', 'mode', 'currency', 'minimum_quality', 'freshness_seconds', 'issued_at', 'expires_at', 'idempotency_key'], 'properties': {'mode': {'$ref': '#/$defs/pcc/definitions/contract_mode'}, 'price': {'$ref': '#/$defs/pcc/definitions/decimal_string'}, 'network': {'enum': ['base', 'base-testnet'], 'type': 'string'}, 'currency': {'$ref': '#/$defs/pcc/definitions/currency'}, 'quote_id': {'$ref': '#/$defs/pcc/definitions/quote_id'}, 'issued_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'expires_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'input_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'service_id': {'$ref': '#/$defs/pcc/definitions/service_id'}, 'idempotency_key': {'$ref': '#/$defs/pcc/definitions/idempotency_key'}, 'minimum_quality': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'service_version': {'$ref': '#/$defs/pcc/definitions/service_version'}, 'freshness_seconds': {'type': 'integer', 'minimum': 1}, 'input_schema_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'output_schema_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'maximum_authorized_price': {'$ref': '#/$defs/pcc/definitions/decimal_string'}}, 'additionalProperties': False}, 'currency': {'enum': ['USD', 'USDC'], 'type': 'string', 'description': 'Permitted currencies'}, 'quote_id': {'type': 'string', 'pattern': '^qte_[a-z0-9]{24}$', 'description': 'Quote identifier'}, 'policy_id': {'type': 'string', 'pattern': '^pol_[a-z0-9]{24}$', 'description': 'Policy identifier'}, 'provenance': {'type': 'object', 'required': ['routes', 'providers', 'tools', 'models', 'software_versions', 'policy_versions', 'transformations', 'cache_provenance', 'execution_environment', 'verification_routes'], 'properties': {'tools': {'type': 'object', 'description': 'Tool name to version mapping', 'additionalProperties': {'type': 'string'}}, 'models': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'version', 'provider'], 'properties': {'name': {'type': 'string', 'minLength': 1}, 'version': {'type': 'string', 'minLength': 1}, 'provider': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}}, 'routes': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/provenance_route'}}, 'providers': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'version', 'capabilities'], 'properties': {'name': {'type': 'string', 'minLength': 1}, 'version': {'type': 'string', 'minLength': 1}, 'capabilities': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}}, 'policy_versions': {'type': 'object', 'description': 'Policy name to version mapping', 'additionalProperties': {'type': 'string'}}, 'transformations': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/transformation'}}, 'cache_provenance': {'type': 'object', 'required': ['enabled', 'hit'], 'properties': {'hit': {'type': 'boolean'}, 'enabled': {'type': 'boolean'}, 'cache_key': {'type': 'string'}, 'stored_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}}, 'additionalProperties': False}, 'software_versions': {'type': 'object', 'description': 'Component name to version mapping', 'additionalProperties': {'type': 'string'}}, 'verification_routes': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/provenance_route'}}, 'execution_environment': {'type': 'object', 'required': ['runtime', 'version', 'platform'], 'properties': {'runtime': {'type': 'string', 'minLength': 1}, 'version': {'type': 'string', 'minLength': 1}, 'platform': {'type': 'string', 'minLength': 1}, 'container_image': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'service_id': {'enum': ['company_evidence_graph.v1', 'web_context_verified.v1', 'document_evidence_json.v1', 'verify_agent_output.v1', 'company_evidence_graph.v2', 'web_context_verified.v2', 'document_evidence_json.v2', 'verify_agent_output.v2', 'company_evidence_graph.v3', 'web_context_verified.v3', 'document_evidence_json.v3', 'verify_agent_output.v3'], 'type': 'string', 'description': 'Service identifier'}, 'evidence_id': {'type': 'string', 'pattern': '^evd_[a-z0-9]{24}$', 'description': 'Evidence identifier'}, 'materiality': {'enum': ['material', 'supporting', 'contextual'], 'type': 'string', 'description': 'Claim materiality classification'}, 'pcc_version': {'type': 'string', 'const': '2.0.0', 'description': 'PCC specification version'}, 'completeness': {'type': 'object', 'required': ['requested_fields', 'populated_fields', 'supported_fields', 'score', 'missing_fields', 'unsupported_fields', 'stale_fields', 'vector'], 'properties': {'score': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'vector': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/completeness_vector_entry'}}, 'stale_fields': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}}, 'missing_fields': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}}, 'populated_fields': {'type': 'integer', 'minimum': 0}, 'requested_fields': {'type': 'integer', 'minimum': 0}, 'supported_fields': {'type': 'integer', 'minimum': 0}, 'unsupported_fields': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}}}, 'additionalProperties': False}, 'locator_type': {'enum': ['json_pointer', 'xpath', 'css_selector', 'text_quote', 'page_region', 'byte_range', 'database_record', 'artifact_pointer'], 'type': 'string', 'description': 'Evidence locator type'}, 'subject_type': {'enum': ['organization', 'person', 'document', 'webpage', 'other'], 'type': 'string', 'description': 'Subject type'}, 'verification': {'type': 'object', 'required': ['schema_valid', 'material_claims_supported', 'evidence_accessibility', 'freshness', 'completeness', 'cross_source_agreement', 'provenance_valid', 'prompt_injection_result', 'deterministic_failures', 'verifier_versions', 'policy', 'decision', 'score', 'failed_requirements'], 'properties': {'score': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'policy': {'$ref': '#/$defs/pcc/definitions/policy_id'}, 'decision': {'$ref': '#/$defs/pcc/definitions/verification_decision'}, 'freshness': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'completeness': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'schema_valid': {'type': 'boolean'}, 'provenance_valid': {'type': 'boolean'}, 'verifier_versions': {'type': 'object', 'additionalProperties': {'type': 'string'}}, 'failed_requirements': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}}, 'cross_source_agreement': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'deterministic_failures': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}}, 'evidence_accessibility': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'prompt_injection_result': {'type': 'object', 'required': ['checked', 'result'], 'properties': {'result': {'enum': ['clean', 'suspected', 'confirmed'], 'type': 'string'}, 'checked': {'type': 'boolean'}, 'details': {'type': 'string'}}, 'additionalProperties': False}, 'material_claims_supported': {'type': 'boolean'}}, 'additionalProperties': False}, 'contract_mode': {'enum': ['paid', 'benchmark', 'offline_verification'], 'type': 'string', 'description': 'Contract mode determines required fields'}, 'evidence_item': {'type': 'object', 'required': ['evidence_id', 'source_uri', 'retrieved_at', 'content_hash', 'media_type', 'locator', 'accessibility_status', 'transformation_history', 'authorization_classification', 'freshness_status'], 'properties': {'locator': {'$ref': '#/$defs/pcc/definitions/locator'}, 'media_type': {'type': 'string', 'minLength': 1}, 'source_uri': {'type': 'string', 'format': 'uri', 'minLength': 1}, 'evidence_id': {'$ref': '#/$defs/pcc/definitions/evidence_id'}, 'content_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'retrieved_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'freshness_status': {'$ref': '#/$defs/pcc/definitions/freshness_status'}, 'source_timestamp': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'accessibility_status': {'$ref': '#/$defs/pcc/definitions/accessibility_status'}, 'transformation_history': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/transformation'}}, 'authorization_classification': {'$ref': '#/$defs/pcc/definitions/authorization_classification'}}, 'additionalProperties': False}, 'vnext_receipt': {'type': 'object', 'required': ['domain', 'proof_version', 'receipt_version', 'job_id', 'request_id', 'service_id', 'service_version', 'contract_release', 'pcc_schema_release', 'pcc_schema_hash', 'input_hash', 'output_schema_hash', 'output_hash', 'pcc_document_hash', 'evidence_hash', 'policy_hash', 'verifier_set_hash', 'decision', 'completeness', 'verification_mode', 'limitations', 'signing_key_id', 'canonicalization_algorithm', 'signature_algorithm', 'issued_at', 'receipt_id', 'signature'], 'properties': {'domain': {'type': 'string', 'const': 'SITEBORNE-PCC-VERIFICATION-PROOF-V1'}, 'job_id': {'$ref': '#/$defs/pcc/definitions/job_id'}, 'decision': {'$ref': '#/$defs/pcc/definitions/verification_decision'}, 'issued_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'signature': {'type': 'string', 'pattern': '^[A-Za-z0-9_-]{86}$'}, 'input_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'receipt_id': {'type': 'string', 'pattern': '^rcpt_[a-f0-9]{24}$'}, 'request_id': {'type': 'string', 'minLength': 1}, 'service_id': {'$ref': '#/$defs/pcc/definitions/service_id'}, 'limitations': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'maxItems': 200}, 'output_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'policy_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'completeness': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'evidence_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'proof_version': {'type': 'string', 'const': '1.0.0'}, 'signing_key_id': {'type': 'string', 'minLength': 1}, 'pcc_schema_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'receipt_version': {'type': 'string', 'const': '2.0.0'}, 'service_version': {'$ref': '#/$defs/pcc/definitions/service_version'}, 'contract_release': {'type': 'string', 'const': '3.0.0'}, 'pcc_document_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'verification_mode': {'enum': ['standard', 'independent_reproduction'], 'type': 'string'}, 'verifier_set_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'output_schema_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'pcc_schema_release': {'type': 'string', 'const': '2.0.0'}, 'signature_algorithm': {'type': 'string', 'const': 'Ed25519'}, 'canonicalization_algorithm': {'type': 'string', 'const': 'RFC8785-JCS'}}, 'additionalProperties': False}, 'decimal_string': {'type': 'string', 'pattern': '^(0|[1-9]\\d*)(\\.\\d+)?$', 'description': 'Non-negative decimal string, no scientific notation, no leading zeros except single zero'}, 'transformation': {'type': 'object', 'required': ['type', 'timestamp', 'tool_version'], 'properties': {'type': {'type': 'string', 'minLength': 1}, 'timestamp': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'parameters': {'type': 'object', 'additionalProperties': True}, 'tool_version': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'extension_value': {'type': 'object', 'description': 'Bounded JSON data payload for a single namespaced extension (PCC 1.0.1). Must be a JSON object; unbounded, executable, or policy-changing structures are out of scope for structural validation. Individual services may further narrow this shape for their own namespace via allOf composition.', 'maxProperties': 200, 'additionalProperties': True}, 'idempotency_key': {'type': 'string', 'pattern': '^idk_[a-z0-9]{24}$', 'description': 'Idempotency key'}, 'service_version': {'type': 'string', 'pattern': '^v\\d+(\\.\\d+)*$', 'description': 'Service version'}, 'freshness_status': {'enum': ['fresh', 'stale', 'unknown'], 'type': 'string', 'description': 'Evidence freshness status'}, 'provenance_route': {'type': 'object', 'required': ['type', 'provider', 'version'], 'properties': {'type': {'enum': ['cache', 'direct', 'deterministic', 'model', 'hybrid'], 'type': 'string'}, 'version': {'type': 'string', 'minLength': 1}, 'provider': {'type': 'string', 'minLength': 1}, 'model_name': {'type': 'string'}, 'parameters': {'type': 'object', 'additionalProperties': True}, 'model_version': {'type': 'string'}}, 'additionalProperties': False}, 'timestamp_rfc3339': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?Z$', 'description': 'RFC 3339 UTC timestamp with Z suffix, normalized fractional seconds'}, 'extension_container': {'type': 'object', 'description': 'Controlled extension container. Keys must use reverse-domain qualified namespaces with at least three DNS-safe labels (e.g., net.siteborne.verification.v1, com.example.custom-metrics.v1). Underscores, leading/trailing hyphens, empty labels, and uppercase are forbidden. Maximum 10 extensions. Maximum total namespace key length: 253 characters. Each value must conform to extension_value (bounded JSON data).', 'maxProperties': 10, 'propertyNames': {'type': 'string', 'pattern': '^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?){2,}$', 'maxLength': 253, 'minLength': 5}, 'patternProperties': {'^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?){2,}$': {'$ref': '#/$defs/pcc/definitions/extension_value'}}, 'additionalProperties': False}, 'signature_algorithm': {'type': 'string', 'const': 'Ed25519', 'description': 'Signature algorithm'}, 'verification_status': {'enum': ['verified', 'unsupported', 'disputed', 'pending'], 'type': 'string', 'description': 'Claim verification status'}, 'accessibility_status': {'enum': ['accessible', 'unavailable', 'restricted', 'requires_authorization'], 'type': 'string', 'description': 'Evidence accessibility status'}, 'verification_decision': {'enum': ['pass', 'conditional', 'fail', 'quarantined'], 'type': 'string', 'description': 'Verification decision'}, 'verification_proof_v1': {'type': 'object', 'required': ['proof_version', 'receipt', 'verification_material'], 'properties': {'receipt': {'$ref': '#/$defs/pcc/definitions/vnext_receipt'}, 'proof_version': {'type': 'string', 'const': '1.0.0'}, 'verification_material': {'type': 'object', 'required': ['verifier_results'], 'properties': {'verifier_results': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/public_verifier_result'}, 'maxItems': 100}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'public_verifier_result': {'type': 'object', 'required': ['verifier_id', 'status', 'findings', 'failure_codes'], 'properties': {'status': {'type': 'string', 'minLength': 1}, 'findings': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'severity'], 'properties': {'code': {'type': 'string', 'minLength': 1}, 'severity': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'maxItems': 200}, 'verifier_id': {'type': 'string', 'minLength': 1}, 'failure_codes': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'maxItems': 200}}, 'additionalProperties': False}, 'vnext_receipt_preimage': {'type': 'object', 'required': ['domain', 'proof_version', 'receipt_version', 'job_id', 'request_id', 'service_id', 'service_version', 'contract_release', 'pcc_schema_release', 'pcc_schema_hash', 'input_hash', 'output_schema_hash', 'output_hash', 'pcc_document_hash', 'evidence_hash', 'policy_hash', 'verifier_set_hash', 'decision', 'completeness', 'verification_mode', 'limitations', 'signing_key_id', 'canonicalization_algorithm', 'signature_algorithm', 'issued_at'], 'properties': {'domain': {'type': 'string', 'const': 'SITEBORNE-PCC-VERIFICATION-PROOF-V1'}, 'job_id': {'$ref': '#/$defs/pcc/definitions/job_id'}, 'decision': {'$ref': '#/$defs/pcc/definitions/verification_decision'}, 'issued_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'input_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'request_id': {'type': 'string', 'minLength': 1}, 'service_id': {'$ref': '#/$defs/pcc/definitions/service_id'}, 'limitations': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'maxItems': 200}, 'output_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'policy_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'completeness': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'evidence_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'proof_version': {'type': 'string', 'const': '1.0.0'}, 'signing_key_id': {'type': 'string', 'minLength': 1}, 'pcc_schema_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'receipt_version': {'type': 'string', 'const': '2.0.0'}, 'service_version': {'$ref': '#/$defs/pcc/definitions/service_version'}, 'contract_release': {'type': 'string', 'const': '3.0.0'}, 'pcc_document_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'verification_mode': {'enum': ['standard', 'independent_reproduction'], 'type': 'string'}, 'verifier_set_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'output_schema_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'pcc_schema_release': {'type': 'string', 'const': '2.0.0'}, 'signature_algorithm': {'type': 'string', 'const': 'Ed25519'}, 'canonicalization_algorithm': {'type': 'string', 'const': 'RFC8785-JCS'}}, 'additionalProperties': False}, 'completeness_vector_entry': {'type': 'object', 'required': ['dimension', 'requested', 'populated', 'supported', 'score'], 'properties': {'score': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'dimension': {'type': 'string', 'minLength': 1}, 'populated': {'type': 'integer', 'minimum': 0}, 'requested': {'type': 'integer', 'minimum': 0}, 'supported': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, 'canonicalization_algorithm': {'type': 'string', 'const': 'RFC8785-JCS', 'description': 'Canonicalization algorithm'}, 'authorization_classification': {'enum': ['public', 'buyer_authorized', 'restricted', 'confidential'], 'type': 'string', 'description': 'Evidence authorization classification'}}, 'description': 'Normative PCC 2.0.0 candidate. Requires a governed, reconstructible self-verifying receipt proof at extensions["net.siteborne.verification-proof.v1"]. The full PCC is the successful result root.', 'pcc_version': '2.0.0', 'additionalProperties': False}, 'money': {'type': 'object', 'title': 'Decimal Money', 'examples': [{'amount': '0.039', 'currency': 'USD'}, {'asset': 'USDC', 'amount': '0.19', 'network': 'base-mainnet', 'currency': 'USD'}], 'required': ['amount', 'currency'], 'properties': {'asset': {'type': 'string', 'pattern': '^[A-Z0-9]{3,10}$', 'description': "Payment asset identifier (e.g., 'USDC', 'ETH'). Optional for non-payment contexts."}, 'amount': {'type': 'string', 'pattern': '^(0|[1-9][0-9]*)(\\.[0-9]{1,18})?$', 'examples': ['0', '0.009', '0.012', '0.019', '0.029', '0.039', '0.049', '0.19'], 'description': "Canonical decimal string. No scientific notation, no leading zeros (except single '0'), no trailing zeros unless significant, no sign. Maximum 18 decimal places."}, 'network': {'type': 'string', 'pattern': '^[a-z0-9-]+$', 'maxLength': 64, 'description': "Payment network identifier (e.g., 'base-mainnet', 'base-sepolia'). Optional for non-payment contexts."}, 'currency': {'enum': ['USD'], 'type': 'string', 'default': 'USD', 'pattern': '^[A-Z]{3}$', 'description': 'ISO 4217 currency code.'}, 'precision': {'type': 'integer', 'default': 6, 'maximum': 18, 'minimum': 0, 'description': 'Maximum decimal places supported by the asset/network. Metadata only.'}}, 'description': 'Canonical decimal-safe money representation. No binary floating-point. Amount is a canonical decimal string.', 'additionalProperties': False}}, 'allOf': [{'$ref': '#/$defs/pcc'}, {'type': 'object', 'required': ['contract', 'extensions'], 'properties': {'contract': {'type': 'object', 'required': ['service_id', 'service_version', 'output_schema_hash'], 'properties': {'service_id': {'enum': ['document_evidence_json.v3']}, 'service_version': {'enum': ['v3']}, 'output_schema_hash': {'type': 'string', 'pattern': '^sha256:[a-f0-9]{64}$'}}}, 'extensions': {'type': 'object', 'required': ['net.siteborne.document-evidence.v1'], 'properties': {'net.siteborne.document-evidence.v1': {'type': 'object', 'properties': {'tables': {'type': 'array', 'items': {'type': 'object', 'properties': {'bbox': {'type': 'array', 'items': {'type': 'number'}, 'maxItems': 4, 'minItems': 4}, 'page': {'type': 'integer', 'minimum': 1}, 'rows': {'type': 'array', 'items': {'type': 'array', 'items': {'type': 'string'}}}, 'headers': {'type': 'array', 'items': {'type': 'string'}}, 'table_index': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, 'maxItems': 50}, 'truncation': {'type': 'object', 'properties': {'truncated': {'type': 'boolean'}, 'pages_omitted': {'type': 'array', 'items': {'type': 'integer'}}}, 'additionalProperties': False}, 'limitations': {'type': 'array', 'items': {'type': 'string', 'maxLength': 256}, 'maxItems': 20}, 'text_blocks': {'type': 'array', 'items': {'type': 'object', 'properties': {'bbox': {'type': 'array', 'items': {'type': 'number'}, 'maxItems': 4, 'minItems': 4}, 'page': {'type': 'integer', 'minimum': 1}, 'text': {'type': 'string'}}, 'additionalProperties': False}, 'maxItems': 100}, 'total_pages': {'type': 'integer', 'maximum': 10, 'minimum': 1}, 'page_warnings': {'type': 'array', 'items': {'type': 'object', 'properties': {'page': {'type': 'integer', 'minimum': 1}, 'warning': {'type': 'string'}, 'severity': {'enum': ['low', 'medium', 'high'], 'type': 'string'}}, 'additionalProperties': False}, 'maxItems': 50}, 'extracted_data': {'type': 'object', 'description': 'Structured extraction results.', 'additionalProperties': True}, 'ocr_confidence': {'type': 'array', 'items': {'type': 'object', 'properties': {'page': {'type': 'integer', 'minimum': 1}, 'mean_confidence': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'low_confidence_regions': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}, 'maxItems': 10}, 'processed_pages': {'type': 'integer', 'maximum': 10, 'minimum': 0}, 'retention_result': {'type': 'object', 'properties': {'stored': {'type': 'boolean'}, 'expires_at': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?Z$'}}, 'additionalProperties': False}, 'unsupported_content': {'type': 'array', 'items': {'type': 'object', 'properties': {'page': {'type': 'integer', 'minimum': 1}, 'reason': {'type': 'string'}}, 'additionalProperties': False}, 'maxItems': 20}, 'media_type_confirmed': {'type': 'string'}, 'page_classifications': {'type': 'array', 'items': {'type': 'object', 'required': ['page_number', 'classification'], 'properties': {'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'page_number': {'type': 'integer', 'minimum': 1}, 'classification': {'enum': ['native_text', 'ocr', 'table_heavy', 'image_only', 'unsupported'], 'type': 'string'}, 'extraction_method': {'enum': ['native', 'ocr', 'hybrid', 'none'], 'type': 'string'}}, 'additionalProperties': False}, 'maxItems': 10}, 'size_bytes_confirmed': {'type': 'integer', 'minimum': 1}, 'document_classification': {'enum': ['contract', 'invoice', 'report', 'form', 'letter', 'financial_statement', 'regulatory_filing', 'other'], 'type': 'string'}, 'calculated_billable_units': {'type': 'object', 'properties': {'ocr_pages': {'type': 'integer', 'minimum': 0}, 'table_pages': {'type': 'integer', 'minimum': 0}, 'total_billable': {'type': 'integer', 'minimum': 0}, 'native_text_pages': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, 'estimated_or_final_amount': {'$ref': '#/$defs/money'}}, 'description': 'Document evidence extension payload.', 'additionalProperties': False}}, 'propertyNames': {'type': 'string', 'pattern': '^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?){2,}$', 'maxLength': 253, 'minLength': 5}}}}], 'title': 'Document Evidence JSON Output', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'description': 'Output schema for document_evidence_json.v1 service. Must be a valid PCC 1.0.0 document with required net.siteborne.document-evidence.v1 extension. Governed candidate output for Service Contract 3.0.0 / PCC 2.0.0.'}}}
siteborne_get_quote
Get SITEBORNE quote
Build a canonical x402 payment quote for one SITEBORNE service and exact request input. Use when: an agent needs the governed price, payee, network, asset, resource, expiry, and payment requirement before deciding whether to invoke a paid service. Do not use when: evidence work is required now (use the matching siteborne_build_company_evidence_graph, siteborne_retrieve_verified_web_context, siteborne_extract_document_evidence_json, or siteborne_verify_agent_output tool), or only availability is needed (use siteborne_get_service_health). Parameters: scheme must be the one scheme the service is offered under (company_evidence_graph.v2 exact, web_context_verified.v2 exact, document_evidence_json.v2 upto, verify_agent_output.v2 exact, company_evidence_graph.v3 exact, web_context_verified.v3 exact, document_evidence_json.v3 upto, verify_agent_output.v3 exact); any other scheme is rejected with scheme_not_offered. input is hashed, so the quote binds only that exact request. Behavior: quote-only and read-only; it hashes the proposed input, and does not execute the underlying paid service, verify payment, call a provider, create a Workflow, or settle. Economics: free of charge. The returned amount is the exact price, or for upto an authorized maximum whose actual_amount is null because the real charge is measured at settlement and never exceeds it. Failure: a mode that has a governed price but is unavailable returns retrieval_mode_unavailable or verification_mode_unavailable and no quote; a quote expires at expires_at. Returns: an expiring input-bound quote with its x402 payment requirement and the canonical economics block.
只读 幂等
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['service_id', 'scheme', 'input'], 'properties': {'input': {'description': 'Complete proposed input for the selected service; its canonical hash binds the quote and later payment requirement to this exact request content.'}, 'scheme': {'enum': ['exact', 'upto'], 'type': 'string', 'description': 'Pricing mode: exact fixes the required amount, while upto authorizes a maximum whose eventual charge cannot exceed the returned amount.'}, 'service_id': {'enum': ['company_evidence_graph.v1', 'web_context_verified.v1', 'document_evidence_json.v1', 'verify_agent_output.v1', 'company_evidence_graph.v2', 'web_context_verified.v2', 'document_evidence_json.v2', 'verify_agent_output.v2', 'company_evidence_graph.v3', 'web_context_verified.v3', 'document_evidence_json.v3', 'verify_agent_output.v3'], 'type': 'string', 'description': 'Canonical SITEBORNE service and major version to price; selects that serviceâ\x80\x99s governed pricing key, contract release, and production resource URL.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['quote_id', 'binding_hash', 'service_id', 'service_version', 'contract_release', 'input_hash', 'pricing_key', 'pricing_source_version', 'scheme', 'network', 'asset', 'amount', 'amount_kind', 'actual_amount', 'resource_id', 'requirement_id', 'payment_requirements', 'payee', 'issued_at', 'expires_at', 'production_enabled', 'payment_required', 'economics'], 'properties': {'asset': {'type': 'string', 'description': 'Token contract address on the network that the amount is denominated in.'}, 'payee': {'type': 'string', 'description': 'Public payTo address that receives the payment.'}, 'amount': {'type': 'string', 'description': 'Amount in the asset atomic units (6 decimals for USDC): the exact price when amount_kind is exact, or the authorized maximum when it is authorized_maximum.'}, 'scheme': {'enum': ['exact', 'upto'], 'type': 'string', 'description': 'x402 scheme: exact requires the amount; upto authorizes it as a maximum.'}, 'network': {'type': 'string', 'description': 'CAIP-2 network the payment must be made on (for example eip155:8453).'}, 'quote_id': {'type': 'string', 'description': 'Deterministic identifier of this quote.'}, 'economics': {'type': 'object', 'description': 'The canonical economic contract for the quoted service (pricing model, tiers, authorization maximum, settlement model, modes and their availability, limits, production state, pricing_source_version, and network/asset/pay_to); identical on every SITEBORNE discovery surface.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'issued_at': {'type': 'string', 'description': 'UTC time the quote was issued.'}, 'expires_at': {'type': 'string', 'description': 'UTC time after which the quote is no longer valid.'}, 'input_hash': {'type': 'string', 'description': 'Canonical hash of the exact request input this quote binds.'}, 'service_id': {'type': 'string', 'description': 'Canonical service id and major version that was quoted.'}, 'amount_kind': {'enum': ['exact', 'authorized_maximum'], 'type': 'string', 'description': 'exact: the charge equals amount. authorized_maximum: the charge is measured at settlement and never exceeds amount.'}, 'pricing_key': {'type': 'string', 'description': 'Governed pricing key the amount was resolved from (governance pricing authority).'}, 'resource_id': {'type': 'string', 'description': 'Canonical URL of the paid resource this quote is bound to.'}, 'binding_hash': {'type': 'string', 'description': 'Hash binding the quote to the exact service, input hash, price, scheme, network, asset, and payee; a payment for a different binding is not accepted.'}, 'actual_amount': {'type': 'null', 'description': 'Always null in a quote: the actual charge exists only after measured settlement.'}, 'requirement_id': {'type': 'string', 'description': 'Identifier of the x402 payment requirement embedded in payment_requirements.'}, 'service_version': {'enum': ['v1', 'v2', 'v3'], 'type': 'string', 'description': 'Service contract major version.'}, 'contract_release': {'enum': ['1.0.0', '2.0.0', '3.0.0'], 'type': 'string', 'description': 'Contract release the quoted service belongs to.'}, 'payment_required': {'type': 'boolean', 'const': True, 'description': 'Always true: executing the quoted service requires payment.'}, 'production_enabled': {'type': 'boolean', 'const': False, 'description': 'Quote-level flag, always false: a quote never authorizes execution. The service runtime state is economics.production_enabled.'}, 'payment_requirements': {'type': 'object', 'description': 'The x402 payment requirement to satisfy, including payTo, network, asset and amount.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'pricing_source_version': {'type': 'string', 'description': 'Version of the governed pricing document that produced the amount; a repricing changes this value.'}}, 'additionalProperties': False}
siteborne_get_service_health
Get SITEBORNE service health
Report MCP server readiness and production-enable status for each SITEBORNE service. Use when: an agent must check protocol availability, tool count, or whether a service is currently production-enabled before selecting a paid tool. Do not use when: a quote is needed (use siteborne_get_quote) or company, web, document, or agent-output evidence work is required (use the corresponding SITEBORNE service tool). Behavior: read-only and credential-independent; it does not perform paid evidence work, create quotes, verify payment, call providers, write service state, create Workflows, or settle. Economics: free of charge; it never issues a payment challenge. Failure: it depends on no provider, so it does not fail because a provider is unavailable. Returns: the server and protocol versions plus truthful local, production, and external-publication status for all four evidence services.
只读 幂等
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['status', 'server_name', 'server_version', 'protocol_version', 'tools', 'production_ready', 'production_enabled', 'external_publication', 'services'], 'properties': {'tools': {'type': 'number', 'const': 10}, 'status': {'type': 'string', 'const': 'ready_local'}, 'services': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'object', 'required': ['implementation', 'production', 'external'], 'properties': {'external': {'enum': ['not_live', 'configured'], 'type': 'string'}, 'production': {'enum': ['production_disabled', 'production_enabled'], 'type': 'string'}, 'implementation': {'enum': ['local_fixture_verified', 'real_executor'], 'type': 'string'}}, 'additionalProperties': False}}, 'server_name': {'type': 'string', 'const': 'net.siteborne/utility'}, 'server_version': {'type': 'string', 'const': '0.1.0'}, 'production_ready': {'type': 'boolean', 'const': False}, 'protocol_version': {'type': 'string', 'const': '2026-07-28'}, 'production_enabled': {'type': 'boolean'}, 'external_publication': {'type': 'string', 'const': 'blocked_external'}}, 'additionalProperties': False}
siteborne_retrieve_verified_web_context
Retrieve verified web context
Retrieve and verify evidence from one public web URL using direct HTTP retrieval. Use when: the request is specifically about the content and provenance of a URL. Do not use when: evidence must be synthesized for a company (use siteborne_build_company_evidence_graph), extracted from an authorized document (use siteborne_extract_document_evidence_json), checked against an existing output contract (use siteborne_verify_agent_output), or the page requires JavaScript rendering (rendered retrieval is not available). Parameters: retrieval_mode must be direct; rendered is defined but unavailable and is rejected before any payment challenge, never substituted with direct retrieval. output_mode structured needs buyer_schema and field_selectors to be meaningful; redirect_policy and max_redirects bound redirect following; max_content_size bounds returned bytes; maximum_authorized_price only constrains payment and never changes retrieval scope. Behavior: open-world: a paid request performs bounded outbound HTTP retrieval of the target URL through a safe-egress boundary (private and loopback destinations are refused) and persists governed payment, audit, job and Workflow state; an unpaid request returns payment_required; a repeated identical request with the same payment is replay-protected and is not charged twice. Retrieval admission follows the governed runtime rate policy; no fixed public per-origin rate is promised. This service is currently production-disabled and rejects execution. Economics: exact price of $0.008 USD per request in direct mode; the payment challenge requires that amount and the charge settles at exactly that amount. rendered mode has a governed price of $0.029 USD but is not available: it is rejected before any payment challenge and never substituted. Failure: schema-invalid input and unavailable modes are rejected before any payment challenge; target-site errors, timeouts and unavailable retrieval return a structured MCP error and are never answered with a substitute result. Returns: normalized, source-attributed web context with verification and PCC evidence.
可访问外部资源 幂等
输入模式
{'$id': 'https://siteborne.net/schemas/services/web-context-input.schema.json', 'type': 'object', 'title': 'Verified Web Context Input', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'examples': [{'target_url': 'https://acme.example.com/about', 'output_mode': 'markdown', 'retrieval_mode': 'direct', 'freshness_seconds': 3600, 'maximum_authorized_price': {'amount': '0.029', 'currency': 'USD'}}], 'required': ['target_url', 'retrieval_mode'], 'properties': {'target_url': {'type': 'string', 'format': 'uri', 'maxLength': 2048, 'description': 'Public HTTP or HTTPS URL to retrieve and verify; private, loopback, and otherwise unsafe network destinations are rejected.'}, 'locale_hint': {'type': 'string', 'pattern': '^[a-z]{2}(-[A-Z]{2})?$', 'description': 'Optional BCP 47 language or language-region hint used for HTTP content negotiation; it does not translate content.'}, 'output_mode': {'enum': ['clean_text', 'markdown', 'structured'], 'type': 'string', 'default': 'clean_text', 'description': 'Result representation: clean_text normalizes prose, markdown preserves document structure, and structured validates selected fields against buyer_schema.'}, 'buyer_schema': {'type': 'object', 'maxDepth': 5, 'description': 'Optional JSON Schema governing structured output; meaningful only with output_mode structured and bounded to fifty properties and depth five.', 'maxProperties': 50, 'additionalProperties': True}, 'max_redirects': {'type': 'integer', 'default': 5, 'maximum': 10, 'minimum': 0, 'description': 'Maximum redirect hops from 0 through 10 when the selected redirect policy follows redirects.'}, 'retrieval_mode': {'enum': ['direct', 'rendered'], 'type': 'string', 'description': 'Retrieval mode. Only direct (plain HTTP retrieval, no JavaScript execution) is available. rendered has a governed price but is not available: it is rejected with retrieval_mode_unavailable before any payment challenge and is never substituted with direct retrieval.'}, 'field_selectors': {'type': 'array', 'items': {'type': 'string', 'maxLength': 128}, 'maxItems': 30, 'description': 'Up to thirty requested field names for structured extraction; narrows the structured result rather than changing the fetched URL.'}, 'redirect_policy': {'enum': ['follow', 'follow_first', 'manual'], 'type': 'string', 'default': 'follow', 'description': 'Redirect handling: follow permits the bounded chain, follow_first permits only the first hop, and manual returns redirect evidence without following.'}, 'max_content_size': {'type': 'integer', 'default': 1048576, 'maximum': 10485760, 'minimum': 1024, 'description': 'Maximum returned content size in bytes, from 1,024 through 10,485,760; smaller limits truncate or reject oversized content sooner.'}, 'freshness_seconds': {'type': 'integer', 'default': 3600, 'maximum': 2592000, 'minimum': 0, 'description': 'Maximum acceptable cached-content age in seconds, from 0 through 2,592,000; zero requests uncached content.'}, 'maximum_authorized_price': {'type': 'object', 'title': 'Decimal Money', 'examples': [{'amount': '0.039', 'currency': 'USD'}, {'asset': 'USDC', 'amount': '0.19', 'network': 'base-mainnet', 'currency': 'USD'}], 'required': ['amount', 'currency'], 'properties': {'asset': {'type': 'string', 'pattern': '^[A-Z0-9]{3,10}$', 'description': "Payment asset identifier (e.g., 'USDC', 'ETH'). Optional for non-payment contexts."}, 'amount': {'type': 'string', 'pattern': '^(0|[1-9][0-9]*)(\\.[0-9]{1,18})?$', 'examples': ['0', '0.009', '0.012', '0.019', '0.029', '0.039', '0.049', '0.19'], 'description': "Canonical decimal string. No scientific notation, no leading zeros (except single '0'), no trailing zeros unless significant, no sign. Maximum 18 decimal places."}, 'network': {'type': 'string', 'pattern': '^[a-z0-9-]+$', 'maxLength': 64, 'description': "Payment network identifier (e.g., 'base-mainnet', 'base-sepolia'). Optional for non-payment contexts."}, 'currency': {'enum': ['USD'], 'type': 'string', 'default': 'USD', 'pattern': '^[A-Z]{3}$', 'description': 'ISO 4217 currency code.'}, 'precision': {'type': 'integer', 'default': 6, 'maximum': 18, 'minimum': 0, 'description': 'Maximum decimal places supported by the asset/network. Metadata only.'}}, 'description': 'Buyerâ\x80\x99s decimal-safe maximum authorized price; constrains the payment requirement and never changes retrieval scope.', 'additionalProperties': False}, 'minimum_verification_score': {'type': 'number', 'default': 0.7, 'maximum': 1, 'minimum': 0, 'description': 'Required PCC verification ratio from 0 through 1; raising it makes evidence acceptance stricter.'}}, 'description': 'Input schema for web_context_verified.v1 service. Supports direct and rendered retrieval modes.', 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['result'], 'properties': {'result': {'$id': 'https://siteborne.net/schemas/services/web-context-output.schema.json', '$defs': {'pcc': {'type': 'object', 'title': 'Proof-Carrying Context (PCC) v1.0.0', 'required': ['pcc_version', 'job_id', 'contract', 'subject', 'claims', 'evidence', 'completeness', 'provenance', 'verification', 'receipt'], 'properties': {'claims': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/claim'}, 'uniqueItems': True}, 'job_id': {'$ref': '#/$defs/pcc/definitions/job_id'}, 'receipt': {'$ref': '#/$defs/pcc/definitions/receipt'}, 'subject': {'$ref': '#/$defs/pcc/definitions/subject'}, 'contract': {'$ref': '#/$defs/pcc/definitions/contract'}, 'evidence': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/evidence_item'}, 'uniqueItems': True}, 'extensions': {'$ref': '#/$defs/pcc/definitions/extension_container'}, 'provenance': {'$ref': '#/$defs/pcc/definitions/provenance'}, 'pcc_version': {'$ref': '#/$defs/pcc/definitions/pcc_version'}, 'completeness': {'$ref': '#/$defs/pcc/definitions/completeness'}, 'verification': {'$ref': '#/$defs/pcc/definitions/verification'}}, 'definitions': {'hash': {'type': 'string', 'pattern': '^sha256:[a-f0-9]{64}$', 'description': 'SHA-256 hash with algorithm tag'}, 'claim': {'type': 'object', 'required': ['claim_id', 'predicate', 'value', 'confidence', 'evidence_ids', 'materiality', 'verification_status'], 'properties': {'value': {'type': ['string', 'number', 'boolean', 'object', 'array', 'null']}, 'claim_id': {'$ref': '#/$defs/pcc/definitions/claim_id'}, 'predicate': {'type': 'string', 'minLength': 1}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'materiality': {'$ref': '#/$defs/pcc/definitions/materiality'}, 'evidence_ids': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/evidence_id'}}, 'verification_status': {'$ref': '#/$defs/pcc/definitions/verification_status'}}, 'additionalProperties': False}, 'job_id': {'type': 'string', 'pattern': '^job_[a-z0-9]{24}$', 'description': 'Unique job identifier'}, 'key_id': {'type': 'string', 'pattern': '^kid_[a-z0-9]{24}$', 'description': 'Key identifier'}, 'locator': {'type': 'object', 'required': ['type', 'value'], 'properties': {'type': {'$ref': '#/$defs/pcc/definitions/locator_type'}, 'value': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'receipt': {'type': 'object', 'required': ['output_hash', 'canonicalization_algorithm', 'policy_hash', 'schema_hash', 'signature_algorithm', 'signing_key_id', 'signature', 'signed_at'], 'properties': {'signature': {'type': 'string', 'pattern': '^[A-Za-z0-9_-]{86,88}$'}, 'signed_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'output_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'policy_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'schema_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'signing_key_id': {'$ref': '#/$defs/pcc/definitions/key_id'}, 'signature_algorithm': {'$ref': '#/$defs/pcc/definitions/signature_algorithm'}, 'canonicalization_algorithm': {'$ref': '#/$defs/pcc/definitions/canonicalization_algorithm'}}, 'additionalProperties': False}, 'subject': {'type': 'object', 'required': ['type', 'canonical_name'], 'properties': {'type': {'$ref': '#/$defs/pcc/definitions/subject_type'}, 'identifiers': {'type': 'object', 'additionalProperties': {'type': 'string'}}, 'canonical_name': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'claim_id': {'type': 'string', 'pattern': '^clm_[a-z0-9]{24}$', 'description': 'Claim identifier'}, 'contract': {'type': 'object', 'required': ['service_id', 'service_version', 'input_hash', 'input_schema_hash', 'output_schema_hash', 'quote_id', 'mode', 'currency', 'minimum_quality', 'freshness_seconds', 'issued_at', 'expires_at', 'idempotency_key'], 'properties': {'mode': {'$ref': '#/$defs/pcc/definitions/contract_mode'}, 'price': {'$ref': '#/$defs/pcc/definitions/decimal_string'}, 'network': {'enum': ['base', 'base-testnet'], 'type': 'string'}, 'currency': {'$ref': '#/$defs/pcc/definitions/currency'}, 'quote_id': {'$ref': '#/$defs/pcc/definitions/quote_id'}, 'issued_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'expires_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'input_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'service_id': {'$ref': '#/$defs/pcc/definitions/service_id'}, 'idempotency_key': {'$ref': '#/$defs/pcc/definitions/idempotency_key'}, 'minimum_quality': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'service_version': {'$ref': '#/$defs/pcc/definitions/service_version'}, 'freshness_seconds': {'type': 'integer', 'minimum': 1}, 'input_schema_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'output_schema_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'maximum_authorized_price': {'$ref': '#/$defs/pcc/definitions/decimal_string'}}, 'additionalProperties': False}, 'currency': {'enum': ['USD', 'USDC'], 'type': 'string', 'description': 'Permitted currencies'}, 'quote_id': {'type': 'string', 'pattern': '^qte_[a-z0-9]{24}$', 'description': 'Quote identifier'}, 'policy_id': {'type': 'string', 'pattern': '^pol_[a-z0-9]{24}$', 'description': 'Policy identifier'}, 'provenance': {'type': 'object', 'required': ['routes', 'providers', 'tools', 'models', 'software_versions', 'policy_versions', 'transformations', 'cache_provenance', 'execution_environment', 'verification_routes'], 'properties': {'tools': {'type': 'object', 'description': 'Tool name to version mapping', 'additionalProperties': {'type': 'string'}}, 'models': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'version', 'provider'], 'properties': {'name': {'type': 'string', 'minLength': 1}, 'version': {'type': 'string', 'minLength': 1}, 'provider': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}}, 'routes': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/provenance_route'}}, 'providers': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'version', 'capabilities'], 'properties': {'name': {'type': 'string', 'minLength': 1}, 'version': {'type': 'string', 'minLength': 1}, 'capabilities': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}}, 'policy_versions': {'type': 'object', 'description': 'Policy name to version mapping', 'additionalProperties': {'type': 'string'}}, 'transformations': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/transformation'}}, 'cache_provenance': {'type': 'object', 'required': ['enabled', 'hit'], 'properties': {'hit': {'type': 'boolean'}, 'enabled': {'type': 'boolean'}, 'cache_key': {'type': 'string'}, 'stored_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}}, 'additionalProperties': False}, 'software_versions': {'type': 'object', 'description': 'Component name to version mapping', 'additionalProperties': {'type': 'string'}}, 'verification_routes': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/provenance_route'}}, 'execution_environment': {'type': 'object', 'required': ['runtime', 'version', 'platform'], 'properties': {'runtime': {'type': 'string', 'minLength': 1}, 'version': {'type': 'string', 'minLength': 1}, 'platform': {'type': 'string', 'minLength': 1}, 'container_image': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'service_id': {'enum': ['company_evidence_graph.v1', 'web_context_verified.v1', 'document_evidence_json.v1', 'verify_agent_output.v1', 'company_evidence_graph.v2', 'web_context_verified.v2', 'document_evidence_json.v2', 'verify_agent_output.v2'], 'type': 'string', 'description': 'Service identifier'}, 'evidence_id': {'type': 'string', 'pattern': '^evd_[a-z0-9]{24}$', 'description': 'Evidence identifier'}, 'materiality': {'enum': ['material', 'supporting', 'contextual'], 'type': 'string', 'description': 'Claim materiality classification'}, 'pcc_version': {'type': 'string', 'const': '1.0.0', 'description': 'PCC specification version'}, 'completeness': {'type': 'object', 'required': ['requested_fields', 'populated_fields', 'supported_fields', 'score', 'missing_fields', 'unsupported_fields', 'stale_fields', 'vector'], 'properties': {'score': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'vector': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/completeness_vector_entry'}}, 'stale_fields': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}}, 'missing_fields': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}}, 'populated_fields': {'type': 'integer', 'minimum': 0}, 'requested_fields': {'type': 'integer', 'minimum': 0}, 'supported_fields': {'type': 'integer', 'minimum': 0}, 'unsupported_fields': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}}}, 'additionalProperties': False}, 'locator_type': {'enum': ['json_pointer', 'xpath', 'css_selector', 'text_quote', 'page_region', 'byte_range', 'database_record', 'artifact_pointer'], 'type': 'string', 'description': 'Evidence locator type'}, 'subject_type': {'enum': ['organization', 'person', 'document', 'webpage', 'other'], 'type': 'string', 'description': 'Subject type'}, 'verification': {'type': 'object', 'required': ['schema_valid', 'material_claims_supported', 'evidence_accessibility', 'freshness', 'completeness', 'cross_source_agreement', 'provenance_valid', 'prompt_injection_result', 'deterministic_failures', 'verifier_versions', 'policy', 'decision', 'score', 'failed_requirements'], 'properties': {'score': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'policy': {'$ref': '#/$defs/pcc/definitions/policy_id'}, 'decision': {'$ref': '#/$defs/pcc/definitions/verification_decision'}, 'freshness': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'completeness': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'schema_valid': {'type': 'boolean'}, 'provenance_valid': {'type': 'boolean'}, 'verifier_versions': {'type': 'object', 'additionalProperties': {'type': 'string'}}, 'failed_requirements': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}}, 'cross_source_agreement': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'deterministic_failures': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}}, 'evidence_accessibility': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'prompt_injection_result': {'type': 'object', 'required': ['checked', 'result'], 'properties': {'result': {'enum': ['clean', 'suspected', 'confirmed'], 'type': 'string'}, 'checked': {'type': 'boolean'}, 'details': {'type': 'string'}}, 'additionalProperties': False}, 'material_claims_supported': {'type': 'boolean'}}, 'additionalProperties': False}, 'contract_mode': {'enum': ['paid', 'benchmark', 'offline_verification'], 'type': 'string', 'description': 'Contract mode determines required fields'}, 'evidence_item': {'type': 'object', 'required': ['evidence_id', 'source_uri', 'retrieved_at', 'content_hash', 'media_type', 'locator', 'accessibility_status', 'transformation_history', 'authorization_classification', 'freshness_status'], 'properties': {'locator': {'$ref': '#/$defs/pcc/definitions/locator'}, 'media_type': {'type': 'string', 'minLength': 1}, 'source_uri': {'type': 'string', 'format': 'uri', 'minLength': 1}, 'evidence_id': {'$ref': '#/$defs/pcc/definitions/evidence_id'}, 'content_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'retrieved_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'freshness_status': {'$ref': '#/$defs/pcc/definitions/freshness_status'}, 'source_timestamp': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'accessibility_status': {'$ref': '#/$defs/pcc/definitions/accessibility_status'}, 'transformation_history': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/transformation'}}, 'authorization_classification': {'$ref': '#/$defs/pcc/definitions/authorization_classification'}}, 'additionalProperties': False}, 'decimal_string': {'type': 'string', 'pattern': '^(0|[1-9]\\d*)(\\.\\d+)?$', 'description': 'Non-negative decimal string, no scientific notation, no leading zeros except single zero'}, 'transformation': {'type': 'object', 'required': ['type', 'timestamp', 'tool_version'], 'properties': {'type': {'type': 'string', 'minLength': 1}, 'timestamp': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'parameters': {'type': 'object', 'additionalProperties': True}, 'tool_version': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'extension_value': {'type': 'object', 'description': 'Bounded JSON data payload for a single namespaced extension (PCC 1.0.1). Must be a JSON object; unbounded, executable, or policy-changing structures are out of scope for structural validation. Individual services may further narrow this shape for their own namespace via allOf composition.', 'maxProperties': 200, 'additionalProperties': True}, 'idempotency_key': {'type': 'string', 'pattern': '^idk_[a-z0-9]{24}$', 'description': 'Idempotency key'}, 'service_version': {'type': 'string', 'pattern': '^v\\d+(\\.\\d+)*$', 'description': 'Service version'}, 'freshness_status': {'enum': ['fresh', 'stale', 'unknown'], 'type': 'string', 'description': 'Evidence freshness status'}, 'provenance_route': {'type': 'object', 'required': ['type', 'provider', 'version'], 'properties': {'type': {'enum': ['cache', 'direct', 'deterministic', 'model', 'hybrid'], 'type': 'string'}, 'version': {'type': 'string', 'minLength': 1}, 'provider': {'type': 'string', 'minLength': 1}, 'model_name': {'type': 'string'}, 'parameters': {'type': 'object', 'additionalProperties': True}, 'model_version': {'type': 'string'}}, 'additionalProperties': False}, 'timestamp_rfc3339': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?Z$', 'description': 'RFC 3339 UTC timestamp with Z suffix, normalized fractional seconds'}, 'extension_container': {'type': 'object', 'description': 'Controlled extension container. Keys must use reverse-domain qualified namespaces with at least three DNS-safe labels (e.g., net.siteborne.verification.v1, com.example.custom-metrics.v1). Underscores, leading/trailing hyphens, empty labels, and uppercase are forbidden. Maximum 10 extensions. Maximum total namespace key length: 253 characters. Each value must conform to extension_value (bounded JSON data).', 'maxProperties': 10, 'propertyNames': {'type': 'string', 'pattern': '^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?){2,}$', 'maxLength': 253, 'minLength': 5}, 'patternProperties': {'^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?){2,}$': {'$ref': '#/$defs/pcc/definitions/extension_value'}}, 'additionalProperties': False}, 'signature_algorithm': {'type': 'string', 'const': 'Ed25519', 'description': 'Signature algorithm'}, 'verification_status': {'enum': ['verified', 'unsupported', 'disputed', 'pending'], 'type': 'string', 'description': 'Claim verification status'}, 'accessibility_status': {'enum': ['accessible', 'unavailable', 'restricted', 'requires_authorization'], 'type': 'string', 'description': 'Evidence accessibility status'}, 'verification_decision': {'enum': ['pass', 'conditional', 'fail', 'quarantined'], 'type': 'string', 'description': 'Verification decision'}, 'completeness_vector_entry': {'type': 'object', 'required': ['dimension', 'requested', 'populated', 'supported', 'score'], 'properties': {'score': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'dimension': {'type': 'string', 'minLength': 1}, 'populated': {'type': 'integer', 'minimum': 0}, 'requested': {'type': 'integer', 'minimum': 0}, 'supported': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, 'canonicalization_algorithm': {'type': 'string', 'const': 'RFC8785-JCS', 'description': 'Canonicalization algorithm'}, 'authorization_classification': {'enum': ['public', 'buyer_authorized', 'restricted', 'confidential'], 'type': 'string', 'description': 'Evidence authorization classification'}}, 'description': 'Normative schema for Proof-Carrying Context 1.0.0. Frozen after compatibility validation passes. Schema patch 1.0.1 (SUN-0100 correction): extension_container now structurally permits qualified extension keys via patternProperties, matching documented semantics; pcc_version (document content compatibility) is unchanged at 1.0.0. Schema minor 1.1.0 (SUN-1000 checkpoint 1M): service_id enum gains 4 new .v2 members (additive-only per packages/pcc-schema/policy/COMPATIBILITY.md section 1/section 4, which explicitly classifies new enum values as minor-compatible -- not the docs/contracts/COMPATIBILITY_POLICY.md service-contract-release taxonomy, which does not govern this file); the 4 existing .v1 members are unchanged and remain valid; pcc_version is unchanged at 1.0.0.', 'pcc_version': '1.0.0', 'additionalProperties': False}, 'money': {'type': 'object', 'title': 'Decimal Money', 'examples': [{'amount': '0.039', 'currency': 'USD'}, {'asset': 'USDC', 'amount': '0.19', 'network': 'base-mainnet', 'currency': 'USD'}], 'required': ['amount', 'currency'], 'properties': {'asset': {'type': 'string', 'pattern': '^[A-Z0-9]{3,10}$', 'description': "Payment asset identifier (e.g., 'USDC', 'ETH'). Optional for non-payment contexts."}, 'amount': {'type': 'string', 'pattern': '^(0|[1-9][0-9]*)(\\.[0-9]{1,18})?$', 'examples': ['0', '0.009', '0.012', '0.019', '0.029', '0.039', '0.049', '0.19'], 'description': "Canonical decimal string. No scientific notation, no leading zeros (except single '0'), no trailing zeros unless significant, no sign. Maximum 18 decimal places."}, 'network': {'type': 'string', 'pattern': '^[a-z0-9-]+$', 'maxLength': 64, 'description': "Payment network identifier (e.g., 'base-mainnet', 'base-sepolia'). Optional for non-payment contexts."}, 'currency': {'enum': ['USD'], 'type': 'string', 'default': 'USD', 'pattern': '^[A-Z]{3}$', 'description': 'ISO 4217 currency code.'}, 'precision': {'type': 'integer', 'default': 6, 'maximum': 18, 'minimum': 0, 'description': 'Maximum decimal places supported by the asset/network. Metadata only.'}}, 'description': 'Canonical decimal-safe money representation. No binary floating-point. Amount is a canonical decimal string.', 'additionalProperties': False}}, 'allOf': [{'$ref': '#/$defs/pcc'}, {'type': 'object', 'required': ['contract', 'extensions'], 'properties': {'contract': {'type': 'object', 'required': ['service_id', 'service_version', 'output_schema_hash'], 'properties': {'service_id': {'enum': ['web_context_verified.v1', 'web_context_verified.v2']}, 'service_version': {'enum': ['v1', 'v2']}, 'output_schema_hash': {'type': 'string', 'pattern': '^sha256:[a-f0-9]{64}$'}}}, 'extensions': {'type': 'object', 'required': ['net.siteborne.web-context.v1'], 'properties': {'net.siteborne.web-context.v1': {'type': 'object', 'properties': {'markdown': {'type': 'string', 'maxLength': 10485760, 'description': 'Markdown output when requested.'}, 'final_url': {'type': 'string', 'format': 'uri', 'description': 'Final URL after redirects.'}, 'byte_count': {'type': 'integer', 'minimum': 0}, 'limitations': {'type': 'array', 'items': {'type': 'string', 'maxLength': 256}, 'maxItems': 20}, 'source_hash': {'type': 'string', 'pattern': '^sha256:[a-f0-9]{64}$', 'description': 'Hash of raw source content.'}, 'cache_status': {'type': 'object', 'properties': {'hit': {'type': 'boolean'}, 'age_seconds': {'type': 'integer'}, 'freshness_seconds': {'type': 'integer'}}, 'additionalProperties': False}, 'content_hash': {'type': 'string', 'pattern': '^sha256:[a-f0-9]{64}$', 'description': 'Hash of processed output content.'}, 'http_metadata': {'type': 'object', 'properties': {'headers': {'type': 'object', 'additionalProperties': {'type': 'string'}}, 'status_code': {'type': 'integer', 'maximum': 599, 'minimum': 100}, 'content_type': {'type': 'string'}, 'content_length': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, 'requested_url': {'type': 'string', 'format': 'uri', 'description': 'Originally requested URL.'}, 'canonical_text': {'type': 'string', 'maxLength': 10485760, 'description': 'Clean text extraction.'}, 'redirect_chain': {'type': 'array', 'items': {'type': 'object', 'required': ['url', 'status_code'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'status_code': {'type': 'integer', 'maximum': 399, 'minimum': 300}}, 'additionalProperties': False}, 'maxItems': 10}, 'character_count': {'type': 'integer', 'minimum': 0}, 'structured_fields': {'type': 'object', 'description': 'Structured extraction when requested.', 'additionalProperties': True}, 'truncation_status': {'type': 'object', 'properties': {'truncated': {'type': 'boolean'}, 'original_bytes': {'type': 'integer', 'minimum': 0}, 'returned_bytes': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, 'rendering_metadata': {'type': 'object', 'properties': {'engine': {'type': 'string'}, 'version': {'type': 'string'}, 'load_time_ms': {'type': 'integer', 'minimum': 0}, 'network_requests': {'type': 'integer', 'minimum': 0}, 'scripts_executed': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, 'extraction_warnings': {'type': 'array', 'items': {'type': 'string', 'maxLength': 256}, 'maxItems': 20}, 'retrieval_freshness': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?Z$', 'description': 'Timestamp of content retrieval.'}, 'retrieval_mode_used': {'enum': ['direct', 'rendered'], 'type': 'string', 'description': 'Mode actually used (may differ if rendered unavailable).'}, 'content_classification': {'enum': ['article', 'landing', 'document', 'app', 'error', 'other'], 'type': 'string'}, 'retrieval_mode_requested': {'enum': ['direct', 'rendered'], 'type': 'string'}, 'prompt_injection_findings': {'type': 'array', 'items': {'type': 'object', 'properties': {'type': {'type': 'string'}, 'location': {'type': 'string'}, 'severity': {'enum': ['low', 'medium', 'high', 'critical'], 'type': 'string'}, 'evidence_id': {'type': 'string'}}, 'additionalProperties': False}, 'maxItems': 20}}, 'description': 'Web context extension payload.', 'additionalProperties': False}}, 'propertyNames': {'type': 'string', 'pattern': '^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?){2,}$', 'maxLength': 253, 'minLength': 5}}}}], 'title': 'Verified Web Context Output', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'examples': [{'claims': [], 'job_id': 'job_aaaaaaaaaaaaaaaaaaaaaaaa', 'receipt': {'signature': 'AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA', 'signed_at': '2026-08-05T10:00:00Z', 'output_hash': 'sha256:eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee', 'policy_hash': 'sha256:ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff', 'schema_hash': 'sha256:0000000000000000000000000000000000000000000000000000000000000000', 'signing_key_id': 'kid_aaaaaaaaaaaaaaaaaaaaaaaa', 'signature_algorithm': 'Ed25519', 'canonicalization_algorithm': 'RFC8785-JCS'}, 'subject': {'type': 'organization', 'identifiers': {'domain': 'acme.example.com'}, 'canonical_name': 'Acme Example Corp'}, 'contract': {'mode': 'paid', 'currency': 'USD', 'quote_id': 'qte_aaaaaaaaaaaaaaaaaaaaaaaa', 'issued_at': '2026-08-05T10:00:00Z', 'expires_at': '2026-08-06T10:00:00Z', 'input_hash': 'sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa', 'service_id': 'web_context_verified.v1', 'idempotency_key': 'idk_aaaaaaaaaaaaaaaaaaaaaaaa', 'minimum_quality': 0.8, 'service_version': 'v1', 'freshness_seconds': 3600, 'input_schema_hash': 'sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb', 'output_schema_hash': 'sha256:abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890'}, 'evidence': [], 'extensions': {'net.siteborne.web-context.v1': {'markdown': '# Acme Corp\n\nLeading innovation...', 'final_url': 'https://acme.example.com/about', 'requested_url': 'https://acme.example.com/about', 'canonical_text': 'Acme Corp - Leading innovation...', 'truncation_status': {'truncated': False, 'original_bytes': 15420, 'returned_bytes': 15420}, 'retrieval_mode_used': 'rendered', 'content_classification': 'landing', 'retrieval_mode_requested': 'rendered'}}, 'provenance': {'tools': {'curl': '8.0.0'}, 'models': [], 'routes': [{'type': 'direct', 'version': '1.0.0', 'provider': 'web'}], 'providers': [{'name': 'web', 'version': '1.0.0', 'capabilities': ['fetch']}], 'policy_versions': {'verification': '1.0.0'}, 'transformations': [], 'cache_provenance': {'hit': False, 'enabled': False}, 'software_versions': {'pcc': '1.0.0'}, 'verification_routes': [], 'execution_environment': {'runtime': 'node', 'version': '22.0.0', 'platform': 'linux'}}, 'pcc_version': '1.0.0', 'completeness': {'score': 0.8, 'vector': [{'score': 0.8, 'dimension': 'general', 'populated': 4, 'requested': 5, 'supported': 4}], 'stale_fields': [], 'missing_fields': ['ceo_name'], 'populated_fields': 4, 'requested_fields': 5, 'supported_fields': 4, 'unsupported_fields': []}, 'verification': {'score': 0.9, 'policy': 'pol_aaaaaaaaaaaaaaaaaaaaaaaa', 'decision': 'pass', 'freshness': 1, 'completeness': 0.8, 'schema_valid': True, 'provenance_valid': True, 'verifier_versions': {'pcc': '1.0.0'}, 'failed_requirements': [], 'cross_source_agreement': 1, 'deterministic_failures': [], 'evidence_accessibility': 1, 'prompt_injection_result': {'result': 'clean', 'checked': True}, 'material_claims_supported': True}}], 'description': 'Output schema for web_context_verified.v1 service. Must be a valid PCC 1.0.0 document with required net.siteborne.web-context.v1 extension.'}}}
siteborne_retrieve_verified_web_context_v3_candidate
Retrieve verified web context (v3 candidate)
Retrieve and verify evidence from one public web URL using direct HTTP retrieval. Use when: the request is specifically about the content and provenance of a URL. Do not use when: evidence must be synthesized for a company (use siteborne_build_company_evidence_graph), extracted from an authorized document (use siteborne_extract_document_evidence_json), checked against an existing output contract (use siteborne_verify_agent_output), or the page requires JavaScript rendering (rendered retrieval is not available). Parameters: retrieval_mode must be direct; rendered is defined but unavailable and is rejected before any payment challenge, never substituted with direct retrieval. output_mode structured needs buyer_schema and field_selectors to be meaningful; redirect_policy and max_redirects bound redirect following; max_content_size bounds returned bytes; maximum_authorized_price only constrains payment and never changes retrieval scope. Behavior: open-world: a paid request performs bounded outbound HTTP retrieval of the target URL through a safe-egress boundary (private and loopback destinations are refused) and persists governed payment, audit, job and Workflow state; an unpaid request returns payment_required; a repeated identical request with the same payment is replay-protected and is not charged twice. Retrieval admission follows the governed runtime rate policy; no fixed public per-origin rate is promised. This service is currently production-disabled and rejects execution. Economics: exact price of $0.008 USD per request in direct mode; the payment challenge requires that amount and the charge settles at exactly that amount. rendered mode has a governed price of $0.029 USD but is not available: it is rejected before any payment challenge and never substituted. Failure: schema-invalid input and unavailable modes are rejected before any payment challenge; target-site errors, timeouts and unavailable retrieval return a structured MCP error and are never answered with a substitute result. Returns: normalized, source-attributed web context with verification and PCC evidence.
可访问外部资源 幂等
输入模式
{'$id': 'https://siteborne.net/schemas/services/web-context-input.schema.json', 'type': 'object', 'title': 'Verified Web Context Input', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'examples': [{'target_url': 'https://acme.example.com/about', 'output_mode': 'markdown', 'retrieval_mode': 'direct', 'freshness_seconds': 3600, 'maximum_authorized_price': {'amount': '0.029', 'currency': 'USD'}}], 'required': ['target_url', 'retrieval_mode'], 'properties': {'target_url': {'type': 'string', 'format': 'uri', 'maxLength': 2048, 'description': 'Public HTTP or HTTPS URL to retrieve and verify; private, loopback, and otherwise unsafe network destinations are rejected.'}, 'locale_hint': {'type': 'string', 'pattern': '^[a-z]{2}(-[A-Z]{2})?$', 'description': 'Optional BCP 47 language or language-region hint used for HTTP content negotiation; it does not translate content.'}, 'output_mode': {'enum': ['clean_text', 'markdown', 'structured'], 'type': 'string', 'default': 'clean_text', 'description': 'Result representation: clean_text normalizes prose, markdown preserves document structure, and structured validates selected fields against buyer_schema.'}, 'buyer_schema': {'type': 'object', 'maxDepth': 5, 'description': 'Optional JSON Schema governing structured output; meaningful only with output_mode structured and bounded to fifty properties and depth five.', 'maxProperties': 50, 'additionalProperties': True}, 'max_redirects': {'type': 'integer', 'default': 5, 'maximum': 10, 'minimum': 0, 'description': 'Maximum redirect hops from 0 through 10 when the selected redirect policy follows redirects.'}, 'retrieval_mode': {'enum': ['direct', 'rendered'], 'type': 'string', 'description': 'Retrieval mode. Only direct (plain HTTP retrieval, no JavaScript execution) is available. rendered has a governed price but is not available: it is rejected with retrieval_mode_unavailable before any payment challenge and is never substituted with direct retrieval.'}, 'field_selectors': {'type': 'array', 'items': {'type': 'string', 'maxLength': 128}, 'maxItems': 30, 'description': 'Up to thirty requested field names for structured extraction; narrows the structured result rather than changing the fetched URL.'}, 'redirect_policy': {'enum': ['follow', 'follow_first', 'manual'], 'type': 'string', 'default': 'follow', 'description': 'Redirect handling: follow permits the bounded chain, follow_first permits only the first hop, and manual returns redirect evidence without following.'}, 'max_content_size': {'type': 'integer', 'default': 1048576, 'maximum': 10485760, 'minimum': 1024, 'description': 'Maximum returned content size in bytes, from 1,024 through 10,485,760; smaller limits truncate or reject oversized content sooner.'}, 'freshness_seconds': {'type': 'integer', 'default': 3600, 'maximum': 2592000, 'minimum': 0, 'description': 'Maximum acceptable cached-content age in seconds, from 0 through 2,592,000; zero requests uncached content.'}, 'maximum_authorized_price': {'type': 'object', 'title': 'Decimal Money', 'examples': [{'amount': '0.039', 'currency': 'USD'}, {'asset': 'USDC', 'amount': '0.19', 'network': 'base-mainnet', 'currency': 'USD'}], 'required': ['amount', 'currency'], 'properties': {'asset': {'type': 'string', 'pattern': '^[A-Z0-9]{3,10}$', 'description': "Payment asset identifier (e.g., 'USDC', 'ETH'). Optional for non-payment contexts."}, 'amount': {'type': 'string', 'pattern': '^(0|[1-9][0-9]*)(\\.[0-9]{1,18})?$', 'examples': ['0', '0.009', '0.012', '0.019', '0.029', '0.039', '0.049', '0.19'], 'description': "Canonical decimal string. No scientific notation, no leading zeros (except single '0'), no trailing zeros unless significant, no sign. Maximum 18 decimal places."}, 'network': {'type': 'string', 'pattern': '^[a-z0-9-]+$', 'maxLength': 64, 'description': "Payment network identifier (e.g., 'base-mainnet', 'base-sepolia'). Optional for non-payment contexts."}, 'currency': {'enum': ['USD'], 'type': 'string', 'default': 'USD', 'pattern': '^[A-Z]{3}$', 'description': 'ISO 4217 currency code.'}, 'precision': {'type': 'integer', 'default': 6, 'maximum': 18, 'minimum': 0, 'description': 'Maximum decimal places supported by the asset/network. Metadata only.'}}, 'description': 'Buyerâ\x80\x99s decimal-safe maximum authorized price; constrains the payment requirement and never changes retrieval scope.', 'additionalProperties': False}, 'minimum_verification_score': {'type': 'number', 'default': 0.7, 'maximum': 1, 'minimum': 0, 'description': 'Required PCC verification ratio from 0 through 1; raising it makes evidence acceptance stricter.'}}, 'description': 'Input schema for web_context_verified.v1 service. Supports direct and rendered retrieval modes.', 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['result'], 'properties': {'result': {'$id': 'https://utility.siteborne.net/contracts/3.0.0/schemas/services/web-context-output.schema.json', '$defs': {'pcc': {'type': 'object', 'title': 'Proof-Carrying Context (PCC) v2.0.0', 'required': ['pcc_version', 'job_id', 'contract', 'subject', 'claims', 'evidence', 'completeness', 'provenance', 'verification', 'receipt'], 'properties': {'claims': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/claim'}, 'uniqueItems': True}, 'job_id': {'$ref': '#/$defs/pcc/definitions/job_id'}, 'receipt': {'$ref': '#/$defs/pcc/definitions/receipt'}, 'subject': {'$ref': '#/$defs/pcc/definitions/subject'}, 'contract': {'$ref': '#/$defs/pcc/definitions/contract'}, 'evidence': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/evidence_item'}, 'uniqueItems': True}, 'extensions': {'allOf': [{'$ref': '#/$defs/pcc/definitions/extension_container'}, {'type': 'object', 'required': ['net.siteborne.verification-proof.v1'], 'properties': {'net.siteborne.verification-proof.v1': {'$ref': '#/$defs/pcc/definitions/verification_proof_v1'}}}]}, 'provenance': {'$ref': '#/$defs/pcc/definitions/provenance'}, 'pcc_version': {'$ref': '#/$defs/pcc/definitions/pcc_version'}, 'completeness': {'$ref': '#/$defs/pcc/definitions/completeness'}, 'verification': {'$ref': '#/$defs/pcc/definitions/verification'}}, 'definitions': {'hash': {'type': 'string', 'pattern': '^sha256:[a-f0-9]{64}$', 'description': 'SHA-256 hash with algorithm tag'}, 'claim': {'type': 'object', 'required': ['claim_id', 'predicate', 'value', 'confidence', 'evidence_ids', 'materiality', 'verification_status'], 'properties': {'value': {'type': ['string', 'number', 'boolean', 'object', 'array', 'null']}, 'claim_id': {'$ref': '#/$defs/pcc/definitions/claim_id'}, 'predicate': {'type': 'string', 'minLength': 1}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'materiality': {'$ref': '#/$defs/pcc/definitions/materiality'}, 'evidence_ids': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/evidence_id'}}, 'verification_status': {'$ref': '#/$defs/pcc/definitions/verification_status'}}, 'additionalProperties': False}, 'job_id': {'type': 'string', 'pattern': '^job_[a-z0-9]{24}$', 'description': 'Unique job identifier'}, 'key_id': {'type': 'string', 'pattern': '^kid_[a-z0-9]{24}$', 'description': 'Key identifier'}, 'locator': {'type': 'object', 'required': ['type', 'value'], 'properties': {'type': {'$ref': '#/$defs/pcc/definitions/locator_type'}, 'value': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'receipt': {'type': 'object', 'required': ['output_hash', 'canonicalization_algorithm', 'policy_hash', 'schema_hash', 'signature_algorithm', 'signing_key_id', 'signature', 'signed_at'], 'properties': {'signature': {'type': 'string', 'pattern': '^[A-Za-z0-9_-]{86,88}$'}, 'signed_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'output_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'policy_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'schema_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'signing_key_id': {'$ref': '#/$defs/pcc/definitions/key_id'}, 'signature_algorithm': {'$ref': '#/$defs/pcc/definitions/signature_algorithm'}, 'canonicalization_algorithm': {'$ref': '#/$defs/pcc/definitions/canonicalization_algorithm'}}, 'additionalProperties': False}, 'subject': {'type': 'object', 'required': ['type', 'canonical_name'], 'properties': {'type': {'$ref': '#/$defs/pcc/definitions/subject_type'}, 'identifiers': {'type': 'object', 'additionalProperties': {'type': 'string'}}, 'canonical_name': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'claim_id': {'type': 'string', 'pattern': '^clm_[a-z0-9]{24}$', 'description': 'Claim identifier'}, 'contract': {'type': 'object', 'required': ['service_id', 'service_version', 'input_hash', 'input_schema_hash', 'output_schema_hash', 'quote_id', 'mode', 'currency', 'minimum_quality', 'freshness_seconds', 'issued_at', 'expires_at', 'idempotency_key'], 'properties': {'mode': {'$ref': '#/$defs/pcc/definitions/contract_mode'}, 'price': {'$ref': '#/$defs/pcc/definitions/decimal_string'}, 'network': {'enum': ['base', 'base-testnet'], 'type': 'string'}, 'currency': {'$ref': '#/$defs/pcc/definitions/currency'}, 'quote_id': {'$ref': '#/$defs/pcc/definitions/quote_id'}, 'issued_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'expires_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'input_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'service_id': {'$ref': '#/$defs/pcc/definitions/service_id'}, 'idempotency_key': {'$ref': '#/$defs/pcc/definitions/idempotency_key'}, 'minimum_quality': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'service_version': {'$ref': '#/$defs/pcc/definitions/service_version'}, 'freshness_seconds': {'type': 'integer', 'minimum': 1}, 'input_schema_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'output_schema_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'maximum_authorized_price': {'$ref': '#/$defs/pcc/definitions/decimal_string'}}, 'additionalProperties': False}, 'currency': {'enum': ['USD', 'USDC'], 'type': 'string', 'description': 'Permitted currencies'}, 'quote_id': {'type': 'string', 'pattern': '^qte_[a-z0-9]{24}$', 'description': 'Quote identifier'}, 'policy_id': {'type': 'string', 'pattern': '^pol_[a-z0-9]{24}$', 'description': 'Policy identifier'}, 'provenance': {'type': 'object', 'required': ['routes', 'providers', 'tools', 'models', 'software_versions', 'policy_versions', 'transformations', 'cache_provenance', 'execution_environment', 'verification_routes'], 'properties': {'tools': {'type': 'object', 'description': 'Tool name to version mapping', 'additionalProperties': {'type': 'string'}}, 'models': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'version', 'provider'], 'properties': {'name': {'type': 'string', 'minLength': 1}, 'version': {'type': 'string', 'minLength': 1}, 'provider': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}}, 'routes': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/provenance_route'}}, 'providers': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'version', 'capabilities'], 'properties': {'name': {'type': 'string', 'minLength': 1}, 'version': {'type': 'string', 'minLength': 1}, 'capabilities': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}}, 'policy_versions': {'type': 'object', 'description': 'Policy name to version mapping', 'additionalProperties': {'type': 'string'}}, 'transformations': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/transformation'}}, 'cache_provenance': {'type': 'object', 'required': ['enabled', 'hit'], 'properties': {'hit': {'type': 'boolean'}, 'enabled': {'type': 'boolean'}, 'cache_key': {'type': 'string'}, 'stored_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}}, 'additionalProperties': False}, 'software_versions': {'type': 'object', 'description': 'Component name to version mapping', 'additionalProperties': {'type': 'string'}}, 'verification_routes': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/provenance_route'}}, 'execution_environment': {'type': 'object', 'required': ['runtime', 'version', 'platform'], 'properties': {'runtime': {'type': 'string', 'minLength': 1}, 'version': {'type': 'string', 'minLength': 1}, 'platform': {'type': 'string', 'minLength': 1}, 'container_image': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'service_id': {'enum': ['company_evidence_graph.v1', 'web_context_verified.v1', 'document_evidence_json.v1', 'verify_agent_output.v1', 'company_evidence_graph.v2', 'web_context_verified.v2', 'document_evidence_json.v2', 'verify_agent_output.v2', 'company_evidence_graph.v3', 'web_context_verified.v3', 'document_evidence_json.v3', 'verify_agent_output.v3'], 'type': 'string', 'description': 'Service identifier'}, 'evidence_id': {'type': 'string', 'pattern': '^evd_[a-z0-9]{24}$', 'description': 'Evidence identifier'}, 'materiality': {'enum': ['material', 'supporting', 'contextual'], 'type': 'string', 'description': 'Claim materiality classification'}, 'pcc_version': {'type': 'string', 'const': '2.0.0', 'description': 'PCC specification version'}, 'completeness': {'type': 'object', 'required': ['requested_fields', 'populated_fields', 'supported_fields', 'score', 'missing_fields', 'unsupported_fields', 'stale_fields', 'vector'], 'properties': {'score': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'vector': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/completeness_vector_entry'}}, 'stale_fields': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}}, 'missing_fields': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}}, 'populated_fields': {'type': 'integer', 'minimum': 0}, 'requested_fields': {'type': 'integer', 'minimum': 0}, 'supported_fields': {'type': 'integer', 'minimum': 0}, 'unsupported_fields': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}}}, 'additionalProperties': False}, 'locator_type': {'enum': ['json_pointer', 'xpath', 'css_selector', 'text_quote', 'page_region', 'byte_range', 'database_record', 'artifact_pointer'], 'type': 'string', 'description': 'Evidence locator type'}, 'subject_type': {'enum': ['organization', 'person', 'document', 'webpage', 'other'], 'type': 'string', 'description': 'Subject type'}, 'verification': {'type': 'object', 'required': ['schema_valid', 'material_claims_supported', 'evidence_accessibility', 'freshness', 'completeness', 'cross_source_agreement', 'provenance_valid', 'prompt_injection_result', 'deterministic_failures', 'verifier_versions', 'policy', 'decision', 'score', 'failed_requirements'], 'properties': {'score': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'policy': {'$ref': '#/$defs/pcc/definitions/policy_id'}, 'decision': {'$ref': '#/$defs/pcc/definitions/verification_decision'}, 'freshness': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'completeness': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'schema_valid': {'type': 'boolean'}, 'provenance_valid': {'type': 'boolean'}, 'verifier_versions': {'type': 'object', 'additionalProperties': {'type': 'string'}}, 'failed_requirements': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}}, 'cross_source_agreement': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'deterministic_failures': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}}, 'evidence_accessibility': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'prompt_injection_result': {'type': 'object', 'required': ['checked', 'result'], 'properties': {'result': {'enum': ['clean', 'suspected', 'confirmed'], 'type': 'string'}, 'checked': {'type': 'boolean'}, 'details': {'type': 'string'}}, 'additionalProperties': False}, 'material_claims_supported': {'type': 'boolean'}}, 'additionalProperties': False}, 'contract_mode': {'enum': ['paid', 'benchmark', 'offline_verification'], 'type': 'string', 'description': 'Contract mode determines required fields'}, 'evidence_item': {'type': 'object', 'required': ['evidence_id', 'source_uri', 'retrieved_at', 'content_hash', 'media_type', 'locator', 'accessibility_status', 'transformation_history', 'authorization_classification', 'freshness_status'], 'properties': {'locator': {'$ref': '#/$defs/pcc/definitions/locator'}, 'media_type': {'type': 'string', 'minLength': 1}, 'source_uri': {'type': 'string', 'format': 'uri', 'minLength': 1}, 'evidence_id': {'$ref': '#/$defs/pcc/definitions/evidence_id'}, 'content_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'retrieved_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'freshness_status': {'$ref': '#/$defs/pcc/definitions/freshness_status'}, 'source_timestamp': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'accessibility_status': {'$ref': '#/$defs/pcc/definitions/accessibility_status'}, 'transformation_history': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/transformation'}}, 'authorization_classification': {'$ref': '#/$defs/pcc/definitions/authorization_classification'}}, 'additionalProperties': False}, 'vnext_receipt': {'type': 'object', 'required': ['domain', 'proof_version', 'receipt_version', 'job_id', 'request_id', 'service_id', 'service_version', 'contract_release', 'pcc_schema_release', 'pcc_schema_hash', 'input_hash', 'output_schema_hash', 'output_hash', 'pcc_document_hash', 'evidence_hash', 'policy_hash', 'verifier_set_hash', 'decision', 'completeness', 'verification_mode', 'limitations', 'signing_key_id', 'canonicalization_algorithm', 'signature_algorithm', 'issued_at', 'receipt_id', 'signature'], 'properties': {'domain': {'type': 'string', 'const': 'SITEBORNE-PCC-VERIFICATION-PROOF-V1'}, 'job_id': {'$ref': '#/$defs/pcc/definitions/job_id'}, 'decision': {'$ref': '#/$defs/pcc/definitions/verification_decision'}, 'issued_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'signature': {'type': 'string', 'pattern': '^[A-Za-z0-9_-]{86}$'}, 'input_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'receipt_id': {'type': 'string', 'pattern': '^rcpt_[a-f0-9]{24}$'}, 'request_id': {'type': 'string', 'minLength': 1}, 'service_id': {'$ref': '#/$defs/pcc/definitions/service_id'}, 'limitations': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'maxItems': 200}, 'output_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'policy_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'completeness': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'evidence_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'proof_version': {'type': 'string', 'const': '1.0.0'}, 'signing_key_id': {'type': 'string', 'minLength': 1}, 'pcc_schema_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'receipt_version': {'type': 'string', 'const': '2.0.0'}, 'service_version': {'$ref': '#/$defs/pcc/definitions/service_version'}, 'contract_release': {'type': 'string', 'const': '3.0.0'}, 'pcc_document_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'verification_mode': {'enum': ['standard', 'independent_reproduction'], 'type': 'string'}, 'verifier_set_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'output_schema_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'pcc_schema_release': {'type': 'string', 'const': '2.0.0'}, 'signature_algorithm': {'type': 'string', 'const': 'Ed25519'}, 'canonicalization_algorithm': {'type': 'string', 'const': 'RFC8785-JCS'}}, 'additionalProperties': False}, 'decimal_string': {'type': 'string', 'pattern': '^(0|[1-9]\\d*)(\\.\\d+)?$', 'description': 'Non-negative decimal string, no scientific notation, no leading zeros except single zero'}, 'transformation': {'type': 'object', 'required': ['type', 'timestamp', 'tool_version'], 'properties': {'type': {'type': 'string', 'minLength': 1}, 'timestamp': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'parameters': {'type': 'object', 'additionalProperties': True}, 'tool_version': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'extension_value': {'type': 'object', 'description': 'Bounded JSON data payload for a single namespaced extension (PCC 1.0.1). Must be a JSON object; unbounded, executable, or policy-changing structures are out of scope for structural validation. Individual services may further narrow this shape for their own namespace via allOf composition.', 'maxProperties': 200, 'additionalProperties': True}, 'idempotency_key': {'type': 'string', 'pattern': '^idk_[a-z0-9]{24}$', 'description': 'Idempotency key'}, 'service_version': {'type': 'string', 'pattern': '^v\\d+(\\.\\d+)*$', 'description': 'Service version'}, 'freshness_status': {'enum': ['fresh', 'stale', 'unknown'], 'type': 'string', 'description': 'Evidence freshness status'}, 'provenance_route': {'type': 'object', 'required': ['type', 'provider', 'version'], 'properties': {'type': {'enum': ['cache', 'direct', 'deterministic', 'model', 'hybrid'], 'type': 'string'}, 'version': {'type': 'string', 'minLength': 1}, 'provider': {'type': 'string', 'minLength': 1}, 'model_name': {'type': 'string'}, 'parameters': {'type': 'object', 'additionalProperties': True}, 'model_version': {'type': 'string'}}, 'additionalProperties': False}, 'timestamp_rfc3339': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?Z$', 'description': 'RFC 3339 UTC timestamp with Z suffix, normalized fractional seconds'}, 'extension_container': {'type': 'object', 'description': 'Controlled extension container. Keys must use reverse-domain qualified namespaces with at least three DNS-safe labels (e.g., net.siteborne.verification.v1, com.example.custom-metrics.v1). Underscores, leading/trailing hyphens, empty labels, and uppercase are forbidden. Maximum 10 extensions. Maximum total namespace key length: 253 characters. Each value must conform to extension_value (bounded JSON data).', 'maxProperties': 10, 'propertyNames': {'type': 'string', 'pattern': '^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?){2,}$', 'maxLength': 253, 'minLength': 5}, 'patternProperties': {'^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?){2,}$': {'$ref': '#/$defs/pcc/definitions/extension_value'}}, 'additionalProperties': False}, 'signature_algorithm': {'type': 'string', 'const': 'Ed25519', 'description': 'Signature algorithm'}, 'verification_status': {'enum': ['verified', 'unsupported', 'disputed', 'pending'], 'type': 'string', 'description': 'Claim verification status'}, 'accessibility_status': {'enum': ['accessible', 'unavailable', 'restricted', 'requires_authorization'], 'type': 'string', 'description': 'Evidence accessibility status'}, 'verification_decision': {'enum': ['pass', 'conditional', 'fail', 'quarantined'], 'type': 'string', 'description': 'Verification decision'}, 'verification_proof_v1': {'type': 'object', 'required': ['proof_version', 'receipt', 'verification_material'], 'properties': {'receipt': {'$ref': '#/$defs/pcc/definitions/vnext_receipt'}, 'proof_version': {'type': 'string', 'const': '1.0.0'}, 'verification_material': {'type': 'object', 'required': ['verifier_results'], 'properties': {'verifier_results': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/public_verifier_result'}, 'maxItems': 100}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'public_verifier_result': {'type': 'object', 'required': ['verifier_id', 'status', 'findings', 'failure_codes'], 'properties': {'status': {'type': 'string', 'minLength': 1}, 'findings': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'severity'], 'properties': {'code': {'type': 'string', 'minLength': 1}, 'severity': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'maxItems': 200}, 'verifier_id': {'type': 'string', 'minLength': 1}, 'failure_codes': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'maxItems': 200}}, 'additionalProperties': False}, 'vnext_receipt_preimage': {'type': 'object', 'required': ['domain', 'proof_version', 'receipt_version', 'job_id', 'request_id', 'service_id', 'service_version', 'contract_release', 'pcc_schema_release', 'pcc_schema_hash', 'input_hash', 'output_schema_hash', 'output_hash', 'pcc_document_hash', 'evidence_hash', 'policy_hash', 'verifier_set_hash', 'decision', 'completeness', 'verification_mode', 'limitations', 'signing_key_id', 'canonicalization_algorithm', 'signature_algorithm', 'issued_at'], 'properties': {'domain': {'type': 'string', 'const': 'SITEBORNE-PCC-VERIFICATION-PROOF-V1'}, 'job_id': {'$ref': '#/$defs/pcc/definitions/job_id'}, 'decision': {'$ref': '#/$defs/pcc/definitions/verification_decision'}, 'issued_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'input_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'request_id': {'type': 'string', 'minLength': 1}, 'service_id': {'$ref': '#/$defs/pcc/definitions/service_id'}, 'limitations': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'maxItems': 200}, 'output_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'policy_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'completeness': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'evidence_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'proof_version': {'type': 'string', 'const': '1.0.0'}, 'signing_key_id': {'type': 'string', 'minLength': 1}, 'pcc_schema_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'receipt_version': {'type': 'string', 'const': '2.0.0'}, 'service_version': {'$ref': '#/$defs/pcc/definitions/service_version'}, 'contract_release': {'type': 'string', 'const': '3.0.0'}, 'pcc_document_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'verification_mode': {'enum': ['standard', 'independent_reproduction'], 'type': 'string'}, 'verifier_set_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'output_schema_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'pcc_schema_release': {'type': 'string', 'const': '2.0.0'}, 'signature_algorithm': {'type': 'string', 'const': 'Ed25519'}, 'canonicalization_algorithm': {'type': 'string', 'const': 'RFC8785-JCS'}}, 'additionalProperties': False}, 'completeness_vector_entry': {'type': 'object', 'required': ['dimension', 'requested', 'populated', 'supported', 'score'], 'properties': {'score': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'dimension': {'type': 'string', 'minLength': 1}, 'populated': {'type': 'integer', 'minimum': 0}, 'requested': {'type': 'integer', 'minimum': 0}, 'supported': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, 'canonicalization_algorithm': {'type': 'string', 'const': 'RFC8785-JCS', 'description': 'Canonicalization algorithm'}, 'authorization_classification': {'enum': ['public', 'buyer_authorized', 'restricted', 'confidential'], 'type': 'string', 'description': 'Evidence authorization classification'}}, 'description': 'Normative PCC 2.0.0 candidate. Requires a governed, reconstructible self-verifying receipt proof at extensions["net.siteborne.verification-proof.v1"]. The full PCC is the successful result root.', 'pcc_version': '2.0.0', 'additionalProperties': False}, 'money': {'type': 'object', 'title': 'Decimal Money', 'examples': [{'amount': '0.039', 'currency': 'USD'}, {'asset': 'USDC', 'amount': '0.19', 'network': 'base-mainnet', 'currency': 'USD'}], 'required': ['amount', 'currency'], 'properties': {'asset': {'type': 'string', 'pattern': '^[A-Z0-9]{3,10}$', 'description': "Payment asset identifier (e.g., 'USDC', 'ETH'). Optional for non-payment contexts."}, 'amount': {'type': 'string', 'pattern': '^(0|[1-9][0-9]*)(\\.[0-9]{1,18})?$', 'examples': ['0', '0.009', '0.012', '0.019', '0.029', '0.039', '0.049', '0.19'], 'description': "Canonical decimal string. No scientific notation, no leading zeros (except single '0'), no trailing zeros unless significant, no sign. Maximum 18 decimal places."}, 'network': {'type': 'string', 'pattern': '^[a-z0-9-]+$', 'maxLength': 64, 'description': "Payment network identifier (e.g., 'base-mainnet', 'base-sepolia'). Optional for non-payment contexts."}, 'currency': {'enum': ['USD'], 'type': 'string', 'default': 'USD', 'pattern': '^[A-Z]{3}$', 'description': 'ISO 4217 currency code.'}, 'precision': {'type': 'integer', 'default': 6, 'maximum': 18, 'minimum': 0, 'description': 'Maximum decimal places supported by the asset/network. Metadata only.'}}, 'description': 'Canonical decimal-safe money representation. No binary floating-point. Amount is a canonical decimal string.', 'additionalProperties': False}}, 'allOf': [{'$ref': '#/$defs/pcc'}, {'type': 'object', 'required': ['contract', 'extensions'], 'properties': {'contract': {'type': 'object', 'required': ['service_id', 'service_version', 'output_schema_hash'], 'properties': {'service_id': {'enum': ['web_context_verified.v3']}, 'service_version': {'enum': ['v3']}, 'output_schema_hash': {'type': 'string', 'pattern': '^sha256:[a-f0-9]{64}$'}}}, 'extensions': {'type': 'object', 'required': ['net.siteborne.web-context.v1'], 'properties': {'net.siteborne.web-context.v1': {'type': 'object', 'properties': {'markdown': {'type': 'string', 'maxLength': 10485760, 'description': 'Markdown output when requested.'}, 'final_url': {'type': 'string', 'format': 'uri', 'description': 'Final URL after redirects.'}, 'byte_count': {'type': 'integer', 'minimum': 0}, 'limitations': {'type': 'array', 'items': {'type': 'string', 'maxLength': 256}, 'maxItems': 20}, 'source_hash': {'type': 'string', 'pattern': '^sha256:[a-f0-9]{64}$', 'description': 'Hash of raw source content.'}, 'cache_status': {'type': 'object', 'properties': {'hit': {'type': 'boolean'}, 'age_seconds': {'type': 'integer'}, 'freshness_seconds': {'type': 'integer'}}, 'additionalProperties': False}, 'content_hash': {'type': 'string', 'pattern': '^sha256:[a-f0-9]{64}$', 'description': 'Hash of processed output content.'}, 'http_metadata': {'type': 'object', 'properties': {'headers': {'type': 'object', 'additionalProperties': {'type': 'string'}}, 'status_code': {'type': 'integer', 'maximum': 599, 'minimum': 100}, 'content_type': {'type': 'string'}, 'content_length': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, 'requested_url': {'type': 'string', 'format': 'uri', 'description': 'Originally requested URL.'}, 'canonical_text': {'type': 'string', 'maxLength': 10485760, 'description': 'Clean text extraction.'}, 'redirect_chain': {'type': 'array', 'items': {'type': 'object', 'required': ['url', 'status_code'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'status_code': {'type': 'integer', 'maximum': 399, 'minimum': 300}}, 'additionalProperties': False}, 'maxItems': 10}, 'character_count': {'type': 'integer', 'minimum': 0}, 'structured_fields': {'type': 'object', 'description': 'Structured extraction when requested.', 'additionalProperties': True}, 'truncation_status': {'type': 'object', 'properties': {'truncated': {'type': 'boolean'}, 'original_bytes': {'type': 'integer', 'minimum': 0}, 'returned_bytes': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, 'rendering_metadata': {'type': 'object', 'properties': {'engine': {'type': 'string'}, 'version': {'type': 'string'}, 'load_time_ms': {'type': 'integer', 'minimum': 0}, 'network_requests': {'type': 'integer', 'minimum': 0}, 'scripts_executed': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, 'extraction_warnings': {'type': 'array', 'items': {'type': 'string', 'maxLength': 256}, 'maxItems': 20}, 'retrieval_freshness': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?Z$', 'description': 'Timestamp of content retrieval.'}, 'retrieval_mode_used': {'enum': ['direct', 'rendered'], 'type': 'string', 'description': 'Mode actually used (may differ if rendered unavailable).'}, 'content_classification': {'enum': ['article', 'landing', 'document', 'app', 'error', 'other'], 'type': 'string'}, 'retrieval_mode_requested': {'enum': ['direct', 'rendered'], 'type': 'string'}, 'prompt_injection_findings': {'type': 'array', 'items': {'type': 'object', 'properties': {'type': {'type': 'string'}, 'location': {'type': 'string'}, 'severity': {'enum': ['low', 'medium', 'high', 'critical'], 'type': 'string'}, 'evidence_id': {'type': 'string'}}, 'additionalProperties': False}, 'maxItems': 20}}, 'description': 'Web context extension payload.', 'additionalProperties': False}}, 'propertyNames': {'type': 'string', 'pattern': '^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?){2,}$', 'maxLength': 253, 'minLength': 5}}}}], 'title': 'Verified Web Context Output', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'description': 'Output schema for web_context_verified.v1 service. Must be a valid PCC 1.0.0 document with required net.siteborne.web-context.v1 extension. Governed candidate output for Service Contract 3.0.0 / PCC 2.0.0.'}}}
siteborne_verify_agent_output
Verify agent output
Evaluate a supplied agent output against explicit claims, deterministic requirements, a required JSON Schema, and optional evidence. Use when: the caller already has an output and needs a governed verification verdict. Do not use when: evidence must first be gathered from a company (use siteborne_build_company_evidence_graph), URL (use siteborne_retrieve_verified_web_context), or document (use siteborne_extract_document_evidence_json), or independent reproduction of the output is required (not available). Parameters: verification_mode must be standard; independent_reproduction is defined but unavailable and is rejected before any payment challenge, never downgraded to standard. required_schema must fit SITEBORNE JSON Schema Profile 1 or the request is rejected before payment; minimum_score sets the acceptance threshold; maximum_authorized_price only constrains payment and never relaxes verification policy. Behavior: closed-world: standard mode evaluates only the supplied claims, requirements, output and evidence with no outbound retrieval, and persists governed payment, audit, job and Workflow state; an unpaid request returns payment_required; a repeated identical request with the same payment is replay-protected and is not charged twice. The verification policy and verdict rules do not depend on price or maximum_authorized_price. This service is currently production-disabled and rejects execution. Economics: exact price of $0.017 USD per request in standard mode; the payment challenge requires that amount and the charge settles at exactly that amount. independent_reproduction mode has a governed price of $0.049 USD but is not available: it is rejected before any payment challenge and never substituted. Failure: an unsupported or oversized required_schema, schema-invalid input and unavailable modes are rejected before any payment challenge; a failed verification is a normal fail or conditional verdict, not an error. Returns: claim-level and deterministic-check results, an overall verification verdict, and PCC evidence—not newly gathered source content.
幂等
输入模式
{'$id': 'https://siteborne.net/schemas/services/agent-verification-input.schema.json', 'type': 'object', 'title': 'Agent Output Verification Input', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'examples': [{'required_schema': {'type': 'object', 'required': ['company'], 'properties': {'company': {'type': 'string'}}}, 'candidate_output': {'company': 'Acme Corp', 'confidence': 0.95}, 'verification_mode': 'standard', 'verification_contract': {'claims': [{'claim_id': 'claim_1', 'predicate': 'equals', 'materiality': 'material', 'expected_value': 'Acme Corp'}], 'deterministic_requirements': [{'check': 'schema_valid', 'requirement_id': 'req_1'}, {'check': 'evidence_resolves', 'requirement_id': 'req_2'}]}, 'maximum_authorized_price': {'amount': '0.019', 'currency': 'USD'}}], 'required': ['verification_contract', 'candidate_output', 'required_schema', 'verification_mode'], 'properties': {'minimum_score': {'type': 'number', 'default': 0.7, 'maximum': 1, 'minimum': 0, 'description': 'Minimum overall verification score from 0 through 1; raising it makes the final acceptance verdict stricter.'}, 'required_schema': {'type': 'object', 'description': 'JSON Schema the candidate output must satisfy; it constrains validation and cannot change SITEBORNE verifier policy.', 'additionalProperties': True}, 'candidate_output': {'type': 'object', 'maxDepth': 10, 'description': 'Agent-produced JSON object to evaluate, bounded to 200 properties and depth 10; it is evidence under test, not trusted policy.', 'maxProperties': 200, 'additionalProperties': True}, 'supplied_evidence': {'type': 'array', 'items': {'type': 'object', 'required': ['evidence_id', 'content', 'content_hash'], 'properties': {'content': {'type': 'object', 'description': 'JSON evidence content whose integrity must agree with content_hash; it is treated as untrusted input.', 'additionalProperties': True}, 'source_uri': {'type': 'string', 'format': 'uri', 'maxLength': 2048, 'description': 'Optional public source URI, up to 2,048 characters, identifying where the evidence was obtained.'}, 'evidence_id': {'type': 'string', 'maxLength': 64, 'description': 'Caller-stable evidence identifier up to 64 characters, used to connect claims to this evidence item.'}, 'content_hash': {'type': 'string', 'pattern': '^sha256:[a-f0-9]{64}$', 'description': 'Lowercase SHA-256 integrity identifier in sha256:<64 hex> form for the supplied content.'}, 'retrieved_at': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?Z$', 'description': 'Optional UTC retrieval timestamp in the schemaâ\x80\x99s RFC 3339 form, used by freshness checks.'}}, 'additionalProperties': False}, 'maxItems': 20, 'description': 'Up to twenty evidence objects supplied with the candidate output and bound to integrity hashes.'}, 'verification_mode': {'enum': ['standard', 'independent_reproduction'], 'type': 'string', 'description': 'Verification mode. Only standard (deterministic checks of the supplied material, no outbound retrieval) is available. independent_reproduction has a governed price but is not available: it is rejected with verification_mode_unavailable before any payment challenge and is never downgraded to standard.'}, 'verification_contract': {'type': 'object', 'required': ['claims', 'deterministic_requirements'], 'properties': {'claims': {'type': 'array', 'items': {'type': 'object', 'required': ['claim_id', 'predicate', 'expected_value'], 'properties': {'claim_id': {'type': 'string', 'maxLength': 64, 'description': 'Caller-stable claim identifier up to 64 characters, used to correlate the verdict for this claim.'}, 'predicate': {'enum': ['equals', 'contains', 'matches', 'greater_than', 'less_than', 'exists', 'not_exists'], 'type': 'string', 'description': 'Comparison operation applied to the candidate value: equality, containment, pattern, ordering, existence, or nonexistence.'}, 'tolerance': {'type': 'number', 'minimum': 0, 'description': 'Optional nonnegative numeric tolerance for comparisons where bounded deviation is acceptable.'}, 'materiality': {'enum': ['material', 'supporting', 'contextual'], 'type': 'string', 'default': 'material', 'description': 'Claim importanceâ\x80\x94material, supporting, or contextualâ\x80\x94which affects how the verdict weighs a failed claim.'}, 'expected_value': {'type': ['string', 'number', 'boolean', 'object', 'array', 'null'], 'description': 'Expected JSON value interpreted by the selected predicate; its shape should match the claim being tested.'}}, 'additionalProperties': False}, 'maxItems': 50, 'description': 'Up to fifty expected claims; each binds a stable claim identifier to a predicate, expected value, and optional tolerance/materiality.'}, 'deterministic_requirements': {'type': 'array', 'items': {'type': 'object', 'required': ['requirement_id', 'check'], 'properties': {'check': {'enum': ['schema_valid', 'hash_match', 'signature_valid', 'evidence_resolves', 'no_pii', 'no_secrets'], 'type': 'string', 'description': 'Closed deterministic check to run: schema, hash, signature, evidence resolution, PII absence, or secret absence.'}, 'parameters': {'type': 'object', 'description': 'Check-specific configuration interpreted only by the selected deterministic check; it cannot modify verifier policy.', 'additionalProperties': True}, 'requirement_id': {'type': 'string', 'maxLength': 64, 'description': 'Caller-stable requirement identifier up to 64 characters, used to correlate the deterministic check result.'}}, 'additionalProperties': False}, 'maxItems': 30, 'description': 'Up to thirty deterministic checks for schema, hashes, signatures, evidence resolution, PII, or secrets.'}}, 'description': 'Complete set of claims and deterministic checks against which the supplied candidate output is evaluated.', 'additionalProperties': False}, 'freshness_requirements': {'type': 'object', 'properties': {'schema_max_age_seconds': {'type': 'integer', 'maximum': 2592000, 'minimum': 0, 'description': 'Maximum schema age in seconds from 0 through 2,592,000; older schemas fail freshness requirements.'}, 'evidence_max_age_seconds': {'type': 'integer', 'maximum': 2592000, 'minimum': 0, 'description': 'Maximum evidence age in seconds from 0 through 2,592,000; older evidence fails freshness requirements.'}}, 'description': 'Optional maximum-age limits for evidence and schemas, each expressed in seconds.', 'additionalProperties': False}, 'allowed_evidence_sources': {'type': 'array', 'items': {'type': 'string', 'format': 'uri', 'maxLength': 2048}, 'maxItems': 10, 'description': 'Up to ten permitted evidence source URIs; evidence outside this allowlist cannot satisfy source restrictions.'}, 'maximum_authorized_price': {'type': 'object', 'title': 'Decimal Money', 'examples': [{'amount': '0.039', 'currency': 'USD'}, {'asset': 'USDC', 'amount': '0.19', 'network': 'base-mainnet', 'currency': 'USD'}], 'required': ['amount', 'currency'], 'properties': {'asset': {'type': 'string', 'pattern': '^[A-Z0-9]{3,10}$', 'description': "Payment asset identifier (e.g., 'USDC', 'ETH'). Optional for non-payment contexts."}, 'amount': {'type': 'string', 'pattern': '^(0|[1-9][0-9]*)(\\.[0-9]{1,18})?$', 'examples': ['0', '0.009', '0.012', '0.019', '0.029', '0.039', '0.049', '0.19'], 'description': "Canonical decimal string. No scientific notation, no leading zeros (except single '0'), no trailing zeros unless significant, no sign. Maximum 18 decimal places."}, 'network': {'type': 'string', 'pattern': '^[a-z0-9-]+$', 'maxLength': 64, 'description': "Payment network identifier (e.g., 'base-mainnet', 'base-sepolia'). Optional for non-payment contexts."}, 'currency': {'enum': ['USD'], 'type': 'string', 'default': 'USD', 'pattern': '^[A-Z]{3}$', 'description': 'ISO 4217 currency code.'}, 'precision': {'type': 'integer', 'default': 6, 'maximum': 18, 'minimum': 0, 'description': 'Maximum decimal places supported by the asset/network. Metadata only.'}}, 'description': 'Buyerâ\x80\x99s decimal-safe maximum authorized price; constrains the payment requirement and never relaxes verification policy.', 'additionalProperties': False}}, 'description': 'Input schema for verify_agent_output.v1 service. Supports standard and independent reproduction modes.', 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['result'], 'properties': {'result': {'$id': 'https://siteborne.net/schemas/services/agent-verification-output.schema.json', '$defs': {'pcc': {'type': 'object', 'title': 'Proof-Carrying Context (PCC) v1.0.0', 'required': ['pcc_version', 'job_id', 'contract', 'subject', 'claims', 'evidence', 'completeness', 'provenance', 'verification', 'receipt'], 'properties': {'claims': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/claim'}, 'uniqueItems': True}, 'job_id': {'$ref': '#/$defs/pcc/definitions/job_id'}, 'receipt': {'$ref': '#/$defs/pcc/definitions/receipt'}, 'subject': {'$ref': '#/$defs/pcc/definitions/subject'}, 'contract': {'$ref': '#/$defs/pcc/definitions/contract'}, 'evidence': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/evidence_item'}, 'uniqueItems': True}, 'extensions': {'$ref': '#/$defs/pcc/definitions/extension_container'}, 'provenance': {'$ref': '#/$defs/pcc/definitions/provenance'}, 'pcc_version': {'$ref': '#/$defs/pcc/definitions/pcc_version'}, 'completeness': {'$ref': '#/$defs/pcc/definitions/completeness'}, 'verification': {'$ref': '#/$defs/pcc/definitions/verification'}}, 'definitions': {'hash': {'type': 'string', 'pattern': '^sha256:[a-f0-9]{64}$', 'description': 'SHA-256 hash with algorithm tag'}, 'claim': {'type': 'object', 'required': ['claim_id', 'predicate', 'value', 'confidence', 'evidence_ids', 'materiality', 'verification_status'], 'properties': {'value': {'type': ['string', 'number', 'boolean', 'object', 'array', 'null']}, 'claim_id': {'$ref': '#/$defs/pcc/definitions/claim_id'}, 'predicate': {'type': 'string', 'minLength': 1}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'materiality': {'$ref': '#/$defs/pcc/definitions/materiality'}, 'evidence_ids': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/evidence_id'}}, 'verification_status': {'$ref': '#/$defs/pcc/definitions/verification_status'}}, 'additionalProperties': False}, 'job_id': {'type': 'string', 'pattern': '^job_[a-z0-9]{24}$', 'description': 'Unique job identifier'}, 'key_id': {'type': 'string', 'pattern': '^kid_[a-z0-9]{24}$', 'description': 'Key identifier'}, 'locator': {'type': 'object', 'required': ['type', 'value'], 'properties': {'type': {'$ref': '#/$defs/pcc/definitions/locator_type'}, 'value': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'receipt': {'type': 'object', 'required': ['output_hash', 'canonicalization_algorithm', 'policy_hash', 'schema_hash', 'signature_algorithm', 'signing_key_id', 'signature', 'signed_at'], 'properties': {'signature': {'type': 'string', 'pattern': '^[A-Za-z0-9_-]{86,88}$'}, 'signed_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'output_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'policy_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'schema_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'signing_key_id': {'$ref': '#/$defs/pcc/definitions/key_id'}, 'signature_algorithm': {'$ref': '#/$defs/pcc/definitions/signature_algorithm'}, 'canonicalization_algorithm': {'$ref': '#/$defs/pcc/definitions/canonicalization_algorithm'}}, 'additionalProperties': False}, 'subject': {'type': 'object', 'required': ['type', 'canonical_name'], 'properties': {'type': {'$ref': '#/$defs/pcc/definitions/subject_type'}, 'identifiers': {'type': 'object', 'additionalProperties': {'type': 'string'}}, 'canonical_name': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'claim_id': {'type': 'string', 'pattern': '^clm_[a-z0-9]{24}$', 'description': 'Claim identifier'}, 'contract': {'type': 'object', 'required': ['service_id', 'service_version', 'input_hash', 'input_schema_hash', 'output_schema_hash', 'quote_id', 'mode', 'currency', 'minimum_quality', 'freshness_seconds', 'issued_at', 'expires_at', 'idempotency_key'], 'properties': {'mode': {'$ref': '#/$defs/pcc/definitions/contract_mode'}, 'price': {'$ref': '#/$defs/pcc/definitions/decimal_string'}, 'network': {'enum': ['base', 'base-testnet'], 'type': 'string'}, 'currency': {'$ref': '#/$defs/pcc/definitions/currency'}, 'quote_id': {'$ref': '#/$defs/pcc/definitions/quote_id'}, 'issued_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'expires_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'input_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'service_id': {'$ref': '#/$defs/pcc/definitions/service_id'}, 'idempotency_key': {'$ref': '#/$defs/pcc/definitions/idempotency_key'}, 'minimum_quality': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'service_version': {'$ref': '#/$defs/pcc/definitions/service_version'}, 'freshness_seconds': {'type': 'integer', 'minimum': 1}, 'input_schema_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'output_schema_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'maximum_authorized_price': {'$ref': '#/$defs/pcc/definitions/decimal_string'}}, 'additionalProperties': False}, 'currency': {'enum': ['USD', 'USDC'], 'type': 'string', 'description': 'Permitted currencies'}, 'quote_id': {'type': 'string', 'pattern': '^qte_[a-z0-9]{24}$', 'description': 'Quote identifier'}, 'policy_id': {'type': 'string', 'pattern': '^pol_[a-z0-9]{24}$', 'description': 'Policy identifier'}, 'provenance': {'type': 'object', 'required': ['routes', 'providers', 'tools', 'models', 'software_versions', 'policy_versions', 'transformations', 'cache_provenance', 'execution_environment', 'verification_routes'], 'properties': {'tools': {'type': 'object', 'description': 'Tool name to version mapping', 'additionalProperties': {'type': 'string'}}, 'models': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'version', 'provider'], 'properties': {'name': {'type': 'string', 'minLength': 1}, 'version': {'type': 'string', 'minLength': 1}, 'provider': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}}, 'routes': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/provenance_route'}}, 'providers': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'version', 'capabilities'], 'properties': {'name': {'type': 'string', 'minLength': 1}, 'version': {'type': 'string', 'minLength': 1}, 'capabilities': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}}, 'policy_versions': {'type': 'object', 'description': 'Policy name to version mapping', 'additionalProperties': {'type': 'string'}}, 'transformations': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/transformation'}}, 'cache_provenance': {'type': 'object', 'required': ['enabled', 'hit'], 'properties': {'hit': {'type': 'boolean'}, 'enabled': {'type': 'boolean'}, 'cache_key': {'type': 'string'}, 'stored_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}}, 'additionalProperties': False}, 'software_versions': {'type': 'object', 'description': 'Component name to version mapping', 'additionalProperties': {'type': 'string'}}, 'verification_routes': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/provenance_route'}}, 'execution_environment': {'type': 'object', 'required': ['runtime', 'version', 'platform'], 'properties': {'runtime': {'type': 'string', 'minLength': 1}, 'version': {'type': 'string', 'minLength': 1}, 'platform': {'type': 'string', 'minLength': 1}, 'container_image': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'service_id': {'enum': ['company_evidence_graph.v1', 'web_context_verified.v1', 'document_evidence_json.v1', 'verify_agent_output.v1', 'company_evidence_graph.v2', 'web_context_verified.v2', 'document_evidence_json.v2', 'verify_agent_output.v2'], 'type': 'string', 'description': 'Service identifier'}, 'evidence_id': {'type': 'string', 'pattern': '^evd_[a-z0-9]{24}$', 'description': 'Evidence identifier'}, 'materiality': {'enum': ['material', 'supporting', 'contextual'], 'type': 'string', 'description': 'Claim materiality classification'}, 'pcc_version': {'type': 'string', 'const': '1.0.0', 'description': 'PCC specification version'}, 'completeness': {'type': 'object', 'required': ['requested_fields', 'populated_fields', 'supported_fields', 'score', 'missing_fields', 'unsupported_fields', 'stale_fields', 'vector'], 'properties': {'score': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'vector': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/completeness_vector_entry'}}, 'stale_fields': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}}, 'missing_fields': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}}, 'populated_fields': {'type': 'integer', 'minimum': 0}, 'requested_fields': {'type': 'integer', 'minimum': 0}, 'supported_fields': {'type': 'integer', 'minimum': 0}, 'unsupported_fields': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}}}, 'additionalProperties': False}, 'locator_type': {'enum': ['json_pointer', 'xpath', 'css_selector', 'text_quote', 'page_region', 'byte_range', 'database_record', 'artifact_pointer'], 'type': 'string', 'description': 'Evidence locator type'}, 'subject_type': {'enum': ['organization', 'person', 'document', 'webpage', 'other'], 'type': 'string', 'description': 'Subject type'}, 'verification': {'type': 'object', 'required': ['schema_valid', 'material_claims_supported', 'evidence_accessibility', 'freshness', 'completeness', 'cross_source_agreement', 'provenance_valid', 'prompt_injection_result', 'deterministic_failures', 'verifier_versions', 'policy', 'decision', 'score', 'failed_requirements'], 'properties': {'score': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'policy': {'$ref': '#/$defs/pcc/definitions/policy_id'}, 'decision': {'$ref': '#/$defs/pcc/definitions/verification_decision'}, 'freshness': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'completeness': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'schema_valid': {'type': 'boolean'}, 'provenance_valid': {'type': 'boolean'}, 'verifier_versions': {'type': 'object', 'additionalProperties': {'type': 'string'}}, 'failed_requirements': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}}, 'cross_source_agreement': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'deterministic_failures': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}}, 'evidence_accessibility': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'prompt_injection_result': {'type': 'object', 'required': ['checked', 'result'], 'properties': {'result': {'enum': ['clean', 'suspected', 'confirmed'], 'type': 'string'}, 'checked': {'type': 'boolean'}, 'details': {'type': 'string'}}, 'additionalProperties': False}, 'material_claims_supported': {'type': 'boolean'}}, 'additionalProperties': False}, 'contract_mode': {'enum': ['paid', 'benchmark', 'offline_verification'], 'type': 'string', 'description': 'Contract mode determines required fields'}, 'evidence_item': {'type': 'object', 'required': ['evidence_id', 'source_uri', 'retrieved_at', 'content_hash', 'media_type', 'locator', 'accessibility_status', 'transformation_history', 'authorization_classification', 'freshness_status'], 'properties': {'locator': {'$ref': '#/$defs/pcc/definitions/locator'}, 'media_type': {'type': 'string', 'minLength': 1}, 'source_uri': {'type': 'string', 'format': 'uri', 'minLength': 1}, 'evidence_id': {'$ref': '#/$defs/pcc/definitions/evidence_id'}, 'content_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'retrieved_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'freshness_status': {'$ref': '#/$defs/pcc/definitions/freshness_status'}, 'source_timestamp': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'accessibility_status': {'$ref': '#/$defs/pcc/definitions/accessibility_status'}, 'transformation_history': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/transformation'}}, 'authorization_classification': {'$ref': '#/$defs/pcc/definitions/authorization_classification'}}, 'additionalProperties': False}, 'decimal_string': {'type': 'string', 'pattern': '^(0|[1-9]\\d*)(\\.\\d+)?$', 'description': 'Non-negative decimal string, no scientific notation, no leading zeros except single zero'}, 'transformation': {'type': 'object', 'required': ['type', 'timestamp', 'tool_version'], 'properties': {'type': {'type': 'string', 'minLength': 1}, 'timestamp': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'parameters': {'type': 'object', 'additionalProperties': True}, 'tool_version': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'extension_value': {'type': 'object', 'description': 'Bounded JSON data payload for a single namespaced extension (PCC 1.0.1). Must be a JSON object; unbounded, executable, or policy-changing structures are out of scope for structural validation. Individual services may further narrow this shape for their own namespace via allOf composition.', 'maxProperties': 200, 'additionalProperties': True}, 'idempotency_key': {'type': 'string', 'pattern': '^idk_[a-z0-9]{24}$', 'description': 'Idempotency key'}, 'service_version': {'type': 'string', 'pattern': '^v\\d+(\\.\\d+)*$', 'description': 'Service version'}, 'freshness_status': {'enum': ['fresh', 'stale', 'unknown'], 'type': 'string', 'description': 'Evidence freshness status'}, 'provenance_route': {'type': 'object', 'required': ['type', 'provider', 'version'], 'properties': {'type': {'enum': ['cache', 'direct', 'deterministic', 'model', 'hybrid'], 'type': 'string'}, 'version': {'type': 'string', 'minLength': 1}, 'provider': {'type': 'string', 'minLength': 1}, 'model_name': {'type': 'string'}, 'parameters': {'type': 'object', 'additionalProperties': True}, 'model_version': {'type': 'string'}}, 'additionalProperties': False}, 'timestamp_rfc3339': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?Z$', 'description': 'RFC 3339 UTC timestamp with Z suffix, normalized fractional seconds'}, 'extension_container': {'type': 'object', 'description': 'Controlled extension container. Keys must use reverse-domain qualified namespaces with at least three DNS-safe labels (e.g., net.siteborne.verification.v1, com.example.custom-metrics.v1). Underscores, leading/trailing hyphens, empty labels, and uppercase are forbidden. Maximum 10 extensions. Maximum total namespace key length: 253 characters. Each value must conform to extension_value (bounded JSON data).', 'maxProperties': 10, 'propertyNames': {'type': 'string', 'pattern': '^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?){2,}$', 'maxLength': 253, 'minLength': 5}, 'patternProperties': {'^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?){2,}$': {'$ref': '#/$defs/pcc/definitions/extension_value'}}, 'additionalProperties': False}, 'signature_algorithm': {'type': 'string', 'const': 'Ed25519', 'description': 'Signature algorithm'}, 'verification_status': {'enum': ['verified', 'unsupported', 'disputed', 'pending'], 'type': 'string', 'description': 'Claim verification status'}, 'accessibility_status': {'enum': ['accessible', 'unavailable', 'restricted', 'requires_authorization'], 'type': 'string', 'description': 'Evidence accessibility status'}, 'verification_decision': {'enum': ['pass', 'conditional', 'fail', 'quarantined'], 'type': 'string', 'description': 'Verification decision'}, 'completeness_vector_entry': {'type': 'object', 'required': ['dimension', 'requested', 'populated', 'supported', 'score'], 'properties': {'score': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'dimension': {'type': 'string', 'minLength': 1}, 'populated': {'type': 'integer', 'minimum': 0}, 'requested': {'type': 'integer', 'minimum': 0}, 'supported': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, 'canonicalization_algorithm': {'type': 'string', 'const': 'RFC8785-JCS', 'description': 'Canonicalization algorithm'}, 'authorization_classification': {'enum': ['public', 'buyer_authorized', 'restricted', 'confidential'], 'type': 'string', 'description': 'Evidence authorization classification'}}, 'description': 'Normative schema for Proof-Carrying Context 1.0.0. Frozen after compatibility validation passes. Schema patch 1.0.1 (SUN-0100 correction): extension_container now structurally permits qualified extension keys via patternProperties, matching documented semantics; pcc_version (document content compatibility) is unchanged at 1.0.0. Schema minor 1.1.0 (SUN-1000 checkpoint 1M): service_id enum gains 4 new .v2 members (additive-only per packages/pcc-schema/policy/COMPATIBILITY.md section 1/section 4, which explicitly classifies new enum values as minor-compatible -- not the docs/contracts/COMPATIBILITY_POLICY.md service-contract-release taxonomy, which does not govern this file); the 4 existing .v1 members are unchanged and remain valid; pcc_version is unchanged at 1.0.0.', 'pcc_version': '1.0.0', 'additionalProperties': False}, 'money': {'type': 'object', 'title': 'Decimal Money', 'examples': [{'amount': '0.039', 'currency': 'USD'}, {'asset': 'USDC', 'amount': '0.19', 'network': 'base-mainnet', 'currency': 'USD'}], 'required': ['amount', 'currency'], 'properties': {'asset': {'type': 'string', 'pattern': '^[A-Z0-9]{3,10}$', 'description': "Payment asset identifier (e.g., 'USDC', 'ETH'). Optional for non-payment contexts."}, 'amount': {'type': 'string', 'pattern': '^(0|[1-9][0-9]*)(\\.[0-9]{1,18})?$', 'examples': ['0', '0.009', '0.012', '0.019', '0.029', '0.039', '0.049', '0.19'], 'description': "Canonical decimal string. No scientific notation, no leading zeros (except single '0'), no trailing zeros unless significant, no sign. Maximum 18 decimal places."}, 'network': {'type': 'string', 'pattern': '^[a-z0-9-]+$', 'maxLength': 64, 'description': "Payment network identifier (e.g., 'base-mainnet', 'base-sepolia'). Optional for non-payment contexts."}, 'currency': {'enum': ['USD'], 'type': 'string', 'default': 'USD', 'pattern': '^[A-Z]{3}$', 'description': 'ISO 4217 currency code.'}, 'precision': {'type': 'integer', 'default': 6, 'maximum': 18, 'minimum': 0, 'description': 'Maximum decimal places supported by the asset/network. Metadata only.'}}, 'description': 'Canonical decimal-safe money representation. No binary floating-point. Amount is a canonical decimal string.', 'additionalProperties': False}}, 'allOf': [{'$ref': '#/$defs/pcc'}, {'type': 'object', 'required': ['contract', 'extensions'], 'properties': {'contract': {'type': 'object', 'required': ['service_id', 'service_version', 'output_schema_hash'], 'properties': {'service_id': {'enum': ['verify_agent_output.v1', 'verify_agent_output.v2']}, 'service_version': {'enum': ['v1', 'v2']}, 'output_schema_hash': {'type': 'string', 'pattern': '^sha256:[a-f0-9]{64}$'}}}, 'extensions': {'type': 'object', 'required': ['net.siteborne.agent-verification.v1'], 'properties': {'net.siteborne.agent-verification.v1': {'type': 'object', 'properties': {'score': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'outcome': {'enum': ['pass', 'fail', 'conditional'], 'type': 'string'}, 'limitations': {'type': 'array', 'items': {'type': 'string', 'maxLength': 256}, 'maxItems': 20}, 'schema_result': {'type': 'object', 'required': ['valid'], 'properties': {'valid': {'type': 'boolean'}, 'errors': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}, 'policy_version': {'type': 'string', 'pattern': '^v[0-9]+(\\.[0-9]+)*$'}, 'evidence_result': {'type': 'object', 'required': ['resolved', 'unresolved_count'], 'properties': {'resolved': {'type': 'boolean'}, 'resolved_count': {'type': 'integer', 'minimum': 0}, 'unresolved_ids': {'type': 'array', 'items': {'type': 'string'}}, 'unresolved_count': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, 'verification_mode': {'enum': ['standard', 'independent_reproduction'], 'type': 'string'}, 'failed_requirements': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 50}, 'reproduction_result': {'type': 'object', 'properties': {'reproduced': {'type': 'boolean'}, 'differences': {'type': 'array', 'items': {'type': 'object', 'properties': {'path': {'type': 'string'}, 'candidate_value': {'type': ['string', 'number', 'boolean', 'null']}, 'reproduced_value': {'type': ['string', 'number', 'boolean', 'null']}}, 'additionalProperties': False}, 'maxItems': 20}, 'agreement_score': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'reproduction_output_hash': {'type': 'string', 'pattern': '^sha256:[a-f0-9]{64}$'}}, 'description': 'Present only for independent_reproduction mode.', 'additionalProperties': False}, 'requirement_results': {'type': 'array', 'items': {'type': 'object', 'required': ['requirement_id', 'passed'], 'properties': {'passed': {'type': 'boolean'}, 'details': {'type': 'string'}, 'evidence_ids': {'type': 'array', 'items': {'type': 'string'}}, 'requirement_id': {'type': 'string'}}, 'additionalProperties': False}, 'maxItems': 50}, 'claim_support_result': {'type': 'object', 'required': ['supported', 'unsupported_count'], 'properties': {'supported': {'type': 'boolean'}, 'supported_count': {'type': 'integer', 'minimum': 0}, 'conflicting_count': {'type': 'integer', 'minimum': 0}, 'unsupported_count': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, 'candidate_output_hash': {'type': 'string', 'pattern': '^sha256:[a-f0-9]{64}$'}, 'verifier_classes_used': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 10}, 'deterministic_failures': {'type': 'array', 'items': {'type': 'object', 'required': ['requirement_id', 'reason'], 'properties': {'reason': {'type': 'string'}, 'blocks_pass': {'type': 'boolean', 'const': True}, 'requirement_id': {'type': 'string'}}, 'additionalProperties': False}, 'maxItems': 20}, 'unverifiable_assertions': {'type': 'array', 'items': {'type': 'object', 'properties': {'reason': {'type': 'string'}, 'claim_id': {'type': 'string'}}, 'additionalProperties': False}, 'maxItems': 20}, 'reproduction_output_hash': {'type': 'string', 'pattern': '^sha256:[a-f0-9]{64}$', 'description': 'Present only for independent_reproduction mode.'}, 'reproduction_agreement_score': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Present only for independent_reproduction mode.'}}, 'description': 'Agent verification extension payload.', 'additionalProperties': False}}, 'propertyNames': {'type': 'string', 'pattern': '^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?){2,}$', 'maxLength': 253, 'minLength': 5}}}}], 'title': 'Agent Output Verification Output', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'examples': [{'claims': [], 'job_id': 'job_aaaaaaaaaaaaaaaaaaaaaaaa', 'receipt': {'signature': 'AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA', 'signed_at': '2026-08-05T10:00:00Z', 'output_hash': 'sha256:eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee', 'policy_hash': 'sha256:ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff', 'schema_hash': 'sha256:0000000000000000000000000000000000000000000000000000000000000000', 'signing_key_id': 'kid_aaaaaaaaaaaaaaaaaaaaaaaa', 'signature_algorithm': 'Ed25519', 'canonicalization_algorithm': 'RFC8785-JCS'}, 'subject': {'type': 'organization', 'identifiers': {'domain': 'acme.example.com'}, 'canonical_name': 'Acme Example Corp'}, 'contract': {'mode': 'paid', 'currency': 'USD', 'quote_id': 'qte_aaaaaaaaaaaaaaaaaaaaaaaa', 'issued_at': '2026-08-05T10:00:00Z', 'expires_at': '2026-08-06T10:00:00Z', 'input_hash': 'sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa', 'service_id': 'verify_agent_output.v1', 'idempotency_key': 'idk_aaaaaaaaaaaaaaaaaaaaaaaa', 'minimum_quality': 0.8, 'service_version': 'v1', 'freshness_seconds': 3600, 'input_schema_hash': 'sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb', 'output_schema_hash': 'sha256:abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890'}, 'evidence': [], 'extensions': {'net.siteborne.agent-verification.v1': {'score': 0.92, 'outcome': 'pass', 'schema_result': {'valid': True, 'errors': []}, 'policy_version': 'v1', 'evidence_result': {'resolved': True, 'resolved_count': 2, 'unresolved_count': 0}, 'verification_mode': 'standard', 'requirement_results': [{'passed': True, 'evidence_ids': ['evd_1'], 'requirement_id': 'req_1'}, {'passed': True, 'evidence_ids': ['evd_2'], 'requirement_id': 'req_2'}], 'claim_support_result': {'supported': True, 'supported_count': 1, 'unsupported_count': 0}, 'candidate_output_hash': 'sha256:abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890', 'verifier_classes_used': ['schema_validator', 'evidence_resolver']}}, 'provenance': {'tools': {'curl': '8.0.0'}, 'models': [], 'routes': [{'type': 'direct', 'version': '1.0.0', 'provider': 'web'}], 'providers': [{'name': 'web', 'version': '1.0.0', 'capabilities': ['fetch']}], 'policy_versions': {'verification': '1.0.0'}, 'transformations': [], 'cache_provenance': {'hit': False, 'enabled': False}, 'software_versions': {'pcc': '1.0.0'}, 'verification_routes': [], 'execution_environment': {'runtime': 'node', 'version': '22.0.0', 'platform': 'linux'}}, 'pcc_version': '1.0.0', 'completeness': {'score': 0.8, 'vector': [{'score': 0.8, 'dimension': 'general', 'populated': 4, 'requested': 5, 'supported': 4}], 'stale_fields': [], 'missing_fields': ['ceo_name'], 'populated_fields': 4, 'requested_fields': 5, 'supported_fields': 4, 'unsupported_fields': []}, 'verification': {'score': 0.9, 'policy': 'pol_aaaaaaaaaaaaaaaaaaaaaaaa', 'decision': 'pass', 'freshness': 1, 'completeness': 0.8, 'schema_valid': True, 'provenance_valid': True, 'verifier_versions': {'pcc': '1.0.0'}, 'failed_requirements': [], 'cross_source_agreement': 1, 'deterministic_failures': [], 'evidence_accessibility': 1, 'prompt_injection_result': {'result': 'clean', 'checked': True}, 'material_claims_supported': True}}], 'description': 'Output schema for verify_agent_output.v1 service. Must be a valid PCC 1.0.0 document with required net.siteborne.agent-verification.v1 extension.'}}}
siteborne_verify_agent_output_v3_candidate
Verify agent output (v3 candidate)
Evaluate a supplied agent output against explicit claims, deterministic requirements, a required JSON Schema, and optional evidence. Use when: the caller already has an output and needs a governed verification verdict. Do not use when: evidence must first be gathered from a company (use siteborne_build_company_evidence_graph), URL (use siteborne_retrieve_verified_web_context), or document (use siteborne_extract_document_evidence_json), or independent reproduction of the output is required (not available). Parameters: verification_mode must be standard; independent_reproduction is defined but unavailable and is rejected before any payment challenge, never downgraded to standard. required_schema must fit SITEBORNE JSON Schema Profile 1 or the request is rejected before payment; minimum_score sets the acceptance threshold; maximum_authorized_price only constrains payment and never relaxes verification policy. Behavior: closed-world: standard mode evaluates only the supplied claims, requirements, output and evidence with no outbound retrieval, and persists governed payment, audit, job and Workflow state; an unpaid request returns payment_required; a repeated identical request with the same payment is replay-protected and is not charged twice. The verification policy and verdict rules do not depend on price or maximum_authorized_price. This service is currently production-disabled and rejects execution. Economics: exact price of $0.017 USD per request in standard mode; the payment challenge requires that amount and the charge settles at exactly that amount. independent_reproduction mode has a governed price of $0.049 USD but is not available: it is rejected before any payment challenge and never substituted. Failure: an unsupported or oversized required_schema, schema-invalid input and unavailable modes are rejected before any payment challenge; a failed verification is a normal fail or conditional verdict, not an error. Returns: claim-level and deterministic-check results, an overall verification verdict, and PCC evidence—not newly gathered source content.
幂等
输入模式
{'$id': 'https://siteborne.net/schemas/services/agent-verification-input.schema.json', 'type': 'object', 'title': 'Agent Output Verification Input', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'examples': [{'required_schema': {'type': 'object', 'required': ['company'], 'properties': {'company': {'type': 'string'}}}, 'candidate_output': {'company': 'Acme Corp', 'confidence': 0.95}, 'verification_mode': 'standard', 'verification_contract': {'claims': [{'claim_id': 'claim_1', 'predicate': 'equals', 'materiality': 'material', 'expected_value': 'Acme Corp'}], 'deterministic_requirements': [{'check': 'schema_valid', 'requirement_id': 'req_1'}, {'check': 'evidence_resolves', 'requirement_id': 'req_2'}]}, 'maximum_authorized_price': {'amount': '0.019', 'currency': 'USD'}}], 'required': ['verification_contract', 'candidate_output', 'required_schema', 'verification_mode'], 'properties': {'minimum_score': {'type': 'number', 'default': 0.7, 'maximum': 1, 'minimum': 0, 'description': 'Minimum overall verification score from 0 through 1; raising it makes the final acceptance verdict stricter.'}, 'required_schema': {'type': 'object', 'description': 'JSON Schema the candidate output must satisfy; it constrains validation and cannot change SITEBORNE verifier policy.', 'additionalProperties': True}, 'candidate_output': {'type': 'object', 'maxDepth': 10, 'description': 'Agent-produced JSON object to evaluate, bounded to 200 properties and depth 10; it is evidence under test, not trusted policy.', 'maxProperties': 200, 'additionalProperties': True}, 'supplied_evidence': {'type': 'array', 'items': {'type': 'object', 'required': ['evidence_id', 'content', 'content_hash'], 'properties': {'content': {'type': 'object', 'description': 'JSON evidence content whose integrity must agree with content_hash; it is treated as untrusted input.', 'additionalProperties': True}, 'source_uri': {'type': 'string', 'format': 'uri', 'maxLength': 2048, 'description': 'Optional public source URI, up to 2,048 characters, identifying where the evidence was obtained.'}, 'evidence_id': {'type': 'string', 'maxLength': 64, 'description': 'Caller-stable evidence identifier up to 64 characters, used to connect claims to this evidence item.'}, 'content_hash': {'type': 'string', 'pattern': '^sha256:[a-f0-9]{64}$', 'description': 'Lowercase SHA-256 integrity identifier in sha256:<64 hex> form for the supplied content.'}, 'retrieved_at': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?Z$', 'description': 'Optional UTC retrieval timestamp in the schemaâ\x80\x99s RFC 3339 form, used by freshness checks.'}}, 'additionalProperties': False}, 'maxItems': 20, 'description': 'Up to twenty evidence objects supplied with the candidate output and bound to integrity hashes.'}, 'verification_mode': {'enum': ['standard', 'independent_reproduction'], 'type': 'string', 'description': 'Verification mode. Only standard (deterministic checks of the supplied material, no outbound retrieval) is available. independent_reproduction has a governed price but is not available: it is rejected with verification_mode_unavailable before any payment challenge and is never downgraded to standard.'}, 'verification_contract': {'type': 'object', 'required': ['claims', 'deterministic_requirements'], 'properties': {'claims': {'type': 'array', 'items': {'type': 'object', 'required': ['claim_id', 'predicate', 'expected_value'], 'properties': {'claim_id': {'type': 'string', 'maxLength': 64, 'description': 'Caller-stable claim identifier up to 64 characters, used to correlate the verdict for this claim.'}, 'predicate': {'enum': ['equals', 'contains', 'matches', 'greater_than', 'less_than', 'exists', 'not_exists'], 'type': 'string', 'description': 'Comparison operation applied to the candidate value: equality, containment, pattern, ordering, existence, or nonexistence.'}, 'tolerance': {'type': 'number', 'minimum': 0, 'description': 'Optional nonnegative numeric tolerance for comparisons where bounded deviation is acceptable.'}, 'materiality': {'enum': ['material', 'supporting', 'contextual'], 'type': 'string', 'default': 'material', 'description': 'Claim importanceâ\x80\x94material, supporting, or contextualâ\x80\x94which affects how the verdict weighs a failed claim.'}, 'expected_value': {'type': ['string', 'number', 'boolean', 'object', 'array', 'null'], 'description': 'Expected JSON value interpreted by the selected predicate; its shape should match the claim being tested.'}}, 'additionalProperties': False}, 'maxItems': 50, 'description': 'Up to fifty expected claims; each binds a stable claim identifier to a predicate, expected value, and optional tolerance/materiality.'}, 'deterministic_requirements': {'type': 'array', 'items': {'type': 'object', 'required': ['requirement_id', 'check'], 'properties': {'check': {'enum': ['schema_valid', 'hash_match', 'signature_valid', 'evidence_resolves', 'no_pii', 'no_secrets'], 'type': 'string', 'description': 'Closed deterministic check to run: schema, hash, signature, evidence resolution, PII absence, or secret absence.'}, 'parameters': {'type': 'object', 'description': 'Check-specific configuration interpreted only by the selected deterministic check; it cannot modify verifier policy.', 'additionalProperties': True}, 'requirement_id': {'type': 'string', 'maxLength': 64, 'description': 'Caller-stable requirement identifier up to 64 characters, used to correlate the deterministic check result.'}}, 'additionalProperties': False}, 'maxItems': 30, 'description': 'Up to thirty deterministic checks for schema, hashes, signatures, evidence resolution, PII, or secrets.'}}, 'description': 'Complete set of claims and deterministic checks against which the supplied candidate output is evaluated.', 'additionalProperties': False}, 'freshness_requirements': {'type': 'object', 'properties': {'schema_max_age_seconds': {'type': 'integer', 'maximum': 2592000, 'minimum': 0, 'description': 'Maximum schema age in seconds from 0 through 2,592,000; older schemas fail freshness requirements.'}, 'evidence_max_age_seconds': {'type': 'integer', 'maximum': 2592000, 'minimum': 0, 'description': 'Maximum evidence age in seconds from 0 through 2,592,000; older evidence fails freshness requirements.'}}, 'description': 'Optional maximum-age limits for evidence and schemas, each expressed in seconds.', 'additionalProperties': False}, 'allowed_evidence_sources': {'type': 'array', 'items': {'type': 'string', 'format': 'uri', 'maxLength': 2048}, 'maxItems': 10, 'description': 'Up to ten permitted evidence source URIs; evidence outside this allowlist cannot satisfy source restrictions.'}, 'maximum_authorized_price': {'type': 'object', 'title': 'Decimal Money', 'examples': [{'amount': '0.039', 'currency': 'USD'}, {'asset': 'USDC', 'amount': '0.19', 'network': 'base-mainnet', 'currency': 'USD'}], 'required': ['amount', 'currency'], 'properties': {'asset': {'type': 'string', 'pattern': '^[A-Z0-9]{3,10}$', 'description': "Payment asset identifier (e.g., 'USDC', 'ETH'). Optional for non-payment contexts."}, 'amount': {'type': 'string', 'pattern': '^(0|[1-9][0-9]*)(\\.[0-9]{1,18})?$', 'examples': ['0', '0.009', '0.012', '0.019', '0.029', '0.039', '0.049', '0.19'], 'description': "Canonical decimal string. No scientific notation, no leading zeros (except single '0'), no trailing zeros unless significant, no sign. Maximum 18 decimal places."}, 'network': {'type': 'string', 'pattern': '^[a-z0-9-]+$', 'maxLength': 64, 'description': "Payment network identifier (e.g., 'base-mainnet', 'base-sepolia'). Optional for non-payment contexts."}, 'currency': {'enum': ['USD'], 'type': 'string', 'default': 'USD', 'pattern': '^[A-Z]{3}$', 'description': 'ISO 4217 currency code.'}, 'precision': {'type': 'integer', 'default': 6, 'maximum': 18, 'minimum': 0, 'description': 'Maximum decimal places supported by the asset/network. Metadata only.'}}, 'description': 'Buyerâ\x80\x99s decimal-safe maximum authorized price; constrains the payment requirement and never relaxes verification policy.', 'additionalProperties': False}}, 'description': 'Input schema for verify_agent_output.v1 service. Supports standard and independent reproduction modes.', 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['result'], 'properties': {'result': {'$id': 'https://utility.siteborne.net/contracts/3.0.0/schemas/services/agent-verification-output.schema.json', '$defs': {'pcc': {'type': 'object', 'title': 'Proof-Carrying Context (PCC) v2.0.0', 'required': ['pcc_version', 'job_id', 'contract', 'subject', 'claims', 'evidence', 'completeness', 'provenance', 'verification', 'receipt'], 'properties': {'claims': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/claim'}, 'uniqueItems': True}, 'job_id': {'$ref': '#/$defs/pcc/definitions/job_id'}, 'receipt': {'$ref': '#/$defs/pcc/definitions/receipt'}, 'subject': {'$ref': '#/$defs/pcc/definitions/subject'}, 'contract': {'$ref': '#/$defs/pcc/definitions/contract'}, 'evidence': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/evidence_item'}, 'uniqueItems': True}, 'extensions': {'allOf': [{'$ref': '#/$defs/pcc/definitions/extension_container'}, {'type': 'object', 'required': ['net.siteborne.verification-proof.v1'], 'properties': {'net.siteborne.verification-proof.v1': {'$ref': '#/$defs/pcc/definitions/verification_proof_v1'}}}]}, 'provenance': {'$ref': '#/$defs/pcc/definitions/provenance'}, 'pcc_version': {'$ref': '#/$defs/pcc/definitions/pcc_version'}, 'completeness': {'$ref': '#/$defs/pcc/definitions/completeness'}, 'verification': {'$ref': '#/$defs/pcc/definitions/verification'}}, 'definitions': {'hash': {'type': 'string', 'pattern': '^sha256:[a-f0-9]{64}$', 'description': 'SHA-256 hash with algorithm tag'}, 'claim': {'type': 'object', 'required': ['claim_id', 'predicate', 'value', 'confidence', 'evidence_ids', 'materiality', 'verification_status'], 'properties': {'value': {'type': ['string', 'number', 'boolean', 'object', 'array', 'null']}, 'claim_id': {'$ref': '#/$defs/pcc/definitions/claim_id'}, 'predicate': {'type': 'string', 'minLength': 1}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'materiality': {'$ref': '#/$defs/pcc/definitions/materiality'}, 'evidence_ids': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/evidence_id'}}, 'verification_status': {'$ref': '#/$defs/pcc/definitions/verification_status'}}, 'additionalProperties': False}, 'job_id': {'type': 'string', 'pattern': '^job_[a-z0-9]{24}$', 'description': 'Unique job identifier'}, 'key_id': {'type': 'string', 'pattern': '^kid_[a-z0-9]{24}$', 'description': 'Key identifier'}, 'locator': {'type': 'object', 'required': ['type', 'value'], 'properties': {'type': {'$ref': '#/$defs/pcc/definitions/locator_type'}, 'value': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'receipt': {'type': 'object', 'required': ['output_hash', 'canonicalization_algorithm', 'policy_hash', 'schema_hash', 'signature_algorithm', 'signing_key_id', 'signature', 'signed_at'], 'properties': {'signature': {'type': 'string', 'pattern': '^[A-Za-z0-9_-]{86,88}$'}, 'signed_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'output_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'policy_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'schema_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'signing_key_id': {'$ref': '#/$defs/pcc/definitions/key_id'}, 'signature_algorithm': {'$ref': '#/$defs/pcc/definitions/signature_algorithm'}, 'canonicalization_algorithm': {'$ref': '#/$defs/pcc/definitions/canonicalization_algorithm'}}, 'additionalProperties': False}, 'subject': {'type': 'object', 'required': ['type', 'canonical_name'], 'properties': {'type': {'$ref': '#/$defs/pcc/definitions/subject_type'}, 'identifiers': {'type': 'object', 'additionalProperties': {'type': 'string'}}, 'canonical_name': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'claim_id': {'type': 'string', 'pattern': '^clm_[a-z0-9]{24}$', 'description': 'Claim identifier'}, 'contract': {'type': 'object', 'required': ['service_id', 'service_version', 'input_hash', 'input_schema_hash', 'output_schema_hash', 'quote_id', 'mode', 'currency', 'minimum_quality', 'freshness_seconds', 'issued_at', 'expires_at', 'idempotency_key'], 'properties': {'mode': {'$ref': '#/$defs/pcc/definitions/contract_mode'}, 'price': {'$ref': '#/$defs/pcc/definitions/decimal_string'}, 'network': {'enum': ['base', 'base-testnet'], 'type': 'string'}, 'currency': {'$ref': '#/$defs/pcc/definitions/currency'}, 'quote_id': {'$ref': '#/$defs/pcc/definitions/quote_id'}, 'issued_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'expires_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'input_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'service_id': {'$ref': '#/$defs/pcc/definitions/service_id'}, 'idempotency_key': {'$ref': '#/$defs/pcc/definitions/idempotency_key'}, 'minimum_quality': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'service_version': {'$ref': '#/$defs/pcc/definitions/service_version'}, 'freshness_seconds': {'type': 'integer', 'minimum': 1}, 'input_schema_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'output_schema_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'maximum_authorized_price': {'$ref': '#/$defs/pcc/definitions/decimal_string'}}, 'additionalProperties': False}, 'currency': {'enum': ['USD', 'USDC'], 'type': 'string', 'description': 'Permitted currencies'}, 'quote_id': {'type': 'string', 'pattern': '^qte_[a-z0-9]{24}$', 'description': 'Quote identifier'}, 'policy_id': {'type': 'string', 'pattern': '^pol_[a-z0-9]{24}$', 'description': 'Policy identifier'}, 'provenance': {'type': 'object', 'required': ['routes', 'providers', 'tools', 'models', 'software_versions', 'policy_versions', 'transformations', 'cache_provenance', 'execution_environment', 'verification_routes'], 'properties': {'tools': {'type': 'object', 'description': 'Tool name to version mapping', 'additionalProperties': {'type': 'string'}}, 'models': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'version', 'provider'], 'properties': {'name': {'type': 'string', 'minLength': 1}, 'version': {'type': 'string', 'minLength': 1}, 'provider': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}}, 'routes': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/provenance_route'}}, 'providers': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'version', 'capabilities'], 'properties': {'name': {'type': 'string', 'minLength': 1}, 'version': {'type': 'string', 'minLength': 1}, 'capabilities': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}}, 'policy_versions': {'type': 'object', 'description': 'Policy name to version mapping', 'additionalProperties': {'type': 'string'}}, 'transformations': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/transformation'}}, 'cache_provenance': {'type': 'object', 'required': ['enabled', 'hit'], 'properties': {'hit': {'type': 'boolean'}, 'enabled': {'type': 'boolean'}, 'cache_key': {'type': 'string'}, 'stored_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}}, 'additionalProperties': False}, 'software_versions': {'type': 'object', 'description': 'Component name to version mapping', 'additionalProperties': {'type': 'string'}}, 'verification_routes': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/provenance_route'}}, 'execution_environment': {'type': 'object', 'required': ['runtime', 'version', 'platform'], 'properties': {'runtime': {'type': 'string', 'minLength': 1}, 'version': {'type': 'string', 'minLength': 1}, 'platform': {'type': 'string', 'minLength': 1}, 'container_image': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'service_id': {'enum': ['company_evidence_graph.v1', 'web_context_verified.v1', 'document_evidence_json.v1', 'verify_agent_output.v1', 'company_evidence_graph.v2', 'web_context_verified.v2', 'document_evidence_json.v2', 'verify_agent_output.v2', 'company_evidence_graph.v3', 'web_context_verified.v3', 'document_evidence_json.v3', 'verify_agent_output.v3'], 'type': 'string', 'description': 'Service identifier'}, 'evidence_id': {'type': 'string', 'pattern': '^evd_[a-z0-9]{24}$', 'description': 'Evidence identifier'}, 'materiality': {'enum': ['material', 'supporting', 'contextual'], 'type': 'string', 'description': 'Claim materiality classification'}, 'pcc_version': {'type': 'string', 'const': '2.0.0', 'description': 'PCC specification version'}, 'completeness': {'type': 'object', 'required': ['requested_fields', 'populated_fields', 'supported_fields', 'score', 'missing_fields', 'unsupported_fields', 'stale_fields', 'vector'], 'properties': {'score': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'vector': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/completeness_vector_entry'}}, 'stale_fields': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}}, 'missing_fields': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}}, 'populated_fields': {'type': 'integer', 'minimum': 0}, 'requested_fields': {'type': 'integer', 'minimum': 0}, 'supported_fields': {'type': 'integer', 'minimum': 0}, 'unsupported_fields': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}}}, 'additionalProperties': False}, 'locator_type': {'enum': ['json_pointer', 'xpath', 'css_selector', 'text_quote', 'page_region', 'byte_range', 'database_record', 'artifact_pointer'], 'type': 'string', 'description': 'Evidence locator type'}, 'subject_type': {'enum': ['organization', 'person', 'document', 'webpage', 'other'], 'type': 'string', 'description': 'Subject type'}, 'verification': {'type': 'object', 'required': ['schema_valid', 'material_claims_supported', 'evidence_accessibility', 'freshness', 'completeness', 'cross_source_agreement', 'provenance_valid', 'prompt_injection_result', 'deterministic_failures', 'verifier_versions', 'policy', 'decision', 'score', 'failed_requirements'], 'properties': {'score': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'policy': {'$ref': '#/$defs/pcc/definitions/policy_id'}, 'decision': {'$ref': '#/$defs/pcc/definitions/verification_decision'}, 'freshness': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'completeness': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'schema_valid': {'type': 'boolean'}, 'provenance_valid': {'type': 'boolean'}, 'verifier_versions': {'type': 'object', 'additionalProperties': {'type': 'string'}}, 'failed_requirements': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}}, 'cross_source_agreement': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'deterministic_failures': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}}, 'evidence_accessibility': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'prompt_injection_result': {'type': 'object', 'required': ['checked', 'result'], 'properties': {'result': {'enum': ['clean', 'suspected', 'confirmed'], 'type': 'string'}, 'checked': {'type': 'boolean'}, 'details': {'type': 'string'}}, 'additionalProperties': False}, 'material_claims_supported': {'type': 'boolean'}}, 'additionalProperties': False}, 'contract_mode': {'enum': ['paid', 'benchmark', 'offline_verification'], 'type': 'string', 'description': 'Contract mode determines required fields'}, 'evidence_item': {'type': 'object', 'required': ['evidence_id', 'source_uri', 'retrieved_at', 'content_hash', 'media_type', 'locator', 'accessibility_status', 'transformation_history', 'authorization_classification', 'freshness_status'], 'properties': {'locator': {'$ref': '#/$defs/pcc/definitions/locator'}, 'media_type': {'type': 'string', 'minLength': 1}, 'source_uri': {'type': 'string', 'format': 'uri', 'minLength': 1}, 'evidence_id': {'$ref': '#/$defs/pcc/definitions/evidence_id'}, 'content_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'retrieved_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'freshness_status': {'$ref': '#/$defs/pcc/definitions/freshness_status'}, 'source_timestamp': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'accessibility_status': {'$ref': '#/$defs/pcc/definitions/accessibility_status'}, 'transformation_history': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/transformation'}}, 'authorization_classification': {'$ref': '#/$defs/pcc/definitions/authorization_classification'}}, 'additionalProperties': False}, 'vnext_receipt': {'type': 'object', 'required': ['domain', 'proof_version', 'receipt_version', 'job_id', 'request_id', 'service_id', 'service_version', 'contract_release', 'pcc_schema_release', 'pcc_schema_hash', 'input_hash', 'output_schema_hash', 'output_hash', 'pcc_document_hash', 'evidence_hash', 'policy_hash', 'verifier_set_hash', 'decision', 'completeness', 'verification_mode', 'limitations', 'signing_key_id', 'canonicalization_algorithm', 'signature_algorithm', 'issued_at', 'receipt_id', 'signature'], 'properties': {'domain': {'type': 'string', 'const': 'SITEBORNE-PCC-VERIFICATION-PROOF-V1'}, 'job_id': {'$ref': '#/$defs/pcc/definitions/job_id'}, 'decision': {'$ref': '#/$defs/pcc/definitions/verification_decision'}, 'issued_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'signature': {'type': 'string', 'pattern': '^[A-Za-z0-9_-]{86}$'}, 'input_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'receipt_id': {'type': 'string', 'pattern': '^rcpt_[a-f0-9]{24}$'}, 'request_id': {'type': 'string', 'minLength': 1}, 'service_id': {'$ref': '#/$defs/pcc/definitions/service_id'}, 'limitations': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'maxItems': 200}, 'output_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'policy_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'completeness': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'evidence_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'proof_version': {'type': 'string', 'const': '1.0.0'}, 'signing_key_id': {'type': 'string', 'minLength': 1}, 'pcc_schema_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'receipt_version': {'type': 'string', 'const': '2.0.0'}, 'service_version': {'$ref': '#/$defs/pcc/definitions/service_version'}, 'contract_release': {'type': 'string', 'const': '3.0.0'}, 'pcc_document_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'verification_mode': {'enum': ['standard', 'independent_reproduction'], 'type': 'string'}, 'verifier_set_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'output_schema_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'pcc_schema_release': {'type': 'string', 'const': '2.0.0'}, 'signature_algorithm': {'type': 'string', 'const': 'Ed25519'}, 'canonicalization_algorithm': {'type': 'string', 'const': 'RFC8785-JCS'}}, 'additionalProperties': False}, 'decimal_string': {'type': 'string', 'pattern': '^(0|[1-9]\\d*)(\\.\\d+)?$', 'description': 'Non-negative decimal string, no scientific notation, no leading zeros except single zero'}, 'transformation': {'type': 'object', 'required': ['type', 'timestamp', 'tool_version'], 'properties': {'type': {'type': 'string', 'minLength': 1}, 'timestamp': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'parameters': {'type': 'object', 'additionalProperties': True}, 'tool_version': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'extension_value': {'type': 'object', 'description': 'Bounded JSON data payload for a single namespaced extension (PCC 1.0.1). Must be a JSON object; unbounded, executable, or policy-changing structures are out of scope for structural validation. Individual services may further narrow this shape for their own namespace via allOf composition.', 'maxProperties': 200, 'additionalProperties': True}, 'idempotency_key': {'type': 'string', 'pattern': '^idk_[a-z0-9]{24}$', 'description': 'Idempotency key'}, 'service_version': {'type': 'string', 'pattern': '^v\\d+(\\.\\d+)*$', 'description': 'Service version'}, 'freshness_status': {'enum': ['fresh', 'stale', 'unknown'], 'type': 'string', 'description': 'Evidence freshness status'}, 'provenance_route': {'type': 'object', 'required': ['type', 'provider', 'version'], 'properties': {'type': {'enum': ['cache', 'direct', 'deterministic', 'model', 'hybrid'], 'type': 'string'}, 'version': {'type': 'string', 'minLength': 1}, 'provider': {'type': 'string', 'minLength': 1}, 'model_name': {'type': 'string'}, 'parameters': {'type': 'object', 'additionalProperties': True}, 'model_version': {'type': 'string'}}, 'additionalProperties': False}, 'timestamp_rfc3339': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?Z$', 'description': 'RFC 3339 UTC timestamp with Z suffix, normalized fractional seconds'}, 'extension_container': {'type': 'object', 'description': 'Controlled extension container. Keys must use reverse-domain qualified namespaces with at least three DNS-safe labels (e.g., net.siteborne.verification.v1, com.example.custom-metrics.v1). Underscores, leading/trailing hyphens, empty labels, and uppercase are forbidden. Maximum 10 extensions. Maximum total namespace key length: 253 characters. Each value must conform to extension_value (bounded JSON data).', 'maxProperties': 10, 'propertyNames': {'type': 'string', 'pattern': '^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?){2,}$', 'maxLength': 253, 'minLength': 5}, 'patternProperties': {'^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?){2,}$': {'$ref': '#/$defs/pcc/definitions/extension_value'}}, 'additionalProperties': False}, 'signature_algorithm': {'type': 'string', 'const': 'Ed25519', 'description': 'Signature algorithm'}, 'verification_status': {'enum': ['verified', 'unsupported', 'disputed', 'pending'], 'type': 'string', 'description': 'Claim verification status'}, 'accessibility_status': {'enum': ['accessible', 'unavailable', 'restricted', 'requires_authorization'], 'type': 'string', 'description': 'Evidence accessibility status'}, 'verification_decision': {'enum': ['pass', 'conditional', 'fail', 'quarantined'], 'type': 'string', 'description': 'Verification decision'}, 'verification_proof_v1': {'type': 'object', 'required': ['proof_version', 'receipt', 'verification_material'], 'properties': {'receipt': {'$ref': '#/$defs/pcc/definitions/vnext_receipt'}, 'proof_version': {'type': 'string', 'const': '1.0.0'}, 'verification_material': {'type': 'object', 'required': ['verifier_results'], 'properties': {'verifier_results': {'type': 'array', 'items': {'$ref': '#/$defs/pcc/definitions/public_verifier_result'}, 'maxItems': 100}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'public_verifier_result': {'type': 'object', 'required': ['verifier_id', 'status', 'findings', 'failure_codes'], 'properties': {'status': {'type': 'string', 'minLength': 1}, 'findings': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'severity'], 'properties': {'code': {'type': 'string', 'minLength': 1}, 'severity': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}, 'maxItems': 200}, 'verifier_id': {'type': 'string', 'minLength': 1}, 'failure_codes': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'maxItems': 200}}, 'additionalProperties': False}, 'vnext_receipt_preimage': {'type': 'object', 'required': ['domain', 'proof_version', 'receipt_version', 'job_id', 'request_id', 'service_id', 'service_version', 'contract_release', 'pcc_schema_release', 'pcc_schema_hash', 'input_hash', 'output_schema_hash', 'output_hash', 'pcc_document_hash', 'evidence_hash', 'policy_hash', 'verifier_set_hash', 'decision', 'completeness', 'verification_mode', 'limitations', 'signing_key_id', 'canonicalization_algorithm', 'signature_algorithm', 'issued_at'], 'properties': {'domain': {'type': 'string', 'const': 'SITEBORNE-PCC-VERIFICATION-PROOF-V1'}, 'job_id': {'$ref': '#/$defs/pcc/definitions/job_id'}, 'decision': {'$ref': '#/$defs/pcc/definitions/verification_decision'}, 'issued_at': {'$ref': '#/$defs/pcc/definitions/timestamp_rfc3339'}, 'input_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'request_id': {'type': 'string', 'minLength': 1}, 'service_id': {'$ref': '#/$defs/pcc/definitions/service_id'}, 'limitations': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'maxItems': 200}, 'output_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'policy_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'completeness': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'evidence_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'proof_version': {'type': 'string', 'const': '1.0.0'}, 'signing_key_id': {'type': 'string', 'minLength': 1}, 'pcc_schema_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'receipt_version': {'type': 'string', 'const': '2.0.0'}, 'service_version': {'$ref': '#/$defs/pcc/definitions/service_version'}, 'contract_release': {'type': 'string', 'const': '3.0.0'}, 'pcc_document_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'verification_mode': {'enum': ['standard', 'independent_reproduction'], 'type': 'string'}, 'verifier_set_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'output_schema_hash': {'$ref': '#/$defs/pcc/definitions/hash'}, 'pcc_schema_release': {'type': 'string', 'const': '2.0.0'}, 'signature_algorithm': {'type': 'string', 'const': 'Ed25519'}, 'canonicalization_algorithm': {'type': 'string', 'const': 'RFC8785-JCS'}}, 'additionalProperties': False}, 'completeness_vector_entry': {'type': 'object', 'required': ['dimension', 'requested', 'populated', 'supported', 'score'], 'properties': {'score': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'dimension': {'type': 'string', 'minLength': 1}, 'populated': {'type': 'integer', 'minimum': 0}, 'requested': {'type': 'integer', 'minimum': 0}, 'supported': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, 'canonicalization_algorithm': {'type': 'string', 'const': 'RFC8785-JCS', 'description': 'Canonicalization algorithm'}, 'authorization_classification': {'enum': ['public', 'buyer_authorized', 'restricted', 'confidential'], 'type': 'string', 'description': 'Evidence authorization classification'}}, 'description': 'Normative PCC 2.0.0 candidate. Requires a governed, reconstructible self-verifying receipt proof at extensions["net.siteborne.verification-proof.v1"]. The full PCC is the successful result root.', 'pcc_version': '2.0.0', 'additionalProperties': False}, 'money': {'type': 'object', 'title': 'Decimal Money', 'examples': [{'amount': '0.039', 'currency': 'USD'}, {'asset': 'USDC', 'amount': '0.19', 'network': 'base-mainnet', 'currency': 'USD'}], 'required': ['amount', 'currency'], 'properties': {'asset': {'type': 'string', 'pattern': '^[A-Z0-9]{3,10}$', 'description': "Payment asset identifier (e.g., 'USDC', 'ETH'). Optional for non-payment contexts."}, 'amount': {'type': 'string', 'pattern': '^(0|[1-9][0-9]*)(\\.[0-9]{1,18})?$', 'examples': ['0', '0.009', '0.012', '0.019', '0.029', '0.039', '0.049', '0.19'], 'description': "Canonical decimal string. No scientific notation, no leading zeros (except single '0'), no trailing zeros unless significant, no sign. Maximum 18 decimal places."}, 'network': {'type': 'string', 'pattern': '^[a-z0-9-]+$', 'maxLength': 64, 'description': "Payment network identifier (e.g., 'base-mainnet', 'base-sepolia'). Optional for non-payment contexts."}, 'currency': {'enum': ['USD'], 'type': 'string', 'default': 'USD', 'pattern': '^[A-Z]{3}$', 'description': 'ISO 4217 currency code.'}, 'precision': {'type': 'integer', 'default': 6, 'maximum': 18, 'minimum': 0, 'description': 'Maximum decimal places supported by the asset/network. Metadata only.'}}, 'description': 'Canonical decimal-safe money representation. No binary floating-point. Amount is a canonical decimal string.', 'additionalProperties': False}}, 'allOf': [{'$ref': '#/$defs/pcc'}, {'type': 'object', 'required': ['contract', 'extensions'], 'properties': {'contract': {'type': 'object', 'required': ['service_id', 'service_version', 'output_schema_hash'], 'properties': {'service_id': {'enum': ['verify_agent_output.v3']}, 'service_version': {'enum': ['v3']}, 'output_schema_hash': {'type': 'string', 'pattern': '^sha256:[a-f0-9]{64}$'}}}, 'extensions': {'type': 'object', 'required': ['net.siteborne.agent-verification.v1'], 'properties': {'net.siteborne.agent-verification.v1': {'type': 'object', 'properties': {'score': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'outcome': {'enum': ['pass', 'fail', 'conditional'], 'type': 'string'}, 'limitations': {'type': 'array', 'items': {'type': 'string', 'maxLength': 256}, 'maxItems': 20}, 'schema_result': {'type': 'object', 'required': ['valid'], 'properties': {'valid': {'type': 'boolean'}, 'errors': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}, 'policy_version': {'type': 'string', 'pattern': '^v[0-9]+(\\.[0-9]+)*$'}, 'evidence_result': {'type': 'object', 'required': ['resolved', 'unresolved_count'], 'properties': {'resolved': {'type': 'boolean'}, 'resolved_count': {'type': 'integer', 'minimum': 0}, 'unresolved_ids': {'type': 'array', 'items': {'type': 'string'}}, 'unresolved_count': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, 'verification_mode': {'enum': ['standard', 'independent_reproduction'], 'type': 'string'}, 'failed_requirements': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 50}, 'reproduction_result': {'type': 'object', 'properties': {'reproduced': {'type': 'boolean'}, 'differences': {'type': 'array', 'items': {'type': 'object', 'properties': {'path': {'type': 'string'}, 'candidate_value': {'type': ['string', 'number', 'boolean', 'null']}, 'reproduced_value': {'type': ['string', 'number', 'boolean', 'null']}}, 'additionalProperties': False}, 'maxItems': 20}, 'agreement_score': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'reproduction_output_hash': {'type': 'string', 'pattern': '^sha256:[a-f0-9]{64}$'}}, 'description': 'Present only for independent_reproduction mode.', 'additionalProperties': False}, 'requirement_results': {'type': 'array', 'items': {'type': 'object', 'required': ['requirement_id', 'passed'], 'properties': {'passed': {'type': 'boolean'}, 'details': {'type': 'string'}, 'evidence_ids': {'type': 'array', 'items': {'type': 'string'}}, 'requirement_id': {'type': 'string'}}, 'additionalProperties': False}, 'maxItems': 50}, 'claim_support_result': {'type': 'object', 'required': ['supported', 'unsupported_count'], 'properties': {'supported': {'type': 'boolean'}, 'supported_count': {'type': 'integer', 'minimum': 0}, 'conflicting_count': {'type': 'integer', 'minimum': 0}, 'unsupported_count': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, 'candidate_output_hash': {'type': 'string', 'pattern': '^sha256:[a-f0-9]{64}$'}, 'verifier_classes_used': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 10}, 'deterministic_failures': {'type': 'array', 'items': {'type': 'object', 'required': ['requirement_id', 'reason'], 'properties': {'reason': {'type': 'string'}, 'blocks_pass': {'type': 'boolean', 'const': True}, 'requirement_id': {'type': 'string'}}, 'additionalProperties': False}, 'maxItems': 20}, 'unverifiable_assertions': {'type': 'array', 'items': {'type': 'object', 'properties': {'reason': {'type': 'string'}, 'claim_id': {'type': 'string'}}, 'additionalProperties': False}, 'maxItems': 20}, 'reproduction_output_hash': {'type': 'string', 'pattern': '^sha256:[a-f0-9]{64}$', 'description': 'Present only for independent_reproduction mode.'}, 'reproduction_agreement_score': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Present only for independent_reproduction mode.'}}, 'description': 'Agent verification extension payload.', 'additionalProperties': False}}, 'propertyNames': {'type': 'string', 'pattern': '^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?){2,}$', 'maxLength': 253, 'minLength': 5}}}}], 'title': 'Agent Output Verification Output', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'description': 'Output schema for verify_agent_output.v1 service. Must be a valid PCC 1.0.0 document with required net.siteborne.agent-verification.v1 extension. Governed candidate output for Service Contract 3.0.0 / PCC 2.0.0.'}}}
已更改
siteborne_get_service_health
2026年9月27日 02:50
已更改
siteborne_get_quote
2026年9月27日 02:50
已添加
siteborne_verify_agent_output_v3_candidate
2026年9月27日 02:50
已添加
siteborne_extract_document_evidence_json_v3_candidate
2026年9月27日 02:50
已添加
siteborne_retrieve_verified_web_context_v3_candidate
2026年9月27日 02:50
已添加
siteborne_build_company_evidence_graph_v3_candidate
2026年9月27日 02:50
已更改
siteborne_verify_agent_output
2026年9月27日 02:50
已更改
siteborne_retrieve_verified_web_context
2026年9月27日 02:50
已移除
siteborne_web_context_verified
2026年9月23日 02:50
已移除
siteborne_document_evidence_json
2026年9月23日 02:50
已移除
siteborne_company_evidence_graph
2026年9月23日 02:50
已更改
siteborne_get_quote
2026年9月23日 02:50
已更改
siteborne_verify_agent_output
2026年9月23日 02:50
已添加
siteborne_extract_document_evidence_json
2026年9月23日 02:50
已添加
siteborne_retrieve_verified_web_context
2026年9月23日 02:50
已添加
siteborne_build_company_evidence_graph
2026年9月23日 02:50
已更改
siteborne_get_service_health
2026年9月21日 02:57
已更改
siteborne_get_quote
2026年9月21日 02:57
已更改
siteborne_verify_agent_output
2026年9月21日 02:57
已更改
siteborne_document_evidence_json
2026年9月21日 02:57
已更改
siteborne_web_context_verified
2026年9月21日 02:57
已更改
siteborne_company_evidence_graph
2026年9月21日 02:57
已添加
siteborne_get_service_health
2026年9月17日 12:54
已添加
siteborne_get_quote
2026年9月17日 12:54
已添加
siteborne_verify_agent_output
2026年9月17日 12:54
已添加
siteborne_document_evidence_json
2026年9月17日 12:54
已添加
siteborne_web_context_verified
2026年9月17日 12:54
已添加
siteborne_company_evidence_graph
2026年9月17日 12:54