@automagik/omni 2.260429.5 → 2.260430.2

package/db/drizzle/0033_close_contact_logs.sql

@@ -0,0 +1,47 @@
+-- Close-contact endpoint audit table.
+--
+-- Records every agent→close-contact event with full payload. Written
+-- synchronously in the /messages/send/close-contact route so no data is
+-- lost. The route also reads this table at close-time to count recent
+-- rows for the same (chat_uuid, outcome) within the configured escalation
+-- window — that count drives the auto-promotion of soft outcomes to hard
+-- terminal (recorded back as `escalated = TRUE` on the new row). See the
+-- design doc at .genie/wishes/559-close-contact/design.md §6 + §8.1 for
+-- the loop-bound proof.
+--
+-- Hot path is the recent-count query, indexed on
+-- (chat_uuid, outcome, sent_at). Per-instance BI feed is indexed on
+-- (instance_id, sent_at). chat_id and agent_id get their own indexes for
+-- support drilldowns.
+--
+-- The `outcome` column is a varchar(32) free string at the DB level; the
+-- TypeScript layer constrains it to the `closeContactOutcomes` const array
+-- in `packages/db/src/schema.ts` (kept in sync with `CloseContactOutcome`
+-- in `@omni/core/events`). No CHECK constraint here so the BI/CRM tooling
+-- can extend the taxonomy without a migration.
+
+CREATE TABLE IF NOT EXISTS "close_contact_logs" (
+  "id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+  "instance_id" uuid REFERENCES "instances"("id") ON DELETE SET NULL,
+  "chat_uuid" uuid REFERENCES "chats"("id") ON DELETE SET NULL,
+  "chat_id" varchar(255) NOT NULL,
+  "to_phone" varchar(100) NOT NULL,
+  "text" text NOT NULL,
+  "outcome" varchar(32) NOT NULL,
+  "reason" text,
+  "close_fields" jsonb,
+  "agent_id" uuid REFERENCES "agents"("id") ON DELETE SET NULL,
+  "external_message_id" varchar(255),
+  "escalated" boolean NOT NULL DEFAULT false,
+  "sent_at" timestamp with time zone DEFAULT now() NOT NULL,
+  "metadata" jsonb
+);
+
+CREATE INDEX IF NOT EXISTS "close_contact_logs_chat_outcome_sent_at_idx"
+  ON "close_contact_logs" ("chat_uuid", "outcome", "sent_at");
+CREATE INDEX IF NOT EXISTS "close_contact_logs_instance_sent_at_idx"
+  ON "close_contact_logs" ("instance_id", "sent_at");
+CREATE INDEX IF NOT EXISTS "close_contact_logs_chat_id_idx"
+  ON "close_contact_logs" ("chat_id");
+CREATE INDEX IF NOT EXISTS "close_contact_logs_agent_idx"
+  ON "close_contact_logs" ("agent_id");

package/db/drizzle/meta/_journal.json

@@ -232,6 +232,13 @@
       "when": 1777500000000,
       "tag": "0032_genie_hosts",
       "breakpoints": true
+    },
+    {
+      "idx": 33,
+      "version": "7",
+      "when": 1777590000000,
+      "tag": "0033_close_contact_logs",
+      "breakpoints": true
     }
   ]
 }

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

