# AGBoss (Agent Graph Builder Open Source System)

> AGBoss (Agent Graph Builder Open Source System) is an open-source TypeScript framework with static verification (agboss check) for complex multi-agent workflows on top of LangGraph, combining dependency injection, typed DTO dataflow, and HarnessDSL (HDSL) — its declarative workflow grammar enforcing 7 distributed-systems architectural principles: (1) Computational Role Segregation (@Agent, @Router, @Arbiter, @Action), (2) Path-Scoped SSA Dataflow & Staleness Tracking (Produced<Dto, Producer>, about, historyOf), (3) Canonical Topology Isomorphism (in-degree = 1 inline vs >= 2 top-level path, depth <= 4), (4) Prompt Prefix Cache Invariance ([prompt.input-in-instructions], sorted schemas, deterministic HMAC replaceWithToken), (5) Transactional LIFO Sagas & Idempotent Execution (step.idempotencyKey, compensateWith / committedBy, [graph.limit-handler-uses-model]), (6) Zero-Leakage DI & Progressive Infrastructure Scaling (InMemory* to Sqlite* WAL, 30s leases, ChildPlacement.AnyInstance work-stealing, health probes, and 10 unit runners), and (7) Progressive Crystallization (agboss describe --json + trace join + agboss hub Crystallization Radar from DecidedBy.Model to DecidedBy.Code).

AGBoss is designed for TypeScript engineers building multi-agent workflows with or without AI coding assistants. Instead of relying on an untyped mutable shared state object where missing branch inputs or stale loop outputs fail at runtime, AGBoss verifies workflow topology and Path Scope before runtime via `agboss check` (emitting `.agboss/types.d.ts`) and ships with auto-synced `AGENTS.md` + 13 skill reference modules (`references/01..13`) and `@agboss/core/eslint`. Workflows use one chained method call per line (`start(Start).returns(Dto).toAgent(Agent).toFinish(Finish)`), DTOs are plain objects validated by field decorators (`@agboss/core/dto`), and durations/money/sizes use unit factories (`seconds()`, `minutes()`, `hours()`, `usd()`, `kilobytes()`).

## Documentation Sets

- [Abridged documentation](https://agboss.dev/llms-small.txt): a compact version of the documentation for AGBoss (Agent Graph Builder Open Source System), with non-essential content removed
- [Complete documentation](https://agboss.dev/llms-full.txt): the full documentation for AGBoss (Agent Graph Builder Open Source System)
- [Core Concepts & HarnessDSL (HDSL)](https://agboss.dev/_llms-txt/core-concepts--harnessdsl-hdsl.txt): Application assembly, HarnessDSL (HDSL) Path Scope grammar, decorators, and dependency injection.
- [Production, FinOps, Security & Testing Guides](https://agboss.dev/_llms-txt/production-finops-security--testing-guides.txt): Testing with testWith and 10 unit runners, @EvalSuite and pass@k / pass^k, error handling and rollback, channels and two-phase pauses, FinOps budgets, PII policies, SQLite durability, ChildPlacement.AnyInstance work-stealing, Langfuse tracing, MCP, RAG, A2A mesh + agboss hub, and AI coding skills.
- [API Reference, CLI & Changelog](https://agboss.dev/_llms-txt/api-reference-cli--changelog.txt): Complete decorator contracts, HarnessDSL (HDSL) flow methods, standard DTOs, agboss CLI commands, and release changelog.
- [Examples](https://agboss.dev/_llms-txt/examples.txt): 7 standalone verified applications in agbossjs/agboss-examples (01-hello-agboss, 02-path-scope-proof, 03-support-refund-desk, 04-travel-booking-saga, 05-cluster-work-stealing, 06-enterprise-agent-mesh, 07-langgraph-migration) plus job-scout and flow-patterns.

## Notes

- The complete documentation includes all content from the official documentation
- The content is automatically generated from the same source as the official documentation

## Optional

- [AGBoss Framework GitHub Repository](https://github.com/agbossjs/agboss): Source code, issue tracker, examples/job-scout, and examples/flow-patterns.
- [AGBoss Verified Examples Repository](https://github.com/agbossjs/agboss-examples): 7 standalone verified applications (01-hello-agboss, 02-path-scope-proof, 03-support-refund-desk, 04-travel-booking-saga, 05-cluster-work-stealing, 06-enterprise-agent-mesh, and 07-langgraph-migration).
- [Why AGBoss](https://agboss.dev/why/): Architectural overview comparing AGBoss with raw orchestration libraries and hosted agent platforms.
- [AGBoss Roadmap](https://agboss.dev/roadmap/): Shipped capabilities and upcoming milestones.