@vinhnt-sdk/trace 0.4.2 → 0.4.3

package/README.md

@@ -0,0 +1,183 @@
+# @vinhnt-sdk/trace
+
+> Version: 0.4.3 | Status: STABLE
+
+Observability for vinhnt-sdk — OpenTelemetry-compatible spans, timeline replay, telemetry aggregation, and cost tracking.
+
+## Install
+
+`ash
+# npm
+npm install @vinhnt-sdk/trace
+
+# pnpm (monorepo)
+pnpm add @vinhnt-sdk/trace
+`
+
+## Features
+
+- **SpanRecorder** — Record and query OpenTelemetry-compatible spans
+- **Timeline** — Build transcripts from run events for replay
+- **CostMeter** — Track token usage and calculate costs per model
+- **ContextPressure** — Monitor context window utilization
+- **TelemetryProvider** — Interface for custom telemetry backends
+- **OTLP exporter** — `createOtlpSpanExporter` ships spans to any OTLP/HTTP collector (optional)
+- **DEFAULT_MODEL_PRICING** — Built-in pricing for common models
+
+## Quick Start
+
+`	ypescript
+import {
+  SpanRecorder, createSpan, endSpan,
+  CostMeter, calculateCost, DEFAULT_MODEL_PRICING,
+  Timeline, buildTranscript,
+} from "@vinhnt-sdk/trace";
+
+// Create and record spans
+const recorder = new SpanRecorder();
+const span = createSpan({ name: "llm-call", kind: "client" });
+recorder.record(span);
+
+// ... do work ...
+
+endSpan(span, { status: "ok" });
+
+// Calculate costs
+const meter = new CostMeter();
+meter.record({
+  inputTokens: 1000,
+  outputTokens: 500,
+  model: "gpt-4o",
+});
+console.log(meter.totalCost); // Cost in USD
+
+// Build transcript from events
+const transcript = buildTranscript(events);
+console.log(transcript);
+`
+
+## API Reference
+
+### Tracing
+
+| Export | Type | Description |
+|--------|------|-------------|
+| SpanRecorder | Class | Record and query spans |
+| createSpan | Function | Create a new span |
+| endSpan | Function | End a span with status |
+| ddSpanEvent | Function | Add an event to a span |
+| generateTraceId | Function | Generate a unique trace ID |
+
+### Span Types
+
+| Export | Type | Description |
+|--------|------|-------------|
+| Span | Interface | A single trace span |
+| SpanKind | Type | Span type (client, server, internal) |
+| SpanStatus | Type | Span completion status |
+| SpanEvent | Interface | Event within a span |
+| SpanNode | Interface | Span tree node |
+| TraceContext | Interface | Trace propagation context |
+
+### Timeline
+
+| Export | Type | Description |
+|--------|------|-------------|
+| Timeline | Class | Build and query run timelines |
+| uildTranscript | Function | Build transcript from events |
+| TimelineEvent | Interface | Event in a timeline |
+| TranscriptEntry | Interface | Transcript line item |
+
+### Telemetry
+
+| Export | Type | Description |
+|--------|------|-------------|
+| CostMeter | Class | Track token costs |
+| calculateCost | Function | Calculate cost from tokens |
+| calculateContextPressure | Function | Calculate context utilization |
+| DEFAULT_MODEL_PRICING | Constant | Default pricing for common models |
+| ConsoleTelemetryProvider | Class | Console-based telemetry output |
+
+### Telemetry Types
+
+| Export | Type | Description |
+|--------|------|-------------|
+| UsageStats | Interface | Token usage statistics |
+| ModelPricing | Interface | Per-1M-token pricing |
+| ContextPressure | Interface | Context window utilization |
+| TelemetryProvider | Interface | Custom telemetry backend |
+
+### OTLP Export (P1-9)
+
+| Export | Type | Description |
+|--------|------|-------------|
+| createOtlpSpanExporter | Function | OTLP/HTTP JSON exporter (config or env endpoint) |
+| resolveOtlpEndpoint | Function | Resolve endpoint from config / `OTEL_EXPORTER_OTLP_*` |
+| mapSpanToOtlp | Function | Map custom `Span` → OTLP JSON span |
+| buildOtlpExportRequest | Function | Wrap spans into `ExportTraceServiceRequest` |
+| SpanExporter | Interface | `export(spans)` / `shutdown()` seam |
+
+Endpoint resolution (first match wins):
+
+1. `config.endpoint`
+2. `OTEL_EXPORTER_OTLP_TRACES_ENDPOINT`
+3. `OTEL_EXPORTER_OTLP_ENDPOINT` + `/v1/traces`
+
+Headers: `OTEL_EXPORTER_OTLP_HEADERS` (`k1=v1,k2=v2`) merged with `config.headers`.
+Resource: `config.resourceAttributes` (default `service.name=vinhnt-sdk`, override via `OTEL_SERVICE_NAME` in attributes).
+
+```typescript
+import { createOtlpSpanExporter, SpanRecorder } from "@vinhnt-sdk/trace";
+
+const recorder = new SpanRecorder();
+// ... record spans ...
+
+const exporter = createOtlpSpanExporter({
+  endpoint: "http://localhost:4318/v1/traces", // or set env only
+  resourceAttributes: { "service.name": "my-agent", "deployment.environment": "dev" },
+});
+await exporter.export(recorder.getSpans());
+await exporter.shutdown();
+```
+
+No exporter is created unless you call `createOtlpSpanExporter` — default telemetry path unchanged.
+
+## Usage Examples
+
+### Cost Tracking
+
+`	ypescript
+import { CostMeter, DEFAULT_MODEL_PRICING } from "@vinhnt-sdk/trace";
+
+const meter = new CostMeter();
+
+// Track usage across multiple calls
+meter.record({ inputTokens: 1000, outputTokens: 500, model: "gpt-4o" });
+meter.record({ inputTokens: 2000, outputTokens: 1000, model: "gpt-4o-mini" });
+
+console.log(meter.totalCost); // Total cost in USD
+`
+
+### Custom Telemetry Provider
+
+`	ypescript
+import type { TelemetryProvider } from "@vinhnt-sdk/trace";
+
+const customProvider: TelemetryProvider = {
+  name: "datadog",
+  async recordSpan(span) {
+    await sendToDatadog(span);
+  },
+  async recordUsage(usage) {
+    await sendMetricsToDatadog(usage);
+  },
+};
+`
+
+## Dependencies
+
+- @vinhnt-sdk/schema >=0.5.0
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -11,6 +11,8 @@ export { SpanRecorder, createSpan, endSpan, addSpanEvent, generateTraceId, } fro
 export type { Span, SpanKind, SpanStatus, SpanEvent, SpanNode, TraceContext } from "./tracing.js";
 export { Timeline, buildTranscript } from "./timeline.js";
 export type { TimelineEvent, TimelineEventType, TranscriptEntry } from "./timeline.js";