@@ -1 +1 @@
-{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/commands/messages.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AA8M5C,wBAAgB,qBAAqB,IAAI,OAAO,CA2S/C"}
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/commands/messages.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AA8M5C,wBAAgB,qBAAqB,IAAI,OAAO,CA4T/C"}

package/dist/index.js

@@ -5755,6 +5755,7 @@ var init_types = __esm(() => {
     "chat.idle_timeout",
     "chat.handoff_activated",
     "chat.archived",
+    "chat.closed",
     "follow_up.armed",
     "follow_up.fired",
     "follow_up.skipped",
@@ -27730,7 +27731,8 @@ var init_follow_up = __esm(() => {
     "sequence_complete",
     "agent_error",
     "send_failed",
-    "session_cleared"
+    "session_cleared",
+    "contact_closed"
   ]);
   FixedScheduleSchema = exports_external.object({
     kind: exports_external.literal("fixed"),
@@ -58589,6 +58591,8 @@ __export(exports_schema, {
   contentTypes: () => contentTypes,
   consumerOffsets: () => consumerOffsets,
   conditionOperators: () => conditionOperators,
+  closeContactOutcomes: () => closeContactOutcomes,
+  closeContactLogs: () => closeContactLogs,
   chatsRelations: () => chatsRelations,
   chats: () => chats,
   chatTypes: () => chatTypes,
@@ -58632,7 +58636,7 @@ __export(exports_schema, {
   accessRules: () => accessRules,
   accessModes: () => accessModes
 });
-var channelTypes, agentTypes, agentSystems, agentEntityTypes, debounceMode, splitDelayMode, 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, persons, platformIdentities, conversations, chats, chatParticipants, omniGroups, messages, omniEvents, handoffLogs, 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;
+var channelTypes, agentTypes, agentSystems, agentEntityTypes, debounceMode, splitDelayMode, 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, persons, platformIdentities, conversations, chats, chatParticipants, omniGroups, messages, 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;
 var init_schema2 = __esm(() => {
   init_events();
   init_drizzle_orm();
@@ -59258,6 +59262,28 @@ var init_schema2 = __esm(() => {
     sentAtIdx: index("handoff_logs_sent_at_idx").on(table3.sentAt),
     agentIdx: index("handoff_logs_agent_idx").on(table3.agentId)
   }));
+  closeContactOutcomes = ["won", "lost", "redirected_sac", "unqualified", "no_response", "other"];
+  closeContactLogs = pgTable("close_contact_logs", {
+    id: uuid("id").primaryKey().defaultRandom(),
+    instanceId: uuid("instance_id").references(() => instances.id, { onDelete: "set null" }),
+    chatUuid: uuid("chat_uuid").references(() => chats.id, { onDelete: "set null" }),
+    chatId: varchar("chat_id", { length: 255 }).notNull(),
+    toPhone: varchar("to_phone", { length: 100 }).notNull(),
+    text: text("text").notNull(),
+    outcome: varchar("outcome", { length: 32 }).notNull().$type(),
+    reason: text("reason"),
+    closeFields: jsonb("close_fields").$type(),
+    agentId: uuid("agent_id").references(() => agents.id, { onDelete: "set null" }),
+    externalMessageId: varchar("external_message_id", { length: 255 }),
+    escalated: boolean("escalated").notNull().default(false),
+    sentAt: timestamp("sent_at", { withTimezone: true }).notNull().defaultNow(),
+    metadata: jsonb("metadata").$type()
+  }, (table3) => ({
+    chatOutcomeSentAtIdx: index("close_contact_logs_chat_outcome_sent_at_idx").on(table3.chatUuid, table3.outcome, table3.sentAt),
+    instanceSentAtIdx: index("close_contact_logs_instance_sent_at_idx").on(table3.instanceId, table3.sentAt),
+    chatIdIdx: index("close_contact_logs_chat_id_idx").on(table3.chatId),
+    agentIdx: index("close_contact_logs_agent_idx").on(table3.agentId)
+  }));
   accessRules = pgTable("access_rules", {
     id: uuid("id").primaryKey().defaultRandom(),
     instanceId: uuid("instance_id").references(() => instances.id, { onDelete: "cascade" }),
@@ -59892,7 +59918,8 @@ var init_schema2 = __esm(() => {
     "sequence_complete",
     "agent_error",
     "send_failed",
-    "session_cleared"
+    "session_cleared",
+    "contact_closed"
   ];
   chatFollowUpState = pgTable("chat_follow_up_state", {
     id: uuid("id").primaryKey().defaultRandom(),
@@ -113953,7 +113980,7 @@ import { fileURLToPath } from "url";
 // package.json
 var package_default = {
   name: "@automagik/omni",
-  version: "2.260429.5",
+  version: "2.260430.2",
   description: "LLM-optimized CLI for Omni",
   type: "module",
   bin: {
@@ -122464,8 +122491,77 @@ function createMessagesCommand() {
       error(`Failed to edit message: ${message2}`);
     }
   });
+  messages3.command("close-contact").description("Close a chat terminally (won/lost) or with a soft cooldown (redirected_sac/unqualified/no_response/other)").requiredOption("--instance <id>", "Instance ID").requiredOption("--chat <chatId>", "Chat DB UUID to close").requiredOption("--to <recipient>", "Recipient phone or platform ID").requiredOption("--text <text>", "Farewell message shown to the lead").requiredOption("--outcome <outcome>", "Outcome: won | lost | redirected_sac | unqualified | no_response | other").option("--reason <reason>", "Free-text rationale persisted in close_contact_logs").option("--close-fields <jsonOrPath>", "Structured BI/CRM payload \u2014 inline JSON or path to a JSON file").action(handleCloseContact);
   return messages3;
 }
+var VALID_CLOSE_OUTCOMES = ["won", "lost", "redirected_sac", "unqualified", "no_response", "other"];
+async function parseCloseFields(raw2) {
+  const trimmed = raw2.trim();
+  if (trimmed.startsWith("{")) {
+    return JSON.parse(trimmed);
+  }
+  const fs2 = await import("fs/promises");
+  const text3 = await fs2.readFile(trimmed, "utf-8");
+  return JSON.parse(text3);
+}
+async function postCloseContact(body) {
+  const _cfg = (await Promise.resolve().then(() => (init_config(), exports_config))).loadConfig();
+  const baseUrl = _cfg.apiUrl ?? "http://localhost:8882";
+  const apiKey = _cfg.apiKey ?? "";
+  const resp = await fetch(`${baseUrl}/api/v2/messages/send/close-contact`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json", "x-api-key": apiKey },
+    body: JSON.stringify(body)
+  });
+  if (!resp.ok) {
+    const err2 = await resp.json().catch(() => ({}));
+    const errMsg = typeof err2.error === "string" ? err2.error : err2.error?.message ?? `API error: ${resp.status}`;
+    throw new Error(errMsg);
+  }
+  const data2 = await resp.json();
+  return data2.data ?? {};
+}
+async function buildCloseContactBody(options) {
+  let closeFields;
+  if (options.closeFields) {
+    try {
+      closeFields = await parseCloseFields(options.closeFields);
+    } catch (err2) {
+      error(`Failed to parse --close-fields: ${err2 instanceof Error ? err2.message : "Unknown error"}`);
+      return null;
+    }
+  }
+  const instanceId = await resolveInstanceId(options.instance);
+  const resolvedChatId = await resolveChatId(options.chat);
+  const body = {
+    instanceId,
+    chatId: resolvedChatId,
+    to: options.to,
+    text: options.text,
+    outcome: options.outcome
+  };
+  if (options.reason)
+    body.reason = options.reason;
+  if (closeFields)
+    body.closeFields = closeFields;
+  return body;
+}
+async function handleCloseContact(options) {
+  if (!VALID_CLOSE_OUTCOMES.includes(options.outcome)) {
+    error(`Invalid --outcome '${options.outcome}'. Must be one of: ${VALID_CLOSE_OUTCOMES.join(", ")}`);
+    return;
+  }
+  try {
+    const body = await buildCloseContactBody(options);
+    if (!body)
+      return;
+    const result = await postCloseContact(body);
+    const cooldownPart = result.closeUntil ? `, closeUntil=${result.closeUntil}` : "";
+    success(`Chat closed (${options.outcome}): terminal=${result.terminal ?? false}, escalated=${result.escalated ?? false}${cooldownPart}`);
+  } catch (err2) {
+    error(`Failed to close contact: ${err2 instanceof Error ? err2.message : "Unknown error"}`);
+  }
+}
 
 // src/commands/open.ts
 init_output();

package/dist/server/index.js

@@ -181,6 +181,7 @@ var init_types2 = __esm(() => {
     "chat.idle_timeout",
     "chat.handoff_activated",
     "chat.archived",
+    "chat.closed",
     "follow_up.armed",
     "follow_up.fired",
     "follow_up.skipped",
@@ -22074,7 +22075,8 @@ var init_follow_up = __esm(() => {
     "sequence_complete",
     "agent_error",
     "send_failed",
-    "session_cleared"
+    "session_cleared",
+    "contact_closed"
   ]);
   FixedScheduleSchema = exports_external.object({
     kind: exports_external.literal("fixed"),
@@ -224554,7 +224556,7 @@ var init_sentry_scrub = __esm(() => {
 var require_package8 = __commonJS((exports, module) => {
   module.exports = {
     name: "@omni/api",
-    version: "2.260429.5",
+    version: "2.260430.2",
     type: "module",
     exports: {
       ".": {
@@ -229981,6 +229983,8 @@ __export(exports_schema, {
   contentTypes: () => contentTypes,
   consumerOffsets: () => consumerOffsets,
   conditionOperators: () => conditionOperators,
+  closeContactOutcomes: () => closeContactOutcomes,
+  closeContactLogs: () => closeContactLogs,
   chatsRelations: () => chatsRelations,
   chats: () => chats,
   chatTypes: () => chatTypes,
@@ -230024,7 +230028,7 @@ __export(exports_schema, {
   accessRules: () => accessRules,
   accessModes: () => accessModes
 });
-var channelTypes, agentTypes, agentSystems, agentEntityTypes, debounceMode, splitDelayMode, 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, persons, platformIdentities, conversations, chats, chatParticipants, omniGroups, messages2, omniEvents, handoffLogs, 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;
+var channelTypes, agentTypes, agentSystems, agentEntityTypes, debounceMode, splitDelayMode, 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, 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;
 var init_schema2 = __esm(() => {
   init_events();
   init_drizzle_orm();
@@ -230650,6 +230654,28 @@ var init_schema2 = __esm(() => {
     sentAtIdx: index("handoff_logs_sent_at_idx").on(table3.sentAt),
     agentIdx: index("handoff_logs_agent_idx").on(table3.agentId)
   }));
+  closeContactOutcomes = ["won", "lost", "redirected_sac", "unqualified", "no_response", "other"];
+  closeContactLogs = pgTable("close_contact_logs", {
+    id: uuid("id").primaryKey().defaultRandom(),
+    instanceId: uuid("instance_id").references(() => instances.id, { onDelete: "set null" }),
+    chatUuid: uuid("chat_uuid").references(() => chats.id, { onDelete: "set null" }),
+    chatId: varchar("chat_id", { length: 255 }).notNull(),
+    toPhone: varchar("to_phone", { length: 100 }).notNull(),
+    text: text("text").notNull(),
+    outcome: varchar("outcome", { length: 32 }).notNull().$type(),
+    reason: text("reason"),
+    closeFields: jsonb("close_fields").$type(),
+    agentId: uuid("agent_id").references(() => agents.id, { onDelete: "set null" }),
+    externalMessageId: varchar("external_message_id", { length: 255 }),
+    escalated: boolean("escalated").notNull().default(false),
+    sentAt: timestamp("sent_at", { withTimezone: true }).notNull().defaultNow(),
+    metadata: jsonb("metadata").$type()
+  }, (table3) => ({
+    chatOutcomeSentAtIdx: index("close_contact_logs_chat_outcome_sent_at_idx").on(table3.chatUuid, table3.outcome, table3.sentAt),
+    instanceSentAtIdx: index("close_contact_logs_instance_sent_at_idx").on(table3.instanceId, table3.sentAt),
+    chatIdIdx: index("close_contact_logs_chat_id_idx").on(table3.chatId),
+    agentIdx: index("close_contact_logs_agent_idx").on(table3.agentId)
+  }));
   accessRules = pgTable("access_rules", {
     id: uuid("id").primaryKey().defaultRandom(),
     instanceId: uuid("instance_id").references(() => instances.id, { onDelete: "cascade" }),
@@ -231284,7 +231310,8 @@ var init_schema2 = __esm(() => {
     "sequence_complete",
     "agent_error",
     "send_failed",
-    "session_cleared"
+    "session_cleared",
+    "contact_closed"
   ];
   chatFollowUpState = pgTable("chat_follow_up_state", {
     id: uuid("id").primaryKey().defaultRandom(),
@@ -240539,7 +240566,7 @@ async function verifySignature3(opts) {
   if (!ok) {
     return { status: "invalid", reason: "signature does not verify under registered pubkey" };
   }
-  return { status: "verified", hostId: host.id };
+  return { status: "verified", hostId: host.id, hostScopes: host.scopes };
 }
 function pathFromRequest(url) {
   return `${url.pathname}${url.search}`;
@@ -240576,7 +240603,7 @@ var init_genie_signature = __esm(() => {
       now: Date.now(),
       findHost: async (id) => {
         const host = await services.genieHosts.findById(id);
-        return host ? { id: host.id, pubkey: host.pubkey, revokedAt: host.revokedAt } : null;
+        return host ? { id: host.id, pubkey: host.pubkey, revokedAt: host.revokedAt, scopes: host.scopes ?? ["*"] } : null;
       }
     });
     if (outcome.status === "invalid") {
@@ -240595,6 +240622,9 @@ var init_genie_signature = __esm(() => {
     }
     if (outcome.status === "verified" && outcome.hostId) {
       c.set("signedBy", outcome.hostId);
+      if (outcome.hostScopes) {
+        c.set("signedByScopes", outcome.hostScopes);
+      }
       services.genieHosts.touchLastSeen(outcome.hostId).catch((err) => {
         log58.warn("touchLastSeen failed (non-fatal)", { hostId: outcome.hostId, err: String(err) });
       });
@@ -241314,9 +241344,12 @@ var init_scope_enforcer = __esm(() => {
     }
     const method = c.req.method.toUpperCase();
     const path3 = c.req.path;
+    const signedBy = c.get("signedBy");
+    const signedByScopes = c.get("signedByScopes");
     const wildcard = ApiKeyService.scopeAllows(apiKey.scopes, "*");
+    let requiredScope;
     if (!wildcard) {
-      const requiredScope = findRequiredScope(method, path3);
+      requiredScope = findRequiredScope(method, path3);
       if (!requiredScope) {
         log60.warn(`DENIED: key=${apiKey.id} route=${method} ${path3} required=UNMAPPED`);
         return c.json({
@@ -241336,6 +241369,31 @@ var init_scope_enforcer = __esm(() => {
         }, 403);
       }
     }
+    if (signedBy && signedByScopes) {
+      const hostWildcard = ApiKeyService.scopeAllows(signedByScopes, "*");
+      if (!hostWildcard) {
+        const needed = requiredScope ?? findRequiredScope(method, path3);
+        if (!needed) {
+          log60.warn(`DENIED: signedBy=${signedBy} route=${method} ${path3} required=UNMAPPED`);
+          return c.json({
+            error: {
+              code: "FORBIDDEN",
+              message: "Insufficient permissions. Route not mapped in scope policy."
+            }
+          }, 403);
+        }
+        if (!ApiKeyService.scopeAllows(signedByScopes, needed)) {
+          log60.warn(`DENIED: signedBy=${signedBy} route=${method} ${path3} required=${needed} host-scopes=${signedByScopes.join(",")}`);
+          return c.json({
+            error: {
+              code: "FORBIDDEN",
+              message: `Insufficient permissions for signing host. Required scope: ${needed}`,
+              host: signedBy
+            }
+          }, 403);
+        }
+      }
+    }
     const body = await safeReadJsonBody(c);
     const targets = extractLockTargets(method, path3, body);
     const instanceResult = enforceInstanceAllowlist(apiKey, targets.instance);
@@ -284644,6 +284702,55 @@ async function dispatchToAgent(services, instance4, msgs, triggerType, channel4,
   });
   await dispatchViaLegacy(services, instance4, msgs, triggerType, channel4, chatId, senderId, personId, senderName, traceId, perThreadExtraContext, senderAgentId);
 }
+async function applyCloseContactGate(services, chatRecordId, instanceId, chatId, chatSettings) {
+  if (chatSettings?.closed === true) {
+    log94.debug("Chat closed (terminal), skipping dispatch", {
+      instanceId,
+      chatId,
+      outcome: chatSettings.closeOutcome ?? null
+    });
+    return "skip";
+  }
+  if (!chatSettings?.closeUntil)
+    return "pass";
+  const closeUntilMs = new Date(chatSettings.closeUntil).getTime();
+  if (!Number.isFinite(closeUntilMs))
+    return "pass";
+  if (Date.now() < closeUntilMs) {
+    log94.debug("Chat in close cooldown, skipping dispatch", {
+      instanceId,
+      chatId,
+      closeUntil: chatSettings.closeUntil,
+      outcome: chatSettings.closeOutcome ?? null
+    });
+    return "skip";
+  }
+  if (!chatRecordId)
+    return "pass";
+  try {
+    await services.chats.update(chatRecordId, {
+      settings: {
+        ...chatSettings,
+        agentPaused: false,
+        closeUntil: null,
+        agentResumedAt: new Date().toISOString()
+      }
+    });
+    log94.info("Close cooldown expired, agent reopened", {
+      instanceId,
+      chatId,
+      closeOutcome: chatSettings.closeOutcome ?? null
+    });
+    return "reopened";
+  } catch (err) {
+    log94.warn("Failed to flip close cooldown state, deferring dispatch", {
+      instanceId,
+      chatId,
+      error: String(err)
+    });
+    return "skip";
+  }
+}
 async function processAgentResponse(services, instance4, messages4, triggerType, db2, eventBus) {
   const firstMessage = messages4[0];
   if (!firstMessage)
@@ -284664,7 +284771,12 @@ async function processAgentResponse(services, instance4, messages4, triggerType,
   }
   const chatRecord = await services.chats.findByExternalIdSmart(instance4.id, chatId);
   const chatSettings = chatRecord?.settings;
-  const isAgentPaused = chatSettings?.agentPaused === true;
+  const gateResult = await applyCloseContactGate(services, chatRecord?.id ?? null, instance4.id, chatId, chatSettings);
+  if (gateResult === "skip") {
+    ackHandle.remove();
+    return;
+  }
+  const isAgentPaused = chatSettings?.agentPaused === true && gateResult !== "reopened";
   if (isAgentPaused) {
     log94.debug("Agent paused (handoff active), skipping dispatch", { instanceId: instance4.id, chatId });
     ackHandle.remove();
@@ -287129,7 +287241,8 @@ function createServices(db2, eventBus) {
     consumerOffsets: new ConsumerOffsetService(db2),
     followUpLifecycle: new FollowUpLifecycleService(db2, eventBus),
     followUpSweeper: new FollowUpSweeperService(db2, eventBus),
-    genieHosts: new GenieHostsService(db2)
+    genieHosts: new GenieHostsService(db2),
+    eventBus
   };
 }
 var init_services = __esm(() => {
@@ -295152,6 +295265,34 @@ var init_chats2 = __esm(() => {
     } catch {}
     return c.json({ success: true, sessionId, sessionStrategy });
   });
+  chatsRoutes.post("/:id/reopen-contact", async (c) => {
+    const id = c.req.param("id");
+    const services = c.get("services");
+    const chat2 = await services.chats.getById(id);
+    if (!chat2)
+      return c.json({ error: "Chat not found" }, 404);
+    if (chat2.instanceId)
+      checkInstanceAccess(c.get("apiKey"), chat2.instanceId);
+    const priorSettings = chat2.settings ?? {};
+    const wasClosed = priorSettings.closed === true || priorSettings.closeUntil != null;
+    await services.chats.update(id, {
+      settings: {
+        ...priorSettings,
+        agentPaused: false,
+        closed: false,
+        closeUntil: null,
+        closeOutcome: null,
+        agentResumedAt: new Date().toISOString()
+      }
+    });
+    return c.json({
+      data: {
+        chatId: id,
+        reopened: true,
+        wasClosed
+      }
+    });
+  });
 });
 
 // ../api/src/routes/v2/context.ts
@@ -300017,6 +300158,38 @@ var init_media = __esm(() => {
   });
 });
 
+// ../api/src/routes/v2/_close-contact-config.ts
+function resolveCloseContactConfig(outcome, instanceSettings) {
+  const override = instanceSettings?.closeContactConfig;
+  const def = DEFAULT_CLOSE_CONTACT_CONFIG[outcome];
+  if (!override || typeof override !== "object")
+    return def;
+  const ovr = override[outcome];
+  if (!ovr || typeof ovr !== "object")
+    return def;
+  return {
+    cooldownMs: typeof ovr.cooldownMs === "number" || ovr.cooldownMs === null ? ovr.cooldownMs : def.cooldownMs,
+    escalationThreshold: typeof ovr.escalationThreshold === "number" || ovr.escalationThreshold === null ? ovr.escalationThreshold : def.escalationThreshold,
+    escalationWindowMs: typeof ovr.escalationWindowMs === "number" || ovr.escalationWindowMs === null ? ovr.escalationWindowMs : def.escalationWindowMs
+  };
+}
+function isHardTerminalOutcome(outcome) {
+  return outcome === "won" || outcome === "lost";
+}
+var HOUR, DAY, DEFAULT_CLOSE_CONTACT_CONFIG;
+var init__close_contact_config = __esm(() => {
+  HOUR = 60 * 60 * 1000;
+  DAY = 24 * HOUR;
+  DEFAULT_CLOSE_CONTACT_CONFIG = {
+    won: { cooldownMs: null, escalationThreshold: null, escalationWindowMs: null },
+    lost: { cooldownMs: null, escalationThreshold: null, escalationWindowMs: null },
+    redirected_sac: { cooldownMs: 24 * HOUR, escalationThreshold: 2, escalationWindowMs: 7 * DAY },
+    unqualified: { cooldownMs: 7 * DAY, escalationThreshold: 3, escalationWindowMs: 30 * DAY },
+    no_response: { cooldownMs: 48 * HOUR, escalationThreshold: 3, escalationWindowMs: 30 * DAY },
+    other: { cooldownMs: 24 * HOUR, escalationThreshold: 2, escalationWindowMs: 14 * DAY }
+  };
+});
+
 // ../api/src/routes/v2/messages.ts
 import { existsSync as existsSync8 } from "fs";
 import { join as join24 } from "path";
@@ -300143,6 +300316,27 @@ async function resolveMessageFromRef(services, ref) {
   }
   return found;
 }
+async function computeCloseContactTerminalState(db2, chatUuid, outcome, auditRowId) {
+  const cfg = resolveCloseContactConfig(outcome, null);
+  if (isHardTerminalOutcome(outcome)) {
+    return { terminal: true, escalated: false, closeUntil: null };
+  }
+  if (cfg.escalationThreshold === null || cfg.escalationWindowMs === null) {
+    const closeUntil2 = cfg.cooldownMs !== null ? new Date(Date.now() + cfg.cooldownMs) : null;
+    return { terminal: false, escalated: false, closeUntil: closeUntil2 };
+  }
+  const windowStart = new Date(Date.now() - cfg.escalationWindowMs);
+  const recent = await db2.select({ count: sql`count(*)::int` }).from(closeContactLogs).where(and2(eq(closeContactLogs.chatUuid, chatUuid), eq(closeContactLogs.outcome, outcome), gte(closeContactLogs.sentAt, windowStart)));
+  const recentCount = Number(recent[0]?.count ?? 0);
+  if (recentCount >= cfg.escalationThreshold) {
+    if (auditRowId) {
+      await db2.update(closeContactLogs).set({ escalated: true }).where(eq(closeContactLogs.id, auditRowId));
+    }
+    return { terminal: true, escalated: true, closeUntil: null };
+  }
+  const closeUntil = cfg.cooldownMs !== null ? new Date(Date.now() + cfg.cooldownMs) : null;
+  return { terminal: false, escalated: false, closeUntil };
+}
 async function verifyMessageInstanceOwnership(services, message2, instanceId) {
   if (!message2.chatId)
     return;
@@ -300156,19 +300350,21 @@ async function verifyMessageInstanceOwnership(services, message2, instanceId) {
     });
   }
 }
-var log105, mediaDownloadLog, messagesRoutes, UUID_REGEX, MessageSourceSchema, MessageTypeSchema, MessageStatusSchema, DeliveryStatusSchema, listQuerySchema13, createMessageSchema, updateMessageSchema, recordEditSchema, addReactionSchema, removeReactionSchema, updateDeliveryStatusSchema, MentionSchema, sendTextSchema, sendMediaSchema, sendReactionSchema, sendStickerSchema, sendContactSchema, sendLocationSchema, sendHandoffSchema, messageRefSchema, _mediaStorageForDownload = null, sendTtsSchema, forwardMessageSchema, sendPresenceSchema, markMessageReadSchema, markBatchReadSchema, sendPollSchema, sendEmbedSchema, editMessageChannelSchema, deleteMessageChannelSchema, starMessageSchema;
+var log105, mediaDownloadLog, messagesRoutes, UUID_REGEX, MessageSourceSchema, MessageTypeSchema, MessageStatusSchema, DeliveryStatusSchema, listQuerySchema13, createMessageSchema, updateMessageSchema, recordEditSchema, addReactionSchema, removeReactionSchema, updateDeliveryStatusSchema, MentionSchema, sendTextSchema, sendMediaSchema, sendReactionSchema, sendStickerSchema, sendContactSchema, sendLocationSchema, sendHandoffSchema, sendCloseContactSchema, messageRefSchema, _mediaStorageForDownload = null, sendTtsSchema, forwardMessageSchema, sendPresenceSchema, markMessageReadSchema, markBatchReadSchema, sendPollSchema, sendEmbedSchema, editMessageChannelSchema, deleteMessageChannelSchema, starMessageSchema;
 var init_messages5 = __esm(() => {
   init_dist6();
   init_src2();
   init_src();
   init_src5();
   init_esm5();
+  init_drizzle_orm();
   init_dist2();
   init_zod();
   init_sentry_scrub();
   init_date_query();
   init_api_keys();
   init_media_storage();
+  init__close_contact_config();
   log105 = createLogger("routes:messages");
   mediaDownloadLog = createLogger("routes:messages:media-download");
   messagesRoutes = new Hono2;
@@ -300330,6 +300526,15 @@ var init_messages5 = __esm(() => {
     extraInfo: exports_external.string().optional().describe("Free-text briefing (legacy \u2014 prefer dadosLead)"),
     handoffFields: exports_external.record(exports_external.unknown()).optional().describe("Structured fields for Gupshup flow variables (e.g. nome, cidade, temperatura_lead)")
   });
+  sendCloseContactSchema = exports_external.object({
+    instanceId: exports_external.string().uuid().describe("Instance ID \u2014 close-contact native send is Gupshup-only in v1"),
+    chatId: exports_external.string().min(1).describe("Chat DB UUID to mark as closed"),
+    to: exports_external.string().min(1).describe("Recipient phone or platform ID"),
+    text: exports_external.string().min(1).describe("Farewell message shown to the lead"),
+    outcome: exports_external.enum(["won", "lost", "redirected_sac", "unqualified", "no_response", "other"]).describe("Drives terminal/cooldown/escalation logic and BI/audit trail"),
+    reason: exports_external.string().optional().describe("Free-text rationale persisted in close_contact_logs"),
+    closeFields: exports_external.record(exports_external.unknown()).optional().describe("Structured BI/CRM payload \u2014 forwarded to Gupshup native send when supported")
+  });
   messagesRoutes.get("/", zValidator("query", listQuerySchema13), async (c) => {
     const query = c.req.valid("query");
     const services = c.get("services");
@@ -301048,6 +301253,109 @@ var init_messages5 = __esm(() => {
       }
     }, 201);
   });
+  messagesRoutes.post("/send/close-contact", zValidator("json", sendCloseContactSchema), async (c) => {
+    const data = c.req.valid("json");
+    const services = c.get("services");
+    const db2 = c.get("db");
+    const channelRegistry2 = c.get("channelRegistry");
+    checkInstanceAccess2(c.get("apiKey"), data.instanceId);
+    const instance4 = await services.instances.getById(data.instanceId);
+    if (!channelRegistry2) {
+      throw new OmniError({
+        code: ERROR_CODES.CHANNEL_NOT_CONNECTED,
+        message: "Channel registry not available",
+        recoverable: false
+      });
+    }
+    const plugin7 = channelRegistry2.get(instance4.channel);
+    if (!plugin7) {
+      throw new OmniError({
+        code: ERROR_CODES.CHANNEL_NOT_CONNECTED,
+        message: `No plugin found for channel: ${instance4.channel}`,
+        context: { channelType: instance4.channel },
+        recoverable: false
+      });
+    }
+    const resolvedTo = await resolveRecipient(data.to, instance4.channel, services);
+    const hasNativeClose = plugin7.capabilities?.canCloseContact === true;
+    const outcome = data.outcome;
+    let channelSendResult = null;
+    if (hasNativeClose) {
+      const outgoingMessage = {
+        to: resolvedTo,
+        content: { type: "text", text: data.text },
+        metadata: {
+          isCloseContact: true,
+          closeReason: data.reason,
+          closeOutcome: outcome,
+          closeFields: data.closeFields
+        }
+      };
+      channelSendResult = await plugin7.sendMessage(data.instanceId, outgoingMessage);
+      handleSendResult(channelSendResult, {
+        channelType: instance4.channel,
+        instanceId: data.instanceId,
+        operation: "send close-contact"
+      });
+    }
+    const [auditRow] = await db2.insert(closeContactLogs).values({
+      instanceId: data.instanceId,
+      chatUuid: data.chatId,
+      chatId: resolvedTo,
+      toPhone: resolvedTo,
+      text: data.text,
+      outcome,
+      reason: data.reason ?? null,
+      closeFields: data.closeFields ?? null,
+      agentId: instance4.agentId ?? null,
+      externalMessageId: channelSendResult?.messageId ?? null,
+      escalated: false,
+      sentAt: new Date,
+      metadata: {
+        instanceChannel: instance4.channel,
+        channelCloseSupported: hasNativeClose
+      }
+    }).returning();
+    const { terminal, escalated, closeUntil } = await computeCloseContactTerminalState(db2, data.chatId, outcome, auditRow?.id ?? null);
+    const closedAt = new Date;
+    await services.chats.update(data.chatId, {
+      settings: {
+        agentPaused: true,
+        closed: terminal,
+        closeUntil: closeUntil?.toISOString() ?? null,
+        closeOutcome: outcome
+      }
+    });
+    await services.followUpLifecycle.disarm({
+      chatId: data.chatId,
+      instanceId: data.instanceId,
+      reason: "contact_closed"
+    });
+    if (services.eventBus) {
+      const payload = {
+        chatId: data.chatId,
+        instanceId: data.instanceId,
+        agentId: instance4.agentId ?? null,
+        outcome,
+        reason: data.reason ?? null,
+        escalated: terminal,
+        closedFields: data.closeFields ?? null,
+        closedAt: closedAt.toISOString()
+      };
+      services.eventBus.publish("chat.closed", payload, { instanceId: data.instanceId }).catch((err) => log105.debug("Failed to publish chat.closed", { error: String(err) }));
+    }
+    return c.json({
+      data: {
+        messageId: channelSendResult?.messageId ?? null,
+        status: "closed",
+        terminal,
+        closeUntil: closeUntil?.toISOString() ?? null,
+        escalated,
+        outcome,
+        timestamp: channelSendResult?.timestamp ?? closedAt.getTime()
+      }
+    }, 201);
+  });
   messagesRoutes.get("/tts/voices", async (c) => {
     const services = c.get("services");
     const voices = await services.tts.listVoices();
@@ -304570,7 +304878,22 @@ async function setupFollowUpHooks(eventBus, services) {
       retryDelayMs: 500,
       startFrom: "new"
     });
-    log109.info("Follow-up hooks active (message.sent/received, chat.handoff_activated, chat.archived)");
+    await eventBus.subscribe("chat.closed", async (event) => {
+      const payload = event.payload;
+      await services.followUpLifecycle.disarm({
+        chatId: payload.chatId,
+        instanceId: payload.instanceId,
+        agentId: payload.agentId ?? null,
+        reason: "contact_closed"
+      });
+    }, {
+      durable: "follow-up-hooks-closed",
+      queue: "follow-up-hooks",
+      maxRetries: 2,
+      retryDelayMs: 500,
+      startFrom: "new"
+    });
+    log109.info("Follow-up hooks active (message.sent/received, chat.handoff_activated, chat.archived, chat.closed)");
   } catch (error2) {
     log109.error("Failed to set up follow-up hooks", { error: String(error2) });
   }
@@ -309561,6 +309884,7 @@ var GUPSHUP_CAPABILITIES = {
   canReplyToMessage: true,
   canForwardMessage: false,
   canHandoff: true,
+  canCloseContact: true,
   canSendContact: false,
   canSendLocation: true,
   canSendSticker: true,
@@ -310028,6 +310352,18 @@ function extractContent2(msg) {
   return null;
 }
 
+// ../channel-gupshup/src/senders/close-contact.ts
+var GUPSHUP_CLOSE_MSG_TYPE = "CLOSING";
+async function sendCloseContact(client, to, text, closeReason, closeOutcome, closeFields) {
+  return client.send(to, {
+    type: GUPSHUP_CLOSE_MSG_TYPE,
+    text,
+    close_reason: closeReason,
+    close_outcome: closeOutcome,
+    close_fields: closeFields
+  });
+}
+
 // ../channel-gupshup/src/senders/handoff.ts
 async function sendHandoff(client, to, text, dadosLead, motivoHandoff, handoffFields) {
   return client.send(to, {
@@ -310100,6 +310436,12 @@ async function dispatchContent(client, dest, message2) {
     const handoffFields = meta.handoffFields;
     return sendHandoff(client, dest, content.text ?? "", dadosLead, motivoHandoff, handoffFields);
   }
+  if (meta?.isCloseContact === true) {
+    const closeReason = meta.closeReason;
+    const closeOutcome = meta.closeOutcome;
+    const closeFields = meta.closeFields;
+    return sendCloseContact(client, dest, content.text ?? "", closeReason, closeOutcome, closeFields);
+  }
   if (content.type === "text") {
     return sendText(client, dest, content.text ?? "");
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automagik/omni",
-  "version": "2.260429.5",
+  "version": "2.260430.2",
   "description": "LLM-optimized CLI for Omni",
   "type": "module",
   "bin": {
@@ -50,15 +50,15 @@
     "qrcode-terminal": "^0.12.0"
   },
   "devDependencies": {
-    "@omni/api": "2.260429.4",
-    "@omni/channel-discord": "2.260429.4",
-    "@omni/channel-gupshup": "2.260429.4",
-    "@omni/channel-sdk": "2.260429.4",
-    "@omni/channel-slack": "2.260429.4",
-    "@omni/channel-telegram": "2.260429.4",
-    "@omni/channel-whatsapp": "2.260429.4",
-    "@omni/core": "2.260429.4",
-    "@omni/sdk": "2.260429.4",
+    "@omni/api": "2.260430.1",
+    "@omni/channel-discord": "2.260430.1",
+    "@omni/channel-gupshup": "2.260430.1",
+    "@omni/channel-sdk": "2.260430.1",
+    "@omni/channel-slack": "2.260430.1",
+    "@omni/channel-telegram": "2.260430.1",
+    "@omni/channel-whatsapp": "2.260430.1",
+    "@omni/core": "2.260430.1",
+    "@omni/sdk": "2.260430.1",
     "@types/node": "^22.10.3",
     "@types/qrcode-terminal": "^0.12.2",
     "typescript": "^5.7.3"