Server definition
- Hash
- sha256:c8883434173f7e11b1142431a32460ed37591c45e716d06fa7afa05b022e7003
- What it is
- What a remote MCP server returned when asked what it offers: 10 tools
The blob, as servednamed by its sha256
{
"instructions": null,
"tools": [
{
"description": "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.",
"inputSchema": {
"$id": "https://siteborne.net/schemas/services/company-evidence-input.schema.json",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"required": [
"company_name"
]
},
{
"required": [
"ticker"
]
},
{
"required": [
"domain"
]
},
{
"required": [
"identifiers"
]
}
],
"description": "Input schema for company_evidence_graph.v1 service. At least one identity signal is required.",
"examples": [
{
"company_name": "Acme Corporation",
"domain": "acme.example.com",
"freshness_seconds": 86400,
"minimum_verification_score": 0.7,
"requested_field_groups": [
"identity",
"sec_submissions",
"website_evidence"
]
}
],
"properties": {
"buyer_urls": {
"description": "Up to twenty public supplemental evidence URLs supplied by the buyer; these are additional sources, not replacements for entity resolution.",
"items": {
"format": "uri",
"maxLength": 2048,
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"company_name": {
"description": "Legal or commonly used company name; supplies an entity-resolution signal when authoritative identifiers are unavailable.",
"maxLength": 256,
"minLength": 1,
"type": "string"
},
"domain": {
"description": "Primary website hostname only, without a URL path; links first-party web evidence to the company identity.",
"format": "hostname",
"maxLength": 253,
"type": "string"
},
"freshness_seconds": {
"default": 86400,
"description": "Maximum acceptable source age in seconds, from 0 through 2,592,000; lower values demand fresher evidence.",
"maximum": 2592000,
"minimum": 0,
"type": "integer"
},
"identifiers": {
"additionalProperties": false,
"description": "Known authoritative entity identifiers; supplying precise identifiers reduces ambiguous name, ticker, or domain matching.",
"maxProperties": 10,
"properties": {
"cik": {
"description": "Exactly ten decimal digits identifying the company in SEC EDGAR.",
"pattern": "^[0-9]{10}$",
"type": "string"
},
"cusip": {
"description": "Nine-character CUSIP security identifier.",
"pattern": "^[A-Z0-9]{9}$",
"type": "string"
},
"exchange": {
"description": "Primary listing exchange name or code, up to sixteen characters; disambiguates reused ticker symbols.",
"maxLength": 16,
"type": "string"
},
"figi": {
"description": "Twelve-character OpenFIGI identifier beginning with BBG.",
"pattern": "^BBG[0-9A-Z]{9}$",
"type": "string"
},
"isin": {
"description": "Twelve-character International Securities Identification Number.",
"pattern": "^[A-Z]{2}[A-Z0-9]{9}[0-9]$",
"type": "string"
},
"lei": {
"description": "Exactly twenty uppercase alphanumeric characters for the Legal Entity Identifier.",
"pattern": "^[A-Z0-9]{20}$",
"type": "string"
},
"ticker_symbol": {
"description": "One-to-five uppercase characters for the primary listed ticker when it differs from ticker.",
"pattern": "^[A-Z]{1,5}$",
"type": "string"
}
},
"type": "object"
},
"jurisdiction_hints": {
"description": "Up to five two-letter uppercase jurisdiction codes used to focus regulatory context; hints do not assert incorporation.",
"items": {
"maxLength": 2,
"pattern": "^[A-Z]{2}$",
"type": "string"
},
"maxItems": 5,
"type": "array"
},
"maximum_authorized_price": {
"additionalProperties": false,
"description": "Buyer’s decimal-safe maximum authorized price; constrains the payment requirement and never expands provider scope.",
"examples": [
{
"amount": "0.039",
"currency": "USD"
},
{
"amount": "0.19",
"asset": "USDC",
"currency": "USD",
"network": "base-mainnet"
}
],
"properties": {
"amount": {
"description": "Canonical decimal string. No scientific notation, no leading zeros (except single '0'), no trailing zeros unless significant, no sign. Maximum 18 decimal places.",
"examples": [
"0",
"0.009",
"0.012",
"0.019",
"0.029",
"0.039",
"0.049",
"0.19"
],
"pattern": "^(0|[1-9][0-9]*)(\\.[0-9]{1,18})?$",
"type": "string"
},
"asset": {
"description": "Payment asset identifier (e.g., 'USDC', 'ETH'). Optional for non-payment contexts.",
"pattern": "^[A-Z0-9]{3,10}$",
"type": "string"
},
"currency": {
"default": "USD",
"description": "ISO 4217 currency code.",
"enum": [
"USD"
],
"pattern": "^[A-Z]{3}$",
"type": "string"
},
"network": {
"description": "Payment network identifier (e.g., 'base-mainnet', 'base-sepolia'). Optional for non-payment contexts.",
"maxLength": 64,
"pattern": "^[a-z0-9-]+$",
"type": "string"
},
"precision": {
"default": 6,
"description": "Maximum decimal places supported by the asset/network. Metadata only.",
"maximum": 18,
"minimum": 0,
"type": "integer"
}
},
"required": [
"amount",
"currency"
],
"title": "Decimal Money",
"type": "object"
},
"minimum_completeness": {
"default": 0.5,
"description": "Required completeness ratio from 0 through 1; results below this threshold fail the requested acceptance condition.",
"maximum": 1,
"minimum": 0,
"type": "number"
},
"minimum_verification_score": {
"default": 0.7,
"description": "Required PCC verification ratio from 0 through 1; raising it makes result acceptance stricter.",
"maximum": 1,
"minimum": 0,
"type": "number"
},
"requested_field_groups": {
"default": [
"identity",
"sec_submissions",
"recent_filings",
"website_evidence"
],
"description": "Unique evidence categories to collect; omitted values use the schema default, while a smaller list limits provider work and result scope.",
"items": {
"enum": [
"identity",
"sec_submissions",
"xbrl_facts",
"recent_filings",
"website_evidence",
"regulatory_mentions",
"public_repository_signals"
],
"type": "string"
},
"maxItems": 7,
"type": "array",
"uniqueItems": true
},
"ticker": {
"description": "One-to-five uppercase exchange ticker symbols; narrows public-company resolution but is not globally unique without other signals.",
"maxLength": 5,
"pattern": "^[A-Z]{1,5}$",
"type": "string"
}
},
"required": [],
"title": "Company Evidence Graph Input",
"type": "object"
},
"name": "siteborne_build_company_evidence_graph",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"result": {
"$defs": {
"money": {
"additionalProperties": false,
"description": "Canonical decimal-safe money representation. No binary floating-point. Amount is a canonical decimal string.",
"examples": [
{
"amount": "0.039",
"currency": "USD"
},
{
"amount": "0.19",
"asset": "USDC",
"currency": "USD",
"network": "base-mainnet"
}
],
"properties": {
"amount": {
"description": "Canonical decimal string. No scientific notation, no leading zeros (except single '0'), no trailing zeros unless significant, no sign. Maximum 18 decimal places.",
"examples": [
"0",
"0.009",
"0.012",
"0.019",
"0.029",
"0.039",
"0.049",
"0.19"
],
"pattern": "^(0|[1-9][0-9]*)(\\.[0-9]{1,18})?$",
"type": "string"
},
"asset": {
"description": "Payment asset identifier (e.g., 'USDC', 'ETH'). Optional for non-payment contexts.",
"pattern": "^[A-Z0-9]{3,10}$",
"type": "string"
},
"currency": {
"default": "USD",
"description": "ISO 4217 currency code.",
"enum": [
"USD"
],
"pattern": "^[A-Z]{3}$",
"type": "string"
},
"network": {
"description": "Payment network identifier (e.g., 'base-mainnet', 'base-sepolia'). Optional for non-payment contexts.",
"maxLength": 64,
"pattern": "^[a-z0-9-]+$",
"type": "string"
},
"precision": {
"default": 6,
"description": "Maximum decimal places supported by the asset/network. Metadata only.",
"maximum": 18,
"minimum": 0,
"type": "integer"
}
},
"required": [
"amount",
"currency"
],
"title": "Decimal Money",
"type": "object"
},
"pcc": {
"additionalProperties": false,
"definitions": {
"accessibility_status": {
"description": "Evidence accessibility status",
"enum": [
"accessible",
"unavailable",
"restricted",
"requires_authorization"
],
"type": "string"
},
"authorization_classification": {
"description": "Evidence authorization classification",
"enum": [
"public",
"buyer_authorized",
"restricted",
"confidential"
],
"type": "string"
},
"canonicalization_algorithm": {
"const": "RFC8785-JCS",
"description": "Canonicalization algorithm",
"type": "string"
},
"claim": {
"additionalProperties": false,
"properties": {
"claim_id": {
"$ref": "#/$defs/pcc/definitions/claim_id"
},
"confidence": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"evidence_ids": {
"items": {
"$ref": "#/$defs/pcc/definitions/evidence_id"
},
"type": "array"
},
"materiality": {
"$ref": "#/$defs/pcc/definitions/materiality"
},
"predicate": {
"minLength": 1,
"type": "string"
},
"value": {
"type": [
"string",
"number",
"boolean",
"object",
"array",
"null"
]
},
"verification_status": {
"$ref": "#/$defs/pcc/definitions/verification_status"
}
},
"required": [
"claim_id",
"predicate",
"value",
"confidence",
"evidence_ids",
"materiality",
"verification_status"
],
"type": "object"
},
"claim_id": {
"description": "Claim identifier",
"pattern": "^clm_[a-z0-9]{24}$",
"type": "string"
},
"completeness": {
"additionalProperties": false,
"properties": {
"missing_fields": {
"items": {
"minLength": 1,
"type": "string"
},
"type": "array"
},
"populated_fields": {
"minimum": 0,
"type": "integer"
},
"requested_fields": {
"minimum": 0,
"type": "integer"
},
"score": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"stale_fields": {
"items": {
"minLength": 1,
"type": "string"
},
"type": "array"
},
"supported_fields": {
"minimum": 0,
"type": "integer"
},
"unsupported_fields": {
"items": {
"minLength": 1,
"type": "string"
},
"type": "array"
},
"vector": {
"items": {
"$ref": "#/$defs/pcc/definitions/completeness_vector_entry"
},
"type": "array"
}
},
"required": [
"requested_fields",
"populated_fields",
"supported_fields",
"score",
"missing_fields",
"unsupported_fields",
"stale_fields",
"vector"
],
"type": "object"
},
"completeness_vector_entry": {
"additionalProperties": false,
"properties": {
"dimension": {
"minLength": 1,
"type": "string"
},
"populated": {
"minimum": 0,
"type": "integer"
},
"requested": {
"minimum": 0,
"type": "integer"
},
"score": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"supported": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"dimension",
"requested",
"populated",
"supported",
"score"
],
"type": "object"
},
"contract": {
"additionalProperties": false,
"properties": {
"currency": {
"$ref": "#/$defs/pcc/definitions/currency"
},
"expires_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"freshness_seconds": {
"minimum": 1,
"type": "integer"
},
"idempotency_key": {
"$ref": "#/$defs/pcc/definitions/idempotency_key"
},
"input_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"input_schema_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"issued_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"maximum_authorized_price": {
"$ref": "#/$defs/pcc/definitions/decimal_string"
},
"minimum_quality": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"mode": {
"$ref": "#/$defs/pcc/definitions/contract_mode"
},
"network": {
"enum": [
"base",
"base-testnet"
],
"type": "string"
},
"output_schema_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"price": {
"$ref": "#/$defs/pcc/definitions/decimal_string"
},
"quote_id": {
"$ref": "#/$defs/pcc/definitions/quote_id"
},
"service_id": {
"$ref": "#/$defs/pcc/definitions/service_id"
},
"service_version": {
"$ref": "#/$defs/pcc/definitions/service_version"
}
},
"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"
],
"type": "object"
},
"contract_mode": {
"description": "Contract mode determines required fields",
"enum": [
"paid",
"benchmark",
"offline_verification"
],
"type": "string"
},
"currency": {
"description": "Permitted currencies",
"enum": [
"USD",
"USDC"
],
"type": "string"
},
"decimal_string": {
"description": "Non-negative decimal string, no scientific notation, no leading zeros except single zero",
"pattern": "^(0|[1-9]\\d*)(\\.\\d+)?$",
"type": "string"
},
"evidence_id": {
"description": "Evidence identifier",
"pattern": "^evd_[a-z0-9]{24}$",
"type": "string"
},
"evidence_item": {
"additionalProperties": false,
"properties": {
"accessibility_status": {
"$ref": "#/$defs/pcc/definitions/accessibility_status"
},
"authorization_classification": {
"$ref": "#/$defs/pcc/definitions/authorization_classification"
},
"content_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"evidence_id": {
"$ref": "#/$defs/pcc/definitions/evidence_id"
},
"freshness_status": {
"$ref": "#/$defs/pcc/definitions/freshness_status"
},
"locator": {
"$ref": "#/$defs/pcc/definitions/locator"
},
"media_type": {
"minLength": 1,
"type": "string"
},
"retrieved_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"source_timestamp": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"source_uri": {
"format": "uri",
"minLength": 1,
"type": "string"
},
"transformation_history": {
"items": {
"$ref": "#/$defs/pcc/definitions/transformation"
},
"type": "array"
}
},
"required": [
"evidence_id",
"source_uri",
"retrieved_at",
"content_hash",
"media_type",
"locator",
"accessibility_status",
"transformation_history",
"authorization_classification",
"freshness_status"
],
"type": "object"
},
"extension_container": {
"additionalProperties": false,
"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,
"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"
}
},
"propertyNames": {
"maxLength": 253,
"minLength": 5,
"pattern": "^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?){2,}$",
"type": "string"
},
"type": "object"
},
"extension_value": {
"additionalProperties": true,
"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,
"type": "object"
},
"freshness_status": {
"description": "Evidence freshness status",
"enum": [
"fresh",
"stale",
"unknown"
],
"type": "string"
},
"hash": {
"description": "SHA-256 hash with algorithm tag",
"pattern": "^sha256:[a-f0-9]{64}$",
"type": "string"
},
"idempotency_key": {
"description": "Idempotency key",
"pattern": "^idk_[a-z0-9]{24}$",
"type": "string"
},
"job_id": {
"description": "Unique job identifier",
"pattern": "^job_[a-z0-9]{24}$",
"type": "string"
},
"key_id": {
"description": "Key identifier",
"pattern": "^kid_[a-z0-9]{24}$",
"type": "string"
},
"locator": {
"additionalProperties": false,
"properties": {
"type": {
"$ref": "#/$defs/pcc/definitions/locator_type"
},
"value": {
"minLength": 1,
"type": "string"
}
},
"required": [
"type",
"value"
],
"type": "object"
},
"locator_type": {
"description": "Evidence locator type",
"enum": [
"json_pointer",
"xpath",
"css_selector",
"text_quote",
"page_region",
"byte_range",
"database_record",
"artifact_pointer"
],
"type": "string"
},
"materiality": {
"description": "Claim materiality classification",
"enum": [
"material",
"supporting",
"contextual"
],
"type": "string"
},
"pcc_version": {
"const": "1.0.0",
"description": "PCC specification version",
"type": "string"
},
"policy_id": {
"description": "Policy identifier",
"pattern": "^pol_[a-z0-9]{24}$",
"type": "string"
},
"provenance": {
"additionalProperties": false,
"properties": {
"cache_provenance": {
"additionalProperties": false,
"properties": {
"cache_key": {
"type": "string"
},
"enabled": {
"type": "boolean"
},
"hit": {
"type": "boolean"
},
"stored_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
}
},
"required": [
"enabled",
"hit"
],
"type": "object"
},
"execution_environment": {
"additionalProperties": false,
"properties": {
"container_image": {
"type": "string"
},
"platform": {
"minLength": 1,
"type": "string"
},
"runtime": {
"minLength": 1,
"type": "string"
},
"version": {
"minLength": 1,
"type": "string"
}
},
"required": [
"runtime",
"version",
"platform"
],
"type": "object"
},
"models": {
"items": {
"additionalProperties": false,
"properties": {
"name": {
"minLength": 1,
"type": "string"
},
"provider": {
"minLength": 1,
"type": "string"
},
"version": {
"minLength": 1,
"type": "string"
}
},
"required": [
"name",
"version",
"provider"
],
"type": "object"
},
"type": "array"
},
"policy_versions": {
"additionalProperties": {
"type": "string"
},
"description": "Policy name to version mapping",
"type": "object"
},
"providers": {
"items": {
"additionalProperties": false,
"properties": {
"capabilities": {
"items": {
"type": "string"
},
"type": "array"
},
"name": {
"minLength": 1,
"type": "string"
},
"version": {
"minLength": 1,
"type": "string"
}
},
"required": [
"name",
"version",
"capabilities"
],
"type": "object"
},
"type": "array"
},
"routes": {
"items": {
"$ref": "#/$defs/pcc/definitions/provenance_route"
},
"type": "array"
},
"software_versions": {
"additionalProperties": {
"type": "string"
},
"description": "Component name to version mapping",
"type": "object"
},
"tools": {
"additionalProperties": {
"type": "string"
},
"description": "Tool name to version mapping",
"type": "object"
},
"transformations": {
"items": {
"$ref": "#/$defs/pcc/definitions/transformation"
},
"type": "array"
},
"verification_routes": {
"items": {
"$ref": "#/$defs/pcc/definitions/provenance_route"
},
"type": "array"
}
},
"required": [
"routes",
"providers",
"tools",
"models",
"software_versions",
"policy_versions",
"transformations",
"cache_provenance",
"execution_environment",
"verification_routes"
],
"type": "object"
},
"provenance_route": {
"additionalProperties": false,
"properties": {
"model_name": {
"type": "string"
},
"model_version": {
"type": "string"
},
"parameters": {
"additionalProperties": true,
"type": "object"
},
"provider": {
"minLength": 1,
"type": "string"
},
"type": {
"enum": [
"cache",
"direct",
"deterministic",
"model",
"hybrid"
],
"type": "string"
},
"version": {
"minLength": 1,
"type": "string"
}
},
"required": [
"type",
"provider",
"version"
],
"type": "object"
},
"quote_id": {
"description": "Quote identifier",
"pattern": "^qte_[a-z0-9]{24}$",
"type": "string"
},
"receipt": {
"additionalProperties": false,
"properties": {
"canonicalization_algorithm": {
"$ref": "#/$defs/pcc/definitions/canonicalization_algorithm"
},
"output_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"policy_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"schema_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"signature": {
"pattern": "^[A-Za-z0-9_-]{86,88}$",
"type": "string"
},
"signature_algorithm": {
"$ref": "#/$defs/pcc/definitions/signature_algorithm"
},
"signed_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"signing_key_id": {
"$ref": "#/$defs/pcc/definitions/key_id"
}
},
"required": [
"output_hash",
"canonicalization_algorithm",
"policy_hash",
"schema_hash",
"signature_algorithm",
"signing_key_id",
"signature",
"signed_at"
],
"type": "object"
},
"service_id": {
"description": "Service identifier",
"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"
},
"service_version": {
"description": "Service version",
"pattern": "^v\\d+(\\.\\d+)*$",
"type": "string"
},
"signature_algorithm": {
"const": "Ed25519",
"description": "Signature algorithm",
"type": "string"
},
"subject": {
"additionalProperties": false,
"properties": {
"canonical_name": {
"minLength": 1,
"type": "string"
},
"identifiers": {
"additionalProperties": {
"type": "string"
},
"type": "object"
},
"type": {
"$ref": "#/$defs/pcc/definitions/subject_type"
}
},
"required": [
"type",
"canonical_name"
],
"type": "object"
},
"subject_type": {
"description": "Subject type",
"enum": [
"organization",
"person",
"document",
"webpage",
"other"
],
"type": "string"
},
"timestamp_rfc3339": {
"description": "RFC 3339 UTC timestamp with Z suffix, normalized fractional seconds",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?Z$",
"type": "string"
},
"transformation": {
"additionalProperties": false,
"properties": {
"parameters": {
"additionalProperties": true,
"type": "object"
},
"timestamp": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"tool_version": {
"minLength": 1,
"type": "string"
},
"type": {
"minLength": 1,
"type": "string"
}
},
"required": [
"type",
"timestamp",
"tool_version"
],
"type": "object"
},
"verification": {
"additionalProperties": false,
"properties": {
"completeness": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"cross_source_agreement": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"decision": {
"$ref": "#/$defs/pcc/definitions/verification_decision"
},
"deterministic_failures": {
"items": {
"minLength": 1,
"type": "string"
},
"type": "array"
},
"evidence_accessibility": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"failed_requirements": {
"items": {
"minLength": 1,
"type": "string"
},
"type": "array"
},
"freshness": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"material_claims_supported": {
"type": "boolean"
},
"policy": {
"$ref": "#/$defs/pcc/definitions/policy_id"
},
"prompt_injection_result": {
"additionalProperties": false,
"properties": {
"checked": {
"type": "boolean"
},
"details": {
"type": "string"
},
"result": {
"enum": [
"clean",
"suspected",
"confirmed"
],
"type": "string"
}
},
"required": [
"checked",
"result"
],
"type": "object"
},
"provenance_valid": {
"type": "boolean"
},
"schema_valid": {
"type": "boolean"
},
"score": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"verifier_versions": {
"additionalProperties": {
"type": "string"
},
"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"
],
"type": "object"
},
"verification_decision": {
"description": "Verification decision",
"enum": [
"pass",
"conditional",
"fail",
"quarantined"
],
"type": "string"
},
"verification_status": {
"description": "Claim verification status",
"enum": [
"verified",
"unsupported",
"disputed",
"pending"
],
"type": "string"
}
},
"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",
"properties": {
"claims": {
"items": {
"$ref": "#/$defs/pcc/definitions/claim"
},
"type": "array",
"uniqueItems": true
},
"completeness": {
"$ref": "#/$defs/pcc/definitions/completeness"
},
"contract": {
"$ref": "#/$defs/pcc/definitions/contract"
},
"evidence": {
"items": {
"$ref": "#/$defs/pcc/definitions/evidence_item"
},
"type": "array",
"uniqueItems": true
},
"extensions": {
"$ref": "#/$defs/pcc/definitions/extension_container"
},
"job_id": {
"$ref": "#/$defs/pcc/definitions/job_id"
},
"pcc_version": {
"$ref": "#/$defs/pcc/definitions/pcc_version"
},
"provenance": {
"$ref": "#/$defs/pcc/definitions/provenance"
},
"receipt": {
"$ref": "#/$defs/pcc/definitions/receipt"
},
"subject": {
"$ref": "#/$defs/pcc/definitions/subject"
},
"verification": {
"$ref": "#/$defs/pcc/definitions/verification"
}
},
"required": [
"pcc_version",
"job_id",
"contract",
"subject",
"claims",
"evidence",
"completeness",
"provenance",
"verification",
"receipt"
],
"title": "Proof-Carrying Context (PCC) v1.0.0",
"type": "object"
}
},
"$id": "https://siteborne.net/schemas/services/company-evidence-output.schema.json",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"allOf": [
{
"$ref": "#/$defs/pcc"
},
{
"properties": {
"contract": {
"properties": {
"output_schema_hash": {
"pattern": "^sha256:[a-f0-9]{64}$",
"type": "string"
},
"service_id": {
"enum": [
"company_evidence_graph.v1",
"company_evidence_graph.v2"
]
},
"service_version": {
"enum": [
"v1",
"v2"
]
}
},
"required": [
"service_id",
"service_version",
"output_schema_hash"
],
"type": "object"
},
"extensions": {
"properties": {
"net.siteborne.company-evidence.v1": {
"additionalProperties": false,
"description": "Company evidence extension payload.",
"properties": {
"cache_status": {
"additionalProperties": false,
"properties": {
"freshness_seconds": {
"type": "integer"
},
"hit": {
"type": "boolean"
},
"sources": {
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"canonical_identity": {
"additionalProperties": false,
"description": "Canonical resolved organization identity.",
"properties": {
"common_name": {
"maxLength": 256,
"type": "string"
},
"domain": {
"format": "hostname",
"type": "string"
},
"legal_name": {
"maxLength": 256,
"type": "string"
},
"resolved_identifiers": {
"additionalProperties": {
"type": "string"
},
"maxProperties": 10,
"type": "object"
},
"ticker": {
"pattern": "^[A-Z]{1,5}$",
"type": "string"
}
},
"type": "object"
},
"conflicts": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"resolution": {
"type": "string"
},
"sources": {
"items": {
"type": "string"
},
"type": "array"
},
"values": {
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"declared_freshness": {
"description": "ISO 8601 duration of freshness guarantee.",
"pattern": "^P(\\d+D)?(T(\\d+H)?(\\d+M)?(\\d+S)?)?$",
"type": "string"
},
"field_groups": {
"additionalProperties": false,
"description": "Requested field groups with completion state.",
"patternProperties": {
"^(identity|sec_submissions|xbrl_facts|recent_filings|website_evidence|regulatory_mentions|public_repository_signals)$": {
"additionalProperties": false,
"properties": {
"evidence_ids": {
"items": {
"type": "string"
},
"type": "array"
},
"items": {
"items": {
"type": "object"
},
"type": "array"
},
"source_count": {
"minimum": 0,
"type": "integer"
},
"status": {
"enum": [
"complete",
"partial",
"empty",
"unavailable"
],
"type": "string"
}
},
"type": "object"
}
},
"type": "object"
},
"filing_summaries": {
"items": {
"additionalProperties": false,
"properties": {
"accession_number": {
"type": "string"
},
"evidence_ids": {
"items": {
"type": "string"
},
"type": "array"
},
"filing_date": {
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
"filing_type": {
"type": "string"
},
"period_end": {
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
"xbrl_available": {
"type": "boolean"
}
},
"type": "object"
},
"maxItems": 50,
"type": "array"
},
"limitations": {
"items": {
"maxLength": 256,
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"normalized_facts": {
"additionalProperties": {
"type": [
"string",
"number",
"boolean"
]
},
"description": "Normalized XBRL facts keyed by concept.",
"type": "object"
},
"regulatory_references": {
"items": {
"additionalProperties": false,
"properties": {
"date": {
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
"description": {
"type": "string"
},
"evidence_ids": {
"items": {
"type": "string"
},
"type": "array"
},
"reference_id": {
"type": "string"
},
"source": {
"type": "string"
}
},
"type": "object"
},
"maxItems": 30,
"type": "array"
},
"repository_signals": {
"items": {
"additionalProperties": false,
"properties": {
"evidence_ids": {
"items": {
"type": "string"
},
"type": "array"
},
"last_push": {
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?Z$",
"type": "string"
},
"owner": {
"type": "string"
},
"platform": {
"type": "string"
},
"repo": {
"type": "string"
},
"stars": {
"minimum": 0,
"type": "integer"
}
},
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"resolved_identifiers": {
"additionalProperties": {
"type": "string"
},
"description": "All resolved authoritative identifiers.",
"maxProperties": 10,
"type": "object"
},
"source_coverage_summary": {
"additionalProperties": false,
"properties": {
"regulatory": {
"type": "boolean"
},
"repositories": {
"type": "boolean"
},
"sec": {
"type": "boolean"
},
"website": {
"type": "boolean"
}
},
"type": "object"
},
"verified_absences": {
"items": {
"additionalProperties": false,
"properties": {
"claim": {
"description": "The claim that was verified absent.",
"type": "string"
},
"confidence": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"evidence_ids": {
"items": {
"type": "string"
},
"type": "array"
},
"limitations": {
"type": "string"
},
"scope": {
"description": "Search scope.",
"type": "string"
},
"search_window": {
"description": "Time window searched.",
"type": "string"
},
"sources_checked": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"claim",
"scope",
"sources_checked",
"confidence"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"website_observations": {
"items": {
"additionalProperties": false,
"properties": {
"content_hash": {
"pattern": "^sha256:[a-f0-9]{64}$",
"type": "string"
},
"evidence_ids": {
"items": {
"type": "string"
},
"type": "array"
},
"extracted_at": {
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?Z$",
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"type": "object"
},
"maxItems": 20,
"type": "array"
}
},
"type": "object"
}
},
"propertyNames": {
"maxLength": 253,
"minLength": 5,
"pattern": "^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?){2,}$",
"type": "string"
},
"required": [
"net.siteborne.company-evidence.v1"
],
"type": "object"
}
},
"required": [
"contract",
"extensions"
],
"type": "object"
}
],
"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.",
"examples": [
{
"claims": [],
"completeness": {
"missing_fields": [
"ceo_name"
],
"populated_fields": 4,
"requested_fields": 5,
"score": 0.8,
"stale_fields": [],
"supported_fields": 4,
"unsupported_fields": [],
"vector": [
{
"dimension": "general",
"populated": 4,
"requested": 5,
"score": 0.8,
"supported": 4
}
]
},
"contract": {
"currency": "USD",
"expires_at": "2026-08-06T10:00:00Z",
"freshness_seconds": 3600,
"idempotency_key": "idk_aaaaaaaaaaaaaaaaaaaaaaaa",
"input_hash": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"input_schema_hash": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
"issued_at": "2026-08-05T10:00:00Z",
"minimum_quality": 0.8,
"mode": "paid",
"output_schema_hash": "sha256:abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
"quote_id": "qte_aaaaaaaaaaaaaaaaaaaaaaaa",
"service_id": "company_evidence_graph.v1",
"service_version": "v1"
},
"evidence": [],
"extensions": {
"net.siteborne.company-evidence.v1": {
"canonical_identity": {
"domain": "acme.example.com",
"legal_name": "Acme Corporation",
"ticker": "ACME"
},
"declared_freshness": "P1D",
"field_groups": {
"identity": {
"source_count": 3,
"status": "complete"
},
"sec_submissions": {
"source_count": 2,
"status": "partial"
},
"website_evidence": {
"source_count": 1,
"status": "complete"
}
},
"limitations": [
"cache-only SEC data",
"no real-time price data"
]
}
},
"job_id": "job_aaaaaaaaaaaaaaaaaaaaaaaa",
"pcc_version": "1.0.0",
"provenance": {
"cache_provenance": {
"enabled": false,
"hit": false
},
"execution_environment": {
"platform": "linux",
"runtime": "node",
"version": "22.0.0"
},
"models": [],
"policy_versions": {
"verification": "1.0.0"
},
"providers": [
{
"capabilities": [
"fetch"
],
"name": "web",
"version": "1.0.0"
}
],
"routes": [
{
"provider": "web",
"type": "direct",
"version": "1.0.0"
}
],
"software_versions": {
"pcc": "1.0.0"
},
"tools": {
"curl": "8.0.0"
},
"transformations": [],
"verification_routes": []
},
"receipt": {
"canonicalization_algorithm": "RFC8785-JCS",
"output_hash": "sha256:eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
"policy_hash": "sha256:ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
"schema_hash": "sha256:0000000000000000000000000000000000000000000000000000000000000000",
"signature": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"signature_algorithm": "Ed25519",
"signed_at": "2026-08-05T10:00:00Z",
"signing_key_id": "kid_aaaaaaaaaaaaaaaaaaaaaaaa"
},
"subject": {
"canonical_name": "Acme Example Corp",
"identifiers": {
"domain": "acme.example.com"
},
"type": "organization"
},
"verification": {
"completeness": 0.8,
"cross_source_agreement": 1,
"decision": "pass",
"deterministic_failures": [],
"evidence_accessibility": 1,
"failed_requirements": [],
"freshness": 1,
"material_claims_supported": true,
"policy": "pol_aaaaaaaaaaaaaaaaaaaaaaaa",
"prompt_injection_result": {
"checked": true,
"result": "clean"
},
"provenance_valid": true,
"schema_valid": true,
"score": 0.9,
"verifier_versions": {
"pcc": "1.0.0"
}
}
}
],
"title": "Company Evidence Graph Output"
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$id": "https://siteborne.net/schemas/services/company-evidence-input.schema.json",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"required": [
"company_name"
]
},
{
"required": [
"ticker"
]
},
{
"required": [
"domain"
]
},
{
"required": [
"identifiers"
]
}
],
"description": "Input schema for company_evidence_graph.v1 service. At least one identity signal is required.",
"examples": [
{
"company_name": "Acme Corporation",
"domain": "acme.example.com",
"freshness_seconds": 86400,
"minimum_verification_score": 0.7,
"requested_field_groups": [
"identity",
"sec_submissions",
"website_evidence"
]
}
],
"properties": {
"buyer_urls": {
"description": "Up to twenty public supplemental evidence URLs supplied by the buyer; these are additional sources, not replacements for entity resolution.",
"items": {
"format": "uri",
"maxLength": 2048,
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"company_name": {
"description": "Legal or commonly used company name; supplies an entity-resolution signal when authoritative identifiers are unavailable.",
"maxLength": 256,
"minLength": 1,
"type": "string"
},
"domain": {
"description": "Primary website hostname only, without a URL path; links first-party web evidence to the company identity.",
"format": "hostname",
"maxLength": 253,
"type": "string"
},
"freshness_seconds": {
"default": 86400,
"description": "Maximum acceptable source age in seconds, from 0 through 2,592,000; lower values demand fresher evidence.",
"maximum": 2592000,
"minimum": 0,
"type": "integer"
},
"identifiers": {
"additionalProperties": false,
"description": "Known authoritative entity identifiers; supplying precise identifiers reduces ambiguous name, ticker, or domain matching.",
"maxProperties": 10,
"properties": {
"cik": {
"description": "Exactly ten decimal digits identifying the company in SEC EDGAR.",
"pattern": "^[0-9]{10}$",
"type": "string"
},
"cusip": {
"description": "Nine-character CUSIP security identifier.",
"pattern": "^[A-Z0-9]{9}$",
"type": "string"
},
"exchange": {
"description": "Primary listing exchange name or code, up to sixteen characters; disambiguates reused ticker symbols.",
"maxLength": 16,
"type": "string"
},
"figi": {
"description": "Twelve-character OpenFIGI identifier beginning with BBG.",
"pattern": "^BBG[0-9A-Z]{9}$",
"type": "string"
},
"isin": {
"description": "Twelve-character International Securities Identification Number.",
"pattern": "^[A-Z]{2}[A-Z0-9]{9}[0-9]$",
"type": "string"
},
"lei": {
"description": "Exactly twenty uppercase alphanumeric characters for the Legal Entity Identifier.",
"pattern": "^[A-Z0-9]{20}$",
"type": "string"
},
"ticker_symbol": {
"description": "One-to-five uppercase characters for the primary listed ticker when it differs from ticker.",
"pattern": "^[A-Z]{1,5}$",
"type": "string"
}
},
"type": "object"
},
"jurisdiction_hints": {
"description": "Up to five two-letter uppercase jurisdiction codes used to focus regulatory context; hints do not assert incorporation.",
"items": {
"maxLength": 2,
"pattern": "^[A-Z]{2}$",
"type": "string"
},
"maxItems": 5,
"type": "array"
},
"maximum_authorized_price": {
"additionalProperties": false,
"description": "Buyer’s decimal-safe maximum authorized price; constrains the payment requirement and never expands provider scope.",
"examples": [
{
"amount": "0.039",
"currency": "USD"
},
{
"amount": "0.19",
"asset": "USDC",
"currency": "USD",
"network": "base-mainnet"
}
],
"properties": {
"amount": {
"description": "Canonical decimal string. No scientific notation, no leading zeros (except single '0'), no trailing zeros unless significant, no sign. Maximum 18 decimal places.",
"examples": [
"0",
"0.009",
"0.012",
"0.019",
"0.029",
"0.039",
"0.049",
"0.19"
],
"pattern": "^(0|[1-9][0-9]*)(\\.[0-9]{1,18})?$",
"type": "string"
},
"asset": {
"description": "Payment asset identifier (e.g., 'USDC', 'ETH'). Optional for non-payment contexts.",
"pattern": "^[A-Z0-9]{3,10}$",
"type": "string"
},
"currency": {
"default": "USD",
"description": "ISO 4217 currency code.",
"enum": [
"USD"
],
"pattern": "^[A-Z]{3}$",
"type": "string"
},
"network": {
"description": "Payment network identifier (e.g., 'base-mainnet', 'base-sepolia'). Optional for non-payment contexts.",
"maxLength": 64,
"pattern": "^[a-z0-9-]+$",
"type": "string"
},
"precision": {
"default": 6,
"description": "Maximum decimal places supported by the asset/network. Metadata only.",
"maximum": 18,
"minimum": 0,
"type": "integer"
}
},
"required": [
"amount",
"currency"
],
"title": "Decimal Money",
"type": "object"
},
"minimum_completeness": {
"default": 0.5,
"description": "Required completeness ratio from 0 through 1; results below this threshold fail the requested acceptance condition.",
"maximum": 1,
"minimum": 0,
"type": "number"
},
"minimum_verification_score": {
"default": 0.7,
"description": "Required PCC verification ratio from 0 through 1; raising it makes result acceptance stricter.",
"maximum": 1,
"minimum": 0,
"type": "number"
},
"requested_field_groups": {
"default": [
"identity",
"sec_submissions",
"recent_filings",
"website_evidence"
],
"description": "Unique evidence categories to collect; omitted values use the schema default, while a smaller list limits provider work and result scope.",
"items": {
"enum": [
"identity",
"sec_submissions",
"xbrl_facts",
"recent_filings",
"website_evidence",
"regulatory_mentions",
"public_repository_signals"
],
"type": "string"
},
"maxItems": 7,
"type": "array",
"uniqueItems": true
},
"ticker": {
"description": "One-to-five uppercase exchange ticker symbols; narrows public-company resolution but is not globally unique without other signals.",
"maxLength": 5,
"pattern": "^[A-Z]{1,5}$",
"type": "string"
}
},
"required": [],
"title": "Company Evidence Graph Input",
"type": "object"
},
"name": "siteborne_build_company_evidence_graph_v3_candidate",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"result": {
"$defs": {
"money": {
"additionalProperties": false,
"description": "Canonical decimal-safe money representation. No binary floating-point. Amount is a canonical decimal string.",
"examples": [
{
"amount": "0.039",
"currency": "USD"
},
{
"amount": "0.19",
"asset": "USDC",
"currency": "USD",
"network": "base-mainnet"
}
],
"properties": {
"amount": {
"description": "Canonical decimal string. No scientific notation, no leading zeros (except single '0'), no trailing zeros unless significant, no sign. Maximum 18 decimal places.",
"examples": [
"0",
"0.009",
"0.012",
"0.019",
"0.029",
"0.039",
"0.049",
"0.19"
],
"pattern": "^(0|[1-9][0-9]*)(\\.[0-9]{1,18})?$",
"type": "string"
},
"asset": {
"description": "Payment asset identifier (e.g., 'USDC', 'ETH'). Optional for non-payment contexts.",
"pattern": "^[A-Z0-9]{3,10}$",
"type": "string"
},
"currency": {
"default": "USD",
"description": "ISO 4217 currency code.",
"enum": [
"USD"
],
"pattern": "^[A-Z]{3}$",
"type": "string"
},
"network": {
"description": "Payment network identifier (e.g., 'base-mainnet', 'base-sepolia'). Optional for non-payment contexts.",
"maxLength": 64,
"pattern": "^[a-z0-9-]+$",
"type": "string"
},
"precision": {
"default": 6,
"description": "Maximum decimal places supported by the asset/network. Metadata only.",
"maximum": 18,
"minimum": 0,
"type": "integer"
}
},
"required": [
"amount",
"currency"
],
"title": "Decimal Money",
"type": "object"
},
"pcc": {
"additionalProperties": false,
"definitions": {
"accessibility_status": {
"description": "Evidence accessibility status",
"enum": [
"accessible",
"unavailable",
"restricted",
"requires_authorization"
],
"type": "string"
},
"authorization_classification": {
"description": "Evidence authorization classification",
"enum": [
"public",
"buyer_authorized",
"restricted",
"confidential"
],
"type": "string"
},
"canonicalization_algorithm": {
"const": "RFC8785-JCS",
"description": "Canonicalization algorithm",
"type": "string"
},
"claim": {
"additionalProperties": false,
"properties": {
"claim_id": {
"$ref": "#/$defs/pcc/definitions/claim_id"
},
"confidence": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"evidence_ids": {
"items": {
"$ref": "#/$defs/pcc/definitions/evidence_id"
},
"type": "array"
},
"materiality": {
"$ref": "#/$defs/pcc/definitions/materiality"
},
"predicate": {
"minLength": 1,
"type": "string"
},
"value": {
"type": [
"string",
"number",
"boolean",
"object",
"array",
"null"
]
},
"verification_status": {
"$ref": "#/$defs/pcc/definitions/verification_status"
}
},
"required": [
"claim_id",
"predicate",
"value",
"confidence",
"evidence_ids",
"materiality",
"verification_status"
],
"type": "object"
},
"claim_id": {
"description": "Claim identifier",
"pattern": "^clm_[a-z0-9]{24}$",
"type": "string"
},
"completeness": {
"additionalProperties": false,
"properties": {
"missing_fields": {
"items": {
"minLength": 1,
"type": "string"
},
"type": "array"
},
"populated_fields": {
"minimum": 0,
"type": "integer"
},
"requested_fields": {
"minimum": 0,
"type": "integer"
},
"score": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"stale_fields": {
"items": {
"minLength": 1,
"type": "string"
},
"type": "array"
},
"supported_fields": {
"minimum": 0,
"type": "integer"
},
"unsupported_fields": {
"items": {
"minLength": 1,
"type": "string"
},
"type": "array"
},
"vector": {
"items": {
"$ref": "#/$defs/pcc/definitions/completeness_vector_entry"
},
"type": "array"
}
},
"required": [
"requested_fields",
"populated_fields",
"supported_fields",
"score",
"missing_fields",
"unsupported_fields",
"stale_fields",
"vector"
],
"type": "object"
},
"completeness_vector_entry": {
"additionalProperties": false,
"properties": {
"dimension": {
"minLength": 1,
"type": "string"
},
"populated": {
"minimum": 0,
"type": "integer"
},
"requested": {
"minimum": 0,
"type": "integer"
},
"score": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"supported": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"dimension",
"requested",
"populated",
"supported",
"score"
],
"type": "object"
},
"contract": {
"additionalProperties": false,
"properties": {
"currency": {
"$ref": "#/$defs/pcc/definitions/currency"
},
"expires_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"freshness_seconds": {
"minimum": 1,
"type": "integer"
},
"idempotency_key": {
"$ref": "#/$defs/pcc/definitions/idempotency_key"
},
"input_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"input_schema_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"issued_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"maximum_authorized_price": {
"$ref": "#/$defs/pcc/definitions/decimal_string"
},
"minimum_quality": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"mode": {
"$ref": "#/$defs/pcc/definitions/contract_mode"
},
"network": {
"enum": [
"base",
"base-testnet"
],
"type": "string"
},
"output_schema_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"price": {
"$ref": "#/$defs/pcc/definitions/decimal_string"
},
"quote_id": {
"$ref": "#/$defs/pcc/definitions/quote_id"
},
"service_id": {
"$ref": "#/$defs/pcc/definitions/service_id"
},
"service_version": {
"$ref": "#/$defs/pcc/definitions/service_version"
}
},
"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"
],
"type": "object"
},
"contract_mode": {
"description": "Contract mode determines required fields",
"enum": [
"paid",
"benchmark",
"offline_verification"
],
"type": "string"
},
"currency": {
"description": "Permitted currencies",
"enum": [
"USD",
"USDC"
],
"type": "string"
},
"decimal_string": {
"description": "Non-negative decimal string, no scientific notation, no leading zeros except single zero",
"pattern": "^(0|[1-9]\\d*)(\\.\\d+)?$",
"type": "string"
},
"evidence_id": {
"description": "Evidence identifier",
"pattern": "^evd_[a-z0-9]{24}$",
"type": "string"
},
"evidence_item": {
"additionalProperties": false,
"properties": {
"accessibility_status": {
"$ref": "#/$defs/pcc/definitions/accessibility_status"
},
"authorization_classification": {
"$ref": "#/$defs/pcc/definitions/authorization_classification"
},
"content_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"evidence_id": {
"$ref": "#/$defs/pcc/definitions/evidence_id"
},
"freshness_status": {
"$ref": "#/$defs/pcc/definitions/freshness_status"
},
"locator": {
"$ref": "#/$defs/pcc/definitions/locator"
},
"media_type": {
"minLength": 1,
"type": "string"
},
"retrieved_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"source_timestamp": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"source_uri": {
"format": "uri",
"minLength": 1,
"type": "string"
},
"transformation_history": {
"items": {
"$ref": "#/$defs/pcc/definitions/transformation"
},
"type": "array"
}
},
"required": [
"evidence_id",
"source_uri",
"retrieved_at",
"content_hash",
"media_type",
"locator",
"accessibility_status",
"transformation_history",
"authorization_classification",
"freshness_status"
],
"type": "object"
},
"extension_container": {
"additionalProperties": false,
"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,
"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"
}
},
"propertyNames": {
"maxLength": 253,
"minLength": 5,
"pattern": "^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?){2,}$",
"type": "string"
},
"type": "object"
},
"extension_value": {
"additionalProperties": true,
"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,
"type": "object"
},
"freshness_status": {
"description": "Evidence freshness status",
"enum": [
"fresh",
"stale",
"unknown"
],
"type": "string"
},
"hash": {
"description": "SHA-256 hash with algorithm tag",
"pattern": "^sha256:[a-f0-9]{64}$",
"type": "string"
},
"idempotency_key": {
"description": "Idempotency key",
"pattern": "^idk_[a-z0-9]{24}$",
"type": "string"
},
"job_id": {
"description": "Unique job identifier",
"pattern": "^job_[a-z0-9]{24}$",
"type": "string"
},
"key_id": {
"description": "Key identifier",
"pattern": "^kid_[a-z0-9]{24}$",
"type": "string"
},
"locator": {
"additionalProperties": false,
"properties": {
"type": {
"$ref": "#/$defs/pcc/definitions/locator_type"
},
"value": {
"minLength": 1,
"type": "string"
}
},
"required": [
"type",
"value"
],
"type": "object"
},
"locator_type": {
"description": "Evidence locator type",
"enum": [
"json_pointer",
"xpath",
"css_selector",
"text_quote",
"page_region",
"byte_range",
"database_record",
"artifact_pointer"
],
"type": "string"
},
"materiality": {
"description": "Claim materiality classification",
"enum": [
"material",
"supporting",
"contextual"
],
"type": "string"
},
"pcc_version": {
"const": "2.0.0",
"description": "PCC specification version",
"type": "string"
},
"policy_id": {
"description": "Policy identifier",
"pattern": "^pol_[a-z0-9]{24}$",
"type": "string"
},
"provenance": {
"additionalProperties": false,
"properties": {
"cache_provenance": {
"additionalProperties": false,
"properties": {
"cache_key": {
"type": "string"
},
"enabled": {
"type": "boolean"
},
"hit": {
"type": "boolean"
},
"stored_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
}
},
"required": [
"enabled",
"hit"
],
"type": "object"
},
"execution_environment": {
"additionalProperties": false,
"properties": {
"container_image": {
"type": "string"
},
"platform": {
"minLength": 1,
"type": "string"
},
"runtime": {
"minLength": 1,
"type": "string"
},
"version": {
"minLength": 1,
"type": "string"
}
},
"required": [
"runtime",
"version",
"platform"
],
"type": "object"
},
"models": {
"items": {
"additionalProperties": false,
"properties": {
"name": {
"minLength": 1,
"type": "string"
},
"provider": {
"minLength": 1,
"type": "string"
},
"version": {
"minLength": 1,
"type": "string"
}
},
"required": [
"name",
"version",
"provider"
],
"type": "object"
},
"type": "array"
},
"policy_versions": {
"additionalProperties": {
"type": "string"
},
"description": "Policy name to version mapping",
"type": "object"
},
"providers": {
"items": {
"additionalProperties": false,
"properties": {
"capabilities": {
"items": {
"type": "string"
},
"type": "array"
},
"name": {
"minLength": 1,
"type": "string"
},
"version": {
"minLength": 1,
"type": "string"
}
},
"required": [
"name",
"version",
"capabilities"
],
"type": "object"
},
"type": "array"
},
"routes": {
"items": {
"$ref": "#/$defs/pcc/definitions/provenance_route"
},
"type": "array"
},
"software_versions": {
"additionalProperties": {
"type": "string"
},
"description": "Component name to version mapping",
"type": "object"
},
"tools": {
"additionalProperties": {
"type": "string"
},
"description": "Tool name to version mapping",
"type": "object"
},
"transformations": {
"items": {
"$ref": "#/$defs/pcc/definitions/transformation"
},
"type": "array"
},
"verification_routes": {
"items": {
"$ref": "#/$defs/pcc/definitions/provenance_route"
},
"type": "array"
}
},
"required": [
"routes",
"providers",
"tools",
"models",
"software_versions",
"policy_versions",
"transformations",
"cache_provenance",
"execution_environment",
"verification_routes"
],
"type": "object"
},
"provenance_route": {
"additionalProperties": false,
"properties": {
"model_name": {
"type": "string"
},
"model_version": {
"type": "string"
},
"parameters": {
"additionalProperties": true,
"type": "object"
},
"provider": {
"minLength": 1,
"type": "string"
},
"type": {
"enum": [
"cache",
"direct",
"deterministic",
"model",
"hybrid"
],
"type": "string"
},
"version": {
"minLength": 1,
"type": "string"
}
},
"required": [
"type",
"provider",
"version"
],
"type": "object"
},
"public_verifier_result": {
"additionalProperties": false,
"properties": {
"failure_codes": {
"items": {
"minLength": 1,
"type": "string"
},
"maxItems": 200,
"type": "array"
},
"findings": {
"items": {
"additionalProperties": false,
"properties": {
"code": {
"minLength": 1,
"type": "string"
},
"severity": {
"minLength": 1,
"type": "string"
}
},
"required": [
"code",
"severity"
],
"type": "object"
},
"maxItems": 200,
"type": "array"
},
"status": {
"minLength": 1,
"type": "string"
},
"verifier_id": {
"minLength": 1,
"type": "string"
}
},
"required": [
"verifier_id",
"status",
"findings",
"failure_codes"
],
"type": "object"
},
"quote_id": {
"description": "Quote identifier",
"pattern": "^qte_[a-z0-9]{24}$",
"type": "string"
},
"receipt": {
"additionalProperties": false,
"properties": {
"canonicalization_algorithm": {
"$ref": "#/$defs/pcc/definitions/canonicalization_algorithm"
},
"output_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"policy_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"schema_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"signature": {
"pattern": "^[A-Za-z0-9_-]{86,88}$",
"type": "string"
},
"signature_algorithm": {
"$ref": "#/$defs/pcc/definitions/signature_algorithm"
},
"signed_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"signing_key_id": {
"$ref": "#/$defs/pcc/definitions/key_id"
}
},
"required": [
"output_hash",
"canonicalization_algorithm",
"policy_hash",
"schema_hash",
"signature_algorithm",
"signing_key_id",
"signature",
"signed_at"
],
"type": "object"
},
"service_id": {
"description": "Service identifier",
"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"
},
"service_version": {
"description": "Service version",
"pattern": "^v\\d+(\\.\\d+)*$",
"type": "string"
},
"signature_algorithm": {
"const": "Ed25519",
"description": "Signature algorithm",
"type": "string"
},
"subject": {
"additionalProperties": false,
"properties": {
"canonical_name": {
"minLength": 1,
"type": "string"
},
"identifiers": {
"additionalProperties": {
"type": "string"
},
"type": "object"
},
"type": {
"$ref": "#/$defs/pcc/definitions/subject_type"
}
},
"required": [
"type",
"canonical_name"
],
"type": "object"
},
"subject_type": {
"description": "Subject type",
"enum": [
"organization",
"person",
"document",
"webpage",
"other"
],
"type": "string"
},
"timestamp_rfc3339": {
"description": "RFC 3339 UTC timestamp with Z suffix, normalized fractional seconds",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?Z$",
"type": "string"
},
"transformation": {
"additionalProperties": false,
"properties": {
"parameters": {
"additionalProperties": true,
"type": "object"
},
"timestamp": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"tool_version": {
"minLength": 1,
"type": "string"
},
"type": {
"minLength": 1,
"type": "string"
}
},
"required": [
"type",
"timestamp",
"tool_version"
],
"type": "object"
},
"verification": {
"additionalProperties": false,
"properties": {
"completeness": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"cross_source_agreement": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"decision": {
"$ref": "#/$defs/pcc/definitions/verification_decision"
},
"deterministic_failures": {
"items": {
"minLength": 1,
"type": "string"
},
"type": "array"
},
"evidence_accessibility": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"failed_requirements": {
"items": {
"minLength": 1,
"type": "string"
},
"type": "array"
},
"freshness": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"material_claims_supported": {
"type": "boolean"
},
"policy": {
"$ref": "#/$defs/pcc/definitions/policy_id"
},
"prompt_injection_result": {
"additionalProperties": false,
"properties": {
"checked": {
"type": "boolean"
},
"details": {
"type": "string"
},
"result": {
"enum": [
"clean",
"suspected",
"confirmed"
],
"type": "string"
}
},
"required": [
"checked",
"result"
],
"type": "object"
},
"provenance_valid": {
"type": "boolean"
},
"schema_valid": {
"type": "boolean"
},
"score": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"verifier_versions": {
"additionalProperties": {
"type": "string"
},
"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"
],
"type": "object"
},
"verification_decision": {
"description": "Verification decision",
"enum": [
"pass",
"conditional",
"fail",
"quarantined"
],
"type": "string"
},
"verification_proof_v1": {
"additionalProperties": false,
"properties": {
"proof_version": {
"const": "1.0.0",
"type": "string"
},
"receipt": {
"$ref": "#/$defs/pcc/definitions/vnext_receipt"
},
"verification_material": {
"additionalProperties": false,
"properties": {
"verifier_results": {
"items": {
"$ref": "#/$defs/pcc/definitions/public_verifier_result"
},
"maxItems": 100,
"type": "array"
}
},
"required": [
"verifier_results"
],
"type": "object"
}
},
"required": [
"proof_version",
"receipt",
"verification_material"
],
"type": "object"
},
"verification_status": {
"description": "Claim verification status",
"enum": [
"verified",
"unsupported",
"disputed",
"pending"
],
"type": "string"
},
"vnext_receipt": {
"additionalProperties": false,
"properties": {
"canonicalization_algorithm": {
"const": "RFC8785-JCS",
"type": "string"
},
"completeness": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"contract_release": {
"const": "3.0.0",
"type": "string"
},
"decision": {
"$ref": "#/$defs/pcc/definitions/verification_decision"
},
"domain": {
"const": "SITEBORNE-PCC-VERIFICATION-PROOF-V1",
"type": "string"
},
"evidence_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"input_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"issued_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"job_id": {
"$ref": "#/$defs/pcc/definitions/job_id"
},
"limitations": {
"items": {
"minLength": 1,
"type": "string"
},
"maxItems": 200,
"type": "array"
},
"output_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"output_schema_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"pcc_document_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"pcc_schema_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"pcc_schema_release": {
"const": "2.0.0",
"type": "string"
},
"policy_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"proof_version": {
"const": "1.0.0",
"type": "string"
},
"receipt_id": {
"pattern": "^rcpt_[a-f0-9]{24}$",
"type": "string"
},
"receipt_version": {
"const": "2.0.0",
"type": "string"
},
"request_id": {
"minLength": 1,
"type": "string"
},
"service_id": {
"$ref": "#/$defs/pcc/definitions/service_id"
},
"service_version": {
"$ref": "#/$defs/pcc/definitions/service_version"
},
"signature": {
"pattern": "^[A-Za-z0-9_-]{86}$",
"type": "string"
},
"signature_algorithm": {
"const": "Ed25519",
"type": "string"
},
"signing_key_id": {
"minLength": 1,
"type": "string"
},
"verification_mode": {
"enum": [
"standard",
"independent_reproduction"
],
"type": "string"
},
"verifier_set_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
}
},
"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"
],
"type": "object"
},
"vnext_receipt_preimage": {
"additionalProperties": false,
"properties": {
"canonicalization_algorithm": {
"const": "RFC8785-JCS",
"type": "string"
},
"completeness": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"contract_release": {
"const": "3.0.0",
"type": "string"
},
"decision": {
"$ref": "#/$defs/pcc/definitions/verification_decision"
},
"domain": {
"const": "SITEBORNE-PCC-VERIFICATION-PROOF-V1",
"type": "string"
},
"evidence_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"input_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"issued_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"job_id": {
"$ref": "#/$defs/pcc/definitions/job_id"
},
"limitations": {
"items": {
"minLength": 1,
"type": "string"
},
"maxItems": 200,
"type": "array"
},
"output_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"output_schema_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"pcc_document_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"pcc_schema_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"pcc_schema_release": {
"const": "2.0.0",
"type": "string"
},
"policy_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"proof_version": {
"const": "1.0.0",
"type": "string"
},
"receipt_version": {
"const": "2.0.0",
"type": "string"
},
"request_id": {
"minLength": 1,
"type": "string"
},
"service_id": {
"$ref": "#/$defs/pcc/definitions/service_id"
},
"service_version": {
"$ref": "#/$defs/pcc/definitions/service_version"
},
"signature_algorithm": {
"const": "Ed25519",
"type": "string"
},
"signing_key_id": {
"minLength": 1,
"type": "string"
},
"verification_mode": {
"enum": [
"standard",
"independent_reproduction"
],
"type": "string"
},
"verifier_set_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
}
},
"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"
],
"type": "object"
}
},
"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",
"properties": {
"claims": {
"items": {
"$ref": "#/$defs/pcc/definitions/claim"
},
"type": "array",
"uniqueItems": true
},
"completeness": {
"$ref": "#/$defs/pcc/definitions/completeness"
},
"contract": {
"$ref": "#/$defs/pcc/definitions/contract"
},
"evidence": {
"items": {
"$ref": "#/$defs/pcc/definitions/evidence_item"
},
"type": "array",
"uniqueItems": true
},
"extensions": {
"allOf": [
{
"$ref": "#/$defs/pcc/definitions/extension_container"
},
{
"properties": {
"net.siteborne.verification-proof.v1": {
"$ref": "#/$defs/pcc/definitions/verification_proof_v1"
}
},
"required": [
"net.siteborne.verification-proof.v1"
],
"type": "object"
}
]
},
"job_id": {
"$ref": "#/$defs/pcc/definitions/job_id"
},
"pcc_version": {
"$ref": "#/$defs/pcc/definitions/pcc_version"
},
"provenance": {
"$ref": "#/$defs/pcc/definitions/provenance"
},
"receipt": {
"$ref": "#/$defs/pcc/definitions/receipt"
},
"subject": {
"$ref": "#/$defs/pcc/definitions/subject"
},
"verification": {
"$ref": "#/$defs/pcc/definitions/verification"
}
},
"required": [
"pcc_version",
"job_id",
"contract",
"subject",
"claims",
"evidence",
"completeness",
"provenance",
"verification",
"receipt"
],
"title": "Proof-Carrying Context (PCC) v2.0.0",
"type": "object"
}
},
"$id": "https://utility.siteborne.net/contracts/3.0.0/schemas/services/company-evidence-output.schema.json",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"allOf": [
{
"$ref": "#/$defs/pcc"
},
{
"properties": {
"contract": {
"properties": {
"output_schema_hash": {
"pattern": "^sha256:[a-f0-9]{64}$",
"type": "string"
},
"service_id": {
"enum": [
"company_evidence_graph.v3"
]
},
"service_version": {
"enum": [
"v3"
]
}
},
"required": [
"service_id",
"service_version",
"output_schema_hash"
],
"type": "object"
},
"extensions": {
"properties": {
"net.siteborne.company-evidence.v1": {
"additionalProperties": false,
"description": "Company evidence extension payload.",
"properties": {
"cache_status": {
"additionalProperties": false,
"properties": {
"freshness_seconds": {
"type": "integer"
},
"hit": {
"type": "boolean"
},
"sources": {
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"canonical_identity": {
"additionalProperties": false,
"description": "Canonical resolved organization identity.",
"properties": {
"common_name": {
"maxLength": 256,
"type": "string"
},
"domain": {
"format": "hostname",
"type": "string"
},
"legal_name": {
"maxLength": 256,
"type": "string"
},
"resolved_identifiers": {
"additionalProperties": {
"type": "string"
},
"maxProperties": 10,
"type": "object"
},
"ticker": {
"pattern": "^[A-Z]{1,5}$",
"type": "string"
}
},
"type": "object"
},
"conflicts": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"resolution": {
"type": "string"
},
"sources": {
"items": {
"type": "string"
},
"type": "array"
},
"values": {
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"declared_freshness": {
"description": "ISO 8601 duration of freshness guarantee.",
"pattern": "^P(\\d+D)?(T(\\d+H)?(\\d+M)?(\\d+S)?)?$",
"type": "string"
},
"field_groups": {
"additionalProperties": false,
"description": "Requested field groups with completion state.",
"patternProperties": {
"^(identity|sec_submissions|xbrl_facts|recent_filings|website_evidence|regulatory_mentions|public_repository_signals)$": {
"additionalProperties": false,
"properties": {
"evidence_ids": {
"items": {
"type": "string"
},
"type": "array"
},
"items": {
"items": {
"type": "object"
},
"type": "array"
},
"source_count": {
"minimum": 0,
"type": "integer"
},
"status": {
"enum": [
"complete",
"partial",
"empty",
"unavailable"
],
"type": "string"
}
},
"type": "object"
}
},
"type": "object"
},
"filing_summaries": {
"items": {
"additionalProperties": false,
"properties": {
"accession_number": {
"type": "string"
},
"evidence_ids": {
"items": {
"type": "string"
},
"type": "array"
},
"filing_date": {
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
"filing_type": {
"type": "string"
},
"period_end": {
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
"xbrl_available": {
"type": "boolean"
}
},
"type": "object"
},
"maxItems": 50,
"type": "array"
},
"limitations": {
"items": {
"maxLength": 256,
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"normalized_facts": {
"additionalProperties": {
"type": [
"string",
"number",
"boolean"
]
},
"description": "Normalized XBRL facts keyed by concept.",
"type": "object"
},
"regulatory_references": {
"items": {
"additionalProperties": false,
"properties": {
"date": {
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
"description": {
"type": "string"
},
"evidence_ids": {
"items": {
"type": "string"
},
"type": "array"
},
"reference_id": {
"type": "string"
},
"source": {
"type": "string"
}
},
"type": "object"
},
"maxItems": 30,
"type": "array"
},
"repository_signals": {
"items": {
"additionalProperties": false,
"properties": {
"evidence_ids": {
"items": {
"type": "string"
},
"type": "array"
},
"last_push": {
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?Z$",
"type": "string"
},
"owner": {
"type": "string"
},
"platform": {
"type": "string"
},
"repo": {
"type": "string"
},
"stars": {
"minimum": 0,
"type": "integer"
}
},
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"resolved_identifiers": {
"additionalProperties": {
"type": "string"
},
"description": "All resolved authoritative identifiers.",
"maxProperties": 10,
"type": "object"
},
"source_coverage_summary": {
"additionalProperties": false,
"properties": {
"regulatory": {
"type": "boolean"
},
"repositories": {
"type": "boolean"
},
"sec": {
"type": "boolean"
},
"website": {
"type": "boolean"
}
},
"type": "object"
},
"verified_absences": {
"items": {
"additionalProperties": false,
"properties": {
"claim": {
"description": "The claim that was verified absent.",
"type": "string"
},
"confidence": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"evidence_ids": {
"items": {
"type": "string"
},
"type": "array"
},
"limitations": {
"type": "string"
},
"scope": {
"description": "Search scope.",
"type": "string"
},
"search_window": {
"description": "Time window searched.",
"type": "string"
},
"sources_checked": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"claim",
"scope",
"sources_checked",
"confidence"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"website_observations": {
"items": {
"additionalProperties": false,
"properties": {
"content_hash": {
"pattern": "^sha256:[a-f0-9]{64}$",
"type": "string"
},
"evidence_ids": {
"items": {
"type": "string"
},
"type": "array"
},
"extracted_at": {
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?Z$",
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"type": "object"
},
"maxItems": 20,
"type": "array"
}
},
"type": "object"
}
},
"propertyNames": {
"maxLength": 253,
"minLength": 5,
"pattern": "^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?){2,}$",
"type": "string"
},
"required": [
"net.siteborne.company-evidence.v1"
],
"type": "object"
}
},
"required": [
"contract",
"extensions"
],
"type": "object"
}
],
"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.",
"title": "Company Evidence Graph Output"
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$id": "https://siteborne.net/schemas/services/document-evidence-input.schema.json",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"description": "Input schema for document_evidence_json.v1 service. Exactly one document reference mode required.",
"examples": [
{
"artifact_reference": {
"artifact_id": "doc/abc123/contract.pdf",
"authorization": "buyer_authorized",
"content_hash": "sha256:abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
"media_type": "application/pdf",
"page_count": 5,
"size_bytes": 2048576
},
"extraction_request": {
"extract_key_values": true,
"extract_tables": true
},
"maximum_authorized_price": {
"amount": "0.19",
"currency": "USD"
},
"ocr_permission": true
}
],
"oneOf": [
{
"required": [
"artifact_reference"
]
},
{
"required": [
"upload_reference"
]
},
{
"required": [
"document_url"
]
}
],
"properties": {
"artifact_reference": {
"additionalProperties": false,
"description": "Authorized stored-artifact descriptor for reference mode 1; use exactly one of artifact_reference, upload_reference, or document_url.",
"examples": [
{
"artifact_id": "doc/abc123/evidence.pdf",
"authorization": "buyer_authorized",
"content_hash": "sha256:abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
"media_type": "application/pdf",
"page_count": 5,
"size_bytes": 2048576
}
],
"properties": {
"access_token": {
"description": "Short-lived access token for private artifacts. Must not be logged.",
"maxLength": 2048,
"type": "string"
},
"artifact_id": {
"description": "Unique artifact identifier (e.g., R2 object key, artifact registry ID).",
"maxLength": 512,
"type": "string"
},
"authorization": {
"description": "Authorization classification.",
"enum": [
"public",
"buyer_authorized"
],
"type": "string"
},
"content_hash": {
"description": "SHA-256 content hash for integrity verification.",
"pattern": "^sha256:[a-f0-9]{64}$",
"type": "string"
},
"media_type": {
"description": "Declared MIME type of the artifact.",
"enum": [
"application/pdf",
"image/png",
"image/jpeg"
],
"type": "string"
},
"page_count": {
"description": "Declared page count when known.",
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"size_bytes": {
"description": "Declared size in bytes.",
"maximum": 10485760,
"minimum": 1,
"type": "integer"
}
},
"required": [
"artifact_id",
"media_type",
"size_bytes"
],
"title": "Authorized Artifact Reference",
"type": "object"
},
"declared_page_count": {
"description": "Optional declared page count from 1 through 10; enables early scope validation but does not override the observed document.",
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"document_url": {
"description": "Public document URL for reference mode 3; use exactly one reference mode and never put credentials in this URL.",
"format": "uri",
"maxLength": 2048,
"type": "string"
},
"extraction_request": {
"additionalProperties": false,
"description": "Selects text, table, key-value, and buyer-schema extraction outputs; omitted switches retain their documented defaults.",
"properties": {
"buyer_schema": {
"additionalProperties": true,
"description": "Optional JSON Schema, bounded to fifty properties and depth five, used to validate buyer-shaped extracted data.",
"maxDepth": 5,
"maxProperties": 50,
"type": "object"
},
"extract_key_values": {
"default": false,
"description": "Whether key-value extraction is requested; defaults to false.",
"type": "boolean"
},
"extract_tables": {
"default": false,
"description": "Whether bounded table extraction is requested; defaults to false and may increase processing work.",
"type": "boolean"
},
"extract_text": {
"default": true,
"description": "Whether normalized text extraction is requested; defaults to true.",
"type": "boolean"
}
},
"type": "object"
},
"language_hints": {
"description": "Up to five BCP 47 language hints used by OCR and extraction; hints do not translate the document.",
"items": {
"pattern": "^[a-z]{2,3}(-[A-Z]{2})?$",
"type": "string"
},
"maxItems": 5,
"type": "array"
},
"maximum_authorized_price": {
"additionalProperties": false,
"description": "Buyer’s decimal-safe maximum authorized price; constrains the payment requirement and not retention or extraction policy.",
"examples": [
{
"amount": "0.039",
"currency": "USD"
},
{
"amount": "0.19",
"asset": "USDC",
"currency": "USD",
"network": "base-mainnet"
}
],
"properties": {
"amount": {
"description": "Canonical decimal string. No scientific notation, no leading zeros (except single '0'), no trailing zeros unless significant, no sign. Maximum 18 decimal places.",
"examples": [
"0",
"0.009",
"0.012",
"0.019",
"0.029",
"0.039",
"0.049",
"0.19"
],
"pattern": "^(0|[1-9][0-9]*)(\\.[0-9]{1,18})?$",
"type": "string"
},
"asset": {
"description": "Payment asset identifier (e.g., 'USDC', 'ETH'). Optional for non-payment contexts.",
"pattern": "^[A-Z0-9]{3,10}$",
"type": "string"
},
"currency": {
"default": "USD",
"description": "ISO 4217 currency code.",
"enum": [
"USD"
],
"pattern": "^[A-Z]{3}$",
"type": "string"
},
"network": {
"description": "Payment network identifier (e.g., 'base-mainnet', 'base-sepolia'). Optional for non-payment contexts.",
"maxLength": 64,
"pattern": "^[a-z0-9-]+$",
"type": "string"
},
"precision": {
"default": 6,
"description": "Maximum decimal places supported by the asset/network. Metadata only.",
"maximum": 18,
"minimum": 0,
"type": "integer"
}
},
"required": [
"amount",
"currency"
],
"title": "Decimal Money",
"type": "object"
},
"minimum_verification_score": {
"default": 0.7,
"description": "Required PCC verification ratio from 0 through 1; raising it makes extracted-evidence acceptance stricter.",
"maximum": 1,
"minimum": 0,
"type": "number"
},
"ocr_permission": {
"default": false,
"description": "Explicit permission to use OCR for image-based content; false prevents OCR even when text is not embedded.",
"type": "boolean"
},
"page_range": {
"additionalProperties": false,
"description": "Optional one-indexed inclusive page range to process; both bounds are limited to pages 1 through 10.",
"properties": {
"end": {
"description": "Last one-indexed page to process, inclusive and not before start.",
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"start": {
"description": "First one-indexed page to process, inclusive.",
"maximum": 10,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"retention_preference": {
"default": "temporary",
"description": "Requested retention class—none, temporary, or permanent—subject to server policy; it cannot override mandatory retention limits.",
"enum": [
"none",
"temporary",
"permanent"
],
"type": "string"
},
"table_extraction_request": {
"default": false,
"description": "Explicit top-level request for table extraction; false leaves tables unrequested.",
"type": "boolean"
},
"upload_reference": {
"additionalProperties": false,
"description": "Previously issued SITEBORNE upload handle and declared file metadata for reference mode 2; it does not upload document bytes.",
"properties": {
"content_hash": {
"description": "Optional lowercase SHA-256 integrity identifier in sha256:<64 hex> form; when supplied it must match the artifact.",
"pattern": "^sha256:[a-f0-9]{64}$",
"type": "string"
},
"media_type": {
"description": "Declared parser media type: PDF, PNG, or JPEG; it must match the stored artifact.",
"enum": [
"application/pdf",
"image/png",
"image/jpeg"
],
"type": "string"
},
"size_bytes": {
"description": "Declared artifact size in bytes, from 1 through 10,485,760; it is checked against stored metadata.",
"maximum": 10485760,
"minimum": 1,
"type": "integer"
},
"upload_id": {
"description": "Opaque SITEBORNE upload identifier, up to 512 characters, that selects the already admitted artifact.",
"maxLength": 512,
"type": "string"
}
},
"required": [
"upload_id",
"media_type",
"size_bytes"
],
"type": "object"
}
},
"title": "Document Evidence JSON Input",
"type": "object"
},
"name": "siteborne_extract_document_evidence_json",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"result": {
"$defs": {
"money": {
"additionalProperties": false,
"description": "Canonical decimal-safe money representation. No binary floating-point. Amount is a canonical decimal string.",
"examples": [
{
"amount": "0.039",
"currency": "USD"
},
{
"amount": "0.19",
"asset": "USDC",
"currency": "USD",
"network": "base-mainnet"
}
],
"properties": {
"amount": {
"description": "Canonical decimal string. No scientific notation, no leading zeros (except single '0'), no trailing zeros unless significant, no sign. Maximum 18 decimal places.",
"examples": [
"0",
"0.009",
"0.012",
"0.019",
"0.029",
"0.039",
"0.049",
"0.19"
],
"pattern": "^(0|[1-9][0-9]*)(\\.[0-9]{1,18})?$",
"type": "string"
},
"asset": {
"description": "Payment asset identifier (e.g., 'USDC', 'ETH'). Optional for non-payment contexts.",
"pattern": "^[A-Z0-9]{3,10}$",
"type": "string"
},
"currency": {
"default": "USD",
"description": "ISO 4217 currency code.",
"enum": [
"USD"
],
"pattern": "^[A-Z]{3}$",
"type": "string"
},
"network": {
"description": "Payment network identifier (e.g., 'base-mainnet', 'base-sepolia'). Optional for non-payment contexts.",
"maxLength": 64,
"pattern": "^[a-z0-9-]+$",
"type": "string"
},
"precision": {
"default": 6,
"description": "Maximum decimal places supported by the asset/network. Metadata only.",
"maximum": 18,
"minimum": 0,
"type": "integer"
}
},
"required": [
"amount",
"currency"
],
"title": "Decimal Money",
"type": "object"
},
"pcc": {
"additionalProperties": false,
"definitions": {
"accessibility_status": {
"description": "Evidence accessibility status",
"enum": [
"accessible",
"unavailable",
"restricted",
"requires_authorization"
],
"type": "string"
},
"authorization_classification": {
"description": "Evidence authorization classification",
"enum": [
"public",
"buyer_authorized",
"restricted",
"confidential"
],
"type": "string"
},
"canonicalization_algorithm": {
"const": "RFC8785-JCS",
"description": "Canonicalization algorithm",
"type": "string"
},
"claim": {
"additionalProperties": false,
"properties": {
"claim_id": {
"$ref": "#/$defs/pcc/definitions/claim_id"
},
"confidence": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"evidence_ids": {
"items": {
"$ref": "#/$defs/pcc/definitions/evidence_id"
},
"type": "array"
},
"materiality": {
"$ref": "#/$defs/pcc/definitions/materiality"
},
"predicate": {
"minLength": 1,
"type": "string"
},
"value": {
"type": [
"string",
"number",
"boolean",
"object",
"array",
"null"
]
},
"verification_status": {
"$ref": "#/$defs/pcc/definitions/verification_status"
}
},
"required": [
"claim_id",
"predicate",
"value",
"confidence",
"evidence_ids",
"materiality",
"verification_status"
],
"type": "object"
},
"claim_id": {
"description": "Claim identifier",
"pattern": "^clm_[a-z0-9]{24}$",
"type": "string"
},
"completeness": {
"additionalProperties": false,
"properties": {
"missing_fields": {
"items": {
"minLength": 1,
"type": "string"
},
"type": "array"
},
"populated_fields": {
"minimum": 0,
"type": "integer"
},
"requested_fields": {
"minimum": 0,
"type": "integer"
},
"score": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"stale_fields": {
"items": {
"minLength": 1,
"type": "string"
},
"type": "array"
},
"supported_fields": {
"minimum": 0,
"type": "integer"
},
"unsupported_fields": {
"items": {
"minLength": 1,
"type": "string"
},
"type": "array"
},
"vector": {
"items": {
"$ref": "#/$defs/pcc/definitions/completeness_vector_entry"
},
"type": "array"
}
},
"required": [
"requested_fields",
"populated_fields",
"supported_fields",
"score",
"missing_fields",
"unsupported_fields",
"stale_fields",
"vector"
],
"type": "object"
},
"completeness_vector_entry": {
"additionalProperties": false,
"properties": {
"dimension": {
"minLength": 1,
"type": "string"
},
"populated": {
"minimum": 0,
"type": "integer"
},
"requested": {
"minimum": 0,
"type": "integer"
},
"score": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"supported": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"dimension",
"requested",
"populated",
"supported",
"score"
],
"type": "object"
},
"contract": {
"additionalProperties": false,
"properties": {
"currency": {
"$ref": "#/$defs/pcc/definitions/currency"
},
"expires_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"freshness_seconds": {
"minimum": 1,
"type": "integer"
},
"idempotency_key": {
"$ref": "#/$defs/pcc/definitions/idempotency_key"
},
"input_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"input_schema_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"issued_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"maximum_authorized_price": {
"$ref": "#/$defs/pcc/definitions/decimal_string"
},
"minimum_quality": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"mode": {
"$ref": "#/$defs/pcc/definitions/contract_mode"
},
"network": {
"enum": [
"base",
"base-testnet"
],
"type": "string"
},
"output_schema_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"price": {
"$ref": "#/$defs/pcc/definitions/decimal_string"
},
"quote_id": {
"$ref": "#/$defs/pcc/definitions/quote_id"
},
"service_id": {
"$ref": "#/$defs/pcc/definitions/service_id"
},
"service_version": {
"$ref": "#/$defs/pcc/definitions/service_version"
}
},
"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"
],
"type": "object"
},
"contract_mode": {
"description": "Contract mode determines required fields",
"enum": [
"paid",
"benchmark",
"offline_verification"
],
"type": "string"
},
"currency": {
"description": "Permitted currencies",
"enum": [
"USD",
"USDC"
],
"type": "string"
},
"decimal_string": {
"description": "Non-negative decimal string, no scientific notation, no leading zeros except single zero",
"pattern": "^(0|[1-9]\\d*)(\\.\\d+)?$",
"type": "string"
},
"evidence_id": {
"description": "Evidence identifier",
"pattern": "^evd_[a-z0-9]{24}$",
"type": "string"
},
"evidence_item": {
"additionalProperties": false,
"properties": {
"accessibility_status": {
"$ref": "#/$defs/pcc/definitions/accessibility_status"
},
"authorization_classification": {
"$ref": "#/$defs/pcc/definitions/authorization_classification"
},
"content_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"evidence_id": {
"$ref": "#/$defs/pcc/definitions/evidence_id"
},
"freshness_status": {
"$ref": "#/$defs/pcc/definitions/freshness_status"
},
"locator": {
"$ref": "#/$defs/pcc/definitions/locator"
},
"media_type": {
"minLength": 1,
"type": "string"
},
"retrieved_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"source_timestamp": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"source_uri": {
"format": "uri",
"minLength": 1,
"type": "string"
},
"transformation_history": {
"items": {
"$ref": "#/$defs/pcc/definitions/transformation"
},
"type": "array"
}
},
"required": [
"evidence_id",
"source_uri",
"retrieved_at",
"content_hash",
"media_type",
"locator",
"accessibility_status",
"transformation_history",
"authorization_classification",
"freshness_status"
],
"type": "object"
},
"extension_container": {
"additionalProperties": false,
"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,
"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"
}
},
"propertyNames": {
"maxLength": 253,
"minLength": 5,
"pattern": "^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?){2,}$",
"type": "string"
},
"type": "object"
},
"extension_value": {
"additionalProperties": true,
"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,
"type": "object"
},
"freshness_status": {
"description": "Evidence freshness status",
"enum": [
"fresh",
"stale",
"unknown"
],
"type": "string"
},
"hash": {
"description": "SHA-256 hash with algorithm tag",
"pattern": "^sha256:[a-f0-9]{64}$",
"type": "string"
},
"idempotency_key": {
"description": "Idempotency key",
"pattern": "^idk_[a-z0-9]{24}$",
"type": "string"
},
"job_id": {
"description": "Unique job identifier",
"pattern": "^job_[a-z0-9]{24}$",
"type": "string"
},
"key_id": {
"description": "Key identifier",
"pattern": "^kid_[a-z0-9]{24}$",
"type": "string"
},
"locator": {
"additionalProperties": false,
"properties": {
"type": {
"$ref": "#/$defs/pcc/definitions/locator_type"
},
"value": {
"minLength": 1,
"type": "string"
}
},
"required": [
"type",
"value"
],
"type": "object"
},
"locator_type": {
"description": "Evidence locator type",
"enum": [
"json_pointer",
"xpath",
"css_selector",
"text_quote",
"page_region",
"byte_range",
"database_record",
"artifact_pointer"
],
"type": "string"
},
"materiality": {
"description": "Claim materiality classification",
"enum": [
"material",
"supporting",
"contextual"
],
"type": "string"
},
"pcc_version": {
"const": "1.0.0",
"description": "PCC specification version",
"type": "string"
},
"policy_id": {
"description": "Policy identifier",
"pattern": "^pol_[a-z0-9]{24}$",
"type": "string"
},
"provenance": {
"additionalProperties": false,
"properties": {
"cache_provenance": {
"additionalProperties": false,
"properties": {
"cache_key": {
"type": "string"
},
"enabled": {
"type": "boolean"
},
"hit": {
"type": "boolean"
},
"stored_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
}
},
"required": [
"enabled",
"hit"
],
"type": "object"
},
"execution_environment": {
"additionalProperties": false,
"properties": {
"container_image": {
"type": "string"
},
"platform": {
"minLength": 1,
"type": "string"
},
"runtime": {
"minLength": 1,
"type": "string"
},
"version": {
"minLength": 1,
"type": "string"
}
},
"required": [
"runtime",
"version",
"platform"
],
"type": "object"
},
"models": {
"items": {
"additionalProperties": false,
"properties": {
"name": {
"minLength": 1,
"type": "string"
},
"provider": {
"minLength": 1,
"type": "string"
},
"version": {
"minLength": 1,
"type": "string"
}
},
"required": [
"name",
"version",
"provider"
],
"type": "object"
},
"type": "array"
},
"policy_versions": {
"additionalProperties": {
"type": "string"
},
"description": "Policy name to version mapping",
"type": "object"
},
"providers": {
"items": {
"additionalProperties": false,
"properties": {
"capabilities": {
"items": {
"type": "string"
},
"type": "array"
},
"name": {
"minLength": 1,
"type": "string"
},
"version": {
"minLength": 1,
"type": "string"
}
},
"required": [
"name",
"version",
"capabilities"
],
"type": "object"
},
"type": "array"
},
"routes": {
"items": {
"$ref": "#/$defs/pcc/definitions/provenance_route"
},
"type": "array"
},
"software_versions": {
"additionalProperties": {
"type": "string"
},
"description": "Component name to version mapping",
"type": "object"
},
"tools": {
"additionalProperties": {
"type": "string"
},
"description": "Tool name to version mapping",
"type": "object"
},
"transformations": {
"items": {
"$ref": "#/$defs/pcc/definitions/transformation"
},
"type": "array"
},
"verification_routes": {
"items": {
"$ref": "#/$defs/pcc/definitions/provenance_route"
},
"type": "array"
}
},
"required": [
"routes",
"providers",
"tools",
"models",
"software_versions",
"policy_versions",
"transformations",
"cache_provenance",
"execution_environment",
"verification_routes"
],
"type": "object"
},
"provenance_route": {
"additionalProperties": false,
"properties": {
"model_name": {
"type": "string"
},
"model_version": {
"type": "string"
},
"parameters": {
"additionalProperties": true,
"type": "object"
},
"provider": {
"minLength": 1,
"type": "string"
},
"type": {
"enum": [
"cache",
"direct",
"deterministic",
"model",
"hybrid"
],
"type": "string"
},
"version": {
"minLength": 1,
"type": "string"
}
},
"required": [
"type",
"provider",
"version"
],
"type": "object"
},
"quote_id": {
"description": "Quote identifier",
"pattern": "^qte_[a-z0-9]{24}$",
"type": "string"
},
"receipt": {
"additionalProperties": false,
"properties": {
"canonicalization_algorithm": {
"$ref": "#/$defs/pcc/definitions/canonicalization_algorithm"
},
"output_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"policy_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"schema_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"signature": {
"pattern": "^[A-Za-z0-9_-]{86,88}$",
"type": "string"
},
"signature_algorithm": {
"$ref": "#/$defs/pcc/definitions/signature_algorithm"
},
"signed_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"signing_key_id": {
"$ref": "#/$defs/pcc/definitions/key_id"
}
},
"required": [
"output_hash",
"canonicalization_algorithm",
"policy_hash",
"schema_hash",
"signature_algorithm",
"signing_key_id",
"signature",
"signed_at"
],
"type": "object"
},
"service_id": {
"description": "Service identifier",
"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"
},
"service_version": {
"description": "Service version",
"pattern": "^v\\d+(\\.\\d+)*$",
"type": "string"
},
"signature_algorithm": {
"const": "Ed25519",
"description": "Signature algorithm",
"type": "string"
},
"subject": {
"additionalProperties": false,
"properties": {
"canonical_name": {
"minLength": 1,
"type": "string"
},
"identifiers": {
"additionalProperties": {
"type": "string"
},
"type": "object"
},
"type": {
"$ref": "#/$defs/pcc/definitions/subject_type"
}
},
"required": [
"type",
"canonical_name"
],
"type": "object"
},
"subject_type": {
"description": "Subject type",
"enum": [
"organization",
"person",
"document",
"webpage",
"other"
],
"type": "string"
},
"timestamp_rfc3339": {
"description": "RFC 3339 UTC timestamp with Z suffix, normalized fractional seconds",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?Z$",
"type": "string"
},
"transformation": {
"additionalProperties": false,
"properties": {
"parameters": {
"additionalProperties": true,
"type": "object"
},
"timestamp": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"tool_version": {
"minLength": 1,
"type": "string"
},
"type": {
"minLength": 1,
"type": "string"
}
},
"required": [
"type",
"timestamp",
"tool_version"
],
"type": "object"
},
"verification": {
"additionalProperties": false,
"properties": {
"completeness": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"cross_source_agreement": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"decision": {
"$ref": "#/$defs/pcc/definitions/verification_decision"
},
"deterministic_failures": {
"items": {
"minLength": 1,
"type": "string"
},
"type": "array"
},
"evidence_accessibility": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"failed_requirements": {
"items": {
"minLength": 1,
"type": "string"
},
"type": "array"
},
"freshness": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"material_claims_supported": {
"type": "boolean"
},
"policy": {
"$ref": "#/$defs/pcc/definitions/policy_id"
},
"prompt_injection_result": {
"additionalProperties": false,
"properties": {
"checked": {
"type": "boolean"
},
"details": {
"type": "string"
},
"result": {
"enum": [
"clean",
"suspected",
"confirmed"
],
"type": "string"
}
},
"required": [
"checked",
"result"
],
"type": "object"
},
"provenance_valid": {
"type": "boolean"
},
"schema_valid": {
"type": "boolean"
},
"score": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"verifier_versions": {
"additionalProperties": {
"type": "string"
},
"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"
],
"type": "object"
},
"verification_decision": {
"description": "Verification decision",
"enum": [
"pass",
"conditional",
"fail",
"quarantined"
],
"type": "string"
},
"verification_status": {
"description": "Claim verification status",
"enum": [
"verified",
"unsupported",
"disputed",
"pending"
],
"type": "string"
}
},
"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",
"properties": {
"claims": {
"items": {
"$ref": "#/$defs/pcc/definitions/claim"
},
"type": "array",
"uniqueItems": true
},
"completeness": {
"$ref": "#/$defs/pcc/definitions/completeness"
},
"contract": {
"$ref": "#/$defs/pcc/definitions/contract"
},
"evidence": {
"items": {
"$ref": "#/$defs/pcc/definitions/evidence_item"
},
"type": "array",
"uniqueItems": true
},
"extensions": {
"$ref": "#/$defs/pcc/definitions/extension_container"
},
"job_id": {
"$ref": "#/$defs/pcc/definitions/job_id"
},
"pcc_version": {
"$ref": "#/$defs/pcc/definitions/pcc_version"
},
"provenance": {
"$ref": "#/$defs/pcc/definitions/provenance"
},
"receipt": {
"$ref": "#/$defs/pcc/definitions/receipt"
},
"subject": {
"$ref": "#/$defs/pcc/definitions/subject"
},
"verification": {
"$ref": "#/$defs/pcc/definitions/verification"
}
},
"required": [
"pcc_version",
"job_id",
"contract",
"subject",
"claims",
"evidence",
"completeness",
"provenance",
"verification",
"receipt"
],
"title": "Proof-Carrying Context (PCC) v1.0.0",
"type": "object"
}
},
"$id": "https://siteborne.net/schemas/services/document-evidence-output.schema.json",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"allOf": [
{
"$ref": "#/$defs/pcc"
},
{
"properties": {
"contract": {
"properties": {
"output_schema_hash": {
"pattern": "^sha256:[a-f0-9]{64}$",
"type": "string"
},
"service_id": {
"enum": [
"document_evidence_json.v1",
"document_evidence_json.v2"
]
},
"service_version": {
"enum": [
"v1",
"v2"
]
}
},
"required": [
"service_id",
"service_version",
"output_schema_hash"
],
"type": "object"
},
"extensions": {
"properties": {
"net.siteborne.document-evidence.v1": {
"additionalProperties": false,
"description": "Document evidence extension payload.",
"properties": {
"calculated_billable_units": {
"additionalProperties": false,
"properties": {
"native_text_pages": {
"minimum": 0,
"type": "integer"
},
"ocr_pages": {
"minimum": 0,
"type": "integer"
},
"table_pages": {
"minimum": 0,
"type": "integer"
},
"total_billable": {
"minimum": 0,
"type": "integer"
}
},
"type": "object"
},
"document_classification": {
"enum": [
"contract",
"invoice",
"report",
"form",
"letter",
"financial_statement",
"regulatory_filing",
"other"
],
"type": "string"
},
"estimated_or_final_amount": {
"$ref": "#/$defs/money"
},
"extracted_data": {
"additionalProperties": true,
"description": "Structured extraction results.",
"type": "object"
},
"limitations": {
"items": {
"maxLength": 256,
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"media_type_confirmed": {
"type": "string"
},
"ocr_confidence": {
"items": {
"additionalProperties": false,
"properties": {
"low_confidence_regions": {
"items": {
"type": "string"
},
"type": "array"
},
"mean_confidence": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"page": {
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"maxItems": 10,
"type": "array"
},
"page_classifications": {
"items": {
"additionalProperties": false,
"properties": {
"classification": {
"enum": [
"native_text",
"ocr",
"table_heavy",
"image_only",
"unsupported"
],
"type": "string"
},
"confidence": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"extraction_method": {
"enum": [
"native",
"ocr",
"hybrid",
"none"
],
"type": "string"
},
"page_number": {
"minimum": 1,
"type": "integer"
}
},
"required": [
"page_number",
"classification"
],
"type": "object"
},
"maxItems": 10,
"type": "array"
},
"page_warnings": {
"items": {
"additionalProperties": false,
"properties": {
"page": {
"minimum": 1,
"type": "integer"
},
"severity": {
"enum": [
"low",
"medium",
"high"
],
"type": "string"
},
"warning": {
"type": "string"
}
},
"type": "object"
},
"maxItems": 50,
"type": "array"
},
"processed_pages": {
"maximum": 10,
"minimum": 0,
"type": "integer"
},
"retention_result": {
"additionalProperties": false,
"properties": {
"expires_at": {
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?Z$",
"type": "string"
},
"stored": {
"type": "boolean"
}
},
"type": "object"
},
"size_bytes_confirmed": {
"minimum": 1,
"type": "integer"
},
"tables": {
"items": {
"additionalProperties": false,
"properties": {
"bbox": {
"items": {
"type": "number"
},
"maxItems": 4,
"minItems": 4,
"type": "array"
},
"headers": {
"items": {
"type": "string"
},
"type": "array"
},
"page": {
"minimum": 1,
"type": "integer"
},
"rows": {
"items": {
"items": {
"type": "string"
},
"type": "array"
},
"type": "array"
},
"table_index": {
"minimum": 0,
"type": "integer"
}
},
"type": "object"
},
"maxItems": 50,
"type": "array"
},
"text_blocks": {
"items": {
"additionalProperties": false,
"properties": {
"bbox": {
"items": {
"type": "number"
},
"maxItems": 4,
"minItems": 4,
"type": "array"
},
"page": {
"minimum": 1,
"type": "integer"
},
"text": {
"type": "string"
}
},
"type": "object"
},
"maxItems": 100,
"type": "array"
},
"total_pages": {
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"truncation": {
"additionalProperties": false,
"properties": {
"pages_omitted": {
"items": {
"type": "integer"
},
"type": "array"
},
"truncated": {
"type": "boolean"
}
},
"type": "object"
},
"unsupported_content": {
"items": {
"additionalProperties": false,
"properties": {
"page": {
"minimum": 1,
"type": "integer"
},
"reason": {
"type": "string"
}
},
"type": "object"
},
"maxItems": 20,
"type": "array"
}
},
"type": "object"
}
},
"propertyNames": {
"maxLength": 253,
"minLength": 5,
"pattern": "^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?){2,}$",
"type": "string"
},
"required": [
"net.siteborne.document-evidence.v1"
],
"type": "object"
}
},
"required": [
"contract",
"extensions"
],
"type": "object"
}
],
"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.",
"examples": [
{
"claims": [],
"completeness": {
"missing_fields": [
"ceo_name"
],
"populated_fields": 4,
"requested_fields": 5,
"score": 0.8,
"stale_fields": [],
"supported_fields": 4,
"unsupported_fields": [],
"vector": [
{
"dimension": "general",
"populated": 4,
"requested": 5,
"score": 0.8,
"supported": 4
}
]
},
"contract": {
"currency": "USD",
"expires_at": "2026-08-06T10:00:00Z",
"freshness_seconds": 3600,
"idempotency_key": "idk_aaaaaaaaaaaaaaaaaaaaaaaa",
"input_hash": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"input_schema_hash": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
"issued_at": "2026-08-05T10:00:00Z",
"minimum_quality": 0.8,
"mode": "paid",
"output_schema_hash": "sha256:abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
"quote_id": "qte_aaaaaaaaaaaaaaaaaaaaaaaa",
"service_id": "document_evidence_json.v1",
"service_version": "v1"
},
"evidence": [],
"extensions": {
"net.siteborne.document-evidence.v1": {
"calculated_billable_units": {
"native_text_pages": 2,
"table_pages": 1,
"total_billable": 3
},
"document_classification": "contract",
"limitations": [
"tables on page 2 may need review"
],
"media_type_confirmed": "application/pdf",
"page_classifications": [
{
"classification": "native_text",
"extraction_method": "native",
"page_number": 1
},
{
"classification": "table_heavy",
"extraction_method": "native",
"page_number": 2
},
{
"classification": "native_text",
"extraction_method": "native",
"page_number": 3
}
],
"processed_pages": 5,
"size_bytes_confirmed": 2048576,
"total_pages": 5
}
},
"job_id": "job_aaaaaaaaaaaaaaaaaaaaaaaa",
"pcc_version": "1.0.0",
"provenance": {
"cache_provenance": {
"enabled": false,
"hit": false
},
"execution_environment": {
"platform": "linux",
"runtime": "node",
"version": "22.0.0"
},
"models": [],
"policy_versions": {
"verification": "1.0.0"
},
"providers": [
{
"capabilities": [
"fetch"
],
"name": "web",
"version": "1.0.0"
}
],
"routes": [
{
"provider": "web",
"type": "direct",
"version": "1.0.0"
}
],
"software_versions": {
"pcc": "1.0.0"
},
"tools": {
"curl": "8.0.0"
},
"transformations": [],
"verification_routes": []
},
"receipt": {
"canonicalization_algorithm": "RFC8785-JCS",
"output_hash": "sha256:eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
"policy_hash": "sha256:ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
"schema_hash": "sha256:0000000000000000000000000000000000000000000000000000000000000000",
"signature": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"signature_algorithm": "Ed25519",
"signed_at": "2026-08-05T10:00:00Z",
"signing_key_id": "kid_aaaaaaaaaaaaaaaaaaaaaaaa"
},
"subject": {
"canonical_name": "Acme Example Corp",
"identifiers": {
"domain": "acme.example.com"
},
"type": "organization"
},
"verification": {
"completeness": 0.8,
"cross_source_agreement": 1,
"decision": "pass",
"deterministic_failures": [],
"evidence_accessibility": 1,
"failed_requirements": [],
"freshness": 1,
"material_claims_supported": true,
"policy": "pol_aaaaaaaaaaaaaaaaaaaaaaaa",
"prompt_injection_result": {
"checked": true,
"result": "clean"
},
"provenance_valid": true,
"schema_valid": true,
"score": 0.9,
"verifier_versions": {
"pcc": "1.0.0"
}
}
}
],
"title": "Document Evidence JSON Output"
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$id": "https://siteborne.net/schemas/services/document-evidence-input.schema.json",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"description": "Input schema for document_evidence_json.v1 service. Exactly one document reference mode required.",
"examples": [
{
"artifact_reference": {
"artifact_id": "doc/abc123/contract.pdf",
"authorization": "buyer_authorized",
"content_hash": "sha256:abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
"media_type": "application/pdf",
"page_count": 5,
"size_bytes": 2048576
},
"extraction_request": {
"extract_key_values": true,
"extract_tables": true
},
"maximum_authorized_price": {
"amount": "0.19",
"currency": "USD"
},
"ocr_permission": true
}
],
"oneOf": [
{
"required": [
"artifact_reference"
]
},
{
"required": [
"upload_reference"
]
},
{
"required": [
"document_url"
]
}
],
"properties": {
"artifact_reference": {
"additionalProperties": false,
"description": "Authorized stored-artifact descriptor for reference mode 1; use exactly one of artifact_reference, upload_reference, or document_url.",
"examples": [
{
"artifact_id": "doc/abc123/evidence.pdf",
"authorization": "buyer_authorized",
"content_hash": "sha256:abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
"media_type": "application/pdf",
"page_count": 5,
"size_bytes": 2048576
}
],
"properties": {
"access_token": {
"description": "Short-lived access token for private artifacts. Must not be logged.",
"maxLength": 2048,
"type": "string"
},
"artifact_id": {
"description": "Unique artifact identifier (e.g., R2 object key, artifact registry ID).",
"maxLength": 512,
"type": "string"
},
"authorization": {
"description": "Authorization classification.",
"enum": [
"public",
"buyer_authorized"
],
"type": "string"
},
"content_hash": {
"description": "SHA-256 content hash for integrity verification.",
"pattern": "^sha256:[a-f0-9]{64}$",
"type": "string"
},
"media_type": {
"description": "Declared MIME type of the artifact.",
"enum": [
"application/pdf",
"image/png",
"image/jpeg"
],
"type": "string"
},
"page_count": {
"description": "Declared page count when known.",
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"size_bytes": {
"description": "Declared size in bytes.",
"maximum": 10485760,
"minimum": 1,
"type": "integer"
}
},
"required": [
"artifact_id",
"media_type",
"size_bytes"
],
"title": "Authorized Artifact Reference",
"type": "object"
},
"declared_page_count": {
"description": "Optional declared page count from 1 through 10; enables early scope validation but does not override the observed document.",
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"document_url": {
"description": "Public document URL for reference mode 3; use exactly one reference mode and never put credentials in this URL.",
"format": "uri",
"maxLength": 2048,
"type": "string"
},
"extraction_request": {
"additionalProperties": false,
"description": "Selects text, table, key-value, and buyer-schema extraction outputs; omitted switches retain their documented defaults.",
"properties": {
"buyer_schema": {
"additionalProperties": true,
"description": "Optional JSON Schema, bounded to fifty properties and depth five, used to validate buyer-shaped extracted data.",
"maxDepth": 5,
"maxProperties": 50,
"type": "object"
},
"extract_key_values": {
"default": false,
"description": "Whether key-value extraction is requested; defaults to false.",
"type": "boolean"
},
"extract_tables": {
"default": false,
"description": "Whether bounded table extraction is requested; defaults to false and may increase processing work.",
"type": "boolean"
},
"extract_text": {
"default": true,
"description": "Whether normalized text extraction is requested; defaults to true.",
"type": "boolean"
}
},
"type": "object"
},
"language_hints": {
"description": "Up to five BCP 47 language hints used by OCR and extraction; hints do not translate the document.",
"items": {
"pattern": "^[a-z]{2,3}(-[A-Z]{2})?$",
"type": "string"
},
"maxItems": 5,
"type": "array"
},
"maximum_authorized_price": {
"additionalProperties": false,
"description": "Buyer’s decimal-safe maximum authorized price; constrains the payment requirement and not retention or extraction policy.",
"examples": [
{
"amount": "0.039",
"currency": "USD"
},
{
"amount": "0.19",
"asset": "USDC",
"currency": "USD",
"network": "base-mainnet"
}
],
"properties": {
"amount": {
"description": "Canonical decimal string. No scientific notation, no leading zeros (except single '0'), no trailing zeros unless significant, no sign. Maximum 18 decimal places.",
"examples": [
"0",
"0.009",
"0.012",
"0.019",
"0.029",
"0.039",
"0.049",
"0.19"
],
"pattern": "^(0|[1-9][0-9]*)(\\.[0-9]{1,18})?$",
"type": "string"
},
"asset": {
"description": "Payment asset identifier (e.g., 'USDC', 'ETH'). Optional for non-payment contexts.",
"pattern": "^[A-Z0-9]{3,10}$",
"type": "string"
},
"currency": {
"default": "USD",
"description": "ISO 4217 currency code.",
"enum": [
"USD"
],
"pattern": "^[A-Z]{3}$",
"type": "string"
},
"network": {
"description": "Payment network identifier (e.g., 'base-mainnet', 'base-sepolia'). Optional for non-payment contexts.",
"maxLength": 64,
"pattern": "^[a-z0-9-]+$",
"type": "string"
},
"precision": {
"default": 6,
"description": "Maximum decimal places supported by the asset/network. Metadata only.",
"maximum": 18,
"minimum": 0,
"type": "integer"
}
},
"required": [
"amount",
"currency"
],
"title": "Decimal Money",
"type": "object"
},
"minimum_verification_score": {
"default": 0.7,
"description": "Required PCC verification ratio from 0 through 1; raising it makes extracted-evidence acceptance stricter.",
"maximum": 1,
"minimum": 0,
"type": "number"
},
"ocr_permission": {
"default": false,
"description": "Explicit permission to use OCR for image-based content; false prevents OCR even when text is not embedded.",
"type": "boolean"
},
"page_range": {
"additionalProperties": false,
"description": "Optional one-indexed inclusive page range to process; both bounds are limited to pages 1 through 10.",
"properties": {
"end": {
"description": "Last one-indexed page to process, inclusive and not before start.",
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"start": {
"description": "First one-indexed page to process, inclusive.",
"maximum": 10,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"retention_preference": {
"default": "temporary",
"description": "Requested retention class—none, temporary, or permanent—subject to server policy; it cannot override mandatory retention limits.",
"enum": [
"none",
"temporary",
"permanent"
],
"type": "string"
},
"table_extraction_request": {
"default": false,
"description": "Explicit top-level request for table extraction; false leaves tables unrequested.",
"type": "boolean"
},
"upload_reference": {
"additionalProperties": false,
"description": "Previously issued SITEBORNE upload handle and declared file metadata for reference mode 2; it does not upload document bytes.",
"properties": {
"content_hash": {
"description": "Optional lowercase SHA-256 integrity identifier in sha256:<64 hex> form; when supplied it must match the artifact.",
"pattern": "^sha256:[a-f0-9]{64}$",
"type": "string"
},
"media_type": {
"description": "Declared parser media type: PDF, PNG, or JPEG; it must match the stored artifact.",
"enum": [
"application/pdf",
"image/png",
"image/jpeg"
],
"type": "string"
},
"size_bytes": {
"description": "Declared artifact size in bytes, from 1 through 10,485,760; it is checked against stored metadata.",
"maximum": 10485760,
"minimum": 1,
"type": "integer"
},
"upload_id": {
"description": "Opaque SITEBORNE upload identifier, up to 512 characters, that selects the already admitted artifact.",
"maxLength": 512,
"type": "string"
}
},
"required": [
"upload_id",
"media_type",
"size_bytes"
],
"type": "object"
}
},
"title": "Document Evidence JSON Input",
"type": "object"
},
"name": "siteborne_extract_document_evidence_json_v3_candidate",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"result": {
"$defs": {
"money": {
"additionalProperties": false,
"description": "Canonical decimal-safe money representation. No binary floating-point. Amount is a canonical decimal string.",
"examples": [
{
"amount": "0.039",
"currency": "USD"
},
{
"amount": "0.19",
"asset": "USDC",
"currency": "USD",
"network": "base-mainnet"
}
],
"properties": {
"amount": {
"description": "Canonical decimal string. No scientific notation, no leading zeros (except single '0'), no trailing zeros unless significant, no sign. Maximum 18 decimal places.",
"examples": [
"0",
"0.009",
"0.012",
"0.019",
"0.029",
"0.039",
"0.049",
"0.19"
],
"pattern": "^(0|[1-9][0-9]*)(\\.[0-9]{1,18})?$",
"type": "string"
},
"asset": {
"description": "Payment asset identifier (e.g., 'USDC', 'ETH'). Optional for non-payment contexts.",
"pattern": "^[A-Z0-9]{3,10}$",
"type": "string"
},
"currency": {
"default": "USD",
"description": "ISO 4217 currency code.",
"enum": [
"USD"
],
"pattern": "^[A-Z]{3}$",
"type": "string"
},
"network": {
"description": "Payment network identifier (e.g., 'base-mainnet', 'base-sepolia'). Optional for non-payment contexts.",
"maxLength": 64,
"pattern": "^[a-z0-9-]+$",
"type": "string"
},
"precision": {
"default": 6,
"description": "Maximum decimal places supported by the asset/network. Metadata only.",
"maximum": 18,
"minimum": 0,
"type": "integer"
}
},
"required": [
"amount",
"currency"
],
"title": "Decimal Money",
"type": "object"
},
"pcc": {
"additionalProperties": false,
"definitions": {
"accessibility_status": {
"description": "Evidence accessibility status",
"enum": [
"accessible",
"unavailable",
"restricted",
"requires_authorization"
],
"type": "string"
},
"authorization_classification": {
"description": "Evidence authorization classification",
"enum": [
"public",
"buyer_authorized",
"restricted",
"confidential"
],
"type": "string"
},
"canonicalization_algorithm": {
"const": "RFC8785-JCS",
"description": "Canonicalization algorithm",
"type": "string"
},
"claim": {
"additionalProperties": false,
"properties": {
"claim_id": {
"$ref": "#/$defs/pcc/definitions/claim_id"
},
"confidence": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"evidence_ids": {
"items": {
"$ref": "#/$defs/pcc/definitions/evidence_id"
},
"type": "array"
},
"materiality": {
"$ref": "#/$defs/pcc/definitions/materiality"
},
"predicate": {
"minLength": 1,
"type": "string"
},
"value": {
"type": [
"string",
"number",
"boolean",
"object",
"array",
"null"
]
},
"verification_status": {
"$ref": "#/$defs/pcc/definitions/verification_status"
}
},
"required": [
"claim_id",
"predicate",
"value",
"confidence",
"evidence_ids",
"materiality",
"verification_status"
],
"type": "object"
},
"claim_id": {
"description": "Claim identifier",
"pattern": "^clm_[a-z0-9]{24}$",
"type": "string"
},
"completeness": {
"additionalProperties": false,
"properties": {
"missing_fields": {
"items": {
"minLength": 1,
"type": "string"
},
"type": "array"
},
"populated_fields": {
"minimum": 0,
"type": "integer"
},
"requested_fields": {
"minimum": 0,
"type": "integer"
},
"score": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"stale_fields": {
"items": {
"minLength": 1,
"type": "string"
},
"type": "array"
},
"supported_fields": {
"minimum": 0,
"type": "integer"
},
"unsupported_fields": {
"items": {
"minLength": 1,
"type": "string"
},
"type": "array"
},
"vector": {
"items": {
"$ref": "#/$defs/pcc/definitions/completeness_vector_entry"
},
"type": "array"
}
},
"required": [
"requested_fields",
"populated_fields",
"supported_fields",
"score",
"missing_fields",
"unsupported_fields",
"stale_fields",
"vector"
],
"type": "object"
},
"completeness_vector_entry": {
"additionalProperties": false,
"properties": {
"dimension": {
"minLength": 1,
"type": "string"
},
"populated": {
"minimum": 0,
"type": "integer"
},
"requested": {
"minimum": 0,
"type": "integer"
},
"score": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"supported": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"dimension",
"requested",
"populated",
"supported",
"score"
],
"type": "object"
},
"contract": {
"additionalProperties": false,
"properties": {
"currency": {
"$ref": "#/$defs/pcc/definitions/currency"
},
"expires_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"freshness_seconds": {
"minimum": 1,
"type": "integer"
},
"idempotency_key": {
"$ref": "#/$defs/pcc/definitions/idempotency_key"
},
"input_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"input_schema_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"issued_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"maximum_authorized_price": {
"$ref": "#/$defs/pcc/definitions/decimal_string"
},
"minimum_quality": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"mode": {
"$ref": "#/$defs/pcc/definitions/contract_mode"
},
"network": {
"enum": [
"base",
"base-testnet"
],
"type": "string"
},
"output_schema_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"price": {
"$ref": "#/$defs/pcc/definitions/decimal_string"
},
"quote_id": {
"$ref": "#/$defs/pcc/definitions/quote_id"
},
"service_id": {
"$ref": "#/$defs/pcc/definitions/service_id"
},
"service_version": {
"$ref": "#/$defs/pcc/definitions/service_version"
}
},
"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"
],
"type": "object"
},
"contract_mode": {
"description": "Contract mode determines required fields",
"enum": [
"paid",
"benchmark",
"offline_verification"
],
"type": "string"
},
"currency": {
"description": "Permitted currencies",
"enum": [
"USD",
"USDC"
],
"type": "string"
},
"decimal_string": {
"description": "Non-negative decimal string, no scientific notation, no leading zeros except single zero",
"pattern": "^(0|[1-9]\\d*)(\\.\\d+)?$",
"type": "string"
},
"evidence_id": {
"description": "Evidence identifier",
"pattern": "^evd_[a-z0-9]{24}$",
"type": "string"
},
"evidence_item": {
"additionalProperties": false,
"properties": {
"accessibility_status": {
"$ref": "#/$defs/pcc/definitions/accessibility_status"
},
"authorization_classification": {
"$ref": "#/$defs/pcc/definitions/authorization_classification"
},
"content_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"evidence_id": {
"$ref": "#/$defs/pcc/definitions/evidence_id"
},
"freshness_status": {
"$ref": "#/$defs/pcc/definitions/freshness_status"
},
"locator": {
"$ref": "#/$defs/pcc/definitions/locator"
},
"media_type": {
"minLength": 1,
"type": "string"
},
"retrieved_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"source_timestamp": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"source_uri": {
"format": "uri",
"minLength": 1,
"type": "string"
},
"transformation_history": {
"items": {
"$ref": "#/$defs/pcc/definitions/transformation"
},
"type": "array"
}
},
"required": [
"evidence_id",
"source_uri",
"retrieved_at",
"content_hash",
"media_type",
"locator",
"accessibility_status",
"transformation_history",
"authorization_classification",
"freshness_status"
],
"type": "object"
},
"extension_container": {
"additionalProperties": false,
"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,
"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"
}
},
"propertyNames": {
"maxLength": 253,
"minLength": 5,
"pattern": "^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?){2,}$",
"type": "string"
},
"type": "object"
},
"extension_value": {
"additionalProperties": true,
"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,
"type": "object"
},
"freshness_status": {
"description": "Evidence freshness status",
"enum": [
"fresh",
"stale",
"unknown"
],
"type": "string"
},
"hash": {
"description": "SHA-256 hash with algorithm tag",
"pattern": "^sha256:[a-f0-9]{64}$",
"type": "string"
},
"idempotency_key": {
"description": "Idempotency key",
"pattern": "^idk_[a-z0-9]{24}$",
"type": "string"
},
"job_id": {
"description": "Unique job identifier",
"pattern": "^job_[a-z0-9]{24}$",
"type": "string"
},
"key_id": {
"description": "Key identifier",
"pattern": "^kid_[a-z0-9]{24}$",
"type": "string"
},
"locator": {
"additionalProperties": false,
"properties": {
"type": {
"$ref": "#/$defs/pcc/definitions/locator_type"
},
"value": {
"minLength": 1,
"type": "string"
}
},
"required": [
"type",
"value"
],
"type": "object"
},
"locator_type": {
"description": "Evidence locator type",
"enum": [
"json_pointer",
"xpath",
"css_selector",
"text_quote",
"page_region",
"byte_range",
"database_record",
"artifact_pointer"
],
"type": "string"
},
"materiality": {
"description": "Claim materiality classification",
"enum": [
"material",
"supporting",
"contextual"
],
"type": "string"
},
"pcc_version": {
"const": "2.0.0",
"description": "PCC specification version",
"type": "string"
},
"policy_id": {
"description": "Policy identifier",
"pattern": "^pol_[a-z0-9]{24}$",
"type": "string"
},
"provenance": {
"additionalProperties": false,
"properties": {
"cache_provenance": {
"additionalProperties": false,
"properties": {
"cache_key": {
"type": "string"
},
"enabled": {
"type": "boolean"
},
"hit": {
"type": "boolean"
},
"stored_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
}
},
"required": [
"enabled",
"hit"
],
"type": "object"
},
"execution_environment": {
"additionalProperties": false,
"properties": {
"container_image": {
"type": "string"
},
"platform": {
"minLength": 1,
"type": "string"
},
"runtime": {
"minLength": 1,
"type": "string"
},
"version": {
"minLength": 1,
"type": "string"
}
},
"required": [
"runtime",
"version",
"platform"
],
"type": "object"
},
"models": {
"items": {
"additionalProperties": false,
"properties": {
"name": {
"minLength": 1,
"type": "string"
},
"provider": {
"minLength": 1,
"type": "string"
},
"version": {
"minLength": 1,
"type": "string"
}
},
"required": [
"name",
"version",
"provider"
],
"type": "object"
},
"type": "array"
},
"policy_versions": {
"additionalProperties": {
"type": "string"
},
"description": "Policy name to version mapping",
"type": "object"
},
"providers": {
"items": {
"additionalProperties": false,
"properties": {
"capabilities": {
"items": {
"type": "string"
},
"type": "array"
},
"name": {
"minLength": 1,
"type": "string"
},
"version": {
"minLength": 1,
"type": "string"
}
},
"required": [
"name",
"version",
"capabilities"
],
"type": "object"
},
"type": "array"
},
"routes": {
"items": {
"$ref": "#/$defs/pcc/definitions/provenance_route"
},
"type": "array"
},
"software_versions": {
"additionalProperties": {
"type": "string"
},
"description": "Component name to version mapping",
"type": "object"
},
"tools": {
"additionalProperties": {
"type": "string"
},
"description": "Tool name to version mapping",
"type": "object"
},
"transformations": {
"items": {
"$ref": "#/$defs/pcc/definitions/transformation"
},
"type": "array"
},
"verification_routes": {
"items": {
"$ref": "#/$defs/pcc/definitions/provenance_route"
},
"type": "array"
}
},
"required": [
"routes",
"providers",
"tools",
"models",
"software_versions",
"policy_versions",
"transformations",
"cache_provenance",
"execution_environment",
"verification_routes"
],
"type": "object"
},
"provenance_route": {
"additionalProperties": false,
"properties": {
"model_name": {
"type": "string"
},
"model_version": {
"type": "string"
},
"parameters": {
"additionalProperties": true,
"type": "object"
},
"provider": {
"minLength": 1,
"type": "string"
},
"type": {
"enum": [
"cache",
"direct",
"deterministic",
"model",
"hybrid"
],
"type": "string"
},
"version": {
"minLength": 1,
"type": "string"
}
},
"required": [
"type",
"provider",
"version"
],
"type": "object"
},
"public_verifier_result": {
"additionalProperties": false,
"properties": {
"failure_codes": {
"items": {
"minLength": 1,
"type": "string"
},
"maxItems": 200,
"type": "array"
},
"findings": {
"items": {
"additionalProperties": false,
"properties": {
"code": {
"minLength": 1,
"type": "string"
},
"severity": {
"minLength": 1,
"type": "string"
}
},
"required": [
"code",
"severity"
],
"type": "object"
},
"maxItems": 200,
"type": "array"
},
"status": {
"minLength": 1,
"type": "string"
},
"verifier_id": {
"minLength": 1,
"type": "string"
}
},
"required": [
"verifier_id",
"status",
"findings",
"failure_codes"
],
"type": "object"
},
"quote_id": {
"description": "Quote identifier",
"pattern": "^qte_[a-z0-9]{24}$",
"type": "string"
},
"receipt": {
"additionalProperties": false,
"properties": {
"canonicalization_algorithm": {
"$ref": "#/$defs/pcc/definitions/canonicalization_algorithm"
},
"output_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"policy_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"schema_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"signature": {
"pattern": "^[A-Za-z0-9_-]{86,88}$",
"type": "string"
},
"signature_algorithm": {
"$ref": "#/$defs/pcc/definitions/signature_algorithm"
},
"signed_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"signing_key_id": {
"$ref": "#/$defs/pcc/definitions/key_id"
}
},
"required": [
"output_hash",
"canonicalization_algorithm",
"policy_hash",
"schema_hash",
"signature_algorithm",
"signing_key_id",
"signature",
"signed_at"
],
"type": "object"
},
"service_id": {
"description": "Service identifier",
"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"
},
"service_version": {
"description": "Service version",
"pattern": "^v\\d+(\\.\\d+)*$",
"type": "string"
},
"signature_algorithm": {
"const": "Ed25519",
"description": "Signature algorithm",
"type": "string"
},
"subject": {
"additionalProperties": false,
"properties": {
"canonical_name": {
"minLength": 1,
"type": "string"
},
"identifiers": {
"additionalProperties": {
"type": "string"
},
"type": "object"
},
"type": {
"$ref": "#/$defs/pcc/definitions/subject_type"
}
},
"required": [
"type",
"canonical_name"
],
"type": "object"
},
"subject_type": {
"description": "Subject type",
"enum": [
"organization",
"person",
"document",
"webpage",
"other"
],
"type": "string"
},
"timestamp_rfc3339": {
"description": "RFC 3339 UTC timestamp with Z suffix, normalized fractional seconds",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?Z$",
"type": "string"
},
"transformation": {
"additionalProperties": false,
"properties": {
"parameters": {
"additionalProperties": true,
"type": "object"
},
"timestamp": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"tool_version": {
"minLength": 1,
"type": "string"
},
"type": {
"minLength": 1,
"type": "string"
}
},
"required": [
"type",
"timestamp",
"tool_version"
],
"type": "object"
},
"verification": {
"additionalProperties": false,
"properties": {
"completeness": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"cross_source_agreement": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"decision": {
"$ref": "#/$defs/pcc/definitions/verification_decision"
},
"deterministic_failures": {
"items": {
"minLength": 1,
"type": "string"
},
"type": "array"
},
"evidence_accessibility": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"failed_requirements": {
"items": {
"minLength": 1,
"type": "string"
},
"type": "array"
},
"freshness": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"material_claims_supported": {
"type": "boolean"
},
"policy": {
"$ref": "#/$defs/pcc/definitions/policy_id"
},
"prompt_injection_result": {
"additionalProperties": false,
"properties": {
"checked": {
"type": "boolean"
},
"details": {
"type": "string"
},
"result": {
"enum": [
"clean",
"suspected",
"confirmed"
],
"type": "string"
}
},
"required": [
"checked",
"result"
],
"type": "object"
},
"provenance_valid": {
"type": "boolean"
},
"schema_valid": {
"type": "boolean"
},
"score": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"verifier_versions": {
"additionalProperties": {
"type": "string"
},
"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"
],
"type": "object"
},
"verification_decision": {
"description": "Verification decision",
"enum": [
"pass",
"conditional",
"fail",
"quarantined"
],
"type": "string"
},
"verification_proof_v1": {
"additionalProperties": false,
"properties": {
"proof_version": {
"const": "1.0.0",
"type": "string"
},
"receipt": {
"$ref": "#/$defs/pcc/definitions/vnext_receipt"
},
"verification_material": {
"additionalProperties": false,
"properties": {
"verifier_results": {
"items": {
"$ref": "#/$defs/pcc/definitions/public_verifier_result"
},
"maxItems": 100,
"type": "array"
}
},
"required": [
"verifier_results"
],
"type": "object"
}
},
"required": [
"proof_version",
"receipt",
"verification_material"
],
"type": "object"
},
"verification_status": {
"description": "Claim verification status",
"enum": [
"verified",
"unsupported",
"disputed",
"pending"
],
"type": "string"
},
"vnext_receipt": {
"additionalProperties": false,
"properties": {
"canonicalization_algorithm": {
"const": "RFC8785-JCS",
"type": "string"
},
"completeness": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"contract_release": {
"const": "3.0.0",
"type": "string"
},
"decision": {
"$ref": "#/$defs/pcc/definitions/verification_decision"
},
"domain": {
"const": "SITEBORNE-PCC-VERIFICATION-PROOF-V1",
"type": "string"
},
"evidence_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"input_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"issued_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"job_id": {
"$ref": "#/$defs/pcc/definitions/job_id"
},
"limitations": {
"items": {
"minLength": 1,
"type": "string"
},
"maxItems": 200,
"type": "array"
},
"output_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"output_schema_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"pcc_document_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"pcc_schema_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"pcc_schema_release": {
"const": "2.0.0",
"type": "string"
},
"policy_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"proof_version": {
"const": "1.0.0",
"type": "string"
},
"receipt_id": {
"pattern": "^rcpt_[a-f0-9]{24}$",
"type": "string"
},
"receipt_version": {
"const": "2.0.0",
"type": "string"
},
"request_id": {
"minLength": 1,
"type": "string"
},
"service_id": {
"$ref": "#/$defs/pcc/definitions/service_id"
},
"service_version": {
"$ref": "#/$defs/pcc/definitions/service_version"
},
"signature": {
"pattern": "^[A-Za-z0-9_-]{86}$",
"type": "string"
},
"signature_algorithm": {
"const": "Ed25519",
"type": "string"
},
"signing_key_id": {
"minLength": 1,
"type": "string"
},
"verification_mode": {
"enum": [
"standard",
"independent_reproduction"
],
"type": "string"
},
"verifier_set_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
}
},
"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"
],
"type": "object"
},
"vnext_receipt_preimage": {
"additionalProperties": false,
"properties": {
"canonicalization_algorithm": {
"const": "RFC8785-JCS",
"type": "string"
},
"completeness": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"contract_release": {
"const": "3.0.0",
"type": "string"
},
"decision": {
"$ref": "#/$defs/pcc/definitions/verification_decision"
},
"domain": {
"const": "SITEBORNE-PCC-VERIFICATION-PROOF-V1",
"type": "string"
},
"evidence_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"input_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"issued_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"job_id": {
"$ref": "#/$defs/pcc/definitions/job_id"
},
"limitations": {
"items": {
"minLength": 1,
"type": "string"
},
"maxItems": 200,
"type": "array"
},
"output_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"output_schema_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"pcc_document_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"pcc_schema_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"pcc_schema_release": {
"const": "2.0.0",
"type": "string"
},
"policy_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"proof_version": {
"const": "1.0.0",
"type": "string"
},
"receipt_version": {
"const": "2.0.0",
"type": "string"
},
"request_id": {
"minLength": 1,
"type": "string"
},
"service_id": {
"$ref": "#/$defs/pcc/definitions/service_id"
},
"service_version": {
"$ref": "#/$defs/pcc/definitions/service_version"
},
"signature_algorithm": {
"const": "Ed25519",
"type": "string"
},
"signing_key_id": {
"minLength": 1,
"type": "string"
},
"verification_mode": {
"enum": [
"standard",
"independent_reproduction"
],
"type": "string"
},
"verifier_set_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
}
},
"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"
],
"type": "object"
}
},
"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",
"properties": {
"claims": {
"items": {
"$ref": "#/$defs/pcc/definitions/claim"
},
"type": "array",
"uniqueItems": true
},
"completeness": {
"$ref": "#/$defs/pcc/definitions/completeness"
},
"contract": {
"$ref": "#/$defs/pcc/definitions/contract"
},
"evidence": {
"items": {
"$ref": "#/$defs/pcc/definitions/evidence_item"
},
"type": "array",
"uniqueItems": true
},
"extensions": {
"allOf": [
{
"$ref": "#/$defs/pcc/definitions/extension_container"
},
{
"properties": {
"net.siteborne.verification-proof.v1": {
"$ref": "#/$defs/pcc/definitions/verification_proof_v1"
}
},
"required": [
"net.siteborne.verification-proof.v1"
],
"type": "object"
}
]
},
"job_id": {
"$ref": "#/$defs/pcc/definitions/job_id"
},
"pcc_version": {
"$ref": "#/$defs/pcc/definitions/pcc_version"
},
"provenance": {
"$ref": "#/$defs/pcc/definitions/provenance"
},
"receipt": {
"$ref": "#/$defs/pcc/definitions/receipt"
},
"subject": {
"$ref": "#/$defs/pcc/definitions/subject"
},
"verification": {
"$ref": "#/$defs/pcc/definitions/verification"
}
},
"required": [
"pcc_version",
"job_id",
"contract",
"subject",
"claims",
"evidence",
"completeness",
"provenance",
"verification",
"receipt"
],
"title": "Proof-Carrying Context (PCC) v2.0.0",
"type": "object"
}
},
"$id": "https://utility.siteborne.net/contracts/3.0.0/schemas/services/document-evidence-output.schema.json",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"allOf": [
{
"$ref": "#/$defs/pcc"
},
{
"properties": {
"contract": {
"properties": {
"output_schema_hash": {
"pattern": "^sha256:[a-f0-9]{64}$",
"type": "string"
},
"service_id": {
"enum": [
"document_evidence_json.v3"
]
},
"service_version": {
"enum": [
"v3"
]
}
},
"required": [
"service_id",
"service_version",
"output_schema_hash"
],
"type": "object"
},
"extensions": {
"properties": {
"net.siteborne.document-evidence.v1": {
"additionalProperties": false,
"description": "Document evidence extension payload.",
"properties": {
"calculated_billable_units": {
"additionalProperties": false,
"properties": {
"native_text_pages": {
"minimum": 0,
"type": "integer"
},
"ocr_pages": {
"minimum": 0,
"type": "integer"
},
"table_pages": {
"minimum": 0,
"type": "integer"
},
"total_billable": {
"minimum": 0,
"type": "integer"
}
},
"type": "object"
},
"document_classification": {
"enum": [
"contract",
"invoice",
"report",
"form",
"letter",
"financial_statement",
"regulatory_filing",
"other"
],
"type": "string"
},
"estimated_or_final_amount": {
"$ref": "#/$defs/money"
},
"extracted_data": {
"additionalProperties": true,
"description": "Structured extraction results.",
"type": "object"
},
"limitations": {
"items": {
"maxLength": 256,
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"media_type_confirmed": {
"type": "string"
},
"ocr_confidence": {
"items": {
"additionalProperties": false,
"properties": {
"low_confidence_regions": {
"items": {
"type": "string"
},
"type": "array"
},
"mean_confidence": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"page": {
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"maxItems": 10,
"type": "array"
},
"page_classifications": {
"items": {
"additionalProperties": false,
"properties": {
"classification": {
"enum": [
"native_text",
"ocr",
"table_heavy",
"image_only",
"unsupported"
],
"type": "string"
},
"confidence": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"extraction_method": {
"enum": [
"native",
"ocr",
"hybrid",
"none"
],
"type": "string"
},
"page_number": {
"minimum": 1,
"type": "integer"
}
},
"required": [
"page_number",
"classification"
],
"type": "object"
},
"maxItems": 10,
"type": "array"
},
"page_warnings": {
"items": {
"additionalProperties": false,
"properties": {
"page": {
"minimum": 1,
"type": "integer"
},
"severity": {
"enum": [
"low",
"medium",
"high"
],
"type": "string"
},
"warning": {
"type": "string"
}
},
"type": "object"
},
"maxItems": 50,
"type": "array"
},
"processed_pages": {
"maximum": 10,
"minimum": 0,
"type": "integer"
},
"retention_result": {
"additionalProperties": false,
"properties": {
"expires_at": {
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?Z$",
"type": "string"
},
"stored": {
"type": "boolean"
}
},
"type": "object"
},
"size_bytes_confirmed": {
"minimum": 1,
"type": "integer"
},
"tables": {
"items": {
"additionalProperties": false,
"properties": {
"bbox": {
"items": {
"type": "number"
},
"maxItems": 4,
"minItems": 4,
"type": "array"
},
"headers": {
"items": {
"type": "string"
},
"type": "array"
},
"page": {
"minimum": 1,
"type": "integer"
},
"rows": {
"items": {
"items": {
"type": "string"
},
"type": "array"
},
"type": "array"
},
"table_index": {
"minimum": 0,
"type": "integer"
}
},
"type": "object"
},
"maxItems": 50,
"type": "array"
},
"text_blocks": {
"items": {
"additionalProperties": false,
"properties": {
"bbox": {
"items": {
"type": "number"
},
"maxItems": 4,
"minItems": 4,
"type": "array"
},
"page": {
"minimum": 1,
"type": "integer"
},
"text": {
"type": "string"
}
},
"type": "object"
},
"maxItems": 100,
"type": "array"
},
"total_pages": {
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"truncation": {
"additionalProperties": false,
"properties": {
"pages_omitted": {
"items": {
"type": "integer"
},
"type": "array"
},
"truncated": {
"type": "boolean"
}
},
"type": "object"
},
"unsupported_content": {
"items": {
"additionalProperties": false,
"properties": {
"page": {
"minimum": 1,
"type": "integer"
},
"reason": {
"type": "string"
}
},
"type": "object"
},
"maxItems": 20,
"type": "array"
}
},
"type": "object"
}
},
"propertyNames": {
"maxLength": 253,
"minLength": 5,
"pattern": "^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?){2,}$",
"type": "string"
},
"required": [
"net.siteborne.document-evidence.v1"
],
"type": "object"
}
},
"required": [
"contract",
"extensions"
],
"type": "object"
}
],
"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.",
"title": "Document Evidence JSON Output"
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"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": {
"description": "Pricing mode: exact fixes the required amount, while upto authorizes a maximum whose eventual charge cannot exceed the returned amount.",
"enum": [
"exact",
"upto"
],
"type": "string"
},
"service_id": {
"description": "Canonical SITEBORNE service and major version to price; selects that service’s governed pricing key, contract release, and production resource URL.",
"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"
}
},
"required": [
"service_id",
"scheme",
"input"
],
"type": "object"
},
"name": "siteborne_get_quote",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"actual_amount": {
"description": "Always null in a quote: the actual charge exists only after measured settlement.",
"type": "null"
},
"amount": {
"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.",
"type": "string"
},
"amount_kind": {
"description": "exact: the charge equals amount. authorized_maximum: the charge is measured at settlement and never exceeds amount.",
"enum": [
"exact",
"authorized_maximum"
],
"type": "string"
},
"asset": {
"description": "Token contract address on the network that the amount is denominated in.",
"type": "string"
},
"binding_hash": {
"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.",
"type": "string"
},
"contract_release": {
"description": "Contract release the quoted service belongs to.",
"enum": [
"1.0.0",
"2.0.0",
"3.0.0"
],
"type": "string"
},
"economics": {
"additionalProperties": {},
"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"
},
"type": "object"
},
"expires_at": {
"description": "UTC time after which the quote is no longer valid.",
"type": "string"
},
"input_hash": {
"description": "Canonical hash of the exact request input this quote binds.",
"type": "string"
},
"issued_at": {
"description": "UTC time the quote was issued.",
"type": "string"
},
"network": {
"description": "CAIP-2 network the payment must be made on (for example eip155:8453).",
"type": "string"
},
"payee": {
"description": "Public payTo address that receives the payment.",
"type": "string"
},
"payment_required": {
"const": true,
"description": "Always true: executing the quoted service requires payment.",
"type": "boolean"
},
"payment_requirements": {
"additionalProperties": {},
"description": "The x402 payment requirement to satisfy, including payTo, network, asset and amount.",
"propertyNames": {
"type": "string"
},
"type": "object"
},
"pricing_key": {
"description": "Governed pricing key the amount was resolved from (governance pricing authority).",
"type": "string"
},
"pricing_source_version": {
"description": "Version of the governed pricing document that produced the amount; a repricing changes this value.",
"type": "string"
},
"production_enabled": {
"const": false,
"description": "Quote-level flag, always false: a quote never authorizes execution. The service runtime state is economics.production_enabled.",
"type": "boolean"
},
"quote_id": {
"description": "Deterministic identifier of this quote.",
"type": "string"
},
"requirement_id": {
"description": "Identifier of the x402 payment requirement embedded in payment_requirements.",
"type": "string"
},
"resource_id": {
"description": "Canonical URL of the paid resource this quote is bound to.",
"type": "string"
},
"scheme": {
"description": "x402 scheme: exact requires the amount; upto authorizes it as a maximum.",
"enum": [
"exact",
"upto"
],
"type": "string"
},
"service_id": {
"description": "Canonical service id and major version that was quoted.",
"type": "string"
},
"service_version": {
"description": "Service contract major version.",
"enum": [
"v1",
"v2",
"v3"
],
"type": "string"
}
},
"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"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "siteborne_get_service_health",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"external_publication": {
"const": "blocked_external",
"type": "string"
},
"production_enabled": {
"type": "boolean"
},
"production_ready": {
"const": false,
"type": "boolean"
},
"protocol_version": {
"const": "2026-07-28",
"type": "string"
},
"server_name": {
"const": "net.siteborne/utility",
"type": "string"
},
"server_version": {
"const": "0.1.0",
"type": "string"
},
"services": {
"additionalProperties": {
"additionalProperties": false,
"properties": {
"external": {
"enum": [
"not_live",
"configured"
],
"type": "string"
},
"implementation": {
"enum": [
"local_fixture_verified",
"real_executor"
],
"type": "string"
},
"production": {
"enum": [
"production_disabled",
"production_enabled"
],
"type": "string"
}
},
"required": [
"implementation",
"production",
"external"
],
"type": "object"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"status": {
"const": "ready_local",
"type": "string"
},
"tools": {
"const": 10,
"type": "number"
}
},
"required": [
"status",
"server_name",
"server_version",
"protocol_version",
"tools",
"production_ready",
"production_enabled",
"external_publication",
"services"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$id": "https://siteborne.net/schemas/services/web-context-input.schema.json",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"description": "Input schema for web_context_verified.v1 service. Supports direct and rendered retrieval modes.",
"examples": [
{
"freshness_seconds": 3600,
"maximum_authorized_price": {
"amount": "0.029",
"currency": "USD"
},
"output_mode": "markdown",
"retrieval_mode": "direct",
"target_url": "https://acme.example.com/about"
}
],
"properties": {
"buyer_schema": {
"additionalProperties": true,
"description": "Optional JSON Schema governing structured output; meaningful only with output_mode structured and bounded to fifty properties and depth five.",
"maxDepth": 5,
"maxProperties": 50,
"type": "object"
},
"field_selectors": {
"description": "Up to thirty requested field names for structured extraction; narrows the structured result rather than changing the fetched URL.",
"items": {
"maxLength": 128,
"type": "string"
},
"maxItems": 30,
"type": "array"
},
"freshness_seconds": {
"default": 3600,
"description": "Maximum acceptable cached-content age in seconds, from 0 through 2,592,000; zero requests uncached content.",
"maximum": 2592000,
"minimum": 0,
"type": "integer"
},
"locale_hint": {
"description": "Optional BCP 47 language or language-region hint used for HTTP content negotiation; it does not translate content.",
"pattern": "^[a-z]{2}(-[A-Z]{2})?$",
"type": "string"
},
"max_content_size": {
"default": 1048576,
"description": "Maximum returned content size in bytes, from 1,024 through 10,485,760; smaller limits truncate or reject oversized content sooner.",
"maximum": 10485760,
"minimum": 1024,
"type": "integer"
},
"max_redirects": {
"default": 5,
"description": "Maximum redirect hops from 0 through 10 when the selected redirect policy follows redirects.",
"maximum": 10,
"minimum": 0,
"type": "integer"
},
"maximum_authorized_price": {
"additionalProperties": false,
"description": "Buyer’s decimal-safe maximum authorized price; constrains the payment requirement and never changes retrieval scope.",
"examples": [
{
"amount": "0.039",
"currency": "USD"
},
{
"amount": "0.19",
"asset": "USDC",
"currency": "USD",
"network": "base-mainnet"
}
],
"properties": {
"amount": {
"description": "Canonical decimal string. No scientific notation, no leading zeros (except single '0'), no trailing zeros unless significant, no sign. Maximum 18 decimal places.",
"examples": [
"0",
"0.009",
"0.012",
"0.019",
"0.029",
"0.039",
"0.049",
"0.19"
],
"pattern": "^(0|[1-9][0-9]*)(\\.[0-9]{1,18})?$",
"type": "string"
},
"asset": {
"description": "Payment asset identifier (e.g., 'USDC', 'ETH'). Optional for non-payment contexts.",
"pattern": "^[A-Z0-9]{3,10}$",
"type": "string"
},
"currency": {
"default": "USD",
"description": "ISO 4217 currency code.",
"enum": [
"USD"
],
"pattern": "^[A-Z]{3}$",
"type": "string"
},
"network": {
"description": "Payment network identifier (e.g., 'base-mainnet', 'base-sepolia'). Optional for non-payment contexts.",
"maxLength": 64,
"pattern": "^[a-z0-9-]+$",
"type": "string"
},
"precision": {
"default": 6,
"description": "Maximum decimal places supported by the asset/network. Metadata only.",
"maximum": 18,
"minimum": 0,
"type": "integer"
}
},
"required": [
"amount",
"currency"
],
"title": "Decimal Money",
"type": "object"
},
"minimum_verification_score": {
"default": 0.7,
"description": "Required PCC verification ratio from 0 through 1; raising it makes evidence acceptance stricter.",
"maximum": 1,
"minimum": 0,
"type": "number"
},
"output_mode": {
"default": "clean_text",
"description": "Result representation: clean_text normalizes prose, markdown preserves document structure, and structured validates selected fields against buyer_schema.",
"enum": [
"clean_text",
"markdown",
"structured"
],
"type": "string"
},
"redirect_policy": {
"default": "follow",
"description": "Redirect handling: follow permits the bounded chain, follow_first permits only the first hop, and manual returns redirect evidence without following.",
"enum": [
"follow",
"follow_first",
"manual"
],
"type": "string"
},
"retrieval_mode": {
"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.",
"enum": [
"direct",
"rendered"
],
"type": "string"
},
"target_url": {
"description": "Public HTTP or HTTPS URL to retrieve and verify; private, loopback, and otherwise unsafe network destinations are rejected.",
"format": "uri",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"target_url",
"retrieval_mode"
],
"title": "Verified Web Context Input",
"type": "object"
},
"name": "siteborne_retrieve_verified_web_context",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"result": {
"$defs": {
"money": {
"additionalProperties": false,
"description": "Canonical decimal-safe money representation. No binary floating-point. Amount is a canonical decimal string.",
"examples": [
{
"amount": "0.039",
"currency": "USD"
},
{
"amount": "0.19",
"asset": "USDC",
"currency": "USD",
"network": "base-mainnet"
}
],
"properties": {
"amount": {
"description": "Canonical decimal string. No scientific notation, no leading zeros (except single '0'), no trailing zeros unless significant, no sign. Maximum 18 decimal places.",
"examples": [
"0",
"0.009",
"0.012",
"0.019",
"0.029",
"0.039",
"0.049",
"0.19"
],
"pattern": "^(0|[1-9][0-9]*)(\\.[0-9]{1,18})?$",
"type": "string"
},
"asset": {
"description": "Payment asset identifier (e.g., 'USDC', 'ETH'). Optional for non-payment contexts.",
"pattern": "^[A-Z0-9]{3,10}$",
"type": "string"
},
"currency": {
"default": "USD",
"description": "ISO 4217 currency code.",
"enum": [
"USD"
],
"pattern": "^[A-Z]{3}$",
"type": "string"
},
"network": {
"description": "Payment network identifier (e.g., 'base-mainnet', 'base-sepolia'). Optional for non-payment contexts.",
"maxLength": 64,
"pattern": "^[a-z0-9-]+$",
"type": "string"
},
"precision": {
"default": 6,
"description": "Maximum decimal places supported by the asset/network. Metadata only.",
"maximum": 18,
"minimum": 0,
"type": "integer"
}
},
"required": [
"amount",
"currency"
],
"title": "Decimal Money",
"type": "object"
},
"pcc": {
"additionalProperties": false,
"definitions": {
"accessibility_status": {
"description": "Evidence accessibility status",
"enum": [
"accessible",
"unavailable",
"restricted",
"requires_authorization"
],
"type": "string"
},
"authorization_classification": {
"description": "Evidence authorization classification",
"enum": [
"public",
"buyer_authorized",
"restricted",
"confidential"
],
"type": "string"
},
"canonicalization_algorithm": {
"const": "RFC8785-JCS",
"description": "Canonicalization algorithm",
"type": "string"
},
"claim": {
"additionalProperties": false,
"properties": {
"claim_id": {
"$ref": "#/$defs/pcc/definitions/claim_id"
},
"confidence": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"evidence_ids": {
"items": {
"$ref": "#/$defs/pcc/definitions/evidence_id"
},
"type": "array"
},
"materiality": {
"$ref": "#/$defs/pcc/definitions/materiality"
},
"predicate": {
"minLength": 1,
"type": "string"
},
"value": {
"type": [
"string",
"number",
"boolean",
"object",
"array",
"null"
]
},
"verification_status": {
"$ref": "#/$defs/pcc/definitions/verification_status"
}
},
"required": [
"claim_id",
"predicate",
"value",
"confidence",
"evidence_ids",
"materiality",
"verification_status"
],
"type": "object"
},
"claim_id": {
"description": "Claim identifier",
"pattern": "^clm_[a-z0-9]{24}$",
"type": "string"
},
"completeness": {
"additionalProperties": false,
"properties": {
"missing_fields": {
"items": {
"minLength": 1,
"type": "string"
},
"type": "array"
},
"populated_fields": {
"minimum": 0,
"type": "integer"
},
"requested_fields": {
"minimum": 0,
"type": "integer"
},
"score": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"stale_fields": {
"items": {
"minLength": 1,
"type": "string"
},
"type": "array"
},
"supported_fields": {
"minimum": 0,
"type": "integer"
},
"unsupported_fields": {
"items": {
"minLength": 1,
"type": "string"
},
"type": "array"
},
"vector": {
"items": {
"$ref": "#/$defs/pcc/definitions/completeness_vector_entry"
},
"type": "array"
}
},
"required": [
"requested_fields",
"populated_fields",
"supported_fields",
"score",
"missing_fields",
"unsupported_fields",
"stale_fields",
"vector"
],
"type": "object"
},
"completeness_vector_entry": {
"additionalProperties": false,
"properties": {
"dimension": {
"minLength": 1,
"type": "string"
},
"populated": {
"minimum": 0,
"type": "integer"
},
"requested": {
"minimum": 0,
"type": "integer"
},
"score": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"supported": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"dimension",
"requested",
"populated",
"supported",
"score"
],
"type": "object"
},
"contract": {
"additionalProperties": false,
"properties": {
"currency": {
"$ref": "#/$defs/pcc/definitions/currency"
},
"expires_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"freshness_seconds": {
"minimum": 1,
"type": "integer"
},
"idempotency_key": {
"$ref": "#/$defs/pcc/definitions/idempotency_key"
},
"input_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"input_schema_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"issued_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"maximum_authorized_price": {
"$ref": "#/$defs/pcc/definitions/decimal_string"
},
"minimum_quality": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"mode": {
"$ref": "#/$defs/pcc/definitions/contract_mode"
},
"network": {
"enum": [
"base",
"base-testnet"
],
"type": "string"
},
"output_schema_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"price": {
"$ref": "#/$defs/pcc/definitions/decimal_string"
},
"quote_id": {
"$ref": "#/$defs/pcc/definitions/quote_id"
},
"service_id": {
"$ref": "#/$defs/pcc/definitions/service_id"
},
"service_version": {
"$ref": "#/$defs/pcc/definitions/service_version"
}
},
"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"
],
"type": "object"
},
"contract_mode": {
"description": "Contract mode determines required fields",
"enum": [
"paid",
"benchmark",
"offline_verification"
],
"type": "string"
},
"currency": {
"description": "Permitted currencies",
"enum": [
"USD",
"USDC"
],
"type": "string"
},
"decimal_string": {
"description": "Non-negative decimal string, no scientific notation, no leading zeros except single zero",
"pattern": "^(0|[1-9]\\d*)(\\.\\d+)?$",
"type": "string"
},
"evidence_id": {
"description": "Evidence identifier",
"pattern": "^evd_[a-z0-9]{24}$",
"type": "string"
},
"evidence_item": {
"additionalProperties": false,
"properties": {
"accessibility_status": {
"$ref": "#/$defs/pcc/definitions/accessibility_status"
},
"authorization_classification": {
"$ref": "#/$defs/pcc/definitions/authorization_classification"
},
"content_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"evidence_id": {
"$ref": "#/$defs/pcc/definitions/evidence_id"
},
"freshness_status": {
"$ref": "#/$defs/pcc/definitions/freshness_status"
},
"locator": {
"$ref": "#/$defs/pcc/definitions/locator"
},
"media_type": {
"minLength": 1,
"type": "string"
},
"retrieved_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"source_timestamp": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"source_uri": {
"format": "uri",
"minLength": 1,
"type": "string"
},
"transformation_history": {
"items": {
"$ref": "#/$defs/pcc/definitions/transformation"
},
"type": "array"
}
},
"required": [
"evidence_id",
"source_uri",
"retrieved_at",
"content_hash",
"media_type",
"locator",
"accessibility_status",
"transformation_history",
"authorization_classification",
"freshness_status"
],
"type": "object"
},
"extension_container": {
"additionalProperties": false,
"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,
"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"
}
},
"propertyNames": {
"maxLength": 253,
"minLength": 5,
"pattern": "^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?){2,}$",
"type": "string"
},
"type": "object"
},
"extension_value": {
"additionalProperties": true,
"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,
"type": "object"
},
"freshness_status": {
"description": "Evidence freshness status",
"enum": [
"fresh",
"stale",
"unknown"
],
"type": "string"
},
"hash": {
"description": "SHA-256 hash with algorithm tag",
"pattern": "^sha256:[a-f0-9]{64}$",
"type": "string"
},
"idempotency_key": {
"description": "Idempotency key",
"pattern": "^idk_[a-z0-9]{24}$",
"type": "string"
},
"job_id": {
"description": "Unique job identifier",
"pattern": "^job_[a-z0-9]{24}$",
"type": "string"
},
"key_id": {
"description": "Key identifier",
"pattern": "^kid_[a-z0-9]{24}$",
"type": "string"
},
"locator": {
"additionalProperties": false,
"properties": {
"type": {
"$ref": "#/$defs/pcc/definitions/locator_type"
},
"value": {
"minLength": 1,
"type": "string"
}
},
"required": [
"type",
"value"
],
"type": "object"
},
"locator_type": {
"description": "Evidence locator type",
"enum": [
"json_pointer",
"xpath",
"css_selector",
"text_quote",
"page_region",
"byte_range",
"database_record",
"artifact_pointer"
],
"type": "string"
},
"materiality": {
"description": "Claim materiality classification",
"enum": [
"material",
"supporting",
"contextual"
],
"type": "string"
},
"pcc_version": {
"const": "1.0.0",
"description": "PCC specification version",
"type": "string"
},
"policy_id": {
"description": "Policy identifier",
"pattern": "^pol_[a-z0-9]{24}$",
"type": "string"
},
"provenance": {
"additionalProperties": false,
"properties": {
"cache_provenance": {
"additionalProperties": false,
"properties": {
"cache_key": {
"type": "string"
},
"enabled": {
"type": "boolean"
},
"hit": {
"type": "boolean"
},
"stored_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
}
},
"required": [
"enabled",
"hit"
],
"type": "object"
},
"execution_environment": {
"additionalProperties": false,
"properties": {
"container_image": {
"type": "string"
},
"platform": {
"minLength": 1,
"type": "string"
},
"runtime": {
"minLength": 1,
"type": "string"
},
"version": {
"minLength": 1,
"type": "string"
}
},
"required": [
"runtime",
"version",
"platform"
],
"type": "object"
},
"models": {
"items": {
"additionalProperties": false,
"properties": {
"name": {
"minLength": 1,
"type": "string"
},
"provider": {
"minLength": 1,
"type": "string"
},
"version": {
"minLength": 1,
"type": "string"
}
},
"required": [
"name",
"version",
"provider"
],
"type": "object"
},
"type": "array"
},
"policy_versions": {
"additionalProperties": {
"type": "string"
},
"description": "Policy name to version mapping",
"type": "object"
},
"providers": {
"items": {
"additionalProperties": false,
"properties": {
"capabilities": {
"items": {
"type": "string"
},
"type": "array"
},
"name": {
"minLength": 1,
"type": "string"
},
"version": {
"minLength": 1,
"type": "string"
}
},
"required": [
"name",
"version",
"capabilities"
],
"type": "object"
},
"type": "array"
},
"routes": {
"items": {
"$ref": "#/$defs/pcc/definitions/provenance_route"
},
"type": "array"
},
"software_versions": {
"additionalProperties": {
"type": "string"
},
"description": "Component name to version mapping",
"type": "object"
},
"tools": {
"additionalProperties": {
"type": "string"
},
"description": "Tool name to version mapping",
"type": "object"
},
"transformations": {
"items": {
"$ref": "#/$defs/pcc/definitions/transformation"
},
"type": "array"
},
"verification_routes": {
"items": {
"$ref": "#/$defs/pcc/definitions/provenance_route"
},
"type": "array"
}
},
"required": [
"routes",
"providers",
"tools",
"models",
"software_versions",
"policy_versions",
"transformations",
"cache_provenance",
"execution_environment",
"verification_routes"
],
"type": "object"
},
"provenance_route": {
"additionalProperties": false,
"properties": {
"model_name": {
"type": "string"
},
"model_version": {
"type": "string"
},
"parameters": {
"additionalProperties": true,
"type": "object"
},
"provider": {
"minLength": 1,
"type": "string"
},
"type": {
"enum": [
"cache",
"direct",
"deterministic",
"model",
"hybrid"
],
"type": "string"
},
"version": {
"minLength": 1,
"type": "string"
}
},
"required": [
"type",
"provider",
"version"
],
"type": "object"
},
"quote_id": {
"description": "Quote identifier",
"pattern": "^qte_[a-z0-9]{24}$",
"type": "string"
},
"receipt": {
"additionalProperties": false,
"properties": {
"canonicalization_algorithm": {
"$ref": "#/$defs/pcc/definitions/canonicalization_algorithm"
},
"output_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"policy_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"schema_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"signature": {
"pattern": "^[A-Za-z0-9_-]{86,88}$",
"type": "string"
},
"signature_algorithm": {
"$ref": "#/$defs/pcc/definitions/signature_algorithm"
},
"signed_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"signing_key_id": {
"$ref": "#/$defs/pcc/definitions/key_id"
}
},
"required": [
"output_hash",
"canonicalization_algorithm",
"policy_hash",
"schema_hash",
"signature_algorithm",
"signing_key_id",
"signature",
"signed_at"
],
"type": "object"
},
"service_id": {
"description": "Service identifier",
"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"
},
"service_version": {
"description": "Service version",
"pattern": "^v\\d+(\\.\\d+)*$",
"type": "string"
},
"signature_algorithm": {
"const": "Ed25519",
"description": "Signature algorithm",
"type": "string"
},
"subject": {
"additionalProperties": false,
"properties": {
"canonical_name": {
"minLength": 1,
"type": "string"
},
"identifiers": {
"additionalProperties": {
"type": "string"
},
"type": "object"
},
"type": {
"$ref": "#/$defs/pcc/definitions/subject_type"
}
},
"required": [
"type",
"canonical_name"
],
"type": "object"
},
"subject_type": {
"description": "Subject type",
"enum": [
"organization",
"person",
"document",
"webpage",
"other"
],
"type": "string"
},
"timestamp_rfc3339": {
"description": "RFC 3339 UTC timestamp with Z suffix, normalized fractional seconds",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?Z$",
"type": "string"
},
"transformation": {
"additionalProperties": false,
"properties": {
"parameters": {
"additionalProperties": true,
"type": "object"
},
"timestamp": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"tool_version": {
"minLength": 1,
"type": "string"
},
"type": {
"minLength": 1,
"type": "string"
}
},
"required": [
"type",
"timestamp",
"tool_version"
],
"type": "object"
},
"verification": {
"additionalProperties": false,
"properties": {
"completeness": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"cross_source_agreement": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"decision": {
"$ref": "#/$defs/pcc/definitions/verification_decision"
},
"deterministic_failures": {
"items": {
"minLength": 1,
"type": "string"
},
"type": "array"
},
"evidence_accessibility": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"failed_requirements": {
"items": {
"minLength": 1,
"type": "string"
},
"type": "array"
},
"freshness": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"material_claims_supported": {
"type": "boolean"
},
"policy": {
"$ref": "#/$defs/pcc/definitions/policy_id"
},
"prompt_injection_result": {
"additionalProperties": false,
"properties": {
"checked": {
"type": "boolean"
},
"details": {
"type": "string"
},
"result": {
"enum": [
"clean",
"suspected",
"confirmed"
],
"type": "string"
}
},
"required": [
"checked",
"result"
],
"type": "object"
},
"provenance_valid": {
"type": "boolean"
},
"schema_valid": {
"type": "boolean"
},
"score": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"verifier_versions": {
"additionalProperties": {
"type": "string"
},
"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"
],
"type": "object"
},
"verification_decision": {
"description": "Verification decision",
"enum": [
"pass",
"conditional",
"fail",
"quarantined"
],
"type": "string"
},
"verification_status": {
"description": "Claim verification status",
"enum": [
"verified",
"unsupported",
"disputed",
"pending"
],
"type": "string"
}
},
"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",
"properties": {
"claims": {
"items": {
"$ref": "#/$defs/pcc/definitions/claim"
},
"type": "array",
"uniqueItems": true
},
"completeness": {
"$ref": "#/$defs/pcc/definitions/completeness"
},
"contract": {
"$ref": "#/$defs/pcc/definitions/contract"
},
"evidence": {
"items": {
"$ref": "#/$defs/pcc/definitions/evidence_item"
},
"type": "array",
"uniqueItems": true
},
"extensions": {
"$ref": "#/$defs/pcc/definitions/extension_container"
},
"job_id": {
"$ref": "#/$defs/pcc/definitions/job_id"
},
"pcc_version": {
"$ref": "#/$defs/pcc/definitions/pcc_version"
},
"provenance": {
"$ref": "#/$defs/pcc/definitions/provenance"
},
"receipt": {
"$ref": "#/$defs/pcc/definitions/receipt"
},
"subject": {
"$ref": "#/$defs/pcc/definitions/subject"
},
"verification": {
"$ref": "#/$defs/pcc/definitions/verification"
}
},
"required": [
"pcc_version",
"job_id",
"contract",
"subject",
"claims",
"evidence",
"completeness",
"provenance",
"verification",
"receipt"
],
"title": "Proof-Carrying Context (PCC) v1.0.0",
"type": "object"
}
},
"$id": "https://siteborne.net/schemas/services/web-context-output.schema.json",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"allOf": [
{
"$ref": "#/$defs/pcc"
},
{
"properties": {
"contract": {
"properties": {
"output_schema_hash": {
"pattern": "^sha256:[a-f0-9]{64}$",
"type": "string"
},
"service_id": {
"enum": [
"web_context_verified.v1",
"web_context_verified.v2"
]
},
"service_version": {
"enum": [
"v1",
"v2"
]
}
},
"required": [
"service_id",
"service_version",
"output_schema_hash"
],
"type": "object"
},
"extensions": {
"properties": {
"net.siteborne.web-context.v1": {
"additionalProperties": false,
"description": "Web context extension payload.",
"properties": {
"byte_count": {
"minimum": 0,
"type": "integer"
},
"cache_status": {
"additionalProperties": false,
"properties": {
"age_seconds": {
"type": "integer"
},
"freshness_seconds": {
"type": "integer"
},
"hit": {
"type": "boolean"
}
},
"type": "object"
},
"canonical_text": {
"description": "Clean text extraction.",
"maxLength": 10485760,
"type": "string"
},
"character_count": {
"minimum": 0,
"type": "integer"
},
"content_classification": {
"enum": [
"article",
"landing",
"document",
"app",
"error",
"other"
],
"type": "string"
},
"content_hash": {
"description": "Hash of processed output content.",
"pattern": "^sha256:[a-f0-9]{64}$",
"type": "string"
},
"extraction_warnings": {
"items": {
"maxLength": 256,
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"final_url": {
"description": "Final URL after redirects.",
"format": "uri",
"type": "string"
},
"http_metadata": {
"additionalProperties": false,
"properties": {
"content_length": {
"minimum": 0,
"type": "integer"
},
"content_type": {
"type": "string"
},
"headers": {
"additionalProperties": {
"type": "string"
},
"type": "object"
},
"status_code": {
"maximum": 599,
"minimum": 100,
"type": "integer"
}
},
"type": "object"
},
"limitations": {
"items": {
"maxLength": 256,
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"markdown": {
"description": "Markdown output when requested.",
"maxLength": 10485760,
"type": "string"
},
"prompt_injection_findings": {
"items": {
"additionalProperties": false,
"properties": {
"evidence_id": {
"type": "string"
},
"location": {
"type": "string"
},
"severity": {
"enum": [
"low",
"medium",
"high",
"critical"
],
"type": "string"
},
"type": {
"type": "string"
}
},
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"redirect_chain": {
"items": {
"additionalProperties": false,
"properties": {
"status_code": {
"maximum": 399,
"minimum": 300,
"type": "integer"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"url",
"status_code"
],
"type": "object"
},
"maxItems": 10,
"type": "array"
},
"rendering_metadata": {
"additionalProperties": false,
"properties": {
"engine": {
"type": "string"
},
"load_time_ms": {
"minimum": 0,
"type": "integer"
},
"network_requests": {
"minimum": 0,
"type": "integer"
},
"scripts_executed": {
"minimum": 0,
"type": "integer"
},
"version": {
"type": "string"
}
},
"type": "object"
},
"requested_url": {
"description": "Originally requested URL.",
"format": "uri",
"type": "string"
},
"retrieval_freshness": {
"description": "Timestamp of content retrieval.",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?Z$",
"type": "string"
},
"retrieval_mode_requested": {
"enum": [
"direct",
"rendered"
],
"type": "string"
},
"retrieval_mode_used": {
"description": "Mode actually used (may differ if rendered unavailable).",
"enum": [
"direct",
"rendered"
],
"type": "string"
},
"source_hash": {
"description": "Hash of raw source content.",
"pattern": "^sha256:[a-f0-9]{64}$",
"type": "string"
},
"structured_fields": {
"additionalProperties": true,
"description": "Structured extraction when requested.",
"type": "object"
},
"truncation_status": {
"additionalProperties": false,
"properties": {
"original_bytes": {
"minimum": 0,
"type": "integer"
},
"returned_bytes": {
"minimum": 0,
"type": "integer"
},
"truncated": {
"type": "boolean"
}
},
"type": "object"
}
},
"type": "object"
}
},
"propertyNames": {
"maxLength": 253,
"minLength": 5,
"pattern": "^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?){2,}$",
"type": "string"
},
"required": [
"net.siteborne.web-context.v1"
],
"type": "object"
}
},
"required": [
"contract",
"extensions"
],
"type": "object"
}
],
"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.",
"examples": [
{
"claims": [],
"completeness": {
"missing_fields": [
"ceo_name"
],
"populated_fields": 4,
"requested_fields": 5,
"score": 0.8,
"stale_fields": [],
"supported_fields": 4,
"unsupported_fields": [],
"vector": [
{
"dimension": "general",
"populated": 4,
"requested": 5,
"score": 0.8,
"supported": 4
}
]
},
"contract": {
"currency": "USD",
"expires_at": "2026-08-06T10:00:00Z",
"freshness_seconds": 3600,
"idempotency_key": "idk_aaaaaaaaaaaaaaaaaaaaaaaa",
"input_hash": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"input_schema_hash": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
"issued_at": "2026-08-05T10:00:00Z",
"minimum_quality": 0.8,
"mode": "paid",
"output_schema_hash": "sha256:abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
"quote_id": "qte_aaaaaaaaaaaaaaaaaaaaaaaa",
"service_id": "web_context_verified.v1",
"service_version": "v1"
},
"evidence": [],
"extensions": {
"net.siteborne.web-context.v1": {
"canonical_text": "Acme Corp - Leading innovation...",
"content_classification": "landing",
"final_url": "https://acme.example.com/about",
"markdown": "# Acme Corp\n\nLeading innovation...",
"requested_url": "https://acme.example.com/about",
"retrieval_mode_requested": "rendered",
"retrieval_mode_used": "rendered",
"truncation_status": {
"original_bytes": 15420,
"returned_bytes": 15420,
"truncated": false
}
}
},
"job_id": "job_aaaaaaaaaaaaaaaaaaaaaaaa",
"pcc_version": "1.0.0",
"provenance": {
"cache_provenance": {
"enabled": false,
"hit": false
},
"execution_environment": {
"platform": "linux",
"runtime": "node",
"version": "22.0.0"
},
"models": [],
"policy_versions": {
"verification": "1.0.0"
},
"providers": [
{
"capabilities": [
"fetch"
],
"name": "web",
"version": "1.0.0"
}
],
"routes": [
{
"provider": "web",
"type": "direct",
"version": "1.0.0"
}
],
"software_versions": {
"pcc": "1.0.0"
},
"tools": {
"curl": "8.0.0"
},
"transformations": [],
"verification_routes": []
},
"receipt": {
"canonicalization_algorithm": "RFC8785-JCS",
"output_hash": "sha256:eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
"policy_hash": "sha256:ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
"schema_hash": "sha256:0000000000000000000000000000000000000000000000000000000000000000",
"signature": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"signature_algorithm": "Ed25519",
"signed_at": "2026-08-05T10:00:00Z",
"signing_key_id": "kid_aaaaaaaaaaaaaaaaaaaaaaaa"
},
"subject": {
"canonical_name": "Acme Example Corp",
"identifiers": {
"domain": "acme.example.com"
},
"type": "organization"
},
"verification": {
"completeness": 0.8,
"cross_source_agreement": 1,
"decision": "pass",
"deterministic_failures": [],
"evidence_accessibility": 1,
"failed_requirements": [],
"freshness": 1,
"material_claims_supported": true,
"policy": "pol_aaaaaaaaaaaaaaaaaaaaaaaa",
"prompt_injection_result": {
"checked": true,
"result": "clean"
},
"provenance_valid": true,
"schema_valid": true,
"score": 0.9,
"verifier_versions": {
"pcc": "1.0.0"
}
}
}
],
"title": "Verified Web Context Output"
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$id": "https://siteborne.net/schemas/services/web-context-input.schema.json",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"description": "Input schema for web_context_verified.v1 service. Supports direct and rendered retrieval modes.",
"examples": [
{
"freshness_seconds": 3600,
"maximum_authorized_price": {
"amount": "0.029",
"currency": "USD"
},
"output_mode": "markdown",
"retrieval_mode": "direct",
"target_url": "https://acme.example.com/about"
}
],
"properties": {
"buyer_schema": {
"additionalProperties": true,
"description": "Optional JSON Schema governing structured output; meaningful only with output_mode structured and bounded to fifty properties and depth five.",
"maxDepth": 5,
"maxProperties": 50,
"type": "object"
},
"field_selectors": {
"description": "Up to thirty requested field names for structured extraction; narrows the structured result rather than changing the fetched URL.",
"items": {
"maxLength": 128,
"type": "string"
},
"maxItems": 30,
"type": "array"
},
"freshness_seconds": {
"default": 3600,
"description": "Maximum acceptable cached-content age in seconds, from 0 through 2,592,000; zero requests uncached content.",
"maximum": 2592000,
"minimum": 0,
"type": "integer"
},
"locale_hint": {
"description": "Optional BCP 47 language or language-region hint used for HTTP content negotiation; it does not translate content.",
"pattern": "^[a-z]{2}(-[A-Z]{2})?$",
"type": "string"
},
"max_content_size": {
"default": 1048576,
"description": "Maximum returned content size in bytes, from 1,024 through 10,485,760; smaller limits truncate or reject oversized content sooner.",
"maximum": 10485760,
"minimum": 1024,
"type": "integer"
},
"max_redirects": {
"default": 5,
"description": "Maximum redirect hops from 0 through 10 when the selected redirect policy follows redirects.",
"maximum": 10,
"minimum": 0,
"type": "integer"
},
"maximum_authorized_price": {
"additionalProperties": false,
"description": "Buyer’s decimal-safe maximum authorized price; constrains the payment requirement and never changes retrieval scope.",
"examples": [
{
"amount": "0.039",
"currency": "USD"
},
{
"amount": "0.19",
"asset": "USDC",
"currency": "USD",
"network": "base-mainnet"
}
],
"properties": {
"amount": {
"description": "Canonical decimal string. No scientific notation, no leading zeros (except single '0'), no trailing zeros unless significant, no sign. Maximum 18 decimal places.",
"examples": [
"0",
"0.009",
"0.012",
"0.019",
"0.029",
"0.039",
"0.049",
"0.19"
],
"pattern": "^(0|[1-9][0-9]*)(\\.[0-9]{1,18})?$",
"type": "string"
},
"asset": {
"description": "Payment asset identifier (e.g., 'USDC', 'ETH'). Optional for non-payment contexts.",
"pattern": "^[A-Z0-9]{3,10}$",
"type": "string"
},
"currency": {
"default": "USD",
"description": "ISO 4217 currency code.",
"enum": [
"USD"
],
"pattern": "^[A-Z]{3}$",
"type": "string"
},
"network": {
"description": "Payment network identifier (e.g., 'base-mainnet', 'base-sepolia'). Optional for non-payment contexts.",
"maxLength": 64,
"pattern": "^[a-z0-9-]+$",
"type": "string"
},
"precision": {
"default": 6,
"description": "Maximum decimal places supported by the asset/network. Metadata only.",
"maximum": 18,
"minimum": 0,
"type": "integer"
}
},
"required": [
"amount",
"currency"
],
"title": "Decimal Money",
"type": "object"
},
"minimum_verification_score": {
"default": 0.7,
"description": "Required PCC verification ratio from 0 through 1; raising it makes evidence acceptance stricter.",
"maximum": 1,
"minimum": 0,
"type": "number"
},
"output_mode": {
"default": "clean_text",
"description": "Result representation: clean_text normalizes prose, markdown preserves document structure, and structured validates selected fields against buyer_schema.",
"enum": [
"clean_text",
"markdown",
"structured"
],
"type": "string"
},
"redirect_policy": {
"default": "follow",
"description": "Redirect handling: follow permits the bounded chain, follow_first permits only the first hop, and manual returns redirect evidence without following.",
"enum": [
"follow",
"follow_first",
"manual"
],
"type": "string"
},
"retrieval_mode": {
"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.",
"enum": [
"direct",
"rendered"
],
"type": "string"
},
"target_url": {
"description": "Public HTTP or HTTPS URL to retrieve and verify; private, loopback, and otherwise unsafe network destinations are rejected.",
"format": "uri",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"target_url",
"retrieval_mode"
],
"title": "Verified Web Context Input",
"type": "object"
},
"name": "siteborne_retrieve_verified_web_context_v3_candidate",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"result": {
"$defs": {
"money": {
"additionalProperties": false,
"description": "Canonical decimal-safe money representation. No binary floating-point. Amount is a canonical decimal string.",
"examples": [
{
"amount": "0.039",
"currency": "USD"
},
{
"amount": "0.19",
"asset": "USDC",
"currency": "USD",
"network": "base-mainnet"
}
],
"properties": {
"amount": {
"description": "Canonical decimal string. No scientific notation, no leading zeros (except single '0'), no trailing zeros unless significant, no sign. Maximum 18 decimal places.",
"examples": [
"0",
"0.009",
"0.012",
"0.019",
"0.029",
"0.039",
"0.049",
"0.19"
],
"pattern": "^(0|[1-9][0-9]*)(\\.[0-9]{1,18})?$",
"type": "string"
},
"asset": {
"description": "Payment asset identifier (e.g., 'USDC', 'ETH'). Optional for non-payment contexts.",
"pattern": "^[A-Z0-9]{3,10}$",
"type": "string"
},
"currency": {
"default": "USD",
"description": "ISO 4217 currency code.",
"enum": [
"USD"
],
"pattern": "^[A-Z]{3}$",
"type": "string"
},
"network": {
"description": "Payment network identifier (e.g., 'base-mainnet', 'base-sepolia'). Optional for non-payment contexts.",
"maxLength": 64,
"pattern": "^[a-z0-9-]+$",
"type": "string"
},
"precision": {
"default": 6,
"description": "Maximum decimal places supported by the asset/network. Metadata only.",
"maximum": 18,
"minimum": 0,
"type": "integer"
}
},
"required": [
"amount",
"currency"
],
"title": "Decimal Money",
"type": "object"
},
"pcc": {
"additionalProperties": false,
"definitions": {
"accessibility_status": {
"description": "Evidence accessibility status",
"enum": [
"accessible",
"unavailable",
"restricted",
"requires_authorization"
],
"type": "string"
},
"authorization_classification": {
"description": "Evidence authorization classification",
"enum": [
"public",
"buyer_authorized",
"restricted",
"confidential"
],
"type": "string"
},
"canonicalization_algorithm": {
"const": "RFC8785-JCS",
"description": "Canonicalization algorithm",
"type": "string"
},
"claim": {
"additionalProperties": false,
"properties": {
"claim_id": {
"$ref": "#/$defs/pcc/definitions/claim_id"
},
"confidence": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"evidence_ids": {
"items": {
"$ref": "#/$defs/pcc/definitions/evidence_id"
},
"type": "array"
},
"materiality": {
"$ref": "#/$defs/pcc/definitions/materiality"
},
"predicate": {
"minLength": 1,
"type": "string"
},
"value": {
"type": [
"string",
"number",
"boolean",
"object",
"array",
"null"
]
},
"verification_status": {
"$ref": "#/$defs/pcc/definitions/verification_status"
}
},
"required": [
"claim_id",
"predicate",
"value",
"confidence",
"evidence_ids",
"materiality",
"verification_status"
],
"type": "object"
},
"claim_id": {
"description": "Claim identifier",
"pattern": "^clm_[a-z0-9]{24}$",
"type": "string"
},
"completeness": {
"additionalProperties": false,
"properties": {
"missing_fields": {
"items": {
"minLength": 1,
"type": "string"
},
"type": "array"
},
"populated_fields": {
"minimum": 0,
"type": "integer"
},
"requested_fields": {
"minimum": 0,
"type": "integer"
},
"score": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"stale_fields": {
"items": {
"minLength": 1,
"type": "string"
},
"type": "array"
},
"supported_fields": {
"minimum": 0,
"type": "integer"
},
"unsupported_fields": {
"items": {
"minLength": 1,
"type": "string"
},
"type": "array"
},
"vector": {
"items": {
"$ref": "#/$defs/pcc/definitions/completeness_vector_entry"
},
"type": "array"
}
},
"required": [
"requested_fields",
"populated_fields",
"supported_fields",
"score",
"missing_fields",
"unsupported_fields",
"stale_fields",
"vector"
],
"type": "object"
},
"completeness_vector_entry": {
"additionalProperties": false,
"properties": {
"dimension": {
"minLength": 1,
"type": "string"
},
"populated": {
"minimum": 0,
"type": "integer"
},
"requested": {
"minimum": 0,
"type": "integer"
},
"score": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"supported": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"dimension",
"requested",
"populated",
"supported",
"score"
],
"type": "object"
},
"contract": {
"additionalProperties": false,
"properties": {
"currency": {
"$ref": "#/$defs/pcc/definitions/currency"
},
"expires_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"freshness_seconds": {
"minimum": 1,
"type": "integer"
},
"idempotency_key": {
"$ref": "#/$defs/pcc/definitions/idempotency_key"
},
"input_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"input_schema_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"issued_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"maximum_authorized_price": {
"$ref": "#/$defs/pcc/definitions/decimal_string"
},
"minimum_quality": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"mode": {
"$ref": "#/$defs/pcc/definitions/contract_mode"
},
"network": {
"enum": [
"base",
"base-testnet"
],
"type": "string"
},
"output_schema_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"price": {
"$ref": "#/$defs/pcc/definitions/decimal_string"
},
"quote_id": {
"$ref": "#/$defs/pcc/definitions/quote_id"
},
"service_id": {
"$ref": "#/$defs/pcc/definitions/service_id"
},
"service_version": {
"$ref": "#/$defs/pcc/definitions/service_version"
}
},
"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"
],
"type": "object"
},
"contract_mode": {
"description": "Contract mode determines required fields",
"enum": [
"paid",
"benchmark",
"offline_verification"
],
"type": "string"
},
"currency": {
"description": "Permitted currencies",
"enum": [
"USD",
"USDC"
],
"type": "string"
},
"decimal_string": {
"description": "Non-negative decimal string, no scientific notation, no leading zeros except single zero",
"pattern": "^(0|[1-9]\\d*)(\\.\\d+)?$",
"type": "string"
},
"evidence_id": {
"description": "Evidence identifier",
"pattern": "^evd_[a-z0-9]{24}$",
"type": "string"
},
"evidence_item": {
"additionalProperties": false,
"properties": {
"accessibility_status": {
"$ref": "#/$defs/pcc/definitions/accessibility_status"
},
"authorization_classification": {
"$ref": "#/$defs/pcc/definitions/authorization_classification"
},
"content_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"evidence_id": {
"$ref": "#/$defs/pcc/definitions/evidence_id"
},
"freshness_status": {
"$ref": "#/$defs/pcc/definitions/freshness_status"
},
"locator": {
"$ref": "#/$defs/pcc/definitions/locator"
},
"media_type": {
"minLength": 1,
"type": "string"
},
"retrieved_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"source_timestamp": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"source_uri": {
"format": "uri",
"minLength": 1,
"type": "string"
},
"transformation_history": {
"items": {
"$ref": "#/$defs/pcc/definitions/transformation"
},
"type": "array"
}
},
"required": [
"evidence_id",
"source_uri",
"retrieved_at",
"content_hash",
"media_type",
"locator",
"accessibility_status",
"transformation_history",
"authorization_classification",
"freshness_status"
],
"type": "object"
},
"extension_container": {
"additionalProperties": false,
"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,
"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"
}
},
"propertyNames": {
"maxLength": 253,
"minLength": 5,
"pattern": "^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?){2,}$",
"type": "string"
},
"type": "object"
},
"extension_value": {
"additionalProperties": true,
"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,
"type": "object"
},
"freshness_status": {
"description": "Evidence freshness status",
"enum": [
"fresh",
"stale",
"unknown"
],
"type": "string"
},
"hash": {
"description": "SHA-256 hash with algorithm tag",
"pattern": "^sha256:[a-f0-9]{64}$",
"type": "string"
},
"idempotency_key": {
"description": "Idempotency key",
"pattern": "^idk_[a-z0-9]{24}$",
"type": "string"
},
"job_id": {
"description": "Unique job identifier",
"pattern": "^job_[a-z0-9]{24}$",
"type": "string"
},
"key_id": {
"description": "Key identifier",
"pattern": "^kid_[a-z0-9]{24}$",
"type": "string"
},
"locator": {
"additionalProperties": false,
"properties": {
"type": {
"$ref": "#/$defs/pcc/definitions/locator_type"
},
"value": {
"minLength": 1,
"type": "string"
}
},
"required": [
"type",
"value"
],
"type": "object"
},
"locator_type": {
"description": "Evidence locator type",
"enum": [
"json_pointer",
"xpath",
"css_selector",
"text_quote",
"page_region",
"byte_range",
"database_record",
"artifact_pointer"
],
"type": "string"
},
"materiality": {
"description": "Claim materiality classification",
"enum": [
"material",
"supporting",
"contextual"
],
"type": "string"
},
"pcc_version": {
"const": "2.0.0",
"description": "PCC specification version",
"type": "string"
},
"policy_id": {
"description": "Policy identifier",
"pattern": "^pol_[a-z0-9]{24}$",
"type": "string"
},
"provenance": {
"additionalProperties": false,
"properties": {
"cache_provenance": {
"additionalProperties": false,
"properties": {
"cache_key": {
"type": "string"
},
"enabled": {
"type": "boolean"
},
"hit": {
"type": "boolean"
},
"stored_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
}
},
"required": [
"enabled",
"hit"
],
"type": "object"
},
"execution_environment": {
"additionalProperties": false,
"properties": {
"container_image": {
"type": "string"
},
"platform": {
"minLength": 1,
"type": "string"
},
"runtime": {
"minLength": 1,
"type": "string"
},
"version": {
"minLength": 1,
"type": "string"
}
},
"required": [
"runtime",
"version",
"platform"
],
"type": "object"
},
"models": {
"items": {
"additionalProperties": false,
"properties": {
"name": {
"minLength": 1,
"type": "string"
},
"provider": {
"minLength": 1,
"type": "string"
},
"version": {
"minLength": 1,
"type": "string"
}
},
"required": [
"name",
"version",
"provider"
],
"type": "object"
},
"type": "array"
},
"policy_versions": {
"additionalProperties": {
"type": "string"
},
"description": "Policy name to version mapping",
"type": "object"
},
"providers": {
"items": {
"additionalProperties": false,
"properties": {
"capabilities": {
"items": {
"type": "string"
},
"type": "array"
},
"name": {
"minLength": 1,
"type": "string"
},
"version": {
"minLength": 1,
"type": "string"
}
},
"required": [
"name",
"version",
"capabilities"
],
"type": "object"
},
"type": "array"
},
"routes": {
"items": {
"$ref": "#/$defs/pcc/definitions/provenance_route"
},
"type": "array"
},
"software_versions": {
"additionalProperties": {
"type": "string"
},
"description": "Component name to version mapping",
"type": "object"
},
"tools": {
"additionalProperties": {
"type": "string"
},
"description": "Tool name to version mapping",
"type": "object"
},
"transformations": {
"items": {
"$ref": "#/$defs/pcc/definitions/transformation"
},
"type": "array"
},
"verification_routes": {
"items": {
"$ref": "#/$defs/pcc/definitions/provenance_route"
},
"type": "array"
}
},
"required": [
"routes",
"providers",
"tools",
"models",
"software_versions",
"policy_versions",
"transformations",
"cache_provenance",
"execution_environment",
"verification_routes"
],
"type": "object"
},
"provenance_route": {
"additionalProperties": false,
"properties": {
"model_name": {
"type": "string"
},
"model_version": {
"type": "string"
},
"parameters": {
"additionalProperties": true,
"type": "object"
},
"provider": {
"minLength": 1,
"type": "string"
},
"type": {
"enum": [
"cache",
"direct",
"deterministic",
"model",
"hybrid"
],
"type": "string"
},
"version": {
"minLength": 1,
"type": "string"
}
},
"required": [
"type",
"provider",
"version"
],
"type": "object"
},
"public_verifier_result": {
"additionalProperties": false,
"properties": {
"failure_codes": {
"items": {
"minLength": 1,
"type": "string"
},
"maxItems": 200,
"type": "array"
},
"findings": {
"items": {
"additionalProperties": false,
"properties": {
"code": {
"minLength": 1,
"type": "string"
},
"severity": {
"minLength": 1,
"type": "string"
}
},
"required": [
"code",
"severity"
],
"type": "object"
},
"maxItems": 200,
"type": "array"
},
"status": {
"minLength": 1,
"type": "string"
},
"verifier_id": {
"minLength": 1,
"type": "string"
}
},
"required": [
"verifier_id",
"status",
"findings",
"failure_codes"
],
"type": "object"
},
"quote_id": {
"description": "Quote identifier",
"pattern": "^qte_[a-z0-9]{24}$",
"type": "string"
},
"receipt": {
"additionalProperties": false,
"properties": {
"canonicalization_algorithm": {
"$ref": "#/$defs/pcc/definitions/canonicalization_algorithm"
},
"output_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"policy_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"schema_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"signature": {
"pattern": "^[A-Za-z0-9_-]{86,88}$",
"type": "string"
},
"signature_algorithm": {
"$ref": "#/$defs/pcc/definitions/signature_algorithm"
},
"signed_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"signing_key_id": {
"$ref": "#/$defs/pcc/definitions/key_id"
}
},
"required": [
"output_hash",
"canonicalization_algorithm",
"policy_hash",
"schema_hash",
"signature_algorithm",
"signing_key_id",
"signature",
"signed_at"
],
"type": "object"
},
"service_id": {
"description": "Service identifier",
"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"
},
"service_version": {
"description": "Service version",
"pattern": "^v\\d+(\\.\\d+)*$",
"type": "string"
},
"signature_algorithm": {
"const": "Ed25519",
"description": "Signature algorithm",
"type": "string"
},
"subject": {
"additionalProperties": false,
"properties": {
"canonical_name": {
"minLength": 1,
"type": "string"
},
"identifiers": {
"additionalProperties": {
"type": "string"
},
"type": "object"
},
"type": {
"$ref": "#/$defs/pcc/definitions/subject_type"
}
},
"required": [
"type",
"canonical_name"
],
"type": "object"
},
"subject_type": {
"description": "Subject type",
"enum": [
"organization",
"person",
"document",
"webpage",
"other"
],
"type": "string"
},
"timestamp_rfc3339": {
"description": "RFC 3339 UTC timestamp with Z suffix, normalized fractional seconds",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?Z$",
"type": "string"
},
"transformation": {
"additionalProperties": false,
"properties": {
"parameters": {
"additionalProperties": true,
"type": "object"
},
"timestamp": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"tool_version": {
"minLength": 1,
"type": "string"
},
"type": {
"minLength": 1,
"type": "string"
}
},
"required": [
"type",
"timestamp",
"tool_version"
],
"type": "object"
},
"verification": {
"additionalProperties": false,
"properties": {
"completeness": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"cross_source_agreement": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"decision": {
"$ref": "#/$defs/pcc/definitions/verification_decision"
},
"deterministic_failures": {
"items": {
"minLength": 1,
"type": "string"
},
"type": "array"
},
"evidence_accessibility": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"failed_requirements": {
"items": {
"minLength": 1,
"type": "string"
},
"type": "array"
},
"freshness": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"material_claims_supported": {
"type": "boolean"
},
"policy": {
"$ref": "#/$defs/pcc/definitions/policy_id"
},
"prompt_injection_result": {
"additionalProperties": false,
"properties": {
"checked": {
"type": "boolean"
},
"details": {
"type": "string"
},
"result": {
"enum": [
"clean",
"suspected",
"confirmed"
],
"type": "string"
}
},
"required": [
"checked",
"result"
],
"type": "object"
},
"provenance_valid": {
"type": "boolean"
},
"schema_valid": {
"type": "boolean"
},
"score": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"verifier_versions": {
"additionalProperties": {
"type": "string"
},
"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"
],
"type": "object"
},
"verification_decision": {
"description": "Verification decision",
"enum": [
"pass",
"conditional",
"fail",
"quarantined"
],
"type": "string"
},
"verification_proof_v1": {
"additionalProperties": false,
"properties": {
"proof_version": {
"const": "1.0.0",
"type": "string"
},
"receipt": {
"$ref": "#/$defs/pcc/definitions/vnext_receipt"
},
"verification_material": {
"additionalProperties": false,
"properties": {
"verifier_results": {
"items": {
"$ref": "#/$defs/pcc/definitions/public_verifier_result"
},
"maxItems": 100,
"type": "array"
}
},
"required": [
"verifier_results"
],
"type": "object"
}
},
"required": [
"proof_version",
"receipt",
"verification_material"
],
"type": "object"
},
"verification_status": {
"description": "Claim verification status",
"enum": [
"verified",
"unsupported",
"disputed",
"pending"
],
"type": "string"
},
"vnext_receipt": {
"additionalProperties": false,
"properties": {
"canonicalization_algorithm": {
"const": "RFC8785-JCS",
"type": "string"
},
"completeness": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"contract_release": {
"const": "3.0.0",
"type": "string"
},
"decision": {
"$ref": "#/$defs/pcc/definitions/verification_decision"
},
"domain": {
"const": "SITEBORNE-PCC-VERIFICATION-PROOF-V1",
"type": "string"
},
"evidence_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"input_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"issued_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"job_id": {
"$ref": "#/$defs/pcc/definitions/job_id"
},
"limitations": {
"items": {
"minLength": 1,
"type": "string"
},
"maxItems": 200,
"type": "array"
},
"output_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"output_schema_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"pcc_document_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"pcc_schema_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"pcc_schema_release": {
"const": "2.0.0",
"type": "string"
},
"policy_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"proof_version": {
"const": "1.0.0",
"type": "string"
},
"receipt_id": {
"pattern": "^rcpt_[a-f0-9]{24}$",
"type": "string"
},
"receipt_version": {
"const": "2.0.0",
"type": "string"
},
"request_id": {
"minLength": 1,
"type": "string"
},
"service_id": {
"$ref": "#/$defs/pcc/definitions/service_id"
},
"service_version": {
"$ref": "#/$defs/pcc/definitions/service_version"
},
"signature": {
"pattern": "^[A-Za-z0-9_-]{86}$",
"type": "string"
},
"signature_algorithm": {
"const": "Ed25519",
"type": "string"
},
"signing_key_id": {
"minLength": 1,
"type": "string"
},
"verification_mode": {
"enum": [
"standard",
"independent_reproduction"
],
"type": "string"
},
"verifier_set_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
}
},
"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"
],
"type": "object"
},
"vnext_receipt_preimage": {
"additionalProperties": false,
"properties": {
"canonicalization_algorithm": {
"const": "RFC8785-JCS",
"type": "string"
},
"completeness": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"contract_release": {
"const": "3.0.0",
"type": "string"
},
"decision": {
"$ref": "#/$defs/pcc/definitions/verification_decision"
},
"domain": {
"const": "SITEBORNE-PCC-VERIFICATION-PROOF-V1",
"type": "string"
},
"evidence_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"input_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"issued_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"job_id": {
"$ref": "#/$defs/pcc/definitions/job_id"
},
"limitations": {
"items": {
"minLength": 1,
"type": "string"
},
"maxItems": 200,
"type": "array"
},
"output_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"output_schema_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"pcc_document_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"pcc_schema_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"pcc_schema_release": {
"const": "2.0.0",
"type": "string"
},
"policy_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"proof_version": {
"const": "1.0.0",
"type": "string"
},
"receipt_version": {
"const": "2.0.0",
"type": "string"
},
"request_id": {
"minLength": 1,
"type": "string"
},
"service_id": {
"$ref": "#/$defs/pcc/definitions/service_id"
},
"service_version": {
"$ref": "#/$defs/pcc/definitions/service_version"
},
"signature_algorithm": {
"const": "Ed25519",
"type": "string"
},
"signing_key_id": {
"minLength": 1,
"type": "string"
},
"verification_mode": {
"enum": [
"standard",
"independent_reproduction"
],
"type": "string"
},
"verifier_set_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
}
},
"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"
],
"type": "object"
}
},
"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",
"properties": {
"claims": {
"items": {
"$ref": "#/$defs/pcc/definitions/claim"
},
"type": "array",
"uniqueItems": true
},
"completeness": {
"$ref": "#/$defs/pcc/definitions/completeness"
},
"contract": {
"$ref": "#/$defs/pcc/definitions/contract"
},
"evidence": {
"items": {
"$ref": "#/$defs/pcc/definitions/evidence_item"
},
"type": "array",
"uniqueItems": true
},
"extensions": {
"allOf": [
{
"$ref": "#/$defs/pcc/definitions/extension_container"
},
{
"properties": {
"net.siteborne.verification-proof.v1": {
"$ref": "#/$defs/pcc/definitions/verification_proof_v1"
}
},
"required": [
"net.siteborne.verification-proof.v1"
],
"type": "object"
}
]
},
"job_id": {
"$ref": "#/$defs/pcc/definitions/job_id"
},
"pcc_version": {
"$ref": "#/$defs/pcc/definitions/pcc_version"
},
"provenance": {
"$ref": "#/$defs/pcc/definitions/provenance"
},
"receipt": {
"$ref": "#/$defs/pcc/definitions/receipt"
},
"subject": {
"$ref": "#/$defs/pcc/definitions/subject"
},
"verification": {
"$ref": "#/$defs/pcc/definitions/verification"
}
},
"required": [
"pcc_version",
"job_id",
"contract",
"subject",
"claims",
"evidence",
"completeness",
"provenance",
"verification",
"receipt"
],
"title": "Proof-Carrying Context (PCC) v2.0.0",
"type": "object"
}
},
"$id": "https://utility.siteborne.net/contracts/3.0.0/schemas/services/web-context-output.schema.json",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"allOf": [
{
"$ref": "#/$defs/pcc"
},
{
"properties": {
"contract": {
"properties": {
"output_schema_hash": {
"pattern": "^sha256:[a-f0-9]{64}$",
"type": "string"
},
"service_id": {
"enum": [
"web_context_verified.v3"
]
},
"service_version": {
"enum": [
"v3"
]
}
},
"required": [
"service_id",
"service_version",
"output_schema_hash"
],
"type": "object"
},
"extensions": {
"properties": {
"net.siteborne.web-context.v1": {
"additionalProperties": false,
"description": "Web context extension payload.",
"properties": {
"byte_count": {
"minimum": 0,
"type": "integer"
},
"cache_status": {
"additionalProperties": false,
"properties": {
"age_seconds": {
"type": "integer"
},
"freshness_seconds": {
"type": "integer"
},
"hit": {
"type": "boolean"
}
},
"type": "object"
},
"canonical_text": {
"description": "Clean text extraction.",
"maxLength": 10485760,
"type": "string"
},
"character_count": {
"minimum": 0,
"type": "integer"
},
"content_classification": {
"enum": [
"article",
"landing",
"document",
"app",
"error",
"other"
],
"type": "string"
},
"content_hash": {
"description": "Hash of processed output content.",
"pattern": "^sha256:[a-f0-9]{64}$",
"type": "string"
},
"extraction_warnings": {
"items": {
"maxLength": 256,
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"final_url": {
"description": "Final URL after redirects.",
"format": "uri",
"type": "string"
},
"http_metadata": {
"additionalProperties": false,
"properties": {
"content_length": {
"minimum": 0,
"type": "integer"
},
"content_type": {
"type": "string"
},
"headers": {
"additionalProperties": {
"type": "string"
},
"type": "object"
},
"status_code": {
"maximum": 599,
"minimum": 100,
"type": "integer"
}
},
"type": "object"
},
"limitations": {
"items": {
"maxLength": 256,
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"markdown": {
"description": "Markdown output when requested.",
"maxLength": 10485760,
"type": "string"
},
"prompt_injection_findings": {
"items": {
"additionalProperties": false,
"properties": {
"evidence_id": {
"type": "string"
},
"location": {
"type": "string"
},
"severity": {
"enum": [
"low",
"medium",
"high",
"critical"
],
"type": "string"
},
"type": {
"type": "string"
}
},
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"redirect_chain": {
"items": {
"additionalProperties": false,
"properties": {
"status_code": {
"maximum": 399,
"minimum": 300,
"type": "integer"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"url",
"status_code"
],
"type": "object"
},
"maxItems": 10,
"type": "array"
},
"rendering_metadata": {
"additionalProperties": false,
"properties": {
"engine": {
"type": "string"
},
"load_time_ms": {
"minimum": 0,
"type": "integer"
},
"network_requests": {
"minimum": 0,
"type": "integer"
},
"scripts_executed": {
"minimum": 0,
"type": "integer"
},
"version": {
"type": "string"
}
},
"type": "object"
},
"requested_url": {
"description": "Originally requested URL.",
"format": "uri",
"type": "string"
},
"retrieval_freshness": {
"description": "Timestamp of content retrieval.",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?Z$",
"type": "string"
},
"retrieval_mode_requested": {
"enum": [
"direct",
"rendered"
],
"type": "string"
},
"retrieval_mode_used": {
"description": "Mode actually used (may differ if rendered unavailable).",
"enum": [
"direct",
"rendered"
],
"type": "string"
},
"source_hash": {
"description": "Hash of raw source content.",
"pattern": "^sha256:[a-f0-9]{64}$",
"type": "string"
},
"structured_fields": {
"additionalProperties": true,
"description": "Structured extraction when requested.",
"type": "object"
},
"truncation_status": {
"additionalProperties": false,
"properties": {
"original_bytes": {
"minimum": 0,
"type": "integer"
},
"returned_bytes": {
"minimum": 0,
"type": "integer"
},
"truncated": {
"type": "boolean"
}
},
"type": "object"
}
},
"type": "object"
}
},
"propertyNames": {
"maxLength": 253,
"minLength": 5,
"pattern": "^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?){2,}$",
"type": "string"
},
"required": [
"net.siteborne.web-context.v1"
],
"type": "object"
}
},
"required": [
"contract",
"extensions"
],
"type": "object"
}
],
"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.",
"title": "Verified Web Context Output"
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$id": "https://siteborne.net/schemas/services/agent-verification-input.schema.json",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"description": "Input schema for verify_agent_output.v1 service. Supports standard and independent reproduction modes.",
"examples": [
{
"candidate_output": {
"company": "Acme Corp",
"confidence": 0.95
},
"maximum_authorized_price": {
"amount": "0.019",
"currency": "USD"
},
"required_schema": {
"properties": {
"company": {
"type": "string"
}
},
"required": [
"company"
],
"type": "object"
},
"verification_contract": {
"claims": [
{
"claim_id": "claim_1",
"expected_value": "Acme Corp",
"materiality": "material",
"predicate": "equals"
}
],
"deterministic_requirements": [
{
"check": "schema_valid",
"requirement_id": "req_1"
},
{
"check": "evidence_resolves",
"requirement_id": "req_2"
}
]
},
"verification_mode": "standard"
}
],
"properties": {
"allowed_evidence_sources": {
"description": "Up to ten permitted evidence source URIs; evidence outside this allowlist cannot satisfy source restrictions.",
"items": {
"format": "uri",
"maxLength": 2048,
"type": "string"
},
"maxItems": 10,
"type": "array"
},
"candidate_output": {
"additionalProperties": true,
"description": "Agent-produced JSON object to evaluate, bounded to 200 properties and depth 10; it is evidence under test, not trusted policy.",
"maxDepth": 10,
"maxProperties": 200,
"type": "object"
},
"freshness_requirements": {
"additionalProperties": false,
"description": "Optional maximum-age limits for evidence and schemas, each expressed in seconds.",
"properties": {
"evidence_max_age_seconds": {
"description": "Maximum evidence age in seconds from 0 through 2,592,000; older evidence fails freshness requirements.",
"maximum": 2592000,
"minimum": 0,
"type": "integer"
},
"schema_max_age_seconds": {
"description": "Maximum schema age in seconds from 0 through 2,592,000; older schemas fail freshness requirements.",
"maximum": 2592000,
"minimum": 0,
"type": "integer"
}
},
"type": "object"
},
"maximum_authorized_price": {
"additionalProperties": false,
"description": "Buyer’s decimal-safe maximum authorized price; constrains the payment requirement and never relaxes verification policy.",
"examples": [
{
"amount": "0.039",
"currency": "USD"
},
{
"amount": "0.19",
"asset": "USDC",
"currency": "USD",
"network": "base-mainnet"
}
],
"properties": {
"amount": {
"description": "Canonical decimal string. No scientific notation, no leading zeros (except single '0'), no trailing zeros unless significant, no sign. Maximum 18 decimal places.",
"examples": [
"0",
"0.009",
"0.012",
"0.019",
"0.029",
"0.039",
"0.049",
"0.19"
],
"pattern": "^(0|[1-9][0-9]*)(\\.[0-9]{1,18})?$",
"type": "string"
},
"asset": {
"description": "Payment asset identifier (e.g., 'USDC', 'ETH'). Optional for non-payment contexts.",
"pattern": "^[A-Z0-9]{3,10}$",
"type": "string"
},
"currency": {
"default": "USD",
"description": "ISO 4217 currency code.",
"enum": [
"USD"
],
"pattern": "^[A-Z]{3}$",
"type": "string"
},
"network": {
"description": "Payment network identifier (e.g., 'base-mainnet', 'base-sepolia'). Optional for non-payment contexts.",
"maxLength": 64,
"pattern": "^[a-z0-9-]+$",
"type": "string"
},
"precision": {
"default": 6,
"description": "Maximum decimal places supported by the asset/network. Metadata only.",
"maximum": 18,
"minimum": 0,
"type": "integer"
}
},
"required": [
"amount",
"currency"
],
"title": "Decimal Money",
"type": "object"
},
"minimum_score": {
"default": 0.7,
"description": "Minimum overall verification score from 0 through 1; raising it makes the final acceptance verdict stricter.",
"maximum": 1,
"minimum": 0,
"type": "number"
},
"required_schema": {
"additionalProperties": true,
"description": "JSON Schema the candidate output must satisfy; it constrains validation and cannot change SITEBORNE verifier policy.",
"type": "object"
},
"supplied_evidence": {
"description": "Up to twenty evidence objects supplied with the candidate output and bound to integrity hashes.",
"items": {
"additionalProperties": false,
"properties": {
"content": {
"additionalProperties": true,
"description": "JSON evidence content whose integrity must agree with content_hash; it is treated as untrusted input.",
"type": "object"
},
"content_hash": {
"description": "Lowercase SHA-256 integrity identifier in sha256:<64 hex> form for the supplied content.",
"pattern": "^sha256:[a-f0-9]{64}$",
"type": "string"
},
"evidence_id": {
"description": "Caller-stable evidence identifier up to 64 characters, used to connect claims to this evidence item.",
"maxLength": 64,
"type": "string"
},
"retrieved_at": {
"description": "Optional UTC retrieval timestamp in the schema’s RFC 3339 form, used by freshness checks.",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?Z$",
"type": "string"
},
"source_uri": {
"description": "Optional public source URI, up to 2,048 characters, identifying where the evidence was obtained.",
"format": "uri",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"evidence_id",
"content",
"content_hash"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"verification_contract": {
"additionalProperties": false,
"description": "Complete set of claims and deterministic checks against which the supplied candidate output is evaluated.",
"properties": {
"claims": {
"description": "Up to fifty expected claims; each binds a stable claim identifier to a predicate, expected value, and optional tolerance/materiality.",
"items": {
"additionalProperties": false,
"properties": {
"claim_id": {
"description": "Caller-stable claim identifier up to 64 characters, used to correlate the verdict for this claim.",
"maxLength": 64,
"type": "string"
},
"expected_value": {
"description": "Expected JSON value interpreted by the selected predicate; its shape should match the claim being tested.",
"type": [
"string",
"number",
"boolean",
"object",
"array",
"null"
]
},
"materiality": {
"default": "material",
"description": "Claim importance—material, supporting, or contextual—which affects how the verdict weighs a failed claim.",
"enum": [
"material",
"supporting",
"contextual"
],
"type": "string"
},
"predicate": {
"description": "Comparison operation applied to the candidate value: equality, containment, pattern, ordering, existence, or nonexistence.",
"enum": [
"equals",
"contains",
"matches",
"greater_than",
"less_than",
"exists",
"not_exists"
],
"type": "string"
},
"tolerance": {
"description": "Optional nonnegative numeric tolerance for comparisons where bounded deviation is acceptable.",
"minimum": 0,
"type": "number"
}
},
"required": [
"claim_id",
"predicate",
"expected_value"
],
"type": "object"
},
"maxItems": 50,
"type": "array"
},
"deterministic_requirements": {
"description": "Up to thirty deterministic checks for schema, hashes, signatures, evidence resolution, PII, or secrets.",
"items": {
"additionalProperties": false,
"properties": {
"check": {
"description": "Closed deterministic check to run: schema, hash, signature, evidence resolution, PII absence, or secret absence.",
"enum": [
"schema_valid",
"hash_match",
"signature_valid",
"evidence_resolves",
"no_pii",
"no_secrets"
],
"type": "string"
},
"parameters": {
"additionalProperties": true,
"description": "Check-specific configuration interpreted only by the selected deterministic check; it cannot modify verifier policy.",
"type": "object"
},
"requirement_id": {
"description": "Caller-stable requirement identifier up to 64 characters, used to correlate the deterministic check result.",
"maxLength": 64,
"type": "string"
}
},
"required": [
"requirement_id",
"check"
],
"type": "object"
},
"maxItems": 30,
"type": "array"
}
},
"required": [
"claims",
"deterministic_requirements"
],
"type": "object"
},
"verification_mode": {
"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.",
"enum": [
"standard",
"independent_reproduction"
],
"type": "string"
}
},
"required": [
"verification_contract",
"candidate_output",
"required_schema",
"verification_mode"
],
"title": "Agent Output Verification Input",
"type": "object"
},
"name": "siteborne_verify_agent_output",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"result": {
"$defs": {
"money": {
"additionalProperties": false,
"description": "Canonical decimal-safe money representation. No binary floating-point. Amount is a canonical decimal string.",
"examples": [
{
"amount": "0.039",
"currency": "USD"
},
{
"amount": "0.19",
"asset": "USDC",
"currency": "USD",
"network": "base-mainnet"
}
],
"properties": {
"amount": {
"description": "Canonical decimal string. No scientific notation, no leading zeros (except single '0'), no trailing zeros unless significant, no sign. Maximum 18 decimal places.",
"examples": [
"0",
"0.009",
"0.012",
"0.019",
"0.029",
"0.039",
"0.049",
"0.19"
],
"pattern": "^(0|[1-9][0-9]*)(\\.[0-9]{1,18})?$",
"type": "string"
},
"asset": {
"description": "Payment asset identifier (e.g., 'USDC', 'ETH'). Optional for non-payment contexts.",
"pattern": "^[A-Z0-9]{3,10}$",
"type": "string"
},
"currency": {
"default": "USD",
"description": "ISO 4217 currency code.",
"enum": [
"USD"
],
"pattern": "^[A-Z]{3}$",
"type": "string"
},
"network": {
"description": "Payment network identifier (e.g., 'base-mainnet', 'base-sepolia'). Optional for non-payment contexts.",
"maxLength": 64,
"pattern": "^[a-z0-9-]+$",
"type": "string"
},
"precision": {
"default": 6,
"description": "Maximum decimal places supported by the asset/network. Metadata only.",
"maximum": 18,
"minimum": 0,
"type": "integer"
}
},
"required": [
"amount",
"currency"
],
"title": "Decimal Money",
"type": "object"
},
"pcc": {
"additionalProperties": false,
"definitions": {
"accessibility_status": {
"description": "Evidence accessibility status",
"enum": [
"accessible",
"unavailable",
"restricted",
"requires_authorization"
],
"type": "string"
},
"authorization_classification": {
"description": "Evidence authorization classification",
"enum": [
"public",
"buyer_authorized",
"restricted",
"confidential"
],
"type": "string"
},
"canonicalization_algorithm": {
"const": "RFC8785-JCS",
"description": "Canonicalization algorithm",
"type": "string"
},
"claim": {
"additionalProperties": false,
"properties": {
"claim_id": {
"$ref": "#/$defs/pcc/definitions/claim_id"
},
"confidence": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"evidence_ids": {
"items": {
"$ref": "#/$defs/pcc/definitions/evidence_id"
},
"type": "array"
},
"materiality": {
"$ref": "#/$defs/pcc/definitions/materiality"
},
"predicate": {
"minLength": 1,
"type": "string"
},
"value": {
"type": [
"string",
"number",
"boolean",
"object",
"array",
"null"
]
},
"verification_status": {
"$ref": "#/$defs/pcc/definitions/verification_status"
}
},
"required": [
"claim_id",
"predicate",
"value",
"confidence",
"evidence_ids",
"materiality",
"verification_status"
],
"type": "object"
},
"claim_id": {
"description": "Claim identifier",
"pattern": "^clm_[a-z0-9]{24}$",
"type": "string"
},
"completeness": {
"additionalProperties": false,
"properties": {
"missing_fields": {
"items": {
"minLength": 1,
"type": "string"
},
"type": "array"
},
"populated_fields": {
"minimum": 0,
"type": "integer"
},
"requested_fields": {
"minimum": 0,
"type": "integer"
},
"score": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"stale_fields": {
"items": {
"minLength": 1,
"type": "string"
},
"type": "array"
},
"supported_fields": {
"minimum": 0,
"type": "integer"
},
"unsupported_fields": {
"items": {
"minLength": 1,
"type": "string"
},
"type": "array"
},
"vector": {
"items": {
"$ref": "#/$defs/pcc/definitions/completeness_vector_entry"
},
"type": "array"
}
},
"required": [
"requested_fields",
"populated_fields",
"supported_fields",
"score",
"missing_fields",
"unsupported_fields",
"stale_fields",
"vector"
],
"type": "object"
},
"completeness_vector_entry": {
"additionalProperties": false,
"properties": {
"dimension": {
"minLength": 1,
"type": "string"
},
"populated": {
"minimum": 0,
"type": "integer"
},
"requested": {
"minimum": 0,
"type": "integer"
},
"score": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"supported": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"dimension",
"requested",
"populated",
"supported",
"score"
],
"type": "object"
},
"contract": {
"additionalProperties": false,
"properties": {
"currency": {
"$ref": "#/$defs/pcc/definitions/currency"
},
"expires_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"freshness_seconds": {
"minimum": 1,
"type": "integer"
},
"idempotency_key": {
"$ref": "#/$defs/pcc/definitions/idempotency_key"
},
"input_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"input_schema_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"issued_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"maximum_authorized_price": {
"$ref": "#/$defs/pcc/definitions/decimal_string"
},
"minimum_quality": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"mode": {
"$ref": "#/$defs/pcc/definitions/contract_mode"
},
"network": {
"enum": [
"base",
"base-testnet"
],
"type": "string"
},
"output_schema_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"price": {
"$ref": "#/$defs/pcc/definitions/decimal_string"
},
"quote_id": {
"$ref": "#/$defs/pcc/definitions/quote_id"
},
"service_id": {
"$ref": "#/$defs/pcc/definitions/service_id"
},
"service_version": {
"$ref": "#/$defs/pcc/definitions/service_version"
}
},
"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"
],
"type": "object"
},
"contract_mode": {
"description": "Contract mode determines required fields",
"enum": [
"paid",
"benchmark",
"offline_verification"
],
"type": "string"
},
"currency": {
"description": "Permitted currencies",
"enum": [
"USD",
"USDC"
],
"type": "string"
},
"decimal_string": {
"description": "Non-negative decimal string, no scientific notation, no leading zeros except single zero",
"pattern": "^(0|[1-9]\\d*)(\\.\\d+)?$",
"type": "string"
},
"evidence_id": {
"description": "Evidence identifier",
"pattern": "^evd_[a-z0-9]{24}$",
"type": "string"
},
"evidence_item": {
"additionalProperties": false,
"properties": {
"accessibility_status": {
"$ref": "#/$defs/pcc/definitions/accessibility_status"
},
"authorization_classification": {
"$ref": "#/$defs/pcc/definitions/authorization_classification"
},
"content_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"evidence_id": {
"$ref": "#/$defs/pcc/definitions/evidence_id"
},
"freshness_status": {
"$ref": "#/$defs/pcc/definitions/freshness_status"
},
"locator": {
"$ref": "#/$defs/pcc/definitions/locator"
},
"media_type": {
"minLength": 1,
"type": "string"
},
"retrieved_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"source_timestamp": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"source_uri": {
"format": "uri",
"minLength": 1,
"type": "string"
},
"transformation_history": {
"items": {
"$ref": "#/$defs/pcc/definitions/transformation"
},
"type": "array"
}
},
"required": [
"evidence_id",
"source_uri",
"retrieved_at",
"content_hash",
"media_type",
"locator",
"accessibility_status",
"transformation_history",
"authorization_classification",
"freshness_status"
],
"type": "object"
},
"extension_container": {
"additionalProperties": false,
"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,
"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"
}
},
"propertyNames": {
"maxLength": 253,
"minLength": 5,
"pattern": "^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?){2,}$",
"type": "string"
},
"type": "object"
},
"extension_value": {
"additionalProperties": true,
"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,
"type": "object"
},
"freshness_status": {
"description": "Evidence freshness status",
"enum": [
"fresh",
"stale",
"unknown"
],
"type": "string"
},
"hash": {
"description": "SHA-256 hash with algorithm tag",
"pattern": "^sha256:[a-f0-9]{64}$",
"type": "string"
},
"idempotency_key": {
"description": "Idempotency key",
"pattern": "^idk_[a-z0-9]{24}$",
"type": "string"
},
"job_id": {
"description": "Unique job identifier",
"pattern": "^job_[a-z0-9]{24}$",
"type": "string"
},
"key_id": {
"description": "Key identifier",
"pattern": "^kid_[a-z0-9]{24}$",
"type": "string"
},
"locator": {
"additionalProperties": false,
"properties": {
"type": {
"$ref": "#/$defs/pcc/definitions/locator_type"
},
"value": {
"minLength": 1,
"type": "string"
}
},
"required": [
"type",
"value"
],
"type": "object"
},
"locator_type": {
"description": "Evidence locator type",
"enum": [
"json_pointer",
"xpath",
"css_selector",
"text_quote",
"page_region",
"byte_range",
"database_record",
"artifact_pointer"
],
"type": "string"
},
"materiality": {
"description": "Claim materiality classification",
"enum": [
"material",
"supporting",
"contextual"
],
"type": "string"
},
"pcc_version": {
"const": "1.0.0",
"description": "PCC specification version",
"type": "string"
},
"policy_id": {
"description": "Policy identifier",
"pattern": "^pol_[a-z0-9]{24}$",
"type": "string"
},
"provenance": {
"additionalProperties": false,
"properties": {
"cache_provenance": {
"additionalProperties": false,
"properties": {
"cache_key": {
"type": "string"
},
"enabled": {
"type": "boolean"
},
"hit": {
"type": "boolean"
},
"stored_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
}
},
"required": [
"enabled",
"hit"
],
"type": "object"
},
"execution_environment": {
"additionalProperties": false,
"properties": {
"container_image": {
"type": "string"
},
"platform": {
"minLength": 1,
"type": "string"
},
"runtime": {
"minLength": 1,
"type": "string"
},
"version": {
"minLength": 1,
"type": "string"
}
},
"required": [
"runtime",
"version",
"platform"
],
"type": "object"
},
"models": {
"items": {
"additionalProperties": false,
"properties": {
"name": {
"minLength": 1,
"type": "string"
},
"provider": {
"minLength": 1,
"type": "string"
},
"version": {
"minLength": 1,
"type": "string"
}
},
"required": [
"name",
"version",
"provider"
],
"type": "object"
},
"type": "array"
},
"policy_versions": {
"additionalProperties": {
"type": "string"
},
"description": "Policy name to version mapping",
"type": "object"
},
"providers": {
"items": {
"additionalProperties": false,
"properties": {
"capabilities": {
"items": {
"type": "string"
},
"type": "array"
},
"name": {
"minLength": 1,
"type": "string"
},
"version": {
"minLength": 1,
"type": "string"
}
},
"required": [
"name",
"version",
"capabilities"
],
"type": "object"
},
"type": "array"
},
"routes": {
"items": {
"$ref": "#/$defs/pcc/definitions/provenance_route"
},
"type": "array"
},
"software_versions": {
"additionalProperties": {
"type": "string"
},
"description": "Component name to version mapping",
"type": "object"
},
"tools": {
"additionalProperties": {
"type": "string"
},
"description": "Tool name to version mapping",
"type": "object"
},
"transformations": {
"items": {
"$ref": "#/$defs/pcc/definitions/transformation"
},
"type": "array"
},
"verification_routes": {
"items": {
"$ref": "#/$defs/pcc/definitions/provenance_route"
},
"type": "array"
}
},
"required": [
"routes",
"providers",
"tools",
"models",
"software_versions",
"policy_versions",
"transformations",
"cache_provenance",
"execution_environment",
"verification_routes"
],
"type": "object"
},
"provenance_route": {
"additionalProperties": false,
"properties": {
"model_name": {
"type": "string"
},
"model_version": {
"type": "string"
},
"parameters": {
"additionalProperties": true,
"type": "object"
},
"provider": {
"minLength": 1,
"type": "string"
},
"type": {
"enum": [
"cache",
"direct",
"deterministic",
"model",
"hybrid"
],
"type": "string"
},
"version": {
"minLength": 1,
"type": "string"
}
},
"required": [
"type",
"provider",
"version"
],
"type": "object"
},
"quote_id": {
"description": "Quote identifier",
"pattern": "^qte_[a-z0-9]{24}$",
"type": "string"
},
"receipt": {
"additionalProperties": false,
"properties": {
"canonicalization_algorithm": {
"$ref": "#/$defs/pcc/definitions/canonicalization_algorithm"
},
"output_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"policy_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"schema_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"signature": {
"pattern": "^[A-Za-z0-9_-]{86,88}$",
"type": "string"
},
"signature_algorithm": {
"$ref": "#/$defs/pcc/definitions/signature_algorithm"
},
"signed_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"signing_key_id": {
"$ref": "#/$defs/pcc/definitions/key_id"
}
},
"required": [
"output_hash",
"canonicalization_algorithm",
"policy_hash",
"schema_hash",
"signature_algorithm",
"signing_key_id",
"signature",
"signed_at"
],
"type": "object"
},
"service_id": {
"description": "Service identifier",
"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"
},
"service_version": {
"description": "Service version",
"pattern": "^v\\d+(\\.\\d+)*$",
"type": "string"
},
"signature_algorithm": {
"const": "Ed25519",
"description": "Signature algorithm",
"type": "string"
},
"subject": {
"additionalProperties": false,
"properties": {
"canonical_name": {
"minLength": 1,
"type": "string"
},
"identifiers": {
"additionalProperties": {
"type": "string"
},
"type": "object"
},
"type": {
"$ref": "#/$defs/pcc/definitions/subject_type"
}
},
"required": [
"type",
"canonical_name"
],
"type": "object"
},
"subject_type": {
"description": "Subject type",
"enum": [
"organization",
"person",
"document",
"webpage",
"other"
],
"type": "string"
},
"timestamp_rfc3339": {
"description": "RFC 3339 UTC timestamp with Z suffix, normalized fractional seconds",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?Z$",
"type": "string"
},
"transformation": {
"additionalProperties": false,
"properties": {
"parameters": {
"additionalProperties": true,
"type": "object"
},
"timestamp": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"tool_version": {
"minLength": 1,
"type": "string"
},
"type": {
"minLength": 1,
"type": "string"
}
},
"required": [
"type",
"timestamp",
"tool_version"
],
"type": "object"
},
"verification": {
"additionalProperties": false,
"properties": {
"completeness": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"cross_source_agreement": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"decision": {
"$ref": "#/$defs/pcc/definitions/verification_decision"
},
"deterministic_failures": {
"items": {
"minLength": 1,
"type": "string"
},
"type": "array"
},
"evidence_accessibility": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"failed_requirements": {
"items": {
"minLength": 1,
"type": "string"
},
"type": "array"
},
"freshness": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"material_claims_supported": {
"type": "boolean"
},
"policy": {
"$ref": "#/$defs/pcc/definitions/policy_id"
},
"prompt_injection_result": {
"additionalProperties": false,
"properties": {
"checked": {
"type": "boolean"
},
"details": {
"type": "string"
},
"result": {
"enum": [
"clean",
"suspected",
"confirmed"
],
"type": "string"
}
},
"required": [
"checked",
"result"
],
"type": "object"
},
"provenance_valid": {
"type": "boolean"
},
"schema_valid": {
"type": "boolean"
},
"score": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"verifier_versions": {
"additionalProperties": {
"type": "string"
},
"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"
],
"type": "object"
},
"verification_decision": {
"description": "Verification decision",
"enum": [
"pass",
"conditional",
"fail",
"quarantined"
],
"type": "string"
},
"verification_status": {
"description": "Claim verification status",
"enum": [
"verified",
"unsupported",
"disputed",
"pending"
],
"type": "string"
}
},
"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",
"properties": {
"claims": {
"items": {
"$ref": "#/$defs/pcc/definitions/claim"
},
"type": "array",
"uniqueItems": true
},
"completeness": {
"$ref": "#/$defs/pcc/definitions/completeness"
},
"contract": {
"$ref": "#/$defs/pcc/definitions/contract"
},
"evidence": {
"items": {
"$ref": "#/$defs/pcc/definitions/evidence_item"
},
"type": "array",
"uniqueItems": true
},
"extensions": {
"$ref": "#/$defs/pcc/definitions/extension_container"
},
"job_id": {
"$ref": "#/$defs/pcc/definitions/job_id"
},
"pcc_version": {
"$ref": "#/$defs/pcc/definitions/pcc_version"
},
"provenance": {
"$ref": "#/$defs/pcc/definitions/provenance"
},
"receipt": {
"$ref": "#/$defs/pcc/definitions/receipt"
},
"subject": {
"$ref": "#/$defs/pcc/definitions/subject"
},
"verification": {
"$ref": "#/$defs/pcc/definitions/verification"
}
},
"required": [
"pcc_version",
"job_id",
"contract",
"subject",
"claims",
"evidence",
"completeness",
"provenance",
"verification",
"receipt"
],
"title": "Proof-Carrying Context (PCC) v1.0.0",
"type": "object"
}
},
"$id": "https://siteborne.net/schemas/services/agent-verification-output.schema.json",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"allOf": [
{
"$ref": "#/$defs/pcc"
},
{
"properties": {
"contract": {
"properties": {
"output_schema_hash": {
"pattern": "^sha256:[a-f0-9]{64}$",
"type": "string"
},
"service_id": {
"enum": [
"verify_agent_output.v1",
"verify_agent_output.v2"
]
},
"service_version": {
"enum": [
"v1",
"v2"
]
}
},
"required": [
"service_id",
"service_version",
"output_schema_hash"
],
"type": "object"
},
"extensions": {
"properties": {
"net.siteborne.agent-verification.v1": {
"additionalProperties": false,
"description": "Agent verification extension payload.",
"properties": {
"candidate_output_hash": {
"pattern": "^sha256:[a-f0-9]{64}$",
"type": "string"
},
"claim_support_result": {
"additionalProperties": false,
"properties": {
"conflicting_count": {
"minimum": 0,
"type": "integer"
},
"supported": {
"type": "boolean"
},
"supported_count": {
"minimum": 0,
"type": "integer"
},
"unsupported_count": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"supported",
"unsupported_count"
],
"type": "object"
},
"deterministic_failures": {
"items": {
"additionalProperties": false,
"properties": {
"blocks_pass": {
"const": true,
"type": "boolean"
},
"reason": {
"type": "string"
},
"requirement_id": {
"type": "string"
}
},
"required": [
"requirement_id",
"reason"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"evidence_result": {
"additionalProperties": false,
"properties": {
"resolved": {
"type": "boolean"
},
"resolved_count": {
"minimum": 0,
"type": "integer"
},
"unresolved_count": {
"minimum": 0,
"type": "integer"
},
"unresolved_ids": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"resolved",
"unresolved_count"
],
"type": "object"
},
"failed_requirements": {
"items": {
"type": "string"
},
"maxItems": 50,
"type": "array"
},
"limitations": {
"items": {
"maxLength": 256,
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"outcome": {
"enum": [
"pass",
"fail",
"conditional"
],
"type": "string"
},
"policy_version": {
"pattern": "^v[0-9]+(\\.[0-9]+)*$",
"type": "string"
},
"reproduction_agreement_score": {
"description": "Present only for independent_reproduction mode.",
"maximum": 1,
"minimum": 0,
"type": "number"
},
"reproduction_output_hash": {
"description": "Present only for independent_reproduction mode.",
"pattern": "^sha256:[a-f0-9]{64}$",
"type": "string"
},
"reproduction_result": {
"additionalProperties": false,
"description": "Present only for independent_reproduction mode.",
"properties": {
"agreement_score": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"differences": {
"items": {
"additionalProperties": false,
"properties": {
"candidate_value": {
"type": [
"string",
"number",
"boolean",
"null"
]
},
"path": {
"type": "string"
},
"reproduced_value": {
"type": [
"string",
"number",
"boolean",
"null"
]
}
},
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"reproduced": {
"type": "boolean"
},
"reproduction_output_hash": {
"pattern": "^sha256:[a-f0-9]{64}$",
"type": "string"
}
},
"type": "object"
},
"requirement_results": {
"items": {
"additionalProperties": false,
"properties": {
"details": {
"type": "string"
},
"evidence_ids": {
"items": {
"type": "string"
},
"type": "array"
},
"passed": {
"type": "boolean"
},
"requirement_id": {
"type": "string"
}
},
"required": [
"requirement_id",
"passed"
],
"type": "object"
},
"maxItems": 50,
"type": "array"
},
"schema_result": {
"additionalProperties": false,
"properties": {
"errors": {
"items": {
"type": "string"
},
"type": "array"
},
"valid": {
"type": "boolean"
}
},
"required": [
"valid"
],
"type": "object"
},
"score": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"unverifiable_assertions": {
"items": {
"additionalProperties": false,
"properties": {
"claim_id": {
"type": "string"
},
"reason": {
"type": "string"
}
},
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"verification_mode": {
"enum": [
"standard",
"independent_reproduction"
],
"type": "string"
},
"verifier_classes_used": {
"items": {
"type": "string"
},
"maxItems": 10,
"type": "array"
}
},
"type": "object"
}
},
"propertyNames": {
"maxLength": 253,
"minLength": 5,
"pattern": "^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?){2,}$",
"type": "string"
},
"required": [
"net.siteborne.agent-verification.v1"
],
"type": "object"
}
},
"required": [
"contract",
"extensions"
],
"type": "object"
}
],
"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.",
"examples": [
{
"claims": [],
"completeness": {
"missing_fields": [
"ceo_name"
],
"populated_fields": 4,
"requested_fields": 5,
"score": 0.8,
"stale_fields": [],
"supported_fields": 4,
"unsupported_fields": [],
"vector": [
{
"dimension": "general",
"populated": 4,
"requested": 5,
"score": 0.8,
"supported": 4
}
]
},
"contract": {
"currency": "USD",
"expires_at": "2026-08-06T10:00:00Z",
"freshness_seconds": 3600,
"idempotency_key": "idk_aaaaaaaaaaaaaaaaaaaaaaaa",
"input_hash": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"input_schema_hash": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
"issued_at": "2026-08-05T10:00:00Z",
"minimum_quality": 0.8,
"mode": "paid",
"output_schema_hash": "sha256:abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
"quote_id": "qte_aaaaaaaaaaaaaaaaaaaaaaaa",
"service_id": "verify_agent_output.v1",
"service_version": "v1"
},
"evidence": [],
"extensions": {
"net.siteborne.agent-verification.v1": {
"candidate_output_hash": "sha256:abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
"claim_support_result": {
"supported": true,
"supported_count": 1,
"unsupported_count": 0
},
"evidence_result": {
"resolved": true,
"resolved_count": 2,
"unresolved_count": 0
},
"outcome": "pass",
"policy_version": "v1",
"requirement_results": [
{
"evidence_ids": [
"evd_1"
],
"passed": true,
"requirement_id": "req_1"
},
{
"evidence_ids": [
"evd_2"
],
"passed": true,
"requirement_id": "req_2"
}
],
"schema_result": {
"errors": [],
"valid": true
},
"score": 0.92,
"verification_mode": "standard",
"verifier_classes_used": [
"schema_validator",
"evidence_resolver"
]
}
},
"job_id": "job_aaaaaaaaaaaaaaaaaaaaaaaa",
"pcc_version": "1.0.0",
"provenance": {
"cache_provenance": {
"enabled": false,
"hit": false
},
"execution_environment": {
"platform": "linux",
"runtime": "node",
"version": "22.0.0"
},
"models": [],
"policy_versions": {
"verification": "1.0.0"
},
"providers": [
{
"capabilities": [
"fetch"
],
"name": "web",
"version": "1.0.0"
}
],
"routes": [
{
"provider": "web",
"type": "direct",
"version": "1.0.0"
}
],
"software_versions": {
"pcc": "1.0.0"
},
"tools": {
"curl": "8.0.0"
},
"transformations": [],
"verification_routes": []
},
"receipt": {
"canonicalization_algorithm": "RFC8785-JCS",
"output_hash": "sha256:eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
"policy_hash": "sha256:ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
"schema_hash": "sha256:0000000000000000000000000000000000000000000000000000000000000000",
"signature": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"signature_algorithm": "Ed25519",
"signed_at": "2026-08-05T10:00:00Z",
"signing_key_id": "kid_aaaaaaaaaaaaaaaaaaaaaaaa"
},
"subject": {
"canonical_name": "Acme Example Corp",
"identifiers": {
"domain": "acme.example.com"
},
"type": "organization"
},
"verification": {
"completeness": 0.8,
"cross_source_agreement": 1,
"decision": "pass",
"deterministic_failures": [],
"evidence_accessibility": 1,
"failed_requirements": [],
"freshness": 1,
"material_claims_supported": true,
"policy": "pol_aaaaaaaaaaaaaaaaaaaaaaaa",
"prompt_injection_result": {
"checked": true,
"result": "clean"
},
"provenance_valid": true,
"schema_valid": true,
"score": 0.9,
"verifier_versions": {
"pcc": "1.0.0"
}
}
}
],
"title": "Agent Output Verification Output"
}
},
"required": [
"result"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$id": "https://siteborne.net/schemas/services/agent-verification-input.schema.json",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"description": "Input schema for verify_agent_output.v1 service. Supports standard and independent reproduction modes.",
"examples": [
{
"candidate_output": {
"company": "Acme Corp",
"confidence": 0.95
},
"maximum_authorized_price": {
"amount": "0.019",
"currency": "USD"
},
"required_schema": {
"properties": {
"company": {
"type": "string"
}
},
"required": [
"company"
],
"type": "object"
},
"verification_contract": {
"claims": [
{
"claim_id": "claim_1",
"expected_value": "Acme Corp",
"materiality": "material",
"predicate": "equals"
}
],
"deterministic_requirements": [
{
"check": "schema_valid",
"requirement_id": "req_1"
},
{
"check": "evidence_resolves",
"requirement_id": "req_2"
}
]
},
"verification_mode": "standard"
}
],
"properties": {
"allowed_evidence_sources": {
"description": "Up to ten permitted evidence source URIs; evidence outside this allowlist cannot satisfy source restrictions.",
"items": {
"format": "uri",
"maxLength": 2048,
"type": "string"
},
"maxItems": 10,
"type": "array"
},
"candidate_output": {
"additionalProperties": true,
"description": "Agent-produced JSON object to evaluate, bounded to 200 properties and depth 10; it is evidence under test, not trusted policy.",
"maxDepth": 10,
"maxProperties": 200,
"type": "object"
},
"freshness_requirements": {
"additionalProperties": false,
"description": "Optional maximum-age limits for evidence and schemas, each expressed in seconds.",
"properties": {
"evidence_max_age_seconds": {
"description": "Maximum evidence age in seconds from 0 through 2,592,000; older evidence fails freshness requirements.",
"maximum": 2592000,
"minimum": 0,
"type": "integer"
},
"schema_max_age_seconds": {
"description": "Maximum schema age in seconds from 0 through 2,592,000; older schemas fail freshness requirements.",
"maximum": 2592000,
"minimum": 0,
"type": "integer"
}
},
"type": "object"
},
"maximum_authorized_price": {
"additionalProperties": false,
"description": "Buyer’s decimal-safe maximum authorized price; constrains the payment requirement and never relaxes verification policy.",
"examples": [
{
"amount": "0.039",
"currency": "USD"
},
{
"amount": "0.19",
"asset": "USDC",
"currency": "USD",
"network": "base-mainnet"
}
],
"properties": {
"amount": {
"description": "Canonical decimal string. No scientific notation, no leading zeros (except single '0'), no trailing zeros unless significant, no sign. Maximum 18 decimal places.",
"examples": [
"0",
"0.009",
"0.012",
"0.019",
"0.029",
"0.039",
"0.049",
"0.19"
],
"pattern": "^(0|[1-9][0-9]*)(\\.[0-9]{1,18})?$",
"type": "string"
},
"asset": {
"description": "Payment asset identifier (e.g., 'USDC', 'ETH'). Optional for non-payment contexts.",
"pattern": "^[A-Z0-9]{3,10}$",
"type": "string"
},
"currency": {
"default": "USD",
"description": "ISO 4217 currency code.",
"enum": [
"USD"
],
"pattern": "^[A-Z]{3}$",
"type": "string"
},
"network": {
"description": "Payment network identifier (e.g., 'base-mainnet', 'base-sepolia'). Optional for non-payment contexts.",
"maxLength": 64,
"pattern": "^[a-z0-9-]+$",
"type": "string"
},
"precision": {
"default": 6,
"description": "Maximum decimal places supported by the asset/network. Metadata only.",
"maximum": 18,
"minimum": 0,
"type": "integer"
}
},
"required": [
"amount",
"currency"
],
"title": "Decimal Money",
"type": "object"
},
"minimum_score": {
"default": 0.7,
"description": "Minimum overall verification score from 0 through 1; raising it makes the final acceptance verdict stricter.",
"maximum": 1,
"minimum": 0,
"type": "number"
},
"required_schema": {
"additionalProperties": true,
"description": "JSON Schema the candidate output must satisfy; it constrains validation and cannot change SITEBORNE verifier policy.",
"type": "object"
},
"supplied_evidence": {
"description": "Up to twenty evidence objects supplied with the candidate output and bound to integrity hashes.",
"items": {
"additionalProperties": false,
"properties": {
"content": {
"additionalProperties": true,
"description": "JSON evidence content whose integrity must agree with content_hash; it is treated as untrusted input.",
"type": "object"
},
"content_hash": {
"description": "Lowercase SHA-256 integrity identifier in sha256:<64 hex> form for the supplied content.",
"pattern": "^sha256:[a-f0-9]{64}$",
"type": "string"
},
"evidence_id": {
"description": "Caller-stable evidence identifier up to 64 characters, used to connect claims to this evidence item.",
"maxLength": 64,
"type": "string"
},
"retrieved_at": {
"description": "Optional UTC retrieval timestamp in the schema’s RFC 3339 form, used by freshness checks.",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?Z$",
"type": "string"
},
"source_uri": {
"description": "Optional public source URI, up to 2,048 characters, identifying where the evidence was obtained.",
"format": "uri",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"evidence_id",
"content",
"content_hash"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"verification_contract": {
"additionalProperties": false,
"description": "Complete set of claims and deterministic checks against which the supplied candidate output is evaluated.",
"properties": {
"claims": {
"description": "Up to fifty expected claims; each binds a stable claim identifier to a predicate, expected value, and optional tolerance/materiality.",
"items": {
"additionalProperties": false,
"properties": {
"claim_id": {
"description": "Caller-stable claim identifier up to 64 characters, used to correlate the verdict for this claim.",
"maxLength": 64,
"type": "string"
},
"expected_value": {
"description": "Expected JSON value interpreted by the selected predicate; its shape should match the claim being tested.",
"type": [
"string",
"number",
"boolean",
"object",
"array",
"null"
]
},
"materiality": {
"default": "material",
"description": "Claim importance—material, supporting, or contextual—which affects how the verdict weighs a failed claim.",
"enum": [
"material",
"supporting",
"contextual"
],
"type": "string"
},
"predicate": {
"description": "Comparison operation applied to the candidate value: equality, containment, pattern, ordering, existence, or nonexistence.",
"enum": [
"equals",
"contains",
"matches",
"greater_than",
"less_than",
"exists",
"not_exists"
],
"type": "string"
},
"tolerance": {
"description": "Optional nonnegative numeric tolerance for comparisons where bounded deviation is acceptable.",
"minimum": 0,
"type": "number"
}
},
"required": [
"claim_id",
"predicate",
"expected_value"
],
"type": "object"
},
"maxItems": 50,
"type": "array"
},
"deterministic_requirements": {
"description": "Up to thirty deterministic checks for schema, hashes, signatures, evidence resolution, PII, or secrets.",
"items": {
"additionalProperties": false,
"properties": {
"check": {
"description": "Closed deterministic check to run: schema, hash, signature, evidence resolution, PII absence, or secret absence.",
"enum": [
"schema_valid",
"hash_match",
"signature_valid",
"evidence_resolves",
"no_pii",
"no_secrets"
],
"type": "string"
},
"parameters": {
"additionalProperties": true,
"description": "Check-specific configuration interpreted only by the selected deterministic check; it cannot modify verifier policy.",
"type": "object"
},
"requirement_id": {
"description": "Caller-stable requirement identifier up to 64 characters, used to correlate the deterministic check result.",
"maxLength": 64,
"type": "string"
}
},
"required": [
"requirement_id",
"check"
],
"type": "object"
},
"maxItems": 30,
"type": "array"
}
},
"required": [
"claims",
"deterministic_requirements"
],
"type": "object"
},
"verification_mode": {
"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.",
"enum": [
"standard",
"independent_reproduction"
],
"type": "string"
}
},
"required": [
"verification_contract",
"candidate_output",
"required_schema",
"verification_mode"
],
"title": "Agent Output Verification Input",
"type": "object"
},
"name": "siteborne_verify_agent_output_v3_candidate",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"result": {
"$defs": {
"money": {
"additionalProperties": false,
"description": "Canonical decimal-safe money representation. No binary floating-point. Amount is a canonical decimal string.",
"examples": [
{
"amount": "0.039",
"currency": "USD"
},
{
"amount": "0.19",
"asset": "USDC",
"currency": "USD",
"network": "base-mainnet"
}
],
"properties": {
"amount": {
"description": "Canonical decimal string. No scientific notation, no leading zeros (except single '0'), no trailing zeros unless significant, no sign. Maximum 18 decimal places.",
"examples": [
"0",
"0.009",
"0.012",
"0.019",
"0.029",
"0.039",
"0.049",
"0.19"
],
"pattern": "^(0|[1-9][0-9]*)(\\.[0-9]{1,18})?$",
"type": "string"
},
"asset": {
"description": "Payment asset identifier (e.g., 'USDC', 'ETH'). Optional for non-payment contexts.",
"pattern": "^[A-Z0-9]{3,10}$",
"type": "string"
},
"currency": {
"default": "USD",
"description": "ISO 4217 currency code.",
"enum": [
"USD"
],
"pattern": "^[A-Z]{3}$",
"type": "string"
},
"network": {
"description": "Payment network identifier (e.g., 'base-mainnet', 'base-sepolia'). Optional for non-payment contexts.",
"maxLength": 64,
"pattern": "^[a-z0-9-]+$",
"type": "string"
},
"precision": {
"default": 6,
"description": "Maximum decimal places supported by the asset/network. Metadata only.",
"maximum": 18,
"minimum": 0,
"type": "integer"
}
},
"required": [
"amount",
"currency"
],
"title": "Decimal Money",
"type": "object"
},
"pcc": {
"additionalProperties": false,
"definitions": {
"accessibility_status": {
"description": "Evidence accessibility status",
"enum": [
"accessible",
"unavailable",
"restricted",
"requires_authorization"
],
"type": "string"
},
"authorization_classification": {
"description": "Evidence authorization classification",
"enum": [
"public",
"buyer_authorized",
"restricted",
"confidential"
],
"type": "string"
},
"canonicalization_algorithm": {
"const": "RFC8785-JCS",
"description": "Canonicalization algorithm",
"type": "string"
},
"claim": {
"additionalProperties": false,
"properties": {
"claim_id": {
"$ref": "#/$defs/pcc/definitions/claim_id"
},
"confidence": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"evidence_ids": {
"items": {
"$ref": "#/$defs/pcc/definitions/evidence_id"
},
"type": "array"
},
"materiality": {
"$ref": "#/$defs/pcc/definitions/materiality"
},
"predicate": {
"minLength": 1,
"type": "string"
},
"value": {
"type": [
"string",
"number",
"boolean",
"object",
"array",
"null"
]
},
"verification_status": {
"$ref": "#/$defs/pcc/definitions/verification_status"
}
},
"required": [
"claim_id",
"predicate",
"value",
"confidence",
"evidence_ids",
"materiality",
"verification_status"
],
"type": "object"
},
"claim_id": {
"description": "Claim identifier",
"pattern": "^clm_[a-z0-9]{24}$",
"type": "string"
},
"completeness": {
"additionalProperties": false,
"properties": {
"missing_fields": {
"items": {
"minLength": 1,
"type": "string"
},
"type": "array"
},
"populated_fields": {
"minimum": 0,
"type": "integer"
},
"requested_fields": {
"minimum": 0,
"type": "integer"
},
"score": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"stale_fields": {
"items": {
"minLength": 1,
"type": "string"
},
"type": "array"
},
"supported_fields": {
"minimum": 0,
"type": "integer"
},
"unsupported_fields": {
"items": {
"minLength": 1,
"type": "string"
},
"type": "array"
},
"vector": {
"items": {
"$ref": "#/$defs/pcc/definitions/completeness_vector_entry"
},
"type": "array"
}
},
"required": [
"requested_fields",
"populated_fields",
"supported_fields",
"score",
"missing_fields",
"unsupported_fields",
"stale_fields",
"vector"
],
"type": "object"
},
"completeness_vector_entry": {
"additionalProperties": false,
"properties": {
"dimension": {
"minLength": 1,
"type": "string"
},
"populated": {
"minimum": 0,
"type": "integer"
},
"requested": {
"minimum": 0,
"type": "integer"
},
"score": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"supported": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"dimension",
"requested",
"populated",
"supported",
"score"
],
"type": "object"
},
"contract": {
"additionalProperties": false,
"properties": {
"currency": {
"$ref": "#/$defs/pcc/definitions/currency"
},
"expires_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"freshness_seconds": {
"minimum": 1,
"type": "integer"
},
"idempotency_key": {
"$ref": "#/$defs/pcc/definitions/idempotency_key"
},
"input_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"input_schema_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"issued_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"maximum_authorized_price": {
"$ref": "#/$defs/pcc/definitions/decimal_string"
},
"minimum_quality": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"mode": {
"$ref": "#/$defs/pcc/definitions/contract_mode"
},
"network": {
"enum": [
"base",
"base-testnet"
],
"type": "string"
},
"output_schema_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"price": {
"$ref": "#/$defs/pcc/definitions/decimal_string"
},
"quote_id": {
"$ref": "#/$defs/pcc/definitions/quote_id"
},
"service_id": {
"$ref": "#/$defs/pcc/definitions/service_id"
},
"service_version": {
"$ref": "#/$defs/pcc/definitions/service_version"
}
},
"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"
],
"type": "object"
},
"contract_mode": {
"description": "Contract mode determines required fields",
"enum": [
"paid",
"benchmark",
"offline_verification"
],
"type": "string"
},
"currency": {
"description": "Permitted currencies",
"enum": [
"USD",
"USDC"
],
"type": "string"
},
"decimal_string": {
"description": "Non-negative decimal string, no scientific notation, no leading zeros except single zero",
"pattern": "^(0|[1-9]\\d*)(\\.\\d+)?$",
"type": "string"
},
"evidence_id": {
"description": "Evidence identifier",
"pattern": "^evd_[a-z0-9]{24}$",
"type": "string"
},
"evidence_item": {
"additionalProperties": false,
"properties": {
"accessibility_status": {
"$ref": "#/$defs/pcc/definitions/accessibility_status"
},
"authorization_classification": {
"$ref": "#/$defs/pcc/definitions/authorization_classification"
},
"content_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"evidence_id": {
"$ref": "#/$defs/pcc/definitions/evidence_id"
},
"freshness_status": {
"$ref": "#/$defs/pcc/definitions/freshness_status"
},
"locator": {
"$ref": "#/$defs/pcc/definitions/locator"
},
"media_type": {
"minLength": 1,
"type": "string"
},
"retrieved_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"source_timestamp": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"source_uri": {
"format": "uri",
"minLength": 1,
"type": "string"
},
"transformation_history": {
"items": {
"$ref": "#/$defs/pcc/definitions/transformation"
},
"type": "array"
}
},
"required": [
"evidence_id",
"source_uri",
"retrieved_at",
"content_hash",
"media_type",
"locator",
"accessibility_status",
"transformation_history",
"authorization_classification",
"freshness_status"
],
"type": "object"
},
"extension_container": {
"additionalProperties": false,
"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,
"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"
}
},
"propertyNames": {
"maxLength": 253,
"minLength": 5,
"pattern": "^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?){2,}$",
"type": "string"
},
"type": "object"
},
"extension_value": {
"additionalProperties": true,
"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,
"type": "object"
},
"freshness_status": {
"description": "Evidence freshness status",
"enum": [
"fresh",
"stale",
"unknown"
],
"type": "string"
},
"hash": {
"description": "SHA-256 hash with algorithm tag",
"pattern": "^sha256:[a-f0-9]{64}$",
"type": "string"
},
"idempotency_key": {
"description": "Idempotency key",
"pattern": "^idk_[a-z0-9]{24}$",
"type": "string"
},
"job_id": {
"description": "Unique job identifier",
"pattern": "^job_[a-z0-9]{24}$",
"type": "string"
},
"key_id": {
"description": "Key identifier",
"pattern": "^kid_[a-z0-9]{24}$",
"type": "string"
},
"locator": {
"additionalProperties": false,
"properties": {
"type": {
"$ref": "#/$defs/pcc/definitions/locator_type"
},
"value": {
"minLength": 1,
"type": "string"
}
},
"required": [
"type",
"value"
],
"type": "object"
},
"locator_type": {
"description": "Evidence locator type",
"enum": [
"json_pointer",
"xpath",
"css_selector",
"text_quote",
"page_region",
"byte_range",
"database_record",
"artifact_pointer"
],
"type": "string"
},
"materiality": {
"description": "Claim materiality classification",
"enum": [
"material",
"supporting",
"contextual"
],
"type": "string"
},
"pcc_version": {
"const": "2.0.0",
"description": "PCC specification version",
"type": "string"
},
"policy_id": {
"description": "Policy identifier",
"pattern": "^pol_[a-z0-9]{24}$",
"type": "string"
},
"provenance": {
"additionalProperties": false,
"properties": {
"cache_provenance": {
"additionalProperties": false,
"properties": {
"cache_key": {
"type": "string"
},
"enabled": {
"type": "boolean"
},
"hit": {
"type": "boolean"
},
"stored_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
}
},
"required": [
"enabled",
"hit"
],
"type": "object"
},
"execution_environment": {
"additionalProperties": false,
"properties": {
"container_image": {
"type": "string"
},
"platform": {
"minLength": 1,
"type": "string"
},
"runtime": {
"minLength": 1,
"type": "string"
},
"version": {
"minLength": 1,
"type": "string"
}
},
"required": [
"runtime",
"version",
"platform"
],
"type": "object"
},
"models": {
"items": {
"additionalProperties": false,
"properties": {
"name": {
"minLength": 1,
"type": "string"
},
"provider": {
"minLength": 1,
"type": "string"
},
"version": {
"minLength": 1,
"type": "string"
}
},
"required": [
"name",
"version",
"provider"
],
"type": "object"
},
"type": "array"
},
"policy_versions": {
"additionalProperties": {
"type": "string"
},
"description": "Policy name to version mapping",
"type": "object"
},
"providers": {
"items": {
"additionalProperties": false,
"properties": {
"capabilities": {
"items": {
"type": "string"
},
"type": "array"
},
"name": {
"minLength": 1,
"type": "string"
},
"version": {
"minLength": 1,
"type": "string"
}
},
"required": [
"name",
"version",
"capabilities"
],
"type": "object"
},
"type": "array"
},
"routes": {
"items": {
"$ref": "#/$defs/pcc/definitions/provenance_route"
},
"type": "array"
},
"software_versions": {
"additionalProperties": {
"type": "string"
},
"description": "Component name to version mapping",
"type": "object"
},
"tools": {
"additionalProperties": {
"type": "string"
},
"description": "Tool name to version mapping",
"type": "object"
},
"transformations": {
"items": {
"$ref": "#/$defs/pcc/definitions/transformation"
},
"type": "array"
},
"verification_routes": {
"items": {
"$ref": "#/$defs/pcc/definitions/provenance_route"
},
"type": "array"
}
},
"required": [
"routes",
"providers",
"tools",
"models",
"software_versions",
"policy_versions",
"transformations",
"cache_provenance",
"execution_environment",
"verification_routes"
],
"type": "object"
},
"provenance_route": {
"additionalProperties": false,
"properties": {
"model_name": {
"type": "string"
},
"model_version": {
"type": "string"
},
"parameters": {
"additionalProperties": true,
"type": "object"
},
"provider": {
"minLength": 1,
"type": "string"
},
"type": {
"enum": [
"cache",
"direct",
"deterministic",
"model",
"hybrid"
],
"type": "string"
},
"version": {
"minLength": 1,
"type": "string"
}
},
"required": [
"type",
"provider",
"version"
],
"type": "object"
},
"public_verifier_result": {
"additionalProperties": false,
"properties": {
"failure_codes": {
"items": {
"minLength": 1,
"type": "string"
},
"maxItems": 200,
"type": "array"
},
"findings": {
"items": {
"additionalProperties": false,
"properties": {
"code": {
"minLength": 1,
"type": "string"
},
"severity": {
"minLength": 1,
"type": "string"
}
},
"required": [
"code",
"severity"
],
"type": "object"
},
"maxItems": 200,
"type": "array"
},
"status": {
"minLength": 1,
"type": "string"
},
"verifier_id": {
"minLength": 1,
"type": "string"
}
},
"required": [
"verifier_id",
"status",
"findings",
"failure_codes"
],
"type": "object"
},
"quote_id": {
"description": "Quote identifier",
"pattern": "^qte_[a-z0-9]{24}$",
"type": "string"
},
"receipt": {
"additionalProperties": false,
"properties": {
"canonicalization_algorithm": {
"$ref": "#/$defs/pcc/definitions/canonicalization_algorithm"
},
"output_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"policy_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"schema_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"signature": {
"pattern": "^[A-Za-z0-9_-]{86,88}$",
"type": "string"
},
"signature_algorithm": {
"$ref": "#/$defs/pcc/definitions/signature_algorithm"
},
"signed_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"signing_key_id": {
"$ref": "#/$defs/pcc/definitions/key_id"
}
},
"required": [
"output_hash",
"canonicalization_algorithm",
"policy_hash",
"schema_hash",
"signature_algorithm",
"signing_key_id",
"signature",
"signed_at"
],
"type": "object"
},
"service_id": {
"description": "Service identifier",
"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"
},
"service_version": {
"description": "Service version",
"pattern": "^v\\d+(\\.\\d+)*$",
"type": "string"
},
"signature_algorithm": {
"const": "Ed25519",
"description": "Signature algorithm",
"type": "string"
},
"subject": {
"additionalProperties": false,
"properties": {
"canonical_name": {
"minLength": 1,
"type": "string"
},
"identifiers": {
"additionalProperties": {
"type": "string"
},
"type": "object"
},
"type": {
"$ref": "#/$defs/pcc/definitions/subject_type"
}
},
"required": [
"type",
"canonical_name"
],
"type": "object"
},
"subject_type": {
"description": "Subject type",
"enum": [
"organization",
"person",
"document",
"webpage",
"other"
],
"type": "string"
},
"timestamp_rfc3339": {
"description": "RFC 3339 UTC timestamp with Z suffix, normalized fractional seconds",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?Z$",
"type": "string"
},
"transformation": {
"additionalProperties": false,
"properties": {
"parameters": {
"additionalProperties": true,
"type": "object"
},
"timestamp": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"tool_version": {
"minLength": 1,
"type": "string"
},
"type": {
"minLength": 1,
"type": "string"
}
},
"required": [
"type",
"timestamp",
"tool_version"
],
"type": "object"
},
"verification": {
"additionalProperties": false,
"properties": {
"completeness": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"cross_source_agreement": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"decision": {
"$ref": "#/$defs/pcc/definitions/verification_decision"
},
"deterministic_failures": {
"items": {
"minLength": 1,
"type": "string"
},
"type": "array"
},
"evidence_accessibility": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"failed_requirements": {
"items": {
"minLength": 1,
"type": "string"
},
"type": "array"
},
"freshness": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"material_claims_supported": {
"type": "boolean"
},
"policy": {
"$ref": "#/$defs/pcc/definitions/policy_id"
},
"prompt_injection_result": {
"additionalProperties": false,
"properties": {
"checked": {
"type": "boolean"
},
"details": {
"type": "string"
},
"result": {
"enum": [
"clean",
"suspected",
"confirmed"
],
"type": "string"
}
},
"required": [
"checked",
"result"
],
"type": "object"
},
"provenance_valid": {
"type": "boolean"
},
"schema_valid": {
"type": "boolean"
},
"score": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"verifier_versions": {
"additionalProperties": {
"type": "string"
},
"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"
],
"type": "object"
},
"verification_decision": {
"description": "Verification decision",
"enum": [
"pass",
"conditional",
"fail",
"quarantined"
],
"type": "string"
},
"verification_proof_v1": {
"additionalProperties": false,
"properties": {
"proof_version": {
"const": "1.0.0",
"type": "string"
},
"receipt": {
"$ref": "#/$defs/pcc/definitions/vnext_receipt"
},
"verification_material": {
"additionalProperties": false,
"properties": {
"verifier_results": {
"items": {
"$ref": "#/$defs/pcc/definitions/public_verifier_result"
},
"maxItems": 100,
"type": "array"
}
},
"required": [
"verifier_results"
],
"type": "object"
}
},
"required": [
"proof_version",
"receipt",
"verification_material"
],
"type": "object"
},
"verification_status": {
"description": "Claim verification status",
"enum": [
"verified",
"unsupported",
"disputed",
"pending"
],
"type": "string"
},
"vnext_receipt": {
"additionalProperties": false,
"properties": {
"canonicalization_algorithm": {
"const": "RFC8785-JCS",
"type": "string"
},
"completeness": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"contract_release": {
"const": "3.0.0",
"type": "string"
},
"decision": {
"$ref": "#/$defs/pcc/definitions/verification_decision"
},
"domain": {
"const": "SITEBORNE-PCC-VERIFICATION-PROOF-V1",
"type": "string"
},
"evidence_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"input_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"issued_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"job_id": {
"$ref": "#/$defs/pcc/definitions/job_id"
},
"limitations": {
"items": {
"minLength": 1,
"type": "string"
},
"maxItems": 200,
"type": "array"
},
"output_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"output_schema_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"pcc_document_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"pcc_schema_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"pcc_schema_release": {
"const": "2.0.0",
"type": "string"
},
"policy_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"proof_version": {
"const": "1.0.0",
"type": "string"
},
"receipt_id": {
"pattern": "^rcpt_[a-f0-9]{24}$",
"type": "string"
},
"receipt_version": {
"const": "2.0.0",
"type": "string"
},
"request_id": {
"minLength": 1,
"type": "string"
},
"service_id": {
"$ref": "#/$defs/pcc/definitions/service_id"
},
"service_version": {
"$ref": "#/$defs/pcc/definitions/service_version"
},
"signature": {
"pattern": "^[A-Za-z0-9_-]{86}$",
"type": "string"
},
"signature_algorithm": {
"const": "Ed25519",
"type": "string"
},
"signing_key_id": {
"minLength": 1,
"type": "string"
},
"verification_mode": {
"enum": [
"standard",
"independent_reproduction"
],
"type": "string"
},
"verifier_set_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
}
},
"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"
],
"type": "object"
},
"vnext_receipt_preimage": {
"additionalProperties": false,
"properties": {
"canonicalization_algorithm": {
"const": "RFC8785-JCS",
"type": "string"
},
"completeness": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"contract_release": {
"const": "3.0.0",
"type": "string"
},
"decision": {
"$ref": "#/$defs/pcc/definitions/verification_decision"
},
"domain": {
"const": "SITEBORNE-PCC-VERIFICATION-PROOF-V1",
"type": "string"
},
"evidence_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"input_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"issued_at": {
"$ref": "#/$defs/pcc/definitions/timestamp_rfc3339"
},
"job_id": {
"$ref": "#/$defs/pcc/definitions/job_id"
},
"limitations": {
"items": {
"minLength": 1,
"type": "string"
},
"maxItems": 200,
"type": "array"
},
"output_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"output_schema_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"pcc_document_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"pcc_schema_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"pcc_schema_release": {
"const": "2.0.0",
"type": "string"
},
"policy_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
},
"proof_version": {
"const": "1.0.0",
"type": "string"
},
"receipt_version": {
"const": "2.0.0",
"type": "string"
},
"request_id": {
"minLength": 1,
"type": "string"
},
"service_id": {
"$ref": "#/$defs/pcc/definitions/service_id"
},
"service_version": {
"$ref": "#/$defs/pcc/definitions/service_version"
},
"signature_algorithm": {
"const": "Ed25519",
"type": "string"
},
"signing_key_id": {
"minLength": 1,
"type": "string"
},
"verification_mode": {
"enum": [
"standard",
"independent_reproduction"
],
"type": "string"
},
"verifier_set_hash": {
"$ref": "#/$defs/pcc/definitions/hash"
}
},
"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"
],
"type": "object"
}
},
"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",
"properties": {
"claims": {
"items": {
"$ref": "#/$defs/pcc/definitions/claim"
},
"type": "array",
"uniqueItems": true
},
"completeness": {
"$ref": "#/$defs/pcc/definitions/completeness"
},
"contract": {
"$ref": "#/$defs/pcc/definitions/contract"
},
"evidence": {
"items": {
"$ref": "#/$defs/pcc/definitions/evidence_item"
},
"type": "array",
"uniqueItems": true
},
"extensions": {
"allOf": [
{
"$ref": "#/$defs/pcc/definitions/extension_container"
},
{
"properties": {
"net.siteborne.verification-proof.v1": {
"$ref": "#/$defs/pcc/definitions/verification_proof_v1"
}
},
"required": [
"net.siteborne.verification-proof.v1"
],
"type": "object"
}
]
},
"job_id": {
"$ref": "#/$defs/pcc/definitions/job_id"
},
"pcc_version": {
"$ref": "#/$defs/pcc/definitions/pcc_version"
},
"provenance": {
"$ref": "#/$defs/pcc/definitions/provenance"
},
"receipt": {
"$ref": "#/$defs/pcc/definitions/receipt"
},
"subject": {
"$ref": "#/$defs/pcc/definitions/subject"
},
"verification": {
"$ref": "#/$defs/pcc/definitions/verification"
}
},
"required": [
"pcc_version",
"job_id",
"contract",
"subject",
"claims",
"evidence",
"completeness",
"provenance",
"verification",
"receipt"
],
"title": "Proof-Carrying Context (PCC) v2.0.0",
"type": "object"
}
},
"$id": "https://utility.siteborne.net/contracts/3.0.0/schemas/services/agent-verification-output.schema.json",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"allOf": [
{
"$ref": "#/$defs/pcc"
},
{
"properties": {
"contract": {
"properties": {
"output_schema_hash": {
"pattern": "^sha256:[a-f0-9]{64}$",
"type": "string"
},
"service_id": {
"enum": [
"verify_agent_output.v3"
]
},
"service_version": {
"enum": [
"v3"
]
}
},
"required": [
"service_id",
"service_version",
"output_schema_hash"
],
"type": "object"
},
"extensions": {
"properties": {
"net.siteborne.agent-verification.v1": {
"additionalProperties": false,
"description": "Agent verification extension payload.",
"properties": {
"candidate_output_hash": {
"pattern": "^sha256:[a-f0-9]{64}$",
"type": "string"
},
"claim_support_result": {
"additionalProperties": false,
"properties": {
"conflicting_count": {
"minimum": 0,
"type": "integer"
},
"supported": {
"type": "boolean"
},
"supported_count": {
"minimum": 0,
"type": "integer"
},
"unsupported_count": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"supported",
"unsupported_count"
],
"type": "object"
},
"deterministic_failures": {
"items": {
"additionalProperties": false,
"properties": {
"blocks_pass": {
"const": true,
"type": "boolean"
},
"reason": {
"type": "string"
},
"requirement_id": {
"type": "string"
}
},
"required": [
"requirement_id",
"reason"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"evidence_result": {
"additionalProperties": false,
"properties": {
"resolved": {
"type": "boolean"
},
"resolved_count": {
"minimum": 0,
"type": "integer"
},
"unresolved_count": {
"minimum": 0,
"type": "integer"
},
"unresolved_ids": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"resolved",
"unresolved_count"
],
"type": "object"
},
"failed_requirements": {
"items": {
"type": "string"
},
"maxItems": 50,
"type": "array"
},
"limitations": {
"items": {
"maxLength": 256,
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"outcome": {
"enum": [
"pass",
"fail",
"conditional"
],
"type": "string"
},
"policy_version": {
"pattern": "^v[0-9]+(\\.[0-9]+)*$",
"type": "string"
},
"reproduction_agreement_score": {
"description": "Present only for independent_reproduction mode.",
"maximum": 1,
"minimum": 0,
"type": "number"
},
"reproduction_output_hash": {
"description": "Present only for independent_reproduction mode.",
"pattern": "^sha256:[a-f0-9]{64}$",
"type": "string"
},
"reproduction_result": {
"additionalProperties": false,
"description": "Present only for independent_reproduction mode.",
"properties": {
"agreement_score": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"differences": {
"items": {
"additionalProperties": false,
"properties": {
"candidate_value": {
"type": [
"string",
"number",
"boolean",
"null"
]
},
"path": {
"type": "string"
},
"reproduced_value": {
"type": [
"string",
"number",
"boolean",
"null"
]
}
},
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"reproduced": {
"type": "boolean"
},
"reproduction_output_hash": {
"pattern": "^sha256:[a-f0-9]{64}$",
"type": "string"
}
},
"type": "object"
},
"requirement_results": {
"items": {
"additionalProperties": false,
"properties": {
"details": {
"type": "string"
},
"evidence_ids": {
"items": {
"type": "string"
},
"type": "array"
},
"passed": {
"type": "boolean"
},
"requirement_id": {
"type": "string"
}
},
"required": [
"requirement_id",
"passed"
],
"type": "object"
},
"maxItems": 50,
"type": "array"
},
"schema_result": {
"additionalProperties": false,
"properties": {
"errors": {
"items": {
"type": "string"
},
"type": "array"
},
"valid": {
"type": "boolean"
}
},
"required": [
"valid"
],
"type": "object"
},
"score": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"unverifiable_assertions": {
"items": {
"additionalProperties": false,
"properties": {
"claim_id": {
"type": "string"
},
"reason": {
"type": "string"
}
},
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"verification_mode": {
"enum": [
"standard",
"independent_reproduction"
],
"type": "string"
},
"verifier_classes_used": {
"items": {
"type": "string"
},
"maxItems": 10,
"type": "array"
}
},
"type": "object"
}
},
"propertyNames": {
"maxLength": 253,
"minLength": 5,
"pattern": "^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?){2,}$",
"type": "string"
},
"required": [
"net.siteborne.agent-verification.v1"
],
"type": "object"
}
},
"required": [
"contract",
"extensions"
],
"type": "object"
}
],
"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.",
"title": "Agent Output Verification Output"
}
},
"required": [
"result"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:c8883434173f7e11b1142431a32460ed37591c45e716d06fa7afa05b022e7003 | sha256sum