Sessions
Stream a session
WSS
/
ws
/
sessions
/
{sessionId}
?token=
{token}
&message_id=
{messageId}
Messages
{
"type": "ack",
"resume_from": ""
}{
"event_id": 3,
"timestamp": 1703001234200,
"kind": "thought",
"block_id": "thought:reasoning",
"message_id": "msg_ghi789",
"payload": {
"thought": "Let me analyze the requirements...",
"finalize": false
}
}{
"event_id": 4,
"timestamp": 1703001234300,
"kind": "text",
"block_id": "text:message",
"message_id": "msg_ghi789",
"payload": {
"text": "Processing your request"
}
}{
"event_id": 10,
"timestamp": 1703001235000,
"kind": "tool.start",
"block_id": "tool:bash:run-1",
"message_id": "msg_ghi789",
"payload": {
"tool_name": "bash"
}
}{
"event_id": 15,
"timestamp": 1703001236000,
"kind": "tool.result",
"block_id": "tool:bash:run-1",
"message_id": "msg_ghi789",
"payload": {
"status": "success",
"output": {
"exit_code": 0
},
"finalize": true
}
}{
"event_id": 20,
"timestamp": 1703001240000,
"kind": "plan.update",
"block_id": "plan:root",
"message_id": "msg_ghi789",
"payload": {
"patch": {
"todos": [
{
"id": "todo_1",
"content": "Set up project structure",
"status": "completed"
},
{
"id": "todo_2",
"content": "Implement main logic",
"status": "active"
},
{
"id": "todo_3",
"content": "Add tests",
"status": "pending"
}
]
}
}
}{
"event_id": 1,
"timestamp": 1703001230000,
"kind": "message.received",
"message_id": "msg_ghi789",
"payload": {
"text": "Build a REST API with authentication",
"files": [],
"references": []
}
}{
"event_id": 35,
"timestamp": 1703001252000,
"kind": "sandbox.snapshot",
"message_id": "msg_ghi789",
"payload": {
"sandbox_id": "sbx_abc123",
"snapshot": {
"src/main.py": {
"key": "src/main.py",
"name": "main.py",
"updatedAt": 1703001252000
}
},
"deleted": []
}
}{
"event_id": 100,
"timestamp": 1703001300000,
"kind": "task.completed",
"message_id": "msg_ghi789",
"payload": {}
}{
"event_id": 55,
"timestamp": 1703001265000,
"kind": "task.aborted",
"message_id": "msg_ghi789",
"payload": {
"reason": "User requested stop"
}
}{
"event_id": 50,
"timestamp": 1703001260000,
"kind": "task.error",
"message_id": "msg_ghi789",
"payload": {
"message": "Failed to execute code",
"code": "execution_error"
}
}{
"type": "MESSAGE",
"content": "Also add error handling for network failures",
"timestamp": 1703001270000
}{
"type": "STOP"
}sessionId
type:string
required
Session ID (session_id from the /sessions/new response)
messageId
type:string
required
Message ID (agent_message_id from the /sessions/new response)
token
type:string
required
Raccoon AI API key
Other optional query params:
- last_stream_entry_id - Last received stream entry ID for reconnection (e.g., "0-0")
Connection Acknowledged
type:object
Confirms WebSocket connection established
Agent Thought
type:object
Agent reasoning/thinking content
Text Content
type:object
Plain text content
Tool Started
type:object
Tool execution started
Tool Result
type:object
Tool execution completed
Plan Updated
type:object
Todo list updated
Message Received
type:object
User message received by agent
Sandbox Snapshot
type:object
Sandbox file system state updated
Task Completed
type:object
Task finished successfully
Task Aborted
type:object
Task stopped by user or system
Task Error
type:object
Task failed with error
Send Message
type:object
Send a message to the running task
Stop Task
type:object
Stop the running task
Was this page helpful?
⌘I
Messages
{
"type": "ack",
"resume_from": ""
}{
"event_id": 3,
"timestamp": 1703001234200,
"kind": "thought",
"block_id": "thought:reasoning",
"message_id": "msg_ghi789",
"payload": {
"thought": "Let me analyze the requirements...",
"finalize": false
}
}{
"event_id": 4,
"timestamp": 1703001234300,
"kind": "text",
"block_id": "text:message",
"message_id": "msg_ghi789",
"payload": {
"text": "Processing your request"
}
}{
"event_id": 10,
"timestamp": 1703001235000,
"kind": "tool.start",
"block_id": "tool:bash:run-1",
"message_id": "msg_ghi789",
"payload": {
"tool_name": "bash"
}
}{
"event_id": 15,
"timestamp": 1703001236000,
"kind": "tool.result",
"block_id": "tool:bash:run-1",
"message_id": "msg_ghi789",
"payload": {
"status": "success",
"output": {
"exit_code": 0
},
"finalize": true
}
}{
"event_id": 20,
"timestamp": 1703001240000,
"kind": "plan.update",
"block_id": "plan:root",
"message_id": "msg_ghi789",
"payload": {
"patch": {
"todos": [
{
"id": "todo_1",
"content": "Set up project structure",
"status": "completed"
},
{
"id": "todo_2",
"content": "Implement main logic",
"status": "active"
},
{
"id": "todo_3",
"content": "Add tests",
"status": "pending"
}
]
}
}
}{
"event_id": 1,
"timestamp": 1703001230000,
"kind": "message.received",
"message_id": "msg_ghi789",
"payload": {
"text": "Build a REST API with authentication",
"files": [],
"references": []
}
}{
"event_id": 35,
"timestamp": 1703001252000,
"kind": "sandbox.snapshot",
"message_id": "msg_ghi789",
"payload": {
"sandbox_id": "sbx_abc123",
"snapshot": {
"src/main.py": {
"key": "src/main.py",
"name": "main.py",
"updatedAt": 1703001252000
}
},
"deleted": []
}
}{
"event_id": 100,
"timestamp": 1703001300000,
"kind": "task.completed",
"message_id": "msg_ghi789",
"payload": {}
}{
"event_id": 55,
"timestamp": 1703001265000,
"kind": "task.aborted",
"message_id": "msg_ghi789",
"payload": {
"reason": "User requested stop"
}
}{
"event_id": 50,
"timestamp": 1703001260000,
"kind": "task.error",
"message_id": "msg_ghi789",
"payload": {
"message": "Failed to execute code",
"code": "execution_error"
}
}{
"type": "MESSAGE",
"content": "Also add error handling for network failures",
"timestamp": 1703001270000
}{
"type": "STOP"
}