@agentwatch/sdk

The reliability layer for AI agents — monitor, trace, and detect failures in production.

Install

npm install @agentwatch/sdk

Quick Start

import { AgentWatch } from '@agentwatch/sdk'

const aw = new AgentWatch({
  apiKey: 'aw_live_...',   // from dashboard
  projectId: 'proj_...',
})

// Trace an agent run
await aw.trace('my-agent', async (trace) => {
  trace.addSpan({ name: 'llm-call', input: prompt })
  const result = await callLLM(prompt)
  trace.addSpan({ name: 'llm-response', output: result })
  return result
})

Auto-Instrument LLM Calls

OpenAI

import { wrapOpenAI } from '@agentwatch/sdk/openai'
import OpenAI from 'openai'

const openai = wrapOpenAI(new OpenAI(), aw)
// All chat.completions.create() calls are now auto-traced

Anthropic

import { wrapAnthropic } from '@agentwatch/sdk/anthropic'
import Anthropic from '@anthropic-ai/sdk'

const anthropic = wrapAnthropic(new Anthropic(), aw)
// All messages.create() calls are now auto-traced

Manual Tracing

const trace = aw.startTrace('agent-name', { userId: 'u_123' })

// ... do work ...

await aw.endTrace(trace, {
  output: result,
  status: 'SUCCESS',  // or 'ERROR'
})

Dashboard

View traces, costs, and anomalies at agentwatch.dev

License

MIT