@vinhnt-sdk/trace 0.4.2 → 0.11.0

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

@@ -0,0 +1,200 @@
+# @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,
+  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)
+
+| 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).
+
+### 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";
+
+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/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,8 +9,12 @@
  */
 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 } 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,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,8 +9,12 @@
  */
 // ── 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 ──
-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,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"}