Runtime · Daemon API

On this page

Daemon runtime overview

GET/runtime

Operation getRuntimeAuthBearer token

Process, settings, providers, auth, MCP, adapters, network, compute and every loaded agent in one read, secrets sanitized. daemon.version is ADF_VERSION, else the npm package version, else null.

Responses

Status Description Body

200 Overview RuntimeOverview

daemonrequired object

5 fields of daemon

`uptime`required	number	Seconds
`pid`required	integer
`version`required	string \| null
`node`required	string
`platform`required	string

settingsrequired object

7 fields of settings · RuntimeSettingsDiagnostics

configuredrequired boolean

filePathrequired string | null

trackedDirectoriesrequired array<string>

maxDirectoryScanDepthrequired integer | null

autoCompactThresholdrequired integer | null

promptOverridesrequired object

3 fields of promptOverrides

`globalSystemPrompt`required	boolean
`compactionPrompt`required	boolean
`toolPrompts`required	integer

packageCountsrequired object

4 fields of packageCounts

`sandboxPackages`required	integer
`mcpServers`required	integer
`adapters`required	integer
`providers`required	integer

providersrequired object

2 fields of providers · ProviderDiagnostics

providersrequired array<ProviderDiagnosticsEntry>

11 fields of providers

idrequired string

typerequired string

namerequired string

baseUrlrequired string

defaultModel string

preset string

credentialStoragerequired

string

app or agent

apiKeyStorage string

hasApiKeyrequired boolean

requestDelayMsrequired integer

paramsrequired array<object>

2 fields of params

`key`required	string
`hasValue`required	boolean

agentUsagerequired array<object>

7 fields of agentUsage

`agentId`required	string
`handle`	string
`name`required	string
`providerId`required	string
`modelId`required	string
`source`required	string	One of `agent`, `app`, `missing`
`credentialStorage`required	string \| null

authrequired object

3 fields of auth · AuthDiagnostics

chatgptrequired object

5 fields of chatgpt · SubscriptionAuthStatus

`authenticated`required	boolean
`email`	string
`expiresAt`	integer	Epoch ms
`flowPending`	boolean
`flowError`	string

grokrequired object

5 fields of grok · SubscriptionAuthStatus

`authenticated`required	boolean
`email`	string
`expiresAt`	integer	Epoch ms
`flowPending`	boolean
`flowError`	string

providersrequired array<object>

5 fields of providers

`id`required	string
`type`required	string
`name`required	string
`credentialStorage`required	string
`hasApiKey`required	boolean

mcprequired object

1 field of mcp · McpRegistrationsDiagnostics

serversrequired array<object>

16 fields of servers

idrequired string

namerequired string

typerequired string

npmPackage string

pypiPackage string

command string

args array<string>

url string

managedrequired boolean

version string

credentialStoragerequired string

envrequired array<object>

2 fields of env

`key`required	string
`hasValue`required	boolean

headersrequired array<object>

2 fields of headers

`key`required	string
`hasValue`required	boolean

headerEnvrequired array<object>

2 fields of headerEnv

`header`required	string
`env`required	string

bearerTokenEnvVarrequired string | null

toolCallTimeoutrequired integer | null

adaptersrequired object

1 field of adapters · AdapterRegistrationsDiagnostics

adaptersrequired array<object>

5 fields of adapters

`id`required	string
`type`required	string
`npmPackage`	string
`managed`required	boolean
`version`	string

networkrequired object

4 fields of network · NetworkDiagnostics

hostrequired object

2 fields of host · LanAddressInfo

hostnamerequired string

addressesrequired array<object>

4 fields of addresses

`iface`required	string
`address`required	string
`family`required	string	One of `IPv4`, `IPv6`
`mac`required	string

meshrequired object

4 fields of mesh

enabledSettingrequired boolean

lanrequired boolean

portrequired integer

statusrequired MeshStatus | null

5 fields of status

meshEnabledrequired boolean

meshServerRunningrequired boolean

meshServerrequired object

3 fields of meshServer · MeshServerStatus

`running`required	boolean
`port`required	integer
`host`required	string

agentsrequired array<MeshAgentStatus>

8 fields of agents

`filePath`required	string
`handle`required	string
`did`	string
`agentId`	string
`icon`	string
`state`required	string	Display (fleet-map) state of an agent One of `active`, `idle`, `hibernate`, `suspended`, `off`
`status`	string
`model`	string

debugrequired

object

Mesh manager internals (unstable)

websocketrequired object

3 fields of websocket

`activeConnections`required	integer
`inboundConnections`required	integer
`outboundConnections`required	integer

agentsrequired array<object>

10 fields of agents

`agentId`required	string
`handle`	string
`name`required	string
`filePath`required	string \| null
`receive`required	boolean
`sendMode`required	string \| null
`network`required	string \| null
`wsConnectionsConfigured`required	integer
`servingRoutes`required	integer
`publicServingEnabled`required	boolean

