Raw schema
{
"type": "object",
"properties": {
"thread": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
"description": "Authorized thread identifier returned by start_thread, get_thread, or list_threads."
},
"messageType": {
"type": "string",
"enum": [
"message",
"action_request",
"action_confirmation",
"approval_confirmation",
"completion_confirmation",
"cancellation_request"
],
"description": "Typed event mode. Supported values are message, action_request, action_confirmation, approval_confirmation, completion_confirmation, and cancellation_request."
},
"messageContent": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 32000
},
{
"type": "object",
"properties": {
"capability": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
"description": "Exact executable capability identifier returned by Search or get_thread."
},
"arguments": {
"type": "object",
"propertyNames": {
"type": "string",
"maxLength": 200
},
"additionalProperties": {
"$ref": "#/$defs/__schema0"
},
"description": "Arguments for that capability, matching its advertised input schema. Never include credentials or payment details."
},
"account": {
"description": "Optional saved external-account reference. This is an opaque Darwin ID, never a token or secret.",
"type": "string",
"minLength": 1,
"maxLength": 200,
"pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$"
}
},
"required": [
"capability",
"arguments"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"request": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
"description": "Exact immutable request identifier returned by get_thread."
}
},
"required": [
"request"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"request": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
"description": "Exact immutable approval request identifier returned by get_thread."
},
"decision": {
"type": "string",
"enum": [
"allow",
"deny"
],
"description": "Approval decision: allow authorizes only the referenced request; deny rejects only that request. Neither value substitutes for another request type."
}
},
"required": [
"request",
"decision"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"operation": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
"description": "Exact operation identifier returned by get_thread whose cancellation should be requested."
}
},
"required": [
"operation"
],
"additionalProperties": false
}
],
"description": "Content required by messageType: message uses non-empty text; action_request uses {capability, arguments, account?}; action_confirmation and completion_confirmation use {request}; approval_confirmation uses {request, decision} with decision allow or deny; cancellation_request uses {operation}. Exact request and operation IDs must come from get_thread. Never place credentials, payment details, or approval authority in text."
},
"agent": {
"description": "Optional authorized Darwin AI. Omit to use the caller's active AI.",
"type": "string",
"minLength": 1,
"maxLength": 200,
"pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$"
},
"attachments": {
"description": "Optional Darwin asset references, allowed only with messageType message; never inline base64 or secrets.",
"maxItems": 19,
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"image",
"audio",
"video",
"file"
]
},
"asset": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$"
}
},
"required": [
"type",
"asset"
],
"additionalProperties": false
}
},
"idempotencyKey": {
"description": "Optional caller-generated retry key. Reuse it only for an unchanged retry after an unknown outcome.",
"type": "string",
"minLength": 1,
"maxLength": 200,
"pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$"
}
},
"required": [
"thread",
"messageType",
"messageContent"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"$defs": {
"__schema0": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {
"$ref": "#/$defs/__schema0"
}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/$defs/__schema0"
}
}
]
}
}
}