@uselemma/tracing 0.1.0

package/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2025 Forge AI Labs, Inc
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,119 @@
+# Tracing Module
+
+OpenTelemetry-based tracing module for Lemma.
+
+## Installation
+
+```bash
+npm install @uselemma/tracing
+```
+
+## Usage
+
+### Basic Setup
+
+```typescript
+import { Tracer, TraceRunner, SpanType } from "@uselemma/tracing";
+
+// Create a tracer
+const tracer = new Tracer("my-service");
+
+// Use TraceRunner for managing traces
+const traceRunner = new TraceRunner(tracer, {
+  "prompt-name": "override template here",
+});
+
+// Run code within tracing context
+await traceRunner.run(async () => {
+  // Your code here
+  const renderedPrompt = await tracer.prompt(
+    "prompt-name",
+    "Hello {{ name }}!",
+    { name: "World" }
+  );
+
+  // ... use renderedPrompt ...
+
+  tracer.addLlmOutput("LLM response", "gpt-4", {
+    prompt_tokens: 100,
+    completion_tokens: 50,
+    total_tokens: 150,
+  });
+});
+
+// Get trace data
+const traceData = await traceRunner.record();
+console.log(traceData.trace_id);
+console.log(traceData.spans);
+```
+
+### Function Tracing
+
+```typescript
+// Wrap a function for tracing
+const tracedFunction = tracer.wrap(SpanType.TOOL, myFunction);
+
+// Or use manually
+const span = tracer.getCurrentSpan();
+tracer.addMetadata("key", "value");
+tracer.addEvent("event-name", { data: "value" });
+```
+
+### Prompt Tracing
+
+```typescript
+// Method 1: Using prompt() (returns rendered prompt)
+const renderedPrompt = await tracer.prompt(
+  "translation",
+  "Translate: {{ text }}",
+  { text: "Hello" }
+);
+// ... use renderedPrompt ...
+tracer.addLlmOutput(result.content);
+
+// Method 2: Using startPrompt() (returns context object)
+const promptCtx = tracer.startPrompt("translation", "Translate: {{ text }}", {
+  text: "Hello",
+});
+// ... use promptCtx.renderedPrompt ...
+tracer.addLlmOutput(result.content);
+promptCtx.end(); // Manually end span
+```
+
+## API
+
+### SpanType
+
+Enum for specifying span types:
+- `SpanType.AGENT` - For agent operations
+- `SpanType.NODE` - For node operations
+- `SpanType.TOOL` - For tool operations
+
+### Tracer
+
+- `wrap<T>(spanType: SpanType, func: T): T` - Wrap a function for tracing
+- `prompt(promptName: string, promptTemplate: string, inputVars: Record<string, unknown>): Promise<string>` - Create a prompt span and render template
+- `startPrompt(...)`: Start a prompt span and return context object
+- `addLlmOutput(output: string, model?: string, usage?: {...}): void` - Add LLM output to current prompt span
+- `addMetadata(key: string, value: unknown): void` - Add metadata to current span
+- `addEvent(eventName: string, attributes?: Record<string, unknown>): void` - Add event to current span
+- `getTraceId(): string | undefined` - Get current trace ID
+- `forceFlush(): Promise<void>` - Force flush all pending spans
+- `getSpans(): ReadableSpan[]` - Get all collected spans
+- `getSpansAsDicts(): SpanDict[]` - Get all collected spans as dictionaries
+
+### TraceRunner
+
+- `run<T>(callback: () => Promise<T> | T): Promise<T>` - Run callback within tracing context
+- `record(): Promise<TraceData>` - Export spans and return trace data
+
+### CandidatePromptManager
+
+- `run<T>(candidatePrompts: Record<string, string> | null, callback: () => Promise<T> | T): Promise<T>` - Run callback with candidate prompts
+- `getEffectiveTemplate(promptName: string, defaultTemplate: string): [string, boolean]` - Get effective template
+
+### MemorySpanExporter
+
+- `getSpans(): ReadableSpan[]` - Get all stored spans
+- `getSpansAsDicts(): SpanDict[]` - Get all stored spans as dictionaries
+- `clear(): void` - Clear stored spans

package/dist/candidate-prompt-manager.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Manages candidate prompt overrides using AsyncLocalStorage for context-local state.
+ */
+export declare class CandidatePromptManager {
+    private readonly _overrides;
+    constructor();
+    /**
+     * Runs a callback with candidate prompts set in the async context.
+     *
+     * @param candidatePrompts - Optional dictionary of prompt name -> candidate template
+     * @param callback - Function to run with the context
+     * @returns Result of the callback
+     */
+    run<T>(candidatePrompts: Record<string, string> | null | undefined, callback: () => Promise<T> | T): Promise<T>;
+    /**
+     * Get the effective template, applying candidate override if present.
+     *
+     * @param promptName - Name of the prompt
+     * @param defaultTemplate - Default template to use if no override
+     * @returns Tuple of [effectiveTemplate, overrideApplied]
+     */
+    getEffectiveTemplate(promptName: string, defaultTemplate: string): [string, boolean];
+    /**
+     * Annotate span with candidate prompt metadata.
+     *
+     * @param span - OpenTelemetry span to annotate
+     */
+    annotateSpan(span: {
+        setAttribute: (key: string, value: unknown) => void;
+    }): void;
+}
+//# sourceMappingURL=candidate-prompt-manager.d.ts.map

package/dist/candidate-prompt-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidate-prompt-manager.d.ts","sourceRoot":"","sources":["../src/candidate-prompt-manager.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmD;;IAM9E;;;;;;OAMG;IACG,GAAG,CAAC,CAAC,EACT,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,EAC3D,QAAQ,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAC7B,OAAO,CAAC,CAAC,CAAC;IAIb;;;;;;OAMG;IACH,oBAAoB,CAClB,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,GACtB,CAAC,MAAM,EAAE,OAAO,CAAC;IAQpB;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE;QACjB,YAAY,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;KACrD,GAAG,IAAI;CAaT"}