computerequired ComputeStatus | null

4 fields of compute

`status`required	string	One of `not_installed`, `machine_stopped`, `stopped`, `starting`, `running`, `error`
`containerName`required	string
`activeAgents`required	array<string>
`error`	string

agentsrequired array<object>

5 fields of agents

idrequired string

handle string

namerequired string

filePathrequired string | null

status object

9 fields of status · AgentStatus

`id`required	string
`filePath`required	string \| null
`name`required	string
`handle`	string
`autostart`required	boolean
`runtimeState`required	string	Executor state: idle, thinking, tool_use, awaiting_approval, awaiting_ask, suspended, error, stopped: or a display state (active, hibernate, off)
`targetState`required	string \| null
`loopCount`required	integer	Persisted entries in main's loop stream
`degraded`	string	Set when the agent loaded but cannot fully function (CREDENTIALS_LOCKED: its credentials envelope is locked); cleared once the owner identity unlocks it

Errors 401 · 403

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`

Error bodies use the error format.

Example

Request

curl "http://127.0.0.1:7385/runtime" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"

Legacy per-agent health summary

GET/diagnostics

Operation getDiagnosticsAuthBearer token

Responses

Status Description Body

200 Diagnostics DiagnosticsResponse

daemonrequired object

2 fields of daemon

`uptime`required	number
`pid`required	integer

agentsrequired array<object>

9 fields of agents

idrequired string

filePathrequired string | null

namerequired string

handle string

autostartrequired boolean

status

object

Fields as in AgentStatus above.

adaptersrequired array<object>

3 fields of adapters

`type`required	string
`status`required	string
`error`	string

mcprequired array<object>

4 fields of mcp

`name`required	string
`status`required	string
`error`	string
`toolCount`required	integer

wsrequired object

2 fields of ws

`configured`required	integer
`active`required	integer

Errors 401 · 403

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`

Error bodies use the error format.

Example

Request

curl "http://127.0.0.1:7385/diagnostics" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"

Sanitized settings summary

GET/runtime/settings

Operation getRuntimeSettingsAuthBearer token

Responses

Status	Description	Body
200	Settings summary	RuntimeSettingsDiagnostics
Fields as in RuntimeSettingsDiagnostics above.

Errors 401 · 403

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`

Error bodies use the error format.

Example

Request

curl "http://127.0.0.1:7385/runtime/settings" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"

Token usage totals by provider and model

GET/runtime/usage

Operation getRuntimeUsageAuthBearer token

Responses

Status Description Body

200 Usage (not attributed per agent) RuntimeUsageResponse

sourcerequired

string

Value token-usage-service

noterequired string

totalsrequired object

3 fields of totals

`input`required	integer
`output`required	integer
`total`required	integer

byProviderrequired array<object>

4 fields of byProvider

`provider`required	string
`input`required	integer
`output`required	integer
`total`required	integer

byModelrequired array<object>

6 fields of byModel

`provider`required	string
`model`required	string
`days`required	integer	Days with usage
`input`required	integer
`output`required	integer
`total`required	integer

usagerequired

map<string, map<string, map<string, object>>>

date → provider → model → { input, output }

2 fields of usage

`input`required	integer
`output`required	integer

Errors 401 · 403

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`

Error bodies use the error format.

Example

Request

curl "http://127.0.0.1:7385/runtime/usage" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"

Count tokens in one string

POST/runtime/token-count

Operation countRuntimeTokensAuthBearer token

With neither provider nor model, agentId picks the loaded agent's model; default provider anthropic.

Request bodyapplication/json · TokenCountBody · required

Field	Type	Description
`text`required	string
`provider`	string
`model`	string
`agentId`	string	Use this agent's provider/model

Responses

Status Description Body

200 Count TokenCountResponse

`count`required	integer
`provider`required	string
`model`required	string

Errors 400 · 401 · 403

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`

Error bodies use the error format.

Example

Request

curl -X POST "http://127.0.0.1:7385/runtime/token-count" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text":"Hello, world","provider":"anthropic"}'

Response 200

{
  "count": 4,
  "provider": "anthropic",
  "model": ""
}

Count tokens in several strings

POST/runtime/token-count/batch

Operation countRuntimeTokensBatchAuthBearer token

Request bodyapplication/json · TokenCountBatchBody · required

Field	Type	Description
`texts`required	array<string>
`provider`	string
`model`	string
`agentId`	string

Responses

Status Description Body

200 Counts, in input order TokenCountBatchResponse

`counts`required	array<integer>
`provider`required	string
`model`required	string

Errors 400 · 401 · 403

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`

Error bodies use the error format.

Example

Request

