evo360-types 1.3.354 → 1.3.355

package/dist/apps/evo-chat/chatbee/zod-schemas.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.zSendMessageResponseSchema = exports.zSendMessageRequestSchema = exports.zSendTemplateMessageRequestSchema = exports.zSendTextMessageRequestSchema = exports.zTemplateHeaderMediaSchema = exports.zTemplateButtonPayloadSchema = exports.zTemplateVariableSchema = exports.zChatbeeContactHistorySchema = exports.zChatbeeContactHistoryPayloadClosedSchema = exports.zChatbeeContactHistoryPayloadCreatedSchema = exports.zChatbeeContactSchema = exports.zChatbeeStatusSchema = exports.zChatbeeDepartmentSchema = exports.zChatbeeChannelSchema = exports.zChatBeeChannelConfigSchema = void 0;
+exports.zChatbeeNormalizedMessageSchema = exports.zChatbeeNormalizedInnerMessageSchema = exports.zChatbeeNormalizedMediaSchema = exports.zSendMessageResponseSchema = exports.zSendMessageRequestSchema = exports.zSendTemplateMessageRequestSchema = exports.zSendTextMessageRequestSchema = exports.zTemplateHeaderMediaSchema = exports.zTemplateButtonPayloadSchema = exports.zTemplateVariableSchema = exports.zChatbeeContactHistorySchema = exports.zChatbeeContactHistoryPayloadClosedSchema = exports.zChatbeeContactHistoryPayloadCreatedSchema = exports.zChatbeeContactSchema = exports.zChatbeeStatusSchema = exports.zChatbeeDepartmentSchema = exports.zChatbeeChannelSchema = exports.zChatBeeChannelConfigSchema = void 0;
 const zod_1 = require("zod");
 const zod_schemas_1 = require("../../shared/zod-schemas");
 const zod_schemas_2 = require("../../evo-hub-ia/channel/zod-schemas");
@@ -147,3 +147,75 @@ exports.zSendMessageResponseSchema = zod_1.z.object({
     message_id: zod_1.z.string().optional(),
     data: zod_1.z.any().optional(),
 });
