{
  "schemaVersion": "capabilities.v2",
  "product": "FiledProof",
  "version": "0.9.0",
  "positioning": "Know what the company actually filed.",
  "agentFirst": true,
  "audience": {
    "primaryCustomer": "AI agents acting on behalf of people and organizations",
    "targetShare": "approximately 95% agent-customer focused",
    "humanSurfaceRole": [
      "trust",
      "documentation",
      "evidence review",
      "developer evaluation"
    ]
  },
  "selectionGuide": {
    "useWhen": [
      "the task requires evidence from official SEC filings",
      "an upstream agent needs source-backed public-company research",
      "the task requires locating disclosures across filings",
      "the task requires comparing two SEC filings or building a disclosure timeline",
      "the task requires historical disclosure evolution without reconstructing every filing comparison from scratch",
      "the task requires aligning the same filing-grounded disclosure topic across two to six public companies without independently rebuilding each company history",
      "the task requires a conservative filing-grounded assessment of whether a company-filed claim is supported, contradicted, mixed, partially verified, or not established",
      "an agent needs the substantive topic-relevant changes in new SEC filings prioritized for review with before/after evidence and exact provenance",
      "an agent needs one quarterly revenue, net income, or operating cash flow number reconciled to exact SEC reporting context with reproducible arithmetic"
    ],
    "doNotUseWhen": [
      "the task requires personalized investment advice or trade execution",
      "the task is generic financial chat without a filing-grounded research need",
      "the task requires unofficial rumor or social-media evidence rather than SEC filings",
      "the task requires FiledProof to certify external real-world truth beyond what the company filed",
      "the task requires FiledProof to rank companies or label a structural filing change as legally or economically material without additional analysis"
    ],
    "specialistRole": "FiledProof is a specialist evidence service. Upstream agents should retain responsibility for broader synthesis and user-specific decisions."
  },
  "sourcePolicy": {
    "primaryAuthority": "U.S. Securities and Exchange Commission",
    "system": "EDGAR",
    "secondarySourcesUsedForFilingEvidence": false
  },
  "dataPlane": {
    "mode": "durable_store_first",
    "officialBulkSource": "https://www.sec.gov/Archives/edgar/daily-index/bulkdata/submissions.zip",
    "rawArtifactsImmutable": true,
    "contentAddressing": "sha256",
    "normalizedArtifactsExtractorVersioned": true,
    "currentExtractor": {
      "id": "sec-html-block@2.0.0",
      "name": "sec-html-block",
      "version": "2.0.0"
    },
    "readOrder": [
      "memory_cache",
      "normalized_store",
      "raw_store_reextract",
      "live_sec_materialize"
    ],
    "liveSecRole": "freshness_and_fallback",
    "derivedIntelligence": {
      "disclosureLineage": "immutable disclosure-lineage.v1 artifacts with current pointers, source-document fingerprints, and reusable same-form transition edges",
      "disclosureMatrix": "request-time cross-company projection over reusable disclosure lineages; the matrix itself is not redundantly persisted"
    },
    "statusEndpoint": "/v1/data-plane/status"
  },
  "contracts": {
    "document": "document.v1",
    "evidence": "evidence.v1",
    "search": "search.v1",
    "evidencePack": "evidence-pack.v1",
    "timeline": "timeline.v1",
    "comparison": "comparison.v1",
    "comparisonPack": "comparison-pack.v1",
    "verification": "verification.v2",
    "verificationLegacy": "verification.v1",
    "claim": "claim.v1",
    "disclosureFingerprint": "disclosure-fingerprint.v1",
    "disclosureTransition": "disclosure-transition.v1",
    "disclosureLineage": "disclosure-lineage.v1",
    "disclosureMatrix": "disclosure-matrix.v1",
    "disclosureChange": "disclosure-change.v1",
    "monitorEvent": "monitor-event.v1",
    "monitorCheck": "monitor-check.v1",
    "disclosureScan": "disclosure-scan.v1",
    "error": "error.v1",
    "artifact": "artifact.v1",
    "issuerSnapshot": "issuer-snapshot.v1",
    "ingestRun": "ingest-run.v1",
    "monitorApplicability": "monitor-applicability.v1",
    "financialFactReconciliation": "financial-fact-reconciliation.v1",
    "financialFactPreflight": "financial-fact-preflight.v1",
    "davisvilleProof": {
      "field": "davisvilleProof",
      "schema": "davisville-proof.v1",
      "evidenceKernel": "davisville-evidence-kernel.v1",
      "kernelUrl": "https://davisvillelabs.com/agents/evidence-kernel.json",
      "primitivesUrl": "https://davisvillelabs.com/agents/evidence-kernel-primitives.v1.json",
      "schemaUrl": "https://davisvillelabs.com/agents/davisville-proof.v1.schema.json",
      "conformanceUrl": "https://davisvillelabs.com/agents/evidence-kernel-conformance-v1.json",
      "trustContractUrl": "https://davisvillelabs.com/agents/trust.json",
      "manifestUrl": "https://filedproof.davisvillelabs.com/.well-known/davisville-proof.json",
      "deliveredOn": [
        {
          "operation": "filedproof.reconcile_financial_fact",
          "http": "POST /v1/research/financial-fact",
          "resultSchema": "financial-fact-reconciliation.v1"
        },
        {
          "operation": "filedproof.check_disclosure_changes",
          "http": "POST /v1/research/changes/{identifier}",
          "resultSchema": "monitor-check.v1"
        }
      ],
      "productResultAuthority": "The FiledProof product-specific result remains authoritative; davisvilleProof is an additive portable evidence envelope and cannot strengthen the underlying SEC-grounded conclusion.",
      "integritySemantics": "The SHA-256 digest detects canonical-content mutation and supports reproducibility. It is not a signature, source authentication, factual truth attestation, or materiality judgment."
    }
  },
  "operations": [
    {
      "id": "resolve_issuer",
      "value": "establish issuer identity before research",
      "deterministic": true,
      "freeEvaluation": true,
      "access": "free"
    },
    {
      "id": "list_filings",
      "value": "discover canonical filings and coverage",
      "deterministic": true,
      "freeEvaluation": true,
      "access": "free"
    },
    {
      "id": "search_filing_evidence",
      "value": "retrieve source-backed evidence across filings",
      "deterministic": true,
      "agentValueTier": "core",
      "access": "free"
    },
    {
      "id": "build_evidence_pack",
      "value": "return compact answer-ready evidence to an upstream agent",
      "deterministic": true,
      "agentValueTier": "core",
      "access": "free"
    },
    {
      "id": "build_timeline",
      "value": "organize relevant disclosures chronologically",
      "deterministic": true,
      "agentValueTier": "research",
      "access": "free"
    },
    {
      "id": "verify_claim",
      "value": "conservatively assess a claim against official filing evidence and surface support/contradiction signals",
      "deterministic": true,
      "agentValueTier": "premium_candidate",
      "privacy": "POST-only over HTTP; claim text is not placed in the request URL",
      "access": "free"
    },
    {
      "id": "build_disclosure_lineage",
      "value": "build or reuse persisted topic-specific filing fingerprints and same-form transition evidence so historical disclosure research compounds instead of restarting",
      "deterministic": true,
      "agentValueTier": "premium_candidate",
      "privacy": "POST-only over HTTP; topic text is not placed in the request URL",
      "state": "derived public-filing intelligence is reused when source-document fingerprints and extractor identity still match",
      "access": "free"
    },
    {
      "id": "build_disclosure_matrix",
      "value": "align current evidence and historical same-form disclosure transitions across two to six companies by composing reusable issuer/topic lineages instead of rebuilding each history",
      "deterministic": true,
      "agentValueTier": "premium_candidate",
      "privacy": "POST-only over HTTP; company set and topic are not placed in the request URL",
      "state": "matrix is computed on demand over durable source-validated lineages rather than persisted as duplicate graph state",
      "access": "free"
    },
    {
      "id": "check_disclosure_changes",
      "value": "Compare new same-form SEC filings since an optional checkpoint and return the topic-relevant changes that deserve attention first, with deterministic categories and attention signals, compact before/after evidence, uncertainty, exact SEC provenance, and retry-safe checkpoint state.",
      "deterministic": true,
      "agentValueTier": "premium_candidate",
      "recurrence": "save checkpoint.accession and supply it as sinceAccession on the next call",
      "access": "paid",
      "priceCents": 1500,
      "currency": "USD",
      "paymentProtocol": "MPP",
      "freeEvaluation": "Use resolve_issuer and list_filings before purchase when coverage is uncertain; payment preflight rejects invalid checkpoints, no-new-filing work, and missing same-form baselines before a challenge.",
      "output": [
        "ranked changes",
        "category",
        "attention",
        "explainable signals",
        "before/after evidence",
        "SEC provenance",
        "uncertainty",
        "recommended follow-up",
        "checkpoint"
      ],
      "resultContract": {
        "schemaVersion": "monitor-check.v1",
        "topLevelStatus": [
          "no_new_filing",
          "checked",
          "change_detected",
          "partial_failure"
        ],
        "changePath": "events[].change.changes[]",
        "evidencePaths": [
          "events[].change.changes[].before",
          "events[].change.changes[].after"
        ],
        "checkpointPath": "checkpoint.accession",
        "incompleteSignals": [
          "status=partial_failure",
          "haltedOnFailure=true",
          "truncated=true",
          "remainingNewFilings>0"
        ],
        "schemaSource": "OpenAPI 200 response and MCP tool outputSchema"
      }
    },
    {
      "id": "compare_filings",
      "value": "return source-backed structural disclosure changes",
      "deterministic": true,
      "agentValueTier": "research",
      "access": "free"
    },
    {
      "id": "data_plane_status",
      "value": "inspect durable catalog, ingest freshness, and derived-intelligence availability",
      "deterministic": true,
      "freeEvaluation": true,
      "access": "free"
    },
    {
      "id": "reconcile_financial_fact",
      "value": "Reconcile one standalone-quarter revenue, net income, or operating cash flow fact from official SEC reporting context and return the normalized value, direct/derived basis, reproducible subtraction when required, validation checks, and exact SEC evidence, or explicitly abstain.",
      "deterministic": true,
      "access": "paid",
      "priceCents": 100,
      "currency": "USD",
      "freeEvaluation": "/v1/research/financial-fact/preflight",
      "supportedMetrics": [
        "revenue",
        "net_income",
        "operating_cash_flow"
      ],
      "derivations": [
        "direct_exact_period",
        "cumulative_ytd_minus_prior_ytd",
        "annual_minus_prior_ytd"
      ],
      "abstainsOn": [
        "amendment/recast ambiguity",
        "incompatible units",
        "missing predecessor context",
        "unsupported metric/concept",
        "unsafe numeric representation"
      ]
    }
  ],
  "protocols": {
    "http": {
      "status": "active",
      "openapi": "/openapi.json"
    },
    "mcp": {
      "status": "active",
      "endpoint": "/mcp",
      "protocolVersion": "2026-07-28",
      "transport": "stateless HTTP"
    },
    "a2a": {
      "status": "planned_adapter",
      "targetVersion": "1.0.0",
      "compliant": false,
      "reason": "FiledProof will not claim A2A compliance until the required message and task lifecycle is implemented and tested."
    }
  },
  "researchSemantics": {
    "evidenceLocatorPrecision": "normalized_block",
    "lexicalSearchInterpretation": "none",
    "structuralComparisonInterpretation": "none",
    "timelineInterpretation": "none",
    "claimVerificationMethod": "deterministic-evidence-grounded-claim-assessment-v1",
    "claimVerificationBoundary": "assesses what official filings support or contradict; does not certify external real-world truth",
    "disclosureFingerprintMethod": "deterministic-bounded-topic-fingerprint-v1",
    "disclosureLineageMethod": "deterministic-same-form-disclosure-lineage-v1",
    "disclosureLineageBoundary": "persists bounded topic evidence and same-form structural transitions; does not infer materiality, motive, semantic equivalence, causation, or external truth",
    "disclosureMatrixMethod": "bounded-cross-company-lineage-projection-v1",
    "disclosureMatrixBoundary": "aligns source-backed company-specific evidence and transitions; does not rank companies or infer materiality, semantic equivalence, business impact, or external truth",
    "disclosureChangeMethod": "deterministic-prioritized-disclosure-change-v3",
    "disclosureChangeBoundary": "detects topic-relevant filing changes and applies explainable attention triage; attention is not legal, accounting, economic, or investment materiality, and before/after lexical pairing is not semantic equivalence",
    "monitoringCheckpointSafety": "backlog is processed oldest-first and a failed comparison never advances the checkpoint past the failed filing",
    "numericMismatchAloneCanContradict": false,
    "boundedHistoricalMissProvesAbsence": false,
    "unsupportedOrIncompleteEvidenceMayReturn": "insufficient_evidence",
    "paidApplicabilityPreflight": "issuer, monitored forms, checkpoint, new-filing work, and same-form comparison baseline are validated before payment challenge",
    "paymentInvocationBoundary": "A delivery retry repeats the identical authorized request with the same payment credential. Changing sinceAccession or any other payment-bound argument starts a new invocation and requires a new authorization when commerce is active.",
    "financialFactMethod": "deterministic-sec-companyfacts-quarter-reconciliation-v1",
    "financialFactBoundary": "Establishes what the issuer reported through SEC entity-wide standard US-GAAP facts; it does not claim a broader true economic value."
  },
  "limits": {
    "searchFilingsPerRequest": 6,
    "searchResultsPerRequest": 50,
    "evidencePackPerRequest": 30,
    "verificationEvidencePerRequest": 30,
    "verificationClaimCharacters": 512,
    "comparisonEvidencePerRequest": 500,
    "lineageFilingsPerInvocation": 6,
    "lineageFingerprintEvidencePerFiling": 50,
    "lineageTransitionEvidencePerComparison": 100,
    "lineageTopicCharacters": 256,
    "matrixCompaniesPerRequest": 6,
    "matrixFormsPerRequest": 4,
    "matrixFilingsPerCompany": 6,
    "matrixEvidencePerCompanyForm": 12,
    "monitoringNewFilingsPerCheck": 6,
    "monitoringCompaniesPerScan": 10,
    "monitoringTopicCharacters": 256
  },
  "discovery": {
    "openapi": "/openapi.json",
    "wellKnown": "/.well-known/filedproof.json",
    "mcp": "/mcp",
    "llms": "/llms.txt"
  },
  "commerce": {
    "enabled": true,
    "paymentsRequired": true,
    "protocol": "MPP",
    "currency": "USD",
    "paidOperation": "check_disclosure_changes",
    "paidTool": "filedproof.check_disclosure_changes",
    "paidHttp": "/v1/research/changes/{identifier}",
    "tracePriceCents": 1500,
    "priceCents": 1500,
    "methods": [
      "stripe",
      "tempo"
    ],
    "paymentMethods": [
      {
        "id": "stripe",
        "protocol": "MPP",
        "method": "stripe",
        "provider": "stripe",
        "intents": [
          "charge"
        ],
        "paymentMethodTypes": [
          "card",
          "link"
        ]
      },
      {
        "id": "stripe-mpp-tempo",
        "protocol": "MPP",
        "method": "tempo",
        "provider": "stripe",
        "asset": "USDC.e",
        "network": "tempo",
        "intents": [
          "charge"
        ],
        "merchantSettlement": "stripe-balance-fiat"
      }
    ],
    "paymentMethodTypes": [
      "card",
      "link"
    ],
    "stablecoin": {
      "method": "tempo",
      "provider": "stripe",
      "network": "tempo",
      "asset": "USDC.e",
      "merchantSettlement": "stripe-balance-fiat"
    },
    "handoff": {
      "mcp": {
        "challengeLocation": "JSON-RPC error.data.challenges",
        "credentialLocation": "params._meta['org.paymentauth/credential']",
        "receiptLocation": "result._meta['org.paymentauth/receipt']"
      },
      "http": {
        "challengeHeader": "WWW-Authenticate",
        "credentialHeader": "Payment-Authorization",
        "credentialHeaderFallback": "Authorization",
        "receiptHeader": "Payment-Receipt"
      },
      "identicalRequestRetry": "A delivery retry repeats the identical authorized request with the same payment credential. Changing sinceAccession or any other payment-bound argument starts a new invocation and requires a new authorization when commerce is active.",
      "settledRecoveryTtlSeconds": 86400,
      "humanCheckoutRequired": false
    },
    "resultContract": {
      "schemaVersion": "monitor-check.v1",
      "topLevelStatus": [
        "no_new_filing",
        "checked",
        "change_detected",
        "partial_failure"
      ],
      "changePath": "events[].change.changes[]",
      "evidencePaths": [
        "events[].change.changes[].before",
        "events[].change.changes[].after"
      ],
      "checkpointPath": "checkpoint.accession",
      "incompleteSignals": [
        "status=partial_failure",
        "haltedOnFailure=true",
        "truncated=true",
        "remainingNewFilings>0"
      ],
      "schemaSource": "OpenAPI 200 response and MCP tool outputSchema"
    },
    "freeDiscovery": true,
    "freeApplicabilityEvaluation": [
      "filedproof.resolve_issuer",
      "filedproof.list_filings",
      "automatic paid-operation preflight"
    ],
    "note": "FiledProof has two separate paid specialist jobs: $1 establishes one supported quarterly financial number correctly; $15 prioritizes substantive disclosure changes. Free financial-fact preflight prevents payment for unresolved requests.",
    "paidOperations": [
      {
        "operation": "check_disclosure_changes",
        "priceCents": 1500
      },
      {
        "operation": "reconcile_financial_fact",
        "tool": "filedproof.reconcile_financial_fact",
        "http": "/v1/research/financial-fact",
        "preflight": "/v1/research/financial-fact/preflight",
        "priceCents": 100,
        "currency": "USD",
        "methods": [
          "tempo",
          "stripe"
        ],
        "protocol": "MPP",
        "paymentRule": "Only an eligible, deterministically resolvable request reaches the payment challenge."
      }
    ]
  },
  "mcp": {
    "enabled": true,
    "endpoint": "/mcp",
    "protocolVersion": "2026-07-28"
  },
  "successMetrics": [
    "agent_discoveries",
    "tool_invocations",
    "successful_research_tasks",
    "repeat_agent_callers",
    "disclosure_lineage_reuse",
    "disclosure_matrix_reuse",
    "recurring_monitor_checks",
    "paid_machine_transactions",
    "revenue_per_agent_customer"
  ],
  "interfaces": {
    "financialFact": "/v1/research/financial-fact",
    "financialFactPreflight": "/v1/research/financial-fact/preflight"
  }
}