-export { CostMeter, calculateCost, calculateContextPressure, DEFAULT_MODEL_PRICING, MODEL_PRICING } from "./telemetry.js";
-export type { UsageStats, ModelPricing, ContextPressure } from "./telemetry.js";
+export { CostMeter, calculateCost, calculateContextPressure, DEFAULT_MODEL_PRICING, MODEL_PRICING, ConsoleTelemetryProvider } from "./telemetry.js";
+export type { UsageStats, ModelPricing, ContextPressure, TelemetryProvider } from "./telemetry.js";
+export { createOtlpSpanExporter, resolveOtlpEndpoint, parseOtlpHeaders, mapSpanToOtlp, buildOtlpExportRequest, toOtlpAnyValue, toOtlpAttributes, toOtlpId, msToUnixNano, OTLP_SPAN_KIND, OTLP_STATUS_OK, OTLP_STATUS_ERROR, OTLP_STATUS_UNSET, } from "./otlp-exporter.js";
+export type { OtlpExporterConfig, SpanExporter, FetchLike, OtlpAnyValue, OtlpKeyValue, OtlpSpan, OtlpSpanEvent, OtlpSpanStatus, OtlpResourceSpans, OtlpExportTraceRequest, } from "./otlp-exporter.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;;;;;;;;GAQG;AAGH,OAAO,EACL,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,EAC/C,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGlG,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC1D,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGvF,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC1H,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EACL,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,EAC/C,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGlG,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC1D,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGvF,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,aAAa,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AACpJ,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGnG,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,sBAAsB,EACtB,cAAc,EACd,gBAAgB,EAChB,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,kBAAkB,EAClB,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -12,5 +12,7 @@ export { SpanRecorder, createSpan, endSpan, addSpanEvent, generateTraceId, } fro
 // ── Timeline ──
 export { Timeline, buildTranscript } from "./timeline.js";
 // ── Telemetry ──
