@raindrop-ai/pi-agent 0.0.2 → 0.0.4

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-VUNUOE2X.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,100 @@ 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;
+var DEFAULT_SECRET_KEY_NAMES = [
+  "apikey",
+  "apisecret",
+  "apitoken",
+  "secretaccesskey",
+  "sessiontoken",
+  "privatekey",
+  "privatekeyid",
+  "clientsecret",
+  "accesstoken",
+  "refreshtoken",
+  "oauthtoken",
+  "bearertoken",
+  "authorization",
+  "password",
+  "passphrase"
+];
+var REDACTED_PLACEHOLDER = "[REDACTED]";
+function normalizeKeyName(name) {
+  return name.toLowerCase().replace(/[-_.]/g, "");
 }
-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 redactSecretsInObject(value, options) {
+  var _a, _b;
+  const normalizedSecretSet = buildSecretSet((_a = options == null ? void 0 : options.secretKeyNames) != null ? _a : DEFAULT_SECRET_KEY_NAMES);
+  const placeholder = (_b = options == null ? void 0 : options.placeholder) != null ? _b : REDACTED_PLACEHOLDER;
+  const seen = /* @__PURE__ */ new WeakSet();
+  const walk = (node) => {
+    if (node === null || typeof node !== "object") return node;
+    if (seen.has(node)) return "[CIRCULAR]";
+    seen.add(node);
+    if (Array.isArray(node)) {
+      return node.map((item) => walk(item));
+    }
+    const out = {};
+    for (const [k, v] of Object.entries(node)) {
+      if (normalizedSecretSet.has(normalizeKeyName(k))) {
+        out[k] = placeholder;
+      } else {
+        out[k] = walk(v);
+      }
+    }
+    return out;
+  };
+  return walk(value);
+}
+function buildSecretSet(names) {
+  const set = /* @__PURE__ */ new Set();
+  for (const name of names) set.add(normalizeKeyName(name));
+  return set;
+}
+var DEFAULT_REDACT_ATTRIBUTE_KEYS = [
+  "ai.request.providerOptions",
+  "ai.response.providerMetadata"
+];
+function defaultTransformSpan(span) {
+  const attrs = span.attributes;
+  if (!attrs || attrs.length === 0) return span;
+  let nextAttrs;
+  for (let i = 0; i < attrs.length; i++) {
+    const attr = attrs[i];
+    const redacted = redactJsonAttributeValue(attr.key, attr.value);
+    if (redacted === void 0) continue;
+    if (!nextAttrs) nextAttrs = attrs.slice();
+    nextAttrs[i] = { key: attr.key, value: redacted };
+  }
+  if (!nextAttrs) return span;
+  return { ...span, attributes: nextAttrs };
+}
+var REDACT_JSON_ATTRIBUTE_KEYS = new Set(DEFAULT_REDACT_ATTRIBUTE_KEYS);
+function redactJsonAttributeValue(key, value) {
+  if (!REDACT_JSON_ATTRIBUTE_KEYS.has(key)) return void 0;
+  const json = value.stringValue;
+  if (typeof json !== "string" || json.length === 0) return void 0;
+  let parsed;
+  try {
+    parsed = JSON.parse(json);
+  } catch (e) {
+    return void 0;
+  }
+  const scrubbed = redactSecretsInObject(parsed);
+  let scrubbedJson;
+  try {
+    scrubbedJson = JSON.stringify(scrubbed);
+  } catch (e) {
+    return void 0;
+  }
+  if (scrubbedJson === json) return void 0;
+  return { stringValue: scrubbedJson };
 }
 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,13 +673,46 @@ 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}`);
+    }
+    this.transformSpanHook = opts.transformSpan;
+    this.disableDefaultRedaction = opts.disableDefaultRedaction === true;
+  }
+  /**
+   * Apply the user `transformSpan` hook (if any) followed by the default
+   * redactor (unless disabled). Returns either the (possibly new) span to
+   * ship, or `null` to drop the span entirely.
+   *
+   * Ordering: user hook runs first so callers can rewrite the span freely
+   * (rename attrs, add new ones, scrub things the default doesn't know
+   * about). The default redactor then runs on whatever the user produced,
+   * acting as the always-on floor for documented BYOK secrets. If the user
+   * sets `disableDefaultRedaction: true`, the floor is skipped.
+   *
+   * Fail-closed: if the user hook throws, the span is dropped — a buggy
+   * hook can never accidentally ship raw, un-redacted spans.
+   */
+  redactSpan(span) {
+    let current = span;
+    if (this.transformSpanHook) {
+      try {
+        const result = this.transformSpanHook(current);
+        if (result === null) return null;
+        if (result !== void 0) current = result;
+      } catch (err) {
+        if (this.debug) {
+          const msg = err instanceof Error ? err.message : String(err);
+          console.warn(`${this.prefix} transformSpan hook threw: ${msg}`);
+        }
+        return null;
       }
     }
+    if (!this.disableDefaultRedaction) {
+      current = defaultTransformSpan(current);
+    }
+    return current;
   }
   isDebugEnabled() {
     return this.debug;
@@ -662,8 +730,8 @@ var TraceShipper = class {
     ];
     if ((_b = args.attributes) == null ? void 0 : _b.length) attrs.push(...args.attributes);
     const span = { ids, name: args.name, startTimeUnixNano: started, attributes: attrs };
-    if (this.localDebuggerUrl) {
-      const openSpan = buildOtlpSpan({
+    this.mirrorToLocalDebugger(
+      buildOtlpSpan({
         ids: span.ids,
         name: span.name,
         startTimeUnixNano: span.startTimeUnixNano,
@@ -671,16 +739,21 @@ var TraceShipper = class {
         // placeholder — will be updated on endSpan
         attributes: span.attributes,
         status: { code: SpanStatusCode.UNSET }
-      });
-      const body = buildExportTraceServiceRequest([openSpan], this.serviceName, this.serviceVersion);
-      mirrorTraceExportToLocalDebugger(body, {
-        baseUrl: this.localDebuggerUrl,
-        debug: false,
-        sdkName: this.sdkName
-      });
-    }
+      })
+    );
     return span;
   }
+  mirrorToLocalDebugger(span) {
+    if (!this.localDebuggerUrl) return;
+    const redacted = this.redactSpan(span);
+    if (redacted === null) return;
+    const body = buildExportTraceServiceRequest([redacted], this.serviceName, this.serviceVersion);
+    mirrorTraceExportToLocalDebugger(body, {
+      baseUrl: this.localDebuggerUrl,
+      debug: false,
+      sdkName: this.sdkName
+    });
+  }
   endSpan(span, extra) {
     var _a, _b;
     if (span.endTimeUnixNano) return;
@@ -702,14 +775,7 @@ var TraceShipper = class {
       status
     });
     this.enqueue(otlp);
-    if (this.localDebuggerUrl) {
-      const body = buildExportTraceServiceRequest([otlp], this.serviceName, this.serviceVersion);
-      mirrorTraceExportToLocalDebugger(body, {
-        baseUrl: this.localDebuggerUrl,
-        debug: false,
-        sdkName: this.sdkName
-      });
-    }
+    this.mirrorToLocalDebugger(otlp);
   }
   createSpan(args) {
     var _a;
@@ -727,14 +793,7 @@ var TraceShipper = class {
       status: args.status
     });
     this.enqueue(otlp);
-    if (this.localDebuggerUrl) {
-      const body = buildExportTraceServiceRequest([otlp], this.serviceName, this.serviceVersion);
-      mirrorTraceExportToLocalDebugger(body, {
-        baseUrl: this.localDebuggerUrl,
-        debug: false,
-        sdkName: this.sdkName
-      });
-    }
+    this.mirrorToLocalDebugger(otlp);
   }
   enqueue(span) {
     if (!this.enabled) return;
@@ -746,10 +805,12 @@ var TraceShipper = class {
         )}`
       );
     }
+    const redacted = this.redactSpan(span);
+    if (redacted === null) return;
     if (this.queue.length >= this.maxQueueSize) {
       this.queue.shift();
     }
-    this.queue.push(span);
+    this.queue.push(redacted);
     if (this.queue.length >= this.maxBatchSize) {
       void this.flush().catch(() => {
       });
@@ -771,6 +832,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 +875,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.4",
+  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: {
+    "@earendil-works/pi-agent-core": ">=0.74.0",
+    "@earendil-works/pi-coding-agent": ">=0.74.0"
+  },
+  peerDependenciesMeta: {
+    "@earendil-works/pi-coding-agent": {
+      optional: true
+    }
+  },
+  devDependencies: {
+    "@raindrop-ai/core": "workspace:*",
+    "@earendil-works/pi-agent-core": "^0.78.0",
+    "@earendil-works/pi-coding-agent": "^0.78.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 +1496,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);
 }