agent-inspect 3.0.0 → 3.2.0

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## 3.2.0
+
+### Minor Changes
+
+- 80f8f30: v3.2 framework adoption pack: AI SDK and OpenAI Agents local-only guides, NestJS harness path, Mastra RFC (deferred), adapter conformance evidence refresh.
+
+## 3.1.0
+
+### Minor Changes
+
+- 70f3fb2: v3.1 adoption train: public `@agent-inspect/harness`, `agent-inspect init` and `doctor` commands, adoption starters, and onboarding docs.
+
+## Unreleased
+
+Post-v3 adoption train (v3.1 → v3.5) in progress. See [docs/implementation/ROADMAP-V3.0-TO-V3.5.md](docs/implementation/ROADMAP-V3.0-TO-V3.5.md).
+
+### v3.1 (in progress)
+
+- `agent-inspect init` and `agent-inspect doctor` CLI commands
+- Public `@agent-inspect/harness` (first publish pending)
+- Adoption starters under `examples/starters/`
+
 ## 3.0.0
 
 ### Major Changes

package/README.md

@@ -22,7 +22,17 @@ agent-inspect gives those runs **structure**: an **execution tree** you can read
 
 ## Install
 
-Current npm release line: **2.4.0** for the linked public packages (`agent-inspect`, adapters, reporters, redact, eval, mcp). **v2.4.0** adds multi-run **session** navigation (`sessions` / `session` CLI), session-aware `search` and `check`, and optional **`@agent-inspect/mcp`** client telemetry.
+Current npm release line: **3.1.0** for the linked public packages (`agent-inspect`, adapters, reporters, redact, eval, mcp, guardrails, circuit, viewer, mcp-server, adapter-sdk, harness). **v3.0.0** adds extension contracts and **`@agent-inspect/adapter-sdk`** for third-party adapter authoring; persisted trace schema remains **1.0**.
+
+**v3.1 adoption path (in progress):**
+
+1. `npx agent-inspect init` — local config + demo (no auto-install)
+2. `observe()` or a framework adapter
+3. `@agent-inspect/harness` for real project runners
+4. `npx agent-inspect doctor` when setup fails
+5. `check` / `eval` / `redact` / `report` for CI and safe sharing
+
+See [examples/starters/](examples/starters/README.md) and [docs/GETTING-STARTED.md](docs/GETTING-STARTED.md).
 
 ```bash
 npm install agent-inspect

package/docs/ADAPTER-CONFORMANCE.md

@@ -57,3 +57,10 @@ This is an internal official-adapter gate, not a third-party certification progr
 ## Before claiming support
 
 An adapter can be documented as supported only after no-network fixtures cover run, step, tool, LLM, error, streaming, and metadata-bound expectations for that framework path.
+
+## v3.2 adoption evidence refresh
+
+- [AI-SDK-ADOPTION.md](./AI-SDK-ADOPTION.md) — blessed AI SDK path (`generateText`, `streamText`, Next.js recipe, troubleshooting)
+- [OPENAI-AGENTS-LOCAL.md](./OPENAI-AGENTS-LOCAL.md) — additional vs replacement processor modes
+- [NESTJS.md](./NESTJS.md) — harness bootstrap path (no `@agent-inspect/nestjs` package in v3.2)
+- [proposals/MASTRA-ADAPTER-RFC.md](./proposals/MASTRA-ADAPTER-RFC.md) — deferred pending demand gates

package/docs/ADAPTERS.md

@@ -18,6 +18,8 @@ Reporters (`@agent-inspect/vitest` and `@agent-inspect/jest`) are public package
 
 ## Vercel AI SDK (`@agent-inspect/ai-sdk`)
 
+**Full guide:** [AI-SDK-ADOPTION.md](./AI-SDK-ADOPTION.md)
+
 **Status:** experimental adapter — optional package published in the aligned v2.2.0 package set and hardened in the v2.3 adapter train.
 
 The adapter has hardened lifecycle identity and parallel integration isolation. It remains metadata-only: `capture: "preview"` and preview-only redaction options emit diagnostics and fall back to metadata-only capture until bounded free-text previews are implemented.
@@ -344,6 +346,8 @@ Full API: [API.md](./API.md) §13.
 
 ## OpenAI Agents JS (`@agent-inspect/openai-agents`)
 
+**Local-only guide:** [OPENAI-AGENTS-LOCAL.md](./OPENAI-AGENTS-LOCAL.md)
+
 **Status:** experimental adapter — optional package published in the aligned v2.2.0 package set.
 
 The safe integration boundary is documented in [OPENAI-AGENTS-JS-TRACING.md](./proposals/OPENAI-AGENTS-JS-TRACING.md). Install the AgentInspect processor by replacing processors:

package/docs/CLI.md

@@ -27,6 +27,8 @@ Core commands:
 - `export` — export manual traces to Markdown/HTML/OpenInference/OTLP JSON (local only)
 - `open` — read supported local trace files, directories, or stdin through the canonical reader pipeline
 - `migrate` — convert one local AgentInspect JSONL file to schema 1.0 with dry-run or explicit output
+- `init` — scaffold local AgentInspect config and demo files (v3.1+)
+- `doctor` — diagnose local setup without network or installs (v3.1+)
 - `check` — run deterministic local trace checks with stable JSON and exit codes
 - `eval` — run deterministic local evals over existing traces
 - `redact` — redact a local JSON/JSONL file or trace copy

package/docs/GETTING-STARTED.md

@@ -10,6 +10,25 @@ AgentInspect is a **local-first execution-tree debugger** for TypeScript AI agen
 pnpm add agent-inspect
 ```
 
+### Quick bootstrap (v3.1+)
+
+```bash
+npx agent-inspect init
+npx agent-inspect doctor
+```
+
+`init` writes `agent-inspect.config.ts`, `.agent-inspect/`, and a deterministic demo — **without installing dependencies**. `doctor` checks Node, trace directory permissions, and optional adapter packages (no network).
+
+Framework-specific init:
+
+```bash
+npx agent-inspect init --framework ai-sdk
+npx agent-inspect init --framework openai-agents
+npx agent-inspect init --framework langchain
+```
+
+Blessed starters: [examples/starters/](../examples/starters/README.md)
+
 The `agent-inspect` package includes the CLI binary via its `bin` field:
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-inspect",
-  "version": "3.0.0",
+  "version": "3.2.0",
   "license": "MIT",
   "type": "module",
   "description": "Local-first execution-tree debugger for TypeScript AI agents",