Skip to main content

​
Create Message

Create a message for a task. 
from terminaluse import TextContent

message = client.messages.create(
    task_id="task-uuid",
    content=TextContent(
        author="agent",
        content="Hello!",
        format="plain",
    ),
    streaming_status="DONE",
)
Parameters:
  • task_id (str): Task UUID
  • content (TaskMessageContent): Message content
  • streaming_status (str): “IN_PROGRESS” or “DONE”
Returns: TaskMessage

​
Retrieve Message

Get a message by ID. 
message = client.messages.retrieve("message-uuid")
Parameters:
  • message_id (str): Message UUID
Returns: TaskMessage

​
List Messages

List messages for a task. 
messages = client.messages.list(
    task_id="task-uuid",
    limit=50,
    order_by="created_at",
    order_direction="desc",
)
Parameters:
  • task_id (str, optional): Filter by task
  • limit (int, optional): Max results
  • page_number (int, optional): Page number
  • order_by (str, optional): Sort field
  • order_direction (str, optional): “asc” or “desc”
Returns: MessageListResponse

​
Update Message

Update a message. 
message = client.messages.update(
    message_id="message-uuid",
    task_id="task-uuid",
    content=TextContent(
        author="agent",
        content="Updated content",
        format="plain",
    ),
    streaming_status="DONE",
)
Parameters:
  • message_id (str): Message UUID
  • task_id (str): Task UUID
  • content (TaskMessageContent): New content
  • streaming_status (str): “IN_PROGRESS” or “DONE”
Returns: TaskMessage

​
Batch Create

Create multiple messages at once. 
messages = client.messages.batch.create(
    task_id="task-uuid",
    messages=[
        {"content": content1, "streaming_status": "DONE"},
        {"content": content2, "streaming_status": "DONE"},
    ],
)

​
Content Types

​
TextContent

from terminaluse import TextContent

content = TextContent(
    author="agent",      # "agent" or "user"
    content="Hello!",    # Text content
    format="markdown",   # "plain" or "markdown"
)

​
DataContent

from terminaluse import DataContent

content = DataContent(
    author="agent",
    data={"key": "value"},  # Any JSON-serializable data
)

​
Message Model

message.id              # Message UUID
message.task_id         # Parent task
message.content         # Message content
message.streaming_status # IN_PROGRESS or DONE
message.created_at      # Creation timestamp
message.updated_at      # Last update