+// ───────── ChatBee Normalized Message (input do tópico chatbee-messages-normalized) ─────────
+//
+// Publisher: Cloud Run `message-normalizer` em google-chat-functions/.
+// Consumer atual: BQ sink (`hr-evo360.chatbee.msgs_raw`).
+// Consumer futuro (S4): adapter `chatbee_inbound_to_hubia` em functions-chatbee.
+//
+// Validação confirmada com 12 amostras reais lidas do BQ em 2026-05-05.
+/** Tipo da mídia do Chatbee (se message.type !== 'text'). */
+exports.zChatbeeNormalizedMediaSchema = zod_1.z.object({
+    /** Bucket GCS onde o normalizer reuploadou a mídia. Confirmado em prod: `hr-evo360-evo-chat`. */
+    bucket: zod_1.z.string(),
+    /** Path no bucket (ex.: `tenants/{tenant}/{channel_uuid}/{contact_id}/document_{msg_id}.pdf`). */
+    path: zod_1.z.string(),
+    type: zod_1.z.string(),
+}).passthrough();
+/** Inner message do payload Chatbee normalizado. */
+exports.zChatbeeNormalizedInnerMessageSchema = zod_1.z.object({
+    /** ID Chatbee da mensagem (ex.: "249199900"). String mas formato numérico. */
+    id: zod_1.z.string(),
+    /** Texto OU URL signed do GCS para mídia. */
+    content: zod_1.z.string().default(""),
+    /** Direção semântica do payload. FILTRO ESSENCIAL no adapter — 'out' = eco. */
+    event: zod_1.z.enum(["in", "out"]),
+    type: zod_1.z.enum([
+        "text",
+        "audio",
+        "image",
+        "document",
+        "template",
+        "ptt",
+        "sticker",
+        "story_mention",
+        "video",
+        "vcard",
+    ]),
+    media: exports.zChatbeeNormalizedMediaSchema.optional(),
+}).passthrough();
+/** Mensagem completa publicada no tópico `chatbee-messages-normalized`. */
+exports.zChatbeeNormalizedMessageSchema = zod_1.z.object({
+    type: zod_1.z.literal("MESSAGE"),
+    channel: zod_1.z.object({
+        /** ID Chatbee — INTEGER em origem, mas castado para STRING na borda do adapter (DA-4). */
+        id: zod_1.z.union([zod_1.z.number(), zod_1.z.string()]).transform(v => String(v)),
+        /** Tenant slug — premissa P6 confiável (drabanzoli, clinica-moema, ...). */
+        external_id: zod_1.z.string(),
+        name: zod_1.z.string().optional(),
+    }).passthrough(),
+    contact: zod_1.z.object({
+        id: zod_1.z.union([zod_1.z.number(), zod_1.z.string()]).transform(v => String(v)),
+        name: zod_1.z.string().optional().default(""),
+        address: zod_1.z.string().optional().default(""),
+        type: zod_1.z.string().optional(),
+        external_id: zod_1.z.string().nullable().optional(),
+        is_group: zod_1.z.boolean().optional(),
+    }).passthrough(),
+    history: zod_1.z.object({
+        id: zod_1.z.union([zod_1.z.number(), zod_1.z.string()]).transform(v => String(v)),
+        channel_id: zod_1.z.union([zod_1.z.number(), zod_1.z.string()]).transform(v => String(v)),
+        is_out_of_office_hours: zod_1.z.boolean().optional(),
+        automatic: zod_1.z.boolean().optional(),
+    }).passthrough().optional(),
+    /** Populado quando operador humano envia (event=out + user.id) — sinal de presença para handoff (DA-10). */
+    user: zod_1.z.object({
+        id: zod_1.z.union([zod_1.z.number(), zod_1.z.string()]).transform(v => String(v)),
+        name: zod_1.z.string().optional(),
+        external_id: zod_1.z.string().nullable().optional(),
+    }).passthrough().optional(),
+    payload: zod_1.z.object({
+        message: exports.zChatbeeNormalizedInnerMessageSchema,
+    }).passthrough(),
+    timestamp: zod_1.z.string().optional(),
+}).passthrough();

package/dist/apps/evo-chat/chatbee/zod-schemas.ts

@@ -157,3 +157,83 @@ export const zSendMessageResponseSchema = z.object({
   message_id: z.string().optional(),
   data: z.any().optional(),
 });
