fix(agents-extensions): ##711 improve AI SDK error details in tracing

[AryanBagade]

Summary

Fixes #711
Improves AI SDK error handling in tracing to capture comprehensive error details including responseBody, statusCode, responseHeaders, and cause fields. Previously, only the error name was captured via String(error), which lost critical debugging information.

Changes

• Updated error handling in aiSdk.ts (3 locations):

  • Non-streaming error handler (lines 780-824)
  • Streaming error handler (lines 1007-1044)
  • Now manually constructs error objects to preserve all
    available fields

• Added comprehensive unit tests in aiSdk.test.ts:

  • Test for non-streaming error handling with tracing enabled
  • Test for streaming error handling with tracing enabled
  • Both tests verify that error fields like responseBody and statusCode are preserved

• Created changeset for version management

Technical Details

When tracing is enabled, errors are now captured as:

{
  name: error.name,
  message: error.message,
  responseBody: error.responseBody,    // ← New!
  responseHeaders: error.responseHeaders, // ← New!
  statusCode: error.statusCode,        // ← New!
  cause: error.cause                   // ← New!
}

This provides developers with complete error context for debugging AI SDK errors, including:

• Rate limit error details and retry information
• API-specific error codes and messages
• Request IDs for support tickets
• HTTP status codes

Safety: Error details are only captured when tracing is explicitly enabled by the user.

[changeset-bot]

🦋 Changeset detected

Latest commit: cc420d6

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@openai/agents-extensions	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR