@automagik/omni 2.260703.2 → 2.260703.4

package/db/drizzle/0037_message_debounce_max_wait.sql

@@ -0,0 +1,22 @@
+-- Presence-debounce max-wait cap (presence-debounce-batching design, 2026-07).
+--
+-- Adds `message_debounce_max_wait_ms` to both the `instances` table and the
+-- per-route `agent_routes` override table. It is the hard cap for the new
+-- 'presence' debounce mode: a batch flushes at `firstBuffered + maxWaitMs`
+-- even while the user keeps typing, so a continuously-composing user can never
+-- starve the agent. NULL = no cap (the legacy fixed/randomized behavior).
+--
+-- The 'presence' mode itself is a TypeScript-layer literal (message-debouncer
+-- DebounceConfig + the `debounceMode` const in schema.ts). The DB stores mode
+-- as a free varchar(20) with no CHECK constraint, so no enum migration is
+-- needed here — only the new nullable column.
+--
+-- Hand-written (not `drizzle-kit generate`) to match the repo convention from
+-- 0032+ and avoid the gupshup column-rename prompts that block non-interactive
+-- runs.
+
+ALTER TABLE "instances"
+  ADD COLUMN IF NOT EXISTS "message_debounce_max_wait_ms" integer;
+
+ALTER TABLE "agent_routes"
+  ADD COLUMN IF NOT EXISTS "message_debounce_max_wait_ms" integer;

package/db/drizzle/meta/_journal.json

@@ -260,6 +260,13 @@
       "when": 1777860000000,
       "tag": "0036_timestamptz_migration",
       "breakpoints": true
+    },
+    {
+      "idx": 37,
+      "version": "7",
+      "when": 1777950000000,
+      "tag": "0037_message_debounce_max_wait",
+      "breakpoints": true
     }
   ]
 }

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

