@raindrop-ai/ai-sdk 0.0.34 → 0.0.36

package/dist/{chunk-OLOFN54C.mjs → chunk-NHSRCEYN.mjs}

@@ -1,6 +1,6 @@
 import { AsyncLocalStorage } from 'async_hooks';
 
-// ../core/dist/chunk-U5HUTMR5.js
+// ../core/dist/chunk-SK6EJEO7.js
 function getCrypto() {
   const c = globalThis.crypto;
   return c;
@@ -397,6 +397,25 @@ function sendLocalDebuggerLiveEvent(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) {
@@ -431,6 +450,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: {
@@ -449,6 +472,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 —
@@ -578,7 +604,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(
@@ -614,7 +640,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(
@@ -710,7 +736,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 {
@@ -857,6 +883,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;
@@ -933,6 +963,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);
@@ -1064,7 +1097,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 {
@@ -2142,10 +2175,7 @@ var RaindropTelemetryIntegration = class {
     };
     /** Flush and stop the background flush timers. */
     this.shutdown = async () => {
-      await Promise.all([
-        this.eventShipper.shutdown(),
-        this.traceShipper.shutdown()
-      ]);
+      await Promise.all([this.eventShipper.shutdown(), this.traceShipper.shutdown()]);
     };
     // ── onStart ─────────────────────────────────────────────────────────────
     this.onStart = (event) => {
@@ -2164,12 +2194,9 @@ var RaindropTelemetryIntegration = class {
       const explicitEventId = callMeta.eventId && !eventIdGenerated ? callMeta.eventId : void 0;
       const eventId = (_d = (_c = (_b = explicitEventId != null ? explicitEventId : (_a = this.defaultContext) == null ? void 0 : _a.eventId) != null ? _b : inherited == null ? void 0 : inherited.eventId) != null ? _c : callMeta.eventId) != null ? _d : randomUUID();
       const inheritedParent = inherited && inherited.eventId === eventId ? { traceIdB64: inherited.traceIdB64, spanIdB64: inherited.spanIdB64 } : void 0;
-      const { operationName, resourceName } = opName(
-        event.operationId,
-        functionId
-      );
+      const { operationName, resourceName } = opName(event.operationId, functionId);
       const parentToolContext = !isEmbed && this.subagentWrapping ? getCurrentParentToolContext() : void 0;
-      const metadataSubagentName = !isEmbed && this.subagentWrapping && parentToolContext === void 0 ? typeof (metadata == null ? void 0 : metadata["ash.subagent.name"]) === "string" ? metadata["ash.subagent.name"] : void 0 : void 0;
+      const metadataSubagentName = !isEmbed && this.subagentWrapping && parentToolContext === void 0 ? typeof (metadata == null ? void 0 : metadata["eve.subagent.name"]) === "string" ? metadata["eve.subagent.name"] : typeof (metadata == null ? void 0 : metadata["ash.subagent.name"]) === "string" ? metadata["ash.subagent.name"] : void 0 : void 0;
       const subagentName = (_e = parentToolContext == null ? void 0 : parentToolContext.toolName) != null ? _e : metadataSubagentName;
       let subagentToolCallSpan;
       let rootParentOverride;
@@ -2221,12 +2248,7 @@ var RaindropTelemetryIntegration = class {
             })
           )
         ] : [];
-        const embedAttrs = isEmbed && recordInputs ? event.operationId === "ai.embedMany" ? [
-          attrString(
-            "ai.values",
-            safeJsonWithUint8(event.value)
-          )
-        ] : [attrString("ai.value", safeJsonWithUint8(event.value))] : [];
+        const embedAttrs = isEmbed && recordInputs ? event.operationId === "ai.embedMany" ? [attrString("ai.values", safeJsonWithUint8(event.value))] : [attrString("ai.value", safeJsonWithUint8(event.value))] : [];
         rootSpan = this.traceShipper.startSpan({
           name: event.operationId,
           parent: rootParentOverride != null ? rootParentOverride : inheritedParent,
@@ -2280,19 +2302,11 @@ var RaindropTelemetryIntegration = class {
       if (!(state == null ? void 0 : state.rootSpan) || !state.rootParent) return;
       const isStream = state.operationId === "ai.streamText" || state.operationId === "ai.streamObject";
       const stepOperationId = isStream ? `${state.operationId}.doStream` : `${state.operationId}.doGenerate`;
-      const { operationName, resourceName } = opName(
-        stepOperationId,
-        state.functionId
-      );
+      const { operationName, resourceName } = opName(stepOperationId, state.functionId);
       const inputAttrs = [];
       if (state.recordInputs) {
         if (event.promptMessages) {
-          inputAttrs.push(
-            attrString(
-              "ai.prompt.messages",
-              safeJsonWithUint8(event.promptMessages)
-            )
-          );
+          inputAttrs.push(attrString("ai.prompt.messages", safeJsonWithUint8(event.promptMessages)));
         }
         if (event.stepTools) {
           inputAttrs.push(
@@ -2307,10 +2321,7 @@ var RaindropTelemetryIntegration = class {
         }
         if (event.stepToolChoice != null) {
           inputAttrs.push(
-            attrString(
-              "ai.prompt.toolChoice",
-              safeJsonWithUint8(event.stepToolChoice)
-            )
+            attrString("ai.prompt.toolChoice", safeJsonWithUint8(event.stepToolChoice))
           );
         }
       }
@@ -2445,16 +2456,8 @@ var RaindropTelemetryIntegration = class {
     this.onEmbedStart = (event) => {
       const state = this.getState(event.callId);
       if (!(state == null ? void 0 : state.rootSpan) || !state.rootParent) return;
-      const { operationName, resourceName } = opName(
-        event.operationId,
-        state.functionId
-      );
-      const inputAttrs = state.recordInputs ? [
-        attrString(
-          "ai.values",
-          safeJsonWithUint8(event.values)
-        )
-      ] : [];
+      const { operationName, resourceName } = opName(event.operationId, state.functionId);
+      const inputAttrs = state.recordInputs ? [attrString("ai.values", safeJsonWithUint8(event.values))] : [];
       const embedSpan = this.traceShipper.startSpan({
         name: event.operationId,
         parent: state.rootParent,
@@ -2478,12 +2481,7 @@ var RaindropTelemetryIntegration = class {
       if (!embedSpan) return;
       const outputAttrs = [];
       if (state.recordOutputs) {
-        outputAttrs.push(
-          attrString(
-            "ai.embeddings",
-            safeJsonWithUint8(event.embeddings)
-          )
-        );
+        outputAttrs.push(attrString("ai.embeddings", safeJsonWithUint8(event.embeddings)));
       }
       if (((_a = event.usage) == null ? void 0 : _a.tokens) != null) {
         outputAttrs.push(attrInt("ai.usage.tokens", event.usage.tokens));
@@ -2701,10 +2699,7 @@ var RaindropTelemetryIntegration = class {
   toolExecutionStart(event) {
     const { toolCall } = event;
     const priorParent = getCurrentParentToolContext();
-    this.priorParentContexts.set(
-      toolCall.toolCallId,
-      priorParent != null ? priorParent : null
-    );
+    this.priorParentContexts.set(toolCall.toolCallId, priorParent != null ? priorParent : null);
     enterParentToolContext({
       parentCallId: event.callId,
       toolCallId: toolCall.toolCallId,
@@ -2713,10 +2708,7 @@ var RaindropTelemetryIntegration = class {
     const state = this.getState(event.callId);
     state == null ? void 0 : state.parentContextToolCallIds.add(toolCall.toolCallId);
     if (!(state == null ? void 0 : state.stepParent)) return;
-    const { operationName, resourceName } = opName(
-      "ai.toolCall",
-      state.functionId
-    );
+    const { operationName, resourceName } = opName("ai.toolCall", state.functionId);
     const inputAttrs = state.recordInputs ? [attrString("ai.toolCall.args", safeJsonWithUint8(toolCall.input))] : [];
     const toolSpan = this.traceShipper.startSpan({
       name: "ai.toolCall",
@@ -2793,10 +2785,7 @@ var RaindropTelemetryIntegration = class {
       }
     }
     for (const call of providerToolCalls) {
-      const { operationName, resourceName } = opName(
-        "ai.toolCall",
-        state.functionId
-      );
+      const { operationName, resourceName } = opName("ai.toolCall", state.functionId);
       const inputAttrs = state.recordInputs ? [attrString("ai.toolCall.args", safeJsonWithUint8(call.input))] : [];
       const toolSpan = this.traceShipper.startSpan({
         name: "ai.toolCall",
@@ -2819,12 +2808,7 @@ var RaindropTelemetryIntegration = class {
       if ((resultPart == null ? void 0 : resultPart.type) === "tool-error") {
         this.traceShipper.endSpan(toolSpan, { error: resultPart.error });
       } else {
-        const outputAttrs = state.recordOutputs && resultPart && "output" in resultPart ? [
-          attrString(
-            "ai.toolCall.result",
-            safeJsonWithUint8(resultPart.output)
-          )
-        ] : [];
+        const outputAttrs = state.recordOutputs && resultPart && "output" in resultPart ? [attrString("ai.toolCall.result", safeJsonWithUint8(resultPart.output))] : [];
         this.traceShipper.endSpan(toolSpan, { attributes: outputAttrs });
       }
       this.emitLive(state, "tool_result", call.toolName);
@@ -2874,9 +2858,7 @@ var RaindropTelemetryIntegration = class {
           attrInt("ai.usage.cachedInputTokens", usage.cachedInputTokens)
         );
       }
-      outputAttrs.push(
-        attrInt("ai.toolCall.count", state.toolCallCount)
-      );
+      outputAttrs.push(attrInt("ai.toolCall.count", state.toolCallCount));
       this.traceShipper.endSpan(state.rootSpan, { attributes: outputAttrs });
     }
     this.finalizeGenerateEvent(
@@ -2929,13 +2911,9 @@ var RaindropTelemetryIntegration = class {
     const isMany = state.operationId === "ai.embedMany";
     if (state.recordOutputs) {
       if (isMany) {
-        outputAttrs.push(
-          attrString("ai.embeddings", safeJsonWithUint8(event.embedding))
-        );
+        outputAttrs.push(attrString("ai.embeddings", safeJsonWithUint8(event.embedding)));
       } else {
-        outputAttrs.push(
-          attrString("ai.embedding", safeJsonWithUint8(event.embedding))
-        );
+        outputAttrs.push(attrString("ai.embedding", safeJsonWithUint8(event.embedding)));
       }
     }
     if (((_a = event.usage) == null ? void 0 : _a.tokens) != null) {
@@ -5014,7 +4992,7 @@ function extractNestedTokens(usage, key) {
 // package.json
 var package_default = {
   name: "@raindrop-ai/ai-sdk",
-  version: "0.0.34"};
+  version: "0.0.36"};
 
 // src/internal/version.ts
 var libraryName = package_default.name;
@@ -5124,6 +5102,7 @@ function createRaindropAISDK(opts) {
     enabled: eventsEnabled,
     debug: ((_c = opts.events) == null ? void 0 : _c.debug) === true || envDebug,
     partialFlushMs: (_d = opts.events) == null ? void 0 : _d.partialFlushMs,
+    projectId: opts.projectId,
     localDebuggerUrl
   });
   const traceShipper = new TraceShipper2({
@@ -5135,6 +5114,7 @@ function createRaindropAISDK(opts) {
     flushIntervalMs: (_g = opts.traces) == null ? void 0 : _g.flushIntervalMs,
     maxBatchSize: (_h = opts.traces) == null ? void 0 : _h.maxBatchSize,
     maxQueueSize: (_i = opts.traces) == null ? void 0 : _i.maxQueueSize,
+    projectId: opts.projectId,
     localDebuggerUrl,
     transformSpan: (_j = opts.traces) == null ? void 0 : _j.transformSpan,
     disableDefaultRedaction: (_k = opts.traces) == null ? void 0 : _k.disableDefaultRedaction

package/dist/{index-HYjRP6nV.d.mts → index-Crm3oDAG.d.mts}

@@ -83,6 +83,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 —
@@ -101,6 +108,7 @@ declare class EventShipper$1 {
     private sdkName;
     private prefix;
     private defaultEventName;
+    private projectId;
     private context;
     private buffers;
     private sticky;
@@ -124,6 +132,7 @@ declare class EventShipper$1 {
     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 —
@@ -254,6 +263,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
@@ -311,6 +327,7 @@ declare class TraceShipper$1 {
     private flushIntervalMs;
     private maxBatchSize;
     private maxQueueSize;
+    private projectId;
     private queue;
     private timer;
     private inFlight;
@@ -361,6 +378,7 @@ declare class TraceShipper$1 {
     private redactSpan;
     isDebugEnabled(): boolean;
     private authHeaders;
+    private requestHeaders;
     startSpan(args: {
         name: string;
         parent?: {
@@ -685,7 +703,7 @@ declare function _resetWarnedMissingUserId(): void;
  * Problem
  * ───────
  * When a tool's `execute` callback recursively calls `streamText` /
- * `generateText` (which is exactly how Ash lowers sub-agents, but also a
+ * `generateText` (which is exactly how Eve lowers sub-agents, but also a
  * common pattern in hand-rolled agent loops, Mastra, Claude Agent SDK,
  * etc.), the inner generation's telemetry events are dispatched with no
  * connection back to the outer tool call. The AI SDK fires `onStart` for
@@ -899,6 +917,12 @@ type RaindropAISDKOptions = {
      */
     writeKey?: string;
     endpoint?: 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;
     /**
      * Force-enable (or opt out of) Workshop / local-debugger mirroring.
      *

package/dist/{index-HYjRP6nV.d.ts → index-Crm3oDAG.d.ts}

@@ -83,6 +83,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 —
@@ -101,6 +108,7 @@ declare class EventShipper$1 {
     private sdkName;
     private prefix;
     private defaultEventName;
+    private projectId;
     private context;
     private buffers;
     private sticky;
@@ -124,6 +132,7 @@ declare class EventShipper$1 {
     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 —
@@ -254,6 +263,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
@@ -311,6 +327,7 @@ declare class TraceShipper$1 {
     private flushIntervalMs;
     private maxBatchSize;
     private maxQueueSize;
+    private projectId;
     private queue;
     private timer;
     private inFlight;
@@ -361,6 +378,7 @@ declare class TraceShipper$1 {
     private redactSpan;
     isDebugEnabled(): boolean;
     private authHeaders;
+    private requestHeaders;
     startSpan(args: {
         name: string;
         parent?: {
@@ -685,7 +703,7 @@ declare function _resetWarnedMissingUserId(): void;
  * Problem
  * ───────
  * When a tool's `execute` callback recursively calls `streamText` /
- * `generateText` (which is exactly how Ash lowers sub-agents, but also a
+ * `generateText` (which is exactly how Eve lowers sub-agents, but also a
  * common pattern in hand-rolled agent loops, Mastra, Claude Agent SDK,
  * etc.), the inner generation's telemetry events are dispatched with no
  * connection back to the outer tool call. The AI SDK fires `onStart` for
@@ -899,6 +917,12 @@ type RaindropAISDKOptions = {
      */
     writeKey?: string;
     endpoint?: 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;
     /**
      * Force-enable (or opt out of) Workshop / local-debugger mirroring.
      *

package/dist/index.browser.d.mts

@@ -83,6 +83,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 —
@@ -101,6 +108,7 @@ declare class EventShipper$1 {
     private sdkName;
     private prefix;
     private defaultEventName;
+    private projectId;
     private context;
     private buffers;
     private sticky;
@@ -124,6 +132,7 @@ declare class EventShipper$1 {
     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 —
@@ -254,6 +263,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
@@ -311,6 +327,7 @@ declare class TraceShipper$1 {
     private flushIntervalMs;
     private maxBatchSize;
     private maxQueueSize;
+    private projectId;
     private queue;
     private timer;
     private inFlight;
@@ -361,6 +378,7 @@ declare class TraceShipper$1 {
     private redactSpan;
     isDebugEnabled(): boolean;
     private authHeaders;
+    private requestHeaders;
     startSpan(args: {
         name: string;
         parent?: {
@@ -685,7 +703,7 @@ declare function _resetWarnedMissingUserId(): void;
  * Problem
  * ───────
  * When a tool's `execute` callback recursively calls `streamText` /
- * `generateText` (which is exactly how Ash lowers sub-agents, but also a
+ * `generateText` (which is exactly how Eve lowers sub-agents, but also a
  * common pattern in hand-rolled agent loops, Mastra, Claude Agent SDK,
  * etc.), the inner generation's telemetry events are dispatched with no
  * connection back to the outer tool call. The AI SDK fires `onStart` for
@@ -899,6 +917,12 @@ type RaindropAISDKOptions = {
      */
     writeKey?: string;
     endpoint?: 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;
     /**
      * Force-enable (or opt out of) Workshop / local-debugger mirroring.
      *

package/dist/index.browser.d.ts

@@ -83,6 +83,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 —
@@ -101,6 +108,7 @@ declare class EventShipper$1 {
     private sdkName;
     private prefix;
     private defaultEventName;
+    private projectId;
     private context;
     private buffers;
     private sticky;
@@ -124,6 +132,7 @@ declare class EventShipper$1 {
     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 —
@@ -254,6 +263,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
@@ -311,6 +327,7 @@ declare class TraceShipper$1 {
     private flushIntervalMs;
     private maxBatchSize;
     private maxQueueSize;
+    private projectId;
     private queue;
     private timer;
     private inFlight;
@@ -361,6 +378,7 @@ declare class TraceShipper$1 {
     private redactSpan;
     isDebugEnabled(): boolean;
     private authHeaders;
+    private requestHeaders;
     startSpan(args: {
         name: string;
         parent?: {
@@ -685,7 +703,7 @@ declare function _resetWarnedMissingUserId(): void;
  * Problem
  * ───────
  * When a tool's `execute` callback recursively calls `streamText` /
- * `generateText` (which is exactly how Ash lowers sub-agents, but also a
+ * `generateText` (which is exactly how Eve lowers sub-agents, but also a
  * common pattern in hand-rolled agent loops, Mastra, Claude Agent SDK,
  * etc.), the inner generation's telemetry events are dispatched with no
  * connection back to the outer tool call. The AI SDK fires `onStart` for
@@ -899,6 +917,12 @@ type RaindropAISDKOptions = {
      */
     writeKey?: string;
     endpoint?: 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;
     /**
      * Force-enable (or opt out of) Workshop / local-debugger mirroring.
      *