-export { CostMeter, calculateCost, calculateContextPressure, DEFAULT_MODEL_PRICING, MODEL_PRICING } from "./telemetry.js";
+export { CostMeter, calculateCost, calculateContextPressure, DEFAULT_MODEL_PRICING, MODEL_PRICING, ConsoleTelemetryProvider } from "./telemetry.js";
+// ── OTLP export (P1-9) ──
+export { createOtlpSpanExporter, resolveOtlpEndpoint, parseOtlpHeaders, mapSpanToOtlp, buildOtlpExportRequest, toOtlpAnyValue, toOtlpAttributes, toOtlpId, msToUnixNano, OTLP_SPAN_KIND, OTLP_STATUS_OK, OTLP_STATUS_ERROR, OTLP_STATUS_UNSET, } from "./otlp-exporter.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;;;;;;;;GAQG;AAEH,gBAAgB;AAChB,OAAO,EACL,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,EAC/C,eAAe,GAChB,MAAM,cAAc,CAAC;AAGtB,iBAAiB;AACjB,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAG1D,kBAAkB;AAClB,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,gBAAgB;AAChB,OAAO,EACL,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,EAC/C,eAAe,GAChB,MAAM,cAAc,CAAC;AAGtB,iBAAiB;AACjB,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAG1D,kBAAkB;AAClB,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,aAAa,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAGpJ,2BAA2B;AAC3B,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,sBAAsB,EACtB,cAAc,EACd,gBAAgB,EAChB,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC"}

package/dist/otlp-exporter.d.ts

