@automagik/omni 2.260906.3 → 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] ?? "";
@@ -23004,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);
@@ -23300,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();
@@ -31293,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();
@@ -36972,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)
@@ -36989,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")
@@ -37070,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;
@@ -37642,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);
@@ -37651,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,
@@ -37750,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 } : {}
     });
@@ -37844,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
     }
   };
 }
@@ -37885,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);
@@ -37919,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;
@@ -38354,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) {
@@ -38370,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);
@@ -38479,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 = {
@@ -38575,6 +38651,7 @@ function createAutomationEngine(config2) {
 }
 var logger4, QueueFullError;
 var init_engine = __esm(() => {
+  init_causality();
   init_envelope();
   init_ids();
   init_logger();
@@ -43113,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();
@@ -43133,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
@@ -43817,6 +43894,7 @@ __export(exports_src, {
   scheduledJobRuns: () => scheduledJobRuns,
   scheduledJobNextRun: () => scheduledJobNextRun,
   scheduledJobDuration: () => scheduledJobDuration,
+  runWithEventCausality: () => runWithEventCausality,
   rootLogger: () => rootLogger,
   resolveResetConfig: () => resolveResetConfig,
   resolvePublishTenantId: () => resolvePublishTenantId,
@@ -43929,6 +44007,7 @@ __export(exports_src, {
   dbQueries: () => dbQueries,
   dbPoolSize: () => dbPoolSize,
   dbErrors: () => dbErrors,
+  currentEventCausality: () => currentEventCausality,
   createValidatedSubscription: () => createValidatedSubscription,
   createTemplateContext: () => createTemplateContext,
   createSubscription: () => createSubscription,
@@ -139026,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();
@@ -139041,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;
@@ -139057,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();
@@ -139068,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;
@@ -139152,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;
@@ -139181,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) {
@@ -139219,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)
@@ -139244,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;
@@ -139253,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)
     };
   }
 
@@ -143391,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();
@@ -144839,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) {
@@ -173074,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),
@@ -179835,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();
@@ -201887,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");
@@ -250825,7 +250906,7 @@ var init_sentry_scrub = __esm(() => {
 var require_package7 = __commonJS((exports, module) => {
   module.exports = {
     name: "@omni/api",
-    version: "2.260906.3",
+    version: "2.260906.4",
     private: true,
     type: "module",
     exports: {
@@ -257810,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);
@@ -258220,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);
@@ -258249,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;
@@ -258604,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);
       }
@@ -300168,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();
 });
 
@@ -300697,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();
@@ -300719,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 {
@@ -300727,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
@@ -300865,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();
@@ -301088,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) => {
@@ -301480,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"];
@@ -301644,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",
@@ -302043,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();
@@ -302165,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) => {
@@ -302462,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",
@@ -302873,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();
@@ -351309,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(() => {
@@ -355597,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)
@@ -355634,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,
@@ -355665,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,
@@ -355697,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,
@@ -358890,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)];
@@ -358991,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();
@@ -363443,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,
@@ -363456,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,
@@ -363516,17 +363642,17 @@ 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, published: false };
+    return { eventId: provisionalId, published: false };
   }
   async heartbeat(sourceName) {
     const source = await this.getByName(sourceName);
@@ -363789,7 +363915,7 @@ function createContextMiddleware(db2, eventBus, channelRegistry2 = null) {
   return { middleware, services };
 }
 var init_context4 = __esm(() => {
-  init_factory2();
+  init_factory3();
   init_services();
 });
 
@@ -364164,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;
@@ -364208,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();
 });
@@ -364262,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();
@@ -364301,7 +364427,7 @@ function createWebhookAuthMiddleware(config4) {
 var log114;
 var init_webhook_auth = __esm(() => {
   init_src();
-  init_factory2();
+  init_factory3();
   log114 = createLogger("api:webhook-auth");
 });
 
@@ -366621,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({
@@ -367257,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",
@@ -367381,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}",
@@ -367410,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();
@@ -367428,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" }),
@@ -367457,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({
@@ -371856,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({
@@ -373652,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");
@@ -378905,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*)/);
@@ -378926,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: {
@@ -378938,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: {
@@ -383736,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 = {
@@ -384528,6 +384693,7 @@ async function setupEventPersistence(eventBus, db2) {
               from: payload.from
             },
             agentId: metadata.agentId ?? null,
+            causationId: metadata.causationId ?? null,
             conversationId: null,
             chatUuid
           };
@@ -384581,6 +384747,7 @@ async function setupEventPersistence(eventBus, db2) {
               voiceNote: payload.content.isVoiceNote
             },
             agentId: metadata.agentId ?? null,
+            causationId: metadata.causationId ?? null,
             conversationId: null,
             chatUuid
           };
@@ -384621,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
             };
@@ -384660,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
             };
@@ -384714,6 +384883,7 @@ async function setupEventPersistence(eventBus, db2) {
                 retryable: payload.retryable
               },
               agentId: metadata.agentId ?? null,
+              causationId: metadata.causationId ?? null,
               conversationId: null,
               chatUuid
             };
@@ -384734,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) });
@@ -389699,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 });
 }
 
@@ -490270,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;
@@ -490299,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;
@@ -490956,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;
@@ -491004,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;
@@ -499079,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");
@@ -499088,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);
         }
       }
     });
@@ -499096,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);
         }
       }
     });
@@ -500084,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");
@@ -501060,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;
@@ -503745,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,
@@ -503757,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");
       }
@@ -503780,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");
           }
@@ -503821,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";
@@ -503831,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);
     },
@@ -503848,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;
       }
@@ -503862,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);
@@ -503874,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" };
         }
@@ -511868,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);
@@ -511942,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) });
@@ -511974,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);
@@ -511996,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)));
   }
 }