@automagik/omni 2.260804.3 → 2.260830.2

package/dist/index.js

@@ -32212,6 +32212,8 @@ var init_instance = __esm(() => {
     sessionIdPrefix: exports_external.string().max(50).nullable(),
     discordBotToken: exports_external.string().nullable(),
     slackBotToken: exports_external.string().nullable(),
+    slackUserToken: exports_external.string().nullable(),
+    slackAuthMode: exports_external.string().nullable(),
     slackAppToken: exports_external.string().nullable(),
     slackSigningSecret: exports_external.string().nullable(),
     telegramBotToken: exports_external.string().nullable(),
@@ -73107,6 +73109,9 @@ __export(exports_schema, {
   settingValueTypes: () => settingValueTypes,
   settingChangeHistoryRelations: () => settingChangeHistoryRelations,
   settingChangeHistory: () => settingChangeHistory,
+  scheduledMessages: () => scheduledMessages,
+  scheduledMessageStatuses: () => scheduledMessageStatuses,
+  scheduledMessageDeliveryModes: () => scheduledMessageDeliveryModes,
   ruleTypes: () => ruleTypes,
   replyFilterMode: () => replyFilterMode,
   providerSchemas: () => providerSchemas,
@@ -73207,7 +73212,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, jobStatuses, providerSchemas, agentProviders, agents, agentRoutes, agentSessions, apiKeys, apiKeyAuditLogs, apiKeysRelations, apiKeyAuditLogsRelations, instances, whatsappTemplates, whatsappFlowKeys, 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, webhookSources, 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, webhookSources, 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 init_schema2 = __esm(() => {
   init_events();
   init_types5();
@@ -73282,6 +73287,8 @@ var init_schema2 = __esm(() => {
   ];
   messageStatuses = ["active", "edited", "deleted", "expired"];
   deliveryStatuses = ["pending", "sent", "delivered", "read", "failed"];
+  scheduledMessageDeliveryModes = ["platform", "local"];
+  scheduledMessageStatuses = ["pending", "sending", "sent", "canceled", "failed"];
   jobStatuses = ["pending", "running", "completed", "failed", "cancelled"];
   providerSchemas = [
     "agno",
@@ -73484,6 +73491,8 @@ var init_schema2 = __esm(() => {
     guildConfigOverrides: jsonb("guild_config_overrides").$type(),
     discordPresence: jsonb("discord_presence").$type(),
     slackBotToken: text("slack_bot_token"),
+    slackUserToken: text("slack_user_token"),
+    slackAuthMode: varchar("slack_auth_mode", { length: 10 }),
     slackAppToken: text("slack_app_token"),
     slackSigningSecret: text("slack_signing_secret"),
     telegramBotToken: text("telegram_bot_token"),
@@ -73628,6 +73637,31 @@ var init_schema2 = __esm(() => {
   }, (t) => ({
     instanceUnique: uniqueIndex("idx_wa_flow_keys_instance").on(t.instanceId)
   }));
+  scheduledMessages = pgTable("scheduled_messages", {
+    id: uuid("id").primaryKey().defaultRandom(),
+    instanceId: uuid("instance_id").notNull().references(() => instances.id, { onDelete: "cascade" }),
+    chatExternalId: varchar("chat_external_id", { length: 255 }).notNull(),
+    threadExternalId: varchar("thread_external_id", { length: 255 }),
+    isThreadBroadcast: boolean("is_thread_broadcast").notNull().default(false),
+    content: jsonb("content").$type().notNull(),
+    sendAt: timestamp("send_at", { withTimezone: true }).notNull(),
+    deliveryMode: varchar("delivery_mode", { length: 20 }).notNull().$type(),
+    status: varchar("status", { length: 20 }).notNull().default("pending").$type(),
+    externalScheduledId: varchar("external_scheduled_id", { length: 255 }),
+    sentExternalId: varchar("sent_external_id", { length: 255 }),
+    sentAt: timestamp("sent_at", { withTimezone: true }),
+    canceledAt: timestamp("canceled_at", { withTimezone: true }),
+    failedAt: timestamp("failed_at", { withTimezone: true }),
+    lastError: text("last_error"),
+    attemptCount: integer("attempt_count").notNull().default(0),
+    createdByAgentId: uuid("created_by_agent_id"),
+    createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
+    updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow()
+  }, (t) => ({
+    dueIdx: index("scheduled_messages_due_idx").on(t.status, t.sendAt),
+    instanceIdx: index("scheduled_messages_instance_idx").on(t.instanceId, t.status),
+    chatIdx: index("scheduled_messages_chat_idx").on(t.instanceId, t.chatExternalId)
+  }));
   persons = pgTable("persons", {
     id: uuid("id").primaryKey().defaultRandom(),
     displayName: varchar("display_name", { length: 255 }),
@@ -73812,6 +73846,15 @@ var init_schema2 = __esm(() => {
     replyToExternalId: varchar("reply_to_external_id", { length: 255 }),
     quotedText: text("quoted_text"),
     quotedSenderName: varchar("quoted_sender_name", { length: 255 }),
+    threadExternalId: varchar("thread_external_id", { length: 255 }),
+    threadRootMessageId: uuid("thread_root_message_id"),
+    isThreadBroadcast: boolean("is_thread_broadcast").notNull().default(false),
+    replyCount: integer("reply_count").notNull().default(0),
+    latestReplyAt: timestamp("latest_reply_at", { withTimezone: true }),
+    permalink: text("permalink"),
+    pinnedAt: timestamp("pinned_at", { withTimezone: true }),
+    pinnedBy: varchar("pinned_by", { length: 255 }),
+    starredAt: timestamp("starred_at", { withTimezone: true }),
     forwardedFromMessageId: uuid("forwarded_from_message_id"),
     forwardedFromExternalId: varchar("forwarded_from_external_id", { length: 255 }),
     forwardCount: integer("forward_count").notNull().default(0),
@@ -73849,6 +73892,8 @@ var init_schema2 = __esm(() => {
     platformTimestampIdx: index("messages_platform_timestamp_idx").on(table3.platformTimestamp),
     replyToIdx: index("messages_reply_to_idx").on(table3.replyToMessageId),
     replyToExternalIdx: index("messages_reply_to_external_idx").on(table3.chatId, table3.replyToExternalId, table3.isFromMe),
+    threadExternalIdx: index("messages_thread_external_idx").on(table3.chatId, table3.threadExternalId, table3.platformTimestamp),
+    threadRootIdx: index("messages_thread_root_idx").on(table3.threadRootMessageId),
     hasMediaIdx: index("messages_has_media_idx").on(table3.hasMedia),
     originalEventIdx: index("messages_original_event_idx").on(table3.originalEventId)
   }));
@@ -126388,6 +126433,31 @@ function createOmniClient(config) {
         throwIfError(response, error);
         return data?.data ?? { code: "", phoneNumber: "", message: "", expiresIn: 0 };
       },
+      async passkey(id) {
+        const response = await apiFetch(`${baseUrl}/api/v2/instances/${id}/passkey`, {});
+        const json = await response.json();
+        if (!response.ok)
+          throw OmniApiError.from(json, response.status);
+        return json.data ?? null;
+      },
+      async submitPasskey(id, credential) {
+        const response = await apiFetch(`${baseUrl}/api/v2/instances/${id}/passkey/response`, {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify(credential)
+        });
+        const json = await response.json();
+        if (!response.ok)
+          throw OmniApiError.from(json, response.status);
+      },
+      async confirmPasskey(id) {
+        const response = await apiFetch(`${baseUrl}/api/v2/instances/${id}/passkey/confirm`, {
+          method: "POST"
+        });
+        const json = await response.json();
+        if (!response.ok)
+          throw OmniApiError.from(json, response.status);
+      },
       async syncProfile(id) {
         const resp = await apiFetch(`${baseUrl}/api/v2/instances/${id}/sync/profile`, {
           method: "POST"
@@ -127931,6 +128001,68 @@ function createOmniClient(config) {
         throwIfError(response, error);
       }
     },
+    scheduledMessages: {
+      async schedule(input) {
+        const resp = await apiFetch(`${baseUrl}/api/v2/scheduled-messages`, {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify(input)
+        });
+        const json = await resp.json();
+        if (!resp.ok)
+          throw OmniApiError.from(json, resp.status);
+        return json?.data ?? {};
+      },
+      async listPending(instanceId, limit) {
+        const query = new URLSearchParams({ instanceId });
+        if (limit !== undefined)
+          query.set("limit", String(limit));
+        const resp = await apiFetch(`${baseUrl}/api/v2/scheduled-messages?${query}`);
+        const json = await resp.json();
+        if (!resp.ok)
+          throw OmniApiError.from(json, resp.status);
+        return json?.data ?? [];
+      },
+      async get(id) {
+        const resp = await apiFetch(`${baseUrl}/api/v2/scheduled-messages/${id}`);
+        const json = await resp.json();
+        if (!resp.ok)
+          throw OmniApiError.from(json, resp.status);
+        return json?.data ?? null;
+      },
+      async cancel(id) {
+        const resp = await apiFetch(`${baseUrl}/api/v2/scheduled-messages/${id}`, { method: "DELETE" });
+        const json = await resp.json();
+        if (!resp.ok)
+          throw OmniApiError.from(json, resp.status);
+        return json?.data ?? {};
+      }
+    },
+    slack: {
+      async openDm(instanceId, userId) {
+        const resp = await apiFetch(`${baseUrl}/api/v2/slack/dm/open`, {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({ instanceId, userId })
+        });
+        const json = await resp.json();
+        if (!resp.ok)
+          throw OmniApiError.from(json, resp.status);
+        return json?.data ?? { userId, channelId: "" };
+      },
+      async search(instanceId, query, options) {
+        const params = new URLSearchParams({ instanceId, query });
+        if (options?.count !== undefined)
+          params.set("count", String(options.count));
+        if (options?.page !== undefined)
+          params.set("page", String(options.page));
+        const resp = await apiFetch(`${baseUrl}/api/v2/slack/search?${params}`);
+        const json = await resp.json();
+        if (!resp.ok)
+          throw OmniApiError.from(json, resp.status);
+        return json?.data ?? [];
+      }
+    },
     followUp: {
       async getAgent(id) {
         const resp = await apiFetch(`${baseUrl}/api/v2/follow-up/agents/${id}`);
@@ -128149,7 +128281,7 @@ import { fileURLToPath } from "url";
 // package.json
 var package_default = {
   name: "@automagik/omni",
-  version: "2.260804.3",
+  version: "2.260830.2",
   description: "LLM-optimized CLI for Omni",
   type: "module",
   bin: {
@@ -131905,19 +132037,33 @@ function createConfigCommand() {
 // src/commands/connect.ts
 import { execFileSync as execFileSync2 } from "child_process";
 init_output();
-async function findOrCreateProvider(client, agentName, agentEntry, natsUrl) {
+
+// src/commands/_setup-helpers.ts
+init_output();
+function schemaToAgentProvider(schema) {
+  switch (schema) {
+    case "agno":
+      return "agno";
+    case "claude-code":
+      return "claude";
+    default:
+      return "custom";
+  }
+}
+async function findOrCreateProvider(client, args) {
   try {
     const provider = await client.providers.create({
-      name: `nats-genie-${agentName}`,
-      schema: "nats-genie",
-      baseUrl: `nats://${natsUrl}`,
-      schemaConfig: { agentName: agentEntry.name, agentDir: agentEntry.dir, natsUrl }
+      name: args.name,
+      schema: args.schema,
+      baseUrl: args.baseUrl,
+      apiKey: args.apiKey,
+      schemaConfig: args.schemaConfig
     });
     return provider.id;
   } catch {
     try {
       const providers = await client.providers.list();
-      const existing = providers.find((p) => p.name === `nats-genie-${agentName}` && p.schema === "nats-genie");
+      const existing = providers.find((p) => p.name === args.name && p.schema === args.schema);
       if (existing) {
         info(`Using existing provider: ${existing.id}`);
         return existing.id;
@@ -131927,22 +132073,23 @@ async function findOrCreateProvider(client, agentName, agentEntry, natsUrl) {
     return null;
   }
 }
-async function findOrCreateAgent(client, agentName, providerId) {
+async function findOrCreateAgent(client, args) {
   try {
     const agent = await client.agents.create({
-      name: agentName,
-      agentProviderId: providerId,
-      agentType: "assistant",
-      provider: "custom",
-      capabilities: [],
-      isInternal: false,
-      isActive: true
+      name: args.name,
+      agentProviderId: args.providerId,
+      agentType: args.agentType ?? "assistant",
+      provider: args.agentProvider,
+      model: args.model,
+      capabilities: args.capabilities ?? [],
+      isInternal: args.isInternal ?? false,
+      isActive: args.isActive ?? true
     });
     return agent.id;
   } catch {
     try {
       const { items } = await client.agents.list();
-      const existing = items.find((a) => a.name === agentName && a.agentProviderId === providerId);
+      const existing = items.find((a) => a.name === args.name && a.agentProviderId === args.providerId);
       if (existing) {
         info(`Using existing agent: ${existing.id}`);
         return existing.id;
@@ -131952,6 +132099,8 @@ async function findOrCreateAgent(client, agentName, providerId) {
     return null;
   }
 }
+
+// src/commands/connect.ts
 function createConnectCommand() {
   return new Command("connect").description("Connect an Omni instance to a Genie agent via NATS").argument("<instance-id>", "Omni instance ID").argument("<agent-name>", "Genie agent name (from genie directory)").option("--nats-url <url>", "NATS server URL", "localhost:4222").option("--mode <mode>", "Trigger mode: turn-based (round-trip) or fire-and-forget", "turn-based").option("--reply-filter <filter>", "Reply filter: all (reply to everything) or filtered", "all").action(async (instanceId, agentName, options) => {
     const client = getClient();
@@ -131978,11 +132127,20 @@ Make sure genie is installed and the agent is registered:
       return;
     }
     info("Creating NATS Genie provider...");
-    const providerId = await findOrCreateProvider(client, agentName, agentEntry, options.natsUrl);
+    const providerId = await findOrCreateProvider(client, {
+      name: `nats-genie-${agentName}`,
+      schema: "nats-genie",
+      baseUrl: `nats://${options.natsUrl}`,
+      schemaConfig: { agentName: agentEntry.name, agentDir: agentEntry.dir, natsUrl: options.natsUrl }
+    });
     if (!providerId)
       return;
     info("Creating agent record...");
-    const agentId = await findOrCreateAgent(client, agentName, providerId);
+    const agentId = await findOrCreateAgent(client, {
+      name: agentName,
+      providerId,
+      agentProvider: "custom"
+    });
     if (!agentId)
       return;
     const triggerMode = options.mode === "turn-based" ? "round-trip" : "fire-and-forget";
@@ -134821,8 +134979,9 @@ async function streamEvents(client, options) {
   const shutdown = () => {
     stopped = true;
   };
-  process.on("SIGINT", shutdown);
-  process.on("SIGTERM", shutdown);
+  const processEvents = process;
+  processEvents.on("SIGINT", shutdown);
+  processEvents.on("SIGTERM", shutdown);
   if (!ndjson)
     dim(`Streaming events (poll=${pollMs}ms). Ctrl+C to stop.`);
   try {
@@ -134834,8 +134993,8 @@ async function streamEvents(client, options) {
       await new Promise((resolve2) => setTimeout(resolve2, pollMs));
     }
   } finally {
-    process.off("SIGINT", shutdown);
-    process.off("SIGTERM", shutdown);
+    processEvents.off("SIGINT", shutdown);
+    processEvents.off("SIGTERM", shutdown);
     await flushStdout();
   }
 }
@@ -136045,6 +136204,39 @@ function createInstancesCommand() {
       error(`Failed to request pairing code: ${message}`);
     }
   });
+  instances.command("passkey <id>").description("Get the pending WhatsApp passkey ceremony").action(async (rawId) => {
+    const client = getClient();
+    try {
+      const id = await resolveInstanceId(rawId);
+      data(await client.instances.passkey(id));
+    } catch (err) {
+      const message = err instanceof Error ? err.message : "Unknown error";
+      error(`Failed to get passkey state: ${message}`);
+    }
+  });
+  instances.command("passkey-submit <id>").description("Submit a WebAuthn assertion for WhatsApp pairing").requiredOption("--response-file <path>", "JSON file containing the one-time WebAuthn assertion").action(async (rawId, options) => {
+    const client = getClient();
+    try {
+      const id = await resolveInstanceId(rawId);
+      const credential = await Bun.file(options.responseFile).json();
+      await client.instances.submitPasskey(id, credential);
+      success("Passkey response submitted");
+    } catch (err) {
+      const message = err instanceof Error ? err.message : "Unknown error";
+      error(`Failed to submit passkey response: ${message}`);
+    }
+  });
+  instances.command("passkey-confirm <id>").description("Confirm a pending WhatsApp passkey pairing").action(async (rawId) => {
+    const client = getClient();
+    try {
+      const id = await resolveInstanceId(rawId);
+      await client.instances.confirmPasskey(id);
+      success("Passkey pairing confirmed");
+    } catch (err) {
+      const message = err instanceof Error ? err.message : "Unknown error";
+      error(`Failed to confirm passkey pairing: ${message}`);
+    }
+  });
   instances.command("connect <id>").description("Connect an instance").option("--force-new-qr", "Force generation of new QR code").option("--token <token>", "Discord bot token (for Discord instances)").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("--access-token <token>", "WhatsApp Cloud (Meta) access token \u2014 pair with --phone-number-id + --waba-id").option("--phone-number-id <id>", "WhatsApp Cloud phone_number_id (Graph API id, not E.164)").option("--waba-id <id>", "WhatsApp Business Account id (WABA id)").option("--meta-app-id <id>", "Optional override for META_APP_ID (when the tenant owns its own Meta App)").option("--meta-business-id <id>", "Optional Meta Business Manager id").action(async (rawId, options) => {
     const client = getClient();
     try {
@@ -139703,6 +139895,84 @@ function createSayCommand() {
   });
 }
 
+// src/commands/schedule.ts
+init_output();
+function parseSendAt(raw2, now = new Date) {
+  const relative = /^(\d+)\s*(m|h|d)$/i.exec(raw2.trim());
+  if (relative) {
+    const amount = Number(relative[1]);
+    const unit = (relative[2] ?? "").toLowerCase();
+    const ms = unit === "m" ? 60000 : unit === "h" ? 3600000 : 86400000;
+    return new Date(now.getTime() + amount * ms);
+  }
+  const parsed = new Date(raw2);
+  if (Number.isNaN(parsed.getTime())) {
+    throw new Error(`Could not read "${raw2}" as a time. Use an ISO-8601 instant or a relative offset (30m, 2h, 3d).`);
+  }
+  return parsed;
+}
+function createScheduleCommand() {
+  const cmd = new Command("schedule").description("Schedule messages for later delivery (#889)");
+  cmd.command("send <instance> <chat> <text>").description("Schedule a text message. <chat> is the PLATFORM id (Slack C\u2026/D\u2026).").requiredOption("--at <when>", "ISO-8601 instant, or a relative offset: 30m, 2h, 3d").option("--thread <ts>", "Post into this thread (Slack thread_ts)").option("--broadcast", "Also surface it in the channel (Slack reply_broadcast)").action(async (instance3, chat, text3, opts) => {
+    try {
+      const sendAt = parseSendAt(opts.at);
+      const instanceId = await resolveInstanceId(instance3);
+      const row = await getClient().scheduledMessages.schedule({
+        instanceId,
+        chatId: chat,
+        content: { type: "text", text: text3 },
+        sendAt: sendAt.toISOString(),
+        threadId: opts.thread,
+        isThreadBroadcast: opts.broadcast === true
+      });
+      success(`Scheduled for ${sendAt.toISOString()} (${row.deliveryMode} mode) \u2014 id ${row.id}`);
+    } catch (err2) {
+      error(`Failed to schedule: ${err2 instanceof Error ? err2.message : "Unknown error"}`, undefined, 3);
+    }
+  });
+  cmd.command("list <instance>").description("List pending messages scheduled through omni.").option("--limit <n>", "Max rows", "100").action(async (instance3, opts) => {
+    try {
+      const instanceId = await resolveInstanceId(instance3);
+      const rows = await getClient().scheduledMessages.listPending(instanceId, Number(opts.limit));
+      if (rows.length === 0) {
+        info("No pending scheduled messages.");
+        info("(Only messages scheduled through omni are listed.)");
+        return;
+      }
+      list(rows.map((r6) => ({
+        id: String(r6.id ?? ""),
+        sendAt: String(r6.sendAt ?? ""),
+        chat: String(r6.chatExternalId ?? ""),
+        mode: String(r6.deliveryMode ?? ""),
+        status: String(r6.status ?? "")
+      })));
+    } catch (err2) {
+      error(`Failed to list: ${err2 instanceof Error ? err2.message : "Unknown error"}`, undefined, 3);
+    }
+  });
+  cmd.command("get <id>").description("Show one scheduled message.").action(async (id) => {
+    try {
+      const row = await getClient().scheduledMessages.get(id);
+      if (!row) {
+        error(`Scheduled message ${id} not found.`, undefined, 4);
+        return;
+      }
+      data(row);
+    } catch (err2) {
+      error(`Failed to read: ${err2 instanceof Error ? err2.message : "Unknown error"}`, undefined, 3);
+    }
+  });
+  cmd.command("cancel <id>").description("Cancel a pending scheduled message.").action(async (id) => {
+    try {
+      const row = await getClient().scheduledMessages.cancel(id);
+      success(`Scheduled message ${id} is now ${row.status}.`);
+    } catch (err2) {
+      error(`Failed to cancel: ${err2 instanceof Error ? err2.message : "Unknown error"}`, undefined, 3);
+    }
+  });
+  return cmd;
+}
+
 // src/commands/see.ts
 import { existsSync as existsSync16, readFileSync as readFileSync13, statSync as statSync5 } from "fs";
 import { extname as extname4 } from "path";
@@ -140459,6 +140729,226 @@ function createSettingsCommand() {
   return settings;
 }
 
+// src/commands/setup.ts
+init_src2();
+init_output();
+function buildAgnoConfig(opts) {
+  if (!opts.baseUrl)
+    return { error: "agno provider requires --base-url (Agno API URL)." };
+  const schemaConfig = {};
+  if (opts.defaultAgentId)
+    schemaConfig.defaultAgentId = opts.defaultAgentId;
+  return {
+    baseUrl: opts.baseUrl,
+    apiKey: opts.apiKey,
+    schemaConfig: Object.keys(schemaConfig).length > 0 ? schemaConfig : undefined
+  };
+}
+function buildWebhookConfig(opts) {
+  const url = opts.webhookUrl ?? opts.baseUrl;
+  if (!url)
+    return { error: "webhook provider requires --webhook-url (or --base-url)." };
+  return { baseUrl: url, apiKey: opts.apiKey };
+}
+function buildOpenClawConfig2(opts) {
+  if (!opts.baseUrl)
+    return { error: "openclaw provider requires --base-url (ws:// or wss://)." };
+  if (!opts.baseUrl.startsWith("ws://") && !opts.baseUrl.startsWith("wss://")) {
+    return { error: `openclaw requires ws:// or wss:// URL. Got: ${opts.baseUrl}` };
+  }
+  if (!opts.defaultAgentId) {
+    return { error: "openclaw provider requires --default-agent-id." };
+  }
+  return {
+    baseUrl: opts.baseUrl,
+    apiKey: opts.apiKey,
+    schemaConfig: { defaultAgentId: opts.defaultAgentId }
+  };
+}
+function buildAgUiConfig(opts) {
+  if (!opts.baseUrl)
+    return { error: "ag-ui provider requires --base-url." };
+  return { baseUrl: opts.baseUrl, apiKey: opts.apiKey };
+}
+function buildClaudeCodeConfig2(opts) {
+  if (!opts.baseUrl)
+    return { error: "claude-code provider requires --base-url." };
+  if (!opts.projectPath)
+    return { error: "claude-code provider requires --project-path." };
+  const schemaConfig = { projectPath: opts.projectPath };
+  if (opts.maxTurns)
+    schemaConfig.maxTurns = opts.maxTurns;
+  if (opts.permissionMode)
+    schemaConfig.permissionMode = opts.permissionMode;
+  if (opts.model)
+    schemaConfig.model = opts.model;
+  if (opts.systemPrompt)
+    schemaConfig.systemPrompt = opts.systemPrompt;
+  return { baseUrl: opts.baseUrl, apiKey: opts.apiKey, schemaConfig };
+}
+function buildA2aConfig(opts) {
+  if (!opts.baseUrl)
+    return { error: "a2a provider requires --base-url." };
+  return { baseUrl: opts.baseUrl, apiKey: opts.apiKey };
+}
+function buildNatsGenieConfig2(opts) {
+  const natsUrl = opts.natsUrl ?? "localhost:4222";
+  const schemaConfig = { natsUrl };
+  if (opts.agentName)
+    schemaConfig.agentName = opts.agentName;
+  if (opts.targetAgent)
+    schemaConfig.targetAgent = opts.targetAgent;
+  if (opts.teamName)
+    schemaConfig.teamName = opts.teamName;
+  return {
+    baseUrl: opts.baseUrl ?? `nats://${natsUrl}`,
+    apiKey: opts.apiKey,
+    schemaConfig
+  };
+}
+function buildProviderConfig(opts) {
+  switch (opts.schema) {
+    case "agno":
+      return buildAgnoConfig(opts);
+    case "webhook":
+      return buildWebhookConfig(opts);
+    case "openclaw":
+      return buildOpenClawConfig2(opts);
+    case "ag-ui":
+      return buildAgUiConfig(opts);
+    case "claude-code":
+      return buildClaudeCodeConfig2(opts);
+    case "a2a":
+      return buildA2aConfig(opts);
+    case "nats-genie":
+      return buildNatsGenieConfig2(opts);
+    default:
+      return { error: `Unsupported --schema "${opts.schema}". Valid: ${[...PROVIDER_SCHEMAS].join(", ")}` };
+  }
+}
+function createTopLevelSetupCommand() {
+  const setup = new Command("setup").description("Compound setup wizards for Omni resources");
+  setup.command("agent").description("Wire an agent to an instance in one step (provider + agent + binding + health check)").requiredOption("--instance <name-or-uuid>", "Omni instance (name or UUID)").requiredOption("--schema <schema>", `Provider schema (${[...PROVIDER_SCHEMAS].join(", ")})`).requiredOption("--name <name>", "Agent name (also used as default provider name)").option("--provider-name <name>", "Provider name override (default: <schema>-<name>)").option("--base-url <url>", "Provider base URL (required for most schemas)").option("--api-key <key>", "API key for the provider").option("--mode <mode>", "Trigger mode: turn-based (round-trip) or fire-and-forget", "turn-based").option("--reply-filter <filter>", "Reply filter: all | filtered", "all").option("--default-agent-id <id>", "Default agent ID (agno, openclaw)").option("--project-path <path>", "Project directory (claude-code)").option("--max-turns <n>", "Max conversation turns (claude-code)", Number.parseInt).option("--permission-mode <mode>", "Permission mode (claude-code)").option("--model <model>", "Model override").option("--system-prompt <prompt>", "System prompt (claude-code)").option("--agent-name <name>", "Agent identity (nats-genie)").option("--target-agent <name>", "Target agent inbox (nats-genie)").option("--team-name <template>", "Team name template (nats-genie)").option("--nats-url <url>", "NATS server URL (nats-genie, default: localhost:4222)").option("--webhook-url <url>", "Webhook endpoint (webhook)").action(async (options3) => {
+    await runSetupAgent(options3);
+  });
+  return setup;
+}
+async function runSetupAgent(options3) {
+  if (!PROVIDER_SCHEMAS.includes(options3.schema)) {
+    error(`Invalid --schema "${options3.schema}". Valid: ${[...PROVIDER_SCHEMAS].join(", ")}`);
+    return;
+  }
+  const client = getClient();
+  const instanceId = await resolveInstanceId(options3.instance);
+  const built = buildProviderConfig(options3);
+  if ("error" in built) {
+    error(built.error);
+    return;
+  }
+  const providerName = options3.providerName ?? `${options3.schema}-${options3.name}`;
+  info(`Creating ${options3.schema} provider "${providerName}"...`);
+  const providerId = await findOrCreateProvider(client, {
+    name: providerName,
+    schema: options3.schema,
+    baseUrl: built.baseUrl,
+    apiKey: built.apiKey,
+    schemaConfig: built.schemaConfig
+  });
+  if (!providerId)
+    return;
+  info(`Creating agent record "${options3.name}"...`);
+  const agentId = await findOrCreateAgent(client, {
+    name: options3.name,
+    providerId,
+    agentProvider: schemaToAgentProvider(options3.schema),
+    model: options3.model
+  });
+  if (!agentId)
+    return;
+  const triggerMode = options3.mode === "turn-based" ? "round-trip" : "fire-and-forget";
+  const agentReplyFilter = {
+    mode: options3.replyFilter,
+    conditions: { onDm: true, onMention: true, onReply: true, onNameMatch: false }
+  };
+  info("Updating instance agent assignment...");
+  try {
+    await client.instances.update(instanceId, {
+      agentId,
+      agentProviderId: providerId,
+      agentReplyFilter,
+      triggerMode
+    });
+  } catch (err2) {
+    const message2 = err2 instanceof Error ? err2.message : "Unknown error";
+    warn(`Could not update instance agent assignment: ${message2}`);
+    info(`Set manually: omni instances update ${instanceId} --agent-id ${agentId} --agent-provider-id ${providerId}`);
+    return;
+  }
+  info("Testing provider connectivity...");
+  let healthSummary;
+  try {
+    const health = await client.providers.checkHealth(providerId);
+    healthSummary = health.healthy ? `healthy (latency: ${health.latency}ms)` : `unhealthy \u2014 ${health.error ?? "unknown error"}`;
+    if (health.healthy) {
+      success(`Provider is healthy (latency: ${health.latency}ms)`);
+    } else {
+      warn(`Provider created but health check failed: ${health.error ?? "unknown error"}`);
+    }
+  } catch (err2) {
+    const message2 = err2 instanceof Error ? err2.message : "Unknown error";
+    healthSummary = `error \u2014 ${message2}`;
+    warn(`Health check errored: ${message2}`);
+  }
+  success(`Connected instance "${options3.instance}" to agent "${options3.name}".`);
+  header("Configuration Summary");
+  keyValue("Instance ID", instanceId);
+  keyValue("Schema", options3.schema);
+  keyValue("Provider ID", providerId);
+  keyValue("Agent ID", agentId);
+  keyValue("Reply Filter", options3.replyFilter);
+  keyValue("Trigger Mode", `${triggerMode} (--mode ${options3.mode})`);
+  keyValue("Health", healthSummary);
+}
+
+// src/commands/slack.ts
+init_output();
+function createSlackCommand() {
+  const cmd = new Command("slack").description("Slack-only operations: open a DM, search messages (#889)");
+  cmd.command("dm <instance> <userId>").description("Resolve the DM channel id for a Slack user (U\u2026). Idempotent.").action(async (instance3, userId) => {
+    try {
+      const instanceId = await resolveInstanceId(instance3);
+      const { channelId } = await getClient().slack.openDm(instanceId, userId);
+      success(`DM channel with ${userId}: ${channelId}`);
+      info(`Send with: omni send text ${instance3} ${channelId} "..."`);
+    } catch (err2) {
+      error(`Failed to open DM: ${err2 instanceof Error ? err2.message : "Unknown error"}`, undefined, 3);
+    }
+  });
+  cmd.command("search <instance> <query>").description("Search messages. Needs an instance in 'user' auth mode \u2014 a bot token cannot search.").option("--count <n>", "Results per page", "20").option("--page <n>", "Page number", "1").action(async (instance3, query, opts) => {
+    try {
+      const instanceId = await resolveInstanceId(instance3);
+      const matches = await getClient().slack.search(instanceId, query, {
+        count: Number(opts.count),
+        page: Number(opts.page)
+      });
+      if (matches.length === 0) {
+        info("No matches.");
+        return;
+      }
+      list(matches.map((m10) => ({
+        channel: String(m10.channelId ?? ""),
+        ts: String(m10.ts ?? ""),
+        from: String(m10.username ?? ""),
+        text: String(m10.text ?? "").slice(0, 80)
+      })));
+      info(`${matches.length} result(s), from the authorizing user's perspective.`);
+    } catch (err2) {
+      error(`Search failed: ${err2 instanceof Error ? err2.message : "Unknown error"}`, undefined, 3);
+    }
+  });
+  return cmd;
+}
+
 // src/commands/speak.ts
 import { writeFile as writeFile2 } from "fs/promises";
 init_output();
@@ -142627,6 +143117,18 @@ var COMMANDS = [
     helpGroup: "Management",
     helpDescription: "Idle-chat follow-up config (agents/instances/chats)"
   },
+  {
+    create: createScheduleCommand,
+    category: "core",
+    helpGroup: "Core",
+    helpDescription: "Schedule messages for later delivery"
+  },
+  {
+    create: createSlackCommand,
+    category: "advanced",
+    helpGroup: "Management",
+    helpDescription: "Slack-only: open a DM by user id, search messages"
+  },
   {
     create: createAgentsCommand,
     category: "core",
@@ -142645,6 +143147,12 @@ var COMMANDS = [
     helpGroup: "Management",
     helpDescription: "Connect instance to genie agent via NATS"
   },
+  {
+    create: createTopLevelSetupCommand,
+    category: "core",
+    helpGroup: "Management",
+    helpDescription: "Compound setup (agent \u2192 provider \u2192 instance, any schema)"
+  },
   {
     create: createRoutesCommand,
     category: "standard",