@mistralai/mistralai 2.2.5 → 2.2.6

package/README.md

@@ -401,6 +401,31 @@ We have dedicated SDKs for the following providers:
 * [update](docs/sdks/judges/README.md#update) - Update a judge
 * [judgeConversation](docs/sdks/judges/README.md#judgeconversation) - Run a saved judge on a conversation
 
+### [Beta.Observability.Logs](docs/sdks/logs/README.md)
+
+* [search](docs/sdks/logs/README.md#search) - Search logs
+* [list](docs/sdks/logs/README.md#list) - Get log field definitions
+* [fetchOptions](docs/sdks/logs/README.md#fetchoptions) - Get options for a log field
+
+### [Beta.Observability.Spans](docs/sdks/spans/README.md)
+
+* [searchSpans](docs/sdks/spans/README.md#searchspans) - Search spans
+* [searchSpanEvaluations](docs/sdks/spans/README.md#searchspanevaluations) - Search span evaluations
+* [searchLatestSpanEvaluations](docs/sdks/spans/README.md#searchlatestspanevaluations) - Search latest span evaluations
+* [listSpanFields](docs/sdks/spans/README.md#listspanfields) - Get span field definitions
+* [listSpanEvalFields](docs/sdks/spans/README.md#listspanevalfields) - Get span evaluation field definitions
+* [fetchSpanFieldOptions](docs/sdks/spans/README.md#fetchspanfieldoptions) - Get options for a span field
+* [fetchSpanEvalFieldOptions](docs/sdks/spans/README.md#fetchspanevalfieldoptions) - Get options for a span evaluation field
+
+### [Beta.Observability.Traces](docs/sdks/traces/README.md)
+
+* [search](docs/sdks/traces/README.md#search) - Search traces
+* [getTraceFields](docs/sdks/traces/README.md#gettracefields) - Get trace field definitions
+* [getTraceById](docs/sdks/traces/README.md#gettracebyid) - Get trace by id
+* [getTraceSpans](docs/sdks/traces/README.md#gettracespans) - Get trace spans
+* [fetchOptions](docs/sdks/traces/README.md#fetchoptions) - Get options for a trace field
+* [getSpanById](docs/sdks/traces/README.md#getspanbyid) - Get span by id
+
 ### [Beta.Rag.IngestionPipelineConfigurations](docs/sdks/ingestionpipelineconfigurations/README.md)
 
 * [list](docs/sdks/ingestionpipelineconfigurations/README.md#list) - List ingestion pipeline configurations
@@ -508,6 +533,8 @@ We have dedicated SDKs for the following providers:
 * [getWorkflowExecutionTraceSummary](docs/sdks/executions/README.md#getworkflowexecutiontracesummary) - Get Workflow Execution Trace Summary
 * [getWorkflowExecutionTraceEvents](docs/sdks/executions/README.md#getworkflowexecutiontraceevents) - Get Workflow Execution Trace Events
 * [stream](docs/sdks/executions/README.md#stream) - Stream
+* [getWorkflowExecutionLogs](docs/sdks/executions/README.md#getworkflowexecutionlogs) - Get Workflow Execution Logs
+* [streamWorkflowExecutionLogs](docs/sdks/executions/README.md#streamworkflowexecutionlogs) - Stream Workflow Execution Logs
 
 #### [Workflows.Metrics](docs/sdks/metrics/README.md)
 
@@ -528,6 +555,7 @@ We have dedicated SDKs for the following providers:
 * [updateSchedule](docs/sdks/schedules/README.md#updateschedule) - Update Schedule
 * [pauseSchedule](docs/sdks/schedules/README.md#pauseschedule) - Pause Schedule
 * [resumeSchedule](docs/sdks/schedules/README.md#resumeschedule) - Resume Schedule
+* [triggerSchedule](docs/sdks/schedules/README.md#triggerschedule) - Trigger Schedule
 
 </details>
 <!-- End Available Resources and Operations [operations] -->
@@ -764,8 +792,8 @@ run();
 
 
 **Inherit from [`MistralError`](./src/models/errors/mistralerror.ts)**:
-* [`HTTPValidationError`](./src/models/errors/httpvalidationerror.ts): Validation Error. Status code `422`. Applicable to 130 of 197 methods.*
-* [`ObservabilityError`](./src/models/errors/observabilityerror.ts): Bad Request - Invalid request parameters or data. Applicable to 41 of 197 methods.*
+* [`HTTPValidationError`](./src/models/errors/httpvalidationerror.ts): Validation Error. Status code `422`. Applicable to 133 of 216 methods.*
+* [`ObservabilityError`](./src/models/errors/observabilityerror.ts): Bad Request - Invalid request parameters or data. Applicable to 57 of 216 methods.*
 * [`ResponseValidationError`](./src/models/errors/responsevalidationerror.ts): Type mismatch between the data returned from the server and the structure expected by the SDK. See `error.rawValue` for the raw value and `error.pretty()` for a nicely formatted multi-line string.
 
 </details>
@@ -1052,6 +1080,22 @@ To read more about standalone functions, check [FUNCTIONS.md](./FUNCTIONS.md).
 - [`betaObservabilityJudgesJudgeConversation`](docs/sdks/judges/README.md#judgeconversation) - Run a saved judge on a conversation
 - [`betaObservabilityJudgesList`](docs/sdks/judges/README.md#list) - Get judges with optional filtering and search
 - [`betaObservabilityJudgesUpdate`](docs/sdks/judges/README.md#update) - Update a judge
+- [`betaObservabilityLogsFetchOptions`](docs/sdks/logs/README.md#fetchoptions) - Get options for a log field
+- [`betaObservabilityLogsList`](docs/sdks/logs/README.md#list) - Get log field definitions
+- [`betaObservabilityLogsSearch`](docs/sdks/logs/README.md#search) - Search logs
+- [`betaObservabilitySpansFetchSpanEvalFieldOptions`](docs/sdks/spans/README.md#fetchspanevalfieldoptions) - Get options for a span evaluation field
+- [`betaObservabilitySpansFetchSpanFieldOptions`](docs/sdks/spans/README.md#fetchspanfieldoptions) - Get options for a span field
+- [`betaObservabilitySpansListSpanEvalFields`](docs/sdks/spans/README.md#listspanevalfields) - Get span evaluation field definitions
+- [`betaObservabilitySpansListSpanFields`](docs/sdks/spans/README.md#listspanfields) - Get span field definitions
+- [`betaObservabilitySpansSearchLatestSpanEvaluations`](docs/sdks/spans/README.md#searchlatestspanevaluations) - Search latest span evaluations
+- [`betaObservabilitySpansSearchSpanEvaluations`](docs/sdks/spans/README.md#searchspanevaluations) - Search span evaluations
+- [`betaObservabilitySpansSearchSpans`](docs/sdks/spans/README.md#searchspans) - Search spans
+- [`betaObservabilityTracesFetchOptions`](docs/sdks/traces/README.md#fetchoptions) - Get options for a trace field
+- [`betaObservabilityTracesGetSpanById`](docs/sdks/traces/README.md#getspanbyid) - Get span by id
+- [`betaObservabilityTracesGetTraceById`](docs/sdks/traces/README.md#gettracebyid) - Get trace by id
+- [`betaObservabilityTracesGetTraceFields`](docs/sdks/traces/README.md#gettracefields) - Get trace field definitions
+- [`betaObservabilityTracesGetTraceSpans`](docs/sdks/traces/README.md#gettracespans) - Get trace spans
+- [`betaObservabilityTracesSearch`](docs/sdks/traces/README.md#search) - Search traces
 - [`betaRagIngestionPipelineConfigurationsList`](docs/sdks/ingestionpipelineconfigurations/README.md#list) - List ingestion pipeline configurations
 - [`betaRagIngestionPipelineConfigurationsRegister`](docs/sdks/ingestionpipelineconfigurations/README.md#register) - Register Config
 - [`betaRagIngestionPipelineConfigurationsUpdateRunInfo`](docs/sdks/ingestionpipelineconfigurations/README.md#updateruninfo) - Update Run Info
@@ -1099,6 +1143,7 @@ To read more about standalone functions, check [FUNCTIONS.md](./FUNCTIONS.md).
 - [`workflowsExecutionsCancelWorkflowExecution`](docs/sdks/executions/README.md#cancelworkflowexecution) - Cancel Workflow Execution
 - [`workflowsExecutionsGetWorkflowExecution`](docs/sdks/executions/README.md#getworkflowexecution) - Get Workflow Execution
 - [`workflowsExecutionsGetWorkflowExecutionHistory`](docs/sdks/executions/README.md#getworkflowexecutionhistory) - Get Workflow Execution History
+- [`workflowsExecutionsGetWorkflowExecutionLogs`](docs/sdks/executions/README.md#getworkflowexecutionlogs) - Get Workflow Execution Logs
 - [`workflowsExecutionsGetWorkflowExecutionTraceEvents`](docs/sdks/executions/README.md#getworkflowexecutiontraceevents) - Get Workflow Execution Trace Events
 - [`workflowsExecutionsGetWorkflowExecutionTraceOtel`](docs/sdks/executions/README.md#getworkflowexecutiontraceotel) - Get Workflow Execution Trace Otel
 - [`workflowsExecutionsGetWorkflowExecutionTraceSummary`](docs/sdks/executions/README.md#getworkflowexecutiontracesummary) - Get Workflow Execution Trace Summary
@@ -1106,6 +1151,7 @@ To read more about standalone functions, check [FUNCTIONS.md](./FUNCTIONS.md).
 - [`workflowsExecutionsResetWorkflow`](docs/sdks/executions/README.md#resetworkflow) - Reset Workflow
 - [`workflowsExecutionsSignalWorkflowExecution`](docs/sdks/executions/README.md#signalworkflowexecution) - Signal Workflow Execution
 - [`workflowsExecutionsStream`](docs/sdks/executions/README.md#stream) - Stream
+- [`workflowsExecutionsStreamWorkflowExecutionLogs`](docs/sdks/executions/README.md#streamworkflowexecutionlogs) - Stream Workflow Execution Logs
 - [`workflowsExecutionsTerminateWorkflowExecution`](docs/sdks/executions/README.md#terminateworkflowexecution) - Terminate Workflow Execution
 - [`workflowsExecutionsUpdateWorkflowExecution`](docs/sdks/executions/README.md#updateworkflowexecution) - Update Workflow Execution
 - [`workflowsGetWorkflow`](docs/sdks/workflows/README.md#getworkflow) - Get Workflow
@@ -1121,6 +1167,7 @@ To read more about standalone functions, check [FUNCTIONS.md](./FUNCTIONS.md).
 - [`workflowsSchedulesPauseSchedule`](docs/sdks/schedules/README.md#pauseschedule) - Pause Schedule
 - [`workflowsSchedulesResumeSchedule`](docs/sdks/schedules/README.md#resumeschedule) - Resume Schedule
 - [`workflowsSchedulesScheduleWorkflow`](docs/sdks/schedules/README.md#scheduleworkflow) - Schedule Workflow
+- [`workflowsSchedulesTriggerSchedule`](docs/sdks/schedules/README.md#triggerschedule) - Trigger Schedule
 - [`workflowsSchedulesUnscheduleWorkflow`](docs/sdks/schedules/README.md#unscheduleworkflow) - Unschedule Workflow
 - [`workflowsSchedulesUpdateSchedule`](docs/sdks/schedules/README.md#updateschedule) - Update Schedule
 - [`workflowsUnarchiveWorkflow`](docs/sdks/workflows/README.md#unarchiveworkflow) - Unarchive Workflow

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

@@ -0,0 +1,40 @@
+/**
+ * Formatting helpers for converting Mistral API payloads to OTEL GenAI convention formats.
+ *
+ * These are pure functions with no OTEL dependencies - they transform objects to objects
+ * matching the GenAI semantic convention schemas for input/output messages and tool definitions.
+ * The caller is responsible for the final JSON serialization (single JSON.stringify on the whole
+ * collection) before setting span attributes.
+ *
+ * Schemas:
+ * - Input messages: https://github.com/open-telemetry/semantic-conventions/blob/main/docs/gen-ai/gen-ai-input-messages.json
+ * - Output messages: https://github.com/open-telemetry/semantic-conventions/blob/main/docs/gen-ai/gen-ai-output-messages.json
+ * - Tool definitions: https://github.com/Cirilla-zmh/semantic-conventions/blob/cc4d07e7e56b80e9aa5904a3d524c134699da37f/docs/gen-ai/gen-ai-tool-definitions.json
+ */
+/**
+ * Format a single input message per the OTEL GenAI convention.
+ *
+ * Schema: https://github.com/open-telemetry/semantic-conventions/blob/main/docs/gen-ai/gen-ai-input-messages.json
+ * ChatMessage: {role (required), parts (required), name?}
+ *
+ * Conversation entry objects (e.g. function.result) don't carry a "role"
+ * field - they are detected via their "type" and mapped to the closest OTEL role.
+ */
+export declare function formatInputMessage(message: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Format a single output choice/message per the OTEL GenAI convention.
+ *
+ * Schema: https://github.com/open-telemetry/semantic-conventions/blob/main/docs/gen-ai/gen-ai-output-messages.json
+ * OutputMessage: {role (required), parts (required), finish_reason (required), name?}
+ */
+export declare function formatOutputMessage(choice: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Flatten a Mistral tool definition to the OTEL GenAI convention schema.
+ *
+ * Mistral format: {"type": "function", "function": {"name": ..., "description": ..., "parameters": ...}}
+ * OTEL format: {"type": "function", "name": ..., "description": ..., "parameters": ...}
+ *
+ * Schema, still under review: https://github.com/open-telemetry/semantic-conventions
+ */
+export declare function formatToolDefinition(tool: Record<string, unknown>): Record<string, unknown> | null;
+//# sourceMappingURL=formatting.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"formatting.d.ts","sourceRoot":"","sources":["../../../src/extra/observability/formatting.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAuFH;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmC5F;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAW5F;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAqBlG"}

package/esm/extra/observability/formatting.js

@@ -0,0 +1,187 @@
+/**
+ * Formatting helpers for converting Mistral API payloads to OTEL GenAI convention formats.
+ *
+ * These are pure functions with no OTEL dependencies - they transform objects to objects
+ * matching the GenAI semantic convention schemas for input/output messages and tool definitions.
+ * The caller is responsible for the final JSON serialization (single JSON.stringify on the whole
+ * collection) before setting span attributes.
+ *
+ * Schemas:
+ * - Input messages: https://github.com/open-telemetry/semantic-conventions/blob/main/docs/gen-ai/gen-ai-input-messages.json
+ * - Output messages: https://github.com/open-telemetry/semantic-conventions/blob/main/docs/gen-ai/gen-ai-output-messages.json
+ * - Tool definitions: https://github.com/Cirilla-zmh/semantic-conventions/blob/cc4d07e7e56b80e9aa5904a3d524c134699da37f/docs/gen-ai/gen-ai-tool-definitions.json
+ */
+/**
+ * Convert Mistral message content to OTEL parts array.
+ *
+ * Mistral content is either a string or an array of content chunks.
+ */
+function contentToParts(content) {
+    if (content == null) {
+        return [];
+    }
+    if (typeof content === "string") {
+        return [{ type: "text", content }];
+    }
+    if (!Array.isArray(content)) {
+        return [];
+    }
+    // Content chunks array - map known Mistral types to OTEL part types
+    const parts = [];
+    for (const chunk of content) {
+        if (typeof chunk === "string") {
+            parts.push({ type: "text", content: chunk });
+        }
+        else if (typeof chunk === "object" && chunk !== null) {
+            const c = chunk;
+            const chunkType = c["type"] || "";
+            if (chunkType === "text") {
+                parts.push({ type: "text", content: c["text"] || "" });
+            }
+            else if (chunkType === "thinking") {
+                const thinking = c["thinking"];
+                let contentStr;
+                if (Array.isArray(thinking)) {
+                    const textParts = thinking
+                        .filter((sub) => typeof sub === "object" && sub !== null && sub["type"] === "text")
+                        .map((sub) => sub["text"] || "");
+                    contentStr = textParts.join("\n");
+                }
+                else {
+                    contentStr = String(thinking || "");
+                }
+                parts.push({ type: "reasoning", content: contentStr });
+            }
+            else if (chunkType === "image_url") {
+                const url = c["image_url"];
+                const uri = typeof url === "object" && url !== null
+                    ? url["url"] || ""
+                    : String(url || "");
+                parts.push({ type: "uri", modality: "image", uri });
+            }
+            else {
+                // Catch-all for other content chunk types
+                parts.push({ type: chunkType });
+            }
+        }
+    }
+    return parts;
+}
+/**
+ * Convert Mistral tool_calls to OTEL ToolCallRequestPart entries.
+ */
+function toolCallsToParts(toolCalls) {
+    if (!toolCalls || !Array.isArray(toolCalls)) {
+        return [];
+    }
+    const parts = [];
+    for (const tc of toolCalls) {
+        if (typeof tc !== "object" || tc === null)
+            continue;
+        const tcObj = tc;
+        const func = tcObj["function"] || {};
+        const part = {
+            type: "tool_call",
+            name: func["name"] || "",
+        };
+        const tcId = tcObj["id"];
+        if (tcId != null) {
+            part["id"] = tcId;
+        }
+        const args = func["arguments"];
+        if (args != null) {
+            part["arguments"] = args;
+        }
+        parts.push(part);
+    }
+    return parts;
+}
+/**
+ * Format a single input message per the OTEL GenAI convention.
+ *
+ * Schema: https://github.com/open-telemetry/semantic-conventions/blob/main/docs/gen-ai/gen-ai-input-messages.json
+ * ChatMessage: {role (required), parts (required), name?}
+ *
+ * Conversation entry objects (e.g. function.result) don't carry a "role"
+ * field - they are detected via their "type" and mapped to the closest OTEL role.
+ */
+export function formatInputMessage(message) {
+    const entryType = message["type"];
+    // Conversation entry: function.result to OTEL tool role
+    if (entryType === "function.result") {
+        const part = { type: "tool_call_response", response: message["result"] };
+        const toolCallId = message["tool_call_id"];
+        if (toolCallId != null) {
+            part["id"] = toolCallId;
+        }
+        return { role: "tool", parts: [part] };
+    }
+    // TODO: may need to handle other types for conversations (e.g. agent handoff)
+    const role = message["role"] || "unknown";
+    const parts = [];
+    if (role === "tool") {
+        // Tool messages are responses to tool calls
+        const toolPart = {
+            type: "tool_call_response",
+            response: message["content"],
+        };
+        const toolCallId = message["tool_call_id"];
+        if (toolCallId != null) {
+            toolPart["id"] = toolCallId;
+        }
+        parts.push(toolPart);
+    }
+    else {
+        parts.push(...contentToParts(message["content"]));
+        parts.push(...toolCallsToParts(message["tool_calls"]));
+    }
+    return { role, parts };
+}
+/**
+ * Format a single output choice/message per the OTEL GenAI convention.
+ *
+ * Schema: https://github.com/open-telemetry/semantic-conventions/blob/main/docs/gen-ai/gen-ai-output-messages.json
+ * OutputMessage: {role (required), parts (required), finish_reason (required), name?}
+ */
+export function formatOutputMessage(choice) {
+    const message = choice["message"] || {};
+    const parts = [];
+    parts.push(...contentToParts(message["content"]));
+    parts.push(...toolCallsToParts(message["tool_calls"]));
+    return {
+        role: message["role"] || "assistant",
+        parts,
+        finish_reason: choice["finish_reason"] || "",
+    };
+}
+/**
+ * Flatten a Mistral tool definition to the OTEL GenAI convention schema.
+ *
+ * Mistral format: {"type": "function", "function": {"name": ..., "description": ..., "parameters": ...}}
+ * OTEL format: {"type": "function", "name": ..., "description": ..., "parameters": ...}
+ *
+ * Schema, still under review: https://github.com/open-telemetry/semantic-conventions
+ */
+export function formatToolDefinition(tool) {
+    // Early exit conditions: only functions supported for now, and name is required
+    const type = tool["type"] || "function";
+    const func = tool["function"];
+    if (!func) {
+        return null;
+    }
+    const name = func["name"];
+    if (!name) {
+        return null;
+    }
+    const formatted = { type, name };
+    const description = func["description"];
+    if (description != null) {
+        formatted["description"] = description;
+    }
+    const parameters = func["parameters"];
+    if (parameters != null) {
+        formatted["parameters"] = parameters;
+    }
+    return formatted;
+}
+//# sourceMappingURL=formatting.js.map

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

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

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

@@ -0,0 +1,3 @@
+export { registerTracerProvider, traceAsync } from "./otel.js";
+export { MISTRAL_SDK_OTEL_TRACER_NAME } from "./otel.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/extra/observability/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,4BAA4B,EAAE,MAAM,WAAW,CAAC"}

package/esm/extra/observability/index.js

@@ -0,0 +1,3 @@
+export { registerTracerProvider, traceAsync } from "./otel.js";
+export { MISTRAL_SDK_OTEL_TRACER_NAME } from "./otel.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/extra/observability/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,4BAA4B,EAAE,MAAM,WAAW,CAAC"}

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

@@ -0,0 +1,59 @@
+/**
+ * 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 { type Context, type Span, type Tracer, type TracerProvider } from "@opentelemetry/api";
+import * as semConvAttributes from "@opentelemetry/semantic-conventions/incubating";
+export type { Context, Span, Tracer };
+export { semConvAttributes };
+export declare const OTEL_SERVICE_NAME = "mistralai_sdk";
+export declare const MISTRAL_SDK_OTEL_TRACER_NAME = "mistralai_sdk_tracer";
+/**
+ * Route SDK tracing spans to a specific OpenTelemetry tracer provider.
+ */
+export declare function registerTracerProvider(tracerProvider?: TracerProvider): void;
+export declare const MistralAIAttributes: {
+    readonly MISTRAL_AI_OCR_USAGE_PAGES_PROCESSED: "mistral_ai.ocr.usage.pages_processed";
+    readonly MISTRAL_AI_OCR_USAGE_DOC_SIZE_BYTES: "mistral_ai.ocr.usage.doc_size_bytes";
+    readonly MISTRAL_AI_ERROR_CODE: "mistral_ai.error.code";
+};
+export declare const TracingErrors: {
+    readonly FAILED_TO_CREATE_SPAN_FOR_REQUEST: "Failed to create span for request.";
+    readonly FAILED_TO_ENRICH_SPAN_WITH_RESPONSE: "Failed to enrich span with response.";
+    readonly FAILED_TO_HANDLE_ERROR_IN_SPAN: "Failed to handle error in span.";
+    readonly FAILED_TO_END_SPAN: "Failed to end span.";
+};
+export declare function enrichSpanFromRequest(span: Span, operationId: string, url: URL, method: string, host: string, body: string | null): Span;
+export declare function enrichSpanFromResponse(tracer: Tracer, span: Span, operationId: string, responseData: Record<string, unknown>): void;
+/**
+ * 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 declare function getOrCreateOtelTracer(): Tracer;
+export declare function getSpanContext(span: Span): Context;
+export declare function runWithContext<T>(context: Context, fn: () => T): T;
+export declare function recordRequestError(context: Context, error: unknown): Promise<void>;
+export declare function getTracedRequestAndSpan(tracer: Tracer, operationId: string, request: Request): Promise<{
+    request: Request;
+    span: Span;
+    body: string | null;
+}>;
+export declare function getTracedResponse(tracer: Tracer, span: Span, operationId: string, response: Response): Promise<Response>;
+export declare function getResponseAndError(span: Span, response: Response | null, error: unknown): Promise<{
+    response: Response | null;
+    error: unknown;
+}>;
+/**
+ * Create a traced span using a callback pattern.
+ * This is the TypeScript equivalent of Python's context manager.
+ */
+export declare function traceAsync<T>(name: string, fn: (span: Span) => Promise<T>): Promise<T>;
+//# sourceMappingURL=otel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"otel.d.ts","sourceRoot":"","sources":["../../../src/extra/observability/otel.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAIL,KAAK,OAAO,EACZ,KAAK,IAAI,EACT,KAAK,MAAM,EACX,KAAK,cAAc,EAEpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,iBAAiB,MAAM,gDAAgD,CAAC;AASpF,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AACtC,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAE7B,eAAO,MAAM,iBAAiB,kBAAkB,CAAC;AACjD,eAAO,MAAM,4BAA4B,yBAAgC,CAAC;AAI1E;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,IAAI,CAE5E;AAiBD,eAAO,MAAM,mBAAmB;;;;CAItB,CAAC;AAEX,eAAO,MAAM,aAAa;;;;;CAKhB,CAAC;AA2JX,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,IAAI,EACV,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GAAG,IAAI,GAClB,IAAI,CAuBN;AAqJD,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,IAAI,EACV,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACpC,IAAI,CAiBN;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAG9C;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAElD;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAElE;AAED,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,IAAI,CAAC,CAKf;AAUD,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CA4DhE;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,IAAI,EACV,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,QAAQ,CAAC,CA8CnB;AAmFD,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,QAAQ,GAAG,IAAI,EACzB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC;IAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,CAsDxD;AAUD;;;GAGG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAChC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,GAC7B,OAAO,CAAC,CAAC,CAAC,CAQZ"}