@raindrop-ai/deep-agents 0.1.1 → 0.1.2

package/dist/index.mjs

@@ -63,7 +63,459 @@ function evalScopeAttributes() {
   return { [EVAL_CORRELATION_ID_ATTRIBUTE]: scope.correlationId };
 }
 
-// ../core/dist/chunk-T53LQAH7.js
+// ../core/dist/chunk-WJOR6M7H.js
+var STATE_KEY = /* @__PURE__ */ Symbol.for("raindrop.tracing.replayTraceRoutingState");
+function state() {
+  const holder = globalThis;
+  let current = holder[STATE_KEY];
+  if (!current) {
+    let storage = null;
+    try {
+      const Ctor = globalThis.RAINDROP_ASYNC_LOCAL_STORAGE;
+      if (Ctor) storage = new Ctor();
+    } catch (e) {
+      storage = null;
+    }
+    current = {
+      storage,
+      syncDestination: void 0,
+      spanDestinations: /* @__PURE__ */ new WeakMap()
+    };
+    holder[STATE_KEY] = current;
+  }
+  return current;
+}
+function currentReplayTraceDestination() {
+  var _a, _b;
+  const routing = state();
+  return (_b = (_a = routing.storage) == null ? void 0 : _a.getStore()) != null ? _b : routing.syncDestination;
+}
+function rememberReplayTraceDestination(span) {
+  const destination = currentReplayTraceDestination();
+  if (destination) state().spanDestinations.set(span, destination);
+}
+function copyReplayTraceDestination(source, target) {
+  const destination = state().spanDestinations.get(source);
+  if (destination) state().spanDestinations.set(target, destination);
+}
+function replayTraceDestinationFor(value) {
+  if (typeof value !== "object" && typeof value !== "function" || value === null) {
+    return void 0;
+  }
+  return state().spanDestinations.get(value);
+}
+function recordReplayExportedSpan(destination, spanId, traceId) {
+  var _a, _b;
+  if (!destination || !spanId || !traceId) return;
+  (_a = destination.exportedSpanIds) == null ? void 0 : _a.add(spanId);
+  (_b = destination.exportedTraceIds) == null ? void 0 : _b.add(traceId);
+}
+function replayTraceUrl(baseUrl) {
+  return `${baseUrl.replace(/\/+$/, "")}/v1/traces`;
+}
+function getAsyncLocalStorageCtor() {
+  return globalThis.RAINDROP_ASYNC_LOCAL_STORAGE;
+}
+var MAX_BINDING_STACK = 128;
+var EMPTY_STACK = [];
+var ContextStackStorage = class {
+  /** Emitted once when this runtime cannot support an ambient push. */
+  constructor(noAmbientBindWarning) {
+    this.noAmbientBindWarning = noAmbientBindWarning;
+    this._als = null;
+    this._enterWithUsable = false;
+    this._syncStack = EMPTY_STACK;
+    this._adoptionChecked = false;
+    this._warnedNoAmbientBind = false;
+  }
+  maybeAdoptAsyncLocalStorage() {
+    if (this._adoptionChecked) return;
+    this._adoptionChecked = true;
+    const Ctor = getAsyncLocalStorageCtor();
+    if (!Ctor) return;
+    const als = new Ctor();
+    try {
+      als.run(EMPTY_STACK, () => {
+      });
+    } catch (e) {
+      return;
+    }
+    this._als = als;
+    if (typeof als.enterWith === "function") {
+      try {
+        als.enterWith(EMPTY_STACK);
+        this._enterWithUsable = true;
+      } catch (e) {
+        this._enterWithUsable = false;
+      }
+    }
+  }
+  getStack() {
+    var _a;
+    this.maybeAdoptAsyncLocalStorage();
+    if (this._als) return (_a = this._als.getStore()) != null ? _a : this._syncStack;
+    return this._syncStack;
+  }
+  /**
+   * Persist an ambient stack mutation. Returns false when an ALS is adopted but
+   * `enterWith` is unusable (workerd): callers must NOT fall back to the
+   * process-shared sync stack, since concurrent isolates would cross-stamp.
+   */
+  setAmbientStack(stack) {
+    if (this._als) {
+      if (!this._enterWithUsable) return false;
+      this._als.enterWith(stack);
+      return true;
+    }
+    this._syncStack = stack;
+    return true;
+  }
+  push(binding) {
+    this.maybeAdoptAsyncLocalStorage();
+    if (this._als && !this._enterWithUsable) {
+      this.warnNoAmbientBindOnce();
+      return;
+    }
+    let stack = this.getStack();
+    if (stack.length >= MAX_BINDING_STACK) {
+      stack = stack.filter((b) => b.isLive());
+      if (stack.length >= MAX_BINDING_STACK) {
+        stack = stack.slice(stack.length - (MAX_BINDING_STACK - 1));
+      }
+    }
+    this.setAmbientStack([...stack, binding]);
+  }
+  remove(binding) {
+    binding.markDead();
+    const stack = this.getStack();
+    const pruned = stack.filter((b) => b !== binding && b.isLive());
+    if (pruned.length !== stack.length) {
+      this.setAmbientStack(pruned);
+    }
+  }
+  runWith(binding, callback) {
+    this.maybeAdoptAsyncLocalStorage();
+    if (this._als) {
+      return this._als.run([...this.getStack(), binding], callback);
+    }
+    const previous = this._syncStack;
+    this._syncStack = [...previous, binding];
+    try {
+      return callback();
+    } finally {
+      this._syncStack = previous;
+    }
+  }
+  current() {
+    const stack = this.getStack();
+    if (stack.length === 0) return void 0;
+    const top = stack[stack.length - 1];
+    if (top.isLive()) return top;
+    const pruned = stack.filter((b) => b.isLive());
+    this.setAmbientStack(pruned);
+    return pruned.length > 0 ? pruned[pruned.length - 1] : void 0;
+  }
+  warnNoAmbientBindOnce() {
+    if (this._warnedNoAmbientBind) return;
+    this._warnedNoAmbientBind = true;
+    console.warn(this.noAmbientBindWarning);
+  }
+};
+var NO_AMBIENT_ROUTING_BIND_WARNING = "[raindrop] This runtime's AsyncLocalStorage does not implement enterWith (e.g. Cloudflare Workers), so begin()/finish() cannot scope auto-instrumented spans to a project without cross-contaminating concurrent requests. Manual events and explicit span routing are unaffected; use asCurrent()/withSpan (run-based) to route auto-instrumented spans on this runtime.";
+var ROUTING_STORAGE_KEY = /* @__PURE__ */ Symbol.for("raindrop.tracing.routingContextStorage");
+function routingStorage() {
+  const holder = globalThis;
+  let storage = holder[ROUTING_STORAGE_KEY];
+  if (!storage) {
+    storage = new ContextStackStorage(NO_AMBIENT_ROUTING_BIND_WARNING);
+    holder[ROUTING_STORAGE_KEY] = storage;
+  }
+  return storage;
+}
+function currentRoutingBinding() {
+  const bound = routingStorage().current();
+  if (!bound) return void 0;
+  return {
+    projectId: bound.projectId,
+    authHint: bound.authHint,
+    ...bound.appGit ? { appGit: bound.appGit } : {},
+    ...bound.appGitSource ? { appGitSource: bound.appGitSource } : {}
+  };
+}
+var APP_COMMIT_SHA = "raindrop.app.commit_sha";
+var APP_COMMIT_DIRTY = "raindrop.app.commit_dirty";
+var APP_BRANCH = "raindrop.app.branch";
+var APP_GIT_KEYS = [APP_COMMIT_SHA, APP_COMMIT_DIRTY, APP_BRANCH];
+var own = (value, key) => Object.prototype.hasOwnProperty.call(value, key);
+function appGitExplicitKeys(properties) {
+  const keys = /* @__PURE__ */ new Set();
+  if (!properties) return keys;
+  for (const key of APP_GIT_KEYS) {
+    if (own(properties, key)) keys.add(key);
+  }
+  return keys;
+}
+function mergeAppGitSnapshot(base, properties, explicitKeys = /* @__PURE__ */ new Set()) {
+  try {
+    const result = { ...base };
+    if (properties && own(properties, APP_COMMIT_SHA) && properties[APP_COMMIT_SHA] !== result[APP_COMMIT_SHA]) {
+      if (!explicitKeys.has(APP_COMMIT_DIRTY) && !own(properties, APP_COMMIT_DIRTY)) {
+        delete result[APP_COMMIT_DIRTY];
+      }
+      if (!explicitKeys.has(APP_BRANCH) && !own(properties, APP_BRANCH)) {
+        delete result[APP_BRANCH];
+      }
+    }
+    for (const key of APP_GIT_KEYS) {
+      if (properties && own(properties, key)) result[key] = properties[key];
+    }
+    return Object.freeze(result);
+  } catch (e) {
+    return Object.freeze({});
+  }
+}
+function validAppCommitSha(value) {
+  if (typeof value !== "string" || value.length > 128) return void 0;
+  const cleaned = value.trim();
+  return /^(?:[a-fA-F0-9]{40}|[a-fA-F0-9]{64})$/.test(cleaned) ? cleaned.toLowerCase() : void 0;
+}
+function shortString(value) {
+  if (typeof value !== "string" || value.length > 1024) return void 0;
+  const cleaned = value.trim();
+  return cleaned.length > 0 ? cleaned : void 0;
+}
+function flag(value) {
+  if (value === true || value === "true" || value === "1") return true;
+  if (value === false || value === "false" || value === "0") return false;
+  return void 0;
+}
+function environment() {
+  try {
+    return typeof process === "undefined" ? {} : process.env;
+  } catch (e) {
+    return {};
+  }
+}
+var DEPLOYMENTS = [
+  ["VERCEL", "VERCEL_GIT_COMMIT_SHA", "VERCEL_GIT_COMMIT_REF"],
+  ["NETLIFY", "COMMIT_REF", "BRANCH"],
+  ["RAILWAY_ENVIRONMENT_NAME", "RAILWAY_GIT_COMMIT_SHA", "RAILWAY_GIT_BRANCH"],
+  ["RAILWAY_ENVIRONMENT", "RAILWAY_GIT_COMMIT_SHA", "RAILWAY_GIT_BRANCH"],
+  ["RENDER", "RENDER_GIT_COMMIT", "RENDER_GIT_BRANCH"],
+  ["DYNO", "HEROKU_BUILD_COMMIT", ""],
+  ["DYNO", "HEROKU_SLUG_COMMIT", ""],
+  ["AWS_APP_ID", "AWS_COMMIT_ID", "AWS_BRANCH"],
+  ["WORKERS_CI", "WORKERS_CI_COMMIT_SHA", "WORKERS_CI_BRANCH"]
+];
+var CI_SOURCES = [
+  ["GITHUB_ACTIONS", "GITHUB_SHA", "GITHUB_REF_NAME"],
+  ["GITLAB_CI", "CI_COMMIT_SHA", "CI_COMMIT_REF_NAME"],
+  ["CIRCLECI", "CIRCLE_SHA1", "CIRCLE_BRANCH"]
+];
+function detectedSource(env, table, detectBranch) {
+  for (const row of table) {
+    const [marker, shaKey, branchKey] = row;
+    if (!marker || !shaKey || !shortString(env[marker]) || flag(env[marker]) === false) continue;
+    const commitSha = validAppCommitSha(env[shaKey]);
+    if (commitSha)
+      return {
+        commitSha,
+        ...detectBranch && branchKey ? { branch: shortString(env[branchKey]) } : {}
+      };
+  }
+  return {};
+}
+var AppGitContextImpl = class {
+  constructor(options, runtime = {}) {
+    this.defaults = {};
+    this.explicit = {};
+    this.explicitKeys = /* @__PURE__ */ new Set();
+    this.disposed = false;
+    this.operations = /* @__PURE__ */ new Map();
+    this.operationOverflow = false;
+    this.detectBranch = false;
+    this.disabled = false;
+    var _a, _b, _c, _d, _e, _f;
+    try {
+      if (options === false) {
+        this.disabled = true;
+        return;
+      }
+      const opts = options != null ? options : {};
+      const env = (_a = runtime.env) != null ? _a : environment();
+      const detectBranch = (_c = (_b = flag(opts.detectBranch)) != null ? _b : flag(env.RAINDROP_GIT_DETECT_BRANCH)) != null ? _c : false;
+      this.detectBranch = detectBranch;
+      const collectBranch = detectBranch || runtime.captureLegacyReplayBranch === true;
+      const autoDetect = runtime.allowDiscovery === false ? false : (_e = (_d = flag(opts.autoDetect)) != null ? _d : flag(env.RAINDROP_GIT_AUTO_DETECT)) != null ? _e : true;
+      const configuredSha = opts.commitSha;
+      const explicitSha = configuredSha === void 0 ? env.RAINDROP_COMMIT_SHA : configuredSha;
+      if (explicitSha === null) this.explicit[APP_COMMIT_SHA] = null;
+      else if (typeof explicitSha === "string" && validAppCommitSha(explicitSha))
+        this.explicit[APP_COMMIT_SHA] = explicitSha;
+      const configuredDirty = opts.commitDirty;
+      const explicitDirty = configuredDirty === void 0 ? flag(env.RAINDROP_COMMIT_DIRTY) : configuredDirty;
+      if (explicitDirty === null || typeof explicitDirty === "boolean")
+        this.explicit[APP_COMMIT_DIRTY] = explicitDirty;
+      const configuredBranch = opts.branch;
+      const explicitBranch = configuredBranch === void 0 ? env.RAINDROP_BRANCH : configuredBranch;
+      if (explicitBranch === null) this.explicit[APP_BRANCH] = null;
+      else if (typeof explicitBranch === "string" && explicitBranch.length <= 1024)
+        this.explicit[APP_BRANCH] = explicitBranch;
+      this.explicitKeys = appGitExplicitKeys(this.explicit);
+      this.defaults = { ...this.explicit };
+      if (!autoDetect || explicitSha !== void 0) return;
+      const sourceDirectory = (_f = shortString(opts.sourceDirectory)) != null ? _f : shortString(env.RAINDROP_GIT_SOURCE_DIRECTORY);
+      if (runtime.allowLocalGit === false && !sourceDirectory) return;
+      const deploy = sourceDirectory ? {} : detectedSource(env, DEPLOYMENTS, collectBranch);
+      if (deploy.commitSha) {
+        this.accept(deploy);
+        return;
+      }
+      const fallback = sourceDirectory ? {} : detectedSource(env, CI_SOURCES, collectBranch);
+      if (runtime.resolveLocal && (runtime.allowLocalGit !== false || sourceDirectory)) {
+        this.cancel = runtime.resolveLocal(sourceDirectory, collectBranch, (result) => {
+          try {
+            if (!this.disposed) this.accept(result.commitSha ? result : fallback);
+          } catch (e) {
+          }
+        });
+      } else this.accept(fallback);
+    } catch (e) {
+    }
+  }
+  accept(result) {
+    const sha = validAppCommitSha(result.commitSha);
+    if (!sha) return;
+    this.replayBranch = shortString(result.branch);
+    this.defaults = {
+      [APP_COMMIT_SHA]: sha,
+      ...typeof result.commitDirty === "boolean" ? { [APP_COMMIT_DIRTY]: result.commitDirty } : {},
+      ...this.detectBranch && this.replayBranch ? { [APP_BRANCH]: this.replayBranch } : {},
+      ...this.explicit
+    };
+  }
+  snapshot(properties) {
+    var _a;
+    try {
+      const binding = currentRoutingBinding();
+      const base = this.disabled && (binding == null ? void 0 : binding.appGitSource) !== "replay-override" ? {} : (_a = binding == null ? void 0 : binding.appGit) != null ? _a : this.defaults;
+      return this.mergeSnapshot(base, properties);
+    } catch (e) {
+      return Object.freeze({});
+    }
+  }
+  /** Safe defaults when no operation/span start was observed; never infer identity. */
+  snapshotExplicit(properties, eventId) {
+    try {
+      const base = { ...this.explicit };
+      const operation = eventId ? this.operations.get(eventId) : void 0;
+      if (operation) {
+        for (const key of operation.explicitKeys) base[key] = operation.snapshot[key];
+      }
+      return this.mergeSnapshot(base, properties, new Set(Object.keys(base)));
+    } catch (e) {
+      return mergeAppGitSnapshot({}, properties);
+    }
+  }
+  /** Existing replay branch reporting stays separate from opt-in event properties. */
+  snapshotForReplay() {
+    const snapshot = this.snapshot();
+    if (this.replayBranch && !own(snapshot, APP_BRANCH) && snapshot[APP_COMMIT_SHA] === this.defaults[APP_COMMIT_SHA]) {
+      return Object.freeze({ ...snapshot, [APP_BRANCH]: this.replayBranch });
+    }
+    return snapshot;
+  }
+  /** Merge a frozen span snapshot without losing client-authored provenance. */
+  mergeSnapshot(base, properties, explicitKeys = this.explicitKeys) {
+    return mergeAppGitSnapshot(base, properties, /* @__PURE__ */ new Set([...this.explicitKeys, ...explicitKeys]));
+  }
+  /** Shippers belonging to one client share this bounded operation registry. */
+  forOperation(eventId, properties, owner) {
+    if (!eventId) return this.snapshot(properties);
+    let operation = this.operations.get(eventId);
+    if (!operation) {
+      if (this.operations.size >= 1e4) this.operationOverflow = true;
+      if (this.operationOverflow) return this.mergeSnapshot({}, properties);
+      operation = {
+        snapshot: this.snapshot(properties),
+        owners: /* @__PURE__ */ new Set(),
+        unowned: owner === void 0,
+        explicitKeys: appGitExplicitKeys(properties)
+      };
+      this.operations.set(eventId, operation);
+    } else if (properties && APP_GIT_KEYS.some((key) => own(properties, key))) {
+      const explicitKeys = /* @__PURE__ */ new Set([...this.explicitKeys, ...operation.explicitKeys]);
+      operation.snapshot = this.mergeSnapshot(operation.snapshot, properties, explicitKeys);
+      for (const key of appGitExplicitKeys(properties)) operation.explicitKeys.add(key);
+    }
+    if (!owner) operation.unowned = true;
+    if (owner) operation.owners.add(owner);
+    return operation.snapshot;
+  }
+  releaseOperation(eventId, owner) {
+    const operation = this.operations.get(eventId);
+    if (!operation) return;
+    operation.owners.delete(owner);
+    if (operation.owners.size === 0 && !operation.unowned) this.operations.delete(eventId);
+  }
+  finishOperation(eventId) {
+    this.operations.delete(eventId);
+  }
+  dispose() {
+    var _a;
+    this.disposed = true;
+    try {
+      (_a = this.cancel) == null ? void 0 : _a.call(this);
+    } catch (e) {
+    }
+  }
+};
+var AppGitContext = AppGitContextImpl;
+function createAppGitContext(options, runtime = {}) {
+  return new AppGitContext(options, runtime);
+}
+function withAppGitProperties(properties, snapshot) {
+  try {
+    const merged = { ...properties };
+    for (const key of APP_GIT_KEYS)
+      if (!own(merged, key) && own(snapshot, key)) merged[key] = snapshot[key];
+    return merged;
+  } catch (e) {
+    return properties != null ? properties : {};
+  }
+}
+function withAppGitAttributes(attributes, snapshot) {
+  try {
+    const present = new Set(attributes.flatMap((attr) => attr ? [attr.key] : []));
+    const added = [];
+    for (const key of APP_GIT_KEYS) {
+      if (present.has(key) || present.has(`ai.telemetry.metadata.${key}`) || present.has(`traceloop.association.properties.${key}`))
+        continue;
+      const value = snapshot[key];
+      if (typeof value === "string") added.push({ key, value: { stringValue: value } });
+      else if (typeof value === "boolean") added.push({ key, value: { boolValue: value } });
+    }
+    return added.length ? [...attributes, ...added] : attributes;
+  } catch (e) {
+    return attributes;
+  }
+}
+function appGitPropertiesFromAttributes(attributes) {
+  var _a, _b, _c;
+  const properties = {};
+  try {
+    for (const attr of attributes) {
+      if (!attr) continue;
+      for (const key of APP_GIT_KEYS) {
+        if (attr.key === key || attr.key === `ai.telemetry.metadata.${key}` || attr.key === `traceloop.association.properties.${key}`) {
+          properties[key] = (_c = (_b = (_a = attr.value.stringValue) != null ? _a : attr.value.boolValue) != null ? _b : attr.value.intValue) != null ? _c : null;
+        }
+      }
+    }
+  } catch (e) {
+  }
+  return properties;
+}
 function getCrypto() {
   const c = globalThis.crypto;
   return c;
@@ -168,7 +620,7 @@ function runWithTracingSuppressed(fn) {
 var DEFAULT_REQUEST_TIMEOUT_MS = 3e4;
 var MAX_RETRY_DELAY_MS = 3e4;
 function wait(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
+  return new Promise((resolve2) => setTimeout(resolve2, ms));
 }
 function formatEndpoint(endpoint) {
   if (!endpoint) return void 0;
@@ -205,9 +657,9 @@ async function raceWithTimeout(promise, timeoutMs) {
       () => true,
       () => true
     ),
-    new Promise((resolve) => {
+    new Promise((resolve2) => {
       var _a;
-      timer = setTimeout(() => resolve(false), Math.max(0, timeoutMs));
+      timer = setTimeout(() => resolve2(false), Math.max(0, timeoutMs));
       (_a = timer.unref) == null ? void 0 : _a.call(timer);
     })
   ]);
@@ -380,55 +832,6 @@ function buildExportTraceServiceRequest(spans, serviceName = "raindrop.core", se
     ]
   };
 }
-var STATE_KEY = /* @__PURE__ */ Symbol.for("raindrop.tracing.replayTraceRoutingState");
-function state() {
-  const holder = globalThis;
-  let current = holder[STATE_KEY];
-  if (!current) {
-    let storage = null;
-    try {
-      const Ctor = globalThis.RAINDROP_ASYNC_LOCAL_STORAGE;
-      if (Ctor) storage = new Ctor();
-    } catch (e) {
-      storage = null;
-    }
-    current = {
-      storage,
-      syncDestination: void 0,
-      spanDestinations: /* @__PURE__ */ new WeakMap()
-    };
-    holder[STATE_KEY] = current;
-  }
-  return current;
-}
-function currentReplayTraceDestination() {
-  var _a, _b;
-  const routing = state();
-  return (_b = (_a = routing.storage) == null ? void 0 : _a.getStore()) != null ? _b : routing.syncDestination;
-}
-function rememberReplayTraceDestination(span) {
-  const destination = currentReplayTraceDestination();
-  if (destination) state().spanDestinations.set(span, destination);
-}
-function copyReplayTraceDestination(source, target) {
-  const destination = state().spanDestinations.get(source);
-  if (destination) state().spanDestinations.set(target, destination);
-}
-function replayTraceDestinationFor(value) {
-  if (typeof value !== "object" && typeof value !== "function" || value === null) {
-    return void 0;
-  }
-  return state().spanDestinations.get(value);
-}
-function recordReplayExportedSpan(destination, spanId, traceId) {
-  var _a, _b;
-  if (!destination || !spanId || !traceId) return;
-  (_a = destination.exportedSpanIds) == null ? void 0 : _a.add(spanId);
-  (_b = destination.exportedTraceIds) == null ? void 0 : _b.add(traceId);
-}
-function replayTraceUrl(baseUrl) {
-  return `${baseUrl.replace(/\/+$/, "")}/v1/traces`;
-}
 var LOCAL_DEBUGGER_ENV_VAR = "RAINDROP_LOCAL_DEBUGGER";
 var WORKSHOP_ENV_VAR = "RAINDROP_WORKSHOP";
 var DEFAULT_LOCAL_WORKSHOP_URL = "http://localhost:5899/v1/";
@@ -538,6 +941,13 @@ function projectIdHeaders(projectId) {
 }
 var SHUTDOWN_DEADLINE_MS = 1e4;
 var POST_SHUTDOWN_TIMEOUT_MS = 5e3;
+function appGitOwnerId(prefix) {
+  try {
+    return `${prefix}:${randomUUID()}`;
+  } catch (e) {
+    return `${prefix}:${Date.now().toString(36)}:${Math.random().toString(36).slice(2)}`;
+  }
+}
 function mergePatches(target, source) {
   var _a, _b, _c, _d, _e, _f, _g, _h, _i;
   const out = { ...target, ...source };
@@ -587,22 +997,25 @@ function eventTelemetryProperties(patch) {
 }
 var EventShipper = class {
   constructor(opts) {
+    this.appGitOwner = appGitOwnerId("event");
     this.buffers = /* @__PURE__ */ new Map();
     this.sticky = /* @__PURE__ */ new Map();
     this.timers = /* @__PURE__ */ new Map();
     this.inFlight = /* @__PURE__ */ new Set();
     this.hasShutdown = false;
-    var _a, _b, _c, _d, _e, _f, _g, _h;
-    this.writeKey = (_a = opts.writeKey) == null ? void 0 : _a.trim();
-    this.baseUrl = (_b = formatEndpoint(opts.endpoint)) != null ? _b : "https://api.raindrop.ai/v1/";
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i;
+    this.appGitContext = (_a = opts.appGitContext) != null ? _a : createAppGitContext(opts.appGit);
+    this.ownsAppGitContext = opts.appGitContext === void 0;
+    this.writeKey = (_b = opts.writeKey) == null ? void 0 : _b.trim();
+    this.baseUrl = (_c = formatEndpoint(opts.endpoint)) != null ? _c : "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.partialFlushMs = (_d = opts.partialFlushMs) != null ? _d : 1e3;
+    this.sdkName = (_e = opts.sdkName) != null ? _e : "core";
     this.prefix = `[raindrop-ai/${this.sdkName}]`;
-    this.defaultEventName = (_e = opts.defaultEventName) != null ? _e : "ai_generation";
+    this.defaultEventName = (_f = opts.defaultEventName) != null ? _f : "ai_generation";
     this.maxTextFieldCharsOpt = opts.maxTextFieldChars;
-    this.localDebuggerUrl = (_f = resolveLocalDebuggerBaseUrl(opts.localDebuggerUrl)) != null ? _f : void 0;
+    this.localDebuggerUrl = (_g = resolveLocalDebuggerBaseUrl(opts.localDebuggerUrl)) != null ? _g : void 0;
     if (this.debug && this.localDebuggerUrl) {
       console.log(`${this.prefix} Local debugger mirroring: ${this.localDebuggerUrl}`);
     }
@@ -613,8 +1026,8 @@ var EventShipper = class {
     const isNode = typeof process !== "undefined" && typeof process.version === "string";
     this.context = {
       library: {
-        name: (_g = opts.libraryName) != null ? _g : "@raindrop-ai/core",
-        version: (_h = opts.libraryVersion) != null ? _h : "0.0.0"
+        name: (_h = opts.libraryName) != null ? _h : "@raindrop-ai/core",
+        version: (_i = opts.libraryVersion) != null ? _i : "0.0.0"
       },
       metadata: {
         jsRuntime: isNode ? "node" : "web",
@@ -622,6 +1035,9 @@ var EventShipper = class {
       }
     };
   }
+  ownAppGitContextForShutdown() {
+    this.ownsAppGitContext = true;
+  }
   isDebugEnabled() {
     return this.debug;
   }
@@ -700,6 +1116,13 @@ var EventShipper = class {
     }
     const sticky = (_c = this.sticky.get(eventId)) != null ? _c : {};
     const existing = (_d = this.buffers.get(eventId)) != null ? _d : {};
+    patch = {
+      ...patch,
+      properties: withAppGitProperties(
+        patch.properties,
+        this.appGitContext.forOperation(eventId, patch.properties, this.appGitOwner)
+      )
+    };
     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);
@@ -713,6 +1136,8 @@ var EventShipper = class {
     if (t) clearTimeout(t);
     if (merged.isPending === false) {
       await this.flushOne(eventId);
+      if (this.appGitContext.releaseOperation) this.appGitContext.releaseOperation(eventId, this.appGitOwner);
+      else this.appGitContext.finishOperation(eventId);
       return;
     }
     const timeout = setTimeout(() => {
@@ -744,6 +1169,7 @@ var EventShipper = class {
       if (!settled) this.warnShutdownDrop("in-flight request(s) at shutdown");
     } finally {
       this.shutdownDeadlineAt = void 0;
+      if (this.ownsAppGitContext) this.appGitContext.dispose();
     }
   }
   async trackSignal(signal) {
@@ -1171,6 +1597,13 @@ function redactJsonAttributeValue(key, value) {
   if (scrubbedJson === json) return void 0;
   return { stringValue: scrubbedJson };
 }
+function appGitOwnerId2(prefix) {
+  try {
+    return `${prefix}:${randomUUID()}`;
+  } catch (e) {
+    return `${prefix}:${Date.now().toString(36)}:${Math.random().toString(36).slice(2)}`;
+  }
+}
 function identityAttrs(args) {
   return [
     attrString("ai.telemetry.metadata.raindrop.ai.userId", args.userId),
@@ -1193,23 +1626,30 @@ function applyOtelSpanAttributeLimit(limit) {
 }
 var TraceShipper = class {
   constructor(opts) {
+    this.appGitOwner = appGitOwnerId2("trace");
+    this.appGitEventIds = /* @__PURE__ */ new WeakMap();
+    this.appGitActiveSpans = /* @__PURE__ */ new Map();
+    this.appGitCaptured = /* @__PURE__ */ new WeakSet();
+    this.appGitAdded = /* @__PURE__ */ new WeakMap();
     this.queue = [];
     this.inFlight = /* @__PURE__ */ new Set();
     this.hasShutdown = false;
-    var _a, _b, _c, _d, _e, _f, _g, _h, _i;
-    this.writeKey = (_a = opts.writeKey) == null ? void 0 : _a.trim();
-    this.baseUrl = (_b = formatEndpoint(opts.endpoint)) != null ? _b : "https://api.raindrop.ai/v1/";
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
+    this.appGitContext = (_a = opts.appGitContext) != null ? _a : createAppGitContext(opts.appGit);
+    this.ownsAppGitContext = opts.appGitContext === void 0;
+    this.writeKey = (_b = opts.writeKey) == null ? void 0 : _b.trim();
+    this.baseUrl = (_c = formatEndpoint(opts.endpoint)) != null ? _c : "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.flushIntervalMs = (_d = opts.flushIntervalMs) != null ? _d : 1e3;
+    this.maxBatchSize = (_e = opts.maxBatchSize) != null ? _e : 50;
+    this.maxQueueSize = (_f = opts.maxQueueSize) != null ? _f : 5e3;
+    this.sdkName = (_g = opts.sdkName) != null ? _g : "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";
-    this.localDebuggerUrl = (_i = resolveLocalDebuggerBaseUrl(opts.localDebuggerUrl)) != null ? _i : void 0;
+    this.serviceName = (_h = opts.serviceName) != null ? _h : "raindrop.core";
+    this.serviceVersion = (_i = opts.serviceVersion) != null ? _i : "0.0.0";
+    this.localDebuggerUrl = (_j = resolveLocalDebuggerBaseUrl(opts.localDebuggerUrl)) != null ? _j : void 0;
     if (this.debug && this.localDebuggerUrl) {
       console.log(`${this.prefix} Local debugger mirroring: ${this.localDebuggerUrl}`);
     }
@@ -1310,7 +1750,7 @@ var TraceShipper = class {
     return { ...this.authHeaders(), ...projectIdHeaders(this.projectId) };
   }
   startSpan(args) {
-    var _a, _b;
+    var _a, _b, _c;
     const ids = createSpanIds(args.parent);
     const started = (_a = args.startTimeUnixNano) != null ? _a : nowUnixNanoString();
     const attrs = [
@@ -1320,13 +1760,24 @@ var TraceShipper = class {
       ...Object.entries(evalScopeAttributes()).map(([key, value]) => attrString(key, value))
     ];
     if ((_b = args.attributes) == null ? void 0 : _b.length) attrs.push(...args.attributes);
+    const tracksAppGit = this.appGitActiveSpans.has(args.eventId) || this.appGitActiveSpans.size < 1e4;
+    const appGitOverrides = appGitPropertiesFromAttributes(attrs);
     const span = {
       ids,
       name: args.name,
       startTimeUnixNano: started,
-      attributes: attrs
+      attributes: withAppGitAttributes(
+        attrs,
+        this.appGitContext.forOperation(args.eventId, appGitOverrides, this.appGitOwner)
+      )
     };
     rememberReplayTraceDestination(span);
+    this.appGitCaptured.add(span);
+    this.appGitEventIds.set(span, args.eventId);
+    if (tracksAppGit) {
+      this.appGitActiveSpans.set(args.eventId, ((_c = this.appGitActiveSpans.get(args.eventId)) != null ? _c : 0) + 1);
+    }
+    this.appGitAdded.set(span, new Set(span.attributes.filter((attr) => !attrs.includes(attr))));
     const openSpan = buildOtlpSpan({
       ids: span.ids,
       name: span.name,
@@ -1366,11 +1817,17 @@ var TraceShipper = class {
     });
   }
   endSpan(span, extra) {
-    var _a, _b;
+    var _a, _b, _c;
     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) {
+      const overrides = appGitPropertiesFromAttributes(extra.attributes);
+      const eventId2 = this.appGitEventIds.get(span);
+      const snapshot = eventId2 ? this.appGitContext.forOperation(eventId2, overrides, this.appGitOwner) : overrides;
+      const added = this.appGitAdded.get(span);
+      span.attributes = span.attributes.filter((attr) => !(added == null ? void 0 : added.has(attr)) || !attr || !Object.prototype.hasOwnProperty.call(overrides, APP_COMMIT_SHA) && !Object.prototype.hasOwnProperty.call(overrides, attr.key));
       span.attributes.push(...extra.attributes);
+      span.attributes = withAppGitAttributes(span.attributes, snapshot);
     }
     let status = extra == null ? void 0 : extra.status;
     if (!status && (extra == null ? void 0 : extra.error) !== void 0) {
@@ -1386,8 +1843,19 @@ var TraceShipper = class {
       status
     });
     copyReplayTraceDestination(span, otlp);
+    this.appGitCaptured.add(otlp);
     this.enqueue(otlp);
     this.mirrorToLocalDebugger(otlp, true);
+    const eventId = this.appGitEventIds.get(span);
+    if (eventId && this.appGitActiveSpans.has(eventId)) {
+      const remaining = ((_c = this.appGitActiveSpans.get(eventId)) != null ? _c : 1) - 1;
+      if (remaining > 0) this.appGitActiveSpans.set(eventId, remaining);
+      else {
+        this.appGitActiveSpans.delete(eventId);
+        if (this.appGitContext.releaseOperation) this.appGitContext.releaseOperation(eventId, this.appGitOwner);
+        else if (this.ownsAppGitContext) this.appGitContext.finishOperation(eventId);
+      }
+    }
   }
   createSpan(args) {
     var _a;
@@ -1398,20 +1866,41 @@ var TraceShipper = class {
       ...Object.entries(evalScopeAttributes()).map(([key, value]) => attrString(key, value))
     ];
     if ((_a = args.attributes) == null ? void 0 : _a.length) attrs.push(...args.attributes);
+    const tracksAppGit = !this.appGitActiveSpans.has(args.eventId);
     const otlp = buildOtlpSpan({
       ids,
       name: args.name,
       startTimeUnixNano: args.startTimeUnixNano,
       endTimeUnixNano: args.endTimeUnixNano,
-      attributes: attrs,
+      attributes: withAppGitAttributes(
+        attrs,
+        this.appGitContext.forOperation(
+          args.eventId,
+          appGitPropertiesFromAttributes(attrs),
+          this.appGitOwner
+        )
+      ),
       status: args.status
     });
     rememberReplayTraceDestination(otlp);
+    this.appGitCaptured.add(otlp);
+    if (tracksAppGit) {
+      if (this.appGitContext.releaseOperation) this.appGitContext.releaseOperation(args.eventId, this.appGitOwner);
+      else if (this.ownsAppGitContext) this.appGitContext.finishOperation(args.eventId);
+    }
     this.enqueue(otlp);
     this.mirrorToLocalDebugger(otlp, true);
   }
   enqueue(span) {
+    var _a;
     if (!this.enabled) return;
+    const attributes = (_a = span.attributes) != null ? _a : [];
+    const enriched = this.appGitCaptured.has(span) ? attributes : withAppGitAttributes(attributes, this.appGitContext.snapshot(appGitPropertiesFromAttributes(attributes)));
+    if (enriched !== attributes) {
+      const original = span;
+      span = { ...span, attributes: enriched.filter((attr) => attr !== void 0) };
+      copyReplayTraceDestination(original, span);
+    }
     if (this.debugSpans) {
       const short = (s) => s ? s.slice(-8) : "none";
       console.log(
@@ -1557,12 +2046,158 @@ var TraceShipper = class {
       }
     } finally {
       this.shutdownDeadlineAt = void 0;
+      if (this.ownsAppGitContext) this.appGitContext.dispose();
     }
   }
 };
 
 // ../core/dist/index.node.js
 import { AsyncLocalStorage } from "async_hooks";
+import { execFile } from "child_process";
+import { resolve } from "path";
+var resolveLocal = (sourceDirectory, detectBranch, completed) => {
+  const cwd = sourceDirectory ? resolve(sourceDirectory) : process.cwd();
+  let cancelled = false;
+  let active;
+  let deadlineTimer;
+  const deadline = Date.now() + 1e3;
+  const run = (args, done) => {
+    if (cancelled) return;
+    const remaining = deadline - Date.now();
+    if (remaining <= 0) {
+      done(void 0);
+      return;
+    }
+    try {
+      active = execFile(
+        "git",
+        args,
+        {
+          cwd,
+          encoding: "utf8",
+          maxBuffer: 4096,
+          windowsHide: true,
+          env: {
+            ...process.env,
+            // The selected application cwd, not the invoking shell's Git plumbing, owns identity.
+            GIT_DIR: void 0,
+            GIT_WORK_TREE: void 0,
+            GIT_COMMON_DIR: void 0,
+            GIT_NAMESPACE: void 0,
+            GIT_INDEX_FILE: void 0,
+            GIT_OBJECT_DIRECTORY: void 0,
+            GIT_ALTERNATE_OBJECT_DIRECTORIES: void 0,
+            GIT_CONFIG_PARAMETERS: void 0,
+            GIT_CONFIG_COUNT: "0",
+            GIT_TERMINAL_PROMPT: "0",
+            GIT_OPTIONAL_LOCKS: "0"
+          }
+        },
+        (error, stdout) => {
+          clearTimeout(deadlineTimer);
+          deadlineTimer = void 0;
+          active = void 0;
+          if (!cancelled) {
+            try {
+              done(error ? void 0 : stdout.trim());
+            } catch (e) {
+            }
+          }
+        }
+      );
+      active.unref();
+      if (active.stdout && "unref" in active.stdout && typeof active.stdout.unref === "function")
+        active.stdout.unref();
+      if (active.stderr && "unref" in active.stderr && typeof active.stderr.unref === "function")
+        active.stderr.unref();
+      deadlineTimer = setTimeout(() => {
+        try {
+          active == null ? void 0 : active.kill("SIGKILL");
+        } catch (e) {
+        }
+      }, remaining);
+      deadlineTimer.unref();
+    } catch (e) {
+      try {
+        done(void 0);
+      } catch (e2) {
+      }
+    }
+  };
+  const scheduled = setTimeout(() => {
+    try {
+      run(["rev-parse", "HEAD"], (rawSha) => {
+        const commitSha = validAppCommitSha(rawSha);
+        if (!commitSha) {
+          completed({});
+          return;
+        }
+        run(["-c", "core.fsmonitor=false", "status", "--porcelain"], (status) => {
+          const finish = (branch) => {
+            run(["rev-parse", "HEAD"], (finalSha) => {
+              const coherent = validAppCommitSha(finalSha) === commitSha;
+              completed({
+                commitSha,
+                ...coherent && status !== void 0 ? { commitDirty: status !== "" } : {},
+                ...coherent && branch && branch !== "HEAD" ? { branch } : {}
+              });
+            });
+          };
+          if (detectBranch) run(["symbolic-ref", "--quiet", "--short", "HEAD"], finish);
+          else finish();
+        });
+      });
+    } catch (e) {
+      completed({});
+    }
+  }, 0);
+  scheduled.unref();
+  return () => {
+    cancelled = true;
+    clearTimeout(scheduled);
+    clearTimeout(deadlineTimer);
+    try {
+      active == null ? void 0 : active.kill("SIGKILL");
+    } catch (e) {
+    }
+  };
+};
+function createAppGitContext2(options, runtime = {}) {
+  return new AppGitContext(options, { ...runtime, resolveLocal });
+}
+function hasDestination(options) {
+  var _a;
+  if (options.enabled === false) return false;
+  return Boolean(((_a = options.writeKey) == null ? void 0 : _a.trim()) || resolveLocalDebuggerBaseUrl(options.localDebuggerUrl));
+}
+var EventShipper2 = class extends EventShipper {
+  constructor(options) {
+    var _a;
+    const ownsAppGitContext = options.appGitContext === void 0;
+    const appGitContext = (_a = options.appGitContext) != null ? _a : createAppGitContext2(options.appGit, { allowDiscovery: hasDestination(options) });
+    try {
+      super({ ...options, appGitContext });
+    } catch (error) {
+      if (ownsAppGitContext) appGitContext.dispose();
+      throw error;
+    }
+    if (ownsAppGitContext) this.ownAppGitContextForShutdown();
+  }
+};
+var TraceShipper2 = class extends TraceShipper {
+  constructor(options) {
+    var _a;
+    const ownsAppGitContext = options.appGitContext === void 0;
+    const appGitContext = (_a = options.appGitContext) != null ? _a : createAppGitContext2(options.appGit, { allowDiscovery: hasDestination(options) });
+    try {
+      super({ ...options, appGitContext });
+    } catch (error) {
+      if (ownsAppGitContext) appGitContext.dispose();
+      throw error;
+    }
+    this.ownsAppGitContext = ownsAppGitContext;
+  }
+};
 globalThis.RAINDROP_ASYNC_LOCAL_STORAGE = AsyncLocalStorage;
 var SUPPRESS_TRACING_KEY = /* @__PURE__ */ Symbol.for(
   "OpenTelemetry SDK Context Key SUPPRESS_TRACING"
@@ -2111,9 +2746,77 @@ function asNumber(val) {
   return Number.isFinite(n) ? n : void 0;
 }
 
+// package.json
+var package_default = {
+  name: "@raindrop-ai/deep-agents",
+  version: "0.1.2",
+  description: "Raindrop integration for LangChain Deep Agents",
+  main: "dist/index.js",
+  module: "dist/index.mjs",
+  types: "dist/index.d.ts",
+  license: "MIT",
+  homepage: "https://www.raindrop.ai/docs/integrations/deepagents/",
+  bugs: {
+    url: "https://www.raindrop.ai/docs/support/"
+  },
+  exports: {
+    ".": {
+      types: "./dist/index.d.ts",
+      import: "./dist/index.mjs",
+      require: "./dist/index.js"
+    }
+  },
+  sideEffects: false,
+  files: [
+    "dist/**"
+  ],
+  scripts: {
+    build: "tsup",
+    dev: "tsup --watch",
+    clean: "rm -rf dist",
+    test: "vitest run"
+  },
+  peerDependencies: {
+    "@langchain/core": ">=0.3.0",
+    deepagents: ">=0.5.0"
+  },
+  devDependencies: {
+    "@langchain/anthropic": "~0.3.34",
+    "@langchain/core": ">=0.3.0",
+    "@langchain/openai": "~0.3.17",
+    "@raindrop-ai/core": "workspace:*",
+    "@types/node": "^20.11.17",
+    deepagents: "1.0.0",
+    msw: "^2.12.7",
+    tsup: "^8.4.0",
+    typescript: "^5.3.3",
+    vitest: "^2.1.9",
+    zod: "^3.23.0"
+  },
+  tsup: {
+    entry: [
+      "src/index.ts"
+    ],
+    format: [
+      "cjs",
+      "esm"
+    ],
+    dts: {
+      resolve: true
+    },
+    clean: true,
+    noExternal: [
+      "@raindrop-ai/core"
+    ]
+  },
+  publishConfig: {
+    access: "public"
+  }
+};
+
 // src/version.ts
-var libraryName = "@raindrop-ai/deep-agents";
-var libraryVersion = "0.0.1";
+var libraryName = package_default.name;
+var libraryVersion = package_default.version;
 
 // src/index.ts
 function createRaindropDeepAgents(opts) {
@@ -2124,7 +2827,8 @@ function createRaindropDeepAgents(opts) {
       "[raindrop-ai/deep-agents] writeKey not provided; telemetry shipping is disabled"
     );
   }
-  const eventShipper = new EventShipper({
+  const appGitContext = createAppGitContext2(writeKey?.trim() ? opts.appGit : false, { allowLocalGit: true });
+  const eventShipper = new EventShipper2({
     writeKey,
     endpoint: opts.endpoint,
     enabled,
@@ -2132,9 +2836,10 @@ function createRaindropDeepAgents(opts) {
     projectId: opts.projectId,
     sdkName: "deep-agents",
     libraryName,
-    libraryVersion
+    libraryVersion,
+    appGitContext
   });
-  const traceShipper = new TraceShipper({
+  const traceShipper = new TraceShipper2({
     writeKey,
     endpoint: opts.endpoint,
     enabled,
@@ -2142,7 +2847,8 @@ function createRaindropDeepAgents(opts) {
     projectId: opts.projectId,
     sdkName: "deep-agents",
     serviceName: "raindrop.deep-agents",
-    serviceVersion: libraryVersion
+    serviceVersion: libraryVersion,
+    appGitContext
   });
   const handler = new RaindropDeepAgentsHandler({
     eventShipper,
@@ -2162,7 +2868,14 @@ function createRaindropDeepAgents(opts) {
       await Promise.all([eventShipper.flush(), traceShipper.flush()]);
     },
     async shutdown() {
-      await Promise.all([eventShipper.shutdown(), traceShipper.shutdown()]);
+      try {
+        await Promise.all([eventShipper.shutdown(), traceShipper.shutdown()]);
+      } finally {
+        try {
+          appGitContext.dispose();
+        } catch {
+        }
+      }
     },
     events: {
       async patch(eventId, patch) {