@agent-inspect/openai-agents

OpenAI Agents JS tracing processor → local AgentInspect traces.

Support level: Supported — see SUPPORT-LEVELS.md.

When to use

• You run agents with @openai/agents
• You want local-only traces (no default OpenAI trace export)

When not to use

• Replacing OpenAI's hosted tracing when you still need their dashboard
• Non–OpenAI Agents frameworks

Install

npm install agent-inspect @agent-inspect/openai-agents @openai/agents

Peer: @openai/agents@^0.12.0

Example

import { Agent, run, setTraceProcessors } from "@openai/agents";
import { agentInspectOpenAiAgents } from "@agent-inspect/openai-agents";

setTraceProcessors([
  agentInspectOpenAiAgents({ traceDir: ".agent-inspect" }),
]);

const agent = new Agent({ name: "demo", tools: [] });
await run(agent, "hello");

Use setTraceProcessors replacement for local-only mode. Avoid addTraceProcessor() if you need to disable default exporters.

Privacy

• Local JSONL files only
• AgentInspect does not upload traces to OpenAI
• Metadata-only by default

API

| Export | Purpose | | ------ | ------- | | agentInspectOpenAiAgents(options) | TracingProcessor for local persistence | | getDiagnostics() | Warnings for misconfiguration |

CLI

npx agent-inspect list · sessions · report

Docs

• OpenAI Agents local guide
• Starter

Troubleshooting

• Duplicate export: Using addTraceProcessor keeps SDK default exporter — use replacement mode for local-only
• Handoffs/sessions: Mapped to run metadata; see docs for session IDs

Version

Part of the fixed AgentInspect release line. See the npm badge / package manifest for the current version.

License

MIT