raindrop-ai 0.0.92 → 0.1.0

package/dist/{chunk-PURTSYKG.mjs → chunk-S6UIW5C4.mjs}

@@ -1,4 +1,4 @@
-// ../core/dist/chunk-Y7SM66SW.js
+// ../core/dist/chunk-LMIWKHOH.js
 function wait(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
@@ -89,10 +89,66 @@ async function postJson(url, body, headers, opts) {
   );
 }
 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(hostname) {
+  if (!hostname) return false;
+  if (hostname === "localhost" || hostname === "127.0.0.1" || hostname === "0.0.0.0" || hostname === "::1") {
+    return true;
+  }
+  if (hostname.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;
-  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;
+  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 localDebuggerEnabled(baseUrl) {
   return resolveLocalDebuggerBaseUrl(baseUrl) !== null;
@@ -148,7 +204,7 @@ globalThis.RAINDROP_ASYNC_LOCAL_STORAGE = AsyncLocalStorage;
 // package.json
 var package_default = {
   name: "raindrop-ai",
-  version: "0.0.92",
+  version: "0.1.0",
   main: "dist/index.js",
   module: "dist/index.mjs",
   types: "dist/index.d.ts",
@@ -510,19 +566,18 @@ var DirectTraceShipper = class {
   constructor(opts) {
     this.queue = [];
     this.inFlight = /* @__PURE__ */ new Set();
-    var _a, _b, _c, _d, _e;
+    var _a, _b, _c, _d, _e, _f;
     this.writeKey = opts.writeKey;
     this.baseUrl = (_a = formatEndpoint2(opts.endpoint)) != null ? _a : "https://api.raindrop.ai/v1/";
     this.enabled = (_b = opts.enabled) != null ? _b : true;
+    this.cloudEnabled = (_c = opts.cloudEnabled) != null ? _c : true;
     this.debug = opts.debug;
-    this.flushIntervalMs = (_c = opts.flushIntervalMs) != null ? _c : 1e3;
-    this.maxBatchSize = (_d = opts.maxBatchSize) != null ? _d : 50;
-    this.maxQueueSize = (_e = opts.maxQueueSize) != null ? _e : 5e3;
-    if (localDebuggerEnabled()) {
-      const resolved = resolveLocalDebuggerBaseUrl();
-      if (resolved && resolved !== this.baseUrl) {
-        this.localDebuggerUrl = resolved;
-      }
+    this.flushIntervalMs = (_d = opts.flushIntervalMs) != null ? _d : 1e3;
+    this.maxBatchSize = (_e = opts.maxBatchSize) != null ? _e : 50;
+    this.maxQueueSize = (_f = opts.maxQueueSize) != null ? _f : 5e3;
+    const resolved = resolveLocalDebuggerBaseUrl(opts.localDebuggerUrl);
+    if (resolved && resolved !== this.baseUrl) {
+      this.localDebuggerUrl = resolved;
     }
   }
   /**
@@ -631,6 +686,10 @@ var DirectTraceShipper = class {
     }
     while (this.queue.length > 0) {
       const batch = this.queue.splice(0, this.maxBatchSize);
+      if (!this.cloudEnabled) {
+        if (this.debug) console.log(`[raindrop] direct: dropped ${batch.length} cloud spans (local-only)`);
+        continue;
+      }
       const body = buildExportTraceServiceRequest2(batch);
       const url = `${this.baseUrl}traces`;
       const p = postJson2(
@@ -1567,8 +1626,8 @@ function isLocalDebuggerUrl(baseUrl) {
     return false;
   }
 }
-function resolveLocalDebuggerExporterBaseUrl() {
-  const localDebuggerUrl = resolveLocalDebuggerBaseUrl();
+function resolveLocalDebuggerExporterBaseUrl(baseUrlOpt) {
+  const localDebuggerUrl = resolveLocalDebuggerBaseUrl(baseUrlOpt);
   if (!localDebuggerUrl || !isLocalDebuggerUrl(localDebuggerUrl)) {
     return null;
   }
@@ -1578,7 +1637,7 @@ function createLocalDebuggerOtlpExporter(config) {
   return new OTLPHttpTraceExporter(config);
 }
 function createLocalDebuggerSpanProcessor(options) {
-  const localDebuggerUrl = resolveLocalDebuggerExporterBaseUrl();
+  const localDebuggerUrl = resolveLocalDebuggerExporterBaseUrl(options.localDebuggerUrlOpt);
   if (!localDebuggerUrl) {
     return void 0;
   }
@@ -1868,7 +1927,18 @@ function getCurrentTraceId() {
   return (_a = trace4.getSpan(context4.active())) == null ? void 0 : _a.spanContext().traceId;
 }
 var tracing = (analytics, apiUrl, writeKey, options, isDebug = false) => {
-  const { logLevel, useExternalOtel, tracingEnabled, disableBatching, bypassOtelForTools, directEndpoint, ...otherOptions } = options;
+  const {
+    logLevel,
+    useExternalOtel,
+    tracingEnabled,
+    disableBatching,
+    bypassOtelForTools,
+    directEndpoint,
+    localDebuggerUrl,
+    cloudEnabled,
+    ...otherOptions
+  } = options;
+  const cloudEnabledResolved = cloudEnabled != null ? cloudEnabled : true;
   if (isDebug) {
     const mode = useExternalOtel ? "(external OTEL mode)" : tracingEnabled === false ? "(tracing disabled)" : "";
     console.log("[raindrop] Initializing tracing", mode);
@@ -1880,7 +1950,9 @@ var tracing = (analytics, apiUrl, writeKey, options, isDebug = false) => {
     writeKey,
     endpoint: directEndpoint != null ? directEndpoint : apiUrl,
     debug: isDebug,
-    enabled: tracingEnabled !== false
+    enabled: tracingEnabled !== false,
+    localDebuggerUrl,
+    cloudEnabled: cloudEnabledResolved
   }) : void 0;
   let traceloopInitialized = false;
   try {
@@ -1909,22 +1981,46 @@ var tracing = (analytics, apiUrl, writeKey, options, isDebug = false) => {
       const localDebuggerProcessor = createLocalDebuggerSpanProcessor({
         writeKey,
         disableBatching,
-        allowedInstrumentationLibraries: traceloop3.ALL_INSTRUMENTATION_LIBRARIES
+        allowedInstrumentationLibraries: traceloop3.ALL_INSTRUMENTATION_LIBRARIES,
+        localDebuggerUrlOpt: localDebuggerUrl
       });
-      const processor = mergeWithBestEffortLocalDebuggerProcessor(
-        otherOptions.processor,
-        localDebuggerProcessor
-      );
-      traceloop3.initialize({
-        baseUrl: apiUrl,
-        apiKey: writeKey,
-        ...otherOptions,
-        logLevel,
-        tracingEnabled: tracingEnabled !== false,
-        disableBatch: disableBatching,
-        ...processor ? { processor } : {}
-      });
-      traceloopInitialized = true;
+      if (!cloudEnabledResolved) {
+        if (localDebuggerProcessor) {
+          traceloop3.initialize({
+            baseUrl: apiUrl,
+            apiKey: writeKey,
+            ...otherOptions,
+            logLevel,
+            tracingEnabled: tracingEnabled !== false,
+            disableBatch: disableBatching,
+            processor: localDebuggerProcessor
+          });
+          traceloopInitialized = true;
+        } else {
+          traceloop3.initialize({
+            baseUrl: apiUrl,
+            apiKey: writeKey,
+            logLevel,
+            tracingEnabled: false
+          });
+          traceloopInitialized = true;
+        }
+      } else {
+        const processor = mergeWithBestEffortLocalDebuggerProcessor(
+          otherOptions.processor,
+          localDebuggerProcessor
+        );
+        traceloop3.initialize({
+          baseUrl: apiUrl,
+          apiKey: writeKey,
+          ...otherOptions,
+          logLevel,
+          tracingEnabled: tracingEnabled !== false,
+          disableBatch: disableBatching,
+          ...processor ? { processor } : {}
+        });
+        traceloopInitialized = true;
+      }
     }
   } catch (error) {
     console.warn(
@@ -1998,6 +2094,24 @@ var tracing = (analytics, apiUrl, writeKey, options, isDebug = false) => {
           }
         };
       }
+      if (!cloudEnabledResolved) {
+        const localOnlyProcessor = createLocalDebuggerSpanProcessor({
+          writeKey,
+          disableBatching,
+          allowedInstrumentationLibraries: processorOptions == null ? void 0 : processorOptions.allowedInstrumentationLibraries,
+          localDebuggerUrlOpt: localDebuggerUrl
+        });
+        return localOnlyProcessor != null ? localOnlyProcessor : {
+          forceFlush: async () => {
+          },
+          onStart: () => {
+          },
+          onEnd: () => {
+          },
+          shutdown: async () => {
+          }
+        };
+      }
       const productionProcessor = traceloop3.createSpanProcessor({
         baseUrl: apiUrl,
         apiKey: writeKey,
@@ -2007,7 +2121,8 @@ var tracing = (analytics, apiUrl, writeKey, options, isDebug = false) => {
       const localDebuggerProcessor = createLocalDebuggerSpanProcessor({
         writeKey,
         disableBatching,
-        allowedInstrumentationLibraries: processorOptions == null ? void 0 : processorOptions.allowedInstrumentationLibraries
+        allowedInstrumentationLibraries: processorOptions == null ? void 0 : processorOptions.allowedInstrumentationLibraries,
+        localDebuggerUrlOpt: localDebuggerUrl
       });
       return mergeWithBestEffortLocalDebuggerProcessor(
         productionProcessor,
@@ -2073,6 +2188,7 @@ var tracing = (analytics, apiUrl, writeKey, options, isDebug = false) => {
 };
 
 export {
+  resolveLocalDebuggerBaseUrl,
   mirrorPartialEventToLocalDebugger,
   package_default,
   tracing

package/dist/index.d.mts

@@ -723,12 +723,30 @@ type Tracer = {
 
 interface AnalyticsConfig {
     wizardSession?: string;
-    writeKey: string;
+    /**
+     * Raindrop write key. When omitted (or empty), the SDK runs in local-only mode:
+     * cloud requests are skipped and only the Workshop / local-debugger mirror fires
+     * (when `localWorkshopUrl` resolves to a URL). Useful for local development where
+     * you only want events to land in Workshop without provisioning a write key.
+     */
+    writeKey?: string;
     bufferSize?: number;
     bufferTimeout?: number;
     debugLogs?: boolean;
     endpoint?: string;
     redactPii?: boolean;
+    /**
+     * Force-enable (or opt out of) Workshop / local-debugger mirroring.
+     *
+     *   - `string` — explicit Workshop URL (e.g. `"http://localhost:5899/v1/"`),
+     *     wins over env vars and runtime auto-detect.
+     *   - `false` (or `null`) — explicit opt-out, even on localhost / when
+     *     `NODE_ENV=development` / when `RAINDROP_WORKSHOP` is set.
+     *   - `undefined` (default) — fall through to `RAINDROP_LOCAL_DEBUGGER`,
+     *     `RAINDROP_WORKSHOP`, and runtime auto-detect (localhost-ish hostname
+     *     OR `NODE_ENV=development` enables the default `:5899` daemon).
+     */
+    localWorkshopUrl?: string | false | null;
     /**
      * @deprecated Renamed to `useExternalOtel`. Use that instead.
      * This option will be removed in a future version.
@@ -833,11 +851,13 @@ declare class Raindrop {
     private disabled;
     private context;
     private _tracing;
+    private localDebuggerUrlOpt;
     private partialEventBuffer;
     private partialEventTimeouts;
     private inFlightRequests;
     debugLogs: boolean;
     constructor(config: AnalyticsConfig);
+    private get localOnly();
     private formatEndpoint;
     /**
      * Begins a new interaction.
@@ -943,6 +963,7 @@ declare class Raindrop {
     private getSize;
     private saveToBuffer;
     private flush;
+    private mirrorBatchToLocalDebugger;
     private sendBatchToApi;
     private getContext;
     private formatZodError;

package/dist/index.d.ts

@@ -723,12 +723,30 @@ type Tracer = {
 
 interface AnalyticsConfig {
     wizardSession?: string;
-    writeKey: string;
+    /**
+     * Raindrop write key. When omitted (or empty), the SDK runs in local-only mode:
+     * cloud requests are skipped and only the Workshop / local-debugger mirror fires
+     * (when `localWorkshopUrl` resolves to a URL). Useful for local development where
+     * you only want events to land in Workshop without provisioning a write key.
+     */
+    writeKey?: string;
     bufferSize?: number;
     bufferTimeout?: number;
     debugLogs?: boolean;
     endpoint?: string;
     redactPii?: boolean;
+    /**
+     * Force-enable (or opt out of) Workshop / local-debugger mirroring.
+     *
+     *   - `string` — explicit Workshop URL (e.g. `"http://localhost:5899/v1/"`),
+     *     wins over env vars and runtime auto-detect.
+     *   - `false` (or `null`) — explicit opt-out, even on localhost / when
+     *     `NODE_ENV=development` / when `RAINDROP_WORKSHOP` is set.
+     *   - `undefined` (default) — fall through to `RAINDROP_LOCAL_DEBUGGER`,
+     *     `RAINDROP_WORKSHOP`, and runtime auto-detect (localhost-ish hostname
+     *     OR `NODE_ENV=development` enables the default `:5899` daemon).
+     */
+    localWorkshopUrl?: string | false | null;
     /**
      * @deprecated Renamed to `useExternalOtel`. Use that instead.
      * This option will be removed in a future version.
@@ -833,11 +851,13 @@ declare class Raindrop {
     private disabled;
     private context;
     private _tracing;
+    private localDebuggerUrlOpt;
     private partialEventBuffer;
     private partialEventTimeouts;
     private inFlightRequests;
     debugLogs: boolean;
     constructor(config: AnalyticsConfig);
+    private get localOnly();
     private formatEndpoint;
     /**
      * Begins a new interaction.
@@ -943,6 +963,7 @@ declare class Raindrop {
     private getSize;
     private saveToBuffer;
     private flush;
+    private mirrorBatchToLocalDebugger;
     private sendBatchToApi;
     private getContext;
     private formatZodError;

package/dist/index.js

@@ -5771,7 +5771,7 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
-// ../core/dist/chunk-Y7SM66SW.js
+// ../core/dist/chunk-LMIWKHOH.js
 function wait(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
@@ -5862,10 +5862,66 @@ async function postJson(url, body, headers, opts) {
   );
 }
 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(hostname) {
+  if (!hostname) return false;
+  if (hostname === "localhost" || hostname === "127.0.0.1" || hostname === "0.0.0.0" || hostname === "::1") {
+    return true;
+  }
+  if (hostname.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;
-  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;
+  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 localDebuggerEnabled(baseUrl) {
   return resolveLocalDebuggerBaseUrl(baseUrl) !== null;
@@ -10026,7 +10082,7 @@ var SignalEventSchema = external_exports.object({
 // package.json
 var package_default = {
   name: "raindrop-ai",
-  version: "0.0.92",
+  version: "0.1.0",
   main: "dist/index.js",
   module: "dist/index.mjs",
   types: "dist/index.d.ts",
@@ -10474,19 +10530,18 @@ var DirectTraceShipper = class {
   constructor(opts) {
     this.queue = [];
     this.inFlight = /* @__PURE__ */ new Set();
-    var _a, _b, _c, _d, _e;
+    var _a, _b, _c, _d, _e, _f;
     this.writeKey = opts.writeKey;
     this.baseUrl = (_a = formatEndpoint2(opts.endpoint)) != null ? _a : "https://api.raindrop.ai/v1/";
     this.enabled = (_b = opts.enabled) != null ? _b : true;
+    this.cloudEnabled = (_c = opts.cloudEnabled) != null ? _c : true;
     this.debug = opts.debug;
-    this.flushIntervalMs = (_c = opts.flushIntervalMs) != null ? _c : 1e3;
-    this.maxBatchSize = (_d = opts.maxBatchSize) != null ? _d : 50;
-    this.maxQueueSize = (_e = opts.maxQueueSize) != null ? _e : 5e3;
-    if (localDebuggerEnabled()) {
-      const resolved = resolveLocalDebuggerBaseUrl();
-      if (resolved && resolved !== this.baseUrl) {
-        this.localDebuggerUrl = resolved;
-      }
+    this.flushIntervalMs = (_d = opts.flushIntervalMs) != null ? _d : 1e3;
+    this.maxBatchSize = (_e = opts.maxBatchSize) != null ? _e : 50;
+    this.maxQueueSize = (_f = opts.maxQueueSize) != null ? _f : 5e3;
+    const resolved = resolveLocalDebuggerBaseUrl(opts.localDebuggerUrl);
+    if (resolved && resolved !== this.baseUrl) {
+      this.localDebuggerUrl = resolved;
     }
   }
   /**
@@ -10595,6 +10650,10 @@ var DirectTraceShipper = class {
     }
     while (this.queue.length > 0) {
       const batch = this.queue.splice(0, this.maxBatchSize);
+      if (!this.cloudEnabled) {
+        if (this.debug) console.log(`[raindrop] direct: dropped ${batch.length} cloud spans (local-only)`);
+        continue;
+      }
       const body = buildExportTraceServiceRequest2(batch);
       const url = `${this.baseUrl}traces`;
       const p = postJson2(
@@ -11525,8 +11584,8 @@ function isLocalDebuggerUrl(baseUrl) {
     return false;
   }
 }
-function resolveLocalDebuggerExporterBaseUrl() {
-  const localDebuggerUrl = resolveLocalDebuggerBaseUrl();
+function resolveLocalDebuggerExporterBaseUrl(baseUrlOpt) {
+  const localDebuggerUrl = resolveLocalDebuggerBaseUrl(baseUrlOpt);
   if (!localDebuggerUrl || !isLocalDebuggerUrl(localDebuggerUrl)) {
     return null;
   }
@@ -11536,7 +11595,7 @@ function createLocalDebuggerOtlpExporter(config) {
   return new import_exporter_trace_otlp_http.OTLPTraceExporter(config);
 }
 function createLocalDebuggerSpanProcessor(options) {
-  const localDebuggerUrl = resolveLocalDebuggerExporterBaseUrl();
+  const localDebuggerUrl = resolveLocalDebuggerExporterBaseUrl(options.localDebuggerUrlOpt);
   if (!localDebuggerUrl) {
     return void 0;
   }
@@ -11826,7 +11885,18 @@ function getCurrentTraceId() {
   return (_a = import_api4.trace.getSpan(import_api4.context.active())) == null ? void 0 : _a.spanContext().traceId;
 }
 var tracing = (analytics, apiUrl, writeKey, options, isDebug = false) => {
-  const { logLevel, useExternalOtel, tracingEnabled, disableBatching, bypassOtelForTools, directEndpoint, ...otherOptions } = options;
+  const {
+    logLevel,
+    useExternalOtel,
+    tracingEnabled,
+    disableBatching,
+    bypassOtelForTools,
+    directEndpoint,
+    localDebuggerUrl,
+    cloudEnabled,
+    ...otherOptions
+  } = options;
+  const cloudEnabledResolved = cloudEnabled != null ? cloudEnabled : true;
   if (isDebug) {
     const mode = useExternalOtel ? "(external OTEL mode)" : tracingEnabled === false ? "(tracing disabled)" : "";
     console.log("[raindrop] Initializing tracing", mode);
@@ -11838,7 +11908,9 @@ var tracing = (analytics, apiUrl, writeKey, options, isDebug = false) => {
     writeKey,
     endpoint: directEndpoint != null ? directEndpoint : apiUrl,
     debug: isDebug,
-    enabled: tracingEnabled !== false
+    enabled: tracingEnabled !== false,
+    localDebuggerUrl,
+    cloudEnabled: cloudEnabledResolved
   }) : void 0;
   let traceloopInitialized = false;
   try {
@@ -11867,22 +11939,46 @@ var tracing = (analytics, apiUrl, writeKey, options, isDebug = false) => {
       const localDebuggerProcessor = createLocalDebuggerSpanProcessor({
         writeKey,
         disableBatching,
-        allowedInstrumentationLibraries: traceloop3.ALL_INSTRUMENTATION_LIBRARIES
-      });
-      const processor = mergeWithBestEffortLocalDebuggerProcessor(
-        otherOptions.processor,
-        localDebuggerProcessor
-      );
-      traceloop3.initialize({
-        baseUrl: apiUrl,
-        apiKey: writeKey,
-        ...otherOptions,
-        logLevel,
-        tracingEnabled: tracingEnabled !== false,
-        disableBatch: disableBatching,
-        ...processor ? { processor } : {}
+        allowedInstrumentationLibraries: traceloop3.ALL_INSTRUMENTATION_LIBRARIES,
+        localDebuggerUrlOpt: localDebuggerUrl
       });
-      traceloopInitialized = true;
+      if (!cloudEnabledResolved) {
+        if (localDebuggerProcessor) {
+          traceloop3.initialize({
+            baseUrl: apiUrl,
+            apiKey: writeKey,
+            ...otherOptions,
+            logLevel,
+            tracingEnabled: tracingEnabled !== false,
+            disableBatch: disableBatching,
+            processor: localDebuggerProcessor
+          });
+          traceloopInitialized = true;
+        } else {
+          traceloop3.initialize({
+            baseUrl: apiUrl,
+            apiKey: writeKey,
+            logLevel,
+            tracingEnabled: false
+          });
+          traceloopInitialized = true;
+        }
+      } else {
+        const processor = mergeWithBestEffortLocalDebuggerProcessor(
+          otherOptions.processor,
+          localDebuggerProcessor
+        );
+        traceloop3.initialize({
+          baseUrl: apiUrl,
+          apiKey: writeKey,
+          ...otherOptions,
+          logLevel,
+          tracingEnabled: tracingEnabled !== false,
+          disableBatch: disableBatching,
+          ...processor ? { processor } : {}
+        });
+        traceloopInitialized = true;
+      }
     }
   } catch (error) {
     console.warn(
@@ -11956,6 +12052,24 @@ var tracing = (analytics, apiUrl, writeKey, options, isDebug = false) => {
           }
         };
       }
+      if (!cloudEnabledResolved) {
+        const localOnlyProcessor = createLocalDebuggerSpanProcessor({
+          writeKey,
+          disableBatching,
+          allowedInstrumentationLibraries: processorOptions == null ? void 0 : processorOptions.allowedInstrumentationLibraries,
+          localDebuggerUrlOpt: localDebuggerUrl
+        });
+        return localOnlyProcessor != null ? localOnlyProcessor : {
+          forceFlush: async () => {
+          },
+          onStart: () => {
+          },
+          onEnd: () => {
+          },
+          shutdown: async () => {
+          }
+        };
+      }
       const productionProcessor = traceloop3.createSpanProcessor({
         baseUrl: apiUrl,
         apiKey: writeKey,
@@ -11965,7 +12079,8 @@ var tracing = (analytics, apiUrl, writeKey, options, isDebug = false) => {
       const localDebuggerProcessor = createLocalDebuggerSpanProcessor({
         writeKey,
         disableBatching,
-        allowedInstrumentationLibraries: processorOptions == null ? void 0 : processorOptions.allowedInstrumentationLibraries
+        allowedInstrumentationLibraries: processorOptions == null ? void 0 : processorOptions.allowedInstrumentationLibraries,
+        localDebuggerUrlOpt: localDebuggerUrl
       });
       return mergeWithBestEffortLocalDebuggerProcessor(
         productionProcessor,
@@ -12221,19 +12336,17 @@ var Raindrop = class {
     this.partialEventBuffer = /* @__PURE__ */ new Map();
     this.partialEventTimeouts = /* @__PURE__ */ new Map();
     this.inFlightRequests = /* @__PURE__ */ new Set();
-    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
-    if (!config.writeKey) {
-      throw new Error("A writeKey is required to use Raindrop");
-    }
-    this.writeKey = config.writeKey;
-    this.apiUrl = (_a = this.formatEndpoint(config.endpoint)) != null ? _a : `https://api.raindrop.ai/v1/`;
-    this.bufferSize = (_b = config.bufferSize) != null ? _b : 50;
-    this.bufferTimeout = (_c = config.bufferTimeout) != null ? _c : 1e3;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k;
+    this.writeKey = (_a = config.writeKey) != null ? _a : "";
+    this.localDebuggerUrlOpt = config.localWorkshopUrl === false ? null : config.localWorkshopUrl;
+    this.apiUrl = (_b = this.formatEndpoint(config.endpoint)) != null ? _b : `https://api.raindrop.ai/v1/`;
+    this.bufferSize = (_c = config.bufferSize) != null ? _c : 50;
+    this.bufferTimeout = (_d = config.bufferTimeout) != null ? _d : 1e3;
     this.buffer = new Array();
-    this.disabled = (_d = config.disabled) != null ? _d : false;
-    this.wizardSession = (_e = config.wizardSession) != null ? _e : null;
-    this.debugLogs = (_f = config.debugLogs) != null ? _f : false;
-    this.redactPii = (_g = config.redactPii) != null ? _g : false;
+    this.disabled = (_e = config.disabled) != null ? _e : false;
+    this.wizardSession = (_f = config.wizardSession) != null ? _f : null;
+    this.debugLogs = (_g = config.debugLogs) != null ? _g : false;
+    this.redactPii = (_h = config.redactPii) != null ? _h : false;
     this.context = this.getContext();
     if (this.debugLogs) {
       process.env.RAINDROP_DEBUG = "true";
@@ -12243,10 +12356,10 @@ var Raindrop = class {
         "[raindrop] 'disableTracing' is deprecated and renamed to 'useExternalOtel'. Please update your config: { useExternalOtel: true }"
       );
     }
-    const useExternalOtel = (_i = (_h = config.useExternalOtel) != null ? _h : config.disableTracing) != null ? _i : false;
+    const useExternalOtel = (_j = (_i = config.useExternalOtel) != null ? _i : config.disableTracing) != null ? _j : false;
     const url = new URL(this.apiUrl);
     const isProduction = process.env.NODE_ENV === "production";
-    const disableBatching = (_j = config.disableBatching) != null ? _j : !isProduction;
+    const disableBatching = (_k = config.disableBatching) != null ? _k : !isProduction;
     this._tracing = tracing(
       this,
       url.origin,
@@ -12263,11 +12376,16 @@ var Raindrop = class {
         // Pass full API URL (with /v1/ path) for DirectTraceShipper.
         // url.origin strips the path, which traceloop handles internally,
         // but the direct shipper needs the full path to post to /v1/traces.
-        directEndpoint: this.apiUrl
+        directEndpoint: this.apiUrl,
+        localDebuggerUrl: this.localDebuggerUrlOpt,
+        cloudEnabled: !this.localOnly
       },
       this.debugLogs
     );
   }
+  get localOnly() {
+    return !this.writeKey;
+  }
   formatEndpoint(endpoint) {
     if (endpoint) {
       return endpoint.endsWith("/") ? endpoint : `${endpoint}/`;
@@ -12642,8 +12760,32 @@ var Raindrop = class {
     ];
     return Promise.all(flushPromises);
   }
+  // Symmetric with mirrorPartialEventToLocalDebugger: fan batch posts out to a
+  // resolved Workshop daemon so calls like trackAi() that never go through the
+  // partial-event path still land in the local debugger. Fire-and-forget; cloud
+  // shipping is independent.
+  mirrorBatchToLocalDebugger(endpoint, body) {
+    const localUrl = resolveLocalDebuggerBaseUrl(this.localDebuggerUrlOpt);
+    if (!localUrl) return;
+    const headers = { "Content-Type": "application/json" };
+    if (this.writeKey) headers.Authorization = `Bearer ${this.writeKey}`;
+    try {
+      void fetch(`${localUrl}${endpoint}`, {
+        method: "POST",
+        headers,
+        body: JSON.stringify(body)
+      }).catch(() => {
+      });
+    } catch (e) {
+    }
+  }
   async sendBatchToApi(events, endpoint) {
     var _a;
+    const body = events.map(({ type, ...event }) => event);
+    this.mirrorBatchToLocalDebugger(endpoint, body);
+    if (this.localOnly) {
+      return;
+    }
     const opName = `POST ${endpoint}`;
     try {
       const response = await withRetry3(
@@ -12654,7 +12796,7 @@ var Raindrop = class {
               "Content-Type": "application/json",
               Authorization: `Bearer ${this.writeKey}`
             },
-            body: JSON.stringify(events.map(({ type, ...event }) => event))
+            body: JSON.stringify(body)
           });
           if (!resp.ok) {
             const text = await resp.text().catch(() => "");
@@ -12880,10 +13022,14 @@ var Raindrop = class {
     const endpoint = "events/track_partial";
     const opName = `POST ${endpoint}`;
     mirrorPartialEventToLocalDebugger(event, {
+      baseUrl: this.localDebuggerUrlOpt,
       writeKey: this.writeKey,
       debug: this.debugLogs,
       sdkName: "js-sdk"
     });
+    if (this.localOnly) {
+      return;
+    }
     try {
       const response = await withRetry3(
         async () => {

package/dist/index.mjs

@@ -1,8 +1,9 @@
 import {
   mirrorPartialEventToLocalDebugger,
   package_default,
+  resolveLocalDebuggerBaseUrl,
   tracing
-} from "./chunk-PURTSYKG.mjs";
+} from "./chunk-S6UIW5C4.mjs";
 import {
   __commonJS,
   __toESM
@@ -10125,19 +10126,17 @@ var Raindrop = class {
     this.partialEventBuffer = /* @__PURE__ */ new Map();
     this.partialEventTimeouts = /* @__PURE__ */ new Map();
     this.inFlightRequests = /* @__PURE__ */ new Set();
-    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
-    if (!config.writeKey) {
-      throw new Error("A writeKey is required to use Raindrop");
-    }
-    this.writeKey = config.writeKey;
-    this.apiUrl = (_a = this.formatEndpoint(config.endpoint)) != null ? _a : `https://api.raindrop.ai/v1/`;
-    this.bufferSize = (_b = config.bufferSize) != null ? _b : 50;
-    this.bufferTimeout = (_c = config.bufferTimeout) != null ? _c : 1e3;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k;
+    this.writeKey = (_a = config.writeKey) != null ? _a : "";
+    this.localDebuggerUrlOpt = config.localWorkshopUrl === false ? null : config.localWorkshopUrl;
+    this.apiUrl = (_b = this.formatEndpoint(config.endpoint)) != null ? _b : `https://api.raindrop.ai/v1/`;
+    this.bufferSize = (_c = config.bufferSize) != null ? _c : 50;
+    this.bufferTimeout = (_d = config.bufferTimeout) != null ? _d : 1e3;
     this.buffer = new Array();
-    this.disabled = (_d = config.disabled) != null ? _d : false;
-    this.wizardSession = (_e = config.wizardSession) != null ? _e : null;
-    this.debugLogs = (_f = config.debugLogs) != null ? _f : false;
-    this.redactPii = (_g = config.redactPii) != null ? _g : false;
+    this.disabled = (_e = config.disabled) != null ? _e : false;
+    this.wizardSession = (_f = config.wizardSession) != null ? _f : null;
+    this.debugLogs = (_g = config.debugLogs) != null ? _g : false;
+    this.redactPii = (_h = config.redactPii) != null ? _h : false;
     this.context = this.getContext();
     if (this.debugLogs) {
       process.env.RAINDROP_DEBUG = "true";
@@ -10147,10 +10146,10 @@ var Raindrop = class {
         "[raindrop] 'disableTracing' is deprecated and renamed to 'useExternalOtel'. Please update your config: { useExternalOtel: true }"
       );
     }
-    const useExternalOtel = (_i = (_h = config.useExternalOtel) != null ? _h : config.disableTracing) != null ? _i : false;
+    const useExternalOtel = (_j = (_i = config.useExternalOtel) != null ? _i : config.disableTracing) != null ? _j : false;
     const url = new URL(this.apiUrl);
     const isProduction = process.env.NODE_ENV === "production";
-    const disableBatching = (_j = config.disableBatching) != null ? _j : !isProduction;
+    const disableBatching = (_k = config.disableBatching) != null ? _k : !isProduction;
     this._tracing = tracing(
       this,
       url.origin,
@@ -10167,11 +10166,16 @@ var Raindrop = class {
         // Pass full API URL (with /v1/ path) for DirectTraceShipper.
         // url.origin strips the path, which traceloop handles internally,
         // but the direct shipper needs the full path to post to /v1/traces.
-        directEndpoint: this.apiUrl
+        directEndpoint: this.apiUrl,
+        localDebuggerUrl: this.localDebuggerUrlOpt,
+        cloudEnabled: !this.localOnly
       },
       this.debugLogs
     );
   }
+  get localOnly() {
+    return !this.writeKey;
+  }
   formatEndpoint(endpoint) {
     if (endpoint) {
       return endpoint.endsWith("/") ? endpoint : `${endpoint}/`;
@@ -10546,8 +10550,32 @@ var Raindrop = class {
     ];
     return Promise.all(flushPromises);
   }
+  // Symmetric with mirrorPartialEventToLocalDebugger: fan batch posts out to a
+  // resolved Workshop daemon so calls like trackAi() that never go through the
+  // partial-event path still land in the local debugger. Fire-and-forget; cloud
+  // shipping is independent.
+  mirrorBatchToLocalDebugger(endpoint, body) {
+    const localUrl = resolveLocalDebuggerBaseUrl(this.localDebuggerUrlOpt);
+    if (!localUrl) return;
+    const headers = { "Content-Type": "application/json" };
+    if (this.writeKey) headers.Authorization = `Bearer ${this.writeKey}`;
+    try {
+      void fetch(`${localUrl}${endpoint}`, {
+        method: "POST",
+        headers,
+        body: JSON.stringify(body)
+      }).catch(() => {
+      });
+    } catch (e) {
+    }
+  }
   async sendBatchToApi(events, endpoint) {
     var _a;
+    const body = events.map(({ type, ...event }) => event);
+    this.mirrorBatchToLocalDebugger(endpoint, body);
+    if (this.localOnly) {
+      return;
+    }
     const opName = `POST ${endpoint}`;
     try {
       const response = await withRetry(
@@ -10558,7 +10586,7 @@ var Raindrop = class {
               "Content-Type": "application/json",
               Authorization: `Bearer ${this.writeKey}`
             },
-            body: JSON.stringify(events.map(({ type, ...event }) => event))
+            body: JSON.stringify(body)
           });
           if (!resp.ok) {
             const text = await resp.text().catch(() => "");
@@ -10784,10 +10812,14 @@ var Raindrop = class {
     const endpoint = "events/track_partial";
     const opName = `POST ${endpoint}`;
     mirrorPartialEventToLocalDebugger(event, {
+      baseUrl: this.localDebuggerUrlOpt,
       writeKey: this.writeKey,
       debug: this.debugLogs,
       sdkName: "js-sdk"
     });
+    if (this.localOnly) {
+      return;
+    }
     try {
       const response = await withRetry(
         async () => {

package/dist/tracing/index.d.mts

@@ -32,6 +32,18 @@ interface TracingOptions extends traceloop.InitializeOptions {
      * the full base URL including the /v1/ path segment.
      */
     directEndpoint?: string;
+    /**
+     * The user-facing `localWorkshopUrl` ctor option, normalized so `false` is
+     * pre-converted to `null`. Threaded through to local-debugger mirror paths
+     * to override env-var resolution.
+     */
+    localDebuggerUrl?: string | null;
+    /**
+     * False when the parent SDK has no writeKey — disables cloud span shipping
+     * (no traceloop NodeSDK pointed at production, no DirectTraceShipper cloud POSTs).
+     * The local-debugger mirror still fires when a Workshop URL is resolved.
+     */
+    cloudEnabled?: boolean;
 }
 declare const tracing: (analytics: Raindrop, apiUrl: string, writeKey: string, options: TracingOptions, isDebug?: boolean) => {
     /**

package/dist/tracing/index.d.ts

@@ -32,6 +32,18 @@ interface TracingOptions extends traceloop.InitializeOptions {
      * the full base URL including the /v1/ path segment.
      */
     directEndpoint?: string;
+    /**
+     * The user-facing `localWorkshopUrl` ctor option, normalized so `false` is
+     * pre-converted to `null`. Threaded through to local-debugger mirror paths
+     * to override env-var resolution.
+     */
+    localDebuggerUrl?: string | null;
+    /**
+     * False when the parent SDK has no writeKey — disables cloud span shipping
+     * (no traceloop NodeSDK pointed at production, no DirectTraceShipper cloud POSTs).
+     * The local-debugger mirror still fires when a Workshop URL is resolved.
+     */
+    cloudEnabled?: boolean;
 }
 declare const tracing: (analytics: Raindrop, apiUrl: string, writeKey: string, options: TracingOptions, isDebug?: boolean) => {
     /**

package/dist/tracing/index.js

@@ -50,7 +50,7 @@ var import_instrumentation_vertexai = require("@traceloop/instrumentation-vertex
 var traceloop3 = __toESM(require("@traceloop/node-server-sdk"));
 var import_weakref = require("weakref");
 
-// ../core/dist/chunk-Y7SM66SW.js
+// ../core/dist/chunk-LMIWKHOH.js
 function wait(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
@@ -141,10 +141,66 @@ async function postJson(url, body, headers, opts) {
   );
 }
 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(hostname) {
+  if (!hostname) return false;
+  if (hostname === "localhost" || hostname === "127.0.0.1" || hostname === "0.0.0.0" || hostname === "::1") {
+    return true;
+  }
+  if (hostname.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;
-  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;
+  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 localDebuggerEnabled(baseUrl) {
   return resolveLocalDebuggerBaseUrl(baseUrl) !== null;
@@ -336,7 +392,7 @@ function base64ToHex(base64) {
 // package.json
 var package_default = {
   name: "raindrop-ai",
-  version: "0.0.92",
+  version: "0.1.0",
   main: "dist/index.js",
   module: "dist/index.mjs",
   types: "dist/index.d.ts",
@@ -532,19 +588,18 @@ var DirectTraceShipper = class {
   constructor(opts) {
     this.queue = [];
     this.inFlight = /* @__PURE__ */ new Set();
-    var _a, _b, _c, _d, _e;
+    var _a, _b, _c, _d, _e, _f;
     this.writeKey = opts.writeKey;
     this.baseUrl = (_a = formatEndpoint2(opts.endpoint)) != null ? _a : "https://api.raindrop.ai/v1/";
     this.enabled = (_b = opts.enabled) != null ? _b : true;
+    this.cloudEnabled = (_c = opts.cloudEnabled) != null ? _c : true;
     this.debug = opts.debug;
-    this.flushIntervalMs = (_c = opts.flushIntervalMs) != null ? _c : 1e3;
-    this.maxBatchSize = (_d = opts.maxBatchSize) != null ? _d : 50;
-    this.maxQueueSize = (_e = opts.maxQueueSize) != null ? _e : 5e3;
-    if (localDebuggerEnabled()) {
-      const resolved = resolveLocalDebuggerBaseUrl();
-      if (resolved && resolved !== this.baseUrl) {
-        this.localDebuggerUrl = resolved;
-      }
+    this.flushIntervalMs = (_d = opts.flushIntervalMs) != null ? _d : 1e3;
+    this.maxBatchSize = (_e = opts.maxBatchSize) != null ? _e : 50;
+    this.maxQueueSize = (_f = opts.maxQueueSize) != null ? _f : 5e3;
+    const resolved = resolveLocalDebuggerBaseUrl(opts.localDebuggerUrl);
+    if (resolved && resolved !== this.baseUrl) {
+      this.localDebuggerUrl = resolved;
     }
   }
   /**
@@ -653,6 +708,10 @@ var DirectTraceShipper = class {
     }
     while (this.queue.length > 0) {
       const batch = this.queue.splice(0, this.maxBatchSize);
+      if (!this.cloudEnabled) {
+        if (this.debug) console.log(`[raindrop] direct: dropped ${batch.length} cloud spans (local-only)`);
+        continue;
+      }
       const body = buildExportTraceServiceRequest2(batch);
       const url = `${this.baseUrl}traces`;
       const p = postJson2(
@@ -1583,8 +1642,8 @@ function isLocalDebuggerUrl(baseUrl) {
     return false;
   }
 }
-function resolveLocalDebuggerExporterBaseUrl() {
-  const localDebuggerUrl = resolveLocalDebuggerBaseUrl();
+function resolveLocalDebuggerExporterBaseUrl(baseUrlOpt) {
+  const localDebuggerUrl = resolveLocalDebuggerBaseUrl(baseUrlOpt);
   if (!localDebuggerUrl || !isLocalDebuggerUrl(localDebuggerUrl)) {
     return null;
   }
@@ -1594,7 +1653,7 @@ function createLocalDebuggerOtlpExporter(config) {
   return new import_exporter_trace_otlp_http.OTLPTraceExporter(config);
 }
 function createLocalDebuggerSpanProcessor(options) {
-  const localDebuggerUrl = resolveLocalDebuggerExporterBaseUrl();
+  const localDebuggerUrl = resolveLocalDebuggerExporterBaseUrl(options.localDebuggerUrlOpt);
   if (!localDebuggerUrl) {
     return void 0;
   }
@@ -1884,7 +1943,18 @@ function getCurrentTraceId() {
   return (_a = import_api4.trace.getSpan(import_api4.context.active())) == null ? void 0 : _a.spanContext().traceId;
 }
 var tracing = (analytics, apiUrl, writeKey, options, isDebug = false) => {
-  const { logLevel, useExternalOtel, tracingEnabled, disableBatching, bypassOtelForTools, directEndpoint, ...otherOptions } = options;
+  const {
+    logLevel,
+    useExternalOtel,
+    tracingEnabled,
+    disableBatching,
+    bypassOtelForTools,
+    directEndpoint,
+    localDebuggerUrl,
+    cloudEnabled,
+    ...otherOptions
+  } = options;
+  const cloudEnabledResolved = cloudEnabled != null ? cloudEnabled : true;
   if (isDebug) {
     const mode = useExternalOtel ? "(external OTEL mode)" : tracingEnabled === false ? "(tracing disabled)" : "";
     console.log("[raindrop] Initializing tracing", mode);
@@ -1896,7 +1966,9 @@ var tracing = (analytics, apiUrl, writeKey, options, isDebug = false) => {
     writeKey,
     endpoint: directEndpoint != null ? directEndpoint : apiUrl,
     debug: isDebug,
-    enabled: tracingEnabled !== false
+    enabled: tracingEnabled !== false,
+    localDebuggerUrl,
+    cloudEnabled: cloudEnabledResolved
   }) : void 0;
   let traceloopInitialized = false;
   try {
@@ -1925,22 +1997,46 @@ var tracing = (analytics, apiUrl, writeKey, options, isDebug = false) => {
       const localDebuggerProcessor = createLocalDebuggerSpanProcessor({
         writeKey,
         disableBatching,
-        allowedInstrumentationLibraries: traceloop3.ALL_INSTRUMENTATION_LIBRARIES
+        allowedInstrumentationLibraries: traceloop3.ALL_INSTRUMENTATION_LIBRARIES,
+        localDebuggerUrlOpt: localDebuggerUrl
       });
-      const processor = mergeWithBestEffortLocalDebuggerProcessor(
-        otherOptions.processor,
-        localDebuggerProcessor
-      );
-      traceloop3.initialize({
-        baseUrl: apiUrl,
-        apiKey: writeKey,
-        ...otherOptions,
-        logLevel,
-        tracingEnabled: tracingEnabled !== false,
-        disableBatch: disableBatching,
-        ...processor ? { processor } : {}
-      });
-      traceloopInitialized = true;
+      if (!cloudEnabledResolved) {
+        if (localDebuggerProcessor) {
+          traceloop3.initialize({
+            baseUrl: apiUrl,
+            apiKey: writeKey,
+            ...otherOptions,
+            logLevel,
+            tracingEnabled: tracingEnabled !== false,
+            disableBatch: disableBatching,
+            processor: localDebuggerProcessor
+          });
+          traceloopInitialized = true;
+        } else {
+          traceloop3.initialize({
+            baseUrl: apiUrl,
+            apiKey: writeKey,
+            logLevel,
+            tracingEnabled: false
+          });
+          traceloopInitialized = true;
+        }
+      } else {
+        const processor = mergeWithBestEffortLocalDebuggerProcessor(
+          otherOptions.processor,
+          localDebuggerProcessor
+        );
+        traceloop3.initialize({
+          baseUrl: apiUrl,
+          apiKey: writeKey,
+          ...otherOptions,
+          logLevel,
+          tracingEnabled: tracingEnabled !== false,
+          disableBatch: disableBatching,
+          ...processor ? { processor } : {}
+        });
+        traceloopInitialized = true;
+      }
     }
   } catch (error) {
     console.warn(
@@ -2014,6 +2110,24 @@ var tracing = (analytics, apiUrl, writeKey, options, isDebug = false) => {
           }
         };
       }
+      if (!cloudEnabledResolved) {
+        const localOnlyProcessor = createLocalDebuggerSpanProcessor({
+          writeKey,
+          disableBatching,
+          allowedInstrumentationLibraries: processorOptions == null ? void 0 : processorOptions.allowedInstrumentationLibraries,
+          localDebuggerUrlOpt: localDebuggerUrl
+        });
+        return localOnlyProcessor != null ? localOnlyProcessor : {
+          forceFlush: async () => {
+          },
+          onStart: () => {
+          },
+          onEnd: () => {
+          },
+          shutdown: async () => {
+          }
+        };
+      }
       const productionProcessor = traceloop3.createSpanProcessor({
         baseUrl: apiUrl,
         apiKey: writeKey,
@@ -2023,7 +2137,8 @@ var tracing = (analytics, apiUrl, writeKey, options, isDebug = false) => {
       const localDebuggerProcessor = createLocalDebuggerSpanProcessor({
         writeKey,
         disableBatching,
-        allowedInstrumentationLibraries: processorOptions == null ? void 0 : processorOptions.allowedInstrumentationLibraries
+        allowedInstrumentationLibraries: processorOptions == null ? void 0 : processorOptions.allowedInstrumentationLibraries,
+        localDebuggerUrlOpt: localDebuggerUrl
       });
       return mergeWithBestEffortLocalDebuggerProcessor(
         productionProcessor,

package/dist/tracing/index.mjs

@@ -1,6 +1,6 @@
 import {
   tracing
-} from "../chunk-PURTSYKG.mjs";
+} from "../chunk-S6UIW5C4.mjs";
 import "../chunk-UJCSKKID.mjs";
 
 // src/tracing/index.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "raindrop-ai",
-  "version": "0.0.92",
+  "version": "0.1.0",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",