AGBoss

Build complex AI workflows. Catch graph errors before runtime.
AGBoss is an open-source TypeScript framework with static verification (agboss check) for complex multi-agent workflows on LangGraph, combining dependency injection, typed dataflow (HarnessDSL), LIFO saga compensation, and deterministic testing & evaluation.

Apache-2.0 · TypeScript · v0.1.0-rc (pre-release in source; 0.0.1 placeholder on npm)

Documentation · Feature Explorer · 7 Principles · 5-Loop Verification Funnel · Examples (01..07) · Quick Start · llms.txt · X · LinkedIn · YouTube

AGBoss (Agent Graph Builder Open Source System) is an open-source TypeScript framework (agboss) and static workflow compiler (agboss-cli / agboss check) built on LangGraph. Its declarative workflow grammar, HarnessDSL (HDSL), replaces shared mutable state bags (Annotation.Root) with narrow @Dto handoffs, compile-time Path Scope dominance (.agboss/types.d.ts), declarative compensateWith / committedBy LIFO sagas, KV-cache prefix invariance, and a 5-loop verification funnel.

Instead of paying live LLM tokens to catch wiring bugs, AGBoss filters every change through a 5-Loop Cost & Determinism Verification Funnel closed by two production feedback loops:

1. Loop 0 — Static Compiler Proof (agboss check --federation, < 1s, $0): Runs on every file save and statically checks declared workflow topology, Path Scope DTOs, saga compensations, and cross-service MCP/A2A mesh contracts before any test runs.
2. Loop 1 — Deterministic Harness & Chaos (npm test, ~3s, $0): Runs on every commit without calling a live LLM — combining 10 isolated unit runners (testTool, testToolInterceptor, testAction, testRouter, testArbiter, testRag, testJudge, testCompaction, testPii, testGuardrail), full-graph testWith(App) with mockLlm, ModelFailure chaos (429, timeouts, truncated JSON), TestConcurrency.inOrder, multi-pod { instances: 2 } leases, and VCR cassettes locked to Loop 2 by [vcr.stale-cassette] (promptHash + schemaHash).
3. Loop 2 — Live-Model PR Smoke Gate (agboss eval run --runs 5 --baseline, ~1 min, $): Triggered when promptHash or schemaHash changes; executes a Fail-Fast $0 -> $$$ cascade (requiredTools/forbiddenTools/toolInvariant $\to$ $0 code @Judge $\to$ calibrated LLM @Judge), compares pass^k against the cached main baseline (flaky-on-baseline quarantine), and attaches a self-contained eval-report.html.
4. Loop 3 — Nightly Polygon (--runs 20 --metamorphic --chaos, ~15 min, $$): Verifies paraphrase trajectory invariance (--metamorphic), multi-turn @Compaction constraint survival, stale-memory override, live fault recovery (--chaos), and silent upstream provider quantization drift across 200+ OpenRouter and JEV decision endpoints.
5. Loop 4 — Production Telemetry & Two Feedback Loops (24/7):
   • Feedback Loop A (Failure Taxonomy & Calibration): PII-scrubbed ExecutionRecord traces flow into agboss eval ui, where engineers tag failures, verify judge agreement via Cohen's kappa ($\kappa \ge 0.80$) (agboss eval calibrate), and promote failures to agboss golden.
   • Feedback Loop B (Progressive Crystallization): High pass@k (100%) with low pass^k (40%) triggers $0 @ToolInterceptor self-correction (ToolCallDecision.replyToModel), while stable pass^k = 100% crystallizes DecidedBy.Model nodes into DecidedBy.Code — moving verification from paid Loop 2 back into free Loop 1.

Every standalone project in agbossjs/agboss-examples follows the Promise → Failure Injection → Reproducible Proof discipline ($0 offline npm run check, npm test, npm run demo), canonical 1 class = 1 file component folders, and symmetric Spring-style tests/ mirroring src/:

Pre-release status (v0.1.0-rc): agboss@0.1.0 and agboss-cli@0.1.0 are currently in release-candidate preparation in agbossjs/agboss (0.0.1 on npm is an initial registry placeholder). Until 0.1.0 is published to npm, pack the release-candidate tarballs from source (git clone https://github.com/agbossjs/agboss.git && cd agboss && npm ci && npm run build && npm pack --workspaces) or run the agbossjs/agboss-examples verification pipeline.

Create a new project (post-0.1.0 npm publication):

npx agboss create my-app
cd my-app
npm install
npm test

Add to an existing project (post-0.1.0 npm publication):

npm install agboss
npm install -D agboss-cli
npx agboss check

Zero vendor lock-in. 100% open source under the Apache 2.0 License. Maintained by Pavel Ravvich. Full documentation: https://agboss.dev · Contact: hello@agboss.dev · Security: security@agboss.dev