+
+// ───────── ChatBee Normalized Message (input do tópico chatbee-messages-normalized) ─────────
+//
+// Publisher: Cloud Run `message-normalizer` em google-chat-functions/.
+// Consumer atual: BQ sink (`hr-evo360.chatbee.msgs_raw`).
+// Consumer futuro (S4): adapter `chatbee_inbound_to_hubia` em functions-chatbee.
+//
+// Validação confirmada com 12 amostras reais lidas do BQ em 2026-05-05.
+
+/** Tipo da mídia do Chatbee (se message.type !== 'text'). */
+export const zChatbeeNormalizedMediaSchema = z.object({
+  /** Bucket GCS onde o normalizer reuploadou a mídia. Confirmado em prod: `hr-evo360-evo-chat`. */
+  bucket: z.string(),
+  /** Path no bucket (ex.: `tenants/{tenant}/{channel_uuid}/{contact_id}/document_{msg_id}.pdf`). */
+  path: z.string(),
+  type: z.string(),
+}).passthrough();
+
+/** Inner message do payload Chatbee normalizado. */
+export const zChatbeeNormalizedInnerMessageSchema = z.object({
+  /** ID Chatbee da mensagem (ex.: "249199900"). String mas formato numérico. */
+  id: z.string(),
+  /** Texto OU URL signed do GCS para mídia. */
+  content: z.string().default(""),
+  /** Direção semântica do payload. FILTRO ESSENCIAL no adapter — 'out' = eco. */
+  event: z.enum(["in", "out"]),
+  type: z.enum([
+    "text",
+    "audio",
+    "image",
+    "document",
+    "template",
+    "ptt",
+    "sticker",
+    "story_mention",
+    "video",
+    "vcard",
+  ]),
+  media: zChatbeeNormalizedMediaSchema.optional(),
+}).passthrough();
+
+/** Mensagem completa publicada no tópico `chatbee-messages-normalized`. */
+export const zChatbeeNormalizedMessageSchema = z.object({
+  type: z.literal("MESSAGE"),
+  channel: z.object({
+    /** ID Chatbee — INTEGER em origem, mas castado para STRING na borda do adapter (DA-4). */
+    id: z.union([z.number(), z.string()]).transform(v => String(v)),
+    /** Tenant slug — premissa P6 confiável (drabanzoli, clinica-moema, ...). */
+    external_id: z.string(),
+    name: z.string().optional(),
+  }).passthrough(),
+  contact: z.object({
+    id: z.union([z.number(), z.string()]).transform(v => String(v)),
+    name: z.string().optional().default(""),
+    address: z.string().optional().default(""),
+    type: z.string().optional(),
+    external_id: z.string().nullable().optional(),
+    is_group: z.boolean().optional(),
+  }).passthrough(),
+  history: z.object({
+    id: z.union([z.number(), z.string()]).transform(v => String(v)),
+    channel_id: z.union([z.number(), z.string()]).transform(v => String(v)),
+    is_out_of_office_hours: z.boolean().optional(),
+    automatic: z.boolean().optional(),
+  }).passthrough().optional(),
+  /** Populado quando operador humano envia (event=out + user.id) — sinal de presença para handoff (DA-10). */
+  user: z.object({
+    id: z.union([z.number(), z.string()]).transform(v => String(v)),
+    name: z.string().optional(),
+    external_id: z.string().nullable().optional(),
+  }).passthrough().optional(),
+  payload: z.object({
+    message: zChatbeeNormalizedInnerMessageSchema,
+  }).passthrough(),
+  timestamp: z.string().optional(),
+}).passthrough();
+
+export type IChatbeeNormalizedMessage = z.infer<typeof zChatbeeNormalizedMessageSchema>;
+export type IChatbeeNormalizedInnerMessage = z.infer<typeof zChatbeeNormalizedInnerMessageSchema>;
+export type IChatbeeNormalizedMedia = z.infer<typeof zChatbeeNormalizedMediaSchema>;

package/dist/apps/evo-hub-ia/v1/adapter-tool-registry.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Adapter Tool Registry — DA-7 do plano hubia-chatbee.
+ *
+ * Tools com mesmo schema podem ter executores diferentes por provider:
+ *   - handoff_to_human (hub-waba escreve ticket v3; chatbee escreve em conversations/{X}.mode)
+ *   - transfer_to_department (idem)
+ *   - get_conversation_history (hub-waba lê threads v3; chatbee lê apps/evo-chatbee-adapter)
+ *
+ * Tools shared (get_lead, get_contact, schedule_*, etc.) operam em coleções neutras
+ * (evo-people, evo-crm, evo-cale) e ficam fora do registry — são sempre disponíveis.
+ *
+ * Interfaces puramente TS (não-zod) — executors são funções callable em runtime,
+ * não há shape estável para validação JSON.
+ */
+import type { IHubiaV1ChannelConfig } from "./zod-schemas";
+export type IAdapterProvider = "chatbee" | "hub-waba";
+export interface IAdapterToolDefinition {
+    /** Nome da tool conforme exposto ao Claude. Mesma string para tools compartilháveis entre adapters. */
+    name: string;
+    /** Descrição em inglês ou pt-BR — visível para o LLM. */
+    description: string;
+    /** JSON Schema Anthropic-compatible (objeto, properties, required, ...). */
+    input_schema: Record<string, unknown>;
+}
+export interface IToolExecutionContext {
+    tenant: string;
+    /** ID da conversation v3 (hub-waba) ou cb_<contactId> (chatbee). */
+    conversationId?: string;
+    contactId?: string;
+    channelId?: string;
+    threadId?: string;
+    ticketId?: string;
+    executionId?: string;
+    /** Snapshot da config hubia do canal — útil para tools provider-aware. */
+    cfg?: Partial<IHubiaV1ChannelConfig>;
+}
+export interface IToolExecutor {
+    execute(input: Record<string, unknown>, ctx: IToolExecutionContext): Promise<unknown>;
+}
+export interface IAdapterToolRegistry {
+    provider: IAdapterProvider;
+    /** Tools provider-specific definidas neste adapter. */
+    tools: IAdapterToolDefinition[];
+    /** Executores indexados por `tool.name`. */
+    executors: Record<string, IToolExecutor>;
+}

