{
  "id": 3311939,
  "title": "I built agent-inspect to debug TypeScript AI agent trajectories",
  "url": "https://urgent.news/2026/08/25/i-built-agent-inspect-to-debug-typescript-ai-agent-trajectories",
  "topic": "ai",
  "section": "AI",
  "published": "2026-08-25T17:12:09.000Z",
  "source": {
    "name": "Dev.to",
    "slug": "dev-to",
    "url": "https://dev.to/raju_dandigam/i-built-agent-inspect-to-debug-typescript-ai-agent-trajectories-2jg6"
  },
  "original_language": "en",
  "account": "I built agent-inspect to debug TypeScript AI agent trajectories. When an AI agent fails, the logs often appear fine, but the tool calls, model calls, fallback usage, and timeouts can be difficult to pinpoint. AgentInspect addresses this issue by transforming a local trace into three valuable outputs: a readable execution tree, a deterministic regression gate, and an Evidence v2 bundle for review. The tool provides a readable execution tree, a deterministic regression gate for testing, and an Evidence v2 bundle for sharing. It focuses on metadata by default, with no accounts, collectors, or default uploads. The debugging process involves generating a synthetic demo, initializing the agent-inspect tool, and using it to view, report, explain, and analyze the run. This approach restores the structure lost in flat logs, showing nested steps, tool and model calls, durations, metadata, errors, and observed outcomes.",
  "summary": "Your AI agent failed. Again. The final answer is wrong, but the logs look fine: tool call started model call started tool call completed model call completed fallback used error: timeout Which tool caused the timeout? Did the model answer before retrieval finished? Was the fallback expected? Did the agent call the same tool twice? This is where console.log stops feeling like debugging and starts…",
  "key_points": [
    "AgentInspect tool created to debug TypeScript AI agent trajectories",
    "Generates readable execution tree, deterministic regression gate, Evidence v2 bundle",
    "Focuses on metadata, no default uploads, restores nested step structure"
  ],
  "editors_take": null,
  "illustration": null,
  "coverage": {
    "outlets": 1,
    "also_reported_by": []
  },
  "ai_generated": true,
  "disclaimer": "Summaries, key points and the editor’s take are written by software from other outlets’ reporting and may contain errors — always check the linked original."
}