@automagik/omni 2.260915.15 → 2.260915.17

package/db/drizzle/0072_shared_durable_consumers.sql

@@ -0,0 +1,19 @@
+-- Competing (shared) durable consumers (issue #1188).
+--
+-- Consumers fan out: each name owns a cursor, so N workers on N names each
+-- see every event. A shared consumer lets N pullers on ONE name split the
+-- stream: pull leases a page (claimed watermark + lease list), ack releases
+-- the lease, and an expired lease is redelivered (at-least-once).
+--
+--   durable_consumers.shared        default false (fan-out, unchanged)
+--   durable_consumers.lease_state   jsonb, null unless shared
+--
+-- Hand-written following the 0043/0044/0052 precedent (additive, idempotent).
+-- No explicit BEGIN/COMMIT — the boot migrator executes this file on a pooled
+-- postgres-js connection, which rejects raw transaction control.
+
+ALTER TABLE "durable_consumers"
+  ADD COLUMN IF NOT EXISTS "shared" boolean NOT NULL DEFAULT false;
+--> statement-breakpoint
+ALTER TABLE "durable_consumers"
+  ADD COLUMN IF NOT EXISTS "lease_state" jsonb;

package/db/drizzle/meta/_journal.json

@@ -505,6 +505,13 @@
       "when": 1787100000000,
       "tag": "0071_webhook_idempotency_across_event_types",
       "breakpoints": true
+    },
+    {
+      "idx": 72,
+      "version": "7",
+      "when": 1787200000000,
+      "tag": "0072_shared_durable_consumers",
+      "breakpoints": true
     }
   ]
 }

package/dist/commands/channels.d.ts

@@ -6,7 +6,27 @@
  * omni channels list      - Show available channel types + instance counts
  * omni channels add <type> [--token <token>] [--name <name>] - Add a new channel instance
  * omni channels status    - Overview of all channels and connection states
+ * omni channels capabilities - Event vocabulary + guarantees per loaded channel
  */
 import { Command } from 'commander';
+type CapabilityFlag = boolean | 'unknown';
+interface ChannelCapabilityRow {
+    id: string;
+    emits: string[] | null;
+    edits: CapabilityFlag;
+    deletes: CapabilityFlag;
+    idempotency: CapabilityFlag;
+}
+/** One matrix row; `?` wherever the plugin declares nothing. */
+export declare function capabilityRow(ch: ChannelCapabilityRow): {
+    channel: string;
+    'message.received': string;
+    'message.sent': string;
+    'reaction.*': string;
+    edit: string;
+    delete: string;
+    idempotency: string;
+};
 export declare function createChannelsCommand(): Command;
+export {};
 //# sourceMappingURL=channels.d.ts.map

