View input schema
{
"type": "object",
"properties": {
"engagement": {
"type": "object",
"description": "The complete engagement.json from the last outcome tool result, unchanged."
},
"engagement_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "engagement_sha256 from the last outcome tool result. A different value means the engagement changed."
},
"event": {
"description": "One event. type picks the fields: brief, plan (research + plan), approve_plan, data, start, complete, approve, skip, block, reopen, autonomy, next_round.",
"oneOf": [
{
"type": "object",
"properties": {
"type": {
"const": "brief"
},
"at": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"brief": {
"type": "object",
"properties": {
"outcome": {
"type": "string",
"maxLength": 1000
},
"ambition": {
"type": [
"object",
"null"
],
"properties": {
"goal_beyond": {
"type": "string",
"maxLength": 500
},
"rungs": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 3,
"minItems": 3
},
"chosen": {
"type": "integer",
"minimum": 1,
"maximum": 3
},
"judge": {
"type": "string",
"maxLength": 500
}
},
"required": [
"goal_beyond",
"rungs",
"chosen",
"judge"
],
"additionalProperties": false
},
"deliverable": {
"type": "string",
"maxLength": 600
},
"done": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 20,
"minItems": 1
},
"metric": {
"type": [
"object",
"null"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200
},
"direction": {
"type": "string",
"enum": [
"decrease",
"increase",
"reach"
]
},
"unit": {
"type": "string",
"maxLength": 60
},
"baseline": {
"type": [
"number",
"null"
]
},
"baseline_source": {
"type": "string",
"enum": [
"reported",
"verified",
"unknown"
]
},
"target": {
"type": [
"number",
"null"
]
}
},
"required": [
"name",
"direction",
"unit",
"baseline_source"
],
"additionalProperties": false
},
"deadline": {
"type": [
"string",
"null"
],
"maxLength": 200
},
"guardrails": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 15
},
"limits": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 20
},
"assets": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 30
},
"connections": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"maxLength": 200
},
"access": {
"type": "string",
"enum": [
"read",
"draft",
"live"
]
},
"status": {
"type": "string",
"enum": [
"connected",
"available",
"missing"
]
}
},
"required": [
"name",
"access",
"status"
],
"additionalProperties": false
},
"maxItems": 30
},
"data_home": {
"type": "string",
"maxLength": 300
},
"technical_level": {
"type": [
"string",
"null"
],
"maxLength": 300
},
"decides": {
"type": "string",
"maxLength": 300
},
"unknowns": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 20
},
"answers": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"question": {
"type": "string",
"maxLength": 500
},
"answer": {
"type": "string",
"maxLength": 2000
}
},
"required": [
"question",
"answer"
],
"additionalProperties": false
},
"maxItems": 40
}
},
"required": [
"outcome",
"deliverable",
"done",
"data_home",
"decides"
],
"additionalProperties": false
}
},
"required": [
"type",
"brief"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"const": "plan"
},
"at": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"research": {
"type": "object",
"properties": {
"approach": {
"type": "string",
"maxLength": 3000
},
"sources": {
"type": "array",
"items": {
"type": "object",
"description": "web: full https link and date; catalogue: an item id; memory or owner: where it came from.",
"properties": {
"id": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$"
},
"kind": {
"type": "string",
"enum": [
"web",
"catalogue",
"memory",
"owner"
]
},
"title": {
"type": "string",
"maxLength": 300
},
"ref": {
"type": "string",
"maxLength": 600
},
"date": {
"type": [
"string",
"null"
],
"pattern": "^\\d{4}-\\d{2}(-\\d{2})?$"
},
"note": {
"type": [
"string",
"null"
],
"maxLength": 500
}
},
"required": [
"id",
"kind",
"title",
"ref"
],
"additionalProperties": false
},
"maxItems": 40,
"minItems": 2
},
"steps": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$"
},
"name": {
"type": "string",
"maxLength": 200
},
"why": {
"type": "string",
"maxLength": 800
},
"sources": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$"
},
"maxItems": 10,
"minItems": 1
}
},
"required": [
"id",
"name",
"why",
"sources"
],
"additionalProperties": false
},
"maxItems": 30,
"minItems": 1
},
"pitfalls": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"text": {
"type": "string",
"maxLength": 500
},
"sources": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$"
},
"maxItems": 10,
"minItems": 1
}
},
"required": [
"text",
"sources"
],
"additionalProperties": false
},
"maxItems": 20
}
},
"required": [
"approach",
"sources",
"steps"
],
"additionalProperties": false
},
"plan": {
"type": "object",
"properties": {
"name": {
"type": "string",
"maxLength": 160
},
"capabilities": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$"
},
"access": {
"type": "string",
"enum": [
"read",
"draft",
"live"
]
},
"via": {
"type": "string",
"enum": [
"mcp",
"api_key",
"file",
"browser",
"owner"
]
},
"name": {
"type": "string",
"maxLength": 200
},
"why": {
"type": "string",
"maxLength": 500
}
},
"required": [
"id",
"access",
"via",
"name",
"why"
],
"additionalProperties": false
},
"maxItems": 25
},
"data": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$"
},
"name": {
"type": "string",
"maxLength": 200
},
"why": {
"type": "string",
"maxLength": 600
},
"fields": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 30
},
"routes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"MCP",
"CSV",
"FILE",
"URL",
"ASK"
]
},
"how": {
"type": "string",
"maxLength": 600
}
},
"required": [
"kind",
"how"
],
"additionalProperties": false
},
"maxItems": 6,
"minItems": 1
},
"required_for": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$"
},
"maxItems": 40
},
"alternative": {
"type": [
"string",
"null"
],
"maxLength": 600
}
},
"required": [
"id",
"name",
"why",
"routes"
],
"additionalProperties": false
},
"maxItems": 20
},
"stages": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$"
},
"kind": {
"type": "string",
"enum": [
"intake",
"context",
"evidence",
"integrity",
"diagnosis",
"options",
"decision",
"production",
"execution",
"measurement",
"learning"
]
},
"name": {
"type": "string",
"maxLength": 120
},
"goal": {
"type": "string",
"maxLength": 1500
},
"from_steps": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$"
},
"maxItems": 10
},
"owner": {
"type": "object",
"properties": {
"role": {
"type": [
"string",
"null"
],
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$"
},
"gap": {
"type": [
"string",
"null"
],
"maxLength": 500
}
},
"required": [],
"additionalProperties": false,
"description": "One of: role (a find_specialist id) or gap (the expert you needed when none fits)."
},
"support": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$"
},
"maxItems": 8
},
"reviewers": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$"
},
"maxItems": 6
},
"uses": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,119}$"
},
"maxItems": 20
},
"data": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$"
},
"maxItems": 40
},
"needs": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$"
},
"maxItems": 40
},
"depends_on": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$"
},
"maxItems": 40
},
"outputs": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$"
},
"name": {
"type": "string",
"maxLength": 250
},
"format": {
"type": "string",
"maxLength": 40
},
"path": {
"type": "string",
"maxLength": 200
},
"count": {
"type": [
"integer",
"null"
],
"minimum": 1,
"maximum": 1000
}
},
"required": [
"id",
"name",
"format",
"path"
],
"additionalProperties": false
},
"maxItems": 12
},
"checks": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$"
},
"name": {
"type": "string",
"maxLength": 500
},
"required": {
"type": [
"boolean",
"null"
]
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"maxItems": 12
},
"gate": {
"type": "string",
"enum": [
"none",
"review",
"approve",
"approve_each_action"
]
},
"optional_when": {
"type": [
"string",
"null"
],
"maxLength": 500
}
},
"required": [
"id",
"kind",
"name",
"goal",
"owner",
"gate"
],
"additionalProperties": false
},
"maxItems": 30,
"minItems": 1
},
"hypotheses": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$"
},
"statement": {
"type": "string",
"maxLength": 400
},
"test": {
"type": "string",
"maxLength": 800
},
"confirm_if": {
"type": "string",
"maxLength": 500
},
"refute_if": {
"type": "string",
"maxLength": 500
},
"fix_stage": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$"
}
},
"required": [
"id",
"statement",
"test",
"confirm_if",
"refute_if",
"fix_stage"
],
"additionalProperties": false
},
"maxItems": 30
},
"dropped": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"step": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$"
},
"reason": {
"type": "string",
"maxLength": 500
}
},
"required": [
"step",
"reason"
],
"additionalProperties": false
},
"maxItems": 30
},
"measurement": {
"type": [
"object",
"null"
],
"properties": {
"window": {
"type": "string",
"maxLength": 300
},
"min_volume": {
"type": "string",
"maxLength": 300
},
"stop_rule": {
"type": "string",
"maxLength": 500
}
},
"required": [
"window",
"min_volume",
"stop_rule"
],
"additionalProperties": false
}
},
"required": [
"name",
"stages"
],
"additionalProperties": false
}
},
"required": [
"type",
"research",
"plan"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"const": "approve_plan"
},
"at": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"decision": {
"type": "string",
"enum": [
"APPROVED",
"CHANGES_REQUESTED"
]
},
"by": {
"type": "string",
"description": "\"owner\", only after the owner actually said so."
},
"note": {
"type": "string",
"maxLength": 2000
}
},
"required": [
"type",
"decision",
"by"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"const": "data"
},
"at": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"data_id": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$"
},
"status": {
"type": "string",
"enum": [
"AVAILABLE",
"MISSING"
]
},
"note": {
"type": "string",
"maxLength": 1000
}
},
"required": [
"type",
"data_id",
"status"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"const": "start"
},
"at": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"stage_id": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$"
}
},
"required": [
"type",
"stage_id"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"const": "complete"
},
"at": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"stage_id": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$"
},
"outputs": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$"
},
"path": {
"type": "string",
"maxLength": 240
},
"sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
},
"required": [
"id"
],
"additionalProperties": false
}
},
"checks": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$"
},
"result": {
"type": "string",
"enum": [
"PASS",
"FAIL",
"NOT_RUN"
]
},
"note": {
"type": "string",
"maxLength": 1000
}
},
"required": [
"id",
"result"
],
"additionalProperties": false
}
},
"summary": {
"type": "string",
"maxLength": 2000
},
"production_artifacts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slot_id": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$"
},
"path": {
"type": "string",
"maxLength": 240
},
"sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"modality": {
"type": "string",
"enum": [
"interactive",
"image",
"text",
"doc",
"data"
]
},
"kind": {
"type": "string",
"maxLength": 120
},
"output_id": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$"
},
"container_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
},
"required": [
"slot_id",
"path",
"sha256",
"modality"
],
"additionalProperties": false
},
"maxItems": 1000
},
"landing_page_delivery": {
"type": "object",
"description": "Current-source page report. Full schema: GET /api/v1/schemas/ai-blocks-landing-page-delivery/1.json. Read it before completion.",
"properties": {
"schema": {
"const": "ai-blocks-landing-page-delivery/1"
},
"mode": {
"type": "string",
"enum": [
"LAUNCHABLE_SITE",
"DESIGN_REFERENCE"
]
},
"artifacts": {
"type": "array",
"items": {
"type": "object"
},
"maxItems": 1000
}
},
"required": [
"schema",
"mode",
"artifacts"
],
"additionalProperties": false
},
"visual_delivery": {
"type": "object",
"description": "Static-ad report. Full schema: GET /api/v1/schemas/ai-blocks-visual-delivery/1.json. Read it before completion. Current image hashes, renderer receipt, independent reviewer and brand/product/claim/format inspection are required.",
"properties": {
"schema": {
"const": "ai-blocks-visual-delivery/1"
},
"renderer": {
"type": "string",
"minLength": 1,
"maxLength": 2000
},
"receipt": {
"type": "string",
"minLength": 1,
"maxLength": 2000
},
"reviewer_id": {
"type": "string",
"minLength": 1,
"maxLength": 2000
},
"references": {
"type": "array",
"minItems": 1,
"maxItems": 30,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 2000
}
},
"items": {
"type": "array",
"minItems": 1,
"maxItems": 1000,
"items": {
"type": "object"
}
}
},
"required": [
"schema",
"renderer",
"receipt",
"reviewer_id",
"references",
"items"
],
"additionalProperties": false
},
"work_context": {
"type": "object",
"description": "Existing-work context and observed comparison. Full schema: GET /api/v1/schemas/ai-blocks-work-context/1.json. Required for substantive IMPROVE or ASSESS production, with CURRENT baseline, preservation, source-backed changes and current-hash comparison.results.",
"properties": {
"schema": {
"const": "ai-blocks-work-context/1"
},
"mode": {
"enum": [
"CREATE",
"IMPROVE",
"ASSESS"
]
},
"scope_reason": {
"type": "string",
"minLength": 1,
"maxLength": 2000
},
"sources": {
"type": "array",
"maxItems": 30,
"items": {
"type": "object"
}
},
"preserve": {
"type": "array",
"maxItems": 50,
"items": {
"type": "object"
}
},
"changes": {
"type": "array",
"maxItems": 30,
"items": {
"type": "object"
}
},
"comparison": {
"type": "object"
}
},
"required": [
"schema",
"mode",
"sources",
"preserve",
"changes",
"comparison"
],
"additionalProperties": false
}
},
"required": [
"type",
"stage_id",
"outputs",
"checks"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"const": "approve"
},
"at": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"stage_id": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$"
},
"decision": {
"type": "string",
"enum": [
"APPROVED",
"CHANGES_REQUESTED"
]
},
"by": {
"type": "string",
"description": "\"owner\", only after the owner actually said so."
},
"note": {
"type": "string",
"maxLength": 2000
}
},
"required": [
"type",
"stage_id",
"decision",
"by"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"const": "skip"
},
"at": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"stage_id": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$"
},
"reason": {
"type": "string",
"maxLength": 1000
}
},
"required": [
"type",
"stage_id",
"reason"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"const": "block"
},
"at": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"stage_id": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$"
},
"reason": {
"type": "string",
"maxLength": 1000
}
},
"required": [
"type",
"stage_id",
"reason"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"const": "reopen"
},
"at": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"stage_id": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,79}$"
}
},
"required": [
"type",
"stage_id"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"const": "autonomy"
},
"at": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"level": {
"type": "integer",
"minimum": 0,
"maximum": 3
},
"by": {
"type": "string",
"description": "\"owner\", only after the owner actually said so."
},
"note": {
"type": "string",
"maxLength": 1000
}
},
"required": [
"type",
"level",
"by"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"const": "next_round"
},
"at": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"note": {
"type": "string",
"maxLength": 1000
}
},
"required": [
"type"
],
"additionalProperties": false
}
]
}
},
"required": [
"engagement",
"engagement_sha256",
"event"
],
"additionalProperties": false
}