@raindrop-ai/claude-code 0.0.1 → 0.0.3

package/dist/cli.js

@@ -6,7 +6,7 @@ import { randomUUID as randomUUID2 } from "crypto";
 import { tmpdir } from "os";
 import { join } from "path";
 
-// ../core/dist/chunk-H6VSZSLN.js
+// ../core/dist/chunk-4UCYIEH4.js
 function getCrypto() {
   const c = globalThis.crypto;
   return c;
@@ -442,11 +442,28 @@ 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;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
     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;
@@ -459,6 +476,13 @@ 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}`);
+      }
+    }
   }
   isDebugEnabled() {
     return this.debug;
@@ -475,7 +499,25 @@ var TraceShipper = class {
       attrString("ai.operationId", args2.operationId)
     ];
     if ((_b = args2.attributes) == null ? void 0 : _b.length) attrs.push(...args2.attributes);
-    return { ids, name: args2.name, startTimeUnixNano: started, attributes: attrs };
+    const span = { ids, name: args2.name, startTimeUnixNano: started, attributes: attrs };
+    if (this.localDebuggerUrl) {
+      const openSpan = buildOtlpSpan({
+        ids: span.ids,
+        name: span.name,
+        startTimeUnixNano: span.startTimeUnixNano,
+        endTimeUnixNano: span.startTimeUnixNano,
+        // 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;
   }
   endSpan(span, extra) {
     var _a, _b;
@@ -498,6 +540,14 @@ 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
+      });
+    }
   }
   createSpan(args2) {
     var _a;
@@ -515,6 +565,14 @@ var TraceShipper = class {
       status: args2.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
+      });
+    }
   }
   enqueue(span) {
     if (!this.enabled) return;
@@ -969,12 +1027,12 @@ async function handleSessionEnd(payload, eventId, config, properties, eventShipp
 }
 
 // src/config.ts
-import { existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";
+import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
 import { homedir, userInfo } from "os";
-import { join as join2 } from "path";
+import { dirname, join as join2 } from "path";
 var CONFIG_PATH = join2(homedir(), ".config", "raindrop", "config.json");
 function loadConfig() {
-  var _a, _b, _c, _d, _e, _f, _g;
+  var _a, _b, _c, _d, _e, _f, _g, _h;
   let file = {};
   try {
     if (existsSync2(CONFIG_PATH)) {
@@ -993,15 +1051,125 @@ function loadConfig() {
     writeKey: (_b = (_a = process.env["RAINDROP_WRITE_KEY"]) != null ? _a : file.write_key) != null ? _b : "",
     endpoint: (_d = (_c = process.env["RAINDROP_API_URL"]) != null ? _c : file.api_url) != null ? _d : "https://api.raindrop.ai/v1",
     userId: (_f = (_e = process.env["RAINDROP_USER_ID"]) != null ? _e : file.user_id) != null ? _f : systemUser,
-    debug: process.env["RAINDROP_DEBUG"] === "true" ? true : (_g = file.debug) != null ? _g : false
+    debug: process.env["RAINDROP_DEBUG"] === "true" ? true : (_g = file.debug) != null ? _g : false,
+    enabled: (_h = file.enabled) != null ? _h : true
   };
 }
 function getConfigPath() {
   return CONFIG_PATH;
 }
+function updateConfig(patch) {
+  const dir = dirname(CONFIG_PATH);
+  mkdirSync2(dir, { recursive: true });
+  let existing = {};
+  try {
+    if (existsSync2(CONFIG_PATH)) {
+      existing = JSON.parse(readFileSync2(CONFIG_PATH, "utf-8"));
+    }
+  } catch (e) {
+  }
+  writeFileSync2(CONFIG_PATH, JSON.stringify({ ...existing, ...patch }, null, 2) + "\n", "utf-8");
+}
+
+// src/local-debugger.ts
+import { existsSync as existsSync3, mkdirSync as mkdirSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "fs";
+import { tmpdir as tmpdir2 } from "os";
+import { join as join3 } from "path";
+var DEFAULT_PORT = 5899;
+var DEFAULT_URL = `http://localhost:${DEFAULT_PORT}/v1/`;
+var HEALTH_TIMEOUT_MS = 300;
+var CACHE_DIR = join3(tmpdir2(), "raindrop-claude-code");
+var CACHE_FILE = join3(CACHE_DIR, "debugger_cache");
+var CACHE_TTL_MS = 5e3;
+function readCache() {
+  try {
+    if (!existsSync3(CACHE_FILE)) return void 0;
+    const data = JSON.parse(readFileSync3(CACHE_FILE, "utf-8"));
+    if (Date.now() - data.ts > CACHE_TTL_MS) return void 0;
+    return data;
+  } catch (e) {
+    return void 0;
+  }
+}
+function writeCache(url) {
+  try {
+    mkdirSync3(CACHE_DIR, { recursive: true });
+    writeFileSync3(CACHE_FILE, JSON.stringify({ url, ts: Date.now() }), "utf-8");
+  } catch (e) {
+  }
+}
+async function healthPing(baseUrl) {
+  const healthUrl = baseUrl.replace(/\/v1\/$/, "/health");
+  try {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), HEALTH_TIMEOUT_MS);
+    const resp = await fetch(healthUrl, { signal: controller.signal });
+    clearTimeout(timeout);
+    if (resp.ok) {
+      const body = await resp.json();
+      if (body.ok) return baseUrl;
+    }
+  } catch (e) {
+  }
+  return null;
+}
+async function detectLocalDebugger(debug) {
+  var _a;
+  const envUrl = resolveLocalDebuggerBaseUrl();
+  if (envUrl) {
+    if (debug) {
+      console.log(`[raindrop-ai/claude-code] Local debugger configured via ${LOCAL_DEBUGGER_ENV_VAR}: ${envUrl}`);
+    }
+    return { url: envUrl, autoDetected: false };
+  }
+  const cached = readCache();
+  if (cached) {
+    if (debug) {
+      console.log(`[raindrop-ai/claude-code] Local debugger cache hit: ${(_a = cached.url) != null ? _a : "not running"}`);
+    }
+    return { url: cached.url, autoDetected: cached.url !== null };
+  }
+  if (debug) {
+    console.log(`[raindrop-ai/claude-code] Probing local debugger at localhost:${DEFAULT_PORT}...`);
+  }
+  const detected = await healthPing(DEFAULT_URL);
+  writeCache(detected);
+  if (detected && debug) {
+    console.log(`[raindrop-ai/claude-code] Local debugger auto-detected at ${detected}`);
+  }
+  return { url: detected, autoDetected: detected !== null };
+}
+function mirrorEventToLocalDebugger(baseUrl, payload, debug) {
+  const url = `${baseUrl}events/track_partial`;
+  if (debug) {
+    console.log(`[raindrop-ai/claude-code] Mirroring event to local debugger: ${url}`);
+  }
+  void fetch(url, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(payload)
+  }).catch(() => {
+  });
+}
 
 // src/hook-handler.ts