@@ -1 +1 @@
-{"version":3,"file":"instances.d.ts","sourceRoot":"","sources":["../../src/commands/instances.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiMpC,wBAAgB,sBAAsB,IAAI,OAAO,CAkuChD"}
+{"version":3,"file":"instances.d.ts","sourceRoot":"","sources":["../../src/commands/instances.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkMpC,wBAAgB,sBAAsB,IAAI,OAAO,CAwuChD"}

package/dist/index.js

@@ -31474,11 +31474,12 @@ var init_agent_route = __esm(() => {
     agentGateEnabled: exports_external.boolean().nullable(),
     agentGateModel: exports_external.string().max(120).nullable(),
     agentGatePrompt: exports_external.string().nullable(),
-    messageDebounceMode: exports_external.enum(["disabled", "fixed", "randomized"]).nullable(),
+    messageDebounceMode: exports_external.enum(["disabled", "fixed", "randomized", "presence"]).nullable(),
     messageDebounceMinMs: exports_external.number().int().nonnegative().nullable(),
     messageDebounceMaxMs: exports_external.number().int().nonnegative().nullable(),
     messageDebounceGroupMs: exports_external.number().int().nonnegative().nullable(),
     messageDebounceRestartOnTyping: exports_external.boolean().nullable(),
+    messageDebounceMaxWaitMs: exports_external.number().int().nonnegative().nullable(),
     messageSplitDelayMode: exports_external.enum(["disabled", "fixed", "randomized"]).nullable(),
     messageSplitDelayFixedMs: exports_external.number().int().nonnegative().nullable(),
     messageSplitDelayMinMs: exports_external.number().int().nonnegative().nullable(),
@@ -31509,11 +31510,12 @@ var init_agent_route = __esm(() => {
     agentGateEnabled: exports_external.boolean().optional(),
     agentGateModel: exports_external.string().max(120).optional(),
     agentGatePrompt: exports_external.string().optional(),
-    messageDebounceMode: exports_external.enum(["disabled", "fixed", "randomized"]).optional(),
+    messageDebounceMode: exports_external.enum(["disabled", "fixed", "randomized", "presence"]).optional(),
     messageDebounceMinMs: exports_external.number().int().nonnegative().optional(),
     messageDebounceMaxMs: exports_external.number().int().nonnegative().optional(),
     messageDebounceGroupMs: exports_external.number().int().nonnegative().optional(),
     messageDebounceRestartOnTyping: exports_external.boolean().optional(),
+    messageDebounceMaxWaitMs: exports_external.number().int().nonnegative().optional(),
     messageSplitDelayMode: exports_external.enum(["disabled", "fixed", "randomized"]).optional(),
     messageSplitDelayFixedMs: exports_external.number().int().nonnegative().optional(),
     messageSplitDelayMinMs: exports_external.number().int().nonnegative().optional(),
@@ -31543,11 +31545,12 @@ var init_agent_route = __esm(() => {
     agentGateEnabled: exports_external.boolean().optional().nullable(),
     agentGateModel: exports_external.string().max(120).optional().nullable(),
     agentGatePrompt: exports_external.string().optional().nullable(),
-    messageDebounceMode: exports_external.enum(["disabled", "fixed", "randomized"]).optional().nullable(),
+    messageDebounceMode: exports_external.enum(["disabled", "fixed", "randomized", "presence"]).optional().nullable(),
     messageDebounceMinMs: exports_external.number().int().nonnegative().optional().nullable(),
     messageDebounceMaxMs: exports_external.number().int().nonnegative().optional().nullable(),
     messageDebounceGroupMs: exports_external.number().int().nonnegative().optional().nullable(),
     messageDebounceRestartOnTyping: exports_external.boolean().optional().nullable(),
+    messageDebounceMaxWaitMs: exports_external.number().int().nonnegative().optional().nullable(),
     messageSplitDelayMode: exports_external.enum(["disabled", "fixed", "randomized"]).optional().nullable(),
     messageSplitDelayFixedMs: exports_external.number().int().nonnegative().optional().nullable(),
     messageSplitDelayMinMs: exports_external.number().int().nonnegative().optional().nullable(),
@@ -71343,7 +71346,7 @@ var init_schema2 = __esm(() => {
   agentTypes = ["agent", "team", "workflow"];
   agentSystems = ["claude", "agno", "openai", "gemini", "custom", "omni-internal"];
   agentEntityTypes = ["assistant", "workflow", "team", "tool"];
-  debounceMode = ["disabled", "fixed", "randomized"];
+  debounceMode = ["disabled", "fixed", "randomized", "presence"];
   splitDelayMode = ["disabled", "fixed", "randomized"];
   replyFilterMode = ["all", "filtered"];
   agentSessionStrategies = ["per_user", "per_chat", "per_thread"];
@@ -71479,6 +71482,7 @@ var init_schema2 = __esm(() => {
     messageDebounceMaxMs: integer("message_debounce_max_ms"),
     messageDebounceGroupMs: integer("message_debounce_group_ms"),
     messageDebounceRestartOnTyping: boolean("message_debounce_restart_on_typing"),
+    messageDebounceMaxWaitMs: integer("message_debounce_max_wait_ms"),
     messageSplitDelayMode: varchar("message_split_delay_mode", { length: 20 }).$type(),
     messageSplitDelayFixedMs: integer("message_split_delay_fixed_ms"),
     messageSplitDelayMinMs: integer("message_split_delay_min_ms"),
@@ -71632,6 +71636,7 @@ var init_schema2 = __esm(() => {
     messageDebounceGroupMs: integer("message_debounce_group_ms"),
     messageDebounceMaxMs: integer("message_debounce_max_ms").notNull().default(0),
     messageDebounceRestartOnTyping: boolean("message_debounce_restart_on_typing").notNull().default(false),
+    messageDebounceMaxWaitMs: integer("message_debounce_max_wait_ms"),
     agentGateEnabled: boolean("agent_gate_enabled").notNull().default(false),
     agentGateModel: varchar("agent_gate_model", { length: 120 }),
     agentGatePrompt: text("agent_gate_prompt"),
@@ -125004,7 +125009,7 @@ import { fileURLToPath } from "url";
 // package.json
 var package_default = {
   name: "@automagik/omni",
-  version: "2.260703.2",
+  version: "2.260703.4",
   description: "LLM-optimized CLI for Omni",
   type: "module",
   bin: {
@@ -132527,6 +132532,8 @@ function applyDebounceFields(body, opts) {
   setBool(body, "messageDebounceRestartOnTyping", opts.debounceRestartOnTyping);
   if (opts.debounceGroup !== undefined)
     body.messageDebounceGroupMs = opts.debounceGroup;
+  if (opts.debounceMaxWait !== undefined)
+    body.messageDebounceMaxWaitMs = opts.debounceMaxWait;
 }
 function applySplitDelayFields(body, opts) {
   setVal(body, "messageSplitDelayMode", opts.splitDelayMode);
@@ -132675,7 +132682,7 @@ function createInstancesCommand() {
       error(`Failed to get instance: ${message}`, undefined, 3);
     }
   });
-  instances.command("create").description("Create a new instance (supports all API fields)").requiredOption("--name <name>", "Instance name").requiredOption("--channel <type>", `Channel type (${VALID_CHANNELS2.join(", ")})`).option("--agent-fk-id <uuid>", 'Agent FK UUID (references agents table, use "null" to clear). When set without --reply-filter-mode, reply filter defaults to {mode:"all", onDm:true} so messages are dispatched instead of silently dropped (omni#443).').option("--agent-provider <id>", "Agent provider ID").option("--agent <id>", "Agent ID").option("--agent-type <type>", "Agent type: agent, team, or workflow").option("--agent-timeout <seconds>", "Agent timeout in seconds", (v) => Number.parseInt(v, 10)).option("--agent-stream-mode", "Enable streaming responses").option("--agent-session-strategy <strategy>", "Session strategy: per_user, per_chat, per_user_per_chat").option("--agent-prefix-sender-name", "Prefix messages with sender name").option("--no-agent-prefix-sender-name", "Disable sender name prefix").option("--agent-wait-for-media", "Wait for media processing before dispatch").option("--no-agent-wait-for-media", "Dispatch immediately without waiting for media").option("--agent-send-media-path", "Include file path in formatted media text").option("--no-agent-send-media-path", "Exclude file path from formatted media text").option("--agent-send-media-path-types <types>", "Content types that receive file path (comma-separated: image,video,document)").option("--reply-filter-mode <mode>", "Reply filter: all or filtered").option("--reply-on-dm", "Reply to DMs").option("--no-reply-on-dm", "Ignore DMs").option("--reply-on-mention", "Reply when @mentioned").option("--no-reply-on-mention", "Ignore @mentions").option("--reply-on-reply", "Reply when message is reply to bot").option("--no-reply-on-reply", "Ignore replies").option("--reply-on-name", "Reply when bot name appears in text").option("--no-reply-on-name", "Ignore name matches").option("--reply-name-patterns <patterns>", "Custom name patterns (comma-separated)").option("--enable-auto-split", "Split responses on double newlines").option("--no-enable-auto-split", "Disable auto-split").option("--message-format-mode <mode>", "Format mode: convert or passthrough").option("--debounce-mode <mode>", "Debounce mode: disabled, fixed, or randomized").option("--debounce-min <ms>", "Minimum debounce delay in ms", (v) => Number.parseInt(v, 10)).option("--debounce-max <ms>", "Maximum debounce delay in ms", (v) => Number.parseInt(v, 10)).option("--debounce-restart-on-typing", "Restart debounce timer on typing").option("--debounce-group <ms>", "Group chat debounce in ms", (v) => Number.parseInt(v, 10)).option("--split-delay-mode <mode>", "Split delay mode: disabled, fixed, or randomized").option("--split-delay-fixed <ms>", "Fixed delay between split chunks in ms", (v) => Number.parseInt(v, 10)).option("--split-delay-min <ms>", "Minimum delay between split chunks in ms", (v) => Number.parseInt(v, 10)).option("--split-delay-max <ms>", "Maximum delay between split chunks in ms", (v) => Number.parseInt(v, 10)).option("--agent-gate", "Enable LLM response gate").option("--agent-gate-model <model>", "Model for response gate").option("--agent-gate-prompt <prompt>", "Custom gate prompt").option("--tts-voice <id>", "ElevenLabs voice ID").option("--tts-model <id>", "ElevenLabs model ID").option("--read-receipts <mode>", "Read receipts mode: on, off, or exclude-self").option("--access-mode <mode>", "Access mode: disabled, blocklist, or allowlist").option("--reaction-ack <mode>", "Reaction ack mode (on|off)").option("--reaction-ack-emoji <json>", "Per-channel emoji map as JSON").option("--ack-timeout <ms>", "Ack timeout in milliseconds", (v) => Number.parseInt(v, 10)).option("--agent-stalled-timeout-ms <ms>", "Idle threshold in ms before the internal turn.stalled event fires (no channel message is ever sent)", (v) => Number.parseInt(v, 10)).option("--token <token>", "Generic bot token (auto-resolves to channel-specific field)").option("--telegram-token <token>", "Telegram bot token").option("--discord-token <token>", "Discord bot token").option("--slack-bot-token <token>", "Slack bot token").option("--slack-app-token <token>", "Slack app token").option("--gupshup-callback-url <url>", "Gupshup Custom Integration callback URL").option("--gupshup-auth-token <token>", "Gupshup Custom Integration auth token").option("--gupshup-event-id <id>", "Gupshup event ID (default: nx_omni_agent_reply)").option("--gupshup-webhook-verify-token <token>", "Gupshup webhook verify token").option("--twilio-account-sid <sid>", "Twilio Account SID").option("--twilio-auth-token <token>", "Twilio Auth Token").option("--twilio-from <address>", "Twilio WhatsApp sender address (whatsapp:+E164)").option("--twilio-messaging-service-sid <sid>", "Twilio Messaging Service SID").option("--twilio-status-callback-url <url>", "Twilio outbound status callback URL").option("--twilio-webhook-url <url>", "Public Twilio webhook URL for signature validation").option("--twilio-validate-signature", "Validate X-Twilio-Signature on webhooks").option("--no-twilio-validate-signature", "Disable X-Twilio-Signature validation").option("--bridge-tmux-session <name>", 'Tmux session name the genie bridge spawns into for this instance (propagated as GENIE_TMUX_SESSION via NATS). Use "null" to clear.').option("--require-genie-signature", "Require a verified X-Genie-Signature on requests targeting this instance. Bearer-only requests will be rejected with 401.").option("--no-require-genie-signature", "Allow bearer-only requests targeting this instance (default).").option("--is-default", "Set as default instance for channel").action(async (options) => {
+  instances.command("create").description("Create a new instance (supports all API fields)").requiredOption("--name <name>", "Instance name").requiredOption("--channel <type>", `Channel type (${VALID_CHANNELS2.join(", ")})`).option("--agent-fk-id <uuid>", 'Agent FK UUID (references agents table, use "null" to clear). When set without --reply-filter-mode, reply filter defaults to {mode:"all", onDm:true} so messages are dispatched instead of silently dropped (omni#443).').option("--agent-provider <id>", "Agent provider ID").option("--agent <id>", "Agent ID").option("--agent-type <type>", "Agent type: agent, team, or workflow").option("--agent-timeout <seconds>", "Agent timeout in seconds", (v) => Number.parseInt(v, 10)).option("--agent-stream-mode", "Enable streaming responses").option("--agent-session-strategy <strategy>", "Session strategy: per_user, per_chat, per_user_per_chat").option("--agent-prefix-sender-name", "Prefix messages with sender name").option("--no-agent-prefix-sender-name", "Disable sender name prefix").option("--agent-wait-for-media", "Wait for media processing before dispatch").option("--no-agent-wait-for-media", "Dispatch immediately without waiting for media").option("--agent-send-media-path", "Include file path in formatted media text").option("--no-agent-send-media-path", "Exclude file path from formatted media text").option("--agent-send-media-path-types <types>", "Content types that receive file path (comma-separated: image,video,document)").option("--reply-filter-mode <mode>", "Reply filter: all or filtered").option("--reply-on-dm", "Reply to DMs").option("--no-reply-on-dm", "Ignore DMs").option("--reply-on-mention", "Reply when @mentioned").option("--no-reply-on-mention", "Ignore @mentions").option("--reply-on-reply", "Reply when message is reply to bot").option("--no-reply-on-reply", "Ignore replies").option("--reply-on-name", "Reply when bot name appears in text").option("--no-reply-on-name", "Ignore name matches").option("--reply-name-patterns <patterns>", "Custom name patterns (comma-separated)").option("--enable-auto-split", "Split responses on double newlines").option("--no-enable-auto-split", "Disable auto-split").option("--message-format-mode <mode>", "Format mode: convert or passthrough").option("--debounce-mode <mode>", "Debounce mode: disabled, fixed, randomized, or presence").option("--debounce-min <ms>", "Minimum debounce delay in ms", (v) => Number.parseInt(v, 10)).option("--debounce-max <ms>", "Maximum debounce delay in ms", (v) => Number.parseInt(v, 10)).option("--debounce-restart-on-typing", "Restart debounce timer on typing").option("--debounce-group <ms>", "Group chat debounce in ms", (v) => Number.parseInt(v, 10)).option("--debounce-max-wait <ms>", "Presence-mode hard cap in ms (flush even under continuous typing)", (v) => Number.parseInt(v, 10)).option("--split-delay-mode <mode>", "Split delay mode: disabled, fixed, or randomized").option("--split-delay-fixed <ms>", "Fixed delay between split chunks in ms", (v) => Number.parseInt(v, 10)).option("--split-delay-min <ms>", "Minimum delay between split chunks in ms", (v) => Number.parseInt(v, 10)).option("--split-delay-max <ms>", "Maximum delay between split chunks in ms", (v) => Number.parseInt(v, 10)).option("--agent-gate", "Enable LLM response gate").option("--agent-gate-model <model>", "Model for response gate").option("--agent-gate-prompt <prompt>", "Custom gate prompt").option("--tts-voice <id>", "ElevenLabs voice ID").option("--tts-model <id>", "ElevenLabs model ID").option("--read-receipts <mode>", "Read receipts mode: on, off, or exclude-self").option("--access-mode <mode>", "Access mode: disabled, blocklist, or allowlist").option("--reaction-ack <mode>", "Reaction ack mode (on|off)").option("--reaction-ack-emoji <json>", "Per-channel emoji map as JSON").option("--ack-timeout <ms>", "Ack timeout in milliseconds", (v) => Number.parseInt(v, 10)).option("--agent-stalled-timeout-ms <ms>", "Idle threshold in ms before the internal turn.stalled event fires (no channel message is ever sent)", (v) => Number.parseInt(v, 10)).option("--token <token>", "Generic bot token (auto-resolves to channel-specific field)").option("--telegram-token <token>", "Telegram bot token").option("--discord-token <token>", "Discord bot token").option("--slack-bot-token <token>", "Slack bot token").option("--slack-app-token <token>", "Slack app token").option("--gupshup-callback-url <url>", "Gupshup Custom Integration callback URL").option("--gupshup-auth-token <token>", "Gupshup Custom Integration auth token").option("--gupshup-event-id <id>", "Gupshup event ID (default: nx_omni_agent_reply)").option("--gupshup-webhook-verify-token <token>", "Gupshup webhook verify token").option("--twilio-account-sid <sid>", "Twilio Account SID").option("--twilio-auth-token <token>", "Twilio Auth Token").option("--twilio-from <address>", "Twilio WhatsApp sender address (whatsapp:+E164)").option("--twilio-messaging-service-sid <sid>", "Twilio Messaging Service SID").option("--twilio-status-callback-url <url>", "Twilio outbound status callback URL").option("--twilio-webhook-url <url>", "Public Twilio webhook URL for signature validation").option("--twilio-validate-signature", "Validate X-Twilio-Signature on webhooks").option("--no-twilio-validate-signature", "Disable X-Twilio-Signature validation").option("--bridge-tmux-session <name>", 'Tmux session name the genie bridge spawns into for this instance (propagated as GENIE_TMUX_SESSION via NATS). Use "null" to clear.').option("--require-genie-signature", "Require a verified X-Genie-Signature on requests targeting this instance. Bearer-only requests will be rejected with 401.").option("--no-require-genie-signature", "Allow bearer-only requests targeting this instance (default).").option("--is-default", "Set as default instance for channel").action(async (options) => {
     const channel = options.channel;
     if (!VALID_CHANNELS2.includes(channel)) {
       error(`Invalid channel: ${channel}`, { validChannels: VALID_CHANNELS2 });
@@ -132943,7 +132950,7 @@ function createInstancesCommand() {
       throw new Error(err?.error?.message ?? `HTTP ${response.status}`);
     }
   }
-  instances.command("update <id>").description("Update an instance (supports all API fields)").option("--name <name>", "Instance name").option("--is-default", "Set as default instance for channel").option("--no-is-default", "Unset as default instance for channel").option("--agent-fk-id <uuid>", 'Agent FK UUID (references agents table, use "null" to clear). When assigning an agent on an instance with no reply filter, the filter defaults to {mode:"all", onDm:true} so messages are dispatched instead of silently dropped (omni#443).').option("--agent-provider <id>", 'Agent provider ID (use "null" to clear)').option("--agent <id>", 'Agent ID (use "null" to clear)').option("--agent-type <type>", "Agent type: agent, team, or workflow").option("--agent-timeout <seconds>", "Agent timeout in seconds", (v) => Number.parseInt(v, 10)).option("--agent-stream-mode", "Enable streaming responses").option("--no-agent-stream-mode", "Disable streaming responses").option("--agent-session-strategy <strategy>", "Session strategy: per_user, per_chat, per_user_per_chat").option("--agent-prefix-sender-name", "Prefix messages with sender name").option("--no-agent-prefix-sender-name", "Disable sender name prefix").option("--agent-wait-for-media", "Wait for media processing before dispatch").option("--no-agent-wait-for-media", "Dispatch immediately without waiting for media").option("--agent-send-media-path", "Include file path in formatted media text").option("--no-agent-send-media-path", "Exclude file path from formatted media text").option("--agent-send-media-path-types <types>", "Content types that receive file path (comma-separated: image,video,document)").option("--reply-filter-mode <mode>", "Reply filter: all or filtered").option("--reply-on-dm", "Reply to DMs (requires --reply-filter-mode filtered)").option("--no-reply-on-dm", "Ignore DMs").option("--reply-on-mention", "Reply when @mentioned").option("--no-reply-on-mention", "Ignore @mentions").option("--reply-on-reply", "Reply when message is reply to bot").option("--no-reply-on-reply", "Ignore replies").option("--reply-on-name", "Reply when bot name appears in text").option("--no-reply-on-name", "Ignore name matches").option("--reply-name-patterns <patterns>", "Custom name patterns (comma-separated)").option("--clear-reply-filter", "Remove reply filter (set to null)").option("--enable-auto-split", "Split responses on double newlines").option("--no-enable-auto-split", "Disable auto-split").option("--message-format-mode <mode>", "Format mode: convert or passthrough").option("--debounce-mode <mode>", "Debounce mode: disabled, fixed, or randomized").option("--debounce-min <ms>", "Minimum debounce delay in ms", (v) => Number.parseInt(v, 10)).option("--debounce-max <ms>", "Maximum debounce delay in ms", (v) => Number.parseInt(v, 10)).option("--debounce-restart-on-typing", "Restart debounce timer on typing").option("--no-debounce-restart-on-typing", "Do not restart debounce on typing").option("--debounce-group <ms>", 'Group chat debounce in ms (use "null" to inherit)', (v) => v === "null" ? null : Number.parseInt(v, 10)).option("--split-delay-mode <mode>", "Split delay mode: disabled, fixed, or randomized").option("--split-delay-fixed <ms>", "Fixed delay between split chunks in ms", (v) => Number.parseInt(v, 10)).option("--split-delay-min <ms>", "Minimum delay between split chunks in ms", (v) => Number.parseInt(v, 10)).option("--split-delay-max <ms>", "Maximum delay between split chunks in ms", (v) => Number.parseInt(v, 10)).option("--agent-gate", "Enable LLM response gate").option("--no-agent-gate", "Disable LLM response gate").option("--agent-gate-model <model>", 'Model for response gate (use "null" for default)').option("--agent-gate-prompt <prompt>", 'Custom gate prompt (use "null" for default)').option("--tts-voice <id>", 'ElevenLabs voice ID (use "null" to clear)').option("--tts-model <id>", 'ElevenLabs model ID (use "null" to clear)').option("--read-receipts <mode>", "Read receipts mode: on, off, or exclude-self").option("--access-mode <mode>", "Access mode: disabled, blocklist, or allowlist").option("--reaction-ack <mode>", "Reaction ack mode (on|off)").option("--reaction-ack-emoji <json>", "Per-channel emoji map as JSON").option("--ack-timeout <ms>", "Ack timeout in milliseconds", (v) => Number.parseInt(v, 10)).option("--agent-stalled-timeout-ms <ms>", "Idle threshold in ms before the internal turn.stalled event fires (no channel message is ever sent)", (v) => Number.parseInt(v, 10)).option("--token <token>", "Generic bot token (auto-resolves to channel-specific field)").option("--telegram-token <token>", 'Telegram bot token (use "null" to clear)').option("--discord-token <token>", 'Discord bot token (use "null" to clear)').option("--slack-bot-token <token>", 'Slack bot token (use "null" to clear)').option("--slack-app-token <token>", 'Slack app token (use "null" to clear)').option("--twilio-account-sid <sid>", 'Twilio Account SID (use "null" to clear)').option("--twilio-auth-token <token>", 'Twilio Auth Token (use "null" to clear)').option("--twilio-from <address>", 'Twilio WhatsApp sender address (use "null" to clear)').option("--twilio-messaging-service-sid <sid>", 'Twilio Messaging Service SID (use "null" to clear)').option("--twilio-status-callback-url <url>", 'Twilio outbound status callback URL (use "null" to clear)').option("--twilio-webhook-url <url>", 'Public Twilio webhook URL for signature validation (use "null" to clear)').option("--twilio-validate-signature", "Validate X-Twilio-Signature on webhooks").option("--no-twilio-validate-signature", "Disable X-Twilio-Signature validation").option("--trigger-events <events>", 'Trigger events (comma-separated, use "null" to clear)').option("--profile-name <name>", "Update WhatsApp display name (push name)").option("--bridge-tmux-session <name>", 'Tmux session name the genie bridge spawns into for this instance (propagated as GENIE_TMUX_SESSION via NATS). Use "null" to clear.').option("--require-genie-signature", "Require a verified X-Genie-Signature on requests targeting this instance. Bearer-only requests will be rejected with 401.").option("--no-require-genie-signature", "Allow bearer-only requests targeting this instance (default).").action(async (rawId, options) => {
+  instances.command("update <id>").description("Update an instance (supports all API fields)").option("--name <name>", "Instance name").option("--is-default", "Set as default instance for channel").option("--no-is-default", "Unset as default instance for channel").option("--agent-fk-id <uuid>", 'Agent FK UUID (references agents table, use "null" to clear). When assigning an agent on an instance with no reply filter, the filter defaults to {mode:"all", onDm:true} so messages are dispatched instead of silently dropped (omni#443).').option("--agent-provider <id>", 'Agent provider ID (use "null" to clear)').option("--agent <id>", 'Agent ID (use "null" to clear)').option("--agent-type <type>", "Agent type: agent, team, or workflow").option("--agent-timeout <seconds>", "Agent timeout in seconds", (v) => Number.parseInt(v, 10)).option("--agent-stream-mode", "Enable streaming responses").option("--no-agent-stream-mode", "Disable streaming responses").option("--agent-session-strategy <strategy>", "Session strategy: per_user, per_chat, per_user_per_chat").option("--agent-prefix-sender-name", "Prefix messages with sender name").option("--no-agent-prefix-sender-name", "Disable sender name prefix").option("--agent-wait-for-media", "Wait for media processing before dispatch").option("--no-agent-wait-for-media", "Dispatch immediately without waiting for media").option("--agent-send-media-path", "Include file path in formatted media text").option("--no-agent-send-media-path", "Exclude file path from formatted media text").option("--agent-send-media-path-types <types>", "Content types that receive file path (comma-separated: image,video,document)").option("--reply-filter-mode <mode>", "Reply filter: all or filtered").option("--reply-on-dm", "Reply to DMs (requires --reply-filter-mode filtered)").option("--no-reply-on-dm", "Ignore DMs").option("--reply-on-mention", "Reply when @mentioned").option("--no-reply-on-mention", "Ignore @mentions").option("--reply-on-reply", "Reply when message is reply to bot").option("--no-reply-on-reply", "Ignore replies").option("--reply-on-name", "Reply when bot name appears in text").option("--no-reply-on-name", "Ignore name matches").option("--reply-name-patterns <patterns>", "Custom name patterns (comma-separated)").option("--clear-reply-filter", "Remove reply filter (set to null)").option("--enable-auto-split", "Split responses on double newlines").option("--no-enable-auto-split", "Disable auto-split").option("--message-format-mode <mode>", "Format mode: convert or passthrough").option("--debounce-mode <mode>", "Debounce mode: disabled, fixed, randomized, or presence").option("--debounce-min <ms>", "Minimum debounce delay in ms", (v) => Number.parseInt(v, 10)).option("--debounce-max <ms>", "Maximum debounce delay in ms", (v) => Number.parseInt(v, 10)).option("--debounce-restart-on-typing", "Restart debounce timer on typing").option("--no-debounce-restart-on-typing", "Do not restart debounce on typing").option("--debounce-group <ms>", 'Group chat debounce in ms (use "null" to inherit)', (v) => v === "null" ? null : Number.parseInt(v, 10)).option("--debounce-max-wait <ms>", 'Presence-mode hard cap in ms (use "null" to inherit)', (v) => v === "null" ? null : Number.parseInt(v, 10)).option("--split-delay-mode <mode>", "Split delay mode: disabled, fixed, or randomized").option("--split-delay-fixed <ms>", "Fixed delay between split chunks in ms", (v) => Number.parseInt(v, 10)).option("--split-delay-min <ms>", "Minimum delay between split chunks in ms", (v) => Number.parseInt(v, 10)).option("--split-delay-max <ms>", "Maximum delay between split chunks in ms", (v) => Number.parseInt(v, 10)).option("--agent-gate", "Enable LLM response gate").option("--no-agent-gate", "Disable LLM response gate").option("--agent-gate-model <model>", 'Model for response gate (use "null" for default)').option("--agent-gate-prompt <prompt>", 'Custom gate prompt (use "null" for default)').option("--tts-voice <id>", 'ElevenLabs voice ID (use "null" to clear)').option("--tts-model <id>", 'ElevenLabs model ID (use "null" to clear)').option("--read-receipts <mode>", "Read receipts mode: on, off, or exclude-self").option("--access-mode <mode>", "Access mode: disabled, blocklist, or allowlist").option("--reaction-ack <mode>", "Reaction ack mode (on|off)").option("--reaction-ack-emoji <json>", "Per-channel emoji map as JSON").option("--ack-timeout <ms>", "Ack timeout in milliseconds", (v) => Number.parseInt(v, 10)).option("--agent-stalled-timeout-ms <ms>", "Idle threshold in ms before the internal turn.stalled event fires (no channel message is ever sent)", (v) => Number.parseInt(v, 10)).option("--token <token>", "Generic bot token (auto-resolves to channel-specific field)").option("--telegram-token <token>", 'Telegram bot token (use "null" to clear)').option("--discord-token <token>", 'Discord bot token (use "null" to clear)').option("--slack-bot-token <token>", 'Slack bot token (use "null" to clear)').option("--slack-app-token <token>", 'Slack app token (use "null" to clear)').option("--twilio-account-sid <sid>", 'Twilio Account SID (use "null" to clear)').option("--twilio-auth-token <token>", 'Twilio Auth Token (use "null" to clear)').option("--twilio-from <address>", 'Twilio WhatsApp sender address (use "null" to clear)').option("--twilio-messaging-service-sid <sid>", 'Twilio Messaging Service SID (use "null" to clear)').option("--twilio-status-callback-url <url>", 'Twilio outbound status callback URL (use "null" to clear)').option("--twilio-webhook-url <url>", 'Public Twilio webhook URL for signature validation (use "null" to clear)').option("--twilio-validate-signature", "Validate X-Twilio-Signature on webhooks").option("--no-twilio-validate-signature", "Disable X-Twilio-Signature validation").option("--trigger-events <events>", 'Trigger events (comma-separated, use "null" to clear)').option("--profile-name <name>", "Update WhatsApp display name (push name)").option("--bridge-tmux-session <name>", 'Tmux session name the genie bridge spawns into for this instance (propagated as GENIE_TMUX_SESSION via NATS). Use "null" to clear.').option("--require-genie-signature", "Require a verified X-Genie-Signature on requests targeting this instance. Bearer-only requests will be rejected with 401.").option("--no-require-genie-signature", "Allow bearer-only requests targeting this instance (default).").action(async (rawId, options) => {
     const client = getClient();
     try {
       const id = await resolveInstanceId(rawId);

package/dist/sdk/types.generated.d.ts

@@ -3789,7 +3789,7 @@ export interface components {
              * @description Debounce mode override
              * @enum {string|null}
              */
-            messageDebounceMode: "disabled" | "fixed" | "randomized" | null;
+            messageDebounceMode: "disabled" | "fixed" | "randomized" | "presence" | null;
             /** @description Debounce min delay (ms) override */
             messageDebounceMinMs: number | null;
             /** @description Debounce max delay (ms) override */
@@ -3798,6 +3798,8 @@ export interface components {
             messageDebounceGroupMs: number | null;
             /** @description Restart debounce on typing override */
             messageDebounceRestartOnTyping: boolean | null;
+            /** @description Presence-mode hard cap (ms) override; null = no cap */
+            messageDebounceMaxWaitMs: number | null;
             /**
              * @description Split delay mode override
              * @enum {string|null}
@@ -3907,7 +3909,7 @@ export interface components {
              * @description Debounce mode
              * @enum {string}
              */
-            messageDebounceMode?: "disabled" | "fixed" | "randomized";
+            messageDebounceMode?: "disabled" | "fixed" | "randomized" | "presence";
             /** @description Debounce min delay (ms) */
             messageDebounceMinMs?: number;
             /** @description Debounce max delay (ms) */
@@ -3916,6 +3918,8 @@ export interface components {
             messageDebounceGroupMs?: number;
             /** @description Restart debounce on typing */
             messageDebounceRestartOnTyping?: boolean;
+            /** @description Presence-mode hard cap (ms); null = no cap */
+            messageDebounceMaxWaitMs?: number;
             /**
              * @description Split delay mode
              * @enum {string}
@@ -4006,7 +4010,7 @@ export interface components {
              * @description Debounce mode
              * @enum {string|null}
              */
-            messageDebounceMode?: "disabled" | "fixed" | "randomized" | null;
+            messageDebounceMode?: "disabled" | "fixed" | "randomized" | "presence" | null;
             /** @description Debounce min delay (ms) */
             messageDebounceMinMs?: number | null;
             /** @description Debounce max delay (ms) */
@@ -4015,6 +4019,8 @@ export interface components {
             messageDebounceGroupMs?: number | null;
             /** @description Restart debounce on typing */
             messageDebounceRestartOnTyping?: boolean | null;
+            /** @description Presence-mode hard cap (ms); null = no cap */
+            messageDebounceMaxWaitMs?: number | null;
             /**
              * @description Split delay mode
              * @enum {string|null}
@@ -11571,7 +11577,7 @@ export interface operations {
                              * @description Debounce mode override
                              * @enum {string|null}
                              */
-                            messageDebounceMode: "disabled" | "fixed" | "randomized" | null;
+                            messageDebounceMode: "disabled" | "fixed" | "randomized" | "presence" | null;
                             /** @description Debounce min delay (ms) override */
                             messageDebounceMinMs: number | null;
                             /** @description Debounce max delay (ms) override */
@@ -11580,6 +11586,8 @@ export interface operations {
                             messageDebounceGroupMs: number | null;
                             /** @description Restart debounce on typing override */
                             messageDebounceRestartOnTyping: boolean | null;
+                            /** @description Presence-mode hard cap (ms) override; null = no cap */
+                            messageDebounceMaxWaitMs: number | null;
                             /**
                              * @description Split delay mode override
                              * @enum {string|null}
@@ -11726,7 +11734,7 @@ export interface operations {
                      * @description Debounce mode
                      * @enum {string}
                      */
-                    messageDebounceMode?: "disabled" | "fixed" | "randomized";
+                    messageDebounceMode?: "disabled" | "fixed" | "randomized" | "presence";
                     /** @description Debounce min delay (ms) */
                     messageDebounceMinMs?: number;
                     /** @description Debounce max delay (ms) */
@@ -11735,6 +11743,8 @@ export interface operations {
                     messageDebounceGroupMs?: number;
                     /** @description Restart debounce on typing */
                     messageDebounceRestartOnTyping?: boolean;
+                    /** @description Presence-mode hard cap (ms); null = no cap */
+                    messageDebounceMaxWaitMs?: number;
                     /**
                      * @description Split delay mode
                      * @enum {string}
@@ -11860,7 +11870,7 @@ export interface operations {
                              * @description Debounce mode override
                              * @enum {string|null}
                              */
-                            messageDebounceMode: "disabled" | "fixed" | "randomized" | null;
+                            messageDebounceMode: "disabled" | "fixed" | "randomized" | "presence" | null;
                             /** @description Debounce min delay (ms) override */
                             messageDebounceMinMs: number | null;
                             /** @description Debounce max delay (ms) override */
@@ -11869,6 +11879,8 @@ export interface operations {
                             messageDebounceGroupMs: number | null;
                             /** @description Restart debounce on typing override */
                             messageDebounceRestartOnTyping: boolean | null;
+                            /** @description Presence-mode hard cap (ms) override; null = no cap */
+                            messageDebounceMaxWaitMs: number | null;
                             /**
                              * @description Split delay mode override
                              * @enum {string|null}
@@ -12075,7 +12087,7 @@ export interface operations {
                              * @description Debounce mode override
                              * @enum {string|null}
                              */
-                            messageDebounceMode: "disabled" | "fixed" | "randomized" | null;
+                            messageDebounceMode: "disabled" | "fixed" | "randomized" | "presence" | null;
                             /** @description Debounce min delay (ms) override */
                             messageDebounceMinMs: number | null;
                             /** @description Debounce max delay (ms) override */
@@ -12084,6 +12096,8 @@ export interface operations {
                             messageDebounceGroupMs: number | null;
                             /** @description Restart debounce on typing override */
                             messageDebounceRestartOnTyping: boolean | null;
+                            /** @description Presence-mode hard cap (ms) override; null = no cap */
+                            messageDebounceMaxWaitMs: number | null;
                             /**
                              * @description Split delay mode override
                              * @enum {string|null}
@@ -12304,7 +12318,7 @@ export interface operations {
                      * @description Debounce mode
                      * @enum {string|null}
                      */
-                    messageDebounceMode?: "disabled" | "fixed" | "randomized" | null;
+                    messageDebounceMode?: "disabled" | "fixed" | "randomized" | "presence" | null;
                     /** @description Debounce min delay (ms) */
                     messageDebounceMinMs?: number | null;
                     /** @description Debounce max delay (ms) */
@@ -12313,6 +12327,8 @@ export interface operations {
                     messageDebounceGroupMs?: number | null;
                     /** @description Restart debounce on typing */
                     messageDebounceRestartOnTyping?: boolean | null;
+                    /** @description Presence-mode hard cap (ms); null = no cap */
+                    messageDebounceMaxWaitMs?: number | null;
                     /**
                      * @description Split delay mode
                      * @enum {string|null}
@@ -12432,7 +12448,7 @@ export interface operations {
                              * @description Debounce mode override
                              * @enum {string|null}
                              */
-                            messageDebounceMode: "disabled" | "fixed" | "randomized" | null;
+                            messageDebounceMode: "disabled" | "fixed" | "randomized" | "presence" | null;
                             /** @description Debounce min delay (ms) override */
                             messageDebounceMinMs: number | null;
                             /** @description Debounce max delay (ms) override */
@@ -12441,6 +12457,8 @@ export interface operations {
                             messageDebounceGroupMs: number | null;
                             /** @description Restart debounce on typing override */
                             messageDebounceRestartOnTyping: boolean | null;
+                            /** @description Presence-mode hard cap (ms) override; null = no cap */
+                            messageDebounceMaxWaitMs: number | null;
                             /**
                              * @description Split delay mode override
                              * @enum {string|null}