@automagik/omni 2.260429.4 → 2.260430.1

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.4",
+  version: "2.260430.1",
   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();