Runtime
Runtime diagnostics, token usage and token counting, daemon-wide and per agent.
On this page
Daemon runtime overview
/runtimeProcess, 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 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
settingsrequiredobject | 7 fields of | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
configuredrequired | boolean | |||||||||||||
filePathrequired | string | null | |||||||||||||
trackedDirectoriesrequired | array<string> | |||||||||||||
maxDirectoryScanDepthrequired | integer | null | |||||||||||||
autoCompactThresholdrequired | integer | null | |||||||||||||
promptOverridesrequired | object | |||||||||||||
3 fields of | ||||||||||||||
globalSystemPromptrequired | boolean | |
compactionPromptrequired | boolean | |
toolPromptsrequired | integer |
packageCountsrequired4 fields of packageCounts
sandboxPackagesrequired | integer | |
mcpServersrequired | integer | |
adaptersrequired | integer | |
providersrequired | integer |
providersrequired2 fields of providers · ProviderDiagnostics
providersrequired | array<ProviderDiagnosticsEntry> | |||||||||||||||||||||||||||||||||||||||||||
11 fields of | ||||||||||||||||||||||||||||||||||||||||||||
idrequired | string | |||||||
typerequired | string | |||||||
namerequired | string | |||||||
baseUrlrequired | string | |||||||
defaultModel | string | |||||||
preset | string | |||||||
credentialStoragerequired | string |
| ||||||
apiKeyStorage | string | |||||||
hasApiKeyrequired | boolean | |||||||
requestDelayMsrequired | integer | |||||||
paramsrequired | array<object> | |||||||
2 fields of | ||||||||
keyrequired | string | |
hasValuerequired | boolean |
agentUsagerequired7 fields of agentUsage
agentIdrequired | string | |
handle | string | |
namerequired | string | |
providerIdrequired | string | |
modelIdrequired | string | |
sourcerequired | string | |
credentialStoragerequired | string | null |
authrequired4 fields of auth · AuthDiagnostics
chatgptrequired | object | ||||||||||||||||||||||||||||||||||
5 fields of | |||||||||||||||||||||||||||||||||||
authenticatedrequired | boolean | |
email | string | |
expiresAt | integer | Epoch ms |
flowPending | boolean | |
flowError | string |
grokrequired5 fields of grok · SubscriptionAuthStatus
authenticatedrequired | boolean | |
email | string | |
expiresAt | integer | Epoch ms |
flowPending | boolean | |
flowError | string |
clauderequiredClaude sign-in as reported by the Claude Code CLI on the daemon host.
11 fields of claude · ClaudeAuthStatus
authenticatedrequired | boolean | |
installedrequired | boolean | False when Claude Code is not installed |
installUrl | string | Where to install Claude Code (only when not installed) |
version | string | Installed Claude Code version |
minVersion | string | Oldest Claude Code version this runtime supports |
updateRequired | boolean | True when the installed Claude Code is older than minVersion; sign-in is unavailable until it is updated |
email | string | |
plan | string | Claude plan, e.g. pro, max, team |
flowPending | boolean | |
flowUrl | string | Sign-in URL of the running flow |
flowError | string | Why Claude is unusable, or why the last sign-in failed. Also set while authenticated when a re-sign-in failed; the account shown is then the one signed in before it. Cleared when a new sign-in starts. |
providersrequired5 fields of providers
idrequired | string | |
typerequired | string | |
namerequired | string | |
credentialStoragerequired | string | |
hasApiKeyrequired | boolean |
mcprequired1 field of mcp · McpRegistrationsDiagnostics
serversrequired | array<object> | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
16 fields of | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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 | ||||||||
keyrequired | string | |
hasValuerequired | boolean |
headersrequired2 fields of headers
keyrequired | string | |
hasValuerequired | boolean |
headerEnvrequired2 fields of headerEnv
headerrequired | string | |
envrequired | string |
bearerTokenEnvVarrequiredtoolCallTimeoutrequiredadaptersrequired1 field of adapters · AdapterRegistrationsDiagnostics
adaptersrequired | array<object> | ||||||||||||||||
5 fields of | |||||||||||||||||
idrequired | string | |
typerequired | string | |
npmPackage | string | |
managedrequired | boolean | |
version | string |
networkrequired4 fields of network · NetworkDiagnostics
hostrequired | object | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
2 fields of | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
hostnamerequired | string | |||||||||||||
addressesrequired | array<object> | |||||||||||||
4 fields of | ||||||||||||||
ifacerequired | string | |
addressrequired | string | |
familyrequired | string | |
macrequired | string |
meshrequired4 fields of mesh
enabledSettingrequired | boolean | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
lanrequired | boolean | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
portrequired | integer | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
statusrequired | MeshStatus | null | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
5 fields of | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
meshEnabledrequired | boolean | |||||||||||||||||||||||||
meshServerRunningrequired | boolean | |||||||||||||||||||||||||
meshServerrequired | object | |||||||||||||||||||||||||
5 fields of | ||||||||||||||||||||||||||
runningrequired | boolean | |
portrequired | integer | |
hostrequired | string | |
lanAddresses | array<string> | Non-loopback addresses listening now. LAN mode (host 0.0.0.0: the Network switch, or an agent with lan or public visibility) listens on private-network and Tailscale addresses of allowed networks only (remote-access.md §3.3, §3.3.1), never on a public address. MESH_HOST set: [MESH_HOST] unless it is loopback. |
warning | string | Present while an agent with public visibility has no allowed network to listen on (it is reachable from this computer only, e.g. on a headless server with only a public address). It names MESH_HOST, which binds an address of the operator's choice. |
agentsrequired8 fields of agents
filePathrequired | string | |
handlerequired | string | |
did | string | |
agentId | string | |
icon | string | |
staterequired | string | Display (fleet-map) state of an agent |
status | string | |
model | string |
debugrequiredMesh manager internals (unstable)
websocketrequired3 fields of websocket
activeConnectionsrequired | integer | |
inboundConnectionsrequired | integer | |
outboundConnectionsrequired | integer |
agentsrequired10 fields of agents
agentIdrequired | string | |
handle | string | |
namerequired | string | |
filePathrequired | string | null | |
receiverequired | boolean | |
sendModerequired | string | null | |
networkrequired | string | null | |
wsConnectionsConfiguredrequired | integer | |
servingRoutesrequired | integer | |
publicServingEnabledrequired | boolean |
computerequired5 fields of compute
statusrequired | string | ||||||||||
containerNamerequired | string | ||||||||||
activeAgentsrequired | array<string> | ||||||||||
error | string | ||||||||||
leftRunning | array<object> | Containers this runtime's last stop (POST /compute/stop, shutdown) left running because another runtime on the machine uses them. Present only when non-empty. Cleared when this runtime starts a container (shared or per-agent) and by a stop that finds nothing running. | |||||||||
3 fields of | |||||||||||
namerequired | string | |
holdersrequired | array<string> | Runtimes using it, e.g. "studio-embedded pid 4242". Empty when the owner is unknown. |
reasonrequired | string |
agentsrequired5 fields of agents
idrequired | string | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
handle | string | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
namerequired | string | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
filePathrequired | string | null | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
status | object | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
13 fields of | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
idrequired | string | |||||||||||||||||||
filePathrequired | string | null | |||||||||||||||||||
namerequired | string | |||||||||||||||||||
handle | string | |||||||||||||||||||
autostartrequired | boolean | |||||||||||||||||||
runtimeStaterequired | string | Executor state: idle, thinking, tool_use, awaiting_approval, awaiting_ask, suspended, error, stopped: or a display state (active, hibernate, off) | ||||||||||||||||||
targetStaterequired | string | null | |||||||||||||||||||
loopCountrequired | 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 | ||||||||||||||||||
running | boolean | GET /agents/{id}/status: false for an open document that is not running (runtimeState | ||||||||||||||||||
sessionId | string | GET /agents/{id}/status of a running agent: its runtime session id (Studio's AGENT_START answers it). | ||||||||||||||||||
loopStates | map<string, string> | GET /agents/{id}/status of a running agent: each inner loop's display state (active, idle, suspended, error, off), keyed by loop name. Main is not in it (runtimeState is main's). A loop that accepted a dispatch but has not started thinking reads active. | ||||||||||||||||||
media | map<string, object> | GET /agents/{id}/status of a running agent: each loop's effective media (main and live inner loops, keyed by loop name): what its provider connector carries, narrowed by the agent's model.multimodal toggles. POST /agents/{id}/chat refuses the rest with 400 media_unsupported. | ||||||||||||||||||
2 fields of | ||||||||||||||||||||
support | object | ||||||||||
3 fields of | |||||||||||
image | boolean | |
audio | boolean | |
video | boolean |
refusalsWhy each modality not in support is refused, keyed image, audio or video.
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
curl "http://127.0.0.1:7385/runtime" \
-H "Authorization: Bearer $ADF_DAEMON_TOKEN"Legacy per-agent health summary
/diagnosticsResponses
| Status | Description | Body | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 200 | Diagnostics | DiagnosticsResponse | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
agentsrequiredarray<object> | 9 fields of | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
idrequired | string | |||||||||||||
filePathrequired | string | null | |||||||||||||
namerequired | string | |||||||||||||
handle | string | |||||||||||||
autostartrequired | boolean | |||||||||||||
status | object | |||||||||||||
adaptersrequired | array<object> | |||||||||||||
3 fields of | ||||||||||||||
typerequired | string | |
statusrequired | string | |
error | string |
mcprequired4 fields of mcp
namerequired | string | |
statusrequired | string | |
error | string | |
toolCountrequired | integer |
wsrequired2 fields of ws
configuredrequired | integer | |
activerequired | 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
curl "http://127.0.0.1:7385/diagnostics" \
-H "Authorization: Bearer $ADF_DAEMON_TOKEN"Sanitized settings summary
/runtime/settingsResponses
| 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
curl "http://127.0.0.1:7385/runtime/settings" \
-H "Authorization: Bearer $ADF_DAEMON_TOKEN"Token usage totals by provider and model
/runtime/usageResponses
| Status | Description | Body | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 200 | Usage (not attributed per agent) | RuntimeUsageResponse | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
byProviderrequiredarray<object> | 4 fields of | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
providerrequired | string | |
inputrequired | integer | |
outputrequired | integer | |
totalrequired | integer |
byModelrequired6 fields of byModel
providerrequired | string | |
modelrequired | string | |
daysrequired | integer | Days with usage |
inputrequired | integer | |
outputrequired | integer | |
totalrequired | integer |
usagerequireddate → provider → model → { input, output }
2 fields of usage
inputrequired | integer | |
outputrequired | 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
curl "http://127.0.0.1:7385/runtime/usage" \
-H "Authorization: Bearer $ADF_DAEMON_TOKEN"Clear token usage
/runtime/usageResponses
| Status | Description | Body | |||
|---|---|---|---|---|---|
| 200 | OK | SuccessResponse | |||
| |||||
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
curl -X DELETE "http://127.0.0.1:7385/runtime/usage" \
-H "Authorization: Bearer $ADF_DAEMON_TOKEN"{
"success": true
}Count tokens in one string
/runtime/token-countWith neither provider nor model, agentId picks the loaded agent's model; default provider anthropic.
Request bodyapplication/json · TokenCountBody · required
| Field | Type | Description |
|---|---|---|
textrequired | string | |
provider | string | |
model | string | |
agentId | string | Use this agent's provider/model |
Responses
| Status | Description | Body | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| 200 | Count | TokenCountResponse | |||||||||
| |||||||||||
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
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"}'{
"count": 4,
"provider": "anthropic",
"model": ""
}Count tokens in several strings
/runtime/token-count/batchRequest bodyapplication/json · TokenCountBatchBody · required
| Field | Type | Description |
|---|---|---|
textsrequired | array<string> | |
provider | string | |
model | string | |
agentId | string |
Responses
| Status | Description | Body | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| 200 | Counts, in input order | TokenCountBatchResponse | |||||||||
| |||||||||||
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
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
/agents/{id}/runtimeStatus, adapters, MCP, triggers and WebSocket connections in one read.
Path parameters
| Name | Type | Description |
|---|---|---|
idrequired | string | Loaded agent: its id, handle or name. |
Responses
| Status | Description | Body | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 200 | Diagnostics | AgentRuntimeDiagnostics | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
statesrequiredarray<AdapterState> | 6 fields of | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
typerequired | string | ||||||||||
statusrequired | string | ||||||||||
error | string | ||||||||||
connectedAt | integer | ||||||||||
restartCountrequired | integer | ||||||||||
logsrequired | array<object> | ||||||||||
3 fields of | |||||||||||
timestamprequired | integer | |
levelrequired | string | |
messagerequired | string |
mcprequired3 fields of mcp · AgentMcpDiagnostics
agentIdrequired | string | Agent id | |||||||||||||||||||||||||||||||||
configuredrequired | array<object> | ||||||||||||||||||||||||||||||||||
5 fields of | |||||||||||||||||||||||||||||||||||
namerequired | string | |
transport | string | |
command | string | |
args | array<string> | |
toolCountrequired | integer |
statesrequired7 fields of states
namerequired | string | ||||||||||
statusrequired | string | ||||||||||
error | string | ||||||||||
connectedAt | integer | ||||||||||
restartCountrequired | integer | ||||||||||
toolCountrequired | integer | ||||||||||
logsrequired | array<object> | ||||||||||
3 fields of | |||||||||||
timestamprequired | integer | |
streamrequired | string | |
messagerequired | string |
triggersrequired3 fields of triggers · AgentTriggersDiagnostics
agentIdrequired | string | Agent id | ||||||||||||||||||||||||||||||||||||||||||||||||
displayStaterequired | string | null | |||||||||||||||||||||||||||||||||||||||||||||||||
configuredrequired | array<object> | |||||||||||||||||||||||||||||||||||||||||||||||||
4 fields of | ||||||||||||||||||||||||||||||||||||||||||||||||||
typerequired | string | ||||||||||||||||||||||||||||||||||
enabledrequired | boolean | ||||||||||||||||||||||||||||||||||
targetCountrequired | integer | ||||||||||||||||||||||||||||||||||
targetsrequired | array<TriggerTarget> | ||||||||||||||||||||||||||||||||||
11 fields of | |||||||||||||||||||||||||||||||||||
scoperequired | string | |
lambda | string | System scope: |
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 |
wsrequired2 fields of ws
configuredrequired | array<object> | ||||||||||||||||
activerequired | array<WsConnectionInfo> | ||||||||||||||||
5 fields of | |||||||||||||||||
connection_idrequired | string | |
remote_didrequired | string | |
directionrequired | string | |
connected_atrequired | integer | |
last_message_atrequired | 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
curl "http://127.0.0.1:7385/agents/agent-1/runtime" \
-H "Authorization: Bearer $ADF_DAEMON_TOKEN"One agent's trigger configuration
/agents/{id}/runtime/triggersPath parameters
| Name | Type | Description |
|---|---|---|
idrequired | string | Loaded agent: its id, handle or name. |
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
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)
/agents/{id}/triggersPath parameters
| Name | Type | Description |
|---|---|---|
idrequired | string | Loaded agent: its id, handle or name. |
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
curl "http://127.0.0.1:7385/agents/agent-1/triggers" \
-H "Authorization: Bearer $ADF_DAEMON_TOKEN"One agent's WebSocket connections
/agents/{id}/runtime/wsPath parameters
| Name | Type | Description |
|---|---|---|
idrequired | string | Loaded agent: its id, handle or name. |
Responses
| Status | Description | Body | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 200 | Connections | AgentWsDiagnostics | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
recentLogsrequiredarray<LogEntry> | Last 50 websocket-origin log rows 8 fields of | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
idrequired | integer | |
levelrequired | string | |
originrequired | string | null | |
eventrequired | string | null | |
targetrequired | string | null | |
messagerequired | string | |
datarequired | string | null | JSON text |
created_atrequired | 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
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)
/agents/{id}/wsPath parameters
| Name | Type | Description |
|---|---|---|
idrequired | string | Loaded agent: its id, handle or name. |
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
curl "http://127.0.0.1:7385/agents/agent-1/ws" \
-H "Authorization: Bearer $ADF_DAEMON_TOKEN"Emergency stop
/runtime/emergency-stopCloses the runtime gate (resumable: the next deliberate start reopens it), disables the mesh without persisting it, unloads every agent at once, stops WS connections, the mesh server, tracked child processes, host execs and sandbox workers, then the compute containers. Files stay reopenable. Any part left running or failed makes the answer success: false naming it.
Responses
| Status | Description | Body | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 200 | OK | EmergencyStopResult | ||||||||||||
| ||||||||||||||
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
curl -X POST "http://127.0.0.1:7385/runtime/emergency-stop" \
-H "Authorization: Bearer $ADF_DAEMON_TOKEN"{
"success": false,
"error": "Emergency stop was partial — not wired on this daemon, left running: mesh server.",
"skipped": [
"mesh server"
]
}Tool schema catalog
/runtime/tools/descriptionsEvery built-in tool in provider format, plus stub declarations of the runtime tools that need per-agent dependencies and the code-execution method schemas.
Responses
| Status | Description | Body |
|---|---|---|
| 200 | OK | ToolDescriptions · map<string, object> |
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
curl "http://127.0.0.1:7385/runtime/tools/descriptions" \
-H "Authorization: Bearer $ADF_DAEMON_TOKEN"