@mistralai/mistralai 2.2.5 → 2.2.6

package/esm/extra/observability/otel.js

@@ -0,0 +1,578 @@
+/**
+ * OTEL conventions for gen AI may be found at:
+ *
+ * https://opentelemetry.io/docs/specs/semconv/gen-ai/gen-ai-spans/
+ * https://opentelemetry.io/docs/specs/semconv/gen-ai/gen-ai-agent-spans/
+ */
+import { context as contextApi, propagation, trace, SpanStatusCode, } from "@opentelemetry/api";
+import * as semConvAttributes from "@opentelemetry/semantic-conventions/incubating";
+import { formatInputMessage, formatOutputMessage, formatToolDefinition, } from "./formatting.js";
+import { accumulateChunksToResponseDict, parseSseChunks } from "./streaming.js";
+export { semConvAttributes };
+export const OTEL_SERVICE_NAME = "mistralai_sdk";
+export const MISTRAL_SDK_OTEL_TRACER_NAME = `${OTEL_SERVICE_NAME}_tracer`;
+const MISTRAL_AGENT_TRACE_PUBLIC_ATTRIBUTE = "agent.trace.public";
+let registeredTracerProvider;
+/**
+ * Route SDK tracing spans to a specific OpenTelemetry tracer provider.
+ */
+export function registerTracerProvider(tracerProvider) {
+    registeredTracerProvider = tracerProvider;
+}
+// Safe check for environment variable in both Node.js and browser
+const getDebugTracing = () => {
+    try {
+        if (typeof globalThis !== "undefined" && "process" in globalThis) {
+            const proc = globalThis.process;
+            return proc?.env?.["MISTRAL_SDK_DEBUG_TRACING"]?.toLowerCase() === "true";
+        }
+    }
+    catch {
+        // Ignore
+    }
+    return false;
+};
+const MISTRAL_SDK_DEBUG_TRACING = getDebugTracing();
+const DEBUG_HINT = "To see detailed tracing logs, set MISTRAL_SDK_DEBUG_TRACING=true.";
+export const MistralAIAttributes = {
+    MISTRAL_AI_OCR_USAGE_PAGES_PROCESSED: "mistral_ai.ocr.usage.pages_processed",
+    MISTRAL_AI_OCR_USAGE_DOC_SIZE_BYTES: "mistral_ai.ocr.usage.doc_size_bytes",
+    MISTRAL_AI_ERROR_CODE: "mistral_ai.error.code",
+};
+export const TracingErrors = {
+    FAILED_TO_CREATE_SPAN_FOR_REQUEST: "Failed to create span for request.",
+    FAILED_TO_ENRICH_SPAN_WITH_RESPONSE: "Failed to enrich span with response.",
+    FAILED_TO_HANDLE_ERROR_IN_SPAN: "Failed to handle error in span.",
+    FAILED_TO_END_SPAN: "Failed to end span.",
+};
+function parseTimeToMillis(ts) {
+    return new Date(ts).getTime();
+}
+function inferGenAiOperationName(operationId) {
+    if (operationId.includes("chat_completion") || operationId === "stream_chat") {
+        return semConvAttributes.GEN_AI_OPERATION_NAME_VALUE_CHAT;
+    }
+    if ((operationId.includes("agents_create") || operationId.includes("agents_update")) &&
+        !operationId.includes("alias")) {
+        return semConvAttributes.GEN_AI_OPERATION_NAME_VALUE_CREATE_AGENT;
+    }
+    if (operationId.includes("agents_completion") || operationId === "stream_agents") {
+        return semConvAttributes.GEN_AI_OPERATION_NAME_VALUE_INVOKE_AGENT;
+    }
+    if (operationId.includes("conversations") &&
+        (operationId.includes("start") ||
+            operationId.includes("append") ||
+            operationId.includes("restart"))) {
+        return semConvAttributes.GEN_AI_OPERATION_NAME_VALUE_INVOKE_AGENT;
+    }
+    if (operationId.includes("fim")) {
+        return semConvAttributes.GEN_AI_OPERATION_NAME_VALUE_TEXT_COMPLETION;
+    }
+    if (operationId.includes("embeddings")) {
+        return semConvAttributes.GEN_AI_OPERATION_NAME_VALUE_EMBEDDINGS;
+    }
+    if (operationId.includes("ocr_post")) {
+        return semConvAttributes.GEN_AI_OPERATION_NAME_VALUE_GENERATE_CONTENT;
+    }
+    return null;
+}
+function isKnownGenAiOperation(operationId) {
+    return inferGenAiOperationName(operationId) !== null;
+}
+function isJsonContentType(contentType) {
+    const mediaType = contentType?.split(";")[0]?.trim().toLowerCase();
+    return mediaType === "application/json" ||
+        mediaType === "text/json" ||
+        mediaType?.endsWith("+json") === true;
+}
+function buildGenaiSpanName(genAiOp, body) {
+    if (genAiOp === semConvAttributes.GEN_AI_OPERATION_NAME_VALUE_CREATE_AGENT ||
+        genAiOp === semConvAttributes.GEN_AI_OPERATION_NAME_VALUE_INVOKE_AGENT) {
+        const agentName = body["name"];
+        return agentName ? `${genAiOp} ${agentName}` : genAiOp;
+    }
+    if (genAiOp === semConvAttributes.GEN_AI_OPERATION_NAME_VALUE_EXECUTE_TOOL) {
+        const toolName = body["name"];
+        return toolName ? `${genAiOp} ${toolName}` : genAiOp;
+    }
+    const model = body["model"];
+    return model ? `${genAiOp} ${model}` : genAiOp;
+}
+function setAvailableAttributes(span, attributes) {
+    for (const [key, value] of Object.entries(attributes)) {
+        if (value != null && value !== "") {
+            span.setAttribute(key, value);
+        }
+    }
+}
+function setMistralAgentTraceMarker(span) {
+    // Mistral-internal marker consumed by downstream trace processors.
+    span.setAttribute(MISTRAL_AGENT_TRACE_PUBLIC_ATTRIBUTE, "");
+}
+function setHttpAttributes(span, url, method, host) {
+    let port = url.port ? parseInt(url.port, 10) : -1;
+    if (port === -1) {
+        if (url.protocol === "https:") {
+            port = 443;
+        }
+        else if (url.protocol === "http:") {
+            port = 80;
+        }
+    }
+    span.setAttributes({
+        [semConvAttributes.ATTR_HTTP_REQUEST_METHOD]: method,
+        [semConvAttributes.ATTR_URL_FULL]: url.toString(),
+        [semConvAttributes.ATTR_SERVER_ADDRESS]: host,
+        [semConvAttributes.ATTR_SERVER_PORT]: port,
+    });
+}
+function enrichRequestGenaiAttrs(span, genAiOp, requestBody) {
+    span.updateName(buildGenaiSpanName(genAiOp, requestBody));
+    const attributes = {
+        [semConvAttributes.ATTR_GEN_AI_REQUEST_CHOICE_COUNT]: requestBody["n"],
+        [semConvAttributes.ATTR_GEN_AI_REQUEST_ENCODING_FORMATS]: requestBody["encoding_formats"],
+        [semConvAttributes.ATTR_GEN_AI_REQUEST_FREQUENCY_PENALTY]: requestBody["frequency_penalty"],
+        [semConvAttributes.ATTR_GEN_AI_REQUEST_MAX_TOKENS]: requestBody["max_tokens"],
+        [semConvAttributes.ATTR_GEN_AI_REQUEST_MODEL]: requestBody["model"],
+        [semConvAttributes.ATTR_GEN_AI_REQUEST_PRESENCE_PENALTY]: requestBody["presence_penalty"],
+        [semConvAttributes.ATTR_GEN_AI_REQUEST_SEED]: requestBody["random_seed"],
+        [semConvAttributes.ATTR_GEN_AI_REQUEST_STOP_SEQUENCES]: requestBody["stop"],
+        [semConvAttributes.ATTR_GEN_AI_REQUEST_TEMPERATURE]: requestBody["temperature"],
+        [semConvAttributes.ATTR_GEN_AI_REQUEST_TOP_P]: requestBody["top_p"],
+        [semConvAttributes.ATTR_GEN_AI_REQUEST_TOP_K]: requestBody["top_k"],
+    };
+    const inputMessages = (requestBody["messages"] || requestBody["inputs"]);
+    if (typeof inputMessages === "string") {
+        attributes[semConvAttributes.ATTR_GEN_AI_INPUT_MESSAGES] = JSON.stringify([
+            formatInputMessage({ role: "user", content: inputMessages }),
+        ]);
+    }
+    else if (Array.isArray(inputMessages)) {
+        attributes[semConvAttributes.ATTR_GEN_AI_INPUT_MESSAGES] = JSON.stringify(inputMessages.map((msg) => formatInputMessage(msg)));
+    }
+    const tools = requestBody["tools"];
+    if (tools) {
+        const formattedTools = tools
+            .map((tool) => formatToolDefinition(tool))
+            .filter((t) => t !== null);
+        if (formattedTools.length > 0) {
+            attributes[semConvAttributes.ATTR_GEN_AI_TOOL_DEFINITIONS] = JSON.stringify(formattedTools);
+        }
+    }
+    // TODO: For agent start conversation, add agent id and version attributes here ?
+    setAvailableAttributes(span, attributes);
+}
+export function enrichSpanFromRequest(span, operationId, url, method, host, body) {
+    setHttpAttributes(span, url, method, host);
+    const genAiOp = inferGenAiOperationName(operationId);
+    if (genAiOp === null) {
+        return span;
+    }
+    span.setAttributes({
+        [semConvAttributes.ATTR_GEN_AI_OPERATION_NAME]: genAiOp,
+        [semConvAttributes.ATTR_GEN_AI_PROVIDER_NAME]: semConvAttributes.GEN_AI_PROVIDER_NAME_VALUE_MISTRAL_AI,
+    });
+    if (body) {
+        try {
+            const requestBody = JSON.parse(body);
+            enrichRequestGenaiAttrs(span, genAiOp, requestBody);
+        }
+        catch {
+            // Ignore parse errors
+        }
+    }
+    return span;
+}
+function enrichResponseGenaiAttrs(span, genAiOp, responseData) {
+    const attributes = {};
+    if (genAiOp !== semConvAttributes.GEN_AI_OPERATION_NAME_VALUE_CREATE_AGENT) {
+        attributes[semConvAttributes.ATTR_GEN_AI_RESPONSE_ID] = responseData["id"];
+    }
+    attributes[semConvAttributes.ATTR_GEN_AI_RESPONSE_MODEL] = responseData["model"];
+    const choices = (responseData["choices"] || []);
+    const finishReasons = choices
+        .map((c) => c["finish_reason"])
+        .filter((r) => !!r);
+    if (finishReasons.length > 0) {
+        attributes[semConvAttributes.ATTR_GEN_AI_RESPONSE_FINISH_REASONS] = finishReasons;
+    }
+    if (choices.length > 0) {
+        attributes[semConvAttributes.ATTR_GEN_AI_OUTPUT_MESSAGES] = JSON.stringify(choices.map((choice) => formatOutputMessage(choice)));
+    }
+    const usage = responseData["usage"];
+    if (usage) {
+        attributes[semConvAttributes.ATTR_GEN_AI_USAGE_INPUT_TOKENS] = usage["prompt_tokens"] || 0;
+        attributes[semConvAttributes.ATTR_GEN_AI_USAGE_OUTPUT_TOKENS] = usage["completion_tokens"] || 0;
+    }
+    setAvailableAttributes(span, attributes);
+}
+function enrichCreateAgent(span, responseData) {
+    const agentAttributes = {
+        [semConvAttributes.ATTR_GEN_AI_AGENT_DESCRIPTION]: responseData["description"],
+        [semConvAttributes.ATTR_GEN_AI_AGENT_ID]: responseData["id"],
+        [semConvAttributes.ATTR_GEN_AI_AGENT_NAME]: responseData["name"],
+        "gen_ai.agent.version": String(responseData["version"]),
+        [semConvAttributes.ATTR_GEN_AI_REQUEST_MODEL]: responseData["model"],
+        [semConvAttributes.ATTR_GEN_AI_SYSTEM_INSTRUCTIONS]: responseData["instructions"],
+    };
+    setAvailableAttributes(span, agentAttributes);
+}
+function stringifyToolAttribute(value) {
+    if (typeof value === "string") {
+        return value;
+    }
+    if (value) {
+        return JSON.stringify(value);
+    }
+    return null;
+}
+function createToolExecutionChildSpan(tracer, parentContext, output) {
+    const startMs = parseTimeToMillis(output["created_at"]);
+    const endMs = parseTimeToMillis(output["completed_at"]);
+    const opName = semConvAttributes.GEN_AI_OPERATION_NAME_VALUE_EXECUTE_TOOL;
+    const spanName = buildGenaiSpanName(opName, output);
+    const childSpan = tracer.startSpan(spanName, { startTime: startMs }, parentContext);
+    setMistralAgentTraceMarker(childSpan);
+    const toolArguments = output["arguments"];
+    const toolResult = output["info"];
+    const toolAttributes = {
+        [semConvAttributes.ATTR_GEN_AI_OPERATION_NAME]: opName,
+        [semConvAttributes.ATTR_GEN_AI_PROVIDER_NAME]: semConvAttributes.GEN_AI_PROVIDER_NAME_VALUE_MISTRAL_AI,
+        [semConvAttributes.ATTR_GEN_AI_TOOL_CALL_ID]: output["id"],
+        [semConvAttributes.ATTR_GEN_AI_TOOL_CALL_ARGUMENTS]: stringifyToolAttribute(toolArguments),
+        [semConvAttributes.ATTR_GEN_AI_TOOL_CALL_RESULT]: stringifyToolAttribute(toolResult),
+        [semConvAttributes.ATTR_GEN_AI_TOOL_NAME]: output["name"],
+        [semConvAttributes.ATTR_GEN_AI_TOOL_TYPE]: "extension",
+    };
+    setAvailableAttributes(childSpan, toolAttributes);
+    childSpan.end(endMs);
+}
+function createMessageOutputChildSpan(tracer, parentContext, output) {
+    const startMs = parseTimeToMillis(output["created_at"]);
+    const endMs = parseTimeToMillis(output["completed_at"]);
+    const opName = semConvAttributes.GEN_AI_OPERATION_NAME_VALUE_CHAT;
+    const spanName = buildGenaiSpanName(opName, output);
+    const childSpan = tracer.startSpan(spanName, { startTime: startMs }, parentContext);
+    setMistralAgentTraceMarker(childSpan);
+    const choiceWrapper = {
+        message: output,
+        finish_reason: output["finish_reason"] || "",
+    };
+    const messageAttributes = {
+        [semConvAttributes.ATTR_GEN_AI_OPERATION_NAME]: opName,
+        [semConvAttributes.ATTR_GEN_AI_PROVIDER_NAME]: semConvAttributes.GEN_AI_PROVIDER_NAME_VALUE_MISTRAL_AI,
+        [semConvAttributes.ATTR_GEN_AI_RESPONSE_ID]: output["id"],
+        [semConvAttributes.ATTR_GEN_AI_AGENT_ID]: output["agent_id"],
+        [semConvAttributes.ATTR_GEN_AI_RESPONSE_MODEL]: output["model"],
+        [semConvAttributes.ATTR_GEN_AI_OUTPUT_MESSAGES]: JSON.stringify([formatOutputMessage(choiceWrapper)]),
+    };
+    setAvailableAttributes(childSpan, messageAttributes);
+    childSpan.end(endMs);
+}
+function enrichInvokeAgent(tracer, span, responseData) {
+    const conversationAttributes = {
+        [semConvAttributes.ATTR_GEN_AI_CONVERSATION_ID]: responseData["conversation_id"],
+    };
+    setAvailableAttributes(span, conversationAttributes);
+    const outputs = (responseData["outputs"] || []);
+    const parentContext = trace.setSpan(contextApi.active(), span);
+    for (const output of outputs) {
+        const outputType = output["type"];
+        if (!outputType)
+            continue;
+        if (outputType === "function.call") {
+            continue;
+        }
+        if (outputType === "tool.execution") {
+            createToolExecutionChildSpan(tracer, parentContext, output);
+        }
+        else if (outputType === "message.output") {
+            createMessageOutputChildSpan(tracer, parentContext, output);
+        }
+    }
+}
+function enrichOcr(span, responseData) {
+    const usageInfo = responseData["usage_info"];
+    if (!usageInfo)
+        return;
+    const ocrAttributes = {
+        [MistralAIAttributes.MISTRAL_AI_OCR_USAGE_PAGES_PROCESSED]: usageInfo["pages_processed"],
+        [MistralAIAttributes.MISTRAL_AI_OCR_USAGE_DOC_SIZE_BYTES]: usageInfo["doc_size_bytes"],
+    };
+    setAvailableAttributes(span, ocrAttributes);
+}
+export function enrichSpanFromResponse(tracer, span, operationId, responseData) {
+    const genAiOp = inferGenAiOperationName(operationId);
+    if (genAiOp === null) {
+        return;
+    }
+    enrichResponseGenaiAttrs(span, genAiOp, responseData);
+    if (genAiOp === semConvAttributes.GEN_AI_OPERATION_NAME_VALUE_CREATE_AGENT) {
+        enrichCreateAgent(span, responseData);
+    }
+    else if (genAiOp === semConvAttributes.GEN_AI_OPERATION_NAME_VALUE_INVOKE_AGENT) {
+        enrichInvokeAgent(tracer, span, responseData);
+    }
+    if (operationId === "ocr_v1_ocr_post") {
+        enrichOcr(span, responseData);
+    }
+}
+/**
+ * Get a tracer from the registered or global TracerProvider.
+ *
+ * The SDK does not set up its own TracerProvider. It relies on the application
+ * to register one explicitly or configure OpenTelemetry's global provider.
+ *
+ * If no TracerProvider is configured, the ProxyTracerProvider (default) will
+ * return a NoOp tracer, effectively disabling tracing. Once the application
+ * sets up a real TracerProvider, subsequent spans will be recorded.
+ */
+export function getOrCreateOtelTracer() {
+    const tracerProvider = registeredTracerProvider ?? trace.getTracerProvider();
+    return tracerProvider.getTracer(MISTRAL_SDK_OTEL_TRACER_NAME);
+}
+export function getSpanContext(span) {
+    return trace.setSpan(contextApi.active(), span);
+}
+export function runWithContext(context, fn) {
+    return contextApi.with(context, fn);
+}
+export async function recordRequestError(context, error) {
+    const span = trace.getSpan(context);
+    if (span) {
+        await getResponseAndError(span, null, error);
+    }
+}
+function warn(error, details) {
+    if (MISTRAL_SDK_DEBUG_TRACING) {
+        console.warn(error, details);
+    }
+    else {
+        console.warn(error, DEBUG_HINT);
+    }
+}
+export async function getTracedRequestAndSpan(tracer, operationId, request) {
+    const span = tracer.startSpan(operationId);
+    if (!span.isRecording()) {
+        return { request, span, body: null };
+    }
+    try {
+        setMistralAgentTraceMarker(span);
+        // Propagate gen_ai.conversation.id from OTEL baggage if present
+        const baggage = propagation.getBaggage(contextApi.active());
+        const conversationId = baggage?.getEntry(semConvAttributes.ATTR_GEN_AI_CONVERSATION_ID)?.value;
+        if (conversationId) {
+            span.setAttribute(semConvAttributes.ATTR_GEN_AI_CONVERSATION_ID, conversationId);
+        }
+        let body = null;
+        if (request.body &&
+            isKnownGenAiOperation(operationId) &&
+            isJsonContentType(request.headers.get("content-type"))) {
+            try {
+                const cloned = request.clone();
+                body = await cloned.text();
+            }
+            catch {
+                // Ignore - body might not be cloneable
+            }
+        }
+        const headers = new Headers(request.headers);
+        const headerCarrier = {};
+        propagation.inject(trace.setSpan(contextApi.active(), span), headerCarrier);
+        for (const [key, value] of Object.entries(headerCarrier)) {
+            headers.set(key, value);
+        }
+        const newRequest = new Request(request, { headers });
+        const url = new URL(request.url);
+        enrichSpanFromRequest(span, operationId, url, request.method, headers.get("host") || url.host, body);
+        return { request: newRequest, span, body };
+    }
+    catch (err) {
+        warn(TracingErrors.FAILED_TO_CREATE_SPAN_FOR_REQUEST, err);
+        try {
+            span.end();
+        }
+        catch {
+            // Ignore
+        }
+        return { request, span, body: null };
+    }
+}
+export async function getTracedResponse(tracer, span, operationId, response) {
+    if (!span.isRecording()) {
+        return response;
+    }
+    try {
+        span.setStatus({ code: SpanStatusCode.OK });
+        span.setAttribute(semConvAttributes.ATTR_HTTP_RESPONSE_STATUS_CODE, response.status);
+        const knownGenAiOperation = isKnownGenAiOperation(operationId);
+        const responseContentType = response.headers.get("content-type");
+        const isStreamResponse = knownGenAiOperation &&
+            !response.bodyUsed &&
+            responseContentType?.toLowerCase().includes("text/event-stream") === true;
+        if (isStreamResponse && response.body) {
+            return createTracedStreamResponse(response, span, tracer, operationId);
+        }
+        if (knownGenAiOperation &&
+            !response.bodyUsed &&
+            isJsonContentType(responseContentType)) {
+            const clonedResponse = response.clone();
+            try {
+                const responseData = await clonedResponse.json();
+                enrichSpanFromResponse(tracer, span, operationId, responseData);
+            }
+            catch {
+                // Ignore parse errors
+            }
+        }
+        endSpan(span);
+        return response;
+    }
+    catch (err) {
+        warn(TracingErrors.FAILED_TO_ENRICH_SPAN_WITH_RESPONSE, err);
+        endSpan(span);
+        return response;
+    }
+}
+function createTracedStreamResponse(response, span, tracer, operationId) {
+    const originalBody = response.body;
+    const chunks = [];
+    const decoder = new TextDecoder();
+    const reader = originalBody.getReader();
+    let finalized = false;
+    const finalize = () => {
+        if (finalized) {
+            return;
+        }
+        const remaining = decoder.decode();
+        if (remaining) {
+            chunks.push(remaining);
+        }
+        finalized = true;
+        finalizeStreamSpan(chunks, span, tracer, operationId);
+    };
+    const tracedStream = new ReadableStream({
+        async pull(controller) {
+            try {
+                const { done, value } = await reader.read();
+                if (done) {
+                    finalize();
+                    controller.close();
+                    return;
+                }
+                chunks.push(decoder.decode(value, { stream: true }));
+                controller.enqueue(value);
+            }
+            catch (err) {
+                finalize();
+                controller.error(err);
+                try {
+                    await reader.cancel(err);
+                }
+                catch {
+                    // Ignore cancellation errors from already-failed streams.
+                }
+            }
+        },
+        async cancel(reason) {
+            finalize();
+            await reader.cancel(reason);
+        },
+    }, { highWaterMark: 0 });
+    return new Response(tracedStream, {
+        status: response.status,
+        statusText: response.statusText,
+        headers: response.headers,
+    });
+}
+function finalizeStreamSpan(chunks, span, tracer, operationId) {
+    try {
+        const fullText = chunks.join("");
+        const parsedChunks = parseSseChunks(fullText);
+        if (parsedChunks.length > 0) {
+            const responseData = accumulateChunksToResponseDict(parsedChunks);
+            enrichSpanFromResponse(tracer, span, operationId, responseData);
+        }
+    }
+    catch (err) {
+        warn("Failed to enrich span with streaming response.", err);
+    }
+    endSpan(span);
+}
+export async function getResponseAndError(span, response, error) {
+    if (!span.isRecording()) {
+        return { response, error };
+    }
+    try {
+        if (error) {
+            span.recordException(error);
+            span.setStatus({ code: SpanStatusCode.ERROR, message: String(error) });
+        }
+        if (!response) {
+            endSpan(span);
+            return { response, error };
+        }
+        try {
+            const responseBody = await response.clone().json();
+            const body = responseBody;
+            if (body["object"] === "error") {
+                const errorMsg = body["message"] || "";
+                const errorType = body["type"] || "";
+                if (errorMsg) {
+                    span.setStatus({ code: SpanStatusCode.ERROR, message: errorMsg });
+                    span.addEvent("exception", {
+                        "exception.type": errorType || "api_error",
+                        "exception.message": errorMsg,
+                    });
+                    const attrs = {
+                        [semConvAttributes.ATTR_HTTP_RESPONSE_STATUS_CODE]: response.status,
+                    };
+                    if (errorType) {
+                        attrs[semConvAttributes.ATTR_ERROR_TYPE] = errorType;
+                    }
+                    if (body["code"]) {
+                        attrs[MistralAIAttributes.MISTRAL_AI_ERROR_CODE] = body["code"];
+                    }
+                    setAvailableAttributes(span, attrs);
+                }
+            }
+        }
+        catch {
+            // Non-JSON error bodies are valid API responses; leave the span as-is.
+        }
+        endSpan(span);
+    }
+    catch (err) {
+        warn(TracingErrors.FAILED_TO_HANDLE_ERROR_IN_SPAN, err);
+        try {
+            span.end();
+        }
+        catch {
+            // Ignore
+        }
+    }
+    return { response, error };
+}
+function endSpan(span) {
+    try {
+        span.end();
+    }
+    catch (err) {
+        warn(TracingErrors.FAILED_TO_END_SPAN, err);
+    }
+}
+/**
+ * Create a traced span using a callback pattern.
+ * This is the TypeScript equivalent of Python's context manager.
+ */
+export async function traceAsync(name, fn) {
+    const tracer = getOrCreateOtelTracer();
+    const span = tracer.startSpan(name);
+    try {
+        return await fn(span);
+    }
+    finally {
+        span.end();
+    }
+}
+//# sourceMappingURL=otel.js.map

