@introspection-sdk/introspection-node 0.4.2 → 0.4.3

package/dist/index.d.ts

@@ -1,38 +1,35 @@
-import { IntrospectionSpanProcessor } from "./span-processor.js";
-import type { IntrospectionSpanProcessorOptions } from "./span-processor.js";
 /**
- * Factory that creates an {@link IntrospectionSpanProcessor}.
+ * Root entry point — REST-only surface.
  *
- * Provided as the default export for convenient use with logfire's
- * `additionalSpanProcessors` option.
+ * Exports `IntrospectionClient` (REST), Runner / RuntimeHandle /
+ * ExperimentHandle, REST wire types, and HTTP helpers. None of these
+ * touch the OpenTelemetry SDK.
  *
- * @param options - Optional processor configuration (token, serviceName, etc.).
- * @returns A ready-to-use {@link IntrospectionSpanProcessor}.
- *
- * @example
- * ```ts
- * import introspectionSpanProcessor from "@introspection-sdk/introspection-node";
- *
- * logfire.configure({ additionalSpanProcessors: [introspectionSpanProcessor()] });
- * ```
+ * For the OTel surface (logs, span processors, instrumentors) import
+ * from `@introspection-sdk/introspection-node/otel`.
  */
-export default function introspectionSpanProcessor(options?: IntrospectionSpanProcessorOptions): IntrospectionSpanProcessor;
-export { IntrospectionSpanProcessor } from "./span-processor.js";
-export type { IntrospectionSpanProcessorOptions } from "./span-processor.js";
 export { IntrospectionClient } from "./client.js";
 export type { AdvancedOptions, IntrospectionClientOptions, FeedbackOptions, UserTraits, } from "./types.js";
-export { IntrospectionTracingProcessor } from "./tracing-processor.js";
-export type { IntrospectionTracingProcessorOptions, TracingProcessorAdvancedOptions, } from "./tracing-processor.js";
-export { IntrospectionClaudeHooks } from "./claude-hooks.js";
-export type { IntrospectionClaudeHooksOptions, ClaudeHooksAdvancedOptions, ClaudeHooksConfig, ClaudeHookCallbackMatcher, ClaudeHookEvent, ClaudeHookInput, ClaudeHookOutput, ClaudeHookCallback, ClaudeUsage, ClaudeModelUsage, ClaudeResultMessage, ClaudeAssistantMessage, ClaudeSDKMessage, } from "./claude-hooks.js";
-export { withIntrospection } from "./claude-wrapper.js";
-export type { WithIntrospectionOptions, InstrumentedClaudeAgentSDK, ClaudeAgentSDKModule, } from "./claude-wrapper.js";
+export { TasksApi, TaskRunsApi, RunHandle } from "./runner-resources/tasks.js";
+export type { StartParams } from "./runner-resources/tasks.js";
+export { FilesApi, FileVersionsApi } from "./runner-resources/files.js";
+export type { FileUploadBody } from "./runner-resources/files.js";
+export { HttpClient } from "./http.js";
+export type { ResolvedApiConfig } from "./http.js";
+export { parseSse } from "./streaming.js";
+export { Runner } from "./runner.js";
+export type { RunnerSource } from "./runner.js";
+export { RuntimesApi, RuntimeHandle, attachRuntimes, isUuid, } from "./resources/runtimes.js";
+export type { RuntimeHandleFactory } from "./resources/runtimes.js";
+export { ExperimentsApi, ExperimentHandle, attachExperiments, } from "./resources/experiments.js";
+export type { ExperimentHandleFactory } from "./resources/experiments.js";
+export { RecipesApi, attachRecipes } from "./resources/recipes.js";
+export type { Paginated, ListParams, Task, TaskCreateParams, TaskUpdateParams, TaskListParams, TaskMode, TaskStatus, TaskPrompt, TaskRun, TaskRunCreateParams, TaskRunResponse, TaskCreateResponse, TaskCancelResponse, AgentInfo, File, FileType, FileListParams, FileUpdateParams, FileCreateTextParams, SseEvent, Runtime, RuntimeCreate, RuntimeUpdate, RuntimeListParams, Experiment, ExperimentCreate, ExperimentUpdate, ExperimentListParams, ExperimentStatus, ExperimentEndParams, Arm, Recipe, RecipeCreate, RecipeUpdate, RecipeListParams, RunnerSpec, RunnerDeployment, RunnerContext, RunnerRecipeSummary, RunnerIdentity, RunRequest, RunCaller, RunCallerLibrary, RunCallerPage, RunIdentityInput, } from "@introspection-sdk/types";
+export { IntrospectionAPIError, AuthenticationError, InsufficientScopeError, RunnerExpiredError, NotFoundError, ConflictError, ValidationError, RateLimitError, SandboxUnavailableError, StreamError, NetworkError, apiErrorFromResponse, } from "@introspection-sdk/types";
 export type { GenAiAttributes, InputMessage, OutputMessage, SystemInstruction, ToolDefinition, TextPart, ToolCallRequestPart, ToolCallResponsePart, MessagePart, } from "@introspection-sdk/types";
 export { toAttributes } from "@introspection-sdk/types";
 export { convertResponsesInputsToSemconv, convertResponsesOutputsToSemconv, convertResponsesToolsToSemconv, convertResponsesInstructionsToSemconv, } from "./converters/openai.js";
 export type { ResponseInputItem, ResponseOutputItem, ResponseTool, ResponseUsage, Response as OpenAIResponse, } from "./converters/openai.js";
