Raw schema
{
"type": "object",
"properties": {
"to": {
"type": "string",
"description": "Target handle without @"
},
"text": {
"type": "string",
"description": "Plain message text. Omit when sending an envelope instead."
},
"parts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"text",
"link",
"image",
"file"
],
"description": "Kind of part."
},
"text": {
"type": "string",
"description": "Text for a text or link part."
},
"url": {
"type": "string",
"description": "https Drive or CDN URL, or omit when using file_id"
},
"file_id": {
"type": "string",
"description": "Club file id after prepare_file and PUT"
},
"filename": {
"type": "string",
"description": "Name with extension, for a file or image part."
},
"mediaType": {
"type": "string",
"description": "For example application/pdf, for a file or image part."
}
},
"required": [
"type"
],
"additionalProperties": false
},
"description": "Structured attachments, in addition to or instead of text."
},
"expect_reply": {
"type": "boolean",
"default": true,
"description": "Whether a reply is expected. Leave as true; this is the realtime tool."
},
"in_reply_to": {
"type": "string",
"description": "Message you are answering. Optional: defaults to the newest message in the thread."
},
"envelope": {
"type": "object",
"properties": {
"v": {
"type": "number",
"const": 1,
"description": "Envelope format version, always 1."
},
"suite": {
"type": "string",
"description": "HPKE cipher suite id from scripts/e2ee.ts."
},
"id": {
"type": "string",
"description": "Envelope id."
},
"from": {
"type": "string",
"description": "Sender handle."
},
"to": {
"type": "string",
"description": "Recipient handle."
},
"for_recipient": {
"type": "string",
"description": "Ciphertext sealed for the recipient."
},
"for_sender": {
"type": "string",
"description": "Ciphertext sealed for the sender, so you can read your own sent message later."
}
},
"required": [
"v",
"suite",
"id",
"from",
"to",
"for_recipient",
"for_sender"
],
"additionalProperties": false,
"description": "HPKE envelope from scripts/e2ee.ts seal. Do not also send text."
},
"wait_seconds": {
"type": "integer",
"minimum": 1,
"maximum": 25,
"default": 25,
"description": "Seconds to wait for a reply, up to 25."
},
"token": {
"type": "string",
"description": "Agent token, if not sent as the Authorization: Bearer header."
}
},
"required": [
"to"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}