@@ -0,0 +1,141 @@
+/**
+ * OTLP/HTTP span exporter — maps custom Span → OTLP ExportTraceServiceRequest.
+ *
+ * Zero hard deps: pure JSON encoding over fetch (no @opentelemetry/* runtime dep).
+ * Endpoint/headers/service name resolved from config first, then standard OTEL env vars.
+ * Default path (no createOtlpSpanExporter call) remains unchanged — no-op / console telemetry.
+ *
+ * Env (read unless overridden in config):
+ *   OTEL_EXPORTER_OTLP_TRACES_ENDPOINT  full URL for /v1/traces
+ *   OTEL_EXPORTER_OTLP_ENDPOINT         base URL → <base>/v1/traces
+ *   OTEL_EXPORTER_OTLP_HEADERS          k1=v1,k2=v2
+ *   OTEL_SERVICE_NAME                   resource attribute service.name
+ */
+import type { Span } from "./tracing.js";
+/** Minimal fetch shape (injectable for tests / custom runtimes). */
+export type FetchLike = (input: string, init?: RequestInit) => Promise<Response>;
+/** Config for createOtlpSpanExporter — all fields optional; env fills gaps. */
+export interface OtlpExporterConfig {
+    /** Full OTLP/HTTP traces endpoint (overrides env). */
+    endpoint?: string;
+    /** Extra HTTP headers merged over env headers. */
+    headers?: Record<string, string>;
+    /** Resource attributes (service.name etc.). */
+    resourceAttributes?: Record<string, unknown>;
+    /** Export timeout in ms (default 10000). */
+    timeoutMs?: number;
+    /** Instrumentation scope name (default @vinhnt-sdk/trace). */
+    scopeName?: string;
+    /** Instrumentation scope version. */
+    scopeVersion?: string;
+    /** Env source for resolution (default process.env). Injectable for tests. */
+    env?: Record<string, string | undefined>;
+    /** Custom fetch (default globalThis.fetch). */
+    fetch?: FetchLike;
+}
+/** Span exporter seam — default path stays no-op unless an exporter is wired. */
+export interface SpanExporter {
+    export(spans: readonly Span[]): Promise<void>;
+    shutdown(): Promise<void>;
+}
+export type OtlpAnyValue = {
+    stringValue: string;
+} | {
+    boolValue: boolean;
+} | {
+    intValue: string;
+} | {
+    doubleValue: number;
+} | {
+    arrayValue: {
+        values: OtlpAnyValue[];
+    };
+} | {
+    kvlistValue: {
+        values: Array<{
+            key: string;
+            value: OtlpAnyValue;
+        }>;
+    };
+};
+export interface OtlpKeyValue {
+    key: string;
+    value: OtlpAnyValue;
+}
+export interface OtlpSpanEvent {
+    timeUnixNano: string;
+    name: string;
+    attributes?: OtlpKeyValue[];
+}
+export interface OtlpSpanStatus {
+    code: number;
+    message?: string;
+}
+export interface OtlpSpan {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+    name: string;
+    kind: number;
+    startTimeUnixNano: string;
+    endTimeUnixNano: string;
+    attributes: OtlpKeyValue[];
+    events: OtlpSpanEvent[];
+    status: OtlpSpanStatus;
+}
+export interface OtlpResourceSpans {
+    resource: {
+        attributes: OtlpKeyValue[];
+    };
+    scopeSpans: Array<{
+        scope: {
+            name: string;
+            version?: string;
+        };
+        spans: OtlpSpan[];
+    }>;
+}
+export interface OtlpExportTraceRequest {
+    resourceSpans: OtlpResourceSpans[];
+}
+/** OTLP span kind codes (proto Span.Kind). */
+export declare const OTLP_SPAN_KIND: Record<string, number>;
+/** OTLP status codes (proto Status.StatusCode). */
+export declare const OTLP_STATUS_OK = 1;
+export declare const OTLP_STATUS_ERROR = 2;
+export declare const OTLP_STATUS_UNSET = 0;
+/**
+ * Resolve OTLP traces endpoint: config.endpoint > OTEL_EXPORTER_OTLP_TRACES_ENDPOINT
+ * > OTEL_EXPORTER_OTLP_ENDPOINT + "/v1/traces". Returns undefined if none set.
+ */
+export declare function resolveOtlpEndpoint(config?: Pick<OtlpExporterConfig, "endpoint" | "env">): string | undefined;
+/** Parse OTEL_EXPORTER_OTLP_HEADERS format `k1=v1,k2=v2`. */
+export declare function parseOtlpHeaders(raw: string | undefined): Record<string, string>;
+/** Deterministic FNV-1a → hex string of `length` chars (span/trace id wire form). */
+export declare function toOtlpId(id: string, length: number): string;
+/** Convert ms epoch → OTLP timeUnixNano string. */
+export declare function msToUnixNano(ms: number): string;
+/** Map a JS value to OTLP AnyValue. */
+export declare function toOtlpAnyValue(value: unknown): OtlpAnyValue;
+/** Convert attributes record → OTLP key-value list. */
+export declare function toOtlpAttributes(attributes: Record<string, unknown>): OtlpKeyValue[];
+/** Map a custom Span → OTLP JSON span. Exported for unit tests / custom pipelines. */
+export declare function mapSpanToOtlp(span: Span): OtlpSpan;
+/** Build full ExportTraceServiceRequest body. */
+export declare function buildOtlpExportRequest(spans: readonly Span[], config?: Pick<OtlpExporterConfig, "resourceAttributes" | "scopeName" | "scopeVersion">): OtlpExportTraceRequest;
+/**
+ * Create an OTLP/HTTP span exporter (JSON encoding).
+ *
+ * @throws ConfigurationError if no endpoint in config or env.
+ *
+ * @example
+ * ```typescript
+ * const exporter = createOtlpSpanExporter({
+ *   endpoint: "http://localhost:4318/v1/traces",
+ * });
+ * await exporter.export(recorder.getSpans());
+ * await exporter.shutdown();
+ * ```
+ */
+export declare function createOtlpSpanExporter(config?: OtlpExporterConfig): SpanExporter;
+//# sourceMappingURL=otlp-exporter.d.ts.map

