Chat · Daemon API

On this page

Display chat history of a loop

GET/agents/{id}/chat

Operation getAgentChatAuthBearer token

Display entries derived from the most recent loop rows. limit default 200 (clamped 1–500).

Path parameters

Name	Type	Description
`id`required	string	Loaded agent: its id, handle or name. example: agent-1

Query parameters

Name	Type	Description
`limit`	integer	Maximum rows to return
`loop`	string	Cognition loop to address. Absent = main. Unknown loops answer 404.

Responses

Status Description Body

200 Chat history (null when none) ChatHistoryResponse

agentIdrequired

string

Agent id

looprequired string

chatHistoryrequired object | null

5 fields of chatHistory

versionrequired integer

uiLogrequired array<DisplayEntry>

5 fields of uiLog

`id`required	string
`type`required	string	One of `user`, `text`, `tool_call`, `tool_result`, `thinking`, `error`, `trigger`, `compaction`, `context`
`content`required	string
`timestamp`required	integer
`metadata`	object

llmMessagesrequired array<any>

totalrequired integer

earlierCountrequired integer

Errors 400 · 401 · 403 · 404 · 500

400	Invalid request: missing or malformed field, query parameter or body. A body Fastify cannot parse gets Fastify's own shape (`statusCode`, `code`, `error`, `message`).`bad_requestFST_ERR_CTP_EMPTY_JSON_BODY`
401	Missing or wrong bearer token (`unauthorized`)
403	The request guard refused it: Host header not allowed (`host_not_allowed`, DNS-rebinding protection) or a browser cross-site request (`cross_origin`)`host_not_allowedcross_origin`
404	Unknown agent (or the named resource: loop, task, file, …)
500	Unexpected runtime failure

Error bodies use the error format.

Example

Request

curl "http://127.0.0.1:7385/agents/agent-1/chat" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"

Queue a user chat turn

POST/agents/{id}/chat

Operation chatAgentAuthBearer token

The owner's voice into main or any inner loop. Answers 202 at once (scheduling, not completion); follow the turn on GET /events, …/status or …/loop. An unknown loop answers 404 and a disabled one 409, before anything is queued. Match the returned turnId against event.turn_id on GET /events to follow this request's turn. Chats sent while the loop is busy queue in arrival order and none is ever dropped: the first interrupts the running turn, then the oldest queued chat runs as the next turn (its own turnId) and the others join it as consecutive user rows before its first model call, listed right away on a chat.delivered event (payload.turn_ids). Every turnId ends on a turn.completed (as its turn_id or in absorbed_turn_ids) or an agent.error; only /abort, unload or an off transition discard queued chats, announced by chat.discarded.

Path parameters

Name	Type	Description
`id`required	string	Loaded agent: its id, handle or name. example: agent-1

Request bodyapplication/json · ChatBody · required

Field	Type	Description
`text`required	string
`loop`	string	Cognition loop to talk to; absent = main. Unknown loop: 404; disabled loop: 409.

Responses

Status Description Body

202 Queued AcceptedTurn

`accepted`required	boolean	Value `true`
`turnId`required	string	Correlation id: the events of the turn that handles this request carry it as `event.turn_id` on GET /events

Errors 400 · 401 · 403 · 404 · 409 · 500

400	Invalid request: missing or malformed field, query parameter or body. A body Fastify cannot parse gets Fastify's own shape (`statusCode`, `code`, `error`, `message`).`bad_requestFST_ERR_CTP_EMPTY_JSON_BODY`
401	Missing or wrong bearer token (`unauthorized`)
403	The request guard refused it: Host header not allowed (`host_not_allowed`, DNS-rebinding protection) or a browser cross-site request (`cross_origin`)`host_not_allowedcross_origin`
404	Unknown agent (or the named resource: loop, task, file, …)
409	The resource is in a state that does not allow this now
500	Unexpected runtime failure

Error bodies use the error format.

Example

Request

curl -X POST "http://127.0.0.1:7385/agents/agent-1/chat" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text":"Summarize today'\''s inbox."}'

Response 202

{
  "accepted": true,
  "turnId": "turn_V1StGXR8_Z5j"
}

Clear a loop's persisted chat / loop history

DELETE/agents/{id}/chat

Operation clearAgentChatAuthBearer token

Clears one loop's stream (default main, never all of them) and resets its in-memory session.

Path parameters

Name	Type	Description
`id`required	string	Loaded agent: its id, handle or name. example: agent-1

Query parameters

Name	Type	Description
`loop`	string	Cognition loop to address. Absent = main. Unknown loops answer 404.

Responses

Status Description Body

200 Cleared ChatClearResponse

`agentId`required	string	Agent id
`loop`required	string
`success`required	boolean	Value `true`

Errors 401 · 403 · 404 · 409 · 500

