New skills (14): - nestjs-best-practices: 40 priority-ranked rules (kadajett) - fastapi: Pydantic v2, async SQLAlchemy, JWT auth (jezweb) - architecture-patterns: Clean Architecture, Hexagonal, DDD (wshobson) - python-performance-optimization: Profiling and optimization (wshobson) - ai-sdk: Vercel AI SDK streaming and agent patterns (vercel) - create-agent: Modular agent architecture with OpenRouter (openrouterteam) - proactive-agent: WAL Protocol, compaction recovery, self-improvement (halthelobster) - brand-guidelines: Brand identity enforcement (anthropics) - ui-animation: Motion design with accessibility (mblode) - marketing-ideas: 139 ideas across 14 categories (coreyhaines31) - pricing-strategy: SaaS pricing and tier design (coreyhaines31) - programmatic-seo: SEO at scale with playbooks (coreyhaines31) - competitor-alternatives: Comparison page architecture (coreyhaines31) - referral-program: Referral and affiliate programs (coreyhaines31) README reorganized by domain: Code Quality, Frontend, Backend, Auth, AI/Agent Building, Marketing, Design, Meta. Mosaic Stack is not limited to coding — the Orchestrator serves coding, business, design, marketing, writing, logistics, and analysis. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
53 lines
1.2 KiB
Markdown
53 lines
1.2 KiB
Markdown
---
|
|
title: AI SDK DevTools
|
|
description: Debug AI SDK calls by inspecting captured runs and steps.
|
|
---
|
|
|
|
# AI SDK DevTools
|
|
|
|
## Why Use DevTools
|
|
|
|
DevTools captures all AI SDK calls (`generateText`, `streamText`, `ToolLoopAgent`) to a local JSON file. This lets you inspect LLM requests, responses, tool calls, and multi-step interactions without manually logging.
|
|
|
|
## Setup
|
|
|
|
Requires AI SDK 6. Install `@ai-sdk/devtools` using your project's package manager.
|
|
|
|
Wrap your model with the middleware:
|
|
|
|
```ts
|
|
import { wrapLanguageModel, gateway } from 'ai';
|
|
import { devToolsMiddleware } from '@ai-sdk/devtools';
|
|
|
|
const model = wrapLanguageModel({
|
|
model: gateway('anthropic/claude-sonnet-4.5'),
|
|
middleware: devToolsMiddleware(),
|
|
});
|
|
```
|
|
|
|
## Viewing Captured Data
|
|
|
|
All runs and steps are saved to:
|
|
|
|
```
|
|
.devtools/generations.json
|
|
```
|
|
|
|
Read this file directly to inspect captured data:
|
|
|
|
```bash
|
|
cat .devtools/generations.json | jq
|
|
```
|
|
|
|
Or launch the web UI:
|
|
|
|
```bash
|
|
npx @ai-sdk/devtools
|
|
# Open http://localhost:4983
|
|
```
|
|
|
|
## Data Structure
|
|
|
|
- **Run**: A complete multi-step interaction grouped by initial prompt
|
|
- **Step**: A single LLM call within a run (includes input, output, tool calls, token usage)
|