@vinhnt-sdk/trace 0.1.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nguyen Thanh Vinh
+
+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/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @module trace
+ * Observability — OpenTelemetry-compatible spans, timeline replay, telemetry aggregation.
+ *
+ * Capability Seam:
+ *   Tracing (SpanRecorder, createSpan) → Consumer (core kernel, step-executor)
+ *   Timeline (Timeline, buildTranscript) → Consumer (session, UI)
+ *   Telemetry (TokenMeter, calculateCost) → Consumer (core kernel, model-caller)
+ */
+export { SpanRecorder, createSpan, endSpan, addSpanEvent, generateTraceId, } from "./tracing.js";
+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, MODEL_PRICING } from "./telemetry.js";
+export type { UsageStats, ModelPricing, ContextPressure } from "./telemetry.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":"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,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACnG,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+/**
+ * @module trace
+ * Observability — OpenTelemetry-compatible spans, timeline replay, telemetry aggregation.
+ *
+ * Capability Seam:
+ *   Tracing (SpanRecorder, createSpan) → Consumer (core kernel, step-executor)
+ *   Timeline (Timeline, buildTranscript) → Consumer (session, UI)
+ *   Telemetry (TokenMeter, calculateCost) → Consumer (core kernel, model-caller)
+ */
+// ── Tracing ──
+export { SpanRecorder, createSpan, endSpan, addSpanEvent, generateTraceId, } from "./tracing.js";
+// ── Timeline ──
+export { Timeline, buildTranscript } from "./timeline.js";
+// ── Telemetry ──
+export { CostMeter, calculateCost, calculateContextPressure, MODEL_PRICING } from "./telemetry.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;;;;;;;;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,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/telemetry.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Telemetry — usage aggregation, cost tracking, context pressure monitoring.
+ *
+ * Aggregates usage per session/provider/model and tracks token costs.
+ */
+/** Usage statistics for a single operation */
+export interface UsageStats {
+    /** Input tokens consumed */
+    inputTokens: number;
+    /** Output tokens generated */
+    outputTokens: number;
+    /** Total tokens (input + output) */
+    totalTokens: number;
+    /** Estimated cost in USD */
+    costUsd: number;
+}
+/** Model pricing per 1M tokens (USD) */
+export interface ModelPricing {
+    /** Cost per 1M input tokens */
+    inputPer1M: number;
+    /** Cost per 1M output tokens */
+    outputPer1M: number;
+}
+/** Known model pricing (as of 2026) */
+export declare const MODEL_PRICING: Record<string, ModelPricing>;
+/**
+ * Calculate cost from token counts.
+ */
+export declare function calculateCost(inputTokens: number, outputTokens: number, pricing?: ModelPricing): number;
+/**
+ * Cost meter — tracks token usage and cost across operations.
+ * Named differently from llm/TokenMeter to clarify purpose:
+ * - llm/TokenMeter: heuristic token estimation for request sizing
+ * - trace/CostMeter: actual usage tracking and cost aggregation
+ */
+export declare class CostMeter {
+    private totalInput;
+    private totalOutput;
+    private readonly operations;
+    /** Record a token usage event */
+    record(inputTokens: number, outputTokens: number, modelId?: string): UsageStats;
+    /** Get total usage */
+    getTotal(): UsageStats;
+    /** Get operation count */
+    getOperationCount(): number;
+    /** Get all operation stats */
+    getOperations(): readonly UsageStats[];
+    /** Reset the meter */
+    reset(): void;
+}
+/**
+ * Context pressure — monitors context window usage.
+ */
+export interface ContextPressure {
+    /** Current context tokens */
+    currentTokens: number;
+    /** Maximum context window */
+    maxTokens: number;
+    /** Pressure ratio (0.0 = empty, 1.0 = full) */
+    pressure: number;
+    /** Whether compaction is recommended */
+    shouldCompact: boolean;
+    readonly metadata?: Record<string, unknown>;
+}
+/**
+ * Calculate context pressure.
+ */
+export declare function calculateContextPressure(currentTokens: number, maxTokens: number, compactThreshold?: number): ContextPressure;
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/telemetry.d.ts.map