-export { IntrospectionAISDKIntegration } from "./ai-sdk-integration.js";
-export type { IntrospectionAISDKIntegrationOptions, AISDKIntegrationAdvancedOptions, } from "./ai-sdk-integration.js";
-export { addOpenInferenceAttributes, OpenInferenceSpanExporter, } from "./converters/openinference.js";
-export { AnthropicInstrumentor, tracedMessagesCreate, REDACTED_THINKING_CONTENT, } from "./anthropic.js";
+export { convertGeminiContentsToInputMessages, convertGeminiCandidatesToOutputMessages, convertGeminiSystemInstructionToSemconv, convertGeminiToolsToToolDefinitions, } from "./converters/gemini.js";
+export type { GeminiCandidate, GeminiContent, GeminiFunctionDeclaration, GeminiPart, GeminiTool, } from "./converters/gemini.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,qBAAqB,CAAC;AAE7E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,OAAO,UAAU,0BAA0B,CAChD,OAAO,CAAC,EAAE,iCAAiC,GAC1C,0BAA0B,CAE5B;AAGD,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,YAAY,EAAE,iCAAiC,EAAE,MAAM,qBAAqB,CAAC;AAG7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGlD,YAAY,EACV,eAAe,EACf,0BAA0B,EAC1B,eAAe,EACf,UAAU,GACX,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AACvE,YAAY,EACV,oCAAoC,EACpC,+BAA+B,GAChC,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,YAAY,EACV,+BAA+B,EAC/B,0BAA0B,EAC1B,iBAAiB,EACjB,yBAAyB,EACzB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACX,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EACV,wBAAwB,EACxB,0BAA0B,EAC1B,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAG7B,YAAY,EACV,eAAe,EACf,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,QAAQ,EACR,mBAAmB,EACnB,oBAAoB,EACpB,WAAW,GACZ,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD,OAAO,EACL,+BAA+B,EAC/B,gCAAgC,EAChC,8BAA8B,EAC9B,qCAAqC,GACtC,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,QAAQ,IAAI,cAAc,GAC3B,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,6BAA6B,EAAE,MAAM,yBAAyB,CAAC;AACxE,YAAY,EACV,oCAAoC,EACpC,+BAA+B,GAChC,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,39 +1,29 @@
-import { IntrospectionSpanProcessor } from "./span-processor.js";
 /**
- * Factory that creates an {@link IntrospectionSpanProcessor}.
+ * Root entry point — REST-only surface.
  *
- * Provided as the default export for convenient use with logfire's
- * `additionalSpanProcessors` option.
+ * Exports `IntrospectionClient` (REST), Runner / RuntimeHandle /
+ * ExperimentHandle, REST wire types, and HTTP helpers. None of these
+ * touch the OpenTelemetry SDK.
  *
- * @param options - Optional processor configuration (token, serviceName, etc.).
- * @returns A ready-to-use {@link IntrospectionSpanProcessor}.
- *
- * @example
- * ```ts
- * import introspectionSpanProcessor from "@introspection-sdk/introspection-node";
- *
- * logfire.configure({ additionalSpanProcessors: [introspectionSpanProcessor()] });
- * ```
+ * For the OTel surface (logs, span processors, instrumentors) import
+ * from `@introspection-sdk/introspection-node/otel`.
  */
