@primo-ai/observability 0.1.0

package/README.md

@@ -0,0 +1,79 @@
+# @primo-ai/observability
+
+Span, Tracer, and Metrics abstractions with an OpenTelemetry bridge.
+
+## Overview
+
+Provides the observability layer for AgentForge. All pipeline stages emit spans with attributes, and the framework exposes metrics for token usage, tool calls, and gate decisions.
+
+## Quick Example
+
+```typescript
+import { OTelBridge } from '@primo-ai/observability';
+import { EventBus } from '@primo-ai/core';
+import { BasicTracerProvider, InMemorySpanExporter, SimpleSpanProcessor } from '@opentelemetry/sdk-trace-base';
+
+const exporter = new InMemorySpanExporter();
+const provider = new BasicTracerProvider({
+  spanProcessors: [new SimpleSpanProcessor(exporter)],
+});
+
+const bus = new EventBus();
+const tracer = new OTelBridge({ tracerProvider: provider, eventBus: bus });
+
+// Use with an Agent
+const agent = new Agent({ model: 'deepseek/deepseek-v4-flash' }, { tracer });
+```
+
+## Key Exports
+
+| Export | Description |
+|--------|-------------|
+| `TracerImpl` | Default tracer implementation with span lifecycle |
+| `SpanImpl` | Span implementation with attributes and events |
+| `NoOpTracer` | No-op tracer for when observability is disabled |
+| `NoOpSpan` | No-op span that discards all data |
+| `OTelBridge` | Bridge connecting AgentForge spans to OpenTelemetry |
+| `InMemoryMetrics` | In-memory metrics collector (counter, gauge, histogram) |
+| `NoOpMetrics` | No-op metrics implementation |
+| `TestExporter` | Test utility for capturing spans |
+| `TraceCollector` | Collects and formats traces as JSON, console, or OTLP |
+| `formatTraceJson` | Formats traces as JSON |
+| `formatTraceConsole` | Formats traces for console output |
+| `formatTraceOtlp` | Formats traces as OTLP for export |
+
+## Span Types
+
+The SDK defines standard span types via `SpanType`:
+
+| Span Type | Description |
+|-----------|-------------|
+| `agent_run` | Full agent execution |
+| `model_step` | Single LLM invocation |
+| `tool_call` | Tool execution |
+| `processor_run` | Pipeline processor execution |
+| `llm.stream` | LLM streaming span |
+| `tool.execute` | Tool execution with hooks |
+| `harness.gate` | Gate decision (allow/deny) |
+| `harness.cost-cap` | Cost cap check |
+| `harness.token-budget` | Token budget check |
+| `session.lifecycle` | Session state transitions |
+| `context.build` | Context assembly |
+| `loop.iteration` | Agentic loop iteration |
+
+## Metrics
+
+```typescript
+import { InMemoryMetrics } from '@primo-ai/observability';
+
+const metrics = new InMemoryMetrics();
+metrics.increment('llm.calls', 1, { model: 'deepseek' });
+metrics.gauge('tokens.used', 150, { type: 'input' });
+metrics.histogram('tool.duration', 42, { tool: 'getWeather' });
+
+const snapshot = metrics.snapshot();
+```
+
+## Dependencies
+
+- `@primo-ai/sdk` -- Span, Tracer, Metrics interfaces

package/dist/exporter.d.ts

