@vinhnt-sdk/trace 0.4.3 → 0.11.1

package/LICENSE

@@ -1,21 +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.
+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/README.md

@@ -1,110 +1,110 @@
-# @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
-
+# @vinhnt-sdk/trace
+
+> 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
+- **GenAI semconv** — OTel `gen_ai.*` attribute keys + builders for chat/tool/agent spans (ADK profile)
 - **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 |
+- **DEFAULT_MODEL_PRICING** — Built-in pricing for common models
+
+## Quick Start
+
+`	ypescript
+import {
+  SpanRecorder,
+  CostMeter, calculateCost, DEFAULT_MODEL_PRICING,
+  Timeline, buildTranscript,
+} from "@vinhnt-sdk/trace";
+
+// Create and record spans
+const recorder = new SpanRecorder();
+const span = recorder.startSpan("llm-call", "client");
+
+// ... do work ...
+
+recorder.endSpan(span, "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)
@@ -126,6 +126,23 @@ Endpoint resolution (first match wins):
 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).
 
+### GenAI Semconv (G3.1)
+
+| Export | Type | Description |
+|--------|------|-------------|
+| GEN_AI_OPERATIONS | Constant | Operation names: `chat`, `text_completion`, `embeddings`, `invoke_agent`, `execute_tool`, `retrieve`, `invoke_workflow` |
+| GenAiOperation | Type | Union of operation names (autocomplete + extensible) |
+| GEN_AI_* | Constants | OTel `gen_ai.*` attribute keys (request/response/usage/tool/content) |
+| genAiChatRequestAttributes | Function | Request-side attrs (`operation.name`, `provider.name`, `request.model`) |
+| genAiResponseAttributes | Function | Served model + `response.finish_reasons` |
+| genAiUsageAttributes | Function | `usage.input_tokens` / `output_tokens` / `reasoning_tokens` |
+| genAiContentAttributes | Function | Opt-in message attrs — `contentMode: "full"` only (default `no_content`) |
+| genAiToolAttributes | Function | `execute_tool` span attrs (`gen_ai.tool.name` / `tool.call.id`) |
+| genAiInvokeAgentAttributes | Function | Root `invoke_agent` span attrs |
+
+Content capture is privacy-gated: without `contentMode: "full"` the builders
+return `{}` — metadata only. Custom attributes use the `vnt.` namespace.
+
 ```typescript
 import { createOtlpSpanExporter, SpanRecorder } from "@vinhnt-sdk/trace";
 
@@ -142,42 +159,42 @@ 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
-
+## 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/gen-ai-attributes.d.ts

