@automagik/omni 2.260609.3 → 2.260609.5

package/dist/index.js

@@ -124971,7 +124971,7 @@ import { fileURLToPath } from "url";
 // package.json
 var package_default = {
   name: "@automagik/omni",
-  version: "2.260609.3",
+  version: "2.260609.5",
   description: "LLM-optimized CLI for Omni",
   type: "module",
   bin: {

package/dist/server/index.js

@@ -225245,7 +225245,7 @@ var init_sentry_scrub = __esm(() => {
 var require_package7 = __commonJS((exports, module) => {
   module.exports = {
     name: "@omni/api",
-    version: "2.260609.3",
+    version: "2.260609.5",
     type: "module",
     exports: {
       ".": {
@@ -335748,6 +335748,28 @@ class MessageService {
     const [result] = await this.db.select().from(messages2).where(and2(eq(messages2.chatId, chatId), eq(messages2.isFromMe, true), or2(...aliasConditions))).orderBy(desc(messages2.platformTimestamp)).limit(1);
     return result ?? null;
   }
+  async findRecentOutboundBefore(chatId, before, inboundText) {
+    const upperBound = new Date(before.getTime() + 2000);
+    const rows = await this.db.select().from(messages2).where(and2(eq(messages2.chatId, chatId), eq(messages2.isFromMe, true), lte(messages2.platformTimestamp, upperBound), sql`${messages2.deletedAt} IS NULL`)).orderBy(desc(messages2.platformTimestamp)).limit(8);
+    if (rows.length === 0)
+      return null;
+    const hint = (inboundText ?? "").toLocaleLowerCase("pt-BR");
+    const wantsPlanLikeTarget = /\b(esse|essa|este|esta|op[c\u00E7][a\u00E3]o|plano|quero|gostei)\b/i.test(hint);
+    if (!wantsPlanLikeTarget)
+      return rows[0] ?? null;
+    const score = (message2) => {
+      const text3 = (message2.textContent ?? "").toLocaleLowerCase("pt-BR");
+      let value = 0;
+      if (/op[c\u00E7][a\u00E3]o|plano/.test(text3))
+        value += 4;
+      if (/r\$|mensal|coparticipa|enfermaria|apartamento|ambulatorial|notrelife|hapvida/.test(text3))
+        value += 3;
+      if (/\?\s*$/.test(text3) && !/r\$/.test(text3))
+        value -= 2;
+      return value;
+    };
+    return rows.map((message2) => ({ message: message2, score: score(message2) })).sort((a, b3) => b3.score - a.score || b3.message.platformTimestamp.getTime() - a.message.platformTimestamp.getTime())[0]?.message ?? null;
+  }
   async getByExternalIds(chatId, externalIds) {
     if (externalIds.length === 0)
       return [];
@@ -338454,7 +338476,7 @@ function getMessageContentText(msg) {
 function uniqueNonEmpty(values2) {
   return [...new Set(values2.filter((value) => typeof value === "string" && value.length > 0))];
 }
-async function lookupQuotedMessage(messages4, chatDbId, replyToId, aliases) {
+async function lookupQuotedMessage(messages4, chatDbId, replyToId, aliases, options = {}) {
   const quoted = await messages4.getByExternalId(chatDbId, replyToId);
   if (quoted)
     return quoted;
@@ -338472,14 +338494,19 @@ async function lookupQuotedMessage(messages4, chatDbId, replyToId, aliases) {
     if (byExternalId)
       return byExternalId;
   }
+  if (options.inboundAt && aliasLookup.findRecentOutboundBefore) {
+    const fallback = await aliasLookup.findRecentOutboundBefore(chatDbId, options.inboundAt, options.inboundText);
+    if (fallback)
+      return fallback;
+  }
   return null;
 }
-async function resolveQuotedMessage(services, instanceId, chatId, replyToId, providerAliases = []) {
+async function resolveQuotedMessage(services, instanceId, chatId, replyToId, providerAliases = [], options = {}) {
   try {
     const chat2 = await services.chats.findByExternalIdSmart(instanceId, chatId);
     if (!chat2)
       return null;
-    const quoted = await lookupQuotedMessage(services.messages, chat2.id, replyToId, providerAliases);
+    const quoted = await lookupQuotedMessage(services.messages, chat2.id, replyToId, providerAliases, options);
     if (!quoted)
       return null;
     const sender = quoted.senderDisplayName ?? quoted.senderPlatformUserId ?? (quoted.isFromMe ? "You" : "unknown");
@@ -338560,13 +338587,27 @@ function extractQuotedProviderAliases(rawPayload) {
     topContext?.id
   ]);
 }
+function extractInboundPlatformDate(rawPayload) {
+  if (!rawPayload)
+    return;
+  const messageObj = isRecord(rawPayload.messageobj) ? rawPayload.messageobj : undefined;
+  const timestamp3 = messageObj?.timestamp;
+  if (typeof timestamp3 === "number" && Number.isFinite(timestamp3) && timestamp3 > 0) {
+    return new Date(timestamp3 * 1000);
+  }
+  return;
+}
 async function prependQuotedContext(services, instanceId, chatId, messages4, entries, messageKeyByIndex) {
   for (const [index2, m2] of messages4.entries()) {
     const replyToId = m2.payload.replyToId;
     if (!replyToId)
       continue;
-    const providerAliases = extractQuotedProviderAliases(m2.payload.rawPayload);
-    const quotedText = await resolveQuotedMessage(services, instanceId, chatId, replyToId, providerAliases);
+    const rawPayload = m2.payload.rawPayload;
+    const providerAliases = extractQuotedProviderAliases(rawPayload);
+    const quotedText = await resolveQuotedMessage(services, instanceId, chatId, replyToId, providerAliases, {
+      inboundAt: extractInboundPlatformDate(rawPayload),
+      inboundText: m2.payload.content?.text
+    });
     if (!quotedText)
       continue;
     const messageKey = messageKeyByIndex.get(index2);
@@ -353168,6 +353209,27 @@ async function enrichContactNames(contacts, services, instanceId) {
       contact.name = dbName;
   }
 }
+async function resolveInstancePlugin(services, channelRegistry2, instanceId) {
+  const instance4 = await services.instances.getById(instanceId);
+  if (!channelRegistry2) {
+    return { ok: false, status: 503, error: { code: "NO_REGISTRY", message: "Channel registry not available" } };
+  }
+  const plugin7 = channelRegistry2.get(instance4.channel);
+  if (!plugin7) {
+    return {
+      ok: false,
+      status: 400,
+      error: { code: "PLUGIN_NOT_FOUND", message: `No plugin for channel: ${instance4.channel}` }
+    };
+  }
+  return { ok: true, plugin: plugin7 };
+}
+function participantUpdateResponse(result) {
+  return {
+    ...result,
+    changedCount: result.participants.length
+  };
+}
 function parseDuration(duration) {
   const match2 = duration.match(/^(\d+)(s|m|h|d)$/);
   if (!match2?.[1] || !match2[2])
@@ -353207,7 +353269,7 @@ function getCacheKey(instanceId, guildId) {
 function invalidateGuildCache(instanceId, guildId) {
   guildConfigCache.delete(getCacheKey(instanceId, guildId));
 }
-var log108, instancesRoutes, instanceAccess2, listQuerySchema12, agentReplyFilterSchema, createInstanceSchema, updateInstanceSchema, DEFAULT_AGENT_REPLY_FILTER, SENSITIVE_INSTANCE_FIELDS, pairingCodeSchema, connectInstanceSchema, syncRequestSchema, listContactsQuerySchema, listGroupsQuerySchema, checkNumberSchema, updateBioSchema, blockContactSchema, resyncSchema, replaySchema, pairingActionSchema, guildConfigOverrideSchema, guildConfigCache, GUILD_CONFIG_TTL, presenceSchema;
+var log108, instancesRoutes, instanceAccess2, listQuerySchema12, agentReplyFilterSchema, createInstanceSchema, updateInstanceSchema, DEFAULT_AGENT_REPLY_FILTER, SENSITIVE_INSTANCE_FIELDS, pairingCodeSchema, connectInstanceSchema, syncRequestSchema, listContactsQuerySchema, listGroupsQuerySchema, checkNumberSchema, updateBioSchema, blockContactSchema, groupParticipantActionSchema, groupSettingSchema, groupParticipantsSchema, groupParticipantsPatchSchema, updateGroupSubjectSchema, updateGroupDescriptionSchema, updateGroupSettingsSchema, patchGroupSchema, resyncSchema, replaySchema, pairingActionSchema, guildConfigOverrideSchema, guildConfigCache, GUILD_CONFIG_TTL, presenceSchema;
 var init_instances3 = __esm(() => {
   init_dist6();
   init_src();
@@ -354309,6 +354371,30 @@ var init_instances3 = __esm(() => {
       return c.json({ error: { code: "REMOVE_FAILED", message: message2 } }, 500);
     }
   });
+  groupParticipantActionSchema = exports_external.enum(["add", "remove", "promote", "demote"]);
+  groupSettingSchema = exports_external.enum(["announcement", "not_announcement", "locked", "unlocked"]);
+  groupParticipantsSchema = exports_external.object({
+    participants: exports_external.array(exports_external.string().min(1)).min(1).describe("Phone numbers or JIDs to mutate")
+  });
+  groupParticipantsPatchSchema = groupParticipantsSchema.extend({
+    action: groupParticipantActionSchema.describe("Participant mutation action")
+  });
+  updateGroupSubjectSchema = exports_external.object({
+    subject: exports_external.string().min(1).max(100).describe("New group name/subject")
+  });
+  updateGroupDescriptionSchema = exports_external.object({
+    description: exports_external.string().max(2048).describe("New group description. Empty string clears the description.")
+  });
+  updateGroupSettingsSchema = exports_external.object({
+    setting: groupSettingSchema.describe("Group setting to apply")
+  });
+  patchGroupSchema = exports_external.object({
+    subject: exports_external.string().min(1).max(100).optional(),
+    description: exports_external.string().max(2048).optional(),
+    setting: groupSettingSchema.optional()
+  }).refine((value) => value.subject !== undefined || value.description !== undefined || value.setting !== undefined, {
+    message: "At least one of subject, description, or setting is required"
+  });
   instancesRoutes.post("/:id/groups", instanceAccess2, zValidator("json", exports_external.object({
     subject: exports_external.string().min(1).max(100).describe("Group name/subject"),
     participants: exports_external.array(exports_external.string().min(1)).min(1).describe("Phone numbers or JIDs to add")
@@ -354328,6 +354414,218 @@ var init_instances3 = __esm(() => {
     const result = await plugin7.groupCreate(id, subject, participants);
     return c.json({ data: result }, 201);
   });
+  instancesRoutes.post("/:id/groups/:groupJid/participants", instanceAccess2, zValidator("json", groupParticipantsSchema), async (c) => {
+    const id = c.req.param("id");
+    const groupJid = c.req.param("groupJid");
+    const { participants } = c.req.valid("json");
+    const resolved = await resolveInstancePlugin(c.get("services"), c.get("channelRegistry"), id);
+    if (!resolved.ok)
+      return c.json({ error: resolved.error }, resolved.status);
+    if (typeof resolved.plugin.updateGroupParticipants !== "function") {
+      return c.json({ error: { code: "NOT_SUPPORTED", message: "Plugin does not support group participant updates" } }, 400);
+    }
+    try {
+      const result = await resolved.plugin.updateGroupParticipants(id, groupJid, participants, "add");
+      return c.json({ success: true, data: participantUpdateResponse(result) });
+    } catch (error3) {
+      const message2 = error3 instanceof Error ? error3.message : "Unknown error";
+      return c.json({ error: { code: "GROUP_PARTICIPANTS_UPDATE_FAILED", message: message2 } }, 500);
+    }
+  });
+  instancesRoutes.post("/:id/groups/:groupJid/participants/:action", instanceAccess2, zValidator("json", groupParticipantsSchema), async (c) => {
+    const id = c.req.param("id");
+    const groupJid = c.req.param("groupJid");
+    const parsedAction = groupParticipantActionSchema.safeParse(c.req.param("action"));
+    const { participants } = c.req.valid("json");
+    if (!parsedAction.success) {
+      return c.json({
+        error: {
+          code: "VALIDATION_ERROR",
+          message: "Invalid group participant action. Expected add, remove, promote, or demote."
+        }
+      }, 400);
+    }
+    const resolved = await resolveInstancePlugin(c.get("services"), c.get("channelRegistry"), id);
+    if (!resolved.ok)
+      return c.json({ error: resolved.error }, resolved.status);
+    if (typeof resolved.plugin.updateGroupParticipants !== "function") {
+      return c.json({ error: { code: "NOT_SUPPORTED", message: "Plugin does not support group participant updates" } }, 400);
+    }
+    try {
+      const result = await resolved.plugin.updateGroupParticipants(id, groupJid, participants, parsedAction.data);
+      return c.json({ success: true, data: participantUpdateResponse(result) });
+    } catch (error3) {
+      const message2 = error3 instanceof Error ? error3.message : "Unknown error";
+      return c.json({ error: { code: "GROUP_PARTICIPANTS_UPDATE_FAILED", message: message2 } }, 500);
+    }
+  });
+  instancesRoutes.patch("/:id/groups/:groupJid/participants", instanceAccess2, zValidator("json", groupParticipantsPatchSchema), async (c) => {
+    const id = c.req.param("id");
+    const groupJid = c.req.param("groupJid");
+    const { action, participants } = c.req.valid("json");
+    const resolved = await resolveInstancePlugin(c.get("services"), c.get("channelRegistry"), id);
+    if (!resolved.ok)
+      return c.json({ error: resolved.error }, resolved.status);
+    if (typeof resolved.plugin.updateGroupParticipants !== "function") {
+      return c.json({ error: { code: "NOT_SUPPORTED", message: "Plugin does not support group participant updates" } }, 400);
+    }
+    try {
+      const result = await resolved.plugin.updateGroupParticipants(id, groupJid, participants, action);
+      return c.json({ success: true, data: participantUpdateResponse(result) });
+    } catch (error3) {
+      const message2 = error3 instanceof Error ? error3.message : "Unknown error";
+      return c.json({ error: { code: "GROUP_PARTICIPANTS_UPDATE_FAILED", message: message2 } }, 500);
+    }
+  });
+  instancesRoutes.patch("/:id/groups/:groupJid", instanceAccess2, zValidator("json", patchGroupSchema), async (c) => {
+    const id = c.req.param("id");
+    const groupJid = c.req.param("groupJid");
+    const body = c.req.valid("json");
+    const resolved = await resolveInstancePlugin(c.get("services"), c.get("channelRegistry"), id);
+    if (!resolved.ok)
+      return c.json({ error: resolved.error }, resolved.status);
+    if (body.subject !== undefined && typeof resolved.plugin.updateGroupSubject !== "function") {
+      return c.json({ error: { code: "NOT_SUPPORTED", message: "Plugin does not support group rename" } }, 400);
+    }
+    if (body.description !== undefined && typeof resolved.plugin.updateGroupDescription !== "function") {
+      return c.json({ error: { code: "NOT_SUPPORTED", message: "Plugin does not support group description updates" } }, 400);
+    }
+    if (body.setting !== undefined && typeof resolved.plugin.updateGroupSettings !== "function") {
+      return c.json({ error: { code: "NOT_SUPPORTED", message: "Plugin does not support group settings updates" } }, 400);
+    }
+    try {
+      const updated = [];
+      if (body.subject !== undefined) {
+        await resolved.plugin.updateGroupSubject?.(id, groupJid, body.subject);
+        updated.push("subject");
+      }
+      if (body.description !== undefined) {
+        await resolved.plugin.updateGroupDescription?.(id, groupJid, body.description);
+        updated.push("description");
+      }
+      if (body.setting !== undefined) {
+        await resolved.plugin.updateGroupSettings?.(id, groupJid, body.setting);
+        updated.push("settings");
+      }
+      return c.json({ success: true, data: { instanceId: id, groupJid, updated, ...body } });
+    } catch (error3) {
+      const message2 = error3 instanceof Error ? error3.message : "Unknown error";
+      return c.json({ error: { code: "GROUP_UPDATE_FAILED", message: message2 } }, 500);
+    }
+  });
+  instancesRoutes.put("/:id/groups/:groupJid/subject", instanceAccess2, zValidator("json", updateGroupSubjectSchema), async (c) => {
+    const id = c.req.param("id");
+    const groupJid = c.req.param("groupJid");
+    const { subject } = c.req.valid("json");
+    const resolved = await resolveInstancePlugin(c.get("services"), c.get("channelRegistry"), id);
+    if (!resolved.ok)
+      return c.json({ error: resolved.error }, resolved.status);
+    if (typeof resolved.plugin.updateGroupSubject !== "function") {
+      return c.json({ error: { code: "NOT_SUPPORTED", message: "Plugin does not support group rename" } }, 400);
+    }
+    try {
+      await resolved.plugin.updateGroupSubject(id, groupJid, subject);
+      return c.json({ success: true, data: { instanceId: id, groupJid, subject, action: "group_subject_updated" } });
+    } catch (error3) {
+      const message2 = error3 instanceof Error ? error3.message : "Unknown error";
+      return c.json({ error: { code: "GROUP_RENAME_FAILED", message: message2 } }, 500);
+    }
+  });
+  instancesRoutes.post("/:id/groups/:groupJid/subject", instanceAccess2, zValidator("json", updateGroupSubjectSchema), async (c) => {
+    const id = c.req.param("id");
+    const groupJid = c.req.param("groupJid");
+    const { subject } = c.req.valid("json");
+    const resolved = await resolveInstancePlugin(c.get("services"), c.get("channelRegistry"), id);
+    if (!resolved.ok)
+      return c.json({ error: resolved.error }, resolved.status);
+    if (typeof resolved.plugin.updateGroupSubject !== "function") {
+      return c.json({ error: { code: "NOT_SUPPORTED", message: "Plugin does not support group rename" } }, 400);
+    }
+    try {
+      await resolved.plugin.updateGroupSubject(id, groupJid, subject);
+      return c.json({ success: true, data: { instanceId: id, groupJid, subject, action: "group_subject_updated" } });
+    } catch (error3) {
+      const message2 = error3 instanceof Error ? error3.message : "Unknown error";
+      return c.json({ error: { code: "GROUP_RENAME_FAILED", message: message2 } }, 500);
+    }
+  });
+  instancesRoutes.put("/:id/groups/:groupJid/description", instanceAccess2, zValidator("json", updateGroupDescriptionSchema), async (c) => {
+    const id = c.req.param("id");
+    const groupJid = c.req.param("groupJid");
+    const { description } = c.req.valid("json");
+    const resolved = await resolveInstancePlugin(c.get("services"), c.get("channelRegistry"), id);
+    if (!resolved.ok)
+      return c.json({ error: resolved.error }, resolved.status);
+    if (typeof resolved.plugin.updateGroupDescription !== "function") {
+      return c.json({ error: { code: "NOT_SUPPORTED", message: "Plugin does not support group description updates" } }, 400);
+    }
+    try {
+      await resolved.plugin.updateGroupDescription(id, groupJid, description);
+      return c.json({
+        success: true,
+        data: { instanceId: id, groupJid, description, action: "group_description_updated" }
+      });
+    } catch (error3) {
+      const message2 = error3 instanceof Error ? error3.message : "Unknown error";
+      return c.json({ error: { code: "GROUP_DESCRIPTION_FAILED", message: message2 } }, 500);
+    }
+  });
+  instancesRoutes.post("/:id/groups/:groupJid/description", instanceAccess2, zValidator("json", updateGroupDescriptionSchema), async (c) => {
+    const id = c.req.param("id");
+    const groupJid = c.req.param("groupJid");
+    const { description } = c.req.valid("json");
+    const resolved = await resolveInstancePlugin(c.get("services"), c.get("channelRegistry"), id);
+    if (!resolved.ok)
+      return c.json({ error: resolved.error }, resolved.status);
+    if (typeof resolved.plugin.updateGroupDescription !== "function") {
+      return c.json({ error: { code: "NOT_SUPPORTED", message: "Plugin does not support group description updates" } }, 400);
+    }
+    try {
+      await resolved.plugin.updateGroupDescription(id, groupJid, description);
+      return c.json({
+        success: true,
+        data: { instanceId: id, groupJid, description, action: "group_description_updated" }
+      });
+    } catch (error3) {
+      const message2 = error3 instanceof Error ? error3.message : "Unknown error";
+      return c.json({ error: { code: "GROUP_DESCRIPTION_FAILED", message: message2 } }, 500);
+    }
+  });
+  instancesRoutes.post("/:id/groups/:groupJid/settings", instanceAccess2, zValidator("json", updateGroupSettingsSchema), async (c) => {
+    const id = c.req.param("id");
+    const groupJid = c.req.param("groupJid");
+    const { setting } = c.req.valid("json");
+    const resolved = await resolveInstancePlugin(c.get("services"), c.get("channelRegistry"), id);
+    if (!resolved.ok)
+      return c.json({ error: resolved.error }, resolved.status);
+    if (typeof resolved.plugin.updateGroupSettings !== "function") {
+      return c.json({ error: { code: "NOT_SUPPORTED", message: "Plugin does not support group settings updates" } }, 400);
+    }
+    try {
+      await resolved.plugin.updateGroupSettings(id, groupJid, setting);
+      return c.json({ success: true, data: { instanceId: id, groupJid, setting, action: "group_settings_updated" } });
+    } catch (error3) {
+      const message2 = error3 instanceof Error ? error3.message : "Unknown error";
+      return c.json({ error: { code: "GROUP_SETTINGS_FAILED", message: message2 } }, 500);
+    }
+  });
+  instancesRoutes.post("/:id/groups/:groupJid/leave", instanceAccess2, async (c) => {
+    const id = c.req.param("id");
+    const groupJid = c.req.param("groupJid");
+    const resolved = await resolveInstancePlugin(c.get("services"), c.get("channelRegistry"), id);
+    if (!resolved.ok)
+      return c.json({ error: resolved.error }, resolved.status);
+    if (typeof resolved.plugin.leaveGroup !== "function") {
+      return c.json({ error: { code: "NOT_SUPPORTED", message: "Plugin does not support leaving groups" } }, 400);
+    }
+    try {
+      await resolved.plugin.leaveGroup(id, groupJid);
+      return c.json({ success: true, data: { instanceId: id, groupJid, left: true } });
+    } catch (error3) {
+      const message2 = error3 instanceof Error ? error3.message : "Unknown error";
+      return c.json({ error: { code: "GROUP_LEAVE_FAILED", message: message2 } }, 500);
+    }
+  });
   instancesRoutes.get("/:id/chats/:chatId/invite", instanceAccess2, async (c) => {
     const id = c.req.param("id");
     const chatId = c.req.param("chatId");
@@ -482804,6 +483102,12 @@ function toJid(identifier, lidCache) {
   }
   return phoneJid;
 }
+function toGroupJid(groupId) {
+  if (groupId.endsWith(JID_SUFFIX.GROUP)) {
+    return groupId;
+  }
+  return `${groupId}${JID_SUFFIX.GROUP}`;
+}
 function fromJid(jid) {
   const isGroup = jid.endsWith(JID_SUFFIX.GROUP);
   const isBroadcast = jid.endsWith(JID_SUFFIX.BROADCAST);
@@ -486419,6 +486723,85 @@ class WhatsAppPlugin extends BaseChannelPlugin {
       throw waError;
     }
   }
+  async updateGroupParticipants(instanceId, groupJid, participants, action) {
+    await this.humanDelay(instanceId);
+    const sock = this.getSocket(instanceId);
+    const jid = toGroupJid(groupJid);
+    const participantJids = participants.map((participant) => toJid(participant));
+    try {
+      const result = await sock.groupParticipantsUpdate(jid, participantJids, action);
+      this.invalidateGroupMetadataCache(instanceId, jid);
+      this.logger.info("Group participants updated", {
+        instanceId,
+        groupJid: jid,
+        action,
+        participantCount: participantJids.length
+      });
+      return {
+        groupJid: jid,
+        action,
+        participants: result.map((participant) => ({
+          jid: participant.jid,
+          status: participant.status
+        }))
+      };
+    } catch (error) {
+      const waError = mapBaileysError(error);
+      throw waError;
+    }
+  }
+  async updateGroupSubject(instanceId, groupJid, subject) {
+    await this.humanDelay(instanceId);
+    const sock = this.getSocket(instanceId);
+    const jid = toGroupJid(groupJid);
+    try {
+      await sock.groupUpdateSubject(jid, subject);
+      this.invalidateGroupMetadataCache(instanceId, jid);
+      this.logger.info("Group subject updated", { instanceId, groupJid: jid });
+    } catch (error) {
+      const waError = mapBaileysError(error);
+      throw waError;
+    }
+  }
+  async updateGroupDescription(instanceId, groupJid, description) {
+    await this.humanDelay(instanceId);
+    const sock = this.getSocket(instanceId);
+    const jid = toGroupJid(groupJid);
+    try {
+      await sock.groupUpdateDescription(jid, description);
+      this.invalidateGroupMetadataCache(instanceId, jid);
+      this.logger.info("Group description updated", { instanceId, groupJid: jid, cleared: !description });
+    } catch (error) {
+      const waError = mapBaileysError(error);
+      throw waError;
+    }
+  }
+  async updateGroupSettings(instanceId, groupJid, setting) {
+    await this.humanDelay(instanceId);
+    const sock = this.getSocket(instanceId);
+    const jid = toGroupJid(groupJid);
+    try {
+      await sock.groupSettingUpdate(jid, setting);
+      this.invalidateGroupMetadataCache(instanceId, jid);
+      this.logger.info("Group settings updated", { instanceId, groupJid: jid, setting });
+    } catch (error) {
+      const waError = mapBaileysError(error);
+      throw waError;
+    }
+  }
+  async leaveGroup(instanceId, groupJid) {
+    await this.humanDelay(instanceId);
+    const sock = this.getSocket(instanceId);
+    const jid = toGroupJid(groupJid);
+    try {
+      await sock.groupLeave(jid);
+      this.invalidateGroupMetadataCache(instanceId, jid);
+      this.logger.info("Left group", { instanceId, groupJid: jid });
+    } catch (error) {
+      const waError = mapBaileysError(error);
+      throw waError;
+    }
+  }
   async handleQrCode(instanceId, qrCode, expiresAt) {
     await this.emitQrCode(instanceId, qrCode, expiresAt);
     const config2 = this.instances.get(instanceId)?.config;

package/package.json

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