@ai-sdk/otel 1.0.147 → 1.0.149

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/otel",
-  "version": "1.0.147",
+  "version": "1.0.149",
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,
@@ -26,12 +26,12 @@
     }
   },
   "dependencies": {
-    "@ai-sdk/provider": "4.0.31",
+    "@ai-sdk/provider": "4.0.32",
     "@opentelemetry/api": "1.9.1",
-    "ai": "7.0.147"
+    "ai": "7.0.149"
   },
   "devDependencies": {
-    "@ai-sdk/provider-utils": "5.0.64",
+    "@ai-sdk/provider-utils": "5.0.66",
     "@opentelemetry/sdk-trace-base": "2.7.1",
     "@types/node": "22.19.19",
     "@vercel/ai-tsconfig": "0.0.0",

package/src/open-telemetry.ts

@@ -125,11 +125,13 @@ export class OpenTelemetry implements Telemetry {
   private readonly callStates = new Map<string, CallState>();
 
   private readonly tracer: Tracer;
+  private readonly agentSpanName: OpenTelemetryOptions['agentSpanName'];
   private readonly supplementalAttributes: SupplementalAttributeOptions;
   private readonly enrichSpan: EnrichSpan | undefined;
 
   constructor(options: OpenTelemetryOptions = {}) {
     this.tracer = options.tracer ?? trace.getTracer('gen_ai');
+    this.agentSpanName = options.agentSpanName;
     this.supplementalAttributes = normalizeSupplementalAttributes(options);
     this.enrichSpan = options.enrichSpan;
   }
@@ -142,6 +144,37 @@ export class OpenTelemetry implements Telemetry {
     this.callStates.delete(callId);
   }
 
+  private getAgentSpanName({
+    operationName,
+    modelId,
+    functionId,
+  }: {
+    operationName: string;
+    modelId: string;
+    functionId: string | undefined;
+  }): string {
+    const defaultName = `${operationName} ${modelId}`;
+
+    // Other operations, such as harness turns, share the generation handler.
+    if (operationName !== 'invoke_agent') {
+      return defaultName;
+    }
+
+    if (this.agentSpanName === 'functionId') {
+      return `invoke_agent ${functionId ?? modelId}`;
+    }
+
+    if (typeof this.agentSpanName === 'function') {
+      try {
+        return this.agentSpanName({ modelId, functionId }) ?? defaultName;
+      } catch {
+        return defaultName;
+      }
+    }
+
+    return defaultName;
+  }
+
   private getSpanAttributes({
     attributes,
     spanType,
@@ -429,7 +462,11 @@ export class OpenTelemetry implements Telemetry {
       ...baseSupplementalAttributes,
     });
 
-    const spanName = `${operationName} ${event.modelId}`;
+    const spanName = this.getAgentSpanName({
+      operationName,
+      modelId: event.modelId,
+      functionId: telemetry.functionId,
+    });
     const rootSpan = this.tracer.startSpan(spanName, {
       attributes: this.getSpanAttributes({
         attributes,
@@ -536,7 +573,11 @@ export class OpenTelemetry implements Telemetry {
       }),
     });
 
-    const spanName = `${operationName} ${event.modelId}`;
+    const spanName = this.getAgentSpanName({
+      operationName,
+      modelId: event.modelId,
+      functionId: telemetry.functionId,
+    });
     const rootSpan = this.tracer.startSpan(spanName, {
       attributes: this.getSpanAttributes({
         attributes,

package/src/supplemental-attributes.ts

@@ -44,6 +44,24 @@ export type OpenTelemetryOptions = {
    */
   tracer?: Tracer;
 
+  /**
+   * Controls root agent span names for text and object generation.
+   *
+   * With `modelId` (the default), names are `invoke_agent {modelId}`.
+   * With `functionId`, names are `invoke_agent {functionId}`, falling back to
+   * the model ID when no function ID is provided.
+   *
+   * A callback returns the complete span name. If it returns `undefined` or
+   * throws, the default model-based name is used.
+   */
+  agentSpanName?:
+    | 'modelId'
+    | 'functionId'
+    | ((options: {
+        modelId: string;
+        functionId: string | undefined;
+      }) => string | undefined);
+
   /**
    * Adds custom attributes to spans when they are created. These attributes are
    * not AI SDK-owned semantics and are intended for observability integrations.