@@ -0,0 +1,9 @@
+import type { Tracer } from '@primo-ai/sdk';
+import { type SpanData } from './tracer.js';
+export declare class TestExporter {
+    private spans;
+    createTracer(): Tracer;
+    getSpans(): SpanData[];
+    clear(): 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,KAAK,EAAQ,MAAM,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAuBtD,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAsB;IAEnC,YAAY,IAAI,MAAM;IAgBtB,QAAQ,IAAI,QAAQ,EAAE;IAItB,KAAK,IAAI,IAAI;CAGd"}

package/dist/exporter.js

@@ -0,0 +1,38 @@
+import { SpanImpl } from './tracer.js';
+class ExporterSpan extends SpanImpl {
+    exporter;
+    constructor(exporter, name, traceId, spanId, parentSpanId) {
+        super(name, traceId, spanId, parentSpanId);
+        this.exporter = exporter;
+    }
+    startChild(name) {
+        const child = new ExporterSpan(this.exporter, name, (this.spanContext().traceId), crypto.randomUUID(), this.spanContext().spanId);
+        this.exporter['spans'].push(child);
+        return child;
+    }
+}
+export class TestExporter {
+    spans = [];
+    createTracer() {
+        const exporter = this;
+        return {
+            startSpan(name) {
+                const traceId = crypto.randomUUID();
+                const spanId = crypto.randomUUID();
+                const span = new ExporterSpan(exporter, name, traceId, spanId);
+                exporter.spans.push(span);
+                return span;
+            },
+            getCurrentSpan() {
+                return undefined;
+            },
+        };
+    }
+    getSpans() {
+        return this.spans.map((s) => s.toData());
+    }
+    clear() {
+        this.spans = [];
+    }
+}
+//# sourceMappingURL=exporter.js.map

package/dist/exporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exporter.js","sourceRoot":"","sources":["../src/exporter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAiB,MAAM,aAAa,CAAC;AAEtD,MAAM,YAAa,SAAQ,QAAQ;IAChB,QAAQ,CAAe;IAExC,YAAY,QAAsB,EAAE,IAAY,EAAE,OAAe,EAAE,MAAc,EAAE,YAAqB;QACtG,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;QAC3C,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,UAAU,CAAC,IAAY;QACrB,MAAM,KAAK,GAAG,IAAI,YAAY,CAC5B,IAAI,CAAC,QAAQ,EACb,IAAI,EACJ,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,EAC5B,MAAM,CAAC,UAAU,EAAE,EACnB,IAAI,CAAC,WAAW,EAAE,CAAC,MAAM,CAC1B,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnC,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAED,MAAM,OAAO,YAAY;IACf,KAAK,GAAmB,EAAE,CAAC;IAEnC,YAAY;QACV,MAAM,QAAQ,GAAG,IAAI,CAAC;QACtB,OAAO;YACL,SAAS,CAAC,IAAY;gBACpB,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;gBACpC,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;gBACnC,MAAM,IAAI,GAAG,IAAI,YAAY,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;gBAC/D,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC1B,OAAO,IAAI,CAAC;YACd,CAAC;YACD,cAAc;gBACZ,OAAO,SAAS,CAAC;YACnB,CAAC;SACF,CAAC;IACJ,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;IAClB,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { NoOpTracer, NoOpSpan } from './noop.js';
+export { TracerImpl, SpanImpl, NoOpMetrics, type SpanData, type OnSpanEndCallback } from './tracer.js';
+export { InMemoryMetrics, type HistogramStats, type MetricsSnapshot } from './metrics.js';
+export { TestExporter } from './exporter.js';
+export { OTelBridge, type OTelBridgeOptions, type EventBusLike } from './otel-bridge.js';
+export { TraceCollector, formatTraceJson, formatTraceConsole, formatTraceOtlp, type Trace, type TraceNode, type OtlpOptions } from './trace-collector.js';
+//# 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":"AAEA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,KAAK,QAAQ,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACvG,OAAO,EAAE,eAAe,EAAE,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAC1F,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACzF,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,kBAAkB,EAAE,eAAe,EAAE,KAAK,KAAK,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+// @primo-ai/observability — Span, Tracer, Metrics abstractions
+export { NoOpTracer, NoOpSpan } from './noop.js';
+export { TracerImpl, SpanImpl, NoOpMetrics } from './tracer.js';
+export { InMemoryMetrics } from './metrics.js';
+export { TestExporter } from './exporter.js';
+export { OTelBridge } from './otel-bridge.js';
+export { TraceCollector, formatTraceJson, formatTraceConsole, formatTraceOtlp } from './trace-collector.js';
+//# 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,+DAA+D;AAE/D,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAyC,MAAM,aAAa,CAAC;AACvG,OAAO,EAAE,eAAe,EAA6C,MAAM,cAAc,CAAC;AAC1F,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,UAAU,EAA6C,MAAM,kBAAkB,CAAC;AACzF,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,kBAAkB,EAAE,eAAe,EAAgD,MAAM,sBAAsB,CAAC"}

package/dist/metrics.d.ts

@@ -0,0 +1,33 @@
+import type { Metrics } from '@primo-ai/sdk';
+export interface HistogramStats {
+    count: number;
+    sum: number;
+    min: number;
+    max: number;
+    avg: number;
+}
+export interface MetricsSnapshot {
+    counters: Record<string, number>;
+    gauges: Record<string, number>;
+    histograms: Record<string, HistogramStats>;
+    labeledCounters: Record<string, number>;
+    labeledGauges: Record<string, number>;
+    labeledHistograms: Record<string, HistogramStats>;
+}
+export declare class InMemoryMetrics implements Metrics {
+    private counters;
+    private gauges;
+    private histograms;
+    private labeledCounters;
+    private labeledGauges;
+    private labeledHistograms;
+    increment(name: string, delta?: number, labels?: Record<string, string>): void;
+    gauge(name: string, value: number, labels?: Record<string, string>): void;
+    histogram(name: string, value: number, labels?: Record<string, string>): void;
+    getCounter(name: string, labels?: Record<string, string>): number;
+    getGauge(name: string, labels?: Record<string, string>): number | undefined;
+    getHistogram(name: string, labels?: Record<string, string>): HistogramStats | undefined;
+    snapshot(): MetricsSnapshot;
+    reset(): void;
+}
+//# sourceMappingURL=metrics.d.ts.map

package/dist/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC3C,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CACnD;AAaD,qBAAa,eAAgB,YAAW,OAAO;IAC7C,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,UAAU,CAAoC;IAGtD,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,iBAAiB,CAAoC;IAE7D,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAI,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IASzE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IASzE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAyB7E,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM;IAOjE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,GAAG,SAAS;IAO3E,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,cAAc,GAAG,SAAS;IAQvF,QAAQ,IAAI,eAAe;IAmB3B,KAAK,IAAI,IAAI;CAQd"}

package/dist/metrics.js

@@ -0,0 +1,113 @@
+/**
+ * Build a stable serialization key from a metric name and its labels.
+ * Labels are sorted alphabetically to ensure deterministic keys.
+ */
+function labelKey(name, labels) {
+    const parts = Object.keys(labels).sort().map((k) => `${k}=${labels[k]}`);
+    return `${name}|${parts.join(',')}`;
+}
+export class InMemoryMetrics {
+    counters = new Map();
+    gauges = new Map();
+    histograms = new Map();
+    // Labeled variants — keyed by `name|k1=v1,k2=v2`
+    labeledCounters = new Map();
+    labeledGauges = new Map();
+    labeledHistograms = new Map();
+    increment(name, delta = 1, labels) {
+        if (labels && Object.keys(labels).length > 0) {
+            const key = labelKey(name, labels);
+            this.labeledCounters.set(key, (this.labeledCounters.get(key) ?? 0) + delta);
+        }
+        else {
+            this.counters.set(name, (this.counters.get(name) ?? 0) + delta);
+        }
+    }
+    gauge(name, value, labels) {
+        if (labels && Object.keys(labels).length > 0) {
+            const key = labelKey(name, labels);
+            this.labeledGauges.set(key, value);
+        }
+        else {
+            this.gauges.set(name, value);
+        }
+    }
+    histogram(name, value, labels) {
+        if (labels && Object.keys(labels).length > 0) {
+            const key = labelKey(name, labels);
+            const existing = this.labeledHistograms.get(key);
+            if (existing) {
+                existing.count += 1;
+                existing.sum += value;
+                if (value < existing.min)
+                    existing.min = value;
+                if (value > existing.max)
+                    existing.max = value;
+            }
+            else {
+                this.labeledHistograms.set(key, { count: 1, sum: value, min: value, max: value });
+            }
+        }
+        else {
+            const existing = this.histograms.get(name);
+            if (existing) {
+                existing.count += 1;
+                existing.sum += value;
+                if (value < existing.min)
+                    existing.min = value;
+                if (value > existing.max)
+                    existing.max = value;
+            }
+            else {
+                this.histograms.set(name, { count: 1, sum: value, min: value, max: value });
+            }
+        }
+    }
+    getCounter(name, labels) {
+        if (labels && Object.keys(labels).length > 0) {
+            return this.labeledCounters.get(labelKey(name, labels)) ?? 0;
+        }
+        return this.counters.get(name) ?? 0;
+    }
+    getGauge(name, labels) {
+        if (labels && Object.keys(labels).length > 0) {
+            return this.labeledGauges.get(labelKey(name, labels));
+        }
+        return this.gauges.get(name);
+    }
+    getHistogram(name, labels) {
+        const map = (labels && Object.keys(labels).length > 0) ? this.labeledHistograms : this.histograms;
+        const key = (labels && Object.keys(labels).length > 0) ? labelKey(name, labels) : name;
+        const h = map.get(key);
+        if (!h)
+            return undefined;
+        return { ...h, avg: h.sum / h.count };
+    }
+    snapshot() {
+        const histograms = {};
+        for (const [name, h] of this.histograms) {
+            histograms[name] = { ...h, avg: h.sum / h.count };
+        }
+        const labeledHists = {};
+        for (const [key, h] of this.labeledHistograms) {
+            labeledHists[key] = { ...h, avg: h.sum / h.count };
+        }
+        return {
+            counters: Object.fromEntries(this.counters),
+            gauges: Object.fromEntries(this.gauges),
+            histograms,
+            labeledCounters: Object.fromEntries(this.labeledCounters),
+            labeledGauges: Object.fromEntries(this.labeledGauges),
+            labeledHistograms: labeledHists,
+        };
+    }
+    reset() {
+        this.counters.clear();
+        this.gauges.clear();
+        this.histograms.clear();
+        this.labeledCounters.clear();
+        this.labeledGauges.clear();
+        this.labeledHistograms.clear();
+    }
+}
+//# sourceMappingURL=metrics.js.map

package/dist/metrics.js.map

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

package/dist/noop.d.ts

@@ -0,0 +1,15 @@
+import type { Span, SpanContext, Tracer } from '@primo-ai/sdk';
+export declare class NoOpSpan implements Span {
+    readonly name: string;
+    constructor(name: string);
+    startChild(name: string): Span;
+    end(): void;
+    setAttribute(_key: string, _value: unknown): Span;
+    addEvent(_name: string, _attributes?: Record<string, unknown>): Span;
+    spanContext(): SpanContext;
+}
+export declare class NoOpTracer implements Tracer {
+    startSpan(name: string): Span;
+    getCurrentSpan(): Span | undefined;
+}
+//# sourceMappingURL=noop.d.ts.map

package/dist/noop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop.d.ts","sourceRoot":"","sources":["../src/noop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE/D,qBAAa,QAAS,YAAW,IAAI;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,MAAM;IAIxB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI9B,GAAG,IAAI,IAAI;IAEX,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAIjD,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIpE,WAAW,IAAI,WAAW;CAG3B;AAED,qBAAa,UAAW,YAAW,MAAM;IACvC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI7B,cAAc,IAAI,IAAI,GAAG,SAAS;CAGnC"}

package/dist/noop.js

@@ -0,0 +1,28 @@
+export class NoOpSpan {
+    name;
+    constructor(name) {
+        this.name = name;
+    }
+    startChild(name) {
+        return new NoOpSpan(name);
+    }
+    end() { }
+    setAttribute(_key, _value) {
+        return this;
+    }
+    addEvent(_name, _attributes) {
+        return this;
+    }
+    spanContext() {
+        return { spanId: '', traceId: '' };
+    }
+}
+export class NoOpTracer {
+    startSpan(name) {
+        return new NoOpSpan(name);
+    }
+    getCurrentSpan() {
+        return undefined;
+    }
+}
+//# sourceMappingURL=noop.js.map

package/dist/noop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop.js","sourceRoot":"","sources":["../src/noop.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,QAAQ;IACV,IAAI,CAAS;IAEtB,YAAY,IAAY;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,UAAU,CAAC,IAAY;QACrB,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,GAAG,KAAU,CAAC;IAEd,YAAY,CAAC,IAAY,EAAE,MAAe;QACxC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,QAAQ,CAAC,KAAa,EAAE,WAAqC;QAC3D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,WAAW;QACT,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACrC,CAAC;CACF;AAED,MAAM,OAAO,UAAU;IACrB,SAAS,CAAC,IAAY;QACpB,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,cAAc;QACZ,OAAO,SAAS,CAAC;IACnB,CAAC;CACF"}

package/dist/otel-bridge.d.ts

@@ -0,0 +1,20 @@
+import type { Span, Tracer } from '@primo-ai/sdk';
+import type { Tracer as OTelTracerType } from '@opentelemetry/api';
+export interface EventBusLike {
+    emit(eventType: string, data?: unknown): void;
+}
+export interface OTelBridgeOptions {
+    tracerProvider?: {
+        getTracer(name: string, version?: string): OTelTracerType;
+    };
+    tracerName?: string;
+    eventBus?: EventBusLike;
+}
+export declare class OTelBridge implements Tracer {
+    private readonly otelTracer;
+    private readonly eventBus?;
+    constructor(options?: OTelBridgeOptions);
+    startSpan(name: string): Span;
+    getCurrentSpan(): Span | undefined;
+}
+//# sourceMappingURL=otel-bridge.d.ts.map

package/dist/otel-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel-bridge.d.ts","sourceRoot":"","sources":["../src/otel-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAe,MAAM,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,KAAK,EAAwB,MAAM,IAAI,cAAc,EAAW,MAAM,oBAAoB,CAAC;AAIlG,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC/C;AAED,MAAM,WAAW,iBAAiB;IAChC,cAAc,CAAC,EAAE;QAAE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,cAAc,CAAA;KAAE,CAAC;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB;AAwDD,qBAAa,UAAW,YAAW,MAAM;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;IACxD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAe;gBAE7B,OAAO,CAAC,EAAE,iBAAiB;IAOvC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM7B,cAAc,IAAI,IAAI,GAAG,SAAS;CAGnC"}

package/dist/otel-bridge.js

@@ -0,0 +1,61 @@
+import { context, trace } from '@opentelemetry/api';
+import { NoOpSpan } from './noop.js';
+class OTelAdapterSpan {
+    name;
+    otelSpan;
+    otelTracer;
+    otelContext;
+    eventBus;
+    constructor(name, otelSpan, otelTracer, otelContext, eventBus) {
+        this.name = name;
+        this.otelSpan = otelSpan;
+        this.otelTracer = otelTracer;
+        this.otelContext = otelContext;
+        this.eventBus = eventBus;
+    }
+    startChild(childName) {
+        const childCtx = trace.setSpan(this.otelContext, this.otelSpan);
+        const childSpan = this.otelTracer.startSpan(childName, undefined, childCtx);
+        return new OTelAdapterSpan(childName, childSpan, this.otelTracer, childCtx, this.eventBus);
+    }
+    end() {
+        this.otelSpan.end();
+        if (this.eventBus) {
+            const ctx = this.otelSpan.spanContext();
+            this.eventBus.emit('span.end', {
+                name: this.name,
+                spanContext: { traceId: ctx.traceId, spanId: ctx.spanId },
+            });
+        }
+    }
+    setAttribute(key, value) {
+        this.otelSpan.setAttribute(key, value);
+        return this;
+    }
+    addEvent(name, attributes) {
+        this.otelSpan.addEvent(name, attributes);
+        return this;
+    }
+    spanContext() {
+        const ctx = this.otelSpan.spanContext();
+        return { spanId: ctx.spanId, traceId: ctx.traceId };
+    }
+}
+export class OTelBridge {
+    otelTracer;
+    eventBus;
+    constructor(options) {
+        this.otelTracer = options?.tracerProvider?.getTracer(options?.tracerName ?? '@primo-ai/observability');
+        this.eventBus = options?.eventBus;
+    }
+    startSpan(name) {
+        if (!this.otelTracer)
+            return new NoOpSpan(name);
+        const otelSpan = this.otelTracer.startSpan(name);
+        return new OTelAdapterSpan(name, otelSpan, this.otelTracer, context.active(), this.eventBus);
+    }
+    getCurrentSpan() {
+        return undefined;
+    }
+}
+//# sourceMappingURL=otel-bridge.js.map

package/dist/otel-bridge.js.map

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

package/dist/trace-collector.d.ts

@@ -0,0 +1,30 @@
+import type { Tracer } from '@primo-ai/sdk';
+import { type SpanData } from './tracer.js';
+export interface TraceNode {
+    span: SpanData;
+    children: TraceNode[];
+}
+export interface Trace {
+    traceId: string;
+    durationMs: number;
+    spans: SpanData[];
+    root?: TraceNode;
+}
+export declare class TraceCollector {
+    private _endedSpans;
+    private _traceId;
+    createTracer(): Tracer;
+    getTrace(): Trace;
+    clear(): void;
+    flush(): Trace;
+    /** Arrow field so CollectorSpan can reference it via closure without private-access issues. */
+    onSpanEnd: (data: SpanData) => void;
+    private buildTree;
+}
+export declare function formatTraceJson(trace: Trace): string;
+export declare function formatTraceConsole(trace: Trace): string;
+export interface OtlpOptions {
+    serviceName?: string;
+}
+export declare function formatTraceOtlp(trace: Trace, options?: OtlpOptions): string;
+//# sourceMappingURL=trace-collector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trace-collector.d.ts","sourceRoot":"","sources":["../src/trace-collector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAQ,MAAM,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEtD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,SAAS,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,KAAK;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AA4BD,qBAAa,cAAc;IACzB,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,QAAQ,CAAuB;IAEvC,YAAY,IAAI,MAAM;IAatB,QAAQ,IAAI,KAAK;IAWjB,KAAK,IAAI,IAAI;IAKb,KAAK,IAAI,KAAK;IAMd,+FAA+F;IAC/F,SAAS,GAAI,MAAM,QAAQ,KAAG,IAAI,CAGhC;IAEF,OAAO,CAAC,SAAS;CAoBlB;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAGpD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAMvD;AAkBD,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAuBD,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,MAAM,CA0C3E"}

package/dist/trace-collector.js

@@ -0,0 +1,156 @@
+import { SpanImpl } from './tracer.js';
+class CollectorSpan extends SpanImpl {
+    collector;
+    constructor(collector, name, traceId, spanId, parentSpanId) {
+        super(name, traceId, spanId, parentSpanId, (data) => collector.onSpanEnd(data));
+        this.collector = collector;
+    }
+    startChild(name) {
+        const child = new CollectorSpan(this.collector, name, this.spanContext().traceId, crypto.randomUUID(), this.spanContext().spanId);
+        return child;
+    }
+}
+export class TraceCollector {
+    _endedSpans = [];
+    _traceId = crypto.randomUUID();
+    createTracer() {
+        const collector = this;
+        const traceId = this._traceId;
+        return {
+            startSpan(name) {
+                return new CollectorSpan(collector, name, traceId, crypto.randomUUID());
+            },
+            getCurrentSpan() {
+                return undefined;
+            },
+        };
+    }
+    getTrace() {
+        const ended = this._endedSpans;
+        const root = this.buildTree(ended);
+        return {
+            traceId: this._traceId,
+            durationMs: root?.span.durationMs ?? 0,
+            spans: ended,
+            root,
+        };
+    }
+    clear() {
+        this._endedSpans = [];
+        this._traceId = crypto.randomUUID();
+    }
+    flush() {
+        const trace = this.getTrace();
+        this.clear();
+        return trace;
+    }
+    /** Arrow field so CollectorSpan can reference it via closure without private-access issues. */
+    onSpanEnd = (data) => {
+        if (!data.ended)
+            return;
+        this._endedSpans.push(data);
+    };
+    buildTree(spans) {
+        if (spans.length === 0)
+            return undefined;
+        const byId = new Map();
+        for (const span of spans) {
+            byId.set(span.spanId, { span, children: [] });
+        }
+        let root;
+        for (const node of byId.values()) {
+            if (node.span.parentSpanId) {
+                const parent = byId.get(node.span.parentSpanId);
+                parent?.children.push(node);
+            }
+            else {
+                root = node;
+            }
+        }
+        return root;
+    }
+}
+export function formatTraceJson(trace) {
+    if (!trace.root)
+        return 'null';
+    return JSON.stringify(trace, null, 2);
+}
+export function formatTraceConsole(trace) {
+    if (!trace.root)
+        return '(no trace)';
+    const lines = [];
+    renderNode(trace.root, 0, lines);
+    return lines.join('\n');
+}
+function renderNode(node, depth, lines) {
+    const indent = '  '.repeat(depth);
+    const attrs = Object.entries(node.span.attributes);
+    const attrStr = attrs.length > 0
+        ? ' ' + attrs.map(([k, v]) => `${k}=${v}`).join(' ')
+        : '';
+    lines.push(`${indent}${node.span.name} ${node.span.durationMs}ms${attrStr}`);
+    for (const child of node.children) {
+        renderNode(child, depth + 1, lines);
+    }
+}
+function toHex16(uuid) {
+    return uuid.replace(/-/g, '').slice(0, 16).toLowerCase();
+}
+function toHex32(uuid) {
+    return uuid.replace(/-/g, '').toLowerCase();
+}
+function msToNano(ms) {
+    return String(BigInt(ms) * 1000000n);
+}
+function toOtlpAttributes(attrs) {
+    return Object.entries(attrs).map(([key, value]) => {
+        if (typeof value === 'string')
+            return { key, value: { stringValue: value } };
+        if (typeof value === 'number')
+            return { key, value: { intValue: String(value) } };
+        if (typeof value === 'boolean')
+            return { key, value: { boolValue: value } };
+        return { key, value: { stringValue: String(value) } };
+    });
+}
+export function formatTraceOtlp(trace, options) {
+    if (!trace.root) {
+        return JSON.stringify({ resourceSpans: [] });
+    }
+    const serviceName = options?.serviceName ?? 'agentforge';
+    const otlpSpans = trace.spans.map((span) => {
+        const otlpSpan = {
+            traceId: toHex32(span.traceId),
+            spanId: toHex16(span.spanId),
+            name: span.name,
+            kind: 1,
+            startTimeUnixNano: msToNano(span.startTime),
+            endTimeUnixNano: msToNano(span.endTime),
+            attributes: toOtlpAttributes(span.attributes),
+            status: {},
+        };
+        if (span.parentSpanId) {
+            otlpSpan.parentSpanId = toHex16(span.parentSpanId);
+        }
+        if (span.events.length > 0) {
+            otlpSpan.events = span.events.map((ev) => ({
+                name: ev.name,
+                timeUnixNano: msToNano(span.startTime),
+                attributes: ev.attributes ? toOtlpAttributes(ev.attributes) : [],
+            }));
+        }
+        return otlpSpan;
+    });
+    return JSON.stringify({
+        resourceSpans: [{
+                resource: {
+                    attributes: [{ key: 'service.name', value: { stringValue: serviceName } }],
+                },
+                scopeSpans: [{
+                        scope: { name: '@primo-ai/observability' },
+                        spans: otlpSpans,
+                    }],
+            }],
+    });
+}
+//# sourceMappingURL=trace-collector.js.map

package/dist/trace-collector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-collector.js","sourceRoot":"","sources":["../src/trace-collector.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAiB,MAAM,aAAa,CAAC;AActD,MAAM,aAAc,SAAQ,QAAQ;IACjB,SAAS,CAAiB;IAE3C,YACE,SAAyB,EACzB,IAAY,EACZ,OAAe,EACf,MAAc,EACd,YAAqB;QAErB,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QAChF,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED,UAAU,CAAC,IAAY;QACrB,MAAM,KAAK,GAAG,IAAI,aAAa,CAC7B,IAAI,CAAC,SAAS,EACd,IAAI,EACJ,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,EAC1B,MAAM,CAAC,UAAU,EAAE,EACnB,IAAI,CAAC,WAAW,EAAE,CAAC,MAAM,CAC1B,CAAC;QACF,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAED,MAAM,OAAO,cAAc;IACjB,WAAW,GAAe,EAAE,CAAC;IAC7B,QAAQ,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;IAEvC,YAAY;QACV,MAAM,SAAS,GAAG,IAAI,CAAC;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,OAAO;YACL,SAAS,CAAC,IAAY;gBACpB,OAAO,IAAI,aAAa,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;YAC1E,CAAC;YACD,cAAc;gBACZ,OAAO,SAAS,CAAC;YACnB,CAAC;SACF,CAAC;IACJ,CAAC;IAED,QAAQ;QACN,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC;QAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACnC,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,QAAQ;YACtB,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,UAAU,IAAI,CAAC;YACtC,KAAK,EAAE,KAAK;YACZ,IAAI;SACL,CAAC;IACJ,CAAC;IAED,KAAK;QACH,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;QACtB,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;IACtC,CAAC;IAED,KAAK;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,OAAO,KAAK,CAAC;IACf,CAAC;IAED,+FAA+F;IAC/F,SAAS,GAAG,CAAC,IAAc,EAAQ,EAAE;QACnC,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO;QACxB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC,CAAC;IAEM,SAAS,CAAC,KAAiB;QACjC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAEzC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAqB,CAAC;QAC1C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;QAChD,CAAC;QAED,IAAI,IAA2B,CAAC;QAChC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YACjC,IAAI,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;gBAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBAChD,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9B,CAAC;iBAAM,CAAC;gBACN,IAAI,GAAG,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED,MAAM,UAAU,eAAe,CAAC,KAAY;IAC1C,IAAI,CAAC,KAAK,CAAC,IAAI;QAAE,OAAO,MAAM,CAAC;IAC/B,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAY;IAC7C,IAAI,CAAC,KAAK,CAAC,IAAI;QAAE,OAAO,YAAY,CAAC;IAErC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;IACjC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,UAAU,CAAC,IAAe,EAAE,KAAa,EAAE,KAAe;IACjE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC;QAC9B,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QACpD,CAAC,CAAC,EAAE,CAAC;IACP,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,KAAK,OAAO,EAAE,CAAC,CAAC;IAC7E,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClC,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC;AACH,CAAC;AAUD,SAAS,OAAO,CAAC,IAAY;IAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AAC3D,CAAC;AAED,SAAS,OAAO,CAAC,IAAY;IAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AAC9C,CAAC;AAED,SAAS,QAAQ,CAAC,EAAU;IAC1B,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,QAAU,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,gBAAgB,CAAC,KAA8B;IACtD,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QAChD,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,CAAC;QAC7E,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;QAClF,IAAI,OAAO,KAAK,KAAK,SAAS;YAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC;QAC5E,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;IACxD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAY,EAAE,OAAqB;IACjE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,YAAY,CAAC;IAEzD,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACzC,MAAM,QAAQ,GAA4B;YACxC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;YAC9B,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;YAC5B,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,CAAC;YACP,iBAAiB,EAAE,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC;YAC3C,eAAe,EAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC;YACvC,UAAU,EAAE,gBAAgB,CAAC,IAAI,CAAC,UAAU,CAAC;YAC7C,MAAM,EAAE,EAAE;SACX,CAAC;QACF,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,QAAQ,CAAC,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACrD,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;gBACzC,IAAI,EAAE,EAAE,CAAC,IAAI;gBACb,YAAY,EAAE,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC;gBACtC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,gBAAgB,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE;aACjE,CAAC,CAAC,CAAC;QACN,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,aAAa,EAAE,CAAC;gBACd,QAAQ,EAAE;oBACR,UAAU,EAAE,CAAC,EAAE,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,EAAE,CAAC;iBAC3E;gBACD,UAAU,EAAE,CAAC;wBACX,KAAK,EAAE,EAAE,IAAI,EAAE,yBAAyB,EAAE;wBAC1C,KAAK,EAAE,SAAS;qBACjB,CAAC;aACH,CAAC;KACH,CAAC,CAAC;AACL,CAAC"}

package/dist/tracer.d.ts

@@ -0,0 +1,54 @@
+import type { Metrics, Span, SpanContext, Tracer } from '@primo-ai/sdk';
+export interface SpanData {
+    name: string;
+    spanId: string;
+    traceId: string;
+    parentSpanId?: string;
+    attributes: Record<string, unknown>;
+    events: Array<{
+        name: string;
+        attributes?: Record<string, unknown>;
+    }>;
+    ended: boolean;
+    startTime: number;
+    endTime: number;
+    durationMs: number;
+}
+export type OnSpanEndCallback = (span: SpanData) => void;
+export declare class SpanImpl implements Span {
+    readonly name: string;
+    private readonly _traceId;
+    private readonly _spanId;
+    private readonly _parentSpanId?;
+    private readonly _onSpanEnd?;
+    private _ended;
+    private _attributes;
+    private _events;
+    private readonly _startTime;
+    constructor(name: string, traceId: string, spanId: string, parentSpanId?: string, onSpanEnd?: OnSpanEndCallback);
+    startChild(name: string): Span;
+    end(): void;
+    get startTime(): number;
+    setAttribute(key: string, value: unknown): Span;
+    addEvent(name: string, attributes?: Record<string, unknown>): Span;
+    spanContext(): SpanContext;
+    get parentSpanId(): string | undefined;
+    get ended(): boolean;
+    toData(): SpanData;
+}
+export declare class TracerImpl implements Tracer {
+    private readonly _traceId;
+    private readonly _onSpanEnd?;
+    private _currentSpan;
+    constructor(onSpanEnd?: OnSpanEndCallback);
+    startSpan(name: string): Span;
+    get traceId(): string;
+    getCurrentSpan(): Span | undefined;
+    withSpan<T>(span: Span, fn: () => T): T;
+}
+export declare class NoOpMetrics implements Metrics {
+    increment(_name: string, _delta?: number, _labels?: Record<string, string>): void;
+    gauge(_name: string, _value: number, _labels?: Record<string, string>): void;
+    histogram(_name: string, _value: number, _labels?: Record<string, string>): void;
+}
+//# 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":"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"}

package/dist/tracer.js

@@ -0,0 +1,96 @@
+export class SpanImpl {
+    name;
+    _traceId;
+    _spanId;
+    _parentSpanId;
+    _onSpanEnd;
+    _ended = false;
+    _attributes = {};
+    _events = [];
+    _startTime;
+    constructor(name, traceId, spanId, parentSpanId, onSpanEnd) {
+        this.name = name;
+        this._traceId = traceId;
+        this._spanId = spanId;
+        this._parentSpanId = parentSpanId;
+        this._onSpanEnd = onSpanEnd;
+        this._startTime = Date.now();
+    }
+    startChild(name) {
+        return new SpanImpl(name, this._traceId, crypto.randomUUID(), this._spanId, this._onSpanEnd);
+    }
+    end() {
+        this._ended = true;
+        this._onSpanEnd?.(this.toData());
+    }
+    get startTime() {
+        return this._startTime;
+    }
+    setAttribute(key, value) {
+        this._attributes[key] = value;
+        return this;
+    }
+    addEvent(name, attributes) {
+        this._events.push({ name, attributes });
+        return this;
+    }
+    spanContext() {
+        return { spanId: this._spanId, traceId: this._traceId };
+    }
+    get parentSpanId() {
+        return this._parentSpanId;
+    }
+    get ended() {
+        return this._ended;
+    }
+    toData() {
+        const endTime = this._ended ? Date.now() : this._startTime;
+        return {
+            name: this.name,
+            spanId: this._spanId,
+            traceId: this._traceId,
+            parentSpanId: this._parentSpanId,
+            attributes: { ...this._attributes },
+            events: [...this._events],
+            ended: this._ended,
+            startTime: this._startTime,
+            endTime,
+            durationMs: endTime - this._startTime,
+        };
+    }
+}
+export class TracerImpl {
+    _traceId;
+    _onSpanEnd;
+    _currentSpan;
+    constructor(onSpanEnd) {
+        this._traceId = crypto.randomUUID();
+        this._onSpanEnd = onSpanEnd;
+    }
+    startSpan(name) {
+        const spanId = crypto.randomUUID();
+        return new SpanImpl(name, this._traceId, spanId, undefined, this._onSpanEnd);
+    }
+    get traceId() {
+        return this._traceId;
+    }
+    getCurrentSpan() {
+        return this._currentSpan;
+    }
+    withSpan(span, fn) {
+        const previous = this._currentSpan;
+        this._currentSpan = span;
+        try {
+            return fn();
+        }
+        finally {
+            this._currentSpan = previous;
+        }
+    }
+}
+export class NoOpMetrics {
+    increment(_name, _delta, _labels) { }
+    gauge(_name, _value, _labels) { }
+    histogram(_name, _value, _labels) { }
+}
+//# 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,30 @@
+{
+  "name": "@primo-ai/observability",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": ["dist"],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run --passWithNoTests",
+    "check-types": "tsc --noEmit",
+    "lint": "eslint src __tests__"
+  },
+  "devDependencies": {
+    "@primo-ai/sdk": "workspace:*",
+    "@opentelemetry/resources": "^2.7.1",
+    "@opentelemetry/sdk-trace-base": "^2.7.1",
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.5"
+  },
+  "dependencies": {
+    "@opentelemetry/api": "^1.9.1"
+  }
+}