@respan/instrumentation-vercel 1.0.4 → 1.0.6

package/dist/_translator/shared.js

@@ -0,0 +1,162 @@
+import { RespanLogType, RespanSpanAttributes } from "@respan/respan-sdk";
+import { VERCEL_PARENT_SPANS, VERCEL_SPAN_CONFIG } from "../constants/index.js";
+export const RESPAN_LOG_TYPE = RespanSpanAttributes.RESPAN_LOG_TYPE;
+export const GEN_AI_REQUEST_MODEL = RespanSpanAttributes.GEN_AI_REQUEST_MODEL;
+export const GEN_AI_USAGE_PROMPT_TOKENS = RespanSpanAttributes.GEN_AI_USAGE_PROMPT_TOKENS;
+export const GEN_AI_USAGE_COMPLETION_TOKENS = RespanSpanAttributes.GEN_AI_USAGE_COMPLETION_TOKENS;
+export const LLM_REQUEST_TYPE = RespanSpanAttributes.LLM_REQUEST_TYPE;
+export const CUSTOMER_ID = RespanSpanAttributes.RESPAN_CUSTOMER_PARAMS_ID;
+export const CUSTOMER_EMAIL = RespanSpanAttributes.RESPAN_CUSTOMER_PARAMS_EMAIL;
+export const CUSTOMER_NAME = RespanSpanAttributes.RESPAN_CUSTOMER_PARAMS_NAME;
+export const THREAD_ID = RespanSpanAttributes.RESPAN_THREADS_ID;
+export const SESSION_ID = "respan.sessions.session_identifier";
+export const TRACE_GROUP_ID = RespanSpanAttributes.RESPAN_TRACE_GROUP_ID;
+export const RESPAN_SPAN_TOOLS = RespanSpanAttributes.RESPAN_SPAN_TOOLS;
+export const RESPAN_SPAN_TOOL_CALLS = RespanSpanAttributes.RESPAN_SPAN_TOOL_CALLS;
+export const RESPAN_METADATA_AGENT_NAME = RespanSpanAttributes.RESPAN_METADATA_AGENT_NAME;
+export const RESPAN_METADATA_PREFIX = RespanSpanAttributes.RESPAN_METADATA;
+export const TL_SPAN_KIND = "traceloop.span.kind";
+export const TL_ENTITY_INPUT = "traceloop.entity.input";
+export const TL_ENTITY_OUTPUT = "traceloop.entity.output";
+export const TL_REQUEST_FUNCTIONS = "llm.request.functions";
+export const AI_PREFIX = "ai.";
+export const AI_SDK = "ai.sdk";
+export const AI_OPERATION_ID = "ai.operationId";
+export const AI_MODEL_ID = "ai.model.id";
+export const AI_EMBEDDING = "ai.embedding";
+export const AI_EMBEDDINGS = "ai.embeddings";
+export const AI_AGENT_ID = "ai.agent.id";
+export const AI_WORKFLOW_ID = "ai.workflow.id";
+export const AI_TRANSCRIPT = "ai.transcript";
+export const AI_SPEECH = "ai.speech";
+export const AI_TELEMETRY_METADATA_PREFIX = "ai.telemetry.metadata.";
+export const AI_PROMPT = "ai.prompt";
+export const AI_PROMPT_MESSAGES = "ai.prompt.messages";
+export const AI_PROMPT_TOOLS = "ai.prompt.tools";
+export const AI_PROMPT_TOOL_CHOICE = "ai.prompt.toolChoice";
+export const AI_RESPONSE_OBJECT = "ai.response.object";
+export const AI_RESPONSE_TEXT = "ai.response.text";
+export const AI_RESPONSE_TOOL_CALLS = "ai.response.toolCalls";
+export const AI_RESPONSE_MS_TO_FINISH = "ai.response.msToFinish";
+export const AI_TOOL_CALL = "ai.toolCall";
+export const AI_TOOL_CALLS = "ai.toolCalls";
+export const AI_TOOL_CALL_PREFIX = "ai.toolCall.";
+export const AI_TOOL_CALL_ID = "ai.toolCall.id";
+export const AI_TOOL_CALL_NAME = "ai.toolCall.name";
+export const AI_TOOL_CALL_ARGS = "ai.toolCall.args";
+export const AI_TOOL_CALL_RESULT = "ai.toolCall.result";
+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_COST = "gen_ai.usage.cost";
+export const GEN_AI_USAGE_TTFT = "gen_ai.usage.ttft";
+export const GEN_AI_USAGE_GENERATION_TIME = "gen_ai.usage.generation_time";
+export const GEN_AI_USAGE_WARNINGS = "gen_ai.usage.warnings";
+export const GEN_AI_USAGE_TYPE = "gen_ai.usage.type";
+export function metadataKey(key) {
+    return `${RESPAN_METADATA_PREFIX}.${key}`;
+}
+export function setDefault(attrs, key, value) {
+    if (attrs[key] === undefined && value !== undefined && value !== null) {
+        attrs[key] = value;
+    }
+}
+export function safeJsonStr(value) {
+    if (value === undefined || value === null)
+        return "";
+    if (typeof value === "string")
+        return value;
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return String(value);
+    }
+}
+export function safeJsonParse(value) {
+    if (typeof value !== "string")
+        return value;
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return value;
+    }
+}
+export function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+export function isVercelAISpan(span) {
+    if (span.instrumentationLibrary?.name === "ai") {
+        return true;
+    }
+    if (span.attributes[AI_SDK] !== undefined) {
+        return true;
+    }
+    return span.name.startsWith(AI_PREFIX);
+}
+export function resolveLogType(name, attrs) {
+    const config = VERCEL_SPAN_CONFIG[name];
+    if (config) {
+        return config.logType;
+    }
+    const parentType = VERCEL_PARENT_SPANS[name];
+    if (parentType) {
+        return parentType;
+    }
+    const operationId = attrs[AI_OPERATION_ID]?.toString();
+    if (operationId) {
+        const operationConfig = VERCEL_SPAN_CONFIG[operationId];
+        if (operationConfig) {
+            return operationConfig.logType;
+        }
+        const operationParentType = VERCEL_PARENT_SPANS[operationId];
+        if (operationParentType) {
+            return operationParentType;
+        }
+    }
+    if (attrs[AI_EMBEDDING] || attrs[AI_EMBEDDINGS] ||
+        name.includes("embed") || operationId?.includes("embed")) {
+        return RespanLogType.EMBEDDING;
+    }
+    if (attrs[AI_TOOL_CALL_ID] || attrs[AI_TOOL_CALL_NAME] ||
+        attrs[AI_TOOL_CALL_ARGS] || attrs[AI_TOOL_CALL_RESULT] ||
+        attrs[AI_RESPONSE_TOOL_CALLS] ||
+        name.includes("tool") || operationId?.includes("tool")) {
+        return RespanLogType.TOOL;
+    }
+    if (attrs[AI_AGENT_ID] ||
+        name.includes("agent") || operationId?.includes("agent")) {
+        return RespanLogType.AGENT;
+    }
+    if (attrs[AI_WORKFLOW_ID] ||
+        name.includes("workflow") || operationId?.includes("workflow")) {
+        return RespanLogType.WORKFLOW;
+    }
+    if (attrs[AI_TRANSCRIPT] ||
+        name.includes("transcript") || operationId?.includes("transcript")) {
+        return RespanLogType.TRANSCRIPTION;
+    }
+    if (attrs[AI_SPEECH] ||
+        name.includes("speech") || operationId?.includes("speech")) {
+        return RespanLogType.SPEECH;
+    }
+    if (name.includes("doGenerate") || name.includes("doStream")) {
+        return RespanLogType.TEXT;
+    }
+    return RespanLogType.UNKNOWN;
+}
+export function normalizeModel(modelId) {
+    const model = modelId.toLowerCase();
+    if (model.includes("gemini-2.0-flash-001"))
+        return "gemini/gemini-2.0-flash";
+    if (model.includes("gemini-2.0-pro"))
+        return "gemini/gemini-2.0-pro-exp-02-05";
+    if (model.includes("claude-3-5-sonnet"))
+        return "claude-3-5-sonnet-20241022";
+    if (model.includes("deepseek"))
+        return `deepseek/${model}`;
+    if (model.includes("o3-mini"))
+        return "o3-mini";
+    return model;
+}
+//# sourceMappingURL=shared.js.map

