braintrust 3.22.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

package/dev/dist/index.d.mts

@@ -12185,7 +12185,7 @@ declare class HTTPConnection {
     set_token(token: string): void;
     _reset(): void;
     get(path: string, params?: Record<string, string | string[] | undefined> | undefined, config?: RequestInit): Promise<Response>;
-    post(path: string, params?: Record<string, unknown> | string, config?: RequestInit): Promise<Response>;
+    post(path: string, params?: Record<string, unknown> | string, config?: RequestInit, retries?: number): Promise<Response>;
     get_json(object_type: string, args?: Record<string, string | string[] | undefined> | undefined, retries?: number): Promise<any>;
     post_json(object_type: string, args?: Record<string, unknown> | string | undefined): Promise<any>;
     toString(): string;

package/dev/dist/index.d.ts

@@ -12185,7 +12185,7 @@ declare class HTTPConnection {
     set_token(token: string): void;
     _reset(): void;
     get(path: string, params?: Record<string, string | string[] | undefined> | undefined, config?: RequestInit): Promise<Response>;
-    post(path: string, params?: Record<string, unknown> | string, config?: RequestInit): Promise<Response>;
+    post(path: string, params?: Record<string, unknown> | string, config?: RequestInit, retries?: number): Promise<Response>;
     get_json(object_type: string, args?: Record<string, string | string[] | undefined> | undefined, retries?: number): Promise<any>;
     post_json(object_type: string, args?: Record<string, unknown> | string | undefined): Promise<any>;
     toString(): string;