# AgentInspect

> Local-first evidence for TypeScript AI agents

AgentInspect turns TypeScript agent runs into readable execution trees, deterministic trajectory checks, and portable Evidence v2—without requiring an account, collector, or default upload.

- Category: Local-first evidence for TypeScript AI agents
- Outcome: Capture once. Debug, prevent, and share from the same local trace.
- Status: Current release: 6.19.0 · schema 1.0 · Node.js 20+ · MIT · actively maintained
- Site: https://agentinspect.vercel.app
- Docs: https://agentinspect.vercel.app/docs/
- GitHub: https://github.com/rajudandigam/agent-inspect
- npm: https://www.npmjs.com/package/agent-inspect
- Machine facts: https://agentinspect.vercel.app/ai/product.json
- Skill: https://github.com/rajudandigam/agent-inspect/blob/main/.agents/skills/agent-inspect/SKILL.md

## When to use

- Debug a TypeScript AI agent run from local JSONL evidence
- Regression-test trajectories with TraceFacts / TraceContract (no LLM judge)
- Produce integrity-verifiable Evidence v2 for a PR or incident
- Let a coding assistant inspect the same local facts over read-only MCP

## When not to use

- Hosted multi-tenant APM / maintainer dashboard
- LLM-as-judge eval hosting as the primary product
- Compliance certification from the library itself

## Three jobs

1. **Debug** — Read nested steps, tools, model metadata, and the first causal failure from local JSONL.
2. **Prevent** — Deterministic check presets, TraceContract, suites, and CI gates.
3. **Share** — Share-checked Evidence v2 with integrity verification (not compliance certification).

Optional Preview: read-only MCP over the same local facts.

## Packages

- `agent-inspect` — core + CLI
- `@agent-inspect/langchain` — LangChain / LangGraph
- `@agent-inspect/ai-sdk` — Vercel AI SDK
- `@agent-inspect/openai-agents` — OpenAI Agents JS
- `@agent-inspect/vitest` / `@agent-inspect/jest` — reporters + experimental matchers
- `@agent-inspect/mcp-server` — read-only MCP (`get_trace_facts`)
- `@agent-inspect/redact` — deterministic redaction

## Key docs

- https://agentinspect.vercel.app/docs/getting-started
- https://agentinspect.vercel.app/docs/trace-facts
- https://agentinspect.vercel.app/docs/trace-contracts
- https://agentinspect.vercel.app/docs/evidence-v2
- https://agentinspect.vercel.app/docs/coding-agent-loop
- https://agentinspect.vercel.app/docs/integrations/langgraph
- https://github.com/rajudandigam/agent-inspect/blob/main/docs/WHY-AGENTINSPECT.md
- https://github.com/rajudandigam/agent-inspect/blob/main/docs/DECISION-GUIDE.md
- https://github.com/rajudandigam/agent-inspect/blob/main/docs/NO-EGRESS-POLICY.md

## Safety

No account · no collector · no default upload · metadata-only by default
Metadata-only by default. No hidden upload. Redaction is best-effort, not certification.
