agent-inspect 6.11.0 → 6.12.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.
- package/CHANGELOG.md +6 -0
- package/README.md +33 -15
- package/docs/ADOPTION.md +4 -0
- package/docs/COMPARE.md +22 -0
- package/docs/DEMO-SCRIPT.md +12 -0
- package/package.json +1 -1
- package/packages/cli/dist/index.cjs +1 -1
- package/packages/cli/dist/index.cjs.map +1 -1
- package/packages/cli/dist/index.mjs +1 -1
- package/packages/cli/dist/index.mjs.map +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,11 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 6.12.0
|
|
4
|
+
|
|
5
|
+
### Minor Changes
|
|
6
|
+
|
|
7
|
+
- 3ee1692: Consolidation and stable launch candidate: positioning/portfolio tiers, install kits, honest packed/native/MCP matrices, PARTIAL design-partner trial worksheets, package maintenance audit (keep fixed group through v6), comparison/interop handoff, and launch demo checklist. No schema break; no new packages; no default upload; trial results not fabricated.
|
|
8
|
+
|
|
3
9
|
## 6.11.0
|
|
4
10
|
|
|
5
11
|
### Minor Changes
|
package/README.md
CHANGED
|
@@ -8,18 +8,13 @@
|
|
|
8
8
|
<h1 align="center">agent-inspect</h1>
|
|
9
9
|
|
|
10
10
|
<p align="center">
|
|
11
|
-
<strong>
|
|
11
|
+
<strong>The local evidence debugger for TypeScript agents—faithful execution trees, deterministic regression checks, share-checked evidence, and coding-agent access without a collector or account.</strong>
|
|
12
12
|
</p>
|
|
13
13
|
|
|
14
14
|
<p align="center">
|
|
15
15
|
<sub>No account · no default upload · metadata-only by default · optional customer-owned Studio</sub>
|
|
16
16
|
</p>
|
|
17
17
|
|
|
18
|
-
<p align="center">
|
|
19
|
-
AgentInspect turns agent runs into <strong>customer-owned evidence</strong>: execution trees,
|
|
20
|
-
deterministic contracts, CI gates, verified-safe bundles, and optional self-hosted review.
|
|
21
|
-
</p>
|
|
22
|
-
|
|
23
18
|
<p align="center">
|
|
24
19
|
<a href="https://agentinspect.vercel.app/">Website</a> ·
|
|
25
20
|
<a href="https://agentinspect.vercel.app/docs/">Docs</a> ·
|
|
@@ -38,6 +33,16 @@
|
|
|
38
33
|
npm install agent-inspect
|
|
39
34
|
```
|
|
40
35
|
|
|
36
|
+
## Hero flow
|
|
37
|
+
|
|
38
|
+
```text
|
|
39
|
+
1. Capture one real run
|
|
40
|
+
2. Find the causal failure
|
|
41
|
+
3. Ask your coding agent to inspect it
|
|
42
|
+
4. Lock the fix with a contract
|
|
43
|
+
5. Attach the share-checked evidence
|
|
44
|
+
```
|
|
45
|
+
|
|
41
46
|
## Three workflows
|
|
42
47
|
|
|
43
48
|
| Workflow | What you do |
|
|
@@ -46,7 +51,9 @@ npm install agent-inspect
|
|
|
46
51
|
| **Prevent one regression** | TraceContract / `check` → suite / cohort → CI gate |
|
|
47
52
|
| **Share one safe artifact** | Redact → `verify-safe` → offline bundle → optional Studio review |
|
|
48
53
|
|
|
49
|
-
**
|
|
54
|
+
**Coding-agent loop (optional):** local read-only [`@agent-inspect/mcp-server`](https://www.npmjs.com/package/@agent-inspect/mcp-server) — see [CODING-AGENT-LOOP.md](https://github.com/rajudandigam/agent-inspect/blob/main/docs/CODING-AGENT-LOOP.md).
|
|
55
|
+
|
|
56
|
+
**Review as a team (optional):** workspace + optional SQLite index → customer-owned [Studio Beta](https://github.com/rajudandigam/agent-inspect/tree/main/packages/studio) (no AgentInspect-hosted cloud). Portfolio tiers: [POSITIONING-AND-PORTFOLIO.md](https://github.com/rajudandigam/agent-inspect/blob/main/docs/POSITIONING-AND-PORTFOLIO.md).
|
|
50
57
|
|
|
51
58
|
<p align="center">
|
|
52
59
|
<img src="https://raw.githubusercontent.com/rajudandigam/agent-inspect/main/docs/assets/readme-product-loop.svg?sanitize=true" alt="Capture or import → understand → enforce → verify and bundle → review locally or in customer-owned Studio" width="900">
|
|
@@ -131,7 +138,7 @@ Details: [Safe sharing](https://github.com/rajudandigam/agent-inspect/blob/main/
|
|
|
131
138
|
|
|
132
139
|
## Project status
|
|
133
140
|
|
|
134
|
-
**Current release:** **6.
|
|
141
|
+
**Current release:** **6.12.0** (eighteen linked npm packages). Technical launch candidate; external pilot evidence pending. Persisted schema **1.0**. Node.js **≥ 20**. **v7 not scheduled.**
|
|
135
142
|
|
|
136
143
|
[Roadmap](ROADMAP.md) · [Pilot kit](https://github.com/rajudandigam/agent-inspect/blob/main/docs/PRE-V7-PILOT-KIT.md) · [Changelog](CHANGELOG.md)
|
|
137
144
|
|
|
@@ -146,18 +153,29 @@ Details: [Safe sharing](https://github.com/rajudandigam/agent-inspect/blob/main/
|
|
|
146
153
|
See [Compare](https://github.com/rajudandigam/agent-inspect/blob/main/docs/COMPARE.md).
|
|
147
154
|
|
|
148
155
|
<details>
|
|
149
|
-
<summary><strong>Package family (18
|
|
156
|
+
<summary><strong>Package family (18 linked packages · tiered presentation)</strong></summary>
|
|
157
|
+
|
|
158
|
+
Canonical tiers: [POSITIONING-AND-PORTFOLIO.md](https://github.com/rajudandigam/agent-inspect/blob/main/docs/POSITIONING-AND-PORTFOLIO.md) · [SUPPORT-LEVELS.md](https://github.com/rajudandigam/agent-inspect/blob/main/docs/SUPPORT-LEVELS.md).
|
|
159
|
+
|
|
160
|
+
### Tier A — Flagship
|
|
161
|
+
|
|
162
|
+
| Package | Purpose |
|
|
163
|
+
| ------- | ------- |
|
|
164
|
+
| [`agent-inspect`](https://www.npmjs.com/package/agent-inspect) | Core APIs + CLI + evidence |
|
|
165
|
+
| [`@agent-inspect/redact`](https://www.npmjs.com/package/@agent-inspect/redact) | Deterministic redaction |
|
|
166
|
+
| [`@agent-inspect/mcp-server`](https://www.npmjs.com/package/@agent-inspect/mcp-server) | Read-only MCP coding-agent loop (Preview) |
|
|
167
|
+
|
|
168
|
+
### Tier B — Official integrations
|
|
150
169
|
|
|
151
170
|
### Framework adapters
|
|
152
171
|
|
|
153
172
|
| Package | Purpose |
|
|
154
173
|
| ------- | ------- |
|
|
155
|
-
| [`agent-inspect`](https://www.npmjs.com/package/agent-inspect) | Core APIs + CLI |
|
|
156
174
|
| [`@agent-inspect/ai-sdk`](https://www.npmjs.com/package/@agent-inspect/ai-sdk) | AI SDK telemetry |
|
|
157
175
|
| [`@agent-inspect/openai-agents`](https://www.npmjs.com/package/@agent-inspect/openai-agents) | OpenAI Agents processor |
|
|
158
176
|
| [`@agent-inspect/langchain`](https://www.npmjs.com/package/@agent-inspect/langchain) | LangChain callbacks |
|
|
159
177
|
|
|
160
|
-
### Testing / evaluation
|
|
178
|
+
### Tier B — Testing / evaluation
|
|
161
179
|
|
|
162
180
|
| Package | Purpose |
|
|
163
181
|
| ------- | ------- |
|
|
@@ -166,7 +184,7 @@ See [Compare](https://github.com/rajudandigam/agent-inspect/blob/main/docs/COMPA
|
|
|
166
184
|
| [`@agent-inspect/vitest`](https://www.npmjs.com/package/@agent-inspect/vitest) | Vitest reporter |
|
|
167
185
|
| [`@agent-inspect/jest`](https://www.npmjs.com/package/@agent-inspect/jest) | Jest reporter |
|
|
168
186
|
|
|
169
|
-
### Safety
|
|
187
|
+
### Tier C — Optional supporting (Safety)
|
|
170
188
|
|
|
171
189
|
| Package | Purpose |
|
|
172
190
|
| ------- | ------- |
|
|
@@ -174,7 +192,7 @@ See [Compare](https://github.com/rajudandigam/agent-inspect/blob/main/docs/COMPA
|
|
|
174
192
|
| [`@agent-inspect/guardrails`](https://www.npmjs.com/package/@agent-inspect/guardrails) | Deterministic guardrail rules |
|
|
175
193
|
| [`@agent-inspect/circuit`](https://www.npmjs.com/package/@agent-inspect/circuit) | Loop / retry / timeout analyzers |
|
|
176
194
|
|
|
177
|
-
### Developer surfaces
|
|
195
|
+
### Tier C — Optional supporting (Developer surfaces)
|
|
178
196
|
|
|
179
197
|
| Package | Purpose |
|
|
180
198
|
| ------- | ------- |
|
|
@@ -183,14 +201,14 @@ See [Compare](https://github.com/rajudandigam/agent-inspect/blob/main/docs/COMPA
|
|
|
183
201
|
| [`@agent-inspect/mcp`](https://www.npmjs.com/package/@agent-inspect/mcp) | MCP client tracing |
|
|
184
202
|
| [`@agent-inspect/mcp-server`](https://www.npmjs.com/package/@agent-inspect/mcp-server) | Read-only MCP server (Preview) |
|
|
185
203
|
|
|
186
|
-
### Team / self-hosted
|
|
204
|
+
### Tier C — Optional supporting (Team / self-hosted)
|
|
187
205
|
|
|
188
206
|
| Package | Purpose |
|
|
189
207
|
| ------- | ------- |
|
|
190
208
|
| [`@agent-inspect/index-sqlite`](https://www.npmjs.com/package/@agent-inspect/index-sqlite) | Optional SQLite index (Beta) |
|
|
191
209
|
| [`@agent-inspect/studio`](https://www.npmjs.com/package/@agent-inspect/studio) | Customer-owned Studio (Beta) |
|
|
192
210
|
|
|
193
|
-
### Extension / interop
|
|
211
|
+
### Tier C — Optional supporting (Extension / interop)
|
|
194
212
|
|
|
195
213
|
| Package | Purpose |
|
|
196
214
|
| ------- | ------- |
|
package/docs/ADOPTION.md
CHANGED
|
@@ -25,6 +25,10 @@ npx agent-inspect verify-safe <run-id> --dir .agent-inspect
|
|
|
25
25
|
|
|
26
26
|
No API keys required for the init demo. See [examples/starters/](../examples/starters/README.md).
|
|
27
27
|
|
|
28
|
+
## Install kits
|
|
29
|
+
|
|
30
|
+
Copyable task kits (LangGraph, portable evidence, AI SDK, OpenAI Agents, CI): [INSTALL-KITS.md](./INSTALL-KITS.md).
|
|
31
|
+
|
|
28
32
|
## Choose a starter
|
|
29
33
|
|
|
30
34
|
| Goal | Starter |
|
package/docs/COMPARE.md
CHANGED
|
@@ -4,6 +4,28 @@ AgentInspect is a local-first trace workbench for TypeScript AI agents: capture
|
|
|
4
4
|
|
|
5
5
|
**Docs site:** [https://agentinspect.vercel.app/docs/compare/](https://agentinspect.vercel.app/docs/compare/)
|
|
6
6
|
|
|
7
|
+
|
|
8
|
+
|
|
9
|
+
## Complementary handoff (v6.12)
|
|
10
|
+
|
|
11
|
+
Position AgentInspect as the **inner-loop local evidence** layer:
|
|
12
|
+
|
|
13
|
+
```text
|
|
14
|
+
local evidence and inner-loop debugging → AgentInspect
|
|
15
|
+
production observability → LangSmith / Langfuse / MLflow / Phoenix / APM
|
|
16
|
+
prompt/output and red-team eval → Promptfoo / Evalite / other eval tools
|
|
17
|
+
generic OTel trace access via MCP → OTel MCP servers
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
Handoff story:
|
|
21
|
+
|
|
22
|
+
```text
|
|
23
|
+
debug locally with AgentInspect
|
|
24
|
+
export OpenInference/OTLP when production tooling is needed
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
Portfolio presentation: [POSITIONING-AND-PORTFOLIO.md](./POSITIONING-AND-PORTFOLIO.md).
|
|
28
|
+
|
|
7
29
|
## Category comparison
|
|
8
30
|
|
|
9
31
|
| Dimension | AgentInspect | Hosted dashboards (LangSmith, Langfuse) | Eval platforms (Braintrust) | Production APM / OTel pipelines |
|
package/docs/DEMO-SCRIPT.md
CHANGED
|
@@ -86,3 +86,15 @@ See [FIRST-TRACE-IN-5-MINUTES.md](./FIRST-TRACE-IN-5-MINUTES.md).
|
|
|
86
86
|
- **Framework:** switch to `examples/starters/ai-sdk` for adapter path
|
|
87
87
|
|
|
88
88
|
Related: [VIDEO-WALKTHROUGH-SCRIPT.md](./VIDEO-WALKTHROUGH-SCRIPT.md) · [SCREENSHOTS.md](./SCREENSHOTS.md)
|
|
89
|
+
|
|
90
|
+
|
|
91
|
+
## Optional MCP beat (30s)
|
|
92
|
+
|
|
93
|
+
If time allows after inspect:
|
|
94
|
+
|
|
95
|
+
```bash
|
|
96
|
+
npx agent-inspect mcp configure --client cursor --dry-run
|
|
97
|
+
npx @agent-inspect/mcp-server --dir .agent-inspect --help
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
Point to [CODING-AGENT-LOOP.md](./CODING-AGENT-LOOP.md) and the coding-agent-debug-loop starter. Stay read-only; do not claim a live partner session unless one is on the call.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "agent-inspect",
|
|
3
|
-
"version": "6.
|
|
3
|
+
"version": "6.12.0",
|
|
4
4
|
"license": "MIT",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"description": "Debug, regression-test, and safely share TypeScript AI-agent behavior locally — no account, no default upload, metadata-only by default",
|
|
@@ -11889,7 +11889,7 @@ var init_src = __esm({
|
|
|
11889
11889
|
});
|
|
11890
11890
|
|
|
11891
11891
|
// package.json
|
|
11892
|
-
var version = "6.
|
|
11892
|
+
var version = "6.12.0";
|
|
11893
11893
|
|
|
11894
11894
|
// packages/cli/src/list.ts
|
|
11895
11895
|
init_advanced();
|