@respan/instrumentation-vercel 1.0.0

package/dist/_translator.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Translate Vercel AI SDK spans → Traceloop/OpenLLMetry format.
+ *
+ * The Vercel AI SDK emits OTEL spans with its own attribute schema (ai.model.id,
+ * ai.prompt.messages, ai.response.text, etc.). This SpanProcessor enriches those
+ * spans with the Traceloop/GenAI semantic conventions the Respan backend expects.
+ *
+ * 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 (gen_ai.usage.tool_choice)
+ * - 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";
+/**
+ * SpanProcessor that translates Vercel AI SDK attributes to Traceloop/OpenLLMetry.
+ *
+ * Phase 1 (onStart): Sets RESPAN_LOG_TYPE so CompositeProcessor lets the span through.
+ * Phase 2 (onEnd):   Full attribute enrichment — model, messages, tokens, metadata,
+ *                     tools, performance metrics, environment, etc.
+ */
+export declare class VercelAITranslator implements SpanProcessor {
+    onStart(span: Span, _parentContext: Context): void;
+    onEnd(span: ReadableSpan): void;
+    shutdown(): Promise<void>;
+    forceFlush(): Promise<void>;
+}

package/dist/_translator.js

@@ -0,0 +1,706 @@
+/**
+ * Translate Vercel AI SDK spans → Traceloop/OpenLLMetry format.
+ *
+ * The Vercel AI SDK emits OTEL spans with its own attribute schema (ai.model.id,
+ * ai.prompt.messages, ai.response.text, etc.). This SpanProcessor enriches those
+ * spans with the Traceloop/GenAI semantic conventions the Respan backend expects.
+ *
+ * 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 (gen_ai.usage.tool_choice)
+ * - 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 { RespanSpanAttributes, RespanLogType } from "@respan/respan-sdk";
+import { VERCEL_SPAN_CONFIG, VERCEL_PARENT_SPANS } from "./constants/index.js";
+// ── Attribute keys (single source of truth from SDK) ─────────────────────────
+const RESPAN_LOG_TYPE = RespanSpanAttributes.RESPAN_LOG_TYPE;
+const GEN_AI_REQUEST_MODEL = RespanSpanAttributes.GEN_AI_REQUEST_MODEL;
+const GEN_AI_USAGE_PROMPT_TOKENS = RespanSpanAttributes.GEN_AI_USAGE_PROMPT_TOKENS;
+const GEN_AI_USAGE_COMPLETION_TOKENS = RespanSpanAttributes.GEN_AI_USAGE_COMPLETION_TOKENS;
+const LLM_REQUEST_TYPE = RespanSpanAttributes.LLM_REQUEST_TYPE;
+const CUSTOMER_ID = RespanSpanAttributes.RESPAN_CUSTOMER_PARAMS_ID;
+const CUSTOMER_EMAIL = RespanSpanAttributes.RESPAN_CUSTOMER_PARAMS_EMAIL;
+const CUSTOMER_NAME = RespanSpanAttributes.RESPAN_CUSTOMER_PARAMS_NAME;
+const THREAD_ID = RespanSpanAttributes.RESPAN_THREADS_ID;
+const TRACE_GROUP_ID = RespanSpanAttributes.RESPAN_TRACE_GROUP_ID;
+const RESPAN_SPAN_TOOLS = RespanSpanAttributes.RESPAN_SPAN_TOOLS;
+const RESPAN_METADATA_AGENT_NAME = RespanSpanAttributes.RESPAN_METADATA_AGENT_NAME;
+const RESPAN_METADATA_PREFIX = RespanSpanAttributes.RESPAN_METADATA; // "respan.metadata"
+/** Build a respan.metadata.<key> attribute name. */
+function metadataKey(key) {
+    return `${RESPAN_METADATA_PREFIX}.${key}`;
+}
+// Traceloop wire-format keys
+const TL_SPAN_KIND = "traceloop.span.kind";
+const TL_ENTITY_NAME = "traceloop.entity.name";
+const TL_ENTITY_INPUT = "traceloop.entity.input";
+const TL_ENTITY_OUTPUT = "traceloop.entity.output";
+const TL_ENTITY_PATH = "traceloop.entity.path";
+// ── Helpers ──────────────────────────────────────────────────────────────────
+function setDefault(attrs, key, value) {
+    if (attrs[key] === undefined && value !== undefined && value !== null) {
+        attrs[key] = value;
+    }
+}
+function safeJsonStr(value) {
+    if (value === undefined || value === null)
+        return "";
+    if (typeof value === "string")
+        return value;
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return String(value);
+    }
+}
+function safeJsonParse(value) {
+    if (typeof value !== "string")
+        return value;
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return value;
+    }
+}
+/**
+ * Detect whether a span is from the Vercel AI SDK.
+ *
+ * Primary check: instrumentation scope name === "ai" (set by the Vercel AI SDK).
+ * Fallback: ai.sdk attribute or ai.* span name.
+ *
+ * Does NOT match on gen_ai.* attributes alone — those may come from other
+ * instrumentations (OpenInference, Traceloop) and must not be stripped.
+ */
+function isVercelAISpan(span) {
+    // Primary: check OTEL instrumentation scope (most reliable, no false positives)
+    if (span.instrumentationLibrary?.name === "ai")
+        return true;
+    // Fallback: explicit Vercel marker or span name convention
+    if (span.attributes["ai.sdk"] !== undefined)
+        return true;
+    if (span.name.startsWith("ai."))
+        return true;
+    return false;
+}
+// ── Log type detection (with operationId + attribute fallbacks) ──────────────
+/**
+ * Resolve the Respan log type for a Vercel AI SDK span.
+ * Replicates the full fallback chain from the exporter's parseLogType().
+ */
+function resolveLogType(name, attrs) {
+    // 1. Direct span name match
+    const config = VERCEL_SPAN_CONFIG[name];
+    if (config)
+        return config.logType;
+    const parentType = VERCEL_PARENT_SPANS[name];
+    if (parentType)
+        return parentType;
+    // 2. operationId attribute fallback
+    const operationId = attrs["ai.operationId"]?.toString();
+    if (operationId) {
+        const opConfig = VERCEL_SPAN_CONFIG[operationId];
+        if (opConfig)
+            return opConfig.logType;
+        const opParent = VERCEL_PARENT_SPANS[operationId];
+        if (opParent)
+            return opParent;
+    }
+    // 3. Attribute-based fallback detection (same heuristics as exporter)
+    if (attrs["ai.embedding"] || attrs["ai.embeddings"] ||
+        name.includes("embed") || operationId?.includes("embed")) {
+        return RespanLogType.EMBEDDING;
+    }
+    if (attrs["ai.toolCall.id"] || attrs["ai.toolCall.name"] ||
+        attrs["ai.toolCall.args"] || attrs["ai.toolCall.result"] ||
+        attrs["ai.response.toolCalls"] ||
+        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;
+    }
+    // 4. Generation span fallback (doGenerate/doStream)
+    if (name.includes("doGenerate") || name.includes("doStream")) {
+        return RespanLogType.TEXT;
+    }
+    return RespanLogType.UNKNOWN;
+}
+// ── Model normalization ──────────────────────────────────────────────────────
+/**
+ * Normalize the model ID from Vercel's ai.model.id to a standard model name.
+ * Replicates the logic from the existing exporter.
+ */
+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;
+}
+// ── Prompt/completion message formatting ─────────────────────────────────────
+/**
+ * Parse ai.prompt.messages into a JSON string suitable for traceloop.entity.input.
+ * Falls back to ai.prompt as a single user message.
+ */
+function formatPromptInput(attrs) {
+    const messages = attrs["ai.prompt.messages"];
+    if (messages) {
+        try {
+            const parsed = typeof messages === "string" ? JSON.parse(messages) : messages;
+            return safeJsonStr(parsed);
+        }
+        catch {
+            // fall through
+        }
+    }
+    const prompt = attrs["ai.prompt"];
+    if (prompt) {
+        return safeJsonStr([{ role: "user", content: String(prompt) }]);
+    }
+    return undefined;
+}
+/**
+ * Build completion output from ai.response.text, ai.response.object, and tool calls.
+ * Also includes tool result messages when present (for tool call spans).
+ */
+function formatCompletionOutput(attrs) {
+    let content = "";
+    if (attrs["ai.response.object"]) {
+        try {
+            const rawObject = attrs["ai.response.object"];
+            const parsed = typeof rawObject === "string" ? JSON.parse(rawObject) : rawObject;
+            // generateObject returns the object directly (no `response` wrapper).
+            // Prefer known wrappers when present, otherwise serialize the object itself.
+            const normalized = parsed?.response ?? parsed?.object ?? parsed?.output ?? parsed?.result ?? parsed;
+            content = safeJsonStr(normalized);
+        }
+        catch {
+            content = String(attrs["ai.response.text"] ?? "");
+        }
+    }
+    else {
+        content = String(attrs["ai.response.text"] ?? "");
+    }
+    if (!content)
+        return undefined;
+    // Build assistant message with optional tool calls
+    const message = { role: "assistant", content };
+    const toolCalls = parseToolCalls(attrs);
+    if (toolCalls && toolCalls.length > 0) {
+        message.tool_calls = toolCalls;
+    }
+    // Include tool result as a separate message if present
+    const messages = [message];
+    if (attrs["ai.toolCall.result"]) {
+        messages.push({
+            role: "tool",
+            tool_call_id: String(attrs["ai.toolCall.id"] || ""),
+            content: String(attrs["ai.toolCall.result"] || ""),
+        });
+    }
+    return safeJsonStr(messages.length === 1 ? message : messages);
+}
+/**
+ * Parse tool call data from various Vercel AI SDK attribute formats.
+ */
+function parseToolCalls(attrs) {
+    // Try array formats first
+    for (const key of ["ai.response.toolCalls", "ai.toolCall", "ai.toolCalls"]) {
+        if (!attrs[key])
+            continue;
+        try {
+            const parsed = typeof attrs[key] === "string" ? JSON.parse(attrs[key]) : attrs[key];
+            const calls = Array.isArray(parsed) ? parsed : [parsed];
+            return calls.map((call) => {
+                if (!call || typeof call !== "object")
+                    return { type: "function" };
+                const result = { ...call };
+                if (!result.type)
+                    result.type = "function";
+                if (!result.id && (result.toolCallId || result.tool_call_id)) {
+                    result.id = result.toolCallId || result.tool_call_id;
+                }
+                return result;
+            });
+        }
+        catch {
+            continue;
+        }
+    }
+    // Try individual tool call attributes
+    if (attrs["ai.toolCall.id"] || attrs["ai.toolCall.name"] || attrs["ai.toolCall.args"]) {
+        const toolCall = { type: "function" };
+        for (const [key, value] of Object.entries(attrs)) {
+            if (key.startsWith("ai.toolCall.")) {
+                toolCall[key.replace("ai.toolCall.", "")] = value;
+            }
+        }
+        return [toolCall];
+    }
+    return undefined;
+}
+/**
+ * Format tool call span input/output for traceloop.entity.input/output.
+ */
+function formatToolInput(attrs) {
+    const name = attrs["ai.toolCall.name"];
+    const args = attrs["ai.toolCall.args"];
+    if (!name && !args)
+        return undefined;
+    const input = {};
+    if (name)
+        input.name = name;
+    if (args) {
+        input.args = typeof args === "string" ? safeJsonParse(args) : args;
+    }
+    return safeJsonStr(input);
+}
+function formatToolOutput(attrs) {
+    const result = attrs["ai.toolCall.result"];
+    if (result === undefined)
+        return undefined;
+    return safeJsonStr(typeof result === "string" ? safeJsonParse(result) : result);
+}
+// ── Tools & tool choice (from exporter's parseTools / parseToolChoice) ───────
+/**
+ * Parse ai.prompt.tools into a normalized tool definition array.
+ * Accepts both nested ({type:"function",function:{...}}) and flat shapes.
+ */
+function parseTools(attrs) {
+    try {
+        const tools = attrs["ai.prompt.tools"];
+        if (!tools)
+            return undefined;
+        const raw = Array.isArray(tools) ? tools : [tools];
+        const parsed = raw
+            .map((tool) => {
+            try {
+                return typeof tool === "string" ? JSON.parse(tool) : tool;
+            }
+            catch {
+                return undefined;
+            }
+        })
+            .filter(Boolean)
+            .map((tool) => {
+            // Accept both nested and flat shapes; normalize to nested
+            if (tool && tool.type === "function") {
+                if (tool.function && typeof tool.function === "object")
+                    return tool;
+                const { name, description, parameters, ...rest } = tool;
+                return {
+                    ...rest,
+                    type: "function",
+                    function: {
+                        name,
+                        ...(description ? { description } : {}),
+                        ...(parameters ? { parameters } : {}),
+                    },
+                };
+            }
+            return tool;
+        });
+        if (parsed.length === 0)
+            return undefined;
+        return safeJsonStr(parsed);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Parse gen_ai.usage.tool_choice into a normalized structure.
+ */
+function parseToolChoice(attrs) {
+    try {
+        const toolChoice = attrs["gen_ai.usage.tool_choice"];
+        if (!toolChoice)
+            return undefined;
+        const parsed = typeof toolChoice === "string" ? JSON.parse(toolChoice) : toolChoice;
+        return safeJsonStr({
+            type: String(parsed.type),
+            function: { name: String(parsed.function.name) },
+        });
+    }
+    catch {
+        return undefined;
+    }
+}
+// ── Metadata / customer params ───────────────────────────────────────────────
+/**
+ * Extract ai.telemetry.metadata.* and map customer/thread params to Respan attrs.
+ * Also handles prompt_unit_price, completion_unit_price, and span_type metadata.
+ */
+function enrichMetadata(attrs, spanName) {
+    for (const [key, value] of Object.entries(attrs)) {
+        if (!key.startsWith("ai.telemetry.metadata."))
+            continue;
+        const cleanKey = key.slice("ai.telemetry.metadata.".length);
+        // Map well-known keys to Respan span attributes
+        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 "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 can be a JSON object with all three fields
+                try {
+                    const parsed = typeof value === "string" ? JSON.parse(value) : value;
+                    if (parsed?.customer_identifier)
+                        setDefault(attrs, CUSTOMER_ID, parsed.customer_identifier);
+                    if (parsed?.customer_email)
+                        setDefault(attrs, CUSTOMER_EMAIL, parsed.customer_email);
+                    if (parsed?.customer_name)
+                        setDefault(attrs, CUSTOMER_NAME, parsed.customer_name);
+                }
+                catch {
+                    // ignore
+                }
+                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":
+                // userId is a fallback for customer_identifier (backward compat with exporter)
+                setDefault(attrs, CUSTOMER_ID, String(value));
+                setDefault(attrs, metadataKey(cleanKey), String(value ?? ""));
+                break;
+            default:
+                // All other metadata → respan.metadata.<key>
+                setDefault(attrs, metadataKey(cleanKey), String(value ?? ""));
+                break;
+        }
+    }
+}
+// ── Token count normalization ────────────────────────────────────────────────
+function enrichTokens(attrs) {
+    // Vercel AI SDK may use gen_ai.usage.input_tokens / gen_ai.usage.output_tokens
+    // Respan backend expects gen_ai.usage.prompt_tokens / gen_ai.usage.completion_tokens
+    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));
+    }
+}
+// ── Performance / cost metrics ───────────────────────────────────────────────
+/**
+ * Enrich performance and cost attributes that the exporter handled explicitly.
+ * These are Vercel-specific attrs that the backend needs in standard locations.
+ */
+function enrichPerformanceMetrics(attrs, spanName) {
+    // Stream detection from span name
+    setDefault(attrs, metadataKey("stream"), String(spanName.includes("doStream")));
+    // Time to first token from ai.response.msToFinish (Vercel-specific)
+    const msToFinish = attrs["ai.response.msToFinish"];
+    if (msToFinish !== undefined) {
+        setDefault(attrs, metadataKey("time_to_first_token"), String(Number(msToFinish) / 1000));
+    }
+    // Cost (gen_ai.usage.cost is standard but ensure it's present)
+    const cost = attrs["gen_ai.usage.cost"];
+    if (cost !== undefined) {
+        setDefault(attrs, metadataKey("cost"), String(cost));
+    }
+    // TTFT (gen_ai.usage.ttft)
+    const ttft = attrs["gen_ai.usage.ttft"];
+    if (ttft !== undefined) {
+        setDefault(attrs, metadataKey("ttft"), String(ttft));
+    }
+    // Generation time
+    const genTime = attrs["gen_ai.usage.generation_time"];
+    if (genTime !== undefined) {
+        setDefault(attrs, metadataKey("generation_time"), String(genTime));
+    }
+    // Warnings
+    const warnings = attrs["gen_ai.usage.warnings"];
+    if (warnings !== undefined) {
+        setDefault(attrs, metadataKey("warnings"), String(warnings));
+    }
+    // Response type (text/json_schema/json_object)
+    const type = attrs["gen_ai.usage.type"];
+    if (type !== undefined) {
+        setDefault(attrs, metadataKey("type"), String(type));
+    }
+}
+// ── Cleanup: strip redundant Vercel attrs after translation ──────────────────
+/**
+ * Vercel AI SDK attributes that have been translated to Traceloop/GenAI/Respan
+ * equivalents. These are deleted after translation to keep spans clean.
+ */
+const VERCEL_ATTRS_TO_STRIP = [
+    // ── Vercel AI SDK attrs (translated to Traceloop/GenAI equivalents) ────
+    // Model (translated to gen_ai.request.model)
+    "ai.model.id",
+    "ai.model.provider",
+    "ai.response.model",
+    // Prompt/completion (translated to traceloop.entity.input/output)
+    "ai.prompt",
+    "ai.prompt.messages",
+    "ai.prompt.format",
+    "ai.response.text",
+    "ai.response.object",
+    // Tokens (translated to gen_ai.usage.prompt_tokens/completion_tokens)
+    "ai.usage.promptTokens",
+    "ai.usage.completionTokens",
+    // Response metadata (redundant with standard OTEL/GenAI attrs)
+    "ai.response.finishReason",
+    "ai.response.id",
+    "ai.response.timestamp",
+    "ai.response.providerMetadata",
+    "ai.response.msToFinish",
+    // SDK internals (no user value)
+    "ai.operationId",
+    "ai.settings.maxRetries",
+    "ai.settings.maxSteps",
+    "ai.sdk",
+    "operation.name",
+    // Tool calls (translated to traceloop.entity.input/output for tool spans)
+    "ai.toolCall.id",
+    "ai.toolCall.name",
+    "ai.toolCall.args",
+    "ai.toolCall.result",
+    "ai.response.toolCalls",
+    // GenAI duplicates (already consumed by backend as top-level fields)
+    "gen_ai.response.finish_reasons",
+    "gen_ai.response.id",
+    "gen_ai.usage.input_tokens",
+    "gen_ai.usage.output_tokens",
+    "gen_ai.system",
+    // ── Traceloop routing attrs (Vercel-specific, not user-facing) ──────────
+    // Keep traceloop.span.kind and respan.entity.log_type — backend needs them.
+    // Keep respan.environment — may be set by user via propagateAttributes().
+    "traceloop.entity.name",
+    "traceloop.entity.path",
+    // ── OTEL resource / process noise (no user value in metadata) ──────────
+    "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.js auto-instrumentation noise ─────────────────────────────────
+    "next.span_name",
+    "next.span_type",
+    "http.url",
+    "http.method",
+    "net.peer.name",
+];
+/**
+ * Remove redundant Vercel AI SDK attributes after translation.
+ * Also strips ai.telemetry.metadata.* keys that have been mapped to respan.* attrs.
+ */
+function stripRedundantAttrs(attrs) {
+    for (const key of VERCEL_ATTRS_TO_STRIP) {
+        delete attrs[key];
+    }
+    // Strip ai.telemetry.metadata.* (already mapped to respan.metadata.* / respan.customer_params.*)
+    for (const key of Object.keys(attrs)) {
+        if (key.startsWith("ai.telemetry.metadata.")) {
+            delete attrs[key];
+        }
+    }
+    // Strip ai.prompt.tools (translated to respan.span.tools)
+    if (attrs["ai.prompt.tools"] !== undefined) {
+        delete attrs["ai.prompt.tools"];
+    }
+}
+// ── Main processor ───────────────────────────────────────────────────────────
+/**
+ * SpanProcessor that translates Vercel AI SDK attributes to Traceloop/OpenLLMetry.
+ *
+ * Phase 1 (onStart): Sets RESPAN_LOG_TYPE so CompositeProcessor lets the span through.
+ * Phase 2 (onEnd):   Full attribute enrichment — model, messages, tokens, metadata,
+ *                     tools, performance metrics, environment, etc.
+ */
+export class VercelAITranslator {
+    onStart(span, _parentContext) {
+        // Cast to access attributes (Span interface doesn't expose them, but the impl does)
+        const s = span;
+        const name = s.name ?? "";
+        if (!name.startsWith("ai."))
+            return;
+        // Set RESPAN_LOG_TYPE early so CompositeProcessor accepts this span
+        const config = VERCEL_SPAN_CONFIG[name];
+        if (config) {
+            s.setAttribute(RESPAN_LOG_TYPE, config.logType);
+        }
+        else if (VERCEL_PARENT_SPANS[name] !== undefined) {
+            s.setAttribute(RESPAN_LOG_TYPE, VERCEL_PARENT_SPANS[name]);
+        }
+        else {
+            // Unknown ai.* span — use full fallback detection
+            // At onStart, attributes may be sparse, so set a generic type.
+            // The precise type will be resolved in onEnd() with full attributes.
+            s.setAttribute(RESPAN_LOG_TYPE, RespanLogType.TASK);
+        }
+    }
+    onEnd(span) {
+        const attrs = span.attributes;
+        if (!attrs)
+            return;
+        if (!isVercelAISpan(span))
+            return;
+        const name = span.name;
+        const config = VERCEL_SPAN_CONFIG[name];
+        const parentLogType = VERCEL_PARENT_SPANS[name];
+        // Resolve the log type using full fallback chain (name → operationId → attributes)
+        const logType = resolveLogType(name, attrs);
+        // ── Always: metadata, customer params, environment ────────────────────
+        enrichMetadata(attrs, name);
+        // ── Parent wrapper spans: minimal enrichment only ─────────────────────
+        if (parentLogType !== undefined && !config) {
+            setDefault(attrs, RESPAN_LOG_TYPE, logType);
+            stripRedundantAttrs(attrs);
+            return;
+        }
+        // ── Detailed / leaf spans: full enrichment ────────────────────────────
+        // Update RESPAN_LOG_TYPE with the resolved type (may be more accurate than onStart)
+        attrs[RESPAN_LOG_TYPE] = logType;
+        if (config) {
+            setDefault(attrs, TL_SPAN_KIND, config.kind);
+            // LLM-specific enrichment
+            if (config.isLLM) {
+                setDefault(attrs, LLM_REQUEST_TYPE, RespanLogType.CHAT);
+                // Model
+                const modelId = attrs["ai.model.id"];
+                if (modelId) {
+                    setDefault(attrs, GEN_AI_REQUEST_MODEL, normalizeModel(String(modelId)));
+                }
+                // Prompt messages → entity input
+                const input = formatPromptInput(attrs);
+                if (input)
+                    setDefault(attrs, TL_ENTITY_INPUT, input);
+                // Completion → entity output
+                const output = formatCompletionOutput(attrs);
+                if (output)
+                    setDefault(attrs, TL_ENTITY_OUTPUT, output);
+                // Token counts
+                enrichTokens(attrs);
+                // Tool definitions
+                const tools = parseTools(attrs);
+                if (tools)
+                    setDefault(attrs, RESPAN_SPAN_TOOLS, tools);
+                // Tool choice
+                const toolChoice = parseToolChoice(attrs);
+                if (toolChoice)
+                    setDefault(attrs, metadataKey("tool_choice"), toolChoice);
+                // Performance metrics (stream, TTFT, cost, etc.)
+                enrichPerformanceMetrics(attrs, name);
+            }
+            // Tool call spans
+            if (config.logType === RespanLogType.TOOL || logType === RespanLogType.TOOL) {
+                const toolInput = formatToolInput(attrs);
+                if (toolInput)
+                    setDefault(attrs, TL_ENTITY_INPUT, toolInput);
+                const toolOutput = formatToolOutput(attrs);
+                if (toolOutput)
+                    setDefault(attrs, TL_ENTITY_OUTPUT, toolOutput);
+            }
+            // Agent spans
+            if (config.logType === RespanLogType.AGENT || logType === RespanLogType.AGENT) {
+                const agentName = attrs["ai.agent.name"] ?? attrs["ai.agent.id"] ?? name;
+                setDefault(attrs, RESPAN_METADATA_AGENT_NAME, String(agentName));
+            }
+        }
+        else {
+            // Unknown ai.* span — enrich with fallback-resolved type
+            // If fallback detected it as an LLM span, add model + tokens
+            if (logType === RespanLogType.TEXT || logType === RespanLogType.EMBEDDING) {
+                const modelId = attrs["ai.model.id"];
+                if (modelId) {
+                    setDefault(attrs, GEN_AI_REQUEST_MODEL, normalizeModel(String(modelId)));
+                }
+                enrichTokens(attrs);
+                if (logType === RespanLogType.TEXT) {
+                    setDefault(attrs, LLM_REQUEST_TYPE, RespanLogType.CHAT);
+                    const input = formatPromptInput(attrs);
+                    if (input)
+                        setDefault(attrs, TL_ENTITY_INPUT, input);
+                    const output = formatCompletionOutput(attrs);
+                    if (output)
+                        setDefault(attrs, TL_ENTITY_OUTPUT, output);
+                    enrichPerformanceMetrics(attrs, name);
+                }
+            }
+            // If fallback detected tool, add tool input/output
+            if (logType === RespanLogType.TOOL) {
+                const toolInput = formatToolInput(attrs);
+                if (toolInput)
+                    setDefault(attrs, TL_ENTITY_INPUT, toolInput);
+                const toolOutput = formatToolOutput(attrs);
+                if (toolOutput)
+                    setDefault(attrs, TL_ENTITY_OUTPUT, toolOutput);
+            }
+        }
+        // ── Cleanup: remove redundant Vercel attrs that have been translated ──
+        stripRedundantAttrs(attrs);
+    }
+    async shutdown() { }
+    async forceFlush() { }
+}
+//# sourceMappingURL=_translator.js.map