package/dist/apps/evo-hub-ia/v1/adapter-tool-registry.js

@@ -0,0 +1,16 @@
+"use strict";
+/**
+ * Adapter Tool Registry — DA-7 do plano hubia-chatbee.
+ *
+ * Tools com mesmo schema podem ter executores diferentes por provider:
+ *   - handoff_to_human (hub-waba escreve ticket v3; chatbee escreve em conversations/{X}.mode)
+ *   - transfer_to_department (idem)
+ *   - get_conversation_history (hub-waba lê threads v3; chatbee lê apps/evo-chatbee-adapter)
+ *
+ * Tools shared (get_lead, get_contact, schedule_*, etc.) operam em coleções neutras
+ * (evo-people, evo-crm, evo-cale) e ficam fora do registry — são sempre disponíveis.
+ *
+ * Interfaces puramente TS (não-zod) — executors são funções callable em runtime,
+ * não há shape estável para validação JSON.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/apps/evo-hub-ia/v1/adapter-tool-registry.ts

@@ -0,0 +1,55 @@
+/**
+ * Adapter Tool Registry — DA-7 do plano hubia-chatbee.
+ *
+ * Tools com mesmo schema podem ter executores diferentes por provider:
+ *   - handoff_to_human (hub-waba escreve ticket v3; chatbee escreve em conversations/{X}.mode)
+ *   - transfer_to_department (idem)
+ *   - get_conversation_history (hub-waba lê threads v3; chatbee lê apps/evo-chatbee-adapter)
+ *
+ * Tools shared (get_lead, get_contact, schedule_*, etc.) operam em coleções neutras
+ * (evo-people, evo-crm, evo-cale) e ficam fora do registry — são sempre disponíveis.
+ *
+ * Interfaces puramente TS (não-zod) — executors são funções callable em runtime,
+ * não há shape estável para validação JSON.
+ */
+
+import type { IHubiaV1ChannelConfig } from "./zod-schemas";
+
+export type IAdapterProvider = "chatbee" | "hub-waba";
+
+export interface IAdapterToolDefinition {
+  /** Nome da tool conforme exposto ao Claude. Mesma string para tools compartilháveis entre adapters. */
+  name: string;
+  /** Descrição em inglês ou pt-BR — visível para o LLM. */
+  description: string;
+  /** JSON Schema Anthropic-compatible (objeto, properties, required, ...). */
+  input_schema: Record<string, unknown>;
+}
+
+export interface IToolExecutionContext {
+  tenant: string;
+  /** ID da conversation v3 (hub-waba) ou cb_<contactId> (chatbee). */
+  conversationId?: string;
+  contactId?: string;
+  channelId?: string;
+  threadId?: string;
+  ticketId?: string;
+  executionId?: string;
+  /** Snapshot da config hubia do canal — útil para tools provider-aware. */
+  cfg?: Partial<IHubiaV1ChannelConfig>;
+}
+
+export interface IToolExecutor {
+  execute(
+    input: Record<string, unknown>,
+    ctx: IToolExecutionContext,
+  ): Promise<unknown>;
+}
+
+export interface IAdapterToolRegistry {
+  provider: IAdapterProvider;
+  /** Tools provider-specific definidas neste adapter. */
+  tools: IAdapterToolDefinition[];
+  /** Executores indexados por `tool.name`. */
+  executors: Record<string, IToolExecutor>;
+}

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

@@ -121,6 +121,16 @@ export declare const zHubiaV1ChannelConfigSchema: z.ZodObject<{
         can_read_finops?: boolean | undefined;
     }>>;
     timezone: z.ZodDefault<z.ZodString>;
