@introspection-sdk/introspection-node 0.7.0 → 0.7.2

package/src/converters/openinference.ts

@@ -121,11 +121,6 @@ function extractResponseId(attrs: Attributes): string | undefined {
   }
 }
 
-/** Local extended tool definition that includes the optional `type` field from OpenInference. */
-interface OIToolDefinition extends ToolDefinition {
-  type?: string;
-}
-
 function extractSystemInstructions(
   attrs: Attributes,
 ): SystemInstruction[] | undefined {
@@ -160,7 +155,7 @@ function extractSystemInstructions(
 function extractToolDefinitions(
   attrs: Attributes,
 ): ToolDefinition[] | undefined {
-  const tools: OIToolDefinition[] = [];
+  const tools: ToolDefinition[] = [];
 
   for (const [key, value] of Object.entries(attrs)) {
     const match = key.match(/^llm\.tools\.(\d+)\.tool\.json_schema$/);
@@ -315,7 +310,7 @@ function extractOutputMessages(attrs: Attributes): OutputMessage[] | undefined {
             const parsed = JSON.parse(toolArgs) as Record<string, unknown>;
             if (typeof parsed.thinking === "string" && parsed.thinking) {
               const reasoningPart: ReasoningPart = {
-                type: "thinking",
+                type: "reasoning",
                 content: parsed.thinking,
               };
               parts.push(reasoningPart);
@@ -385,8 +380,8 @@ export function convertOpenInferenceToGenAI(
   const model = extractModel(attrs);
   if (model) result.requestModel = model;
 
-  const system = extractSystem(attrs);
-  if (system) result.system = system;
+  const providerName = extractSystem(attrs);
+  if (providerName) result.providerName = providerName;
 
   const responseId = extractResponseId(attrs);
   if (responseId) result.responseId = responseId;

package/src/converters/vercel.ts

@@ -90,14 +90,14 @@ export function convertVercelAIToGenAI(
     result["gen_ai.conversation.id"] = metadataConvId;
   }
 
-  // gen_ai.request.model and gen_ai.system from ai.model.*
+  // gen_ai.request.model and gen_ai.provider.name from ai.model.*
   const modelId = attrs["ai.model.id"];
   if (typeof modelId === "string" && !attrs["gen_ai.request.model"]) {
     result["gen_ai.request.model"] = modelId;
   }
   const modelProvider = attrs["ai.model.provider"];
-  if (typeof modelProvider === "string" && !attrs["gen_ai.system"]) {
-    result["gen_ai.system"] = modelProvider;
+  if (typeof modelProvider === "string" && !attrs["gen_ai.provider.name"]) {
+    result["gen_ai.provider.name"] = modelProvider;
   }
 
   // Vercel AI SDK stores prompt data in two formats:
@@ -141,7 +141,7 @@ export function convertVercelAIToGenAI(
   if (typeof responseText === "string" && responseText) {
     const parts: GenAIPart[] = [];
     if (typeof responseReasoning === "string" && responseReasoning) {
-      parts.push({ type: "thinking", content: responseReasoning });
+      parts.push({ type: "reasoning", content: responseReasoning });
     }
     parts.push({ type: "text", content: responseText });
     result["gen_ai.output.messages"] = JSON.stringify([

package/src/otel/anthropic.ts

@@ -32,8 +32,7 @@ import {
   SpanKind,
   SpanStatusCode,
 } from "@opentelemetry/api";
-import type { Tracer, Span } from "@opentelemetry/api";
-import type { BasicTracerProvider } from "@opentelemetry/sdk-trace-base";
+import type { Tracer, Span, TracerProvider } from "@opentelemetry/api";
 
 // ---------------------------------------------------------------------------
 // Converters
@@ -51,8 +50,8 @@ function blockToParts(block: Record<string, unknown>): MessagePart[] {
 
   if (bt === "thinking") {
     const part: ReasoningPart = {
-      type: "thinking",
-      content: (block.thinking as string) || undefined,
+      type: "reasoning",
+      content: (block.thinking as string) || REDACTED_THINKING_CONTENT,
       signature: (block.signature as string) || undefined,
       provider_name: "anthropic",
     };
@@ -62,11 +61,11 @@ function blockToParts(block: Record<string, unknown>): MessagePart[] {
   if (bt === "redacted_thinking") {
     return [
       {
-        type: "thinking",
+        type: "reasoning",
         content: REDACTED_THINKING_CONTENT,
         signature: (block.data as string) || undefined,
         provider_name: "anthropic",
-      } as ReasoningPart,
+      },
     ];
   }
 
@@ -169,7 +168,6 @@ function startSpan(
   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,
@@ -535,7 +533,7 @@ export class AnthropicInstrumentor {
   private conversationId: string | undefined;
 
   instrument(opts: {
-    tracerProvider?: BasicTracerProvider;
+    tracerProvider?: TracerProvider;
     /** The Anthropic client instance to instrument. */
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     client: any;
@@ -557,9 +555,7 @@ export class AnthropicInstrumentor {
     this.conversationId = opts.conversationId ?? crypto.randomUUID();
 
     const provider = opts.tracerProvider ?? trace.getTracerProvider();
-    this.tracer = (provider as BasicTracerProvider).getTracer(
-      "introspection-anthropic",
-    );
+    this.tracer = provider.getTracer("introspection-anthropic");
 
     const origCreate = client.messages.create.bind(client.messages);
     this.patchedClients.push({ client, originalCreate: origCreate });
@@ -582,7 +578,7 @@ export class AnthropicInstrumentor {
   instrumentClass(opts: {
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     anthropic: any;
-    tracerProvider?: BasicTracerProvider;
+    tracerProvider?: TracerProvider;
     conversationId?: string;
   }): void {
     const Messages = opts.anthropic?.Messages;
@@ -596,9 +592,7 @@ export class AnthropicInstrumentor {
 
     this.conversationId = opts.conversationId ?? crypto.randomUUID();
     const provider = opts.tracerProvider ?? trace.getTracerProvider();
-    this.tracer = (provider as BasicTracerProvider).getTracer(
-      "introspection-anthropic",
-    );
+    this.tracer = provider.getTracer("introspection-anthropic");
 
     const origCreate = proto.create;
     const patched = buildTracedCreate(

package/src/otel/claude-hooks.ts

@@ -295,8 +295,8 @@ export interface IntrospectionClaudeHooksOptions {
  * Provides instrumented hooks for Claude Agent SDK.
  *
  * Creates OpenTelemetry spans with gen_ai.* semantic convention attributes:
- * - Session spans: gen_ai.system, gen_ai.request.model
- * - Tool spans: gen_ai.tool.name, gen_ai.tool.input, gen_ai.tool.output
+ * - Session spans: gen_ai.provider.name, gen_ai.request.model
+ * - Tool spans: gen_ai.tool.name, gen_ai.tool.call.arguments, gen_ai.tool.call.result
  * - Subagent spans: gen_ai.agent.name
  *
  * Usage tracking is captured from streamed messages via recordUsage().
@@ -689,7 +689,7 @@ export class IntrospectionClaudeHooks {
     logger.debug(`Starting session span from init message: ${sessionId}`);
     const ids = this._resolveIdentity(sessionId);
     const attrs: Attributes = {
-      "gen_ai.system": "anthropic",
+      "gen_ai.provider.name": "anthropic",
       "gen_ai.operation.name": "chat",
       "gen_ai.agent.name": ids.agentName,
       "gen_ai.conversation.id": ids.conversationId,
@@ -835,7 +835,7 @@ export class IntrospectionClaudeHooks {
     // when the caller wrapped the query in withAgent() / withConversation().
     const ids = this._resolveIdentity(sessionInput.session_id);
     const attrs: Attributes = {
-      "gen_ai.system": "anthropic",
+      "gen_ai.provider.name": "anthropic",
       "gen_ai.operation.name": "chat",
       "gen_ai.agent.name": ids.agentName,
       "gen_ai.conversation.id": ids.conversationId,
@@ -952,11 +952,14 @@ export class IntrospectionClaudeHooks {
       : undefined;
 
     const span = this._tracer.startSpan(
-      `tool.${toolInput.tool_name}`,
+      `execute_tool ${toolInput.tool_name}`,
       {
         kind: SpanKind.INTERNAL,
         attributes: {
+          "gen_ai.operation.name": "execute_tool",
           "gen_ai.tool.name": toolInput.tool_name,
+          "gen_ai.tool.type": "function",
+          "gen_ai.tool.call.id": toolInput.tool_use_id,
           "claude.session_id": toolInput.session_id,
           "claude.tool_use_id": toolInput.tool_use_id,
         },
@@ -967,11 +970,14 @@ export class IntrospectionClaudeHooks {
     if (toolInput.tool_input) {
       try {
         span.setAttribute(
-          "gen_ai.tool.input",
+          "gen_ai.tool.call.arguments",
           JSON.stringify(toolInput.tool_input),
         );
       } catch {
-        span.setAttribute("gen_ai.tool.input", String(toolInput.tool_input));
+        span.setAttribute(
+          "gen_ai.tool.call.arguments",
+          String(toolInput.tool_input),
+        );
       }
     }
 
@@ -998,17 +1004,16 @@ export class IntrospectionClaudeHooks {
       if (toolInput.tool_response !== undefined) {
         try {
           span.setAttribute(
-            "gen_ai.tool.output",
+            "gen_ai.tool.call.result",
             JSON.stringify(toolInput.tool_response),
           );
         } catch {
           span.setAttribute(
-            "gen_ai.tool.output",
+            "gen_ai.tool.call.result",
             String(toolInput.tool_response),
           );
         }
       }
-      span.setStatus({ code: SpanStatusCode.OK });
       span.end();
       this._toolSpans.delete(toolInput.tool_use_id);
     }

package/src/otel/gemini.ts

@@ -2,7 +2,7 @@
  * Lightweight Google Gemini (`@google/genai`) instrumentor for Introspection SDK.
  *
  * Captures the full Gemini response including per-part `thoughtSignature`
- * payloads (Gemini 3.x extended thinking) as gen_ai `thinking` parts with
+ * payloads (Gemini 3.x extended thinking) as gen_ai `reasoning` parts with
  * `signature` set — mirroring how the {@link AnthropicInstrumentor} captures
  * Anthropic thinking blocks.
  *
@@ -23,8 +23,7 @@
  */
 
 import { trace, SpanKind, SpanStatusCode } from "@opentelemetry/api";
-import type { Tracer, Span } from "@opentelemetry/api";
-import type { BasicTracerProvider } from "@opentelemetry/sdk-trace-base";
+import type { Tracer, Span, TracerProvider } from "@opentelemetry/api";
 
 import type { InputMessage, OutputMessage } from "@introspection-sdk/types";
 import { providerCostAttributes } from "@introspection-sdk/types";
@@ -64,7 +63,6 @@ function startSpan(
   return tracer.startSpan("chat", {
     kind: SpanKind.CLIENT,
     attributes: {
-      "gen_ai.system": GEMINI_PROVIDER_NAME,
       "gen_ai.provider.name": GEMINI_PROVIDER_NAME,
       "gen_ai.operation.name": "chat",
       "gen_ai.request.model": model,
@@ -374,7 +372,7 @@ export class GeminiInstrumentor {
   private conversationId: string | undefined;
 
   instrument(opts: {
-    tracerProvider?: BasicTracerProvider;
+    tracerProvider?: TracerProvider;
     /** A `@google/genai` `GoogleGenAI` client instance. */
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     client: any;
@@ -394,9 +392,7 @@ export class GeminiInstrumentor {
     this.conversationId = opts.conversationId ?? crypto.randomUUID();
 
     const provider = opts.tracerProvider ?? trace.getTracerProvider();
-    this.tracer = (provider as BasicTracerProvider).getTracer(
-      "introspection-gemini",
-    );
+    this.tracer = provider.getTracer("introspection-gemini");
     const tracer = this.tracer;
     const conversationId = this.conversationId;
 
@@ -436,7 +432,7 @@ export class GeminiInstrumentor {
   instrumentClass(opts: {
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     genai: any;
-    tracerProvider?: BasicTracerProvider;
+    tracerProvider?: TracerProvider;
     conversationId?: string;
   }): void {
     const proto = opts.genai?.Models?.prototype;
@@ -449,9 +445,7 @@ export class GeminiInstrumentor {
 
     this.conversationId = opts.conversationId ?? crypto.randomUUID();
     const provider = opts.tracerProvider ?? trace.getTracerProvider();
-    this.tracer = (provider as BasicTracerProvider).getTracer(
-      "introspection-gemini",
-    );
+    this.tracer = provider.getTracer("introspection-gemini");
     const conversationId = this.conversationId;
 
     const origGenerate = proto.generateContentInternal;

package/src/otel/langchain-handler.ts

@@ -317,7 +317,7 @@ export class IntrospectionCallbackHandler extends BaseCallbackHandler {
 
     const provider = this._extractProvider(llm);
     if (provider) {
-      otelSpan.setAttribute("gen_ai.system", provider);
+      otelSpan.setAttribute("gen_ai.provider.name", provider);
     }
 
     const invocationParams = extraParams?.["invocation_params"] as
@@ -571,15 +571,22 @@ export class IntrospectionCallbackHandler extends BaseCallbackHandler {
     const toolName =
       runName || tool?.name || tool?.id?.[tool.id.length - 1] || "tool";
 
-    const otelSpan = this._createChildSpan(toolName, runId, parentRunId);
+    const otelSpan = this._createChildSpan(
+      `execute_tool ${toolName}`,
+      runId,
+      parentRunId,
+    );
     this._spans.set(runId, otelSpan);
 
     const conversationId = this._getConversationId(metadata);
     this._setRootConversationId(conversationId, runId, parentRunId);
 
+    otelSpan.setAttribute("gen_ai.operation.name", "execute_tool");
     otelSpan.setAttribute("gen_ai.tool.name", toolName);
+    otelSpan.setAttribute("gen_ai.tool.type", "function");
+    otelSpan.setAttribute("gen_ai.tool.call.id", runId);
     otelSpan.setAttribute("openinference.span.kind", "TOOL");
-    otelSpan.setAttribute("gen_ai.tool.input", input);
+    otelSpan.setAttribute("gen_ai.tool.call.arguments", input);
     otelSpan.setAttribute("gen_ai.conversation.id", conversationId);
   }
 
@@ -591,7 +598,7 @@ export class IntrospectionCallbackHandler extends BaseCallbackHandler {
 
     if (output != null) {
       otelSpan.setAttribute(
-        "gen_ai.tool.output",
+        "gen_ai.tool.call.result",
         typeof output === "string" ? output : JSON.stringify(output),
       );
     }

package/src/otel/logs.ts

@@ -113,7 +113,8 @@ export class IntrospectionLogs {
       }),
     );
 
-    const processor = new BatchLogRecordProcessor(exporter, {
+    const processor = new BatchLogRecordProcessor({
+      exporter,
       maxQueueSize: options.maxBatchSize ?? 100,
       scheduledDelayMillis: options.flushInterval ?? 5000,
     });

package/src/otel/mastra-exporter.ts

@@ -358,7 +358,7 @@ export class IntrospectionMastraExporter extends BaseExporter {
     otelSpan.setAttribute("openinference.span.kind", "LLM");
 
     if (model) otelSpan.setAttribute("gen_ai.request.model", model);
-    if (provider) otelSpan.setAttribute("gen_ai.system", provider);
+    if (provider) otelSpan.setAttribute("gen_ai.provider.name", provider);
     if (responseModel)
       otelSpan.setAttribute("gen_ai.response.model", responseModel);
     if (responseId) otelSpan.setAttribute("gen_ai.response.id", responseId);
@@ -481,14 +481,16 @@ export class IntrospectionMastraExporter extends BaseExporter {
     const conversationId = this._getConversationId(span);
     const toolName = span.entityName || span.name || "tool";
 
-    const otelSpan = this._createSpan(span, toolName);
+    const otelSpan = this._createSpan(span, `execute_tool ${toolName}`);
+    otelSpan.setAttribute("gen_ai.operation.name", "execute_tool");
     otelSpan.setAttribute("gen_ai.tool.name", toolName);
+    otelSpan.setAttribute("gen_ai.tool.type", "function");
     otelSpan.setAttribute("gen_ai.conversation.id", conversationId);
     otelSpan.setAttribute("openinference.span.kind", "TOOL");
 
     if (span.input != null) {
       otelSpan.setAttribute(
-        "gen_ai.tool.input",
+        "gen_ai.tool.call.arguments",
         typeof span.input === "string"
           ? span.input
           : JSON.stringify(span.input),
@@ -496,7 +498,7 @@ export class IntrospectionMastraExporter extends BaseExporter {
     }
     if (span.output != null) {
       otelSpan.setAttribute(
-        "gen_ai.tool.output",
+        "gen_ai.tool.call.result",
         typeof span.output === "string"
           ? span.output
           : JSON.stringify(span.output),
@@ -600,7 +602,7 @@ export class IntrospectionMastraExporter extends BaseExporter {
       if (Array.isArray(out.reasoning)) {
         for (const r of out.reasoning as Record<string, unknown>[]) {
           const text = (r.text || r.content || "") as string;
-          if (text) parts.push({ type: "thinking", content: text });
+          if (text) parts.push({ type: "reasoning", content: text });
         }
       }
 

package/src/otel/span-processor.ts

@@ -308,7 +308,7 @@ export class IntrospectionSpanProcessor implements SpanProcessor {
     const hasGenAi =
       isOI ||
       isVercel ||
-      span.attributes["gen_ai.system"] != null ||
+      span.attributes["gen_ai.provider.name"] != null ||
       span.attributes["gen_ai.operation.name"] != null ||
       span.attributes["gen_ai.request.model"] != null ||
       span.attributes["gen_ai.input.messages"] != null ||
@@ -333,7 +333,7 @@ export class IntrospectionSpanProcessor implements SpanProcessor {
           if (
             key === "gen_ai.output.messages" &&
             typeof value === "string" &&
-            value.includes('"thinking"')
+            value.includes('"reasoning"')
           ) {
             attrs[key] = value;
           } else if (attrs[key] === undefined) {
@@ -351,6 +351,7 @@ export class IntrospectionSpanProcessor implements SpanProcessor {
     } else {
       attrs = { ...span.attributes };
     }
+    delete attrs["gen_ai.system"];
 
     // Read baggage from active context
     const baggage = propagation.getBaggage(otelContext.active());

package/src/otel/tracing-processor.ts

@@ -97,7 +97,7 @@ export interface IntrospectionTracingProcessorOptions {
  *
  * Extracts OTel Gen AI semantic convention attributes from span data:
  * - Agent spans: `gen_ai.agent.name`, `gen_ai.tool.definitions`, `gen_ai.agent.handoffs`
- * - Function spans: `gen_ai.tool.name`, `gen_ai.tool.input`, `gen_ai.tool.output`
+ * - Function spans: `gen_ai.tool.name`, `gen_ai.tool.call.arguments`, `gen_ai.tool.call.result`
  * - Response spans: `gen_ai.input/output.messages`, `gen_ai.usage.*`, `gen_ai.request.model`
  * - Generation spans: `gen_ai.request.model`, `gen_ai.usage.*`
  * - Handoff spans: `gen_ai.handoff.from_agent`, `gen_ai.handoff.to_agent`
@@ -336,12 +336,15 @@ export class IntrospectionTracingProcessor implements TracingProcessor {
    */
   private _processAgentSpan(otelSpan: OtelSpan, spanData: AgentSpanData): void {
     otelSpan.setAttribute("gen_ai.agent.name", spanData.name);
-    otelSpan.setAttribute("gen_ai.system", "openai");
+    otelSpan.setAttribute("gen_ai.provider.name", "openai");
     otelSpan.setAttribute("openinference.span.kind", "AGENT");
 
     if (spanData.tools) {
       // Wrap tool names as objects for ClickHouse Array(JSON) compatibility
-      const toolDefs = spanData.tools.map((t: string) => ({ name: t }));
+      const toolDefs = spanData.tools.map((t: string) => ({
+        type: "function",
+        name: t,
+      }));
       otelSpan.setAttribute(
         "gen_ai.tool.definitions",
         JSON.stringify(toolDefs),
@@ -367,15 +370,18 @@ export class IntrospectionTracingProcessor implements TracingProcessor {
     otelSpan: OtelSpan,
     spanData: FunctionSpanData,
   ): void {
+    otelSpan.updateName(`execute_tool ${spanData.name}`);
+    otelSpan.setAttribute("gen_ai.operation.name", "execute_tool");
     otelSpan.setAttribute("gen_ai.tool.name", spanData.name);
+    otelSpan.setAttribute("gen_ai.tool.type", "function");
     otelSpan.setAttribute("openinference.span.kind", "TOOL");
 
     if (spanData.input) {
-      otelSpan.setAttribute("gen_ai.tool.input", spanData.input);
+      otelSpan.setAttribute("gen_ai.tool.call.arguments", spanData.input);
     }
 
     if (spanData.output) {
-      otelSpan.setAttribute("gen_ai.tool.output", String(spanData.output));
+      otelSpan.setAttribute("gen_ai.tool.call.result", String(spanData.output));
     }
   }
 
@@ -388,7 +394,7 @@ export class IntrospectionTracingProcessor implements TracingProcessor {
     spanData: ResponseSpanData,
   ): void {
     otelSpan.setAttribute("gen_ai.operation.name", "chat");
-    otelSpan.setAttribute("gen_ai.system", "openai");
+    otelSpan.setAttribute("gen_ai.provider.name", "openai");
     otelSpan.setAttribute("openinference.span.kind", "LLM");
 
     // Response ID (from span_data directly)
@@ -494,7 +500,7 @@ export class IntrospectionTracingProcessor implements TracingProcessor {
     spanData: GenerationSpanData,
   ): void {
     otelSpan.setAttribute("gen_ai.operation.name", "chat");
-    otelSpan.setAttribute("gen_ai.system", "openai");
+    otelSpan.setAttribute("gen_ai.provider.name", "openai");
     otelSpan.setAttribute("openinference.span.kind", "LLM");
 
     if (spanData.model) {