@automagik/omni 2.260908.11 → 2.260908.12

package/db/drizzle/0064_durable_consumers.sql

@@ -0,0 +1,46 @@
+-- Durable named event consumers (#989, RFC #925 G7 — the durable half of the
+-- event-consumer surface; the one-shot half, `omni events wait`, shipped in
+-- PR #972).
+--
+-- omni_events.journal_seq: a monotonic journal position assigned by a
+-- sequence at insert. The durable-consumer cursor is "last acked journal_seq"
+-- and delivery resumes strictly after it. receivedAt cannot anchor an
+-- at-least-once cursor — it carries the PUBLISHER's clock and lands out of
+-- order under consumer retries. BIGSERIAL backfills existing rows (physical
+-- order; they predate every consumer, so the order among them is moot).
+--
+-- durable_consumers: the registry — name (globally unique), event-type filter
+-- (trailing-* prefix glob, the #966 contract), optional payload conditions
+-- (same matcher as `events wait --filter` / automation triggers), and the
+-- cursor. NOT consumer_offsets: that table is owned by the NATS subscription
+-- layer (gap detection over NATS stream sequences); this registry has an
+-- API-managed lifecycle and a different sequence space (the journal IS the
+-- replay source, NATS is transport).
+--
+-- TENANCY: global — no tenant_id column, following the event_schemas
+-- precedent (0056): the RLS coverage gate requires every tenant_id-bearing
+-- table to be in the frozen G0 manifest, the G1 tenant plane, or the
+-- runtime-denied exclusions. Event reads stay tenant-policed through
+-- omni_events' own RLS; per-tenant consumer ownership joins additively in
+-- the G6+ ownership pass.
+--
+-- Hand-written following the 0043/0044/0052 precedent (additive, idempotent).
+--
+-- NOTE: no explicit BEGIN/COMMIT — the boot migrator executes this file on a
+-- pooled postgres-js connection, which rejects raw transaction control.
+
+ALTER TABLE "omni_events" ADD COLUMN IF NOT EXISTS "journal_seq" bigserial;
+--> statement-breakpoint
+CREATE UNIQUE INDEX IF NOT EXISTS "omni_events_journal_seq_uq" ON "omni_events" ("journal_seq");
+--> statement-breakpoint
+CREATE TABLE IF NOT EXISTS "durable_consumers" (
+  "id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+  "name" varchar(100) NOT NULL,
+  "event_type" varchar(255) NOT NULL,
+  "filters" jsonb,
+  "cursor" bigint DEFAULT 0 NOT NULL,
+  "created_at" timestamp with time zone DEFAULT now() NOT NULL,
+  "updated_at" timestamp with time zone DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX IF NOT EXISTS "durable_consumers_name_uq" ON "durable_consumers" ("name");

package/db/drizzle/meta/_journal.json

@@ -449,6 +449,13 @@
       "when": 1786300000000,
       "tag": "0063_automation_manifest_provenance",
       "breakpoints": true
+    },
+    {
+      "idx": 64,
+      "version": "7",
+      "when": 1786400000000,
+      "tag": "0064_durable_consumers",
+      "breakpoints": true
     }
   ]
 }

package/dist/commands/events.d.ts

