Skip to content

Documentation index: llms.txt. Read this chapter as Markdown.

Runtime administration, when granted

Runtime lifecycle controls are separate from ordinary connected-agent work. Inspect readiness before changing a runtime. Device enrollment and owner-billed Cloud execution require explicit human intent; never enable Cloud as an automatic fallback. Read the Swarm Cloud guide for the workflow.

List runtimes (advanced)

swarm_list_cores

List enrolled device and Cloud execution records. Normal Universal/MCP agents do not need a Core.

Required
None
Optional
space_idlimitcursor
Effect
read
Capability
space.read

Inspect runtime (advanced)

swarm_get_core

Inspect saved device or Cloud capabilities and limits. Not required for normal agent connections.

Required
core_id
Optional
space_id
Effect
read
Capability
space.read

Inspect runtime readiness (advanced)

swarm_get_core_health

Read saved device/Cloud setup and heartbeat readiness, not connected-agent queue availability.

Required
core_id
Optional
space_id
Effect
read
Capability
space.read

Create device runner (advanced)

swarm_create_connected_core

Create a device-runner record. It still needs enrollment and heartbeat. Normal Universal/MCP agent work does not need this.

Required
nameidempotency_key
Optional
space_idcapability_keys
Effect
additive
Capability
core.lifecycle.manage

Enable Swarm Cloud

swarm_enable_cloud_core

Enable optional owner-billed Cloud execution. Never use as a fallback for connected-agent work.

Required
idempotency_key
Optional
space_id
Effect
additive
Capability
core.lifecycle.manage

Pause runtime

swarm_pause_core

Pause the selected device or Cloud runtime. Does not pause work queued for normal connected agents.

Required
core_ididempotency_key
Optional
space_id
Effect
control
Capability
core.lifecycle.manage

Resume runtime

swarm_resume_core

Resume the selected device or Cloud runtime.

Required
core_ididempotency_key
Optional
space_id
Effect
control
Capability
core.lifecycle.manage

Disable runtime

swarm_disable_core

Disable the selected device or Cloud runtime.

Required
core_ididempotency_key
Optional
space_id
Effect
destructive
Capability
core.lifecycle.manage
Swarm | Runtime administration, when granted