lightrace 0.1.10 → 0.1.13

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,79 @@
+/**
+ * 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 turnCount;
+    constructor(opts?: LightraceAgentHandlerOptions);
+    /** Process a single message from the agent SDK stream. */
+    handle(message: SDKMessageLike): void;
+    private onSystem;
+    private onAssistant;
+    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,CAAK;gBAEV,IAAI,CAAC,EAAE,4BAA4B;IAO/C,0DAA0D;IAC1D,MAAM,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAuBrC,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,WAAW;IAuEnB,OAAO,CAAC,MAAM;IAgCd,OAAO,CAAC,QAAQ;CAgCjB;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,243 @@
+/**
+ * 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
+    turnCount = 0;
+    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 {
+            // Tracing errors should never break the agent loop
+        }
+    }
+    // ── Message handlers ───────────────────────────────────────────────
+    onSystem(msg) {
+        // Capture model from init message for the root span name
+        if (msg.subtype === "init" && !this.agentRunId) {
+            // We'll use the model info when the first assistant message arrives
+        }
+    }
+    onAssistant(msg) {
+        // Start root agent span on first assistant message
+        if (this.agentRunId === null) {
+            this.agentRunId = generateId();
+            this.registerRun(this.agentRunId, undefined, {
+                type: "span",
+                name: this.traceName ?? "claude-agent",
+                startTime: new Date(),
+                input: this.prompt,
+            });
+        }
+        this.turnCount++;
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const raw = msg;
+        const betaMessage = raw.message;
+        const model = raw.model ?? betaMessage?.model;
+        const usage = betaMessage?.usage;
+        // Create a generation span for this turn
+        const genRunId = generateId();
+        this.registerRun(genRunId, this.agentRunId, {
+            type: "generation",
+            name: model ?? "claude",
+            startTime: new Date(),
+            input: undefined,
+            model,
+        });
+        // Extract content blocks
+        const content = betaMessage?.content ?? raw.content ?? [];
+        const outputBlocks = [];
+        for (const block of content) {
+            const b = block;
+            const blockType = b.type;
+            if (blockType === "text") {
+                outputBlocks.push({ type: "text", text: b.text ?? "" });
+            }
+            else if (blockType === "tool_use") {
+                const toolId = b.id;
+                const toolName = b.name;
+                const toolInput = b.input;
+                outputBlocks.push({
+                    type: "tool_use",
+                    id: toolId,
+                    name: toolName,
+                    input: jsonSerializable(toolInput),
+                });
+                // Start a tool span (ended when matching user message arrives)
+                const toolRunId = generateId();
+                this.toolRunIds.set(toolId, toolRunId);
+                this.registerRun(toolRunId, this.agentRunId, {
+                    type: "tool",
+                    name: toolName,
+                    startTime: new Date(),
+                    input: toolInput,
+                });
+            }
+            else {
+                outputBlocks.push(jsonSerializable(b));
+            }
+        }
+        // End the generation span (the LLM call itself is complete)
+        const normalizedUsage = usage ? normalizeUsage(usage) : null;
+        this.endRun(genRunId, outputBlocks, "DEFAULT", null, normalizedUsage ?? undefined);
+    }
+    onUser(msg) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const raw = msg;
+        const userMessage = raw.message;
+        // 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" && 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);
+                    const output = b.content;
+                    if (isError) {
+                        this.endRun(toolRunId, jsonSerializable(output), "ERROR", String(output));
+                    }
+                    else {
+                        this.endRun(toolRunId, jsonSerializable(output));
+                    }
+                }
+            }
+        }
+    }
+    onResult(msg) {
+        // 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;
+        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;
+        this.turnCount = 0;
+    }
+}
+// ── 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.13",
   "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": {