fix(core): Improve Vercel AI SDK instrumentation attributes

.size-limit.js

@@ -326,7 +326,7 @@ module.exports = [
     import: createImport('init'),
     ignore: [...builtinModules, ...nodePrefixedBuiltinModules],
     gzip: true,
-    limit: '175 KB',
+    limit: '176 KB',
   },
   {
     name: '@sentry/node - without tracing',

dev-packages/e2e-tests/test-applications/nextjs-15/tests/ai-test.test.ts

@@ -34,14 +34,14 @@ test('should create AI spans with correct attributes', async ({ page }) => {
   expect(firstPipelineSpan?.data?.['vercel.ai.model.id']).toBe('mock-model-id');
   expect(firstPipelineSpan?.data?.['vercel.ai.model.provider']).toBe('mock-provider');
   expect(firstPipelineSpan?.data?.['vercel.ai.prompt']).toContain('Where is the first span?');
-  expect(firstPipelineSpan?.data?.['gen_ai.response.text']).toBe('First span here!');
+  expect(firstPipelineSpan?.data?.['gen_ai.output.messages']).toContain('First span here!');
   expect(firstPipelineSpan?.data?.['gen_ai.usage.input_tokens']).toBe(10);
   expect(firstPipelineSpan?.data?.['gen_ai.usage.output_tokens']).toBe(20); */
 
   // Second AI call - explicitly enabled telemetry
   const secondPipelineSpan = aiPipelineSpans[0];
   expect(secondPipelineSpan?.data?.['vercel.ai.prompt']).toContain('Where is the second span?');
-  expect(secondPipelineSpan?.data?.['gen_ai.response.text']).toContain('Second span here!');
+  expect(secondPipelineSpan?.data?.['gen_ai.output.messages']).toContain('Second span here!');
 
   // Third AI call - with tool calls
   /*  const thirdPipelineSpan = aiPipelineSpans[2];

dev-packages/e2e-tests/test-applications/nextjs-16/tests/ai-test.test.ts

@@ -34,14 +34,14 @@ test('should create AI spans with correct attributes', async ({ page }) => {
   expect(firstPipelineSpan?.data?.['vercel.ai.model.id']).toBe('mock-model-id');
   expect(firstPipelineSpan?.data?.['vercel.ai.model.provider']).toBe('mock-provider');
   expect(firstPipelineSpan?.data?.['vercel.ai.prompt']).toContain('Where is the first span?');
-  expect(firstPipelineSpan?.data?.['gen_ai.response.text']).toBe('First span here!');
+  expect(firstPipelineSpan?.data?.['gen_ai.output.messages']).toContain('First span here!');
   expect(firstPipelineSpan?.data?.['gen_ai.usage.input_tokens']).toBe(10);
   expect(firstPipelineSpan?.data?.['gen_ai.usage.output_tokens']).toBe(20); */
 
   // Second AI call - explicitly enabled telemetry
   const secondPipelineSpan = aiPipelineSpans[0];
   expect(secondPipelineSpan?.data?.['vercel.ai.prompt']).toContain('Where is the second span?');
-  expect(secondPipelineSpan?.data?.['gen_ai.response.text']).toContain('Second span here!');
+  expect(secondPipelineSpan?.data?.['gen_ai.output.messages']).toContain('Second span here!');
 
   // Third AI call - with tool calls
   /*  const thirdPipelineSpan = aiPipelineSpans[2];

dev-packages/node-integration-tests/suites/tracing/vercelai/scenario.mjs

@@ -51,6 +51,7 @@ async function run() {
       }),
       tools: {
         getWeather: {
+          description: 'Get the current weather for a location',
           parameters: z.object({ location: z.string() }),
           execute: async args => {
             return `Weather in ${args.location}: Sunny, 72°F`;

dev-packages/node-integration-tests/suites/tracing/vercelai/test.ts

@@ -5,16 +5,16 @@ import {
   GEN_AI_INPUT_MESSAGES_ATTRIBUTE,
   GEN_AI_INPUT_MESSAGES_ORIGINAL_LENGTH_ATTRIBUTE,
   GEN_AI_OPERATION_NAME_ATTRIBUTE,
+  GEN_AI_OUTPUT_MESSAGES_ATTRIBUTE,
   GEN_AI_REQUEST_AVAILABLE_TOOLS_ATTRIBUTE,
   GEN_AI_REQUEST_MODEL_ATTRIBUTE,
   GEN_AI_RESPONSE_FINISH_REASONS_ATTRIBUTE,
   GEN_AI_RESPONSE_ID_ATTRIBUTE,
   GEN_AI_RESPONSE_MODEL_ATTRIBUTE,
-  GEN_AI_RESPONSE_TEXT_ATTRIBUTE,
-  GEN_AI_RESPONSE_TOOL_CALLS_ATTRIBUTE,
   GEN_AI_SYSTEM_ATTRIBUTE,
   GEN_AI_SYSTEM_INSTRUCTIONS_ATTRIBUTE,
   GEN_AI_TOOL_CALL_ID_ATTRIBUTE,
+  GEN_AI_TOOL_DESCRIPTION_ATTRIBUTE,
   GEN_AI_TOOL_INPUT_ATTRIBUTE,
   GEN_AI_TOOL_NAME_ATTRIBUTE,
   GEN_AI_TOOL_OUTPUT_ATTRIBUTE,
@@ -91,9 +91,10 @@ describe('Vercel AI integration', () => {
         data: {
           [GEN_AI_INPUT_MESSAGES_ORIGINAL_LENGTH_ATTRIBUTE]: 1,
           [GEN_AI_INPUT_MESSAGES_ATTRIBUTE]: '[{"role":"user","content":"Where is the second span?"}]',
+          [GEN_AI_OUTPUT_MESSAGES_ATTRIBUTE]:
+            '[{"role":"assistant","parts":[{"type":"text","content":"Second span here!"}],"finish_reason":"stop"}]',
           [GEN_AI_REQUEST_MODEL_ATTRIBUTE]: 'mock-model-id',
           [GEN_AI_RESPONSE_MODEL_ATTRIBUTE]: 'mock-model-id',
-          [GEN_AI_RESPONSE_TEXT_ATTRIBUTE]: expect.any(String),
           [GEN_AI_USAGE_INPUT_TOKENS_ATTRIBUTE]: 10,
           [GEN_AI_USAGE_OUTPUT_TOKENS_ATTRIBUTE]: 20,
           [GEN_AI_USAGE_TOTAL_TOKENS_ATTRIBUTE]: 30,
@@ -119,11 +120,12 @@ describe('Vercel AI integration', () => {
         data: {
           [GEN_AI_INPUT_MESSAGES_ATTRIBUTE]: expect.any(String),
           [GEN_AI_INPUT_MESSAGES_ORIGINAL_LENGTH_ATTRIBUTE]: 1,
+          [GEN_AI_OUTPUT_MESSAGES_ATTRIBUTE]:
+            '[{"role":"assistant","parts":[{"type":"text","content":"Second span here!"}],"finish_reason":"stop"}]',
           [GEN_AI_REQUEST_MODEL_ATTRIBUTE]: 'mock-model-id',
           [GEN_AI_RESPONSE_FINISH_REASONS_ATTRIBUTE]: ['stop'],
           [GEN_AI_RESPONSE_ID_ATTRIBUTE]: expect.any(String),
           [GEN_AI_RESPONSE_MODEL_ATTRIBUTE]: 'mock-model-id',
-          [GEN_AI_RESPONSE_TEXT_ATTRIBUTE]: expect.any(String),
           [GEN_AI_SYSTEM_ATTRIBUTE]: 'mock-provider',
           [GEN_AI_USAGE_INPUT_TOKENS_ATTRIBUTE]: 10,
           [GEN_AI_USAGE_OUTPUT_TOKENS_ATTRIBUTE]: 20,
@@ -201,6 +203,7 @@ describe('Vercel AI integration', () => {
         status: 'ok',
       }),
       // Seventh span - tool call execution span
+      // Note: gen_ai.tool.description is NOT present when sendDefaultPii: false because ai.prompt.tools is not recorded
       expect.objectContaining({
         data: {
           [GEN_AI_TOOL_CALL_ID_ATTRIBUTE]: 'call-1',
@@ -220,7 +223,7 @@ describe('Vercel AI integration', () => {
   };
 
   const EXPECTED_AVAILABLE_TOOLS_JSON =
-    '[{"type":"function","name":"getWeather","parameters":{"type":"object","properties":{"location":{"type":"string"}},"required":["location"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}]';
+    '[{"type":"function","name":"getWeather","description":"Get the current weather for a location","parameters":{"type":"object","properties":{"location":{"type":"string"}},"required":["location"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}]';
 
   const EXPECTED_TRANSACTION_DEFAULT_PII_TRUE = {
     transaction: 'main',
@@ -230,9 +233,10 @@ describe('Vercel AI integration', () => {
         data: {
           [GEN_AI_INPUT_MESSAGES_ORIGINAL_LENGTH_ATTRIBUTE]: 1,
           [GEN_AI_INPUT_MESSAGES_ATTRIBUTE]: '[{"role":"user","content":"Where is the first span?"}]',
+          [GEN_AI_OUTPUT_MESSAGES_ATTRIBUTE]:
+            '[{"role":"assistant","parts":[{"type":"text","content":"First span here!"}],"finish_reason":"stop"}]',
           [GEN_AI_REQUEST_MODEL_ATTRIBUTE]: 'mock-model-id',
           [GEN_AI_RESPONSE_MODEL_ATTRIBUTE]: 'mock-model-id',
-          [GEN_AI_RESPONSE_TEXT_ATTRIBUTE]: 'First span here!',
           [GEN_AI_USAGE_INPUT_TOKENS_ATTRIBUTE]: 10,
           [GEN_AI_USAGE_OUTPUT_TOKENS_ATTRIBUTE]: 20,
           [GEN_AI_USAGE_TOTAL_TOKENS_ATTRIBUTE]: 30,
@@ -264,11 +268,12 @@ describe('Vercel AI integration', () => {
           [GEN_AI_INPUT_MESSAGES_ORIGINAL_LENGTH_ATTRIBUTE]: 1,
           [GEN_AI_INPUT_MESSAGES_ATTRIBUTE]:
             '[{"role":"user","content":[{"type":"text","text":"Where is the first span?"}]}]',
+          [GEN_AI_OUTPUT_MESSAGES_ATTRIBUTE]:
+            '[{"role":"assistant","parts":[{"type":"text","content":"First span here!"}],"finish_reason":"stop"}]',
           [GEN_AI_REQUEST_MODEL_ATTRIBUTE]: 'mock-model-id',
           [GEN_AI_RESPONSE_FINISH_REASONS_ATTRIBUTE]: ['stop'],
           [GEN_AI_RESPONSE_ID_ATTRIBUTE]: expect.any(String),
           [GEN_AI_RESPONSE_MODEL_ATTRIBUTE]: 'mock-model-id',
-          [GEN_AI_RESPONSE_TEXT_ATTRIBUTE]: 'First span here!',
           [GEN_AI_SYSTEM_ATTRIBUTE]: 'mock-provider',
           [GEN_AI_USAGE_INPUT_TOKENS_ATTRIBUTE]: 10,
           [GEN_AI_USAGE_OUTPUT_TOKENS_ATTRIBUTE]: 20,
@@ -302,9 +307,10 @@ describe('Vercel AI integration', () => {
         data: {
           [GEN_AI_INPUT_MESSAGES_ORIGINAL_LENGTH_ATTRIBUTE]: 1,
           [GEN_AI_INPUT_MESSAGES_ATTRIBUTE]: '[{"role":"user","content":"Where is the second span?"}]',
+          [GEN_AI_OUTPUT_MESSAGES_ATTRIBUTE]:
+            '[{"role":"assistant","parts":[{"type":"text","content":"Second span here!"}],"finish_reason":"stop"}]',
           [GEN_AI_REQUEST_MODEL_ATTRIBUTE]: 'mock-model-id',
           [GEN_AI_RESPONSE_MODEL_ATTRIBUTE]: 'mock-model-id',
-          [GEN_AI_RESPONSE_TEXT_ATTRIBUTE]: expect.any(String),
           [GEN_AI_USAGE_INPUT_TOKENS_ATTRIBUTE]: 10,
           [GEN_AI_USAGE_OUTPUT_TOKENS_ATTRIBUTE]: 20,
           [GEN_AI_USAGE_TOTAL_TOKENS_ATTRIBUTE]: 30,
@@ -335,11 +341,12 @@ describe('Vercel AI integration', () => {
         data: {
           [GEN_AI_INPUT_MESSAGES_ATTRIBUTE]: expect.any(String),
           [GEN_AI_INPUT_MESSAGES_ORIGINAL_LENGTH_ATTRIBUTE]: 1,
+          [GEN_AI_OUTPUT_MESSAGES_ATTRIBUTE]:
+            '[{"role":"assistant","parts":[{"type":"text","content":"Second span here!"}],"finish_reason":"stop"}]',
           [GEN_AI_REQUEST_MODEL_ATTRIBUTE]: 'mock-model-id',
           [GEN_AI_RESPONSE_FINISH_REASONS_ATTRIBUTE]: ['stop'],
           [GEN_AI_RESPONSE_ID_ATTRIBUTE]: expect.any(String),
           [GEN_AI_RESPONSE_MODEL_ATTRIBUTE]: 'mock-model-id',
-          [GEN_AI_RESPONSE_TEXT_ATTRIBUTE]: expect.any(String),
           [GEN_AI_SYSTEM_ATTRIBUTE]: 'mock-provider',
           [GEN_AI_USAGE_INPUT_TOKENS_ATTRIBUTE]: 10,
           [GEN_AI_USAGE_OUTPUT_TOKENS_ATTRIBUTE]: 20,
@@ -373,10 +380,10 @@ describe('Vercel AI integration', () => {
         data: {
           [GEN_AI_INPUT_MESSAGES_ORIGINAL_LENGTH_ATTRIBUTE]: 1,
           [GEN_AI_INPUT_MESSAGES_ATTRIBUTE]: '[{"role":"user","content":"What is the weather in San Francisco?"}]',
+          [GEN_AI_OUTPUT_MESSAGES_ATTRIBUTE]:
+            '[{"role":"assistant","parts":[{"type":"text","content":"Tool call completed!"},{"type":"tool_call","id":"call-1","name":"getWeather","arguments":"{ \\"location\\": \\"San Francisco\\" }"}],"finish_reason":"tool_call"}]',
           [GEN_AI_REQUEST_MODEL_ATTRIBUTE]: 'mock-model-id',
           [GEN_AI_RESPONSE_MODEL_ATTRIBUTE]: 'mock-model-id',
-          [GEN_AI_RESPONSE_TEXT_ATTRIBUTE]: 'Tool call completed!',
-          [GEN_AI_RESPONSE_TOOL_CALLS_ATTRIBUTE]: expect.any(String),
           [GEN_AI_USAGE_INPUT_TOKENS_ATTRIBUTE]: 15,
           [GEN_AI_USAGE_OUTPUT_TOKENS_ATTRIBUTE]: 25,
           [GEN_AI_USAGE_TOTAL_TOKENS_ATTRIBUTE]: 40,
@@ -408,12 +415,12 @@ describe('Vercel AI integration', () => {
           [GEN_AI_REQUEST_AVAILABLE_TOOLS_ATTRIBUTE]: EXPECTED_AVAILABLE_TOOLS_JSON,
           [GEN_AI_INPUT_MESSAGES_ATTRIBUTE]: expect.any(String),
           [GEN_AI_INPUT_MESSAGES_ORIGINAL_LENGTH_ATTRIBUTE]: 1,
+          [GEN_AI_OUTPUT_MESSAGES_ATTRIBUTE]:
+            '[{"role":"assistant","parts":[{"type":"text","content":"Tool call completed!"},{"type":"tool_call","id":"call-1","name":"getWeather","arguments":"{ \\"location\\": \\"San Francisco\\" }"}],"finish_reason":"tool_call"}]',
           [GEN_AI_REQUEST_MODEL_ATTRIBUTE]: 'mock-model-id',
           [GEN_AI_RESPONSE_FINISH_REASONS_ATTRIBUTE]: ['tool-calls'],
           [GEN_AI_RESPONSE_ID_ATTRIBUTE]: expect.any(String),
           [GEN_AI_RESPONSE_MODEL_ATTRIBUTE]: 'mock-model-id',
-          [GEN_AI_RESPONSE_TEXT_ATTRIBUTE]: 'Tool call completed!',
-          [GEN_AI_RESPONSE_TOOL_CALLS_ATTRIBUTE]: expect.any(String),
           [GEN_AI_SYSTEM_ATTRIBUTE]: 'mock-provider',
           [GEN_AI_USAGE_INPUT_TOKENS_ATTRIBUTE]: 15,
           [GEN_AI_USAGE_OUTPUT_TOKENS_ATTRIBUTE]: 25,
@@ -447,6 +454,7 @@ describe('Vercel AI integration', () => {
       expect.objectContaining({
         data: {
           [GEN_AI_TOOL_CALL_ID_ATTRIBUTE]: 'call-1',
+          [GEN_AI_TOOL_DESCRIPTION_ATTRIBUTE]: 'Get the current weather for a location',
           [GEN_AI_TOOL_INPUT_ATTRIBUTE]: expect.any(String),
           [GEN_AI_TOOL_NAME_ATTRIBUTE]: 'getWeather',
           [GEN_AI_TOOL_OUTPUT_ATTRIBUTE]: expect.any(String),
@@ -809,7 +817,6 @@ describe('Vercel AI integration', () => {
                   data: expect.objectContaining({
                     [GEN_AI_INPUT_MESSAGES_ORIGINAL_LENGTH_ATTRIBUTE]: 3,
                     [GEN_AI_INPUT_MESSAGES_ATTRIBUTE]: expect.stringMatching(/^\[.*"(?:text|content)":"C+".*\]$/),
-                    [GEN_AI_RESPONSE_TEXT_ATTRIBUTE]: 'Response to truncated messages',
                   }),
                 }),
                 // Second call: Last message is small and kept intact
@@ -819,7 +826,6 @@ describe('Vercel AI integration', () => {
                     [GEN_AI_INPUT_MESSAGES_ATTRIBUTE]: expect.stringContaining(
                       'This is a small message that fits within the limit',
                     ),
-                    [GEN_AI_RESPONSE_TEXT_ATTRIBUTE]: 'Response to small message',
                   }),
                 }),
               ]),

dev-packages/node-integration-tests/suites/tracing/vercelai/v5/scenario.mjs

@@ -47,6 +47,7 @@ async function run() {
       }),
       tools: {
         getWeather: tool({
+          description: 'Get the current weather for a location',
           inputSchema: z.object({ location: z.string() }),
           execute: async ({ location }) => `Weather in ${location}: Sunny, 72°F`,
         }),