@@ -117,6 +117,53 @@ export declare function matchesWaitEvent(event: WaitEventRow, filters: StreamFil
  * accepted transport (the issue's non-goal keeps SSE/WS out of scope).
  */
 export declare function waitForEvent(client: OmniClient, params: WaitParams): Promise<WaitEventRow | null>;
+/** A durable consumer as the API returns it (registration + live lag). */
+interface ConsumerData {
+    id: string;
+    name: string;
+    eventType: string;
+    filters: AutomationCondition[] | null;
+    cursor: number;
+    head: number;
+    lag: number;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Raw CLI→API call for the consumer endpoints — the generated SDK does not
+ * cover them yet (`schemaApiRequest` precedent; the CLI only ever talks to
+ * the API, never the database).
+ */
+export declare function consumersApiRequest<T>(path: string, init?: {
+    method?: string;
+    body?: string;
+}): Promise<T>;
+export declare function summarizeConsumerRow(row: ConsumerData): Record<string, unknown>;
+export interface FollowParams {
+    consumer: string;
+    /** Max rows scanned per pull page. */
+    limit: number;
+    /** Server-side long-poll window per pull when the journal is idle. */
+    waitMs: number;
+    /** Advance the cursor as pages are printed (default). false = peek one page, exit. */
+    ack: boolean;
+    /** Exit 0 once caught up (no new rows scanned) instead of tailing forever. */
+    untilIdle: boolean;
+    /** External stop signal (SIGINT). */
+    isStopped?: () => boolean;
+    /** Line sink — defaults to output.raw (stdout). Injected by tests. */
+    emit?: (line: string) => void;
+}
+/**
+ * The `omni events follow` loop: pull a page from the stored cursor, print
+ * each event as a JSON line, ack the SCANNED cursor (so filtered-out rows are
+ * skipped too), repeat. Resumes exactly-after-cursor across restarts because
+ * progress lives server-side.
+ *
+ * With `ack: false` the stored cursor never moves, so a loop would replay the
+ * same page forever — peek mode prints ONE page and returns.
+ */
+export declare function followConsumer(params: FollowParams): Promise<void>;
 export declare function createEventsCommand(): Command;
 export {};
 //# sourceMappingURL=events.d.ts.map

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":"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"}

package/dist/index.js

@@ -81405,6 +81405,7 @@ __export(exports_schema, {
   eventTypes: () => eventTypes,
   eventSchemas: () => eventSchemas,
   eventPayloads: () => eventPayloads,
+  durableConsumers: () => durableConsumers,
   deliveryStatuses: () => deliveryStatuses,
   debounceMode: () => debounceMode,
   deadLetterStatuses: () => deadLetterStatuses,
@@ -81465,7 +81466,7 @@ __export(exports_schema, {
   accessRules: () => accessRules,
   accessModes: () => accessModes
 });
-var channelTypes, agentTypes, agentSystems, agentEntityTypes, debounceMode, splitDelayMode, supersedeMode, replyFilterMode, agentSessionStrategies, ruleTypes, accessModes, settingValueTypes, apiKeyStatuses, apiKeyProfiles, eventTypes, contentTypes, chatTypes, messageSources, messageTypes, messageStatuses, deliveryStatuses, scheduledMessageDeliveryModes, scheduledMessageStatuses, jobStatuses, providerSchemas, agentProviders, agents, agentRoutes, agentSessions, apiKeys, apiKeyAuditLogs, apiKeysRelations, apiKeyAuditLogsRelations, instances, whatsappTemplates, whatsappFlowKeys, scheduledMessages, persons, platformIdentities, conversations, chats, chatParticipants, omniGroups, messages2, omniEvents, handoffLogs, closeContactOutcomes, closeContactLogs, accessRules, globalSettings, settingChangeHistory, batchJobs, syncJobTypes, syncJobs, mediaContent, chatIdMappings, pluginStorage, agentProvidersRelations, agentsRelations, instancesRelations, syncJobsRelations, personsRelations, platformIdentitiesRelations, conversationsRelations, chatsRelations, chatParticipantsRelations, messagesRelations, omniEventsRelations, accessRulesRelations, globalSettingsRelations, settingChangeHistoryRelations, batchJobsRelations, mediaContentRelations, chatIdMappingsRelations, deadLetterStatuses, deadLetterEvents, payloadStorageConfig, payloadStages, eventPayloads, webhookSignatureAlgorithms, connectorLivenessStatuses, connectorWindowSemanticsValues, connectorMutationPolicies, webhookSources, eventSchemas, conditionOperators, actionTypes, automationDebounceModes, automations2, automationLogStatuses, automationLogs, consumerOffsets, automationsRelations, automationLogsRelations, triggerLogs, triggerLogsRelations, agentRoutesRelations, agentTaskStatuses, agentTasks, agentTasksRelations, turnStatuses, turnActions, turns, turnsRelations, followUpDisarmReasons, chatFollowUpState, chatFollowUpStateRelations, processedEvents, genieHosts, tenantStatuses, principalTypes, principalStatuses, tenantRoles, membershipStatuses, credentialClasses, authCredentialStatuses, platformApiKeyStatuses, tenants, principals, tenantMemberships, tenantRolePolicies, platformApiKeys, tenantKeyLineage, authCredentials, tenantAuditLogs, platformAuditLogs, platformProviderCatalog, tenantProviderConfig, platformSettings, tenantSettings, platformSettingChangeHistory, tenantSettingChangeHistory, platformPluginStorage, tenantPluginStorage, platformPayloadStorageConfig, tenantPayloadStorageOverrides, tenantMigrationLedger, tenantMigrationLedgerHistory;
+var channelTypes, agentTypes, agentSystems, agentEntityTypes, debounceMode, splitDelayMode, supersedeMode, replyFilterMode, agentSessionStrategies, ruleTypes, accessModes, settingValueTypes, apiKeyStatuses, apiKeyProfiles, eventTypes, contentTypes, chatTypes, messageSources, messageTypes, messageStatuses, deliveryStatuses, scheduledMessageDeliveryModes, scheduledMessageStatuses, jobStatuses, providerSchemas, agentProviders, agents, agentRoutes, agentSessions, apiKeys, apiKeyAuditLogs, apiKeysRelations, apiKeyAuditLogsRelations, instances, whatsappTemplates, whatsappFlowKeys, scheduledMessages, persons, platformIdentities, conversations, chats, chatParticipants, omniGroups, messages2, omniEvents, handoffLogs, closeContactOutcomes, closeContactLogs, accessRules, globalSettings, settingChangeHistory, batchJobs, syncJobTypes, syncJobs, mediaContent, chatIdMappings, pluginStorage, agentProvidersRelations, agentsRelations, instancesRelations, syncJobsRelations, personsRelations, platformIdentitiesRelations, conversationsRelations, chatsRelations, chatParticipantsRelations, messagesRelations, omniEventsRelations, accessRulesRelations, globalSettingsRelations, settingChangeHistoryRelations, batchJobsRelations, mediaContentRelations, chatIdMappingsRelations, deadLetterStatuses, deadLetterEvents, payloadStorageConfig, payloadStages, eventPayloads, webhookSignatureAlgorithms, connectorLivenessStatuses, connectorWindowSemanticsValues, connectorMutationPolicies, webhookSources, eventSchemas, conditionOperators, actionTypes, automationDebounceModes, automations2, automationLogStatuses, automationLogs, consumerOffsets, durableConsumers, automationsRelations, automationLogsRelations, triggerLogs, triggerLogsRelations, agentRoutesRelations, agentTaskStatuses, agentTasks, agentTasksRelations, turnStatuses, turnActions, turns, turnsRelations, followUpDisarmReasons, chatFollowUpState, chatFollowUpStateRelations, processedEvents, genieHosts, tenantStatuses, principalTypes, principalStatuses, tenantRoles, membershipStatuses, credentialClasses, authCredentialStatuses, platformApiKeyStatuses, tenants, principals, tenantMemberships, tenantRolePolicies, platformApiKeys, tenantKeyLineage, authCredentials, tenantAuditLogs, platformAuditLogs, platformProviderCatalog, tenantProviderConfig, platformSettings, tenantSettings, platformSettingChangeHistory, tenantSettingChangeHistory, platformPluginStorage, tenantPluginStorage, platformPayloadStorageConfig, tenantPayloadStorageOverrides, tenantMigrationLedger, tenantMigrationLedgerHistory;
 var init_schema2 = __esm(() => {
   init_events();
   init_types4();
@@ -82201,10 +82202,12 @@ var init_schema2 = __esm(() => {
     idempotencyKey: text("idempotency_key"),
     metadata: jsonb("metadata").$type(),
     causationId: uuid("causation_id"),
+    journalSeq: bigserial("journal_seq", { mode: "number" }),
     createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
     tenantId: uuid("tenant_id").references(() => tenants.id, { onDelete: "restrict" })
   }, (table3) => ({
     causationIdx: index("omni_events_causation_idx").on(table3.causationId),
+    journalSeqUq: uniqueIndex("omni_events_journal_seq_uq").on(table3.journalSeq),
     tenantIdx: index("omni_events_tenant_idx").on(table3.tenantId),
     tenantIdUq: uniqueIndex("omni_events_tenant_id_uq").on(table3.tenantId, table3.id),
     idempotencyKeyUq: uniqueIndex("omni_events_idempotency_key_uq").on(table3.idempotencyKey),
@@ -82799,6 +82802,17 @@ var init_schema2 = __esm(() => {
     lastEventId: uuid("last_event_id"),
     updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow()
   });
+  durableConsumers = pgTable("durable_consumers", {
+    id: uuid("id").primaryKey().defaultRandom(),
+    name: varchar("name", { length: 100 }).notNull(),
+    eventType: varchar("event_type", { length: 255 }).notNull(),
+    filters: jsonb("filters").$type(),
+    cursor: bigint2("cursor", { mode: "number" }).notNull().default(0),
+    createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
+    updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow()
+  }, (table3) => ({
+    nameUq: uniqueIndex("durable_consumers_name_uq").on(table3.name)
+  }));
   automationsRelations = relations(automations2, ({ many }) => ({
     logs: many(automationLogs)
   }));
@@ -122930,12 +122944,12 @@ var require_instrumentation8 = __commonJS((exports) => {
         pendingMetrics.forEach((m10) => m10());
         return result;
       }).catch((reason) => {
-        let errorMessage2;
+        let errorMessage3;
         let errorType = semantic_conventions_1.ERROR_TYPE_VALUE_OTHER;
         if (typeof reason === "string" || reason === undefined) {
-          errorMessage2 = reason;
+          errorMessage3 = reason;
         } else if (typeof reason === "object" && Object.prototype.hasOwnProperty.call(reason, "message")) {
-          errorMessage2 = reason.message;
+          errorMessage3 = reason.message;
           errorType = reason.constructor.name;
         }
         pendingMetrics.forEach((m10) => m10(errorType));
@@ -122943,7 +122957,7 @@ var require_instrumentation8 = __commonJS((exports) => {
           span.setAttribute(semantic_conventions_1.ATTR_ERROR_TYPE, errorType);
           span.setStatus({
             code: api_1.SpanStatusCode.ERROR,
-            message: errorMessage2
+            message: errorMessage3
           });
         });
         throw reason;
@@ -136746,7 +136760,7 @@ import { fileURLToPath } from "url";
 // package.json
 var package_default = {
   name: "@automagik/omni",
-  version: "2.260908.11",
+  version: "2.260908.12",
   repository: {
     type: "git",
     url: "git+https://github.com/automagik-dev/omni.git",
@@ -143824,9 +143838,119 @@ async function waitForEvent(client, params) {
     await new Promise((resolve2) => setTimeout(resolve2, Math.min(params.pollMs, remaining)));
   }
 }
+async function consumersApiRequest(path, init = {}) {
+  const config2 = loadConfig();
+  const baseUrl = config2.apiUrl ?? "http://localhost:8882";
+  const resp = await fetch(`${baseUrl}/api/v2/events/consumers${path}`, {
+    method: init.method ?? "GET",
+    body: init.body,
+    headers: { "content-type": "application/json", "x-api-key": config2.apiKey ?? "" }
+  });
+  if (!resp.ok) {
+    throw new Error(`API returned ${resp.status}: ${await resp.text()}`);
+  }
+  return await resp.json();
+}
+function summarizeConsumerRow(row) {
+  return {
+    name: row.name,
+    eventType: row.eventType,
+    filters: row.filters?.length ? row.filters.map((f10) => `${f10.field} ${f10.operator} ${JSON.stringify(f10.value)}`).join(" AND ") : "-",
+    cursor: row.cursor,
+    lag: row.lag,
+    updatedAt: row.updatedAt
+  };
+}
+async function followConsumer(params) {
+  const emit = params.emit ?? raw;
+  let acked = -1;
+  for (;; ) {
+    if (params.isStopped?.())
+      return;
+    const page = await consumersApiRequest(`/${encodeURIComponent(params.consumer)}/pull?limit=${params.limit}&waitMs=${params.waitMs}`, { method: "POST" });
+    for (const item of page.items) {
+      emit(JSON.stringify(item));
+    }
+    if (!params.ack) {
+      await flushStdout();
+      return;
+    }
+    if (page.cursor > acked) {
+      await consumersApiRequest(`/${encodeURIComponent(params.consumer)}/ack`, {
+        method: "POST",
+        body: JSON.stringify({ cursor: page.cursor })
+      });
+    }
+    const progressed = page.items.length > 0 || page.hasMore || acked >= 0 && page.cursor > acked;
+    acked = Math.max(acked, page.cursor);
+    if (params.untilIdle && !progressed && !page.hasMore) {
+      await flushStdout();
+      return;
+    }
+    if (!progressed && params.waitMs < 1000) {
+      await new Promise((resolve2) => setTimeout(resolve2, 1000));
+    }
+  }
+}
+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("--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) => {
+    try {
+      const filters = parseWaitFilters(WaitOptionsSchema.shape.filter.parse(options.filter));
+      const result = await consumersApiRequest("", {
+        method: "POST",
+        body: JSON.stringify({
+          name,
+          eventType: options.type,
+          filters: filters.length ? filters : undefined,
+          startFrom: options.fromBeginning ? "beginning" : undefined
+        })
+      });
+      success(`Consumer registered: ${result.data.name} (cursor ${result.data.cursor})`, {
+        name: result.data.name,
+        eventType: result.data.eventType,
+        cursor: result.data.cursor,
+        lag: result.data.lag
+      });
+    } catch (err2) {
+      error(`Failed to create consumer: ${errorMessage(err2)}`);
+    }
+  });
+  consumers.command("ls").description("List durable consumers with their cursor and lag").action(async () => {
+    try {
+      const result = await consumersApiRequest("");
+      list(result.items.map(summarizeConsumerRow), { emptyMessage: "No durable consumers registered." });
+    } catch (err2) {
+      error(`Failed to list consumers: ${errorMessage(err2)}`);
+    }
+  });
+  consumers.command("inspect <name>").description("Show one consumer: filter, cursor, journal head, lag").action(async (name) => {
+    try {
+      const result = await consumersApiRequest(`/${encodeURIComponent(name)}`);
+      data(result.data);
+    } catch (err2) {
+      error(`Failed to inspect consumer: ${errorMessage(err2)}`);
+    }
+  });
+  consumers.command("rm <name>").description("Delete a consumer registration (the journal itself is untouched)").action(async (name) => {
+    try {
+      await consumersApiRequest(`/${encodeURIComponent(name)}`, { method: "DELETE" });
+      success(`Consumer removed: ${name}`);
+    } catch (err2) {
+      error(`Failed to remove consumer: ${errorMessage(err2)}`);
+    }
+  });
+  return consumers;
+}
+function errorMessage(err2) {
+  if (err2 instanceof exports_external.ZodError)
+    return err2.issues.map((i6) => i6.message).join("; ");
+  return err2 instanceof Error ? err2.message : "Unknown error";
+}
 function createEventsCommand() {
   const events2 = new Command("events").description("Query events");
   events2.addCommand(createSchemaCommand());
+  events2.addCommand(createConsumersCommand());
   events2.command("list").description("List events").option("--instance <id>", "Filter by instance ID").option("--channel <type>", "Filter by channel type").option("--type <type>", "Filter by event type (trailing * = prefix glob, e.g. custom.*)").option("--chat-id <id>", "Filter by chat ID").option("--since <time>", "Events since (e.g., 24h, 7d, or ISO timestamp)").option("--until <time>", "Events until (ISO timestamp)").option("--limit <n>", "Limit results", (v4) => Number.parseInt(v4, 10), 50).action(async (options) => {
     const client = getClient();
     try {
@@ -143899,6 +144023,31 @@ function createEventsCommand() {
       error(`Failed to wait for event: ${message2}`);
     }
   });
+  events2.command("follow").description("Tail the journal through a durable consumer: resumes from its stored cursor, prints JSON lines, acks as it goes.").requiredOption("--consumer <name>", "Durable consumer to follow (create with: omni events consumers create)").option("--limit <n>", "Max journal rows scanned per pull", (v4) => Number.parseInt(v4, 10), 100).option("--wait-ms <n>", "Server-side long-poll window per pull when idle (max 30000)", (v4) => Number.parseInt(v4, 10), 1e4).option("--no-ack", "Peek: print one page without advancing the cursor, then exit").option("--until-idle", "Exit 0 once caught up with the journal instead of tailing forever").action(async (options) => {
+    let stopped = false;
+    const shutdown = () => {
+      stopped = true;
+    };
+    const processEvents = process;
+    processEvents.on("SIGINT", shutdown);
+    processEvents.on("SIGTERM", shutdown);
+    try {
+      await followConsumer({
+        consumer: options.consumer,
+        limit: Math.min(Math.max(options.limit, 1), 500),
+        waitMs: Math.min(Math.max(options.waitMs, 0), 30000),
+        ack: options.ack,
+        untilIdle: options.untilIdle === true,
+        isStopped: () => stopped
+      });
+    } catch (err2) {
+      error(`Failed to follow consumer: ${errorMessage(err2)}`);
+    } finally {
+      processEvents.off("SIGINT", shutdown);
+      processEvents.off("SIGTERM", shutdown);
+      await flushStdout();
+    }
+  });
   events2.command("get <id>").description("Get full details for a single event by ID").action(async (id) => {
     const client = getClient();
     try {
@@ -151019,11 +151168,11 @@ function createNatsReplySidecarArtifact() {
   };
 }
 var REGISTRY = [createNatsReplySidecarArtifact()];
-function errorMessage(error2) {
+function errorMessage2(error2) {
   return error2 instanceof Error ? error2.message : String(error2);
 }
 function erroredOutcome(name, phase, error2) {
-  const message2 = errorMessage(error2);
+  const message2 = errorMessage2(error2);
   return {
     name,
     state: "errored",