evo360-types 1.3.353 → 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>;
+}