{
  "schemaVersion": "capabilities.v2",
  "product": "FiledProof",
  "version": "0.8.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 to check whether topic-relevant disclosure blocks changed since a prior SEC filing checkpoint",
      "an agent needs a bounded recurring disclosure scan across up to 10 public companies"
    ],
    "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"
  },
  "operations": [
    {
      "id": "resolve_issuer",
      "value": "establish issuer identity before research",
      "deterministic": true,
      "freeEvaluation": true
    },
    {
      "id": "list_filings",
      "value": "discover canonical filings and coverage",
      "deterministic": true,
      "freeEvaluation": true
    },
    {
      "id": "search_filing_evidence",
      "value": "retrieve source-backed evidence across filings",
      "deterministic": true,
      "agentValueTier": "core"
    },
    {
      "id": "build_evidence_pack",
      "value": "return compact answer-ready evidence to an upstream agent",
      "deterministic": true,
      "agentValueTier": "core"
    },
    {
      "id": "build_timeline",
      "value": "organize relevant disclosures chronologically",
      "deterministic": true,
      "agentValueTier": "research"
    },
    {
      "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"
    },
    {
      "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"
    },
    {
      "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"
    },
    {
      "id": "check_disclosure_changes",
      "value": "checkpoint recurring topic-specific filing changes for one issuer without skipping backlog filings",
      "deterministic": true,
      "agentValueTier": "premium_candidate",
      "recurrence": "save checkpoint.accession and supply it as sinceAccession on the next call"
    },
    {
      "id": "scan_disclosure_changes",
      "value": "run checkpointed disclosure monitoring across up to 10 issuers with per-company failure isolation",
      "deterministic": true,
      "agentValueTier": "premium_candidate"
    },
    {
      "id": "compare_filings",
      "value": "return source-backed structural disclosure changes",
      "deterministic": true,
      "agentValueTier": "research"
    },
    {
      "id": "data_plane_status",
      "value": "inspect durable catalog, ingest freshness, and derived-intelligence availability",
      "deterministic": true,
      "freeEvaluation": true
    }
  ],
  "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-structural-topic-change-v1",
    "disclosureChangeBoundary": "detects topic-relevant added and removed filing blocks; does not infer materiality or 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"
  },
  "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": false,
    "strategy": "Machine-native commerce will be added only after high-value agent operations show repeat usage. Disclosure lineage, cross-company disclosure matrices, recurring disclosure checks, and guarded verification are explicit premium candidates because they eliminate repeated specialist research work."
  },
  "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"
  ]
}