package/dist/otlp-exporter.d.ts.map

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

package/dist/otlp-exporter.js

@@ -0,0 +1,238 @@
+/**
+ * OTLP/HTTP span exporter — maps custom Span → OTLP ExportTraceServiceRequest.
+ *
+ * Zero hard deps: pure JSON encoding over fetch (no @opentelemetry/* runtime dep).
+ * Endpoint/headers/service name resolved from config first, then standard OTEL env vars.
+ * Default path (no createOtlpSpanExporter call) remains unchanged — no-op / console telemetry.
+ *
+ * Env (read unless overridden in config):
+ *   OTEL_EXPORTER_OTLP_TRACES_ENDPOINT  full URL for /v1/traces
+ *   OTEL_EXPORTER_OTLP_ENDPOINT         base URL → <base>/v1/traces
+ *   OTEL_EXPORTER_OTLP_HEADERS          k1=v1,k2=v2
+ *   OTEL_SERVICE_NAME                   resource attribute service.name
+ */
+import { ConfigurationError, NetworkError } from "@vinhnt-sdk/schema";
+/** OTLP span kind codes (proto Span.Kind). */
+export const OTLP_SPAN_KIND = {
+    internal: 1,
+    server: 2,
+    client: 3,
+    producer: 4,
+    consumer: 5,
+};
+/** OTLP status codes (proto Status.StatusCode). */
+export const OTLP_STATUS_OK = 1;
+export const OTLP_STATUS_ERROR = 2;
+export const OTLP_STATUS_UNSET = 0;
+const DEFAULT_TIMEOUT_MS = 10_000;
+const DEFAULT_SCOPE_NAME = "@vinhnt-sdk/trace";
+/**
+ * Resolve OTLP traces endpoint: config.endpoint > OTEL_EXPORTER_OTLP_TRACES_ENDPOINT
+ * > OTEL_EXPORTER_OTLP_ENDPOINT + "/v1/traces". Returns undefined if none set.
+ */
+export function resolveOtlpEndpoint(config) {
+    const env = config?.env ?? (typeof process !== "undefined" ? process.env : undefined);
+    if (config?.endpoint)
+        return config.endpoint;
+    const traces = env?.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT;
+    if (traces)
+        return traces;
+    const base = env?.OTEL_EXPORTER_OTLP_ENDPOINT;
+    if (base) {
+        return base.endsWith("/v1/traces") ? base : `${base.replace(/\/+$/, "")}/v1/traces`;
+    }
+    return undefined;
+}
+/** Parse OTEL_EXPORTER_OTLP_HEADERS format `k1=v1,k2=v2`. */
+export function parseOtlpHeaders(raw) {
+    if (!raw)
+        return {};
+    const out = {};
+    for (const pair of raw.split(",")) {
+        const eq = pair.indexOf("=");
+        if (eq <= 0)
+            continue;
+        const key = pair.slice(0, eq).trim();
+        const value = pair.slice(eq + 1).trim();
+        if (key)
+            out[key] = value;
+    }
+    return out;
+}
+/** Deterministic FNV-1a → hex string of `length` chars (span/trace id wire form). */
+export function toOtlpId(id, length) {
+    let hex = "";
+    let seed = 0x811c9dc5;
+    let round = 0;
+    while (hex.length < length) {
+        let h = seed;
+        const input = `${id}#${round++}`;
+        for (let i = 0; i < input.length; i++) {
+            h ^= input.charCodeAt(i);
+            h = Math.imul(h, 0x01000193) >>> 0;
+        }
+        hex += (h >>> 0).toString(16).padStart(8, "0");
+        seed = (h ^ 0x9e3779b9) >>> 0;
+    }
+    return hex.slice(0, length);
+}
+/** Convert ms epoch → OTLP timeUnixNano string. */
+export function msToUnixNano(ms) {
+    return `${BigInt(Math.max(0, Math.trunc(ms))) * 1000000n}`;
+}
+/** Map a JS value to OTLP AnyValue. */
+export function toOtlpAnyValue(value) {
+    if (value === null || value === undefined)
+        return { stringValue: "" };
+    if (typeof value === "string")
+        return { stringValue: value };
+    if (typeof value === "boolean")
+        return { boolValue: value };
+    if (typeof value === "number") {
+        return Number.isInteger(value) && Number.isSafeInteger(value)
+            ? { intValue: String(value) }
+            : { doubleValue: value };
+    }
+    if (typeof value === "bigint")
+        return { intValue: value.toString() };
+    if (Array.isArray(value)) {
+        return { arrayValue: { values: value.map(toOtlpAnyValue) } };
+    }
+    if (typeof value === "object") {
+        const values = Object.entries(value).map(([key, v]) => ({ key, value: toOtlpAnyValue(v) }));
+        return { kvlistValue: { values } };
+    }
+    return { stringValue: String(value) };
+}
+/** Convert attributes record → OTLP key-value list. */
+export function toOtlpAttributes(attributes) {
+    return Object.entries(attributes).map(([key, value]) => ({
+        key,
+        value: toOtlpAnyValue(value),
+    }));
+}
+function mapStatus(status) {
+    if (status === "ok")
+        return { code: OTLP_STATUS_OK };
+    if (status === "" || status === "unset")
+        return { code: OTLP_STATUS_UNSET };
+    // error | cancelled | timeout | custom → ERROR with message
+    const result = { code: OTLP_STATUS_ERROR };
+    if (status !== "error")
+        result.message = status;
+    return result;
+}
+/** Map a custom Span → OTLP JSON span. Exported for unit tests / custom pipelines. */
+export function mapSpanToOtlp(span) {
+    const endMs = span.endTimeMs > 0 ? span.endTimeMs : span.startTimeMs;
+    const out = {
+        traceId: toOtlpId(span.traceId ?? span.id, 32),
+        spanId: toOtlpId(span.id, 16),
+        name: span.name,
+        kind: OTLP_SPAN_KIND[span.kind] ?? OTLP_SPAN_KIND.internal,
+        startTimeUnixNano: msToUnixNano(span.startTimeMs),
+        endTimeUnixNano: msToUnixNano(endMs),
+        attributes: toOtlpAttributes(span.attributes),
+        events: span.events.map((event) => ({
+            timeUnixNano: msToUnixNano(event.timestampMs),
+            name: event.name,
+            attributes: toOtlpAttributes(event.attributes),
+        })),
+        status: mapStatus(span.status),
+    };
+    if (span.parentId) {
+        out.parentSpanId = toOtlpId(span.parentId, 16);
+    }
+    return out;
+}
+/** Build full ExportTraceServiceRequest body. */
+export function buildOtlpExportRequest(spans, config) {
+    const resourceAttrs = {
+        ...(config?.resourceAttributes ?? {}),
+    };
+    if (resourceAttrs["service.name"] === undefined) {
+        resourceAttrs["service.name"] = "vinhnt-sdk";
+    }
+    const scope = {
+        name: config?.scopeName ?? DEFAULT_SCOPE_NAME,
+    };
+    if (config?.scopeVersion !== undefined) {
+        scope.version = config.scopeVersion;
+    }
+    return {
+        resourceSpans: [
+            {
+                resource: { attributes: toOtlpAttributes(resourceAttrs) },
+                scopeSpans: [
+                    {
+                        scope,
+                        spans: spans.map(mapSpanToOtlp),
+                    },
+                ],
+            },
+        ],
+    };
+}
+/**
+ * Create an OTLP/HTTP span exporter (JSON encoding).
+ *
+ * @throws ConfigurationError if no endpoint in config or env.
+ *
+ * @example
+ * ```typescript
+ * const exporter = createOtlpSpanExporter({
+ *   endpoint: "http://localhost:4318/v1/traces",
+ * });
+ * await exporter.export(recorder.getSpans());
+ * await exporter.shutdown();
+ * ```
+ */
+export function createOtlpSpanExporter(config = {}) {
+    const endpoint = resolveOtlpEndpoint(config);
+    if (!endpoint) {
+        throw new ConfigurationError("OTLP endpoint not configured: set config.endpoint, OTEL_EXPORTER_OTLP_TRACES_ENDPOINT, or OTEL_EXPORTER_OTLP_ENDPOINT");
+    }
+    const env = config.env ?? (typeof process !== "undefined" ? process.env : undefined);
+    const headers = {
+        "content-type": "application/json",
+        ...parseOtlpHeaders(env?.OTEL_EXPORTER_OTLP_HEADERS),
+        ...(config.headers ?? {}),
+    };
+    const timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const fetchImpl = config.fetch ??
+        ((input, init) => {
+            if (typeof globalThis.fetch !== "function") {
+                throw new NetworkError("globalThis.fetch is not available; pass config.fetch");
+            }
+            return globalThis.fetch(input, init);
+        });
+    let closed = false;
+    return {
+        async export(spans) {
+            if (closed)
+                return;
+            if (spans.length === 0)
+                return;
+            const body = JSON.stringify(buildOtlpExportRequest(spans, config));
+            let response;
+            try {
+                response = await fetchImpl(endpoint, {
+                    method: "POST",
+                    headers,
+                    body,
+                    signal: AbortSignal.timeout(timeoutMs),
+                });
+            }
+            catch (cause) {
+                throw new NetworkError(`OTLP export failed: ${String(cause)}`, { cause });
+            }
+            if (!response.ok) {
+                throw new NetworkError(`OTLP export failed: HTTP ${response.status} ${response.statusText}`);
+            }
+        },
+        async shutdown() {
+            closed = true;
+        },
+    };
+}
+//# sourceMappingURL=otlp-exporter.js.map

