braintrust 3.32.0 → 3.33.0

package/README.md

@@ -104,49 +104,6 @@ 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

@@ -14447,6 +14447,34 @@ interface DatasetSummary {
     dataSummary: DataSummary | undefined;
 }
 
+/** Inclusive span duration bounds, in seconds. */
+interface SpanDurationFilter {
+    /** Minimum value of metrics.end - metrics.start. */
+    min?: number;
+    /** Maximum value of metrics.end - metrics.start. */
+    max?: number;
+}
+/**
+ * Filters supported by Trace.getSpans(). Different fields combine with AND.
+ *
+ * Empty name/spanType arrays match no spans. Empty metadata/duration objects
+ * add no constraints. Omit a field to leave it unfiltered.
+ */
+interface SpanFilters {
+    /** Match spans whose span_attributes.type equals any of these. */
+    spanType?: string[];
+    /** Match spans whose span_attributes.name equals any of these. */
+    name?: string[];
+    /** Match spans based on whether they recorded an error. */
+    hasError?: boolean;
+    /**
+     * Match metadata keys at any depth without type coercion. `null` matches a
+     * null or missing path.
+     */
+    metadata?: Record<string, unknown>;
+    /** Bound how long the span took. */
+    duration?: SpanDurationFilter;
+}
 /**
  * Span data returned by getSpans().
  */
@@ -14475,7 +14503,10 @@ interface GetThreadOptions {
     preprocessor?: string;
 }
 interface GetSpansOptions {
+    /** Optional top-level span type filter. */
     spanType?: string[];
+    /** Filters for span type, name, error state, metadata, and duration. */
+    filters?: SpanFilters;
     includeScorers?: boolean;
 }
 /**

package/dev/dist/index.d.ts

@@ -14447,6 +14447,34 @@ interface DatasetSummary {
     dataSummary: DataSummary | undefined;
 }
 
+/** Inclusive span duration bounds, in seconds. */
+interface SpanDurationFilter {
+    /** Minimum value of metrics.end - metrics.start. */
+    min?: number;
+    /** Maximum value of metrics.end - metrics.start. */
+    max?: number;
+}
+/**
+ * Filters supported by Trace.getSpans(). Different fields combine with AND.
+ *
+ * Empty name/spanType arrays match no spans. Empty metadata/duration objects
+ * add no constraints. Omit a field to leave it unfiltered.
+ */
+interface SpanFilters {
+    /** Match spans whose span_attributes.type equals any of these. */
+    spanType?: string[];
+    /** Match spans whose span_attributes.name equals any of these. */
+    name?: string[];
+    /** Match spans based on whether they recorded an error. */
+    hasError?: boolean;
+    /**
+     * Match metadata keys at any depth without type coercion. `null` matches a
+     * null or missing path.
+     */
+    metadata?: Record<string, unknown>;
+    /** Bound how long the span took. */
+    duration?: SpanDurationFilter;
+}
 /**
  * Span data returned by getSpans().
  */
@@ -14475,7 +14503,10 @@ interface GetThreadOptions {
     preprocessor?: string;
 }
 interface GetSpansOptions {
+    /** Optional top-level span type filter. */
     spanType?: string[];
+    /** Filters for span type, name, error state, metadata, and duration. */
+    filters?: SpanFilters;
     includeScorers?: boolean;
 }
 /**