braintrust 3.13.0 → 3.15.0

package/dist/instrumentation/index.d.mts

@@ -6137,6 +6137,7 @@ interface InstrumentationIntegrationsConfig {
     cursor?: boolean;
     cursorSDK?: boolean;
     flue?: boolean;
+    mastra?: boolean;
     openAIAgents?: boolean;
     openrouter?: boolean;
     openrouterAgent?: boolean;
@@ -6737,17 +6738,15 @@ interface PromptKey {
     id?: string;
 }
 /**
- * A two-layer cache for Braintrust prompts with both in-memory and filesystem storage.
+ * A configurable cache for Braintrust prompts with optional in-memory and filesystem storage.
  *
- * This cache implements either a one or two-layer caching strategy:
- * 1. A fast in-memory LRU cache for frequently accessed prompts.
- * 2. An optional persistent filesystem-based cache that serves as a backing store.
+ * This cache can use either layer independently, both layers together, or no layers.
  */
 declare class PromptCache {
-    private readonly memoryCache;
+    private readonly memoryCache?;
     private readonly diskCache?;
     constructor(options: {
-        memoryCache: LRUCache<string, Prompt>;
+        memoryCache?: LRUCache<string, Prompt>;
         diskCache?: DiskCache<Prompt>;
     });
     /**
@@ -6774,10 +6773,10 @@ interface ParametersKey {
     id?: string;
 }
 declare class ParametersCache {
-    private readonly memoryCache;
+    private readonly memoryCache?;
     private readonly diskCache?;
     constructor(options: {
-        memoryCache: LRUCache<string, RemoteEvalParameters>;
+        memoryCache?: LRUCache<string, RemoteEvalParameters>;
         diskCache?: DiskCache<RemoteEvalParameters>;
     });
     get(key: ParametersKey): Promise<RemoteEvalParameters | undefined>;
@@ -8166,6 +8165,16 @@ declare class OpenAIAgentsTraceProcessor {
     private omitKeys;
 }
 
+type FlueObserver = (event: unknown, ctx?: unknown) => void;
+/**
+ * Braintrust's Flue observe subscriber.
+ *
+ * Pass this directly to @flue/runtime/app.observe:
+ *
+ *   const unsubscribe = observe(braintrustFlueObserver);
+ */
+declare const braintrustFlueObserver: FlueObserver;
+
 /**
  * Plugin registry and configuration for auto-instrumentation.
  *
@@ -8202,4 +8211,4 @@ declare class OpenAIAgentsTraceProcessor {
  */
 declare function configureInstrumentation(config: InstrumentationConfig): void;
 
-export { type AsyncEndEvent, type AsyncStartEvent, type BaseContext, BasePlugin, BraintrustPlugin, type BraintrustPluginConfig, type ChannelHandlers, type EndEvent, type ErrorEvent, type InstrumentationConfig, OpenAIAgentsTraceProcessor, type OpenAIAgentsTraceProcessorOptions, type StartEvent, configureInstrumentation, createChannelName, isValidChannelName, parseChannelName };
+export { type AsyncEndEvent, type AsyncStartEvent, type BaseContext, BasePlugin, BraintrustPlugin, type BraintrustPluginConfig, type ChannelHandlers, type EndEvent, type ErrorEvent, type InstrumentationConfig, OpenAIAgentsTraceProcessor, type OpenAIAgentsTraceProcessorOptions, type StartEvent, braintrustFlueObserver, configureInstrumentation, createChannelName, isValidChannelName, parseChannelName };

package/dist/instrumentation/index.d.ts

@@ -6137,6 +6137,7 @@ interface InstrumentationIntegrationsConfig {
     cursor?: boolean;
     cursorSDK?: boolean;
     flue?: boolean;
+    mastra?: boolean;
     openAIAgents?: boolean;
     openrouter?: boolean;
     openrouterAgent?: boolean;
@@ -6737,17 +6738,15 @@ interface PromptKey {
     id?: string;
 }
 /**
- * A two-layer cache for Braintrust prompts with both in-memory and filesystem storage.
+ * A configurable cache for Braintrust prompts with optional in-memory and filesystem storage.
  *
- * This cache implements either a one or two-layer caching strategy:
- * 1. A fast in-memory LRU cache for frequently accessed prompts.
- * 2. An optional persistent filesystem-based cache that serves as a backing store.
+ * This cache can use either layer independently, both layers together, or no layers.
  */
 declare class PromptCache {
-    private readonly memoryCache;
+    private readonly memoryCache?;
     private readonly diskCache?;
     constructor(options: {
-        memoryCache: LRUCache<string, Prompt>;
+        memoryCache?: LRUCache<string, Prompt>;
         diskCache?: DiskCache<Prompt>;
     });
     /**
@@ -6774,10 +6773,10 @@ interface ParametersKey {
     id?: string;
 }
 declare class ParametersCache {
-    private readonly memoryCache;
+    private readonly memoryCache?;
     private readonly diskCache?;
     constructor(options: {
-        memoryCache: LRUCache<string, RemoteEvalParameters>;
+        memoryCache?: LRUCache<string, RemoteEvalParameters>;
         diskCache?: DiskCache<RemoteEvalParameters>;
     });
     get(key: ParametersKey): Promise<RemoteEvalParameters | undefined>;
@@ -8166,6 +8165,16 @@ declare class OpenAIAgentsTraceProcessor {
     private omitKeys;
 }
 
+type FlueObserver = (event: unknown, ctx?: unknown) => void;
+/**
+ * Braintrust's Flue observe subscriber.
+ *
+ * Pass this directly to @flue/runtime/app.observe:
+ *
+ *   const unsubscribe = observe(braintrustFlueObserver);
+ */
+declare const braintrustFlueObserver: FlueObserver;
+
 /**
  * Plugin registry and configuration for auto-instrumentation.
  *
@@ -8202,4 +8211,4 @@ declare class OpenAIAgentsTraceProcessor {
  */
 declare function configureInstrumentation(config: InstrumentationConfig): void;
 
-export { type AsyncEndEvent, type AsyncStartEvent, type BaseContext, BasePlugin, BraintrustPlugin, type BraintrustPluginConfig, type ChannelHandlers, type EndEvent, type ErrorEvent, type InstrumentationConfig, OpenAIAgentsTraceProcessor, type OpenAIAgentsTraceProcessorOptions, type StartEvent, configureInstrumentation, createChannelName, isValidChannelName, parseChannelName };
+export { type AsyncEndEvent, type AsyncStartEvent, type BaseContext, BasePlugin, BraintrustPlugin, type BraintrustPluginConfig, type ChannelHandlers, type EndEvent, type ErrorEvent, type InstrumentationConfig, OpenAIAgentsTraceProcessor, type OpenAIAgentsTraceProcessorOptions, type StartEvent, braintrustFlueObserver, configureInstrumentation, createChannelName, isValidChannelName, parseChannelName };