agent-inspect 3.3.0 → 3.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (14) hide show
  1. package/CHANGELOG.md +12 -0
  2. package/README.md +7 -8
  3. package/docs/COMPARE.md +13 -0
  4. package/package.json +1 -1
  5. package/packages/cli/dist/index.cjs +435 -70
  6. package/packages/cli/dist/index.cjs.map +1 -1
  7. package/packages/cli/dist/index.mjs +436 -71
  8. package/packages/cli/dist/index.mjs.map +1 -1
  9. package/packages/core/dist/checks.cjs +105 -0
  10. package/packages/core/dist/checks.cjs.map +1 -1
  11. package/packages/core/dist/checks.d.cts +26 -1
  12. package/packages/core/dist/checks.d.ts +26 -1
  13. package/packages/core/dist/checks.mjs +103 -1
  14. package/packages/core/dist/checks.mjs.map +1 -1
package/CHANGELOG.md CHANGED
@@ -1,5 +1,17 @@
1
1
  # Changelog
2
2
 
3
+ ## 3.5.0
4
+
5
+ ### Minor Changes
6
+
7
+ - 71e94de: v3.5 adoption kit: ADOPTION guide, demo scripts, design partner kit, starter polish, comparison refresh, post-v3.5 handoff.
8
+
9
+ ## 3.4.0
10
+
11
+ ### Minor Changes
12
+
13
+ - 2fef104: v3.4 performance hardening: scale warnings, optional index CLI, stall/timeout check rules, performance and streaming docs.
14
+
3
15
  ## 3.3.0
4
16
 
5
17
  ### Minor Changes
package/README.md CHANGED
@@ -22,17 +22,16 @@ agent-inspect gives those runs **structure**: an **execution tree** you can read
22
22
 
23
23
  ## Install
24
24
 
25
- Current npm release line: **3.2.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**.
25
+ Current npm release line: **3.4.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**.
26
26
 
27
- **v3.1 adoption path (in progress):**
27
+ **v3 adoption path (3.1–3.5):**
28
28
 
29
- 1. `npx agent-inspect init` — local config + demo (no auto-install)
30
- 2. `observe()` or a framework adapter
31
- 3. `@agent-inspect/harness` for real project runners
29
+ 1. [ADOPTION.md](docs/ADOPTION.md) — blessed onboarding guide
30
+ 2. `npx agent-inspect init` + [examples/starters/](examples/starters/README.md)
31
+ 3. Framework guides: [AI SDK](docs/AI-SDK-ADOPTION.md), [OpenAI Agents](docs/OPENAI-AGENTS-LOCAL.md), [NestJS](docs/NESTJS.md)
32
32
  4. `npx agent-inspect doctor` when setup fails
33
- 5. `check` / `eval` / `redact` / `report` for CI and safe sharing
34
-
35
- See [examples/starters/](examples/starters/README.md) and [docs/GETTING-STARTED.md](docs/GETTING-STARTED.md).
33
+ 5. `check` / `eval` / `redact` / `report` for CI — [PERFORMANCE.md](docs/PERFORMANCE.md) at scale
34
+ 6. VS Code extension: develop from `packages/vscode` ([VSCODE.md](docs/VSCODE.md); Marketplace publish is manual)
36
35
 
37
36
  ```bash
38
37
  npm install agent-inspect
package/docs/COMPARE.md CHANGED
@@ -63,8 +63,21 @@ AgentInspect avoids SDK/collector setup for local debugging:
63
63
  | No-account CLI tracing | Strong fit |
64
64
  | Deterministic local eval heuristics | Good fit |
65
65
  | Share-safe local redaction copy | Good fit |
66
+ | VS Code trace sidebar (in-repo / dev host) | Good fit — Marketplace listing separate |
66
67
  | Production dashboards | Not the goal |
67
68
  | Hosted eval datasets | Not the goal |
68
69
  | Prompt management | Not the goal |
69
70
  | Standards-aligned local export | Partial (compatibility-oriented) |
70
71
  | Full observability platform | Use a dedicated platform |
72
+
73
+ ## v3.5 positioning (local inner loop)
74
+
75
+ AgentInspect v3.5 is the **adoption release** — not new runtime surface. Use it when:
76
+
77
+ - You want **traces on disk** before/alongside hosted tools
78
+ - You need **CI gates** (`check`, `eval`, `circuit`) without a vendor account
79
+ - You want **metadata-only** defaults and explicit `redact` before sharing
80
+
81
+ Keep using LangSmith, Langfuse, Braintrust, Phoenix, or OTel when you need hosted retention, fleet dashboards, dataset management, or org-wide production pipelines. AgentInspect is complementary.
82
+
83
+ **Full adoption path:** [ADOPTION.md](./ADOPTION.md)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "agent-inspect",
3
- "version": "3.3.0",
3
+ "version": "3.5.0",
4
4
  "license": "MIT",
5
5
  "type": "module",
6
6
  "description": "Local-first execution-tree debugger for TypeScript AI agents",