@agenttracehq/sdk

Official Node.js SDK for AgentTraceHQ — Audit Trail for AI Agents.

Installation

npm install @agenttracehq/sdk

Quick Start

const { AgentTraceHQ } = require('@agenttracehq/sdk');

const tracer = new AgentTraceHQ({
  apiKey: 'athq_live_...',
  agentId: 'my-agent-001',
});

await tracer.trace({
  action: 'tool_call',
  input: { query: 'What is the weather?' },
  output: { result: 'Sunny, 72F' },
  toolsUsed: ['weather_api'],
});

await tracer.flush();

Session Tracing

const session = tracer.session();
await session.trace({ action: 'user_input', input: { message: 'Hello' } });
await session.trace({ action: 'response', output: { message: 'Hi there!' } });
await session.end();

LangChain Integration

const handler = tracer.langchainHandler();
// Pass as callback to any LangChain component
const llm = new ChatOpenAI({ callbacks: [handler] });

API Reference

new AgentTraceHQ(options)

• apiKey (string, required) — Your API key
• agentId (string, required) — Default agent identifier
• baseUrl (string) — API URL (default: https://agenttracehq.com/api/v1)
• batchSize (number) — Traces per batch (default: 10)
• flushIntervalMs (number) — Auto-flush interval (default: 1000ms)

tracer.trace(data) — Send a trace

tracer.session([id]) — Create a grouped session

tracer.langchainHandler() — Get LangChain callback handler

tracer.flush() — Flush pending traces

tracer.shutdown() — Flush and stop the SDK