package/dist/_translator.js.map

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

package/dist/constants/index.d.ts

@@ -0,0 +1 @@
+export { VERCEL_SPAN_CONFIG, VERCEL_PARENT_SPANS, type VercelSpanConfig, } from "./logs.js";

package/dist/constants/index.js

@@ -0,0 +1,2 @@
+export { VERCEL_SPAN_CONFIG, VERCEL_PARENT_SPANS, } from "./logs.js";
+//# sourceMappingURL=index.js.map

package/dist/constants/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,mBAAmB,GAEpB,MAAM,WAAW,CAAC"}

package/dist/constants/logs.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Mappings from Vercel AI SDK span names to Respan/Traceloop conventions.
+ *
+ * The Vercel AI SDK emits OTEL spans with names like "ai.generateText.doGenerate".
+ * These mappings tell the translator which traceloop.span.kind, respan log type,
+ * and whether to apply full LLM attribute enrichment.
+ */
+export interface VercelSpanConfig {
+    /** Traceloop span kind (workflow, agent, task, tool) */
+    kind: string;
+    /** Respan log type for backend categorization */
+    logType: string;
+    /** Whether this span represents an LLM call (triggers prompt/completion enrichment) */
+    isLLM: boolean;
+}
+export declare const VERCEL_SPAN_CONFIG: Record<string, VercelSpanConfig>;
+export declare const VERCEL_PARENT_SPANS: Record<string, string>;

