@hed-hog/core 0.0.387 → 0.0.393

package/dist/mailbox/mailbox-fetcher.registry.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Uma mensagem recebida, ainda crua.
+ *
+ * O fetcher devolve o MIME e nada mais. Interpretar (parsear cabeçalhos, cortar
+ * citação, decidir se é autoresposta) é do consumidor — assim os dois provedores
+ * compartilham exatamente o mesmo caminho de leitura, e o core não precisa
+ * conhecer mailparser nem as regras de atendimento.
+ */
+export interface RawInboundMessage {
+    /**
+     * Identidade da mensagem no provedor (Message-Id, id do Graph).
+     * É a chave de idempotência de quem consome.
+     */
+    externalId: string;
+    /** Mensagem RFC 822 completa. */
+    source: Buffer;
+    receivedAt: Date;
+}
+export interface MailboxFetchTarget {
+    /** Perfil de integração com as credenciais. */
+    integrationProfileId: number;
+    /** Endereço monitorado. No Graph, é também o alvo do acesso app-only. */
+    address: string;
+    folder: string;
+    /**
+     * Cursor OPACO, como o fetcher o gravou da última vez.
+     *
+     * Cada provedor escolhe o formato — UID + UIDVALIDITY no IMAP, deltaLink no
+     * Graph. Manter isso opaco é o que permite um campo só no banco servir aos
+     * dois sem o consumidor entender nenhum dos dois.
+     */
+    cursor: string | null;
+    markAsRead: boolean;
+    /** Teto por ciclo, para uma caixa esquecida não virar um poll infinito. */
+    maxMessages: number;
+}
+export interface MailboxFetchResult {
+    messages: RawInboundMessage[];
+    /** Cursor a gravar DEPOIS que as mensagens forem persistidas. */
+    cursor: string | null;
+    /**
+     * O provedor invalidou o cursor anterior (UIDVALIDITY novo, delta expirado).
+     * Serve para o consumidor registrar o fato — a releitura em si já vem
+     * resolvida no resultado.
+     */
+    cursorReset: boolean;
+}
+/** Resultado de um teste de leitura, no mesmo formato do `MailVerifyResult`. */
+export interface MailboxVerifyResult {
+    ok: boolean;
+    /** Evidência legível do sucesso. Nunca contém credencial. */
+    info?: string;
+    /** Motivo legível da falha. Nunca contém credencial. */
+    error?: string;
+}
+/**
+ * Lê uma caixa de correio.
+ *
+ * Implementações vivem nas libraries donas do protocolo (IMAP no `sac`,
+ * Microsoft Graph no `microsoft`) e se registram aqui no boot.
+ */
+export interface IMailboxFetcher {
+    /** Falso quando o provedor está desligado ou mal configurado nesta instalação. */
+    isAvailable(): Promise<boolean>;
+    fetch(target: MailboxFetchTarget): Promise<MailboxFetchResult>;
+    /**
+     * Confere se ESTA caixa pode ser lida agora, exercitando o caminho real.
+     *
+     * Existe porque testar o perfil de integração não é a mesma coisa que testar a
+     * caixa: para o Entra, o teste do perfil só pede um token e passa mesmo sem
+     * permissão de e-mail, sem acesso àquele endereço e sem a pasta existir — ou
+     * seja, aprovaria uma caixa que nunca vai receber nada.
+     *
+     * Opcional: sem ela, o chamador cai no testador do perfil (o que basta para o
+     * IMAP, onde autenticar já prova o acesso).
+     */
+    verify?(target: MailboxFetchTarget): Promise<MailboxVerifyResult>;
+}
+/**
+ * Registro dos leitores de caixa, no mesmo padrão do MeetingProviderRegistry.
+ *
+ * Existe pelo mesmo motivo daquele: permitir que um módulo de negócio leia uma
+ * caixa do Microsoft 365 sem depender de `@hed-hog-pro/microsoft` — o que
+ * arrastaria as tabelas, as rotas e os crons daquela library para toda
+ * instalação, só para obter um token.
+ *
+ * A chave é o SLUG DO PROVIDER DE INTEGRAÇÃO (`imap`,
+ * `microsoft-entra-id-oauth`), então o caminho perfil → fetcher se resolve sem
+ * nenhuma tabela de-para.
+ */
+export declare class MailboxFetcherRegistry {
+    private readonly logger;
+    private readonly fetchers;
+    register(providerSlug: string, implementation: IMailboxFetcher): void;
+    get(providerSlug: string | null | undefined): IMailboxFetcher | null;
+    has(providerSlug: string | null | undefined): boolean;
+    /** Providers que sabem ler caixa nesta instalação (a UI filtra por isto). */
+    list(): string[];
+}
+//# sourceMappingURL=mailbox-fetcher.registry.d.ts.map

