@raindrop-ai/deep-agents 0.0.1

package/dist/index.mjs

@@ -0,0 +1,1217 @@
+// src/callback-handler.ts
+import { BaseCallbackHandler } from "@langchain/core/callbacks/base";
+
+// ../core/dist/chunk-4UCYIEH4.js
+function getCrypto() {
+  const c = globalThis.crypto;
+  return c;
+}
+function randomBytes(length) {
+  const cryptoObj = getCrypto();
+  const out = new Uint8Array(length);
+  if (cryptoObj && typeof cryptoObj.getRandomValues === "function") {
+    cryptoObj.getRandomValues(out);
+    return out;
+  }
+  for (let i = 0; i < out.length; i++) out[i] = Math.floor(Math.random() * 256);
+  return out;
+}
+function randomUUID() {
+  const cryptoObj = getCrypto();
+  if (cryptoObj && typeof cryptoObj.randomUUID === "function") {
+    return cryptoObj.randomUUID();
+  }
+  const b = randomBytes(16);
+  b[6] = b[6] & 15 | 64;
+  b[8] = b[8] & 63 | 128;
+  const hex = [...b].map((x) => x.toString(16).padStart(2, "0")).join("");
+  return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+}
+function base64Encode(bytes) {
+  const maybeBuffer = globalThis.Buffer;
+  if (maybeBuffer) {
+    return maybeBuffer.from(bytes).toString("base64");
+  }
+  let binary = "";
+  for (let i2 = 0; i2 < bytes.length; i2++) {
+    binary += String.fromCharCode(bytes[i2]);
+  }
+  const btoaFn = globalThis.btoa;
+  if (typeof btoaFn === "function") return btoaFn(binary);
+  const alphabet = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+  let out = "";
+  let i = 0;
+  while (i < binary.length) {
+    const c1 = binary.charCodeAt(i++) & 255;
+    const c2 = i < binary.length ? binary.charCodeAt(i++) & 255 : NaN;
+    const c3 = i < binary.length ? binary.charCodeAt(i++) & 255 : NaN;
+    const e1 = c1 >> 2;
+    const e2 = (c1 & 3) << 4 | (Number.isNaN(c2) ? 0 : c2 >> 4);
+    const e3 = Number.isNaN(c2) ? 64 : (c2 & 15) << 2 | (Number.isNaN(c3) ? 0 : c3 >> 6);
+    const e4 = Number.isNaN(c3) ? 64 : c3 & 63;
+    out += alphabet.charAt(e1);
+    out += alphabet.charAt(e2);
+    out += e3 === 64 ? "=" : alphabet.charAt(e3);
+    out += e4 === 64 ? "=" : alphabet.charAt(e4);
+  }
+  return out;
+}
+function wait(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function formatEndpoint(endpoint) {
+  if (!endpoint) return void 0;
+  return endpoint.endsWith("/") ? endpoint : `${endpoint}/`;
+}
+function parseRetryAfter(headers) {
+  var _a;
+  const value = (_a = headers.get("Retry-After")) != null ? _a : headers.get("retry-after");
+  if (!value) return void 0;
+  const asNumber2 = Number(value);
+  if (value.trim() !== "" && !Number.isNaN(asNumber2)) return asNumber2 * 1e3;
+  const asDate = new Date(value).getTime();
+  if (!Number.isNaN(asDate)) {
+    const delta = asDate - Date.now();
+    return delta > 0 ? delta : 0;
+  }
+  return void 0;
+}
+function getRetryDelayMs(attemptNumber, previousError) {
+  if (previousError && typeof previousError === "object" && previousError !== null && "retryAfterMs" in previousError) {
+    const v = previousError.retryAfterMs;
+    if (typeof v === "number") return Math.max(0, v);
+  }
+  if (attemptNumber <= 1) return 0;
+  const base = 500;
+  const factor = Math.pow(2, attemptNumber - 2);
+  return base * factor;
+}
+async function withRetry(operation, opName, opts) {
+  const prefix = opts.sdkName ? `[raindrop-ai/${opts.sdkName}]` : "[raindrop-ai/core]";
+  let lastError = void 0;
+  for (let attemptNumber = 1; attemptNumber <= opts.maxAttempts; attemptNumber++) {
+    if (attemptNumber > 1) {
+      const delay = getRetryDelayMs(attemptNumber, lastError);
+      if (opts.debug) {
+        console.warn(
+          `${prefix} ${opName} retry ${attemptNumber}/${opts.maxAttempts} in ${delay}ms`
+        );
+      }
+      if (delay > 0) await wait(delay);
+    } else if (opts.debug) {
+      console.log(`${prefix} ${opName} attempt ${attemptNumber}/${opts.maxAttempts}`);
+    }
+    try {
+      return await operation();
+    } catch (err) {
+      lastError = err;
+      if (opts.debug) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.warn(
+          `${prefix} ${opName} attempt ${attemptNumber} failed: ${msg}${attemptNumber === opts.maxAttempts ? " (no more retries)" : ""}`
+        );
+      }
+      if (lastError && typeof lastError === "object" && "retryable" in lastError && !lastError.retryable)
+        break;
+      if (attemptNumber === opts.maxAttempts) break;
+    }
+  }
+  throw lastError instanceof Error ? lastError : new Error(String(lastError));
+}
+async function postJson(url, body, headers, opts) {
+  const opName = `POST ${url}`;
+  await withRetry(
+    async () => {
+      const resp = await fetch(url, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          ...headers
+        },
+        body: JSON.stringify(body)
+      });
+      if (!resp.ok) {
+        const text = await resp.text().catch(() => "");
+        const err = new Error(
+          `HTTP ${resp.status} ${resp.statusText}${text ? `: ${text}` : ""}`
+        );
+        const retryAfterMs = parseRetryAfter(resp.headers);
+        if (typeof retryAfterMs === "number") err.retryAfterMs = retryAfterMs;
+        err.retryable = resp.status === 429 || resp.status >= 500;
+        throw err;
+      }
+    },
+    opName,
+    opts
+  );
+}
+var SpanStatusCode = {
+  UNSET: 0,
+  OK: 1,
+  ERROR: 2
+};
+function createSpanIds(parent) {
+  const traceId = parent ? parent.traceIdB64 : base64Encode(randomBytes(16));
+  const spanId = base64Encode(randomBytes(8));
+  return {
+    traceIdB64: traceId,
+    spanIdB64: spanId,
+    parentSpanIdB64: parent ? parent.spanIdB64 : void 0
+  };
+}
+function nowUnixNanoString() {
+  return Date.now().toString() + "000000";
+}
+function attrString(key, value) {
+  if (value === void 0) return void 0;
+  return { key, value: { stringValue: value } };
+}
+function attrInt(key, value) {
+  if (value === void 0) return void 0;
+  if (!Number.isFinite(value)) return void 0;
+  return { key, value: { intValue: String(Math.trunc(value)) } };
+}
+function buildOtlpSpan(args) {
+  const attrs = args.attributes.filter((x) => x !== void 0);
+  const span = {
+    traceId: args.ids.traceIdB64,
+    spanId: args.ids.spanIdB64,
+    name: args.name,
+    startTimeUnixNano: args.startTimeUnixNano,
+    endTimeUnixNano: args.endTimeUnixNano
+  };
+  if (args.ids.parentSpanIdB64) span.parentSpanId = args.ids.parentSpanIdB64;
+  if (attrs.length) span.attributes = attrs;
+  if (args.status) span.status = args.status;
+  return span;
+}
+function buildExportTraceServiceRequest(spans, serviceName = "raindrop.core", serviceVersion = "0.0.0") {
+  return {
+    resourceSpans: [
+      {
+        resource: {
+          attributes: [{ key: "service.name", value: { stringValue: serviceName } }]
+        },
+        scopeSpans: [
+          {
+            scope: { name: serviceName, version: serviceVersion },
+            spans
+          }
+        ]
+      }
+    ]
+  };
+}
+function mergePatches(target, source) {
+  var _a, _b, _c, _d;
+  const out = { ...target, ...source };
+  if (target.properties || source.properties) {
+    out.properties = { ...(_a = target.properties) != null ? _a : {}, ...(_b = source.properties) != null ? _b : {} };
+  }
+  if (target.attachments || source.attachments) {
+    out.attachments = [...(_c = target.attachments) != null ? _c : [], ...(_d = source.attachments) != null ? _d : []];
+  }
+  return out;
+}
+var EventShipper = class {
+  constructor(opts) {
+    this.buffers = /* @__PURE__ */ new Map();
+    this.sticky = /* @__PURE__ */ new Map();
+    this.timers = /* @__PURE__ */ new Map();
+    this.inFlight = /* @__PURE__ */ new Set();
+    var _a, _b, _c, _d, _e, _f, _g;
+    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;
+    this.debug = opts.debug;
+    this.partialFlushMs = (_c = opts.partialFlushMs) != null ? _c : 1e3;
+    this.sdkName = (_d = opts.sdkName) != null ? _d : "core";
+    this.prefix = `[raindrop-ai/${this.sdkName}]`;
+    this.defaultEventName = (_e = opts.defaultEventName) != null ? _e : "ai_generation";
+    const isNode = typeof process !== "undefined" && typeof process.version === "string";
+    this.context = {
+      library: {
+        name: (_f = opts.libraryName) != null ? _f : "@raindrop-ai/core",
+        version: (_g = opts.libraryVersion) != null ? _g : "0.0.0"
+      },
+      metadata: {
+        jsRuntime: isNode ? "node" : "web",
+        ...isNode ? { nodeVersion: process.version } : {}
+      }
+    };
+  }
+  isDebugEnabled() {
+    return this.debug;
+  }
+  authHeaders() {
+    return this.writeKey ? { Authorization: `Bearer ${this.writeKey}` } : {};
+  }
+  async patch(eventId, patch) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k;
+    if (!this.enabled) return;
+    if (!eventId || !eventId.trim()) return;
+    if (this.debug) {
+      console.log(`${this.prefix} queue patch`, {
+        eventId,
+        userId: patch.userId,
+        convoId: patch.convoId,
+        eventName: patch.eventName,
+        hasInput: typeof patch.input === "string" && patch.input.length > 0,
+        hasOutput: typeof patch.output === "string" && patch.output.length > 0,
+        attachments: (_b = (_a = patch.attachments) == null ? void 0 : _a.length) != null ? _b : 0,
+        isPending: patch.isPending
+      });
+    }
+    const sticky = (_c = this.sticky.get(eventId)) != null ? _c : {};
+    const existing = (_d = this.buffers.get(eventId)) != null ? _d : {};
+    const merged = mergePatches(existing, patch);
+    merged.isPending = (_g = (_f = (_e = patch.isPending) != null ? _e : existing.isPending) != null ? _f : sticky.isPending) != null ? _g : true;
+    this.buffers.set(eventId, merged);
+    this.sticky.set(eventId, {
+      userId: (_h = merged.userId) != null ? _h : sticky.userId,
+      convoId: (_i = merged.convoId) != null ? _i : sticky.convoId,
+      eventName: (_j = merged.eventName) != null ? _j : sticky.eventName,
+      isPending: (_k = merged.isPending) != null ? _k : sticky.isPending
+    });
+    const t = this.timers.get(eventId);
+    if (t) clearTimeout(t);
+    if (merged.isPending === false) {
+      await this.flushOne(eventId);
+      return;
+    }
+    const timeout = setTimeout(() => {
+      void this.flushOne(eventId).catch(() => {
+      });
+    }, this.partialFlushMs);
+    this.timers.set(eventId, timeout);
+  }
+  async finish(eventId, patch) {
+    await this.patch(eventId, { ...patch, isPending: false });
+  }
+  async flush() {
+    if (!this.enabled) return;
+    const ids = [...this.buffers.keys()];
+    await Promise.all(ids.map((id) => this.flushOne(id)));
+    await Promise.all([...this.inFlight].map((p) => p.catch(() => {
+    })));
+  }
+  async shutdown() {
+    for (const t of this.timers.values()) clearTimeout(t);
+    this.timers.clear();
+    await this.flush();
+  }
+  async trackSignal(signal) {
+    var _a, _b;
+    if (!this.enabled) return;
+    const body = [
+      {
+        event_id: signal.eventId,
+        signal_name: signal.name,
+        signal_type: (_a = signal.type) != null ? _a : "default",
+        timestamp: signal.timestamp,
+        sentiment: signal.sentiment,
+        attachment_id: signal.attachmentId,
+        properties: {
+          ...(_b = signal.properties) != null ? _b : {},
+          ...signal.comment ? { comment: signal.comment } : {},
+          ...signal.after ? { after: signal.after } : {}
+        }
+      }
+    ];
+    const url = `${this.baseUrl}signals/track`;
+    try {
+      await postJson(url, body, this.authHeaders(), {
+        maxAttempts: 3,
+        debug: this.debug,
+        sdkName: this.sdkName
+      });
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      console.warn(`${this.prefix} failed to send signal (dropping): ${msg}`);
+    }
+  }
+  async identify(users) {
+    if (!this.enabled) return;
+    const list = Array.isArray(users) ? users : [users];
+    const body = list.filter((user) => {
+      if (!(user == null ? void 0 : user.userId) || !user.userId.trim()) {
+        if (this.debug) {
+          console.warn(`${this.prefix} skipping identify: missing userId`);
+        }
+        return false;
+      }
+      return true;
+    }).map((user) => {
+      var _a;
+      return {
+        user_id: user.userId,
+        traits: (_a = user.traits) != null ? _a : {}
+      };
+    });
+    if (body.length === 0) return;
+    const url = `${this.baseUrl}users/identify`;
+    try {
+      await postJson(url, body, this.authHeaders(), {
+        maxAttempts: 3,
+        debug: this.debug,
+        sdkName: this.sdkName
+      });
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      console.warn(`${this.prefix} failed to send identify (dropping): ${msg}`);
+    }
+  }
+  async flushOne(eventId) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m;
+    if (!this.enabled) return;
+    const timer = this.timers.get(eventId);
+    if (timer) {
+      clearTimeout(timer);
+      this.timers.delete(eventId);
+    }
+    const accumulated = this.buffers.get(eventId);
+    this.buffers.delete(eventId);
+    if (!accumulated) return;
+    const sticky = (_a = this.sticky.get(eventId)) != null ? _a : {};
+    const eventName = (_c = (_b = accumulated.eventName) != null ? _b : sticky.eventName) != null ? _c : this.defaultEventName;
+    const userId = (_d = accumulated.userId) != null ? _d : sticky.userId;
+    if (!userId) {
+      if (this.debug) {
+        console.warn(`${this.prefix} skipping track_partial for ${eventId}: missing userId`);
+      }
+      this.sticky.delete(eventId);
+      return;
+    }
+    const { wizardSession, ...restProperties } = (_e = accumulated.properties) != null ? _e : {};
+    const convoId = (_f = accumulated.convoId) != null ? _f : sticky.convoId;
+    const isPending = (_h = (_g = accumulated.isPending) != null ? _g : sticky.isPending) != null ? _h : true;
+    const payload = {
+      event_id: eventId,
+      user_id: userId,
+      event: eventName,
+      timestamp: (_i = accumulated.timestamp) != null ? _i : (/* @__PURE__ */ new Date()).toISOString(),
+      ai_data: {
+        input: accumulated.input,
+        output: accumulated.output,
+        model: accumulated.model,
+        convo_id: convoId
+      },
+      properties: {
+        ...restProperties,
+        ...wizardSession ? { "raindrop.wizardSession": wizardSession } : {},
+        $context: this.context
+      },
+      attachments: accumulated.attachments,
+      is_pending: isPending
+    };
+    const url = `${this.baseUrl}events/track_partial`;
+    if (this.debug) {
+      console.log(`${this.prefix} sending track_partial`, {
+        eventId,
+        eventName,
+        userId,
+        convoId,
+        isPending,
+        inputPreview: typeof accumulated.input === "string" ? accumulated.input.slice(0, 120) : void 0,
+        outputPreview: typeof accumulated.output === "string" ? accumulated.output.slice(0, 120) : void 0,
+        attachments: (_k = (_j = accumulated.attachments) == null ? void 0 : _j.length) != null ? _k : 0,
+        attachmentKinds: (_m = (_l = accumulated.attachments) == null ? void 0 : _l.map((a) => ({
+          type: a.type,
+          role: a.role,
+          name: a.name,
+          valuePreview: a.value.slice(0, 60)
+        }))) != null ? _m : [],
+        endpoint: url
+      });
+    }
+    const p = postJson(url, payload, this.authHeaders(), {
+      maxAttempts: 3,
+      debug: this.debug,
+      sdkName: this.sdkName
+    });
+    this.inFlight.add(p);
+    try {
+      try {
+        await p;
+        if (this.debug) {
+          console.log(`${this.prefix} sent track_partial ${eventId} (${eventName})`);
+        }
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.warn(`${this.prefix} failed to send track_partial (dropping): ${msg}`);
+      }
+    } finally {
+      this.inFlight.delete(p);
+    }
+    if (!isPending) {
+      this.sticky.delete(eventId);
+    }
+  }
+};
+var LOCAL_DEBUGGER_ENV_VAR = "RAINDROP_LOCAL_DEBUGGER";
+function resolveLocalDebuggerBaseUrl(baseUrl) {
+  var _a, _b, _c;
+  const resolved = (_b = baseUrl != null ? baseUrl : typeof process !== "undefined" ? (_a = process.env) == null ? void 0 : _a[LOCAL_DEBUGGER_ENV_VAR] : void 0) != null ? _b : null;
+  return resolved ? (_c = formatEndpoint(resolved)) != null ? _c : null : null;
+}
+function mirrorTraceExportToLocalDebugger(body, options = {}) {
+  var _a;
+  const baseUrl = resolveLocalDebuggerBaseUrl(options.baseUrl);
+  if (!baseUrl) return;
+  void postJson(`${baseUrl}traces`, body, {}, {
+    maxAttempts: 1,
+    debug: (_a = options.debug) != null ? _a : false,
+    sdkName: options.sdkName
+  }).catch(() => {
+  });
+}
+var TraceShipper = class {
+  constructor(opts) {
+    this.queue = [];
+    this.inFlight = /* @__PURE__ */ new Set();
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
+    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;
+    this.debug = opts.debug;
+    this.debugSpans = opts.debugSpans === true;
+    this.flushIntervalMs = (_c = opts.flushIntervalMs) != null ? _c : 1e3;
+    this.maxBatchSize = (_d = opts.maxBatchSize) != null ? _d : 50;
+    this.maxQueueSize = (_e = opts.maxQueueSize) != null ? _e : 5e3;
+    this.sdkName = (_f = opts.sdkName) != null ? _f : "core";
+    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;
+  }
+  authHeaders() {
+    return this.writeKey ? { Authorization: `Bearer ${this.writeKey}` } : {};
+  }
+  startSpan(args) {
+    var _a, _b;
+    const ids = createSpanIds(args.parent);
+    const started = (_a = args.startTimeUnixNano) != null ? _a : nowUnixNanoString();
+    const attrs = [
+      attrString("ai.telemetry.metadata.raindrop.eventId", args.eventId),
+      attrString("ai.operationId", args.operationId)
+    ];
+    if ((_b = args.attributes) == null ? void 0 : _b.length) attrs.push(...args.attributes);
+    const span = { ids, name: args.name, startTimeUnixNano: started, attributes: attrs };
+    if (this.localDebuggerUrl) {
+      const openSpan = buildOtlpSpan({
+        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;
+    if (span.endTimeUnixNano) return;
+    span.endTimeUnixNano = (_a = extra == null ? void 0 : extra.endTimeUnixNano) != null ? _a : nowUnixNanoString();
+    if ((_b = extra == null ? void 0 : extra.attributes) == null ? void 0 : _b.length) {
+      span.attributes.push(...extra.attributes);
+    }
+    let status = extra == null ? void 0 : extra.status;
+    if (!status && (extra == null ? void 0 : extra.error) !== void 0) {
+      const message = extra.error instanceof Error ? extra.error.message : String(extra.error);
+      status = { code: SpanStatusCode.ERROR, message };
+    }
+    const otlp = buildOtlpSpan({
+      ids: span.ids,
+      name: span.name,
+      startTimeUnixNano: span.startTimeUnixNano,
+      endTimeUnixNano: span.endTimeUnixNano,
+      attributes: span.attributes,
+      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;
+    const ids = createSpanIds(args.parent);
+    const attrs = [
+      attrString("ai.telemetry.metadata.raindrop.eventId", args.eventId)
+    ];
+    if ((_a = args.attributes) == null ? void 0 : _a.length) attrs.push(...args.attributes);
+    const otlp = buildOtlpSpan({
+      ids,
+      name: args.name,
+      startTimeUnixNano: args.startTimeUnixNano,
+      endTimeUnixNano: args.endTimeUnixNano,
+      attributes: attrs,
+      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;
+    if (this.debugSpans) {
+      const short = (s) => s ? s.slice(-8) : "none";
+      console.log(
+        `${this.prefix}[span] name=${span.name} trace=${short(span.traceId)} span=${short(span.spanId)} parent=${short(
+          span.parentSpanId
+        )}`
+      );
+    }
+    if (this.queue.length >= this.maxQueueSize) {
+      this.queue.shift();
+    }
+    this.queue.push(span);
+    if (this.queue.length >= this.maxBatchSize) {
+      void this.flush().catch(() => {
+      });
+      return;
+    }
+    if (!this.timer) {
+      this.timer = setTimeout(() => {
+        this.timer = void 0;
+        void this.flush().catch(() => {
+        });
+      }, this.flushIntervalMs);
+    }
+  }
+  async flush() {
+    if (!this.enabled) return;
+    if (this.timer) {
+      clearTimeout(this.timer);
+      this.timer = void 0;
+    }
+    while (this.queue.length > 0) {
+      const batch = this.queue.splice(0, this.maxBatchSize);
+      const body = buildExportTraceServiceRequest(batch, this.serviceName, this.serviceVersion);
+      const url = `${this.baseUrl}traces`;
+      if (this.debug) {
+        console.log(`${this.prefix} sending traces batch`, {
+          spans: batch.length,
+          endpoint: url
+        });
+      }
+      const p = postJson(url, body, this.authHeaders(), {
+        maxAttempts: 3,
+        debug: this.debug,
+        sdkName: this.sdkName
+      });
+      this.inFlight.add(p);
+      try {
+        try {
+          await p;
+          if (this.debug) console.log(`${this.prefix} sent ${batch.length} spans`);
+        } catch (err) {
+          const msg = err instanceof Error ? err.message : String(err);
+          console.warn(`${this.prefix} failed to send ${batch.length} spans: ${msg}`);
+        }
+      } finally {
+        this.inFlight.delete(p);
+      }
+    }
+  }
+  async shutdown() {
+    if (this.timer) {
+      clearTimeout(this.timer);
+      this.timer = void 0;
+    }
+    await this.flush();
+    await Promise.all([...this.inFlight].map((p) => p.catch(() => {
+    })));
+  }
+};
+
+// ../core/dist/index.node.js
+import { AsyncLocalStorage } from "async_hooks";
+globalThis.RAINDROP_ASYNC_LOCAL_STORAGE = AsyncLocalStorage;
+
+// src/callback-handler.ts
+function isInternalName(name) {
+  if (name.startsWith("Branch:")) return true;
+  if (name.startsWith("ChannelWrite")) return true;
+  if (name.startsWith("ChannelRead")) return true;
+  if (name.startsWith("__") && name.endsWith("__")) return true;
+  return false;
+}
+var CHAIN_TEXT_MAX_LEN = 8192;
+function extractTextFromContent(content) {
+  if (content == null) return void 0;
+  if (typeof content === "string") return content;
+  if (Array.isArray(content)) {
+    const parts = [];
+    for (const part of content) {
+      if (typeof part === "string") {
+        parts.push(part);
+      } else if (part && typeof part === "object") {
+        const p = part;
+        if (typeof p.text === "string") {
+          parts.push(p.text);
+        } else if (p.type === "text" && typeof p.content === "string") {
+          parts.push(p.content);
+        }
+      }
+    }
+    if (parts.length > 0) return parts.join("\n");
+    return safeStringify(content);
+  }
+  if (typeof content === "object") {
+    const c = content;
+    if (typeof c.text === "string") return c.text;
+    if (typeof c.content === "string") return c.content;
+    return safeStringify(content);
+  }
+  return String(content);
+}
+var RaindropDeepAgentsHandler = class extends BaseCallbackHandler {
+  constructor(opts) {
+    super();
+    this.name = "RaindropDeepAgentsHandler";
+    this.spans = /* @__PURE__ */ new Map();
+    this.rootRunIds = /* @__PURE__ */ new Map();
+    this.eventIds = /* @__PURE__ */ new Map();
+    this.forwardedSpans = /* @__PURE__ */ new Set();
+    this.eventShipper = opts.eventShipper;
+    this.traceShipper = opts.traceShipper;
+    this.userId = opts.userId;
+    this.convoId = opts.convoId;
+    this.traceChains = opts.traceChains ?? true;
+  }
+  getEventId(runId, parentRunId) {
+    const rootId = parentRunId ? this.rootRunIds.get(parentRunId) ?? parentRunId : runId;
+    this.rootRunIds.set(runId, rootId);
+    if (!this.eventIds.has(rootId)) {
+      this.eventIds.set(rootId, randomUUID());
+    }
+    return this.eventIds.get(rootId);
+  }
+  getParent(parentRunId) {
+    if (!parentRunId) return void 0;
+    const parentSpan = this.spans.get(parentRunId);
+    if (!parentSpan) return void 0;
+    return {
+      traceIdB64: parentSpan.ids.traceIdB64,
+      spanIdB64: parentSpan.ids.spanIdB64
+    };
+  }
+  cleanup(runId) {
+    this.spans.delete(runId);
+    this.spans.delete(`${runId}:agent_action`);
+    this.forwardedSpans.delete(runId);
+    const rootId = this.rootRunIds.get(runId) ?? runId;
+    this.rootRunIds.delete(runId);
+    if (rootId === runId) {
+      this.eventIds.delete(rootId);
+    }
+  }
+  async finalizeEventIfRoot(runId, patch) {
+    const rootId = this.rootRunIds.get(runId) ?? runId;
+    const isRoot = rootId === runId;
+    const eventId = this.eventIds.get(rootId);
+    if (!eventId) return;
+    if (isRoot) {
+      if (this.convoId) {
+        await this.eventShipper.patch(eventId, {
+          userId: this.userId,
+          convoId: this.convoId,
+          isPending: true
+        });
+      }
+      await this.eventShipper.finish(eventId, { userId: this.userId, ...patch });
+    } else if (patch) {
+      await this.eventShipper.patch(eventId, {
+        userId: this.userId,
+        convoId: this.convoId,
+        ...patch,
+        isPending: true
+      });
+    }
+  }
+  // ---------------------------------------------------------------------------
+  // LLM events
+  // ---------------------------------------------------------------------------
+  async handleLLMStart(llm, prompts, runId, parentRunId, _extraParams, tags, metadata, runName) {
+    try {
+      if (this.spans.has(runId)) return;
+      const eventId = this.getEventId(runId, parentRunId);
+      const modelId = getName(llm, runName);
+      const span = this.traceShipper.startSpan({
+        name: "llm",
+        parent: this.getParent(parentRunId),
+        eventId,
+        attributes: [
+          attrString("ai.model.provider", modelId),
+          attrString("ai.operationId", "llm")
+        ]
+      });
+      this.spans.set(runId, span);
+      await this.eventShipper.patch(eventId, {
+        userId: this.userId,
+        convoId: this.convoId,
+        input: truncate(prompts.join("\n"), CHAIN_TEXT_MAX_LEN),
+        properties: buildProperties(tags, metadata),
+        isPending: true
+      });
+    } catch {
+    }
+  }
+  async handleChatModelStart(llm, messages, runId, parentRunId, _extraParams, tags, metadata, runName) {
+    try {
+      if (this.spans.has(runId)) return;
+      const eventId = this.getEventId(runId, parentRunId);
+      const modelId = getName(llm, runName);
+      const span = this.traceShipper.startSpan({
+        name: "llm",
+        parent: this.getParent(parentRunId),
+        eventId,
+        attributes: [
+          attrString("ai.model.provider", modelId),
+          attrString("ai.operationId", "chat")
+        ]
+      });
+      this.spans.set(runId, span);
+      const allMessages = messages.flat();
+      const userMessages = allMessages.filter((m) => {
+        const role = m._getType?.() ?? "unknown";
+        return role === "human";
+      });
+      const lastMsg = userMessages.length > 0 ? userMessages[userMessages.length - 1] : allMessages[allMessages.length - 1];
+      const extracted = lastMsg ? extractTextFromContent(lastMsg.content) : void 0;
+      const inputText = extracted !== void 0 ? truncate(extracted, CHAIN_TEXT_MAX_LEN) : void 0;
+      await this.eventShipper.patch(eventId, {
+        userId: this.userId,
+        convoId: this.convoId,
+        input: inputText,
+        properties: buildProperties(tags, metadata),
+        isPending: true
+      });
+    } catch {
+    }
+  }
+  async handleLLMEnd(output, runId, _parentRunId) {
+    const earlyRootId = this.rootRunIds.get(runId) ?? runId;
+    if (earlyRootId === runId) {
+      this._lastRootEventId = this.eventIds.get(earlyRootId) ?? this._lastRootEventId;
+    }
+    try {
+      const span = this.spans.get(runId);
+      if (!span) {
+        await this.finalizeEventIfRoot(runId);
+        return;
+      }
+      const meta = extractLLMMetadata(output);
+      const {
+        model,
+        promptTokens,
+        completionTokens,
+        cachedTokens,
+        reasoningTokens,
+        finishReason,
+        outputText
+      } = meta;
+      this.traceShipper.endSpan(span, {
+        attributes: [
+          attrString("ai.response.model", model),
+          attrInt("ai.usage.prompt_tokens", promptTokens),
+          attrInt("ai.usage.completion_tokens", completionTokens),
+          attrInt("ai.usage.cached_tokens", cachedTokens),
+          attrInt("ai.usage.thoughts_tokens", reasoningTokens),
+          attrString("ai.finish_reason", finishReason)
+        ]
+      });
+      const properties = {};
+      if (promptTokens != null) properties["ai.usage.prompt_tokens"] = promptTokens;
+      if (completionTokens != null) properties["ai.usage.completion_tokens"] = completionTokens;
+      if (cachedTokens != null) properties["ai.usage.cached_tokens"] = cachedTokens;
+      if (reasoningTokens != null) properties["ai.usage.thoughts_tokens"] = reasoningTokens;
+      if (finishReason != null) properties["ai.finish_reason"] = finishReason;
+      const cappedOutput = outputText !== void 0 ? truncate(outputText, CHAIN_TEXT_MAX_LEN) : void 0;
+      await this.finalizeEventIfRoot(runId, {
+        output: cappedOutput,
+        model,
+        properties: Object.keys(properties).length > 0 ? properties : void 0
+      });
+    } catch {
+    } finally {
+      this.cleanup(runId);
+    }
+  }
+  async handleLLMError(err, runId) {
+    const earlyRootId = this.rootRunIds.get(runId) ?? runId;
+    if (earlyRootId === runId) {
+      this._lastRootEventId = this.eventIds.get(earlyRootId) ?? this._lastRootEventId;
+    }
+    try {
+      const span = this.spans.get(runId);
+      if (span) {
+        this.traceShipper.endSpan(span, { error: err });
+      }
+      const errorInfo = extractErrorInfo(err);
+      await this.finalizeEventIfRoot(runId, {
+        output: `[Error] ${errorInfo.type}: ${errorInfo.message}`,
+        properties: {
+          "error.type": errorInfo.type,
+          "error.message": errorInfo.message
+        }
+      });
+    } catch {
+    } finally {
+      this.cleanup(runId);
+    }
+  }
+  // ---------------------------------------------------------------------------
+  // Chain events
+  // ---------------------------------------------------------------------------
+  async handleChainStart(chain, _inputs, runId, parentRunId, _tags, _metadata, _runType, runName) {
+    try {
+      const chainName = getName(chain, runName);
+      this.getEventId(runId, parentRunId);
+      if (isInternalName(chainName)) {
+        const parentSpan = parentRunId ? this.spans.get(parentRunId) : void 0;
+        if (parentSpan) {
+          this.spans.set(runId, parentSpan);
+          this.forwardedSpans.add(runId);
+        }
+        return;
+      }
+      if (!this.traceChains) return;
+      const eventId = this.eventIds.get(this.rootRunIds.get(runId) ?? runId);
+      const span = this.traceShipper.startSpan({
+        name: "chain",
+        parent: this.getParent(parentRunId),
+        eventId,
+        attributes: [
+          attrString("chain.name", chainName),
+          attrString("ai.operationId", "chain")
+        ]
+      });
+      this.spans.set(runId, span);
+    } catch {
+    }
+  }
+  async handleChainEnd(_outputs, runId) {
+    const earlyRootId = this.rootRunIds.get(runId) ?? runId;
+    if (earlyRootId === runId) {
+      this._lastRootEventId = this.eventIds.get(earlyRootId) ?? this._lastRootEventId;
+    }
+    try {
+      if (this.traceChains && !this.forwardedSpans.has(runId)) {
+        const span = this.spans.get(runId);
+        if (span) this.traceShipper.endSpan(span);
+      }
+      await this.finalizeEventIfRoot(runId);
+    } catch {
+    } finally {
+      this.cleanup(runId);
+    }
+  }
+  async handleChainError(err, runId) {
+    const earlyRootId = this.rootRunIds.get(runId) ?? runId;
+    if (earlyRootId === runId) {
+      this._lastRootEventId = this.eventIds.get(earlyRootId) ?? this._lastRootEventId;
+    }
+    try {
+      if (this.traceChains && !this.forwardedSpans.has(runId)) {
+        const span = this.spans.get(runId);
+        if (span) this.traceShipper.endSpan(span, { error: err });
+      }
+      const errorInfo = extractErrorInfo(err);
+      await this.finalizeEventIfRoot(runId, {
+        output: `[Error] ${errorInfo.type}: ${errorInfo.message}`,
+        properties: {
+          "error.type": errorInfo.type,
+          "error.message": errorInfo.message
+        }
+      });
+    } catch {
+    } finally {
+      this.cleanup(runId);
+    }
+  }
+  // ---------------------------------------------------------------------------
+  // Tool events -- Deep Agents uses tools heavily (write_todos, read_file,
+  // write_file, edit_file, ls, execute, task, etc.)
+  // ---------------------------------------------------------------------------
+  async handleToolStart(tool, input, runId, parentRunId, _tags, _metadata, runName) {
+    try {
+      const eventId = this.getEventId(runId, parentRunId);
+      const toolName = getName(tool, runName);
+      const span = this.traceShipper.startSpan({
+        name: "tool",
+        parent: this.getParent(parentRunId),
+        eventId,
+        operationId: "ai.toolCall",
+        attributes: [
+          attrString("ai.toolCall.name", toolName),
+          attrString("tool.input", truncate(input, 4096))
+        ]
+      });
+      this.spans.set(runId, span);
+    } catch {
+    }
+  }
+  async handleToolEnd(output, runId) {
+    const earlyRootId = this.rootRunIds.get(runId) ?? runId;
+    if (earlyRootId === runId) {
+      this._lastRootEventId = this.eventIds.get(earlyRootId) ?? this._lastRootEventId;
+    }
+    try {
+      const span = this.spans.get(runId);
+      if (span) {
+        const outputStr = typeof output === "string" ? output : safeStringify(output);
+        this.traceShipper.endSpan(span, {
+          attributes: [attrString("tool.output", truncate(outputStr, 4096))]
+        });
+      }
+      await this.finalizeEventIfRoot(runId);
+    } catch {
+    } finally {
+      this.cleanup(runId);
+    }
+  }
+  async handleToolError(err, runId) {
+    const earlyRootId = this.rootRunIds.get(runId) ?? runId;
+    if (earlyRootId === runId) {
+      this._lastRootEventId = this.eventIds.get(earlyRootId) ?? this._lastRootEventId;
+    }
+    try {
+      const span = this.spans.get(runId);
+      if (span) this.traceShipper.endSpan(span, { error: err });
+      const errorInfo = extractErrorInfo(err);
+      await this.finalizeEventIfRoot(runId, {
+        output: `[Error] ${errorInfo.type}: ${errorInfo.message}`,
+        properties: {
+          "error.type": errorInfo.type,
+          "error.message": errorInfo.message
+        }
+      });
+    } catch {
+    } finally {
+      this.cleanup(runId);
+    }
+  }
+  // ---------------------------------------------------------------------------
+  // Agent events
+  // ---------------------------------------------------------------------------
+  async handleAgentAction(action, runId, parentRunId) {
+    try {
+      const eventId = this.getEventId(runId, parentRunId);
+      const span = this.traceShipper.startSpan({
+        name: "agent_action",
+        parent: this.getParent(parentRunId),
+        eventId,
+        operationId: "ai.toolCall",
+        attributes: [
+          attrString("ai.toolCall.name", action.tool),
+          attrString("agent.tool_input", truncate(
+            typeof action.toolInput === "string" ? action.toolInput : safeStringify(action.toolInput),
+            4096
+          ))
+        ]
+      });
+      this.spans.set(`${runId}:agent_action`, span);
+    } catch {
+    }
+  }
+  async handleAgentEnd(_action, runId) {
+    try {
+      const spanKey = `${runId}:agent_action`;
+      const span = this.spans.get(spanKey);
+      if (span) {
+        this.traceShipper.endSpan(span);
+        this.spans.delete(spanKey);
+      }
+    } catch {
+    }
+  }
+};
+function getName(serialized, runName) {
+  if (runName) return runName;
+  if (serialized?.id?.length) return serialized.id[serialized.id.length - 1];
+  if ("name" in serialized && typeof serialized.name === "string")
+    return serialized.name;
+  return "unknown";
+}
+function buildProperties(tags, metadata) {
+  if (!tags?.length && !metadata) return void 0;
+  const props = {};
+  if (tags?.length) props["deep_agents.tags"] = tags;
+  if (metadata) Object.assign(props, metadata);
+  return props;
+}
+function safeStringify(value) {
+  try {
+    return JSON.stringify(value) ?? "";
+  } catch {
+    return String(value);
+  }
+}
+function truncate(str, maxLen) {
+  if (str.length <= maxLen) return str;
+  return str.slice(0, maxLen - 3) + "...";
+}
+function extractLLMMetadata(output) {
+  const gen = output.generations?.[0]?.[0];
+  const message = gen?.message;
+  const responseMeta = message?.response_metadata;
+  const usageMeta = message?.usage_metadata;
+  const generationInfo = gen?.generationInfo;
+  const llmOutput = output.llmOutput;
+  const tokenUsage = llmOutput?.token_usage ?? llmOutput?.tokenUsage;
+  const estimatedTokens = llmOutput?.estimatedTokens;
+  const model = responseMeta?.model_name ?? responseMeta?.model ?? llmOutput?.model_name ?? llmOutput?.model;
+  const usage = usageMeta ?? tokenUsage ?? estimatedTokens;
+  const promptTokens = asNumber(
+    usage?.input_tokens ?? usage?.prompt_tokens ?? usage?.promptTokens
+  );
+  const completionTokens = asNumber(
+    usage?.output_tokens ?? usage?.completion_tokens ?? usage?.completionTokens
+  );
+  const inputDetails = usage?.input_token_details;
+  const outputDetails = usage?.output_token_details;
+  const cachedTokens = asNumber(
+    inputDetails?.cache_read ?? usage?.cache_read_input_tokens ?? usage?.cached_tokens
+  );
+  const reasoningTokens = asNumber(
+    outputDetails?.reasoning ?? usage?.reasoning_tokens ?? usage?.thoughts_tokens
+  );
+  const finishReason = generationInfo?.finish_reason ?? responseMeta?.finish_reason ?? responseMeta?.stop_reason;
+  const outputText = gen?.text ?? (typeof message?.content === "string" ? message.content : void 0) ?? (message?.content ? extractTextFromContent(message.content) : void 0);
+  return {
+    model,
+    promptTokens,
+    completionTokens,
+    cachedTokens,
+    reasoningTokens,
+    finishReason,
+    outputText
+  };
+}
+function asNumber(val) {
+  if (val == null) return void 0;
+  const n = typeof val === "number" ? val : Number(val);
+  return Number.isFinite(n) ? n : void 0;
+}
+function extractErrorInfo(err) {
+  if (err instanceof Error) {
+    return { type: err.name || err.constructor.name, message: err.message };
+  }
+  if (typeof err === "object" && err !== null) {
+    const e = err;
+    const type = e.name ?? e.constructor?.name ?? "Error";
+    const message = e.message ?? safeStringify(err);
+    return { type, message };
+  }
+  return { type: "Error", message: String(err) };
+}
+
+// src/version.ts
+var libraryName = "@raindrop-ai/deep-agents";
+var libraryVersion = "0.0.1";
+
+// src/index.ts
+function createRaindropDeepAgents(opts) {
+  const writeKey = opts.writeKey;
+  const enabled = !!writeKey;
+  if (!writeKey) {
+    console.warn(
+      "[raindrop-ai/deep-agents] writeKey not provided; telemetry shipping is disabled"
+    );
+  }
+  const eventShipper = new EventShipper({
+    writeKey,
+    endpoint: opts.endpoint,
+    enabled,
+    debug: opts.debug ?? false,
+    sdkName: "deep-agents",
+    libraryName,
+    libraryVersion
+  });
+  const traceShipper = new TraceShipper({
+    writeKey,
+    endpoint: opts.endpoint,
+    enabled,
+    debug: opts.debug ?? false,
+    sdkName: "deep-agents",
+    serviceName: "raindrop.deep-agents",
+    serviceVersion: libraryVersion
+  });
+  const handler = new RaindropDeepAgentsHandler({
+    eventShipper,
+    traceShipper,
+    userId: opts.userId,
+    convoId: opts.convoId,
+    traceChains: opts.traceChains
+  });
+  return {
+    handler,
+    get lastEventId() {
+      return handler._lastRootEventId;
+    },
+    async flush() {
+      await Promise.all([eventShipper.flush(), traceShipper.flush()]);
+    },
+    async shutdown() {
+      await Promise.all([eventShipper.shutdown(), traceShipper.shutdown()]);
+    },
+    events: {
+      async patch(eventId, patch) {
+        await eventShipper.patch(eventId, patch);
+      },
+      async finish(eventId, patch) {
+        await eventShipper.finish(eventId, patch);
+      },
+      async addAttachments(eventId, attachments) {
+        await eventShipper.patch(eventId, { attachments });
+      },
+      async setProperties(eventId, properties) {
+        await eventShipper.patch(eventId, { properties });
+      }
+    },
+    users: {
+      async identify(users) {
+        await eventShipper.identify(users);
+      }
+    },
+    signals: {
+      async track(signal) {
+        await eventShipper.trackSignal(signal);
+      }
+    }
+  };
+}
+export {
+  RaindropDeepAgentsHandler,
+  createRaindropDeepAgents
+};