package/dist/constants/logs.js

@@ -0,0 +1,45 @@
+/**
+ * Mappings from Vercel AI SDK span names to Respan/Traceloop conventions.
+ *
+ * The Vercel AI SDK emits OTEL spans with names like "ai.generateText.doGenerate".
+ * These mappings tell the translator which traceloop.span.kind, respan log type,
+ * and whether to apply full LLM attribute enrichment.
+ */
+import { RespanLogType } from "@respan/respan-sdk";
+// ── Detailed spans (leaf nodes with actual LLM/embedding/tool data) ─────────
+export const VERCEL_SPAN_CONFIG = {
+    // LLM generation (detailed spans carry response data)
+    "ai.generateText.doGenerate": { kind: RespanLogType.TASK, logType: RespanLogType.TEXT, isLLM: true },
+    "ai.streamText.doStream": { kind: RespanLogType.TASK, logType: RespanLogType.TEXT, isLLM: true },
+    "ai.generateObject.doGenerate": { kind: RespanLogType.TASK, logType: RespanLogType.TEXT, isLLM: true },
+    "ai.streamObject.doStream": { kind: RespanLogType.TASK, logType: RespanLogType.TEXT, isLLM: true },
+    // Embeddings
+    "ai.embed.doEmbed": { kind: RespanLogType.TASK, logType: RespanLogType.EMBEDDING, isLLM: false },
+    "ai.embedMany.doEmbed": { kind: RespanLogType.TASK, logType: RespanLogType.EMBEDDING, isLLM: false },
+    // Tool calls
+    "ai.toolCall": { kind: RespanLogType.TOOL, logType: RespanLogType.TOOL, isLLM: false },
+    // Agent / workflow
+    "ai.agent": { kind: RespanLogType.AGENT, logType: RespanLogType.AGENT, isLLM: false },
+    "ai.agent.run": { kind: RespanLogType.AGENT, logType: RespanLogType.AGENT, isLLM: false },
+    "ai.agent.step": { kind: RespanLogType.TASK, logType: RespanLogType.TASK, isLLM: false },
+    "ai.workflow": { kind: RespanLogType.WORKFLOW, logType: RespanLogType.WORKFLOW, isLLM: false },
+    // Function / handoff
+    "ai.function": { kind: RespanLogType.TOOL, logType: RespanLogType.FUNCTION, isLLM: false },
+    "ai.handoff": { kind: RespanLogType.TASK, logType: RespanLogType.HANDOFF, isLLM: false },
+    // Media
+    "ai.transcript": { kind: RespanLogType.TASK, logType: RespanLogType.TRANSCRIPTION, isLLM: false },
+    "ai.speech": { kind: RespanLogType.TASK, logType: RespanLogType.SPEECH, isLLM: false },
+    // Other
+    "ai.response": { kind: RespanLogType.TASK, logType: RespanLogType.RESPONSE, isLLM: false },
+    "ai.stream.firstChunk": { kind: RespanLogType.TASK, logType: RespanLogType.TEXT, isLLM: false },
+};
+// ── Parent wrapper spans (structural only, no LLM data) ─────────────────────
+export const VERCEL_PARENT_SPANS = {
+    "ai.generateText": RespanLogType.TEXT,
+    "ai.streamText": RespanLogType.TEXT,
+    "ai.generateObject": RespanLogType.TEXT,
+    "ai.streamObject": RespanLogType.TEXT,
+    "ai.embed": RespanLogType.EMBEDDING,
+    "ai.embedMany": RespanLogType.EMBEDDING,
+};
+//# sourceMappingURL=logs.js.map

