agent-inspect 2.6.0 → 3.0.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 3.0.0
+
+### Major Changes
+
+- a1f743f: v3.0 extension contracts: `@agent-inspect/adapter-sdk` with registration, conformance, privacy helpers, transform/renderer contracts, optional rebuildable indexer, and community extension registry documentation. Linked major semver bump; persisted trace schema 1.0 unchanged.
+
 ## 2.6.0
 
 ### Minor Changes

package/docs/MIGRATION.md

@@ -65,3 +65,27 @@ Nothing uploads by default. Manual metadata is redacted before disk by default,
 - Root/core does not require optional adapter dependencies.
 - Optional adapter APIs are experimental and package-scoped.
 - No destructive migration is required for existing trace directories.
+
+## Upgrading from 2.x to 3.0
+
+v3.0 is a **linked npm major** for the public package family. **Persisted trace schema remains 1.0** — existing `.jsonl` files do not need rewriting.
+
+### What changes
+
+- New optional package [`@agent-inspect/adapter-sdk`](https://www.npmjs.com/package/@agent-inspect/adapter-sdk) for third-party adapter authoring (registration, conformance, privacy checklist, transform/renderer/indexer contracts).
+- Community extension process documented in [COMMUNITY-EXTENSION-REGISTRY.md](./COMMUNITY-EXTENSION-REGISTRY.md).
+- Extension interfaces are versioned in `@agent-inspect/adapter-sdk@3.x`; breaking extension API changes ship there, not in silent root patches.
+
+### What stays the same
+
+- Root imports (`inspectRun`, `step`, `observe`, `createInspector`, etc.) and subpath layout from v2.
+- Local-first capture, metadata-only adapter defaults, and explicit migration via `agent-inspect migrate` for schema upgrades.
+- Optional packages (`viewer`, `mcp-server`, adapters, reporters) remain opt-in peer dependencies.
+
+### Upgrade steps
+
+1. Bump linked dependencies together, e.g. `agent-inspect@^3.0.0` and matching `@agent-inspect/*` versions.
+2. Re-run your trace/check CI after bump; no trace file migration is required for 2.6 → 3.0.
+3. For new third-party adapters, use `@agent-inspect/adapter-sdk` and follow the community registry checklist.
+
+See [V3-EXTENSION-CONTRACTS.md](./proposals/V3-EXTENSION-CONTRACTS.md) and [V3.0.0-RELEASE-READINESS.md](./implementation/release-trains/V3.0.0-RELEASE-READINESS.md).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-inspect",
-  "version": "2.6.0",
+  "version": "3.0.0",
   "license": "MIT",
   "type": "module",
   "description": "Local-first execution-tree debugger for TypeScript AI agents",
@@ -178,7 +178,7 @@
   },
   "scripts": {
     "clean": "pnpm -r exec -- rm -rf dist",
-    "build": "pnpm exec tsup --config tsup.core.config.ts && pnpm exec tsup --config tsup.cli.config.ts && pnpm exec tsup --config tsup.langchain.config.ts && pnpm exec tsup --config tsup.tui.config.ts && pnpm exec tsup --config tsup.ai-sdk.config.ts && pnpm exec tsup --config tsup.vitest.config.ts && pnpm exec tsup --config tsup.jest.config.ts && pnpm exec tsup --config tsup.openai-agents.config.ts && pnpm exec tsup --config tsup.harness.config.ts && pnpm exec tsup --config tsup.redact.config.ts && pnpm exec tsup --config tsup.eval.config.ts && pnpm exec tsup --config tsup.mcp.config.ts && pnpm exec tsup --config tsup.guardrails.config.ts && pnpm exec tsup --config tsup.circuit.config.ts && pnpm exec tsup --config tsup.viewer.config.ts && pnpm exec tsup --config tsup.mcp-server.config.ts",
+    "build": "pnpm exec tsup --config tsup.core.config.ts && pnpm exec tsup --config tsup.cli.config.ts && pnpm exec tsup --config tsup.langchain.config.ts && pnpm exec tsup --config tsup.tui.config.ts && pnpm exec tsup --config tsup.ai-sdk.config.ts && pnpm exec tsup --config tsup.vitest.config.ts && pnpm exec tsup --config tsup.jest.config.ts && pnpm exec tsup --config tsup.openai-agents.config.ts && pnpm exec tsup --config tsup.harness.config.ts && pnpm exec tsup --config tsup.redact.config.ts && pnpm exec tsup --config tsup.eval.config.ts && pnpm exec tsup --config tsup.mcp.config.ts && pnpm exec tsup --config tsup.guardrails.config.ts && pnpm exec tsup --config tsup.circuit.config.ts && pnpm exec tsup --config tsup.viewer.config.ts && pnpm exec tsup --config tsup.mcp-server.config.ts && pnpm exec tsup --config tsup.adapter-sdk.config.ts",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
     "test:watch": "vitest",

package/packages/cli/dist/index.cjs

@@ -24,7 +24,7 @@ var process2__default = /*#__PURE__*/_interopDefault(process2);
 var tty__default = /*#__PURE__*/_interopDefault(tty);
 
 // package.json
-var version = "2.6.0";
+var version = "3.0.0";
 
 // packages/core/src/correlation-metadata.ts
 var TRACE_CORRELATION_KEYS = [