Create pending, user-owned general-knowledge card drafts only after clear affirmative consent to specifically named, independently teachable knowledge in the current conversation. Every card must declare knowledge_scope as general_knowledge. Personal or company decisions, product principles or policies, pricing rationale, preferences, plans, tasks, reminders, meeting outcomes, project status, and autobiographical facts are ineligible. An assistant suggestion alone is not consent. This tool never accepts raw transcripts or historical-conversation data, and it cannot approve, publish, or modify public knowledge cards.
View input 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)))$"
}
},
"required": [
"type",
"conversation_ref"
],
"additionalProperties": false
},
"cards": {
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "object",
"properties": {
"client_card_id": {
"type": "string",
"minLength": 1,
"maxLength": 160,
"pattern": "^[A-Za-z0-9._:-]+$"
},
"knowledge_scope": {
"type": "string",
"const": "general_knowledge",
"description": "Required assertion that this card teaches reusable knowledge independent of a person, company, product, preference, plan, task, or decision."
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"summary": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"explanation": {
"type": "string",
"minLength": 1,
"maxLength": 6000
},
"topic": {
"type": "string",
"minLength": 1,
"maxLength": 48
},
"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"
],
"description": "Relationship type. supersedes is rejected: propose a replacement with resolution_proposal (merge or update) instead."
},
"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
}
]
}
}
},
"required": [
"knowledge_scope",
"title"
],
"additionalProperties": false
}
}
},
"required": [
"provider",
"request_id",
"provenance",
"cards"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}