LoopX Distributed Agent Control Plane & Cluster Scheduler

LoopX Distributed Agent Control Plane & Cluster Scheduler

@loopx-project/loopx·v1.4.0·core

An enterprise-grade distributed control plane and cluster scheduler for DeepSeek Harness. Features automated service discovery, dynamic load balancing, regional routing, and cluster health metrics.

Control-Plane · Cluster-Scheduler · Service-Discovery · Mesh

GitHubNPM
Installation & Integration
bash
manager:
$ pnpm add @loopx-project/loopx

Architecture

LoopX Control Plane transforms standalone agent processes into a resilient distributed mesh. As AI infrastructure scales across multiple regions and hundreds of specialized workers, manual peer configurations collapse under operational complexity. This plugin implements a lightweight control plane adapter on top of Cordis. Worker nodes self-register their capabilities and dynamic load metrics on startup. The central scheduler balances execution requests using health-aware heuristics, optimizing GPU utilization, minimizing round-trip latency, and providing 99.99% fault tolerance.

Core Features

01

Lightweight Embedded Consensus: Employs an internal Raft protocol without external ZooKeeper stacks

02

Capability-Aware Affinity Rules: Routes tasks based on GPU tier, RAM capacity, or geography

03

Live Mesh Topology Console: Real-time visual dashboard showcasing node throughput and heatmaps

04

Prometheus Native Metrics: Exports scheduling latencies and queue depths directly to Grafana

Core Workflow

01

Node Discovery & Registration

Worker instances declare available tools, GPU resources, and endpoints on boot.

02

Heartbeat & Telemetry Probing

Continuously probes node health, memory pressure, and queue backpressure.

03

Adaptive Weighted Routing

Routes execution jobs to the most suitable idle node based on dynamic weights.

04

Fault Eviction & Failover

Instantly evicts degraded nodes and reroutes in-flight jobs to healthy peers.

Configuration Parameters Reference (YAML / JSON)

ParameterTypeDefaultDescription
clusterRolestringworkerNode role in the LoopX cluster mesh
controlPlaneEndpointstringhttp://127.0.0.1:8888Master control plane communication URL
heartbeatIntervalSecnumber5Heartbeat reporting frequency in seconds