-export default function introspectionSpanProcessor(options) {
-    return new IntrospectionSpanProcessor(options);
-}
-// Span processor exports (for OpenTelemetry integration)
-export { IntrospectionSpanProcessor } from "./span-processor.js";
-// Client exports
+// REST client.
 export { IntrospectionClient } from "./client.js";
-// Tracing processor exports (for OpenAI Agents SDK integration)
-export { IntrospectionTracingProcessor } from "./tracing-processor.js";
-// Claude Agent SDK hooks exports
-export { IntrospectionClaudeHooks } from "./claude-hooks.js";
-// Claude Agent SDK wrapper exports
-export { withIntrospection } from "./claude-wrapper.js";
+// Runner-bound REST namespaces (runner.tasks, runner.files) + HTTP/SSE.
+export { TasksApi, TaskRunsApi, RunHandle } from "./runner-resources/tasks.js";
+export { FilesApi, FileVersionsApi } from "./runner-resources/files.js";
+export { HttpClient } from "./http.js";
+export { parseSse } from "./streaming.js";
+// Runner + CP resources.
+export { Runner } from "./runner.js";
+export { RuntimesApi, RuntimeHandle, attachRuntimes, isUuid, } from "./resources/runtimes.js";
+export { ExperimentsApi, ExperimentHandle, attachExperiments, } from "./resources/experiments.js";
+export { RecipesApi, attachRecipes } from "./resources/recipes.js";
+export { IntrospectionAPIError, AuthenticationError, InsufficientScopeError, RunnerExpiredError, NotFoundError, ConflictError, ValidationError, RateLimitError, SandboxUnavailableError, StreamError, NetworkError, apiErrorFromResponse, } from "@introspection-sdk/types";
 export { toAttributes } from "@introspection-sdk/types";
-// OpenAI converter exports
+// OpenAI converter exports (pure functions, no OTel SDK imports).
 export { convertResponsesInputsToSemconv, convertResponsesOutputsToSemconv, convertResponsesToolsToSemconv, convertResponsesInstructionsToSemconv, } from "./converters/openai.js";
-// AI SDK integration exports (for Vercel AI SDK)
-export { IntrospectionAISDKIntegration } from "./ai-sdk-integration.js";
-// OpenInference converter exports
-export { addOpenInferenceAttributes, OpenInferenceSpanExporter, } from "./converters/openinference.js";
-// Anthropic instrumentor exports
-export { AnthropicInstrumentor, tracedMessagesCreate, REDACTED_THINKING_CONTENT, } from "./anthropic.js";
+// Gemini converters (pure functions, no OTel SDK imports).
+export { convertGeminiContentsToInputMessages, convertGeminiCandidatesToOutputMessages, convertGeminiSystemInstructionToSemconv, convertGeminiToolsToToolDefinitions, } from "./converters/gemini.js";
+//# 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;;;;;;;;;GASG;AAEH,eAAe;AACf,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAUlD,wEAAwE;AACxE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAE/E,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAExE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,yBAAyB;AACzB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EACL,WAAW,EACX,aAAa,EACb,cAAc,EACd,MAAM,GACP,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAmDnE,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,eAAe,EACf,cAAc,EACd,uBAAuB,EACvB,WAAW,EACX,YAAY,EACZ,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAclC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,kEAAkE;AAClE,OAAO,EACL,+BAA+B,EAC/B,gCAAgC,EAChC,8BAA8B,EAC9B,qCAAqC,GACtC,MAAM,wBAAwB,CAAC;AAShC,2DAA2D;AAC3D,OAAO,EACL,oCAAoC,EACpC,uCAAuC,EACvC,uCAAuC,EACvC,mCAAmC,GACpC,MAAM,wBAAwB,CAAC"}