package/dist/otlp-exporter.js.map

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

package/dist/telemetry.d.ts

@@ -75,4 +75,31 @@ export interface ContextPressure {
  * Calculate context pressure.
  */
 export declare function calculateContextPressure(currentTokens: number, maxTokens: number, compactThreshold?: number): ContextPressure;
+/**
+ * Telemetry provider interface — export telemetry data to external systems.
+ *
+ * Inspired by Vercel AI SDK's telemetry pattern.
+ */
+export interface TelemetryProvider {
+    exportTrace(trace: {
+        traceId: string;
+        spans: Array<{
+            spanId: string;
+            name: string;
+            startTime: number;
+            endTime?: number;
+            attributes?: Record<string, unknown>;
+        }>;
+    }): Promise<void> | void;
+    exportMetric(metric: {
+        name: string;
+        value: number;
+        unit: string;
+        attributes?: Record<string, unknown>;
+    }): Promise<void> | void;
+}
+/**
+ * Default telemetry provider — logs to console.
+ */
+export declare const ConsoleTelemetryProvider: TelemetryProvider;
 //# sourceMappingURL=telemetry.d.ts.map

package/dist/telemetry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,8CAA8C;AAC9C,MAAM,WAAW,UAAU;IACzB,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wCAAwC;AACxC,MAAM,WAAW,YAAY;IAC3B,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAC;CACrB;AAQD;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAO9D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,8BAAwB,CAAC;AAEnD;;GAEG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,YAA8B,GACtC,MAAM,CAIR;AAED;;;;;GAKG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAC/C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA+B;gBAEhD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC;IAIvD,iCAAiC;IACjC,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU;IAe/E,sBAAsB;IACtB,QAAQ,IAAI,UAAU;IAUtB,0BAA0B;IAC1B,iBAAiB,IAAI,MAAM;IAI3B,8BAA8B;IAC9B,aAAa,IAAI,SAAS,UAAU,EAAE;IAItC,sBAAsB;IACtB,KAAK,IAAI,IAAI;CAKd;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,6BAA6B;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,EACjB,gBAAgB,SAAM,GACrB,eAAe,CAQjB"}
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,8CAA8C;AAC9C,MAAM,WAAW,UAAU;IACzB,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wCAAwC;AACxC,MAAM,WAAW,YAAY;IAC3B,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAC;CACrB;AAQD;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAO9D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,8BAAwB,CAAC;AAEnD;;GAEG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,YAA8B,GACtC,MAAM,CAIR;AAED;;;;;GAKG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAC/C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA+B;gBAEhD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC;IAIvD,iCAAiC;IACjC,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU;IAe/E,sBAAsB;IACtB,QAAQ,IAAI,UAAU;IAUtB,0BAA0B;IAC1B,iBAAiB,IAAI,MAAM;IAI3B,8BAA8B;IAC9B,aAAa,IAAI,SAAS,UAAU,EAAE;IAItC,sBAAsB;IACtB,KAAK,IAAI,IAAI;CAKd;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,6BAA6B;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,EACjB,gBAAgB,SAAM,GACrB,eAAe,CAQjB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,KAAK,EAAE;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,KAAK,CAAC;YACX,MAAM,EAAE,MAAM,CAAC;YACf,IAAI,EAAE,MAAM,CAAC;YACb,SAAS,EAAE,MAAM,CAAC;YAClB,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;SACtC,CAAC,CAAC;KACJ,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACzB,YAAY,CAAC,MAAM,EAAE;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACtC,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC1B;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,iBAWtC,CAAC"}

package/dist/telemetry.js

@@ -98,4 +98,19 @@ export function calculateContextPressure(currentTokens, maxTokens, compactThresh
         shouldCompact: pressure >= compactThreshold,
     };
 }
