Skip to main content

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

Periodic POST /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 respects maxQueueSize — oldest events are dropped when the limit is reached.

Events