@automagik/omni 2.260908.11 → 2.260908.13

package/dist/server/index.js

@@ -76865,7 +76865,7 @@ var require_ClientVoiceManager = __commonJS((exports, module) => {
 
 // ../../node_modules/.bun/@discordjs+ws@1.2.3/node_modules/@discordjs/ws/dist/index.js
 var require_dist9 = __commonJS((exports, module) => {
-  var __dirname = "/home/runner/work/omni/omni/node_modules/.bun/@discordjs+ws@1.2.3/node_modules/@discordjs/ws/dist";
+  var __dirname = "/home/runner/work/omni/omni/.stable-source/node_modules/.bun/@discordjs+ws@1.2.3/node_modules/@discordjs/ws/dist";
   var __create2 = Object.create;
   var __defProp2 = Object.defineProperty;
   var __getOwnPropDesc2 = Object.getOwnPropertyDescriptor;
@@ -162145,7 +162145,7 @@ var require_indexes = __commonJS((exports, module) => {
 
 // ../../node_modules/.bun/thread-stream@3.1.0/node_modules/thread-stream/index.js
 var require_thread_stream = __commonJS((exports, module) => {
-  var __dirname = "/home/runner/work/omni/omni/node_modules/.bun/thread-stream@3.1.0/node_modules/thread-stream";
+  var __dirname = "/home/runner/work/omni/omni/.stable-source/node_modules/.bun/thread-stream@3.1.0/node_modules/thread-stream";
   var { version } = require_package5();
   var { EventEmitter: EventEmitter3 } = __require("events");
   var { Worker } = __require("worker_threads");
@@ -162566,7 +162566,7 @@ var require_thread_stream = __commonJS((exports, module) => {
 
 // ../../node_modules/.bun/pino@9.14.0/node_modules/pino/lib/transport.js
 var require_transport2 = __commonJS((exports, module) => {
-  var __dirname = "/home/runner/work/omni/omni/node_modules/.bun/pino@9.14.0/node_modules/pino/lib";
+  var __dirname = "/home/runner/work/omni/omni/.stable-source/node_modules/.bun/pino@9.14.0/node_modules/pino/lib";
   var { createRequire: createRequire2 } = __require("module");
   var getCallers = require_caller();
   var { join: join8, isAbsolute, sep: sep2 } = __require("path");
@@ -172609,6 +172609,7 @@ __export(exports_schema, {
   eventTypes: () => eventTypes,
   eventSchemas: () => eventSchemas,
   eventPayloads: () => eventPayloads,
+  durableConsumers: () => durableConsumers,
   deliveryStatuses: () => deliveryStatuses,
   debounceMode: () => debounceMode,
   deadLetterStatuses: () => deadLetterStatuses,
@@ -172669,7 +172670,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_types5();
@@ -173405,10 +173406,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),
@@ -174003,6 +174006,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)
   }));
@@ -178364,6 +178378,7 @@ __export(exports_src3, {
   eventSchemas: () => eventSchemas,
   eventPayloads: () => eventPayloads,
   eq: () => eq,
+  durableConsumers: () => durableConsumers,
   desc: () => desc,
   deliveryStatuses: () => deliveryStatuses,
   debounceMode: () => debounceMode,
@@ -243939,7 +243954,7 @@ var require_client3 = __commonJS((exports) => {
 
 // ../../node_modules/.bun/@sentry+node-core@10.52.0+6488de8736d8e524/node_modules/@sentry/node-core/build/cjs/sdk/esmLoader.js
 var require_esmLoader = __commonJS((exports) => {
-  var __filename = "/home/runner/work/omni/omni/node_modules/.bun/@sentry+node-core@10.52.0+6488de8736d8e524/node_modules/@sentry/node-core/build/cjs/sdk/esmLoader.js";
+  var __filename = "/home/runner/work/omni/omni/.stable-source/node_modules/.bun/@sentry+node-core@10.52.0+6488de8736d8e524/node_modules/@sentry/node-core/build/cjs/sdk/esmLoader.js";
   Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
   var core3 = require_cjs6();
   var importInTheMiddle = require_import_in_the_middle();
@@ -251165,7 +251180,7 @@ var init_sentry_scrub = __esm(() => {
 var require_package7 = __commonJS((exports, module) => {
   module.exports = {
     name: "@omni/api",
-    version: "2.260908.11",
+    version: "2.260908.13",
     private: true,
     type: "module",
     exports: {
@@ -286922,7 +286937,7 @@ var require_src52 = __commonJS((exports) => {
 
 // ../../node_modules/.bun/@grpc+grpc-js@1.14.3/node_modules/@grpc/grpc-js/build/src/channelz.js
 var require_channelz = __commonJS((exports) => {
-  var __dirname = "/home/runner/work/omni/omni/node_modules/.bun/@grpc+grpc-js@1.14.3/node_modules/@grpc/grpc-js/build/src";
+  var __dirname = "/home/runner/work/omni/omni/.stable-source/node_modules/.bun/@grpc+grpc-js@1.14.3/node_modules/@grpc/grpc-js/build/src";
   Object.defineProperty(exports, "__esModule", { value: true });
   exports.registerChannelzSocket = exports.registerChannelzServer = exports.registerChannelzSubchannel = exports.registerChannelzChannel = exports.ChannelzCallTrackerStub = exports.ChannelzCallTracker = exports.ChannelzChildrenTrackerStub = exports.ChannelzChildrenTracker = exports.ChannelzTrace = exports.ChannelzTraceStub = undefined;
   exports.unregisterChannelzRef = unregisterChannelzRef;
@@ -292325,7 +292340,7 @@ var require_duration = __commonJS((exports) => {
 
 // ../../node_modules/.bun/@grpc+grpc-js@1.14.3/node_modules/@grpc/grpc-js/build/src/orca.js
 var require_orca = __commonJS((exports) => {
-  var __dirname = "/home/runner/work/omni/omni/node_modules/.bun/@grpc+grpc-js@1.14.3/node_modules/@grpc/grpc-js/build/src";
+  var __dirname = "/home/runner/work/omni/omni/.stable-source/node_modules/.bun/@grpc+grpc-js@1.14.3/node_modules/@grpc/grpc-js/build/src";
   Object.defineProperty(exports, "__esModule", { value: true });
   exports.OrcaOobMetricsSubchannelWrapper = exports.GRPC_METRICS_HEADER = exports.ServerMetricRecorder = exports.PerRequestMetricRecorder = undefined;
   exports.createOrcaClient = createOrcaClient;
@@ -302747,6 +302762,7 @@ var init_route_ownership = __esm(() => {
     "DELETE /api/v2/conversations/:id",
     "DELETE /api/v2/event-ops/replay/:id",
     "DELETE /api/v2/events/:eventId/payloads",
+    "DELETE /api/v2/events/consumers/:name",
     "DELETE /api/v2/follow-up/agents/:id",
     "DELETE /api/v2/follow-up/chats/:id",
     "DELETE /api/v2/follow-up/instances/:id",
@@ -302816,6 +302832,8 @@ var init_route_ownership = __esm(() => {
     "GET /api/v2/events/:id/trace",
     "GET /api/v2/events/analytics",
     "GET /api/v2/events/by-sender/:senderId",
+    "GET /api/v2/events/consumers",
+    "GET /api/v2/events/consumers/:name",
     "GET /api/v2/events/schemas",
     "GET /api/v2/events/schemas/:eventType",
     "GET /api/v2/events/timeline/:personId",
@@ -302957,6 +302975,9 @@ var init_route_ownership = __esm(() => {
     "POST /api/v2/dead-letters/:id/retry",
     "POST /api/v2/event-ops/replay",
     "POST /api/v2/event-ops/scheduled",
+    "POST /api/v2/events/consumers",
+    "POST /api/v2/events/consumers/:name/ack",
+    "POST /api/v2/events/consumers/:name/pull",
     "POST /api/v2/events/schemas",
     "POST /api/v2/events/search",
     "POST /api/v2/events/trigger",
@@ -359003,6 +359024,365 @@ var init_dead_letters = __esm(() => {
   log99 = createLogger("dead-letters");
 });
 
+// ../api/src/services/events.ts
+function escapeLikePattern(value) {
+  return value.replace(/([\\%_])/g, "\\$1");
+}
+
+class EventService {
+  pool;
+  get db() {
+    return scopedHandle(this.pool);
+  }
+  constructor(pool) {
+    this.pool = pool;
+  }
+  async list(options = {}) {
+    const {
+      channel: channel5,
+      instanceId,
+      personId,
+      eventType,
+      contentType,
+      direction,
+      since,
+      until,
+      search,
+      limit: limit2 = 50,
+      cursor
+    } = options;
+    const conditions3 = [];
+    if (channel5?.length) {
+      conditions3.push(inArray(omniEvents.channel, channel5));
+    }
+    if (instanceId) {
+      conditions3.push(eq(omniEvents.instanceId, instanceId));
+    } else if (options.instanceIds?.length) {
+      conditions3.push(inArray(omniEvents.instanceId, options.instanceIds));
+    }
+    if (personId) {
+      conditions3.push(eq(omniEvents.personId, personId));
+    }
+    if (eventType?.length) {
+      const exact = eventType.filter((t) => !t.endsWith("*"));
+      const prefixes = eventType.filter((t) => t.endsWith("*")).map((t) => t.slice(0, -1));
+      const typeClauses = [
+        ...exact.length ? [inArray(omniEvents.eventType, exact)] : [],
+        ...prefixes.map((p2) => like(omniEvents.eventType, `${escapeLikePattern(p2)}%`))
+      ];
+      const combined = typeClauses.length === 1 ? typeClauses[0] : or2(...typeClauses);
+      if (combined)
+        conditions3.push(combined);
+    }
+    if (contentType?.length) {
+      conditions3.push(inArray(omniEvents.contentType, contentType));
+    }
+    if (direction) {
+      conditions3.push(eq(omniEvents.direction, direction));
+    }
+    if (since) {
+      conditions3.push(gte(omniEvents.receivedAt, since));
+    }
+    if (until) {
+      conditions3.push(lte(omniEvents.receivedAt, until));
+    }
+    if (search) {
+      const searchPattern = `%${search}%`;
+      conditions3.push(or2(ilike(omniEvents.textContent, searchPattern), ilike(omniEvents.transcription, searchPattern), ilike(omniEvents.imageDescription, searchPattern)));
+    }
+    if (cursor) {
+      conditions3.push(sql`${omniEvents.receivedAt} < ${cursor}`);
+    }
+    const whereClause = conditions3.length ? and2(...conditions3) : undefined;
+    const items = await this.db.select().from(omniEvents).where(whereClause).orderBy(desc(omniEvents.receivedAt)).limit(limit2 + 1);
+    const hasMore = items.length > limit2;
+    if (hasMore) {
+      items.pop();
+    }
+    const lastItem = items[items.length - 1];
+    return {
+      items,
+      hasMore,
+      cursor: lastItem?.receivedAt.toISOString()
+    };
+  }
+  async getById(id) {
+    const [result] = await this.db.select().from(omniEvents).where(eq(omniEvents.id, id)).limit(1);
+    if (!result) {
+      throw new NotFoundError("Event", id);
+    }
+    return result;
+  }
+  async trace(id) {
+    const focus = await this.getById(id);
+    const seen = new Set([focus.id]);
+    const ancestors = [];
+    let current = focus;
+    let truncated = false;
+    while (current.causationId && ancestors.length < TRACE_MAX_ANCESTORS) {
+      if (seen.has(current.causationId))
+        break;
+      const [parent] = await this.db.select().from(omniEvents).where(eq(omniEvents.id, current.causationId)).limit(1);
+      if (!parent)
+        break;
+      seen.add(parent.id);
+      ancestors.unshift(parent);
+      current = parent;
+    }
+    if (current.causationId && ancestors.length >= TRACE_MAX_ANCESTORS)
+      truncated = true;
+    const descendants = [];
+    let frontier = [focus.id];
+    let depth = 0;
+    while (frontier.length > 0 && depth < TRACE_MAX_DEPTH && descendants.length < TRACE_MAX_NODES) {
+      depth++;
+      const children = await this.db.select().from(omniEvents).where(inArray(omniEvents.causationId, frontier)).orderBy(omniEvents.receivedAt).limit(TRACE_MAX_NODES + 1);
+      const fresh = children.filter((c) => !seen.has(c.id));
+      for (const child of fresh)
+        seen.add(child.id);
+      for (const child of fresh)
+        descendants.push({ event: child, depth });
+      if (descendants.length > TRACE_MAX_NODES) {
+        descendants.length = TRACE_MAX_NODES;
+        truncated = true;
+        break;
+      }
+      frontier = fresh.map((c) => c.id);
+    }
+    if (frontier.length > 0 && depth >= TRACE_MAX_DEPTH)
+      truncated = true;
+    return { event: focus, ancestors, descendants, truncated };
+  }
+  async getTimeline(personId, options = {}) {
+    const { channels, since, until, limit: limit2 = 50, cursor } = options;
+    const conditions3 = [eq(omniEvents.personId, personId)];
+    if (channels?.length) {
+      conditions3.push(inArray(omniEvents.channel, channels));
+    }
+    if (since) {
+      conditions3.push(gte(omniEvents.receivedAt, since));
+    }
+    if (until) {
+      conditions3.push(lte(omniEvents.receivedAt, until));
+    }
+    if (cursor) {
+      conditions3.push(sql`${omniEvents.receivedAt} < ${cursor}`);
+    }
+    const items = await this.db.select().from(omniEvents).where(and2(...conditions3)).orderBy(desc(omniEvents.receivedAt)).limit(limit2 + 1);
+    const hasMore = items.length > limit2;
+    if (hasMore) {
+      items.pop();
+    }
+    const lastItem = items[items.length - 1];
+    return {
+      items,
+      hasMore,
+      cursor: lastItem?.receivedAt.toISOString()
+    };
+  }
+  async getAnalytics(options = {}) {
+    const { since, until, instanceId, granularity } = options;
+    const conditions3 = [];
+    if (since) {
+      conditions3.push(gte(omniEvents.receivedAt, since));
+    }
+    if (until) {
+      conditions3.push(lte(omniEvents.receivedAt, until));
+    }
+    if (instanceId) {
+      conditions3.push(eq(omniEvents.instanceId, instanceId));
+    }
+    const whereClause = conditions3.length ? and2(...conditions3) : undefined;
+    const countResults = await this.db.select({
+      total: sql`count(*)::int`,
+      successful: sql`count(*) filter (where ${omniEvents.status} = 'completed')::int`,
+      failed: sql`count(*) filter (where ${omniEvents.status} = 'failed')::int`,
+      avgProcessingTime: sql`avg(${omniEvents.processingTimeMs})::int`,
+      avgAgentTime: sql`avg(${omniEvents.agentLatencyMs})::int`
+    }).from(omniEvents).where(whereClause);
+    const counts = countResults[0];
+    const contentTypeCounts = await this.db.select({
+      contentType: omniEvents.contentType,
+      count: sql`count(*)::int`
+    }).from(omniEvents).where(whereClause).groupBy(omniEvents.contentType);
+    const errorStageCounts = await this.db.select({
+      errorStage: omniEvents.errorStage,
+      count: sql`count(*)::int`
+    }).from(omniEvents).where(and2(whereClause, sql`${omniEvents.errorStage} is not null`)).groupBy(omniEvents.errorStage);
+    const instanceCounts = await this.db.select({
+      instanceId: omniEvents.instanceId,
+      count: sql`count(*)::int`
+    }).from(omniEvents).where(whereClause).groupBy(omniEvents.instanceId);
+    const channelCounts = await this.db.select({
+      channel: omniEvents.channel,
+      count: sql`count(*)::int`
+    }).from(omniEvents).where(whereClause).groupBy(omniEvents.channel);
+    const directionCounts = await this.db.select({
+      direction: omniEvents.direction,
+      count: sql`count(*)::int`
+    }).from(omniEvents).where(whereClause).groupBy(omniEvents.direction);
+    const total = counts?.total ?? 0;
+    const successful = counts?.successful ?? 0;
+    const failed = counts?.failed ?? 0;
+    let timeline;
+    if (granularity) {
+      const truncFunc = granularity === "hourly" ? "hour" : "day";
+      const timelineCounts = await this.db.select({
+        bucket: sql`date_trunc('${sql.raw(truncFunc)}', ${omniEvents.receivedAt})::text`,
+        count: sql`count(*)::int`
+      }).from(omniEvents).where(whereClause).groupBy(sql`date_trunc('${sql.raw(truncFunc)}', ${omniEvents.receivedAt})`).orderBy(sql`date_trunc('${sql.raw(truncFunc)}', ${omniEvents.receivedAt})`);
+      timeline = timelineCounts.map((t) => ({ bucket: t.bucket, count: t.count }));
+    }
+    const inboundCount = directionCounts.find((d2) => d2.direction === "inbound")?.count ?? 0;
+    const outboundCount = directionCounts.find((d2) => d2.direction === "outbound")?.count ?? 0;
+    return {
+      totalMessages: total,
+      successfulMessages: successful,
+      failedMessages: failed,
+      successRate: total > 0 ? successful / total * 100 : 0,
+      avgProcessingTimeMs: counts?.avgProcessingTime ?? null,
+      avgAgentTimeMs: counts?.avgAgentTime ?? null,
+      messageTypes: Object.fromEntries(contentTypeCounts.filter((c) => c.contentType != null).map((c) => [c.contentType, c.count])),
+      errorStages: Object.fromEntries(errorStageCounts.filter((c) => c.errorStage != null).map((c) => [c.errorStage, c.count])),
+      instances: Object.fromEntries(instanceCounts.filter((c) => c.instanceId != null).map((c) => [c.instanceId, c.count])),
+      byChannel: Object.fromEntries(channelCounts.filter((c) => c.channel != null).map((c) => [c.channel, c.count])),
+      byDirection: {
+        inbound: inboundCount,
+        outbound: outboundCount
+      },
+      timeline
+    };
+  }
+}
+var TRACE_MAX_ANCESTORS = 50, TRACE_MAX_DEPTH = 10, TRACE_MAX_NODES = 200;
+var init_events2 = __esm(() => {
+  init_src();
+  init_src5();
+  init_drizzle_orm();
+  init_tenant_scope();
+});
+
+// ../api/src/services/event-consumers.ts
+function matchesConsumerPayload(row, filters) {
+  if (!filters || filters.length === 0)
+    return true;
+  return evaluateConditions(filters, row.rawPayload ?? {});
+}
+function resolveInitialCursor(startFrom, head) {
+  return startFrom === "beginning" ? 0 : head;
+}
+function computeLag(head, cursor) {
+  return Math.max(0, head - cursor);
+}
+
+class EventConsumerService {
+  pool;
+  eventBus;
+  get db() {
+    return scopedHandle(this.pool);
+  }
+  constructor(pool, eventBus = null) {
+    this.pool = pool;
+    this.eventBus = eventBus;
+  }
+  async head() {
+    const [row] = await this.db.select({ head: sql`coalesce(max(${omniEvents.journalSeq}), 0)::bigint` }).from(omniEvents);
+    return Number(row?.head ?? 0);
+  }
+  async list() {
+    const [rows, head] = await Promise.all([
+      this.db.select().from(durableConsumers).orderBy(asc(durableConsumers.name)),
+      this.head()
+    ]);
+    return rows.map((row) => ({ ...row, head, lag: computeLag(head, row.cursor) }));
+  }
+  async getByName(name) {
+    const [row] = await this.db.select().from(durableConsumers).where(eq(durableConsumers.name, name)).limit(1);
+    if (!row)
+      throw new NotFoundError("DurableConsumer", name);
+    return row;
+  }
+  async inspect(name) {
+    const row = await this.getByName(name);
+    const head = await this.head();
+    return { ...row, head, lag: computeLag(head, row.cursor) };
+  }
+  async create(input) {
+    const head = await this.head();
+    const cursor = resolveInitialCursor(input.startFrom ?? "now", head);
+    const [created] = await this.db.insert(durableConsumers).values({ name: input.name, eventType: input.eventType, filters: input.filters ?? null, cursor }).onConflictDoNothing({ target: durableConsumers.name }).returning();
+    if (!created) {
+      throw new ConflictError("DurableConsumer", `a consumer named '${input.name}' already exists`, {
+        name: input.name
+      });
+    }
+    if (this.eventBus) {
+      await this.eventBus.publishGeneric("system.consumer.created", {
+        consumerId: created.id,
+        name: created.name,
+        eventType: created.eventType,
+        cursor: created.cursor
+      });
+    }
+    return { ...created, head, lag: computeLag(head, created.cursor) };
+  }
+  async delete(name) {
+    const [deleted] = await this.db.delete(durableConsumers).where(eq(durableConsumers.name, name)).returning();
+    if (!deleted)
+      throw new NotFoundError("DurableConsumer", name);
+    if (this.eventBus) {
+      await this.eventBus.publishGeneric("system.consumer.deleted", {
+        consumerId: deleted.id,
+        name: deleted.name,
+        eventType: deleted.eventType,
+        cursor: deleted.cursor
+      });
+    }
+  }
+  async pull(name, options = {}) {
+    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);
+    const deadline = Date.now() + waitMs;
+    let scanned = await this.scanPage(consumer, limit2);
+    while (scanned.length === 0 && Date.now() < deadline) {
+      await new Promise((resolve4) => setTimeout(resolve4, PULL_POLL_INTERVAL_MS));
+      scanned = await this.scanPage(consumer, limit2);
+    }
+    const items = scanned.filter((row) => matchesConsumerPayload(row, consumer.filters));
+    const last = scanned[scanned.length - 1];
+    const head = await this.head();
+    return {
+      consumer: consumer.name,
+      items,
+      cursor: last ? Number(last.journalSeq) : consumer.cursor,
+      head,
+      hasMore: scanned.length === limit2
+    };
+  }
+  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();
+    if (!updated) {
+      const existing = await this.getByName(name);
+      throw new ValidationError2(`ack cursor ${cursor} is behind the stored cursor ${existing.cursor} \u2014 acks are monotonic`, undefined, { name, cursor, storedCursor: existing.cursor });
+    }
+    const head = await this.head();
+    return { ...updated, head, lag: computeLag(head, updated.cursor) };
+  }
+  async scanPage(consumer, limit2) {
+    const typeClause = consumer.eventType.endsWith("*") ? like(omniEvents.eventType, `${escapeLikePattern(consumer.eventType.slice(0, -1))}%`) : eq(omniEvents.eventType, consumer.eventType);
+    return this.db.select().from(omniEvents).where(and2(gt(omniEvents.journalSeq, consumer.cursor), typeClause)).orderBy(asc(omniEvents.journalSeq)).limit(limit2);
+  }
+}
+var PULL_POLL_INTERVAL_MS = 500, PULL_MAX_LIMIT = 500, PULL_MAX_WAIT_MS = 30000;
+var init_event_consumers = __esm(() => {
+  init_src();
+  init_src5();
+  init_drizzle_orm();
+  init_tenant_scope();
+  init_events2();
+});
+
 // ../api/src/services/event-ops.ts
 class EventOpsService {
   pool;
@@ -359396,244 +359776,6 @@ var init_event_schemas = __esm(() => {
   log101 = createLogger("api:event-schemas");
 });
 
-// ../api/src/services/events.ts
-function escapeLikePattern(value) {
-  return value.replace(/([\\%_])/g, "\\$1");
-}
-
-class EventService {
-  pool;
-  get db() {
-    return scopedHandle(this.pool);
-  }
-  constructor(pool) {
-    this.pool = pool;
-  }
-  async list(options = {}) {
-    const {
-      channel: channel5,
-      instanceId,
-      personId,
-      eventType,
-      contentType,
-      direction,
-      since,
-      until,
-      search,
-      limit: limit2 = 50,
-      cursor
-    } = options;
-    const conditions3 = [];
-    if (channel5?.length) {
-      conditions3.push(inArray(omniEvents.channel, channel5));
-    }
-    if (instanceId) {
-      conditions3.push(eq(omniEvents.instanceId, instanceId));
-    } else if (options.instanceIds?.length) {
-      conditions3.push(inArray(omniEvents.instanceId, options.instanceIds));
-    }
-    if (personId) {
-      conditions3.push(eq(omniEvents.personId, personId));
-    }
-    if (eventType?.length) {
-      const exact = eventType.filter((t) => !t.endsWith("*"));
-      const prefixes = eventType.filter((t) => t.endsWith("*")).map((t) => t.slice(0, -1));
-      const typeClauses = [
-        ...exact.length ? [inArray(omniEvents.eventType, exact)] : [],
-        ...prefixes.map((p2) => like(omniEvents.eventType, `${escapeLikePattern(p2)}%`))
-      ];
-      const combined = typeClauses.length === 1 ? typeClauses[0] : or2(...typeClauses);
-      if (combined)
-        conditions3.push(combined);
-    }
-    if (contentType?.length) {
-      conditions3.push(inArray(omniEvents.contentType, contentType));
-    }
-    if (direction) {
-      conditions3.push(eq(omniEvents.direction, direction));
-    }
-    if (since) {
-      conditions3.push(gte(omniEvents.receivedAt, since));
-    }
-    if (until) {
-      conditions3.push(lte(omniEvents.receivedAt, until));
-    }
-    if (search) {
-      const searchPattern = `%${search}%`;
-      conditions3.push(or2(ilike(omniEvents.textContent, searchPattern), ilike(omniEvents.transcription, searchPattern), ilike(omniEvents.imageDescription, searchPattern)));
-    }
-    if (cursor) {
-      conditions3.push(sql`${omniEvents.receivedAt} < ${cursor}`);
-    }
-    const whereClause = conditions3.length ? and2(...conditions3) : undefined;
-    const items = await this.db.select().from(omniEvents).where(whereClause).orderBy(desc(omniEvents.receivedAt)).limit(limit2 + 1);
-    const hasMore = items.length > limit2;
-    if (hasMore) {
-      items.pop();
-    }
-    const lastItem = items[items.length - 1];
-    return {
-      items,
-      hasMore,
-      cursor: lastItem?.receivedAt.toISOString()
-    };
-  }
-  async getById(id) {
-    const [result] = await this.db.select().from(omniEvents).where(eq(omniEvents.id, id)).limit(1);
-    if (!result) {
-      throw new NotFoundError("Event", id);
-    }
-    return result;
-  }
-  async trace(id) {
-    const focus = await this.getById(id);
-    const seen = new Set([focus.id]);
-    const ancestors = [];
-    let current = focus;
-    let truncated = false;
-    while (current.causationId && ancestors.length < TRACE_MAX_ANCESTORS) {
-      if (seen.has(current.causationId))
-        break;
-      const [parent] = await this.db.select().from(omniEvents).where(eq(omniEvents.id, current.causationId)).limit(1);
-      if (!parent)
-        break;
-      seen.add(parent.id);
-      ancestors.unshift(parent);
-      current = parent;
-    }
-    if (current.causationId && ancestors.length >= TRACE_MAX_ANCESTORS)
-      truncated = true;
-    const descendants = [];
-    let frontier = [focus.id];
-    let depth = 0;
-    while (frontier.length > 0 && depth < TRACE_MAX_DEPTH && descendants.length < TRACE_MAX_NODES) {
-      depth++;
-      const children = await this.db.select().from(omniEvents).where(inArray(omniEvents.causationId, frontier)).orderBy(omniEvents.receivedAt).limit(TRACE_MAX_NODES + 1);
-      const fresh = children.filter((c) => !seen.has(c.id));
-      for (const child of fresh)
-        seen.add(child.id);
-      for (const child of fresh)
-        descendants.push({ event: child, depth });
-      if (descendants.length > TRACE_MAX_NODES) {
-        descendants.length = TRACE_MAX_NODES;
-        truncated = true;
-        break;
-      }
-      frontier = fresh.map((c) => c.id);
-    }
-    if (frontier.length > 0 && depth >= TRACE_MAX_DEPTH)
-      truncated = true;
-    return { event: focus, ancestors, descendants, truncated };
-  }
-  async getTimeline(personId, options = {}) {
-    const { channels, since, until, limit: limit2 = 50, cursor } = options;
-    const conditions3 = [eq(omniEvents.personId, personId)];
-    if (channels?.length) {
-      conditions3.push(inArray(omniEvents.channel, channels));
-    }
-    if (since) {
-      conditions3.push(gte(omniEvents.receivedAt, since));
-    }
-    if (until) {
-      conditions3.push(lte(omniEvents.receivedAt, until));
-    }
-    if (cursor) {
-      conditions3.push(sql`${omniEvents.receivedAt} < ${cursor}`);
-    }
-    const items = await this.db.select().from(omniEvents).where(and2(...conditions3)).orderBy(desc(omniEvents.receivedAt)).limit(limit2 + 1);
-    const hasMore = items.length > limit2;
-    if (hasMore) {
-      items.pop();
-    }
-    const lastItem = items[items.length - 1];
-    return {
-      items,
-      hasMore,
-      cursor: lastItem?.receivedAt.toISOString()
-    };
-  }
-  async getAnalytics(options = {}) {
-    const { since, until, instanceId, granularity } = options;
-    const conditions3 = [];
-    if (since) {
-      conditions3.push(gte(omniEvents.receivedAt, since));
-    }
-    if (until) {
-      conditions3.push(lte(omniEvents.receivedAt, until));
-    }
-    if (instanceId) {
-      conditions3.push(eq(omniEvents.instanceId, instanceId));
-    }
-    const whereClause = conditions3.length ? and2(...conditions3) : undefined;
-    const countResults = await this.db.select({
-      total: sql`count(*)::int`,
-      successful: sql`count(*) filter (where ${omniEvents.status} = 'completed')::int`,
-      failed: sql`count(*) filter (where ${omniEvents.status} = 'failed')::int`,
-      avgProcessingTime: sql`avg(${omniEvents.processingTimeMs})::int`,
-      avgAgentTime: sql`avg(${omniEvents.agentLatencyMs})::int`
-    }).from(omniEvents).where(whereClause);
-    const counts = countResults[0];
-    const contentTypeCounts = await this.db.select({
-      contentType: omniEvents.contentType,
-      count: sql`count(*)::int`
-    }).from(omniEvents).where(whereClause).groupBy(omniEvents.contentType);
-    const errorStageCounts = await this.db.select({
-      errorStage: omniEvents.errorStage,
-      count: sql`count(*)::int`
-    }).from(omniEvents).where(and2(whereClause, sql`${omniEvents.errorStage} is not null`)).groupBy(omniEvents.errorStage);
-    const instanceCounts = await this.db.select({
-      instanceId: omniEvents.instanceId,
-      count: sql`count(*)::int`
-    }).from(omniEvents).where(whereClause).groupBy(omniEvents.instanceId);
-    const channelCounts = await this.db.select({
-      channel: omniEvents.channel,
-      count: sql`count(*)::int`
-    }).from(omniEvents).where(whereClause).groupBy(omniEvents.channel);
-    const directionCounts = await this.db.select({
-      direction: omniEvents.direction,
-      count: sql`count(*)::int`
-    }).from(omniEvents).where(whereClause).groupBy(omniEvents.direction);
-    const total = counts?.total ?? 0;
-    const successful = counts?.successful ?? 0;
-    const failed = counts?.failed ?? 0;
-    let timeline;
-    if (granularity) {
-      const truncFunc = granularity === "hourly" ? "hour" : "day";
-      const timelineCounts = await this.db.select({
-        bucket: sql`date_trunc('${sql.raw(truncFunc)}', ${omniEvents.receivedAt})::text`,
-        count: sql`count(*)::int`
-      }).from(omniEvents).where(whereClause).groupBy(sql`date_trunc('${sql.raw(truncFunc)}', ${omniEvents.receivedAt})`).orderBy(sql`date_trunc('${sql.raw(truncFunc)}', ${omniEvents.receivedAt})`);
-      timeline = timelineCounts.map((t) => ({ bucket: t.bucket, count: t.count }));
-    }
-    const inboundCount = directionCounts.find((d2) => d2.direction === "inbound")?.count ?? 0;
-    const outboundCount = directionCounts.find((d2) => d2.direction === "outbound")?.count ?? 0;
-    return {
-      totalMessages: total,
-      successfulMessages: successful,
-      failedMessages: failed,
-      successRate: total > 0 ? successful / total * 100 : 0,
-      avgProcessingTimeMs: counts?.avgProcessingTime ?? null,
-      avgAgentTimeMs: counts?.avgAgentTime ?? null,
-      messageTypes: Object.fromEntries(contentTypeCounts.filter((c) => c.contentType != null).map((c) => [c.contentType, c.count])),
-      errorStages: Object.fromEntries(errorStageCounts.filter((c) => c.errorStage != null).map((c) => [c.errorStage, c.count])),
-      instances: Object.fromEntries(instanceCounts.filter((c) => c.instanceId != null).map((c) => [c.instanceId, c.count])),
-      byChannel: Object.fromEntries(channelCounts.filter((c) => c.channel != null).map((c) => [c.channel, c.count])),
-      byDirection: {
-        inbound: inboundCount,
-        outbound: outboundCount
-      },
-      timeline
-    };
-  }
-}
-var TRACE_MAX_ANCESTORS = 50, TRACE_MAX_DEPTH = 10, TRACE_MAX_NODES = 200;
-var init_events2 = __esm(() => {
-  init_src();
-  init_src5();
-  init_drizzle_orm();
-  init_tenant_scope();
-});
-
 // ../api/src/lib/close-contact-state.ts
 function isChatInActiveCloseState(settings) {
   if (!settings)
@@ -364595,6 +364737,7 @@ function createServices(db2, eventBus) {
     payloadStore,
     eventOps,
     eventSchemas: eventSchemas2,
+    eventConsumers: new EventConsumerService(db2, eventBus),
     webhooks: new WebhookService(db2, eventBus, eventSchemas2, deadLetters),
     automations: automationsService,
     manifestCompiler,
@@ -364650,6 +364793,7 @@ var init_services = __esm(() => {
   init_consumer_offsets();
   init_conversations();
   init_dead_letters();
+  init_event_consumers();
   init_event_ops();
   init_event_schemas();
   init_events2();
@@ -368149,6 +368293,160 @@ var init_dead_letters2 = __esm(() => {
   });
 });
 
+// ../api/src/schemas/openapi/event-consumers.ts
+function registerEventConsumerSchemas(registry4) {
+  registry4.register("DurableConsumer", DurableConsumerSchema);
+  registry4.register("CreateConsumerRequest", CreateConsumerSchema);
+  registry4.register("ConsumerPullResult", PullResultSchema);
+  registry4.registerPath({
+    method: "get",
+    path: "/events/consumers",
+    operationId: "listEventConsumers",
+    tags: ["Events"],
+    summary: "List durable event consumers",
+    description: "Every registered durable consumer with its filter, cursor, and live lag (journal head minus cursor).",
+    responses: {
+      200: {
+        description: "Registered consumers",
+        content: { "application/json": { schema: exports_external.object({ items: exports_external.array(DurableConsumerSchema) }) } }
+      }
+    }
+  });
+  registry4.registerPath({
+    method: "post",
+    path: "/events/consumers",
+    operationId: "createEventConsumer",
+    tags: ["Events"],
+    summary: "Register a durable event consumer",
+    description: "Registers a named consumer over the event journal: a type filter (trailing-* prefix glob, the events-wait " + "contract) plus optional payload conditions (the automation-trigger matcher), and a stored cursor. " + "startFrom 'now' (default) begins at the journal head; 'beginning' replays the full journal (projections).",
+    request: { body: { content: { "application/json": { schema: CreateConsumerSchema } } } },
+    responses: {
+      201: {
+        description: "Consumer registered",
+        content: { "application/json": { schema: exports_external.object({ data: DurableConsumerSchema }) } }
+      },
+      409: {
+        description: "A consumer with this name already exists",
+        content: { "application/json": { schema: ErrorSchema } }
+      }
+    }
+  });
+  registry4.registerPath({
+    method: "get",
+    path: "/events/consumers/{name}",
+    operationId: "getEventConsumer",
+    tags: ["Events"],
+    summary: "Inspect a durable event consumer",
+    description: "The consumer registration plus its live cursor position and lag.",
+    request: { params: exports_external.object({ name: exports_external.string().openapi({ description: "Consumer name" }) }) },
+    responses: {
+      200: {
+        description: "Consumer with live lag",
+        content: { "application/json": { schema: exports_external.object({ data: DurableConsumerSchema }) } }
+      },
+      404: { description: "No such consumer", content: { "application/json": { schema: ErrorSchema } } }
+    }
+  });
+  registry4.registerPath({
+    method: "delete",
+    path: "/events/consumers/{name}",
+    operationId: "deleteEventConsumer",
+    tags: ["Events"],
+    summary: "Delete a durable event consumer",
+    description: "Removes the registration and its cursor. The journal itself is untouched.",
+    request: { params: exports_external.object({ name: exports_external.string().openapi({ description: "Consumer name" }) }) },
+    responses: {
+      200: {
+        description: "Deleted",
+        content: { "application/json": { schema: exports_external.object({ success: exports_external.boolean() }) } }
+      },
+      404: { description: "No such consumer", content: { "application/json": { schema: ErrorSchema } } }
+    }
+  });
+  registry4.registerPath({
+    method: "post",
+    path: "/events/consumers/{name}/pull",
+    operationId: "pullEventConsumer",
+    tags: ["Events"],
+    summary: "Pull journal events from the stored cursor",
+    description: "Pages journal events strictly after the stored cursor, in journal_seq order, pre-filtered by the type glob " + "and payload conditions. Does NOT advance the cursor \u2014 ack the returned cursor to commit progress " + "(at-least-once: a client that crashes mid-page re-pulls the same page). waitMs long-polls when no rows are available.",
+    request: {
+      params: exports_external.object({ name: exports_external.string().openapi({ description: "Consumer name" }) }),
+      query: PullConsumerQuerySchema
+    },
+    responses: {
+      200: { description: "One page of events", content: { "application/json": { schema: PullResultSchema } } },
+      404: { description: "No such consumer", content: { "application/json": { schema: ErrorSchema } } }
+    }
+  });
+  registry4.registerPath({
+    method: "post",
+    path: "/events/consumers/{name}/ack",
+    operationId: "ackEventConsumer",
+    tags: ["Events"],
+    summary: "Advance the consumer cursor (monotonic)",
+    description: "Commits progress up to a pull result's cursor. Monotonic: an ack equal to the stored cursor is an " + "idempotent no-op, an ack behind it is refused with 400 \u2014 a durable cursor never moves backwards.",
+    request: {
+      params: exports_external.object({ name: exports_external.string().openapi({ description: "Consumer name" }) }),
+      body: { content: { "application/json": { schema: AckConsumerSchema } } }
+    },
+    responses: {
+      200: {
+        description: "Cursor advanced (or already there)",
+        content: { "application/json": { schema: exports_external.object({ data: DurableConsumerSchema }) } }
+      },
+      400: { description: "Ack behind the stored cursor", content: { "application/json": { schema: ErrorSchema } } },
+      404: { description: "No such consumer", content: { "application/json": { schema: ErrorSchema } } }
+    }
+  });
+}
+var CONSUMER_NAME_PATTERN, ConsumerConditionSchema, DurableConsumerSchema, CreateConsumerSchema, PullConsumerQuerySchema, AckConsumerSchema, PullResultSchema;
+var init_event_consumers2 = __esm(() => {
+  init_zod_openapi();
+  init_common4();
+  CONSUMER_NAME_PATTERN = /^[a-z0-9][a-z0-9._-]*$/;
+  ConsumerConditionSchema = exports_external.object({
+    field: exports_external.string().min(1).max(500).openapi({ description: "Dot-notation path into the event's rawPayload (e.g. user.id)" }),
+    operator: exports_external.enum(["eq", "neq", "gt", "lt", "gte", "lte", "contains", "not_contains", "exists", "not_exists", "regex"]).openapi({ description: "Comparison operator (same matcher as automation trigger conditions)" }),
+    value: exports_external.unknown().optional().openapi({ description: "Comparison value. Ignored for 'exists'/'not_exists'" })
+  });
+  DurableConsumerSchema = exports_external.object({
+    id: exports_external.string().uuid().openapi({ description: "Consumer UUID" }),
+    name: exports_external.string().openapi({ description: "Unique consumer name (the follow/ack handle)" }),
+    eventType: exports_external.string().openapi({ description: "Type filter: exact event type or trailing-* prefix glob" }),
+    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" }),
+    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)" }),
+    createdAt: exports_external.string().datetime().openapi({ description: "Creation timestamp" }),
+    updatedAt: exports_external.string().datetime().openapi({ description: "Last cursor/registry update timestamp" })
+  });
+  CreateConsumerSchema = exports_external.object({
+    name: exports_external.string().min(1).max(100).regex(CONSUMER_NAME_PATTERN, "Consumer name must be lowercase tokens: a-z 0-9 . _ - (starting alphanumeric)").openapi({ description: "Unique consumer name (e.g. deploy-tracker)" }),
+    eventType: exports_external.string().min(1).max(255).openapi({ description: "Type filter: exact event type, or trailing-* prefix glob (e.g. custom.github.*)" }),
+    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" })
+  });
+  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)" })
+  });
+  AckConsumerSchema = exports_external.object({
+    cursor: exports_external.coerce.number().int().min(0).openapi({
+      description: `The journal_seq to advance to (a pull result's "cursor"). Monotonic: equal = no-op, lower = 400`
+    })
+  });
+  PullResultSchema = exports_external.object({
+    consumer: exports_external.string().openapi({ description: "Consumer name" }),
+    items: exports_external.array(exports_external.record(exports_external.string(), exports_external.unknown())).openapi({ description: "Matching journal rows, ascending journal_seq" }),
+    cursor: exports_external.number().int().openapi({
+      description: "Highest journal_seq SCANNED (not merely matched) \u2014 ack this value to advance past filtered-out rows"
+    }),
+    head: exports_external.number().int().openapi({ description: "Journal head at pull time" }),
+    hasMore: exports_external.boolean().openapi({ description: "True when the scan filled the page \u2014 more rows are already waiting" })
+  });
+});
+
 // ../api/src/schemas/openapi/event-ops.ts
 function registerEventOpsSchemas(registry4) {
   registry4.register("ReplayOptions", ReplayOptionsSchema);
@@ -371898,6 +372196,7 @@ var init_openapi2 = __esm(() => {
   init_common4();
   init_conversations2();
   init_dead_letters2();
+  init_event_consumers2();
   init_event_ops2();
   init_event_schemas2();
   init_events3();
@@ -371935,6 +372234,7 @@ var init_openapi2 = __esm(() => {
   registerDeadLetterSchemas(registry4);
   registerEventOpsSchemas(registry4);
   registerEventSchemaSchemas(registry4);
+  registerEventConsumerSchemas(registry4);
   registerMetricsSchemas(registry4);
   registerAutomationSchemas(registry4);
   registerPayloadSchemas(registry4);
@@ -374727,6 +375027,52 @@ var init_dead_letters3 = __esm(() => {
   });
 });
 
+// ../api/src/routes/v2/event-consumers.ts
+var eventConsumersRoutes;
+var init_event_consumers3 = __esm(() => {
+  init_dist6();
+  init_dist2();
+  init_event_consumers2();
+  eventConsumersRoutes = new Hono2;
+  eventConsumersRoutes.get("/events/consumers", async (c) => {
+    const services = c.get("services");
+    const items = await services.eventConsumers.list();
+    return c.json({ items });
+  });
+  eventConsumersRoutes.post("/events/consumers", zValidator("json", CreateConsumerSchema), async (c) => {
+    const input = c.req.valid("json");
+    const services = c.get("services");
+    const data = await services.eventConsumers.create(input);
+    return c.json({ data }, 201);
+  });
+  eventConsumersRoutes.get("/events/consumers/:name", async (c) => {
+    const name = c.req.param("name");
+    const services = c.get("services");
+    const data = await services.eventConsumers.inspect(name);
+    return c.json({ data });
+  });
+  eventConsumersRoutes.delete("/events/consumers/:name", async (c) => {
+    const name = c.req.param("name");
+    const services = c.get("services");
+    await services.eventConsumers.delete(name);
+    return c.json({ success: true });
+  });
+  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 services = c.get("services");
+    const result = await services.eventConsumers.pull(name, { limit: limit2, waitMs });
+    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 services = c.get("services");
+    const data = await services.eventConsumers.ack(name, cursor);
+    return c.json({ data });
+  });
+});
+
 // ../api/src/routes/v2/event-ops.ts
 var eventOpsRoutes, replayOptionsSchema;
 var init_event_ops3 = __esm(() => {
@@ -385027,6 +385373,7 @@ var init_v2 = __esm(() => {
   init_context5();
   init_conversations3();
   init_dead_letters3();
+  init_event_consumers3();
   init_event_ops3();
   init_event_schemas3();
   init_events4();
@@ -385065,6 +385412,7 @@ var init_v2 = __esm(() => {
   v2Routes.route("/scheduled-messages", scheduledMessagesRoutes);
   v2Routes.route("/slack", slackRoutes);
   v2Routes.route("/", eventSchemasRoutes);
+  v2Routes.route("/", eventConsumersRoutes);
   v2Routes.route("/events", eventsRoutes);
   v2Routes.route("/journeys", journeysRoutes);
   v2Routes.route("/persons", personsRoutes);