+/**
+ * Default telemetry provider — logs to console.
+ */
+export const ConsoleTelemetryProvider = {
+    exportTrace(trace) {
+        if (typeof console !== "undefined") {
+            console.log("[trace]", trace);
+        }
+    },
+    exportMetric(metric) {
+        if (typeof console !== "undefined") {
+            console.log("[metric]", metric);
+        }
+    },
+};
 //# sourceMappingURL=telemetry.js.map

package/dist/telemetry.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vinhnt-sdk/trace",
-  "version": "0.4.2",
-  "description": "Observability — OpenTelemetry spans, timeline replay, telemetry aggregation",
+  "version": "0.4.3",
+  "description": "Observability - OpenTelemetry spans, timeline replay, telemetry aggregation",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
@@ -42,17 +42,18 @@
   "publishConfig": {
     "access": "public"
   },
-  "dependencies": {
-    "@vinhnt-sdk/schema": "0.4.2"
-  },
-  "devDependencies": {
-    "vitest": "^3.2.7"
-  },
   "scripts": {
     "build": "tsc -b",
     "typecheck": "tsc --noEmit",
     "clean": "node -e \"try{require('fs').rmSync('dist',{recursive:true,force:true})}catch(e){}\" && node -e \"try{require('fs').rmSync('tsconfig.tsbuildinfo',{force:true})}catch(e){}\"",
+    "prepublishOnly": "pnpm build",
     "test": "vitest run",
     "lint": "eslint ."
+  },
+  "dependencies": {
+    "@vinhnt-sdk/schema": "0.5.9"
+  },
+  "devDependencies": {
+    "vitest": "^3.2.7"
   }
-}
+}