package/esm/extra/observability/otel.js.map

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

package/esm/extra/observability/streaming.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Streaming response helpers for OTEL tracing.
+ *
+ * Pure functions that parse SSE byte streams and accumulate CompletionChunk
+ * deltas into a ChatCompletionResponse-shaped dict suitable for span enrichment.
+ *
+ * NOTE: The SSE bytes are re-parsed here even though EventStream already
+ * parsed them during iteration.
+ * TracedResponse sits below EventStream and can only accumulate raw bytes; it
+ * has no access to the decoded events. Hooking into EventStream could eliminate
+ * this double-parse, but EventStream is Speakeasy-generated code.
+ */
+import { CompletionChunk } from "../../models/components/completionchunk.js";
+/**
+ * Parse raw SSE text into a list of typed CompletionChunk models.
+ *
+ * Only CompletionChunk is handled. If new SSE-streamed response types
+ * are added, parsing and typing here will need updating.
+ */
+export declare function parseSseChunks(rawSseText: string): CompletionChunk[];
+/**
+ * Accumulate streaming CompletionChunk deltas into a ChatCompletionResponse-shaped dict.
+ */
+export declare function accumulateChunksToResponseDict(chunks: CompletionChunk[]): Record<string, unknown>;
+//# sourceMappingURL=streaming.d.ts.map

package/esm/extra/observability/streaming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../../../src/extra/observability/streaming.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,eAAe,EAEhB,MAAM,4CAA4C,CAAC;AAmDpD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,EAAE,CAsBpE;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,eAAe,EAAE,GACxB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAuEzB"}