@raindrop-ai/deep-agents 0.0.2 → 0.0.4

package/README.md

@@ -120,4 +120,4 @@ The dashboard token comes from `app.raindrop.ai` → DevTools → Network → an
 
 ## Python
 
-A Python version of this integration is available as `raindrop-deep-agents` on PyPI. See [the Python package](https://github.com/invisible-tools/dawn/tree/main/packages/deep-agents-python) for details.
+A Python version of this integration is available as `raindrop-deep-agents` on PyPI. See [the Python package](https://pypi.org/project/raindrop-deep-agents/) for details.

package/dist/index.d.mts

@@ -90,6 +90,13 @@ type EventShipperOptions = {
      * Pass `null` to opt out of all mirroring (including auto-detect).
      */
     localDebuggerUrl?: string | null;
+    /**
+     * Optional project slug. When set, every outbound cloud request includes an
+     * `X-Raindrop-Project-Id: <projectId>` header. Empty / whitespace-only
+     * values are ignored. Slug format is validated on construction but never
+     * throws — the backend returns 400 on invalid values.
+     */
+    projectId?: string;
     /**
      * Per-field character cap applied to event input/output BEFORE buffering
      * or serialization, so oversized payloads cost the cap — not the payload —
@@ -108,6 +115,7 @@ declare class EventShipper {
     private sdkName;
     private prefix;
     private defaultEventName;
+    private projectId;
     private context;
     private buffers;
     private sticky;
@@ -131,6 +139,7 @@ declare class EventShipper {
     constructor(opts: EventShipperOptions);
     isDebugEnabled(): boolean;
     private authHeaders;
+    private requestHeaders;
     /**
      * Build the retry/timeout options for one POST, honoring the shutdown
      * deadline. Returns `null` when the shutdown drain window is exhausted —
@@ -202,6 +211,13 @@ type TraceShipperOptions = {
      * Pass `null` to opt out of all mirroring (including auto-detect).
      */
     localDebuggerUrl?: string | null;
+    /**
+     * Optional project slug. When set, every OTLP trace export includes an
+     * `X-Raindrop-Project-Id: <projectId>` header. Empty / whitespace-only
+     * values are ignored. Slug format is validated on construction but never
+     * throws — the backend returns 400 on invalid values.
+     */
+    projectId?: string;
     /**
      * Per-span hook that fires for every OTLP span right before the span is
      * shipped (both to the Raindrop API and to a local debugger). Lets callers
@@ -259,6 +275,7 @@ declare class TraceShipper {
     private flushIntervalMs;
     private maxBatchSize;
     private maxQueueSize;
+    private projectId;
     private queue;
     private timer;
     private inFlight;
@@ -309,6 +326,7 @@ declare class TraceShipper {
     private redactSpan;
     isDebugEnabled(): boolean;
     private authHeaders;
+    private requestHeaders;
     startSpan(args: {
         name: string;
         parent?: {
@@ -427,6 +445,12 @@ interface DeepAgentsOptions {
     debug?: boolean;
     userId?: string;
     convoId?: string;
+    /**
+     * Optional Raindrop project slug. When set, every outbound cloud request
+     * carries an `X-Raindrop-Project-Id` header. Unset → no header (the project
+     * resolves to `default` server-side; byte-identical to prior behavior).
+     */
+    projectId?: string;
     traceChains?: boolean;
 }
 type RaindropDeepAgentsClient = {

package/dist/index.d.ts

@@ -90,6 +90,13 @@ type EventShipperOptions = {
      * Pass `null` to opt out of all mirroring (including auto-detect).
      */
     localDebuggerUrl?: string | null;
+    /**
+     * Optional project slug. When set, every outbound cloud request includes an
+     * `X-Raindrop-Project-Id: <projectId>` header. Empty / whitespace-only
+     * values are ignored. Slug format is validated on construction but never
+     * throws — the backend returns 400 on invalid values.
+     */
+    projectId?: string;
     /**
      * Per-field character cap applied to event input/output BEFORE buffering
      * or serialization, so oversized payloads cost the cap — not the payload —
@@ -108,6 +115,7 @@ declare class EventShipper {
     private sdkName;
     private prefix;
     private defaultEventName;
+    private projectId;
     private context;
     private buffers;
     private sticky;
@@ -131,6 +139,7 @@ declare class EventShipper {
     constructor(opts: EventShipperOptions);
     isDebugEnabled(): boolean;
     private authHeaders;
+    private requestHeaders;
     /**
      * Build the retry/timeout options for one POST, honoring the shutdown
      * deadline. Returns `null` when the shutdown drain window is exhausted —
@@ -202,6 +211,13 @@ type TraceShipperOptions = {
      * Pass `null` to opt out of all mirroring (including auto-detect).
      */
     localDebuggerUrl?: string | null;
+    /**
+     * Optional project slug. When set, every OTLP trace export includes an
+     * `X-Raindrop-Project-Id: <projectId>` header. Empty / whitespace-only
+     * values are ignored. Slug format is validated on construction but never
+     * throws — the backend returns 400 on invalid values.
+     */
+    projectId?: string;
     /**
      * Per-span hook that fires for every OTLP span right before the span is
      * shipped (both to the Raindrop API and to a local debugger). Lets callers
@@ -259,6 +275,7 @@ declare class TraceShipper {
     private flushIntervalMs;
     private maxBatchSize;
     private maxQueueSize;
+    private projectId;
     private queue;
     private timer;
     private inFlight;
@@ -309,6 +326,7 @@ declare class TraceShipper {
     private redactSpan;
     isDebugEnabled(): boolean;
     private authHeaders;
+    private requestHeaders;
     startSpan(args: {
         name: string;
         parent?: {
@@ -427,6 +445,12 @@ interface DeepAgentsOptions {
     debug?: boolean;
     userId?: string;
     convoId?: string;
+    /**
+     * Optional Raindrop project slug. When set, every outbound cloud request
+     * carries an `X-Raindrop-Project-Id` header. Unset → no header (the project
+     * resolves to `default` server-side; byte-identical to prior behavior).
+     */
+    projectId?: string;
     traceChains?: boolean;
 }
 type RaindropDeepAgentsClient = {

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-U5HUTMR5.js
+// ../core/dist/chunk-SK6EJEO7.js
 function getCrypto() {
   const c = globalThis.crypto;
   return c;
@@ -380,6 +380,25 @@ function mirrorPartialEventToLocalDebugger(event, options = {}) {
   }).catch(() => {
   });
 }
+var PROJECT_ID_HEADER = "X-Raindrop-Project-Id";
+var PROJECT_ID_SLUG_PATTERN = /^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/;
+function isValidProjectIdSlug(value) {
+  return PROJECT_ID_SLUG_PATTERN.test(value);
+}
+function normalizeProjectId(raw, opts) {
+  if (typeof raw !== "string") return void 0;
+  const trimmed = raw.trim();
+  if (!trimmed) return void 0;
+  if (!isValidProjectIdSlug(trimmed) && opts.debug) {
+    console.warn(
+      `${opts.prefix} projectId "${trimmed}" does not match slug ${PROJECT_ID_SLUG_PATTERN.source}; sending anyway \u2014 backend may reject with HTTP 400`
+    );
+  }
+  return trimmed;
+}
+function projectIdHeaders(projectId) {
+  return projectId ? { [PROJECT_ID_HEADER]: projectId } : {};
+}
 var SHUTDOWN_DEADLINE_MS = 1e4;
 var POST_SHUTDOWN_TIMEOUT_MS = 5e3;
 function mergePatches(target, source) {
@@ -414,6 +433,10 @@ var EventShipper = class {
     if (this.debug && this.localDebuggerUrl) {
       console.log(`${this.prefix} Local debugger mirroring: ${this.localDebuggerUrl}`);
     }
+    this.projectId = normalizeProjectId(opts.projectId, {
+      debug: this.debug,
+      prefix: this.prefix
+    });
     const isNode = typeof process !== "undefined" && typeof process.version === "string";
     this.context = {
       library: {
@@ -432,6 +455,9 @@ var EventShipper = class {
   authHeaders() {
     return this.writeKey ? { Authorization: `Bearer ${this.writeKey}` } : {};
   }
+  requestHeaders() {
+    return { ...this.authHeaders(), ...projectIdHeaders(this.projectId) };
+  }
   /**
    * Build the retry/timeout options for one POST, honoring the shutdown
    * deadline. Returns `null` when the shutdown drain window is exhausted —
@@ -561,7 +587,7 @@ var EventShipper = class {
       return;
     }
     try {
-      await postJson(url, body, this.authHeaders(), opts);
+      await postJson(url, body, this.requestHeaders(), opts);
     } catch (err) {
       const msg = err instanceof Error ? err.message : String(err);
       rateLimitedLog(
@@ -597,7 +623,7 @@ var EventShipper = class {
       return;
     }
     try {
-      await postJson(url, body, this.authHeaders(), opts);
+      await postJson(url, body, this.requestHeaders(), opts);
     } catch (err) {
       const msg = err instanceof Error ? err.message : String(err);
       rateLimitedLog(
@@ -693,7 +719,7 @@ var EventShipper = class {
       if (!isPending) this.sticky.delete(eventId);
       return;
     }
-    const p = postJson(url, payload, this.authHeaders(), opts);
+    const p = postJson(url, payload, this.requestHeaders(), opts);
     this.inFlight.add(p);
     try {
       try {
@@ -840,6 +866,10 @@ var TraceShipper = class {
     if (this.debug && this.localDebuggerUrl) {
       console.log(`${this.prefix} Local debugger mirroring: ${this.localDebuggerUrl}`);
     }
+    this.projectId = normalizeProjectId(opts.projectId, {
+      debug: this.debug,
+      prefix: this.prefix
+    });
     this.transformSpanHook = opts.transformSpan;
     this.disableDefaultRedaction = opts.disableDefaultRedaction === true;
     this.maxTextFieldCharsOpt = opts.maxTextFieldChars;
@@ -916,6 +946,9 @@ var TraceShipper = class {
   authHeaders() {
     return this.writeKey ? { Authorization: `Bearer ${this.writeKey}` } : {};
   }
+  requestHeaders() {
+    return { ...this.authHeaders(), ...projectIdHeaders(this.projectId) };
+  }
   startSpan(args) {
     var _a, _b;
     const ids = createSpanIds(args.parent);
@@ -1047,7 +1080,7 @@ var TraceShipper = class {
           endpoint: url
         });
       }
-      const p = postJson(url, body, this.authHeaders(), opts);
+      const p = postJson(url, body, this.requestHeaders(), opts);
       this.inFlight.add(p);
       try {
         try {
@@ -1671,6 +1704,7 @@ function createRaindropDeepAgents(opts) {
     endpoint: opts.endpoint,
     enabled,
     debug: opts.debug ?? false,
+    projectId: opts.projectId,
     sdkName: "deep-agents",
     libraryName,
     libraryVersion
@@ -1680,6 +1714,7 @@ function createRaindropDeepAgents(opts) {
     endpoint: opts.endpoint,
     enabled,
     debug: opts.debug ?? false,
+    projectId: opts.projectId,
     sdkName: "deep-agents",
     serviceName: "raindrop.deep-agents",
     serviceVersion: libraryVersion

package/dist/index.mjs

@@ -1,7 +1,7 @@
 // src/callback-handler.ts
 import { BaseCallbackHandler } from "@langchain/core/callbacks/base";
 
-// ../core/dist/chunk-U5HUTMR5.js
+// ../core/dist/chunk-SK6EJEO7.js
 function getCrypto() {
   const c = globalThis.crypto;
   return c;
@@ -353,6 +353,25 @@ function mirrorPartialEventToLocalDebugger(event, options = {}) {
   }).catch(() => {
   });
 }
+var PROJECT_ID_HEADER = "X-Raindrop-Project-Id";
+var PROJECT_ID_SLUG_PATTERN = /^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/;
+function isValidProjectIdSlug(value) {
+  return PROJECT_ID_SLUG_PATTERN.test(value);
+}
+function normalizeProjectId(raw, opts) {
+  if (typeof raw !== "string") return void 0;
+  const trimmed = raw.trim();
+  if (!trimmed) return void 0;
+  if (!isValidProjectIdSlug(trimmed) && opts.debug) {
+    console.warn(
+      `${opts.prefix} projectId "${trimmed}" does not match slug ${PROJECT_ID_SLUG_PATTERN.source}; sending anyway \u2014 backend may reject with HTTP 400`
+    );
+  }
+  return trimmed;
+}
+function projectIdHeaders(projectId) {
+  return projectId ? { [PROJECT_ID_HEADER]: projectId } : {};
+}
 var SHUTDOWN_DEADLINE_MS = 1e4;
 var POST_SHUTDOWN_TIMEOUT_MS = 5e3;
 function mergePatches(target, source) {
@@ -387,6 +406,10 @@ var EventShipper = class {
     if (this.debug && this.localDebuggerUrl) {
       console.log(`${this.prefix} Local debugger mirroring: ${this.localDebuggerUrl}`);
     }
+    this.projectId = normalizeProjectId(opts.projectId, {
+      debug: this.debug,
+      prefix: this.prefix
+    });
     const isNode = typeof process !== "undefined" && typeof process.version === "string";
     this.context = {
       library: {
@@ -405,6 +428,9 @@ var EventShipper = class {
   authHeaders() {
     return this.writeKey ? { Authorization: `Bearer ${this.writeKey}` } : {};
   }
+  requestHeaders() {
+    return { ...this.authHeaders(), ...projectIdHeaders(this.projectId) };
+  }
   /**
    * Build the retry/timeout options for one POST, honoring the shutdown
    * deadline. Returns `null` when the shutdown drain window is exhausted —
@@ -534,7 +560,7 @@ var EventShipper = class {
       return;
     }
     try {
-      await postJson(url, body, this.authHeaders(), opts);
+      await postJson(url, body, this.requestHeaders(), opts);
     } catch (err) {
       const msg = err instanceof Error ? err.message : String(err);
       rateLimitedLog(
@@ -570,7 +596,7 @@ var EventShipper = class {
       return;
     }
     try {
-      await postJson(url, body, this.authHeaders(), opts);
+      await postJson(url, body, this.requestHeaders(), opts);
     } catch (err) {
       const msg = err instanceof Error ? err.message : String(err);
       rateLimitedLog(
@@ -666,7 +692,7 @@ var EventShipper = class {
       if (!isPending) this.sticky.delete(eventId);
       return;
     }
-    const p = postJson(url, payload, this.authHeaders(), opts);
+    const p = postJson(url, payload, this.requestHeaders(), opts);
     this.inFlight.add(p);
     try {
       try {
@@ -813,6 +839,10 @@ var TraceShipper = class {
     if (this.debug && this.localDebuggerUrl) {
       console.log(`${this.prefix} Local debugger mirroring: ${this.localDebuggerUrl}`);
     }
+    this.projectId = normalizeProjectId(opts.projectId, {
+      debug: this.debug,
+      prefix: this.prefix
+    });
     this.transformSpanHook = opts.transformSpan;
     this.disableDefaultRedaction = opts.disableDefaultRedaction === true;
     this.maxTextFieldCharsOpt = opts.maxTextFieldChars;
@@ -889,6 +919,9 @@ var TraceShipper = class {
   authHeaders() {
     return this.writeKey ? { Authorization: `Bearer ${this.writeKey}` } : {};
   }
+  requestHeaders() {
+    return { ...this.authHeaders(), ...projectIdHeaders(this.projectId) };
+  }
   startSpan(args) {
     var _a, _b;
     const ids = createSpanIds(args.parent);
@@ -1020,7 +1053,7 @@ var TraceShipper = class {
           endpoint: url
         });
       }
-      const p = postJson(url, body, this.authHeaders(), opts);
+      const p = postJson(url, body, this.requestHeaders(), opts);
       this.inFlight.add(p);
       try {
         try {
@@ -1644,6 +1677,7 @@ function createRaindropDeepAgents(opts) {
     endpoint: opts.endpoint,
     enabled,
     debug: opts.debug ?? false,
+    projectId: opts.projectId,
     sdkName: "deep-agents",
     libraryName,
     libraryVersion
@@ -1653,6 +1687,7 @@ function createRaindropDeepAgents(opts) {
     endpoint: opts.endpoint,
     enabled,
     debug: opts.debug ?? false,
+    projectId: opts.projectId,
     sdkName: "deep-agents",
     serviceName: "raindrop.deep-agents",
     serviceVersion: libraryVersion

package/package.json

@@ -1,19 +1,14 @@
 {
   "name": "@raindrop-ai/deep-agents",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "Raindrop integration for LangChain Deep Agents",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
   "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/raindrop-ai/raindrop-js.git",
-    "directory": "packages/deep-agents"
-  },
-  "homepage": "https://github.com/raindrop-ai/raindrop-js/tree/main/packages/deep-agents#readme",
+  "homepage": "https://www.raindrop.ai/docs/integrations/deepagents/",
   "bugs": {
-    "url": "https://github.com/raindrop-ai/raindrop-js/issues"
+    "url": "https://www.raindrop.ai/docs/support/"
   },
   "exports": {
     ".": {
@@ -41,7 +36,7 @@
     "typescript": "^5.3.3",
     "vitest": "^2.1.9",
     "zod": "^3.23.0",
-    "@raindrop-ai/core": "0.0.3"
+    "@raindrop-ai/core": "0.0.4"
   },
   "tsup": {
     "entry": [