Messages

Individual messages.

2 actions. Each is callable by the agent as a tool, over HTTP via /api/invoke, and (usually) from a UI page.

`messages.send`

POST · mutating

Send a message into a conversation. If the conversation is an external mirror (Slack/Discord), this also posts there via Composio.

AI tool: messages_send
API: POST /api/invoke/messages.send

Input

Field	Type	Required
`conversationId`	string	yes
`body`	string	yes
`actorId`	string	—
`parentId`	string	—
`mentions`	string[]	—
`attachments`	object[]	—

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "conversationId": {
      "type": "string",
      "minLength": 1
    },
    "body": {
      "type": "string"
    },
    "actorId": {
      "type": "string",
      "minLength": 1
    },
    "parentId": {
      "type": "string",
      "minLength": 1
    },
    "mentions": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      }
    },
    "attachments": {
      "type": "array",
      "items": {
        "type": "object",
        "propertyNames": {
          "type": "string"
        },
        "additionalProperties": {}
      }
    }
  },
  "required": [
    "conversationId",
    "body"
  ]
}

`messages.generate_agent_reply`

POST · mutating

Generate and post an AI reply from an agent actor into a conversation. Reads recent history as context.

AI tool: messages_generate_agent_reply
API: POST /api/invoke/messages.generate_agent_reply

Input

Field	Type	Required
`conversationId`	string	yes
`agentActorId`	string	yes
`triggerMessageId`	string	—
`instruction`	string	—
`forceTool`	string	—

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "conversationId": {
      "type": "string",
      "minLength": 1
    },
    "agentActorId": {
      "type": "string",
      "minLength": 1
    },
    "triggerMessageId": {
      "type": "string",
      "minLength": 1
    },
    "instruction": {
      "type": "string"
    },
    "forceTool": {
      "type": "string"
    }
  },
  "required": [
    "conversationId",
    "agentActorId"
  ]
}