+    /** Provider que entrega mensagens deste canal. Quando ausente, runtime assume 'hub-waba' (back-compat). */
+    provider: z.ZodOptional<z.ZodEnum<["chatbee", "hub-waba"]>>;
+    /** Para provider='chatbee': id do canal no Chatbee (numérico stringificado). */
+    chatbee_channel_id: z.ZodOptional<z.ZodString>;
+    /** Para provider='chatbee': company_id que resolve a API key do Chatbee. */
+    chatbee_company_id: z.ZodOptional<z.ZodNumber>;
+    /** Department padrão para AI router. Para Chatbee, único caminho (não há canal v3). Para hub-waba, fallback caso ticket não tenha department. */
+    default_department_id: z.ZodOptional<z.ZodString>;
+    /** Quantidade máxima de mensagens carregadas pela tool `get_conversation_history` (auto-injection). Default runtime: 30. */
+    history_size: z.ZodOptional<z.ZodNumber>;
 }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
     id: z.ZodString;
     ref: z.ZodAny;
@@ -241,6 +251,16 @@ export declare const zHubiaV1ChannelConfigSchema: z.ZodObject<{
         can_read_finops?: boolean | undefined;
     }>>;
     timezone: z.ZodDefault<z.ZodString>;
+    /** Provider que entrega mensagens deste canal. Quando ausente, runtime assume 'hub-waba' (back-compat). */
+    provider: z.ZodOptional<z.ZodEnum<["chatbee", "hub-waba"]>>;
+    /** Para provider='chatbee': id do canal no Chatbee (numérico stringificado). */
+    chatbee_channel_id: z.ZodOptional<z.ZodString>;
+    /** Para provider='chatbee': company_id que resolve a API key do Chatbee. */
+    chatbee_company_id: z.ZodOptional<z.ZodNumber>;
+    /** Department padrão para AI router. Para Chatbee, único caminho (não há canal v3). Para hub-waba, fallback caso ticket não tenha department. */
+    default_department_id: z.ZodOptional<z.ZodString>;
+    /** Quantidade máxima de mensagens carregadas pela tool `get_conversation_history` (auto-injection). Default runtime: 30. */
+    history_size: z.ZodOptional<z.ZodNumber>;
 }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
     id: z.ZodString;
     ref: z.ZodAny;
@@ -361,8 +381,92 @@ export declare const zHubiaV1ChannelConfigSchema: z.ZodObject<{
         can_read_finops?: boolean | undefined;
     }>>;
     timezone: z.ZodDefault<z.ZodString>;
+    /** Provider que entrega mensagens deste canal. Quando ausente, runtime assume 'hub-waba' (back-compat). */
+    provider: z.ZodOptional<z.ZodEnum<["chatbee", "hub-waba"]>>;
+    /** Para provider='chatbee': id do canal no Chatbee (numérico stringificado). */
+    chatbee_channel_id: z.ZodOptional<z.ZodString>;
+    /** Para provider='chatbee': company_id que resolve a API key do Chatbee. */
+    chatbee_company_id: z.ZodOptional<z.ZodNumber>;
+    /** Department padrão para AI router. Para Chatbee, único caminho (não há canal v3). Para hub-waba, fallback caso ticket não tenha department. */
+    default_department_id: z.ZodOptional<z.ZodString>;
+    /** Quantidade máxima de mensagens carregadas pela tool `get_conversation_history` (auto-injection). Default runtime: 30. */
+    history_size: z.ZodOptional<z.ZodNumber>;
 }, z.ZodTypeAny, "passthrough">>;
 export type IHubiaV1ChannelConfig = z.infer<typeof zHubiaV1ChannelConfigSchema>;