401	Missing or wrong bearer token (`unauthorized`)
403	The request guard refused it: Host header not allowed (`host_not_allowed`, DNS-rebinding protection) or a browser cross-site request (`cross_origin`)`host_not_allowedcross_origin`
404	Unknown agent (or the named resource: loop, task, file, …)
409	The resource is in a state that does not allow this now
500	Unexpected runtime failure

Error bodies use the error format.

Example

Request

curl -X DELETE "http://127.0.0.1:7385/agents/agent-1/chat" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"

Queue an ADF event dispatch

POST/agents/{id}/trigger

Operation triggerAgentAuthBearer token

Accepts a dispatch, a wrapped { dispatch }, a bare event (target fields at the top level or under target) or a batch (events). The daemon fills missing id, time and source. Event types: inbox, outbox, file_change, chat, timer, tool_call, task_create, task_complete, log_entry, startup, llm_call; data is required except for startup. Answers 202 at once.

Bypasses the TriggerEvaluator: the dispatch goes straight to the executor, with no enabled check, target/scope gate, filter, timing modifier, state gating or self-suppression. An inbox dispatch creates no adf_inbox row; for a real inbound message use the mesh server's POST /agents/{handle}/inbox.

No owner voice: data.message.source: "user" is refused (400; use POST …/chat, or source api / mesh), as are the internal flags skip_loop_append and pre_appended_loop. Match the returned turnId against event.turn_id on GET /events to follow this request's turn.

Path parameters

Name	Type	Description
`id`required	string	Loaded agent: its id, handle or name. example: agent-1

Request bodyapplication/json · TriggerBody · AdfEventDispatch | AdfBatchDispatch | object | AdfEvent · required

A dispatch, { dispatch: … }, a bare event, or a batch dispatch.

Field Type Description

Option 1

object

Target fields may sit at the top level or under target (default scope: agent).

7 fields of Option 1 · AdfEventDispatch

eventrequired object

6 fields of event · AdfEvent

`id`	string	Default: generated
`type`required	string	One of `inbox`, `outbox`, `file_change`, `chat`, `timer`, `tool_call`, `task_create`, `task_complete`, `log_entry`, `startup`, `llm_call`
`source`	string	Default: `daemon:http`
`time`	string	ISO 8601; default: now
`data`	any	Event payload; required (use null) for every type except startup. `data.message.source: "user"` and the internal flags `skip_loop_append` / `pre_appended_loop` are refused.
`correlationId`	string

target object

5 fields of target · DispatchTarget

`scope`	string	One of `agent`, `system`
`lambda`	string
`command`	string
`warm`	boolean
`loop`	string

scope

string

One of agent, system

lambda string

command string

warm boolean

loop string

Option 2 object

8 fields of Option 2 · AdfBatchDispatch

eventsrequired

array<AdfEvent>

items: ≥ 1

6 fields of events

`id`	string	Default: generated
`type`required	string	One of `inbox`, `outbox`, `file_change`, `chat`, `timer`, `tool_call`, `task_create`, `task_complete`, `log_entry`, `startup`, `llm_call`
`source`	string	Default: `daemon:http`
`time`	string	ISO 8601; default: now
`data`	any	Event payload; required (use null) for every type except startup. `data.message.source: "user"` and the internal flags `skip_loop_append` / `pre_appended_loop` are refused.
`correlationId`	string

count integer

target object

5 fields of target · DispatchTarget

`scope`	string	One of `agent`, `system`
`lambda`	string
`command`	string
`warm`	boolean
`loop`	string

scope

string

One of agent, system

lambda string

command string

warm boolean

loop string

Option 3 object

1 field of Option 3

dispatchrequired AdfEventDispatch | AdfBatchDispatch

2 variants of dispatch

`Option 1`	object	Target fields may sit at the top level or under `target` (default scope: agent). Fields as in AdfEventDispatch above.
`Option 2`	object	Fields as in AdfBatchDispatch above.

Option 4

object

Fields as in AdfEvent above.

Responses

Status Description Body

202 Queued AcceptedTurn

`accepted`required	boolean	Value `true`
`turnId`required	string	Correlation id: the events of the turn that handles this request carry it as `event.turn_id` on GET /events

Errors 400 · 401 · 403 · 404

400	Invalid request: missing or malformed field, query parameter or body. A body Fastify cannot parse gets Fastify's own shape (`statusCode`, `code`, `error`, `message`).`bad_requestFST_ERR_CTP_EMPTY_JSON_BODY`
401	Missing or wrong bearer token (`unauthorized`)
403	The request guard refused it: Host header not allowed (`host_not_allowed`, DNS-rebinding protection) or a browser cross-site request (`cross_origin`)`host_not_allowedcross_origin`
404	Unknown agent (or the named resource: loop, task, file, …)

