@raindrop-ai/deep-agents 0.0.6 → 0.1.0

package/dist/index.d.mts

@@ -60,6 +60,7 @@ type Patch = {
     output?: string;
     model?: string;
     properties?: Record<string, unknown>;
+    featureFlags?: Record<string, string>;
     attachments?: Attachment[];
     isPending?: boolean;
     timestamp?: string;
@@ -160,6 +161,7 @@ declare class EventShipper {
         output?: string;
         model?: string;
         properties?: Record<string, unknown>;
+        featureFlags?: Record<string, string>;
         userId?: string;
     }): Promise<void>;
     flush(): Promise<void>;
@@ -432,6 +434,8 @@ interface RaindropDeepAgentsHandlerOptions {
     traceShipper: TraceShipper;
     userId?: string;
     convoId?: string;
+    eventName?: string;
+    eventId?: () => string;
     traceChains?: boolean;
 }
 declare class RaindropDeepAgentsHandler extends BaseCallbackHandler {
@@ -440,6 +444,8 @@ declare class RaindropDeepAgentsHandler extends BaseCallbackHandler {
     private traceShipper;
     private userId?;
     private convoId?;
+    private eventName?;
+    private eventIdSource?;
     private traceChains;
     private spans;
     private rootRunIds;
@@ -481,6 +487,18 @@ interface DeepAgentsOptions {
     debug?: boolean;
     userId?: string;
     convoId?: string;
+    /**
+     * Event name stamped on every captured event, replacing core's hardcoded
+     * `"ai_generation"` default (DEV-1167).
+     */
+    eventName?: string;
+    /**
+     * Per-call event-id source, invoked once per captured root agent invocation
+     * to mint that event's id (and the linked spans' id), replacing the
+     * handler-minted UUID (DEV-1174). A throwing/empty/absent source falls back
+     * to a random UUID, so telemetry never crashes the caller.
+     */
+    eventId?: () => string;
     /**
      * Optional Raindrop project slug. When set, every outbound cloud request
      * carries an `X-Raindrop-Project-Id` header. Unset → no header (the project

package/dist/index.d.ts

@@ -60,6 +60,7 @@ type Patch = {
     output?: string;
     model?: string;
     properties?: Record<string, unknown>;
+    featureFlags?: Record<string, string>;
     attachments?: Attachment[];
     isPending?: boolean;
     timestamp?: string;
@@ -160,6 +161,7 @@ declare class EventShipper {
         output?: string;
         model?: string;
         properties?: Record<string, unknown>;
+        featureFlags?: Record<string, string>;
         userId?: string;
     }): Promise<void>;
     flush(): Promise<void>;
@@ -432,6 +434,8 @@ interface RaindropDeepAgentsHandlerOptions {
     traceShipper: TraceShipper;
     userId?: string;
     convoId?: string;
+    eventName?: string;
+    eventId?: () => string;
     traceChains?: boolean;
 }
 declare class RaindropDeepAgentsHandler extends BaseCallbackHandler {
@@ -440,6 +444,8 @@ declare class RaindropDeepAgentsHandler extends BaseCallbackHandler {
     private traceShipper;
     private userId?;
     private convoId?;
+    private eventName?;
+    private eventIdSource?;
     private traceChains;
     private spans;
     private rootRunIds;
@@ -481,6 +487,18 @@ interface DeepAgentsOptions {
     debug?: boolean;
     userId?: string;
     convoId?: string;
+    /**
+     * Event name stamped on every captured event, replacing core's hardcoded
+     * `"ai_generation"` default (DEV-1167).
+     */
+    eventName?: string;
+    /**
+     * Per-call event-id source, invoked once per captured root agent invocation
+     * to mint that event's id (and the linked spans' id), replacing the
+     * handler-minted UUID (DEV-1174). A throwing/empty/absent source falls back
+     * to a random UUID, so telemetry never crashes the caller.
+     */
+    eventId?: () => string;
     /**
      * Optional Raindrop project slug. When set, every outbound cloud request
      * carries an `X-Raindrop-Project-Id` header. Unset → no header (the project

package/dist/index.js

@@ -28,7 +28,7 @@ module.exports = __toCommonJS(index_exports);
 // src/callback-handler.ts
 var import_base = require("@langchain/core/callbacks/base");
 
-// ../core/dist/chunk-WKRW55KX.js
+// ../core/dist/chunk-267IXHO5.js
 function getCrypto() {
   const c = globalThis.crypto;
   return c;
@@ -418,13 +418,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;
 }
@@ -694,6 +697,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
     };
@@ -1192,6 +1196,15 @@ function installTracingSuppressionHook() {
 installTracingSuppressionHook();
 
 // src/callback-handler.ts
+function resolveEventId(source) {
+  if (typeof source !== "function") return randomUUID();
+  try {
+    const id = source();
+    return typeof id === "string" && id.trim() !== "" ? id : randomUUID();
+  } catch {
+    return randomUUID();
+  }
+}
 function isInternalName(name) {
   if (name.startsWith("Branch:")) return true;
   if (name.startsWith("ChannelWrite")) return true;
@@ -1240,13 +1253,15 @@ var RaindropDeepAgentsHandler = class extends import_base.BaseCallbackHandler {
     this.traceShipper = opts.traceShipper;
     this.userId = opts.userId;
     this.convoId = opts.convoId;
+    this.eventName = opts.eventName;
+    this.eventIdSource = opts.eventId;
     this.traceChains = opts.traceChains ?? true;
   }
   getEventId(runId, parentRunId) {
     const rootId = parentRunId ? this.rootRunIds.get(parentRunId) ?? parentRunId : runId;
     this.rootRunIds.set(runId, rootId);
     if (!this.eventIds.has(rootId)) {
-      this.eventIds.set(rootId, randomUUID());
+      this.eventIds.set(rootId, resolveEventId(this.eventIdSource));
     }
     return this.eventIds.get(rootId);
   }
@@ -1275,10 +1290,11 @@ var RaindropDeepAgentsHandler = class extends import_base.BaseCallbackHandler {
     const eventId = this.eventIds.get(rootId);
     if (!eventId) return;
     if (isRoot) {
-      if (this.convoId) {
+      if (this.convoId || this.eventName) {
         await this.eventShipper.patch(eventId, {
           userId: this.userId,
           convoId: this.convoId,
+          eventName: this.eventName,
           isPending: true
         });
       }
@@ -1287,6 +1303,7 @@ var RaindropDeepAgentsHandler = class extends import_base.BaseCallbackHandler {
       await this.eventShipper.patch(eventId, {
         userId: this.userId,
         convoId: this.convoId,
+        eventName: this.eventName,
         ...patch,
         isPending: true
       });
@@ -1313,6 +1330,7 @@ var RaindropDeepAgentsHandler = class extends import_base.BaseCallbackHandler {
       await this.eventShipper.patch(eventId, {
         userId: this.userId,
         convoId: this.convoId,
+        eventName: this.eventName,
         input: truncate(prompts.join("\n"), CHAIN_TEXT_MAX_LEN),
         properties: buildProperties(tags, metadata),
         isPending: true
@@ -1346,6 +1364,7 @@ var RaindropDeepAgentsHandler = class extends import_base.BaseCallbackHandler {
       await this.eventShipper.patch(eventId, {
         userId: this.userId,
         convoId: this.convoId,
+        eventName: this.eventName,
         input: inputText,
         properties: buildProperties(tags, metadata),
         isPending: true
@@ -1765,6 +1784,8 @@ function createRaindropDeepAgents(opts) {
     traceShipper,
     userId: opts.userId,
     convoId: opts.convoId,
+    eventName: opts.eventName,
+    eventId: opts.eventId,
     traceChains: opts.traceChains
   });
   return {

package/dist/index.mjs

@@ -1,7 +1,7 @@
 // src/callback-handler.ts
 import { BaseCallbackHandler } from "@langchain/core/callbacks/base";
 
-// ../core/dist/chunk-WKRW55KX.js
+// ../core/dist/chunk-267IXHO5.js
 function getCrypto() {
   const c = globalThis.crypto;
   return c;
@@ -391,13 +391,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;
 }
@@ -667,6 +670,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
     };
@@ -1165,6 +1169,15 @@ function installTracingSuppressionHook() {
 installTracingSuppressionHook();
 
 // src/callback-handler.ts
+function resolveEventId(source) {
+  if (typeof source !== "function") return randomUUID();
+  try {
+    const id = source();
+    return typeof id === "string" && id.trim() !== "" ? id : randomUUID();
+  } catch {
+    return randomUUID();
+  }
+}
 function isInternalName(name) {
   if (name.startsWith("Branch:")) return true;
   if (name.startsWith("ChannelWrite")) return true;
@@ -1213,13 +1226,15 @@ var RaindropDeepAgentsHandler = class extends BaseCallbackHandler {
     this.traceShipper = opts.traceShipper;
     this.userId = opts.userId;
     this.convoId = opts.convoId;
+    this.eventName = opts.eventName;
+    this.eventIdSource = opts.eventId;
     this.traceChains = opts.traceChains ?? true;
   }
   getEventId(runId, parentRunId) {
     const rootId = parentRunId ? this.rootRunIds.get(parentRunId) ?? parentRunId : runId;
     this.rootRunIds.set(runId, rootId);
     if (!this.eventIds.has(rootId)) {
-      this.eventIds.set(rootId, randomUUID());
+      this.eventIds.set(rootId, resolveEventId(this.eventIdSource));
     }
     return this.eventIds.get(rootId);
   }
@@ -1248,10 +1263,11 @@ var RaindropDeepAgentsHandler = class extends BaseCallbackHandler {
     const eventId = this.eventIds.get(rootId);
     if (!eventId) return;
     if (isRoot) {
-      if (this.convoId) {
+      if (this.convoId || this.eventName) {
         await this.eventShipper.patch(eventId, {
           userId: this.userId,
           convoId: this.convoId,
+          eventName: this.eventName,
           isPending: true
         });
       }
@@ -1260,6 +1276,7 @@ var RaindropDeepAgentsHandler = class extends BaseCallbackHandler {
       await this.eventShipper.patch(eventId, {
         userId: this.userId,
         convoId: this.convoId,
+        eventName: this.eventName,
         ...patch,
         isPending: true
       });
@@ -1286,6 +1303,7 @@ var RaindropDeepAgentsHandler = class extends BaseCallbackHandler {
       await this.eventShipper.patch(eventId, {
         userId: this.userId,
         convoId: this.convoId,
+        eventName: this.eventName,
         input: truncate(prompts.join("\n"), CHAIN_TEXT_MAX_LEN),
         properties: buildProperties(tags, metadata),
         isPending: true
@@ -1319,6 +1337,7 @@ var RaindropDeepAgentsHandler = class extends BaseCallbackHandler {
       await this.eventShipper.patch(eventId, {
         userId: this.userId,
         convoId: this.convoId,
+        eventName: this.eventName,
         input: inputText,
         properties: buildProperties(tags, metadata),
         isPending: true
@@ -1738,6 +1757,8 @@ function createRaindropDeepAgents(opts) {
     traceShipper,
     userId: opts.userId,
     convoId: opts.convoId,
+    eventName: opts.eventName,
+    eventId: opts.eventId,
     traceChains: opts.traceChains
   });
   return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@raindrop-ai/deep-agents",
-  "version": "0.0.6",
+  "version": "0.1.0",
   "description": "Raindrop integration for LangChain Deep Agents",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -36,7 +36,7 @@
     "typescript": "^5.3.3",
     "vitest": "^2.1.9",
     "zod": "^3.23.0",
-    "@raindrop-ai/core": "0.0.5"
+    "@raindrop-ai/core": "0.1.2"
   },
   "tsup": {
     "entry": [