@jem-open/mbali-core

The engine, model and ports of mbali — a reconciling control plane for fleets of remote AI agent sessions. Zero runtime dependencies.

This is the package everything else is built on. It defines the domain model (planes, runs, policy), the reconciling Engine, and the ports — AgentRuntime, WorkSource, Ingress, Channel, RunStore, IngressBuffer, Scheduler, Secrets, Telemetry, Correlation. Driver packages (@jem-open/mbali-slack, @jem-open/mbali-linear, @jem-open/mbali-anthropic-managed, …) implement these ports; core orchestrates them. It never reaches out to a vendor itself.

Install

pnpm add @jem-open/mbali-core

Usage

Wire drivers into the Engine, define a plane, and tick it. Each tick polls the work source, admits items under policy, dispatches sessions on the runtime, and reconciles live runs against the store.

import { Engine, type PlaneDefinition } from "@jem-open/mbali-core";

const engine = new Engine({ runtime, runStore });

const plane: PlaneDefinition = {
  id: "support",
  trigger: { worksource, query: { label: "ai" } },
  policy: { admission: { maxPerTick: 5 } },
  agent: (item) => ({ agent: "support-agent", title: item.title }),
};

const report = await engine.tick(plane);

A plane's failure never sinks the rest of the fleet; reconcile reaps, completes, recovers and verifies runs idempotently so ticks are safe to repeat.

Part of mbali — the control plane for fleets of remote AI agent sessions.