agops-sdk

Lightweight observability wrapper for Anthropic and OpenAI Node.js SDKs. Part of Ag-Ops.

Your API key never leaves your machine. The SDK intercepts each request/response and ships the session log asynchronously — fire-and-forget. SDK errors never break your app.

Install

npm install agops-sdk

Quickstart

import { wrap, configure } from "agops-sdk";
import Anthropic from "@anthropic-ai/sdk";

configure({ token: "ag_...", project: "my-project" });
// or set AGOPS_TOKEN + AGOPS_PROJECT env vars

const client = wrap(new Anthropic());

// Works exactly like the original client
const response = await client.messages.create({
  model: "claude-sonnet-4-20250514",
  messages: [{ role: "user", content: "Hello" }],
});

// Streaming works too
const stream = client.messages.stream({
  /* ... */
});
for await (const event of stream) {
  /* ... */
}

OpenAI works the same way:

import { wrap } from "agops-sdk";
import OpenAI from "openai";

const client = wrap(new OpenAI());
const response = await client.chat.completions.create({
  /* ... */
});

What gets shipped

Each call ships a session payload containing: model, messages (user + assistant + tool), token counts, duration, timestamps, and errors. The full transcript appears in the Ag-Ops dashboard within seconds.

Delivery reliability

Failed shipments retry with exponential backoff (3 attempts: 1s, 2s, 4s). On repeated failure, sessions queue to disk at ~/.agops/queue/ and drain on the next successful call.

Configuration

| Env var | Purpose | | ---------------- | ------------------------------------------------------- | | AGOPS_TOKEN | Ag-Ops API token (get one from the dashboard). | | AGOPS_PROJECT | Project slug — optional, shown in the dashboard feed. | | AGOPS_ENDPOINT | Override the backend endpoint (default: hosted Ag-Ops). |

License

MIT