@raindrop-ai/ai-sdk 0.0.40 → 0.1.0

package/dist/index.browser.d.mts

@@ -1,3 +1,14 @@
+type FeatureFlagValue = string | number | boolean;
+type FeatureFlags = string[] | Record<string, FeatureFlagValue>;
+/**
+ * Normalizes feature flags from the two accepted input forms into a
+ * canonical `Record<string, string>` ready for the wire payload.
+ *
+ * - Array form: `["a", "b"]` → `{"a": "true", "b": "true"}`
+ * - Object form: `{ a: "v2", b: true, c: 3 }` → `{"a": "v2", "b": "true", "c": "3"}`
+ */
+declare function normalizeFeatureFlags(input: FeatureFlags): Record<string, string>;
+
 type OtlpAnyValue = {
     stringValue?: string;
     intValue?: string;
@@ -53,6 +64,7 @@ type Patch = {
     output?: string;
     model?: string;
     properties?: Record<string, unknown>;
+    featureFlags?: Record<string, string>;
     attachments?: Attachment$1[];
     isPending?: boolean;
     timestamp?: string;
@@ -153,6 +165,7 @@ declare class EventShipper$1 {
         output?: string;
         model?: string;
         properties?: Record<string, unknown>;
+        featureFlags?: Record<string, string>;
         userId?: string;
     }): Promise<void>;
     flush(): Promise<void>;
@@ -416,6 +429,42 @@ declare class TraceShipper$1 {
     shutdown(): Promise<void>;
 }
 
+/**
+ * Run telemetry egress with OpenTelemetry tracing suppressed.
+ *
+ * Why this exists
+ * ---------------
+ * Raindrop integrations ship spans/events over HTTP with the global `fetch`
+ * (see {@link ../http.ts `postJson`}). When the host app also runs an OTel
+ * fetch/undici instrumentation — e.g. `@vercel/otel`'s `registerOTel`, which
+ * every Eve agent installs — that instrumentation wraps *our own* telemetry
+ * POSTs in a `fetch POST <endpoint>` span. Those spans are then handed to the
+ * very exporter that issued the request, so they get shipped right back to
+ * Raindrop and Workshop as standalone "runs" (and, because each export issues
+ * another fetch, they feed back on themselves). The result is a run list
+ * flooded with `fetch POST .../v1/traces`, `.../events/track_partial` and
+ * `.../live` entries that drown out the real agent turns — especially with
+ * sub-agents, where every sandbox runs its own instrumentation.
+ *
+ * The OTel-blessed fix is to mark the active context as "tracing suppressed"
+ * around the request; instrumentations check `isTracingSuppressed` and return
+ * a no-op span instead of recording one. We do this through a hook stashed on
+ * `globalThis` by the Node entrypoint ({@link ../index.node.ts}) so that:
+ *   - `@opentelemetry/api` / `@opentelemetry/core` stay *optional* — core never
+ *     hard-depends on them, and the hook is simply absent when they (and thus
+ *     any instrumentation to suppress) are not installed; and
+ *   - the browser bundle never pulls in `node:module`, mirroring how core
+ *     injects `AsyncLocalStorage` via `RAINDROP_ASYNC_LOCAL_STORAGE`.
+ *
+ * When no hook is present the callback runs unchanged, so suppression is a
+ * best-effort no-op rather than a hard requirement.
+ */
+/** Hook signature: run `fn` with OTel tracing suppressed, returning its value. */
+type SuppressTracingHook = <T>(fn: () => T) => T;
+declare global {
+    var RAINDROP_SUPPRESS_TRACING: SuppressTracingHook | undefined;
+}
+
 type ParentSpanContext = {
     traceIdB64: string;
     spanIdB64: string;
@@ -527,6 +576,7 @@ type RaindropTelemetryIntegrationOptions = {
         eventName?: string;
         convoId?: string;
         properties?: Record<string, unknown>;
+        featureFlags?: Record<string, string>;
     };
 };
 declare class RaindropTelemetryIntegration implements TelemetryIntegration {
@@ -803,6 +853,8 @@ type EventMetadataOptions = {
     eventName?: string;
     /** Additional properties to merge with wrap-time properties */
     properties?: Record<string, unknown>;
+    /** Feature flags to attach to this event (merged with wrap-time flags; call-time wins) */
+    featureFlags?: FeatureFlags;
 };
 /**
  * Creates metadata for use with the AI SDK's `experimental_telemetry.metadata` option.
@@ -1006,6 +1058,7 @@ type RaindropAISDKContext = {
     eventName?: string;
     convoId?: string;
     properties?: Record<string, unknown>;
+    featureFlags?: FeatureFlags;
     attachments?: Attachment[];
 };
 
@@ -1015,6 +1068,7 @@ type BuildEventPatch = {
     output?: string;
     model?: string;
     properties?: Record<string, unknown>;
+    featureFlags?: Record<string, string>;
     attachments?: Attachment[];
 };
 /**
@@ -1179,6 +1233,7 @@ type EventPatch = {
     output?: string;
     model?: string;
     properties?: Record<string, unknown>;
+    featureFlags?: Record<string, string>;
     attachments?: Attachment[];
     isPending?: boolean;
     timestamp?: string;
@@ -1211,10 +1266,12 @@ type RaindropAISDKClient = {
         patch(eventId: string, patch: EventPatch): Promise<void>;
         addAttachments(eventId: string, attachments: Attachment[]): Promise<void>;
         setProperties(eventId: string, properties: Record<string, unknown>): Promise<void>;
+        setFeatureFlags(eventId: string, featureFlags: FeatureFlags): Promise<void>;
         finish(eventId: string, patch: {
             output?: string;
             model?: string;
             properties?: Record<string, unknown>;
+            featureFlags?: Record<string, string>;
         }): Promise<void>;
     };
     /**
@@ -1325,4 +1382,4 @@ type RaindropTelemetryOptions = RaindropAISDKOptions & {
  */
 declare function raindrop(options?: RaindropTelemetryOptions): RaindropTelemetryIntegration;
 
-export { type AISDKChatRequestLike, type AISDKChatRequestMessageLike, type AISDKMessage, type AgentCallMetadata, type AgentWithMetadata, type Attachment, type BuildEventPatch, ContextManager, type ContextSpan, type CreateSpanArgs, DEFAULT_MAX_TEXT_FIELD_CHARS, DEFAULT_REDACT_ATTRIBUTE_KEYS, DEFAULT_SECRET_KEY_NAMES, type EndSpanArgs, type EventBuilder, type EventMetadataOptions, type IdentifyInput, type OtlpAnyValue, type OtlpSpan, type ParentToolContext, REDACTED_PLACEHOLDER, type RaindropAISDKClient, type RaindropAISDKContext, type RaindropAISDKOptions, type RaindropCallMetadata, RaindropTelemetryIntegration, type RaindropTelemetryIntegrationOptions, type RaindropTelemetryOptions, type SelfDiagnosticsOptions, type SelfDiagnosticsSignalDefinition, type SelfDiagnosticsSignalDefinitions, type SelfDiagnosticsTool, type SelfDiagnosticsToolInput, type SelfDiagnosticsToolOptions, type SelfDiagnosticsToolResult, type StartSpanArgs, TRUNCATION_MARKER, type TraceSpan, type TransformSpanHook, type WrapAISDKOptions, type WrappedAI, type WrappedAISDK, _resetParentToolContextStorage, _resetRaindropCallMetadataStorage, _resetWarnedMissingUserId, boundedStringify, capText, clearParentToolContext, createRaindropAISDK, currentSpan, defaultTransformSpan, enterParentToolContext, eventMetadata, eventMetadataFromChatRequest, getContextManager, getCurrentParentToolContext, getCurrentRaindropCallMetadata, raindrop, readRaindropCallMetadataFromArgs, redactJsonAttributeValue, redactSecretsInObject, runWithParentToolContext, runWithRaindropCallMetadata, withCurrent };
+export { type AISDKChatRequestLike, type AISDKChatRequestMessageLike, type AISDKMessage, type AgentCallMetadata, type AgentWithMetadata, type Attachment, type BuildEventPatch, ContextManager, type ContextSpan, type CreateSpanArgs, DEFAULT_MAX_TEXT_FIELD_CHARS, DEFAULT_REDACT_ATTRIBUTE_KEYS, DEFAULT_SECRET_KEY_NAMES, type EndSpanArgs, type EventBuilder, type EventMetadataOptions, type FeatureFlagValue, type FeatureFlags, type IdentifyInput, type OtlpAnyValue, type OtlpSpan, type ParentToolContext, REDACTED_PLACEHOLDER, type RaindropAISDKClient, type RaindropAISDKContext, type RaindropAISDKOptions, type RaindropCallMetadata, RaindropTelemetryIntegration, type RaindropTelemetryIntegrationOptions, type RaindropTelemetryOptions, type SelfDiagnosticsOptions, type SelfDiagnosticsSignalDefinition, type SelfDiagnosticsSignalDefinitions, type SelfDiagnosticsTool, type SelfDiagnosticsToolInput, type SelfDiagnosticsToolOptions, type SelfDiagnosticsToolResult, type StartSpanArgs, TRUNCATION_MARKER, type TraceSpan, type TransformSpanHook, type WrapAISDKOptions, type WrappedAI, type WrappedAISDK, _resetParentToolContextStorage, _resetRaindropCallMetadataStorage, _resetWarnedMissingUserId, boundedStringify, capText, clearParentToolContext, createRaindropAISDK, currentSpan, defaultTransformSpan, enterParentToolContext, eventMetadata, eventMetadataFromChatRequest, getContextManager, getCurrentParentToolContext, getCurrentRaindropCallMetadata, normalizeFeatureFlags, raindrop, readRaindropCallMetadataFromArgs, redactJsonAttributeValue, redactSecretsInObject, runWithParentToolContext, runWithRaindropCallMetadata, withCurrent };

package/dist/index.browser.d.ts

@@ -1,3 +1,14 @@
+type FeatureFlagValue = string | number | boolean;
+type FeatureFlags = string[] | Record<string, FeatureFlagValue>;
+/**
+ * Normalizes feature flags from the two accepted input forms into a
+ * canonical `Record<string, string>` ready for the wire payload.
+ *
+ * - Array form: `["a", "b"]` → `{"a": "true", "b": "true"}`
+ * - Object form: `{ a: "v2", b: true, c: 3 }` → `{"a": "v2", "b": "true", "c": "3"}`
+ */
+declare function normalizeFeatureFlags(input: FeatureFlags): Record<string, string>;
+
 type OtlpAnyValue = {
     stringValue?: string;
     intValue?: string;
@@ -53,6 +64,7 @@ type Patch = {
     output?: string;
     model?: string;
     properties?: Record<string, unknown>;
+    featureFlags?: Record<string, string>;
     attachments?: Attachment$1[];
     isPending?: boolean;
     timestamp?: string;
@@ -153,6 +165,7 @@ declare class EventShipper$1 {
         output?: string;
         model?: string;
         properties?: Record<string, unknown>;
+        featureFlags?: Record<string, string>;
         userId?: string;
     }): Promise<void>;
     flush(): Promise<void>;
@@ -416,6 +429,42 @@ declare class TraceShipper$1 {
     shutdown(): Promise<void>;
 }
 
+/**
+ * Run telemetry egress with OpenTelemetry tracing suppressed.
+ *
+ * Why this exists
+ * ---------------
+ * Raindrop integrations ship spans/events over HTTP with the global `fetch`
+ * (see {@link ../http.ts `postJson`}). When the host app also runs an OTel
+ * fetch/undici instrumentation — e.g. `@vercel/otel`'s `registerOTel`, which
+ * every Eve agent installs — that instrumentation wraps *our own* telemetry
+ * POSTs in a `fetch POST <endpoint>` span. Those spans are then handed to the
+ * very exporter that issued the request, so they get shipped right back to
+ * Raindrop and Workshop as standalone "runs" (and, because each export issues
+ * another fetch, they feed back on themselves). The result is a run list
+ * flooded with `fetch POST .../v1/traces`, `.../events/track_partial` and
+ * `.../live` entries that drown out the real agent turns — especially with
+ * sub-agents, where every sandbox runs its own instrumentation.
+ *
+ * The OTel-blessed fix is to mark the active context as "tracing suppressed"
+ * around the request; instrumentations check `isTracingSuppressed` and return
+ * a no-op span instead of recording one. We do this through a hook stashed on
+ * `globalThis` by the Node entrypoint ({@link ../index.node.ts}) so that:
+ *   - `@opentelemetry/api` / `@opentelemetry/core` stay *optional* — core never
+ *     hard-depends on them, and the hook is simply absent when they (and thus
+ *     any instrumentation to suppress) are not installed; and
+ *   - the browser bundle never pulls in `node:module`, mirroring how core
+ *     injects `AsyncLocalStorage` via `RAINDROP_ASYNC_LOCAL_STORAGE`.
+ *
+ * When no hook is present the callback runs unchanged, so suppression is a
+ * best-effort no-op rather than a hard requirement.
+ */
+/** Hook signature: run `fn` with OTel tracing suppressed, returning its value. */
+type SuppressTracingHook = <T>(fn: () => T) => T;
+declare global {
+    var RAINDROP_SUPPRESS_TRACING: SuppressTracingHook | undefined;
+}
+
 type ParentSpanContext = {
     traceIdB64: string;
     spanIdB64: string;
@@ -527,6 +576,7 @@ type RaindropTelemetryIntegrationOptions = {
         eventName?: string;
         convoId?: string;
         properties?: Record<string, unknown>;
+        featureFlags?: Record<string, string>;
     };
 };
 declare class RaindropTelemetryIntegration implements TelemetryIntegration {
@@ -803,6 +853,8 @@ type EventMetadataOptions = {
     eventName?: string;
     /** Additional properties to merge with wrap-time properties */
     properties?: Record<string, unknown>;
+    /** Feature flags to attach to this event (merged with wrap-time flags; call-time wins) */
+    featureFlags?: FeatureFlags;
 };
 /**
  * Creates metadata for use with the AI SDK's `experimental_telemetry.metadata` option.
@@ -1006,6 +1058,7 @@ type RaindropAISDKContext = {
     eventName?: string;
     convoId?: string;
     properties?: Record<string, unknown>;
+    featureFlags?: FeatureFlags;
     attachments?: Attachment[];
 };
 
@@ -1015,6 +1068,7 @@ type BuildEventPatch = {
     output?: string;
     model?: string;
     properties?: Record<string, unknown>;
+    featureFlags?: Record<string, string>;
     attachments?: Attachment[];
 };
 /**
@@ -1179,6 +1233,7 @@ type EventPatch = {
     output?: string;
     model?: string;
     properties?: Record<string, unknown>;
+    featureFlags?: Record<string, string>;
     attachments?: Attachment[];
     isPending?: boolean;
     timestamp?: string;
@@ -1211,10 +1266,12 @@ type RaindropAISDKClient = {
         patch(eventId: string, patch: EventPatch): Promise<void>;
         addAttachments(eventId: string, attachments: Attachment[]): Promise<void>;
         setProperties(eventId: string, properties: Record<string, unknown>): Promise<void>;
+        setFeatureFlags(eventId: string, featureFlags: FeatureFlags): Promise<void>;
         finish(eventId: string, patch: {
             output?: string;
             model?: string;
             properties?: Record<string, unknown>;
+            featureFlags?: Record<string, string>;
         }): Promise<void>;
     };
     /**
@@ -1325,4 +1382,4 @@ type RaindropTelemetryOptions = RaindropAISDKOptions & {
  */
 declare function raindrop(options?: RaindropTelemetryOptions): RaindropTelemetryIntegration;
 
-export { type AISDKChatRequestLike, type AISDKChatRequestMessageLike, type AISDKMessage, type AgentCallMetadata, type AgentWithMetadata, type Attachment, type BuildEventPatch, ContextManager, type ContextSpan, type CreateSpanArgs, DEFAULT_MAX_TEXT_FIELD_CHARS, DEFAULT_REDACT_ATTRIBUTE_KEYS, DEFAULT_SECRET_KEY_NAMES, type EndSpanArgs, type EventBuilder, type EventMetadataOptions, type IdentifyInput, type OtlpAnyValue, type OtlpSpan, type ParentToolContext, REDACTED_PLACEHOLDER, type RaindropAISDKClient, type RaindropAISDKContext, type RaindropAISDKOptions, type RaindropCallMetadata, RaindropTelemetryIntegration, type RaindropTelemetryIntegrationOptions, type RaindropTelemetryOptions, type SelfDiagnosticsOptions, type SelfDiagnosticsSignalDefinition, type SelfDiagnosticsSignalDefinitions, type SelfDiagnosticsTool, type SelfDiagnosticsToolInput, type SelfDiagnosticsToolOptions, type SelfDiagnosticsToolResult, type StartSpanArgs, TRUNCATION_MARKER, type TraceSpan, type TransformSpanHook, type WrapAISDKOptions, type WrappedAI, type WrappedAISDK, _resetParentToolContextStorage, _resetRaindropCallMetadataStorage, _resetWarnedMissingUserId, boundedStringify, capText, clearParentToolContext, createRaindropAISDK, currentSpan, defaultTransformSpan, enterParentToolContext, eventMetadata, eventMetadataFromChatRequest, getContextManager, getCurrentParentToolContext, getCurrentRaindropCallMetadata, raindrop, readRaindropCallMetadataFromArgs, redactJsonAttributeValue, redactSecretsInObject, runWithParentToolContext, runWithRaindropCallMetadata, withCurrent };
+export { type AISDKChatRequestLike, type AISDKChatRequestMessageLike, type AISDKMessage, type AgentCallMetadata, type AgentWithMetadata, type Attachment, type BuildEventPatch, ContextManager, type ContextSpan, type CreateSpanArgs, DEFAULT_MAX_TEXT_FIELD_CHARS, DEFAULT_REDACT_ATTRIBUTE_KEYS, DEFAULT_SECRET_KEY_NAMES, type EndSpanArgs, type EventBuilder, type EventMetadataOptions, type FeatureFlagValue, type FeatureFlags, type IdentifyInput, type OtlpAnyValue, type OtlpSpan, type ParentToolContext, REDACTED_PLACEHOLDER, type RaindropAISDKClient, type RaindropAISDKContext, type RaindropAISDKOptions, type RaindropCallMetadata, RaindropTelemetryIntegration, type RaindropTelemetryIntegrationOptions, type RaindropTelemetryOptions, type SelfDiagnosticsOptions, type SelfDiagnosticsSignalDefinition, type SelfDiagnosticsSignalDefinitions, type SelfDiagnosticsTool, type SelfDiagnosticsToolInput, type SelfDiagnosticsToolOptions, type SelfDiagnosticsToolResult, type StartSpanArgs, TRUNCATION_MARKER, type TraceSpan, type TransformSpanHook, type WrapAISDKOptions, type WrappedAI, type WrappedAISDK, _resetParentToolContextStorage, _resetRaindropCallMetadataStorage, _resetWarnedMissingUserId, boundedStringify, capText, clearParentToolContext, createRaindropAISDK, currentSpan, defaultTransformSpan, enterParentToolContext, eventMetadata, eventMetadataFromChatRequest, getContextManager, getCurrentParentToolContext, getCurrentRaindropCallMetadata, normalizeFeatureFlags, raindrop, readRaindropCallMetadataFromArgs, redactJsonAttributeValue, redactSecretsInObject, runWithParentToolContext, runWithRaindropCallMetadata, withCurrent };

package/dist/index.browser.js

@@ -1,6 +1,14 @@
 'use strict';
 
-// ../core/dist/chunk-SK6EJEO7.js
+// ../core/dist/chunk-Y5LUB7OE.js
+function normalizeFeatureFlags(input) {
+  if (Array.isArray(input)) {
+    return Object.fromEntries(input.map((name) => [name, "true"]));
+  }
+  return Object.fromEntries(
+    Object.entries(input).map(([k, v]) => [k, String(v)])
+  );
+}
 function getCrypto() {
   const c = globalThis.crypto;
   return c;
@@ -55,6 +63,20 @@ function base64Encode(bytes) {
   }
   return out;
 }
+function runWithTracingSuppressed(fn) {
+  const hook = globalThis.RAINDROP_SUPPRESS_TRACING;
+  if (typeof hook !== "function") return fn();
+  let started = false;
+  try {
+    return hook(() => {
+      started = true;
+      return fn();
+    });
+  } catch (err) {
+    if (started) throw err;
+    return fn();
+  }
+}
 var DEFAULT_REQUEST_TIMEOUT_MS = 3e4;
 var MAX_RETRY_DELAY_MS = 3e4;
 function wait(ms) {
@@ -165,15 +187,17 @@ async function postJson(url, body, headers, opts) {
   const timeoutMs = (_a = opts.timeoutMs) != null ? _a : DEFAULT_REQUEST_TIMEOUT_MS;
   await withRetry(
     async () => {
-      const resp = await fetch(url, {
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json",
-          ...headers
-        },
-        body: JSON.stringify(body),
-        signal: AbortSignal.timeout(timeoutMs)
-      });
+      const resp = await runWithTracingSuppressed(
+        () => fetch(url, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            ...headers
+          },
+          body: JSON.stringify(body),
+          signal: AbortSignal.timeout(timeoutMs)
+        })
+      );
       if (!resp.ok) {
         const text = await resp.text().catch(() => "");
         const err = new Error(
@@ -419,13 +443,16 @@ function projectIdHeaders(projectId) {
 var SHUTDOWN_DEADLINE_MS = 1e4;
 var POST_SHUTDOWN_TIMEOUT_MS = 5e3;
 function mergePatches(target, source) {
-  var _a, _b, _c, _d;
+  var _a, _b, _c, _d, _e, _f;
   const out = { ...target, ...source };
   if (target.properties || source.properties) {
     out.properties = { ...(_a = target.properties) != null ? _a : {}, ...(_b = source.properties) != null ? _b : {} };
   }
+  if (target.featureFlags || source.featureFlags) {
+    out.featureFlags = { ...(_c = target.featureFlags) != null ? _c : {}, ...(_d = source.featureFlags) != null ? _d : {} };
+  }
   if (target.attachments || source.attachments) {
-    out.attachments = [...(_c = target.attachments) != null ? _c : [], ...(_d = source.attachments) != null ? _d : []];
+    out.attachments = [...(_e = target.attachments) != null ? _e : [], ...(_f = source.attachments) != null ? _f : []];
   }
   return out;
 }
@@ -695,6 +722,7 @@ var EventShipper = class {
         ...wizardSession ? { "raindrop.wizardSession": wizardSession } : {},
         $context: this.context
       },
+      ...accumulated.featureFlags && Object.keys(accumulated.featureFlags).length > 0 ? { feature_flags: accumulated.featureFlags } : {},
       attachments: accumulated.attachments,
       is_pending: isPending
     };
@@ -1283,7 +1311,7 @@ async function* asyncGeneratorWithCurrent(span, gen) {
 // package.json
 var package_default = {
   name: "@raindrop-ai/ai-sdk",
-  version: "0.0.40"};
+  version: "0.1.0"};
 
 // src/internal/version.ts
 var libraryName = package_default.name;
@@ -2705,6 +2733,20 @@ var RaindropTelemetryIntegration = class {
     } else if (properties && typeof properties === "object") {
       result.properties = properties;
     }
+    const featureFlags = metadata["raindrop.featureFlags"];
+    if (typeof featureFlags === "string") {
+      try {
+        const parsed = JSON.parse(featureFlags);
+        if (parsed && typeof parsed === "object") {
+          result.featureFlags = normalizeFeatureFlags(parsed);
+        }
+      } catch (e) {
+      }
+    } else if (featureFlags && typeof featureFlags === "object") {
+      result.featureFlags = normalizeFeatureFlags(
+        featureFlags
+      );
+    }
     return result;
   }
   /**
@@ -2919,7 +2961,7 @@ var RaindropTelemetryIntegration = class {
    * same event ID into a separate canonical row.
    */
   finalizeGenerateEvent(state, output, model, keepPending = false) {
-    var _a, _b, _c, _d, _e, _f, _g, _h;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i;
     const suppressSubagentEvent = state.subagentName !== void 0 && state.subagentToolCallSpan !== void 0;
     if (!this.sendEvents || suppressSubagentEvent) return;
     const callMeta = this.extractRaindropMetadata(state.metadata);
@@ -2932,7 +2974,11 @@ var RaindropTelemetryIntegration = class {
       ...(_f = this.defaultContext) == null ? void 0 : _f.properties,
       ...callMeta.properties
     };
-    const convoId = (_h = callMeta.convoId) != null ? _h : (_g = this.defaultContext) == null ? void 0 : _g.convoId;
+    const featureFlags = {
+      ...(_g = this.defaultContext) == null ? void 0 : _g.featureFlags,
+      ...callMeta.featureFlags
+    };
+    const convoId = (_i = callMeta.convoId) != null ? _i : (_h = this.defaultContext) == null ? void 0 : _h.convoId;
     void this.eventShipper.patch(state.eventId, {
       eventName,
       userId,
@@ -2941,6 +2987,7 @@ var RaindropTelemetryIntegration = class {
       output: cappedOutput,
       model,
       properties: Object.keys(properties).length > 0 ? properties : void 0,
+      featureFlags: Object.keys(featureFlags).length > 0 ? featureFlags : void 0,
       isPending: keepPending
     }).catch((err) => {
       if (this.debug) {
@@ -3264,6 +3311,20 @@ function extractRaindropMetadata(metadata) {
   } else if (properties && typeof properties === "object") {
     result.properties = properties;
   }
+  const featureFlags = metadata["raindrop.featureFlags"];
+  if (typeof featureFlags === "string") {
+    try {
+      const parsed = JSON.parse(featureFlags);
+      if (parsed && typeof parsed === "object") {
+        result.featureFlags = normalizeFeatureFlags(parsed);
+      }
+    } catch (e) {
+    }
+  } else if (featureFlags && typeof featureFlags === "object") {
+    result.featureFlags = normalizeFeatureFlags(
+      featureFlags
+    );
+  }
   return result;
 }
 function mergeContexts(wrapTime, callTime) {
@@ -3278,6 +3339,10 @@ function mergeContexts(wrapTime, callTime) {
       ...callTime.properties
     };
   }
+  if (callTime.featureFlags) {
+    const wrapTimeFlags = wrapTime.featureFlags ? normalizeFeatureFlags(wrapTime.featureFlags) : {};
+    result.featureFlags = { ...wrapTimeFlags, ...callTime.featureFlags };
+  }
   return result;
 }
 function detectAISDKVersion(aiSDK) {
@@ -3590,6 +3655,7 @@ function createFinalize(params) {
       output: defaultOutput,
       model,
       properties: setup.ctx.properties,
+      featureFlags: setup.ctx.featureFlags ? normalizeFeatureFlags(setup.ctx.featureFlags) : void 0,
       attachments: mergeAttachments(setup.ctx.attachments, inputAttachments, outputAttachments)
     };
     const built = await maybeBuildEvent(options.buildEvent, allMessages);
@@ -3643,6 +3709,7 @@ function createFinalize(params) {
         output,
         model: finalModel,
         properties: patch.properties,
+        featureFlags: patch.featureFlags,
         attachments: patch.attachments,
         isPending: keepEventPending
       }).catch((err) => {
@@ -3874,7 +3941,8 @@ function wrapAISDK(aiSDK, deps) {
         eventId: wrapTimeCtx.eventId,
         eventName: wrapTimeCtx.eventName,
         convoId: wrapTimeCtx.convoId,
-        properties: wrapTimeCtx.properties
+        properties: wrapTimeCtx.properties,
+        featureFlags: wrapTimeCtx.featureFlags ? normalizeFeatureFlags(wrapTimeCtx.featureFlags) : void 0
       }
     });
     const registerFn = resolveRegisterTelemetry(aiSDK);
@@ -4150,6 +4218,7 @@ function wrapAgentGenerate(generate, instance, agentSettings, className, aiSDK,
         output: outputText,
         model,
         properties: ctx.properties,
+        featureFlags: ctx.featureFlags ? normalizeFeatureFlags(ctx.featureFlags) : void 0,
         attachments: mergeAttachments(ctx.attachments, inputAttachments, outputAttachments)
       };
       const built = await maybeBuildEvent(deps.options.buildEvent, allMessages);
@@ -4217,6 +4286,7 @@ function wrapAgentGenerate(generate, instance, agentSettings, className, aiSDK,
           output,
           model: finalModel,
           properties: patch.properties,
+          featureFlags: patch.featureFlags,
           attachments: patch.attachments,
           isPending: false
         }).catch((err) => {
@@ -4358,6 +4428,7 @@ function wrapAgentStream(stream, instance, agentSettings, className, aiSDK, deps
         output: outputText,
         model,
         properties: ctx.properties,
+        featureFlags: ctx.featureFlags ? normalizeFeatureFlags(ctx.featureFlags) : void 0,
         attachments: mergeAttachments(ctx.attachments, inputAttachments, outputAttachments)
       };
       const built = await maybeBuildEvent(deps.options.buildEvent, allMessages);
@@ -4425,6 +4496,7 @@ function wrapAgentStream(stream, instance, agentSettings, className, aiSDK, deps
           output,
           model: finalModel,
           properties: patch.properties,
+          featureFlags: patch.featureFlags,
           attachments: patch.attachments,
           isPending: false
         }).catch((err) => {
@@ -5022,7 +5094,7 @@ async function maybeBuildEvent(buildEvent, messages) {
   }
 }
 function mergeBuildEventPatch(defaults, override) {
-  var _a, _b, _c, _d, _e, _f, _g, _h;
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
   if (!override) return defaults;
   return {
     eventName: (_a = override.eventName) != null ? _a : defaults.eventName,
@@ -5030,7 +5102,8 @@ function mergeBuildEventPatch(defaults, override) {
     output: (_c = override.output) != null ? _c : defaults.output,
     model: (_d = override.model) != null ? _d : defaults.model,
     properties: override.properties !== void 0 ? { ...(_e = defaults.properties) != null ? _e : {}, ...(_f = override.properties) != null ? _f : {} } : defaults.properties,
-    attachments: override.attachments !== void 0 ? [...(_g = defaults.attachments) != null ? _g : [], ...(_h = override.attachments) != null ? _h : []] : defaults.attachments
+    featureFlags: override.featureFlags !== void 0 ? { ...(_g = defaults.featureFlags) != null ? _g : {}, ...(_h = override.featureFlags) != null ? _h : {} } : defaults.featureFlags,
+    attachments: override.attachments !== void 0 ? [...(_i = defaults.attachments) != null ? _i : [], ...(_j = override.attachments) != null ? _j : []] : defaults.attachments
   };
 }
 function mergeAttachments(...groups) {
@@ -5061,6 +5134,8 @@ function eventMetadata(options) {
   if (options.convoId) result["raindrop.convoId"] = options.convoId;
   if (options.eventName) result["raindrop.eventName"] = options.eventName;
   if (options.properties) result["raindrop.properties"] = JSON.stringify(options.properties);
+  if (options.featureFlags)
+    result["raindrop.featureFlags"] = JSON.stringify(normalizeFeatureFlags(options.featureFlags));
   return result;
 }
 function deriveChatTurnMessageId(request) {
@@ -5165,7 +5240,8 @@ function createRaindropAISDK(opts) {
         "eventId",
         "eventName",
         "convoId",
-        "properties"
+        "properties",
+        "featureFlags"
       ];
       let context;
       let subagentWrapping;
@@ -5197,6 +5273,9 @@ function createRaindropAISDK(opts) {
       async setProperties(eventId, properties) {
         await eventShipper.patch(eventId, { properties });
       },
+      async setFeatureFlags(eventId, featureFlags) {
+        await eventShipper.patch(eventId, { featureFlags: normalizeFeatureFlags(featureFlags) });
+      },
       async finish(eventId, patch) {
         await eventShipper.finish(eventId, patch);
       }
@@ -5318,6 +5397,7 @@ exports.eventMetadataFromChatRequest = eventMetadataFromChatRequest;
 exports.getContextManager = getContextManager;
 exports.getCurrentParentToolContext = getCurrentParentToolContext;
 exports.getCurrentRaindropCallMetadata = getCurrentRaindropCallMetadata;
+exports.normalizeFeatureFlags = normalizeFeatureFlags;
 exports.raindrop = raindrop;
 exports.readRaindropCallMetadataFromArgs = readRaindropCallMetadataFromArgs;
 exports.redactJsonAttributeValue = redactJsonAttributeValue;