package/dist/candidate-prompt-manager.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CandidatePromptManager = void 0;
+const node_async_hooks_1 = require("node:async_hooks");
+/**
+ * Manages candidate prompt overrides using AsyncLocalStorage for context-local state.
+ */
+class CandidatePromptManager {
+    _overrides;
+    constructor() {
+        this._overrides = new node_async_hooks_1.AsyncLocalStorage();
+    }
+    /**
+     * Runs a callback with candidate prompts set in the async context.
+     *
+     * @param candidatePrompts - Optional dictionary of prompt name -> candidate template
+     * @param callback - Function to run with the context
+     * @returns Result of the callback
+     */
+    async run(candidatePrompts, callback) {
+        return this._overrides.run(candidatePrompts ?? null, callback);
+    }
+    /**
+     * Get the effective template, applying candidate override if present.
+     *
+     * @param promptName - Name of the prompt
+     * @param defaultTemplate - Default template to use if no override
+     * @returns Tuple of [effectiveTemplate, overrideApplied]
+     */
+    getEffectiveTemplate(promptName, defaultTemplate) {
+        const overrides = this._overrides.getStore();
+        if (overrides && promptName in overrides) {
+            return [overrides[promptName], true];
+        }
+        return [defaultTemplate, false];
+    }
+    /**
+     * Annotate span with candidate prompt metadata.
+     *
+     * @param span - OpenTelemetry span to annotate
+     */
+    annotateSpan(span) {
+        const overrides = this._overrides.getStore();
+        if (overrides !== null && overrides !== undefined) {
+            try {
+                span.setAttribute("candidate_prompts.count", Object.keys(overrides).length);
+            }
+            catch {
+                // Best-effort; avoid breaking tracing on attribute errors
+            }
+        }
+    }
+}
+exports.CandidatePromptManager = CandidatePromptManager;
+//# sourceMappingURL=candidate-prompt-manager.js.map

package/dist/candidate-prompt-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidate-prompt-manager.js","sourceRoot":"","sources":["../src/candidate-prompt-manager.ts"],"names":[],"mappings":";;;AAAA,uDAAqD;AAErD;;GAEG;AACH,MAAa,sBAAsB;IAChB,UAAU,CAAmD;IAE9E;QACE,IAAI,CAAC,UAAU,GAAG,IAAI,oCAAiB,EAAiC,CAAC;IAC3E,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,GAAG,CACP,gBAA2D,EAC3D,QAA8B;QAE9B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,gBAAgB,IAAI,IAAI,EAAE,QAAQ,CAAC,CAAC;IACjE,CAAC;IAED;;;;;;OAMG;IACH,oBAAoB,CAClB,UAAkB,EAClB,eAAuB;QAEvB,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;QAC7C,IAAI,SAAS,IAAI,UAAU,IAAI,SAAS,EAAE,CAAC;YACzC,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,CAAC;QACvC,CAAC;QACD,OAAO,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;IAED;;;;OAIG;IACH,YAAY,CAAC,IAEZ;QACC,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;QAC7C,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAClD,IAAI,CAAC;gBACH,IAAI,CAAC,YAAY,CACf,yBAAyB,EACzB,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,CAC9B,CAAC;YACJ,CAAC;YAAC,MAAM,CAAC;gBACP,0DAA0D;YAC5D,CAAC;QACH,CAAC;IACH,CAAC;CACF;AA3DD,wDA2DC"}

package/dist/exporter.d.ts

@@ -0,0 +1,42 @@
+import { ExportResultCode } from "@opentelemetry/core";
+import type { ReadableSpan, SpanExporter } from "@opentelemetry/sdk-trace-base";
+export interface SpanDict {
+    timestamp: string;
+    trace_id: string;
+    span_id: string;
+    parent_span_id: string | null;
+    name: string;
+    kind: string;
+    start_time_ns: bigint;
+    end_time_ns: bigint | null;
+    duration_ms: number | null;
+    attributes: Record<string, unknown>;
+    status: {
+        status_code: string;
+        description?: string;
+    } | null;
+    events: Array<{
+        name: string;
+        timestamp_ns: bigint;
+        attributes: Record<string, unknown>;
+    }>;
+    resource: Record<string, unknown>;
+}
+/**
+ * Span exporter that stores spans in memory for retrieval.
+ */
+export declare class MemorySpanExporter implements SpanExporter {
+    private readonly _spans;
+    export(spans: ReadableSpan[]): Promise<{
+        code: ExportResultCode;
+    }>;
+    getSpans(): ReadableSpan[];
+    getSpansAsDicts(): SpanDict[];
+    private _formatTraceId;
+    private _formatSpanId;
+    private _spanToDict;
+    clear(): void;
+    shutdown(): Promise<void>;
+    forceFlush(): Promise<void>;
+}
+//# sourceMappingURL=exporter.d.ts.map

package/dist/exporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exporter.d.ts","sourceRoot":"","sources":["../src/exporter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAEhF,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,MAAM,EAAE;QACN,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,IAAI,CAAC;IACT,MAAM,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACrC,CAAC,CAAC;IACH,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,qBAAa,kBAAmB,YAAW,YAAY;IACrD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAE7C,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,gBAAgB,CAAA;KAAE,CAAC;IAKlE,QAAQ,IAAI,YAAY,EAAE;IAI1B,eAAe,IAAI,QAAQ,EAAE;IAI7B,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,WAAW;IA2CnB,KAAK,IAAI,IAAI;IAIb,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAIzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B"}

