SwarmWire

# A research + writer pipeline with a hard 50¢ ceiling
import { Swarm, createProvider } from 'swarmwire'

const swarm = new Swarm({
  providers: [createProvider('anthropic', { apiKey: process.env.ANTHROPIC_API_KEY })],
  // ledger rejects a plan whose dry-run exceeds this
  budget: { maxCostCents: 100 },
});

const researcher = swarm.agent({ name: 'researcher', role: 'Research thoroughly', model });
const writer     = swarm.agent({ name: 'writer',     role: 'Write concise prose', model });

const result = await swarm.run('Research TypeScript ORMs and recommend one', {
  pattern: 'pipeline',
  stages: [
    { name: 'research', agent: researcher },
    { name: 'write',    agent: writer      },
  ],
  // per-run override — cancels mid-flight if exceeded
  budget: { maxCostCents: 50, warningAt: 0.8 },
});

// always present, always typed
console.log(result.cost.totalCostCents,  // e.g. 42.7
            result.cost.perAgent,        // Map<name, { tokens, costCents, calls }>
            result.cost.budgetUsed);     // 0–1 fraction of ceiling consumed

If budget exhausts mid-execution: running steps finish, no new steps start, a partial result returns with cost.budgetUsed = 1. The ledger does not lie about where it stopped.