braintrust 3.21.0 → 3.23.0

package/README.md

@@ -104,6 +104,49 @@ If you use TypeScript or other transpilation plugins, place the Braintrust plugi
 
 For deeper details, see the [auto-instrumentation architecture docs](src/auto-instrumentations/README.md).
 
+### LangSmith tracing
+
+Braintrust supports LangSmith `>=0.3.30 <1.0.0`. LangSmith tracing remains authoritative: LangSmith must be enabled, and it continues exporting traces to LangSmith while Braintrust mirrors the same run lifecycle. This integration covers tracing only; LangSmith eval, Jest, and Vitest APIs are not instrumented.
+
+For automatic Node.js instrumentation, use the standard hook before importing LangSmith:
+
+```bash
+node --import braintrust/hook.mjs app.js
+```
+
+The Vite, Webpack, esbuild, and Rollup plugins shown above apply the same automatic instrumentation in bundled applications. To instrument explicit namespaces instead, wrap the three LangSmith entrypoints you use:
+
+```typescript
+import {
+  wrapLangSmithClient,
+  wrapLangSmithRunTrees,
+  wrapLangSmithTraceable,
+} from "braintrust";
+import * as clientNamespace from "langsmith/client";
+import * as runTreesNamespace from "langsmith/run_trees";
+import * as traceableNamespace from "langsmith/traceable";
+
+const { Client } = wrapLangSmithClient(clientNamespace);
+const { RunTree } = wrapLangSmithRunTrees(runTreesNamespace);
+const { traceable } = wrapLangSmithTraceable(traceableNamespace);
+```
+
+The wrappers are composable and idempotent. They preserve LangSmith behavior, including its network export and `on_end` callbacks. Automatic and explicit instrumentation can safely be used together.
+
+Disable LangSmith instrumentation in code or through the environment:
+
+```typescript
+import { configureInstrumentation } from "braintrust";
+
+configureInstrumentation({ integrations: { langsmith: false } });
+```
+
+```bash
+BRAINTRUST_DISABLE_INSTRUMENTATION=langsmith node --import braintrust/hook.mjs app.js
+```
+
+When Braintrust LangChain/LangGraph instrumentation is enabled, LangSmith runs serialized by LangChain are ignored to avoid duplicate spans. Set `langchain: false` (and use LangSmith instrumentation) when LangSmith should be the source for those runs instead.
+
 ## Migration Guides
 
 ### Upgrading from 2.x to 3.x
@@ -119,3 +162,7 @@ See the [Migrate from v1.x to v2.x guide](https://www.braintrust.dev/docs/refere
 ### Upgrading from 0.x to 1.x
 
 See the [Migrate from v1.x to v2.x guide](https://www.braintrust.dev/docs/reference/sdks/typescript/migrations/v0-to-v1).
+
+## Compatibility
+
+The `braintrust` package is compatible with Node.js versions 20.12.0, 22.13.0, for the respective major Node.js release lines and above.