package/dist/commands/channels.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channels.d.ts","sourceRoot":"","sources":["../../src/commands/channels.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkDpC,wBAAgB,qBAAqB,IAAI,OAAO,CAqH/C"}
+{"version":3,"file":"channels.d.ts","sourceRoot":"","sources":["../../src/commands/channels.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkDpC,KAAK,cAAc,GAAG,OAAO,GAAG,SAAS,CAAC;AAC1C,UAAU,oBAAoB;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,cAAc,CAAC;IACtB,OAAO,EAAE,cAAc,CAAC;IACxB,WAAW,EAAE,cAAc,CAAC;CAC7B;AAID,gEAAgE;AAChE,wBAAgB,aAAa,CAAC,EAAE,EAAE,oBAAoB;;;;;;;;EAYrD;AAED,wBAAgB,qBAAqB,IAAI,OAAO,CAqI/C"}

package/dist/commands/events.d.ts

@@ -202,6 +202,8 @@ interface ConsumerData {
     excludeTypes?: string[] | null;
     filters: AutomationCondition[] | null;
     cursor: number;
+    /** Competing consumers (#1188). Absent on older servers. */
+    shared?: boolean;
     head: number;
     lag: number;
     /** No type-matching row past the cursor (#1128). Absent on older servers. */

package/dist/commands/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/commands/events.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/commands/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,KAAK,mBAAmB,EAAsB,MAAM,YAAY,CAAC;AAC1E,OAAO,KAAK,EAAE,KAAK,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE1E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyJpC,iFAAiF;AACjF,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzF;AAqDD,2DAA2D;AAC3D,UAAU,UAAU;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC7C,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AA+BD,wEAAwE;AACxE,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAKzE;AAyCD,wDAAwD;AACxD,UAAU,eAAe;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,iBAAe,gBAAgB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAe1G;AAED,kFAAkF;AAClF,iBAAS,kBAAkB,CAAC,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUhG;AAED,kGAAkG;AAClG,iBAAS,WAAW,CAAC,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAK1E;AAWD,iBAAS,kBAAkB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQzE;AAyGD,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAC5B,eAAO,MAAM,WAAW;;;;;CAA4E,CAAC;AAErG;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,GAAG;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB,CAEA;AAoBD,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,yFAAyF;AACzF,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAEjF;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAG7G;AAED,iFAAiF;AACjF,MAAM,WAAW,mBAAmB;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAQvF;AAED;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG;IACnC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACpC,UAAU,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,OAAO,CAAA;SAAE,CAAA;KAAE,GAAG,IAAI,CAAC;CACvE,CAAC;AAEF,gFAAgF;AAChF,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IACtC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IAClC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,iBAAiB;IAChC,+DAA+D;IAC/D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4EAA4E;IAC5E,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,sEAAsE;IACtE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,mEAAmE;IACnE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAQD,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,MAAM,CAG9E;AAED,uDAAuD;AACvD,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,GAAE,iBAAsB,GAAG,MAAM,CAc9F;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAS3D;AAMD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,GAAE,iBAAsB,GAAG,MAAM,CAa/F;AAmLD;;;;;;GAMG;AACH,KAAK,YAAY,GAAG,KAAK,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;CAAE,CAAC;AAc5E;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,mBAAmB,EAAE,CAYzE;AAED,UAAU,UAAU;IAClB,OAAO,EAAE,mBAAmB,CAAC;IAC7B,UAAU,EAAE,mBAAmB,EAAE,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,gFAAgF;AAChF,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,mBAAmB,EAC5B,UAAU,EAAE,mBAAmB,EAAE,GAChC,OAAO,CAGT;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CA4BvG;AAMD,0EAA0E;AAC1E,UAAU,YAAY;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC/B,OAAO,EAAE,mBAAmB,EAAE,GAAG,IAAI,CAAC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAeD;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAepH;AAQD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAa/E;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,MAAM,EAAE,MAAM,CAAC;IACf,sFAAsF;IACtF,GAAG,EAAE,OAAO,CAAC;IACb,8EAA8E;IAC9E,SAAS,EAAE,OAAO,CAAC;IACnB,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC;IAC1B,sEAAsE;IACtE,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,qGAAqG;IACrG,MAAM,CAAC,EAAE;QAAE,MAAM,EAAE,UAAU,CAAC;QAAC,MAAM,EAAE,iBAAiB,CAAA;KAAE,CAAC;IAC3D,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA2CD;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAqDxE;AA2HD,wBAAgB,mBAAmB,IAAI,OAAO,CAma7C"}

package/dist/index.js

@@ -83361,6 +83361,8 @@ var init_schema2 = __esm(() => {
     excludeTypes: jsonb("exclude_types").$type(),
     filters: jsonb("filters").$type(),
     cursor: bigint2("cursor", { mode: "number" }).notNull().default(0),
+    shared: boolean2("shared").notNull().default(false),
+    leaseState: jsonb("lease_state").$type(),
     createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
     updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow()
   }, (table3) => ({
@@ -104664,9 +104666,9 @@ __export(exports_supports_color, {
 import process10 from "process";
 import os3 from "os";
 import tty2 from "tty";
-function hasFlag2(flag, argv = globalThis.Deno ? globalThis.Deno.args : process10.argv) {
-  const prefix = flag.startsWith("-") ? "" : flag.length === 1 ? "-" : "--";
-  const position = argv.indexOf(prefix + flag);
+function hasFlag2(flag2, argv = globalThis.Deno ? globalThis.Deno.args : process10.argv) {
+  const prefix = flag2.startsWith("-") ? "" : flag2.length === 1 ? "-" : "--";
+  const position = argv.indexOf(prefix + flag2);
   const terminatorPosition = argv.indexOf("--");
   return position !== -1 && (terminatorPosition === -1 || position < terminatorPosition);
 }
@@ -137384,7 +137386,7 @@ import { fileURLToPath } from "url";
 // package.json
 var package_default = {
   name: "@automagik/omni",
-  version: "2.260915.15",
+  version: "2.260915.17",
   repository: {
     type: "git",
     url: "git+https://github.com/automagik-dev/omni.git",
@@ -140262,6 +140264,19 @@ function buildStatusItems(instances) {
     profile: inst.profileName ?? "-"
   }));
 }
+var flag = (v4) => v4 === "unknown" ? "?" : v4 ? "yes" : "no";
+function capabilityRow(ch) {
+  const emits = (prefix) => ch.emits === null ? "?" : ch.emits.some((t) => t.startsWith(prefix)) ? "yes" : "no";
+  return {
+    channel: ch.id,
+    "message.received": emits("message.received"),
+    "message.sent": emits("message.sent"),
+    "reaction.*": emits("reaction."),
+    edit: flag(ch.edits),
+    delete: flag(ch.deletes),
+    idempotency: flag(ch.idempotency)
+  };
+}
 function createChannelsCommand() {
   const channels = new Command("channels").description("Channel management \u2014 list types, add instances, check status");
   channels.command("list").description("Show available channel types and instance counts").action(async () => {
@@ -140294,6 +140309,15 @@ function createChannelsCommand() {
       error(`Failed to list channels: ${message2}`);
     }
   });
+  channels.command("capabilities").description("Event vocabulary and guarantees per loaded channel (declared by code, see #1187)").action(async () => {
+    try {
+      const { items } = await apiCall("channels/capabilities");
+      list(items.map(capabilityRow), { emptyMessage: "No channels loaded.", rawData: items });
+    } catch (err2) {
+      const message2 = err2 instanceof Error ? err2.message : "Unknown error";
+      error(`Failed to load channel capabilities: ${message2}`);
+    }
+  });
   channels.command("add <type>").description("Add a new channel instance (interactive setup)").option("--token <token>", "Bot token (for Telegram, Discord, Slack)").option("--name <name>", "Instance name (auto-generated if not provided)").action(async (type, options) => {
     const validTypes = ["telegram", "discord", "slack", "whatsapp-baileys", "whatsapp-business", "twilio-whatsapp"];
     if (!validTypes.includes(type)) {
@@ -144888,7 +144912,12 @@ async function followConsumer(params) {
       await flushStdout();
       return;
     }
-    if (page.cursor > acked) {
+    if (page.leaseId) {
+      await consumersApiRequest(`/${encodeURIComponent(params.consumer)}/ack`, {
+        method: "POST",
+        body: JSON.stringify({ leaseId: page.leaseId })
+      });
+    } else if (page.cursor > acked) {
       await consumersApiRequest(`/${encodeURIComponent(params.consumer)}/ack`, {
         method: "POST",
         body: JSON.stringify({ cursor: page.cursor })
@@ -144907,7 +144936,25 @@ async function followConsumer(params) {
 }
 function createConsumersCommand() {
   const consumers = new Command("consumers").description("Manage durable event consumers (named cursors over the event journal)");
-  consumers.command("create <name>").description("Register a durable consumer").requiredOption("--type <type>", "Event type filter (trailing * = prefix glob, e.g. custom.github.*)").option("--exclude <glob>", "Drop event types matching this glob, repeatable; wins over --type (e.g. --exclude custom.chat.*)", (value, previous) => [...previous, value], []).option("--filter <k=v>", "Payload condition, repeatable (dot paths + JSON values \u2014 same matcher as events wait)", (value, previous) => [...previous, value], []).option("--from-beginning", "Start the cursor at 0 (replay the full journal) instead of the current head").action(async (name, options) => {
+  consumers.command("create <name>").description("Register a durable consumer").addHelpText("after", `
+Fan-out (default) vs shared (--shared):
+  Each consumer NAME owns one cursor. Two names on the same type BOTH see
+  every event \u2014 right for observers (monitor, archiver, metrics).
+  By default, starting a second worker on the SAME name does not split the
+  work: both pull the same pages, so events get handled twice. Don't scale
+  workers that way.
+
+  To scale workers, pick one:
+    --shared    competing consumers: N processes following this one name
+                split the stream. Each pull leases a page to one process;
+                ack releases it; an unacked page is redelivered after the
+                lease expires (at-least-once \u2014 make handlers idempotent on id).
+    one consumer, parallelize inside your process: a single follower that
+                fans each page out to a local worker pool, then acks.
+
+Examples:
+  omni events consumers create audit-log --type 'custom.*'
+  omni events consumers create my-workers --type custom.x --shared`).requiredOption("--type <type>", "Event type filter (trailing * = prefix glob, e.g. custom.github.*)").option("--exclude <glob>", "Drop event types matching this glob, repeatable; wins over --type (e.g. --exclude custom.chat.*)", (value, previous) => [...previous, value], []).option("--filter <k=v>", "Payload condition, repeatable (dot paths + JSON values \u2014 same matcher as events wait)", (value, previous) => [...previous, value], []).option("--from-beginning", "Start the cursor at 0 (replay the full journal) instead of the current head").option("--shared", "Competing consumers: followers of this name split events instead of each seeing all").action(async (name, options) => {
     try {
       const filters = parseWaitFilters(WaitOptionsSchema.shape.filter.parse(options.filter));
       const result = await consumersApiRequest("", {
@@ -144917,13 +144964,15 @@ function createConsumersCommand() {
           eventType: options.type,
           excludeTypes: options.exclude.length ? options.exclude : undefined,
           filters: filters.length ? filters : undefined,
-          startFrom: options.fromBeginning ? "beginning" : undefined
+          startFrom: options.fromBeginning ? "beginning" : undefined,
+          shared: options.shared || undefined
         })
       });
       success(`Consumer registered: ${result.data.name} (cursor ${result.data.cursor})`, {
         name: result.data.name,
         eventType: result.data.eventType,
         cursor: result.data.cursor,
+        shared: result.data.shared ?? false,
         lag: result.data.lag
       });
     } catch (err2) {
@@ -145618,9 +145667,9 @@ function computeDefaultDatabaseUrl() {
   return buildEmbeddedDatabaseUrl();
 }
 function resolveInstallDatabaseUrl(options) {
-  const flag = options.databaseUrlFlag?.trim();
-  if (flag && flag.length > 0)
-    return flag;
+  const flag2 = options.databaseUrlFlag?.trim();
+  if (flag2 && flag2.length > 0)
+    return flag2;
   return computeDefaultDatabaseUrl();
 }
 async function isBunAvailable() {
@@ -148308,12 +148357,12 @@ function extensionForMime2(mimeType) {
     return ".flac";
   return ".mp3";
 }
-function parsePositiveIntOption(value, flag) {
+function parsePositiveIntOption(value, flag2) {
   if (value === undefined)
     return;
   const parsed = Number.parseInt(value, 10);
   if (Number.isNaN(parsed))
-    throw new Error(`Invalid ${flag}: ${value}`);
+    throw new Error(`Invalid ${flag2}: ${value}`);
   return parsed;
 }
 function assertMusicMode(mode) {
@@ -154007,8 +154056,8 @@ function sanitizeArgs(argv) {
     const arg = argv[i6];
     const eqIdx = arg.indexOf("=");
     if (eqIdx !== -1) {
-      const flag = arg.slice(0, eqIdx).toLowerCase();
-      if (SENSITIVE_FLAGS.has(flag)) {
+      const flag2 = arg.slice(0, eqIdx).toLowerCase();
+      if (SENSITIVE_FLAGS.has(flag2)) {
         result.push(`${arg.slice(0, eqIdx)}=[REDACTED]`);
       } else {
         result.push(arg);

package/dist/server/index.js

@@ -166112,7 +166112,26 @@ var init_capabilities3 = __esm(() => {
         maxSize: 100 * 1024 * 1024
       },
       { mimeType: "text/plain", maxSize: 100 * 1024 * 1024 }
-    ]
+    ],
+    events: {
+      emits: [
+        "channel.alert",
+        "flow.data_exchange",
+        "instance.connected",
+        "instance.disconnected",
+        "message.delivered",
+        "message.failed",
+        "message.read",
+        "message.received",
+        "message.sent",
+        "reaction.received",
+        "reaction.removed",
+        "template.status_changed"
+      ],
+      edits: false,
+      deletes: false,
+      idempotency: true
+    }
   };
 });
 
@@ -173827,6 +173846,8 @@ var init_schema2 = __esm(() => {
     excludeTypes: jsonb("exclude_types").$type(),
     filters: jsonb("filters").$type(),
     cursor: bigint2("cursor", { mode: "number" }).notNull().default(0),
+    shared: boolean2("shared").notNull().default(false),
+    leaseState: jsonb("lease_state").$type(),
     createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
     updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow()
   }, (table3) => ({
@@ -181067,7 +181088,13 @@ var init_plugin2 = __esm(() => {
   init_stream_store();
   A2A_CAPABILITIES = {
     ...DEFAULT_CAPABILITIES,
-    canSendText: true
+    canSendText: true,
+    events: {
+      emits: ["instance.connected", "instance.disconnected", "message.received"],
+      edits: false,
+      deletes: false,
+      idempotency: false
+    }
   };
   A2AChannelPlugin = class A2AChannelPlugin extends BaseChannelPlugin {
     id = "a2a";
@@ -251050,7 +251077,7 @@ var init_sentry_scrub = __esm(() => {
 var require_package7 = __commonJS((exports, module) => {
   module.exports = {
     name: "@omni/api",
-    version: "2.260915.15",
+    version: "2.260915.17",
     private: true,
     type: "module",
     exports: {
@@ -312878,6 +312905,7 @@ var init_scopes = __esm(() => {
     "GET /handoffs/:id": "handoffs:read",
     "GET /instances": "instances:read",
     "GET /instances/supported-channels": "instances:read",
+    "GET /channels/capabilities": "instances:read",
     "GET /instances/:id": "instances:read",
     "POST /instances": "instances:write",
     "PATCH /instances/:id": "instances:write",
@@ -313697,6 +313725,7 @@ var init_route_ownership = __esm(() => {
     "GET /api/v2/batch-jobs",
     "GET /api/v2/batch-jobs/:id",
     "GET /api/v2/batch-jobs/:id/status",
+    "GET /api/v2/channels/capabilities",
     "GET /api/v2/channels/harness/:instanceId/transcript",
     "GET /api/v2/chats",
     "GET /api/v2/chats/:id",
@@ -370407,6 +370436,24 @@ var init_events2 = __esm(() => {
 });
 
 // ../api/src/services/event-consumers.ts
+import { randomUUID as randomUUID4 } from "crypto";
+function planSharedPull(state, now) {
+  const expired = state.leases.find((lease) => lease.expiresAt <= now);
+  return expired ? { reclaim: expired } : { after: state.claimed };
+}
+function claimLease(state, lease, replaces) {
+  return {
+    claimed: Math.max(state.claimed, lease.to),
+    leases: [...state.leases.filter((l) => l.id !== replaces), lease]
+  };
+}
+function releaseLease(state, leaseId) {
+  if (!state.leases.some((l) => l.id === leaseId))
+    return null;
+  const leases = state.leases.filter((l) => l.id !== leaseId);
+  const cursor = leases.length ? Math.min(...leases.map((l) => l.from)) : state.claimed;
+  return { state: { claimed: state.claimed, leases }, cursor };
+}
 function matchesConsumerPayload(row, filters) {
   if (!filters || filters.length === 0)
     return true;
@@ -370462,7 +370509,9 @@ class EventConsumerService {
       eventType: input.eventType,
       excludeTypes: input.excludeTypes?.length ? input.excludeTypes : null,
       filters: input.filters ?? null,
-      cursor
+      cursor,
+      shared: input.shared ?? false,
+      leaseState: input.shared ? { claimed: cursor, leases: [] } : null
     }).onConflictDoNothing({ target: durableConsumers.name }).returning();
     if (!created) {
       throw new ConflictError("DurableConsumer", `a consumer named '${input.name}' already exists`, {
@@ -370474,7 +370523,8 @@ class EventConsumerService {
         consumerId: created.id,
         name: created.name,
         eventType: created.eventType,
-        cursor: created.cursor
+        cursor: created.cursor,
+        shared: created.shared
       });
     }
     return this.withLag(created, head);
@@ -370496,6 +370546,8 @@ class EventConsumerService {
     const limit2 = Math.min(Math.max(options.limit ?? 100, 1), PULL_MAX_LIMIT);
     const waitMs = Math.min(Math.max(options.waitMs ?? 0, 0), PULL_MAX_WAIT_MS);
     const consumer = await this.getByName(name);
+    if (consumer.shared)
+      return this.pullShared(consumer, limit2, waitMs, options.leaseMs ?? DEFAULT_LEASE_MS);
     const deadline = Date.now() + waitMs;
     let scanned = await this.scanPage(consumer, limit2);
     while (scanned.length === 0 && Date.now() < deadline) {
@@ -370519,20 +370571,93 @@ class EventConsumerService {
       scanExhausted: hasMore && items.length === 0
     };
   }
-  async ack(name, cursor) {
-    const [updated] = await this.db.update(durableConsumers).set({ cursor, updatedAt: new Date }).where(and2(eq(durableConsumers.name, name), lte(durableConsumers.cursor, cursor))).returning();
+  async ack(name, cursor, leaseId) {
+    if (leaseId)
+      return this.ackShared(name, leaseId);
+    const [updated] = await this.db.update(durableConsumers).set({ cursor, updatedAt: new Date }).where(and2(eq(durableConsumers.name, name), eq(durableConsumers.shared, false), lte(durableConsumers.cursor, cursor))).returning();
     if (!updated) {
       const existing = await this.getByName(name);
+      if (existing.shared) {
+        throw new ValidationError(`consumer '${name}' is shared \u2014 ack with the pull result's leaseId`, undefined, {
+          name
+        });
+      }
       throw new ValidationError(`ack cursor ${cursor} is behind the stored cursor ${existing.cursor} \u2014 acks are monotonic`, undefined, { name, cursor, storedCursor: existing.cursor });
     }
     return this.withLag(updated, await this.head());
   }
-  async scanPage(consumer, limit2) {
+  async pullShared(initial, limit2, waitMs, leaseMs) {
+    const deadline = Date.now() + waitMs;
+    let claim = await this.claimShared(initial, limit2, leaseMs);
+    while (!claim.lease && Date.now() < deadline) {
+      await new Promise((resolve4) => setTimeout(resolve4, PULL_POLL_INTERVAL_MS));
+      claim = await this.claimShared(await this.getByName(initial.name), limit2, leaseMs);
+    }
+    const { consumer, lease, scanned } = claim;
+    const items = scanned.filter((row) => matchesConsumerPayload(row, consumer.filters));
+    if (lease && items.length === 0) {
+      await this.ackShared(consumer.name, lease.id).catch(() => {
+        return;
+      });
+    }
+    const hasMore = scanned.length === limit2;
+    return {
+      consumer: consumer.name,
+      items,
+      cursor: lease?.to ?? consumer.cursor,
+      head: await this.head(),
+      hasMore,
+      scanExhausted: hasMore && items.length === 0,
+      ...lease && items.length > 0 ? { leaseId: lease.id } : {}
+    };
+  }
+  async claimShared(start, limit2, leaseMs) {
+    let consumer = start;
+    for (let attempt = 0;attempt < SHARED_CAS_ATTEMPTS; attempt++) {
+      const state = consumer.leaseState ?? { claimed: consumer.cursor, leases: [] };
+      const now = Date.now();
+      const plan = planSharedPull(state, now);
+      const scanned = plan.reclaim ? await this.scanPage(consumer, PULL_MAX_LIMIT, plan.reclaim.from, plan.reclaim.to) : await this.scanPage(consumer, limit2, plan.after);
+      const last = scanned[scanned.length - 1];
+      if (!plan.reclaim && !last)
+        return { consumer, lease: null, scanned };
+      const lease = plan.reclaim ? { ...plan.reclaim, id: randomUUID4(), expiresAt: now + leaseMs } : { id: randomUUID4(), from: plan.after, to: Number(last?.journalSeq), expiresAt: now + leaseMs };
+      if (await this.casLeaseState(consumer, claimLease(state, lease, plan.reclaim?.id))) {
+        return { consumer, lease, scanned };
+      }
+      consumer = await this.getByName(consumer.name);
+    }
+    throw new ConflictError("DurableConsumer", `too much contention leasing '${start.name}', retry`, {
+      name: start.name
+    });
+  }
+  async ackShared(name, leaseId) {
+    for (let attempt = 0;attempt < SHARED_CAS_ATTEMPTS; attempt++) {
+      const consumer = await this.getByName(name);
+      if (!consumer.shared) {
+        throw new ValidationError(`consumer '${name}' is not shared \u2014 ack with a cursor`, undefined, { name });
+      }
+      const released = releaseLease(consumer.leaseState ?? { claimed: consumer.cursor, leases: [] }, leaseId);
+      if (!released) {
+        throw new ValidationError(`lease ${leaseId} is unknown or expired \u2014 its page was (or will be) redelivered`, undefined, { name, leaseId });
+      }
+      const updated = await this.casLeaseState(consumer, released.state, Math.max(consumer.cursor, released.cursor));
+      if (updated)
+        return this.withLag(updated, await this.head());
+    }
+    throw new ConflictError("DurableConsumer", `too much contention acking '${name}', retry`, { name });
+  }
+  async casLeaseState(consumer, next, cursor) {
+    const unchanged = consumer.leaseState ? sql`${durableConsumers.leaseState} = ${JSON.stringify(consumer.leaseState)}::jsonb` : isNull2(durableConsumers.leaseState);
+    const [updated] = await this.db.update(durableConsumers).set({ leaseState: next, ...cursor === undefined ? {} : { cursor }, updatedAt: new Date }).where(and2(eq(durableConsumers.id, consumer.id), unchanged)).returning();
+    return updated ?? null;
+  }
+  async scanPage(consumer, limit2, after = consumer.cursor, through) {
     const typeClause = eventTypeFilterClause([consumer.eventType], consumer.excludeTypes ?? undefined);
-    return this.db.select().from(omniEvents).where(and2(gt(omniEvents.journalSeq, consumer.cursor), typeClause)).orderBy(asc(omniEvents.journalSeq)).limit(limit2);
+    return this.db.select().from(omniEvents).where(and2(gt(omniEvents.journalSeq, after), through === undefined ? undefined : lte(omniEvents.journalSeq, through), typeClause)).orderBy(asc(omniEvents.journalSeq)).limit(limit2);
   }
 }
-var PULL_POLL_INTERVAL_MS = 500, PULL_MAX_LIMIT = 500, PULL_MAX_WAIT_MS = 30000;
+var PULL_POLL_INTERVAL_MS = 500, PULL_MAX_LIMIT = 500, PULL_MAX_WAIT_MS = 30000, DEFAULT_LEASE_MS = 60000, SHARED_CAS_ATTEMPTS = 20;
 var init_event_consumers = __esm(() => {
   init_src();
   init_src5();
@@ -379436,6 +379561,39 @@ var init_channel_harness = __esm(() => {
   });
 });
 
+// ../api/src/schemas/openapi/channels.ts
+function registerChannelSchemas(registry4) {
+  registry4.register("ChannelCapabilities", ChannelCapabilitiesSchema);
+  registry4.registerPath({
+    method: "get",
+    path: "/channels/capabilities",
+    operationId: "listChannelCapabilities",
+    tags: ["Instances"],
+    summary: "Channel capability matrix",
+    description: "Event types and guarantees (edits, deletes, idempotency) each loaded channel plugin declares. Declarations are verified against the channel code by a static test.",
+    responses: {
+      200: {
+        description: "Capability matrix",
+        content: { "application/json": { schema: ChannelCapabilitiesMatrixSchema } }
+      }
+    }
+  });
+}
+var CapabilityFlagSchema, ChannelCapabilitiesSchema, ChannelCapabilitiesMatrixSchema;
+var init_channels = __esm(() => {
+  init_zod_openapi();
+  CapabilityFlagSchema = exports_external.union([exports_external.boolean(), exports_external.literal("unknown")]).openapi({ description: "true/false as established from the channel's code; 'unknown' when undeclared" });
+  ChannelCapabilitiesSchema = exports_external.object({
+    id: exports_external.string().openapi({ description: "Channel type (e.g. whatsapp-baileys)" }),
+    name: exports_external.string().openapi({ description: "Human-readable channel name" }),
+    emits: exports_external.array(exports_external.string()).nullable().openapi({ description: "Core event types the channel publishes; null when the plugin declares none" }),
+    edits: CapabilityFlagSchema,
+    deletes: CapabilityFlagSchema,
+    idempotency: CapabilityFlagSchema
+  });
+  ChannelCapabilitiesMatrixSchema = exports_external.object({ items: exports_external.array(ChannelCapabilitiesSchema) });
+});
+
 // ../api/src/schemas/openapi/conversations.ts
 function registerConversationSchemas(registry4) {
   registry4.register("Conversation", ConversationSchema2);
@@ -379843,6 +380001,9 @@ var init_event_consumers2 = __esm(() => {
     excludeTypes: exports_external.array(exports_external.string()).nullable().openapi({ description: "Type globs dropped from the stream (exclusion wins over eventType), or null" }),
     filters: exports_external.array(ConsumerConditionSchema).nullable().openapi({ description: "Payload conditions (AND), or null" }),
     cursor: exports_external.number().int().openapi({ description: "Last acked journal_seq; delivery resumes strictly after it" }),
+    shared: exports_external.boolean().openapi({
+      description: "true = competing consumers (pullers on this name split the stream); false = own cursor (fan-out)"
+    }),
     head: exports_external.number().int().openapi({ description: "Highest journal_seq currently in the journal" }),
     lag: exports_external.number().int().openapi({ description: "head - cursor (all journal rows past the cursor, not only matches)" }),
     caughtUp: exports_external.boolean().openapi({ description: "No type-matching journal row past the cursor (lag may still count other types)" }),
@@ -379854,16 +380015,25 @@ var init_event_consumers2 = __esm(() => {
     eventType: exports_external.string().min(1).max(255).openapi({ description: "Type filter: exact event type, or trailing-* prefix glob (e.g. custom.github.*)" }),
     excludeTypes: exports_external.array(exports_external.string().min(1).max(255)).max(20).optional().openapi({ description: "Type globs to drop (same syntax as eventType); exclusion wins over inclusion" }),
     filters: exports_external.array(ConsumerConditionSchema).max(20).optional().openapi({ description: "Payload conditions (AND) \u2014 same matcher as events wait --filter" }),
-    startFrom: exports_external.enum(["now", "beginning"]).optional().openapi({ description: "Initial cursor: 'now' = journal head (default), 'beginning' = full replay" })
+    startFrom: exports_external.enum(["now", "beginning"]).optional().openapi({ description: "Initial cursor: 'now' = journal head (default), 'beginning' = full replay" }),
+    shared: exports_external.boolean().optional().openapi({
+      description: "Competing consumers (#1188). false (default) = fan-out: every consumer name has its own cursor and sees every " + "event. true = N pullers on THIS name split the stream: each pull leases a page to one puller, ack(leaseId) " + "releases it, an unacked lease is redelivered after leaseMs (at-least-once)."
+    })
   });
   PullConsumerQuerySchema = exports_external.object({
     limit: exports_external.coerce.number().int().min(1).max(500).optional().openapi({ description: "Max journal rows to scan (default 100)" }),
-    waitMs: exports_external.coerce.number().int().min(0).max(30000).optional().openapi({ description: "Long-poll: wait up to this long when no rows are available (default 0)" })
+    waitMs: exports_external.coerce.number().int().min(0).max(30000).optional().openapi({ description: "Long-poll: wait up to this long when no rows are available (default 0)" }),
+    leaseMs: exports_external.coerce.number().int().min(1000).max(3600000).optional().openapi({ description: "Shared consumers: lease duration before the page is redelivered (default 60000)" })
   });
   AckConsumerSchema = exports_external.object({
-    cursor: exports_external.coerce.number().int().min(0).openapi({
+    cursor: exports_external.coerce.number().int().min(0).optional().openapi({
       description: `The journal_seq to advance to (a pull result's "cursor"). Monotonic: equal = no-op, lower = 400`
+    }),
+    leaseId: exports_external.string().uuid().optional().openapi({
+      description: "Shared consumers: the pull result's leaseId (required instead of cursor)"
     })
+  }).refine((body) => body.cursor !== undefined || body.leaseId !== undefined, {
+    message: "cursor or leaseId is required"
   });
   PullResultSchema = exports_external.object({
     consumer: exports_external.string().openapi({ description: "Consumer name" }),
@@ -379875,6 +380045,9 @@ var init_event_consumers2 = __esm(() => {
     hasMore: exports_external.boolean().openapi({ description: "True when the scan filled the page \u2014 more rows are already waiting" }),
     scanExhausted: exports_external.boolean().openapi({
       description: "A full scan window matched nothing; the stored cursor was advanced past it (#1128)"
+    }),
+    leaseId: exports_external.string().optional().openapi({
+      description: "Shared consumers only: ack this lease once the items are handled (absent when nothing delivered)"
     })
   });
 });
@@ -383749,6 +383922,7 @@ var init_openapi2 = __esm(() => {
   init_auth2();
   init_automations3();
   init_channel_harness();
+  init_channels();
   init_common4();
   init_conversations2();
   init_dead_letters2();
@@ -383790,6 +383964,7 @@ var init_openapi2 = __esm(() => {
   registerLogSchemas(registry4);
   registerDeadLetterSchemas(registry4);
   registerEventOpsSchemas(registry4);
+  registerChannelSchemas(registry4);
   registerEventSchemaSchemas(registry4);
   registerEventConsumerSchemas(registry4);
   registerMetricsSchemas(registry4);
@@ -385493,6 +385668,25 @@ var init_channel_harness2 = __esm(() => {
   });
 });
 
+// ../api/src/routes/v2/channels.ts
+var channelsRoutes;
+var init_channels2 = __esm(() => {
+  init_dist2();
+  channelsRoutes = new Hono2;
+  channelsRoutes.get("/capabilities", (c) => {
+    const plugins = c.get("channelRegistry")?.getAll() ?? [];
+    const items = plugins.map((plugin13) => ({
+      id: plugin13.id,
+      name: plugin13.name,
+      emits: plugin13.capabilities.events ? [...plugin13.capabilities.events.emits] : null,
+      edits: plugin13.capabilities.events?.edits ?? "unknown",
+      deletes: plugin13.capabilities.events?.deletes ?? "unknown",
+      idempotency: plugin13.capabilities.events?.idempotency ?? "unknown"
+    }));
+    return c.json({ items });
+  });
+});
+
 // ../api/src/plugins/session-cleaner.ts
 function trustedTenantOf(event) {
   const classification = classifyEnvelope(event.metadata);
@@ -386708,16 +386902,16 @@ var init_event_consumers3 = __esm(() => {
   });
   eventConsumersRoutes.post("/events/consumers/:name/pull", zValidator("query", PullConsumerQuerySchema), async (c) => {
     const name = c.req.param("name");
-    const { limit: limit2, waitMs } = c.req.valid("query");
+    const { limit: limit2, waitMs, leaseMs } = c.req.valid("query");
     const services = c.get("services");
-    const result = await services.eventConsumers.pull(name, { limit: limit2, waitMs });
+    const result = await services.eventConsumers.pull(name, { limit: limit2, waitMs, leaseMs });
     return c.json(result);
   });
   eventConsumersRoutes.post("/events/consumers/:name/ack", zValidator("json", AckConsumerSchema), async (c) => {
     const name = c.req.param("name");
-    const { cursor } = c.req.valid("json");
+    const { cursor, leaseId } = c.req.valid("json");
     const services = c.get("services");
-    const data = await services.eventConsumers.ack(name, cursor);
+    const data = await services.eventConsumers.ack(name, cursor ?? 0, leaseId);
     return c.json({ data });
   });
 });
@@ -396376,7 +396570,7 @@ var init_webhooks3 = __esm(() => {
 });
 
 // ../api/src/lib/oauth-token-cache.ts
-import { randomUUID as randomUUID4 } from "crypto";
+import { randomUUID as randomUUID5 } from "crypto";
 function put(accessToken, ttlMs = DEFAULT_TTL_MS4) {
   if (!accessToken)
     throw new Error("oauth-token-cache: accessToken is required");
@@ -396385,7 +396579,7 @@ function put(accessToken, ttlMs = DEFAULT_TTL_MS4) {
     if (oldest)
       store.delete(oldest);
   }
-  const handle = `eshandle_${randomUUID4()}`;
+  const handle = `eshandle_${randomUUID5()}`;
   store.set(handle, { accessToken, expiresAt: Date.now() + ttlMs });
   return handle;
 }
@@ -397154,6 +397348,7 @@ var init_v2 = __esm(() => {
   init_automations4();
   init_batch_jobs2();
   init_channel_harness2();
+  init_channels2();
   init_chats2();
   init_context5();
   init_conversations3();
@@ -397211,6 +397406,7 @@ var init_v2 = __esm(() => {
   v2Routes.route("/metrics", metricsRoutes);
   v2Routes.route("/conversations", conversationsRoutes);
   v2Routes.route("/chats", chatsRoutes);
+  v2Routes.route("/channels", channelsRoutes);
   v2Routes.route("/channels/harness", harnessRoutes);
   v2Routes.route("/media", mediaRoutes);
   v2Routes.route("/batch-jobs", batchJobsRoutes);
@@ -402313,7 +402509,23 @@ var ASC_CAPABILITIES = {
       maxSize: 100 * 1024 * 1024
     },
     { mimeType: "text/plain", maxSize: 100 * 1024 * 1024 }
-  ]
+  ],
+  events: {
+    emits: [
+      "instance.connected",
+      "instance.disconnected",
+      "message.delivered",
+      "message.failed",
+      "message.read",
+      "message.received",
+      "message.sent",
+      "reaction.received",
+      "reaction.removed"
+    ],
+    edits: false,
+    deletes: false,
+    idempotency: true
+  }
 };
 
 // ../channel-asc/src/utils/errors.ts
@@ -403239,7 +403451,13 @@ var ASC_FLOW_CAPABILITIES = {
     { mimeType: "audio/*", maxSize: 16 * 1024 * 1024 },
     { mimeType: "video/*", maxSize: 16 * 1024 * 1024 },
     { mimeType: "application/*", maxSize: 16 * 1024 * 1024 }
-  ]
+  ],
+  events: {
+    emits: ["instance.connected", "instance.disconnected", "message.failed", "message.received", "message.sent"],
+    edits: false,
+    deletes: false,
+    idempotency: true
+  }
 };
 
 // ../channel-asc-flow/src/utils/errors.ts
@@ -404745,7 +404963,23 @@ var DISCORD_CAPABILITIES = {
   maxEmbedFields: 25,
   maxButtonsPerRow: 5,
   maxRowsPerMessage: 5,
-  maxSelectOptions: 25
+  maxSelectOptions: 25,
+  events: {
+    emits: [
+      "instance.connected",
+      "instance.disconnected",
+      "message.failed",
+      "message.received",
+      "message.sent",
+      "reaction.received",
+      "reaction.removed",
+      "voice.user_joined_channel",
+      "voice.user_left_channel"
+    ],
+    edits: true,
+    deletes: true,
+    idempotency: true
+  }
 };
 
 // ../channel-discord/src/client.ts
@@ -408150,7 +408384,21 @@ var GUPSHUP_CAPABILITIES = {
     { mimeType: "video/*", maxSize: 100 * 1024 * 1024 },
     { mimeType: "application/*", maxSize: 100 * 1024 * 1024 },
     { mimeType: "image/webp", maxSize: 100 * 1024 * 1024 }
-  ]
+  ],
+  events: {
+    emits: [
+      "instance.connected",
+      "instance.disconnected",
+      "message.delivered",
+      "message.failed",
+      "message.read",
+      "message.received",
+      "message.sent"
+    ],
+    edits: false,
+    deletes: false,
+    idempotency: true
+  }
 };
 
 // ../channel-gupshup/src/utils/errors.ts
@@ -409239,7 +409487,13 @@ var HARNESS_CAPABILITIES = {
   canSendButtons: true,
   canSendSelectMenu: true,
   canReplyToMessage: true,
-  supportedMediaTypes: [{ mimeType: "*/*" }]
+  supportedMediaTypes: [{ mimeType: "*/*" }],
+  events: {
+    emits: ["message.failed", "message.received", "message.sent"],
+    edits: false,
+    deletes: false,
+    idempotency: true
+  }
 };
 var MEDIA_CONTENT_TYPES = new Set(["image", "audio", "video", "document", "sticker"]);
 
@@ -409545,7 +409799,23 @@ var HERMES_CAPABILITIES = {
       maxSize: 100 * 1024 * 1024
     },
     { mimeType: "text/plain", maxSize: 100 * 1024 * 1024 }
-  ]
+  ],
+  events: {
+    emits: [
+      "instance.connected",
+      "instance.disconnected",
+      "message.delivered",
+      "message.failed",
+      "message.read",
+      "message.received",
+      "message.sent",
+      "reaction.received",
+      "reaction.removed"
+    ],
+    edits: false,
+    deletes: false,
+    idempotency: true
+  }
 };
 
 // ../channel-hermes/src/utils/errors.ts
@@ -410556,7 +410826,24 @@ var SLACK_CAPABILITIES = {
   maxFileSize: 1024 * 1024 * 1024,
   maxButtonsPerRow: 5,
   maxRowsPerMessage: 50,
-  maxSelectOptions: 100
+  maxSelectOptions: 100,
+  events: {
+    emits: [
+      "agent.run.cancel_requested",
+      "instance.connected",
+      "instance.disconnected",
+      "message.failed",
+      "message.pinned",
+      "message.received",
+      "message.sent",
+      "message.unpinned",
+      "reaction.received",
+      "reaction.removed"
+    ],
+    edits: false,
+    deletes: false,
+    idempotency: true
+  }
 };
 
 // ../channel-slack/src/config/stream-mode.ts
@@ -413401,7 +413688,24 @@ var TELEGRAM_CAPABILITIES = {
     { mimeType: "video/*", maxSize: 50 * 1024 * 1024 },
     { mimeType: "application/*", maxSize: 50 * 1024 * 1024 }
   ],
-  maxFileSize: 50 * 1024 * 1024
+  maxFileSize: 50 * 1024 * 1024,
+  events: {
+    emits: [
+      "instance.connected",
+      "instance.disconnected",
+      "message.button_click",
+      "message.failed",
+      "message.poll",
+      "message.poll_vote",
+      "message.received",
+      "message.sent",
+      "reaction.received",
+      "reaction.removed"
+    ],
+    edits: false,
+    deletes: false,
+    idempotency: true
+  }
 };
 
 // ../channel-telegram/src/client.ts
@@ -527765,7 +528069,28 @@ var WHATSAPP_CAPABILITIES = {
     { mimeType: "video/*", maxSize: 64 * 1024 * 1024 },
     { mimeType: "application/*", maxSize: 100 * 1024 * 1024 }
   ],
-  maxFileSize: 100 * 1024 * 1024
+  maxFileSize: 100 * 1024 * 1024,
+  events: {
+    emits: [
+      "instance.connected",
+      "instance.disconnected",
+      "instance.qr_code",
+      "media.received",
+      "message.delivered",
+      "message.failed",
+      "message.read",
+      "message.received",
+      "message.sent",
+      "presence.offline",
+      "presence.online",
+      "presence.typing",
+      "reaction.received",
+      "reaction.removed"
+    ],
+    edits: true,
+    deletes: true,
+    idempotency: true
+  }
 };
 
 // ../channel-whatsapp/src/env.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automagik/omni",
-  "version": "2.260915.15",
+  "version": "2.260915.17",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/automagik-dev/omni.git",