@raindrop-ai/openai-agents

Raindrop integration for the OpenAI Agents SDK. Implements a TracingProcessor that captures agent runs, LLM generations, tool calls, and handoffs.

Installation

npm install @raindrop-ai/openai-agents @openai/agents

Usage

import { createRaindropOpenAIAgents } from "@raindrop-ai/openai-agents";
import { Agent, run, addTraceProcessor } from "@openai/agents";

const raindrop = createRaindropOpenAIAgents({
  writeKey: "rk_...",
  userId: "user-123",
});

addTraceProcessor(raindrop.processor);

const agent = new Agent({
  name: "Assistant",
  model: "gpt-4o",
  instructions: "Be helpful",
});

const result = await run(agent, "Hello!");
console.log(result.finalOutput);

await raindrop.flush();

What gets captured

• Agent runs: trace-level events with workflow name
• LLM generations: model, input messages, output, token usage
• Tool calls: function name, input, output
• Handoffs: from/to agent names
• Errors: captured with error status on spans

All spans are linked with parent-child relationships for full trace visibility.

Options

| Option | Type | Default | Description | |--------|------|---------|-------------| | writeKey | string | - | Raindrop API write key (omit to disable telemetry) | | endpoint | string | https://api.raindrop.ai/v1/ | API endpoint | | userId | string | - | Associate all events with a user | | convoId | string | - | Group events into a conversation | | debug | boolean | false | Enable verbose logging |

Testing

pnpm test

Tests use MSW to intercept HTTP requests — no real OpenAI calls are made.