evo360-types 1.3.736 → 1.3.748

package/dist/apps/evo-chat/thread-message/zod-schemas.d.ts

@@ -63,6 +63,8 @@ export declare const zMessageMediaSchema: z.ZodObject<{
     filename: z.ZodOptional<z.ZodString>;
     caption: z.ZodOptional<z.ZodString>;
     meta_media_id: z.ZodOptional<z.ZodString>;
+    /** feat-303: áudio enviado como nota de voz (OGG/Opus + `voice: true` na Meta). */
+    voice: z.ZodOptional<z.ZodBoolean>;
 }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
     gcs_uri: z.ZodOptional<z.ZodString>;
     url: z.ZodOptional<z.ZodString>;
@@ -72,6 +74,8 @@ export declare const zMessageMediaSchema: z.ZodObject<{
     filename: z.ZodOptional<z.ZodString>;
     caption: z.ZodOptional<z.ZodString>;
     meta_media_id: z.ZodOptional<z.ZodString>;
+    /** feat-303: áudio enviado como nota de voz (OGG/Opus + `voice: true` na Meta). */
+    voice: z.ZodOptional<z.ZodBoolean>;
 }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
     gcs_uri: z.ZodOptional<z.ZodString>;
     url: z.ZodOptional<z.ZodString>;
