lightrace 0.1.10 → 0.1.14

package/README.md

@@ -1,11 +1,27 @@
-# lightrace-js
+<p align="center">
+  <img src="https://raw.githubusercontent.com/SKE-Labs/lightrace/main/packages/frontend/public/white_transparent.png" alt="LightRace" width="280" />
+</p>
 
-Lightweight LLM tracing SDK for TypeScript/JavaScript with remote tool invocation.
+<h1 align="center">lightrace-js</h1>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/lightrace"><img src="https://img.shields.io/npm/v/lightrace?style=flat-square&color=ff1a1a" alt="npm version" /></a>
+  <a href="https://github.com/SKE-Labs/lightrace-js/stargazers"><img src="https://img.shields.io/github/stars/SKE-Labs/lightrace-js?style=flat-square" alt="GitHub stars" /></a>
+  <a href="https://github.com/SKE-Labs/lightrace-js/blob/main/LICENSE"><img src="https://img.shields.io/github/license/SKE-Labs/lightrace-js?style=flat-square" alt="License" /></a>
+</p>
+
+<p align="center">Lightweight LLM tracing SDK for TypeScript/JavaScript with remote tool invocation.</p>
+
+---
 
 ## Install
 
 ```bash
+npm install lightrace
+# or
 yarn add lightrace
+# or
+pnpm add lightrace
 ```
 
 ## Quick Start
@@ -74,10 +90,122 @@ trace(name, options, fn);
 | `inputSchema` | `ZodType` | `undefined` | Optional Zod schema for tool input                       |
 | `metadata`    | `Record`  | `undefined` | Static metadata attached to every call                   |
 
+## Integrations
+
+### Anthropic
+
+```typescript
+import Anthropic from "@anthropic-ai/sdk";
+import { Lightrace, trace } from "lightrace";
+import { LightraceAnthropicInstrumentor } from "lightrace/integrations/anthropic";
+
+const lt = new Lightrace({ publicKey: "pk-lt-demo", secretKey: "sk-lt-demo" });
+
+const anthropic = new Anthropic();
+const instrumentor = new LightraceAnthropicInstrumentor({ client: lt });
+instrumentor.instrument(anthropic);
+
+const response = await anthropic.messages.create({
+  model: "claude-sonnet-4-20250514",
+  max_tokens: 256,
+  messages: [{ role: "user", content: "What is the capital of Mongolia?" }],
+});
+
+lt.flush();
+await lt.shutdown();
+```
+
+### OpenAI
+
+```typescript
+import OpenAI from "openai";
+import { Lightrace, trace } from "lightrace";
+import { LightraceOpenAIInstrumentor } from "lightrace/integrations/openai";
+
+const lt = new Lightrace({ publicKey: "pk-lt-demo", secretKey: "sk-lt-demo" });
+
+const openai = new OpenAI();
+const instrumentor = new LightraceOpenAIInstrumentor({ client: lt });
+instrumentor.instrument(openai);
+
+const response = await openai.chat.completions.create({
+  model: "gpt-4o-mini",
+  max_tokens: 256,
+  messages: [{ role: "user", content: "What is the speed of light?" }],
+});
+
+lt.flush();
+await lt.shutdown();
+```
+
+### LangChain
+
+```typescript
+import { ChatOpenAI } from "@langchain/openai";
+import { Lightrace } from "lightrace";
+import { LightraceCallbackHandler } from "lightrace/integrations/langchain";
+
+const lt = new Lightrace({ publicKey: "pk-lt-demo", secretKey: "sk-lt-demo" });
+
+const handler = new LightraceCallbackHandler({ client: lt });
+const model = new ChatOpenAI({ model: "gpt-4o-mini", maxTokens: 256 });
+
+const response = await model.invoke("What is the speed of light?", {
+  callbacks: [handler],
+});
+
+lt.flush();
+await lt.shutdown();
+```
+
+### Claude Agent SDK
+
+```typescript
+import { Lightrace } from "lightrace";
+import { tracedQuery } from "lightrace/integrations/claude-agent-sdk";
+
+const lt = new Lightrace({ publicKey: "pk-lt-demo", secretKey: "sk-lt-demo" });
+
+for await (const message of tracedQuery({
+  prompt: "What files are in the current directory?",
+  options: { maxTurns: 3 },
+  client: lt,
+  traceName: "file-lister",
+})) {
+  if (message.type === "result") {
+    const r = message as Record<string, unknown>;
+    console.log(r.result);
+    console.log(`Cost: $${r.total_cost_usd}`);
+  }
+}
+
+lt.flush();
+await lt.shutdown();
+```
+
+You can also use the handler directly for more control:
+
+```typescript
+import { query } from "@anthropic-ai/claude-agent-sdk";
+import { LightraceAgentHandler } from "lightrace/integrations/claude-agent-sdk";
+
+const handler = new LightraceAgentHandler({ prompt: "Hello", client: lt, traceName: "my-agent" });
+
+for await (const message of query({ prompt: "Hello" })) {
+  handler.handle(message);
+}
+```
+
 ## Compatibility
 
 Lightrace server also accepts traces from Langfuse Python/JS SDKs.
 
