Edge-Cloud Sync
Connect edge devices to a cloud Agentium instance with heartbeats, remote configuration, event streaming, and an offline-first event queue.Quick Start
Config
string
required
Cloud server base URL.
string
required
Unique identifier for this edge device.
string
Bearer token for cloud API authentication.
number
default:"30000"
Heartbeat frequency in milliseconds.
string
default:"/tmp/agentium-edge-queue"
Directory for the offline event queue.
number
default:"10000"
Maximum queued events before oldest are dropped.
number
default:"60000"
How often to attempt flushing queued events.
Features
Heartbeat
PeriodicPOST /edge/heartbeat to the cloud with device status, resource metrics, and queue depth.
Config Pull
pullConfig() fetches agent, team, and workflow blueprints from the cloud admin API (GET /admin/agents, /admin/teams, /admin/workflows), allowing remote deployment of agent configurations.
Event Push
pushEvent(type, payload) streams agent run results and telemetry back to the cloud for logging and monitoring.
Offline-First Queue
Events are persisted to a local JSONL file when the cloud is unreachable. On reconnect, the entire queue is flushed in a single batch. The queue respectsmaxQueueSize — oldest events are dropped when the limit is reached.