Agent Job Kit — TypeScript orchestration for AI agents

Stop building job orchestration from scratch

Every multi-agent system needs the same foundation: a way to create work, assign it to an agent, verify the output, and settle payment. Building this reliably — with proper error handling, timeouts, audit trails, and retry logic — takes days.

This kit gives you that foundation in one npm install.

──────────────────────────────────────

What's inside

Core orchestrator — three functions cover 95% of use cases:

• runCycle() — one job, full lifecycle, one call

• runBatch() — N jobs in sequence, per-job error handling, summary

• waitForTerminal() — poll until a job reaches its final state

Two adapters included:

• JSON/SQLite (Web2) — stores jobs locally. Zero accounts, zero setup. Works offline. Run the demo in 30 seconds.

• EVM (Web3) — any EVM-compatible chain via Circle Developer Wallets. Tested on Arc Testnet with 5,000 production cycles.

Built-in audit module — run "npm run audit" after any batch to get a full health report: completion rate, stuck jobs, budget integrity, and custom checks you define.

Clean interfaces — implement JobProvider to plug in PostgreSQL, Redis, or any backend. The orchestrator logic never changes.

──────────────────────────────────────

Run the demo in 30 seconds

git clone / unzip the kit

npm install

npm run demo

You'll see 5 jobs run through the full cycle — pending, funded, submitted, completed (or rejected) — with a batch summary and a clean audit report. No API keys. No accounts. No blockchain.

──────────────────────────────────────

Proven in production

The EVM adapter and orchestration patterns were built and tested during the Arc Testnet hackathon — 5,000 complete job cycles across a multi-agent economy with identity registration (ERC-8004), job marketplace (ERC-8183), reputation tracking, and a public BidBoard. The code in this kit is a generalized, cleaned version of that production codebase.

──────────────────────────────────────

What you get

• Full TypeScript source — no minified or obfuscated code

• core/types.ts — Job, JobProvider, AuditResult interfaces

• core/orchestrator.ts — runCycle, runBatch, waitForTerminal

• adapters/json.ts — Web2 JSON backend

• adapters/sqlite.ts — Web2 SQLite backend

• adapters/evm.ts — Web3 EVM backend (Circle + viem)

• audit/audit.ts — JobAuditor with 4 sections + custom checks

• 3 runnable examples (web2, web3, audit)

• .env.example — all config documented

• Full README with API reference and production notes

──────────────────────────────────────

Who this is for

• Backend developers building multi-agent systems who need a reliable job lifecycle without reinventing the wheel

• AI engineers orchestrating LLM agents that need auditable, accountable outputs

• Web3 developers on EVM chains who want a clean TypeScript abstraction over Circle wallets

• Teams that need job audit trails for compliance or quality control

──────────────────────────────────────

Requirements

• Node.js 18+ (tested on v22)

• TypeScript 5+ / tsx

• Web2 demo: no external accounts needed

• Web3 demo: free Circle Developer Console account + funded EVM wallets