agent-inspect 2.0.0 → 2.2.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 +24 -0
- package/README.md +27 -4
- package/docs/ADAPTERS.md +4 -0
- package/docs/API.md +75 -10
- package/docs/CLI.md +124 -9
- package/docs/COMPARE.md +5 -4
- package/docs/GETTING-STARTED.md +24 -6
- package/docs/KNOWN-ISSUES.md +7 -0
- package/docs/LIMITATIONS.md +3 -1
- package/package.json +12 -2
- package/packages/cli/dist/index.cjs +2040 -142
- package/packages/cli/dist/index.cjs.map +1 -1
- package/packages/cli/dist/index.mjs +2039 -141
- package/packages/cli/dist/index.mjs.map +1 -1
- package/packages/core/dist/reporters.cjs +185 -0
- package/packages/core/dist/reporters.cjs.map +1 -0
- package/packages/core/dist/reporters.d.cts +91 -0
- package/packages/core/dist/reporters.d.ts +91 -0
- package/packages/core/dist/reporters.mjs +175 -0
- package/packages/core/dist/reporters.mjs.map +1 -0
package/docs/LIMITATIONS.md
CHANGED
|
@@ -50,6 +50,7 @@ This document states what AgentInspect **does not** provide today. It complement
|
|
|
50
50
|
## Trace safety bounds
|
|
51
51
|
|
|
52
52
|
- **Redaction profiles** (`local`, `share`, `strict`) are key-based presets — not compliance-grade PII detection. Review exports before sharing even with `--redaction-profile strict`.
|
|
53
|
+
- **`@agent-inspect/redact` and `agent-inspect redact` create redacted copies.** They do not encrypt source traces, mutate originals, certify compliance, or guarantee every sensitive value is detected.
|
|
53
54
|
- **Default metadata redaction** covers common sensitive keys only (exact key match, case-insensitive). Custom secret field names are not redacted unless you add rules via `redact: { rules: [...] }`.
|
|
54
55
|
- **Metadata truncation** applies to string values and nested structures; very large metadata may be replaced with a truncation marker when `maxEventBytes` is exceeded (default 64 KiB per JSONL line).
|
|
55
56
|
- **Redaction is not encryption.** Local trace files remain readable on disk; treat `.agent-inspect-runs/` like any developer artifact that may contain operational data.
|
|
@@ -57,6 +58,7 @@ This document states what AgentInspect **does not** provide today. It complement
|
|
|
57
58
|
## Checks, artifacts, and test reporters
|
|
58
59
|
|
|
59
60
|
- **Checks are deterministic local rules, not compliance certification.** `check`, `scan`, and `verify-safe` surface bounded findings and diagnostics over supported local inputs; they do not prove a trace is safe for every sharing context.
|
|
61
|
+
- **Eval is deterministic local heuristics.** `@agent-inspect/eval` and `agent-inspect eval` do not provide LLM-as-judge scoring, hosted datasets, replay, semantic grading, or production quality analytics.
|
|
60
62
|
- **Safe CI artifacts are structural summaries.** They avoid raw prompt/output/request/response/header/tool payload content by default, but teams should still review generated files before sharing.
|
|
61
63
|
- **Vitest/Jest reporters are optional package surfaces.** Recipes document config patterns and explicit associations; package publication is controlled by release readiness and maintainer authorization.
|
|
62
64
|
|
|
@@ -64,7 +66,7 @@ This document states what AgentInspect **does not** provide today. It complement
|
|
|
64
66
|
|
|
65
67
|
- **No replay / fork** of past runs from traces alone.
|
|
66
68
|
- **No time-travel debugging** across arbitrary runtime state.
|
|
67
|
-
- **No multi-run statistical evaluation** built into core.
|
|
69
|
+
- **No multi-run statistical evaluation** built into core. v2.1 eval checks are per selected trace/run unless user code aggregates results.
|
|
68
70
|
|
|
69
71
|
## Economics
|
|
70
72
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "agent-inspect",
|
|
3
|
-
"version": "2.
|
|
3
|
+
"version": "2.2.0",
|
|
4
4
|
"license": "MIT",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"description": "Local-first execution-tree debugger for TypeScript AI agents",
|
|
@@ -105,6 +105,16 @@
|
|
|
105
105
|
"types": "./packages/core/dist/checks.d.cts",
|
|
106
106
|
"default": "./packages/core/dist/checks.cjs"
|
|
107
107
|
}
|
|
108
|
+
},
|
|
109
|
+
"./reporters": {
|
|
110
|
+
"import": {
|
|
111
|
+
"types": "./packages/core/dist/reporters.d.ts",
|
|
112
|
+
"default": "./packages/core/dist/reporters.mjs"
|
|
113
|
+
},
|
|
114
|
+
"require": {
|
|
115
|
+
"types": "./packages/core/dist/reporters.d.cts",
|
|
116
|
+
"default": "./packages/core/dist/reporters.cjs"
|
|
117
|
+
}
|
|
108
118
|
}
|
|
109
119
|
},
|
|
110
120
|
"bin": {
|
|
@@ -168,7 +178,7 @@
|
|
|
168
178
|
},
|
|
169
179
|
"scripts": {
|
|
170
180
|
"clean": "pnpm -r exec -- rm -rf dist",
|
|
171
|
-
"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",
|
|
181
|
+
"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",
|
|
172
182
|
"typecheck": "tsc --noEmit",
|
|
173
183
|
"test": "vitest run",
|
|
174
184
|
"test:watch": "vitest",
|