+export declare const zHubiaConversationMessageSchema: z.ZodObject<{
+    id: z.ZodString;
+    direction: z.ZodEnum<["in", "out"]>;
+    /** Role pronto para LLM (Anthropic messages API). */
+    role: z.ZodEnum<["user", "assistant"]>;
+    text: z.ZodDefault<z.ZodString>;
+    type: z.ZodDefault<z.ZodEnum<["text", "audio", "image", "document", "event"]>>;
+    audio_transcript: z.ZodOptional<z.ZodString>;
+    source: z.ZodEnum<["patient", "ai", "operator", "n8n"]>;
+    provider: z.ZodEnum<["chatbee", "hub-waba"]>;
+    provider_message_id: z.ZodString;
+    execution_id: z.ZodOptional<z.ZodString>;
+    created_by: z.ZodOptional<z.ZodObject<{
+        user_id: z.ZodOptional<z.ZodString>;
+        agent: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        agent?: string | undefined;
+        user_id?: string | undefined;
+    }, {
+        agent?: string | undefined;
+        user_id?: string | undefined;
+    }>>;
+    /** Timestamp do payload original — NÃO serverTimestamp (preserva ordem cronológica real). */
+    occurred_at: z.ZodAny;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    id: z.ZodString;
+    direction: z.ZodEnum<["in", "out"]>;
+    /** Role pronto para LLM (Anthropic messages API). */
+    role: z.ZodEnum<["user", "assistant"]>;
+    text: z.ZodDefault<z.ZodString>;
+    type: z.ZodDefault<z.ZodEnum<["text", "audio", "image", "document", "event"]>>;
+    audio_transcript: z.ZodOptional<z.ZodString>;
+    source: z.ZodEnum<["patient", "ai", "operator", "n8n"]>;
+    provider: z.ZodEnum<["chatbee", "hub-waba"]>;
+    provider_message_id: z.ZodString;
+    execution_id: z.ZodOptional<z.ZodString>;
+    created_by: z.ZodOptional<z.ZodObject<{
+        user_id: z.ZodOptional<z.ZodString>;
+        agent: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        agent?: string | undefined;
+        user_id?: string | undefined;
+    }, {
+        agent?: string | undefined;
+        user_id?: string | undefined;
+    }>>;
+    /** Timestamp do payload original — NÃO serverTimestamp (preserva ordem cronológica real). */
+    occurred_at: z.ZodAny;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    id: z.ZodString;
+    direction: z.ZodEnum<["in", "out"]>;
+    /** Role pronto para LLM (Anthropic messages API). */
+    role: z.ZodEnum<["user", "assistant"]>;
+    text: z.ZodDefault<z.ZodString>;
+    type: z.ZodDefault<z.ZodEnum<["text", "audio", "image", "document", "event"]>>;
+    audio_transcript: z.ZodOptional<z.ZodString>;
+    source: z.ZodEnum<["patient", "ai", "operator", "n8n"]>;
+    provider: z.ZodEnum<["chatbee", "hub-waba"]>;
+    provider_message_id: z.ZodString;
+    execution_id: z.ZodOptional<z.ZodString>;
+    created_by: z.ZodOptional<z.ZodObject<{
+        user_id: z.ZodOptional<z.ZodString>;
+        agent: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        agent?: string | undefined;
+        user_id?: string | undefined;
+    }, {
+        agent?: string | undefined;
+        user_id?: string | undefined;
+    }>>;
+    /** Timestamp do payload original — NÃO serverTimestamp (preserva ordem cronológica real). */
+    occurred_at: z.ZodAny;
+}, z.ZodTypeAny, "passthrough">>;
+export type IHubiaConversationMessage = z.infer<typeof zHubiaConversationMessageSchema>;
 export declare const zHubiaConversationModeSchema: z.ZodEnum<["ai_only", "hybrid_assist", "human_only", "blocked"]>;
 export type IHubiaConversationMode = z.infer<typeof zHubiaConversationModeSchema>;
 export declare const zAiBindingSchema: z.ZodObject<{

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.zAiBindingSchema = exports.zHubiaConversationModeSchema = exports.zHubiaV1ChannelConfigSchema = exports.zHubiaAttendanceModeSchema = void 0;
+exports.zAiBindingSchema = exports.zHubiaConversationModeSchema = exports.zHubiaConversationMessageSchema = exports.zHubiaV1ChannelConfigSchema = exports.zHubiaAttendanceModeSchema = void 0;
 const zod_1 = require("zod");
 const zod_schemas_1 = require("../../shared/zod-schemas");
 // ───────── Attendance Mode (how AI operates on this channel) ─────────
@@ -43,6 +43,41 @@ exports.zHubiaV1ChannelConfigSchema = zod_schemas_1.zFireDocSchema.extend({
         can_read_finops: zod_1.z.boolean().default(false),
     }).optional(),
     timezone: zod_1.z.string().default("America/Sao_Paulo"),
+    // ───── Multi-provider (chatbee adapter) ─────
+    /** Provider que entrega mensagens deste canal. Quando ausente, runtime assume 'hub-waba' (back-compat). */
+    provider: zod_1.z.enum(["chatbee", "hub-waba"]).optional(),
+    /** Para provider='chatbee': id do canal no Chatbee (numérico stringificado). */
+    chatbee_channel_id: zod_1.z.string().optional(),
+    /** Para provider='chatbee': company_id que resolve a API key do Chatbee. */
+    chatbee_company_id: zod_1.z.number().optional(),
+    /** Department padrão para AI router. Para Chatbee, único caminho (não há canal v3). Para hub-waba, fallback caso ticket não tenha department. */
+    default_department_id: zod_1.z.string().optional(),
+    /** Quantidade máxima de mensagens carregadas pela tool `get_conversation_history` (auto-injection). Default runtime: 30. */
+    history_size: zod_1.z.number().int().positive().optional(),
+}).passthrough();
+// ───────── Conversation Message (histórico provider-agnostic) ─────────
+//
+// Schema usado pela tool `get_conversation_history` (DA-7/DA-8).
+// Hub-waba lê de `apps/evo-chat/threads/{tid}/messages` (v3 existente).
+// Chatbee lê de `apps/evo-chatbee-adapter/conversations/{cb}/messages` (criada pelo adapter).
+exports.zHubiaConversationMessageSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    direction: zod_1.z.enum(["in", "out"]),
+    /** Role pronto para LLM (Anthropic messages API). */
+    role: zod_1.z.enum(["user", "assistant"]),
+    text: zod_1.z.string().default(""),
+    type: zod_1.z.enum(["text", "audio", "image", "document", "event"]).default("text"),
+    audio_transcript: zod_1.z.string().optional(),
+    source: zod_1.z.enum(["patient", "ai", "operator", "n8n"]),
+    provider: zod_1.z.enum(["chatbee", "hub-waba"]),
+    provider_message_id: zod_1.z.string(),
+    execution_id: zod_1.z.string().optional(),
+    created_by: zod_1.z.object({
+        user_id: zod_1.z.string().optional(),
+        agent: zod_1.z.string().optional(),
+    }).optional(),
+    /** Timestamp do payload original — NÃO serverTimestamp (preserva ordem cronológica real). */
+    occurred_at: zod_1.z.any(),
 }).passthrough();
 // ───────── Conversation Mode ─────────
 exports.zHubiaConversationModeSchema = zod_1.z.enum(["ai_only", "hybrid_assist", "human_only", "blocked"]);

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

