@automagik/omni 2.260902.5 → 2.260903.2

package/dist/server/index.js

@@ -68655,7 +68655,7 @@ var require_ClientVoiceManager = __commonJS((exports, module) => {
 
 // ../../node_modules/.bun/@discordjs+ws@1.2.3/node_modules/@discordjs/ws/dist/index.js
 var require_dist9 = __commonJS((exports, module) => {
-  var __dirname = "/home/runner/work/omni/omni/.stable-source/node_modules/.bun/@discordjs+ws@1.2.3/node_modules/@discordjs/ws/dist";
+  var __dirname = "/home/runner/work/omni/omni/node_modules/.bun/@discordjs+ws@1.2.3/node_modules/@discordjs/ws/dist";
   var __create2 = Object.create;
   var __defProp2 = Object.defineProperty;
   var __getOwnPropDesc2 = Object.getOwnPropertyDescriptor;
@@ -132634,12 +132634,12 @@ var require_minimal = __commonJS((exports) => {
   util3.newError = newError;
   util3.ProtocolError = newError("ProtocolError");
   util3.oneOfGetter = function getOneOf(fieldNames) {
-    var fieldMap = {};
+    var fieldMap2 = {};
     for (var i = 0;i < fieldNames.length; ++i)
-      fieldMap[fieldNames[i]] = 1;
+      fieldMap2[fieldNames[i]] = 1;
     return function() {
       for (var keys = Object.keys(this), i2 = keys.length - 1;i2 > -1; --i2)
-        if (fieldMap[keys[i2]] === 1 && this[keys[i2]] !== undefined && this[keys[i2]] !== null)
+        if (fieldMap2[keys[i2]] === 1 && this[keys[i2]] !== undefined && this[keys[i2]] !== null)
           return keys[i2];
     };
   };
@@ -135823,12 +135823,12 @@ var require_minimal2 = __commonJS((exports) => {
   util3.newError = newError;
   util3.ProtocolError = newError("ProtocolError");
   util3.oneOfGetter = function getOneOf(fieldNames) {
-    var fieldMap = {};
+    var fieldMap2 = {};
     for (var i = 0;i < fieldNames.length; ++i)
-      fieldMap[fieldNames[i]] = 1;
+      fieldMap2[fieldNames[i]] = 1;
     return function() {
       for (var keys = Object.keys(this), i2 = keys.length - 1;i2 > -1; --i2)
-        if (fieldMap[keys[i2]] === 1 && this[keys[i2]] !== undefined && this[keys[i2]] !== null)
+        if (fieldMap2[keys[i2]] === 1 && this[keys[i2]] !== undefined && this[keys[i2]] !== null)
           return keys[i2];
     };
   };
@@ -153935,7 +153935,7 @@ var require_indexes = __commonJS((exports, module) => {
 
 // ../../node_modules/.bun/thread-stream@3.1.0/node_modules/thread-stream/index.js
 var require_thread_stream = __commonJS((exports, module) => {
-  var __dirname = "/home/runner/work/omni/omni/.stable-source/node_modules/.bun/thread-stream@3.1.0/node_modules/thread-stream";
+  var __dirname = "/home/runner/work/omni/omni/node_modules/.bun/thread-stream@3.1.0/node_modules/thread-stream";
   var { version } = require_package5();
   var { EventEmitter: EventEmitter3 } = __require("events");
   var { Worker } = __require("worker_threads");
@@ -154356,7 +154356,7 @@ var require_thread_stream = __commonJS((exports, module) => {
 
 // ../../node_modules/.bun/pino@9.14.0/node_modules/pino/lib/transport.js
 var require_transport2 = __commonJS((exports, module) => {
-  var __dirname = "/home/runner/work/omni/omni/.stable-source/node_modules/.bun/pino@9.14.0/node_modules/pino/lib";
+  var __dirname = "/home/runner/work/omni/omni/node_modules/.bun/pino@9.14.0/node_modules/pino/lib";
   var { createRequire: createRequire2 } = __require("module");
   var getCallers = require_caller();
   var { join: join7, isAbsolute, sep: sep2 } = __require("path");
@@ -164744,6 +164744,7 @@ var init_schema2 = __esm(() => {
     gupshupAuthToken: text("gupshup_auth_token"),
     gupshupEventId: varchar("gupshup_event_id", { length: 255 }),
     webhookVerifyToken: text("webhook_verify_token"),
+    gupshupHandoffOptions: jsonb("gupshup_handoff_options").$type(),
     twilioAccountSid: varchar("twilio_account_sid", { length: 34 }),
     twilioAuthToken: text("twilio_auth_token"),
     twilioFrom: varchar("twilio_from", { length: 64 }),
@@ -235675,7 +235676,7 @@ var require_client3 = __commonJS((exports) => {
 
 // ../../node_modules/.bun/@sentry+node-core@10.52.0+6488de8736d8e524/node_modules/@sentry/node-core/build/cjs/sdk/esmLoader.js
 var require_esmLoader = __commonJS((exports) => {
-  var __filename = "/home/runner/work/omni/omni/.stable-source/node_modules/.bun/@sentry+node-core@10.52.0+6488de8736d8e524/node_modules/@sentry/node-core/build/cjs/sdk/esmLoader.js";
+  var __filename = "/home/runner/work/omni/omni/node_modules/.bun/@sentry+node-core@10.52.0+6488de8736d8e524/node_modules/@sentry/node-core/build/cjs/sdk/esmLoader.js";
   Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
   var core3 = require_cjs6();
   var importInTheMiddle = require_import_in_the_middle();
@@ -242901,7 +242902,7 @@ var init_sentry_scrub = __esm(() => {
 var require_package7 = __commonJS((exports, module) => {
   module.exports = {
     name: "@omni/api",
-    version: "2.260902.5",
+    version: "2.260903.2",
     type: "module",
     exports: {
       ".": {
@@ -278656,7 +278657,7 @@ var require_src52 = __commonJS((exports) => {
 
 // ../../node_modules/.bun/@grpc+grpc-js@1.14.3/node_modules/@grpc/grpc-js/build/src/channelz.js
 var require_channelz = __commonJS((exports) => {
-  var __dirname = "/home/runner/work/omni/omni/.stable-source/node_modules/.bun/@grpc+grpc-js@1.14.3/node_modules/@grpc/grpc-js/build/src";
+  var __dirname = "/home/runner/work/omni/omni/node_modules/.bun/@grpc+grpc-js@1.14.3/node_modules/@grpc/grpc-js/build/src";
   Object.defineProperty(exports, "__esModule", { value: true });
   exports.registerChannelzSocket = exports.registerChannelzServer = exports.registerChannelzSubchannel = exports.registerChannelzChannel = exports.ChannelzCallTrackerStub = exports.ChannelzCallTracker = exports.ChannelzChildrenTrackerStub = exports.ChannelzChildrenTracker = exports.ChannelzTrace = exports.ChannelzTraceStub = undefined;
   exports.unregisterChannelzRef = unregisterChannelzRef;
@@ -284059,7 +284060,7 @@ var require_duration = __commonJS((exports) => {
 
 // ../../node_modules/.bun/@grpc+grpc-js@1.14.3/node_modules/@grpc/grpc-js/build/src/orca.js
 var require_orca = __commonJS((exports) => {
-  var __dirname = "/home/runner/work/omni/omni/.stable-source/node_modules/.bun/@grpc+grpc-js@1.14.3/node_modules/@grpc/grpc-js/build/src";
+  var __dirname = "/home/runner/work/omni/omni/node_modules/.bun/@grpc+grpc-js@1.14.3/node_modules/@grpc/grpc-js/build/src";
   Object.defineProperty(exports, "__esModule", { value: true });
   exports.OrcaOobMetricsSubchannelWrapper = exports.GRPC_METRICS_HEADER = exports.ServerMetricRecorder = exports.PerRequestMetricRecorder = undefined;
   exports.createOrcaClient = createOrcaClient;
@@ -304265,8 +304266,8 @@ class GenerateContentResponse {
     let anyTextPartText = false;
     const nonTextParts = [];
     for (const part of (_h = (_g = (_f = (_e = this.candidates) === null || _e === undefined ? undefined : _e[0]) === null || _f === undefined ? undefined : _f.content) === null || _g === undefined ? undefined : _g.parts) !== null && _h !== undefined ? _h : []) {
-      for (const [fieldName, fieldValue] of Object.entries(part)) {
-        if (fieldName !== "text" && fieldName !== "thought" && fieldName !== "thoughtSignature" && (fieldValue !== null || fieldValue !== undefined)) {
+      for (const [fieldName, fieldValue2] of Object.entries(part)) {
+        if (fieldName !== "text" && fieldName !== "thought" && fieldName !== "thoughtSignature" && (fieldValue2 !== null || fieldValue2 !== undefined)) {
           nonTextParts.push(fieldName);
         }
       }
@@ -304294,8 +304295,8 @@ class GenerateContentResponse {
     let data = "";
     const nonDataParts = [];
     for (const part of (_h = (_g = (_f = (_e = this.candidates) === null || _e === undefined ? undefined : _e[0]) === null || _f === undefined ? undefined : _f.content) === null || _g === undefined ? undefined : _g.parts) !== null && _h !== undefined ? _h : []) {
-      for (const [fieldName, fieldValue] of Object.entries(part)) {
-        if (fieldName !== "inlineData" && (fieldValue !== null || fieldValue !== undefined)) {
+      for (const [fieldName, fieldValue2] of Object.entries(part)) {
+        if (fieldName !== "inlineData" && (fieldValue2 !== null || fieldValue2 !== undefined)) {
           nonDataParts.push(fieldName);
         }
       }
@@ -304450,8 +304451,8 @@ class LiveServerMessage {
     let anyTextPartFound = false;
     const nonTextParts = [];
     for (const part of (_c = (_b = (_a2 = this.serverContent) === null || _a2 === undefined ? undefined : _a2.modelTurn) === null || _b === undefined ? undefined : _b.parts) !== null && _c !== undefined ? _c : []) {
-      for (const [fieldName, fieldValue] of Object.entries(part)) {
-        if (fieldName !== "text" && fieldName !== "thought" && fieldValue !== null) {
+      for (const [fieldName, fieldValue2] of Object.entries(part)) {
+        if (fieldName !== "text" && fieldName !== "thought" && fieldValue2 !== null) {
           nonTextParts.push(fieldName);
         }
       }
@@ -304473,8 +304474,8 @@ class LiveServerMessage {
     let data = "";
     const nonDataParts = [];
     for (const part of (_c = (_b = (_a2 = this.serverContent) === null || _a2 === undefined ? undefined : _a2.modelTurn) === null || _b === undefined ? undefined : _b.parts) !== null && _c !== undefined ? _c : []) {
-      for (const [fieldName, fieldValue] of Object.entries(part)) {
-        if (fieldName !== "inlineData" && fieldValue !== null) {
+      for (const [fieldName, fieldValue2] of Object.entries(part)) {
+        if (fieldName !== "inlineData" && fieldValue2 !== null) {
           nonDataParts.push(fieldName);
         }
       }
@@ -304705,23 +304706,23 @@ function processJsonSchema(_jsonSchema) {
   if (_jsonSchema["type"] instanceof Array) {
     flattenTypeArrayToAnyOf(_jsonSchema["type"], genAISchema);
   }
-  for (const [fieldName, fieldValue] of Object.entries(_jsonSchema)) {
-    if (fieldValue == null) {
+  for (const [fieldName, fieldValue2] of Object.entries(_jsonSchema)) {
+    if (fieldValue2 == null) {
       continue;
     }
     if (fieldName == "type") {
-      if (fieldValue === "null") {
+      if (fieldValue2 === "null") {
         throw new Error("type: null can not be the only possible type for the field.");
       }
-      if (fieldValue instanceof Array) {
+      if (fieldValue2 instanceof Array) {
         continue;
       }
-      genAISchema["type"] = Object.values(Type).includes(fieldValue.toUpperCase()) ? fieldValue.toUpperCase() : Type.TYPE_UNSPECIFIED;
+      genAISchema["type"] = Object.values(Type).includes(fieldValue2.toUpperCase()) ? fieldValue2.toUpperCase() : Type.TYPE_UNSPECIFIED;
     } else if (schemaFieldNames.includes(fieldName)) {
-      genAISchema[fieldName] = processJsonSchema(fieldValue);
+      genAISchema[fieldName] = processJsonSchema(fieldValue2);
     } else if (listSchemaFieldNames.includes(fieldName)) {
       const listSchemaFieldValue = [];
-      for (const item of fieldValue) {
+      for (const item of fieldValue2) {
         if (item["type"] == "null") {
           genAISchema["nullable"] = true;
           continue;
@@ -304731,7 +304732,7 @@ function processJsonSchema(_jsonSchema) {
       genAISchema[fieldName] = listSchemaFieldValue;
     } else if (dictSchemaFieldNames.includes(fieldName)) {
       const dictSchemaFieldValue = {};
-      for (const [key, value] of Object.entries(fieldValue)) {
+      for (const [key, value] of Object.entries(fieldValue2)) {
         dictSchemaFieldValue[key] = processJsonSchema(value);
       }
       genAISchema[fieldName] = dictSchemaFieldValue;
@@ -304739,7 +304740,7 @@ function processJsonSchema(_jsonSchema) {
       if (fieldName === "additionalProperties") {
         continue;
       }
-      genAISchema[fieldName] = fieldValue;
+      genAISchema[fieldName] = fieldValue2;
     }
   }
   return genAISchema;
@@ -359867,7 +359868,7 @@ function registerInstanceSchemas(registry4) {
     }
   });
 }
-var InstanceSchema2, CreateInstanceSchema2, InstanceStatusSchema2, QrCodeSchema, PairingCodeRequestSchema, PairingCodeSchema, ConnectInstanceSchema, ConnectResponseSchema, UserProfileSchema, ContactSchema, GroupSchema, SupportedChannelSchema;
+var InstanceSchema2, gupshupHandoffFieldValue, gupshupHandoffFieldKey, gupshupHandoffFields, GupshupHandoffOptionsSchema, CreateInstanceSchema2, InstanceStatusSchema2, QrCodeSchema, PairingCodeRequestSchema, PairingCodeSchema, ConnectInstanceSchema, ConnectResponseSchema, UserProfileSchema, ContactSchema, GroupSchema, SupportedChannelSchema;
 var init_instances2 = __esm(() => {
   init_src();
   init_zod_openapi();
@@ -359891,6 +359892,40 @@ var init_instances2 = __esm(() => {
     createdAt: exports_external.string().datetime().openapi({ description: "Creation timestamp" }),
     updatedAt: exports_external.string().datetime().openapi({ description: "Last update timestamp" })
   });
+  gupshupHandoffFieldValue = exports_external.string().max(2048);
+  gupshupHandoffFieldKey = exports_external.string().min(1).max(128);
+  gupshupHandoffFields = exports_external.record(gupshupHandoffFieldKey, gupshupHandoffFieldValue);
+  GupshupHandoffOptionsSchema = exports_external.object({
+    defaultFields: gupshupHandoffFields.optional().openapi({
+      description: "Routing fields merged under whatever the emitter sent; explicit handoff fields always win, so system-initiated handoffs (dispatch error, silence watchdog) still land in a queue",
+      example: { queue: "SALES" }
+    }),
+    fieldsByPhonePrefix: exports_external.array(exports_external.object({
+      prefixes: exports_external.array(exports_external.string().min(1).max(15).regex(/^\d+$/)).min(1).max(256).openapi({
+        description: "Digit-only phone prefixes (country code first, no +)",
+        example: ["5511", "5521"]
+      }),
+      fields: gupshupHandoffFields.openapi({
+        description: "Routing fields applied when the customer phone starts with one of the prefixes",
+        example: { queue: "SALES-SOUTHEAST" }
+      })
+    })).max(64).optional().openapi({ description: "Prefix rules layered over defaultFields; the first matching rule wins" }),
+    customerFields: exports_external.array(exports_external.object({
+      apiKey: gupshupHandoffFieldKey.openapi({ description: "customerFields apiKey your Gupshup Journey reads" }),
+      value: gupshupHandoffFieldValue.optional().openapi({ description: "Literal value to send; mutually exclusive with `from`" }),
+      from: gupshupHandoffFieldKey.optional().openapi({
+        description: "Resolved handoff field to copy the value from; mutually exclusive with `value`"
+      })
+    }).refine((entry) => entry.value === undefined !== (entry.from === undefined), {
+      message: "each customerFields entry needs exactly one of `value` or `from`"
+    })).max(64).optional().openapi({
+      description: "Ordered template for the Custom Integration customerFields array. Entries whose source resolves empty are dropped; the array is only sent when non-empty",
+      example: [
+        { apiKey: "Queue", from: "queue" },
+        { apiKey: "Handled By", value: "assistant" }
+      ]
+    })
+  }).strict();
   CreateInstanceSchema2 = exports_external.object({
     name: exports_external.string().min(1).max(255).openapi({ description: "Unique name for the instance" }),
     channel: ChannelTypeSchema.openapi({ description: "Channel type" }),
@@ -359901,7 +359936,18 @@ var init_instances2 = __esm(() => {
     }),
     agentStreamMode: exports_external.boolean().default(false).openapi({ description: "Enable streaming responses" }),
     isDefault: exports_external.boolean().default(false).openapi({ description: "Set as default instance for channel" }),
-    token: exports_external.string().optional().openapi({ description: "Bot token for Discord instances" })
+    token: exports_external.string().optional().openapi({ description: "Bot token for Discord instances" }),
+    gupshupHandoffOptions: GupshupHandoffOptionsSchema.nullable().optional().openapi({
+      description: "Gupshup HANDOFF routing defaults and customerFields template (gupshup instances only). Read by the plugin at connect: restart the instance after changing it. null clears it",
+      example: {
+        defaultFields: { queue: "SALES" },
+        fieldsByPhonePrefix: [{ prefixes: ["5511", "5521"], fields: { queue: "SALES-SOUTHEAST" } }],
+        customerFields: [
+          { apiKey: "Queue", from: "queue" },
+          { apiKey: "Handled By", value: "assistant" }
+        ]
+      }
+    })
   });
   InstanceStatusSchema2 = exports_external.object({
     instanceId: exports_external.string().uuid().openapi({ description: "Instance UUID" }),
@@ -366744,6 +366790,8 @@ function applyGupshupConnectionOptions(options, input) {
     options.gupshupAuthToken = input.gupshupAuthToken;
   if (input.gupshupEventId)
     options.gupshupEventId = input.gupshupEventId;
+  if (input.gupshupHandoffOptions)
+    options.gupshupHandoffOptions = input.gupshupHandoffOptions;
   if (input.webhookVerifyToken)
     options.webhookVerifyToken = input.webhookVerifyToken;
 }
@@ -366927,6 +366975,7 @@ function buildConnectConnectionOptions(instance4, body, forceNewQr) {
     gupshupCallbackUrl: instance4.gupshupCallbackUrl,
     gupshupAuthToken: instance4.gupshupAuthToken,
     gupshupEventId: instance4.gupshupEventId,
+    gupshupHandoffOptions: instance4.gupshupHandoffOptions,
     webhookVerifyToken: instance4.webhookVerifyToken,
     twilioAccountSid: body.twilioAccountSid ?? instance4.twilioAccountSid,
     twilioAuthToken: body.twilioAuthToken ?? body.token ?? instance4.twilioAuthToken,
@@ -367100,6 +367149,7 @@ var init_instances3 = __esm(() => {
   init_auth();
   init_agent_dispatcher();
   init_qr_store();
+  init_instances2();
   init_access();
   init_agent_replay();
   log117 = createLogger("api:instances");
@@ -367165,6 +367215,7 @@ var init_instances3 = __esm(() => {
     gupshupCallbackUrl: exports_external.string().optional().nullable().describe("Gupshup Custom Integration callback URL"),
     gupshupAuthToken: exports_external.string().optional().nullable().describe("Gupshup Custom Integration auth token"),
     gupshupEventId: exports_external.string().optional().nullable().describe("Gupshup event ID (default: nx_omni_agent_reply)"),
+    gupshupHandoffOptions: GupshupHandoffOptionsSchema.optional().nullable().describe("Gupshup HANDOFF routing defaults and customerFields template"),
     webhookVerifyToken: exports_external.string().optional().nullable().describe("Gupshup webhook verify token"),
     twilioAccountSid: exports_external.string().optional().nullable().describe("Twilio Account SID"),
     twilioAuthToken: exports_external.string().optional().nullable().describe("Twilio Auth Token"),
@@ -367204,6 +367255,7 @@ var init_instances3 = __esm(() => {
     gupshupCallbackUrl: exports_external.string().nullable().optional(),
     gupshupAuthToken: exports_external.string().nullable().optional(),
     gupshupEventId: exports_external.string().nullable().optional(),
+    gupshupHandoffOptions: GupshupHandoffOptionsSchema.nullable().optional(),
     webhookVerifyToken: exports_external.string().nullable().optional(),
     twilioAccountSid: exports_external.string().nullable().optional(),
     twilioAuthToken: exports_external.string().nullable().optional(),
@@ -367334,6 +367386,7 @@ var init_instances3 = __esm(() => {
       gupshupCallbackUrl: instance4.gupshupCallbackUrl,
       gupshupAuthToken: instance4.gupshupAuthToken,
       gupshupEventId: instance4.gupshupEventId,
+      gupshupHandoffOptions: instance4.gupshupHandoffOptions,
       webhookVerifyToken: instance4.webhookVerifyToken,
       twilioAccountSid: instance4.twilioAccountSid,
       twilioAuthToken: instance4.twilioAuthToken,
@@ -367686,6 +367739,9 @@ var init_instances3 = __esm(() => {
       if (instance4.channel === "hermes") {
         applyHermesConnectionOptions(restartOptions, instance4);
       }
+      if (instance4.channel === "gupshup") {
+        applyGupshupConnectionOptions(restartOptions, instance4);
+      }
       if (instance4.channel === "whatsapp-business") {
         applyWhatsAppBusinessConnectionOptions(restartOptions, instance4);
       }
@@ -377712,6 +377768,8 @@ function applyGupshupOptions(options, instance4) {
     options.gupshupAuthToken = instance4.gupshupAuthToken;
   if (instance4.gupshupEventId)
     options.gupshupEventId = instance4.gupshupEventId;
+  if (instance4.gupshupHandoffOptions)
+    options.gupshupHandoffOptions = instance4.gupshupHandoffOptions;
   if (instance4.gupshupApiKey)
     options.gupshupApiKey = instance4.gupshupApiKey;
   if (instance4.gupshupAppName)
@@ -383228,6 +383286,7 @@ var src_default = plugin2;
 
 // ../channel-gupshup/src/plugin.ts
 init_src2();
+init_zod();
 
 // ../channel-gupshup/src/capabilities.ts
 init_src2();
@@ -383350,6 +383409,8 @@ class GupshupClient {
       payload.motivo_handoff = msg.motivo_handoff;
     if (msg.handoff_fields)
       payload.handoff_fields = msg.handoff_fields;
+    if (msg.customer_fields && msg.customer_fields.length > 0)
+      payload.customerFields = msg.customer_fields;
     const res = await fetch(this.callbackUrl, {
       method: "POST",
       headers: { "Content-Type": "application/json", Authorization: this.authToken },
@@ -383866,6 +383927,67 @@ function extractContent2(msg) {
   return null;
 }
 
+// ../channel-gupshup/src/handoff-options.ts
+init_zod();
+var fieldValue = exports_external.string().max(2048);
+var fieldKey = exports_external.string().min(1).max(128);
+var fieldMap = exports_external.record(fieldKey, fieldValue);
+var gupshupHandoffOptionsSchema = exports_external.object({
+  defaultFields: fieldMap.optional(),
+  fieldsByPhonePrefix: exports_external.array(exports_external.object({
+    prefixes: exports_external.array(exports_external.string().min(1).max(15).regex(/^\d+$/, "prefixes must be digits only")).min(1).max(256),
+    fields: fieldMap
+  })).max(64).optional(),
+  customerFields: exports_external.array(exports_external.object({
+    apiKey: fieldKey,
+    value: fieldValue.optional(),
+    from: fieldKey.optional()
+  }).refine((entry) => entry.value === undefined !== (entry.from === undefined), {
+    message: "each customerFields entry needs exactly one of `value` or `from`"
+  })).max(64).optional()
+}).strict();
+var EMPTY_SENTINELS = new Set(["", "undefined", "null"]);
+function cleanValue(value) {
+  const text = String(value ?? "").trim();
+  return EMPTY_SENTINELS.has(text.toLowerCase()) ? "" : text;
+}
+function parseHandoffOptions(raw) {
+  if (raw === undefined || raw === null)
+    return;
+  return gupshupHandoffOptionsSchema.parse(raw);
+}
+function resolveHandoffFields(phone, explicit, options) {
+  if (!options)
+    return explicit;
+  const defaults = { ...options.defaultFields ?? {} };
+  const digits = String(phone ?? "").replace(/\D/g, "");
+  if (digits && options.fieldsByPhonePrefix) {
+    const rule = options.fieldsByPhonePrefix.find((r) => r.prefixes.some((p2) => digits.startsWith(p2)));
+    if (rule)
+      Object.assign(defaults, rule.fields);
+  }
+  if (Object.keys(defaults).length === 0)
+    return explicit;
+  const out = { ...explicit ?? {} };
+  for (const [key, value] of Object.entries(defaults)) {
+    if (cleanValue(out[key]) === "")
+      out[key] = value;
+  }
+  return out;
+}
+function buildCustomerFields(handoffFields, template) {
+  if (!template || template.length === 0)
+    return;
+  const out = [];
+  for (const entry of template) {
+    const value = entry.value !== undefined ? cleanValue(entry.value) : cleanValue(handoffFields?.[entry.from]);
+    if (value === "")
+      continue;
+    out.push({ apiKey: entry.apiKey, value });
+  }
+  return out.length > 0 ? out : undefined;
+}
+
 // ../channel-gupshup/src/senders/close-contact.ts
 var GUPSHUP_CLOSE_MSG_TYPE = "CLOSING";
 async function sendCloseContact(client, to, text, closeReason, closeOutcome, closeFields) {
@@ -383879,13 +384001,14 @@ async function sendCloseContact(client, to, text, closeReason, closeOutcome, clo
 }
 
 // ../channel-gupshup/src/senders/handoff.ts
-async function sendHandoff(client, to, text, dadosLead, motivoHandoff, handoffFields) {
+async function sendHandoff(client, to, text, dadosLead, motivoHandoff, handoffFields, customerFields) {
   return client.send(to, {
     type: "HANDOFF",
     text,
     dados_lead: dadosLead,
     motivo_handoff: motivoHandoff,
-    handoff_fields: handoffFields
+    handoff_fields: handoffFields,
+    ...customerFields ? { customer_fields: customerFields } : {}
   });
 }
 
@@ -383941,15 +384064,17 @@ function toGupshupPhone(phone) {
 }
 
 // ../channel-gupshup/src/plugin.ts
-async function dispatchContent(client, dest, message2) {
+async function dispatchContent(client, dest, message2, handoffOptions) {
   const { content } = message2;
   const meta = message2.metadata;
   const mediaTypes = new Set(["image", "audio", "video", "document", "sticker"]);
   if (meta?.isHandoff === true) {
     const dadosLead = meta.dadosLead;
     const motivoHandoff = meta.motivoHandoff;
-    const handoffFields = meta.handoffFields;
-    return sendHandoff(client, dest, content.text ?? "", dadosLead, motivoHandoff, handoffFields);
+    const explicitFields = meta.handoffFields;
+    const handoffFields = resolveHandoffFields(dest, explicitFields, handoffOptions);
+    const customerFields = buildCustomerFields(handoffFields, handoffOptions?.customerFields);
+    return sendHandoff(client, dest, content.text ?? "", dadosLead, motivoHandoff, handoffFields, customerFields);
   }
   if (meta?.isCloseContact === true) {
     const closeReason = meta.closeReason;
@@ -384021,6 +384146,13 @@ class GupshupPlugin extends BaseChannelPlugin {
     const authToken = creds.gupshupAuthToken ?? opts.gupshupAuthToken;
     const eventId = creds.gupshupEventId ?? opts.gupshupEventId ?? "nx_omni_agent_reply";
     const webhookVerifyToken = creds.webhookVerifyToken ?? opts.webhookVerifyToken;
+    let handoffOptions;
+    try {
+      handoffOptions = parseHandoffOptions(creds.gupshupHandoffOptions ?? opts.gupshupHandoffOptions);
+    } catch (err2) {
+      const detail = err2 instanceof ZodError ? err2.issues.map((issue) => `${issue.path.join(".") || "(root)"}: ${issue.message}`).join("; ") : String(err2);
+      throw new GupshupError(GupshupErrorCode.BAD_REQUEST, `gupshupHandoffOptions is invalid \u2014 ${detail}`);
+    }
     if (!callbackUrl)
       throw new GupshupError(GupshupErrorCode.AUTH_FAILED, "gupshupCallbackUrl is required");
     if (!authToken)
@@ -384035,7 +384167,8 @@ class GupshupPlugin extends BaseChannelPlugin {
       gupshupCallbackUrl: callbackUrl,
       gupshupAuthToken: authToken,
       gupshupEventId: eventId,
-      webhookVerifyToken
+      webhookVerifyToken,
+      handoffOptions
     };
     const dedupeCache = createInboundDedupeCache();
     this.gupshupInstances.set(instanceId, { client, config: gupshupConfig, dedupeCache });
@@ -384076,7 +384209,7 @@ class GupshupPlugin extends BaseChannelPlugin {
     if (correlationId)
       this.captureT10(correlationId);
     try {
-      const response = await dispatchContent(client, dest, message2);
+      const response = await dispatchContent(client, dest, message2, state.config.handoffOptions);
       const providerAliases = extractGupshupProviderAliases(response);
       const messageId = extractResponseString(response, "messageId") ?? crypto.randomUUID();
       if (correlationId)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automagik/omni",
-  "version": "2.260902.5",
+  "version": "2.260903.2",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/automagik-dev/omni.git",