analysis-contract-manifest.json
OT Flash r56 · Online reference / 在线参考
{
"manifestVersion": "mcp-analysis-contract-manifest-v1",
"contracts": {
"ontologyAnalysisPlan": {
"policyVersion": "datafocus-ontology-analysis-plan-v1",
"rootFields": ["caveat", "confidence", "documentQueries", "needsDocumentEvidence", "needsStructuredData", "planTruncated", "policyVersion", "structuredQuestions"],
"maxStructuredQuestions": 3,
"maxDocumentQueries": 4
},
"effectiveQuestion": {
"policyVersion": "datafocus-effective-question-v1",
"inputFields": ["followUp", "prior.documentQueries", "prior.needsDocumentEvidence", "prior.needsStructuredData", "prior.structuredQuestions"],
"outputFields": ["effectiveQuestion", "mode"],
"allowedModes": ["refine", "replace"],
"maxQuestionLength": 4000,
"maxPriorStructuredQuestions": 3,
"maxPriorDocumentQueries": 4
},
"analysisRefine": {
"policyVersion": "datafocus-analysis-refine-v2",
"retainedPolicyVersions": ["datafocus-analysis-refine-v1"],
"requiredInputFields": ["ontologyId", "sessionId", "resultId", "expectedRevision", "idempotencyKey", "question-or-change"],
"idempotencyKeyPattern": "[A-Za-z0-9._:-]{8,128}",
"baseRequirement": "latest-complete-result",
"executionAuthority": "search-with-current-row-policy-or-acl-checked-canonical-document-evidence",
"replayGuarantee": "same-logical-result-after-session-commit",
"changeTypes": ["natural_language", "filter_patch"],
"filterPatchFields": ["fieldRef", "operator", "valueRef"],
"filterPatchOperators": ["EQ"]
},
"analysisInteractions": {
"policyVersion": "datafocus-analysis-interactions-v1",
"rootFields": ["fields", "policyVersion"],
"fieldFields": ["fieldRef", "label", "operators", "values"],
"valueFields": ["label", "valueRef"],
"maxFields": 12,
"maxValuesPerField": 20
},
"analysisInsights": {
"policyVersion": "datafocus-analysis-insights-v1",
"rootFields": ["citationEligible", "count", "generated", "items", "policyVersion"],
"itemFields": ["citationEligible", "generated", "insightId", "text", "title"],
"maxInsights": 12,
"maxTextLength": 1000
},
"analysisPage": {
"policyVersion": "datafocus-analysis-page-v1",
"requiredInputFields": ["ontologyId", "sessionId", "resultId", "branchId", "expectedRevision", "pageNo", "pageSize"],
"rootFields": ["branchId", "citationEligible", "data", "pageNo", "pageSize", "policyVersion", "provenance", "resultId", "resultRevision", "sessionId", "status"],
"maxPageNo": 10000,
"maxPageSize": 100,
"executionAuthority": "server-retained-search-recipe-with-current-row-policy"
},
"canonicalDocumentEvidence": {
"policyVersion": "canonical-document-evidence-v1",
"rootFields": ["citationEligible", "complete", "items", "policyVersion", "queryCount", "truncated"],
"itemFields": ["assetId", "chunkUuid", "citationEligible", "content", "contentSha256", "contentTruncated", "documentId", "documentName", "evidenceId", "knowledgeId", "pageEnd", "pageStart", "query", "spanEnd", "spanStart", "title"]
},
"documentFactLedger": {
"policyVersion": "datafocus-document-fact-ledger-v1",
"rootFields": ["citationEligible", "complete", "coverageMode", "evidence", "evidenceCount", "factCount", "facts", "generationStatus", "policyVersion", "rejectedCandidateCount", "truncated"],
"factFields": ["citationEligible", "claim", "entity", "evidenceRefs", "factId", "kind", "period", "predicate", "qualifiers", "unit", "value", "verified"],
"evidenceFields": ["chunkUuid", "citationEligible", "contentSha256", "evidenceId", "evidencePointer", "quoteSha256", "spanEnd", "spanStart", "type"],
"maxFacts": 24
},
"mixedAnalysisReport": {
"policyVersion": "datafocus-mixed-analysis-report-v1",
"rootFields": ["caveat", "citationEligible", "complete", "policyVersion", "routePolicyVersion", "sections", "status"],
"sectionFields": ["citationEligible", "contentPointers", "id", "title", "type", "visualIds"]
},
"analysisNarrative": {
"policyVersion": "datafocus-analysis-narrative-v4",
"retainedPolicyVersions": ["datafocus-analysis-narrative-v1", "datafocus-analysis-narrative-v2", "datafocus-analysis-narrative-v3"],
"rootFields": ["citationEligible", "executiveSummary", "findings", "generationStatus", "headline", "limitations", "policyVersion"],
"findingFields": ["body", "citationEligible", "documentFactRefs", "evidencePointers", "factRefs", "id", "kind", "structuredBranchIds", "title", "verified", "visualIds"]
},
"structuredBranches": {
"policyVersion": "datafocus-structured-branches-v2",
"retainedPolicyVersions": ["datafocus-structured-branches-v1"],
"rootFields": ["branchCount", "branches", "cancelledCount", "citationEligible", "complete", "completedCount", "failedCount", "insightsPending", "partial", "policyVersion", "truncated", "workingCount"],
"branchFields": ["branchId", "citationEligible", "data", "failureReason", "insightStatus", "insights", "interactionOptions", "materializedAt", "provenance", "question", "revision", "status"],
"maxBranches": 3
},
"structuredFactLedger": {
"policyVersion": "datafocus-structured-fact-ledger-v1",
"rootFields": ["citationEligible", "complete", "evidence", "evidenceCount", "factCount", "facts", "policyVersion", "presentationPolicyVersion", "sourcePolicyVersion", "truncated"],
"factFields": ["branchId", "citationEligible", "evidenceRefs", "factId", "metricKey", "qualifiers", "value", "valueType", "verified", "visualRefs"],
"evidenceFields": ["branchId", "citationEligible", "evidenceId", "fieldKey", "materializedAt", "outputSha256", "resultPointer", "rowIndex", "transform", "type"],
"maxFacts": 120
},
"durableStructuredFactLedger": {
"policyVersion": "datafocus-structured-fact-ledger-v2",
"retainedPolicyVersions": ["datafocus-structured-fact-ledger-v1"],
"coveragePolicy": "balanced-published-branch-budget-v1",
"rootFields": ["branchCoverageComplete", "citationEligible", "complete", "coveragePolicy", "coveredBranchCount", "evidence", "evidenceCount", "factCount", "facts", "maxFacts", "policyVersion", "presentationPolicyVersion", "requiredBranchCount", "sourcePolicyVersion", "truncated"],
"factFields": ["branchId", "citationEligible", "evidenceRefs", "factId", "metricKey", "qualifiers", "value", "valueType", "verified", "visualRefs"],
"evidenceFields": ["branchId", "citationEligible", "evidenceId", "fieldKey", "materializedAt", "outputSha256", "resultPointer", "rowIndex", "transform", "type"],
"maxFacts": 120,
"maxPublishedBranches": 8
},
"authorizedStructuredSchema": {
"policyVersion": "authorized-structured-schema-v1",
"rootFields": ["formulas", "ontologyId", "policyVersion", "relations", "tables"],
"tableFields": ["columns", "description", "displayName", "id"],
"columnFields": ["aggregation", "dataType", "description", "displayName", "id", "masked", "synonyms"],
"relationFields": ["conditions", "dimensionTableId", "factTableId", "id", "joinType"],
"conditionFields": ["sourceColumnId", "targetColumnId"],
"formulaFields": ["id", "name", "resultType"]
},
"authorizationFingerprint": {
"policyVersion": "analysis-authorization-fingerprint-v1",
"algorithm": "HmacSHA256",
"digestEncoding": "lowercase-hex",
"securityPolicyEpochRequired": true
},
"structuredProjection": {
"policyVersion": "canonical-structured-result-v2",
"projectionFields": ["bounded", "maxArrayItems", "policyVersion", "truncated"]
},
"presentation": {
"policyVersion": "datafocus-analysis-presentation-v1",
"rootFields": ["citationEligible", "datasets", "defaultVisualId", "interactions", "narrativeBlocks", "policyVersion", "source", "truncated", "visuals"],
"narrativeFields": ["kind", "sourcePointer"],
"datasetFields": ["columns", "complete", "id", "preferredDimension", "preferredMeasure", "preferredTemporal", "rowCount", "rowPointer"],
"visualFields": ["columns", "datasetId", "dimension", "id", "measure", "title", "type"]
},
"multiBranchPresentation": {
"policyVersion": "datafocus-structured-branch-presentation-v1",
"rootFields": ["citationEligible", "complete", "datasets", "defaultVisualId", "interactions", "narrativeBlocks", "policyVersion", "source", "truncated", "visuals"],
"narrativeFields": ["branchId", "kind", "sourcePointer"],
"datasetFields": ["branchId", "columns", "complete", "id", "preferredDimension", "preferredMeasure", "preferredTemporal", "question", "rowCount", "rowPointer"],
"visualFields": ["branchId", "columns", "datasetId", "dimension", "id", "measure", "title", "type"]
},
"structuredProvenance": {
"policyVersion": "structured-query-receipt-v1",
"rootFields": ["authority", "authorizationMode", "citationEligible", "columns", "complete", "evidenceKind", "executionEngine", "policyVersion", "rowPolicyApplied", "tables", "truncated"],
"tableFields": ["displayName", "id"],
"columnFields": ["dataType", "displayName", "id", "tableId"]
},
"report": {
"policyVersion": "datafocus-analysis-report-v1",
"rootFields": ["citationEligible", "complete", "pointerRoot", "policyVersion", "sections", "sourcePresentationVersion"],
"sectionFields": ["citationEligible", "contentRefs", "datasetId", "id", "provenancePointer", "title", "type", "visualId"]
},
"multiBranchMixedReport": {
"policyVersion": "datafocus-multi-branch-analysis-report-v1",
"rootFields": ["caveat", "citationEligible", "complete", "policyVersion", "routePolicyVersion", "sections", "status", "structuredPolicyVersion"],
"sectionFields": ["citationEligible", "contentPointers", "id", "title", "type", "visualIds"]
},
"durableReport": {
"policyVersion": "mcp-durable-analysis-report-v4",
"retainedPolicyVersions": ["mcp-durable-analysis-report-v3"],
"rootFields": ["analysisReport", "documentEvidence", "documentFactLedger", "factLedger", "narrative", "presentation", "projectionPolicyVersion", "routePlan", "structuredBranches"]
},
"durableReportStatus": {
"policyVersion": "mcp-analysis-report-status-v2",
"rootFields": ["answerMode", "branches", "citationEligible", "documentStatus", "ontologyId", "policyVersion", "pollAfterMs", "reportId", "revision", "status", "structuredStatus"]
},
"publicResult": {
"rootFields": ["analysisReport", "data", "documentEvidence", "documentFactLedger", "factLedger", "narrative", "nextAction", "ontologyId", "presentation", "provenance", "report", "resultId", "revision", "routePlan", "sessionId", "status", "structuredBranches"]
}
},
"apps": {
"activeUri": "ui://datafocus/analysis-report/v14/index.html",
"durableReportUri": "ui://datafocus/analysis-report/v16/index.html",
"retainedUris": [
"ui://datafocus/analysis-report/v1/index.html",
"ui://datafocus/analysis-report/v2/index.html",
"ui://datafocus/analysis-report/v3/index.html",
"ui://datafocus/analysis-report/v4/index.html",
"ui://datafocus/analysis-report/v5/index.html",
"ui://datafocus/analysis-report/v6/index.html",
"ui://datafocus/analysis-report/v7/index.html",
"ui://datafocus/analysis-report/v8/index.html",
"ui://datafocus/analysis-report/v9/index.html",
"ui://datafocus/analysis-report/v10/index.html",
"ui://datafocus/analysis-report/v11/index.html",
"ui://datafocus/analysis-report/v12/index.html",
"ui://datafocus/analysis-report/v13/index.html",
"ui://datafocus/analysis-report/v15/index.html"
]
}
}