@automagik/omni 2.260525.2 → 2.260529.1

package/dist/index.js

@@ -28459,7 +28459,7 @@ function registerSchemas(entries) {
     eventRegistry.register(entry);
   }
 }
-var log2, eventRegistry, SystemEventSchemas;
+var log2, eventRegistry, SystemEventSchemas, CustomEventSchemas;
 var init_registry = __esm(() => {
   init_zod();
   init_logger();
@@ -28493,6 +28493,25 @@ var init_registry = __esm(() => {
       severity: exports_external.enum(["warning", "critical"])
     }), { description: "System health degradation detected" })
   };
+  CustomEventSchemas = {
+    chatUnreadUpdated: createEventSchema("custom.chat.unread-updated", exports_external.object({
+      chatId: exports_external.string(),
+      unreadCount: exports_external.number()
+    }), { description: "Platform-native chat unread count update" }),
+    contactsNames: createEventSchema("custom.contacts.names", exports_external.object({
+      names: exports_external.array(exports_external.object({
+        jid: exports_external.string(),
+        name: exports_external.string()
+      }))
+    }), { description: "Contact display names discovered by a channel" }),
+    lidMappingBatch: createEventSchema("custom.lid-mapping.batch", exports_external.object({
+      mappings: exports_external.array(exports_external.object({
+        lidJid: exports_external.string(),
+        phoneJid: exports_external.string()
+      }))
+    }), { description: "Batch of WhatsApp LID to phone JID mappings" })
+  };
+  registerSchemas([...Object.values(SystemEventSchemas), ...Object.values(CustomEventSchemas)]);
 });
 
 // ../core/src/events/nats/subjects.ts
@@ -35744,6 +35763,100 @@ var init_types6 = __esm(() => {
   };
 });
 