@@ -0,0 +1,99 @@
+/**
+ * GenAI semantic-convention attribute layer — OTel `gen_ai.*` attributes
+ * (ADK profile; research: .agents/research/ai-observability-research.md).
+ *
+ * Pure constants + tiny builders — zero runtime deps. Spans stay plain
+ * `Span` objects (see ./tracing.ts); this module only supplies the standard
+ * attribute keys/values so every producer agrees on names.
+ *
+ * Privacy: content capture is OPT-IN (`contentMode: "full"`). The default
+ * `no_content` tier records metadata only (research "Privacy Tiers" #1).
+ */
+/** Attribute keys — core set (research table "Core Attributes"). */
+export declare const GEN_AI_OPERATION_NAME = "gen_ai.operation.name";
+export declare const GEN_AI_PROVIDER_NAME = "gen_ai.provider.name";
+export declare const GEN_AI_REQUEST_MODEL = "gen_ai.request.model";
+export declare const GEN_AI_RESPONSE_MODEL = "gen_ai.response.model";
+export declare const GEN_AI_USAGE_INPUT_TOKENS = "gen_ai.usage.input_tokens";
+export declare const GEN_AI_USAGE_OUTPUT_TOKENS = "gen_ai.usage.output_tokens";
+export declare const GEN_AI_USAGE_REASONING_TOKENS = "gen_ai.usage.reasoning_tokens";
+export declare const GEN_AI_RESPONSE_FINISH_REASONS = "gen_ai.response.finish_reasons";
+export declare const GEN_AI_CONVERSATION_ID = "gen_ai.conversation.id";
+/** Attribute keys — tool calls (gen_ai.tool.* span attributes). */
+export declare const GEN_AI_TOOL_NAME = "gen_ai.tool.name";
+export declare const GEN_AI_TOOL_CALL_ID = "gen_ai.tool.call.id";
+/** Attribute keys — opt-in content capture (`contentMode: "full"` only). */
+export declare const GEN_AI_INPUT_MESSAGES = "gen_ai.input.messages";
+export declare const GEN_AI_OUTPUT_MESSAGES = "gen_ai.output.messages";
+/**
+ * Operation names — research "Agent Spans (5 types)" ∪ core-attributes
+ * operations (`chat`, `text_completion`, `embeddings`).
+ */
+export declare const GEN_AI_OPERATIONS: {
+    readonly chat: "chat";
+    readonly textCompletion: "text_completion";
+    readonly embeddings: "embeddings";
+    readonly invokeAgent: "invoke_agent";
+    readonly executeTool: "execute_tool";
+    readonly retrieve: "retrieve";
+    readonly invokeWorkflow: "invoke_workflow";
+};
+export type GenAiOperation = (typeof GEN_AI_OPERATIONS)[keyof typeof GEN_AI_OPERATIONS];
+/**
+ * Content capture tier — research privacy tiers #1 (default) and #4.
+ * `metadata_only`/`redacted` belong to the PromptLogger work (out of scope).
+ */
+export type GenAiContentMode = "no_content" | "full";
+/** Default cap for opt-in content attributes (chars). */
+export declare const DEFAULT_GEN_AI_MAX_CONTENT_LENGTH = 4096;
+/** Custom (non-semconv) attribute keys used by the SDK — `vnt.` namespace. */
+export declare const VNT_TRACE_CONTENT_TRUNCATED = "vnt.trace.content_truncated";
+/** Structural usage subset of `ModelUsage` (kept dependency-free). */
+export interface GenAiUsage {
+    readonly promptTokens?: number | undefined;
+    readonly completionTokens?: number | undefined;
+    readonly reasoningTokens?: number | undefined;
+}
+export interface GenAiContentOptions {
+    /** `no_content` (default) → content attributes are omitted entirely. */
+    readonly contentMode?: GenAiContentMode | undefined;
+    /** Truncation cap for content attributes. Default 4096 chars. */
+    readonly maxContentLength?: number | undefined;
+}
+/** Conversation grouping attribute (emitted only when a session id exists). */
+export declare function genAiConversationAttributes(conversationId?: string | undefined): Record<string, unknown>;
+/** Attributes for the start of a chat/completion request. */
+export declare function genAiChatRequestAttributes(params: {
+    readonly provider: string;
+    readonly model: string;
+    readonly conversationId?: string | undefined;
+}): Record<string, unknown>;
+/** Response-side attributes: served model + finish reasons. Omits unset fields. */
+export declare function genAiResponseAttributes(params: {
+    readonly model?: string | undefined;
+    readonly finishReason?: string | undefined;
+}): Record<string, unknown>;
+/** Token usage attributes — ints, only the fields actually present. */
+export declare function genAiUsageAttributes(usage?: GenAiUsage | undefined): Record<string, unknown>;
+/**
+ * Opt-in content attributes — `no_content` (default) returns `{}`.
+ * `full` emits `gen_ai.input.messages` / `gen_ai.output.messages` as
+ * (possibly truncated) JSON strings + a `vnt.trace.content_truncated` flag.
+ */
+export declare function genAiContentAttributes(params: {
+    /** Serialized conversation (request side), ready for JSON encoding. */
+    readonly inputJson?: string | undefined;
+    /** Serialized assistant output (response side). */
+    readonly outputJson?: string | undefined;
+}, options?: GenAiContentOptions | undefined): Record<string, unknown>;
+/** Attributes for an `execute_tool` span. */
+export declare function genAiToolAttributes(params: {
+    readonly toolName: string;
+    readonly toolCallId?: string | undefined;
+    readonly conversationId?: string | undefined;
+}): Record<string, unknown>;
+/** Attributes for a top-level `invoke_agent` span. */
+export declare function genAiInvokeAgentAttributes(params: {
+    readonly conversationId?: string | undefined;
+}): Record<string, unknown>;
+//# sourceMappingURL=gen-ai-attributes.d.ts.map

package/dist/gen-ai-attributes.d.ts.map

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

package/dist/gen-ai-attributes.js

