@automagik/omni 2.260906.2 → 2.260906.4

package/dist/server/index.js

@@ -207,6 +207,19 @@ var init_types2 = __esm(() => {
     "flow.data_exchange"
   ];
 });
+// ../core/src/events/causality.ts
+import { AsyncLocalStorage } from "async_hooks";
+function runWithEventCausality(context2, fn) {
+  return storage.run(context2, fn);
+}
+function currentEventCausality() {
+  return storage.getStore();
+}
+var storage;
+var init_causality = __esm(() => {
+  storage = new AsyncLocalStorage;
+});
+
 // ../core/src/events/envelope.ts
 function classifyEnvelope(metadata) {
   if (metadata === null || metadata === undefined)
@@ -18232,6 +18245,38 @@ var init_logger = __esm(() => {
   rootLogger = createLogger("system");
 });
 
+// ../core/src/events/factory.ts
+function createOmniEvent(type, payload, metadata, serviceName) {
+  const eventId = crypto.randomUUID();
+  const timestamp = Date.now();
+  const tenantId = resolvePublishTenantId(metadata?.tenantId, metadata?.instanceId);
+  const ambient = currentEventCausality();
+  const causationId = metadata?.causationId ?? ambient?.causationId;
+  return {
+    id: eventId,
+    type,
+    payload,
+    timestamp,
+    metadata: {
+      correlationId: metadata?.correlationId ?? ambient?.correlationId ?? eventId,
+      ...causationId ? { causationId } : {},
+      instanceId: metadata?.instanceId,
+      channelType: metadata?.channelType,
+      personId: metadata?.personId,
+      platformIdentityId: metadata?.platformIdentityId,
+      traceId: metadata?.traceId ?? eventId,
+      source: metadata?.source ?? serviceName,
+      ingestMode: metadata?.ingestMode,
+      timings: metadata?.timings,
+      ...tenantId ? { envelopeVersion: CURRENT_ENVELOPE_VERSION, tenantId } : {}
+    }
+  };
+}
+var init_factory = __esm(() => {
+  init_causality();
+  init_envelope();
+});
+
 // ../core/src/events/nats/streams.ts
 function getStreamForEventType(eventType) {
   const prefix = eventType.split(".")[0] ?? "";
@@ -22567,7 +22612,24 @@ var init_registry = __esm(() => {
       component: exports_external.string(),
       reason: exports_external.string(),
       severity: exports_external.enum(["warning", "critical"])
-    }), { description: "System health degradation detected" })
+    }), { description: "System health degradation detected" }),
+    connectorStalled: createEventSchema("system.connector.stalled", exports_external.object({
+      sourceId: exports_external.string(),
+      sourceName: exports_external.string(),
+      expectedIntervalSeconds: exports_external.number(),
+      lastReceivedAt: exports_external.number().nullable(),
+      lastHeartbeatAt: exports_external.number().nullable(),
+      silentForSeconds: exports_external.number(),
+      stalledAt: exports_external.number()
+    }), { description: "A supervised connector went silent beyond its declared cadence" }),
+    connectorRecovered: createEventSchema("system.connector.recovered", exports_external.object({
+      sourceId: exports_external.string(),
+      sourceName: exports_external.string(),
+      expectedIntervalSeconds: exports_external.number(),
+      stalledForSeconds: exports_external.number(),
+      recoveredBy: exports_external.enum(["event", "heartbeat", "rearmed"]),
+      recoveredAt: exports_external.number()
+    }), { description: "A stalled connector signalled again (event, heartbeat, or re-declared cadence)" })
   };
   CustomEventSchemas = {
     chatUnreadUpdated: createEventSchema("custom.chat.unread-updated", exports_external.object({
@@ -22987,27 +23049,8 @@ class NatsEventBus {
   }
   async publishInternal(type, payload, metadata) {
     await this.ensureConnected();
-    const eventId = crypto.randomUUID();
-    const timestamp = Date.now();
-    const tenantId = resolvePublishTenantId(metadata?.tenantId, metadata?.instanceId);
-    const event = {
-      id: eventId,
-      type,
-      payload,
-      timestamp,
-      metadata: {
-        correlationId: metadata?.correlationId ?? eventId,
-        instanceId: metadata?.instanceId,
-        channelType: metadata?.channelType,
-        personId: metadata?.personId,
-        platformIdentityId: metadata?.platformIdentityId,
-        traceId: metadata?.traceId ?? eventId,
-        source: metadata?.source ?? this.config.serviceName,
-        ingestMode: metadata?.ingestMode,
-        timings: metadata?.timings,
-        ...tenantId ? { envelopeVersion: CURRENT_ENVELOPE_VERSION, tenantId } : {}
-      }
-    };
+    const event = createOmniEvent(type, payload, metadata, this.config.serviceName);
+    const eventId = event.id;
     let subject;
     if (metadata?.channelType && metadata?.instanceId) {
       subject = buildSubject(type, metadata.channelType, metadata.instanceId);
@@ -23283,7 +23326,7 @@ async function connectEventBus(config2) {
 var import_api2, import_nats, log4, DEFAULTS, ENSURE_CONNECTED_WAIT_MS = 5000;
 var init_client = __esm(() => {
   init_logger();
-  init_envelope();
+  init_factory();
   init_consumer();
   init_registry();
   init_streams();
@@ -31276,6 +31319,7 @@ function estimateCompletion(progress) {
 // ../core/src/events/index.ts
 var init_events = __esm(() => {
   init_types2();
+  init_causality();
   init_envelope();
   init_nats();
   init_dead_letter();
@@ -36955,13 +36999,7 @@ function resolveFollowUpValue(trimmed, followUp) {
       return;
   }
 }
-function resolveTemplatePath(path, context2) {
-  const trimmed = path.trim();
-  if (!trimmed)
-    return;
-  const parts = trimmed.split(".");
-  const root = parts[0] ?? "";
-  const rest = parts.slice(1).join(".");
+function resolveSpecialValue(trimmed, root, rest, context2) {
   if (context2.debounce) {
     const debounceValue = resolveDebounceValue(trimmed, rest, context2.debounce);
     if (debounceValue !== undefined)
@@ -36972,6 +37010,21 @@ function resolveTemplatePath(path, context2) {
     if (followUpValue !== undefined)
       return followUpValue;
   }
+  if (root === "event" && context2.event) {
+    return rest ? getNestedValue(context2.event, rest) : context2.event;
+  }
+  return;
+}
+function resolveTemplatePath(path, context2) {
+  const trimmed = path.trim();
+  if (!trimmed)
+    return;
+  const parts = trimmed.split(".");
+  const root = parts[0] ?? "";
+  const rest = parts.slice(1).join(".");
+  const specialValue = resolveSpecialValue(trimmed, root, rest, context2);
+  if (specialValue !== undefined)
+    return specialValue;
   if (root === "payload")
     return rest ? getNestedValue(context2.payload, rest) : context2.payload;
   if (root === "env")
@@ -37053,7 +37106,9 @@ function createTemplateContext(payload, options = {}) {
     variables: options.variables ?? {},
     env: process.env,
     debounce: options.debounce,
-    followUp
+    followUp,
+    event: options.event,
+    automation: options.automation
   };
 }
 var TEMPLATE_REGEX;
@@ -37625,8 +37680,12 @@ var init_egress = __esm(() => {
 });
 
 // ../core/src/automations/actions.ts
-function buildWebhookHeaders(config2, context2) {
+function buildWebhookHeaders(config2, context2, actionIndex) {
   const headers = { "Content-Type": "application/json" };
+  if (context2.event) {
+    headers["X-Omni-Event-Id"] = context2.event.id;
+    headers["X-Omni-Delivery-Id"] = `${context2.event.id}:${context2.automation?.id ?? "manual"}:${actionIndex}`;
+  }
   if (config2.headers) {
     for (const [key, value] of Object.entries(config2.headers)) {
       headers[key] = substituteTemplate(value, context2);
@@ -37634,16 +37693,28 @@ function buildWebhookHeaders(config2, context2) {
   }
   return headers;
 }
+function buildDefaultWebhookBody(config2, context2) {
+  if (context2.event && config2.includeEnvelope !== false) {
+    return JSON.stringify({
+      id: context2.event.id,
+      type: context2.event.type,
+      payload: context2.payload,
+      metadata: context2.event.metadata,
+      timestamp: context2.event.timestamp
+    });
+  }
+  return JSON.stringify(context2.payload);
+}
 async function parseWebhookResponse(response) {
   const contentType = response.headers.get("content-type") ?? "";
   return contentType.includes("application/json") ? response.json() : response.text();
 }
-async function executeWebhookAction(config2, context2, _deps, trustedTenantId) {
+async function executeWebhookAction(config2, context2, _deps, trustedTenantId, actionIndex = 0) {
   try {
     const url = substituteTemplate(config2.url, context2);
     const method = config2.method ?? "POST";
-    const headers = buildWebhookHeaders(config2, context2);
-    const body = config2.bodyTemplate ? substituteTemplate(config2.bodyTemplate, context2) : JSON.stringify(context2.payload);
+    const headers = buildWebhookHeaders(config2, context2, actionIndex);
+    const body = config2.bodyTemplate ? substituteTemplate(config2.bodyTemplate, context2) : buildDefaultWebhookBody(config2, context2);
     logger2.debug(`Webhook ${method} ${url}`, { method, url, waitForResponse: config2.waitForResponse });
     const response = await brokeredFetch(url, {
       method,
@@ -37733,8 +37804,10 @@ async function executeEmitEventAction(config2, context2, deps, trustedTenantId)
       }
     }
     logger2.debug("Emitting event", { eventType });
+    const correlationId = context2.event?.metadata.correlationId ?? context2.payload.correlationId ?? undefined;
     const result = await deps.eventBus.publishGeneric(eventType, payload, {
-      correlationId: context2.payload.correlationId ?? undefined,
+      correlationId,
+      causationId: context2.event?.id,
       source: "automation",
       ...trustedTenantId ? { tenantId: trustedTenantId } : {}
     });
@@ -37827,7 +37900,12 @@ function extractAgentCallContext(config2, context2) {
       threadId,
       senderId,
       senderName,
-      messages: messagesResult
+      messages: messagesResult,
+      event: context2.event ? {
+        id: context2.event.id,
+        type: context2.event.type,
+        correlationId: context2.event.metadata.correlationId
+      } : undefined
     }
   };
 }
@@ -37868,12 +37946,12 @@ async function executeCallAgentAction(config2, context2, deps, trustedTenantId)
     return { success: false, error: errorMessage };
   }
 }
-async function executeAction(action, context2, deps, trustedTenantId) {
+async function executeAction(action, context2, deps, trustedTenantId, actionIndex = 0) {
   const start = Date.now();
   let result;
   switch (action.type) {
     case "webhook":
-      result = await executeWebhookAction(action.config, context2, deps, trustedTenantId);
+      result = await executeWebhookAction(action.config, context2, deps, trustedTenantId, actionIndex);
       break;
     case "send_message":
       result = await executeSendMessageAction(action.config, context2, deps, trustedTenantId);
@@ -37902,12 +37980,12 @@ async function executeAction(action, context2, deps, trustedTenantId) {
 async function executeActions(actions, context2, deps, trustedTenantId) {
   const results = [];
   const variables = { ...context2.variables };
-  for (const action of actions) {
+  for (const [actionIndex, action] of actions.entries()) {
     const actionContext = {
       ...context2,
       variables
     };
-    const result = await executeAction(action, actionContext, deps, trustedTenantId);
+    const result = await executeAction(action, actionContext, deps, trustedTenantId, actionIndex);
     results.push(result);
     if (action.type === "webhook" && action.config.responseAs && result.status === "success" && result.result) {
       variables[action.config.responseAs] = result.result;
@@ -38337,13 +38415,18 @@ class AutomationEngine {
       type: content?.type ?? "unknown",
       text: content?.text,
       timestamp: event.timestamp,
-      payload
+      payload,
+      eventId: event.id,
+      correlationId: event.metadata.correlationId
     };
     manager.addMessage(key, message2, from, instanceId, stamp);
   }
   async handleImmediate(automation, event) {
     const instanceId = event.metadata.instanceId ?? "global";
-    const context2 = createTemplateContext(event.payload);
+    const context2 = createTemplateContext(event.payload, {
+      event: { id: event.id, type: event.type, timestamp: event.timestamp, metadata: event.metadata },
+      automation: { id: automation.id }
+    });
     await this.queueExecution(automation, event, context2, instanceId);
   }
   setupDebounceManager(automation) {
@@ -38353,28 +38436,35 @@ class AutomationEngine {
         logger4.warn("Debounce callback fired with empty messages array", { key });
         return;
       }
-      const context2 = createTemplateContext(lastMessage.payload, {
-        debounce: {
-          messages: messages.map((m2) => ({
-            type: m2.type,
-            text: m2.text,
-            timestamp: m2.timestamp
-          })),
-          from,
-          instanceId
-        }
-      });
       const syntheticEvent = {
         id: generateId(),
         type: automation.triggerEventType,
         payload: lastMessage.payload,
         metadata: {
-          correlationId: generateId(),
+          correlationId: lastMessage.correlationId ?? generateId(),
           instanceId,
           ...stamp ? { envelopeVersion: stamp.envelopeVersion, tenantId: stamp.tenantId } : {}
         },
         timestamp: Date.now()
       };
+      const context2 = createTemplateContext(lastMessage.payload, {
+        debounce: {
+          messages: messages.map((m2) => ({
+            type: m2.type,
+            text: m2.text,
+            timestamp: m2.timestamp
+          })),
+          from,
+          instanceId
+        },
+        event: {
+          id: lastMessage.eventId ?? syntheticEvent.id,
+          type: syntheticEvent.type,
+          timestamp: syntheticEvent.timestamp,
+          metadata: syntheticEvent.metadata
+        },
+        automation: { id: automation.id }
+      });
       await this.queueExecution(automation, syntheticEvent, context2, instanceId);
     };
     const manager = new DebounceManager(automation.debounce, callback);
@@ -38462,7 +38552,10 @@ class AutomationEngine {
         await this.logExecution(result2, trustedTenantId);
         return result2;
       }
-      const actionsExecuted = await executeActions(automation.actions, context2, this.deps, trustedTenantId);
+      const actionsExecuted = await runWithEventCausality({
+        correlationId: context2.event?.metadata.correlationId ?? event.metadata.correlationId,
+        causationId: context2.event?.id ?? event.id
+      }, () => executeActions(automation.actions, context2, this.deps, trustedTenantId));
       const allSucceeded = actionsExecuted.every((a) => a.status === "success");
       const status = allSucceeded ? "success" : "failed";
       const result = {
@@ -38558,6 +38651,7 @@ function createAutomationEngine(config2) {
 }
 var logger4, QueueFullError;
 var init_engine = __esm(() => {
+  init_causality();
   init_envelope();
   init_ids();
   init_logger();
@@ -38946,6 +39040,113 @@ var init_automations = __esm(() => {
   init_sweeper();
 });
 
+// ../core/src/connectors/liveness.ts
+function latestConnectorSignal(row) {
+  let best = { at: row.createdAt, kind: "rearmed" };
+  const candidates = [
+    { at: row.livenessArmedAt, kind: "rearmed" },
+    { at: row.lastReceivedAt, kind: "event" },
+    { at: row.lastHeartbeatAt, kind: "heartbeat" }
+  ];
+  for (const candidate of candidates) {
+    if (candidate.at && candidate.at.getTime() >= best.at.getTime()) {
+      best = { at: candidate.at, kind: candidate.kind };
+    }
+  }
+  return best;
+}
+async function sweepConnectorLiveness(deps) {
+  const clock = deps.now ?? (() => new Date);
+  const now = clock();
+  const rows = await deps.repo.findSupervised();
+  const stats = { scanned: rows.length, stalled: 0, recovered: 0, errors: 0 };
+  for (const row of rows) {
+    try {
+      await processRow2(row, now, deps, stats);
+    } catch (err2) {
+      stats.errors += 1;
+      deps.logger.error("connector liveness: failed to process source", {
+        sourceId: row.id,
+        sourceName: row.name,
+        error: err2 instanceof Error ? err2.message : String(err2)
+      });
+    }
+  }
+  if (stats.stalled > 0 || stats.recovered > 0) {
+    deps.logger.info("connector liveness sweep tick", { ...stats });
+  }
+  return stats;
+}
+async function processRow2(row, now, deps, stats) {
+  const signal = latestConnectorSignal(row);
+  const silentMs = Math.max(0, now.getTime() - signal.at.getTime());
+  const overdue = silentMs > row.expectedIntervalSeconds * 1000;
+  const silentForSeconds = Math.round(silentMs / 1000);
+  if (overdue) {
+    if (row.livenessStatus === "stalled")
+      return;
+    if (!await deps.repo.markStalled(row.id, now))
+      return;
+    const payload = {
+      sourceId: row.id,
+      sourceName: row.name,
+      expectedIntervalSeconds: row.expectedIntervalSeconds,
+      lastReceivedAt: row.lastReceivedAt?.getTime() ?? null,
+      lastHeartbeatAt: row.lastHeartbeatAt?.getTime() ?? null,
+      silentForSeconds,
+      stalledAt: now.getTime()
+    };
+    const eventId = await publishTransition(deps, "system.connector.stalled", { ...payload }, row);
+    stats.stalled += 1;
+    await runHook(deps.logger, "onStalled", row, () => deps.onStalled?.(row, payload, eventId));
+    return;
+  }
+  if (row.livenessStatus === "stalled") {
+    if (!await deps.repo.markRecovered(row.id, now))
+      return;
+    const stalledSince = row.stalledAt ?? signal.at;
+    const payload = {
+      sourceId: row.id,
+      sourceName: row.name,
+      expectedIntervalSeconds: row.expectedIntervalSeconds,
+      stalledForSeconds: Math.max(0, Math.round((now.getTime() - stalledSince.getTime()) / 1000)),
+      recoveredBy: signal.kind,
+      recoveredAt: now.getTime()
+    };
+    await publishTransition(deps, "system.connector.recovered", { ...payload }, row);
+    stats.recovered += 1;
+    await runHook(deps.logger, "onRecovered", row, () => deps.onRecovered?.(row, payload));
+  }
+}
+async function publishTransition(deps, type, payload, row) {
+  if (!deps.eventBus) {
+    deps.logger.warn("connector liveness: no event bus, transition persisted without event", {
+      type,
+      sourceName: row.name
+    });
+    return null;
+  }
+  const result = await deps.eventBus.publishGeneric(type, payload, {
+    source: "connector-liveness",
+    ...row.tenantId ? { tenantId: row.tenantId } : {}
+  });
+  return result.id;
+}
+async function runHook(logger5, name, row, hook) {
+  try {
+    await hook();
+  } catch (err2) {
+    logger5.error(`connector liveness: ${name} hook failed`, {
+      sourceId: row.id,
+      sourceName: row.name,
+      error: err2 instanceof Error ? err2.message : String(err2)
+    });
+  }
+}
+
+// ../core/src/connectors/index.ts
+var init_connectors = () => {};
+
 // ../core/src/sessions/reset.ts
 class InMemorySessionActivityStore {
   activities = new Map;
@@ -42989,7 +43190,7 @@ function isProviderSchemaSupported(schema) {
 function getSupportedProviderSchemas() {
   return ["agno", "webhook", "openclaw", "claude-code", "ag-ui", "a2a", "nats-genie"];
 }
-var init_factory = __esm(() => {
+var init_factory2 = __esm(() => {
   init_a2a_client();
   init_ag_ui_client();
   init_agno_client();
@@ -43009,7 +43210,7 @@ var init_providers = __esm(() => {
   init_ag_ui_provider();
   init_a2a_provider();
   init_nats_genie_provider();
-  init_factory();
+  init_factory2();
 });
 
 // ../core/src/cache/types.ts
@@ -43678,6 +43879,7 @@ __export(exports_src, {
   tenantLabelBucketCount: () => tenantLabelBucketCount,
   tenantEventsProcessed: () => tenantEventsProcessed,
   sweepFollowUps: () => sweepFollowUps,
+  sweepConnectorLiveness: () => sweepConnectorLiveness,
   substituteTemplateObject: () => substituteTemplateObject,
   substituteTemplate: () => substituteTemplate,
   stampsEqual: () => stampsEqual,
@@ -43692,6 +43894,7 @@ __export(exports_src, {
   scheduledJobRuns: () => scheduledJobRuns,
   scheduledJobNextRun: () => scheduledJobNextRun,
   scheduledJobDuration: () => scheduledJobDuration,
+  runWithEventCausality: () => runWithEventCausality,
   rootLogger: () => rootLogger,
   resolveResetConfig: () => resolveResetConfig,
   resolvePublishTenantId: () => resolvePublishTenantId,
@@ -43740,6 +43943,7 @@ __export(exports_src, {
   natsConnectionStatus: () => natsConnectionStatus,
   matchesPattern: () => matchesPattern,
   markdownToWhatsApp: () => markdownToWhatsApp,
+  latestConnectorSignal: () => latestConnectorSignal,
   jsonEquals: () => jsonEquals,
   isValidUuid: () => isValidUuid,
   isValidJsonSchema: () => isValidJsonSchema,
@@ -43803,6 +44007,7 @@ __export(exports_src, {
   dbQueries: () => dbQueries,
   dbPoolSize: () => dbPoolSize,
   dbErrors: () => dbErrors,
+  currentEventCausality: () => currentEventCausality,
   createValidatedSubscription: () => createValidatedSubscription,
   createTemplateContext: () => createTemplateContext,
   createSubscription: () => createSubscription,
@@ -44065,6 +44270,7 @@ var init_src = __esm(() => {
   init_observability();
   init_secrets();
   init_automations();
+  init_connectors();
   init_reset();
   init_providers();
   init_cache();
@@ -138899,9 +139105,9 @@ var require_session = __commonJS((exports) => {
     return options.type === "multi" ? strictMultiSession(options) : strictSingleSession(options);
   }
   function strictSingleSession(options) {
-    const { initial, storage, getSessionKey, custom: custom2 } = fillDefaults(options);
+    const { initial, storage: storage2, getSessionKey, custom: custom2 } = fillDefaults(options);
     return async (ctx, next) => {
-      const propSession = new PropertySession(storage, ctx, "session", initial);
+      const propSession = new PropertySession(storage2, ctx, "session", initial);
       const key = await getSessionKey(ctx);
       await propSession.init(key, { custom: custom2, lazy: false });
       await next();
@@ -138914,8 +139120,8 @@ var require_session = __commonJS((exports) => {
     return async (ctx, next) => {
       ctx.session = {};
       const propSessions = await Promise.all(props.map(async (prop) => {
-        const { initial, storage, getSessionKey, custom: custom2 } = defaults[prop];
-        const s = new PropertySession(storage, ctx.session, prop, initial);
+        const { initial, storage: storage2, getSessionKey, custom: custom2 } = defaults[prop];
+        const s = new PropertySession(storage2, ctx.session, prop, initial);
         const key = await getSessionKey(ctx);
         await s.init(key, { custom: custom2, lazy: false });
         return s;
@@ -138930,9 +139136,9 @@ var require_session = __commonJS((exports) => {
     if (options.type !== undefined && options.type !== "single") {
       throw new Error("Cannot use lazy multi sessions!");
     }
-    const { initial, storage, getSessionKey, custom: custom2 } = fillDefaults(options);
+    const { initial, storage: storage2, getSessionKey, custom: custom2 } = fillDefaults(options);
     return async (ctx, next) => {
-      const propSession = new PropertySession(storage, ctx, "session", initial);
+      const propSession = new PropertySession(storage2, ctx, "session", initial);
       const key = await getSessionKey(ctx);
       await propSession.init(key, { custom: custom2, lazy: true });
       await next();
@@ -138941,8 +139147,8 @@ var require_session = __commonJS((exports) => {
   }
 
   class PropertySession {
-    constructor(storage, obj, prop, initial) {
-      this.storage = storage;
+    constructor(storage2, obj, prop, initial) {
+      this.storage = storage2;
       this.obj = obj;
       this.prop = prop;
       this.initial = initial;
@@ -139025,15 +139231,15 @@ var require_session = __commonJS((exports) => {
     }
   }
   function fillDefaults(opts = {}) {
-    let { prefix = "", getSessionKey = defaultGetSessionKey, initial, storage } = opts;
-    if (storage == null) {
+    let { prefix = "", getSessionKey = defaultGetSessionKey, initial, storage: storage2 } = opts;
+    if (storage2 == null) {
       debug2("Storing session data in memory, all data will be lost when the bot restarts.");
-      storage = new MemorySessionStorage;
+      storage2 = new MemorySessionStorage;
     }
     const custom2 = getSessionKey !== defaultGetSessionKey;
     return {
       initial,
-      storage,
+      storage: storage2,
       getSessionKey: async (ctx) => {
         const key = await getSessionKey(ctx);
         return key === undefined ? undefined : prefix + key;
@@ -139054,30 +139260,30 @@ var require_session = __commonJS((exports) => {
     return value === undefined || typeof value === "object" && value !== null && "__d" in value;
   }
   function enhanceStorage(options) {
-    let { storage, millisecondsToLive, migrations } = options;
-    storage = compatStorage(storage);
+    let { storage: storage2, millisecondsToLive, migrations } = options;
+    storage2 = compatStorage(storage2);
     if (millisecondsToLive !== undefined) {
-      storage = timeoutStorage(storage, millisecondsToLive);
+      storage2 = timeoutStorage(storage2, millisecondsToLive);
     }
     if (migrations !== undefined) {
-      storage = migrationStorage(storage, migrations);
+      storage2 = migrationStorage(storage2, migrations);
     }
-    return wrapStorage(storage);
+    return wrapStorage(storage2);
   }
-  function compatStorage(storage) {
+  function compatStorage(storage2) {
     return {
       read: async (k2) => {
-        const v2 = await storage.read(k2);
+        const v2 = await storage2.read(k2);
         return isEnhance(v2) ? v2 : { __d: v2 };
       },
-      write: (k2, v2) => storage.write(k2, v2),
-      delete: (k2) => storage.delete(k2)
+      write: (k2, v2) => storage2.write(k2, v2),
+      delete: (k2) => storage2.delete(k2)
     };
   }
-  function timeoutStorage(storage, millisecondsToLive) {
+  function timeoutStorage(storage2, millisecondsToLive) {
     const ttlStorage = {
       read: async (k2) => {
-        const value = await storage.read(k2);
+        const value = await storage2.read(k2);
         if (value === undefined)
           return;
         if (value.e === undefined) {
@@ -139092,13 +139298,13 @@ var require_session = __commonJS((exports) => {
       },
       write: async (k2, v2) => {
         v2.e = addExpiryDate(v2, millisecondsToLive).expires;
-        await storage.write(k2, v2);
+        await storage2.write(k2, v2);
       },
-      delete: (k2) => storage.delete(k2)
+      delete: (k2) => storage2.delete(k2)
     };
     return ttlStorage;
   }
-  function migrationStorage(storage, migrations) {
+  function migrationStorage(storage2, migrations) {
     const versions = Object.keys(migrations).map((v2) => parseInt(v2)).sort((a, b2) => a - b2);
     const count = versions.length;
     if (count === 0)
@@ -139117,7 +139323,7 @@ var require_session = __commonJS((exports) => {
     return {
       read: async (k2) => {
         var _a;
-        const val = await storage.read(k2);
+        const val = await storage2.read(k2);
         if (val === undefined)
           return val;
         let { __d: value, v: current = earliest - 1 } = val;
@@ -139126,15 +139332,15 @@ var require_session = __commonJS((exports) => {
           value = migrations[versions[i]](value);
         return { ...val, v: latest, __d: value };
       },
-      write: (k2, v2) => storage.write(k2, { v: latest, ...v2 }),
-      delete: (k2) => storage.delete(k2)
+      write: (k2, v2) => storage2.write(k2, { v: latest, ...v2 }),
+      delete: (k2) => storage2.delete(k2)
     };
   }
-  function wrapStorage(storage) {
+  function wrapStorage(storage2) {
     return {
-      read: (k2) => Promise.resolve(storage.read(k2)).then((v2) => v2 === null || v2 === undefined ? undefined : v2.__d),
-      write: (k2, v2) => storage.write(k2, { __d: v2 }),
-      delete: (k2) => storage.delete(k2)
+      read: (k2) => Promise.resolve(storage2.read(k2)).then((v2) => v2 === null || v2 === undefined ? undefined : v2.__d),
+      write: (k2, v2) => storage2.write(k2, { __d: v2 }),
+      delete: (k2) => storage2.delete(k2)
     };
   }
 
@@ -143264,9 +143470,9 @@ var require_session_builder = __commonJS((exports, module) => {
   var queueJob = require_queue_job();
 
   class SessionBuilder {
-    constructor(storage, protocolAddress) {
+    constructor(storage2, protocolAddress) {
       this.addr = protocolAddress;
-      this.storage = storage;
+      this.storage = storage2;
     }
     async initOutgoing(device) {
       const fqAddr = this.addr.toString();
@@ -144712,12 +144918,12 @@ var require_session_cipher = __commonJS((exports, module) => {
   }
 
   class SessionCipher {
-    constructor(storage, protocolAddress) {
+    constructor(storage2, protocolAddress) {
       if (!(protocolAddress instanceof ProtocolAddress)) {
         throw new TypeError("protocolAddress must be a ProtocolAddress");
       }
       this.addr = protocolAddress;
-      this.storage = storage;
+      this.storage = storage2;
     }
     _encodeTupleByte(number1, number2) {
       if (number1 > 15 || number2 > 15) {
@@ -172164,6 +172370,9 @@ __export(exports_schema, {
   conversations: () => conversations,
   contentTypes: () => contentTypes,
   consumerOffsets: () => consumerOffsets,
+  connectorWindowSemanticsValues: () => connectorWindowSemanticsValues,
+  connectorMutationPolicies: () => connectorMutationPolicies,
+  connectorLivenessStatuses: () => connectorLivenessStatuses,
   conditionOperators: () => conditionOperators,
   closeContactOutcomes: () => closeContactOutcomes,
   closeContactLogs: () => closeContactLogs,
@@ -172212,7 +172421,7 @@ __export(exports_schema, {
   accessRules: () => accessRules,
   accessModes: () => accessModes
 });
-var channelTypes, agentTypes, agentSystems, agentEntityTypes, debounceMode, splitDelayMode, supersedeMode, replyFilterMode, agentSessionStrategies, ruleTypes, accessModes, settingValueTypes, apiKeyStatuses, apiKeyProfiles, eventTypes, contentTypes, chatTypes, messageSources, messageTypes, messageStatuses, deliveryStatuses, scheduledMessageDeliveryModes, scheduledMessageStatuses, jobStatuses, providerSchemas, agentProviders, agents, agentRoutes, agentSessions, apiKeys, apiKeyAuditLogs, apiKeysRelations, apiKeyAuditLogsRelations, instances, whatsappTemplates, whatsappFlowKeys, scheduledMessages, persons, platformIdentities, conversations, chats, chatParticipants, omniGroups, messages2, omniEvents, handoffLogs, closeContactOutcomes, closeContactLogs, accessRules, globalSettings, settingChangeHistory, batchJobs, syncJobTypes, syncJobs, mediaContent, chatIdMappings, pluginStorage, agentProvidersRelations, agentsRelations, instancesRelations, syncJobsRelations, personsRelations, platformIdentitiesRelations, conversationsRelations, chatsRelations, chatParticipantsRelations, messagesRelations, omniEventsRelations, accessRulesRelations, globalSettingsRelations, settingChangeHistoryRelations, batchJobsRelations, mediaContentRelations, chatIdMappingsRelations, deadLetterStatuses, deadLetterEvents, payloadStorageConfig, payloadStages, eventPayloads, webhookSignatureAlgorithms, webhookSources, eventSchemas, conditionOperators, actionTypes, automationDebounceModes, automations2, automationLogStatuses, automationLogs, consumerOffsets, automationsRelations, automationLogsRelations, triggerLogs, triggerLogsRelations, agentRoutesRelations, agentTaskStatuses, agentTasks, agentTasksRelations, turnStatuses, turnActions, turns, turnsRelations, followUpDisarmReasons, chatFollowUpState, chatFollowUpStateRelations, processedEvents, genieHosts, tenantStatuses, principalTypes, principalStatuses, tenantRoles, membershipStatuses, credentialClasses, authCredentialStatuses, platformApiKeyStatuses, tenants, principals, tenantMemberships, tenantRolePolicies, platformApiKeys, tenantKeyLineage, authCredentials, tenantAuditLogs, platformAuditLogs, platformProviderCatalog, tenantProviderConfig, platformSettings, tenantSettings, platformSettingChangeHistory, tenantSettingChangeHistory, platformPluginStorage, tenantPluginStorage, platformPayloadStorageConfig, tenantPayloadStorageOverrides, tenantMigrationLedger, tenantMigrationLedgerHistory;
+var channelTypes, agentTypes, agentSystems, agentEntityTypes, debounceMode, splitDelayMode, supersedeMode, replyFilterMode, agentSessionStrategies, ruleTypes, accessModes, settingValueTypes, apiKeyStatuses, apiKeyProfiles, eventTypes, contentTypes, chatTypes, messageSources, messageTypes, messageStatuses, deliveryStatuses, scheduledMessageDeliveryModes, scheduledMessageStatuses, jobStatuses, providerSchemas, agentProviders, agents, agentRoutes, agentSessions, apiKeys, apiKeyAuditLogs, apiKeysRelations, apiKeyAuditLogsRelations, instances, whatsappTemplates, whatsappFlowKeys, scheduledMessages, persons, platformIdentities, conversations, chats, chatParticipants, omniGroups, messages2, omniEvents, handoffLogs, closeContactOutcomes, closeContactLogs, accessRules, globalSettings, settingChangeHistory, batchJobs, syncJobTypes, syncJobs, mediaContent, chatIdMappings, pluginStorage, agentProvidersRelations, agentsRelations, instancesRelations, syncJobsRelations, personsRelations, platformIdentitiesRelations, conversationsRelations, chatsRelations, chatParticipantsRelations, messagesRelations, omniEventsRelations, accessRulesRelations, globalSettingsRelations, settingChangeHistoryRelations, batchJobsRelations, mediaContentRelations, chatIdMappingsRelations, deadLetterStatuses, deadLetterEvents, payloadStorageConfig, payloadStages, eventPayloads, webhookSignatureAlgorithms, connectorLivenessStatuses, connectorWindowSemanticsValues, connectorMutationPolicies, webhookSources, eventSchemas, conditionOperators, actionTypes, automationDebounceModes, automations2, automationLogStatuses, automationLogs, consumerOffsets, automationsRelations, automationLogsRelations, triggerLogs, triggerLogsRelations, agentRoutesRelations, agentTaskStatuses, agentTasks, agentTasksRelations, turnStatuses, turnActions, turns, turnsRelations, followUpDisarmReasons, chatFollowUpState, chatFollowUpStateRelations, processedEvents, genieHosts, tenantStatuses, principalTypes, principalStatuses, tenantRoles, membershipStatuses, credentialClasses, authCredentialStatuses, platformApiKeyStatuses, tenants, principals, tenantMemberships, tenantRolePolicies, platformApiKeys, tenantKeyLineage, authCredentials, tenantAuditLogs, platformAuditLogs, platformProviderCatalog, tenantProviderConfig, platformSettings, tenantSettings, platformSettingChangeHistory, tenantSettingChangeHistory, platformPluginStorage, tenantPluginStorage, platformPayloadStorageConfig, tenantPayloadStorageOverrides, tenantMigrationLedger, tenantMigrationLedgerHistory;
 var init_schema2 = __esm(() => {
   init_events();
   init_types5();
@@ -172944,9 +173153,11 @@ var init_schema2 = __esm(() => {
     agentRequest: jsonb("agent_request").$type(),
     agentResponse: jsonb("agent_response").$type(),
     metadata: jsonb("metadata").$type(),
+    causationId: uuid("causation_id"),
     createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
     tenantId: uuid("tenant_id").references(() => tenants.id, { onDelete: "restrict" })
   }, (table3) => ({
+    causationIdx: index("omni_events_causation_idx").on(table3.causationId),
     tenantIdx: index("omni_events_tenant_idx").on(table3.tenantId),
     tenantIdUq: uniqueIndex("omni_events_tenant_id_uq").on(table3.tenantId, table3.id),
     externalIdIdx: index("omni_events_external_id_idx").on(table3.externalId),
@@ -173425,6 +173636,9 @@ var init_schema2 = __esm(() => {
     eventStageIdx: index("event_payloads_event_stage_idx").on(table3.eventId, table3.stage)
   }));
   webhookSignatureAlgorithms = ["hmac-sha256", "hmac-sha1", "token-match"];
+  connectorLivenessStatuses = ["healthy", "stalled"];
+  connectorWindowSemanticsValues = ["future_only", "includes_in_progress"];
+  connectorMutationPolicies = ["same_id", "new_id"];
   webhookSources = pgTable("webhook_sources", {
     id: uuid("id").primaryKey().defaultRandom(),
     name: varchar("name", { length: 100 }).notNull().unique(),
@@ -173436,6 +173650,14 @@ var init_schema2 = __esm(() => {
     enabled: boolean2("enabled").notNull().default(true),
     lastReceivedAt: timestamp("last_received_at", { withTimezone: true }),
     totalReceived: integer("total_received").notNull().default(0),
+    expectedIntervalSeconds: integer("expected_interval_seconds"),
+    lastHeartbeatAt: timestamp("last_heartbeat_at", { withTimezone: true }),
+    heartbeatCount: integer("heartbeat_count").notNull().default(0),
+    livenessStatus: varchar("liveness_status", { length: 20 }).$type(),
+    livenessArmedAt: timestamp("liveness_armed_at", { withTimezone: true }),
+    stalledAt: timestamp("stalled_at", { withTimezone: true }),
+    windowSemantics: varchar("window_semantics", { length: 40 }).$type(),
+    mutationPolicy: varchar("mutation_policy", { length: 20 }).$type(),
     createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
     updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow(),
     tenantId: uuid("tenant_id").references(() => tenants.id, { onDelete: "restrict" })
@@ -173443,7 +173665,8 @@ var init_schema2 = __esm(() => {
     tenantIdx: index("webhook_sources_tenant_idx").on(table3.tenantId),
     tenantNameUq: uniqueIndex("webhook_sources_tenant_name_uq").on(table3.tenantId, table3.name).where(sql`${table3.tenantId} IS NOT NULL`),
     nameIdx: uniqueIndex("webhook_sources_name_idx").on(table3.name),
-    enabledIdx: index("webhook_sources_enabled_idx").on(table3.enabled)
+    enabledIdx: index("webhook_sources_enabled_idx").on(table3.enabled),
+    supervisedIdx: index("webhook_sources_supervised_idx").on(table3.enabled).where(sql`${table3.expectedIntervalSeconds} IS NOT NULL`)
   }));
   eventSchemas = pgTable("event_schemas", {
     id: uuid("id").primaryKey().defaultRandom(),
@@ -177895,6 +178118,9 @@ __export(exports_src3, {
   conversations: () => conversations,
   contentTypes: () => contentTypes,
   consumerOffsets: () => consumerOffsets,
+  connectorWindowSemanticsValues: () => connectorWindowSemanticsValues,
+  connectorMutationPolicies: () => connectorMutationPolicies,
+  connectorLivenessStatuses: () => connectorLivenessStatuses,
   conditionOperators: () => conditionOperators,
   closeDb: () => closeDb,
   closeContactOutcomes: () => closeContactOutcomes,
@@ -179690,11 +179916,11 @@ function isTerminal(state) {
 class A2ATaskStore {
   memory = new Map;
   storage;
-  constructor(storage) {
-    this.storage = storage;
+  constructor(storage2) {
+    this.storage = storage2;
   }
-  setStorage(storage) {
-    this.storage = storage;
+  setStorage(storage2) {
+    this.storage = storage2;
   }
   async createTask(params) {
     const now = new Date().toISOString();
@@ -201742,12 +201968,12 @@ var init_resource_Bhpm2sLf = __esm(() => {
 });
 
 // ../../node_modules/.bun/@sentry+opentelemetry@10.52.0+54dbe0b6443040f8/node_modules/@sentry/opentelemetry/build/esm/index.js
-import { AsyncLocalStorage as AsyncLocalStorage2 } from "async_hooks";
+import { AsyncLocalStorage as AsyncLocalStorage3 } from "async_hooks";
 import { EventEmitter as EventEmitter4 } from "events";
 
 class SentryAsyncLocalStorageContextManager {
   __init() {
-    this._asyncLocalStorage = new AsyncLocalStorage2;
+    this._asyncLocalStorage = new AsyncLocalStorage3;
   }
   __init2() {
     this._kOtListeners = Symbol("OtListeners");
@@ -250680,7 +250906,7 @@ var init_sentry_scrub = __esm(() => {
 var require_package7 = __commonJS((exports, module) => {
   module.exports = {
     name: "@omni/api",
-    version: "2.260906.2",
+    version: "2.260906.4",
     private: true,
     type: "module",
     exports: {
@@ -257665,23 +257891,23 @@ var require_Meter = __commonJS((exports) => {
     }
     createGauge(name, options) {
       const descriptor = (0, InstrumentDescriptor_1.createInstrumentDescriptor)(name, InstrumentDescriptor_1.InstrumentType.GAUGE, options);
-      const storage = this._meterSharedState.registerMetricStorage(descriptor);
-      return new Instruments_1.GaugeInstrument(storage, descriptor);
+      const storage2 = this._meterSharedState.registerMetricStorage(descriptor);
+      return new Instruments_1.GaugeInstrument(storage2, descriptor);
     }
     createHistogram(name, options) {
       const descriptor = (0, InstrumentDescriptor_1.createInstrumentDescriptor)(name, InstrumentDescriptor_1.InstrumentType.HISTOGRAM, options);
-      const storage = this._meterSharedState.registerMetricStorage(descriptor);
-      return new Instruments_1.HistogramInstrument(storage, descriptor);
+      const storage2 = this._meterSharedState.registerMetricStorage(descriptor);
+      return new Instruments_1.HistogramInstrument(storage2, descriptor);
     }
     createCounter(name, options) {
       const descriptor = (0, InstrumentDescriptor_1.createInstrumentDescriptor)(name, InstrumentDescriptor_1.InstrumentType.COUNTER, options);
-      const storage = this._meterSharedState.registerMetricStorage(descriptor);
-      return new Instruments_1.CounterInstrument(storage, descriptor);
+      const storage2 = this._meterSharedState.registerMetricStorage(descriptor);
+      return new Instruments_1.CounterInstrument(storage2, descriptor);
     }
     createUpDownCounter(name, options) {
       const descriptor = (0, InstrumentDescriptor_1.createInstrumentDescriptor)(name, InstrumentDescriptor_1.InstrumentType.UP_DOWN_COUNTER, options);
-      const storage = this._meterSharedState.registerMetricStorage(descriptor);
-      return new Instruments_1.UpDownCounterInstrument(storage, descriptor);
+      const storage2 = this._meterSharedState.registerMetricStorage(descriptor);
+      return new Instruments_1.UpDownCounterInstrument(storage2, descriptor);
     }
     createObservableGauge(name, options) {
       const descriptor = (0, InstrumentDescriptor_1.createInstrumentDescriptor)(name, InstrumentDescriptor_1.InstrumentType.OBSERVABLE_GAUGE, options);
@@ -258075,16 +258301,16 @@ var require_MetricStorageRegistry = __commonJS((exports) => {
       }
       return storages;
     }
-    register(storage) {
-      this._registerStorage(storage, this._sharedRegistry);
+    register(storage2) {
+      this._registerStorage(storage2, this._sharedRegistry);
     }
-    registerForCollector(collector, storage) {
+    registerForCollector(collector, storage2) {
       let storageMap = this._perCollectorRegistry.get(collector);
       if (storageMap == null) {
         storageMap = new Map;
         this._perCollectorRegistry.set(collector, storageMap);
       }
-      this._registerStorage(storage, storageMap);
+      this._registerStorage(storage2, storageMap);
     }
     findOrUpdateCompatibleStorage(expectedDescriptor) {
       const storages = this._sharedRegistry.get(expectedDescriptor.name);
@@ -258104,14 +258330,14 @@ var require_MetricStorageRegistry = __commonJS((exports) => {
       }
       return this._findOrUpdateCompatibleStorage(expectedDescriptor, storages);
     }
-    _registerStorage(storage, storageMap) {
-      const descriptor = storage.getInstrumentDescriptor();
+    _registerStorage(storage2, storageMap) {
+      const descriptor = storage2.getInstrumentDescriptor();
       const storages = storageMap.get(descriptor.name);
       if (storages === undefined) {
-        storageMap.set(descriptor.name, [storage]);
+        storageMap.set(descriptor.name, [storage2]);
         return;
       }
-      storages.push(storage);
+      storages.push(storage2);
     }
     _findOrUpdateCompatibleStorage(expectedDescriptor, existingStorages) {
       let compatibleStorage = null;
@@ -258459,9 +258685,9 @@ var require_MeterSharedState = __commonJS((exports) => {
             return compatibleStorage;
           }
           const aggregator = aggregation.createAggregator(descriptor);
-          const storage = new MetricStorageType(descriptor, aggregator, AttributesProcessor_1.AttributesProcessor.Noop(), [collector]);
-          this.metricStorageRegistry.registerForCollector(collector, storage);
-          return storage;
+          const storage2 = new MetricStorageType(descriptor, aggregator, AttributesProcessor_1.AttributesProcessor.Noop(), [collector]);
+          this.metricStorageRegistry.registerForCollector(collector, storage2);
+          return storage2;
         });
         storages = storages.concat(collectorStorages);
       }
@@ -300023,7 +300249,7 @@ var Factory = class {
     return handlers2.filter((handler) => handler !== undefined);
   };
 }, createMiddleware = (middleware) => middleware;
-var init_factory2 = __esm(() => {
+var init_factory3 = __esm(() => {
   init_hono2();
 });
 
@@ -300552,20 +300778,20 @@ var init_tenant_transaction = __esm(() => {
 });
 
 // ../api/src/tenancy/tenant-scope.ts
-import { AsyncLocalStorage as AsyncLocalStorage3 } from "async_hooks";
+import { AsyncLocalStorage as AsyncLocalStorage4 } from "async_hooks";
 function currentTenantScope() {
-  return storage.getStore() ?? null;
+  return storage2.getStore() ?? null;
 }
 function scopedHandle(db2) {
-  const scope = storage.getStore();
+  const scope = storage2.getStore();
   return scope ? scope.tx : db2;
 }
 async function runInTenantScope(db2, context20, fn) {
-  if (storage.getStore()) {
+  if (storage2.getStore()) {
     throw new Error("tenant-scope: a tenant scope is already active for this request");
   }
   const postCommit = [];
-  const result = await withTenantTransaction(db2, context20, async (tx, tenantId) => storage.run({ tx, tenantId, postCommit }, fn));
+  const result = await withTenantTransaction(db2, context20, async (tx, tenantId) => storage2.run({ tx, tenantId, postCommit }, fn));
   for (const cb of postCommit) {
     try {
       cb();
@@ -300574,7 +300800,7 @@ async function runInTenantScope(db2, context20, fn) {
   return result;
 }
 function runAfterTenantCommit(fn) {
-  const scope = storage.getStore();
+  const scope = storage2.getStore();
   if (scope) {
     scope.postCommit.push(fn);
   } else {
@@ -300582,12 +300808,12 @@ function runAfterTenantCommit(fn) {
   }
 }
 function runDetachedFromTenantScope(fn) {
-  return storage.exit(fn);
+  return storage2.exit(fn);
 }
-var storage;
+var storage2;
 var init_tenant_scope = __esm(() => {
   init_tenant_transaction();
-  storage = new AsyncLocalStorage3;
+  storage2 = new AsyncLocalStorage4;
 });
 
 // ../api/src/tenancy/auth-context.ts
@@ -300720,7 +300946,7 @@ function filterByInstanceAccess(items, getInstanceId, apiKey) {
 }
 var authMiddleware;
 var init_auth = __esm(() => {
-  init_factory2();
+  init_factory3();
   init_api_keys();
   init_tenant_scope();
   init_worker_tenant_context();
@@ -300943,7 +301169,7 @@ function pathFromRequest(url) {
 var log59, REPLAY_WINDOW_MS = 60000, ED25519_SPKI_PREFIX, HEADER_HOST_ID = "x-genie-host-id", HEADER_TIMESTAMP = "x-genie-timestamp", HEADER_SIGNATURE = "x-genie-signature", genieSignatureMiddleware;
 var init_genie_signature = __esm(() => {
   init_src();
-  init_factory2();
+  init_factory3();
   log59 = createLogger("api:genie-signature");
   ED25519_SPKI_PREFIX = Buffer.from("302a300506032b6570032100", "hex");
   genieSignatureMiddleware = createMiddleware(async (c, next) => {
@@ -301335,7 +301561,7 @@ async function emitRedactionEvents(c, apiKey, presetKey, hits) {
 var log60, SEND_ROUTE_PREFIXES, REDACTION_MARKER = "[redacted]", SECRET_REDACTED_EVENT = "secret.redacted", MAX_REDACT_BYTES, presetRegistry = null, outputRedactorMiddleware;
 var init_output_redactor = __esm(() => {
   init_src();
-  init_factory2();
+  init_factory3();
   init_profiles();
   log60 = createLogger("api:output-redactor");
   SEND_ROUTE_PREFIXES = ["/messages/send"];
@@ -301499,6 +301725,7 @@ var init_scopes = __esm(() => {
     "GET /events/timeline/:personId": "events:read",
     "POST /events/search": "events:read",
     "GET /events/:id": "events:read",
+    "GET /events/:id/trace": "events:read",
     "GET /events/by-sender/:senderId": "events:read",
     "GET /follow-up/agents/:id": "follow-up:read",
     "PUT /follow-up/agents/:id": "follow-up:write",
@@ -301898,7 +302125,7 @@ function invalidSignedHostScopeContextResponse(c, hostId) {
 var log61, OUTBOUND_SEND_PREFIXES, PATH_INSTANCE_PREFIXES, PATH_CHAT_PREFIXES, PATH_MEDIA_INSTANCE_PREFIX = "/media/", scopeEnforcerMiddleware;
 var init_scope_enforcer = __esm(() => {
   init_src();
-  init_factory2();
+  init_factory3();
   init_profiles();
   init_scopes();
   init_signed_host_scope_context();
@@ -302020,7 +302247,7 @@ async function safeReadJsonBody2(c) {
 var log62, requireSignedInstanceMiddleware;
 var init_require_signed_instance = __esm(() => {
   init_src();
-  init_factory2();
+  init_factory3();
   init_scope_enforcer();
   log62 = createLogger("api:require-signed-instance");
   requireSignedInstanceMiddleware = createMiddleware(async (c, next) => {
@@ -302317,6 +302544,7 @@ var init_route_ownership = __esm(() => {
     "GET /api/v2/events/:eventId/payloads",
     "GET /api/v2/events/:eventId/payloads/:stage",
     "GET /api/v2/events/:id",
+    "GET /api/v2/events/:id/trace",
     "GET /api/v2/events/analytics",
     "GET /api/v2/events/by-sender/:senderId",
     "GET /api/v2/events/schemas",
@@ -302543,6 +302771,7 @@ var init_route_ownership = __esm(() => {
     "POST /api/v2/voice/leave",
     "POST /api/v2/webhook-sources",
     "POST /api/v2/webhooks/:source",
+    "POST /api/v2/webhooks/:source/heartbeat",
     "PUT /api/v2/agent-state/:agentId/:chatId",
     "PUT /api/v2/follow-up/agents/:id",
     "PUT /api/v2/follow-up/chats/:id",
@@ -302727,7 +302956,7 @@ function refuseUnaddressableRoute(c) {
 }
 var TENANT_HINT_HEADER = "x-omni-tenant-id", tenancyMiddleware;
 var init_tenancy = __esm(() => {
-  init_factory2();
+  init_factory3();
   init_route();
   init_route_ownership();
   init_scope_projection();
@@ -351163,24 +351392,24 @@ class InMemoryPluginStorage {
 }
 function setStorageDatabase(db2) {
   globalDb = db2;
-  for (const [pluginId, storage2] of storageInstances.entries()) {
-    if (storage2 instanceof InMemoryPluginStorage) {
+  for (const [pluginId, storage3] of storageInstances.entries()) {
+    if (storage3 instanceof InMemoryPluginStorage) {
       storageInstances.set(pluginId, new DatabasePluginStorage(db2, pluginId));
     }
   }
 }
 function getPluginStorage(pluginId) {
-  let storage2 = storageInstances.get(pluginId);
-  if (!storage2) {
+  let storage3 = storageInstances.get(pluginId);
+  if (!storage3) {
     if (globalDb) {
-      storage2 = new DatabasePluginStorage(globalDb, pluginId);
+      storage3 = new DatabasePluginStorage(globalDb, pluginId);
     } else {
       log87.warn("Database not available, using in-memory storage", { pluginId });
-      storage2 = new InMemoryPluginStorage(pluginId);
+      storage3 = new InMemoryPluginStorage(pluginId);
     }
-    storageInstances.set(pluginId, storage2);
+    storageInstances.set(pluginId, storage3);
   }
-  return storage2;
+  return storage3;
 }
 var log87, INSTANCE_ID_IN_KEY, globalDb = null, storageInstances;
 var init_storage = __esm(() => {
@@ -355451,7 +355680,8 @@ async function setupAgentDispatcher(eventBus, services, db2) {
       tracker.recordCheckpoint(firstMsg.metadata.correlationId, "T5", JOURNEY_STAGES.T5);
     }
     queuedAck?.release();
-    await processAgentResponse(services, instance4, messages4, triggerType, db2, eventBus);
+    const lastMsg = messages4[messages4.length - 1] ?? firstMsg;
+    await runWithEventCausality({ correlationId: lastMsg.metadata.correlationId, causationId: lastMsg.metadata.eventId }, () => processAgentResponse(services, instance4, messages4, triggerType, db2, eventBus));
   };
   const debouncer = new MessageDebouncer(onDebouncedFlush, Date.now, {
     onQueuedBehindActiveRun: (info2) => void ackQueuedMessage(info2)
@@ -355488,6 +355718,7 @@ async function setupAgentDispatcher(eventBus, services, db2) {
               platformIdentityId: metadata.platformIdentityId,
               traceId,
               correlationId: metadata.correlationId,
+              eventId: event.id,
               journeyTracked: metadata.timings != null,
               resolvedInstance: resolved,
               routeId,
@@ -355519,14 +355750,14 @@ async function setupAgentDispatcher(eventBus, services, db2) {
           if (!instance4)
             return;
           const traceId = metadata.traceId ?? generateCorrelationId("trc");
-          await processReactionTrigger(services, instance4, payload, {
+          await runWithEventCausality({ correlationId: metadata.correlationId, causationId: event.id }, () => processReactionTrigger(services, instance4, payload, {
             instanceId: instance4.id,
             channelType: metadata.channelType,
             personId: metadata.personId,
             platformIdentityId: metadata.platformIdentityId,
             traceId,
             trustedTenantId: trustedDispatchTenant(metadata)
-          }, event, db2);
+          }, event, db2));
         } catch (error3) {
           log91.error("Error processing reaction for dispatch", {
             instanceId: metadata.instanceId,
@@ -355551,14 +355782,14 @@ async function setupAgentDispatcher(eventBus, services, db2) {
           if (!instance4)
             return;
           const traceId = metadata.traceId ?? generateCorrelationId("trc");
-          await processReactionTrigger(services, instance4, payload, {
+          await runWithEventCausality({ correlationId: metadata.correlationId, causationId: event.id }, () => processReactionTrigger(services, instance4, payload, {
             instanceId: instance4.id,
             channelType: metadata.channelType,
             personId: metadata.personId,
             platformIdentityId: metadata.platformIdentityId,
             traceId,
             trustedTenantId: trustedDispatchTenant(metadata)
-          }, event, db2);
+          }, event, db2));
         } catch (error3) {
           log91.error("Error processing reaction removal for dispatch", {
             instanceId: metadata.instanceId,
@@ -358067,6 +358298,9 @@ class DeadLetterService {
   }
   async create(options) {
     const insertData = prepareDeadLetterInsert(options);
+    if (options.autoRetry === false) {
+      insertData.nextAutoRetryAt = null;
+    }
     const [result] = await this.db.insert(deadLetterEvents).values(insertData).returning();
     if (!result) {
       throw new Error("Failed to create dead letter entry");
@@ -358741,6 +358975,46 @@ class EventService {
     }
     return result;
   }
+  async trace(id) {
+    const focus = await this.getById(id);
+    const seen = new Set([focus.id]);
+    const ancestors = [];
+    let current = focus;
+    let truncated = false;
+    while (current.causationId && ancestors.length < TRACE_MAX_ANCESTORS) {
+      if (seen.has(current.causationId))
+        break;
+      const [parent] = await this.db.select().from(omniEvents).where(eq(omniEvents.id, current.causationId)).limit(1);
+      if (!parent)
+        break;
+      seen.add(parent.id);
+      ancestors.unshift(parent);
+      current = parent;
+    }
+    if (current.causationId && ancestors.length >= TRACE_MAX_ANCESTORS)
+      truncated = true;
+    const descendants = [];
+    let frontier = [focus.id];
+    let depth = 0;
+    while (frontier.length > 0 && depth < TRACE_MAX_DEPTH && descendants.length < TRACE_MAX_NODES) {
+      depth++;
+      const children = await this.db.select().from(omniEvents).where(inArray(omniEvents.causationId, frontier)).orderBy(omniEvents.receivedAt).limit(TRACE_MAX_NODES + 1);
+      const fresh = children.filter((c) => !seen.has(c.id));
+      for (const child of fresh)
+        seen.add(child.id);
+      for (const child of fresh)
+        descendants.push({ event: child, depth });
+      if (descendants.length > TRACE_MAX_NODES) {
+        descendants.length = TRACE_MAX_NODES;
+        truncated = true;
+        break;
+      }
+      frontier = fresh.map((c) => c.id);
+    }
+    if (frontier.length > 0 && depth >= TRACE_MAX_DEPTH)
+      truncated = true;
+    return { event: focus, ancestors, descendants, truncated };
+  }
   async getTimeline(personId, options = {}) {
     const { channels, since, until, limit: limit2 = 50, cursor } = options;
     const conditions3 = [eq(omniEvents.personId, personId)];
@@ -358842,6 +359116,7 @@ class EventService {
     };
   }
 }
+var TRACE_MAX_ANCESTORS = 50, TRACE_MAX_DEPTH = 10, TRACE_MAX_NODES = 200;
 var init_events2 = __esm(() => {
   init_src();
   init_src5();
@@ -363201,7 +363476,10 @@ class WebhookService {
     if (data.signatureSecret && !data.signatureConfig) {
       throw new ValidationError2("signatureSecret cannot be set without a signatureConfig");
     }
-    const values2 = data.signatureSecret ? { ...data, signatureSecret: sealCredentialField(this.tenantId, data.signatureSecret) } : data;
+    let values2 = data.signatureSecret ? { ...data, signatureSecret: sealCredentialField(this.tenantId, data.signatureSecret) } : data;
+    if (values2.expectedIntervalSeconds != null) {
+      values2 = { ...values2, livenessArmedAt: new Date, livenessStatus: "healthy" };
+    }
     const [created] = await this.db.insert(webhookSources).values(values2).returning();
     if (!created) {
       throw new Error("Failed to create webhook source");
@@ -363227,12 +363505,28 @@ class WebhookService {
         patch.signatureSecret = null;
       }
     }
+    await this.applyLivenessArming(id, data, patch);
     const [updated] = await this.db.update(webhookSources).set({ ...patch, updatedAt: new Date }).where(eq(webhookSources.id, id)).returning();
     if (!updated) {
       throw new NotFoundError("WebhookSource", id);
     }
     return updated;
   }
+  async applyLivenessArming(id, data, patch) {
+    if (data.expectedIntervalSeconds === undefined)
+      return;
+    if (data.expectedIntervalSeconds === null) {
+      patch.livenessStatus = null;
+      patch.livenessArmedAt = null;
+      patch.stalledAt = null;
+      return;
+    }
+    patch.livenessArmedAt = new Date;
+    const existing = await this.getById(id);
+    if (existing.livenessStatus === null) {
+      patch.livenessStatus = "healthy";
+    }
+  }
   async delete(id) {
     const result = await this.db.delete(webhookSources).where(eq(webhookSources.id, id)).returning();
     if (!result.length) {
@@ -363275,12 +363569,12 @@ class WebhookService {
         }
       }
     }
-    const eventId = generateId();
     const eventType = resolveWebhookEventType(sourceName, source.eventTypeMapping, headers);
     const eventPayload = {
       source: sourceName,
       ...payload
     };
+    let eventId = generateId();
     await this.enforceRegisteredSchema(eventType, eventPayload, eventId, `webhook '${sourceName}'`);
     await this.db.update(webhookSources).set({
       lastReceivedAt: new Date,
@@ -363288,10 +363582,10 @@ class WebhookService {
       updatedAt: new Date
     }).where(eq(webhookSources.id, source.id));
     if (this.eventBus) {
-      await this.eventBus.publishGeneric(eventType, eventPayload, {
-        correlationId: eventId,
+      const result = await this.eventBus.publishGeneric(eventType, eventPayload, {
         source: "webhook"
       });
+      eventId = result.id;
     }
     return {
       received: true,
@@ -363348,17 +363642,112 @@ class WebhookService {
     throw new ValidationError2(`${SCHEMA_VALIDATION_FAILED}: payload for '${eventType}' violates its registered schema (${origin})`, undefined, { eventType, errors: verdict.errors });
   }
   async trigger(eventType, payload, metadata) {
-    const eventId = metadata?.correlationId ?? generateId();
-    await this.enforceRegisteredSchema(eventType, payload, eventId, "manual trigger");
+    const provisionalId = metadata?.correlationId ?? generateId();
+    await this.enforceRegisteredSchema(eventType, payload, provisionalId, "manual trigger");
     if (this.eventBus) {
-      await this.eventBus.publishGeneric(eventType, payload, {
-        correlationId: eventId,
+      const result = await this.eventBus.publishGeneric(eventType, payload, {
+        correlationId: metadata?.correlationId,
         instanceId: metadata?.instanceId,
         source: "manual-trigger"
       });
-      return { eventId, published: true };
+      return { eventId: result.id, published: true };
+    }
+    return { eventId: provisionalId, published: false };
+  }
+  async heartbeat(sourceName) {
+    const source = await this.getByName(sourceName);
+    if (!source) {
+      throw new NotFoundError("WebhookSource", sourceName);
+    }
+    if (!source.enabled) {
+      throw new OmniError({
+        code: ERROR_CODES.FORBIDDEN,
+        message: `Webhook source '${sourceName}' is disabled`,
+        context: { sourceName }
+      });
+    }
+    const now = new Date;
+    await this.db.update(webhookSources).set({
+      lastHeartbeatAt: now,
+      heartbeatCount: sql`${webhookSources.heartbeatCount} + 1`,
+      updatedAt: now
+    }).where(eq(webhookSources.id, source.id));
+    return {
+      ok: true,
+      source: sourceName,
+      heartbeatAt: now.toISOString(),
+      livenessStatus: source.livenessStatus,
+      expectedIntervalSeconds: source.expectedIntervalSeconds
+    };
+  }
+  async sweepLiveness(options = {}) {
+    const { deadLetters } = options;
+    const hooks2 = deadLetters ? {
+      onStalled: (row, payload, publishedEventId) => fileStallDeadLetter(deadLetters, row, payload, publishedEventId),
+      onRecovered: (row) => resolveStallDeadLetters(deadLetters, row)
+    } : {};
+    return sweepConnectorLiveness({
+      repo: this.livenessRepo(),
+      eventBus: this.eventBus,
+      logger: log111,
+      ...hooks2
+    });
+  }
+  livenessRepo() {
+    return {
+      findSupervised: async () => {
+        const rows = await this.db.select().from(webhookSources).where(and2(eq(webhookSources.enabled, true), isNotNull(webhookSources.expectedIntervalSeconds)));
+        return rows.filter((row) => row.expectedIntervalSeconds !== null).map((row) => ({
+          id: row.id,
+          name: row.name,
+          expectedIntervalSeconds: row.expectedIntervalSeconds,
+          lastReceivedAt: row.lastReceivedAt,
+          lastHeartbeatAt: row.lastHeartbeatAt,
+          livenessArmedAt: row.livenessArmedAt,
+          livenessStatus: row.livenessStatus,
+          stalledAt: row.stalledAt,
+          createdAt: row.createdAt,
+          tenantId: row.tenantId
+        }));
+      },
+      markStalled: async (id, at) => {
+        const res = await this.db.update(webhookSources).set({ livenessStatus: "stalled", stalledAt: at, updatedAt: at }).where(and2(eq(webhookSources.id, id), sql`${webhookSources.livenessStatus} IS DISTINCT FROM 'stalled'`)).returning({ id: webhookSources.id });
+        return res.length > 0;
+      },
+      markRecovered: async (id, at) => {
+        const res = await this.db.update(webhookSources).set({ livenessStatus: "healthy", stalledAt: null, updatedAt: at }).where(and2(eq(webhookSources.id, id), eq(webhookSources.livenessStatus, "stalled"))).returning({ id: webhookSources.id });
+        return res.length > 0;
+      }
+    };
+  }
+}
+async function fileStallDeadLetter(deadLetters, row, payload, publishedEventId) {
+  const event = {
+    id: publishedEventId ?? generateId(),
+    type: "system.connector.stalled",
+    payload: { ...payload },
+    metadata: {
+      correlationId: generateId(),
+      source: "connector-liveness",
+      ...row.tenantId ? { tenantId: row.tenantId } : {}
+    },
+    timestamp: payload.stalledAt
+  };
+  await deadLetters.create({
+    event,
+    subject: "system.connector.stalled.internal.global",
+    error: new Error(`Connector '${row.name}' declared >=1 event or heartbeat per ${row.expectedIntervalSeconds}s ` + `but has been silent for ${payload.silentForSeconds}s`),
+    retryCount: 0,
+    autoRetry: false
+  });
+}
+async function resolveStallDeadLetters(deadLetters, row) {
+  const { items } = await deadLetters.list({ status: ["pending"], eventType: ["system.connector.stalled"] });
+  for (const entry of items) {
+    const stored = entry.payload;
+    if (stored.payload?.sourceId === row.id) {
+      await deadLetters.resolve(entry.id, "connector-liveness: recovered");
     }
-    return { eventId, published: false };
   }
 }
 var log111;
@@ -363526,7 +363915,7 @@ function createContextMiddleware(db2, eventBus, channelRegistry2 = null) {
   return { middleware, services };
 }
 var init_context4 = __esm(() => {
-  init_factory2();
+  init_factory3();
   init_services();
 });
 
@@ -363901,7 +364290,7 @@ function createRateLimiter2(config4 = RATE_LIMITS.general, keyPrefix = "ratelimi
 var log113, warnedUnparseableProxyHop = false, rateLimitStore, cleanupTimer, RATE_LIMITS, clientIpSchema, rateLimitMiddleware, webhookIngressRateLimitMiddleware;
 var init_rate_limit = __esm(() => {
   init_src();
-  init_factory2();
+  init_factory3();
   init_zod();
   log113 = createLogger("api:rate-limit");
   rateLimitStore = new Map;
@@ -363945,7 +364334,7 @@ function timeoutMiddleware(config4 = {}) {
 }
 var DEFAULT_TIMEOUT_MS8 = 30000, defaultTimeoutMiddleware;
 var init_timeout = __esm(() => {
-  init_factory2();
+  init_factory3();
   init_http_exception();
   defaultTimeoutMiddleware = timeoutMiddleware();
 });
@@ -363999,7 +364388,7 @@ function loadServerVersionInfo() {
 }
 var import__package, EMBEDDED_VERSION, LAST_RESORT_VERSION = "2.0.0-dev.1", FALLBACK_COMMIT = "unknown", SERVER_VERSION_INFO, versionHeadersMiddleware;
 var init_version_headers = __esm(() => {
-  init_factory2();
+  init_factory3();
   import__package = __toESM(require_package7(), 1);
   EMBEDDED_VERSION = import__package.default?.version;
   SERVER_VERSION_INFO = loadServerVersionInfo();
@@ -364038,7 +364427,7 @@ function createWebhookAuthMiddleware(config4) {
 var log114;
 var init_webhook_auth = __esm(() => {
   init_src();
-  init_factory2();
+  init_factory3();
   log114 = createLogger("api:webhook-auth");
 });
 
@@ -366358,7 +366747,8 @@ var init_automations3 = __esm(() => {
       bodyTemplate: exports_external.string().optional(),
       waitForResponse: exports_external.boolean().default(false),
       timeoutMs: exports_external.number().int().default(30000),
-      responseAs: exports_external.string().optional()
+      responseAs: exports_external.string().optional(),
+      includeEnvelope: exports_external.boolean().optional().openapi({ description: "Send the full OmniEvent envelope as the default body (default true)" })
     })
   });
   SendMessageActionSchema = exports_external.object({
@@ -366994,6 +367384,7 @@ function registerEventSchemas(registry4) {
   registry4.register("EventSummary", EventSummarySchema);
   registry4.register("EventAnalytics", EventAnalyticsSchema);
   registry4.register("EventSearch", EventSearchSchema);
+  registry4.register("EventTrace", EventTraceSchema);
   registry4.registerPath({
     method: "get",
     path: "/events",
@@ -367118,6 +367509,22 @@ function registerEventSchemas(registry4) {
       404: { description: "Event not found", content: { "application/json": { schema: ErrorSchema } } }
     }
   });
+  registry4.registerPath({
+    method: "get",
+    path: "/events/{id}/trace",
+    operationId: "traceEvent",
+    tags: ["Events"],
+    summary: "Trace the causality chain around an event",
+    description: "Walks UP via causationId to the root ingress event and DOWN breadth-first through fan-out (children are events whose causationId equals this id). correlationId groups the flow; causationId gives the tree.",
+    request: { params: exports_external.object({ id: exports_external.string().uuid().openapi({ description: "Event UUID" }) }) },
+    responses: {
+      200: {
+        description: "Causality trace",
+        content: { "application/json": { schema: exports_external.object({ data: EventTraceSchema }) } }
+      },
+      404: { description: "Event not found", content: { "application/json": { schema: ErrorSchema } } }
+    }
+  });
   registry4.registerPath({
     method: "get",
     path: "/events/by-sender/{senderId}",
@@ -367147,7 +367554,7 @@ function registerEventSchemas(registry4) {
     }
   });
 }
-var EventSchema, EventSummarySchema, EventAnalyticsSchema, EventSearchSchema;
+var EventSchema, EventSummarySchema, EventAnalyticsSchema, EventTraceSchema, EventSearchSchema;
 var init_events3 = __esm(() => {
   init_zod_openapi();
   init_common4();
@@ -367165,7 +367572,8 @@ var init_events3 = __esm(() => {
     agentId: exports_external.string().uuid().nullable().openapi({ description: "Agent UUID (FK \u2192 agents.id)" }),
     conversationId: exports_external.string().uuid().nullable().openapi({ description: "Conversation UUID (FK \u2192 conversations.id)" }),
     receivedAt: exports_external.string().datetime().openapi({ description: "When event was received" }),
-    processedAt: exports_external.string().datetime().nullable().openapi({ description: "When event was processed" })
+    processedAt: exports_external.string().datetime().nullable().openapi({ description: "When event was processed" }),
+    causationId: exports_external.string().uuid().nullable().openapi({ description: "Id of the immediate parent event (null for roots and pre-#957 rows)" })
   });
   EventSummarySchema = exports_external.object({
     id: exports_external.string().uuid().openapi({ description: "Event UUID" }),
@@ -367194,6 +367602,15 @@ var init_events3 = __esm(() => {
       count: exports_external.number().int().openapi({ description: "Event count in bucket" })
     })).optional().openapi({ description: "Timeline data (hourly or daily buckets)" })
   });
+  EventTraceSchema = exports_external.object({
+    event: EventSchema.openapi({ description: "The event the trace was requested for" }),
+    ancestors: exports_external.array(EventSchema).openapi({ description: "Chain above the event via causationId, root first, ending at the immediate parent" }),
+    descendants: exports_external.array(exports_external.object({
+      event: EventSchema,
+      depth: exports_external.number().int().openapi({ description: "Distance below the focus event (1 = direct child)" })
+    })).openapi({ description: "Fan-out below the event, breadth-first" }),
+    truncated: exports_external.boolean().openapi({ description: "True when a depth/node cap cut the walk short" })
+  });
   EventSearchSchema = exports_external.object({
     query: exports_external.string().optional().openapi({ description: "Full-text search query" }),
     filters: exports_external.object({
@@ -369789,6 +370206,7 @@ function registerWebhookSchemas(registry4) {
   registry4.register("CreateWebhookSourceRequest", CreateWebhookSourceSchema);
   registry4.register("TriggerEventRequest", TriggerEventSchema);
   registry4.register("WebhookReceiveResponse", WebhookReceiveResponseSchema);
+  registry4.register("WebhookHeartbeatResponse", WebhookHeartbeatResponseSchema);
   registry4.registerPath({
     method: "get",
     path: "/webhook-sources",
@@ -369887,6 +370305,25 @@ function registerWebhookSchemas(registry4) {
       400: { description: "Body is not a JSON object", content: { "application/json": { schema: ErrorSchema } } }
     }
   });
+  registry4.registerPath({
+    method: "post",
+    path: "/webhooks/{source}/heartbeat",
+    operationId: "heartbeatWebhookSource",
+    tags: ["Webhooks"],
+    summary: "Connector heartbeat",
+    description: 'Record a connector heartbeat: "I ran, zero events found". Resets the liveness window of a supervised ' + "source (one declaring expectedIntervalSeconds) so silence-beyond-window detection can tell quiet from " + "dead. Creates NO journal event \u2014 only the stalled/recovered transitions are journaled. No request body.",
+    request: {
+      params: exports_external.object({ source: exports_external.string().openapi({ description: "Source name" }) })
+    },
+    responses: {
+      200: {
+        description: "Heartbeat recorded",
+        content: { "application/json": { schema: WebhookHeartbeatResponseSchema } }
+      },
+      403: { description: "Source disabled", content: { "application/json": { schema: ErrorSchema } } },
+      404: { description: "Source not found", content: { "application/json": { schema: ErrorSchema } } }
+    }
+  });
   registry4.registerPath({
     method: "post",
     path: "/webhooks/ingress/{source}",
@@ -369925,7 +370362,7 @@ function registerWebhookSchemas(registry4) {
     }
   });
 }
-var WebhookSignatureConfigSchema, WebhookEventTypeMappingSchema, WebhookSourceSchema, CreateWebhookSourceSchema, TriggerEventSchema, WebhookReceiveResponseSchema;
+var WebhookSignatureConfigSchema, WebhookEventTypeMappingSchema, WebhookSourceSchema, CreateWebhookSourceSchema, WebhookHeartbeatResponseSchema, TriggerEventSchema, WebhookReceiveResponseSchema;
 var init_webhooks2 = __esm(() => {
   init_src5();
   init_zod_openapi();
@@ -369963,6 +370400,16 @@ var init_webhooks2 = __esm(() => {
     }),
     hasSignatureSecret: exports_external.boolean().openapi({ description: "Whether a signature secret is stored (secret is write-only)" }),
     enabled: exports_external.boolean().openapi({ description: "Whether enabled" }),
+    lastReceivedAt: exports_external.string().datetime().nullable().openapi({ description: "When the last webhook was received" }),
+    totalReceived: exports_external.number().int().openapi({ description: "Total webhooks received" }),
+    expectedIntervalSeconds: exports_external.number().int().nullable().openapi({ description: "Declared cadence: >=1 event or heartbeat per N seconds. Null = unsupervised" }),
+    lastHeartbeatAt: exports_external.string().datetime().nullable().openapi({ description: 'Last heartbeat ("ran, zero events")' }),
+    heartbeatCount: exports_external.number().int().openapi({ description: "Total heartbeats received" }),
+    livenessStatus: exports_external.enum(connectorLivenessStatuses).nullable().openapi({ description: "Liveness state; null = unsupervised. Transitions emit system.connector.* events" }),
+    livenessArmedAt: exports_external.string().datetime().nullable().openapi({ description: "When the cadence was (re)declared" }),
+    stalledAt: exports_external.string().datetime().nullable().openapi({ description: "When the current stall began" }),
+    windowSemantics: exports_external.enum(connectorWindowSemanticsValues).nullable().openapi({ description: "Declared window semantics; null = undeclared" }),
+    mutationPolicy: exports_external.enum(connectorMutationPolicies).nullable().openapi({ description: "Declared upstream-mutation re-emit policy; null = undeclared" }),
     createdAt: exports_external.string().datetime().openapi({ description: "Creation timestamp" }),
     updatedAt: exports_external.string().datetime().openapi({ description: "Last update timestamp" })
   });
@@ -369979,7 +370426,23 @@ var init_webhooks2 = __esm(() => {
     eventTypeMapping: WebhookEventTypeMappingSchema.nullable().optional().openapi({
       description: "Semantic event-type extraction (e.g. header X-GitHub-Event: push emits custom.{source}.push). " + "Null or absent keeps the legacy collapsed custom.webhook.{source} type for every delivery."
     }),
-    enabled: exports_external.boolean().default(true).openapi({ description: "Whether enabled" })
+    enabled: exports_external.boolean().default(true).openapi({ description: "Whether enabled" }),
+    expectedIntervalSeconds: exports_external.number().int().min(1).max(2592000).nullable().optional().openapi({
+      description: "Declared cadence: the connector promises >=1 event or heartbeat per N seconds (1s-30d). Declaring it " + "arms liveness supervision (silence beyond the window emits system.connector.stalled and marks the " + "source unhealthy); null disarms it."
+    }),
+    windowSemantics: exports_external.enum(connectorWindowSemanticsValues).nullable().optional().openapi({
+      description: "Declared time-window semantics: 'future_only' (only not-yet-started items) or 'includes_in_progress'. " + "Informational contract for consumers; null = undeclared."
+    }),
+    mutationPolicy: exports_external.enum(connectorMutationPolicies).nullable().optional().openapi({
+      description: "How the source re-emits a changed upstream item: 'same_id' (reschedule case \u2014 consumers must key on " + "id+content) or 'new_id'. Feeds the idempotency key template choice; null = undeclared."
+    })
+  });
+  WebhookHeartbeatResponseSchema = exports_external.object({
+    ok: exports_external.literal(true).openapi({ description: "Heartbeat recorded" }),
+    source: exports_external.string().openapi({ description: "Webhook source name" }),
+    heartbeatAt: exports_external.string().datetime().openapi({ description: "When the heartbeat was recorded" }),
+    livenessStatus: exports_external.enum(connectorLivenessStatuses).nullable().openapi({ description: "Status before this heartbeat (a stalled source recovers on the next sweep tick)" }),
+    expectedIntervalSeconds: exports_external.number().int().nullable().openapi({ description: "Declared cadence, if any" })
   });
   TriggerEventSchema = exports_external.object({
     eventType: exports_external.string().min(1).openapi({ description: "Event type (must start with custom.)" }),
@@ -371547,7 +372010,8 @@ var init_automations4 = __esm(() => {
       bodyTemplate: exports_external.string().optional().describe("Request body template (JSON)"),
       waitForResponse: exports_external.boolean().default(false).describe("Wait for response before continuing"),
       timeoutMs: exports_external.number().int().min(1000).max(120000).default(30000).describe("Request timeout"),
-      responseAs: exports_external.string().optional().describe("Store response as variable name")
+      responseAs: exports_external.string().optional().describe("Store response as variable name"),
+      includeEnvelope: exports_external.boolean().optional().describe("Send the full OmniEvent envelope as the default body when no bodyTemplate is set (default true)")
     })
   });
   sendMessageActionSchema = exports_external.object({
@@ -373343,6 +373807,16 @@ var init_events4 = __esm(() => {
     }
     return c.json({ data: event });
   });
+  eventsRoutes.get("/:id/trace", async (c) => {
+    const id = c.req.param("id");
+    const services = c.get("services");
+    const apiKey = c.get("apiKey");
+    const trace24 = await services.events.trace(id);
+    if (trace24.event.instanceId && apiKey && !ApiKeyService.instanceAllowed(apiKey.instanceIds, trace24.event.instanceId)) {
+      return c.json({ error: { code: "FORBIDDEN", message: "API key does not have access to this instance" } }, 403);
+    }
+    return c.json({ data: trace24 });
+  });
   eventsRoutes.get("/by-sender/:senderId", async (c) => {
     const senderId = c.req.param("senderId");
     const instanceId = c.req.query("instanceId");
@@ -378596,14 +379070,14 @@ var init_media2 = __esm(() => {
     }
     const relativePath = `${instanceId}/${path3}`;
     const db2 = c.get("services");
-    const storage2 = getMediaStorage(db2);
+    const storage3 = getMediaStorage(db2);
     try {
-      const stat5 = await storage2.statMedia(relativePath);
+      const stat5 = await storage3.statMedia(relativePath);
       if (!stat5) {
         return c.json({ error: { code: "NOT_FOUND", message: "Media not found" } }, 404);
       }
       const fileSize = stat5.size;
-      const mimeType = storage2.getMimeType(path3);
+      const mimeType = storage3.getMimeType(path3);
       const rangeHeader = c.req.header("Range");
       if (rangeHeader) {
         const matches = rangeHeader.match(/bytes=(\d+)-(\d*)/);
@@ -378617,7 +379091,7 @@ var init_media2 = __esm(() => {
               headers: { "Content-Range": `bytes */${fileSize}`, "Accept-Ranges": "bytes" }
             });
           }
-          const chunk2 = await storage2.readMediaRange(relativePath, start, end);
+          const chunk2 = await storage3.readMediaRange(relativePath, start, end);
           return new Response(chunk2, {
             status: 206,
             headers: {
@@ -378629,7 +379103,7 @@ var init_media2 = __esm(() => {
           });
         }
       }
-      const stream2 = await storage2.readMediaStream(relativePath);
+      const stream2 = await storage3.readMediaStream(relativePath);
       return new Response(stream2, {
         status: 200,
         headers: {
@@ -382522,6 +382996,12 @@ var init_webhooks3 = __esm(() => {
     });
     return c.json(result);
   });
+  webhooksRoutes.post("/webhooks/:source/heartbeat", async (c) => {
+    const sourceName = c.req.param("source");
+    const services = c.get("services");
+    const result = await services.webhooks.heartbeat(sourceName);
+    return c.json(result);
+  });
   triggerEventSchema = exports_external.object({
     eventType: exports_external.string().min(1).refine((t) => t.startsWith("custom."), { message: 'Event type must start with "custom."' }).describe("Event type (must be custom.*)"),
     payload: exports_external.record(exports_external.string(), exports_external.unknown()).describe("Event payload"),
@@ -383421,7 +383901,7 @@ function platformAuthMiddleware(requiredScope, platformAction) {
 }
 var UNAUTHORIZED, FORBIDDEN;
 var init_platform_auth = __esm(() => {
-  init_factory2();
+  init_factory3();
   init_api_keys();
   UNAUTHORIZED = { error: { code: "UNAUTHORIZED", message: "Platform credential required" } };
   FORBIDDEN = {
@@ -384213,6 +384693,7 @@ async function setupEventPersistence(eventBus, db2) {
               from: payload.from
             },
             agentId: metadata.agentId ?? null,
+            causationId: metadata.causationId ?? null,
             conversationId: null,
             chatUuid
           };
@@ -384266,6 +384747,7 @@ async function setupEventPersistence(eventBus, db2) {
               voiceNote: payload.content.isVoiceNote
             },
             agentId: metadata.agentId ?? null,
+            causationId: metadata.causationId ?? null,
             conversationId: null,
             chatUuid
           };
@@ -384306,6 +384788,7 @@ async function setupEventPersistence(eventBus, db2) {
               receivedAt: new Date(event.timestamp),
               deliveredAt: new Date(payload.deliveredAt),
               agentId: metadata.agentId ?? null,
+              causationId: metadata.causationId ?? null,
               conversationId: null,
               chatUuid
             };
@@ -384345,6 +384828,7 @@ async function setupEventPersistence(eventBus, db2) {
               receivedAt: new Date(event.timestamp),
               readAt: new Date(payload.readAt),
               agentId: metadata.agentId ?? null,
+              causationId: metadata.causationId ?? null,
               conversationId: null,
               chatUuid
             };
@@ -384399,6 +384883,7 @@ async function setupEventPersistence(eventBus, db2) {
                 retryable: payload.retryable
               },
               agentId: metadata.agentId ?? null,
+              causationId: metadata.causationId ?? null,
               conversationId: null,
               chatUuid
             };
@@ -384419,6 +384904,38 @@ async function setupEventPersistence(eventBus, db2) {
         });
       }
     }, { ...CONSUMER_OPTIONS, durable: "event-persistence-failed" });
+    await eventBus.subscribePattern("custom.>", async (event) => {
+      const metadata = event.metadata;
+      try {
+        await runConsumerInTenantContext(db2, event, async () => {
+          const sdb = scopedHandle(db2);
+          const newEvent = {
+            ...eventIdInsert(event.id),
+            channel: "internal",
+            instanceId: metadata.instanceId && isValidUuid(metadata.instanceId) ? metadata.instanceId : null,
+            eventType: event.type.slice(0, 50),
+            direction: "internal",
+            status: "completed",
+            receivedAt: new Date(event.timestamp),
+            rawPayload: deepSanitize(event.payload),
+            metadata: {
+              correlationId: metadata.correlationId,
+              source: metadata.source,
+              fullEventType: event.type
+            },
+            causationId: metadata.causationId ?? null,
+            conversationId: null
+          };
+          await sdb.insert(omniEvents).values(newEvent).onConflictDoNothing({ target: omniEvents.id });
+        });
+      } catch (error3) {
+        log124.error("Failed to persist custom event", {
+          eventType: event.type,
+          eventId: event.id,
+          error: String(error3)
+        });
+      }
+    }, { ...CONSUMER_OPTIONS, durable: "event-persistence-custom", startFrom: "new" });
     log124.info("Event persistence initialized - listening for message events");
   } catch (error3) {
     log124.error("Failed to set up event persistence", { error: String(error3) });
@@ -386672,6 +387189,26 @@ function setupScheduler(services, channelRegistry2) {
       });
     }
   });
+  scheduler.register({
+    name: "connector-liveness-sweeper",
+    cron: "*/30 * * * * *",
+    runOnStart: false,
+    handler: async () => {
+      await withCronMonitor("connector-liveness-sweeper", "*/30 * * * * *", 1, 1, async () => {
+        const startTime3 = Date.now();
+        try {
+          const stats = await services.webhooks.sweepLiveness({ deadLetters: services.deadLetters });
+          recordScheduledJob("connector-liveness-sweeper", "success", (Date.now() - startTime3) / 1000);
+          if (stats.stalled > 0 || stats.recovered > 0) {
+            log130.info("Connector liveness sweep tick", { ...stats });
+          }
+        } catch (err2) {
+          recordScheduledJob("connector-liveness-sweeper", "failure", (Date.now() - startTime3) / 1000);
+          throw err2;
+        }
+      });
+    }
+  });
   if (channelRegistry2) {
     const scheduledMessages2 = createScheduledMessageSweeper(services, channelRegistry2);
     scheduler.register({
@@ -389364,27 +389901,27 @@ var import_discord5 = __toESM(require_src2(), 1);
 // ../channel-discord/src/auth.ts
 init_src();
 var log21 = createLogger("discord:auth");
-async function loadToken(storage, instanceId) {
+async function loadToken(storage2, instanceId) {
   const key = `${instanceId}:token`;
-  const data = await storage.get(key);
+  const data = await storage2.get(key);
   if (data?.token) {
     log21.debug("Loaded token from storage", { instanceId });
     return data.token;
   }
   return null;
 }
-async function saveToken(storage, instanceId, token) {
+async function saveToken(storage2, instanceId, token) {
   const key = `${instanceId}:token`;
   const data = {
     token,
     storedAt: Date.now()
   };
-  await storage.set(key, data);
+  await storage2.set(key, data);
   log21.debug("Saved token to storage", { instanceId });
 }
-async function clearToken(storage, instanceId) {
+async function clearToken(storage2, instanceId) {
   const key = `${instanceId}:token`;
-  await storage.delete(key);
+  await storage2.delete(key);
   log21.debug("Cleared token from storage", { instanceId });
 }
 
@@ -489935,11 +490472,11 @@ class GroupCipher {
     const ret2 = wasm.groupcipher_encrypt(this.__wbg_ptr, ptr0, len0);
     return takeObject(ret2);
   }
-  constructor(storage, group_id, sender) {
+  constructor(storage2, group_id, sender) {
     const ptr0 = passStringToWasm0(group_id, wasm.__wbindgen_export, wasm.__wbindgen_export2);
     const len0 = WASM_VECTOR_LEN;
     _assertClass(sender, ProtocolAddress);
-    const ret2 = wasm.groupcipher_new(addHeapObject(storage), ptr0, len0, sender.__wbg_ptr);
+    const ret2 = wasm.groupcipher_new(addHeapObject(storage2), ptr0, len0, sender.__wbg_ptr);
     this.__wbg_ptr = ret2 >>> 0;
     GroupCipherFinalization.register(this, this.__wbg_ptr, this);
     return this;
@@ -489964,8 +490501,8 @@ class GroupSessionBuilder {
     const ret2 = wasm.groupsessionbuilder_create(this.__wbg_ptr, sender_key_name.__wbg_ptr);
     return takeObject(ret2);
   }
-  constructor(storage) {
-    const ret2 = wasm.groupsessionbuilder_new(addHeapObject(storage));
+  constructor(storage2) {
+    const ret2 = wasm.groupsessionbuilder_new(addHeapObject(storage2));
     this.__wbg_ptr = ret2 >>> 0;
     GroupSessionBuilderFinalization.register(this, this.__wbg_ptr, this);
     return this;
@@ -490621,9 +491158,9 @@ class SessionBuilder {
     const ret2 = wasm.sessionbuilder_initOutgoing(this.__wbg_ptr, addHeapObject(bundle_input));
     return takeObject(ret2);
   }
-  constructor(storage, remote_address) {
+  constructor(storage2, remote_address) {
     _assertClass(remote_address, ProtocolAddress);
-    const ret2 = wasm.sessionbuilder_new(addHeapObject(storage), remote_address.__wbg_ptr);
+    const ret2 = wasm.sessionbuilder_new(addHeapObject(storage2), remote_address.__wbg_ptr);
     this.__wbg_ptr = ret2 >>> 0;
     SessionBuilderFinalization.register(this, this.__wbg_ptr, this);
     return this;
@@ -490669,9 +491206,9 @@ class SessionCipher {
     const ret2 = wasm.sessioncipher_hasOpenSession(this.__wbg_ptr);
     return takeObject(ret2);
   }
-  constructor(storage, remote_address) {
+  constructor(storage2, remote_address) {
     _assertClass(remote_address, ProtocolAddress);
-    const ret2 = wasm.sessionbuilder_new(addHeapObject(storage), remote_address.__wbg_ptr);
+    const ret2 = wasm.sessionbuilder_new(addHeapObject(storage2), remote_address.__wbg_ptr);
     this.__wbg_ptr = ret2 >>> 0;
     SessionCipherFinalization.register(this, this.__wbg_ptr, this);
     return this;
@@ -498744,8 +499281,8 @@ var CacheableSync = class extends Hookified {
       data
     });
   }
-  subscribe(storage, cacheId) {
-    this._storage = storage;
+  subscribe(storage2, cacheId) {
+    this._storage = storage2;
     this._cacheId = cacheId;
     const setEvent = this.getPrefixedEvent("cache:set");
     const deleteEvent = this.getPrefixedEvent("cache:delete");
@@ -498753,7 +499290,7 @@ var CacheableSync = class extends Hookified {
       handler: async (message2) => {
         const data = message2.data;
         if (data.cacheId !== cacheId) {
-          await storage.set(data.key, data.value, data.ttl);
+          await storage2.set(data.key, data.value, data.ttl);
         }
       }
     });
@@ -498761,7 +499298,7 @@ var CacheableSync = class extends Hookified {
       handler: async (message2) => {
         const data = message2.data;
         if (data.cacheId !== cacheId) {
-          await storage.delete(data.key);
+          await storage2.delete(data.key);
         }
       }
     });
@@ -499749,7 +500286,7 @@ var index_default = NodeCache;
 
 // ../../node_modules/.bun/baileys@vendor+baileys-v7.0.0-rc10.tgz+89588f7e3fe8b2e6/node_modules/baileys/lib/Utils/auth-utils.js
 var import_boom10 = __toESM(require_lib7(), 1);
-import { AsyncLocalStorage } from "async_hooks";
+import { AsyncLocalStorage as AsyncLocalStorage2 } from "async_hooks";
 
 // ../../node_modules/.bun/async-mutex@0.5.0/node_modules/async-mutex/index.mjs
 var E_TIMEOUT = new Error("timeout while waiting for mutex to become available");
@@ -500725,7 +501262,7 @@ class PreKeyManager {
 
 // ../../node_modules/.bun/baileys@vendor+baileys-v7.0.0-rc10.tgz+89588f7e3fe8b2e6/node_modules/baileys/lib/Utils/auth-utils.js
 var addTransactionCapability = (state, logger5, { maxCommitRetries, delayBetweenTriesMs }) => {
-  const txStorage = new AsyncLocalStorage;
+  const txStorage = new AsyncLocalStorage2;
   const keyQueues = new Map;
   const txMutexes = new Map;
   const txMutexRefCounts = new Map;
@@ -503410,7 +503947,7 @@ function extractIdentityFromPkmsg(ciphertext) {
 }
 function makeLibSignalRepository(auth, logger5, pnToLIDFunc) {
   const lidMapping = new LIDMappingStore(auth.keys, logger5, pnToLIDFunc);
-  const storage = signalStorage(auth, lidMapping);
+  const storage2 = signalStorage(auth, lidMapping);
   const parsedKeys = auth.keys;
   const migratedSessionCache = new M({
     ttl: 3 * 24 * 60 * 60 * 1000,
@@ -503422,21 +503959,21 @@ function makeLibSignalRepository(auth, logger5, pnToLIDFunc) {
     const senderNameStr = senderName.toString();
     const { [senderNameStr]: senderKey } = await auth.keys.get("sender-key", [senderNameStr]);
     if (!senderKey) {
-      await storage.storeSenderKey(senderName, new SenderKeyRecord2);
+      await storage2.storeSenderKey(senderName, new SenderKeyRecord2);
     }
-    const skdm = await new GroupSessionBuilder2(storage).create(senderName);
+    const skdm = await new GroupSessionBuilder2(storage2).create(senderName);
     return { senderName, skdm };
   };
   const repository = {
     decryptGroupMessage({ group, authorJid, msg }) {
       const senderName = jidToSignalSenderKeyName(group, authorJid);
-      const cipher = new GroupCipher2(storage, senderName);
+      const cipher = new GroupCipher2(storage2, senderName);
       return parsedKeys.transaction(async () => {
         return cipher.decrypt(msg);
       }, group);
     },
     async processSenderKeyDistributionMessage({ item, authorJid }) {
-      const builder = new GroupSessionBuilder2(storage);
+      const builder = new GroupSessionBuilder2(storage2);
       if (!item.groupId) {
         throw new Error("Group ID is required for sender key distribution message");
       }
@@ -503445,24 +503982,24 @@ function makeLibSignalRepository(auth, logger5, pnToLIDFunc) {
       const senderNameStr = senderName.toString();
       const { [senderNameStr]: senderKey } = await auth.keys.get("sender-key", [senderNameStr]);
       if (!senderKey) {
-        await storage.storeSenderKey(senderName, new SenderKeyRecord2);
+        await storage2.storeSenderKey(senderName, new SenderKeyRecord2);
       }
       return parsedKeys.transaction(async () => {
         const { [senderNameStr]: senderKey2 } = await auth.keys.get("sender-key", [senderNameStr]);
         if (!senderKey2) {
-          await storage.storeSenderKey(senderName, new SenderKeyRecord2);
+          await storage2.storeSenderKey(senderName, new SenderKeyRecord2);
         }
         await builder.process(senderName, senderMsg);
       }, item.groupId);
     },
     async decryptMessage({ jid, type, ciphertext }) {
       const addr = jidToSignalProtocolAddress(jid);
-      const session = new libsignal.SessionCipher(storage, addr);
+      const session = new libsignal.SessionCipher(storage2, addr);
       if (type === "pkmsg") {
         const identityKey = extractIdentityFromPkmsg(ciphertext);
         if (identityKey) {
           const addrStr = addr.toString();
-          const identityChanged = await storage.saveIdentity(addrStr, identityKey);
+          const identityChanged = await storage2.saveIdentity(addrStr, identityKey);
           if (identityChanged) {
             logger5.info({ jid, addr: addrStr }, "identity key changed or new contact, session will be re-established");
           }
@@ -503486,7 +504023,7 @@ function makeLibSignalRepository(auth, logger5, pnToLIDFunc) {
     },
     async encryptMessage({ jid, data }) {
       const addr = jidToSignalProtocolAddress(jid);
-      const cipher = new libsignal.SessionCipher(storage, addr);
+      const cipher = new libsignal.SessionCipher(storage2, addr);
       return parsedKeys.transaction(async () => {
         const { type: sigType, body } = await cipher.encrypt(data);
         const type = sigType === 3 ? "pkmsg" : "msg";
@@ -503496,7 +504033,7 @@ function makeLibSignalRepository(auth, logger5, pnToLIDFunc) {
     async encryptGroupMessage({ group, meId, data }) {
       return parsedKeys.transaction(async () => {
         const { senderName, skdm } = await ensureSenderKeyAndCreateSkdm(group, meId);
-        const ciphertext = await new GroupCipher2(storage, senderName).encrypt(data);
+        const ciphertext = await new GroupCipher2(storage2, senderName).encrypt(data);
         return { ciphertext, senderKeyDistributionMessage: skdm.serialize() };
       }, group);
     },
@@ -503513,7 +504050,7 @@ function makeLibSignalRepository(auth, logger5, pnToLIDFunc) {
     },
     async getSessionInfo(jid) {
       const addr = jidToSignalProtocolAddress(jid).toString();
-      const session = await storage.loadSession(addr);
+      const session = await storage2.loadSession(addr);
       if (!session) {
         return null;
       }
@@ -503527,7 +504064,7 @@ function makeLibSignalRepository(auth, logger5, pnToLIDFunc) {
     },
     async injectE2ESession({ jid, session }) {
       logger5.trace({ jid }, "injecting E2EE session");
-      const cipher = new libsignal.SessionBuilder(storage, jidToSignalProtocolAddress(jid));
+      const cipher = new libsignal.SessionBuilder(storage2, jidToSignalProtocolAddress(jid));
       return parsedKeys.transaction(async () => {
         await cipher.initOutgoing(session);
       }, jid);
@@ -503539,7 +504076,7 @@ function makeLibSignalRepository(auth, logger5, pnToLIDFunc) {
     async validateSession(jid) {
       try {
         const addr = jidToSignalProtocolAddress(jid);
-        const session = await storage.loadSession(addr.toString());
+        const session = await storage2.loadSession(addr.toString());
         if (!session) {
           return { exists: false, reason: "no session" };
         }
@@ -511533,11 +512070,11 @@ function deserializeSignalData(type, data) {
   }
   return data;
 }
-async function createStorageAuthState(storage, instanceId) {
+async function createStorageAuthState(storage2, instanceId) {
   const credsKey = `auth:${instanceId}:creds`;
   const keyPrefix = `auth:${instanceId}:keys`;
   let creds;
-  const existingCreds = await storage.get(credsKey);
+  const existingCreds = await storage2.get(credsKey);
   if (existingCreds) {
     if (typeof existingCreds === "string") {
       creds = deserialize(existingCreds);
@@ -511607,10 +512144,10 @@ async function createStorageAuthState(storage, instanceId) {
     const previousPersist = persistQueues.get(key) ?? Promise.resolve();
     const nextPersist = previousPersist.catch(() => {}).then(async () => {
       if (value !== null && value !== undefined) {
-        await storage.set(key, serialize(value));
+        await storage2.set(key, serialize(value));
         return;
       }
-      await storage.delete(key);
+      await storage2.delete(key);
     }).catch((err2) => {
       if (value !== null && value !== undefined) {
         log50.error("Background key persist failed", { type, id: id.slice(-40), instanceId, err: String(err2) });
@@ -511639,7 +512176,7 @@ async function createStorageAuthState(storage, instanceId) {
               data[id] = deserializeSignalData(type, cached);
               continue;
             }
-            const value = await storage.get(key);
+            const value = await storage2.get(key);
             if (value !== null && value !== undefined) {
               const parsed = parseStorageValue(value);
               setCachedValue(key, parsed);
@@ -511661,19 +512198,19 @@ async function createStorageAuthState(storage, instanceId) {
       }
     },
     saveCreds: async () => {
-      await storage.set(credsKey, serialize(creds));
+      await storage2.set(credsKey, serialize(creds));
     }
   };
 }
-async function clearAuthState(storage, instanceId) {
+async function clearAuthState(storage2, instanceId) {
   const credsKey = `auth:${instanceId}:creds`;
   const keyPrefix = `auth:${instanceId}:keys`;
-  await storage.delete(credsKey);
-  const keys = await storage.keys(`${keyPrefix}:*`);
+  await storage2.delete(credsKey);
+  const keys = await storage2.keys(`${keyPrefix}:*`);
   const batchSize = 50;
   for (let i = 0;i < keys.length; i += batchSize) {
     const batch = keys.slice(i, i + batchSize);
-    await Promise.all(batch.map((key) => storage.delete(key)));
+    await Promise.all(batch.map((key) => storage2.delete(key)));
   }
 }