# braintrustdata/braintrust-sdk · RepoSense Release & Migration Intelligence

> feat(mcp): Capture MCP tool and prompt content by default. Drop-in upgrade. Migration: None.

## Metadata
- **Repository URL**: https://github.com/braintrustdata/braintrust-sdk
- **Primary Package**: `braintrust` (NPM)
- **Categories**: `AI-EVALS`, `AI-SDK`, `TESTING`
- **Latest Version**: `braintrust@3.42.0`
- **Semantic Status**: `COMPATIBLE`
- **Bundle Size Impact (unavailable)**: `Size Unavailable`
- **Atom Ingestion Feed**: https://github.com/braintrustdata/braintrust-sdk/releases.atom

## The Human Context (Plain-English Pitch)
braintrust is an open-source library and developer tool in the braintrustdata/braintrust-sdk ecosystem. It removes the friction of wiring up raw HTTP requests, streaming parsers, and authentication boilerplate so developers can integrate AI capabilities in a few lines of code.

## Stage 1 Executive Summary ([Core Change] + [Required Action] + [Migration Effort])
feat(mcp): Capture MCP tool and prompt content by default. Drop-in upgrade. Migration: None.

## Breaking Changes & Required Actions
- feat(mcp): Capture MCP tool and prompt content by default (#2690)
- feat(mcp): trace server notifications and session metadata (#2692)
- fix(pi): align agent instrumentation with tracing spec (#2682)

## Migration Snippet
```ts
npm install braintrust@braintrust@3.42.0
```

## Ecosystem Compatibility Matrix & Graph Warnings
- **TypeScript 5.x** [`COMPATIBLE`]: Ships standard TypeScript declaration files without type regressions.

## Zero-Noise Release Timeline
- **braintrust@3.42.0** (2026-10-29) [COMPATIBLE]: feat(mcp): Capture MCP tool and prompt content by default. Drop-in upgrade. Migration: None.

## Upgrade & Migration Q&A (GEO Direct Answers)
### Is braintrustdata/braintrust-sdk braintrust@3.42.0 safe to upgrade in production?
braintrustdata/braintrust-sdk braintrust@3.42.0 is classified as COMPATIBLE (MINOR release). feat(mcp): Capture MCP tool and prompt content by default. Drop-in upgrade. Migration: None.

### What breaking changes or compatibility risks exist in braintrustdata/braintrust-sdk braintrust@3.42.0?
No breaking API changes or peer dependency conflicts are recorded for braintrustdata/braintrust-sdk braintrust@3.42.0 in the RepoSense compatibility graph.

### What is the bundle size impact of braintrust braintrust@3.42.0?
Measured bundle size telemetry is currently unavailable for braintrust braintrust@3.42.0; verify build output locally before deploying.

### How do I upgrade braintrust to braintrust@3.42.0?
Upgrade braintrust to braintrust@3.42.0 by running "npm install braintrust@braintrust@3.42.0" and applying the migration steps: npm install braintrust@braintrust@3.42.0