@raindrop-ai/pi-agent 0.0.2 → 0.0.3

package/dist/extension.cjs

@@ -25,147 +25,7 @@ __export(extension_exports, {
 });
 module.exports = __toCommonJS(extension_exports);
 
-// src/internal/config.ts
-var import_node_fs = require("fs");
-var import_node_os = require("os");
-var import_node_path = require("path");
-function getPiAgentDirectory() {
-  var _a;
-  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;
-  let merged = {};
-  const configPaths = [
-    (0, import_node_path.join)(getPiAgentDirectory(), "raindrop.json"),
-    (0, import_node_path.join)(projectDirectory, ".pi", "raindrop.json")
-  ];
-  for (const configPath of configPaths) {
-    try {
-      if ((0, import_node_fs.existsSync)(configPath)) {
-        const content = (0, import_node_fs.readFileSync)(configPath, "utf-8");
-        const parsed = JSON.parse(content);
-        merged = { ...merged, ...parsed };
-      }
-    } catch (e) {
-    }
-  }
-  let eventMetadata;
-  const envMeta = process.env["RAINDROP_EVENT_METADATA"];
-  if (envMeta) {
-    try {
-      eventMetadata = JSON.parse(envMeta);
-    } catch (e) {
-    }
-  }
-  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,
-    eventMetadata
-  };
-}
-
-// package.json
-var package_default = {
-  name: "@raindrop-ai/pi-agent",
-  version: "0.0.2",
-  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",
-  bugs: {
-    url: "https://github.com/raindrop-ai/raindrop-js/issues"
-  },
-  keywords: [
-    "pi-package",
-    "raindrop",
-    "pi-agent",
-    "observability",
-    "tracing"
-  ],
-  exports: {
-    ".": {
-      types: "./dist/index.d.ts",
-      import: "./dist/index.js",
-      require: "./dist/index.cjs"
-    },
-    "./extension": {
-      types: "./dist/extension.d.ts",
-      import: "./dist/extension.js",
-      require: "./dist/extension.cjs"
-    }
-  },
-  pi: {
-    extensions: [
-      "./dist/extension.js"
-    ]
-  },
-  sideEffects: false,
-  files: [
-    "dist/**",
-    "README.md"
-  ],
-  scripts: {
-    build: "tsup",
-    dev: "tsup --watch",
-    clean: "rm -rf dist",
-    test: "vitest run",
-    "test:watch": "vitest"
-  },
-  peerDependencies: {
-    "@mariozechner/pi-agent-core": ">=0.60.0",
-    "@mariozechner/pi-coding-agent": ">=0.65.2"
-  },
-  peerDependenciesMeta: {
-    "@mariozechner/pi-coding-agent": {
-      optional: true
-    }
-  },
-  devDependencies: {
-    "@raindrop-ai/core": "workspace:*",
-    "@mariozechner/pi-agent-core": "^0.66.0",
-    "@mariozechner/pi-coding-agent": "^0.66.0",
-    "@types/node": "^20.11.17",
-    msw: "^2.12.7",
-    tsup: "^8.5.1",
-    typescript: "^5.7.3",
-    vitest: "^2.1.9"
-  },
-  tsup: {
-    entry: [
-      "src/index.ts",
-      "src/extension.ts"
-    ],
-    format: [
-      "cjs",
-      "esm"
-    ],
-    dts: {
-      resolve: true
-    },
-    clean: true,
-    noExternal: [
-      "@raindrop-ai/core"
-    ]
-  },
-  publishConfig: {
-    access: "public"
-  }
-};
-
-// src/version.ts
-var libraryName = package_default.name;
-var libraryVersion = package_default.version;
-
-// ../core/dist/chunk-4UCYIEH4.js
+// ../core/dist/chunk-OLYXZCOK.js
 function getCrypto() {
   const c = globalThis.crypto;
   return c;
@@ -358,6 +218,91 @@ function buildExportTraceServiceRequest(spans, serviceName = "raindrop.core", se
     ]
   };
 }
