Skip to content

dev

const dev: object

console: (config?) => Middleware = devConsole

Full agent lifecycle terminal trace for development.

Creates a dev.console() middleware that prints the full agent lifecycle to stderr in a human-readable format.

Shows: session start/end, turns, model calls (model, tokens, cost, duration), tool executions (name, args, duration), guard results, and errors.

DevConsoleConfig

Optional configuration with custom formatter

Middleware

Middleware that prints lifecycle to terminal

agent.use(dev.console())
// Output:
// ┌ session s-abc123
// │ → turn #0
// │ │ → model.call sonnet tokens: 150→85 $0.003 847ms
// │ │ → tool.exec search 234ms
// │ │ → model.call sonnet tokens: 320→120 $0.005 612ms
// │ → turn #0 done $0.008 1693ms
// └ session done $0.008 1 turn