Error bodies use the error format.

Example

Request

curl -X POST "http://127.0.0.1:7385/agents/agent-1/trigger" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "event": {
    "type": "chat",
    "data": {
      "text": "ping"
    }
  },
  "target": {
    "scope": "agent"
  }
}'

Response 202

{
  "accepted": true,
  "turnId": "turn_V1StGXR8_Z5j"
}

List inbox messages

GET/agents/{id}/inbox

Operation getAgentInboxAuthBearer token

Path parameters

Name	Type	Description
`id`required	string	Loaded agent: its id, handle or name. example: agent-1

Query parameters

Name	Type	Description
`status`	string	Only this status One of `unread`, `read`, `archived`

Responses

Status Description Body

200 Messages InboxResponse

agentIdrequired

string

Agent id

messagesrequired array<InboxMessage>

24 fields of messages

`id`required	string
`from`required	string
`to`	string
`reply_to`	string
`network`	string
`thread_id`	string
`parent_id`	string
`subject`	string
`content`required	string
`content_type`	string
`attachments`	array<object>
`meta`	object
`sender_alias`	string
`recipient_alias`	string
`message_id`	string
`owner`	string
`card`	string
`return_path`	string
`source`	string
`source_context`	object
`sent_at`	integer
`received_at`required	integer
`status`required	string	One of `unread`, `read`, `archived`
`original_message`	string

Errors 400 · 401 · 403 · 404

400	Invalid request: missing or malformed field, query parameter or body. A body Fastify cannot parse gets Fastify's own shape (`statusCode`, `code`, `error`, `message`).`bad_requestFST_ERR_CTP_EMPTY_JSON_BODY`
401	Missing or wrong bearer token (`unauthorized`)
403	The request guard refused it: Host header not allowed (`host_not_allowed`, DNS-rebinding protection) or a browser cross-site request (`cross_origin`)`host_not_allowedcross_origin`
404	Unknown agent (or the named resource: loop, task, file, …)

Error bodies use the error format.

Example

Request

curl "http://127.0.0.1:7385/agents/agent-1/inbox" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"

Delete all inbox messages

DELETE/agents/{id}/inbox

Operation clearAgentInboxAuthBearer token

Audit snapshots are kept when the agent's audit config requires them.

Path parameters

Name	Type	Description
`id`required	string	Loaded agent: its id, handle or name. example: agent-1

Responses

Status Description Body

200 Cleared InboxClearResponse

`agentId`required	string	Agent id
`success`required	boolean	Value `true`
`deleted`required	integer

Errors 401 · 403 · 404 · 500

401	Missing or wrong bearer token (`unauthorized`)
403	The request guard refused it: Host header not allowed (`host_not_allowed`, DNS-rebinding protection) or a browser cross-site request (`cross_origin`)`host_not_allowedcross_origin`
404	Unknown agent (or the named resource: loop, task, file, …)
500	Unexpected runtime failure

Error bodies use the error format.

Example

Request

curl -X DELETE "http://127.0.0.1:7385/agents/agent-1/inbox" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"

List outbox messages

GET/agents/{id}/outbox

Operation getAgentOutboxAuthBearer token

Path parameters

Name	Type	Description
`id`required	string	Loaded agent: its id, handle or name. example: agent-1

Query parameters

Name	Type	Description
`status`	string	Only this status One of `pending`, `sent`, `delivered`, `failed`

Responses

Status Description Body

200 Messages OutboxResponse

agentIdrequired

string

Agent id

messagesrequired array<OutboxMessage>

24 fields of messages

`id`required	string
`from`required	string
`to`required	string
`address`	string
`reply_to`	string
`network`	string
`thread_id`	string
`parent_id`	string
`subject`	string
`content`required	string
`content_type`	string
`attachments`	array<object>
`meta`	object
`sender_alias`	string
`recipient_alias`	string
`message_id`	string
`owner`	string
`card`	string
`return_path`	string
`status_code`	integer
`created_at`required	integer
`delivered_at`	integer
`status`required	string	One of `pending`, `sent`, `delivered`, `failed`
`original_message`	string

Errors 400 · 401 · 403 · 404

400	Invalid request: missing or malformed field, query parameter or body. A body Fastify cannot parse gets Fastify's own shape (`statusCode`, `code`, `error`, `message`).`bad_requestFST_ERR_CTP_EMPTY_JSON_BODY`
401	Missing or wrong bearer token (`unauthorized`)
403	The request guard refused it: Host header not allowed (`host_not_allowed`, DNS-rebinding protection) or a browser cross-site request (`cross_origin`)`host_not_allowedcross_origin`
404	Unknown agent (or the named resource: loop, task, file, …)

Error bodies use the error format.

Example

Request

curl "http://127.0.0.1:7385/agents/agent-1/outbox" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"