package/dist/constants/logs.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Respan instrumentation plugin for the Vercel AI SDK.
+ *
+ * Registers a {@link VercelAITranslator} SpanProcessor that enriches Vercel AI SDK
+ * OTEL spans with Traceloop/GenAI semantic conventions so they flow through the
+ * unified Respan OTEL pipeline.
+ *
+ * The Vercel AI SDK already emits OTEL spans natively. This instrumentation
+ * translates its attribute schema (ai.model.id, ai.prompt.messages, ai.response.text)
+ * into the Traceloop format the Respan backend expects (gen_ai.request.model,
+ * traceloop.entity.input, traceloop.entity.output, etc.).
+ *
+ * ```typescript
+ * import { Respan } from "@respan/respan";
+ * import { VercelAIInstrumentor } from "@respan/instrumentation-vercel";
+ *
+ * const respan = new Respan({
+ *   instrumentations: [new VercelAIInstrumentor()],
+ * });
+ * await respan.initialize();
+ * ```
+ */
+export { VercelAITranslator } from "./_translator.js";
+export { VERCEL_SPAN_CONFIG, VERCEL_PARENT_SPANS } from "./constants/index.js";
+export declare class VercelAIInstrumentor {
+    readonly name = "vercel-ai";
+    /** Class-level flag: only register the translator once across all instances */
+    private static _translatorRegistered;
+    activate(): void;
+    deactivate(): void;
+}