curl -X POST "http://127.0.0.1:7385/runtime/token-count/batch" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"texts":["one","two words"]}'

One agent's runtime diagnostics

GET/agents/{id}/runtime

Operation getAgentRuntimeAuthBearer token

Status, adapters, MCP, triggers and WebSocket connections in one read.

Path parameters

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

Responses

Status Description Body

200 Diagnostics AgentRuntimeDiagnostics

agentIdrequired

string

Agent id

status

object

Fields as in AgentStatus above.

adaptersrequired object

3 fields of adapters · AgentAdaptersDiagnostics

agentIdrequired

string

Agent id

configuredrequired array<object>

3 fields of configured

`type`required	string
`enabled`required	boolean
`config`required	object

statesrequired array<AdapterState>

6 fields of states

typerequired string

statusrequired

string

One of connected, connecting, disconnected, error

error string

connectedAt integer

restartCountrequired integer

logsrequired array<object>

3 fields of logs

`timestamp`required	integer
`level`required	string	One of `info`, `warn`, `error`, `system`
`message`required	string

mcprequired object

3 fields of mcp · AgentMcpDiagnostics

agentIdrequired

string

Agent id

configuredrequired array<object>

5 fields of configured

`name`required	string
`transport`	string
`command`	string
`args`	array<string>
`toolCount`required	integer

statesrequired array<McpServerState>

7 fields of states

namerequired string

statusrequired

string

One of stopped, connecting, connected, error, installing

error string

connectedAt integer

restartCountrequired integer

toolCountrequired integer

logsrequired array<object>

3 fields of logs

`timestamp`required	integer
`stream`required	string	One of `stdout`, `stderr`, `system`
`message`required	string

triggersrequired object

3 fields of triggers · AgentTriggersDiagnostics

agentIdrequired

string

Agent id

displayStaterequired string | null

configuredrequired array<object>

4 fields of configured

typerequired string

enabledrequired boolean

targetCountrequired integer

targetsrequired array<TriggerTarget>

11 fields of targets

`scope`required	string	One of `agent`, `system`
`lambda`	string	System scope: `path/file.ts:functionName`
`command`	string	System scope: shell command (alternative to lambda)
`warm`	boolean
`filter`	object
`debounce_ms`	integer
`interval_ms`	integer
`batch_ms`	integer
`batch_count`	integer
`locked`	boolean
`loop`	string	Cognition loop this target wakes; absent = main

wsrequired object

2 fields of ws

configuredrequired array<object>

activerequired array<WsConnectionInfo>

5 fields of active

`connection_id`required	string
`remote_did`required	string
`direction`required	string	One of `inbound`, `outbound`
`connected_at`required	integer
`last_message_at`required	integer

Errors 401 · 403 · 404

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/runtime" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"

One agent's trigger configuration

GET/agents/{id}/runtime/triggers

Operation getAgentRuntimeTriggersAuthBearer token

Path parameters

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

Responses

Status	Description	Body
200	Triggers	AgentTriggersDiagnostics
Fields as in AgentTriggersDiagnostics above.

Errors 401 · 403 · 404

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/runtime/triggers" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"

One agent's trigger configuration (same as …/runtime/triggers)

GET/agents/{id}/triggers

Operation getAgentTriggersAuthBearer token

Path parameters

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

Responses

Status	Description	Body
200	Triggers	AgentTriggersDiagnostics
Fields as in AgentTriggersDiagnostics above.

Errors 401 · 403 · 404

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/triggers" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"

One agent's WebSocket connections

GET/agents/{id}/runtime/ws

Operation getAgentRuntimeWsAuthBearer token

Path parameters

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

Responses

Status Description Body

200 Connections AgentWsDiagnostics

agentIdrequired

string

Agent id

configuredrequired

array<object>

config.ws_connections

activerequired array<WsConnectionInfo>

5 fields of active

`connection_id`required	string
`remote_did`required	string
`direction`required	string	One of `inbound`, `outbound`
`connected_at`required	integer
`last_message_at`required	integer

recentLogsrequired

array<LogEntry>

Last 50 websocket-origin log rows

8 fields of recentLogs

`id`required	integer
`level`required	string	One of `debug`, `info`, `warn`, `error`
`origin`required	string \| null
`event`required	string \| null
`target`required	string \| null
`message`required	string
`data`required	string \| null	JSON text
`created_at`required	integer	Epoch ms

Errors 401 · 403 · 404

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/runtime/ws" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"

One agent's WebSocket connections (same as …/runtime/ws)

GET/agents/{id}/ws

Operation getAgentWsAuthBearer token

Path parameters

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

Responses

Status	Description	Body
200	Connections	AgentWsDiagnostics
Fields as in AgentWsDiagnostics above.

Errors 401 · 403 · 404

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/ws" \
  -H "Authorization: Bearer $ADF_DAEMON_TOKEN"