@raindrop-ai/pi-agent 0.0.5 → 0.0.7

package/dist/{chunk-2NGOEVWI.js → chunk-GILK5ZDM.js}

@@ -1,4 +1,4 @@
-// ../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 {
@@ -1093,18 +1126,13 @@ globalThis.RAINDROP_ASYNC_LOCAL_STORAGE = AsyncLocalStorage;
 // package.json
 var package_default = {
   name: "@raindrop-ai/pi-agent",
-  version: "0.0.5",
+  version: "0.0.7",
   description: "Raindrop observability for Pi Agent \u2014 automatic tracing via subscriber or pi-coding-agent extension",
   type: "module",
   license: "MIT",
-  repository: {
-    type: "git",
-    url: "git+https://github.com/raindrop-ai/raindrop-js.git",
-    directory: "packages/pi-agent"
-  },
-  homepage: "https://github.com/raindrop-ai/raindrop-js/tree/main/packages/pi-agent#readme",
+  homepage: "https://www.raindrop.ai/docs/integrations/pi-agent/",
   bugs: {
-    url: "https://github.com/raindrop-ai/raindrop-js/issues"
+    url: "https://www.raindrop.ai/docs/support/"
   },
   keywords: [
     "pi-package",

package/dist/extension.cjs

@@ -25,7 +25,7 @@ __export(extension_exports, {
 });
 module.exports = __toCommonJS(extension_exports);
 
-// ../core/dist/chunk-U5HUTMR5.js
+// ../core/dist/chunk-SK6EJEO7.js
 function getCrypto() {
   const c = globalThis.crypto;
   return c;
@@ -369,6 +369,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) {
@@ -403,6 +422,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: {
@@ -421,6 +444,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 —
@@ -550,7 +576,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(
@@ -586,7 +612,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(
@@ -682,7 +708,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 {
@@ -829,6 +855,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;
@@ -905,6 +935,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);
@@ -1036,7 +1069,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 {
@@ -1115,7 +1148,7 @@ function getPiAgentDirectory() {
   return (_a = process.env["PI_CODING_AGENT_DIR"]) != null ? _a : (0, import_node_path.join)((0, import_node_os.homedir)(), ".pi", "agent");
 }
 function loadConfig(projectDirectory) {
-  var _a, _b, _c, _d, _e, _f, _g;
+  var _a, _b, _c, _d, _e, _f, _g, _h;
   let merged = {};
   const configPaths = [
     (0, import_node_path.join)(getPiAgentDirectory(), "raindrop.json"),
@@ -1142,9 +1175,10 @@ function loadConfig(projectDirectory) {
   return {
     writeKey: (_b = (_a = process.env["RAINDROP_WRITE_KEY"]) != null ? _a : merged.write_key) != null ? _b : "",
     endpoint: (_d = (_c = process.env["RAINDROP_API_URL"]) != null ? _c : merged.api_url) != null ? _d : "https://api.raindrop.ai/v1",
-    eventName: (_e = merged.event_name) != null ? _e : "pi_session",
-    debug: process.env["RAINDROP_DEBUG"] === "true" ? true : (_f = merged.debug) != null ? _f : false,
-    captureSystemPrompt: process.env["RAINDROP_CAPTURE_SYSTEM_PROMPT"] !== void 0 ? process.env["RAINDROP_CAPTURE_SYSTEM_PROMPT"] === "true" : (_g = merged.capture_system_prompt) != null ? _g : false,
+    projectId: (_e = process.env["RAINDROP_PROJECT_ID"]) != null ? _e : merged.project_id,
+    eventName: (_f = merged.event_name) != null ? _f : "pi_session",
+    debug: process.env["RAINDROP_DEBUG"] === "true" ? true : (_g = merged.debug) != null ? _g : false,
+    captureSystemPrompt: process.env["RAINDROP_CAPTURE_SYSTEM_PROMPT"] !== void 0 ? process.env["RAINDROP_CAPTURE_SYSTEM_PROMPT"] === "true" : (_h = merged.capture_system_prompt) != null ? _h : false,
     eventMetadata,
     localWorkshopUrl: resolveLocalWorkshopUrl(merged.local_workshop_url)
   };
@@ -1163,18 +1197,13 @@ function resolveLocalWorkshopUrl(fileValue) {
 // package.json
 var package_default = {
   name: "@raindrop-ai/pi-agent",
-  version: "0.0.5",
+  version: "0.0.7",
   description: "Raindrop observability for Pi Agent \u2014 automatic tracing via subscriber or pi-coding-agent extension",
   type: "module",
   license: "MIT",
-  repository: {
-    type: "git",
-    url: "git+https://github.com/raindrop-ai/raindrop-js.git",
-    directory: "packages/pi-agent"
-  },
-  homepage: "https://github.com/raindrop-ai/raindrop-js/tree/main/packages/pi-agent#readme",
+  homepage: "https://www.raindrop.ai/docs/integrations/pi-agent/",
   bugs: {
-    url: "https://github.com/raindrop-ai/raindrop-js/issues"
+    url: "https://www.raindrop.ai/docs/support/"
   },
   keywords: [
     "pi-package",
@@ -1820,12 +1849,14 @@ function extension(pi) {
     writeKey: config.writeKey,
     endpoint: config.endpoint,
     debug: config.debug,
+    projectId: config.projectId,
     localDebuggerUrl: config.localWorkshopUrl
   });
   const traceShipper = new TraceShipper2({
     writeKey: config.writeKey,
     endpoint: config.endpoint,
     debug: config.debug,
+    projectId: config.projectId,
     localDebuggerUrl: config.localWorkshopUrl
   });
   registerTracing(pi, config, eventShipper, traceShipper);

package/dist/extension.d.cts

@@ -1,5 +1,5 @@
 import { ExtensionAPI } from '@earendil-works/pi-coding-agent';
-import { E as EventShipper$1, T as TraceShipper$1, O as OtlpSpan } from './index.d-CRPiWjXE.cjs';
+import { E as EventShipper$1, T as TraceShipper$1, O as OtlpSpan } from './index.d-D0J2tEXx.cjs';
 
 interface EventMetadata {
     userId?: string;
@@ -9,6 +9,13 @@ interface EventMetadata {
 interface RaindropExtensionConfig {
     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).
+     * Sourced from `RAINDROP_PROJECT_ID` or the `project_id` config-file key.
+     */
+    projectId?: string;
     eventName: string;
     debug: boolean;
     captureSystemPrompt: boolean;

package/dist/extension.d.ts

@@ -1,5 +1,5 @@
 import { ExtensionAPI } from '@earendil-works/pi-coding-agent';
-import { E as EventShipper$1, T as TraceShipper$1, O as OtlpSpan } from './index.d-CRPiWjXE.js';
+import { E as EventShipper$1, T as TraceShipper$1, O as OtlpSpan } from './index.d-D0J2tEXx.js';
 
 interface EventMetadata {
     userId?: string;
@@ -9,6 +9,13 @@ interface EventMetadata {
 interface RaindropExtensionConfig {
     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).
+     * Sourced from `RAINDROP_PROJECT_ID` or the `project_id` config-file key.
+     */
+    projectId?: string;
     eventName: string;
     debug: boolean;
     captureSystemPrompt: boolean;

package/dist/extension.js

@@ -14,7 +14,7 @@ import {
   resolveLocalDebuggerBaseUrl,
   safeStringify,
   truncate
-} from "./chunk-2NGOEVWI.js";
+} from "./chunk-GILK5ZDM.js";
 
 // src/internal/config.ts
 import { existsSync, readFileSync } from "fs";
@@ -25,7 +25,7 @@ function getPiAgentDirectory() {
   return (_a = process.env["PI_CODING_AGENT_DIR"]) != null ? _a : join(homedir(), ".pi", "agent");
 }
 function loadConfig(projectDirectory) {
-  var _a, _b, _c, _d, _e, _f, _g;
+  var _a, _b, _c, _d, _e, _f, _g, _h;
   let merged = {};
   const configPaths = [
     join(getPiAgentDirectory(), "raindrop.json"),
@@ -52,9 +52,10 @@ function loadConfig(projectDirectory) {
   return {
     writeKey: (_b = (_a = process.env["RAINDROP_WRITE_KEY"]) != null ? _a : merged.write_key) != null ? _b : "",
     endpoint: (_d = (_c = process.env["RAINDROP_API_URL"]) != null ? _c : merged.api_url) != null ? _d : "https://api.raindrop.ai/v1",
-    eventName: (_e = merged.event_name) != null ? _e : "pi_session",
-    debug: process.env["RAINDROP_DEBUG"] === "true" ? true : (_f = merged.debug) != null ? _f : false,
-    captureSystemPrompt: process.env["RAINDROP_CAPTURE_SYSTEM_PROMPT"] !== void 0 ? process.env["RAINDROP_CAPTURE_SYSTEM_PROMPT"] === "true" : (_g = merged.capture_system_prompt) != null ? _g : false,
+    projectId: (_e = process.env["RAINDROP_PROJECT_ID"]) != null ? _e : merged.project_id,
+    eventName: (_f = merged.event_name) != null ? _f : "pi_session",
+    debug: process.env["RAINDROP_DEBUG"] === "true" ? true : (_g = merged.debug) != null ? _g : false,
+    captureSystemPrompt: process.env["RAINDROP_CAPTURE_SYSTEM_PROMPT"] !== void 0 ? process.env["RAINDROP_CAPTURE_SYSTEM_PROMPT"] === "true" : (_h = merged.capture_system_prompt) != null ? _h : false,
     eventMetadata,
     localWorkshopUrl: resolveLocalWorkshopUrl(merged.local_workshop_url)
   };
@@ -467,12 +468,14 @@ function extension(pi) {
     writeKey: config.writeKey,
     endpoint: config.endpoint,
     debug: config.debug,
+    projectId: config.projectId,
     localDebuggerUrl: config.localWorkshopUrl
   });
   const traceShipper = new TraceShipper({
     writeKey: config.writeKey,
     endpoint: config.endpoint,
     debug: config.debug,
+    projectId: config.projectId,
     localDebuggerUrl: config.localWorkshopUrl
   });
   registerTracing(pi, config, eventShipper, traceShipper);

package/dist/index.cjs

@@ -24,7 +24,7 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
-// ../core/dist/chunk-U5HUTMR5.js
+// ../core/dist/chunk-SK6EJEO7.js
 function getCrypto() {
   const c = globalThis.crypto;
   return c;
@@ -376,6 +376,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) {
@@ -410,6 +429,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: {
@@ -428,6 +451,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 —
@@ -557,7 +583,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(
@@ -593,7 +619,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(
@@ -689,7 +715,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 {
@@ -836,6 +862,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;
@@ -912,6 +942,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);
@@ -1043,7 +1076,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 {
@@ -1116,18 +1149,13 @@ globalThis.RAINDROP_ASYNC_LOCAL_STORAGE = import_async_hooks.AsyncLocalStorage;
 // package.json
 var package_default = {
   name: "@raindrop-ai/pi-agent",
-  version: "0.0.5",
+  version: "0.0.7",
   description: "Raindrop observability for Pi Agent \u2014 automatic tracing via subscriber or pi-coding-agent extension",
   type: "module",
   license: "MIT",
-  repository: {
-    type: "git",
-    url: "git+https://github.com/raindrop-ai/raindrop-js.git",
-    directory: "packages/pi-agent"
-  },
-  homepage: "https://github.com/raindrop-ai/raindrop-js/tree/main/packages/pi-agent#readme",
+  homepage: "https://www.raindrop.ai/docs/integrations/pi-agent/",
   bugs: {
-    url: "https://github.com/raindrop-ai/raindrop-js/issues"
+    url: "https://www.raindrop.ai/docs/support/"
   },
   keywords: [
     "pi-package",
@@ -1796,6 +1824,7 @@ function createRaindropPiAgent(opts) {
     enabled: true,
     debug: ((_e = opts.events) == null ? void 0 : _e.debug) === true || envDebug,
     partialFlushMs: (_f = opts.events) == null ? void 0 : _f.partialFlushMs,
+    projectId: opts.projectId,
     localDebuggerUrl: opts.localWorkshopUrl
   }) : null;
   const traceShipper = tracesEnabled && (hasWriteKey || opts.endpoint || hasLocalDestination) ? new TraceShipper2({
@@ -1807,6 +1836,7 @@ function createRaindropPiAgent(opts) {
     flushIntervalMs: (_i = opts.traces) == null ? void 0 : _i.flushIntervalMs,
     maxBatchSize: (_j = opts.traces) == null ? void 0 : _j.maxBatchSize,
     maxQueueSize: (_k = opts.traces) == null ? void 0 : _k.maxQueueSize,
+    projectId: opts.projectId,
     localDebuggerUrl: opts.localWorkshopUrl
   }) : null;
   const defaultOptions = {

package/dist/{index.d-CRPiWjXE.d.cts → index.d-D0J2tEXx.d.cts}

@@ -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 {
     private sdkName;
     private prefix;
     private defaultEventName;
+    private projectId;
     private context;
     private buffers;
     private sticky;
@@ -124,6 +132,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 —
@@ -195,6 +204,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
@@ -252,6 +268,7 @@ declare class TraceShipper {
     private flushIntervalMs;
     private maxBatchSize;
     private maxQueueSize;
+    private projectId;
     private queue;
     private timer;
     private inFlight;
@@ -302,6 +319,7 @@ declare class TraceShipper {
     private redactSpan;
     isDebugEnabled(): boolean;
     private authHeaders;
+    private requestHeaders;
     startSpan(args: {
         name: string;
         parent?: {

package/dist/{index.d-CRPiWjXE.d.ts → index.d-D0J2tEXx.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 {
     private sdkName;
     private prefix;
     private defaultEventName;
+    private projectId;
     private context;
     private buffers;
     private sticky;
@@ -124,6 +132,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 —
@@ -195,6 +204,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
@@ -252,6 +268,7 @@ declare class TraceShipper {
     private flushIntervalMs;
     private maxBatchSize;
     private maxQueueSize;
+    private projectId;
     private queue;
     private timer;
     private inFlight;
@@ -302,6 +319,7 @@ declare class TraceShipper {
     private redactSpan;
     isDebugEnabled(): boolean;
     private authHeaders;
+    private requestHeaders;
     startSpan(args: {
         name: string;
         parent?: {

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import { Agent } from '@earendil-works/pi-agent-core';
-import { A as Attachment } from './index.d-CRPiWjXE.cjs';
+import { A as Attachment } from './index.d-D0J2tEXx.cjs';
 
 /**
  * Options for the Raindrop Pi Agent client.
@@ -12,6 +12,12 @@ interface RaindropPiAgentOptions {
     writeKey?: string;
     /** API endpoint URL (defaults to production) */
     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;
     /** Default user ID for all events */
     userId?: string;
     /** Default conversation ID to group related events */

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { Agent } from '@earendil-works/pi-agent-core';
-import { A as Attachment } from './index.d-CRPiWjXE.js';
+import { A as Attachment } from './index.d-D0J2tEXx.js';
 
 /**
  * Options for the Raindrop Pi Agent client.
@@ -12,6 +12,12 @@ interface RaindropPiAgentOptions {
     writeKey?: string;
     /** API endpoint URL (defaults to production) */
     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;
     /** Default user ID for all events */
     userId?: string;
     /** Default conversation ID to group related events */

package/dist/index.js

@@ -17,7 +17,7 @@ import {
   resolveLocalDebuggerBaseUrl,
   safeStringify,
   truncate
-} from "./chunk-2NGOEVWI.js";
+} from "./chunk-GILK5ZDM.js";
 
 // src/internal/subscriber.ts
 function createSubscriber(agent, eventShipper, traceShipper, defaultOptions, options, debug) {
@@ -396,6 +396,7 @@ function createRaindropPiAgent(opts) {
     enabled: true,
     debug: ((_e = opts.events) == null ? void 0 : _e.debug) === true || envDebug,
     partialFlushMs: (_f = opts.events) == null ? void 0 : _f.partialFlushMs,
+    projectId: opts.projectId,
     localDebuggerUrl: opts.localWorkshopUrl
   }) : null;
   const traceShipper = tracesEnabled && (hasWriteKey || opts.endpoint || hasLocalDestination) ? new TraceShipper({
@@ -407,6 +408,7 @@ function createRaindropPiAgent(opts) {
     flushIntervalMs: (_i = opts.traces) == null ? void 0 : _i.flushIntervalMs,
     maxBatchSize: (_j = opts.traces) == null ? void 0 : _j.maxBatchSize,
     maxQueueSize: (_k = opts.traces) == null ? void 0 : _k.maxQueueSize,
+    projectId: opts.projectId,
     localDebuggerUrl: opts.localWorkshopUrl
   }) : null;
   const defaultOptions = {

package/package.json

@@ -1,17 +1,12 @@
 {
   "name": "@raindrop-ai/pi-agent",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "description": "Raindrop observability for Pi Agent — automatic tracing via subscriber or pi-coding-agent extension",
   "type": "module",
   "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/raindrop-ai/raindrop-js.git",
-    "directory": "packages/pi-agent"
-  },
-  "homepage": "https://github.com/raindrop-ai/raindrop-js/tree/main/packages/pi-agent#readme",
+  "homepage": "https://www.raindrop.ai/docs/integrations/pi-agent/",
   "bugs": {
-    "url": "https://github.com/raindrop-ai/raindrop-js/issues"
+    "url": "https://www.raindrop.ai/docs/support/"
   },
   "keywords": [
     "pi-package",
@@ -59,7 +54,7 @@
     "tsup": "^8.5.1",
     "typescript": "^5.7.3",
     "vitest": "^2.1.9",
-    "@raindrop-ai/core": "0.0.3"
+    "@raindrop-ai/core": "0.0.4"
   },
   "tsup": {
     "entry": [