+## Related
+
+- [Lightrace](https://github.com/SKE-Labs/lightrace) — the main platform (backend + frontend)
+- [Lightrace CLI](https://github.com/SKE-Labs/lightrace-cli) — self-host with a single command
+- [lightrace-python](https://github.com/SKE-Labs/lightrace-python) — Python SDK
+
 ## Development
 
 ```bash

package/dist/integrations/claude-agent-sdk.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Claude Agent SDK integration for Lightrace.
+ *
+ * Wraps the `query()` async iterator from `@anthropic-ai/claude-agent-sdk`
+ * to emit OTel spans for each generation, tool call, and the overall agent run.
+ *
+ * @example Wrapper (recommended)
+ * ```ts
+ * import { Lightrace } from "lightrace";
+ * import { tracedQuery } from "lightrace/integrations/claude-agent-sdk";
+ *
+ * const lt = new Lightrace({ publicKey: "pk-lt-demo", secretKey: "sk-lt-demo" });
+ *
+ * for await (const message of tracedQuery({
+ *   prompt: "What files are in the current directory?",
+ *   client: lt,
+ *   traceName: "file-lister",
+ * })) {
+ *   if (message.type === "result") console.log(message.result);
+ * }
+ * ```
+ *
+ * @example Manual handler
+ * ```ts
+ * import { query } from "@anthropic-ai/claude-agent-sdk";
+ * import { LightraceAgentHandler } from "lightrace/integrations/claude-agent-sdk";
+ *
+ * const handler = new LightraceAgentHandler({ client: lt });
+ *
+ * for await (const message of query({ prompt: "Hello" })) {
+ *   handler.handle(message);
+ * }
+ * ```
+ */
+import { TracingMixin, type TracingMixinOptions } from "./_base.js";
+/** Minimal message shape — avoids hard dependency on @anthropic-ai/claude-agent-sdk. */
+interface SDKMessageLike {
+    type: string;
+    [key: string]: unknown;
+}
+export interface LightraceAgentHandlerOptions extends TracingMixinOptions {
+    /** The prompt sent to the agent (captured as root trace input). */
+    prompt?: string;
+}
+export interface TracedQueryOptions extends TracingMixinOptions {
+    /** The prompt to send to the agent. */
+    prompt: string;
+    /** `ClaudeAgentOptions` to pass through to `query()`. */
+    options?: unknown;
+}
+/**
+ * Processes Claude Agent SDK messages to create Lightrace traces.
+ *
+ * Call {@link handle} for each message yielded by `query()`. The handler
+ * automatically creates a root agent span, child generation spans for each
+ * `AssistantMessage`, and child tool spans for each tool call.
+ */
+export declare class LightraceAgentHandler extends TracingMixin {
+    private prompt;
+    private agentRunId;
+    private toolRunIds;
+    private initTools;
+    private initModel;
+    private currentGenRunId;
+    private currentMessageId;
+    private currentOutputBlocks;
+    private currentUsage;
+    constructor(opts?: LightraceAgentHandlerOptions);
+    /** Process a single message from the agent SDK stream. */
+    handle(message: SDKMessageLike): void;
+    private onSystem;
+    private onAssistant;
+    private processContentBlocks;
+    private flushGeneration;
+    private onUser;
+    private onResult;
+}
+/**
+ * Drop-in wrapper around `query()` that adds Lightrace tracing.
+ *
+ * Messages are yielded through unchanged. Requires `@anthropic-ai/claude-agent-sdk`
+ * to be installed.
+ */
+export declare function tracedQuery(opts: TracedQueryOptions): AsyncGenerator<SDKMessageLike, void>;
+export {};
+//# sourceMappingURL=claude-agent-sdk.d.ts.map

package/dist/integrations/claude-agent-sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-agent-sdk.d.ts","sourceRoot":"","sources":["../../src/integrations/claude-agent-sdk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAGH,OAAO,EAAE,YAAY,EAAkB,KAAK,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAIpF,wFAAwF;AACxF,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,4BAA6B,SAAQ,mBAAmB;IACvE,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAmB,SAAQ,mBAAmB;IAC7D,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAID;;;;;;GAMG;AACH,qBAAa,qBAAsB,SAAQ,YAAY;IACrD,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,UAAU,CAA6B;IAC/C,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,SAAS,CAAuB;IAIxC,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,mBAAmB,CAAiC;IAC5D,OAAO,CAAC,YAAY,CAAuC;gBAE/C,IAAI,CAAC,EAAE,4BAA4B;IAO/C,0DAA0D;IAC1D,MAAM,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IA0BrC,OAAO,CAAC,QAAQ;IAahB,OAAO,CAAC,WAAW;IAiDnB,OAAO,CAAC,oBAAoB;IAgD5B,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,MAAM;IAuCd,OAAO,CAAC,QAAQ;CAkCjB;AAID;;;;;GAKG;AACH,wBAAuB,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,cAAc,CAAC,cAAc,EAAE,IAAI,CAAC,CA4BjG"}

package/dist/integrations/claude-agent-sdk.js

@@ -0,0 +1,308 @@
+/**
+ * Claude Agent SDK integration for Lightrace.
+ *
+ * Wraps the `query()` async iterator from `@anthropic-ai/claude-agent-sdk`
+ * to emit OTel spans for each generation, tool call, and the overall agent run.
+ *
+ * @example Wrapper (recommended)
+ * ```ts
+ * import { Lightrace } from "lightrace";
+ * import { tracedQuery } from "lightrace/integrations/claude-agent-sdk";
+ *
+ * const lt = new Lightrace({ publicKey: "pk-lt-demo", secretKey: "sk-lt-demo" });
+ *
+ * for await (const message of tracedQuery({
+ *   prompt: "What files are in the current directory?",
+ *   client: lt,
+ *   traceName: "file-lister",
+ * })) {
+ *   if (message.type === "result") console.log(message.result);
+ * }
+ * ```
+ *
+ * @example Manual handler
+ * ```ts
+ * import { query } from "@anthropic-ai/claude-agent-sdk";
+ * import { LightraceAgentHandler } from "lightrace/integrations/claude-agent-sdk";
+ *
+ * const handler = new LightraceAgentHandler({ client: lt });
+ *
+ * for await (const message of query({ prompt: "Hello" })) {
+ *   handler.handle(message);
+ * }
+ * ```
+ */
+import { generateId, jsonSerializable } from "../utils.js";
+import { TracingMixin, normalizeUsage } from "./_base.js";
+// ── Handler ────────────────────────────────────────────────────────────────
+/**
+ * Processes Claude Agent SDK messages to create Lightrace traces.
+ *
+ * Call {@link handle} for each message yielded by `query()`. The handler
+ * automatically creates a root agent span, child generation spans for each
+ * `AssistantMessage`, and child tool spans for each tool call.
+ */
+export class LightraceAgentHandler extends TracingMixin {
+    prompt;
+    agentRunId = null;
+    toolRunIds = new Map(); // tool_use_id → runId
+    initTools = null;
+    initModel = null;
+    // Generation span accumulation — SDK yields multiple AssistantMessages
+    // per turn (thinking + tool_use) sharing the same message_id.
+    currentGenRunId = null;
+    currentMessageId = null;
+    currentOutputBlocks = [];
+    currentUsage = null;
+    constructor(opts) {
+        super(opts);
+        this.prompt = opts?.prompt;
+    }
+    // ── Public API ─────────────────────────────────────────────────────
+    /** Process a single message from the agent SDK stream. */
+    handle(message) {
+        try {
+            switch (message.type) {
+                case "assistant":
+                    this.onAssistant(message);
+                    break;
+                case "user":
+                    this.onUser(message);
+                    break;
+                case "result":
+                    this.onResult(message);
+                    break;
+                case "system":
+                    this.onSystem(message);
+                    break;
+            }
+        }
+        catch (err) {
+            // Tracing errors should never break the agent loop
+            if (typeof console !== "undefined") {
+                console.warn("[lightrace] Error handling message:", err);
+            }
+        }
+    }
+    // ── Message handlers ───────────────────────────────────────────────
+    onSystem(msg) {
+        if (msg.subtype === "init") {
+            // Tools/model are nested in a `data` dict
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const data = msg.data;
+            const source = data ?? msg;
+            const tools = source.tools;
+            if (tools)
+                this.initTools = [...tools];
+            const model = source.model;
+            if (model)
+                this.initModel = model;
+        }
+    }
+    onAssistant(msg) {
+        // Start root agent span on first assistant message
+        if (this.agentRunId === null) {
+            this.agentRunId = generateId();
+            const input = { prompt: this.prompt };
+            if (this.initTools)
+                input.tools = this.initTools;
+            if (this.initModel)
+                input.model = this.initModel;
+            this.registerRun(this.agentRunId, undefined, {
+                type: "span",
+                name: this.traceName ?? "claude-agent",
+                startTime: new Date(),
+                input,
+            });
+        }
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const raw = msg;
+        const betaMessage = raw.message;
+        const messageId = raw.message_id ?? betaMessage?.id;
+        // SDK yields multiple AssistantMessages per turn sharing the same
+        // message_id (e.g. thinking block, then tool_use block). Accumulate
+        // content blocks into a single generation span.
+        if (messageId && messageId === this.currentMessageId && this.currentGenRunId !== null) {
+            this.processContentBlocks(raw);
+            return;
+        }
+        // New turn — flush any pending generation from the previous turn.
+        this.flushGeneration();
+        const model = raw.model ?? betaMessage?.model;
+        this.currentMessageId = messageId ?? null;
+        this.currentGenRunId = generateId();
+        this.currentOutputBlocks = [];
+        this.currentUsage = null;
+        this.registerRun(this.currentGenRunId, this.agentRunId ?? undefined, {
+            type: "generation",
+            name: model ?? "claude",
+            startTime: new Date(),
+            input: undefined,
+            model,
+        });
+        this.processContentBlocks(raw);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    processContentBlocks(raw) {
+        const betaMessage = raw.message;
+        const content = betaMessage?.content ?? raw.content ?? [];
+        const usage = betaMessage?.usage ?? raw.usage;
+        for (const block of content) {
+            const b = block;
+            const blockType = b.type;
+            const hasText = "text" in b && !("id" in b);
+            const hasTool = "id" in b && "name" in b && "input" in b;
+            const hasThinking = "thinking" in b;
+            if (blockType === "text" || (!blockType && hasText)) {
+                this.currentOutputBlocks.push({ type: "text", text: b.text ?? "" });
+            }
+            else if (blockType === "tool_use" || (!blockType && hasTool)) {
+                const toolId = b.id;
+                const toolName = b.name;
+                const toolInput = b.input;
+                this.currentOutputBlocks.push({
+                    type: "tool_use",
+                    id: toolId,
+                    name: toolName,
+                    input: toolInput,
+                });
+                // Start a tool span (ended when matching user message arrives)
+                const toolRunId = generateId();
+                this.toolRunIds.set(toolId, toolRunId);
+                this.registerRun(toolRunId, this.agentRunId ?? undefined, {
+                    type: "tool",
+                    name: toolName,
+                    startTime: new Date(),
+                    input: toolInput,
+                });
+            }
+            else if (blockType === "thinking" || (!blockType && hasThinking)) {
+                this.currentOutputBlocks.push({ type: "thinking", thinking: b.thinking ?? "" });
+            }
+            else {
+                this.currentOutputBlocks.push(jsonSerializable(b));
+            }
+        }
+        // Keep the latest usage (last AssistantMessage in this turn wins)
+        if (usage) {
+            this.currentUsage = normalizeUsage(usage);
+        }
+    }
+    flushGeneration() {
+        if (this.currentGenRunId === null)
+            return;
+        const output = {
+            role: "assistant",
+            content: this.currentOutputBlocks,
+        };
+        this.endRun(this.currentGenRunId, output, "DEFAULT", null, this.currentUsage ?? undefined);
+        this.currentGenRunId = null;
+        this.currentMessageId = null;
+        this.currentOutputBlocks = [];
+        this.currentUsage = null;
+    }
+    onUser(msg) {
+        this.flushGeneration();
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const raw = msg;
+        const userMessage = raw.message;
+        const fallbackOutput = raw.tool_use_result;
+        // User messages contain tool results as content blocks
+        const content = Array.isArray(userMessage?.content)
+            ? userMessage.content
+            : Array.isArray(raw.content)
+                ? raw.content
+                : [];
+        for (const block of content) {
+            const b = block;
+            if ((b.type === "tool_result" || "tool_use_id" in b) && typeof b.tool_use_id === "string") {
+                const toolUseId = b.tool_use_id;
+                const toolRunId = this.toolRunIds.get(toolUseId);
+                if (toolRunId) {
+                    this.toolRunIds.delete(toolUseId);
+                    const isError = Boolean(b.is_error);
+                    let output = b.content ?? b.output;
+                    // Use fallback from tool_use_result when block has no output
+                    if (output === undefined && fallbackOutput !== undefined) {
+                        output = fallbackOutput;
+                    }
+                    if (isError) {
+                        this.endRun(toolRunId, output, "ERROR", String(output));
+                    }
+                    else {
+                        this.endRun(toolRunId, output);
+                    }
+                }
+            }
+        }
+    }
+    onResult(msg) {
+        this.flushGeneration();
+        // End any remaining tool spans
+        for (const [, toolRunId] of this.toolRunIds) {
+            this.endRun(toolRunId, null);
+        }
+        this.toolRunIds.clear();
+        if (this.agentRunId === null)
+            return;
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const raw = msg;
+        const output = {};
+        if (raw.result !== undefined)
+            output.result = raw.result;
+        if (raw.num_turns !== undefined)
+            output.num_turns = raw.num_turns;
+        if (raw.total_cost_usd !== undefined)
+            output.total_cost_usd = raw.total_cost_usd;
+        if (raw.duration_ms !== undefined)
+            output.duration_ms = raw.duration_ms;
+        if (raw.subtype !== undefined)
+            output.subtype = raw.subtype;
+        if (raw.model_usage !== undefined)
+            output.model_usage = jsonSerializable(raw.model_usage);
+        const usage = raw.usage ? normalizeUsage(raw.usage) : null;
+        const isError = Boolean(raw.is_error);
+        if (isError) {
+            const errorMsg = raw.result ?? raw.subtype ?? "Agent error";
+            this.endRun(this.agentRunId, output, "ERROR", String(errorMsg), usage ?? undefined);
+        }
+        else {
+            this.endRun(this.agentRunId, output, "DEFAULT", null, usage ?? undefined);
+        }
+        this.agentRunId = null;
+    }
+}
+// ── Wrapper ────────────────────────────────────────────────────────────────
+/**
+ * Drop-in wrapper around `query()` that adds Lightrace tracing.
+ *
+ * Messages are yielded through unchanged. Requires `@anthropic-ai/claude-agent-sdk`
+ * to be installed.
+ */
+export async function* tracedQuery(opts) {
+    // Dynamic import to avoid hard dependency
+    let queryFn;
+    try {
+        // Use a variable to prevent TypeScript from resolving the optional peer dep
+        const modName = "@anthropic-ai/claude-agent-sdk";
+        const mod = await import(/* webpackIgnore: true */ modName);
+        queryFn = mod.query;
+    }
+    catch {
+        throw new Error("@anthropic-ai/claude-agent-sdk is required for this integration. " +
+            "Install it with: npm install @anthropic-ai/claude-agent-sdk");
+    }
+    const handler = new LightraceAgentHandler({
+        prompt: opts.prompt,
+        client: opts.client,
+        userId: opts.userId,
+        sessionId: opts.sessionId,
+        traceName: opts.traceName,
+        metadata: opts.metadata,
+    });
+    for await (const message of queryFn({ prompt: opts.prompt, options: opts.options })) {
+        handler.handle(message);
+        yield message;
+    }
+}
+//# sourceMappingURL=claude-agent-sdk.js.map

package/dist/integrations/claude-agent-sdk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-agent-sdk.js","sourceRoot":"","sources":["../../src/integrations/claude-agent-sdk.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lightrace",
-  "version": "0.1.10",
+  "version": "0.1.14",
   "description": "Agentic development kit — LLM tracing, tool management, and agent primitives",
   "type": "module",
   "main": "./dist/index.js",
@@ -25,6 +25,10 @@
     "./integrations/llamaindex": {
       "import": "./dist/integrations/llamaindex.js",
       "types": "./dist/integrations/llamaindex.d.ts"
+    },
+    "./integrations/claude-agent-sdk": {
+      "import": "./dist/integrations/claude-agent-sdk.js",
+      "types": "./dist/integrations/claude-agent-sdk.d.ts"
     }
   },
   "files": [
@@ -69,6 +73,7 @@
     "@anthropic-ai/sdk": ">=0.30.0",
     "openai": ">=4.0.0",
     "llamaindex": ">=0.5.0",
+    "@anthropic-ai/claude-agent-sdk": ">=0.1.0",
     "zod": "^3.0.0"
   },
   "peerDependenciesMeta": {
@@ -86,6 +91,9 @@
     },
     "llamaindex": {
       "optional": true
+    },
+    "@anthropic-ai/claude-agent-sdk": {
+      "optional": true
     }
   },
   "lint-staged": {