@@ -0,0 +1,126 @@
+/**
+ * GenAI semantic-convention attribute layer — OTel `gen_ai.*` attributes
+ * (ADK profile; research: .agents/research/ai-observability-research.md).
+ *
+ * Pure constants + tiny builders — zero runtime deps. Spans stay plain
+ * `Span` objects (see ./tracing.ts); this module only supplies the standard
+ * attribute keys/values so every producer agrees on names.
+ *
+ * Privacy: content capture is OPT-IN (`contentMode: "full"`). The default
+ * `no_content` tier records metadata only (research "Privacy Tiers" #1).
+ */
+/** Attribute keys — core set (research table "Core Attributes"). */
+export const GEN_AI_OPERATION_NAME = "gen_ai.operation.name";
+export const GEN_AI_PROVIDER_NAME = "gen_ai.provider.name";
+export const GEN_AI_REQUEST_MODEL = "gen_ai.request.model";
+export const GEN_AI_RESPONSE_MODEL = "gen_ai.response.model";
+export const GEN_AI_USAGE_INPUT_TOKENS = "gen_ai.usage.input_tokens";
+export const GEN_AI_USAGE_OUTPUT_TOKENS = "gen_ai.usage.output_tokens";
+export const GEN_AI_USAGE_REASONING_TOKENS = "gen_ai.usage.reasoning_tokens";
+export const GEN_AI_RESPONSE_FINISH_REASONS = "gen_ai.response.finish_reasons";
+export const GEN_AI_CONVERSATION_ID = "gen_ai.conversation.id";
+/** Attribute keys — tool calls (gen_ai.tool.* span attributes). */
+export const GEN_AI_TOOL_NAME = "gen_ai.tool.name";
+export const GEN_AI_TOOL_CALL_ID = "gen_ai.tool.call.id";
+/** Attribute keys — opt-in content capture (`contentMode: "full"` only). */
+export const GEN_AI_INPUT_MESSAGES = "gen_ai.input.messages";
+export const GEN_AI_OUTPUT_MESSAGES = "gen_ai.output.messages";
+/**
+ * Operation names — research "Agent Spans (5 types)" ∪ core-attributes
+ * operations (`chat`, `text_completion`, `embeddings`).
+ */
+export const GEN_AI_OPERATIONS = {
+    chat: "chat",
+    textCompletion: "text_completion",
+    embeddings: "embeddings",
+    invokeAgent: "invoke_agent",
+    executeTool: "execute_tool",
+    retrieve: "retrieve",
+    invokeWorkflow: "invoke_workflow",
+};
+/** Default cap for opt-in content attributes (chars). */
+export const DEFAULT_GEN_AI_MAX_CONTENT_LENGTH = 4_096;
+/** Custom (non-semconv) attribute keys used by the SDK — `vnt.` namespace. */
+export const VNT_TRACE_CONTENT_TRUNCATED = "vnt.trace.content_truncated";
+/** Conversation grouping attribute (emitted only when a session id exists). */
+export function genAiConversationAttributes(conversationId) {
+    return conversationId ? { [GEN_AI_CONVERSATION_ID]: conversationId } : {};
+}
+/** Attributes for the start of a chat/completion request. */
+export function genAiChatRequestAttributes(params) {
+    return {
+        [GEN_AI_OPERATION_NAME]: GEN_AI_OPERATIONS.chat,
+        [GEN_AI_PROVIDER_NAME]: params.provider,
+        [GEN_AI_REQUEST_MODEL]: params.model,
+        ...genAiConversationAttributes(params.conversationId),
+    };
+}
+/** Response-side attributes: served model + finish reasons. Omits unset fields. */
+export function genAiResponseAttributes(params) {
+    const attrs = {};
+    if (params.model)
+        attrs[GEN_AI_RESPONSE_MODEL] = params.model;
+    if (params.finishReason)
+        attrs[GEN_AI_RESPONSE_FINISH_REASONS] = [params.finishReason];
+    return attrs;
+}
+/** Token usage attributes — ints, only the fields actually present. */
+export function genAiUsageAttributes(usage) {
+    if (!usage)
+        return {};
+    const attrs = {};
+    if (typeof usage.promptTokens === "number")
+        attrs[GEN_AI_USAGE_INPUT_TOKENS] = usage.promptTokens;
+    if (typeof usage.completionTokens === "number")
+        attrs[GEN_AI_USAGE_OUTPUT_TOKENS] = usage.completionTokens;
+    if (typeof usage.reasoningTokens === "number")
+        attrs[GEN_AI_USAGE_REASONING_TOKENS] = usage.reasoningTokens;
+    return attrs;
+}
+function truncateContent(value, maxLength) {
+    if (value.length <= maxLength)
+        return { text: value, truncated: false };
+    return { text: value.slice(0, maxLength), truncated: true };
+}
+/**
+ * Opt-in content attributes — `no_content` (default) returns `{}`.
+ * `full` emits `gen_ai.input.messages` / `gen_ai.output.messages` as
+ * (possibly truncated) JSON strings + a `vnt.trace.content_truncated` flag.
+ */
+export function genAiContentAttributes(params, options) {
+    if ((options?.contentMode ?? "no_content") !== "full")
+        return {};
+    const max = options?.maxContentLength ?? DEFAULT_GEN_AI_MAX_CONTENT_LENGTH;
+    const attrs = {};
+    let truncated = false;
+    if (params.inputJson !== undefined) {
+        const r = truncateContent(params.inputJson, max);
+        attrs[GEN_AI_INPUT_MESSAGES] = r.text;
+        truncated = truncated || r.truncated;
+    }
+    if (params.outputJson !== undefined) {
+        const r = truncateContent(params.outputJson, max);
+        attrs[GEN_AI_OUTPUT_MESSAGES] = r.text;
+        truncated = truncated || r.truncated;
+    }
+    if (truncated)
+        attrs[VNT_TRACE_CONTENT_TRUNCATED] = true;
+    return attrs;
+}
+/** Attributes for an `execute_tool` span. */
+export function genAiToolAttributes(params) {
+    return {
+        [GEN_AI_OPERATION_NAME]: GEN_AI_OPERATIONS.executeTool,
+        [GEN_AI_TOOL_NAME]: params.toolName,
+        ...genAiConversationAttributes(params.conversationId),
+        ...(params.toolCallId ? { [GEN_AI_TOOL_CALL_ID]: params.toolCallId } : {}),
+    };
+}
+/** Attributes for a top-level `invoke_agent` span. */
+export function genAiInvokeAgentAttributes(params) {
+    return {
+        [GEN_AI_OPERATION_NAME]: GEN_AI_OPERATIONS.invokeAgent,
+        ...genAiConversationAttributes(params.conversationId),
+    };
+}
+//# sourceMappingURL=gen-ai-attributes.js.map