package/dist/_translator/shared.js.map

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

package/dist/_translator/span-enrichment.d.ts

@@ -0,0 +1,5 @@
+import { type SpanAttributes } from "./shared.js";
+export declare function enrichMetadata(attrs: SpanAttributes): void;
+export declare function enrichTokens(attrs: SpanAttributes): void;
+export declare function enrichPerformanceMetrics(attrs: SpanAttributes, spanName: string): void;
+export declare function stripRedundantAttrs(attrs: SpanAttributes): void;

package/dist/_translator/span-enrichment.js

@@ -0,0 +1,188 @@
+import { AI_MODEL_ID, AI_OPERATION_ID, AI_PROMPT, AI_PROMPT_MESSAGES, AI_PROMPT_TOOL_CHOICE, AI_PROMPT_TOOLS, AI_RESPONSE_OBJECT, AI_RESPONSE_MS_TO_FINISH, AI_RESPONSE_TEXT, AI_RESPONSE_TOOL_CALLS, AI_SDK, AI_TELEMETRY_METADATA_PREFIX, AI_TOOL_CALL_ARGS, AI_TOOL_CALL_ID, AI_TOOL_CALL_NAME, AI_TOOL_CALL_RESULT, CUSTOMER_EMAIL, CUSTOMER_ID, CUSTOMER_NAME, GEN_AI_USAGE_COST, GEN_AI_USAGE_GENERATION_TIME, GEN_AI_USAGE_INPUT_TOKENS, GEN_AI_USAGE_OUTPUT_TOKENS, GEN_AI_USAGE_TTFT, GEN_AI_USAGE_TYPE, GEN_AI_USAGE_WARNINGS, GEN_AI_USAGE_COMPLETION_TOKENS, GEN_AI_USAGE_PROMPT_TOKENS, SESSION_ID, THREAD_ID, TRACE_GROUP_ID, metadataKey, setDefault, } from "./shared.js";
+export function enrichMetadata(attrs) {
+    for (const [key, value] of Object.entries(attrs)) {
+        if (!key.startsWith(AI_TELEMETRY_METADATA_PREFIX)) {
+            continue;
+        }
+        const cleanKey = key.slice(AI_TELEMETRY_METADATA_PREFIX.length);
+        switch (cleanKey) {
+            case "customer_identifier":
+                setDefault(attrs, CUSTOMER_ID, String(value));
+                break;
+            case "customer_email":
+                setDefault(attrs, CUSTOMER_EMAIL, String(value));
+                break;
+            case "customer_name":
+                setDefault(attrs, CUSTOMER_NAME, String(value));
+                break;
+            case "session_identifier":
+                setDefault(attrs, SESSION_ID, String(value));
+                break;
+            case "thread_identifier":
+                setDefault(attrs, THREAD_ID, String(value));
+                break;
+            case "trace_group_identifier":
+                setDefault(attrs, TRACE_GROUP_ID, String(value));
+                break;
+            case "customer_params": {
+                // customer_params is a JSON-stringified object (Vercel telemetry
+                // metadata values must be flat scalars, so users serialize the object).
+                // Documented shape uses `email` / `name` (matching the Customer columns
+                // in the UI); accept the legacy `customer_email` / `customer_name`
+                // aliases too so older integrations keep working.
+                try {
+                    const parsed = typeof value === "string" ? JSON.parse(value) : value;
+                    if (parsed?.customer_identifier)
+                        setDefault(attrs, CUSTOMER_ID, parsed.customer_identifier);
+                    const email = parsed?.email ?? parsed?.customer_email;
+                    if (email)
+                        setDefault(attrs, CUSTOMER_EMAIL, email);
+                    const name = parsed?.name ?? parsed?.customer_name;
+                    if (name)
+                        setDefault(attrs, CUSTOMER_NAME, name);
+                }
+                catch {
+                    // Ignore malformed customer_params metadata.
+                }
+                break;
+            }
+            case "prompt_unit_price":
+                setDefault(attrs, metadataKey("prompt_unit_price"), String(value));
+                break;
+            case "completion_unit_price":
+                setDefault(attrs, metadataKey("completion_unit_price"), String(value));
+                break;
+            case "userId":
+                setDefault(attrs, CUSTOMER_ID, String(value));
+                setDefault(attrs, metadataKey(cleanKey), String(value ?? ""));
+                break;
+            default:
+                setDefault(attrs, metadataKey(cleanKey), String(value ?? ""));
+                break;
+        }
+    }
+}
+export function enrichTokens(attrs) {
+    const inputTokens = attrs[GEN_AI_USAGE_INPUT_TOKENS] ??
+        attrs["gen_ai.usage.prompt_tokens"];
+    const outputTokens = attrs[GEN_AI_USAGE_OUTPUT_TOKENS] ??
+        attrs["gen_ai.usage.completion_tokens"];
+    if (inputTokens !== undefined) {
+        setDefault(attrs, GEN_AI_USAGE_PROMPT_TOKENS, Number(inputTokens));
+    }
+    if (outputTokens !== undefined) {
+        setDefault(attrs, GEN_AI_USAGE_COMPLETION_TOKENS, Number(outputTokens));
+    }
+}
+export function enrichPerformanceMetrics(attrs, spanName) {
+    setDefault(attrs, metadataKey("stream"), String(spanName.includes("doStream")));
+    const msToFinish = attrs[AI_RESPONSE_MS_TO_FINISH];
+    if (msToFinish !== undefined) {
+        setDefault(attrs, metadataKey("time_to_first_token"), String(Number(msToFinish) / 1000));
+    }
+    const cost = attrs[GEN_AI_USAGE_COST];
+    if (cost !== undefined) {
+        setDefault(attrs, metadataKey("cost"), String(cost));
+    }
+    const ttft = attrs[GEN_AI_USAGE_TTFT];
+    if (ttft !== undefined) {
+        setDefault(attrs, metadataKey("ttft"), String(ttft));
+    }
+    const generationTime = attrs[GEN_AI_USAGE_GENERATION_TIME];
+    if (generationTime !== undefined) {
+        setDefault(attrs, metadataKey("generation_time"), String(generationTime));
+    }
+    const warnings = attrs[GEN_AI_USAGE_WARNINGS];
+    if (warnings !== undefined) {
+        setDefault(attrs, metadataKey("warnings"), String(warnings));
+    }
+    const responseType = attrs[GEN_AI_USAGE_TYPE];
+    if (responseType !== undefined) {
+        setDefault(attrs, metadataKey("type"), String(responseType));
+    }
+}
+const VERCEL_ATTRS_TO_STRIP = [
+    AI_MODEL_ID,
+    "ai.model.provider",
+    "ai.response.model",
+    AI_PROMPT,
+    AI_PROMPT_MESSAGES,
+    "ai.prompt.format",
+    AI_RESPONSE_TEXT,
+    AI_RESPONSE_OBJECT,
+    "ai.usage.promptTokens",
+    "ai.usage.completionTokens",
+    "ai.usage.inputTokens",
+    "ai.usage.outputTokens",
+    "ai.usage.totalTokens",
+    "ai.usage.reasoningTokens",
+    "ai.usage.cachedInputTokens",
+    "ai.response.finishReason",
+    "ai.response.id",
+    "ai.response.timestamp",
+    "ai.response.providerMetadata",
+    AI_RESPONSE_MS_TO_FINISH,
+    "ai.response.msToFirstChunk",
+    "ai.response.avgOutputTokensPerSecond",
+    "ai.response.avgCompletionTokensPerSecond",
+    "ai.request.headers.user-agent",
+    AI_PROMPT_TOOL_CHOICE,
+    AI_OPERATION_ID,
+    "ai.settings.maxRetries",
+    "ai.settings.maxSteps",
+    AI_SDK,
+    "operation.name",
+    AI_TOOL_CALL_ID,
+    AI_TOOL_CALL_NAME,
+    AI_TOOL_CALL_ARGS,
+    AI_TOOL_CALL_RESULT,
+    AI_RESPONSE_TOOL_CALLS,
+    "gen_ai.response.finish_reasons",
+    "gen_ai.response.id",
+    "gen_ai.usage.input_tokens",
+    "gen_ai.usage.output_tokens",
+    "gen_ai.system",
+    "traceloop.entity.name",
+    "traceloop.entity.path",
+    "service.name",
+    "telemetry.sdk.language",
+    "telemetry.sdk.name",
+    "telemetry.sdk.version",
+    "process.pid",
+    "process.executable.name",
+    "process.executable.path",
+    "process.command_args",
+    "process.runtime.version",
+    "process.runtime.name",
+    "process.runtime.description",
+    "process.command",
+    "process.owner",
+    "host.name",
+    "host.arch",
+    "host.id",
+    "otel.scope.name",
+    "otel.scope.version",
+    "next.span_name",
+    "next.span_type",
+    "http.url",
+    "http.method",
+    "net.peer.name",
+];
+export function stripRedundantAttrs(attrs) {
+    for (const key of VERCEL_ATTRS_TO_STRIP) {
+        delete attrs[key];
+    }
+    for (const key of Object.keys(attrs)) {
+        if (key.startsWith(AI_TELEMETRY_METADATA_PREFIX)) {
+            delete attrs[key];
+            continue;
+        }
+        if (key.startsWith("ai.usage.") && key.includes("Details.")) {
+            delete attrs[key];
+        }
+    }
+    if (attrs[AI_PROMPT_TOOLS] !== undefined) {
+        delete attrs[AI_PROMPT_TOOLS];
+    }
+}
+//# sourceMappingURL=span-enrichment.js.map