+var LOCAL_DEBUGGER_ENV_VAR = "RAINDROP_LOCAL_DEBUGGER";
+var WORKSHOP_ENV_VAR = "RAINDROP_WORKSHOP";
+var DEFAULT_LOCAL_WORKSHOP_URL = "http://localhost:5899/v1/";
+function readEnvVar(name) {
+  var _a;
+  try {
+    const env = (_a = globalThis == null ? void 0 : globalThis.process) == null ? void 0 : _a.env;
+    if (env && typeof env[name] === "string" && env[name].length > 0) {
+      return env[name];
+    }
+  } catch (e) {
+  }
+  return void 0;
+}
+function readWorkshopEnv() {
+  const raw = readEnvVar(WORKSHOP_ENV_VAR);
+  if (raw === void 0) return void 0;
+  const trimmed = raw.trim();
+  if (trimmed.length === 0) return void 0;
+  if (/^https?:\/\//i.test(trimmed)) return { url: trimmed };
+  if (/^(1|true|yes|on)$/i.test(trimmed)) return "enable";
+  if (/^(0|false|no|off)$/i.test(trimmed)) return "disable";
+  return void 0;
+}
+function isLocalDevHost(hostname2) {
+  if (!hostname2) return false;
+  if (hostname2 === "localhost" || hostname2 === "127.0.0.1" || hostname2 === "0.0.0.0" || hostname2 === "::1") {
+    return true;
+  }
+  if (hostname2.endsWith(".localhost")) return true;
+  return false;
+}
+function readRuntimeHostname() {
+  try {
+    const loc = globalThis == null ? void 0 : globalThis.location;
+    if (loc && typeof loc.hostname === "string" && loc.hostname.length > 0) {
+      return loc.hostname;
+    }
+  } catch (e) {
+  }
+  return void 0;
+}
+function shouldAutoEnableLocalWorkshop() {
+  if (isLocalDevHost(readRuntimeHostname())) return true;
+  if (readEnvVar("NODE_ENV") === "development") return true;
+  return false;
+}
+function resolveLocalDebuggerBaseUrl(baseUrl) {
+  var _a, _b, _c;
+  if (baseUrl === null) return null;
+  if (typeof baseUrl === "string" && baseUrl.length > 0) {
+    return (_a = formatEndpoint(baseUrl)) != null ? _a : null;
+  }
+  const explicitUrlEnv = readEnvVar(LOCAL_DEBUGGER_ENV_VAR);
+  if (explicitUrlEnv) return (_b = formatEndpoint(explicitUrlEnv)) != null ? _b : null;
+  const workshopEnv = readWorkshopEnv();
+  if (workshopEnv === "disable") return null;
+  if (workshopEnv === "enable") return DEFAULT_LOCAL_WORKSHOP_URL;
+  if (workshopEnv && "url" in workshopEnv) return (_c = formatEndpoint(workshopEnv.url)) != null ? _c : null;
+  if (shouldAutoEnableLocalWorkshop()) return DEFAULT_LOCAL_WORKSHOP_URL;
+  return null;
+}
+function mirrorTraceExportToLocalDebugger(body, options = {}) {
+  var _a;
+  const baseUrl = resolveLocalDebuggerBaseUrl(options.baseUrl);
+  if (!baseUrl) return;
+  void postJson(`${baseUrl}traces`, body, {}, {
+    maxAttempts: 1,
+    debug: (_a = options.debug) != null ? _a : false,
+    sdkName: options.sdkName
+  }).catch(() => {
+  });
+}
+function mirrorPartialEventToLocalDebugger(event, options = {}) {
+  var _a;
+  const baseUrl = resolveLocalDebuggerBaseUrl(options.baseUrl);
+  if (!baseUrl) return;
+  const headers = options.writeKey ? { Authorization: `Bearer ${options.writeKey}` } : {};
+  void postJson(`${baseUrl}events/track_partial`, event, headers, {
+    maxAttempts: 1,
+    debug: (_a = options.debug) != null ? _a : false,
+    sdkName: options.sdkName
+  }).catch(() => {
+  });
+}
 function mergePatches(target, source) {
   var _a, _b, _c, _d;
   const out = { ...target, ...source };
@@ -375,7 +320,7 @@ var EventShipper = class {
     this.sticky = /* @__PURE__ */ new Map();
     this.timers = /* @__PURE__ */ new Map();
     this.inFlight = /* @__PURE__ */ new Set();
-    var _a, _b, _c, _d, _e, _f, _g;
+    var _a, _b, _c, _d, _e, _f, _g, _h;
     this.writeKey = (_a = opts.writeKey) == null ? void 0 : _a.trim();
     this.baseUrl = (_b = formatEndpoint(opts.endpoint)) != null ? _b : "https://api.raindrop.ai/v1/";
     this.enabled = opts.enabled !== false;
@@ -384,11 +329,15 @@ var EventShipper = class {
     this.sdkName = (_d = opts.sdkName) != null ? _d : "core";
     this.prefix = `[raindrop-ai/${this.sdkName}]`;
     this.defaultEventName = (_e = opts.defaultEventName) != null ? _e : "ai_generation";
+    this.localDebuggerUrl = (_f = resolveLocalDebuggerBaseUrl(opts.localDebuggerUrl)) != null ? _f : void 0;
+    if (this.debug && this.localDebuggerUrl) {
+      console.log(`${this.prefix} Local debugger mirroring: ${this.localDebuggerUrl}`);
+    }
     const isNode = typeof process !== "undefined" && typeof process.version === "string";
     this.context = {
       library: {
-        name: (_f = opts.libraryName) != null ? _f : "@raindrop-ai/core",
-        version: (_g = opts.libraryVersion) != null ? _g : "0.0.0"
+        name: (_g = opts.libraryName) != null ? _g : "@raindrop-ai/core",
+        version: (_h = opts.libraryVersion) != null ? _h : "0.0.0"
       },
       metadata: {
         jsRuntime: isNode ? "node" : "web",
@@ -474,6 +423,7 @@ var EventShipper = class {
         }
       }
     ];
+    if (!this.writeKey) return;
     const url = `${this.baseUrl}signals/track`;
     try {
       await postJson(url, body, this.authHeaders(), {
@@ -504,6 +454,7 @@ var EventShipper = class {
         traits: (_a = user.traits) != null ? _a : {}
       };
     });
+    if (!this.writeKey) return;
     if (body.length === 0) return;
     const url = `${this.baseUrl}users/identify`;
     try {
@@ -580,6 +531,18 @@ var EventShipper = class {
         endpoint: url
       });
     }
+    if (this.localDebuggerUrl) {
+      mirrorPartialEventToLocalDebugger(payload, {
+        baseUrl: this.localDebuggerUrl,
+        writeKey: this.writeKey,
+        debug: this.debug,
+        sdkName: this.sdkName
+      });
+    }
+    if (!this.writeKey) {
+      if (!isPending) this.sticky.delete(eventId);
+      return;
+    }
     const p = postJson(url, payload, this.authHeaders(), {
       maxAttempts: 3,
       debug: this.debug,
@@ -604,28 +567,11 @@ var EventShipper = class {
     }
   }
 };
-var LOCAL_DEBUGGER_ENV_VAR = "RAINDROP_LOCAL_DEBUGGER";
-function resolveLocalDebuggerBaseUrl(baseUrl) {
-  var _a, _b, _c;
-  const resolved = (_b = baseUrl != null ? baseUrl : typeof process !== "undefined" ? (_a = process.env) == null ? void 0 : _a[LOCAL_DEBUGGER_ENV_VAR] : void 0) != null ? _b : null;
-  return resolved ? (_c = formatEndpoint(resolved)) != null ? _c : null : null;
-}
-function mirrorTraceExportToLocalDebugger(body, options = {}) {
-  var _a;
-  const baseUrl = resolveLocalDebuggerBaseUrl(options.baseUrl);
-  if (!baseUrl) return;
-  void postJson(`${baseUrl}traces`, body, {}, {
-    maxAttempts: 1,
-    debug: (_a = options.debug) != null ? _a : false,
-    sdkName: options.sdkName
-  }).catch(() => {
-  });
-}
 var TraceShipper = class {
   constructor(opts) {
     this.queue = [];
     this.inFlight = /* @__PURE__ */ new Set();
-    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i;
     this.writeKey = (_a = opts.writeKey) == null ? void 0 : _a.trim();
     this.baseUrl = (_b = formatEndpoint(opts.endpoint)) != null ? _b : "https://api.raindrop.ai/v1/";
     this.enabled = opts.enabled !== false;
@@ -638,12 +584,9 @@ var TraceShipper = class {
     this.prefix = `[raindrop-ai/${this.sdkName}]`;
     this.serviceName = (_g = opts.serviceName) != null ? _g : "raindrop.core";
     this.serviceVersion = (_h = opts.serviceVersion) != null ? _h : "0.0.0";
-    const localDebugger = typeof process !== "undefined" ? (_i = process.env) == null ? void 0 : _i.RAINDROP_LOCAL_DEBUGGER : void 0;
-    if (localDebugger) {
-      this.localDebuggerUrl = (_j = resolveLocalDebuggerBaseUrl(localDebugger)) != null ? _j : void 0;
-      if (this.debug) {
-        console.log(`${this.prefix} Local debugger mirroring: ${this.localDebuggerUrl}`);
-      }
+    this.localDebuggerUrl = (_i = resolveLocalDebuggerBaseUrl(opts.localDebuggerUrl)) != null ? _i : void 0;
+    if (this.debug && this.localDebuggerUrl) {
+      console.log(`${this.prefix} Local debugger mirroring: ${this.localDebuggerUrl}`);
     }
   }
   isDebugEnabled() {
@@ -771,6 +714,7 @@ var TraceShipper = class {
     }
     while (this.queue.length > 0) {
       const batch = this.queue.splice(0, this.maxBatchSize);
+      if (!this.writeKey) continue;
       const body = buildExportTraceServiceRequest(batch, this.serviceName, this.serviceVersion);
       const url = `${this.baseUrl}traces`;
       if (this.debug) {
@@ -813,6 +757,157 @@ var TraceShipper = class {
 var import_async_hooks = require("async_hooks");
 globalThis.RAINDROP_ASYNC_LOCAL_STORAGE = import_async_hooks.AsyncLocalStorage;
 
+// src/internal/config.ts
+var import_node_fs = require("fs");
+var import_node_os = require("os");
+var import_node_path = require("path");
+function getPiAgentDirectory() {
+  var _a;
+  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;
+  let merged = {};
+  const configPaths = [
+    (0, import_node_path.join)(getPiAgentDirectory(), "raindrop.json"),
+    (0, import_node_path.join)(projectDirectory, ".pi", "raindrop.json")
+  ];
+  for (const configPath of configPaths) {
+    try {
+      if ((0, import_node_fs.existsSync)(configPath)) {
+        const content = (0, import_node_fs.readFileSync)(configPath, "utf-8");
+        const parsed = JSON.parse(content);
+        merged = { ...merged, ...parsed };
+      }
+    } catch (e) {
+    }
+  }
+  let eventMetadata;
+  const envMeta = process.env["RAINDROP_EVENT_METADATA"];
+  if (envMeta) {
+    try {
+      eventMetadata = JSON.parse(envMeta);
+    } catch (e) {
+    }
+  }
+  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,
+    eventMetadata,
+    localWorkshopUrl: resolveLocalWorkshopUrl(merged.local_workshop_url)
+  };
+}
+function resolveLocalWorkshopUrl(fileValue) {
+  const envValue = process.env["RAINDROP_LOCAL_WORKSHOP_URL"];
+  if (envValue !== void 0) {
+    if (envValue === "" || envValue.toLowerCase() === "null" || envValue.toLowerCase() === "false") {
+      return null;
+    }
+    return envValue;
+  }
+  return fileValue;
+}
+
+// package.json
+var package_default = {
+  name: "@raindrop-ai/pi-agent",
+  version: "0.0.3",
+  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",
+  bugs: {
+    url: "https://github.com/raindrop-ai/raindrop-js/issues"
+  },
+  keywords: [
+    "pi-package",
+    "raindrop",
+    "pi-agent",
+    "observability",
+    "tracing"
+  ],
+  exports: {
+    ".": {
+      types: "./dist/index.d.ts",
+      import: "./dist/index.js",
+      require: "./dist/index.cjs"
+    },
+    "./extension": {
+      types: "./dist/extension.d.ts",
+      import: "./dist/extension.js",
+      require: "./dist/extension.cjs"
+    }
+  },
+  pi: {
+    extensions: [
+      "./dist/extension.js"
+    ]
+  },
+  sideEffects: false,
+  files: [
+    "dist/**",
+    "README.md"
+  ],
+  scripts: {
+    build: "tsup",
+    dev: "tsup --watch",
+    clean: "rm -rf dist",
+    test: "vitest run",
+    "test:watch": "vitest"
+  },
+  peerDependencies: {
+    "@mariozechner/pi-agent-core": ">=0.60.0",
+    "@mariozechner/pi-coding-agent": ">=0.65.2"
+  },
+  peerDependenciesMeta: {
+    "@mariozechner/pi-coding-agent": {
+      optional: true
+    }
+  },
+  devDependencies: {
+    "@raindrop-ai/core": "workspace:*",
+    "@mariozechner/pi-agent-core": "^0.66.0",
+    "@mariozechner/pi-coding-agent": "^0.66.0",
+    "@types/node": "^20.11.17",
+    msw: "^2.12.7",
+    tsup: "^8.5.1",
+    typescript: "^5.7.3",
+    vitest: "^2.1.9"
+  },
+  tsup: {
+    entry: [
+      "src/index.ts",
+      "src/extension.ts"
+    ],
+    format: [
+      "cjs",
+      "esm"
+    ],
+    dts: {
+      resolve: true
+    },
+    clean: true,
+    noExternal: [
+      "@raindrop-ai/core"
+    ]
+  },
+  publishConfig: {
+    access: "public"
+  }
+};
+
+// src/version.ts
+var libraryName = package_default.name;
+var libraryVersion = package_default.version;
+
 // src/internal/shipper.ts
 var EventShipper2 = class extends EventShipper {
   constructor(opts) {
@@ -1283,25 +1378,33 @@ function extension(pi) {
     console.log(`[raindrop-ai/pi-agent] [${level}] ${message}`);
   }
   appLog("info", `Loading ${PLUGIN_NAME} v${libraryVersion}`);
-  if (!config.writeKey) {
+  const resolvedLocalUrl = resolveLocalDebuggerBaseUrl(config.localWorkshopUrl);
+  const hasLocalDestination = resolvedLocalUrl !== null;
+  if (!config.writeKey && !hasLocalDestination) {
     appLog(
       "warn",
-      "RAINDROP_WRITE_KEY not set \u2014 Raindrop tracing disabled. Set it in your environment or in ~/.pi/agent/raindrop.json."
+      "RAINDROP_WRITE_KEY not set and no local Workshop daemon detected \u2014 Raindrop tracing disabled. Set RAINDROP_WRITE_KEY for cloud, or RAINDROP_LOCAL_WORKSHOP_URL / RAINDROP_LOCAL_DEBUGGER for local-only mode."
     );
     return;
   }
   if (config.debug) {
-    appLog("info", `Raindrop tracing enabled (endpoint: ${config.endpoint})`);
+    const destinations = [
+      config.writeKey ? `cloud (${config.endpoint})` : null,
+      resolvedLocalUrl ? `local Workshop (${resolvedLocalUrl})` : null
+    ].filter(Boolean);
+    appLog("info", `Raindrop tracing enabled \u2014 destinations: ${destinations.join(", ")}`);
   }
   const eventShipper = new EventShipper2({
     writeKey: config.writeKey,
     endpoint: config.endpoint,
-    debug: config.debug
+    debug: config.debug,
+    localDebuggerUrl: config.localWorkshopUrl
   });
   const traceShipper = new TraceShipper2({
     writeKey: config.writeKey,
     endpoint: config.endpoint,
-    debug: config.debug
+    debug: config.debug,
+    localDebuggerUrl: config.localWorkshopUrl
   });
   registerTracing(pi, config, eventShipper, traceShipper);
 }

package/dist/extension.d.cts

@@ -1,5 +1,5 @@
 import { ExtensionAPI } from '@mariozechner/pi-coding-agent';
-import { E as EventShipper$1, T as TraceShipper$1, O as OtlpSpan } from './index.d-npTVS9Mf.cjs';
+import { E as EventShipper$1, T as TraceShipper$1, O as OtlpSpan } from './index.d-CtwaEReY.cjs';
 
 interface EventMetadata {
     userId?: string;
@@ -13,6 +13,13 @@ interface RaindropExtensionConfig {
     debug: boolean;
     captureSystemPrompt: boolean;
     eventMetadata?: EventMetadata;
+    /**
+     * Explicit Workshop / local debugger URL forwarded to both shippers as their
+     * `localDebuggerUrl`. `null` opts out (overrides `RAINDROP_LOCAL_DEBUGGER` /
+     * `RAINDROP_WORKSHOP` env vars and auto-detect). `undefined` falls through to
+     * the env / auto-detect resolution in `@raindrop-ai/core`.
+     */
+    localWorkshopUrl?: string | null;
 }
 
 declare class EventShipper extends EventShipper$1 {
@@ -49,6 +56,9 @@ declare function registerTracing(pi: ExtensionAPI, config: RaindropExtensionConf
  *   RAINDROP_API_URL — custom endpoint (default: https://api.raindrop.ai/v1)
  *   RAINDROP_DEBUG — enable debug logging
  *   RAINDROP_CAPTURE_SYSTEM_PROMPT — capture system prompts in traces
+ *   RAINDROP_LOCAL_WORKSHOP_URL — mirror to a local Raindrop Workshop daemon
+ *     in addition to the cloud endpoint. Pass `null`, `""`, or `"false"` to
+ *     opt out of all auto-detection.
  *
  * Config file locations:
  *   ~/.pi/agent/raindrop.json (global)

package/dist/extension.d.ts

@@ -1,5 +1,5 @@
 import { ExtensionAPI } from '@mariozechner/pi-coding-agent';
-import { E as EventShipper$1, T as TraceShipper$1, O as OtlpSpan } from './index.d-npTVS9Mf.js';
+import { E as EventShipper$1, T as TraceShipper$1, O as OtlpSpan } from './index.d-CtwaEReY.js';
 
 interface EventMetadata {
     userId?: string;
@@ -13,6 +13,13 @@ interface RaindropExtensionConfig {
     debug: boolean;
     captureSystemPrompt: boolean;
     eventMetadata?: EventMetadata;
+    /**
+     * Explicit Workshop / local debugger URL forwarded to both shippers as their
+     * `localDebuggerUrl`. `null` opts out (overrides `RAINDROP_LOCAL_DEBUGGER` /
+     * `RAINDROP_WORKSHOP` env vars and auto-detect). `undefined` falls through to
+     * the env / auto-detect resolution in `@raindrop-ai/core`.
+     */
+    localWorkshopUrl?: string | null;
 }
 
 declare class EventShipper extends EventShipper$1 {
@@ -49,6 +56,9 @@ declare function registerTracing(pi: ExtensionAPI, config: RaindropExtensionConf
  *   RAINDROP_API_URL — custom endpoint (default: https://api.raindrop.ai/v1)
  *   RAINDROP_DEBUG — enable debug logging
  *   RAINDROP_CAPTURE_SYSTEM_PROMPT — capture system prompts in traces
+ *   RAINDROP_LOCAL_WORKSHOP_URL — mirror to a local Raindrop Workshop daemon
+ *     in addition to the cloud endpoint. Pass `null`, `""`, or `"false"` to
+ *     opt out of all auto-detection.
  *
  * Config file locations:
  *   ~/.pi/agent/raindrop.json (global)

package/dist/extension.js

@@ -10,9 +10,10 @@ import {
   getUsername,
   libraryVersion,
   nowUnixNanoString,
+  resolveLocalDebuggerBaseUrl,
   safeStringify,
   truncate
-} from "./chunk-LZIGXU2D.js";
+} from "./chunk-MHIMKMK7.js";
 
 // src/internal/config.ts
 import { existsSync, readFileSync } from "fs";
@@ -53,9 +54,20 @@ function loadConfig(projectDirectory) {
     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,
-    eventMetadata
+    eventMetadata,
+    localWorkshopUrl: resolveLocalWorkshopUrl(merged.local_workshop_url)
   };
 }
+function resolveLocalWorkshopUrl(fileValue) {
+  const envValue = process.env["RAINDROP_LOCAL_WORKSHOP_URL"];
+  if (envValue !== void 0) {
+    if (envValue === "" || envValue.toLowerCase() === "null" || envValue.toLowerCase() === "false") {
+      return null;
+    }
+    return envValue;
+  }
+  return fileValue;
+}
 
 // src/internal/extension-tracing.ts
 function safeParsArgs(argsStr) {
@@ -424,25 +436,33 @@ function extension(pi) {
     console.log(`[raindrop-ai/pi-agent] [${level}] ${message}`);
   }
   appLog("info", `Loading ${PLUGIN_NAME} v${libraryVersion}`);
-  if (!config.writeKey) {
+  const resolvedLocalUrl = resolveLocalDebuggerBaseUrl(config.localWorkshopUrl);
+  const hasLocalDestination = resolvedLocalUrl !== null;
+  if (!config.writeKey && !hasLocalDestination) {
     appLog(
       "warn",
-      "RAINDROP_WRITE_KEY not set \u2014 Raindrop tracing disabled. Set it in your environment or in ~/.pi/agent/raindrop.json."
+      "RAINDROP_WRITE_KEY not set and no local Workshop daemon detected \u2014 Raindrop tracing disabled. Set RAINDROP_WRITE_KEY for cloud, or RAINDROP_LOCAL_WORKSHOP_URL / RAINDROP_LOCAL_DEBUGGER for local-only mode."
     );
     return;
   }
   if (config.debug) {
-    appLog("info", `Raindrop tracing enabled (endpoint: ${config.endpoint})`);
+    const destinations = [
+      config.writeKey ? `cloud (${config.endpoint})` : null,
+      resolvedLocalUrl ? `local Workshop (${resolvedLocalUrl})` : null
+    ].filter(Boolean);
+    appLog("info", `Raindrop tracing enabled \u2014 destinations: ${destinations.join(", ")}`);
   }
   const eventShipper = new EventShipper({
     writeKey: config.writeKey,
     endpoint: config.endpoint,
-    debug: config.debug
+    debug: config.debug,
+    localDebuggerUrl: config.localWorkshopUrl
   });
   const traceShipper = new TraceShipper({
     writeKey: config.writeKey,
     endpoint: config.endpoint,
-    debug: config.debug
+    debug: config.debug,
+    localDebuggerUrl: config.localWorkshopUrl
   });
   registerTracing(pi, config, eventShipper, traceShipper);
 }