package/dist/otel/anthropic.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Lightweight Anthropic instrumentor for Introspection SDK.
+ *
+ * Captures the full Anthropic response including thinking blocks (extended
+ * thinking) with signatures, which third-party instrumentors drop.
+ *
+ * Supports both non-streaming (`messages.create`) and streaming
+ * (`messages.create({ stream: true })`) calls.
+ *
+ * @example
+ * ```ts
+ * import { AnthropicInstrumentor } from "@introspection-sdk/introspection-node";
+ *
+ * const instrumentor = new AnthropicInstrumentor();
+ * instrumentor.instrument({ tracerProvider: provider });
+ * // All client.messages.create calls are now traced
+ * ```
+ */
+import type { Tracer } from "@opentelemetry/api";
+import type { BasicTracerProvider } from "@opentelemetry/sdk-trace-base";
+/** Sentinel value for redacted thinking blocks — content was encrypted by safety systems. */
+export declare const REDACTED_THINKING_CONTENT = "[redacted]";
+/**
+ * Traced wrapper around `client.messages.create(kwargs)`.
+ * Creates a gen_ai span with full Anthropic response including thinking blocks.
+ */
+export declare function tracedMessagesCreate(tracer: Tracer, client: {
+    messages: {
+        create: (...args: unknown[]) => Promise<unknown>;
+    };
+}, kwargs: Record<string, unknown>, conversationId?: string): Promise<unknown>;
+/**
+ * Auto-instrumentor that patches `Anthropic.messages.create` to add tracing.
+ *
+ * Captures all content blocks including thinking (extended thinking) with
+ * signatures. Supports both non-streaming and streaming calls.
+ */
+/**
+ * Auto-instrumentor that wraps an Anthropic client instance to add tracing.
+ *
+ * Captures all content blocks including thinking (extended thinking) with
+ * signatures. Supports both non-streaming and streaming calls.
+ */
+export declare class AnthropicInstrumentor {
+    private tracer;
+    private patchedClients;
+    private conversationId;
+    instrument(opts: {
+        tracerProvider?: BasicTracerProvider;
+        /** The Anthropic client instance to instrument. */
+        client: any;
+        /**
+         * Conversation ID shared across all spans produced by this instrumentor.
+         * Enables the Introspection processor to reliably link multi-turn API calls
+         * into a single conversation without relying on history-hash matching.
+         * Defaults to a random UUID generated at instrument() time.
+         */
+        conversationId?: string;
+    }): void;
+    uninstrument(): void;
+}
+//# sourceMappingURL=anthropic.d.ts.map

package/dist/otel/anthropic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/otel/anthropic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAgBH,OAAO,KAAK,EAAE,MAAM,EAAQ,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAMzE,6FAA6F;AAC7F,eAAO,MAAM,yBAAyB,eAAe,CAAC;AAiWtD;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE;IAAE,QAAQ,EAAE;QAAE,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;KAAE,CAAA;CAAE,EAC1E,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,OAAO,CAAC,CAuBlB;AAED;;;;;GAKG;AACH;;;;;GAKG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAAuB;IAErC,OAAO,CAAC,cAAc,CAAmD;IACzE,OAAO,CAAC,cAAc,CAAqB;IAE3C,UAAU,CAAC,IAAI,EAAE;QACf,cAAc,CAAC,EAAE,mBAAmB,CAAC;QACrC,mDAAmD;QAEnD,MAAM,EAAE,GAAG,CAAC;QACZ;;;;;WAKG;QACH,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,GAAG,IAAI;IAsFR,YAAY,IAAI,IAAI;CAOrB"}

package/dist/otel/anthropic.js

