View input schema
{
"type": "object",
"properties": {
"graph": {
"type": "object",
"properties": {
"graph_type": {
"type": "string",
"enum": [
"concept",
"futures_wheel"
],
"default": "concept",
"description": "Choose a graph type explicitly. Futures wheels require exactly one order-0 center, parent_id/order metadata on every consequence, and causal edges forming one tree through five orders. Only radial layout is supported for wheels."
},
"title": {
"type": "string",
"minLength": 1
},
"description": {
"type": "string"
},
"layout_intent": {
"type": "string",
"enum": [
"smart",
"left-to-right",
"top-to-bottom",
"radial",
"clustered",
"grid",
"hierarchical",
"declutter",
"manual"
],
"default": "smart",
"description": "Requested semantic layout. Use this exact top-level field. If omitted, KnowMapped automatically applies Smart layout unless every node supplies explicit x/y coordinates; complete explicit coordinates are preserved as manual positioning. For futures_wheel the default is radial, positions are always derived, and non-radial intent is rejected."
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"nodes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"label": {
"type": "string"
},
"description": {
"type": "string"
},
"position": {
"type": "object"
},
"importance": {
"type": "string"
},
"is_core": {
"type": "boolean"
},
"resources": {
"type": "array"
},
"icon": {
"type": "string"
},
"semantic_data": {
"type": "object",
"description": "Knowledge/concept maps do not expose Evidence and classification fields. Do not ask users for or invent semantic roles, node tags, relationship type, basis/assertion status, review status, supporting evidence, or source-reference classifications for concept maps. Use clear labels, node descriptions and resource links for context and sources. Existing semantic metadata remains supported for compatibility: preserve it when editing, without adding classification defaults. Structural metadata such as grouping and map links remains supported. Futures Wheel evidence controls and typed causal metadata are unchanged. For futures_wheel: futures_wheel.order is 0 for the unique center or 1–5 for consequences; futures_wheel.parent_id is null for the center, otherwise the source node ID. Center futures_wheel.domains contains up to 32 {id,label} entries; only order 1 may set domain_id. collapsed is a boolean beside futures_wheel. status is possible/assumption/evidence (not a fact check)."
}
},
"required": [
"id",
"label"
],
"additionalProperties": false
}
},
"edges": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"source": {
"type": "string"
},
"target": {
"type": "string"
},
"label": {
"type": "string"
},
"style": {
"type": "object"
},
"routing": {
"type": "string"
},
"strength": {
"type": "string"
},
"semantic_data": {
"type": "object",
"description": "Knowledge/concept maps do not expose Evidence and classification fields. Do not ask users for or invent semantic roles, node tags, relationship type, basis/assertion status, review status, supporting evidence, or source-reference classifications for concept maps. Use clear labels, node descriptions and resource links for context and sources. Existing semantic metadata remains supported for compatibility: preserve it when editing, without adding classification defaults. Structural metadata such as grouping and map links remains supported. Futures Wheel evidence controls and typed causal metadata are unchanged."
}
},
"required": [
"id",
"source",
"target"
],
"additionalProperties": false
}
},
"presentation": {
"type": "object",
"description": "Non-layout visual settings. Layout belongs in top-level layout_intent.",
"additionalProperties": true
}
},
"required": [
"nodes",
"edges"
],
"additionalProperties": false,
"examples": [
{
"title": "Research flow",
"layout_intent": "left-to-right",
"nodes": [
{
"id": "source",
"label": "Source"
},
{
"id": "review",
"label": "Review"
}
],
"edges": [
{
"id": "source-review",
"source": "source",
"target": "review",
"label": "informs"
}
]
},
{
"title": "Possible consequences",
"graph_type": "futures_wheel",
"layout_intent": "radial",
"nodes": [
{
"id": "change",
"label": "A central change",
"semantic_data": {
"collapsed": false,
"futures_wheel": {
"order": 0,
"parent_id": null,
"status": "assumption",
"domains": [
{
"id": "health",
"label": "Public health"
}
]
}
}
},
{
"id": "effect",
"label": "A possible consequence",
"semantic_data": {
"collapsed": false,
"futures_wheel": {
"order": 1,
"parent_id": "change",
"domain_id": "health",
"status": "possible"
}
}
}
],
"edges": [
{
"id": "cause",
"source": "change",
"target": "effect",
"label": ""
}
]
}
]
},
"idempotency_key": {
"title": "Idempotency Key",
"type": "string"
},
"validate_only": {
"default": false,
"title": "Validate Only",
"type": "boolean"
},
"confirm_credit_use": {
"default": false,
"title": "Confirm Credit Use",
"type": "boolean"
}
},
"required": [
"graph",
"idempotency_key"
],
"title": "create_knowmapped_mapArguments"
}