Payload schema
messagestring
The visible chat message (markdown).
filesobject[]optional
Files attached to the message.
contentTypestring
MIME type.
filenamestring
Original filename.
pathstring
Project file-storage path.
sizeinteger
Size in bytes.
urlstring
Signed URL minted at attach time (stored, not re-minted, so history stays deterministic).
llmRequestOffsetintegeroptional
Present when the message was extracted from the identified LLM response rather than sent by a script. Suppresses the assistant-history mirror.
Raw JSON schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"message": {
"type": "string",
"description": "The visible chat message (markdown)."
},
"files": {
"description": "Files attached to the message.",
"type": "array",
"items": {
"type": "object",
"properties": {
"contentType": {
"type": "string",
"description": "MIME type."
},
"filename": {
"type": "string",
"description": "Original filename."
},
"path": {
"type": "string",
"description": "Project file-storage path."
},
"size": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Size in bytes."
},
"url": {
"type": "string",
"description": "Signed URL minted at attach time (stored, not re-minted, so history stays deterministic)."
}
},
"required": [
"contentType",
"filename",
"path",
"size",
"url"
]
}
},
"llmRequestOffset": {
"description": "Present when the message was extracted from the identified LLM response rather than sent by a script. Suppresses the assistant-history mirror.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"message"
]
}