Raw schema
{
"type": "object",
"properties": {
"provider": {
"type": "string",
"enum": [
"chatgpt",
"claude",
"gemini",
"other"
]
},
"request_id": {
"type": "string",
"minLength": 1,
"maxLength": 160,
"pattern": "^[A-Za-z0-9._:-]+$"
},
"provenance": {
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "current_conversation"
},
"conversation_ref": {
"type": "string",
"minLength": 1,
"maxLength": 240,
"pattern": "^[A-Za-z0-9._:-]+$"
},
"source_url": {
"type": "string",
"maxLength": 2048,
"format": "uri"
},
"discussed_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"reported_model": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"reported_agent": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"client_version": {
"type": "string",
"minLength": 1,
"maxLength": 160
}
},
"required": [
"type",
"conversation_ref"
],
"additionalProperties": false
},
"bundles": {
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "object",
"properties": {
"client_bundle_id": {
"type": "string",
"minLength": 1,
"maxLength": 160,
"pattern": "^[A-Za-z0-9._:-]+$"
},
"knowledge_scope": {
"type": "string",
"const": "general_knowledge",
"description": "Required assertion that this bundle teaches reusable knowledge independent of a person, company, product, preference, plan, task, or decision."
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"central_question": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"knowledge_type": {
"type": "string",
"enum": [
"concept",
"procedure",
"comparison",
"mechanism",
"structure",
"claim_evidence",
"question",
"event",
"expression"
]
},
"summary": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"structured_content": {
"oneOf": [
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "concept"
},
"definition": {
"default": "",
"type": "string",
"maxLength": 4000
},
"key_points": {
"default": [],
"maxItems": 24,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 6000
}
},
"examples": {
"default": [],
"description": "Concrete instances of this concept; explain why each fits. Prefer one concise example supported by the selected material when useful; otherwise use an empty array.",
"maxItems": 24,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"non_examples": {
"default": [],
"description": "Nearby cases that do not meet the definition; explain the distinguishing boundary. Include only when supported by the selected material and useful; otherwise use an empty array.",
"maxItems": 24,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"misconceptions": {
"default": [],
"description": "Misconceptions and corrections as {claim, correction} pairs: a mistaken interpretation and its accurate replacement with a brief reason. Include only when supported by the selected material; otherwise use an empty array. Never attribute a misconception to the user or fabricate evidence.",
"maxItems": 12,
"type": "array",
"items": {
"type": "object",
"properties": {
"claim": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"correction": {
"type": "string",
"minLength": 1,
"maxLength": 4000
}
},
"required": [
"claim",
"correction"
],
"additionalProperties": false
}
}
},
"required": [
"type"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "procedure"
},
"goal": {
"default": "",
"type": "string",
"maxLength": 4000
},
"prerequisites": {
"default": [],
"maxItems": 24,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"steps": {
"default": [],
"maxItems": 30,
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"detail": {
"default": "",
"type": "string",
"maxLength": 4000
}
},
"required": [
"title"
],
"additionalProperties": false
}
},
"branches": {
"default": [],
"maxItems": 16,
"type": "array",
"items": {
"type": "object",
"properties": {
"condition": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"action": {
"type": "string",
"minLength": 1,
"maxLength": 4000
}
},
"required": [
"condition",
"action"
],
"additionalProperties": false
}
},
"failure_modes": {
"default": [],
"maxItems": 16,
"type": "array",
"items": {
"type": "object",
"properties": {
"symptom": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"response": {
"type": "string",
"minLength": 1,
"maxLength": 4000
}
},
"required": [
"symptom",
"response"
],
"additionalProperties": false
}
},
"done_when": {
"default": [],
"maxItems": 24,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
}
},
"required": [
"type"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "comparison"
},
"targets": {
"default": [],
"maxItems": 8,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"criteria": {
"default": [],
"maxItems": 20,
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"values": {
"maxItems": 8,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 4000
}
}
},
"required": [
"name",
"values"
],
"additionalProperties": false
}
},
"commonalities": {
"default": [],
"maxItems": 24,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"differences": {
"default": [],
"maxItems": 24,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"choice_guide": {
"default": [],
"maxItems": 16,
"type": "array",
"items": {
"type": "object",
"properties": {
"condition": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"recommendation": {
"type": "string",
"minLength": 1,
"maxLength": 4000
}
},
"required": [
"condition",
"recommendation"
],
"additionalProperties": false
}
}
},
"required": [
"type"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "mechanism"
},
"causes": {
"default": [],
"maxItems": 24,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"stages": {
"default": [],
"maxItems": 30,
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"detail": {
"default": "",
"type": "string",
"maxLength": 4000
}
},
"required": [
"title"
],
"additionalProperties": false
}
},
"results": {
"default": [],
"maxItems": 24,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"conditions": {
"default": [],
"maxItems": 24,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"exceptions": {
"default": [],
"maxItems": 24,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
}
},
"required": [
"type"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "structure"
},
"purpose": {
"default": "",
"type": "string",
"maxLength": 4000
},
"components": {
"default": [],
"maxItems": 40,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"pattern": "^[A-Za-z0-9._:-]+$"
},
"label": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"role": {
"default": "",
"type": "string",
"maxLength": 4000
},
"parent_id": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"pattern": "^[A-Za-z0-9._:-]+$"
}
},
"required": [
"id",
"label"
],
"additionalProperties": false
}
},
"relations": {
"default": [],
"maxItems": 60,
"type": "array",
"items": {
"type": "object",
"properties": {
"source_id": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"target_id": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"label": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"required": [
"source_id",
"target_id",
"label"
],
"additionalProperties": false
}
},
"boundaries": {
"default": [],
"maxItems": 24,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
}
},
"required": [
"type"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "claim_evidence"
},
"claim": {
"default": "",
"type": "string",
"maxLength": 4000
},
"evidence": {
"default": [],
"maxItems": 24,
"type": "array",
"items": {
"type": "object",
"properties": {
"statement": {
"type": "string",
"minLength": 1,
"maxLength": 4000
},
"source": {
"type": "string",
"minLength": 1,
"maxLength": 1000
}
},
"required": [
"statement"
],
"additionalProperties": false
}
},
"counterevidence": {
"default": [],
"maxItems": 24,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"scope": {
"default": [],
"maxItems": 24,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"limitations": {
"default": [],
"maxItems": 24,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"confidence": {
"type": "string",
"enum": [
"low",
"medium",
"high"
]
}
},
"required": [
"type"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "question"
},
"question": {
"default": "",
"type": "string",
"maxLength": 4000
},
"context": {
"default": "",
"type": "string",
"maxLength": 4000
},
"known_facts": {
"default": [],
"maxItems": 24,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 6000
}
},
"hypotheses": {
"default": [],
"maxItems": 24,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 6000
}
},
"next_steps": {
"default": [],
"maxItems": 24,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 6000
}
},
"answer_summary": {
"default": "",
"type": "string",
"maxLength": 4000
},
"status": {
"default": "open",
"type": "string",
"enum": [
"open",
"answered"
]
}
},
"required": [
"type"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "decision"
},
"decision": {
"default": "",
"type": "string",
"maxLength": 4000
},
"context": {
"default": "",
"type": "string",
"maxLength": 4000
},
"options": {
"default": [],
"maxItems": 24,
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"tradeoffs": {
"default": "",
"type": "string",
"maxLength": 4000
}
},
"required": [
"name"
],
"additionalProperties": false
}
},
"criteria": {
"default": [],
"maxItems": 24,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 6000
}
},
"rationale": {
"default": [],
"maxItems": 24,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 6000
}
},
"reconsider_when": {
"default": [],
"maxItems": 24,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 6000
}
},
"outcome": {
"default": "",
"type": "string",
"maxLength": 4000
}
},
"required": [
"type"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "event"
},
"event": {
"default": "",
"type": "string",
"maxLength": 4000
},
"occurred_at": {
"default": "",
"type": "string",
"maxLength": 500
},
"chronology": {
"type": "object",
"properties": {
"start": {
"type": "object",
"properties": {
"year": {
"type": "integer",
"minimum": 1,
"maximum": 999999
},
"era": {
"type": "string",
"enum": [
"bce",
"ce"
]
},
"month": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"day": {
"type": "integer",
"minimum": 1,
"maximum": 31
}
},
"required": [
"year",
"era"
],
"additionalProperties": false
},
"end": {
"type": "object",
"properties": {
"year": {
"type": "integer",
"minimum": 1,
"maximum": 999999
},
"era": {
"type": "string",
"enum": [
"bce",
"ce"
]
},
"month": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"day": {
"type": "integer",
"minimum": 1,
"maximum": 31
}
},
"required": [
"year",
"era"
],
"additionalProperties": false
},
"precision": {
"type": "string",
"enum": [
"exact",
"day",
"month",
"year",
"decade",
"century",
"approximate",
"range"
]
}
},
"required": [
"start",
"precision"
],
"additionalProperties": false
},
"context": {
"default": "",
"type": "string",
"maxLength": 4000
},
"changes": {
"default": [],
"maxItems": 24,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 6000
}
},
"causes": {
"default": [],
"maxItems": 24,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 6000
}
},
"consequences": {
"default": [],
"maxItems": 24,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 6000
}
}
},
"required": [
"type"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "expression"
},
"expression": {
"default": "",
"type": "string",
"maxLength": 4000
},
"language": {
"type": "string",
"minLength": 2,
"maxLength": 255
},
"pronunciation": {
"default": "",
"type": "string",
"maxLength": 500
},
"meanings": {
"default": [],
"maxItems": 24,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 6000
}
},
"translations": {
"default": [],
"maxItems": 24,
"type": "array",
"items": {
"type": "object",
"properties": {
"language": {
"type": "string",
"minLength": 2,
"maxLength": 255
},
"text": {
"type": "string",
"minLength": 1,
"maxLength": 4000
}
},
"required": [
"language",
"text"
],
"additionalProperties": false
}
},
"register": {
"default": "",
"type": "string",
"maxLength": 500
},
"nuance": {
"default": "",
"type": "string",
"maxLength": 4000
},
"usage_contexts": {
"default": [],
"maxItems": 24,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 6000
}
},
"examples": {
"default": [],
"maxItems": 24,
"type": "array",
"items": {
"type": "object",
"properties": {
"text": {
"type": "string",
"minLength": 1,
"maxLength": 4000
},
"translation": {
"type": "string",
"minLength": 1,
"maxLength": 4000
},
"note": {
"type": "string",
"minLength": 1,
"maxLength": 4000
}
},
"required": [
"text"
],
"additionalProperties": false
}
},
"contrasts": {
"default": [],
"maxItems": 24,
"type": "array",
"items": {
"type": "object",
"properties": {
"expression": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"difference": {
"type": "string",
"minLength": 1,
"maxLength": 4000
}
},
"required": [
"expression",
"difference"
],
"additionalProperties": false
}
},
"common_mistakes": {
"default": [],
"maxItems": 24,
"type": "array",
"items": {
"type": "object",
"properties": {
"incorrect": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"correction": {
"type": "string",
"minLength": 1,
"maxLength": 4000
}
},
"required": [
"incorrect",
"correction"
],
"additionalProperties": false
}
}
},
"required": [
"type",
"language"
],
"additionalProperties": false
}
]
},
"bundle_schema_version": {
"type": "number",
"const": 1
},
"topic": {
"type": "string",
"minLength": 1,
"maxLength": 48
},
"topic_id": {
"type": "string",
"minLength": 1,
"maxLength": 160,
"pattern": "^[A-Za-z0-9._:-]+$"
},
"tag_ids": {
"maxItems": 12,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 160,
"pattern": "^[A-Za-z0-9._:-]+$"
}
},
"tags": {
"maxItems": 12,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 48
}
},
"relations": {
"maxItems": 12,
"type": "array",
"items": {
"type": "object",
"properties": {
"target_kind": {
"type": "string",
"enum": [
"private",
"draft"
],
"description": "Minimal-core drafts may relate only to the owner's private knowledge or another draft; public graph targets are unavailable."
},
"target_id": {
"type": "string",
"minLength": 1,
"maxLength": 160,
"pattern": "^[A-Za-z0-9._:-]+$"
},
"type": {
"type": "string",
"enum": [
"related",
"prerequisite",
"generalizes",
"derived_from",
"equivalent_to",
"supersedes",
"answers",
"supports",
"contradicts",
"causes",
"contributes_to",
"enables",
"inhibits"
]
},
"direction": {
"type": "string",
"enum": [
"outgoing",
"incoming"
]
},
"weight": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 1
},
"evidence_selector_indexes": {
"maxItems": 24,
"type": "array",
"items": {
"type": "integer",
"minimum": 0,
"maximum": 23
}
}
},
"required": [
"target_kind",
"target_id",
"type"
],
"additionalProperties": false
}
},
"evidence_selectors": {
"maxItems": 24,
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"properties": {
"selector_type": {
"type": "string",
"const": "message"
},
"message_ref": {
"type": "string",
"minLength": 1,
"maxLength": 240,
"pattern": "^[A-Za-z0-9._:-]+$"
},
"polarity": {
"default": "supports",
"type": "string",
"enum": [
"supports",
"contradicts"
]
},
"quality": {
"default": "unknown",
"type": "string",
"enum": [
"unknown",
"low",
"medium",
"high"
]
},
"relation_origin": {
"default": "model_inferred",
"type": "string",
"enum": [
"explicit_user",
"extracted_from_source",
"model_inferred"
]
}
},
"required": [
"selector_type",
"message_ref"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"selector_type": {
"type": "string",
"const": "external_ref"
},
"source_ref": {
"type": "string",
"minLength": 1,
"maxLength": 2048
},
"polarity": {
"default": "supports",
"type": "string",
"enum": [
"supports",
"contradicts"
]
},
"quality": {
"default": "unknown",
"type": "string",
"enum": [
"unknown",
"low",
"medium",
"high"
]
},
"relation_origin": {
"default": "model_inferred",
"type": "string",
"enum": [
"explicit_user",
"extracted_from_source",
"model_inferred"
]
}
},
"required": [
"selector_type",
"source_ref"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"selector_type": {
"type": "string",
"const": "text_position"
},
"start": {
"type": "integer",
"minimum": 0,
"maximum": 9999999
},
"end": {
"type": "integer",
"minimum": 1,
"maximum": 10000000
},
"polarity": {
"default": "supports",
"type": "string",
"enum": [
"supports",
"contradicts"
]
},
"quality": {
"default": "unknown",
"type": "string",
"enum": [
"unknown",
"low",
"medium",
"high"
]
},
"relation_origin": {
"default": "model_inferred",
"type": "string",
"enum": [
"explicit_user",
"extracted_from_source",
"model_inferred"
]
}
},
"required": [
"selector_type",
"start",
"end"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"selector_type": {
"type": "string",
"const": "line_range"
},
"line_start": {
"type": "integer",
"minimum": 1,
"maximum": 1000000
},
"line_end": {
"type": "integer",
"minimum": 1,
"maximum": 1000000
},
"polarity": {
"default": "supports",
"type": "string",
"enum": [
"supports",
"contradicts"
]
},
"quality": {
"default": "unknown",
"type": "string",
"enum": [
"unknown",
"low",
"medium",
"high"
]
},
"relation_origin": {
"default": "model_inferred",
"type": "string",
"enum": [
"explicit_user",
"extracted_from_source",
"model_inferred"
]
}
},
"required": [
"selector_type",
"line_start",
"line_end"
],
"additionalProperties": false
}
]
}
},
"resolution_proposal": {
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"save_new",
"merge",
"update"
]
},
"target_item_id": {
"type": "string",
"minLength": 1,
"maxLength": 160,
"pattern": "^[A-Za-z0-9._:-]+$"
},
"expected_target_version": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"source_item_ids": {
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 160,
"pattern": "^[A-Za-z0-9._:-]+$"
}
},
"change_summary": {
"type": "object",
"properties": {
"preserved": {
"default": [],
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"added": {
"default": [],
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"changed": {
"default": [],
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"conflicts": {
"default": [],
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
}
},
"additionalProperties": false
},
"reason": {
"type": "string",
"minLength": 1,
"maxLength": 1000
}
},
"required": [
"action",
"source_item_ids",
"change_summary",
"reason"
],
"additionalProperties": false
}
},
"required": [
"knowledge_scope",
"title",
"central_question",
"knowledge_type",
"summary",
"structured_content",
"bundle_schema_version",
"topic",
"tags"
],
"additionalProperties": false
}
}
},
"required": [
"provider",
"request_id",
"provenance",
"bundles"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}