@@ -0,0 +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,uCAAuC;AACvC,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAOtD,CAAC;AAEF;;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;IAE/C,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"}

package/dist/telemetry.js

@@ -0,0 +1,90 @@
+/**
+ * Telemetry — usage aggregation, cost tracking, context pressure monitoring.
+ *
+ * Aggregates usage per session/provider/model and tracks token costs.
+ */
+/** Default pricing — zero cost (override with actual pricing) */
+const DEFAULT_PRICING = {
+    inputPer1M: 0,
+    outputPer1M: 0,
+};
+/** Known model pricing (as of 2026) */
+export const MODEL_PRICING = {
+    "deepseek-chat": { inputPer1M: 0.27, outputPer1M: 1.10 },
+    "deepseek-reasoner": { inputPer1M: 0.55, outputPer1M: 2.19 },
+    "gpt-4o": { inputPer1M: 2.50, outputPer1M: 10.00 },
+    "gpt-4o-mini": { inputPer1M: 0.15, outputPer1M: 0.60 },
+    "claude-sonnet-4-20250514": { inputPer1M: 3.00, outputPer1M: 15.00 },
+    "claude-haiku-4-20250414": { inputPer1M: 0.80, outputPer1M: 4.00 },
+};
+/**
+ * Calculate cost from token counts.
+ */
+export function calculateCost(inputTokens, outputTokens, pricing = DEFAULT_PRICING) {
+    const inputCost = (inputTokens / 1_000_000) * pricing.inputPer1M;
+    const outputCost = (outputTokens / 1_000_000) * pricing.outputPer1M;
+    return inputCost + outputCost;
+}
+/**
+ * Cost meter — tracks token usage and cost across operations.
+ * Named differently from llm/TokenMeter to clarify purpose:
+ * - llm/TokenMeter: heuristic token estimation for request sizing
+ * - trace/CostMeter: actual usage tracking and cost aggregation
+ */
+export class CostMeter {
+    totalInput = 0;
+    totalOutput = 0;
+    operations = [];
+    /** Record a token usage event */
+    record(inputTokens, outputTokens, modelId) {
+        const pricing = modelId ? MODEL_PRICING[modelId] : undefined;
+        const costUsd = calculateCost(inputTokens, outputTokens, pricing);
+        const stats = {
+            inputTokens,
+            outputTokens,
+            totalTokens: inputTokens + outputTokens,
+            costUsd,
+        };
+        this.totalInput += inputTokens;
+        this.totalOutput += outputTokens;
+        this.operations.push(stats);
+        return stats;
+    }
+    /** Get total usage */
+    getTotal() {
+        const totalCost = this.operations.reduce((sum, op) => sum + op.costUsd, 0);
+        return {
+            inputTokens: this.totalInput,
+            outputTokens: this.totalOutput,
+            totalTokens: this.totalInput + this.totalOutput,
+            costUsd: totalCost,
+        };
+    }
+    /** Get operation count */
+    getOperationCount() {
+        return this.operations.length;
+    }
+    /** Get all operation stats */
+    getOperations() {
+        return [...this.operations];
+    }
+    /** Reset the meter */
+    reset() {
+        this.totalInput = 0;
+        this.totalOutput = 0;
+        this.operations.length = 0;
+    }
+}
+/**
+ * Calculate context pressure.
+ */
+export function calculateContextPressure(currentTokens, maxTokens, compactThreshold = 0.8) {
+    const pressure = maxTokens > 0 ? currentTokens / maxTokens : 0;
+    return {
+        currentTokens,
+        maxTokens,
+        pressure,
+        shouldCompact: pressure >= compactThreshold,
+    };
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/telemetry.js.map

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

package/dist/timeline.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Timeline — session log IS the timeline.
+ *
+ * Full replay from durable events. Token-level replay fidelity
+ * via assistant/chunk events.
+ *
+ * The timeline is a linear sequence of events that can be replayed
+ * to reconstruct the full conversation history.
+ */
+/** Timeline event types — maps to KnownRunEvent from schema */
+export type TimelineEventType = "run.started" | "run.completed" | "run.failed" | "step.started" | "step.completed" | "step.failed" | "turn.started" | "turn.ended" | "tool.invoked" | "tool.completed" | "tool.failed" | "tool.cancelled" | "approval.asked" | "approval.decided" | "llm.retry" | "llm.retry_started" | "assistant.chunk" | "token.compressed" | "context.compressed" | "permission.asked" | "permission.decided";
+/** A single timeline event */
+export interface TimelineEvent {
+    /** Event type */
+    readonly type: TimelineEventType;
+    /** Timestamp (Unix ms) */
+    readonly timestampMs: number;
+    /** Event data (type-specific) */
+    readonly data: Record<string, unknown>;
+    /** Sequence number (monotonic within a session) */
+    readonly seq: number;
+}
+/**
+ * Timeline — ordered sequence of events for a session.
+ */
+export declare class Timeline {
+    private readonly events;
+    private seq;
+    /** Record an event */
+    record(type: TimelineEventType, data: Record<string, unknown>): TimelineEvent;
+    /** Get all events */
+    getEvents(): readonly TimelineEvent[];
+    /** Get events filtered by type */
+    getEventsByType(type: TimelineEventType): readonly TimelineEvent[];
+    /** Get events in a time range */
+    getEventsInRange(startMs: number, endMs: number): readonly TimelineEvent[];
+    /** Get event count */
+    count(): number;
+    /** Get duration of the timeline */
+    getDurationMs(): number;
+    /** Replay events through a handler */
+    replay(handler: (event: TimelineEvent) => Promise<void>): Promise<void>;
+    /** Export events as JSON */
+    export(): TimelineEvent[];
+    /** Import events from JSON */
+    import(events: TimelineEvent[]): void;
+}
+/**
+ * Build a conversation transcript from timeline events.
+ * Extracts user messages, assistant responses, and tool calls.
+ */
+export declare function buildTranscript(events: readonly TimelineEvent[]): TranscriptEntry[];
+/** A single entry in a conversation transcript */
+export interface TranscriptEntry {
+    type: "user" | "assistant" | "tool_call" | "tool_result";
+    content?: string;
+    toolName?: string;
+    input?: unknown;
+    output?: unknown;
+    timestampMs: number;
+}
+//# sourceMappingURL=timeline.d.ts.map

package/dist/timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.d.ts","sourceRoot":"","sources":["../src/timeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,+DAA+D;AAC/D,MAAM,MAAM,iBAAiB,GACzB,aAAa,GACb,eAAe,GACf,YAAY,GACZ,cAAc,GACd,gBAAgB,GAChB,aAAa,GACb,cAAc,GACd,YAAY,GACZ,cAAc,GACd,gBAAgB,GAChB,aAAa,GACb,gBAAgB,GAChB,gBAAgB,GAChB,kBAAkB,GAClB,WAAW,GACX,mBAAmB,GACnB,iBAAiB,GACjB,kBAAkB,GAClB,oBAAoB,GACpB,kBAAkB,GAClB,oBAAoB,CAAC;AAEzB,8BAA8B;AAC9B,MAAM,WAAW,aAAa;IAC5B,iBAAiB;IACjB,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,0BAA0B;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,iCAAiC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,mDAAmD;IACnD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAC9C,OAAO,CAAC,GAAG,CAAK;IAEhB,sBAAsB;IACtB,MAAM,CAAC,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,aAAa;IAW7E,qBAAqB;IACrB,SAAS,IAAI,SAAS,aAAa,EAAE;IAIrC,kCAAkC;IAClC,eAAe,CAAC,IAAI,EAAE,iBAAiB,GAAG,SAAS,aAAa,EAAE;IAIlE,iCAAiC;IACjC,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,aAAa,EAAE;IAI1E,sBAAsB;IACtB,KAAK,IAAI,MAAM;IAIf,mCAAmC;IACnC,aAAa,IAAI,MAAM;IAKvB,sCAAsC;IAChC,MAAM,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAM7E,4BAA4B;IAC5B,MAAM,IAAI,aAAa,EAAE;IAIzB,8BAA8B;IAC9B,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,IAAI;CAOtC;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,GAAG,eAAe,EAAE,CAuCnF;AAED,kDAAkD;AAClD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,WAAW,GAAG,aAAa,CAAC;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/timeline.js

@@ -0,0 +1,110 @@
+/**
+ * Timeline — session log IS the timeline.
+ *
+ * Full replay from durable events. Token-level replay fidelity
+ * via assistant/chunk events.
+ *
+ * The timeline is a linear sequence of events that can be replayed
+ * to reconstruct the full conversation history.
+ */
+/**
+ * Timeline — ordered sequence of events for a session.
+ */
+export class Timeline {
+    events = [];
+    seq = 0;
+    /** Record an event */
+    record(type, data) {
+        const event = {
+            type,
+            timestampMs: Date.now(),
+            data,
+            seq: this.seq++,
+        };
+        this.events.push(event);
+        return event;
+    }
+    /** Get all events */
+    getEvents() {
+        return [...this.events];
+    }
+    /** Get events filtered by type */
+    getEventsByType(type) {
+        return this.events.filter((e) => e.type === type);
+    }
+    /** Get events in a time range */
+    getEventsInRange(startMs, endMs) {
+        return this.events.filter((e) => e.timestampMs >= startMs && e.timestampMs <= endMs);
+    }
+    /** Get event count */
+    count() {
+        return this.events.length;
+    }
+    /** Get duration of the timeline */
+    getDurationMs() {
+        if (this.events.length === 0)
+            return 0;
+        return this.events[this.events.length - 1].timestampMs - this.events[0].timestampMs;
+    }
+    /** Replay events through a handler */
+    async replay(handler) {
+        for (const event of this.events) {
+            await handler(event);
+        }
+    }
+    /** Export events as JSON */
+    export() {
+        return [...this.events];
+    }
+    /** Import events from JSON */
+    import(events) {
+        this.events.length = 0;
+        for (const event of events) {
+            this.events.push(event);
+        }
+        this.seq = Math.max(0, ...events.map((e) => e.seq)) + 1;
+    }
+}
+/**
+ * Build a conversation transcript from timeline events.
+ * Extracts user messages, assistant responses, and tool calls.
+ */
+export function buildTranscript(events) {
+    const entries = [];
+    for (const event of events) {
+        switch (event.type) {
+            case "run.started":
+                entries.push({
+                    type: "user",
+                    content: event.data.prompt,
+                    timestampMs: event.timestampMs,
+                });
+                break;
+            case "assistant.chunk":
+                entries.push({
+                    type: "assistant",
+                    content: event.data.content,
+                    timestampMs: event.timestampMs,
+                });
+                break;
+            case "tool.invoked":
+                entries.push({
+                    type: "tool_call",
+                    toolName: event.data.toolName,
+                    input: event.data.input,
+                    timestampMs: event.timestampMs,
+                });
+                break;
+            case "tool.completed":
+                entries.push({
+                    type: "tool_result",
+                    toolName: event.data.toolName,
+                    output: event.data.output,
+                    timestampMs: event.timestampMs,
+                });
+                break;
+        }
+    }
+    return entries;
+}
+//# sourceMappingURL=timeline.js.map

package/dist/timeline.js.map

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

package/dist/tracing.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Tracing — OpenTelemetry-compatible span model.
+ *
+ * Spans represent units of work (model call, tool execution, step, turn).
+ * They form a tree: parent span → child spans.
+ *
+ * This is a lightweight, zero-dependency implementation compatible with
+ * the OpenTelemetry span model but without requiring the OTel SDK.
+ */
+/** Span status */
+export type SpanStatus = "ok" | "error" | "cancelled";
+/** A single trace span */
+export interface Span {
+    /** Unique span ID */
+    readonly id: string;
+    /** Parent span ID (undefined for root spans) */
+    readonly parentId: string | undefined;
+    /** Span name (e.g., "llm.call", "tool.execute", "step") */
+    readonly name: string;
+    /** Span kind */
+    readonly kind: SpanKind;
+    /** Start time (Unix ms) */
+    readonly startTimeMs: number;
+    /** End time (Unix ms, 0 if still active) */
+    endTimeMs: number;
+    /** Span status */
+    status: SpanStatus;
+    /** Span attributes (key-value pairs) */
+    attributes: Record<string, unknown>;
+    /** Span events (timestamped annotations) */
+    events: SpanEvent[];
+    readonly metadata?: Record<string, unknown>;
+}
+/** Span kind */
+export type SpanKind = "internal" | "client" | "server" | "producer" | "consumer";
+/** A timestamped event within a span */
+export interface SpanEvent {
+    name: string;
+    timestampMs: number;
+    attributes: Record<string, unknown>;
+}
+/** Trace context — passed through the call chain */
+export interface TraceContext {
+    /** Root trace ID */
+    readonly traceId: string;
+    /** Current span */
+    readonly span: Span;
+}
+/** Generate a unique trace ID */
+export declare function generateTraceId(): string;
+/**
+ * Create a new span.
+ */
+export declare function createSpan(name: string, kind: SpanKind, parentId?: string, traceId?: string): Span;
+/**
+ * End a span with a status.
+ */
+export declare function endSpan(span: Span, status?: SpanStatus): void;
+/**
+ * Add an event to a span.
+ */
+export declare function addSpanEvent(span: Span, name: string, attributes?: Record<string, unknown>): void;
+/**
+ * A span recorder — collects spans and provides trace context.
+ */
+export declare class SpanRecorder {
+    private readonly spans;
+    private readonly traceId;
+    constructor(traceId?: string);
+    /** Start a new span */
+    startSpan(name: string, kind: SpanKind, parentId?: string): Span;
+    /** End a span */
+    endSpan(span: Span, status?: SpanStatus): void;
+    /** Get all recorded spans */
+    getSpans(): readonly Span[];
+    /** Get span tree (root → children) */
+    getSpanTree(): SpanNode[];
+    /** Get total duration of the trace */
+    getTotalDurationMs(): number;
+}
+/** A node in the span tree */
+export interface SpanNode {
+    span: Span;
+    children: SpanNode[];
+}
+//# sourceMappingURL=tracing.d.ts.map

package/dist/tracing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../src/tracing.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,kBAAkB;AAClB,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,OAAO,GAAG,WAAW,CAAC;AAEtD,0BAA0B;AAC1B,MAAM,WAAW,IAAI;IACnB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,gBAAgB;IAChB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,2BAA2B;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB;IAClB,MAAM,EAAE,UAAU,CAAC;IACnB,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,4CAA4C;IAC5C,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED,gBAAgB;AAChB,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;AAElF,wCAAwC;AACxC,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,oDAAoD;AACpD,MAAM,WAAW,YAAY;IAC3B,oBAAoB;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,mBAAmB;IACnB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;CACrB;AASD,iCAAiC;AACjC,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,QAAQ,EACd,QAAQ,CAAC,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,GACf,IAAI,CAYN;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,GAAE,UAAiB,GAAG,IAAI,CAGnE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAMjG;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,CAAC,EAAE,MAAM;IAI5B,uBAAuB;IACvB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAMhE,iBAAiB;IACjB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,GAAE,UAAiB,GAAG,IAAI;IAIpD,6BAA6B;IAC7B,QAAQ,IAAI,SAAS,IAAI,EAAE;IAI3B,sCAAsC;IACtC,WAAW,IAAI,QAAQ,EAAE;IA0BzB,sCAAsC;IACtC,kBAAkB,IAAI,MAAM;CAM7B;AAED,8BAA8B;AAC9B,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,QAAQ,EAAE,CAAC;CACtB"}

package/dist/tracing.js

@@ -0,0 +1,109 @@
+/**
+ * Tracing — OpenTelemetry-compatible span model.
+ *
+ * Spans represent units of work (model call, tool execution, step, turn).
+ * They form a tree: parent span → child spans.
+ *
+ * This is a lightweight, zero-dependency implementation compatible with
+ * the OpenTelemetry span model but without requiring the OTel SDK.
+ */
+let spanCounter = 0;
+/** Generate a unique span ID */
+function generateSpanId() {
+    return `span_${Date.now().toString(36)}_${(spanCounter++).toString(36)}`;
+}
+/** Generate a unique trace ID */
+export function generateTraceId() {
+    return `trace_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
+}
+/**
+ * Create a new span.
+ */
+export function createSpan(name, kind, parentId, traceId) {
+    return {
+        id: generateSpanId(),
+        parentId,
+        name,
+        kind,
+        startTimeMs: Date.now(),
+        endTimeMs: 0,
+        status: "ok",
+        attributes: {},
+        events: [],
+    };
+}
+/**
+ * End a span with a status.
+ */
+export function endSpan(span, status = "ok") {
+    span.endTimeMs = Date.now();
+    span.status = status;
+}
+/**
+ * Add an event to a span.
+ */
+export function addSpanEvent(span, name, attributes) {
+    span.events.push({
+        name,
+        timestampMs: Date.now(),
+        attributes: attributes ?? {},
+    });
+}
+/**
+ * A span recorder — collects spans and provides trace context.
+ */
+export class SpanRecorder {
+    spans = [];
+    traceId;
+    constructor(traceId) {
+        this.traceId = traceId ?? generateTraceId();
+    }
+    /** Start a new span */
+    startSpan(name, kind, parentId) {
+        const span = createSpan(name, kind, parentId ?? this.spans[this.spans.length - 1]?.id, this.traceId);
+        this.spans.push(span);
+        return span;
+    }
+    /** End a span */
+    endSpan(span, status = "ok") {
+        endSpan(span, status);
+    }
+    /** Get all recorded spans */
+    getSpans() {
+        return [...this.spans];
+    }
+    /** Get span tree (root → children) */
+    getSpanTree() {
+        const spanMap = new Map();
+        const roots = [];
+        // Create nodes
+        for (const span of this.spans) {
+            spanMap.set(span.id, { span, children: [] });
+        }
+        // Build tree
+        for (const node of spanMap.values()) {
+            if (node.span.parentId) {
+                const parent = spanMap.get(node.span.parentId);
+                if (parent) {
+                    parent.children.push(node);
+                }
+                else {
+                    roots.push(node);
+                }
+            }
+            else {
+                roots.push(node);
+            }
+        }
+        return roots;
+    }
+    /** Get total duration of the trace */
+    getTotalDurationMs() {
+        if (this.spans.length === 0)
+            return 0;
+        const start = Math.min(...this.spans.map((s) => s.startTimeMs));
+        const end = Math.max(...this.spans.map((s) => s.endTimeMs || Date.now()));
+        return end - start;
+    }
+}
+//# sourceMappingURL=tracing.js.map

package/dist/tracing.js.map

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

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@vinhnt-sdk/trace",
+  "version": "0.1.3",
+  "description": "Observability — OpenTelemetry spans, timeline replay, telemetry aggregation",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vinhnt-develop/vinhnt-sdk.git",
+    "directory": "packages/trace"
+  },
+  "homepage": "https://github.com/vinhnt-develop/vinhnt-sdk/tree/main/packages/trace",
+  "bugs": {
+    "url": "https://github.com/vinhnt-develop/vinhnt-sdk/issues"
+  },
+  "keywords": [
+    "vnt",
+    "trace",
+    "opentelemetry",
+    "timeline",
+    "telemetry"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@vinhnt-sdk/schema": "0.1.3"
+  },
+  "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){}\"",
+    "test": "vitest run",
+    "lint": "eslint ."
+  }
+}