package/dist/_translator/span-enrichment.js.map

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

package/dist/_translator.d.ts

@@ -8,22 +8,9 @@
  * Two-phase enrichment:
  * - onStart(): Sets RESPAN_LOG_TYPE so the span passes CompositeProcessor filtering
  * - onEnd():   Full attribute translation (model, messages, tokens, metadata, etc.)
- *
- * Vercel attrs are preserved (additive enrichment via setDefault, not destructive).
- *
- * Ported from @respan/exporter-vercel — all exporter features are replicated:
- * - Model normalization (Gemini, Claude, DeepSeek, O3-mini)
- * - Prompt message parsing (ai.prompt.messages + ai.prompt fallback)
- * - Completion message building (ai.response.text, ai.response.object, tool calls)
- * - Token count normalization (input/output → prompt/completion)
- * - Tool definitions (ai.prompt.tools) and tool choice (ai.prompt.toolChoice)
- * - Customer params (ai.telemetry.metadata.customer_* + customer_params JSON)
- * - General metadata (ai.telemetry.metadata.* → respan.metadata.*)
- * - Stream detection, environment, cost, TTFT, generation time, unit prices
- * - Log type detection with operationId + attribute-based fallbacks
  */
 import type { Context } from "@opentelemetry/api";
-import type { SpanProcessor, ReadableSpan, Span } from "@opentelemetry/sdk-trace-base";
+import type { ReadableSpan, Span, SpanProcessor } from "@opentelemetry/sdk-trace-base";
 /**
  * SpanProcessor that translates Vercel AI SDK attributes to Traceloop/OpenLLMetry.
  *
@@ -34,6 +21,6 @@ import type { SpanProcessor, ReadableSpan, Span } from "@opentelemetry/sdk-trace
 export declare class VercelAITranslator implements SpanProcessor {
     onStart(span: Span, _parentContext: Context): void;
     onEnd(span: ReadableSpan): void;
-    shutdown(): Promise<void>;
     forceFlush(): Promise<void>;
+    shutdown(): Promise<void>;
 }