Overview

Agent Dev Lab is a TypeScript-first toolkit for authoring AI agents and workflows: a headless core (@agent-dev-lab/core), optional sandboxed tools (@agent-dev-lab/tools), an inspection UI (@agent-dev-lab/web), and a CLI (adl).

What You Get

• Agents and workflows as plain TypeScript on top of the Vercel AI SDK (streamText, tool, ModelMessage)
• Persisted run events for waterfalls, SSE tails, and replay (WorkflowStore / SQLite)
• adl init / adl workflow run / adl agent run / adl dashboard for scaffolding, CLI execution, and inspection
• adl dashboard — inspect runs; --serve if you do not want edits to agents, workflows, or templates picked up live. Restart after .env* edits.

Principles

• Runtime/UI split — workflows run from scripts, tests, or server; UI reads persisted output.
• TypeScript-first — plain TS orchestration, no workflow graph DSL.
• AI SDK native — ModelMessage, streamText, tool() without parallel abstractions.
• Colocated prompts — markdown beside code; templates via Handlebars + Zod (createTemplate).

Documentation Map

Guides

• Project Setup — the recommended way to start a project (adl init)
• Manual Setup — adding ADL to an existing project by hand
• Inspection UI — adl dashboard, waterfalls, agent conversations, event log
• Sandboxed Tools — optional @agent-dev-lab/tools (file, bash, search, fetchUrl)
• Gotchas — sharp edges worth knowing about before they surprise you
• Runtime — createAdlRuntime, workflow context, OpenTelemetry
• Agents — adl.createAgent, stopWhen, memory, adl agent run
• Tool Providers — ToolProvider, createToolProvider, combineToolProviders
• Workflows — adl.createWorkflow, ctx.emit, createWorkflowFromAgent
• Project Config — registry, loadAdlProject

API Reference

Generated from @agent-dev-lab/core’s own code comments — covers focused APIs that aren’t duplicated as guide pages:

• Package Overview — AI SDK compatibility summary (ModelMessage, OpenTelemetry)
• MessageStore, WorkflowStore, RunEvent (runSeq)
• Template, createTemplate
• createWorkflowFromAgent, createToolFromAgent
• ToolProvider, createToolProvider
• WorkflowObserver, AgentObserver
• createWorkspaceToolProvider, createFetchUrlTool

Use the Core API and Tools API sidebars for the full export lists.

Packages

Package	Role
@agent-dev-lab/core	Headless runtime
@agent-dev-lab/tools	Optional sandboxed file/bash/search/fetchUrl
@agent-dev-lab/web	Inspection UI
@agent-dev-lab/cli	adl CLI