+// ../core/src/providers/execution-context.ts
+function compactEnv(values) {
+  return Object.fromEntries(Object.entries(values).filter(([, value]) => value !== undefined));
+}
+function inferChatType(context) {
+  if (context.type === "dm")
+    return "dm";
+  if (context.source.chatId === context.sender.platformUserId)
+    return "dm";
+  if (context.source.threadId)
+    return "channel";
+  return "group";
+}
+function compactCustomer(customer) {
+  if (!customer)
+    return;
+  const compacted = Object.fromEntries(Object.entries(customer).filter(([, value]) => value !== undefined));
+  return Object.keys(compacted).length > 0 ? compacted : undefined;
+}
+function buildOmniExecutionContext(context) {
+  const userId = context.sender.personId ?? context.sender.platformUserId;
+  const sessionId = context.sessionId || context.source.threadId || context.source.chatId || userId;
+  const customer = compactCustomer(context.customer);
+  return {
+    identity: {
+      userId,
+      ...context.sender.personId ? { personId: context.sender.personId } : {},
+      platformUserId: context.sender.platformUserId,
+      ...context.sender.displayName ? { displayName: context.sender.displayName } : {}
+    },
+    source: {
+      channel: context.source.channelType,
+      instanceId: context.source.instanceId,
+      chatId: context.source.chatId,
+      ...context.source.threadId ? { threadId: context.source.threadId } : {},
+      messageId: context.source.messageId
+    },
+    session: {
+      id: sessionId,
+      ...context.sessionStrategy ? { strategy: context.sessionStrategy } : {}
+    },
+    trace: {
+      id: context.traceId
+    },
+    ...customer ? { customer } : {}
+  };
+}
+function buildOmniEnv(context, executionContext = buildOmniExecutionContext(context)) {
+  return compactEnv({
+    ...context.env ?? {},
+    OMNI_USER_ID: executionContext.identity.userId,
+    OMNI_PERSON_ID: executionContext.identity.personId,
+    OMNI_PLATFORM_USER_ID: executionContext.identity.platformUserId,
+    OMNI_SENDER: executionContext.identity.platformUserId,
+    OMNI_DISPLAY_NAME: executionContext.identity.displayName,
+    OMNI_INSTANCE: executionContext.source.instanceId,
+    OMNI_CHAT: executionContext.source.chatId,
+    OMNI_MESSAGE: executionContext.source.messageId,
+    OMNI_CHANNEL: executionContext.source.channel,
+    OMNI_SESSION: executionContext.session.id,
+    OMNI_TRACE_ID: executionContext.trace.id,
+    OMNI_THREAD: executionContext.source.threadId,
+    OMNI_EXTERNAL_USER_ID: executionContext.customer?.externalUserId,
+    OMNI_CUSTOMER_ID: executionContext.customer?.customerId,
+    OMNI_ORGANIZATION_ID: executionContext.customer?.organizationId,
+    OMNI_TENANT_ID: executionContext.customer?.tenantId
+  });
+}
+function buildProviderRequestContext(context) {
+  const executionContext = buildOmniExecutionContext(context);
+  return {
+    userId: executionContext.identity.userId,
+    sessionId: executionContext.session.id,
+    platform: {
+      id: executionContext.identity.platformUserId,
+      channel: executionContext.source.channel,
+      instanceId: executionContext.source.instanceId
+    },
+    sender: {
+      ...executionContext.identity.displayName ? { displayName: executionContext.identity.displayName } : {}
+    },
+    chat: {
+      type: inferChatType(context),
+      id: executionContext.source.chatId,
+      ...executionContext.source.threadId ? { threadId: executionContext.source.threadId } : {}
+    },
+    messageId: executionContext.source.messageId,
+    ...context.content.referencedMessageId ? { replyToMessageId: context.content.referencedMessageId } : {},
+    env: buildOmniEnv(context, executionContext),
+    executionContext
+  };
+}
+var OMNI_EXECUTION_CONTEXT_EXTENSION_URI = "https://omni.dev/extensions/execution-context/v1";
+
 // ../core/src/providers/agno-client.ts
 class AgnoClient {
   baseUrl;
@@ -60159,12 +60272,11 @@ class AgnoAgentProvider {
       message2 = `[${context.sender.displayName}]: ${message2}`;
     }
     const request = {
+      ...buildProviderRequestContext(context),
       message: message2,
       agentId: this.config.agentId,
       agentType: this.config.agentType,
       stream: false,
-      sessionId: context.sessionId,
-      userId: context.sender.platformUserId,
       timeoutMs: this.config.timeoutMs ?? 60000
     };
     log8.info("Triggering Agno agent", {
@@ -60220,20 +60332,6 @@ function boundContextMessages(contextMessages) {
   }
   return bounded;
 }
-function buildOmniEnv(context) {
-  return {
-    ...context.env ?? {},
-    OMNI_INSTANCE: context.source.instanceId,
-    OMNI_CHAT: context.source.chatId,
-    OMNI_MESSAGE: context.source.messageId,
-    OMNI_CHANNEL: context.source.channelType,
-    OMNI_SESSION: context.sessionId,
-    OMNI_TRACE_ID: context.traceId,
-    OMNI_SENDER: context.sender.platformUserId,
-    ...context.sender.personId ? { OMNI_PERSON_ID: context.sender.personId } : {},
-    ...context.source.threadId ? { OMNI_THREAD: context.source.threadId } : {}
-  };
-}
 
 class ClaudeCodeAgentProvider {
   id;
@@ -60357,13 +60455,12 @@ ${fileList}`;
     }
     const { message: message2, resolvedSessionId, internalSessionKey } = prepared;
     const request = {
+      ...buildProviderRequestContext(context),
       message: message2,
       agentId: "claude-code",
       stream: false,
       sessionId: resolvedSessionId,
-      userId: context.sender.personId ?? context.sender.platformUserId,
       timeoutMs: this.options.timeoutMs ?? 120000,
-      env: buildOmniEnv(context),
       ...context.source.chatId ? { mcpUrlParams: { chat_id: context.source.chatId } } : {}
     };
     log9.info("Triggering Claude Code agent", {
@@ -60400,13 +60497,12 @@ ${fileList}`;
     }
     const { message: message2, resolvedSessionId, internalSessionKey } = prepared;
     const request = {
+      ...buildProviderRequestContext(context),
       message: message2,
       agentId: "claude-code",
       stream: true,
       sessionId: resolvedSessionId,
-      userId: context.sender.personId ?? context.sender.platformUserId,
       timeoutMs: this.options.timeoutMs ?? 120000,
-      env: buildOmniEnv(context),
       ...context.source.chatId ? { mcpUrlParams: { chat_id: context.source.chatId } } : {}
     };
     log9.info("Triggering Claude Code agent (stream)", {
@@ -60502,6 +60598,7 @@ class WebhookAgentProvider {
         emoji: context.content.emoji
       },
       traceId: context.traceId,
+      executionContext: buildOmniExecutionContext(context),
       replyEndpoint: "POST /api/v2/messages/send"
     };
     log10.info("Sending webhook trigger", {
@@ -61917,10 +62014,9 @@ class AgUiAgentProvider {
       return { parts: [], metadata: { runId: "", providerId: this.id, durationMs: 0 } };
     }
     const request = {
+      ...buildProviderRequestContext(context),
       message: message2,
       agentId: this.config.agentId,
-      sessionId: context.sessionId,
-      userId: context.sender.platformUserId,
       timeoutMs: this.config.timeoutMs ?? 60000
     };
     log14.info("Triggering AG-UI agent", { agentId: this.config.agentId, traceId: context.traceId });
@@ -61947,10 +62043,9 @@ class AgUiAgentProvider {
       return;
     }
     const request = {
+      ...buildProviderRequestContext(context),
       message: message2,
       agentId: this.config.agentId,
-      sessionId: context.sessionId,
-      userId: context.sender.platformUserId,
       timeoutMs: this.config.timeoutMs ?? 60000
     };
     log14.info("Streaming AG-UI agent", { agentId: this.config.agentId, traceId: context.traceId });
@@ -62109,16 +62204,23 @@ class A2AClient {
     }
   }
   buildJsonRpcRequest(method, request) {
+    const message2 = {
+      role: "ROLE_USER",
+      parts: [{ text: request.message, mediaType: "text/plain" }],
+      messageId: `msg-${crypto.randomUUID()}`
+    };
+    if (request.executionContext) {
+      message2.extensions = [OMNI_EXECUTION_CONTEXT_EXTENSION_URI];
+      message2.metadata = {
+        omniExecutionContext: request.executionContext
+      };
+    }
     return {
       jsonrpc: "2.0",
       id: `omni-${crypto.randomUUID()}`,
       method,
       params: {
-        message: {
-          role: "ROLE_USER",
-          parts: [{ text: request.message, mediaType: "text/plain" }],
-          messageId: `msg-${crypto.randomUUID()}`
-        },
+        message: message2,
         configuration: {
           acceptedOutputModes: ["text/plain"],
           returnImmediately: true
@@ -62334,10 +62436,9 @@ class A2AAgentProvider {
       return { parts: [], metadata: { runId: "", providerId: this.id, durationMs: 0 } };
     }
     const request = {
+      ...buildProviderRequestContext(context),
       message: message2,
       agentId: this.config.agentId,
-      sessionId: context.sessionId,
-      userId: context.sender.platformUserId,
       timeoutMs: this.config.timeoutMs ?? 60000
     };
     log16.info("Triggering A2A agent", { agentId: this.config.agentId, traceId: context.traceId });
@@ -62367,10 +62468,9 @@ class A2AAgentProvider {
       return;
     }
     const request = {
+      ...buildProviderRequestContext(context),
       message: message2,
       agentId: this.config.agentId,
-      sessionId: context.sessionId,
-      userId: context.sender.platformUserId,
       timeoutMs: this.config.timeoutMs ?? 60000
     };
     log16.info("Streaming A2A agent", { agentId: this.config.agentId, traceId: context.traceId });
@@ -62466,7 +62566,8 @@ class NatsGenieProvider {
       traceId: context.traceId,
       messageId: context.source.messageId,
       files: context.content.files,
-      env: context.env
+      env: buildOmniEnv(context),
+      executionContext: buildOmniExecutionContext(context)
     };
     try {
       await this.ensureConnected();
@@ -63449,6 +63550,9 @@ __export(exports_src, {
   calculateBackoffDelay: () => calculateBackoffDelay,
   buildSubscribePattern: () => buildSubscribePattern,
   buildSubject: () => buildSubject,
+  buildProviderRequestContext: () => buildProviderRequestContext,
+  buildOmniExecutionContext: () => buildOmniExecutionContext,
+  buildOmniEnv: () => buildOmniEnv,
   buildConversationKey: () => buildConversationKey,
   buildConsumerConfig: () => buildConsumerConfig,
   armSequence: () => armSequence,
@@ -63493,6 +63597,7 @@ __export(exports_src, {
   OpenClawAgentProvider: () => OpenClawAgentProvider,
   OmniEventRecordSchema: () => OmniEventRecordSchema,
   OmniError: () => OmniError,
+  OMNI_EXECUTION_CONTEXT_EXTENSION_URI: () => OMNI_EXECUTION_CONTEXT_EXTENSION_URI,
   NotFoundError: () => NotFoundError,
   NonEmptyStringSchema: () => NonEmptyStringSchema,
   NatsGenieProvider: () => NatsGenieProvider,
@@ -63551,6 +63656,7 @@ __export(exports_src, {
   DEFAULT_CONSUMER_CONFIG: () => DEFAULT_CONSUMER_CONFIG,
   DEFAULT_CACHE_CONFIG: () => DEFAULT_CACHE_CONFIG,
   DEBOUNCE_MODES: () => DEBOUNCE_MODES,
+  CustomEventSchemas: () => CustomEventSchemas,
   CronExpressions: () => CronExpressions,
   CreatePlatformIdentitySchema: () => CreatePlatformIdentitySchema,
   CreatePersonSchema: () => CreatePersonSchema,
@@ -124617,7 +124723,7 @@ import { fileURLToPath } from "url";
 // package.json
 var package_default = {
   name: "@automagik/omni",
-  version: "2.260525.2",
+  version: "2.260529.1",
   description: "LLM-optimized CLI for Omni",
   type: "module",
   bin: {
@@ -133978,7 +134084,7 @@ function createMessagesCommand() {
         error("--chat is required");
         return;
       }
-      const resolvedMessageId = await resolveMessageId(messageId);
+      const resolvedMessageId = await resolveMessageId(messageId, channelId);
       const instanceId = await resolveInstanceId(options.instance);
       const config2 = (await Promise.resolve().then(() => (init_config(), exports_config))).loadConfig();
       const baseUrl = config2.apiUrl ?? "http://localhost:8882";

package/dist/server/index.js

@@ -22418,7 +22418,12 @@ function createEventSchema(eventType, schema, options) {
     description: options?.description
   };
 }
-var log2, eventRegistry, SystemEventSchemas;
+function registerSchemas(entries) {
+  for (const entry of entries) {
+    eventRegistry.register(entry);
+  }
+}
+var log2, eventRegistry, SystemEventSchemas, CustomEventSchemas;
 var init_registry = __esm(() => {
   init_zod();
   init_logger();
@@ -22452,6 +22457,25 @@ var init_registry = __esm(() => {
       severity: exports_external.enum(["warning", "critical"])
     }), { description: "System health degradation detected" })
   };
+  CustomEventSchemas = {
+    chatUnreadUpdated: createEventSchema("custom.chat.unread-updated", exports_external.object({
+      chatId: exports_external.string(),
+      unreadCount: exports_external.number()
+    }), { description: "Platform-native chat unread count update" }),
+    contactsNames: createEventSchema("custom.contacts.names", exports_external.object({
+      names: exports_external.array(exports_external.object({
+        jid: exports_external.string(),
+        name: exports_external.string()
+      }))
+    }), { description: "Contact display names discovered by a channel" }),
+    lidMappingBatch: createEventSchema("custom.lid-mapping.batch", exports_external.object({
+      mappings: exports_external.array(exports_external.object({
+        lidJid: exports_external.string(),
+        phoneJid: exports_external.string()
+      }))
+    }), { description: "Batch of WhatsApp LID to phone JID mappings" })
+  };
+  registerSchemas([...Object.values(SystemEventSchemas), ...Object.values(CustomEventSchemas)]);
 });
 
 // ../core/src/events/nats/subjects.ts
@@ -29417,6 +29441,100 @@ var init_types7 = __esm(() => {
   };
 });
 
+// ../core/src/providers/execution-context.ts
+function compactEnv(values) {
+  return Object.fromEntries(Object.entries(values).filter(([, value]) => value !== undefined));
+}
+function inferChatType(context2) {
+  if (context2.type === "dm")
+    return "dm";
+  if (context2.source.chatId === context2.sender.platformUserId)
+    return "dm";
+  if (context2.source.threadId)
+    return "channel";
+  return "group";
+}
+function compactCustomer(customer) {
+  if (!customer)
+    return;
+  const compacted = Object.fromEntries(Object.entries(customer).filter(([, value]) => value !== undefined));
+  return Object.keys(compacted).length > 0 ? compacted : undefined;
+}
+function buildOmniExecutionContext(context2) {
+  const userId = context2.sender.personId ?? context2.sender.platformUserId;
+  const sessionId = context2.sessionId || context2.source.threadId || context2.source.chatId || userId;
+  const customer = compactCustomer(context2.customer);
+  return {
+    identity: {
+      userId,
+      ...context2.sender.personId ? { personId: context2.sender.personId } : {},
+      platformUserId: context2.sender.platformUserId,
+      ...context2.sender.displayName ? { displayName: context2.sender.displayName } : {}
+    },
+    source: {
+      channel: context2.source.channelType,
+      instanceId: context2.source.instanceId,
+      chatId: context2.source.chatId,
+      ...context2.source.threadId ? { threadId: context2.source.threadId } : {},
+      messageId: context2.source.messageId
+    },
+    session: {
+      id: sessionId,
+      ...context2.sessionStrategy ? { strategy: context2.sessionStrategy } : {}
+    },
+    trace: {
+      id: context2.traceId
+    },
+    ...customer ? { customer } : {}
+  };
+}
+function buildOmniEnv(context2, executionContext = buildOmniExecutionContext(context2)) {
+  return compactEnv({
+    ...context2.env ?? {},
+    OMNI_USER_ID: executionContext.identity.userId,
+    OMNI_PERSON_ID: executionContext.identity.personId,
+    OMNI_PLATFORM_USER_ID: executionContext.identity.platformUserId,
+    OMNI_SENDER: executionContext.identity.platformUserId,
+    OMNI_DISPLAY_NAME: executionContext.identity.displayName,
+    OMNI_INSTANCE: executionContext.source.instanceId,
+    OMNI_CHAT: executionContext.source.chatId,
+    OMNI_MESSAGE: executionContext.source.messageId,
+    OMNI_CHANNEL: executionContext.source.channel,
+    OMNI_SESSION: executionContext.session.id,
+    OMNI_TRACE_ID: executionContext.trace.id,
+    OMNI_THREAD: executionContext.source.threadId,
+    OMNI_EXTERNAL_USER_ID: executionContext.customer?.externalUserId,
+    OMNI_CUSTOMER_ID: executionContext.customer?.customerId,
+    OMNI_ORGANIZATION_ID: executionContext.customer?.organizationId,
+    OMNI_TENANT_ID: executionContext.customer?.tenantId
+  });
+}
+function buildProviderRequestContext(context2) {
+  const executionContext = buildOmniExecutionContext(context2);
+  return {
+    userId: executionContext.identity.userId,
+    sessionId: executionContext.session.id,
+    platform: {
+      id: executionContext.identity.platformUserId,
+      channel: executionContext.source.channel,
+      instanceId: executionContext.source.instanceId
+    },
+    sender: {
+      ...executionContext.identity.displayName ? { displayName: executionContext.identity.displayName } : {}
+    },
+    chat: {
+      type: inferChatType(context2),
+      id: executionContext.source.chatId,
+      ...executionContext.source.threadId ? { threadId: executionContext.source.threadId } : {}
+    },
+    messageId: executionContext.source.messageId,
+    ...context2.content.referencedMessageId ? { replyToMessageId: context2.content.referencedMessageId } : {},
+    env: buildOmniEnv(context2, executionContext),
+    executionContext
+  };
+}
+var OMNI_EXECUTION_CONTEXT_EXTENSION_URI = "https://omni.dev/extensions/execution-context/v1";
+
 // ../core/src/providers/agno-client.ts
 class AgnoClient {
   baseUrl;
@@ -30462,12 +30580,11 @@ class AgnoAgentProvider {
       message2 = `[${context2.sender.displayName}]: ${message2}`;
     }
     const request = {
+      ...buildProviderRequestContext(context2),
       message: message2,
       agentId: this.config.agentId,
       agentType: this.config.agentType,
       stream: false,
-      sessionId: context2.sessionId,
-      userId: context2.sender.platformUserId,
       timeoutMs: this.config.timeoutMs ?? 60000
     };
     log8.info("Triggering Agno agent", {
@@ -30523,20 +30640,6 @@ function boundContextMessages(contextMessages) {
   }
   return bounded;
 }
-function buildOmniEnv(context2) {
-  return {
-    ...context2.env ?? {},
-    OMNI_INSTANCE: context2.source.instanceId,
-    OMNI_CHAT: context2.source.chatId,
-    OMNI_MESSAGE: context2.source.messageId,
-    OMNI_CHANNEL: context2.source.channelType,
-    OMNI_SESSION: context2.sessionId,
-    OMNI_TRACE_ID: context2.traceId,
-    OMNI_SENDER: context2.sender.platformUserId,
-    ...context2.sender.personId ? { OMNI_PERSON_ID: context2.sender.personId } : {},
-    ...context2.source.threadId ? { OMNI_THREAD: context2.source.threadId } : {}
-  };
-}
 
 class ClaudeCodeAgentProvider {
   id;
@@ -30660,13 +30763,12 @@ ${fileList}`;
     }
     const { message: message2, resolvedSessionId, internalSessionKey } = prepared;
     const request = {
+      ...buildProviderRequestContext(context2),
       message: message2,
       agentId: "claude-code",
       stream: false,
       sessionId: resolvedSessionId,
-      userId: context2.sender.personId ?? context2.sender.platformUserId,
       timeoutMs: this.options.timeoutMs ?? 120000,
-      env: buildOmniEnv(context2),
       ...context2.source.chatId ? { mcpUrlParams: { chat_id: context2.source.chatId } } : {}
     };
     log9.info("Triggering Claude Code agent", {
@@ -30703,13 +30805,12 @@ ${fileList}`;
     }
     const { message: message2, resolvedSessionId, internalSessionKey } = prepared;
     const request = {
+      ...buildProviderRequestContext(context2),
       message: message2,
       agentId: "claude-code",
       stream: true,
       sessionId: resolvedSessionId,
-      userId: context2.sender.personId ?? context2.sender.platformUserId,
       timeoutMs: this.options.timeoutMs ?? 120000,
-      env: buildOmniEnv(context2),
       ...context2.source.chatId ? { mcpUrlParams: { chat_id: context2.source.chatId } } : {}
     };
     log9.info("Triggering Claude Code agent (stream)", {
@@ -30805,6 +30906,7 @@ class WebhookAgentProvider {
         emoji: context2.content.emoji
       },
       traceId: context2.traceId,
+      executionContext: buildOmniExecutionContext(context2),
       replyEndpoint: "POST /api/v2/messages/send"
     };
     log10.info("Sending webhook trigger", {
@@ -32201,10 +32303,9 @@ class AgUiAgentProvider {
       return { parts: [], metadata: { runId: "", providerId: this.id, durationMs: 0 } };
     }
     const request = {
+      ...buildProviderRequestContext(context2),
       message: message2,
       agentId: this.config.agentId,
-      sessionId: context2.sessionId,
-      userId: context2.sender.platformUserId,
       timeoutMs: this.config.timeoutMs ?? 60000
     };
     log14.info("Triggering AG-UI agent", { agentId: this.config.agentId, traceId: context2.traceId });
@@ -32231,10 +32332,9 @@ class AgUiAgentProvider {
       return;
     }
     const request = {
+      ...buildProviderRequestContext(context2),
       message: message2,
       agentId: this.config.agentId,
-      sessionId: context2.sessionId,
-      userId: context2.sender.platformUserId,
       timeoutMs: this.config.timeoutMs ?? 60000
     };
     log14.info("Streaming AG-UI agent", { agentId: this.config.agentId, traceId: context2.traceId });
@@ -32380,16 +32480,23 @@ class A2AClient {
     }
   }
   buildJsonRpcRequest(method, request) {
+    const message2 = {
+      role: "ROLE_USER",
+      parts: [{ text: request.message, mediaType: "text/plain" }],
+      messageId: `msg-${crypto.randomUUID()}`
+    };
+    if (request.executionContext) {
+      message2.extensions = [OMNI_EXECUTION_CONTEXT_EXTENSION_URI];
+      message2.metadata = {
+        omniExecutionContext: request.executionContext
+      };
+    }
     return {
       jsonrpc: "2.0",
       id: `omni-${crypto.randomUUID()}`,
       method,
       params: {
-        message: {
-          role: "ROLE_USER",
-          parts: [{ text: request.message, mediaType: "text/plain" }],
-          messageId: `msg-${crypto.randomUUID()}`
-        },
+        message: message2,
         configuration: {
           acceptedOutputModes: ["text/plain"],
           returnImmediately: true
@@ -32605,10 +32712,9 @@ class A2AAgentProvider {
       return { parts: [], metadata: { runId: "", providerId: this.id, durationMs: 0 } };
     }
     const request = {
+      ...buildProviderRequestContext(context2),
       message: message2,
       agentId: this.config.agentId,
-      sessionId: context2.sessionId,
-      userId: context2.sender.platformUserId,
       timeoutMs: this.config.timeoutMs ?? 60000
     };
     log16.info("Triggering A2A agent", { agentId: this.config.agentId, traceId: context2.traceId });
@@ -32638,10 +32744,9 @@ class A2AAgentProvider {
       return;
     }
     const request = {
+      ...buildProviderRequestContext(context2),
       message: message2,
       agentId: this.config.agentId,
-      sessionId: context2.sessionId,
-      userId: context2.sender.platformUserId,
       timeoutMs: this.config.timeoutMs ?? 60000
     };
     log16.info("Streaming A2A agent", { agentId: this.config.agentId, traceId: context2.traceId });
@@ -32724,7 +32829,8 @@ class NatsGenieProvider {
       traceId: context2.traceId,
       messageId: context2.source.messageId,
       files: context2.content.files,
-      env: context2.env
+      env: buildOmniEnv(context2),
+      executionContext: buildOmniExecutionContext(context2)
     };
     try {
       await this.ensureConnected();
@@ -230186,7 +230292,7 @@ var init_sentry_scrub = __esm(() => {
 var require_package8 = __commonJS((exports, module) => {
   module.exports = {
     name: "@omni/api",
-    version: "2.260525.2",
+    version: "2.260529.1",
     type: "module",
     exports: {
       ".": {
@@ -331775,7 +331881,7 @@ function resolveEffectiveChatName(params) {
 function mapContentType(contentType) {
   return CONTENT_TYPE_MAP[contentType ?? ""] ?? "text";
 }
-function inferChatType(chatId, isGroup) {
+function inferChatType2(chatId, isGroup) {
   if (chatId.includes("@g.us") || chatId.includes("@broadcast"))
     return "group";
   if (chatId.includes("@newsletter"))
@@ -332047,7 +332153,7 @@ async function handleMessageReceived(services, payload, metadata, eventTimestamp
   const chatExternalId = truncate3(payload.chatId, 255) ?? payload.chatId;
   const messageExternalId = truncate3(payload.externalId, 255) ?? payload.externalId;
   const rawPayload = payload.rawPayload ? deepSanitize(payload.rawPayload) : undefined;
-  const chatType = inferChatType(payload.chatId, rawPayload?.isGroup);
+  const chatType = inferChatType2(payload.chatId, rawPayload?.isGroup);
   const isFromMe2 = rawPayload?.isFromMe === true;
   const pushName = truncate3(payload.senderName ?? rawPayload?.pushName, 255);
   const chatName = truncate3(payload.chatName ?? rawPayload?.chatName, 255);
@@ -332149,7 +332255,7 @@ async function setupMessagePersistence(eventBus, services) {
         const chatExternalId = truncate3(payload.chatId, 255) ?? payload.chatId;
         const messageExternalId = truncate3(payload.externalId, 255) ?? payload.externalId;
         const { chat: chat2 } = await services.chats.findOrCreate(metadata.instanceId, chatExternalId, {
-          chatType: inferChatType(payload.chatId),
+          chatType: inferChatType2(payload.chatId),
           channel: metadata.channelType ?? "whatsapp"
         });
         const sentContent = buildSentMessageContentFields(payload);
@@ -332754,6 +332860,26 @@ async function waitForRecord(fn, maxMs = 5000, pollMs = 250) {
   }
   return null;
 }
+function awaitMediaCompletion(msgId) {
+  return new Promise((resolvePromise, rejectPromise) => {
+    mediaCompletions.set(msgId, { resolve: resolvePromise, reject: rejectPromise, createdAt: Date.now() });
+    setTimeout(() => {
+      if (mediaCompletions.has(msgId)) {
+        mediaCompletions.delete(msgId);
+        rejectPromise(new Error(`media wait timeout (${MEDIA_WAIT_TIMEOUT_MS}ms)`));
+      }
+    }, MEDIA_WAIT_TIMEOUT_MS);
+  });
+}
+async function recoverProcessedMediaAfterTimeout(services, chatRecordId, externalId, column2) {
+  const refreshed = await services.messages.getByExternalId(chatRecordId, externalId);
+  if (!refreshed)
+    return null;
+  const recovered = checkProcessedColumn(refreshed, column2);
+  if (recovered === "pending" || recovered === "error")
+    return null;
+  return recovered;
+}
 async function awaitMediaProcessing(services, instanceId, chatId, externalId, contentType) {
   const column2 = getProcessedColumn(contentType);
   if (!column2)
@@ -332783,9 +332909,22 @@ async function awaitMediaProcessing(services, instanceId, chatId, externalId, co
     const localPath2 = msg.mediaLocalPath ? resolve2(join19(MEDIA_BASE_PATH3, msg.mediaLocalPath)) : null;
     return { content: cached.content, localPath: localPath2 };
   }
-  const result = await new Promise((resolvePromise, rejectPromise) => {
-    mediaCompletions.set(msg.id, { resolve: resolvePromise, reject: rejectPromise, createdAt: Date.now() });
-  });
+  let result;
+  try {
+    result = await awaitMediaCompletion(msg.id);
+  } catch (error3) {
+    log94.warn("Media wait timed out, retrying DB read", {
+      instanceId,
+      chatId,
+      externalId,
+      msgId: msg.id,
+      error: String(error3)
+    });
+    const recovered = await recoverProcessedMediaAfterTimeout(services, chat2.id, externalId, column2);
+    if (recovered)
+      return recovered;
+    return MEDIA_WAIT_NULL;
+  }
   if (!result.content || result.error)
     return MEDIA_WAIT_NULL;
   const updated = await services.messages.getByExternalId(chat2.id, externalId);
@@ -333014,6 +333153,62 @@ async function resolvePersonId(services, channel5, instanceId, senderId, metadat
   }
   return;
 }
+function isRecord(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function pickString(record, ...keys) {
+  for (const key of keys) {
+    const value = record[key];
+    if (typeof value === "string" && value.length > 0)
+      return value;
+  }
+  return;
+}
+function compactCustomerContext(context20) {
+  const compacted = Object.fromEntries(Object.entries(context20).filter(([, value]) => value !== undefined));
+  return Object.keys(compacted).length > 0 ? compacted : undefined;
+}
+function customerContextFromRecord(record) {
+  return compactCustomerContext({
+    externalUserId: pickString(record, "externalUserId", "external_user_id"),
+    customerId: pickString(record, "customerId", "customer_id"),
+    organizationId: pickString(record, "organizationId", "organization_id", "orgId", "org_id"),
+    tenantId: pickString(record, "tenantId", "tenant_id")
+  });
+}
+function extractA2ACustomerContext(messages4, channel5) {
+  if (channel5 !== "a2a")
+    return;
+  const rawPayload = messages4[0]?.payload.rawPayload;
+  if (!isRecord(rawPayload))
+    return;
+  const executionContext = rawPayload.omniExecutionContext;
+  if (!isRecord(executionContext))
+    return;
+  const customer = isRecord(executionContext.customer) ? executionContext.customer : {};
+  const identity = isRecord(executionContext.identity) ? executionContext.identity : {};
+  return compactCustomerContext({
+    ...customerContextFromRecord(customer),
+    externalUserId: pickString(customer, "externalUserId", "external_user_id") ?? pickString(identity, "platformUserId", "userId")
+  });
+}
+async function resolveCustomerContext(services, personId, externalContext) {
+  let storedContext;
+  if (personId) {
+    try {
+      const person2 = await services.persons.getById(personId);
+      if (person2 && isRecord(person2.metadata)) {
+        storedContext = customerContextFromRecord(person2.metadata);
+      }
+    } catch (error3) {
+      log94.debug("Failed to resolve customer context", { personId, error: String(error3) });
+    }
+  }
+  return compactCustomerContext({
+    ...externalContext ?? {},
+    ...storedContext ?? {}
+  });
+}
 async function fetchSenderMetadata(services, channel5, instanceId, senderId) {
   try {
     const identity = await services.persons.getIdentityByPlatformId(channel5, instanceId, senderId);
@@ -333168,7 +333363,7 @@ async function executeBeforeMessageWriteHooks(instanceId, chatId, content) {
   });
   return result.context.content;
 }
-function buildMessageTrigger(traceId, triggerType, rawEvent, channel5, instance4, chatId, senderId, personId, senderName, messages4, messageTexts, triggerFiles, sessionId, allContextMessages) {
+function buildMessageTrigger(traceId, triggerType, rawEvent, channel5, instance4, chatId, senderId, personId, senderName, messages4, messageTexts, triggerFiles, sessionId, customerContext, allContextMessages) {
   const threadId2 = extractThreadId(messages4);
   const env2 = {};
   if (instance4.bridgeTmuxSession) {
@@ -333197,6 +333392,8 @@ function buildMessageTrigger(traceId, triggerType, rawEvent, channel5, instance4
       referencedMessageId: messages4[0]?.payload.replyToId || undefined
     },
     sessionId,
+    sessionStrategy: instance4.agentSessionStrategy ?? "per_chat",
+    customer: customerContext,
     contextMessages: allContextMessages.length > 0 ? allContextMessages : undefined,
     env: Object.keys(env2).length > 0 ? env2 : undefined
   };
@@ -333219,7 +333416,8 @@ async function dispatchViaStreamingProvider(services, instance4, messages4, trig
   const allContextMessages = mergeContextMessages(extraContextMessages, dbContextMessages);
   const triggerFiles = toTriggerFiles(mediaFiles);
   await executeBeforeAgentStartHooks(instance4, chatId, senderId, senderName, triggerType, traceId, messages4[0]?.metadata.correlationId, triggerFiles);
-  const trigger = buildMessageTrigger(traceId, triggerType, rawEvent, channel5, instance4, chatId, senderId, personId, senderName, messages4, messageTexts, triggerFiles, sessionId, allContextMessages);
+  const customerContext = await resolveCustomerContext(services, personId, extractA2ACustomerContext(messages4, channel5));
+  const trigger = buildMessageTrigger(traceId, triggerType, rawEvent, channel5, instance4, chatId, senderId, personId, senderName, messages4, messageTexts, triggerFiles, sessionId, customerContext, allContextMessages);
   const chatType = determineChatType(chatId, channel5, rawPl);
   const formatMode = instance4.messageFormatMode ?? "convert";
   const sender = resolved.createSender(instance4.id, chatId, replyToId, chatType, { formatMode });
@@ -333438,7 +333636,8 @@ async function dispatchViaProvider(services, instance4, messages4, triggerType,
   const allContextMessages = mergeContextMessages(extraContextMessages, dbContextMessages);
   const triggerFiles = toTriggerFiles(mediaFiles);
   await executeBeforeAgentStartHooks(instance4, chatId, senderId, senderName, triggerType, traceId, messages4[0]?.metadata.correlationId, triggerFiles);
-  const trigger = buildMessageTrigger(traceId, triggerType, rawEvent, channel5, instance4, chatId, senderId, personId, senderName, messages4, messageTexts, triggerFiles, sessionId, allContextMessages);
+  const customerContext = await resolveCustomerContext(services, personId, extractA2ACustomerContext(messages4, channel5));
+  const trigger = buildMessageTrigger(traceId, triggerType, rawEvent, channel5, instance4, chatId, senderId, personId, senderName, messages4, messageTexts, triggerFiles, sessionId, customerContext, allContextMessages);
   if (provider.mode === "turn-based") {
     return dispatchViaTurnBasedProvider(services, instance4, provider, trigger, messages4, chatId, traceId, db2);
   }
@@ -334301,6 +334500,7 @@ async function processReactionTrigger(services, baseInstance, payload, metadata,
       const effectivePersonId = reactionPersonId ?? metadata.personId;
       const senderName2 = await services.agentRunner.getSenderName(effectivePersonId, undefined);
       const sessionId = computeSessionId(instance4.agentSessionStrategy ?? "per_chat", payload.from, externalChatId);
+      const customerContext = await resolveCustomerContext(services, effectivePersonId);
       const trigger = {
         traceId: metadata.traceId,
         type: "reaction",
@@ -334320,7 +334520,9 @@ async function processReactionTrigger(services, baseInstance, payload, metadata,
           emoji: payload.emoji,
           referencedMessageId: payload.messageId
         },
-        sessionId
+        sessionId,
+        sessionStrategy: instance4.agentSessionStrategy ?? "per_chat",
+        customer: customerContext
       };
       const result2 = await provider.trigger(trigger);
       if (result2 && result2.parts.length > 0) {
@@ -334974,7 +335176,7 @@ async function setupAgentDispatcher(eventBus, services, db2) {
     log94.info("Agent dispatcher shutdown complete");
   };
 }
-var log94, _natsGenieProviderCtor, QUOTED_MESSAGE_MAX_CHARS = 4000, DM_HISTORY_LIMIT = 20, TRANSIENT_DISPATCH_ERROR_PATTERNS, TRANSIENT_DISPATCH_RETRY_DELAYS_MS, CHANNEL_MESSAGE_LIMITS, DEFAULT_MESSAGE_LIMIT = 4000, MEDIA_BASE_PATH3, MEDIA_ICONS, MEDIA_WAIT_NULL, mediaCompletions, mediaResultCache, DEFAULT_SEND_MEDIA_PATH_TYPES, BOT_PREFIX = "\uD83E\uDD16 ", activeStreams, sessionActivityStore, PROC_REACT_START, PROC_REACT_DONE = "\u2705", providerCache, openclawClientPool, nullFilterWarnedInstances, DEFAULT_GATE_MODEL = "gemini-3-flash-preview", GATE_TIMEOUT_MS = 3000, setupAgentResponder;
+var log94, _natsGenieProviderCtor, QUOTED_MESSAGE_MAX_CHARS = 4000, DM_HISTORY_LIMIT = 20, TRANSIENT_DISPATCH_ERROR_PATTERNS, TRANSIENT_DISPATCH_RETRY_DELAYS_MS, CHANNEL_MESSAGE_LIMITS, DEFAULT_MESSAGE_LIMIT = 4000, MEDIA_BASE_PATH3, MEDIA_ICONS, MEDIA_WAIT_NULL, mediaCompletions, mediaResultCache, MEDIA_WAIT_TIMEOUT_MS = 30000, DEFAULT_SEND_MEDIA_PATH_TYPES, BOT_PREFIX = "\uD83E\uDD16 ", activeStreams, sessionActivityStore, PROC_REACT_START, PROC_REACT_DONE = "\u2705", providerCache, openclawClientPool, nullFilterWarnedInstances, DEFAULT_GATE_MODEL = "gemini-3-flash-preview", GATE_TIMEOUT_MS = 3000, setupAgentResponder;
 var init_agent_dispatcher = __esm(() => {
   init_src2();
   init_src();
@@ -342675,7 +342877,7 @@ var init_dist6 = __esm(() => {
 });
 
 // ../api/src/services/a2a-discovery.ts
-function isRecord(value) {
+function isRecord2(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }
 function stringOverride(value) {
@@ -342722,7 +342924,7 @@ function buildDefaultSkills(capabilities3) {
 }
 function buildA2AAgentCard(params) {
   const { baseUrl, agent: agent3, instance: instance4 } = params;
-  const override = isRecord(agent3.agentCard) ? agent3.agentCard : {};
+  const override = isRecord2(agent3.agentCard) ? agent3.agentCard : {};
   const capabilities3 = agent3.capabilities ?? [];
   const endpointUrl = `${normalizeBaseUrl(baseUrl)}/a2a/${instance4.id}`;
   const card = {
@@ -342740,8 +342942,16 @@ function buildA2AAgentCard(params) {
       streaming: true,
       pushNotifications: false,
       extendedAgentCard: false,
-      ...isRecord(override.capabilities) ? override.capabilities : {}
+      ...isRecord2(override.capabilities) ? override.capabilities : {}
     },
+    extensions: Array.isArray(override.extensions) ? override.extensions : [
+      {
+        uri: OMNI_EXECUTION_CONTEXT_EXTENSION_URI,
+        description: "Omni execution context metadata for user, source, session, trace, and customer identity.",
+        version: "1.0",
+        required: false
+      }
+    ],
     defaultInputModes: stringArray(override.defaultInputModes) ?? ["text/plain"],
     defaultOutputModes: stringArray(override.defaultOutputModes) ?? ["text/plain"],
     skills: Array.isArray(override.skills) ? override.skills : buildDefaultSkills(capabilities3),
@@ -342760,14 +342970,14 @@ function buildA2AAgentCard(params) {
           description: "Legacy Omni API key header."
         }
       },
-      ...isRecord(override.securitySchemes) ? override.securitySchemes : {}
+      ...isRecord2(override.securitySchemes) ? override.securitySchemes : {}
     },
     securityRequirements: [{ schemes: { bearerAuth: { list: [] } } }, { schemes: { apiKeyHeader: { list: [] } } }]
   };
-  const providerOverride = isRecord(override.provider) ? override.provider : undefined;
+  const providerOverride = isRecord2(override.provider) ? override.provider : undefined;
   if (providerOverride)
     card.provider = providerOverride;
-  const metadataOverride = isRecord(override.metadata) ? override.metadata : undefined;
+  const metadataOverride = isRecord2(override.metadata) ? override.metadata : undefined;
   if (metadataOverride)
     card.metadata = metadataOverride;
   const iconUrl = stringOverride(override.iconUrl);
@@ -342854,6 +343064,9 @@ async function resolveA2AAgentCard(params) {
     provider
   };
 }
+var init_a2a_discovery = __esm(() => {
+  init_src();
+});
 
 // ../api/src/routes/v2/a2a.ts
 function baseUrlFromRequest(url) {
@@ -342864,6 +343077,7 @@ var init_a2a = __esm(() => {
   init_dist6();
   init_dist2();
   init_zod();
+  init_a2a_discovery();
   a2aRoutes = new Hono2;
   listQuerySchema = exports_external.object({
     includeUnconfigured: exports_external.coerce.boolean().optional().default(false)
@@ -349803,6 +350017,14 @@ async function verifyMessageInstanceOwnership(services, message2, instanceId) {
     });
   }
 }
+async function resolveChannelMessageId(services, messageId, instanceId) {
+  if (!isUUID(messageId))
+    return messageId;
+  const message2 = await services.messages.getById(messageId);
+  await verifyMessageInstanceOwnership(services, message2, instanceId);
+  log105.debug("Resolved internal UUID to external ID", { messageId, externalId: message2.externalId });
+  return message2.externalId;
+}
 var log105, mediaDownloadLog, messagesRoutes, MIME_BY_EXTENSION, DEFAULT_MIME_BY_MEDIA_TYPE, UUID_REGEX2, MessageSourceSchema, MessageTypeSchema, MessageStatusSchema, DeliveryStatusSchema, listQuerySchema14, createMessageSchema, updateMessageSchema, recordEditSchema, addReactionSchema, removeReactionSchema, updateDeliveryStatusSchema, MentionSchema, sendTextSchema, sendMediaSchema, sendReactionSchema, sendStickerSchema, sendContactSchema, sendLocationSchema, sendHandoffSchema, sendCloseContactSchema, messageRefSchema, _mediaStorageForDownload = null, sendTtsSchema, forwardMessageSchema, sendPresenceSchema, markMessageReadSchema, markBatchReadSchema, sendPollSchema, sendEmbedSchema, editMessageChannelSchema, deleteMessageChannelSchema, starMessageSchema;
 var init_messages5 = __esm(() => {
   init_dist6();
@@ -351337,13 +351559,7 @@ var init_messages5 = __esm(() => {
         recoverable: false
       });
     }
-    let resolvedMessageId = messageId;
-    if (isUUID(messageId)) {
-      const message2 = await services.messages.getById(messageId);
-      await verifyMessageInstanceOwnership(services, message2, instanceId);
-      resolvedMessageId = message2.externalId;
-      log105.debug("Resolved internal UUID to external ID", { messageId, externalId: resolvedMessageId });
-    }
+    const resolvedMessageId = await resolveChannelMessageId(services, messageId, instanceId);
     try {
       await plugin7.editMessage(instanceId, channelId, resolvedMessageId, text3);
     } catch (error3) {
@@ -351399,10 +351615,11 @@ var init_messages5 = __esm(() => {
         recoverable: false
       });
     }
-    await plugin7.deleteMessage(instanceId, channelId, messageId, fromMe);
+    const resolvedMessageId = await resolveChannelMessageId(services, messageId, instanceId);
+    await plugin7.deleteMessage(instanceId, channelId, resolvedMessageId, fromMe);
     return c.json({
       success: true,
-      data: { messageId, deleted: true }
+      data: { messageId, externalId: resolvedMessageId, deleted: true }
     });
   });
   starMessageSchema = exports_external.object({
@@ -352845,6 +353062,7 @@ var init_app = __esm(() => {
   init_health2();
   init_openapi2();
   init_v2();
+  init_a2a_discovery();
   httpLog = createLogger("http");
 });
 
@@ -476415,6 +476633,7 @@ function processLidMappings(data, plugin6, instanceId) {
   }
 }
 function setupAllEventHandlers2(sock, plugin6, instanceId) {
+  const onReadOnlyEvent = sock.ev.on.bind(sock.ev);
   sock.ev.on("call", (calls) => {
     for (const call of calls) {
       const { id: from } = fromJid(call.from);
@@ -476453,6 +476672,12 @@ function setupAllEventHandlers2(sock, plugin6, instanceId) {
       logEvent("chats.delete", { chatIds });
     plugin6.handleChatsDelete(instanceId, chatIds);
   });
+  onReadOnlyEvent("chats.lock", (update) => {
+    waLog.info("Chat lock update", { chatId: update.id, locked: update.locked });
+    if (DEBUG)
+      logEvent("chats.lock", update);
+    plugin6.handleChatLockUpdate(instanceId, update);
+  });
   sock.ev.on("contacts.upsert", (contacts) => {
     if (DEBUG)
       logEvent("contacts.upsert", { count: contacts.length, contacts });
@@ -476489,6 +476714,16 @@ function setupAllEventHandlers2(sock, plugin6, instanceId) {
       logEvent("group.join-request", request);
     plugin6.handleGroupJoinRequest(instanceId, request);
   });
+  onReadOnlyEvent("group.member-tag.update", (update) => {
+    waLog.info("Group member tag update", {
+      groupId: update.groupId,
+      participant: update.participant,
+      label: update.label
+    });
+    if (DEBUG)
+      logEvent("group.member-tag.update", update);
+    plugin6.handleGroupMemberTagUpdate(instanceId, update);
+  });
   sock.ev.on("message-receipt.update", (updates) => {
     for (const update of updates) {
       if (DEBUG) {
@@ -476507,6 +476742,15 @@ function setupAllEventHandlers2(sock, plugin6, instanceId) {
       plugin6.handleMediaUpdate(instanceId, update);
     }
   });
+  onReadOnlyEvent("message-capping.update", (info) => {
+    waLog.info("Message capping update", {
+      type: info && typeof info === "object" ? info.type : undefined,
+      reason: info && typeof info === "object" ? info.reason : undefined
+    });
+    if (DEBUG)
+      logEvent("message-capping.update", info);
+    plugin6.handleMessageCappingUpdate(instanceId, info);
+  });
   sock.ev.on("messaging-history.set", async (history3) => {
     const { chats, contacts, messages: messages2, progress, syncType } = history3;
     waLog.info("History sync", {
@@ -476526,6 +476770,16 @@ function setupAllEventHandlers2(sock, plugin6, instanceId) {
       });
     await plugin6.handleHistorySync(instanceId, history3);
   });
+  onReadOnlyEvent("messaging-history.status", (status) => {
+    waLog.info("History sync status", {
+      syncType: status.syncType,
+      status: status.status,
+      explicit: status.explicit
+    });
+    if (DEBUG)
+      logEvent("messaging-history.status", status);
+    plugin6.handleMessagingHistoryStatus(instanceId, status);
+  });
   sock.ev.on("blocklist.set", (data) => {
     waLog.info("Blocklist set", { count: data.blocklist.length });
     if (DEBUG)
@@ -476538,6 +476792,12 @@ function setupAllEventHandlers2(sock, plugin6, instanceId) {
       logEvent("blocklist.update", data);
     plugin6.handleBlocklistUpdate(instanceId, data.blocklist, data.type);
   });
+  onReadOnlyEvent("settings.update", (update) => {
+    waLog.info("Settings update", { setting: update.setting });
+    if (DEBUG)
+      logEvent("settings.update", update);
+    plugin6.handleSettingsUpdate(instanceId, update);
+  });
   sock.ev.on("labels.edit", (label) => {
     if (DEBUG)
       logEvent("labels.edit", label);
@@ -480264,6 +480524,53 @@ class WhatsAppPlugin extends BaseChannelPlugin {
   async emitMediaReceivedInternal(params) {
     await this.emitMediaReceived(params);
   }
+  whatsappEventMeta(instanceId, suffix) {
+    return {
+      instanceId,
+      channelType: this.id,
+      source: `channel:${this.id}`,
+      correlationId: `${suffix}-${instanceId}`
+    };
+  }
+  handleMessagingHistoryStatus(instanceId, status) {
+    this.eventBus.publishGeneric("custom.whatsapp.messaging-history-status", {
+      instanceId,
+      syncType: status.syncType,
+      status: status.status ?? "unknown",
+      explicit: status.explicit,
+      timestamp: Date.now()
+    }, this.whatsappEventMeta(instanceId, "history-status")).catch((err) => this.logger.warn("Failed to publish messaging history status", { error: String(err) }));
+  }
+  handleMessageCappingUpdate(instanceId, info) {
+    this.eventBus.publishGeneric("custom.whatsapp.message-capping-updated", { instanceId, info, timestamp: Date.now() }, this.whatsappEventMeta(instanceId, "message-capping")).catch((err) => this.logger.warn("Failed to publish message capping update", { error: String(err) }));
+  }
+  handleSettingsUpdate(instanceId, update) {
+    this.eventBus.publishGeneric("custom.whatsapp.settings-updated", {
+      instanceId,
+      setting: update.setting ?? "unknown",
+      value: update.value,
+      timestamp: Date.now()
+    }, this.whatsappEventMeta(instanceId, `settings-${update.setting ?? "unknown"}`)).catch((err) => this.logger.warn("Failed to publish settings update", { error: String(err) }));
+  }
+  handleChatLockUpdate(instanceId, update) {
+    this.eventBus.publishGeneric("custom.whatsapp.chat-lock-updated", {
+      instanceId,
+      chatId: update.id ?? "",
+      locked: update.locked ?? false,
+      timestamp: Date.now()
+    }, this.whatsappEventMeta(instanceId, `chat-lock-${update.id ?? "unknown"}`)).catch((err) => this.logger.warn("Failed to publish chat lock update", { error: String(err) }));
+  }
+  handleGroupMemberTagUpdate(instanceId, update) {
+    this.eventBus.publishGeneric("custom.whatsapp.group-member-tag-updated", {
+      instanceId,
+      groupId: update.groupId ?? "",
+      participant: update.participant ?? "",
+      participantAlt: update.participantAlt,
+      label: update.label ?? "",
+      messageTimestamp: update.messageTimestamp,
+      timestamp: Date.now()
+    }, this.whatsappEventMeta(instanceId, `group-member-tag-${update.groupId ?? "unknown"}`)).catch((err) => this.logger.warn("Failed to publish group member tag update", { error: String(err) }));
+  }
   handleCallReceived(instanceId, callId, from, callType, status, _rawCall) {
     this.logger.info("Call received", { instanceId, callId, from, callType, status });
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automagik/omni",
-  "version": "2.260525.2",
+  "version": "2.260529.1",
   "description": "LLM-optimized CLI for Omni",
   "type": "module",
   "bin": {