+import { existsSync as existsSync4, readFileSync as readFileSync4 } from "fs";
+import { join as join4 } from "path";
+import { tmpdir as tmpdir3 } from "os";
 var STDIN_TIMEOUT_MS = 5e3;
+var STATE_DIR2 = join4(tmpdir3(), "raindrop-claude-code");
+function getOtlpTraceId(sessionId) {
+  try {
+    const key = `rootspan_${sessionId}`.replace(/[^a-zA-Z0-9_\-]/g, "_");
+    const filePath = join4(STATE_DIR2, key);
+    if (!existsSync4(filePath)) return void 0;
+    const ctx = JSON.parse(readFileSync4(filePath, "utf-8"));
+    if (!ctx.traceIdB64) return void 0;
+    return Buffer.from(ctx.traceIdB64, "base64").toString("hex");
+  } catch (e) {
+    return void 0;
+  }
+}
 function readStdin() {
   return new Promise((resolve2) => {
     if (process.stdin.isTTY) {
@@ -1041,7 +1209,16 @@ async function handleHook() {
     return;
   }
   const config = loadConfig();
-  if (!config.writeKey) {
+  if (!config.enabled) {
+    return;
+  }
+  const debugger_ = await detectLocalDebugger(config.debug);
+  if (debugger_.url && debugger_.autoDetected) {
+    process.env[LOCAL_DEBUGGER_ENV_VAR] = debugger_.url;
+  }
+  const hasCloudKey = Boolean(config.writeKey);
+  const hasDebugger = Boolean(debugger_.url);
+  if (!hasCloudKey && !hasDebugger) {
     return;
   }
   const mapperConfig = {
@@ -1051,13 +1228,44 @@ async function handleHook() {
   const eventShipper = new EventShipper2({
     writeKey: config.writeKey,
     endpoint: config.endpoint,
-    debug: config.debug
+    debug: config.debug,
+    // Only ship to the cloud when we have an API key. When only the local
+    // debugger is present the shipper still needs to be instantiated so the
+    // event mapper can call patch/finish, but cloud POSTs are skipped.
+    enabled: hasCloudKey
   });
   const traceShipper = new TraceShipper2({
     writeKey: config.writeKey,
     endpoint: config.endpoint,
-    debug: config.debug
+    debug: config.debug,
+    enabled: hasCloudKey
   });
+  if (debugger_.url) {
+    const debuggerUrl = debugger_.url;
+    const origPatch = eventShipper.patch.bind(eventShipper);
+    eventShipper.patch = async (eventId, patch) => {
+      var _a, _b, _c, _d;
+      const traceId = (_a = getOtlpTraceId(payload.session_id)) != null ? _a : payload.session_id;
+      mirrorEventToLocalDebugger(debuggerUrl, {
+        event_id: eventId,
+        user_id: (_b = patch.userId) != null ? _b : config.userId,
+        event: (_c = patch.eventName) != null ? _c : "claude_code_session",
+        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+        ai_data: {
+          input: patch.input,
+          output: patch.output,
+          model: patch.model,
+          convo_id: patch.convoId
+        },
+        properties: {
+          ...patch.properties,
+          ...payload.session_id ? { trace_id: traceId } : {}
+        },
+        is_pending: (_d = patch.isPending) != null ? _d : true
+      }, config.debug);
+      await origPatch(eventId, patch);
+    };
+  }
   try {
     await mapHookToRaindrop(payload, mapperConfig, eventShipper, traceShipper);
     await Promise.all([eventShipper.flush(), traceShipper.flush()]);
@@ -1072,17 +1280,18 @@ async function handleHook() {
 }
 
 // src/setup.ts
-import { existsSync as existsSync3, mkdirSync as mkdirSync2, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "fs";
+import { existsSync as existsSync5, mkdirSync as mkdirSync4, readFileSync as readFileSync5, writeFileSync as writeFileSync4 } from "fs";
 import { homedir as homedir2, userInfo as userInfo2 } from "os";
-import { dirname, join as join3, resolve } from "path";
+import { dirname as dirname2, join as join5, resolve } from "path";
 import { createInterface } from "readline";
+import { execSync } from "child_process";
 function getClaudeSettingsPath(scope, cwd) {
   if (scope === "project") {
     return resolve(cwd, ".claude", "settings.json");
   }
-  return join3(homedir2(), ".claude", "settings.json");
+  return join5(homedir2(), ".claude", "settings.json");
 }
-var HOOK_EVENTS = [
+var CORE_HOOK_EVENTS = [
   "SessionStart",
   "UserPromptSubmit",
   "PreToolUse",
@@ -1090,15 +1299,58 @@ var HOOK_EVENTS = [
   "PostToolUseFailure",
   "SubagentStart",
   "SubagentStop",
-  "PermissionDenied",
-  "PostCompact",
   "Stop",
-  "StopFailure",
   "SessionEnd"
 ];
-function makeHookConfig() {
+var VERSIONED_HOOK_EVENTS = [
+  { minVersion: "2.1.78", events: ["StopFailure"] },
+  { minVersion: "2.1.76", events: ["PostCompact"] },
+  { minVersion: "2.1.89", events: ["PermissionDenied"] }
+];
+function parseVersion(version) {
+  const match = version.match(/(\d+)\.(\d+)\.(\d+)/);
+  if (!match) return void 0;
+  return [parseInt(match[1], 10), parseInt(match[2], 10), parseInt(match[3], 10)];
+}
+function isVersionAtLeast(current, required) {
+  const req = parseVersion(required);
+  if (!req) return false;
+  for (let i = 0; i < 3; i++) {
+    if (current[i] > req[i]) return true;
+    if (current[i] < req[i]) return false;
+  }
+  return true;
+}
+function detectClaudeCodeVersion() {
+  try {
+    const output = execSync("claude --version", {
+      encoding: "utf-8",
+      timeout: 5e3,
+      stdio: ["ignore", "pipe", "ignore"]
+    }).trim();
+    const match = output.match(/(\d+\.\d+\.\d+)/);
+    return match ? match[1] : void 0;
+  } catch (e) {
+    return void 0;
+  }
+}
+function getHookEventsForVersion(version) {
+  const events = [...CORE_HOOK_EVENTS];
+  if (!version) {
+    return events;
+  }
+  const parsed = parseVersion(version);
+  if (!parsed) return events;
+  for (const { minVersion, events: versionedEvents } of VERSIONED_HOOK_EVENTS) {
+    if (isVersionAtLeast(parsed, minVersion)) {
+      events.push(...versionedEvents);
+    }
+  }
+  return events;
+}
+function makeHookConfig(hookEvents) {
   const hooks = {};
-  for (const event of HOOK_EVENTS) {
+  for (const event of hookEvents) {
     hooks[event] = [
       {
         hooks: [
@@ -1129,10 +1381,10 @@ async function runSetup(args2) {
   const scopeLabel = scope === "project" ? "project" : "global";
   console.log("\n  Raindrop \xD7 Claude Code \u2014 Setup\n");
   let writeKey = (_c = (_b = args2.writeKey) != null ? _b : process.env["RAINDROP_WRITE_KEY"]) != null ? _c : "";
-  if (!writeKey) {
+  if (!writeKey && !args2.localOnly) {
     writeKey = await prompt("  Enter your Raindrop write key: ");
   }
-  if (!writeKey) {
+  if (!writeKey && !args2.localOnly) {
     console.error("\n  Error: write key is required. Get it from https://app.raindrop.ai\n");
     process.exit(1);
   }
@@ -1144,37 +1396,47 @@ async function runSetup(args2) {
       userId = "unknown";
     }
   }
-  const configPath = getConfigPath();
-  const configDir = dirname(configPath);
-  mkdirSync2(configDir, { recursive: true });
-  let existingConfig = {};
-  try {
-    if (existsSync3(configPath)) {
-      existingConfig = JSON.parse(readFileSync3(configPath, "utf-8"));
+  if (writeKey) {
+    const configPath = getConfigPath();
+    const configDir = dirname2(configPath);
+    mkdirSync4(configDir, { recursive: true });
+    let existingConfig = {};
+    try {
+      if (existsSync5(configPath)) {
+        existingConfig = JSON.parse(readFileSync5(configPath, "utf-8"));
+      }
+    } catch (e) {
     }
-  } catch (e) {
+    const raindropConfig = {
+      ...existingConfig,
+      write_key: writeKey,
+      user_id: userId
+    };
+    writeFileSync4(configPath, JSON.stringify(raindropConfig, null, 2) + "\n", "utf-8");
+    console.log(`  Saved Raindrop config to ${configPath}`);
+  }
+  const ccVersion = detectClaudeCodeVersion();
+  const hookEvents = getHookEventsForVersion(ccVersion);
+  if (ccVersion) {
+    console.log(`  Detected Claude Code v${ccVersion}`);
+  } else {
+    console.log(`  Could not detect Claude Code version \u2014 registering core hooks only.`);
+    console.log(`  Run setup again after installing Claude Code to enable all hooks.`);
   }
-  const raindropConfig = {
-    ...existingConfig,
-    write_key: writeKey,
-    user_id: userId
-  };
-  writeFileSync2(configPath, JSON.stringify(raindropConfig, null, 2) + "\n", "utf-8");
-  console.log(`  Saved Raindrop config to ${configPath}`);
   const settingsPath = getClaudeSettingsPath(scope, process.cwd());
-  const settingsDir = dirname(settingsPath);
-  mkdirSync2(settingsDir, { recursive: true });
+  const settingsDir = dirname2(settingsPath);
+  mkdirSync4(settingsDir, { recursive: true });
   let settings = {};
-  if (existsSync3(settingsPath)) {
+  if (existsSync5(settingsPath)) {
     try {
-      settings = JSON.parse(readFileSync3(settingsPath, "utf-8"));
+      settings = JSON.parse(readFileSync5(settingsPath, "utf-8"));
     } catch (e) {
       console.warn(`  Warning: could not parse ${settingsPath}, creating fresh`);
       settings = {};
     }
   }
   const existingHooks = (_e = settings["hooks"]) != null ? _e : {};
-  const newHooks = makeHookConfig();
+  const newHooks = makeHookConfig(hookEvents);
   for (const [event, hookGroups] of Object.entries(newHooks)) {
     const existing = existingHooks[event];
     if (!existing || !Array.isArray(existing)) {
@@ -1193,9 +1455,8 @@ async function runSetup(args2) {
     }
   }
   settings["hooks"] = existingHooks;
-  writeFileSync2(settingsPath, JSON.stringify(settings, null, 2) + "\n", "utf-8");
+  writeFileSync4(settingsPath, JSON.stringify(settings, null, 2) + "\n", "utf-8");
   console.log(`  Updated Claude Code hooks in ${settingsPath} (${scopeLabel})`);
-  const { execSync } = await import("child_process");
   const whichCmd = process.platform === "win32" ? "where" : "which";
   try {
     execSync(`${whichCmd} raindrop-claude-code`, { stdio: "ignore" });
@@ -1207,7 +1468,8 @@ async function runSetup(args2) {
     npm install -g @raindrop-ai/claude-code
 `);
   }
-  console.log(`
+  if (writeKey) {
+    console.log(`
   Done! Claude Code will now send telemetry to Raindrop.
   Scope: ${scopeLabel}
   User ID: ${userId}
@@ -1215,6 +1477,13 @@ async function runSetup(args2) {
   To verify, start a Claude Code session and check your Raindrop dashboard.
   Set RAINDROP_DEBUG=true for verbose logging.
 `);
+  } else {
+    console.log(`
+  Done! Hooks installed (${scopeLabel}).
+  No write key configured \u2014 events will only be sent to the local debugger.
+  Start it with: npx @raindrop-ai/local-debugger
+`);
+  }
 }
 
 // src/cli.ts
@@ -1233,7 +1502,8 @@ async function main() {
       await runSetup({
         writeKey: parseFlag("write-key"),
         userId: parseFlag("user-id"),
-        scope
+        scope,
+        localOnly: args.includes("--local-only")
       });
       break;
     }
@@ -1241,6 +1511,32 @@ async function main() {
       await handleHook();
       break;
     }
+    case "status": {
+      const config = loadConfig();
+      const result = await detectLocalDebugger(config.debug);
+      console.log("");
+      if (result.url) {
+        console.log(`  Local debugger: \x1B[32m\u25CF connected\x1B[0m`);
+        console.log(`  URL: ${result.url}`);
+        console.log(`  Source: ${result.autoDetected ? "auto-detected" : "RAINDROP_LOCAL_DEBUGGER env var"}`);
+      } else {
+        console.log(`  Local debugger: \x1B[2m\u25CB not detected\x1B[0m`);
+        console.log(`  Start it with: npx @dawn/local-debugger`);
+      }
+      console.log(`  Hooks: ${config.enabled ? "\x1B[32menabled\x1B[0m" : "\x1B[2mdisabled\x1B[0m"}`);
+      console.log("");
+      break;
+    }
+    case "enable": {
+      updateConfig({ enabled: true });
+      console.log("  Raindrop hooks enabled.");
+      break;
+    }
+    case "disable": {
+      updateConfig({ enabled: false });
+      console.log("  Raindrop hooks disabled.");
+      break;
+    }
     case "version":
     case "--version":
     case "-v": {
@@ -1261,16 +1557,21 @@ async function main() {
       --write-key=KEY   Raindrop write key (or set RAINDROP_WRITE_KEY)
       --user-id=ID      User identifier (defaults to system username)
       --scope=SCOPE     "user" (global, default) or "project" (.claude/ in cwd)
+      --local-only      Install hooks without a write key (local debugger only)
 
     hook                Handle a Claude Code hook event (reads JSON from stdin)
+    status              Check local debugger connectivity
+    enable              Enable Raindrop hooks
+    disable             Disable Raindrop hooks
     version             Print version
     help                Show this help message
 
   Environment:
-    RAINDROP_WRITE_KEY  API write key (alternative to --write-key or config file)
-    RAINDROP_USER_ID    User ID override
-    RAINDROP_API_URL    Custom API endpoint
-    RAINDROP_DEBUG      Set to "true" for verbose logging
+    RAINDROP_WRITE_KEY        API write key (alternative to --write-key or config file)
+    RAINDROP_USER_ID          User ID override
+    RAINDROP_API_URL          Custom API endpoint
+    RAINDROP_LOCAL_DEBUGGER   Local debugger URL (auto-detected if running on :5899)
+    RAINDROP_DEBUG            Set to "true" for verbose logging
 `);
       if (!command || command === "help" || command === "--help" || command === "-h") {
         process.exit(0);

package/dist/index.cjs

@@ -24,13 +24,16 @@ __export(src_exports, {
   PACKAGE_NAME: () => PACKAGE_NAME,
   PACKAGE_VERSION: () => PACKAGE_VERSION,
   TraceShipper: () => TraceShipper2,
+  detectLocalDebugger: () => detectLocalDebugger,
   getConfigPath: () => getConfigPath,
   loadConfig: () => loadConfig,
-  mapHookToRaindrop: () => mapHookToRaindrop
+  mapHookToRaindrop: () => mapHookToRaindrop,
+  mirrorEventToLocalDebugger: () => mirrorEventToLocalDebugger,
+  updateConfig: () => updateConfig
 });
 module.exports = __toCommonJS(src_exports);
 
-// ../core/dist/chunk-H6VSZSLN.js
+// ../core/dist/chunk-4UCYIEH4.js
 function getCrypto() {
   const c = globalThis.crypto;
   return c;
@@ -466,11 +469,28 @@ 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;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
     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;
@@ -483,6 +503,13 @@ 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}`);
+      }
+    }
   }
   isDebugEnabled() {
     return this.debug;
@@ -499,7 +526,25 @@ var TraceShipper = class {
       attrString("ai.operationId", args.operationId)
     ];
     if ((_b = args.attributes) == null ? void 0 : _b.length) attrs.push(...args.attributes);
-    return { ids, name: args.name, startTimeUnixNano: started, attributes: attrs };
+    const span = { ids, name: args.name, startTimeUnixNano: started, attributes: attrs };
+    if (this.localDebuggerUrl) {
+      const openSpan = buildOtlpSpan({
+        ids: span.ids,
+        name: span.name,
+        startTimeUnixNano: span.startTimeUnixNano,
+        endTimeUnixNano: span.startTimeUnixNano,
+        // 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;
   }
   endSpan(span, extra) {
     var _a, _b;
@@ -522,6 +567,14 @@ 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
+      });
+    }
   }
   createSpan(args) {
     var _a;
@@ -539,6 +592,14 @@ 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
+      });
+    }
   }
   enqueue(span) {
     if (!this.enabled) return;
@@ -662,7 +723,7 @@ var import_node_os = require("os");
 var import_node_path = require("path");
 var CONFIG_PATH = (0, import_node_path.join)((0, import_node_os.homedir)(), ".config", "raindrop", "config.json");
 function loadConfig() {
-  var _a, _b, _c, _d, _e, _f, _g;
+  var _a, _b, _c, _d, _e, _f, _g, _h;
   let file = {};
   try {
     if ((0, import_node_fs.existsSync)(CONFIG_PATH)) {
@@ -681,12 +742,25 @@ function loadConfig() {
     writeKey: (_b = (_a = process.env["RAINDROP_WRITE_KEY"]) != null ? _a : file.write_key) != null ? _b : "",
     endpoint: (_d = (_c = process.env["RAINDROP_API_URL"]) != null ? _c : file.api_url) != null ? _d : "https://api.raindrop.ai/v1",
     userId: (_f = (_e = process.env["RAINDROP_USER_ID"]) != null ? _e : file.user_id) != null ? _f : systemUser,
-    debug: process.env["RAINDROP_DEBUG"] === "true" ? true : (_g = file.debug) != null ? _g : false
+    debug: process.env["RAINDROP_DEBUG"] === "true" ? true : (_g = file.debug) != null ? _g : false,
+    enabled: (_h = file.enabled) != null ? _h : true
   };
 }
 function getConfigPath() {
   return CONFIG_PATH;
 }
+function updateConfig(patch) {
+  const dir = (0, import_node_path.dirname)(CONFIG_PATH);
+  (0, import_node_fs.mkdirSync)(dir, { recursive: true });
+  let existing = {};
+  try {
+    if ((0, import_node_fs.existsSync)(CONFIG_PATH)) {
+      existing = JSON.parse((0, import_node_fs.readFileSync)(CONFIG_PATH, "utf-8"));
+    }
+  } catch (e) {
+  }
+  (0, import_node_fs.writeFileSync)(CONFIG_PATH, JSON.stringify({ ...existing, ...patch }, null, 2) + "\n", "utf-8");
+}
 
 // src/event-mapper.ts
 var import_node_fs2 = require("fs");
@@ -1027,13 +1101,97 @@ async function handleSessionEnd(payload, eventId, config, properties, eventShipp
     }
   });
 }
+
+// src/local-debugger.ts
+var import_node_fs3 = require("fs");
+var import_node_os3 = require("os");
+var import_node_path3 = require("path");
+var DEFAULT_PORT = 5899;
+var DEFAULT_URL = `http://localhost:${DEFAULT_PORT}/v1/`;
+var HEALTH_TIMEOUT_MS = 300;
+var CACHE_DIR = (0, import_node_path3.join)((0, import_node_os3.tmpdir)(), "raindrop-claude-code");
+var CACHE_FILE = (0, import_node_path3.join)(CACHE_DIR, "debugger_cache");
+var CACHE_TTL_MS = 5e3;
+function readCache() {
+  try {
+    if (!(0, import_node_fs3.existsSync)(CACHE_FILE)) return void 0;
+    const data = JSON.parse((0, import_node_fs3.readFileSync)(CACHE_FILE, "utf-8"));
+    if (Date.now() - data.ts > CACHE_TTL_MS) return void 0;
+    return data;
+  } catch (e) {
+    return void 0;
+  }
+}
+function writeCache(url) {
+  try {
+    (0, import_node_fs3.mkdirSync)(CACHE_DIR, { recursive: true });
+    (0, import_node_fs3.writeFileSync)(CACHE_FILE, JSON.stringify({ url, ts: Date.now() }), "utf-8");
+  } catch (e) {
+  }
+}
+async function healthPing(baseUrl) {
+  const healthUrl = baseUrl.replace(/\/v1\/$/, "/health");
+  try {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), HEALTH_TIMEOUT_MS);
+    const resp = await fetch(healthUrl, { signal: controller.signal });
+    clearTimeout(timeout);
+    if (resp.ok) {
+      const body = await resp.json();
+      if (body.ok) return baseUrl;
+    }
+  } catch (e) {
+  }
+  return null;
+}
+async function detectLocalDebugger(debug) {
+  var _a;
+  const envUrl = resolveLocalDebuggerBaseUrl();
+  if (envUrl) {
+    if (debug) {
+      console.log(`[raindrop-ai/claude-code] Local debugger configured via ${LOCAL_DEBUGGER_ENV_VAR}: ${envUrl}`);
+    }
+    return { url: envUrl, autoDetected: false };
+  }
+  const cached = readCache();
+  if (cached) {
+    if (debug) {
+      console.log(`[raindrop-ai/claude-code] Local debugger cache hit: ${(_a = cached.url) != null ? _a : "not running"}`);
+    }
+    return { url: cached.url, autoDetected: cached.url !== null };
+  }
+  if (debug) {
+    console.log(`[raindrop-ai/claude-code] Probing local debugger at localhost:${DEFAULT_PORT}...`);
+  }
+  const detected = await healthPing(DEFAULT_URL);
+  writeCache(detected);
+  if (detected && debug) {
+    console.log(`[raindrop-ai/claude-code] Local debugger auto-detected at ${detected}`);
+  }
+  return { url: detected, autoDetected: detected !== null };
+}
+function mirrorEventToLocalDebugger(baseUrl, payload, debug) {
+  const url = `${baseUrl}events/track_partial`;
+  if (debug) {
+    console.log(`[raindrop-ai/claude-code] Mirroring event to local debugger: ${url}`);
+  }
+  void fetch(url, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(payload)
+  }).catch(() => {
+  });
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   EventShipper,
   PACKAGE_NAME,
   PACKAGE_VERSION,
   TraceShipper,
+  detectLocalDebugger,
   getConfigPath,
   loadConfig,
-  mapHookToRaindrop
+  mapHookToRaindrop,
+  mirrorEventToLocalDebugger,
+  updateConfig
 });

package/dist/index.d.cts

@@ -147,6 +147,8 @@ declare class TraceShipper$1 {
     private queue;
     private timer;
     private inFlight;
+    /** URL of the local debugger (from RAINDROP_LOCAL_DEBUGGER env var). */
+    private localDebuggerUrl;
     constructor(opts: TraceShipperOptions);
     isDebugEnabled(): boolean;
     private authHeaders;
@@ -219,11 +221,19 @@ declare class TraceShipper extends TraceShipper$1 {
     enqueue(span: OtlpSpan): void;
 }
 
+interface ConfigFile {
+    write_key?: string;
+    api_url?: string;
+    user_id?: string;
+    debug?: boolean;
+    enabled?: boolean;
+}
 interface RaindropConfig {
     writeKey: string;
     endpoint: string;
     userId: string;
     debug: boolean;
+    enabled: boolean;
 }
 /**
  * Load config with precedence (low -> high):
@@ -233,6 +243,7 @@ interface RaindropConfig {
  */
 declare function loadConfig(): RaindropConfig;
 declare function getConfigPath(): string;
+declare function updateConfig(patch: Partial<ConfigFile>): void;
 
 type SetupScope = "user" | "project";
 
@@ -270,4 +281,25 @@ declare function mapHookToRaindrop(payload: HookPayload, config: MapperConfig, e
 declare const PACKAGE_NAME = "@raindrop-ai/claude-code";
 declare const PACKAGE_VERSION = "0.0.1";
 
-export { EventShipper, type HookPayload, type MapperConfig, PACKAGE_NAME, PACKAGE_VERSION, type RaindropConfig, type SetupScope, TraceShipper, getConfigPath, loadConfig, mapHookToRaindrop };
+interface LocalDebuggerResult {
+    /** The resolved base URL (e.g. "http://localhost:5899/v1/"), or null if not detected. */
+    url: string | null;
+    /** Whether the debugger was auto-detected (vs explicitly configured via env var). */
+    autoDetected: boolean;
+}
+/**
+ * Detect whether the local debugger is available.
+ *
+ * Resolution order:
+ * 1. RAINDROP_LOCAL_DEBUGGER env var — use directly (no health check, trust the user)
+ * 2. Cached probe result (within TTL)
+ * 3. Probe http://localhost:5899/health with a short timeout
+ */
+declare function detectLocalDebugger(debug: boolean): Promise<LocalDebuggerResult>;
+/**
+ * Mirror an event payload to the local debugger's track_partial endpoint.
+ * Fire-and-forget — errors are silently swallowed.
+ */
+declare function mirrorEventToLocalDebugger(baseUrl: string, payload: Record<string, unknown>, debug: boolean): void;
+
+export { EventShipper, type HookPayload, type LocalDebuggerResult, type MapperConfig, PACKAGE_NAME, PACKAGE_VERSION, type RaindropConfig, type SetupScope, TraceShipper, detectLocalDebugger, getConfigPath, loadConfig, mapHookToRaindrop, mirrorEventToLocalDebugger, updateConfig };

package/dist/index.d.ts

@@ -147,6 +147,8 @@ declare class TraceShipper$1 {
     private queue;
     private timer;
     private inFlight;
+    /** URL of the local debugger (from RAINDROP_LOCAL_DEBUGGER env var). */
+    private localDebuggerUrl;
     constructor(opts: TraceShipperOptions);
     isDebugEnabled(): boolean;
     private authHeaders;
@@ -219,11 +221,19 @@ declare class TraceShipper extends TraceShipper$1 {
     enqueue(span: OtlpSpan): void;
 }
 
+interface ConfigFile {
+    write_key?: string;
+    api_url?: string;
+    user_id?: string;
+    debug?: boolean;
+    enabled?: boolean;
+}
 interface RaindropConfig {
     writeKey: string;
     endpoint: string;
     userId: string;
     debug: boolean;
+    enabled: boolean;
 }
 /**
  * Load config with precedence (low -> high):
@@ -233,6 +243,7 @@ interface RaindropConfig {
  */
 declare function loadConfig(): RaindropConfig;
 declare function getConfigPath(): string;
+declare function updateConfig(patch: Partial<ConfigFile>): void;
 
 type SetupScope = "user" | "project";
 
@@ -270,4 +281,25 @@ declare function mapHookToRaindrop(payload: HookPayload, config: MapperConfig, e
 declare const PACKAGE_NAME = "@raindrop-ai/claude-code";
 declare const PACKAGE_VERSION = "0.0.1";
 
-export { EventShipper, type HookPayload, type MapperConfig, PACKAGE_NAME, PACKAGE_VERSION, type RaindropConfig, type SetupScope, TraceShipper, getConfigPath, loadConfig, mapHookToRaindrop };
+interface LocalDebuggerResult {
+    /** The resolved base URL (e.g. "http://localhost:5899/v1/"), or null if not detected. */
+    url: string | null;
+    /** Whether the debugger was auto-detected (vs explicitly configured via env var). */
+    autoDetected: boolean;
+}
+/**
+ * Detect whether the local debugger is available.
+ *
+ * Resolution order:
+ * 1. RAINDROP_LOCAL_DEBUGGER env var — use directly (no health check, trust the user)
+ * 2. Cached probe result (within TTL)
+ * 3. Probe http://localhost:5899/health with a short timeout
+ */
+declare function detectLocalDebugger(debug: boolean): Promise<LocalDebuggerResult>;
+/**
+ * Mirror an event payload to the local debugger's track_partial endpoint.
+ * Fire-and-forget — errors are silently swallowed.
+ */
+declare function mirrorEventToLocalDebugger(baseUrl: string, payload: Record<string, unknown>, debug: boolean): void;
+
+export { EventShipper, type HookPayload, type LocalDebuggerResult, type MapperConfig, PACKAGE_NAME, PACKAGE_VERSION, type RaindropConfig, type SetupScope, TraceShipper, detectLocalDebugger, getConfigPath, loadConfig, mapHookToRaindrop, mirrorEventToLocalDebugger, updateConfig };

package/dist/index.js

@@ -1,4 +1,4 @@
-// ../core/dist/chunk-H6VSZSLN.js
+// ../core/dist/chunk-4UCYIEH4.js
 function getCrypto() {
   const c = globalThis.crypto;
   return c;
@@ -434,11 +434,28 @@ 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;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
     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;
@@ -451,6 +468,13 @@ 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}`);
+      }
+    }
   }
   isDebugEnabled() {
     return this.debug;
@@ -467,7 +491,25 @@ var TraceShipper = class {
       attrString("ai.operationId", args.operationId)
     ];
     if ((_b = args.attributes) == null ? void 0 : _b.length) attrs.push(...args.attributes);
-    return { ids, name: args.name, startTimeUnixNano: started, attributes: attrs };
+    const span = { ids, name: args.name, startTimeUnixNano: started, attributes: attrs };
+    if (this.localDebuggerUrl) {
+      const openSpan = buildOtlpSpan({
+        ids: span.ids,
+        name: span.name,
+        startTimeUnixNano: span.startTimeUnixNano,
+        endTimeUnixNano: span.startTimeUnixNano,
+        // 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;
   }
   endSpan(span, extra) {
     var _a, _b;
@@ -490,6 +532,14 @@ 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
+      });
+    }
   }
   createSpan(args) {
     var _a;
@@ -507,6 +557,14 @@ 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
+      });
+    }
   }
   enqueue(span) {
     if (!this.enabled) return;
@@ -625,12 +683,12 @@ var TraceShipper2 = class extends TraceShipper {
 };
 
 // src/config.ts
-import { existsSync, readFileSync } from "fs";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
 import { homedir, userInfo } from "os";
-import { join } from "path";
+import { dirname, join } from "path";
 var CONFIG_PATH = join(homedir(), ".config", "raindrop", "config.json");
 function loadConfig() {
-  var _a, _b, _c, _d, _e, _f, _g;
+  var _a, _b, _c, _d, _e, _f, _g, _h;
   let file = {};
   try {
     if (existsSync(CONFIG_PATH)) {
@@ -649,15 +707,28 @@ function loadConfig() {
     writeKey: (_b = (_a = process.env["RAINDROP_WRITE_KEY"]) != null ? _a : file.write_key) != null ? _b : "",
     endpoint: (_d = (_c = process.env["RAINDROP_API_URL"]) != null ? _c : file.api_url) != null ? _d : "https://api.raindrop.ai/v1",
     userId: (_f = (_e = process.env["RAINDROP_USER_ID"]) != null ? _e : file.user_id) != null ? _f : systemUser,
-    debug: process.env["RAINDROP_DEBUG"] === "true" ? true : (_g = file.debug) != null ? _g : false
+    debug: process.env["RAINDROP_DEBUG"] === "true" ? true : (_g = file.debug) != null ? _g : false,
+    enabled: (_h = file.enabled) != null ? _h : true
   };
 }
 function getConfigPath() {
   return CONFIG_PATH;
 }
+function updateConfig(patch) {
+  const dir = dirname(CONFIG_PATH);
+  mkdirSync(dir, { recursive: true });
+  let existing = {};
+  try {
+    if (existsSync(CONFIG_PATH)) {
+      existing = JSON.parse(readFileSync(CONFIG_PATH, "utf-8"));
+    }
+  } catch (e) {
+  }
+  writeFileSync(CONFIG_PATH, JSON.stringify({ ...existing, ...patch }, null, 2) + "\n", "utf-8");
+}
 
 // src/event-mapper.ts
-import { existsSync as existsSync2, mkdirSync, readFileSync as readFileSync2, unlinkSync, writeFileSync } from "fs";
+import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync as readFileSync2, unlinkSync, writeFileSync as writeFileSync2 } from "fs";
 import { randomUUID as randomUUID2 } from "crypto";
 import { tmpdir } from "os";
 import { join as join2 } from "path";
@@ -679,7 +750,7 @@ function safeStringify(value) {
 var STATE_DIR = join2(tmpdir(), "raindrop-claude-code");
 function ensureStateDir() {
   try {
-    mkdirSync(STATE_DIR, { recursive: true });
+    mkdirSync2(STATE_DIR, { recursive: true });
   } catch (e) {
   }
 }
@@ -697,7 +768,7 @@ function statePath(key) {
 function writeState(key, value) {
   try {
     ensureStateDir();
-    writeFileSync(statePath(key), value, "utf-8");
+    writeFileSync2(statePath(key), value, "utf-8");
   } catch (e) {
   }
 }
@@ -995,12 +1066,96 @@ async function handleSessionEnd(payload, eventId, config, properties, eventShipp
     }
   });
 }
+
+// src/local-debugger.ts
+import { existsSync as existsSync3, mkdirSync as mkdirSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "fs";
+import { tmpdir as tmpdir2 } from "os";
+import { join as join3 } from "path";
+var DEFAULT_PORT = 5899;
+var DEFAULT_URL = `http://localhost:${DEFAULT_PORT}/v1/`;
+var HEALTH_TIMEOUT_MS = 300;
+var CACHE_DIR = join3(tmpdir2(), "raindrop-claude-code");
+var CACHE_FILE = join3(CACHE_DIR, "debugger_cache");
+var CACHE_TTL_MS = 5e3;
+function readCache() {
+  try {
+    if (!existsSync3(CACHE_FILE)) return void 0;
+    const data = JSON.parse(readFileSync3(CACHE_FILE, "utf-8"));
+    if (Date.now() - data.ts > CACHE_TTL_MS) return void 0;
+    return data;
+  } catch (e) {
+    return void 0;
+  }
+}
+function writeCache(url) {
+  try {
+    mkdirSync3(CACHE_DIR, { recursive: true });
+    writeFileSync3(CACHE_FILE, JSON.stringify({ url, ts: Date.now() }), "utf-8");
+  } catch (e) {
+  }
+}
+async function healthPing(baseUrl) {
+  const healthUrl = baseUrl.replace(/\/v1\/$/, "/health");
+  try {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), HEALTH_TIMEOUT_MS);
+    const resp = await fetch(healthUrl, { signal: controller.signal });
+    clearTimeout(timeout);
+    if (resp.ok) {
+      const body = await resp.json();
+      if (body.ok) return baseUrl;
+    }
+  } catch (e) {
+  }
+  return null;
+}
+async function detectLocalDebugger(debug) {
+  var _a;
+  const envUrl = resolveLocalDebuggerBaseUrl();
+  if (envUrl) {
+    if (debug) {
+      console.log(`[raindrop-ai/claude-code] Local debugger configured via ${LOCAL_DEBUGGER_ENV_VAR}: ${envUrl}`);
+    }
+    return { url: envUrl, autoDetected: false };
+  }
+  const cached = readCache();
+  if (cached) {
+    if (debug) {
+      console.log(`[raindrop-ai/claude-code] Local debugger cache hit: ${(_a = cached.url) != null ? _a : "not running"}`);
+    }
+    return { url: cached.url, autoDetected: cached.url !== null };
+  }
+  if (debug) {
+    console.log(`[raindrop-ai/claude-code] Probing local debugger at localhost:${DEFAULT_PORT}...`);
+  }
+  const detected = await healthPing(DEFAULT_URL);
+  writeCache(detected);
+  if (detected && debug) {
+    console.log(`[raindrop-ai/claude-code] Local debugger auto-detected at ${detected}`);
+  }
+  return { url: detected, autoDetected: detected !== null };
+}
+function mirrorEventToLocalDebugger(baseUrl, payload, debug) {
+  const url = `${baseUrl}events/track_partial`;
+  if (debug) {
+    console.log(`[raindrop-ai/claude-code] Mirroring event to local debugger: ${url}`);
+  }
+  void fetch(url, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(payload)
+  }).catch(() => {
+  });
+}
 export {
   EventShipper2 as EventShipper,
   PACKAGE_NAME,
   PACKAGE_VERSION,
   TraceShipper2 as TraceShipper,
+  detectLocalDebugger,
   getConfigPath,
   loadConfig,
-  mapHookToRaindrop
+  mapHookToRaindrop,
+  mirrorEventToLocalDebugger,
+  updateConfig
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@raindrop-ai/claude-code",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "Raindrop observability for Claude Code CLI — automatic session, tool call, and prompt tracing via hooks",
   "license": "MIT",
   "type": "module",