package/dist/mailbox/mailbox-fetcher.registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailbox-fetcher.registry.d.ts","sourceRoot":"","sources":["../../src/mailbox/mailbox-fetcher.registry.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,+CAA+C;IAC/C,oBAAoB,EAAE,MAAM,CAAC;IAC7B,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf;;;;;;OAMG;IACH,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,2EAA2E;IAC3E,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,iEAAiE;IACjE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB;;;;OAIG;IACH,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,gFAAgF;AAChF,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,OAAO,CAAC;IACZ,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,kFAAkF;IAClF,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,KAAK,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC/D;;;;;;;;;;OAUG;IACH,MAAM,CAAC,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACnE;AAED;;;;;;;;;;;GAWG;AACH,qBACa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2C;IAClE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsC;IAE/D,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,eAAe,GAAG,IAAI;IAYrE,GAAG,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,eAAe,GAAG,IAAI;IAKpE,GAAG,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO;IAIrD,6EAA6E;IAC7E,IAAI,IAAI,MAAM,EAAE;CAGjB"}

package/dist/mailbox/mailbox-fetcher.registry.js

@@ -0,0 +1,59 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var MailboxFetcherRegistry_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MailboxFetcherRegistry = void 0;
+const common_1 = require("@nestjs/common");
+/**
+ * Registro dos leitores de caixa, no mesmo padrão do MeetingProviderRegistry.
+ *
+ * Existe pelo mesmo motivo daquele: permitir que um módulo de negócio leia uma
+ * caixa do Microsoft 365 sem depender de `@hed-hog-pro/microsoft` — o que
+ * arrastaria as tabelas, as rotas e os crons daquela library para toda
+ * instalação, só para obter um token.
+ *
+ * A chave é o SLUG DO PROVIDER DE INTEGRAÇÃO (`imap`,
+ * `microsoft-entra-id-oauth`), então o caminho perfil → fetcher se resolve sem
+ * nenhuma tabela de-para.
+ */
+let MailboxFetcherRegistry = MailboxFetcherRegistry_1 = class MailboxFetcherRegistry {
+    constructor() {
+        this.logger = new common_1.Logger(MailboxFetcherRegistry_1.name);
+        this.fetchers = new Map();
+    }
+    register(providerSlug, implementation) {
+        const key = normalizeProvider(providerSlug);
+        if (!key)
+            throw new Error('Mailbox fetcher provider key is required.');
+        if (this.fetchers.has(key)) {
+            this.logger.warn(`Mailbox fetcher "${key}" was overwritten.`);
+        }
+        this.fetchers.set(key, implementation);
+        this.logger.log(`Registered mailbox fetcher "${key}"`);
+    }
+    get(providerSlug) {
+        var _a;
+        const key = normalizeProvider(providerSlug);
+        return key ? ((_a = this.fetchers.get(key)) !== null && _a !== void 0 ? _a : null) : null;
+    }
+    has(providerSlug) {
+        return this.get(providerSlug) !== null;
+    }
+    /** Providers que sabem ler caixa nesta instalação (a UI filtra por isto). */
+    list() {
+        return [...this.fetchers.keys()].sort();
+    }
+};
+exports.MailboxFetcherRegistry = MailboxFetcherRegistry;
+exports.MailboxFetcherRegistry = MailboxFetcherRegistry = MailboxFetcherRegistry_1 = __decorate([
+    (0, common_1.Injectable)()
+], MailboxFetcherRegistry);
+function normalizeProvider(providerSlug) {
+    return String(providerSlug !== null && providerSlug !== void 0 ? providerSlug : '').trim().toLowerCase();
+}
+//# sourceMappingURL=mailbox-fetcher.registry.js.map