package/dist/exporter.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemorySpanExporter = void 0;
+const core_1 = require("@opentelemetry/core");
+/**
+ * Span exporter that stores spans in memory for retrieval.
+ */
+class MemorySpanExporter {
+    _spans = [];
+    export(spans) {
+        this._spans.push(...spans);
+        return Promise.resolve({ code: core_1.ExportResultCode.SUCCESS });
+    }
+    getSpans() {
+        return [...this._spans];
+    }
+    getSpansAsDicts() {
+        return this._spans.map((span) => this._spanToDict(span));
+    }
+    _formatTraceId(traceId) {
+        // Ensure trace ID is 32-character hex string
+        return traceId.padStart(32, "0").slice(0, 32);
+    }
+    _formatSpanId(spanId) {
+        // Ensure span ID is 16-character hex string
+        return spanId.padStart(16, "0").slice(0, 16);
+    }
+    _spanToDict(span) {
+        const spanCtx = span.spanContext();
+        const traceId = this._formatTraceId(spanCtx.traceId);
+        const spanId = this._formatSpanId(spanCtx.spanId);
+        const parentSpanId = span.parentSpanId
+            ? this._formatSpanId(span.parentSpanId)
+            : null;
+        return {
+            timestamp: new Date().toISOString(),
+            trace_id: traceId,
+            span_id: spanId,
+            parent_span_id: parentSpanId,
+            name: span.name,
+            kind: span.kind.toString(),
+            start_time_ns: BigInt(span.startTime[0]) * 1000000000n + BigInt(span.startTime[1]),
+            end_time_ns: span.endTime
+                ? BigInt(span.endTime[0]) * 1000000000n + BigInt(span.endTime[1])
+                : null,
+            duration_ms: span.endTime
+                ? (span.endTime[0] - span.startTime[0]) * 1000 +
+                    (span.endTime[1] - span.startTime[1]) / 1_000_000
+                : null,
+            attributes: span.attributes ? { ...span.attributes } : {},
+            status: span.status
+                ? {
+                    status_code: span.status.code.toString(),
+                    description: span.status.message,
+                }
+                : null,
+            events: (span.events || []).map((event) => ({
+                name: event.name,
+                timestamp_ns: BigInt(event.time[0]) * 1000000000n + BigInt(event.time[1]),
+                attributes: event.attributes ? { ...event.attributes } : {},
+            })),
+            resource: span.resource?.attributes
+                ? { ...span.resource.attributes }
+                : {},
+        };
+    }
+    clear() {
+        this._spans.length = 0;
+    }
+    shutdown() {
+        return Promise.resolve();
+    }
+    forceFlush() {
+        return Promise.resolve();
+    }
+}
+exports.MemorySpanExporter = MemorySpanExporter;
+//# sourceMappingURL=exporter.js.map

