TypeScript SDK

npm install retrace

import { configure } from "retrace";

configure({
  apiKey: "rt_live_...",
  baseUrl: "https://api.retrace.yashbogam.me",
  projectId: "my-project",
});

import { record } from "retrace";

const recorder = record({ name: "my-agent" });
recorder.start();

// ... your agent logic ...

recorder.end(result);

import { trace } from "retrace";

const myAgent = trace(async (prompt: string) => {
  const response = await ai.models.generateContent({
    model: "gemini-3.1-pro-preview",
    messages: [{ role: "user", content: prompt }],
  });
  return response.choices[0].message.content;
}, { name: "my-agent" });

const result = await myAgent("hello");

import { record, SpanType } from "retrace";

const recorder = record({ name: "agent" });
recorder.start();

const span = recorder.startSpan("web_search", SpanType.TOOL_CALL, { query: "test" });
const results = await search("test");
recorder.endSpan(span, results);

recorder.end();

import { installGeminiInterceptor } from "retrace";

installGeminiInterceptor((span) => recorder.addSpan(span));

configure({ apiKey: "rt_live_...", transport: "http" });

const recorder = record({
  name: "agent",
  metadata: { environment: "production", version: "2.1.0" },
  tags: ["customer-facing", "high-priority"],
});

process.env.RETRACE_ENABLED = "false";

configure({ apiKey: "rt_live_...", enabled: false });