package/dist/mailbox/mailbox-fetcher.registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailbox-fetcher.registry.js","sourceRoot":"","sources":["../../src/mailbox/mailbox-fetcher.registry.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAoD;AAqFpD;;;;;;;;;;;GAWG;AAEI,IAAM,sBAAsB,8BAA5B,MAAM,sBAAsB;IAA5B;QACY,WAAM,GAAG,IAAI,eAAM,CAAC,wBAAsB,CAAC,IAAI,CAAC,CAAC;QACjD,aAAQ,GAAG,IAAI,GAAG,EAA2B,CAAC;IA2BjE,CAAC;IAzBC,QAAQ,CAAC,YAAoB,EAAE,cAA+B;QAC5D,MAAM,GAAG,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAC;QAC5C,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAEvE,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,oBAAoB,GAAG,oBAAoB,CAAC,CAAC;QAChE,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,+BAA+B,GAAG,GAAG,CAAC,CAAC;IACzD,CAAC;IAED,GAAG,CAAC,YAAuC;;QACzC,MAAM,GAAG,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAC;QAC5C,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,MAAA,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,mCAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACvD,CAAC;IAED,GAAG,CAAC,YAAuC;QACzC,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC;IACzC,CAAC;IAED,6EAA6E;IAC7E,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1C,CAAC;CACF,CAAA;AA7BY,wDAAsB;iCAAtB,sBAAsB;IADlC,IAAA,mBAAU,GAAE;GACA,sBAAsB,CA6BlC;AAED,SAAS,iBAAiB,CAAC,YAAuC;IAChE,OAAO,MAAM,CAAC,YAAY,aAAZ,YAAY,cAAZ,YAAY,GAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AACzD,CAAC"}

package/dist/mailbox/mailbox.module.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Porta genérica de leitura de caixa de correio. Só carrega o registro — as
+ * implementações vêm de quem se registrar no boot (a library `sac` com a chave
+ * `imap`, a library `microsoft` com `microsoft-entra-id-oauth`).
+ */
+export declare class MailboxModule {
+}
+//# sourceMappingURL=mailbox.module.d.ts.map

package/dist/mailbox/mailbox.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailbox.module.d.ts","sourceRoot":"","sources":["../../src/mailbox/mailbox.module.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,qBAKa,aAAa;CAAG"}

package/dist/mailbox/mailbox.module.js

@@ -0,0 +1,27 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MailboxModule = void 0;
+const common_1 = require("@nestjs/common");
+const mailbox_fetcher_registry_1 = require("./mailbox-fetcher.registry");
+/**
+ * Porta genérica de leitura de caixa de correio. Só carrega o registro — as
+ * implementações vêm de quem se registrar no boot (a library `sac` com a chave
+ * `imap`, a library `microsoft` com `microsoft-entra-id-oauth`).
+ */
+let MailboxModule = class MailboxModule {
+};
+exports.MailboxModule = MailboxModule;
+exports.MailboxModule = MailboxModule = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({
+        providers: [mailbox_fetcher_registry_1.MailboxFetcherRegistry],
+        exports: [mailbox_fetcher_registry_1.MailboxFetcherRegistry],
+    })
+], MailboxModule);
+//# sourceMappingURL=mailbox.module.js.map

package/dist/mailbox/mailbox.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailbox.module.js","sourceRoot":"","sources":["../../src/mailbox/mailbox.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAgD;AAChD,yEAAoE;AAEpE;;;;GAIG;AAMI,IAAM,aAAa,GAAnB,MAAM,aAAa;CAAG,CAAA;AAAhB,sCAAa;wBAAb,aAAa;IALzB,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC;QACN,SAAS,EAAE,CAAC,iDAAsB,CAAC;QACnC,OAAO,EAAE,CAAC,iDAAsB,CAAC;KAClC,CAAC;GACW,aAAa,CAAG"}

package/dist/mcp-chat/mcp-chat.controller.d.ts

