Overview

The Agent Dev Lab is a TypeScript-first workspace for experimenting with agentic workflows: a headless core library (@agent-dev-lab/core), a TanStack Start inspection UI (apps/web), CLI (adl), and shared infrastructure.

What is implemented today

The headless runtime in @agent-dev-lab/core is usable without the UI or CLI execution path:

Area	Status
createAdlRuntime, agents, workflows, templates	Implemented
agent.run / agent.stream via AI SDK streamText	Implemented
workflow.run / workflow.stream, ctx.step, step caching	Implemented
MessageStore + WorkflowStore (in-memory defaults)	Implemented
Observers, RunRecorder, run events	Implemented
loadAdlProject + registry indexes	Implemented
adl.createToolFromAgent / adl.createToolFromWorkflow	Implemented
SQLite-backed stores	Not implemented
CLI adl run / list commands	Not implemented
Inspection UI run waterfall / SSE	Not implemented
Playground end-to-end sample	Not implemented

Documentation map

Guides (Starlight)

Cross-cutting concepts and project layout:

• Project setup — required vs recommended layout; #adl import alias; how tooling gets config.adl
• Runtime — adl runtime, ALS for workflow context
• Agents — adl.createAgent, memory, structured output
• Workflows — adl.createWorkflow, steps, keys, nesting
• Project config — registry, loadAdlProject

API reference (TypeDoc)

Generated from packages/core — includes JSDoc for focused APIs that are not duplicated as Starlight pages:

• Package overview — AI SDK compatibility summary
• MessageStore, WorkflowStore, RunEvent
• Template, createTemplate
• WorkflowObserver, AgentObserver

Use the Core API sidebar for the full export list.

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 — CoreMessage, streamText, tool() without parallel abstractions.
• Colocated prompts — markdown beside code; templates via createTemplate.
• Docs near code — smaller single-API surfaces documented in JSDoc; conceptual guides stay in Starlight.

Monorepo packages

Package	Role
@agent-dev-lab/core	Headless runtime
@agent-dev-lab/web	Inspection UI (port 3000)
@agent-dev-lab/cli	adl CLI
@agent-dev-lab/docs	This site (port 4321)
@agent-dev-lab/common	Drizzle + SQLite helpers, logging, ESLint
apps/playground	Framework dev project

Development

From the repo root:

bun install
bun run dev:docs   # this site on :4321
bun run dev:web    # inspection UI on :3000

Coding-agent tracking notes (v1 gaps, deferred design) live in the repo notes/ directory.