@@ -0,0 +1,425 @@
+/**
+ * Lightweight Anthropic instrumentor for Introspection SDK.
+ *
+ * Captures the full Anthropic response including thinking blocks (extended
+ * thinking) with signatures, which third-party instrumentors drop.
+ *
+ * Supports both non-streaming (`messages.create`) and streaming
+ * (`messages.create({ stream: true })`) calls.
+ *
+ * @example
+ * ```ts
+ * import { AnthropicInstrumentor } from "@introspection-sdk/introspection-node";
+ *
+ * const instrumentor = new AnthropicInstrumentor();
+ * instrumentor.instrument({ tracerProvider: provider });
+ * // All client.messages.create calls are now traced
+ * ```
+ */
+import { trace, context as otelContext, propagation, SpanKind, SpanStatusCode, } from "@opentelemetry/api";
+// ---------------------------------------------------------------------------
+// Converters
+// ---------------------------------------------------------------------------
+/** Sentinel value for redacted thinking blocks — content was encrypted by safety systems. */
+export const REDACTED_THINKING_CONTENT = "[redacted]";
+function blockToParts(block) {
+    const bt = block.type || "";
+    if (bt === "text") {
+        return [{ type: "text", content: block.text || "" }];
+    }
+    if (bt === "thinking") {
+        const part = {
+            type: "thinking",
+            content: block.thinking || undefined,
+            signature: block.signature || undefined,
+            provider_name: "anthropic",
+        };
+        return [part];
+    }
+    if (bt === "redacted_thinking") {
+        return [
+            {
+                type: "thinking",
+                content: REDACTED_THINKING_CONTENT,
+                signature: block.data || undefined,
+                provider_name: "anthropic",
+            },
+        ];
+    }
+    if (bt === "tool_use") {
+        return [
+            {
+                type: "tool_call",
+                id: block.id || "",
+                name: block.name || "",
+                arguments: block.input,
+            },
+        ];
+    }
+    if (bt === "tool_result") {
+        return [
+            {
+                type: "tool_call_response",
+                id: block.tool_use_id || "",
+                response: block.content != null ? String(block.content) : "",
+            },
+        ];
+    }
+    return [];
+}
+function convertAnthropicInput(messages) {
+    const result = [];
+    for (const msg of messages) {
+        const role = msg.role || "user";
+        const content = msg.content;
+        if (typeof content === "string") {
+            result.push({
+                role: role,
+                parts: [{ type: "text", content }],
+            });
+        }
+        else if (Array.isArray(content)) {
+            const parts = [];
+            for (const block of content) {
+                const rec = typeof block === "object" && block !== null
+                    ? block
+                    : { type: "text", text: String(block) };
+                parts.push(...blockToParts(rec));
+            }
+            if (parts.length > 0) {
+                result.push({ role: role, parts });
+            }
+        }
+    }
+    return result;
+}
+function convertAnthropicOutput(content) {
+    const parts = [];
+    let hasToolCalls = false;
+    for (const block of content) {
+        const newParts = blockToParts(block);
+        for (const p of newParts) {
+            if (p.type === "tool_call")
+                hasToolCalls = true;
+        }
+        parts.push(...newParts);
+    }
+    if (parts.length === 0)
+        return [];
+    return [
+        {
+            role: "assistant",
+            parts,
+            finish_reason: hasToolCalls ? "tool-calls" : "stop",
+        },
+    ];
+}
+// ---------------------------------------------------------------------------
+// Span helpers
+// ---------------------------------------------------------------------------
+function serializeMessages(msgs) {
+    return JSON.stringify(msgs.map((m) => {
+        const obj = { role: m.role, parts: m.parts };
+        if ("finish_reason" in m && m.finish_reason) {
+            obj.finish_reason = m.finish_reason;
+        }
+        return obj;
+    }));
+}
+function startSpan(tracer, model, conversationId) {
+    const span = tracer.startSpan("chat", {
+        kind: SpanKind.CLIENT,
+        attributes: {
+            "gen_ai.system": "anthropic",
+            "gen_ai.provider.name": "anthropic",
+            "gen_ai.operation.name": "chat",
+            "gen_ai.request.model": model,
+            "openinference.span.kind": "LLM",
+            ...(conversationId
+                ? { "gen_ai.conversation.id": conversationId }
+                : undefined),
+        },
+    });
+    return { span, token: null };
+}
+function setRequestAttrs(span, kwargs) {
+    const messages = kwargs.messages || [];
+    const inputMsgs = convertAnthropicInput(messages);
+    if (inputMsgs.length > 0) {
+        span.setAttribute("gen_ai.input.messages", serializeMessages(inputMsgs));
+    }
+    const system = kwargs.system;
+    if (system) {
+        let sysVal;
+        if (typeof system === "string") {
+            sysVal = JSON.stringify([{ type: "text", content: system }]);
+        }
+        else if (Array.isArray(system)) {
+            // Anthropic block format: [{type:"text", text:"...", cache_control:{...}}]
+            // Normalize to gen_ai format: [{type:"text", content:"..."}]
+            sysVal = JSON.stringify(system.map((block) => ({
+                type: "text",
+                content: typeof block.text === "string"
+                    ? block.text
+                    : typeof block.content === "string"
+                        ? block.content
+                        : "",
+            })));
+        }
+        else {
+            sysVal = JSON.stringify(system);
+        }
+        span.setAttribute("gen_ai.system_instructions", sysVal);
+    }
+    const tools = kwargs.tools;
+    if (tools && tools.length > 0) {
+        const defs = tools.map((t) => ({
+            name: t.name || "",
+            description: t.description,
+            parameters: t.input_schema,
+        }));
+        span.setAttribute("gen_ai.tool.definitions", JSON.stringify(defs));
+    }
+}
+function setResponseAttrs(span, response) {
+    const content = response.content;
+    if (content) {
+        const outputMsgs = convertAnthropicOutput(content);
+        if (outputMsgs.length > 0) {
+            span.setAttribute("gen_ai.output.messages", serializeMessages(outputMsgs));
+        }
+    }
+    if (response.id)
+        span.setAttribute("gen_ai.response.id", String(response.id));
+    if (response.model)
+        span.setAttribute("gen_ai.response.model", String(response.model));
+    const usage = response.usage;
+    if (usage) {
+        if (usage.input_tokens != null)
+            span.setAttribute("gen_ai.usage.input_tokens", usage.input_tokens);
+        if (usage.output_tokens != null)
+            span.setAttribute("gen_ai.usage.output_tokens", usage.output_tokens);
+        if (usage.cache_read_input_tokens != null)
+            span.setAttribute("gen_ai.usage.cache_read.input_tokens", usage.cache_read_input_tokens);
+        if (usage.cache_creation_input_tokens != null)
+            span.setAttribute("gen_ai.usage.cache_creation.input_tokens", usage.cache_creation_input_tokens);
+    }
+    span.setStatus({ code: SpanStatusCode.OK });
+}
+class TracedStream {
+    inner;
+    span;
+    blocks = [];
+    currentBlock = null;
+    responseId = null;
+    responseModel = null;
+    inputTokens = 0;
+    outputTokens = 0;
+    cacheReadInputTokens = 0;
+    cacheCreationInputTokens = 0;
+    finalized = false;
+    constructor(inner, span) {
+        this.inner = inner;
+        this.span = span;
+    }
+    async *[Symbol.asyncIterator]() {
+        try {
+            for await (const event of this.inner) {
+                this.processEvent(event);
+                yield event;
+            }
+        }
+        finally {
+            this.finalize();
+        }
+    }
+    processEvent(event) {
+        if (event.type === "message_start" && event.message) {
+            this.responseId = event.message.id || null;
+            this.responseModel = event.message.model || null;
+            const usage = event.message.usage;
+            if (usage) {
+                this.inputTokens = usage.input_tokens || 0;
+                this.cacheReadInputTokens = usage.cache_read_input_tokens || 0;
+                this.cacheCreationInputTokens = usage.cache_creation_input_tokens || 0;
+            }
+        }
+        else if (event.type === "content_block_start" && event.content_block) {
+            const bt = event.content_block.type || "";
+            this.currentBlock = { type: bt };
+            if (bt === "thinking") {
+                this.currentBlock.thinking = "";
+                this.currentBlock.signature = "";
+            }
+            else if (bt === "text") {
+                this.currentBlock.text = "";
+            }
+        }
+        else if (event.type === "content_block_delta" && event.delta) {
+            if (!this.currentBlock)
+                return;
+            const dt = event.delta.type || "";
+            if (dt === "thinking_delta") {
+                this.currentBlock.thinking =
+                    (this.currentBlock.thinking || "") +
+                        (event.delta.thinking || "");
+            }
+            else if (dt === "text_delta") {
+                this.currentBlock.text =
+                    (this.currentBlock.text || "") +
+                        (event.delta.text || "");
+            }
+            else if (dt === "signature_delta") {
+                this.currentBlock.signature =
+                    (this.currentBlock.signature || "") +
+                        (event.delta.signature || "");
+            }
+        }
+        else if (event.type === "content_block_stop") {
+            if (this.currentBlock) {
+                this.blocks.push(this.currentBlock);
+                this.currentBlock = null;
+            }
+        }
+        else if (event.type === "message_delta") {
+            const usage = event.usage;
+            if (usage)
+                this.outputTokens = usage.output_tokens || 0;
+        }
+    }
+    finalize() {
+        if (this.finalized)
+            return;
+        this.finalized = true;
+        if (this.blocks.length > 0) {
+            const outputMsgs = convertAnthropicOutput(this.blocks);
+            if (outputMsgs.length > 0) {
+                this.span.setAttribute("gen_ai.output.messages", serializeMessages(outputMsgs));
+            }
+        }
+        if (this.responseId)
+            this.span.setAttribute("gen_ai.response.id", this.responseId);
+        if (this.responseModel)
+            this.span.setAttribute("gen_ai.response.model", this.responseModel);
+        if (this.inputTokens)
+            this.span.setAttribute("gen_ai.usage.input_tokens", this.inputTokens);
+        if (this.outputTokens)
+            this.span.setAttribute("gen_ai.usage.output_tokens", this.outputTokens);
+        if (this.cacheReadInputTokens)
+            this.span.setAttribute("gen_ai.usage.cache_read.input_tokens", this.cacheReadInputTokens);
+        if (this.cacheCreationInputTokens)
+            this.span.setAttribute("gen_ai.usage.cache_creation.input_tokens", this.cacheCreationInputTokens);
+        this.span.setStatus({ code: SpanStatusCode.OK });
+        this.span.end();
+    }
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Traced wrapper around `client.messages.create(kwargs)`.
+ * Creates a gen_ai span with full Anthropic response including thinking blocks.
+ */
+export async function tracedMessagesCreate(tracer, client, kwargs, conversationId) {
+    const { span } = startSpan(tracer, kwargs.model || "unknown", conversationId);
+    try {
+        setRequestAttrs(span, kwargs);
+        const response = (await client.messages.create(kwargs));
+        setResponseAttrs(span, response);
+        return response;
+    }
+    catch (e) {
+        span.setStatus({
+            code: SpanStatusCode.ERROR,
+            message: String(e),
+        });
+        throw e;
+    }
+    finally {
+        span.end();
+    }
+}
+/**
+ * Auto-instrumentor that patches `Anthropic.messages.create` to add tracing.
+ *
+ * Captures all content blocks including thinking (extended thinking) with
+ * signatures. Supports both non-streaming and streaming calls.
+ */
+/**
+ * Auto-instrumentor that wraps an Anthropic client instance to add tracing.
+ *
+ * Captures all content blocks including thinking (extended thinking) with
+ * signatures. Supports both non-streaming and streaming calls.
+ */
+export class AnthropicInstrumentor {
+    tracer = null;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    patchedClients = [];
+    conversationId;
+    instrument(opts) {
+        const { client } = opts;
+        if (!client?.messages?.create) {
+            throw new Error("Invalid client — pass an Anthropic client instance (new Anthropic())");
+        }
+        this.conversationId = opts.conversationId ?? crypto.randomUUID();
+        const provider = opts.tracerProvider ?? trace.getTracerProvider();
+        this.tracer = provider.getTracer("introspection-anthropic");
+        const origCreate = client.messages.create.bind(client.messages);
+        this.patchedClients.push({ client, originalCreate: origCreate });
+        const tracer = this.tracer;
+        const defaultConversationId = this.conversationId;
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        client.messages.create = function (...args) {
+            const kwargs = args[0];
+            const isStream = kwargs?.stream === true;
+            // Baggage on the active context overrides the conversation ID bound
+            // at instrument() time, so callers can wrap a request in
+            // IntrospectionClient.withConversation() to scope a single call to a
+            // distinct conversation without re-instrumenting the client.
+            const baggage = propagation.getBaggage(otelContext.active());
+            const baggageConvId = baggage?.getEntry("gen_ai.conversation.id")?.value;
+            const baggageAgentName = baggage?.getEntry("gen_ai.agent.name")?.value;
+            const baggageAgentId = baggage?.getEntry("gen_ai.agent.id")?.value;
+            const { span } = startSpan(tracer, kwargs?.model || "unknown", baggageConvId ?? defaultConversationId);
+            if (baggageAgentName) {
+                span.setAttribute("gen_ai.agent.name", baggageAgentName);
+            }
+            if (baggageAgentId) {
+                span.setAttribute("gen_ai.agent.id", baggageAgentId);
+            }
+            setRequestAttrs(span, kwargs || {});
+            if (isStream) {
+                const streamPromise = origCreate(...args);
+                return streamPromise.then((stream) => new TracedStream(stream, span), (err) => {
+                    span.setStatus({
+                        code: SpanStatusCode.ERROR,
+                        message: String(err),
+                    });
+                    span.end();
+                    throw err;
+                });
+            }
+            const resultPromise = origCreate(...args);
+            return resultPromise.then((response) => {
+                setResponseAttrs(span, response);
+                span.end();
+                return response;
+            }, (err) => {
+                span.setStatus({
+                    code: SpanStatusCode.ERROR,
+                    message: String(err),
+                });
+                span.end();
+                throw err;
+            });
+        };
+    }
+    uninstrument() {
+        for (const { client, originalCreate } of this.patchedClients) {
+            client.messages.create = originalCreate;
+        }
+        this.patchedClients = [];
+        this.tracer = null;
+    }
+}
+//# sourceMappingURL=anthropic.js.map