@@ -34,8 +34,8 @@ export declare class McpChatController {
         id: number;
         created_at: Date;
         updated_at: Date;
-        content: string;
         role: import("@prisma/client").$Enums.mcp_conversation_message_role_422a6ea954_enum;
+        content: string;
         tool_name: string | null;
         conversation_id: number;
         tool_call_id: string | null;
@@ -46,8 +46,8 @@ export declare class McpChatController {
         id: number;
         created_at: Date;
         updated_at: Date;
-        content: string;
         role: import("@prisma/client").$Enums.mcp_conversation_message_role_422a6ea954_enum;
+        content: string;
         tool_name: string | null;
         conversation_id: number;
         tool_call_id: string | null;

package/dist/mcp-chat/mcp-chat.service.d.ts

@@ -32,8 +32,8 @@ export declare class McpChatService {
         id: number;
         created_at: Date;
         updated_at: Date;
-        content: string;
         role: import("@prisma/client").$Enums.mcp_conversation_message_role_422a6ea954_enum;
+        content: string;
         tool_name: string | null;
         conversation_id: number;
         tool_call_id: string | null;
@@ -42,18 +42,40 @@ export declare class McpChatService {
         id: number;
         created_at: Date;
         updated_at: Date;
-        content: string;
         role: import("@prisma/client").$Enums.mcp_conversation_message_role_422a6ea954_enum;
+        content: string;
         tool_name: string | null;
         conversation_id: number;
         tool_call_id: string | null;
     }[]>;
+    /**
+     * Composes the system prompt from the stored layers.
+     *
+     * `moduleSlug`/`agentSlug` activate the L3/L4 layers; without them the seeded
+     * `module.*` and `agent.*` instructions are never read. `SYSTEM_PROMPT_FALLBACK`
+     * used to be duplicated here — it now comes from `AiInstructionService`, which
+     * already falls back internally, so this only guards against the whole build
+     * throwing.
+     */
     private getSystemPrompt;
+    /**
+     * Loop de tool calling no formato OpenAI. Serve tanto para a OpenAI quanto
+     * para o DeepSeek, que expõe a mesma API de `/chat/completions` (inclusive
+     * `tools`/`tool_calls`) — muda só a base URL, o modelo e a chave.
+     */
     private runOpenAiLoop;
     private runGeminiLoop;
     private toOpenAiMessages;
     private toGeminiContents;
     private assertOwnership;
+    /**
+     * Resolve credenciais e modelo do chat MCP a partir do perfil de integração
+     * apontado pela setting `mcp-ai-profile-id`.
+     *
+     * O `model` segue a mesma precedência do resto do codebase — aqui sem o degrau
+     * de `ai_instruction`, porque este fluxo não tem prompt de task próprio:
+     * `integration_profile.config.model` > constante de default do provider.
+     */
     private getProviderKey;
     private buildOpenAiTools;
     private buildGeminiTools;

package/dist/mcp-chat/mcp-chat.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-chat.service.d.ts","sourceRoot":"","sources":["../../src/mcp-chat/mcp-chat.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAapD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AAErF,OAAO,EAAE,kBAAkB,EAAgB,MAAM,6BAA6B,CAAC;AAE/E,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AA6NtE,qBACa,cAAc;IAKvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAEvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAExB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAEzB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAE9B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAZ9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmC;gBAIvC,MAAM,EAAE,aAAa,EAErB,OAAO,EAAE,cAAc,EAEvB,QAAQ,EAAE,kBAAkB,EAE5B,aAAa,EAAE,sBAAsB,EAErC,WAAW,EAAE,kBAAkB;IAG5C,iBAAiB,CAAC,MAAM,EAAE,MAAM;;;;;;IAQhC,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,qBAAqB;;;;;;;IAS7D,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE;;;IAOjD,WAAW,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;;;;;;;;;;IAQlD,WAAW,CACf,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM;;;;;;;;;;YAiDH,eAAe;YAaf,aAAa;YAmNb,aAAa;IAsL3B,OAAO,CAAC,gBAAgB;IA0CxB,OAAO,CAAC,gBAAgB;YAyDV,eAAe;YAaf,cAAc;YA6Bd,gBAAgB;YAShB,gBAAgB;YAmBhB,iBAAiB;YAoIjB,sBAAsB;IAyBpC,OAAO,CAAC,uBAAuB;IAa/B,OAAO,CAAC,eAAe;IAuCvB,OAAO,CAAC,mBAAmB;IAgB3B,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,gBAAgB;IAyCxB,OAAO,CAAC,mBAAmB;IAe3B,OAAO,CAAC,6BAA6B;IAwCrC,OAAO,CAAC,cAAc;IA6BtB,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,uBAAuB;IA8B/B,OAAO,CAAC,2BAA2B;IAMnC,OAAO,CAAC,iCAAiC;IAwBzC,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,cAAc;IAetB,OAAO,CAAC,kBAAkB;IAM1B,OAAO,CAAC,kBAAkB;YAUZ,+BAA+B;IAkB7C,OAAO,CAAC,oBAAoB;CAsB7B"}
+{"version":3,"file":"mcp-chat.service.d.ts","sourceRoot":"","sources":["../../src/mcp-chat/mcp-chat.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAapD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAE5E,OAAO,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AAMrF,OAAO,EAAE,kBAAkB,EAAgB,MAAM,6BAA6B,CAAC;AAE/E,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AA+NtE,qBACa,cAAc;IAKvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAEvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAExB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAEzB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAE9B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAZ9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmC;gBAIvC,MAAM,EAAE,aAAa,EAErB,OAAO,EAAE,cAAc,EAEvB,QAAQ,EAAE,kBAAkB,EAE5B,aAAa,EAAE,sBAAsB,EAErC,WAAW,EAAE,kBAAkB;IAG5C,iBAAiB,CAAC,MAAM,EAAE,MAAM;;;;;;IAQhC,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,qBAAqB;;;;;;;IAS7D,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE;;;IAOjD,WAAW,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;;;;;;;;;;IAQlD,WAAW,CACf,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM;;;;;;;;;;IAmEjB;;;;;;;;OAQG;YACW,eAAe;IAkB7B;;;;OAIG;YACW,aAAa;YA2Nb,aAAa;IA0L3B,OAAO,CAAC,gBAAgB;IA0CxB,OAAO,CAAC,gBAAgB;YAyDV,eAAe;IAa7B;;;;;;;OAOG;YACW,cAAc;YA6Dd,gBAAgB;YAShB,gBAAgB;YAmBhB,iBAAiB;YAoIjB,sBAAsB;IAyBpC,OAAO,CAAC,uBAAuB;IAa/B,OAAO,CAAC,eAAe;IAuCvB,OAAO,CAAC,mBAAmB;IAgB3B,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,gBAAgB;IAyCxB,OAAO,CAAC,mBAAmB;IAe3B,OAAO,CAAC,6BAA6B;IAwCrC,OAAO,CAAC,cAAc;IA6BtB,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,uBAAuB;IA8B/B,OAAO,CAAC,2BAA2B;IAMnC,OAAO,CAAC,iCAAiC;IAwBzC,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,cAAc;IAetB,OAAO,CAAC,kBAAkB;IAM1B,OAAO,CAAC,kBAAkB;YAUZ,+BAA+B;IAkB7C,OAAO,CAAC,oBAAoB;CAsB7B"}

package/dist/mcp-chat/mcp-chat.service.js

@@ -21,10 +21,19 @@ const api_prisma_1 = require("@hed-hog/api-prisma");
 const common_1 = require("@nestjs/common");
 const axios_1 = __importDefault(require("axios"));
 const ai_execution_service_1 = require("../ai-instruction/ai-execution.service");
+const ai_instruction_service_1 = require("../ai-instruction/ai-instruction.service");
 const ai_prompt_builder_service_1 = require("../ai-instruction/ai-prompt-builder.service");
 const integration_profile_utils_1 = require("../integration-profile/integration-profile.utils");
 const mcp_registry_service_1 = require("../mcp/mcp-registry.service");
 const setting_service_1 = require("../setting/setting.service");
+const OPENAI_API_BASE_URL = 'https://api.openai.com/v1';
+/**
+ * Modelos usados quando o perfil de integração não declara `config.model`.
+ * São o comportamento histórico do chat MCP, de quando o modelo era literal:
+ * mudar aqui muda o padrão de toda instalação que ainda não preencheu o campo.
+ */
+const OPENAI_CHAT_MODEL = 'gpt-4o-mini';
+const GEMINI_CHAT_MODEL = 'gemini-2.0-flash';
 const MAX_OPENAI_TOOLS = 128;
 const TARGET_SELECTED_TOOLS = 112;
 const MAX_ITERATIONS = 20;
@@ -34,11 +43,6 @@ const HISTORY_MESSAGE_LIMIT = 40;
 const FORCE_FINISH_THRESHOLD = 2;
 const MIN_DOMAIN_CONFIDENCE = 2;
 const AMBIGUOUS_DOMAIN_DELTA = 1;
-// SYSTEM_PROMPT is now managed via AiInstructionService (slug: system.global).
-// This fallback is used only if the DB is unreachable during startup.
-const SYSTEM_PROMPT_FALLBACK = 'You are a helpful assistant with access to tools from the HedHog system. ' +
-    "Use the available tools to answer the user's questions accurately. " +
-    'Always respond in the same language the user writes in.';
 const sanitize = (n) => n.replace(/\./g, '__');
 const restore = (n) => n.replace(/__/g, '.');
 const DOMAIN_KEYWORDS = {
@@ -221,7 +225,7 @@ let McpChatService = McpChatService_1 = class McpChatService {
             throw new common_1.BadRequestException('MCP server is disabled.');
         }
         await this.assertOwnership(conversationId, userId);
-        const { provider, apiKey } = await this.getProviderKey();
+        const { provider, apiKey, baseUrl, model } = await this.getProviderKey();
         // Save user message
         await this.prisma.mcp_conversation_message.create({
             data: {
@@ -248,28 +252,44 @@ let McpChatService = McpChatService_1 = class McpChatService {
         });
         try {
             if (provider === 'gemini') {
-                return await this.runGeminiLoop(conversationId, userId, locale, message, apiKey, executionId);
+                return await this.runGeminiLoop(conversationId, userId, locale, message, apiKey, executionId, model);
             }
-            return await this.runOpenAiLoop(conversationId, userId, locale, message, apiKey, executionId);
+            return await this.runOpenAiLoop(conversationId, userId, locale, message, apiKey, executionId, provider, baseUrl, model);
         }
         catch (err) {
             await this.aiExecution.finish(executionId, 'failed', String(err));
             throw err;
         }
     }
-    async getSystemPrompt(locale) {
+    /**
+     * Composes the system prompt from the stored layers.
+     *
+     * `moduleSlug`/`agentSlug` activate the L3/L4 layers; without them the seeded
+     * `module.*` and `agent.*` instructions are never read. `SYSTEM_PROMPT_FALLBACK`
+     * used to be duplicated here — it now comes from `AiInstructionService`, which
+     * already falls back internally, so this only guards against the whole build
+     * throwing.
+     */
+    async getSystemPrompt(locale, context) {
         try {
             const built = await this.promptBuilder.build({
                 locale,
+                moduleSlug: context === null || context === void 0 ? void 0 : context.moduleSlug,
+                agentSlug: context === null || context === void 0 ? void 0 : context.agentSlug,
             });
-            return built.systemPrompt || SYSTEM_PROMPT_FALLBACK;
+            return built.systemPrompt || ai_instruction_service_1.FALLBACK_SYSTEM_PROMPT;
         }
         catch (_a) {
-            return SYSTEM_PROMPT_FALLBACK;
+            return ai_instruction_service_1.FALLBACK_SYSTEM_PROMPT;
         }
     }
     // ── OpenAI loop ──────────────────────────────────────────────────────────
-    async runOpenAiLoop(conversationId, userId, locale, message, apiKey, executionId) {
+    /**
+     * Loop de tool calling no formato OpenAI. Serve tanto para a OpenAI quanto
+     * para o DeepSeek, que expõe a mesma API de `/chat/completions` (inclusive
+     * `tools`/`tool_calls`) — muda só a base URL, o modelo e a chave.
+     */
+    async runOpenAiLoop(conversationId, userId, locale, message, apiKey, executionId, provider = 'openai', baseUrl = OPENAI_API_BASE_URL, model = OPENAI_CHAT_MODEL) {
         var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q;
         const systemPrompt = await this.getSystemPrompt(locale);
         const allHistory = await this.prisma.mcp_conversation_message.findMany({
@@ -287,6 +307,9 @@ let McpChatService = McpChatService_1 = class McpChatService {
         ];
         const toolSelection = await this.buildOpenAiTools(message, conversationId, userId, history);
         if (toolSelection.clarification) {
+            // Sem o finish a execução fica presa em `running` para sempre — o caminho
+            // Gemini já fechava aqui.
+            await this.aiExecution.finish(executionId, 'completed');
             return this.recordAssistantAndReturnHistory(conversationId, toolSelection.clarification);
         }
         const tools = toolSelection.tools;
@@ -298,8 +321,8 @@ let McpChatService = McpChatService_1 = class McpChatService {
             let response;
             const stepStart = Date.now();
             try {
-                response = await axios_1.default.post('https://api.openai.com/v1/chat/completions', {
-                    model: 'gpt-4o-mini',
+                response = await axios_1.default.post(`${baseUrl}/chat/completions`, {
+                    model,
                     messages: openAiMessages,
                     tools: !forceFinish && tools.length > 0 ? tools : undefined,
                     tool_choice: !forceFinish && tools.length > 0 ? 'auto' : undefined,
@@ -313,21 +336,22 @@ let McpChatService = McpChatService_1 = class McpChatService {
             catch (err) {
                 const status = (_a = err === null || err === void 0 ? void 0 : err.response) === null || _a === void 0 ? void 0 : _a.status;
                 const errBody = (_c = (_b = err === null || err === void 0 ? void 0 : err.response) === null || _b === void 0 ? void 0 : _b.data) === null || _c === void 0 ? void 0 : _c.error;
+                const providerName = provider === 'deepseek' ? 'DeepSeek' : 'OpenAI';
                 if (status === 429) {
-                    throw new common_1.HttpException((_d = errBody === null || errBody === void 0 ? void 0 : errBody.message) !== null && _d !== void 0 ? _d : 'OpenAI rate limit exceeded. Please try again later.', common_1.HttpStatus.TOO_MANY_REQUESTS);
+                    throw new common_1.HttpException((_d = errBody === null || errBody === void 0 ? void 0 : errBody.message) !== null && _d !== void 0 ? _d : `${providerName} rate limit exceeded. Please try again later.`, common_1.HttpStatus.TOO_MANY_REQUESTS);
                 }
                 if (status === 401) {
-                    throw new common_1.BadRequestException('Invalid OpenAI API key.');
+                    throw new common_1.BadRequestException(`Invalid ${providerName} API key.`);
                 }
-                throw new common_1.HttpException((_e = errBody === null || errBody === void 0 ? void 0 : errBody.message) !== null && _e !== void 0 ? _e : 'OpenAI API error.', status !== null && status !== void 0 ? status : common_1.HttpStatus.BAD_GATEWAY);
+                throw new common_1.HttpException((_e = errBody === null || errBody === void 0 ? void 0 : errBody.message) !== null && _e !== void 0 ? _e : `${providerName} API error.`, status !== null && status !== void 0 ? status : common_1.HttpStatus.BAD_GATEWAY);
             }
             const usage = (_f = response.data) === null || _f === void 0 ? void 0 : _f.usage;
             await this.aiExecution.recordStep({
                 executionId,
                 stepOrder: stepOrder++,
                 type: 'prompt',
-                provider: 'openai',
-                model: 'gpt-4o-mini',
+                provider,
+                model,
                 durationMs: Date.now() - stepStart,
                 usage: usage
                     ? { input: (_g = usage.prompt_tokens) !== null && _g !== void 0 ? _g : 0, output: (_h = usage.completion_tokens) !== null && _h !== void 0 ? _h : 0, total: (_j = usage.total_tokens) !== null && _j !== void 0 ? _j : 0 }
@@ -438,8 +462,11 @@ let McpChatService = McpChatService_1 = class McpChatService {
         throw new common_1.BadRequestException('Maximum tool call iterations exceeded.');
     }
     // ── Gemini loop ──────────────────────────────────────────────────────────
-    async runGeminiLoop(conversationId, userId, locale, message, apiKey, executionId) {
+    async runGeminiLoop(conversationId, userId, locale, message, apiKey, executionId, model = GEMINI_CHAT_MODEL) {
         var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r;
+        // O perfil pode trazer o nome no formato da API ("models/gemini-2.0-flash");
+        // a URL abaixo já inclui o segmento `/models/`.
+        const modelId = model.replace(/^models\//, '');
         const systemPrompt = await this.getSystemPrompt(locale);
         const allHistory = await this.prisma.mcp_conversation_message.findMany({
             where: { conversation_id: conversationId },
@@ -463,7 +490,7 @@ let McpChatService = McpChatService_1 = class McpChatService {
             let response;
             const stepStart = Date.now();
             try {
-                response = await axios_1.default.post(`https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent?key=${apiKey}`, {
+                response = await axios_1.default.post(`https://generativelanguage.googleapis.com/v1beta/models/${encodeURIComponent(modelId)}:generateContent?key=${apiKey}`, {
                     systemInstruction: { parts: [{ text: systemPrompt }] },
                     contents: geminiContents,
                     tools: !forceFinish && functionDeclarations.length > 0
@@ -491,7 +518,7 @@ let McpChatService = McpChatService_1 = class McpChatService {
                 stepOrder: stepOrder++,
                 type: 'prompt',
                 provider: 'gemini',
-                model: 'gemini-2.0-flash',
+                model: modelId,
                 durationMs: Date.now() - stepStart,
                 usage: geminiUsage
                     ? { input: (_k = geminiUsage.promptTokenCount) !== null && _k !== void 0 ? _k : 0, output: (_l = geminiUsage.candidatesTokenCount) !== null && _l !== void 0 ? _l : 0, total: (_m = geminiUsage.totalTokenCount) !== null && _m !== void 0 ? _m : 0 }
@@ -674,6 +701,14 @@ let McpChatService = McpChatService_1 = class McpChatService {
             throw new common_1.ForbiddenException('Access denied to this conversation.');
         }
     }
+    /**
+     * Resolve credenciais e modelo do chat MCP a partir do perfil de integração
+     * apontado pela setting `mcp-ai-profile-id`.
+     *
+     * O `model` segue a mesma precedência do resto do codebase — aqui sem o degrau
+     * de `ai_instruction`, porque este fluxo não tem prompt de task próprio:
+     * `integration_profile.config.model` > constante de default do provider.
+     */
     async getProviderKey() {
         var _a;
         const settings = await this.setting.getSettingValues(['mcp-ai-profile-id']);
@@ -689,11 +724,32 @@ let McpChatService = McpChatService_1 = class McpChatService {
             throw new common_1.BadRequestException(`MCP AI profile "${profileSlug}" not found.`);
         }
         const providerSlug = profile.integration_provider.slug;
-        const { apiKey } = (0, integration_profile_utils_1.buildAiConfigFromIntegration)(providerSlug, profile.config);
+        const { apiKey, model, baseUrl } = (0, integration_profile_utils_1.buildAiConfigFromIntegration)(providerSlug, profile.config);
         if (!apiKey) {
             throw new common_1.BadRequestException(`MCP AI profile "${profileSlug}" has no API key configured.`);
         }
-        return { provider: providerSlug === 'gemini' ? 'gemini' : 'openai', apiKey };
+        if (providerSlug === 'gemini') {
+            return {
+                provider: 'gemini',
+                apiKey,
+                baseUrl: '',
+                model: model || GEMINI_CHAT_MODEL,
+            };
+        }
+        if (providerSlug === 'deepseek') {
+            return {
+                provider: 'deepseek',
+                apiKey,
+                baseUrl: baseUrl || integration_profile_utils_1.DEEPSEEK_API_BASE_URL,
+                model: model || integration_profile_utils_1.DEEPSEEK_DEFAULT_MODEL,
+            };
+        }
+        return {
+            provider: 'openai',
+            apiKey,
+            baseUrl: OPENAI_API_BASE_URL,
+            model: model || OPENAI_CHAT_MODEL,
+        };
     }
     async buildOpenAiTools(message, conversationId, userId, history) {
         return this.selectOpenAiTools(message, conversationId, userId, history);