@@ -81,6 +85,8 @@ export declare const zMessageMediaSchema: z.ZodObject<{
     filename: z.ZodOptional<z.ZodString>;
     caption: z.ZodOptional<z.ZodString>;
     meta_media_id: z.ZodOptional<z.ZodString>;
+    /** feat-303: áudio enviado como nota de voz (OGG/Opus + `voice: true` na Meta). */
+    voice: z.ZodOptional<z.ZodBoolean>;
 }, z.ZodTypeAny, "passthrough">>;
 export declare const zMessageCreatedBySchema: z.ZodObject<{
     type: z.ZodEnum<["human", "automation", "system"]>;
@@ -209,6 +215,8 @@ export declare const zThreadMessageSchema: z.ZodObject<{
         filename: z.ZodOptional<z.ZodString>;
         caption: z.ZodOptional<z.ZodString>;
         meta_media_id: z.ZodOptional<z.ZodString>;
+        /** feat-303: áudio enviado como nota de voz (OGG/Opus + `voice: true` na Meta). */
+        voice: z.ZodOptional<z.ZodBoolean>;
     }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
         gcs_uri: z.ZodOptional<z.ZodString>;
         url: z.ZodOptional<z.ZodString>;
@@ -218,6 +226,8 @@ export declare const zThreadMessageSchema: z.ZodObject<{
         filename: z.ZodOptional<z.ZodString>;
         caption: z.ZodOptional<z.ZodString>;
         meta_media_id: z.ZodOptional<z.ZodString>;
+        /** feat-303: áudio enviado como nota de voz (OGG/Opus + `voice: true` na Meta). */
+        voice: z.ZodOptional<z.ZodBoolean>;
     }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
         gcs_uri: z.ZodOptional<z.ZodString>;
         url: z.ZodOptional<z.ZodString>;
@@ -227,6 +237,8 @@ export declare const zThreadMessageSchema: z.ZodObject<{
         filename: z.ZodOptional<z.ZodString>;
         caption: z.ZodOptional<z.ZodString>;
         meta_media_id: z.ZodOptional<z.ZodString>;
+        /** feat-303: áudio enviado como nota de voz (OGG/Opus + `voice: true` na Meta). */
+        voice: z.ZodOptional<z.ZodBoolean>;
     }, z.ZodTypeAny, "passthrough">>>;
     location: z.ZodOptional<z.ZodObject<{
         latitude: z.ZodNumber;
@@ -536,6 +548,8 @@ export declare const zThreadMessageSchema: z.ZodObject<{
         filename: z.ZodOptional<z.ZodString>;
         caption: z.ZodOptional<z.ZodString>;
         meta_media_id: z.ZodOptional<z.ZodString>;
+        /** feat-303: áudio enviado como nota de voz (OGG/Opus + `voice: true` na Meta). */
+        voice: z.ZodOptional<z.ZodBoolean>;
     }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
         gcs_uri: z.ZodOptional<z.ZodString>;
         url: z.ZodOptional<z.ZodString>;
@@ -545,6 +559,8 @@ export declare const zThreadMessageSchema: z.ZodObject<{
         filename: z.ZodOptional<z.ZodString>;
         caption: z.ZodOptional<z.ZodString>;
         meta_media_id: z.ZodOptional<z.ZodString>;
+        /** feat-303: áudio enviado como nota de voz (OGG/Opus + `voice: true` na Meta). */
+        voice: z.ZodOptional<z.ZodBoolean>;
     }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
         gcs_uri: z.ZodOptional<z.ZodString>;
         url: z.ZodOptional<z.ZodString>;
@@ -554,6 +570,8 @@ export declare const zThreadMessageSchema: z.ZodObject<{
         filename: z.ZodOptional<z.ZodString>;
         caption: z.ZodOptional<z.ZodString>;
         meta_media_id: z.ZodOptional<z.ZodString>;
+        /** feat-303: áudio enviado como nota de voz (OGG/Opus + `voice: true` na Meta). */
+        voice: z.ZodOptional<z.ZodBoolean>;
     }, z.ZodTypeAny, "passthrough">>>;
     location: z.ZodOptional<z.ZodObject<{
         latitude: z.ZodNumber;
@@ -863,6 +881,8 @@ export declare const zThreadMessageSchema: z.ZodObject<{
         filename: z.ZodOptional<z.ZodString>;
         caption: z.ZodOptional<z.ZodString>;
         meta_media_id: z.ZodOptional<z.ZodString>;
+        /** feat-303: áudio enviado como nota de voz (OGG/Opus + `voice: true` na Meta). */
+        voice: z.ZodOptional<z.ZodBoolean>;
     }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
         gcs_uri: z.ZodOptional<z.ZodString>;
         url: z.ZodOptional<z.ZodString>;
@@ -872,6 +892,8 @@ export declare const zThreadMessageSchema: z.ZodObject<{
         filename: z.ZodOptional<z.ZodString>;
         caption: z.ZodOptional<z.ZodString>;
         meta_media_id: z.ZodOptional<z.ZodString>;
+        /** feat-303: áudio enviado como nota de voz (OGG/Opus + `voice: true` na Meta). */
+        voice: z.ZodOptional<z.ZodBoolean>;
     }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
         gcs_uri: z.ZodOptional<z.ZodString>;
         url: z.ZodOptional<z.ZodString>;
@@ -881,6 +903,8 @@ export declare const zThreadMessageSchema: z.ZodObject<{
         filename: z.ZodOptional<z.ZodString>;
         caption: z.ZodOptional<z.ZodString>;
         meta_media_id: z.ZodOptional<z.ZodString>;
+        /** feat-303: áudio enviado como nota de voz (OGG/Opus + `voice: true` na Meta). */
+        voice: z.ZodOptional<z.ZodBoolean>;
     }, z.ZodTypeAny, "passthrough">>>;
     location: z.ZodOptional<z.ZodObject<{
         latitude: z.ZodNumber;

package/dist/apps/evo-chat/thread-message/zod-schemas.js

@@ -23,6 +23,8 @@ exports.zMessageMediaSchema = zod_1.z.object({
     filename: zod_1.z.string().optional(),
     caption: zod_1.z.string().optional(),
     meta_media_id: zod_1.z.string().optional(),
+    /** feat-303: áudio enviado como nota de voz (OGG/Opus + `voice: true` na Meta). */
+    voice: zod_1.z.boolean().optional(),
 }).passthrough();
 exports.zMessageCreatedBySchema = zod_1.z.object({
     type: zod_1.z.enum(['human', 'automation', 'system']),

package/dist/apps/evo-chat/thread-message/zod-schemas.ts

@@ -22,6 +22,8 @@ export const zMessageMediaSchema = z.object({
   filename: z.string().optional(),
   caption: z.string().optional(),
   meta_media_id: z.string().optional(),
+  /** feat-303: áudio enviado como nota de voz (OGG/Opus + `voice: true` na Meta). */
+  voice: z.boolean().optional(),
 }).passthrough();
 
 export const zMessageCreatedBySchema = z.object({

package/dist/apps/evo-hub-ia/v1/zod-schemas.d.ts

@@ -1611,6 +1611,123 @@ export declare const zHubiaRuleSchema: z.ZodEffects<z.ZodObject<{
     /** Aborta sequência de ações no primeiro erro. */
     stop_actions_on_error: z.ZodDefault<z.ZodBoolean>;
 }, z.ZodTypeAny, "passthrough">>;
+/** Vozes do `gpt-4o-mini-tts` oferecidas na UI. O schema aceita qualquer string
+ *  para o provedor poder mudar sem novo contrato. */
+export declare const HUBIA_VOICE_REPLY_OPENAI_VOICES: readonly ["alloy", "ash", "ballad", "coral", "echo", "fable", "nova", "onyx", "sage", "shimmer", "verse", "marin", "cedar"];
+export declare const HUBIA_VOICE_REPLY_DEFAULT_VOICE = "coral";
+/** Liga a resposta em áudio no binding. QUANDO usar áudio é regra do prompt do
+ *  binding (o LLM decide por turno), não deste objeto. */
+export declare const zHubiaVoiceReplySchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    voice: z.ZodDefault<z.ZodString>;
+    /** Tom/estilo da fala ("cordial, ritmo calmo"). */
+    instructions: z.ZodOptional<z.ZodString>;
+    /** 1.0 = normal. */
+    speed: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    enabled: boolean;
+    voice: string;
+    instructions?: string | undefined;
+    speed?: number | undefined;
+}, {
+    enabled?: boolean | undefined;
+    voice?: string | undefined;
+    instructions?: string | undefined;
+    speed?: number | undefined;
+}>;
+export type IHubiaVoiceReply = z.infer<typeof zHubiaVoiceReplySchema>;
+export declare const zHubiaResponseModeSchema: z.ZodEnum<["text", "audio"]>;
+export type HubiaResponseMode = z.infer<typeof zHubiaResponseModeSchema>;
+/** `conversations/{id}.pending_suggestion` (modo hybrid_assist). */
+export declare const zHubiaPendingSuggestionSchema: z.ZodObject<{
+    execution_id: z.ZodString;
+    messages: z.ZodArray<z.ZodString, "many">;
+    created_at: z.ZodAny;
+    was_used: z.ZodOptional<z.ZodBoolean>;
+    /** Escolha do LLM; pré-marca "enviar como áudio" na caixa de sugestão. */
+    response_mode: z.ZodOptional<z.ZodEnum<["text", "audio"]>>;
+    /** Binding + canal permitiam áudio no turno da sugestão. */
+    voice_available: z.ZodOptional<z.ZodBoolean>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    execution_id: z.ZodString;
+    messages: z.ZodArray<z.ZodString, "many">;
+    created_at: z.ZodAny;
+    was_used: z.ZodOptional<z.ZodBoolean>;
+    /** Escolha do LLM; pré-marca "enviar como áudio" na caixa de sugestão. */
+    response_mode: z.ZodOptional<z.ZodEnum<["text", "audio"]>>;
+    /** Binding + canal permitiam áudio no turno da sugestão. */
+    voice_available: z.ZodOptional<z.ZodBoolean>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    execution_id: z.ZodString;
+    messages: z.ZodArray<z.ZodString, "many">;
+    created_at: z.ZodAny;
+    was_used: z.ZodOptional<z.ZodBoolean>;
+    /** Escolha do LLM; pré-marca "enviar como áudio" na caixa de sugestão. */
+    response_mode: z.ZodOptional<z.ZodEnum<["text", "audio"]>>;
+    /** Binding + canal permitiam áudio no turno da sugestão. */
+    voice_available: z.ZodOptional<z.ZodBoolean>;
+}, z.ZodTypeAny, "passthrough">>;
+export type IHubiaPendingSuggestion = z.infer<typeof zHubiaPendingSuggestionSchema>;
+/** Gravado na mensagem enviada a partir de uma sugestão da HubIA. */
+export declare const zHubiaSuggestionMessageRefSchema: z.ZodObject<{
+    execution_id: z.ZodString;
+    /** O operador alterou o texto antes de enviar. */
+    edited: z.ZodBoolean;
+    mode: z.ZodEnum<["text", "audio"]>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    execution_id: z.ZodString;
+    /** O operador alterou o texto antes de enviar. */
+    edited: z.ZodBoolean;
+    mode: z.ZodEnum<["text", "audio"]>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    execution_id: z.ZodString;
+    /** O operador alterou o texto antes de enviar. */
+    edited: z.ZodBoolean;
+    mode: z.ZodEnum<["text", "audio"]>;
+}, z.ZodTypeAny, "passthrough">>;
+export type IHubiaSuggestionMessageRef = z.infer<typeof zHubiaSuggestionMessageRefSchema>;
+/** Desfecho da sugestão, gravado na execução que a gerou. */
+export declare const zHubiaSuggestionOutcomeSchema: z.ZodObject<{
+    status: z.ZodEnum<["sent", "sent_edited", "discarded"]>;
+    mode: z.ZodOptional<z.ZodEnum<["text", "audio"]>>;
+    by_user_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    at: z.ZodAny;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    status: z.ZodEnum<["sent", "sent_edited", "discarded"]>;
+    mode: z.ZodOptional<z.ZodEnum<["text", "audio"]>>;
+    by_user_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    at: z.ZodAny;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    status: z.ZodEnum<["sent", "sent_edited", "discarded"]>;
+    mode: z.ZodOptional<z.ZodEnum<["text", "audio"]>>;
+    by_user_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    at: z.ZodAny;
+}, z.ZodTypeAny, "passthrough">>;
+export type IHubiaSuggestionOutcome = z.infer<typeof zHubiaSuggestionOutcomeSchema>;
+/** Metadados da nota de voz gerada pela HubIA, gravados na mensagem. */
+export declare const zHubiaTtsMessageMetaSchema: z.ZodObject<{
+    model: z.ZodString;
+    voice: z.ZodString;
+    format: z.ZodEnum<["ogg", "mp3"]>;
+    chars: z.ZodNumber;
+    duration_seconds: z.ZodNullable<z.ZodNumber>;
+    execution_id: z.ZodOptional<z.ZodString>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    model: z.ZodString;
+    voice: z.ZodString;
+    format: z.ZodEnum<["ogg", "mp3"]>;
+    chars: z.ZodNumber;
+    duration_seconds: z.ZodNullable<z.ZodNumber>;
+    execution_id: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    model: z.ZodString;
+    voice: z.ZodString;
+    format: z.ZodEnum<["ogg", "mp3"]>;
+    chars: z.ZodNumber;
+    duration_seconds: z.ZodNullable<z.ZodNumber>;
+    execution_id: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">>;
+export type IHubiaTtsMessageMeta = z.infer<typeof zHubiaTtsMessageMetaSchema>;
 export declare const zAiBindingSchema: z.ZodObject<{
     id: z.ZodString;
     ref: z.ZodAny;
@@ -2377,6 +2494,26 @@ export declare const zAiBindingSchema: z.ZodObject<{
      *  com `hubia` em `usable_for`) usada neste departamento. Vence o
      *  `llm_connection_id` do canal. `null`/ausente = herda do canal. */
     llm_connection_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** Ausente/`enabled: false` = HubIA só responde em texto. Exige o contrato
+     *  estruturado (`respond_to_contact`) ligado no canal. */
+    voice_reply: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        voice: z.ZodDefault<z.ZodString>;
+        /** Tom/estilo da fala ("cordial, ritmo calmo"). */
+        instructions: z.ZodOptional<z.ZodString>;
+        /** 1.0 = normal. */
+        speed: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        voice: string;
+        instructions?: string | undefined;
+        speed?: number | undefined;
+    }, {
+        enabled?: boolean | undefined;
+        voice?: string | undefined;
+        instructions?: string | undefined;
+        speed?: number | undefined;
+    }>>;
 }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
     id: z.ZodString;
     ref: z.ZodAny;
@@ -3143,6 +3280,26 @@ export declare const zAiBindingSchema: z.ZodObject<{
      *  com `hubia` em `usable_for`) usada neste departamento. Vence o
      *  `llm_connection_id` do canal. `null`/ausente = herda do canal. */
     llm_connection_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** Ausente/`enabled: false` = HubIA só responde em texto. Exige o contrato
+     *  estruturado (`respond_to_contact`) ligado no canal. */
+    voice_reply: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        voice: z.ZodDefault<z.ZodString>;
+        /** Tom/estilo da fala ("cordial, ritmo calmo"). */
+        instructions: z.ZodOptional<z.ZodString>;
+        /** 1.0 = normal. */
+        speed: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        voice: string;
+        instructions?: string | undefined;
+        speed?: number | undefined;
+    }, {
+        enabled?: boolean | undefined;
+        voice?: string | undefined;
+        instructions?: string | undefined;
+        speed?: number | undefined;
+    }>>;
 }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
     id: z.ZodString;
     ref: z.ZodAny;
@@ -3909,6 +4066,26 @@ export declare const zAiBindingSchema: z.ZodObject<{
      *  com `hubia` em `usable_for`) usada neste departamento. Vence o
      *  `llm_connection_id` do canal. `null`/ausente = herda do canal. */
     llm_connection_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** Ausente/`enabled: false` = HubIA só responde em texto. Exige o contrato
+     *  estruturado (`respond_to_contact`) ligado no canal. */
+    voice_reply: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        voice: z.ZodDefault<z.ZodString>;
+        /** Tom/estilo da fala ("cordial, ritmo calmo"). */
+        instructions: z.ZodOptional<z.ZodString>;
+        /** 1.0 = normal. */
+        speed: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        voice: string;
+        instructions?: string | undefined;
+        speed?: number | undefined;
+    }, {
+        enabled?: boolean | undefined;
+        voice?: string | undefined;
+        instructions?: string | undefined;
+        speed?: number | undefined;
+    }>>;
 }, z.ZodTypeAny, "passthrough">>;
 export type IAiBinding = z.infer<typeof zAiBindingSchema>;
 /** Disposição de fechamento publicada no evento. Os bridges publicam `null`

package/dist/apps/evo-hub-ia/v1/zod-schemas.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.zHubiaTicketClosedEventSchema = exports.zHubiaTicketClosedCloseSchema = exports.zAiBindingSchema = exports.zHubiaRuleSchema = exports.zHubiaRulesModeSchema = exports.zSendQuickReplyActionInputSchema = exports.zCreateTaskActionInputSchema = exports.zHubiaRuleActionSchema = exports.zHubiaRuleScopeSchema = exports.zHubiaConditionGroupSchema = exports.zHubiaConditionSchema = exports.zHubiaScheduleSchema = exports.zHubiaScheduleWindowSchema = exports.zHubiaConditionOpSchema = exports.zHubiaOutboundSourceSchema = exports.zHubiaRuleAppliesToSchema = exports.zHubiaRuleOutcomeSchema = exports.zHubiaRuleTriggerSchema = exports.zHubiaRulePhaseSchema = exports.zHubiaConversationModeSchema = exports.zHubiaConversationMessageSchema = exports.zHubiaV1ChannelConfigSchema = exports.zHubiaAttendanceModeSchema = void 0;
+exports.zHubiaTicketClosedEventSchema = exports.zHubiaTicketClosedCloseSchema = exports.zAiBindingSchema = exports.zHubiaTtsMessageMetaSchema = exports.zHubiaSuggestionOutcomeSchema = exports.zHubiaSuggestionMessageRefSchema = exports.zHubiaPendingSuggestionSchema = exports.zHubiaResponseModeSchema = exports.zHubiaVoiceReplySchema = exports.HUBIA_VOICE_REPLY_DEFAULT_VOICE = exports.HUBIA_VOICE_REPLY_OPENAI_VOICES = exports.zHubiaRuleSchema = exports.zHubiaRulesModeSchema = exports.zSendQuickReplyActionInputSchema = exports.zCreateTaskActionInputSchema = exports.zHubiaRuleActionSchema = exports.zHubiaRuleScopeSchema = exports.zHubiaConditionGroupSchema = exports.zHubiaConditionSchema = exports.zHubiaScheduleSchema = exports.zHubiaScheduleWindowSchema = exports.zHubiaConditionOpSchema = exports.zHubiaOutboundSourceSchema = exports.zHubiaRuleAppliesToSchema = exports.zHubiaRuleOutcomeSchema = exports.zHubiaRuleTriggerSchema = exports.zHubiaRulePhaseSchema = exports.zHubiaConversationModeSchema = exports.zHubiaConversationMessageSchema = exports.zHubiaV1ChannelConfigSchema = exports.zHubiaAttendanceModeSchema = void 0;
 const zod_1 = require("zod");
 const zod_schemas_1 = require("../../shared/zod-schemas");
 const zod_schemas_2 = require("../../evo-csq/zod-schemas");
@@ -350,6 +350,59 @@ const zHubiaPromptOverridesSchema = zod_1.z.object({
     routing: zod_1.z.string().optional(),
     tool_usage: zod_1.z.string().optional(),
 });
+// ───────── Resposta em áudio (feat-303) ─────────
+/** Vozes do `gpt-4o-mini-tts` oferecidas na UI. O schema aceita qualquer string
+ *  para o provedor poder mudar sem novo contrato. */
+exports.HUBIA_VOICE_REPLY_OPENAI_VOICES = [
+    'alloy', 'ash', 'ballad', 'coral', 'echo', 'fable', 'nova',
+    'onyx', 'sage', 'shimmer', 'verse', 'marin', 'cedar',
+];
+exports.HUBIA_VOICE_REPLY_DEFAULT_VOICE = 'coral';
+/** Liga a resposta em áudio no binding. QUANDO usar áudio é regra do prompt do
+ *  binding (o LLM decide por turno), não deste objeto. */
+exports.zHubiaVoiceReplySchema = zod_1.z.object({
+    enabled: zod_1.z.boolean().default(false),
+    voice: zod_1.z.string().min(1).max(40).default(exports.HUBIA_VOICE_REPLY_DEFAULT_VOICE),
+    /** Tom/estilo da fala ("cordial, ritmo calmo"). */
+    instructions: zod_1.z.string().max(1000).optional(),
+    /** 1.0 = normal. */
+    speed: zod_1.z.number().min(0.75).max(1.5).optional(),
+});
+exports.zHubiaResponseModeSchema = zod_1.z.enum(['text', 'audio']);
+/** `conversations/{id}.pending_suggestion` (modo hybrid_assist). */
+exports.zHubiaPendingSuggestionSchema = zod_1.z.object({
+    execution_id: zod_1.z.string(),
+    messages: zod_1.z.array(zod_1.z.string()),
+    created_at: zod_1.z.any(),
+    was_used: zod_1.z.boolean().optional(),
+    /** Escolha do LLM; pré-marca "enviar como áudio" na caixa de sugestão. */
+    response_mode: exports.zHubiaResponseModeSchema.optional(),
+    /** Binding + canal permitiam áudio no turno da sugestão. */
+    voice_available: zod_1.z.boolean().optional(),
+}).passthrough();
+/** Gravado na mensagem enviada a partir de uma sugestão da HubIA. */
+exports.zHubiaSuggestionMessageRefSchema = zod_1.z.object({
+    execution_id: zod_1.z.string(),
+    /** O operador alterou o texto antes de enviar. */
+    edited: zod_1.z.boolean(),
+    mode: exports.zHubiaResponseModeSchema,
+}).passthrough();
+/** Desfecho da sugestão, gravado na execução que a gerou. */
+exports.zHubiaSuggestionOutcomeSchema = zod_1.z.object({
+    status: zod_1.z.enum(['sent', 'sent_edited', 'discarded']),
+    mode: exports.zHubiaResponseModeSchema.optional(),
+    by_user_id: zod_1.z.string().nullable().optional(),
+    at: zod_1.z.any(),
+}).passthrough();
+/** Metadados da nota de voz gerada pela HubIA, gravados na mensagem. */
+exports.zHubiaTtsMessageMetaSchema = zod_1.z.object({
+    model: zod_1.z.string(),
+    voice: zod_1.z.string(),
+    format: zod_1.z.enum(['ogg', 'mp3']),
+    chars: zod_1.z.number(),
+    duration_seconds: zod_1.z.number().nullable(),
+    execution_id: zod_1.z.string().optional(),
+}).passthrough();
 exports.zAiBindingSchema = zod_schemas_1.zFireDocSchema.extend({
     agent_type: zod_1.z.string(), // 'evo-hubia-v1', future: 'evo-hubia-v2', etc.
     agent_config_id: zod_1.z.string(), // ref to the agent's channel config doc
@@ -397,6 +450,10 @@ exports.zAiBindingSchema = zod_schemas_1.zFireDocSchema.extend({
      *  com `hubia` em `usable_for`) usada neste departamento. Vence o
      *  `llm_connection_id` do canal. `null`/ausente = herda do canal. */
     llm_connection_id: zod_1.z.string().nullable().optional(),
+    // ───── Resposta em áudio (feat-303) ─────
+    /** Ausente/`enabled: false` = HubIA só responde em texto. Exige o contrato
+     *  estruturado (`respond_to_contact`) ligado no canal. */
+    voice_reply: exports.zHubiaVoiceReplySchema.optional(),
 }).passthrough();
 // ───────── Evento `hubia-ticket-closed` (payload do tópico PubSub) ─────────
 /** Disposição de fechamento publicada no evento. Os bridges publicam `null`

package/dist/apps/evo-hub-ia/v1/zod-schemas.ts

@@ -397,6 +397,74 @@ const zHubiaPromptOverridesSchema = z.object({
   tool_usage: z.string().optional(),
 });
 
+// ───────── Resposta em áudio (feat-303) ─────────
+
+/** Vozes do `gpt-4o-mini-tts` oferecidas na UI. O schema aceita qualquer string
+ *  para o provedor poder mudar sem novo contrato. */
+export const HUBIA_VOICE_REPLY_OPENAI_VOICES = [
+  'alloy', 'ash', 'ballad', 'coral', 'echo', 'fable', 'nova',
+  'onyx', 'sage', 'shimmer', 'verse', 'marin', 'cedar',
+] as const;
+
+export const HUBIA_VOICE_REPLY_DEFAULT_VOICE = 'coral';
+
+/** Liga a resposta em áudio no binding. QUANDO usar áudio é regra do prompt do
+ *  binding (o LLM decide por turno), não deste objeto. */
+export const zHubiaVoiceReplySchema = z.object({
+  enabled: z.boolean().default(false),
+  voice: z.string().min(1).max(40).default(HUBIA_VOICE_REPLY_DEFAULT_VOICE),
+  /** Tom/estilo da fala ("cordial, ritmo calmo"). */
+  instructions: z.string().max(1000).optional(),
+  /** 1.0 = normal. */
+  speed: z.number().min(0.75).max(1.5).optional(),
+});
+export type IHubiaVoiceReply = z.infer<typeof zHubiaVoiceReplySchema>;
+
+export const zHubiaResponseModeSchema = z.enum(['text', 'audio']);
+export type HubiaResponseMode = z.infer<typeof zHubiaResponseModeSchema>;
+
+/** `conversations/{id}.pending_suggestion` (modo hybrid_assist). */
+export const zHubiaPendingSuggestionSchema = z.object({
+  execution_id: z.string(),
+  messages: z.array(z.string()),
+  created_at: z.any(),
+  was_used: z.boolean().optional(),
+  /** Escolha do LLM; pré-marca "enviar como áudio" na caixa de sugestão. */
+  response_mode: zHubiaResponseModeSchema.optional(),
+  /** Binding + canal permitiam áudio no turno da sugestão. */
+  voice_available: z.boolean().optional(),
+}).passthrough();
+export type IHubiaPendingSuggestion = z.infer<typeof zHubiaPendingSuggestionSchema>;
+
+/** Gravado na mensagem enviada a partir de uma sugestão da HubIA. */
+export const zHubiaSuggestionMessageRefSchema = z.object({
+  execution_id: z.string(),
+  /** O operador alterou o texto antes de enviar. */
+  edited: z.boolean(),
+  mode: zHubiaResponseModeSchema,
+}).passthrough();
+export type IHubiaSuggestionMessageRef = z.infer<typeof zHubiaSuggestionMessageRefSchema>;
+
+/** Desfecho da sugestão, gravado na execução que a gerou. */
+export const zHubiaSuggestionOutcomeSchema = z.object({
+  status: z.enum(['sent', 'sent_edited', 'discarded']),
+  mode: zHubiaResponseModeSchema.optional(),
+  by_user_id: z.string().nullable().optional(),
+  at: z.any(),
+}).passthrough();
+export type IHubiaSuggestionOutcome = z.infer<typeof zHubiaSuggestionOutcomeSchema>;
+
+/** Metadados da nota de voz gerada pela HubIA, gravados na mensagem. */
+export const zHubiaTtsMessageMetaSchema = z.object({
+  model: z.string(),
+  voice: z.string(),
+  format: z.enum(['ogg', 'mp3']),
+  chars: z.number(),
+  duration_seconds: z.number().nullable(),
+  execution_id: z.string().optional(),
+}).passthrough();
+export type IHubiaTtsMessageMeta = z.infer<typeof zHubiaTtsMessageMetaSchema>;
+
 export const zAiBindingSchema = zFireDocSchema.extend({
   agent_type: z.string(),            // 'evo-hubia-v1', future: 'evo-hubia-v2', etc.
   agent_config_id: z.string(),       // ref to the agent's channel config doc
@@ -447,6 +515,11 @@ export const zAiBindingSchema = zFireDocSchema.extend({
    *  com `hubia` em `usable_for`) usada neste departamento. Vence o
    *  `llm_connection_id` do canal. `null`/ausente = herda do canal. */
   llm_connection_id: z.string().nullable().optional(),
+
+  // ───── Resposta em áudio (feat-303) ─────
+  /** Ausente/`enabled: false` = HubIA só responde em texto. Exige o contrato
+   *  estruturado (`respond_to_contact`) ligado no canal. */
+  voice_reply: zHubiaVoiceReplySchema.optional(),
 }).passthrough();
 
 export type IAiBinding = z.infer<typeof zAiBindingSchema>;

package/dist/types/evo-reports/index.d.ts

@@ -32,6 +32,16 @@ export interface IUsageCapabilities {
      * desenhada antes dessa data, porque ausência de medição não é consumo zero.
      */
     telemedicine_since: string | null;
+    /**
+     * feat-302 F2 — transcrição de áudio medida (evento `media.transcription`).
+     * Opcional: produtor antigo não envia; ausente = série não desenhada.
+     */
+    transcription?: boolean;
+    /**
+     * Data (`YYYY-MM-DD`) do primeiro evento de transcrição medido (sem
+     * backfill). `null`/ausente antes do deploy do emissor.
+     */
+    transcription_since?: string | null;
 }
 /**
  * Uma linha da abertura por departamento dentro de um mês.
@@ -94,6 +104,46 @@ export interface IUsageLlm {
     tokens_output: number;
     tokens_cache_write: number;
     tokens_cache_read: number;
+    /**
+     * feat-302 F2 — custo ESTIMADO em US$ (preço de lista, `cost_usd_est` dos
+     * eventos). Informativo, não é fatura. `null` quando nenhum evento do mês tem
+     * preço conhecido. Opcional: produtor antigo não envia.
+     */
+    cost_usd_est?: number | null;
+    /**
+     * feat-302 F2 — quebra por categoria de produto (visão de custo por tenant).
+     * Só categorias com uso no mês aparecem. A soma bate com o total do bloco.
+     * Opcional: produtor antigo não envia.
+     */
+    por_categoria?: Partial<Record<UsageAiCategory, IUsageLlmCategory>>;
+}
+/**
+ * feat-302 F2 — categorias de uso de IA do TENANT (espelho de
+ * `AiUsageCategory` do `@evo/hubia`, sem as internas como `csq_judge`).
+ * - `hubia`: atendimento (turnos do LLM, reativação, busca de família).
+ * - `attachment_analysis`: leitura de foto/PDF pelo classificador de anexos.
+ * - `audio_synthesis`: resposta em áudio (reservada; ainda sem emissor).
+ */
+export type UsageAiCategory = "hubia" | "attachment_analysis" | "audio_synthesis";
+export interface IUsageLlmCategory {
+    /** Chamadas ao LLM nesta categoria (execuções/análises, dedup por evento). */
+    turnos: number;
+    tokens_total: number;
+    /** US$ estimado (preço de lista); `null` sem preço conhecido. */
+    cost_usd_est: number | null;
+}
+/**
+ * feat-302 F2 — transcrição de áudio no mês (Whisper; evento
+ * `media.transcription`, 1 por áudio, dedup por mensagem). Informativo: não é
+ * cobrado. Bloco `null` = capability desligada (não é consumo zero).
+ */
+export interface IUsageTranscription {
+    audios: number;
+    segundos: number;
+    /** `segundos / 60`, 2 casas. */
+    minutos: number;
+    /** US$ estimado (preço de lista); `null` sem duração/preço. */
+    cost_usd_est: number | null;
 }
 /**
  * Teleconsultas REALIZADAS no mês (feat-160 F18 / D33). Realizada = a consulta
@@ -119,6 +169,8 @@ export interface IMonthlyUsageRow {
     notificacoes: IUsageNotifications;
     ia: IUsageLlm | null;
     telemedicina: IUsageTelemedicine | null;
+    /** feat-302 F2 — opcional: produtor antigo não envia; `null` = capability desligada. */
+    transcricao?: IUsageTranscription | null;
 }
 export interface IMonthlyUsageResponse {
     ok: true;

package/dist/types/evo-reports/index.ts

@@ -48,6 +48,16 @@ export interface IUsageCapabilities {
    * desenhada antes dessa data, porque ausência de medição não é consumo zero.
    */
   telemedicine_since: string | null;
+  /**
+   * feat-302 F2 — transcrição de áudio medida (evento `media.transcription`).
+   * Opcional: produtor antigo não envia; ausente = série não desenhada.
+   */
+  transcription?: boolean;
+  /**
+   * Data (`YYYY-MM-DD`) do primeiro evento de transcrição medido (sem
+   * backfill). `null`/ausente antes do deploy do emissor.
+   */
+  transcription_since?: string | null;
 }
 
 /**
@@ -114,6 +124,49 @@ export interface IUsageLlm {
   tokens_output: number;
   tokens_cache_write: number;
   tokens_cache_read: number;
+  /**
+   * feat-302 F2 — custo ESTIMADO em US$ (preço de lista, `cost_usd_est` dos
+   * eventos). Informativo, não é fatura. `null` quando nenhum evento do mês tem
+   * preço conhecido. Opcional: produtor antigo não envia.
+   */
+  cost_usd_est?: number | null;
+  /**
+   * feat-302 F2 — quebra por categoria de produto (visão de custo por tenant).
+   * Só categorias com uso no mês aparecem. A soma bate com o total do bloco.
+   * Opcional: produtor antigo não envia.
+   */
+  por_categoria?: Partial<Record<UsageAiCategory, IUsageLlmCategory>>;
+}
+
+/**
+ * feat-302 F2 — categorias de uso de IA do TENANT (espelho de
+ * `AiUsageCategory` do `@evo/hubia`, sem as internas como `csq_judge`).
+ * - `hubia`: atendimento (turnos do LLM, reativação, busca de família).
+ * - `attachment_analysis`: leitura de foto/PDF pelo classificador de anexos.
+ * - `audio_synthesis`: resposta em áudio (reservada; ainda sem emissor).
+ */
+export type UsageAiCategory = "hubia" | "attachment_analysis" | "audio_synthesis";
+
+export interface IUsageLlmCategory {
+  /** Chamadas ao LLM nesta categoria (execuções/análises, dedup por evento). */
+  turnos: number;
+  tokens_total: number;
+  /** US$ estimado (preço de lista); `null` sem preço conhecido. */
+  cost_usd_est: number | null;
+}
+
+/**
+ * feat-302 F2 — transcrição de áudio no mês (Whisper; evento
+ * `media.transcription`, 1 por áudio, dedup por mensagem). Informativo: não é
+ * cobrado. Bloco `null` = capability desligada (não é consumo zero).
+ */
+export interface IUsageTranscription {
+  audios: number;
+  segundos: number;
+  /** `segundos / 60`, 2 casas. */
+  minutos: number;
+  /** US$ estimado (preço de lista); `null` sem duração/preço. */
+  cost_usd_est: number | null;
 }
 
 /**
@@ -141,6 +194,8 @@ export interface IMonthlyUsageRow {
   notificacoes: IUsageNotifications;
   ia: IUsageLlm | null;
   telemedicina: IUsageTelemedicine | null;
+  /** feat-302 F2 — opcional: produtor antigo não envia; `null` = capability desligada. */
+  transcricao?: IUsageTranscription | null;
 }
 
 export interface IMonthlyUsageResponse {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "evo360-types",
-  "version": "1.3.736",
+  "version": "1.3.748",
   "description": "HREVO360 Shared Types",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",