@introspection-sdk/introspection-node 0.7.1 → 0.8.0

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.
  *
@@ -63,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,

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/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) {