lightrace 0.1.6 → 0.1.8

package/dist/client.d.ts

@@ -2,14 +2,13 @@
  * Main Lightrace SDK client.
  */
 import { LightraceOtelExporter } from "./otel-exporter.js";
+import { DevServer } from "./dev-server.js";
 import { Observation } from "./observation.js";
 import type { UsageDetails } from "./types.js";
 export interface LightraceOptions {
     publicKey?: string;
     secretKey?: string;
     host?: string;
-    /** WebSocket host for tool connections (defaults to host if not set). */
-    wsHost?: string;
     flushAt?: number;
     flushInterval?: number;
     timeout?: number;
@@ -18,48 +17,34 @@ export interface LightraceOptions {
     userId?: string;
     /** Default session ID for all traces. */
     sessionId?: string;
+    /**
+     * Start the embedded dev server for tool invocation from the dashboard.
+     * Default: true. Set to false in production environments.
+     */
+    devServer?: boolean;
+    /** Port for the dev server (0 = auto-discover free port). Default: 0. */
+    devServerPort?: number;
 }
 export declare class Lightrace {
     private static instance;
     private otelExporter;
-    private toolClient;
-    private toolConnectTimer;
+    private _devServer;
     private enabled;
     private host;
-    private wsHost;
     private publicKey;
     private secretKey;
-    /** Default user ID for all traces. */
+    private devServerEnabled;
+    private devServerPort;
     readonly userId: string | undefined;
-    /** Default session ID for all traces. */
     readonly sessionId: string | undefined;
     constructor(options?: LightraceOptions);
     static getInstance(): Lightrace | null;
-    /** Get the OTel exporter (used by Observation). */
     getOtelExporter(): LightraceOtelExporter | null;
-    private autoConnectTools;
-    private startToolClient;
-    /**
-     * Explicitly start the tool WebSocket client.
-     * Call this after all tools have been registered (via trace() or registerTools).
-     * Cancels the deferred auto-connect timer if still pending.
-     */
-    connectTools(): void;
-    /**
-     * Register tools for remote invocation.
-     *
-     * @param tools - Array of tool descriptors with name, fn, and optional inputSchema.
-     */
-    registerTools(...tools: Array<{
-        name: string;
-        fn: (...args: unknown[]) => unknown;
-        inputSchema?: Record<string, unknown> | null;
-    }>): void;
+    getDevServer(): DevServer | null;
+    private startDevServer;
+    private registerToolsHttp;
     flush(): void;
     shutdown(): Promise<void>;
-    /**
-     * Create a span observation imperatively.
-     */
     span(opts: {
         name: string;
         input?: unknown;
@@ -67,9 +52,6 @@ export declare class Lightrace {
         traceId?: string;
         parentObservationId?: string;
     }): Observation;
-    /**
-     * Create a generation observation imperatively.
-     */
     generation(opts: {
         name: string;
         input?: unknown;
@@ -79,9 +61,6 @@ export declare class Lightrace {
         traceId?: string;
         parentObservationId?: string;
     }): Observation;
-    /**
-     * Create an event observation imperatively (auto-ended).
-     */
     event(opts: {
         name: string;
         input?: unknown;

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAS3D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,yEAAyE;IACzE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA0B;IAEjD,OAAO,CAAC,YAAY,CAAsC;IAC1D,OAAO,CAAC,UAAU,CAA0B;IAC5C,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,gBAAgB,CAAU;IAClC,OAAO,CAAC,aAAa,CAAS;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;gBAE3B,OAAO,GAAE,gBAAqB;IAgC1C,MAAM,CAAC,WAAW,IAAI,SAAS,GAAG,IAAI;IAItC,eAAe,IAAI,qBAAqB,GAAG,IAAI;IAI/C,YAAY,IAAI,SAAS,GAAG,IAAI;IAMhC,OAAO,CAAC,cAAc;IAiBtB,OAAO,CAAC,iBAAiB;IAiCzB,KAAK,IAAI,IAAI;IAIP,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAe/B,IAAI,CAAC,IAAI,EAAE;QACT,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnC,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,mBAAmB,CAAC,EAAE,MAAM,CAAC;KAC9B,GAAG,WAAW;IAIf,UAAU,CAAC,IAAI,EAAE;QACf,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnC,KAAK,CAAC,EAAE,YAAY,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,mBAAmB,CAAC,EAAE,MAAM,CAAC;KAC9B,GAAG,WAAW;IAIf,KAAK,CAAC,IAAI,EAAE;QACV,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnC,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,mBAAmB,CAAC,EAAE,MAAM,CAAC;KAC9B,GAAG,WAAW;IAMf,OAAO,CAAC,kBAAkB;CA2C3B"}

package/dist/client.js

@@ -2,34 +2,32 @@
  * Main Lightrace SDK client.
  */
 import { LightraceOtelExporter } from "./otel-exporter.js";
-import * as attrs from "./otel-exporter.js";
+import { AS_ROOT, TRACE_NAME } from "./otel-exporter.js";
 import { _setOtelExporter, _setClientDefaults, _getTraceContext, _getToolRegistry, } from "./trace.js";
-import { ToolClient } from "./tool-client.js";
+import { DevServer } from "./dev-server.js";
 import { Observation } from "./observation.js";
 import { generateId } from "./utils.js";
 export class Lightrace {
     static instance = null;
     otelExporter = null;
-    toolClient = null;
-    toolConnectTimer = null;
+    _devServer = null;
     enabled;
     host;
-    wsHost;
     publicKey;
     secretKey;
-    /** Default user ID for all traces. */
+    devServerEnabled;
+    devServerPort;
     userId;
-    /** Default session ID for all traces. */
     sessionId;
     constructor(options = {}) {
         this.publicKey = options.publicKey ?? process.env.LIGHTRACE_PUBLIC_KEY ?? "";
         this.secretKey = options.secretKey ?? process.env.LIGHTRACE_SECRET_KEY ?? "";
         this.host = (options.host ?? process.env.LIGHTRACE_HOST ?? "http://localhost:3002").replace(/\/$/, "");
-        this.wsHost =
-            (options.wsHost ?? process.env.LIGHTRACE_WS_HOST ?? "").replace(/\/$/, "") || null;
         this.enabled = options.enabled !== false;
         this.userId = options.userId;
         this.sessionId = options.sessionId;
+        this.devServerEnabled = options.devServer !== false;
+        this.devServerPort = options.devServerPort ?? 0;
         if (!this.enabled)
             return;
         this.otelExporter = new LightraceOtelExporter({
@@ -42,106 +40,87 @@ export class Lightrace {
         _setOtelExporter(this.otelExporter);
         _setClientDefaults({ userId: this.userId, sessionId: this.sessionId });
         Lightrace.instance = this;
-        // Deferred tool client start -- gives trace() decorators time to register
-        this.toolConnectTimer = setTimeout(() => this.autoConnectTools(), 2000);
+        if (this.devServerEnabled) {
+            this.startDevServer();
+        }
     }
     static getInstance() {
         return Lightrace.instance;
     }
-    /** Get the OTel exporter (used by Observation). */
     getOtelExporter() {
         return this.otelExporter;
     }
-    // -- Tool registration -------------------------------------------------------
-    autoConnectTools() {
-        this.toolConnectTimer = null;
-        if (!this.enabled || this.toolClient)
-            return;
-        const registry = _getToolRegistry();
-        if (registry.size === 0)
-            return;
-        this.startToolClient();
+    getDevServer() {
+        return this._devServer;
     }
-    startToolClient() {
-        if (this.toolClient)
-            return;
-        this.toolClient = new ToolClient({
-            host: this.wsHost ?? this.host,
+    // -- Dev server + tool registration -----------------------------------------
+    startDevServer() {
+        this._devServer = new DevServer({
+            port: this.devServerPort,
             publicKey: this.publicKey,
-            secretKey: this.secretKey,
         });
-        this.toolClient.start();
-    }
-    /**
-     * Explicitly start the tool WebSocket client.
-     * Call this after all tools have been registered (via trace() or registerTools).
-     * Cancels the deferred auto-connect timer if still pending.
-     */
-    connectTools() {
-        if (this.toolConnectTimer) {
-            clearTimeout(this.toolConnectTimer);
-            this.toolConnectTimer = null;
-        }
-        if (!this.enabled)
-            return;
-        this.startToolClient();
+        this._devServer
+            .start()
+            .then((port) => {
+            console.log(`[lightrace] Dev server listening on http://127.0.0.1:${port}`);
+            this.registerToolsHttp();
+        })
+            .catch((err) => {
+            console.error("[lightrace] Failed to start dev server:", err);
+        });
     }
-    /**
-     * Register tools for remote invocation.
-     *
-     * @param tools - Array of tool descriptors with name, fn, and optional inputSchema.
-     */
-    registerTools(...tools) {
+    registerToolsHttp() {
         const registry = _getToolRegistry();
-        for (const tool of tools) {
-            registry.set(tool.name, {
-                fn: tool.fn,
-                inputSchema: tool.inputSchema ?? null,
-            });
-        }
-        if (registry.size > 0 && this.enabled) {
-            if (this.toolConnectTimer) {
-                clearTimeout(this.toolConnectTimer);
-                this.toolConnectTimer = null;
-            }
-            this.startToolClient();
-        }
+        if (registry.size === 0)
+            return;
+        const callbackUrl = this._devServer?.getCallbackUrl();
+        if (!callbackUrl)
+            return;
+        const tools = Array.from(registry.entries()).map(([name, entry]) => ({
+            name,
+            inputSchema: entry.inputSchema,
+            description: entry.description ?? null,
+        }));
+        const auth = Buffer.from(`${this.publicKey}:${this.secretKey}`).toString("base64");
+        fetch(`${this.host}/api/public/tools/register`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Basic ${auth}`,
+            },
+            body: JSON.stringify({ callbackUrl, tools }),
+        })
+            .then((res) => {
+            if (!res.ok)
+                console.warn(`[lightrace] Tool registration returned ${res.status}`);
+        })
+            .catch((err) => {
+            console.error("[lightrace] Failed to register tools:", err.message);
+        });
     }
     // -- Flush / shutdown --------------------------------------------------------
     flush() {
         this.otelExporter?.flush();
     }
     async shutdown() {
-        if (this.toolConnectTimer) {
-            clearTimeout(this.toolConnectTimer);
-            this.toolConnectTimer = null;
-        }
-        if (this.toolClient) {
-            this.toolClient.stop();
-            this.toolClient = null;
+        if (this._devServer) {
+            await this._devServer.stop();
+            this._devServer = null;
         }
         if (this.otelExporter) {
             await this.otelExporter.shutdown();
+            this.otelExporter = null;
             _setOtelExporter(null);
         }
         Lightrace.instance = null;
     }
     // -- Imperative observation API ----------------------------------------------
-    /**
-     * Create a span observation imperatively.
-     */
     span(opts) {
         return this._createObservation("span", opts);
     }
-    /**
-     * Create a generation observation imperatively.
-     */
     generation(opts) {
         return this._createObservation("generation", opts);
     }
-    /**
-     * Create an event observation imperatively (auto-ended).
-     */
     event(opts) {
         const obs = this._createObservation("event", opts);
         obs.end();
@@ -149,23 +128,21 @@ export class Lightrace {
     }
     _createObservation(type, opts) {
         const otelExporter = this.otelExporter;
-        // Resolve trace context: explicit > OTel active span > create new root trace
         const ctx = _getTraceContext();
         let traceId = opts.traceId ?? ctx?.traceId;
-        const parentObservationId = opts.parentObservationId ?? ctx?.observationId ?? undefined;
-        // If no trace context, create an implicit root trace via OTel span
+        const parentObservationId = opts.parentObservationId ?? ctx?.observationId;
         if (!traceId && otelExporter) {
             const tracer = otelExporter.tracer;
             const rootSpan = tracer.startSpan(opts.name);
-            rootSpan.setAttribute(attrs.AS_ROOT, "true");
-            rootSpan.setAttribute(attrs.TRACE_NAME, opts.name);
+            rootSpan.setAttribute(AS_ROOT, "true");
+            rootSpan.setAttribute(TRACE_NAME, opts.name);
             traceId = rootSpan.spanContext().traceId;
             rootSpan.end();
         }
         if (!traceId) {
             traceId = generateId();
         }
-        const obs = new Observation({
+        return new Observation({
             traceId,
             type,
             name: opts.name,
@@ -176,7 +153,6 @@ export class Lightrace {
             usage: opts.usage,
             parentObservationId: parentObservationId ?? undefined,
         });
-        return obs;
     }
 }
 //# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/dev-server.d.ts

@@ -0,0 +1,18 @@
+export interface DevServerOptions {
+    /** Port to bind (0 = auto-discover free port). Default: 0. */
+    port?: number;
+    /** Public key for request authentication. */
+    publicKey?: string;
+}
+export declare class DevServer {
+    private server;
+    private publicKey;
+    private assignedPort;
+    private requestedPort;
+    constructor(options?: DevServerOptions);
+    start(): Promise<number>;
+    stop(): Promise<void>;
+    getPort(): number | null;
+    getCallbackUrl(): string | null;
+}
+//# sourceMappingURL=dev-server.d.ts.map

package/dist/dev-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-server.d.ts","sourceRoot":"","sources":["../src/dev-server.ts"],"names":[],"mappings":"AAoBA,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,aAAa,CAAS;gBAElB,OAAO,GAAE,gBAAqB;IAKpC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAkExB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAW3B,OAAO,IAAI,MAAM,GAAG,IAAI;IAIxB,cAAc,IAAI,MAAM,GAAG,IAAI;CAIhC"}

package/dist/dev-server.js

@@ -0,0 +1,95 @@
+import { Hono } from "hono";
+import { cors } from "hono/cors";
+import { bodyLimit } from "hono/body-limit";
+import { serve } from "@hono/node-server";
+import { _getToolRegistry } from "./trace.js";
+import { jsonSerializable } from "./utils.js";
+function apiResponse(c, code, message, response = null) {
+    return c.json({ code, message, response }, code);
+}
+export class DevServer {
+    server = null;
+    publicKey;
+    assignedPort = null;
+    requestedPort;
+    constructor(options = {}) {
+        this.requestedPort = options.port ?? 0;
+        this.publicKey = options.publicKey ?? "";
+    }
+    async start() {
+        if (this.server)
+            return this.assignedPort;
+        const app = new Hono();
+        const publicKey = this.publicKey;
+        app.use("*", cors());
+        app.use("/invoke", bodyLimit({ maxSize: 1024 * 1024 }));
+        app.get("/health", (c) => apiResponse(c, 200, "OK", { status: "ok" }));
+        app.post("/invoke", async (c) => {
+            if (publicKey && c.req.header("Authorization") !== `Bearer ${publicKey}`) {
+                return apiResponse(c, 401, "Unauthorized");
+            }
+            const body = await c.req.json().catch(() => null);
+            if (!body || typeof body !== "object") {
+                return apiResponse(c, 400, "Invalid JSON body");
+            }
+            const { tool, input } = body;
+            const registry = _getToolRegistry();
+            const entry = registry.get(tool);
+            if (!entry) {
+                return apiResponse(c, 404, `Tool not found: ${tool}`);
+            }
+            const start = performance.now();
+            try {
+                let result;
+                if (input && typeof input === "object" && !Array.isArray(input)) {
+                    result = await entry.fn(input);
+                }
+                else {
+                    result = input != null ? await entry.fn(input) : await entry.fn();
+                }
+                const durationMs = Math.round(performance.now() - start);
+                return apiResponse(c, 200, "OK", { output: jsonSerializable(result), durationMs });
+            }
+            catch (err) {
+                const durationMs = Math.round(performance.now() - start);
+                return apiResponse(c, 200, "OK", {
+                    output: null,
+                    error: err instanceof Error ? err.message : String(err),
+                    durationMs,
+                });
+            }
+        });
+        return new Promise((resolve, reject) => {
+            try {
+                const server = serve({ fetch: app.fetch, port: this.requestedPort, hostname: "127.0.0.1" }, (info) => {
+                    this.assignedPort = info.port;
+                    this.server = server;
+                    resolve(info.port);
+                });
+            }
+            catch (err) {
+                reject(err);
+            }
+        });
+    }
+    async stop() {
+        if (!this.server)
+            return;
+        return new Promise((resolve) => {
+            this.server.close(() => {
+                this.server = null;
+                this.assignedPort = null;
+                resolve();
+            });
+        });
+    }
+    getPort() {
+        return this.assignedPort;
+    }
+    getCallbackUrl() {
+        if (!this.assignedPort)
+            return null;
+        return `http://127.0.0.1:${this.assignedPort}`;
+    }
+}
+//# sourceMappingURL=dev-server.js.map

package/dist/dev-server.js.map

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

package/dist/index.d.ts

@@ -3,7 +3,7 @@ export type { LightraceOptions } from "./client.js";
 export { trace } from "./trace.js";
 export { Observation } from "./observation.js";
 export { LightraceOtelExporter } from "./otel-exporter.js";
-export { ToolClient, getInvokeState } from "./tool-client.js";
+export { DevServer } from "./dev-server.js";
 export { registerContext, captureContext, restoreContext } from "./context.js";
 export type { TraceOptions, ObservationType, UsageDetails } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC/E,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC/E,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -2,6 +2,6 @@ export { Lightrace } from "./client.js";
 export { trace } from "./trace.js";
 export { Observation } from "./observation.js";
 export { LightraceOtelExporter } from "./otel-exporter.js";
-export { ToolClient, getInvokeState } from "./tool-client.js";
+export { DevServer } from "./dev-server.js";
 export { registerContext, captureContext, restoreContext } from "./context.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}

package/dist/integrations/_base.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Shared tracing infrastructure for framework integrations.
+ *
+ * Provides `TracingMixin` with `registerRun` / `endRun` to manage OTel spans
+ * with `lightrace.*` attributes, and `normalizeUsage` for multi-provider
+ * token usage extraction.
+ */
+import type { Span } from "@opentelemetry/api";
+import type { LightraceOtelExporter } from "../otel-exporter.js";
+import { Lightrace } from "../client.js";
+/** State tracked for each in-flight observation. */
+export interface ObsRunInfo {
+    observationId: string;
+    type: "span" | "generation" | "event" | "tool" | "chain";
+    name: string;
+    startTime: Date;
+    input: unknown;
+    parentRunId?: string;
+    model?: string;
+    metadata?: Record<string, unknown>;
+    modelParameters?: Record<string, unknown>;
+    span: Span;
+}
+export interface TracingMixinOptions {
+    /** User ID to attach to the root trace. */
+    userId?: string;
+    /** Session ID to attach to the root trace. */
+    sessionId?: string;
+    /** Override name for the root trace. */
+    traceName?: string;
+    /** Additional metadata to attach to the root trace. */
+    metadata?: Record<string, unknown>;
+    /** Provide a Lightrace client instance. If omitted, uses Lightrace.getInstance(). */
+    client?: Lightrace;
+}
+/**
+ * Normalize token usage from any provider format to a canonical form.
+ *
+ * Supports OpenAI (`prompt_tokens`/`completion_tokens`), Anthropic
+ * (`input_tokens`/`output_tokens`), and camelCase variants.
+ */
+export declare function normalizeUsage(raw: Record<string, unknown>): Record<string, number> | null;
+/**
+ * Base class providing shared OTel tracing infrastructure for framework
+ * integrations. Manages span lifecycle, run-state tracking, and
+ * `lightrace.*` attribute setting.
+ */
+export declare class TracingMixin {
+    protected runs: Map<string, ObsRunInfo>;
+    protected runParents: Map<string, string | undefined>;
+    protected completionStartTimes: Map<string, Date>;
+    protected rootRunId: string | null;
+    protected _traceId: string | null;
+    protected userId?: string;
+    protected sessionId?: string;
+    protected traceName?: string;
+    protected rootMetadata?: Record<string, unknown>;
+    protected otelExporter: LightraceOtelExporter | null;
+    /** Root span for the current trace. */
+    protected rootSpan: Span | null;
+    /** The trace ID from the most recently completed root run. */
+    lastTraceId: string | null;
+    constructor(opts?: TracingMixinOptions);
+    /** Get the current active trace ID (null if no run is active). */
+    get traceId(): string | null;
+    protected registerRun(runId: string, parentRunId: string | undefined, info: Omit<ObsRunInfo, "observationId" | "parentRunId" | "span">): ObsRunInfo;
+    protected endObservationSpan(run: ObsRunInfo, output: unknown, level: string, statusMessage: string | null, extra?: Record<string, unknown>): void;
+    endRun(runId: string, output: unknown, level?: string, statusMessage?: string | null, extra?: Record<string, unknown>): void;
+}
+//# sourceMappingURL=_base.d.ts.map

package/dist/integrations/_base.d.ts.map

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