package/dist/index.js

@@ -0,0 +1,59 @@
+/**
+ * Respan instrumentation plugin for the Vercel AI SDK.
+ *
+ * Registers a {@link VercelAITranslator} SpanProcessor that enriches Vercel AI SDK
+ * OTEL spans with Traceloop/GenAI semantic conventions so they flow through the
+ * unified Respan OTEL pipeline.
+ *
+ * The Vercel AI SDK already emits OTEL spans natively. This instrumentation
+ * translates its attribute schema (ai.model.id, ai.prompt.messages, ai.response.text)
+ * into the Traceloop format the Respan backend expects (gen_ai.request.model,
+ * traceloop.entity.input, traceloop.entity.output, etc.).
+ *
+ * ```typescript
+ * import { Respan } from "@respan/respan";
+ * import { VercelAIInstrumentor } from "@respan/instrumentation-vercel";
+ *
+ * const respan = new Respan({
+ *   instrumentations: [new VercelAIInstrumentor()],
+ * });
+ * await respan.initialize();
+ * ```
+ */
+import { trace } from "@opentelemetry/api";
+import { VercelAITranslator } from "./_translator.js";
+export { VercelAITranslator } from "./_translator.js";
+export { VERCEL_SPAN_CONFIG, VERCEL_PARENT_SPANS } from "./constants/index.js";
+export class VercelAIInstrumentor {
+    name = "vercel-ai";
+    /** Class-level flag: only register the translator once across all instances */
+    static _translatorRegistered = false;
+    activate() {
+        if (VercelAIInstrumentor._translatorRegistered)
+            return;
+        // Walk the TracerProvider chain to find one that supports addSpanProcessor.
+        // trace.getTracerProvider() returns a ProxyTracerProvider; the real
+        // NodeTracerProvider lives at ._delegate (or ._delegate._tracerProvider).
+        const tp = trace.getTracerProvider();
+        const provider = (typeof tp?.addSpanProcessor === "function" && tp) ||
+            (typeof tp?._delegate?.addSpanProcessor === "function" && tp._delegate) ||
+            (typeof tp?._delegate?._tracerProvider?.addSpanProcessor === "function" && tp._delegate._tracerProvider) ||
+            null;
+        if (provider) {
+            // NOTE: The translator is registered AFTER CompositeProcessor (which was
+            // added during startTracing). This means CompositeProcessor.onEnd routes
+            // spans to BatchSpanProcessor before our onEnd enriches them. This works
+            // because BatchSpanProcessor holds span references and exports async —
+            // our enrichment completes before the next batch flush. If SimpleSpanProcessor
+            // is ever used, the translator would need to be registered first.
+            provider.addSpanProcessor(new VercelAITranslator());
+            VercelAIInstrumentor._translatorRegistered = true;
+        }
+    }
+    deactivate() {
+        // Reset static flag so a subsequent initialize() can re-register.
+        // The old translator processor is torn down with the TracerProvider.
+        VercelAIInstrumentor._translatorRegistered = false;
+    }
+}
+//# 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;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE/E,MAAM,OAAO,oBAAoB;IACf,IAAI,GAAG,WAAW,CAAC;IAEnC,+EAA+E;IACvE,MAAM,CAAC,qBAAqB,GAAG,KAAK,CAAC;IAE7C,QAAQ;QACN,IAAI,oBAAoB,CAAC,qBAAqB;YAAE,OAAO;QAEvD,4EAA4E;QAC5E,oEAAoE;QACpE,0EAA0E;QAC1E,MAAM,EAAE,GAAG,KAAK,CAAC,iBAAiB,EAAS,CAAC;QAC5C,MAAM,QAAQ,GACZ,CAAC,OAAO,EAAE,EAAE,gBAAgB,KAAK,UAAU,IAAI,EAAE,CAAC;YAClD,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,gBAAgB,KAAK,UAAU,IAAI,EAAE,CAAC,SAAS,CAAC;YACvE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,eAAe,EAAE,gBAAgB,KAAK,UAAU,IAAI,EAAE,CAAC,SAAS,CAAC,eAAe,CAAC;YACxG,IAAI,CAAC;QAEP,IAAI,QAAQ,EAAE,CAAC;YACb,yEAAyE;YACzE,yEAAyE;YACzE,yEAAyE;YACzE,uEAAuE;YACvE,+EAA+E;YAC/E,kEAAkE;YAClE,QAAQ,CAAC,gBAAgB,CAAC,IAAI,kBAAkB,EAAE,CAAC,CAAC;YACpD,oBAAoB,CAAC,qBAAqB,GAAG,IAAI,CAAC;QACpD,CAAC;IACH,CAAC;IAED,UAAU;QACR,kEAAkE;QAClE,qEAAqE;QACrE,oBAAoB,CAAC,qBAAqB,GAAG,KAAK,CAAC;IACrD,CAAC"}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@respan/instrumentation-vercel",
+  "type": "module",
+  "version": "1.0.0",
+  "description": "Respan instrumentation plugin for Vercel AI SDK",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "author": "Respan <team@respan.ai>",
+  "license": "Apache-2.0",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "publish": "yarn npm publish",
+    "release": "yarn build && yarn version patch && yarn publish"
+  },
+  "packageManager": "yarn@4.6.0",
+  "dependencies": {
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/sdk-trace-base": "^1.29.0",
+    "@respan/respan-sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.29",
+    "typescript": "^5.7.3"
+  }
+}