package/dist/gen-ai-attributes.js.map

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

package/dist/index.d.ts

@@ -9,6 +9,8 @@
  */
 export { SpanRecorder, createSpan, endSpan, addSpanEvent, generateTraceId, } from "./tracing.js";
 export type { Span, SpanKind, SpanStatus, SpanEvent, SpanNode, TraceContext } from "./tracing.js";
+export { GEN_AI_OPERATION_NAME, GEN_AI_PROVIDER_NAME, GEN_AI_REQUEST_MODEL, GEN_AI_RESPONSE_MODEL, GEN_AI_USAGE_INPUT_TOKENS, GEN_AI_USAGE_OUTPUT_TOKENS, GEN_AI_USAGE_REASONING_TOKENS, GEN_AI_RESPONSE_FINISH_REASONS, GEN_AI_CONVERSATION_ID, GEN_AI_TOOL_NAME, GEN_AI_TOOL_CALL_ID, GEN_AI_INPUT_MESSAGES, GEN_AI_OUTPUT_MESSAGES, GEN_AI_OPERATIONS, DEFAULT_GEN_AI_MAX_CONTENT_LENGTH, VNT_TRACE_CONTENT_TRUNCATED, genAiConversationAttributes, genAiChatRequestAttributes, genAiResponseAttributes, genAiUsageAttributes, genAiContentAttributes, genAiToolAttributes, genAiInvokeAgentAttributes, } from "./gen-ai-attributes.js";
+export type { GenAiOperation, GenAiContentMode, GenAiUsage, GenAiContentOptions, } from "./gen-ai-attributes.js";
 export { Timeline, buildTranscript } from "./timeline.js";
 export type { TimelineEvent, TimelineEventType, TranscriptEntry } from "./timeline.js";
 export { CostMeter, calculateCost, calculateContextPressure, DEFAULT_MODEL_PRICING, MODEL_PRICING, ConsoleTelemetryProvider } from "./telemetry.js";

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,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"}
+{"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,EACL,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,yBAAyB,EACzB,0BAA0B,EAC1B,6BAA6B,EAC7B,8BAA8B,EAC9B,sBAAsB,EACtB,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,EACjB,iCAAiC,EACjC,2BAA2B,EAC3B,2BAA2B,EAC3B,0BAA0B,EAC1B,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAGhC,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

@@ -9,6 +9,8 @@
  */
 // ── Tracing ──
 export { SpanRecorder, createSpan, endSpan, addSpanEvent, generateTraceId, } from "./tracing.js";
+// ── GenAI semantic conventions (OTel gen_ai.*, ADK profile) ──
+export { GEN_AI_OPERATION_NAME, GEN_AI_PROVIDER_NAME, GEN_AI_REQUEST_MODEL, GEN_AI_RESPONSE_MODEL, GEN_AI_USAGE_INPUT_TOKENS, GEN_AI_USAGE_OUTPUT_TOKENS, GEN_AI_USAGE_REASONING_TOKENS, GEN_AI_RESPONSE_FINISH_REASONS, GEN_AI_CONVERSATION_ID, GEN_AI_TOOL_NAME, GEN_AI_TOOL_CALL_ID, GEN_AI_INPUT_MESSAGES, GEN_AI_OUTPUT_MESSAGES, GEN_AI_OPERATIONS, DEFAULT_GEN_AI_MAX_CONTENT_LENGTH, VNT_TRACE_CONTENT_TRUNCATED, genAiConversationAttributes, genAiChatRequestAttributes, genAiResponseAttributes, genAiUsageAttributes, genAiContentAttributes, genAiToolAttributes, genAiInvokeAgentAttributes, } from "./gen-ai-attributes.js";
 // ── Timeline ──
 export { Timeline, buildTranscript } from "./timeline.js";
 // ── Telemetry ──

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,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"}
+{"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,gEAAgE;AAChE,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,yBAAyB,EACzB,0BAA0B,EAC1B,6BAA6B,EAC7B,8BAA8B,EAC9B,sBAAsB,EACtB,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,EACjB,iCAAiC,EACjC,2BAA2B,EAC3B,2BAA2B,EAC3B,0BAA0B,EAC1B,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAQhC,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/timeline.d.ts

@@ -7,9 +7,31 @@
  * 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" | (string & {});
-export declare const KNOWN_TIMELINE_EVENT_TYPES: readonly TimelineEventType[];
+import type { KnownRunEvent } from "@vinhnt-sdk/schema";
+/**
+ * Timeline event types — DERIVED from `KnownRunEvent["type"]` (the canonical
+ * run-event vocabulary). There is intentionally no `(string & {})` escape
+ * hatch: a name that is not emitted by the SDK cannot enter the timeline, so
+ * phantom names (`turn.ended`, `permission.asked`, `assistant.chunk`, …) are
+ * rejected at compile time.
+ */
+export type TimelineEventType = KnownRunEvent["type"];
+/**
+ * Every timeline event type the SDK emits, in emission order.
+ *
+ * Checked both ways at compile time:
+ * - `satisfies` → an unknown name fails typecheck (no phantoms);
+ * - {@link TimelineCoversAllRunEvents} → a missing name fails typecheck
+ *   (adding a `KnownRunEvent` without updating this list is a build error).
+ */
+export declare const KNOWN_TIMELINE_EVENT_TYPES: readonly ["run.started", "step.started", "token.streamed", "thinking.started", "thinking.content", "thinking.completed", "context.compressed", "token.counted", "tool.invoked", "tool.completed", "tool.failed", "tool.cancelled", "tool.self_correcting", "step.completed", "step.failed", "run.completed", "permission.requested", "permission.replied", "step.type_changed", "model.cost", "turn.started", "turn.end", "agent.handoff", "llm.retry", "llm.retry_started", "llm.failover", "approval.asked", "approval.decided", "request.header", "request.context", "llm.request", "llm.response"];
+/** Compile-time helper: constrains `T` to `never` (errors on anything else). */
+type AssertNever<T extends never> = T;
+/**
+ * Compile-time drift check: fails to typecheck when a `KnownRunEvent` type
+ * is missing from {@link KNOWN_TIMELINE_EVENT_TYPES}.
+ */
+export type TimelineCoversAllRunEvents = AssertNever<Exclude<KnownRunEvent["type"], (typeof KNOWN_TIMELINE_EVENT_TYPES)[number]>>;
 /** A single timeline event */
 export interface TimelineEvent {
     /** Event type */
@@ -60,4 +82,5 @@ export interface TranscriptEntry {
     output?: unknown;
     timestampMs: number;
 }
+export {};
 //# sourceMappingURL=timeline.d.ts.map

package/dist/timeline.d.ts.map

@@ -1 +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,GACpB,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAClB,eAAO,MAAM,0BAA0B,EAAE,SAAS,iBAAiB,EAsBlE,CAAC;AAEF,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"}
+{"version":3,"file":"timeline.d.ts","sourceRoot":"","sources":["../src/timeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;AAEtD;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,wkBAiCc,CAAC;AAEtD,gFAAgF;AAChF,KAAK,WAAW,CAAC,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC;AAEtC;;;GAGG;AACH,MAAM,MAAM,0BAA0B,GAAG,WAAW,CAClD,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAC,CAC5E,CAAC;AAEF,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

@@ -7,28 +7,47 @@
  * The timeline is a linear sequence of events that can be replayed
  * to reconstruct the full conversation history.
  */
+/**
+ * Every timeline event type the SDK emits, in emission order.
+ *
+ * Checked both ways at compile time:
+ * - `satisfies` → an unknown name fails typecheck (no phantoms);
+ * - {@link TimelineCoversAllRunEvents} → a missing name fails typecheck
+ *   (adding a `KnownRunEvent` without updating this list is a build error).
+ */
 export const KNOWN_TIMELINE_EVENT_TYPES = [
     "run.started",
-    "run.completed",
-    "run.failed",
     "step.started",
-    "step.completed",
-    "step.failed",
-    "turn.started",
-    "turn.ended",
+    "token.streamed",
+    "thinking.started",
+    "thinking.content",
+    "thinking.completed",
+    "context.compressed",
+    "token.counted",
     "tool.invoked",
     "tool.completed",
     "tool.failed",
     "tool.cancelled",
-    "approval.asked",
-    "approval.decided",
+    "tool.self_correcting",
+    "step.completed",
+    "step.failed",
+    "run.completed",
+    "permission.requested",
+    "permission.replied",
+    "step.type_changed",
+    "model.cost",
+    "turn.started",
+    "turn.end",
+    "agent.handoff",
     "llm.retry",
     "llm.retry_started",
-    "assistant.chunk",
-    "token.compressed",
-    "context.compressed",
-    "permission.asked",
-    "permission.decided",
+    "llm.failover",
+    "approval.asked",
+    "approval.decided",
+    "request.header",
+    "request.context",
+    "llm.request",
+    "llm.response",
 ];
 /**
  * Timeline — ordered sequence of events for a session.
@@ -103,7 +122,7 @@ export function buildTranscript(events) {
                     timestampMs: event.timestampMs,
                 });
                 break;
-            case "assistant.chunk":
+            case "token.streamed":
                 entries.push({
                     type: "assistant",
                     content: event.data.content,

package/dist/timeline.js.map

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

package/dist/tracing.d.ts

@@ -53,8 +53,11 @@ export interface TraceContext {
 export declare function generateTraceId(): string;
 /**
  * Create a new span.
+ *
+ * `startTimeMs` back-dates the span — used when a span is recorded after the
+ * work finished (e.g. tool batches, failed calls) but must keep its real start.
  */
-export declare function createSpan(name: string, kind: SpanKind, parentId?: string, traceId?: string): Span;
+export declare function createSpan(name: string, kind: SpanKind, parentId?: string, traceId?: string, startTimeMs?: number): Span;
 /**
  * End a span with a status.
  */
@@ -70,8 +73,8 @@ 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;
+    /** Start a new span — `startTimeMs` optionally back-dates the start. */
+    startSpan(name: string, kind: SpanKind, parentId?: string, startTimeMs?: number): Span;
     /** End a span */
     endSpan(span: Span, status?: SpanStatus): void;
     /** Get all recorded spans */

package/dist/tracing.d.ts.map

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

package/dist/tracing.js

@@ -19,15 +19,18 @@ export function generateTraceId() {
 }
 /**
  * Create a new span.
+ *
+ * `startTimeMs` back-dates the span — used when a span is recorded after the
+ * work finished (e.g. tool batches, failed calls) but must keep its real start.
  */
-export function createSpan(name, kind, parentId, traceId) {
+export function createSpan(name, kind, parentId, traceId, startTimeMs) {
     return {
         id: generateSpanId(),
         traceId,
         parentId,
         name,
         kind,
-        startTimeMs: Date.now(),
+        startTimeMs: startTimeMs ?? Date.now(),
         endTimeMs: 0,
         status: "ok",
         attributes: {},
@@ -60,9 +63,9 @@ export class SpanRecorder {
     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);
+    /** Start a new span — `startTimeMs` optionally back-dates the start. */
+    startSpan(name, kind, parentId, startTimeMs) {
+        const span = createSpan(name, kind, parentId ?? this.spans[this.spans.length - 1]?.id, this.traceId, startTimeMs);
         this.spans.push(span);
         return span;
     }

package/dist/tracing.js.map

@@ -1 +1 @@
-{"version":3,"file":"tracing.js","sourceRoot":"","sources":["../src/tracing.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,CAAC,MAAM,mBAAmB,GAA0B,CAAC,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;AA6ClG,IAAI,WAAW,GAAG,CAAC,CAAC;AAEpB,gCAAgC;AAChC,SAAS,cAAc;IACrB,OAAO,QAAQ,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;AAC3E,CAAC;AAED,iCAAiC;AACjC,MAAM,UAAU,eAAe;IAC7B,OAAO,SAAS,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AACtF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CACxB,IAAY,EACZ,IAAc,EACd,QAAiB,EACjB,OAAgB;IAEhB,OAAO;QACL,EAAE,EAAE,cAAc,EAAE;QACpB,OAAO;QACP,QAAQ;QACR,IAAI;QACJ,IAAI;QACJ,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE;QACvB,SAAS,EAAE,CAAC;QACZ,MAAM,EAAE,IAAI;QACZ,UAAU,EAAE,EAAE;QACd,MAAM,EAAE,EAAE;KACX,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,IAAU,EAAE,SAAqB,IAAI;IAC3D,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC5B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,IAAU,EAAE,IAAY,EAAE,UAAoC;IACzF,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;QACf,IAAI;QACJ,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE;QACvB,UAAU,EAAE,UAAU,IAAI,EAAE;KAC7B,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,YAAY;IACN,KAAK,GAAW,EAAE,CAAC;IACnB,OAAO,CAAS;IAEjC,YAAY,OAAgB;QAC1B,IAAI,CAAC,OAAO,GAAG,OAAO,IAAI,eAAe,EAAE,CAAC;IAC9C,CAAC;IAED,uBAAuB;IACvB,SAAS,CAAC,IAAY,EAAE,IAAc,EAAE,QAAiB;QACvD,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACrG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,iBAAiB;IACjB,OAAO,CAAC,IAAU,EAAE,SAAqB,IAAI;QAC3C,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxB,CAAC;IAED,6BAA6B;IAC7B,QAAQ;QACN,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED,sCAAsC;IACtC,WAAW;QACT,MAAM,OAAO,GAAG,IAAI,GAAG,EAAoB,CAAC;QAC5C,MAAM,KAAK,GAAe,EAAE,CAAC;QAE7B,eAAe;QACf,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;QAC/C,CAAC;QAED,aAAa;QACb,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YACpC,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACvB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC/C,IAAI,MAAM,EAAE,CAAC;oBACX,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC7B,CAAC;qBAAM,CAAC;oBACN,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACnB,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED,sCAAsC;IACtC,kBAAkB;QAChB,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QACtC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;QAChE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAC1E,OAAO,GAAG,GAAG,KAAK,CAAC;IACrB,CAAC;CACF"}
+{"version":3,"file":"tracing.js","sourceRoot":"","sources":["../src/tracing.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vinhnt-sdk/trace",
-  "version": "0.4.3",
+  "version": "0.11.1",
   "description": "Observability - OpenTelemetry spans, timeline replay, telemetry aggregation",
   "license": "MIT",
   "type": "module",
@@ -25,7 +25,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/vinhnt-develop/vinhnt-sdk.git",
+    "url": "git+https://github.com/vinhnt-develop/vinhnt-sdk.git",
     "directory": "packages/trace"
   },
   "homepage": "https://github.com/vinhnt-develop/vinhnt-sdk/tree/main/packages/trace",
@@ -42,18 +42,17 @@
   "publishConfig": {
     "access": "public"
   },
+  "dependencies": {
+    "@vinhnt-sdk/schema": "0.11.1"
+  },
+  "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"
   }
-}
+}