package/dist/exporter.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { CandidatePromptManager } from './candidate-prompt-manager';
+export { MemorySpanExporter, type SpanDict } from './exporter';
+export { TraceRunner, type TraceData } from './trace-runner';
+export { SpanType, Tracer } from './tracer';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Tracer = exports.SpanType = exports.TraceRunner = exports.MemorySpanExporter = exports.CandidatePromptManager = void 0;
+var candidate_prompt_manager_1 = require("./candidate-prompt-manager");
+Object.defineProperty(exports, "CandidatePromptManager", { enumerable: true, get: function () { return candidate_prompt_manager_1.CandidatePromptManager; } });
+var exporter_1 = require("./exporter");
+Object.defineProperty(exports, "MemorySpanExporter", { enumerable: true, get: function () { return exporter_1.MemorySpanExporter; } });
+var trace_runner_1 = require("./trace-runner");
+Object.defineProperty(exports, "TraceRunner", { enumerable: true, get: function () { return trace_runner_1.TraceRunner; } });
+var tracer_1 = require("./tracer");
+Object.defineProperty(exports, "SpanType", { enumerable: true, get: function () { return tracer_1.SpanType; } });
+Object.defineProperty(exports, "Tracer", { enumerable: true, get: function () { return tracer_1.Tracer; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,uEAAoE;AAA3D,kIAAA,sBAAsB,OAAA;AAC/B,uCAA+D;AAAtD,8GAAA,kBAAkB,OAAA;AAC3B,+CAA6D;AAApD,2GAAA,WAAW,OAAA;AACpB,mCAA4C;AAAnC,kGAAA,QAAQ,OAAA;AAAE,gGAAA,MAAM,OAAA"}

package/dist/trace-runner.d.ts

@@ -0,0 +1,67 @@
+import type { Tracer } from './tracer';
+export interface TraceData {
+    trace_id: string;
+    spans: Array<{
+        timestamp: string;
+        trace_id: string;
+        span_id: string;
+        parent_span_id: string | null;
+        name: string;
+        kind: string;
+        start_time_ns: bigint;
+        end_time_ns: bigint | null;
+        duration_ms: number | null;
+        attributes: Record<string, unknown>;
+        status: {
+            status_code: string;
+            description?: string;
+        } | null;
+        events: Array<{
+            name: string;
+            timestamp_ns: bigint;
+            attributes: Record<string, unknown>;
+        }>;
+        resource: Record<string, unknown>;
+    }>;
+}
+/**
+ * Wrapper around Tracer that manages candidate prompts and tracks trace_id.
+ *
+ * Usage:
+ *   const traceRunner = new TraceRunner(tracer, { "prompt1": "..." });
+ *
+ *   await traceRunner.run(async () => {
+ *     // ... tracing code ...
+ *   });
+ *
+ *   const traceData = traceRunner.record();
+ *   const traceId = traceData.trace_id;
+ *   const spans = traceData.spans;
+ */
+export declare class TraceRunner {
+    private readonly _tracer;
+    private readonly _cpm;
+    private readonly _candidatePrompts;
+    private _traceId;
+    private _contextEntered;
+    private _alreadyRecorded;
+    constructor(tracer: Tracer, candidatePrompts?: Record<string, string> | null);
+    /**
+     * Run a callback with candidate prompts set in the async context.
+     *
+     * All spans created within this context will be part of the same trace.
+     * The trace_id is captured from spans created within the context and can be retrieved via record().
+     *
+     * @param callback - Function to run within the tracing context
+     * @returns Result of the callback
+     */
+    run<T>(callback: () => Promise<T> | T): Promise<T>;
+    /**
+     * Export all spans and return the full trace with all child spans.
+     *
+     * @returns Dictionary with trace_id and spans
+     * @throws Error if called before context is entered or after already recorded
+     */
+    record(): Promise<TraceData>;
+}
+//# sourceMappingURL=trace-runner.d.ts.map

package/dist/trace-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-runner.d.ts","sourceRoot":"","sources":["../src/trace-runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGvC,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC;QACX,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,MAAM,EAAE;YACN,WAAW,EAAE,MAAM,CAAC;YACpB,WAAW,CAAC,EAAE,MAAM,CAAC;SACtB,GAAG,IAAI,CAAC;QACT,MAAM,EAAE,KAAK,CAAC;YACZ,IAAI,EAAE,MAAM,CAAC;YACb,YAAY,EAAE,MAAM,CAAC;YACrB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;SACrC,CAAC,CAAC;QACH,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,CAAC,CAAC;CACJ;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAyB;IAC9C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAgC;IAClE,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,gBAAgB,CAAS;gBAG/B,MAAM,EAAE,MAAM,EACd,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAUlD;;;;;;;;OAQG;IACG,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAqBxD;;;;;OAKG;IACG,MAAM,IAAI,OAAO,CAAC,SAAS,CAAC;CAmCnC"}

package/dist/trace-runner.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TraceRunner = void 0;
+const candidate_prompt_manager_1 = require("./candidate-prompt-manager");
+/**
+ * Wrapper around Tracer that manages candidate prompts and tracks trace_id.
+ *
+ * Usage:
+ *   const traceRunner = new TraceRunner(tracer, { "prompt1": "..." });
+ *
+ *   await traceRunner.run(async () => {
+ *     // ... tracing code ...
+ *   });
+ *
+ *   const traceData = traceRunner.record();
+ *   const traceId = traceData.trace_id;
+ *   const spans = traceData.spans;
+ */
+class TraceRunner {
+    _tracer;
+    _cpm;
+    _candidatePrompts;
+    _traceId;
+    _contextEntered = false;
+    _alreadyRecorded = false;
+    constructor(tracer, candidatePrompts) {
+        this._tracer = tracer;
+        this._cpm = new candidate_prompt_manager_1.CandidatePromptManager();
+        this._candidatePrompts = candidatePrompts ?? null;
+        this._traceId = undefined;
+        this._contextEntered = false;
+        this._alreadyRecorded = false;
+    }
+    /**
+     * Run a callback with candidate prompts set in the async context.
+     *
+     * All spans created within this context will be part of the same trace.
+     * The trace_id is captured from spans created within the context and can be retrieved via record().
+     *
+     * @param callback - Function to run within the tracing context
+     * @returns Result of the callback
+     */
+    async run(callback) {
+        if (this._alreadyRecorded) {
+            throw new Error('Cannot enter context after record() has been called');
+        }
+        // Set up candidate prompts context
+        return this._cpm.run(this._candidatePrompts, async () => {
+            this._contextEntered = true;
+            try {
+                const result = await callback();
+                // Capture trace_id from tracer after execution completes
+                this._traceId = this._tracer.getTraceId();
+                return result;
+            }
+            finally {
+                // Reset state when context exits
+                this._contextEntered = false;
+            }
+        });
+    }
+    /**
+     * Export all spans and return the full trace with all child spans.
+     *
+     * @returns Dictionary with trace_id and spans
+     * @throws Error if called before context is entered or after already recorded
+     */
+    async record() {
+        if (this._alreadyRecorded) {
+            throw new Error('record() can only be called once per TraceRunner instance');
+        }
+        // Capture trace_id from tracer if we haven't captured it yet
+        if (this._traceId === undefined) {
+            this._traceId = this._tracer.getTraceId();
+        }
+        if (this._traceId === undefined) {
+            throw new Error('trace_id could not be captured. Ensure spans are created within the context.');
+        }
+        // Force flush all pending spans
+        await this._tracer.forceFlush();
+        // Get all spans for this trace
+        const allSpans = this._tracer.getSpansAsDicts();
+        // Filter spans to only include those matching the trace_id
+        const traceSpans = allSpans.filter((span) => span.trace_id === this._traceId);
+        this._alreadyRecorded = true;
+        return {
+            trace_id: this._traceId,
+            spans: traceSpans,
+        };
+    }
+}
+exports.TraceRunner = TraceRunner;
+//# sourceMappingURL=trace-runner.js.map

package/dist/trace-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-runner.js","sourceRoot":"","sources":["../src/trace-runner.ts"],"names":[],"mappings":";;;AACA,yEAAoE;AA4BpE;;;;;;;;;;;;;GAaG;AACH,MAAa,WAAW;IACL,OAAO,CAAS;IAChB,IAAI,CAAyB;IAC7B,iBAAiB,CAAgC;IAC1D,QAAQ,CAAqB;IAC7B,eAAe,GAAG,KAAK,CAAC;IACxB,gBAAgB,GAAG,KAAK,CAAC;IAEjC,YACE,MAAc,EACd,gBAAgD;QAEhD,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,iDAAsB,EAAE,CAAC;QACzC,IAAI,CAAC,iBAAiB,GAAG,gBAAgB,IAAI,IAAI,CAAC;QAClD,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;QAC1B,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC;QAC7B,IAAI,CAAC,gBAAgB,GAAG,KAAK,CAAC;IAChC,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,GAAG,CAAI,QAA8B;QACzC,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACzE,CAAC;QAED,mCAAmC;QACnC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE,KAAK,IAAI,EAAE;YACtD,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;YAE5B,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,QAAQ,EAAE,CAAC;gBAChC,yDAAyD;gBACzD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;gBAC1C,OAAO,MAAM,CAAC;YAChB,CAAC;oBAAS,CAAC;gBACT,iCAAiC;gBACjC,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC;YAC/B,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,MAAM;QACV,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CACb,2DAA2D,CAC5D,CAAC;QACJ,CAAC;QAED,6DAA6D;QAC7D,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YAChC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QAC5C,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CACb,8EAA8E,CAC/E,CAAC;QACJ,CAAC;QAED,gCAAgC;QAChC,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QAEhC,+BAA+B;QAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;QAChD,2DAA2D;QAC3D,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAChC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ,CAC1C,CAAC;QAEF,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;QAE7B,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,KAAK,EAAE,UAAU;SAClB,CAAC;IACJ,CAAC;CACF;AA3FD,kCA2FC"}

package/dist/tracer.d.ts

@@ -0,0 +1,147 @@
+import { type Span } from "@opentelemetry/api";
+import type { SpanExporter } from "@opentelemetry/sdk-trace-base";
+import { ReadableSpan } from "@opentelemetry/sdk-trace-base";
+import { CandidatePromptManager } from "./candidate-prompt-manager";
+import { MemorySpanExporter } from "./exporter";
+type AnyFunction = (...args: unknown[]) => unknown;
+/**
+ * Span type for tracing different kinds of operations.
+ */
+export declare enum SpanType {
+    AGENT = "agent",
+    NODE = "node",
+    TOOL = "tool"
+}
+/**
+ * OpenTelemetry-based tracer that mimics agentbridge API.
+ */
+export declare class Tracer {
+    private readonly _tracer;
+    private readonly _cpm;
+    private readonly _memoryExporter;
+    private readonly _currentPromptSpan;
+    private readonly _llmStartTime;
+    private readonly _traceId;
+    constructor(serviceName: string, exporter?: SpanExporter, candidatePromptManager?: CandidatePromptManager);
+    /**
+     * Wraps a function to trace it as a span.
+     *
+     * @param spanType - Type of span (SpanType.AGENT, SpanType.NODE, or SpanType.TOOL)
+     * @param func - Function to wrap
+     * @returns Wrapped function
+     */
+    wrap<T extends AnyFunction>(spanType: SpanType, func: T): T;
+    /**
+     * Context manager for tracing prompt rendering and LLM calls.
+     *
+     * Usage:
+     *   const renderedPrompt = await tracer.prompt(
+     *     "translation",
+     *     promptTemplate,
+     *     { premises: [...], conclusion: "..." }
+     *   );
+     *   const result = await llm.invoke([{ role: "user", content: renderedPrompt }]);
+     *   tracer.addLlmOutput(result.content);
+     *
+     * @param promptName - Name of the prompt
+     * @param promptTemplate - Template string (Nunjucks format)
+     * @param inputVars - Variables to render into the template
+     * @returns Promise that resolves to the rendered prompt
+     */
+    prompt(promptName: string, promptTemplate: string, inputVars: Record<string, unknown>): Promise<string>;
+    /**
+     * Start a prompt span and return a context manager-like object.
+     *
+     * Usage:
+     *   const promptCtx = tracer.startPrompt("translation", template, vars);
+     *   const renderedPrompt = promptCtx.renderedPrompt;
+     *   // ... use renderedPrompt ...
+     *   tracer.addLlmOutput(result.content);
+     *   promptCtx.end();
+     *
+     * @param promptName - Name of the prompt
+     * @param promptTemplate - Template string (Nunjucks format)
+     * @param inputVars - Variables to render into the template
+     * @returns Object with renderedPrompt and end() method
+     */
+    startPrompt(promptName: string, promptTemplate: string, inputVars: Record<string, unknown>): {
+        renderedPrompt: string;
+        span: Span;
+        end: () => void;
+    };
+    /**
+     * Add LLM output metadata to the current prompt span.
+     *
+     * Usage:
+     *   tracer.addLLMOutput(result.content);
+     *   // or with more metadata:
+     *   tracer.addLlmOutput(
+     *     result.content,
+     *     "gpt-4",
+     *     { prompt_tokens: 100, completion_tokens: 50 }
+     *   );
+     *
+     * @param output - LLM output text
+     * @param model - Optional model name
+     * @param usage - Optional token usage information
+     */
+    addLLMOutput(output: string, model?: string, usage?: {
+        prompt_tokens?: number;
+        completion_tokens?: number;
+        total_tokens?: number;
+    }): void;
+    /**
+     * Get the current active span.
+     *
+     * @returns Current span or undefined
+     */
+    getCurrentSpan(): Span | undefined;
+    /**
+     * Add metadata to the current span.
+     *
+     * Usage:
+     *   tracer.addMetadata("decision", "True");
+     *
+     * @param key - Attribute key
+     * @param value - Attribute value
+     */
+    addMetadata(key: string, value: unknown): void;
+    /**
+     * Add an event to the current span.
+     *
+     * Usage:
+     *   tracer.addEvent("processing_started", { item_count: 10 });
+     *
+     * @param eventName - Name of the event
+     * @param attributes - Optional event attributes
+     */
+    addEvent(eventName: string, attributes?: Record<string, string | number | boolean>): void;
+    /**
+     * Get the trace_id from the current context.
+     *
+     * @returns trace_id as a 32-character hexadecimal string, or undefined if not available
+     */
+    getTraceId(): string | undefined;
+    /**
+     * Helper to format trace ID as 32-character hex string.
+     */
+    private _formatTraceId;
+    /**
+     * Force flush all pending spans.
+     */
+    forceFlush(): Promise<void>;
+    /**
+     * Get all collected spans from memory.
+     *
+     * @returns List of ReadableSpan objects for all spans collected so far
+     */
+    getSpans(): ReadableSpan[];
+    /**
+     * Get all collected spans as dictionaries.
+     *
+     * @returns List of span dictionaries with all span data
+     */
+    getSpansAsDicts(): ReturnType<MemorySpanExporter["getSpansAsDicts"]>;
+}
+export {};
+//# sourceMappingURL=tracer.d.ts.map

package/dist/tracer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracer.d.ts","sourceRoot":"","sources":["../src/tracer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,IAAI,EAAyB,MAAM,oBAAoB,CAAC;AAE/E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAGL,YAAY,EACb,MAAM,+BAA+B,CAAC;AAIvC,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,KAAK,WAAW,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;AAEnD;;GAEG;AACH,oBAAY,QAAQ;IAClB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,IAAI,SAAS;CACd;AAED;;GAEG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAC7D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAyB;IAC9C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqB;IACrD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA2C;IAC9E,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA6C;IAC3E,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgD;gBAGvE,WAAW,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,YAAY,EACvB,sBAAsB,CAAC,EAAE,sBAAsB;IAiCjD;;;;;;OAMG;IACH,IAAI,CAAC,CAAC,SAAS,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC;IA+E3D;;;;;;;;;;;;;;;;OAgBG;IACG,MAAM,CACV,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,MAAM,CAAC;IAgDlB;;;;;;;;;;;;;;OAcG;IACH,WAAW,CACT,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC;QACD,cAAc,EAAE,MAAM,CAAC;QACvB,IAAI,EAAE,IAAI,CAAC;QACX,GAAG,EAAE,MAAM,IAAI,CAAC;KACjB;IAiDD;;;;;;;;;;;;;;;OAeG;IACH,YAAY,CACV,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,EACd,KAAK,CAAC,EAAE;QACN,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,GACA,IAAI;IAqCP;;;;OAIG;IACH,cAAc,IAAI,IAAI,GAAG,SAAS;IAKlC;;;;;;;;OAQG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAkB9C;;;;;;;;OAQG;IACH,QAAQ,CACN,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GACrD,IAAI;IAOP;;;;OAIG;IACH,UAAU,IAAI,MAAM,GAAG,SAAS;IAKhC;;OAEG;IACH,OAAO,CAAC,cAAc;IAKtB;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAOjC;;;;OAIG;IACH,QAAQ,IAAI,YAAY,EAAE;IAI1B;;;;OAIG;IACH,eAAe,IAAI,UAAU,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,CAAC;CAGrE"}

package/dist/tracer.js

@@ -0,0 +1,379 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Tracer = exports.SpanType = void 0;
+const api_1 = require("@opentelemetry/api");
+const resources_1 = require("@opentelemetry/resources");
+const sdk_trace_base_1 = require("@opentelemetry/sdk-trace-base");
+const node_async_hooks_1 = require("node:async_hooks");
+const nunjucks_1 = __importDefault(require("nunjucks"));
+const candidate_prompt_manager_1 = require("./candidate-prompt-manager");
+const exporter_1 = require("./exporter");
+/**
+ * Span type for tracing different kinds of operations.
+ */
+var SpanType;
+(function (SpanType) {
+    SpanType["AGENT"] = "agent";
+    SpanType["NODE"] = "node";
+    SpanType["TOOL"] = "tool";
+})(SpanType || (exports.SpanType = SpanType = {}));
+/**
+ * OpenTelemetry-based tracer that mimics agentbridge API.
+ */
+class Tracer {
+    _tracer;
+    _cpm;
+    _memoryExporter;
+    _currentPromptSpan;
+    _llmStartTime;
+    _traceId;
+    constructor(serviceName, exporter, candidatePromptManager) {
+        const resource = resources_1.Resource.default().merge(new resources_1.Resource({
+            "service.name": serviceName,
+        }));
+        // Create memory exporter to collect spans (always used)
+        this._memoryExporter = new exporter_1.MemorySpanExporter();
+        // Prepare span processors
+        const spanProcessors = [new sdk_trace_base_1.BatchSpanProcessor(this._memoryExporter)];
+        if (exporter) {
+            spanProcessors.push(new sdk_trace_base_1.BatchSpanProcessor(exporter));
+        }
+        const provider = new sdk_trace_base_1.BasicTracerProvider({
+            resource,
+            spanProcessors,
+        });
+        api_1.trace.setGlobalTracerProvider(provider);
+        this._tracer = api_1.trace.getTracer(serviceName);
+        this._cpm = candidatePromptManager ?? new candidate_prompt_manager_1.CandidatePromptManager();
+        // Context-local state for prompt spans and timing
+        this._currentPromptSpan = new node_async_hooks_1.AsyncLocalStorage();
+        this._llmStartTime = new node_async_hooks_1.AsyncLocalStorage();
+        this._traceId = new node_async_hooks_1.AsyncLocalStorage();
+    }
+    /**
+     * Wraps a function to trace it as a span.
+     *
+     * @param spanType - Type of span (SpanType.AGENT, SpanType.NODE, or SpanType.TOOL)
+     * @param func - Function to wrap
+     * @returns Wrapped function
+     */
+    wrap(spanType, func) {
+        const wrapped = ((...args) => {
+            const span = this._tracer.startSpan(func.name);
+            const activeContext = api_1.trace.setSpan(api_1.context.active(), span);
+            // Capture trace_id from span context
+            const spanContext = span.spanContext();
+            if (spanContext.traceFlags !== undefined) {
+                const traceId = this._formatTraceId(spanContext.traceId);
+                // Store trace ID in async context for later retrieval
+                const currentStore = this._traceId.getStore();
+                if (!currentStore) {
+                    this._traceId.enterWith({ traceId });
+                }
+            }
+            span.setAttribute("span.type", spanType);
+            span.setAttribute("function.name", func.name);
+            // Add input metadata for agent spans
+            const inputArgs = args.slice(0);
+            try {
+                span.setAttribute("function.input", JSON.stringify(inputArgs));
+            }
+            catch {
+                // Skip if args can't be serialized
+            }
+            return api_1.context.with(activeContext, () => {
+                try {
+                    const result = func(...args);
+                    if (result instanceof Promise) {
+                        return result
+                            .then((res) => {
+                            try {
+                                span.setAttribute("function.result", JSON.stringify(res));
+                            }
+                            catch {
+                                // Skip if result can't be serialized
+                            }
+                            span.setStatus({ code: api_1.SpanStatusCode.OK });
+                            span.end();
+                            return res;
+                        })
+                            .catch((error) => {
+                            span.setStatus({
+                                code: api_1.SpanStatusCode.ERROR,
+                                message: error.message,
+                            });
+                            span.recordException(error);
+                            span.end();
+                            throw error;
+                        });
+                    }
+                    try {
+                        span.setAttribute("function.result", JSON.stringify(result));
+                    }
+                    catch {
+                        // Skip if result can't be serialized
+                    }
+                    span.setStatus({ code: api_1.SpanStatusCode.OK });
+                    span.end();
+                    return result;
+                }
+                catch (error) {
+                    const err = error instanceof Error ? error : new Error(String(error));
+                    span.setStatus({
+                        code: api_1.SpanStatusCode.ERROR,
+                        message: err.message,
+                    });
+                    span.recordException(err);
+                    span.end();
+                    throw error;
+                }
+            });
+        });
+        Object.defineProperty(wrapped, "name", { value: func.name });
+        return wrapped;
+    }
+    /**
+     * Context manager for tracing prompt rendering and LLM calls.
+     *
+     * Usage:
+     *   const renderedPrompt = await tracer.prompt(
+     *     "translation",
+     *     promptTemplate,
+     *     { premises: [...], conclusion: "..." }
+     *   );
+     *   const result = await llm.invoke([{ role: "user", content: renderedPrompt }]);
+     *   tracer.addLlmOutput(result.content);
+     *
+     * @param promptName - Name of the prompt
+     * @param promptTemplate - Template string (Nunjucks format)
+     * @param inputVars - Variables to render into the template
+     * @returns Promise that resolves to the rendered prompt
+     */
+    async prompt(promptName, promptTemplate, inputVars) {
+        const span = this._tracer.startSpan(promptName);
+        const activeContext = api_1.trace.setSpan(api_1.context.active(), span);
+        // Capture trace_id from span context and store in async context
+        const spanContext = span.spanContext();
+        if (spanContext.traceFlags !== undefined) {
+            const traceId = this._formatTraceId(spanContext.traceId);
+            // Store trace ID in async context for later retrieval
+            const currentStore = this._traceId.getStore();
+            if (!currentStore) {
+                this._traceId.enterWith({ traceId });
+            }
+        }
+        span.setAttribute("span.type", "prompt");
+        span.setAttribute("prompt.name", promptName);
+        span.setAttribute("prompt.template", promptTemplate);
+        span.setAttribute("prompt.input_vars", JSON.stringify(inputVars));
+        // Select effective template (apply candidate override if present) and render
+        const [effectiveTemplate, overrideApplied] = this._cpm.getEffectiveTemplate(promptName, promptTemplate);
+        span.setAttribute("prompt.override_applied", overrideApplied);
+        const renderedPrompt = nunjucks_1.default.renderString(effectiveTemplate, inputVars);
+        span.setAttribute("prompt.rendered_length", renderedPrompt.length);
+        span.addEvent("prompt_rendered");
+        const startTime = Date.now();
+        // Store span and start time in context for add_llm_output to use
+        // Use run() to ensure these are available in the async context
+        return this._currentPromptSpan.run({ span }, () => {
+            return this._llmStartTime.run({ time: startTime }, () => {
+                // Return the rendered prompt with active context
+                // The span and time will be available when addLlmOutput is called
+                // as long as it's called within this async context
+                return api_1.context.with(activeContext, async () => {
+                    return renderedPrompt;
+                });
+            });
+        });
+    }
+    /**
+     * Start a prompt span and return a context manager-like object.
+     *
+     * Usage:
+     *   const promptCtx = tracer.startPrompt("translation", template, vars);
+     *   const renderedPrompt = promptCtx.renderedPrompt;
+     *   // ... use renderedPrompt ...
+     *   tracer.addLlmOutput(result.content);
+     *   promptCtx.end();
+     *
+     * @param promptName - Name of the prompt
+     * @param promptTemplate - Template string (Nunjucks format)
+     * @param inputVars - Variables to render into the template
+     * @returns Object with renderedPrompt and end() method
+     */
+    startPrompt(promptName, promptTemplate, inputVars) {
+        const span = this._tracer.startSpan(promptName);
+        const activeContext = api_1.trace.setSpan(api_1.context.active(), span);
+        // Capture trace_id from span context and store in async context
+        const spanContext = span.spanContext();
+        if (spanContext.traceFlags !== undefined) {
+            const traceId = this._formatTraceId(spanContext.traceId);
+            // Store trace ID in async context for later retrieval
+            const currentStore = this._traceId.getStore();
+            if (!currentStore) {
+                this._traceId.enterWith({ traceId });
+            }
+        }
+        span.setAttribute("span.type", "prompt");
+        span.setAttribute("prompt.name", promptName);
+        span.setAttribute("prompt.template", promptTemplate);
+        span.setAttribute("prompt.input_vars", JSON.stringify(inputVars));
+        // Select effective template (apply candidate override if present) and render
+        const [effectiveTemplate, overrideApplied] = this._cpm.getEffectiveTemplate(promptName, promptTemplate);
+        span.setAttribute("prompt.override_applied", overrideApplied);
+        const renderedPrompt = nunjucks_1.default.renderString(effectiveTemplate, inputVars);
+        span.setAttribute("prompt.rendered_length", renderedPrompt.length);
+        span.addEvent("prompt_rendered");
+        const startTime = Date.now();
+        // Store span and start time in context for add_llm_output to use
+        // Note: These will only be available if addLlmOutput is called
+        // within the same async context chain
+        this._currentPromptSpan.enterWith({ span });
+        this._llmStartTime.enterWith({ time: startTime });
+        return {
+            renderedPrompt,
+            span,
+            end: () => {
+                span.end();
+            },
+        };
+    }
+    /**
+     * Add LLM output metadata to the current prompt span.
+     *
+     * Usage:
+     *   tracer.addLLMOutput(result.content);
+     *   // or with more metadata:
+     *   tracer.addLlmOutput(
+     *     result.content,
+     *     "gpt-4",
+     *     { prompt_tokens: 100, completion_tokens: 50 }
+     *   );
+     *
+     * @param output - LLM output text
+     * @param model - Optional model name
+     * @param usage - Optional token usage information
+     */
+    addLLMOutput(output, model, usage) {
+        const store = this._currentPromptSpan.getStore();
+        const timeStore = this._llmStartTime.getStore();
+        const span = store?.span ?? null;
+        const startTime = timeStore?.time ?? null;
+        if (!span || startTime === null) {
+            return;
+        }
+        const durationMs = Date.now() - startTime;
+        span.setAttribute("gen_ai.response", output.slice(0, 1000)); // Truncate
+        span.setAttribute("gen_ai.response.length", output.length);
+        span.setAttribute("llm.duration_ms", durationMs);
+        if (model) {
+            span.setAttribute("gen_ai.request.model", model);
+        }
+        if (usage) {
+            span.setAttribute("gen_ai.usage.prompt_tokens", usage.prompt_tokens ?? 0);
+            span.setAttribute("gen_ai.usage.completion_tokens", usage.completion_tokens ?? 0);
+            span.setAttribute("gen_ai.usage.total_tokens", usage.total_tokens ?? 0);
+        }
+        span.addEvent("llm_call_completed", {
+            duration_ms: durationMs,
+            response_length: output.length,
+        });
+        span.end();
+    }
+    /**
+     * Get the current active span.
+     *
+     * @returns Current span or undefined
+     */
+    getCurrentSpan() {
+        const span = api_1.trace.getActiveSpan();
+        return span;
+    }
+    /**
+     * Add metadata to the current span.
+     *
+     * Usage:
+     *   tracer.addMetadata("decision", "True");
+     *
+     * @param key - Attribute key
+     * @param value - Attribute value
+     */
+    addMetadata(key, value) {
+        const span = this.getCurrentSpan();
+        if (span) {
+            if (typeof value === "string" ||
+                typeof value === "number" ||
+                typeof value === "boolean") {
+                span.setAttribute(key, value);
+            }
+            else if (Array.isArray(value) || typeof value === "object") {
+                const serialized = JSON.stringify(value);
+                span.setAttribute(key, serialized.slice(0, 1000));
+            }
+            else {
+                span.setAttribute(key, String(value).slice(0, 1000));
+            }
+        }
+    }
+    /**
+     * Add an event to the current span.
+     *
+     * Usage:
+     *   tracer.addEvent("processing_started", { item_count: 10 });
+     *
+     * @param eventName - Name of the event
+     * @param attributes - Optional event attributes
+     */
+    addEvent(eventName, attributes) {
+        const span = this.getCurrentSpan();
+        if (span) {
+            span.addEvent(eventName, attributes);
+        }
+    }
+    /**
+     * Get the trace_id from the current context.
+     *
+     * @returns trace_id as a 32-character hexadecimal string, or undefined if not available
+     */
+    getTraceId() {
+        const store = this._traceId.getStore();
+        return store?.traceId;
+    }
+    /**
+     * Helper to format trace ID as 32-character hex string.
+     */
+    _formatTraceId(traceId) {
+        // Trace ID from OpenTelemetry is already a hex string, but ensure it's 32 chars
+        return traceId.padStart(32, "0").slice(0, 32);
+    }
+    /**
+     * Force flush all pending spans.
+     */
+    async forceFlush() {
+        const provider = api_1.trace.getTracerProvider();
+        if ("forceFlush" in provider) {
+            await provider.forceFlush();
+        }
+    }
+    /**
+     * Get all collected spans from memory.
+     *
+     * @returns List of ReadableSpan objects for all spans collected so far
+     */
+    getSpans() {
+        return this._memoryExporter.getSpans();
+    }
+    /**
+     * Get all collected spans as dictionaries.
+     *
+     * @returns List of span dictionaries with all span data
+     */
+    getSpansAsDicts() {
+        return this._memoryExporter.getSpansAsDicts();
+    }
+}
+exports.Tracer = Tracer;
+//# sourceMappingURL=tracer.js.map

package/dist/tracer.js.map

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

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@uselemma/tracing",
+  "version": "0.1.0",
+  "description": "OpenTelemetry-based tracing module for Lemma",
+  "license": "MIT",
+  "author": "Lemma",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/uselemma/tracing"
+  },
+  "homepage": "https://github.com/uselemma/tracing#readme",
+  "bugs": {
+    "url": "https://github.com/uselemma/tracing/issues"
+  },
+  "keywords": [
+    "opentelemetry",
+    "tracing",
+    "observability",
+    "monitoring",
+    "llm",
+    "instrumentation"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/core": "^2.2.0",
+    "@opentelemetry/resources": "^1.27.0",
+    "@opentelemetry/sdk-trace-base": "^1.27.0",
+    "nunjucks": "^3.2.4"
+  },
+  "devDependencies": {
+    "@trivago/prettier-plugin-sort-imports": "^5.2.2",
+    "@types/node": "^22.18.8",
+    "@types/nunjucks": "^3.2.6",
+    "prettier": "^3.6.2",
+    "prettier-plugin-tailwindcss": "^0.6.14",
+    "typescript": "^5.9.3"
+  },
+  "scripts": {
+    "type-check": "tsc --noEmit",
+    "build": "tsc",
+    "clean": "rm -rf dist"
+  }
+}