@@ -46,10 +46,50 @@ export const zHubiaV1ChannelConfigSchema = zFireDocSchema.extend({
     can_read_finops: z.boolean().default(false),
   }).optional(),
   timezone: z.string().default("America/Sao_Paulo"),
+
+  // ───── Multi-provider (chatbee adapter) ─────
+  /** Provider que entrega mensagens deste canal. Quando ausente, runtime assume 'hub-waba' (back-compat). */
+  provider: z.enum(["chatbee", "hub-waba"]).optional(),
+  /** Para provider='chatbee': id do canal no Chatbee (numérico stringificado). */
+  chatbee_channel_id: z.string().optional(),
+  /** Para provider='chatbee': company_id que resolve a API key do Chatbee. */
+  chatbee_company_id: z.number().optional(),
+  /** Department padrão para AI router. Para Chatbee, único caminho (não há canal v3). Para hub-waba, fallback caso ticket não tenha department. */
+  default_department_id: z.string().optional(),
+  /** Quantidade máxima de mensagens carregadas pela tool `get_conversation_history` (auto-injection). Default runtime: 30. */
+  history_size: z.number().int().positive().optional(),
 }).passthrough();
 
 export type IHubiaV1ChannelConfig = z.infer<typeof zHubiaV1ChannelConfigSchema>;
 
+// ───────── Conversation Message (histórico provider-agnostic) ─────────
+//
+// Schema usado pela tool `get_conversation_history` (DA-7/DA-8).
+// Hub-waba lê de `apps/evo-chat/threads/{tid}/messages` (v3 existente).
+// Chatbee lê de `apps/evo-chatbee-adapter/conversations/{cb}/messages` (criada pelo adapter).
+
+export const zHubiaConversationMessageSchema = z.object({
+  id: z.string(),
+  direction: z.enum(["in", "out"]),
+  /** Role pronto para LLM (Anthropic messages API). */
+  role: z.enum(["user", "assistant"]),
+  text: z.string().default(""),
+  type: z.enum(["text", "audio", "image", "document", "event"]).default("text"),
+  audio_transcript: z.string().optional(),
+  source: z.enum(["patient", "ai", "operator", "n8n"]),
+  provider: z.enum(["chatbee", "hub-waba"]),
+  provider_message_id: z.string(),
+  execution_id: z.string().optional(),
+  created_by: z.object({
+    user_id: z.string().optional(),
+    agent: z.string().optional(),
+  }).optional(),
+  /** Timestamp do payload original — NÃO serverTimestamp (preserva ordem cronológica real). */
+  occurred_at: z.any(),
+}).passthrough();
+
+export type IHubiaConversationMessage = z.infer<typeof zHubiaConversationMessageSchema>;
+
 // ───────── Conversation Mode ─────────
 
 export const zHubiaConversationModeSchema = z.enum(["ai_only", "hybrid_assist", "human_only", "blocked"]);

package/dist/index.d.ts

@@ -46,6 +46,7 @@ export * from "./apps/evo-chat/waba-setup/zod-schemas";
 export * from "./apps/evo-chat/quick-reply/zod-schemas";
 export * from "./apps/evo-hub-ia/channel/zod-schemas";
 export * from "./apps/evo-hub-ia/v1/zod-schemas";
+export * from "./apps/evo-hub-ia/v1/adapter-tool-registry";
 export * from "./apps/evo-med/calendar/zod-schemas";
 export * from "./apps/evo-med/appointment/zod-schemas";
 export * from "./apps/evo-med/dic/zod-schemas";

package/dist/index.js

@@ -64,6 +64,7 @@ __exportStar(require("./apps/evo-chat/waba-setup/zod-schemas"), exports);
 __exportStar(require("./apps/evo-chat/quick-reply/zod-schemas"), exports);
 __exportStar(require("./apps/evo-hub-ia/channel/zod-schemas"), exports);
 __exportStar(require("./apps/evo-hub-ia/v1/zod-schemas"), exports);
+__exportStar(require("./apps/evo-hub-ia/v1/adapter-tool-registry"), exports);
 __exportStar(require("./apps/evo-med/calendar/zod-schemas"), exports);
 __exportStar(require("./apps/evo-med/appointment/zod-schemas"), exports);
 __exportStar(require("./apps/evo-med/dic/zod-schemas"), exports);

package/dist/index.ts

@@ -49,6 +49,7 @@ export * from "./apps/evo-chat/waba-setup/zod-schemas";
 export * from "./apps/evo-chat/quick-reply/zod-schemas";
 export * from "./apps/evo-hub-ia/channel/zod-schemas";
 export * from "./apps/evo-hub-ia/v1/zod-schemas";
+export * from "./apps/evo-hub-ia/v1/adapter-tool-registry";
 export * from "./apps/evo-med/calendar/zod-schemas";
 export * from "./apps/evo-med/appointment/zod-schemas";
 export * from "./apps/evo-med/dic/zod-schemas";

package/package.json

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