@hed-hog/core 0.0.399 → 0.0.401

package/dist/ai/ai.service.js

@@ -16,7 +16,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 var AiService_1;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AiService = void 0;
+exports.AiService = exports.AiProfileProviderMismatchError = void 0;
+exports.isAttachmentDeliveredToModel = isAttachmentDeliveredToModel;
+exports.isAttachmentDeliveredAsPixels = isAttachmentDeliveredAsPixels;
 const api_prisma_1 = require("@hed-hog/api-prisma");
 const common_1 = require("@nestjs/common");
 const axios_1 = __importDefault(require("axios"));
@@ -27,6 +29,7 @@ const ai_prompt_resolver_service_1 = require("../ai-instruction/ai-prompt-resolv
 const file_service_1 = require("../file/file.service");
 const integration_profile_utils_1 = require("../integration-profile/integration-profile.utils");
 const setting_service_1 = require("../setting/setting.service");
+const ai_agent_sort_1 = require("./ai-agent.sort");
 const ai_attachment_fragments_1 = require("./ai-attachment.fragments");
 const ai_prompts_1 = require("./ai.prompts");
 /** Fallback call timeout when the active AI integration profile doesn't set `timeout_ms`. */
@@ -50,6 +53,44 @@ const PROVIDER_BY_INTEGRATION_SLUG = {
     deepseek: 'deepseek',
     claude: 'claude',
 };
+/** Anexo que o modelo realmente leu, em vez de um marcador dizendo que não deu. */
+const DELIVERED_TO_MODEL = new Set([
+    'image',
+    'pdf-document',
+    'pdf-text',
+    'text',
+]);
+/** Entregas em que o modelo enxergou os pixels da página, não só texto. */
+const DELIVERED_AS_PIXELS = new Set([
+    'image',
+    'pdf-document',
+]);
+function isAttachmentDeliveredToModel(delivery) {
+    return !!delivery && DELIVERED_TO_MODEL.has(delivery);
+}
+function isAttachmentDeliveredAsPixels(delivery) {
+    return !!delivery && DELIVERED_AS_PIXELS.has(delivery);
+}
+/**
+ * O setting de um provider aponta para o perfil de outro provider.
+ *
+ * Classe própria, e não um `BadRequestException` solto, para uma escada de
+ * fallback conseguir parar antes de disparar chamadas que vão dar 4xx com
+ * certeza — era o que o extrator de notas fiscais fazia oito vezes por upload,
+ * engolindo cada uma delas.
+ */
+class AiProfileProviderMismatchError extends common_1.BadRequestException {
+    constructor(requestedProvider, profileSlug, profileProviderSlug, settingSlug) {
+        super(`AI profile "${profileSlug}" (setting "${settingSlug}") belongs to provider ` +
+            `"${profileProviderSlug}", not "${requestedProvider}". ` +
+            `Point Settings → AI → "${settingSlug}" at a ${requestedProvider} profile, or leave it empty.`);
+        this.requestedProvider = requestedProvider;
+        this.profileSlug = profileSlug;
+        this.profileProviderSlug = profileProviderSlug;
+        this.settingSlug = settingSlug;
+    }
+}
+exports.AiProfileProviderMismatchError = AiProfileProviderMismatchError;
 let AiService = AiService_1 = class AiService {
     constructor(prismaService, settingService, fileService, aiExecution, promptResolver) {
         this.prismaService = prismaService;
@@ -84,7 +125,7 @@ let AiService = AiService_1 = class AiService {
         const executionId = await this.aiExecution.start({ trigger: 'api', contextSlug: 'ai-chat' });
         const stepStart = Date.now();
         try {
-            const { content, usage } = await this.withTimeout(this.chatWithProvider(provider, {
+            const { content, usage, delivery } = await this.withTimeout(this.chatWithProvider(provider, {
                 message: data.message,
                 model,
                 systemPrompt: data.systemPrompt,
@@ -92,6 +133,7 @@ let AiService = AiService_1 = class AiService {
                 apiKey: aiProfile.apiKey,
                 baseUrl: aiProfile.baseUrl,
                 params,
+                timeoutMs,
             }), timeoutMs);
             await this.aiExecution.recordStep({
                 executionId,
@@ -104,7 +146,12 @@ let AiService = AiService_1 = class AiService {
                 outputSummary: content.slice(0, 200),
             });
             await this.aiExecution.finish(executionId, 'completed');
-            return { provider, model, content };
+            return {
+                provider,
+                model,
+                content,
+                attachmentDelivery: delivery !== null && delivery !== void 0 ? delivery : 'none',
+            };
         }
         catch (err) {
             await this.aiExecution.finish(executionId, 'failed', String(err));
@@ -120,7 +167,7 @@ let AiService = AiService_1 = class AiService {
      * can log a fallback.
      */
     async chatWithPrompt(input) {
-        var _a, _b, _c, _d, _e, _f;
+        var _a, _b, _c, _d, _e, _f, _g;
         const slugs = input.systemPromptSlug
             ? [input.systemPromptSlug, input.userPromptSlug]
             : [input.userPromptSlug];
@@ -136,12 +183,15 @@ let AiService = AiService_1 = class AiService {
         const target = await this.resolveProviderAndProfile(input.provider, input.profileSlug);
         const provider = target.provider;
         const aiProfile = target.profile;
-        const model = stored.model || aiProfile.model || this.getDefaultModel(provider);
-        const timeoutMs = (_a = aiProfile.timeoutMs) !== null && _a !== void 0 ? _a : DEFAULT_AI_CALL_TIMEOUT_MS;
+        const model = ((_a = input.model) === null || _a === void 0 ? void 0 : _a.trim()) ||
+            stored.model ||
+            aiProfile.model ||
+            this.getDefaultModel(provider);
+        const timeoutMs = (_b = aiProfile.timeoutMs) !== null && _b !== void 0 ? _b : DEFAULT_AI_CALL_TIMEOUT_MS;
         const params = {
-            temperature: (_b = stored.temperature) !== null && _b !== void 0 ? _b : (_c = input.params) === null || _c === void 0 ? void 0 : _c.temperature,
-            maxTokens: (_d = stored.maxTokens) !== null && _d !== void 0 ? _d : (_e = input.params) === null || _e === void 0 ? void 0 : _e.maxTokens,
-            responseFormat: (_f = input.params) === null || _f === void 0 ? void 0 : _f.responseFormat,
+            temperature: (_c = stored.temperature) !== null && _c !== void 0 ? _c : (_d = input.params) === null || _d === void 0 ? void 0 : _d.temperature,
+            maxTokens: (_e = stored.maxTokens) !== null && _e !== void 0 ? _e : (_f = input.params) === null || _f === void 0 ? void 0 : _f.maxTokens,
+            responseFormat: (_g = input.params) === null || _g === void 0 ? void 0 : _g.responseFormat,
         };
         const executionId = await this.aiExecution.start({
             trigger: 'api',
@@ -169,30 +219,41 @@ let AiService = AiService_1 = class AiService {
             });
             await this.aiExecution.finish(executionId, 'completed');
             const promptSources = Object.fromEntries(Object.entries(resolved).map(([slug, prompt]) => [slug, prompt.source]));
-            return { provider, model, content, promptSources };
+            // `executionId || null`: `start` devolve 0 quando não conseguiu abrir a
+            // linha, e quem guarda esse id (o SAC, em `ai_execution_id`) ficaria
+            // apontando para uma execução inexistente — a coluna não tem FK para
+            // barrar isso.
+            return { provider, model, content, promptSources, executionId: executionId || null };
         }
         catch (err) {
             await this.aiExecution.finish(executionId, 'failed', String(err));
             throw err;
         }
     }
+    /**
+     * `external_agent_id` nasce nulo: a Assistants API da OpenAI, que devolvia o
+     * `asst_...` guardado nessa coluna, foi desligada em 26/08/2026 e todo
+     * `POST /v1/assistants` passou a responder 404. As instruções do agente viram
+     * system prompt do `chat/completions` em `chatWithAgent`, então elas precisam
+     * estar na linha — daí resolver aqui a instrução padrão que antes ia embutida
+     * no assistant remoto, em vez de deixar o agente sem prompt nenhum.
+     */
     async createAgent(data) {
         var _a;
         const slug = data.slug.trim();
         const provider = data.provider || 'openai';
         const model = data.model || this.getDefaultModel(provider);
-        const instructions = ((_a = data.instructions) === null || _a === void 0 ? void 0 : _a.trim()) || null;
         const existing = await this.findAgentBySlug(slug);
         if (existing) {
             return existing;
         }
-        let externalAgentId = null;
-        if (provider === 'openai') {
-            externalAgentId = await this.createOpenAiAssistant({
-                slug,
-                model,
-                instructions,
+        let instructions = ((_a = data.instructions) === null || _a === void 0 ? void 0 : _a.trim()) || null;
+        if (!instructions) {
+            const defaultInstructions = await this.promptResolver.resolve({
+                slug: ai_prompts_1.CORE_AI_PROMPT_SLUGS.agentDefaultInstructions,
+                variables: { slug },
             });
+            instructions = defaultInstructions.content;
         }
         await this.prismaService.$executeRaw `
       INSERT INTO ai_agent (slug, provider, model, instructions, external_agent_id)
@@ -201,7 +262,7 @@ let AiService = AiService_1 = class AiService {
         CAST(${provider} AS ai_agent_provider_7cb93b1143_enum),
         ${model},
         ${instructions},
-        ${externalAgentId}
+        NULL
       )
     `;
         return this.findAgentBySlug(slug);
@@ -234,28 +295,22 @@ let AiService = AiService_1 = class AiService {
         });
     }
     async listAgents(paginationParams) {
-        var _a;
         const page = Math.max(Number((paginationParams === null || paginationParams === void 0 ? void 0 : paginationParams.page) || 1), 1);
         const pageSize = Math.min(Math.max(Number((paginationParams === null || paginationParams === void 0 ? void 0 : paginationParams.pageSize) || 10), 1), 100);
-        const offset = (page - 1) * pageSize;
+        const skip = (page - 1) * pageSize;
         const search = String((paginationParams === null || paginationParams === void 0 ? void 0 : paginationParams.search) || '').trim();
-        const whereClause = search
-            ? api_prisma_1.Prisma.sql `WHERE LOWER(slug) LIKE LOWER(${`%${search}%`})`
-            : api_prisma_1.Prisma.empty;
-        const data = await this.prismaService.$queryRaw(api_prisma_1.Prisma.sql `
-      SELECT id, slug, provider, model, instructions, external_agent_id, created_at, updated_at
-      FROM ai_agent
-      ${whereClause}
-      ORDER BY id DESC
-      LIMIT ${pageSize}
-      OFFSET ${offset}
-    `);
-        const totalResult = await this.prismaService.$queryRaw(api_prisma_1.Prisma.sql `
-      SELECT COUNT(*) AS total
-      FROM ai_agent
-      ${whereClause}
-    `);
-        const total = Number(((_a = totalResult === null || totalResult === void 0 ? void 0 : totalResult[0]) === null || _a === void 0 ? void 0 : _a.total) || 0);
+        const where = search
+            ? { slug: { contains: search, mode: 'insensitive' } }
+            : {};
+        const [data, total] = await Promise.all([
+            this.prismaService.ai_agent.findMany({
+                where,
+                orderBy: ai_agent_sort_1.AI_AGENT_SORT.toPrismaOrderBy(paginationParams),
+                skip,
+                take: pageSize,
+            }),
+            this.prismaService.ai_agent.count({ where }),
+        ]);
         return {
             data,
             total,
@@ -287,24 +342,15 @@ let AiService = AiService_1 = class AiService {
                 throw new common_1.BadRequestException(`AI agent with slug "${slug}" already exists.`);
             }
         }
-        let externalAgentId = currentAgent.external_agent_id;
-        if (provider !== 'openai') {
-            externalAgentId = null;
-        }
-        else if (!externalAgentId) {
-            externalAgentId = await this.createOpenAiAssistant({
-                slug,
-                model,
-                instructions,
-            });
-        }
+        // Zera o `asst_...` legado: a coluna deixou de ser alimentada quando a
+        // Assistants API foi desligada, e valor antigo aqui não tem mais para onde ir.
         await this.prismaService.$executeRaw `
       UPDATE ai_agent
       SET slug = ${slug},
           provider = CAST(${provider} AS ai_agent_provider_7cb93b1143_enum),
           model = ${model},
           instructions = ${instructions},
-          external_agent_id = ${externalAgentId},
+          external_agent_id = NULL,
           updated_at = NOW()
       WHERE id = ${agentId}
     `;
@@ -330,34 +376,37 @@ let AiService = AiService_1 = class AiService {
         };
     }
     async chatWithAgent(slug, data, file) {
+        var _a;
         const agent = await this.findAgentBySlug(slug);
         const attachment = await this.resolveAttachment(file, data.file_id);
         if (!agent) {
             throw new common_1.NotFoundException(`AI agent with slug "${slug}" was not found.`);
         }
-        if (agent.provider === 'openai' && agent.external_agent_id && !attachment) {
-            const content = await this.chatWithOpenAiAssistant(agent.external_agent_id, data.message);
-            return {
-                slug: agent.slug,
-                provider: agent.provider,
-                model: agent.model,
-                content,
-            };
-        }
+        // Um único caminho para todo agente, com ou sem anexo: as instruções da
+        // linha viram system prompt do provider. Até 26/08/2026 o agente da OpenAI
+        // com `external_agent_id` e sem anexo era atendido por thread + run da
+        // Assistants API — que a OpenAI desligou, e que já ignorava model e
+        // instructions do banco porque só mandava o `assistant_id`.
         const aiProfile = await this.getAiProfile(agent.provider);
-        const { content } = await this.chatWithProvider(agent.provider, {
+        const timeoutMs = (_a = aiProfile.timeoutMs) !== null && _a !== void 0 ? _a : DEFAULT_AI_CALL_TIMEOUT_MS;
+        // Sem o `withTimeout` este era o único ponto público sem prazo nenhum: uma
+        // chamada travada no provider segurava a requisição HTTP de quem chamou
+        // indefinidamente.
+        const { content, delivery } = await this.withTimeout(this.chatWithProvider(agent.provider, {
             message: data.message,
             model: agent.model || this.getDefaultModel(agent.provider),
             systemPrompt: agent.instructions || undefined,
             attachment,
             apiKey: aiProfile.apiKey,
             baseUrl: aiProfile.baseUrl,
-        });
+            timeoutMs,
+        }), timeoutMs);
         return {
             slug: agent.slug,
             provider: agent.provider,
             model: agent.model,
             content,
+            attachmentDelivery: delivery !== null && delivery !== void 0 ? delivery : 'none',
         };
     }
     async getAgentBySlug(slug) {
@@ -417,7 +466,7 @@ let AiService = AiService_1 = class AiService {
             textSample: extractedText.slice(0, 600),
             sha256: (0, crypto_1.createHash)('sha256').update(attachment.buffer).digest('hex'),
         };
-        this.logger.warn(`[AI-ATTACHMENT-DEBUG] fileId=${fileId || 'upload'} filename="${result.filename}" mime=${result.mimeType} mode=${result.mode} bytes=${result.bytes} textLength=${result.textLength}`);
+        this.logger.debug(`[AI-ATTACHMENT-DEBUG] fileId=${fileId || 'upload'} filename="${result.filename}" mime=${result.mimeType} mode=${result.mode} bytes=${result.bytes} textLength=${result.textLength}`);
         return result;
     }
     async findAgentBySlug(slug) {
@@ -512,7 +561,38 @@ let AiService = AiService_1 = class AiService {
         if (!profileSlug) {
             throw new common_1.BadRequestException(`No ${provider} AI profile configured. Set one in Settings → AI.`);
         }
-        return (await this.loadAiProfileBySlug(profileSlug)).config;
+        const loaded = await this.loadAiProfileBySlug(profileSlug);
+        const mapped = PROVIDER_BY_INTEGRATION_SLUG[loaded.providerSlug];
+        // `resolveProviderAndProfile` já protegia o caminho do perfil explícito
+        // ("pedir openai e apontar um perfil Claude bateria na API errada com a
+        // chave errada"); o caminho do setting global ficara de fora. Sem isso, um
+        // perfil OpenAI no campo do Gemini fazia o serviço postar a chave da OpenAI
+        // no endpoint do Google e engolir o 4xx de cada modelo tentado.
+        if (mapped !== provider) {
+            this.logger.error(`[AI-PROFILE] "${slug}" = "${profileSlug}" é um perfil ${loaded.providerSlug}, ` +
+                `mas ${provider} foi pedido.`);
+            throw new AiProfileProviderMismatchError(provider, profileSlug, loaded.providerSlug, slug);
+        }
+        return loaded.config;
+    }
+    /**
+     * "Este provider dá para usar?", sem lançar.
+     *
+     * Existe para uma escada de fallback perguntar antes de tentar, em vez de
+     * gastar uma requisição HTTP por modelo só para descobrir que a credencial
+     * nem é daquele provider.
+     */
+    async isProviderConfigured(provider) {
+        try {
+            await this.getAiProfile(provider);
+            return { ok: true };
+        }
+        catch (error) {
+            return {
+                ok: false,
+                reason: error instanceof Error ? error.message : String(error),
+            };
+        }
     }
     async loadAiProfileBySlug(profileSlug) {
         const profile = await this.prismaService.integration_profile.findUnique({
@@ -541,26 +621,176 @@ let AiService = AiService_1 = class AiService {
             });
         });
     }
-    async chatWithOpenAi({ message, model, systemPrompt, attachment, apiKey, params, provider = 'openai', baseUrl = 'https://api.openai.com/v1', supportsImages = true, }) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+    async chatWithOpenAi({ message, model, systemPrompt, attachment, apiKey, params, provider = 'openai', baseUrl = 'https://api.openai.com/v1', supportsImages = true, timeoutMs, }) {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q;
         const openai = apiKey !== null && apiKey !== void 0 ? apiKey : (await this.getAiApiKey(provider));
+        if (this.shouldUseOpenAiResponses({ provider, baseUrl, model, attachment })) {
+            try {
+                return await this.chatWithOpenAiResponses({
+                    message,
+                    model,
+                    systemPrompt,
+                    attachment: attachment,
+                    apiKey: openai,
+                    baseUrl,
+                    params,
+                    timeoutMs,
+                });
+            }
+            catch (error) {
+                const status = Number((_a = error === null || error === void 0 ? void 0 : error.response) === null || _a === void 0 ? void 0 : _a.status);
+                // 400/404/422 = este modelo ou esta conta não aceita `input_file`;
+                // cair para o chat/completions é melhor que falhar. Qualquer outra
+                // coisa (401, 429, 5xx, timeout) é falha de verdade e não pode ser
+                // mascarada por uma segunda chamada mais fraca, que só reproduziria o
+                // marcador de PDF ilegível e devolveria "não achei nada".
+                if (![400, 404, 422].includes(status))
+                    throw error;
+                this.logger.warn(`[AI-RESPONSES] /v1/responses recusou (status=${status}); usando chat/completions. ` +
+                    `apiError=${(_e = (_d = (_c = (_b = error === null || error === void 0 ? void 0 : error.response) === null || _b === void 0 ? void 0 : _b.data) === null || _c === void 0 ? void 0 : _c.error) === null || _d === void 0 ? void 0 : _d.message) !== null && _e !== void 0 ? _e : 'n/a'}`);
+            }
+        }
         const messages = [];
         if (systemPrompt) {
             messages.push({ role: 'system', content: systemPrompt });
         }
-        const userContent = await this.buildOpenAiUserContent(message, attachment, supportsImages);
+        const { content: userContent, delivery } = await this.buildOpenAiUserContent(message, attachment, supportsImages);
         messages.push({ role: 'user', content: userContent });
-        const body = (0, ai_prompt_resolver_service_1.applyOpenAiModelParams)({ messages }, { model: null, temperature: (_a = params === null || params === void 0 ? void 0 : params.temperature) !== null && _a !== void 0 ? _a : null, maxTokens: (_b = params === null || params === void 0 ? void 0 : params.maxTokens) !== null && _b !== void 0 ? _b : null }, { model, jsonObject: (params === null || params === void 0 ? void 0 : params.responseFormat) === 'json_object' });
+        const body = (0, ai_prompt_resolver_service_1.applyOpenAiModelParams)({ messages }, { model: null, temperature: (_f = params === null || params === void 0 ? void 0 : params.temperature) !== null && _f !== void 0 ? _f : null, maxTokens: (_g = params === null || params === void 0 ? void 0 : params.maxTokens) !== null && _g !== void 0 ? _g : null }, { model, jsonObject: (params === null || params === void 0 ? void 0 : params.responseFormat) === 'json_object' });
         const response = await axios_1.default.post(`${baseUrl.replace(/\/+$/, '')}/chat/completions`, body, {
             headers: {
                 Authorization: `Bearer ${openai}`,
                 'Content-Type': 'application/json',
             },
         });
-        const u = (_c = response.data) === null || _c === void 0 ? void 0 : _c.usage;
+        const u = (_h = response.data) === null || _h === void 0 ? void 0 : _h.usage;
         return {
-            content: ((_g = (_f = (_e = (_d = response.data) === null || _d === void 0 ? void 0 : _d.choices) === null || _e === void 0 ? void 0 : _e[0]) === null || _f === void 0 ? void 0 : _f.message) === null || _g === void 0 ? void 0 : _g.content) || '',
-            usage: u ? { input: (_h = u.prompt_tokens) !== null && _h !== void 0 ? _h : 0, output: (_j = u.completion_tokens) !== null && _j !== void 0 ? _j : 0, total: (_k = u.total_tokens) !== null && _k !== void 0 ? _k : 0 } : undefined,
+            content: ((_m = (_l = (_k = (_j = response.data) === null || _j === void 0 ? void 0 : _j.choices) === null || _k === void 0 ? void 0 : _k[0]) === null || _l === void 0 ? void 0 : _l.message) === null || _m === void 0 ? void 0 : _m.content) || '',
+            delivery,
+            usage: u ? { input: (_o = u.prompt_tokens) !== null && _o !== void 0 ? _o : 0, output: (_p = u.completion_tokens) !== null && _p !== void 0 ? _p : 0, total: (_q = u.total_tokens) !== null && _q !== void 0 ? _q : 0 } : undefined,
+        };
+    }
+    shouldUseOpenAiResponses(input) {
+        // O DeepSeek reusa o formato da OpenAI, mas não tem /v1/responses; e um
+        // gateway apontado por `base_url` pode simplesmente não repassar a rota.
+        if (input.provider !== 'openai')
+            return false;
+        if (!input.baseUrl.startsWith('https://api.openai.com'))
+            return false;
+        if (!input.attachment)
+            return false;
+        // Imagem já funciona pelo bloco de visão do chat/completions.
+        if (!this.isPdfMime(input.attachment.mimeType))
+            return false;
+        if (input.attachment.buffer.length > AiService_1.OPENAI_RESPONSES_MAX_PDF_BYTES) {
+            return false;
+        }
+        return AiService_1.OPENAI_DOCUMENT_MODEL_RE.test(input.model);
+    }
+    buildOpenAiResponsesBody(input) {
+        var _a, _b, _c, _d, _e;
+        const base64 = input.attachment.buffer.toString('base64');
+        // Arquivo antes da instrução, como no exemplo da própria OpenAI: o modelo
+        // lê o documento antes de saber o que tirar dele.
+        const body = {
+            input: [
+                {
+                    role: 'user',
+                    content: [
+                        {
+                            type: 'input_file',
+                            filename: input.attachment.filename,
+                            file_data: `data:${input.attachment.mimeType};base64,${base64}`,
+                        },
+                        { type: 'input_text', text: input.message },
+                    ],
+                },
+            ],
+        };
+        // `instructions` é o equivalente do `messages[0].role === 'system'`.
+        if (input.systemPrompt)
+            body.instructions = input.systemPrompt;
+        return (0, ai_prompt_resolver_service_1.applyOpenAiResponsesParams)(body, {
+            model: null,
+            temperature: (_b = (_a = input.params) === null || _a === void 0 ? void 0 : _a.temperature) !== null && _b !== void 0 ? _b : null,
+            maxTokens: (_d = (_c = input.params) === null || _c === void 0 ? void 0 : _c.maxTokens) !== null && _d !== void 0 ? _d : null,
+        }, {
+            model: input.model,
+            jsonObject: ((_e = input.params) === null || _e === void 0 ? void 0 : _e.responseFormat) === 'json_object',
+        });
+    }
+    /**
+     * Texto da resposta da Responses API.
+     *
+     * `output_text` é conveniência do SDK — o JSON HTTP cru normalmente não traz.
+     * O texto mora no array `output`, ao lado de itens `reasoning` que não têm
+     * `content` nenhum. Percorrer o array é o caminho real; o atalho pelo
+     * `output_text` só vale para quando o campo por acaso estiver lá.
+     */
+    readOpenAiResponsesText(data) {
+        var _a;
+        if (typeof (data === null || data === void 0 ? void 0 : data.output_text) === 'string' && data.output_text.trim()) {
+            return data.output_text;
+        }
+        const output = Array.isArray(data === null || data === void 0 ? void 0 : data.output) ? data.output : [];
+        const chunks = [];
+        for (const item of output) {
+            if ((item === null || item === void 0 ? void 0 : item.type) && item.type !== 'message')
+                continue;
+            for (const part of (_a = item === null || item === void 0 ? void 0 : item.content) !== null && _a !== void 0 ? _a : []) {
+                if ((part === null || part === void 0 ? void 0 : part.type) === 'output_text' && typeof part.text === 'string') {
+                    chunks.push(part.text);
+                }
+                else if ((part === null || part === void 0 ? void 0 : part.type) === 'refusal' && typeof part.refusal === 'string') {
+                    this.logger.warn(`[AI-RESPONSES] modelo recusou: ${part.refusal.slice(0, 200)}`);
+                }
+            }
+        }
+        return chunks.join('');
+    }
+    /**
+     * PDF como documento, via `POST /v1/responses`.
+     *
+     * É o único caminho em que um PDF escaneado chega ao modelo: para modelos com
+     * visão a API extrai o texto e renderiza cada página como imagem. O
+     * chat/completions, mesmo aceitando um content part de PDF, só extrai texto —
+     * não serviria para um scan.
+     */
+    async chatWithOpenAiResponses(input) {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
+        const pages = await this.countPdfPages(input.attachment.buffer);
+        if (pages > AiService_1.OPENAI_RESPONSES_MAX_PDF_PAGES) {
+            this.logger.warn(`[AI-RESPONSES] "${input.attachment.filename}" tem ${pages} páginas ` +
+                `(máx. ${AiService_1.OPENAI_RESPONSES_MAX_PDF_PAGES}); usando chat/completions.`);
+            // 422 é o status que o chamador trata como "degrade", e não como falha.
+            throw Object.assign(new Error('PDF acima do limite de páginas'), {
+                response: { status: 422, data: { error: { message: 'too many pages' } } },
+            });
+        }
+        const response = await axios_1.default.post(`${input.baseUrl.replace(/\/+$/, '')}/responses`, this.buildOpenAiResponsesBody(input), {
+            headers: {
+                Authorization: `Bearer ${input.apiKey}`,
+                'Content-Type': 'application/json',
+            },
+            // O corpo é o PDF em base64, na casa dos megabytes, e a renderização
+            // das páginas é lenta: com os padrões do axios isso trunca ou trava.
+            timeout: (_a = input.timeoutMs) !== null && _a !== void 0 ? _a : DEFAULT_AI_CALL_TIMEOUT_MS,
+            maxBodyLength: Infinity,
+            maxContentLength: Infinity,
+        });
+        if (((_b = response.data) === null || _b === void 0 ? void 0 : _b.status) && response.data.status !== 'completed') {
+            this.logger.warn(`[AI-RESPONSES] status=${response.data.status} ` +
+                `reason=${(_e = (_d = (_c = response.data) === null || _c === void 0 ? void 0 : _c.incomplete_details) === null || _d === void 0 ? void 0 : _d.reason) !== null && _e !== void 0 ? _e : 'n/a'} ` +
+                `model=${input.model} file="${input.attachment.filename}"`);
+        }
+        const u = (_f = response.data) === null || _f === void 0 ? void 0 : _f.usage;
+        return {
+            content: this.readOpenAiResponsesText(response.data),
+            delivery: 'pdf-document',
+            usage: u
+                ? Object.assign({ input: (_g = u.input_tokens) !== null && _g !== void 0 ? _g : 0, output: (_h = u.output_tokens) !== null && _h !== void 0 ? _h : 0, total: (_j = u.total_tokens) !== null && _j !== void 0 ? _j : ((_k = u.input_tokens) !== null && _k !== void 0 ? _k : 0) + ((_l = u.output_tokens) !== null && _l !== void 0 ? _l : 0) }, (((_m = u.input_tokens_details) === null || _m === void 0 ? void 0 : _m.cached_tokens)
+                    ? { cached: u.input_tokens_details.cached_tokens }
+                    : {})) : undefined,
         };
     }
     /**
@@ -608,95 +838,18 @@ let AiService = AiService_1 = class AiService {
                 : undefined,
         };
     }
-    async createOpenAiAssistant({ slug, model, instructions, }) {
-        var _a;
-        const openai = await this.getAiApiKey('openai');
-        const defaultInstructions = await this.promptResolver.resolve({
-            slug: ai_prompts_1.CORE_AI_PROMPT_SLUGS.agentDefaultInstructions,
-            variables: { slug },
-        });
-        const response = await axios_1.default.post('https://api.openai.com/v1/assistants', {
-            name: slug,
-            model,
-            instructions: instructions || defaultInstructions.content,
-        }, {
-            headers: {
-                Authorization: `Bearer ${openai}`,
-                'Content-Type': 'application/json',
-                'OpenAI-Beta': 'assistants=v2',
-            },
-        });
-        const assistantId = (_a = response.data) === null || _a === void 0 ? void 0 : _a.id;
-        if (!assistantId) {
-            throw new common_1.BadRequestException('OpenAI assistant creation failed.');
-        }
-        return assistantId;
-    }
-    async chatWithOpenAiAssistant(assistantId, message) {
-        var _a, _b, _c, _d, _e, _f, _g, _h;
-        const openai = await this.getAiApiKey('openai');
-        const threadResponse = await axios_1.default.post('https://api.openai.com/v1/threads', {
-            messages: [{ role: 'user', content: message }],
-        }, {
-            headers: {
-                Authorization: `Bearer ${openai}`,
-                'Content-Type': 'application/json',
-                'OpenAI-Beta': 'assistants=v2',
-            },
-        });
-        const threadId = (_a = threadResponse.data) === null || _a === void 0 ? void 0 : _a.id;
-        if (!threadId) {
-            throw new common_1.BadRequestException('OpenAI thread creation failed.');
-        }
-        const runResponse = await axios_1.default.post(`https://api.openai.com/v1/threads/${threadId}/runs`, {
-            assistant_id: assistantId,
-        }, {
-            headers: {
-                Authorization: `Bearer ${openai}`,
-                'Content-Type': 'application/json',
-                'OpenAI-Beta': 'assistants=v2',
-            },
-        });
-        const runId = (_b = runResponse.data) === null || _b === void 0 ? void 0 : _b.id;
-        if (!runId) {
-            throw new common_1.BadRequestException('OpenAI assistant run failed to start.');
-        }
-        for (let i = 0; i < 30; i++) {
-            const runStatusResponse = await axios_1.default.get(`https://api.openai.com/v1/threads/${threadId}/runs/${runId}`, {
-                headers: {
-                    Authorization: `Bearer ${openai}`,
-                    'OpenAI-Beta': 'assistants=v2',
-                },
-            });
-            const status = (_c = runStatusResponse.data) === null || _c === void 0 ? void 0 : _c.status;
-            if (status === 'completed') {
-                break;
-            }
-            if (['cancelled', 'failed', 'expired'].includes(status)) {
-                throw new common_1.BadRequestException(`OpenAI assistant run did not complete successfully (status: ${status}).`);
-            }
-            await this.sleep(1000);
-        }
-        const messagesResponse = await axios_1.default.get(`https://api.openai.com/v1/threads/${threadId}/messages`, {
-            headers: {
-                Authorization: `Bearer ${openai}`,
-                'OpenAI-Beta': 'assistants=v2',
-            },
-        });
-        const assistantMessage = (_e = (_d = messagesResponse.data) === null || _d === void 0 ? void 0 : _d.data) === null || _e === void 0 ? void 0 : _e.find((item) => item.role === 'assistant');
-        const output = (_h = (_g = (_f = assistantMessage === null || assistantMessage === void 0 ? void 0 : assistantMessage.content) === null || _f === void 0 ? void 0 : _f[0]) === null || _g === void 0 ? void 0 : _g.text) === null || _h === void 0 ? void 0 : _h.value;
-        return output || '';
-    }
     async chatWithGemini({ message, model, systemPrompt, attachment, apiKey, params, }) {
         var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
         const gemini = apiKey !== null && apiKey !== void 0 ? apiKey : (await this.getAiApiKey('gemini'));
         const url = `https://generativelanguage.googleapis.com/v1beta/models/${model}:generateContent?key=${gemini}`;
         const userParts = [{ text: message }];
+        let delivery = 'none';
         if (attachment) {
             if (this.isTextMime(attachment.mimeType)) {
                 userParts.push({
                     text: (0, ai_attachment_fragments_1.attachedFileBlock)(attachment.filename, this.toUtf8Text(attachment.buffer)),
                 });
+                delivery = 'text';
             }
             else if (this.isPdfMime(attachment.mimeType)) {
                 const pdfText = await this.extractPdfText(attachment.buffer);
@@ -704,6 +857,7 @@ let AiService = AiService_1 = class AiService {
                     userParts.push({
                         text: (0, ai_attachment_fragments_1.attachedFileBlock)(attachment.filename, pdfText),
                     });
+                    delivery = 'pdf-text';
                 }
                 else {
                     userParts.push({
@@ -712,6 +866,7 @@ let AiService = AiService_1 = class AiService {
                             data: attachment.buffer.toString('base64'),
                         },
                     });
+                    delivery = 'pdf-document';
                 }
             }
             else {
@@ -721,6 +876,7 @@ let AiService = AiService_1 = class AiService {
                         data: attachment.buffer.toString('base64'),
                     },
                 });
+                delivery = this.isImageMime(attachment.mimeType) ? 'image' : 'binary';
             }
         }
         let payload = {
@@ -742,12 +898,10 @@ let AiService = AiService_1 = class AiService {
         const u = (_g = response.data) === null || _g === void 0 ? void 0 : _g.usageMetadata;
         return {
             content,
+            delivery,
             usage: u ? { input: (_h = u.promptTokenCount) !== null && _h !== void 0 ? _h : 0, output: (_j = u.candidatesTokenCount) !== null && _j !== void 0 ? _j : 0, total: (_k = u.totalTokenCount) !== null && _k !== void 0 ? _k : 0 } : undefined,
         };
     }
-    async sleep(ms) {
-        await new Promise((resolve) => setTimeout(resolve, ms));
-    }
     async resolveAttachment(uploadFile, fileId) {
         var _a;
         if (uploadFile) {
@@ -769,30 +923,46 @@ let AiService = AiService_1 = class AiService {
         }
         return null;
     }
+    /**
+     * Conteúdo da mensagem do usuário no chat/completions, mais como o anexo foi
+     * parar lá dentro.
+     *
+     * O `delivery` sai daqui porque é aqui que a decisão acontece: um PDF sem
+     * camada de texto vira o marcador de ilegível, e só este método sabe disso.
+     */
     async buildOpenAiUserContent(message, attachment, supportsImages = true) {
         if (!attachment) {
-            return message;
+            return { content: message, delivery: 'none' };
         }
         if (supportsImages && this.isImageMime(attachment.mimeType)) {
             const dataUri = `data:${attachment.mimeType};base64,${attachment.buffer.toString('base64')}`;
-            return [
-                { type: 'text', text: message },
-                { type: 'image_url', image_url: { url: dataUri } },
-            ];
+            return {
+                content: [
+                    { type: 'text', text: message },
+                    { type: 'image_url', image_url: { url: dataUri } },
+                ],
+                delivery: 'image',
+            };
         }
         let text;
+        let delivery;
         if (this.isTextMime(attachment.mimeType)) {
             text = this.toUtf8Text(attachment.buffer);
+            delivery = 'text';
         }
         else if (this.isPdfMime(attachment.mimeType)) {
-            text =
-                (await this.extractPdfText(attachment.buffer)) ||
-                    (0, ai_attachment_fragments_1.unreadablePdfMarker)(attachment.filename);
+            const pdfText = await this.extractPdfText(attachment.buffer);
+            text = pdfText || (0, ai_attachment_fragments_1.unreadablePdfMarker)(attachment.filename);
+            delivery = pdfText ? 'pdf-text' : 'unreadable-pdf';
         }
         else {
             text = (0, ai_attachment_fragments_1.binaryAttachmentMarker)(attachment.filename, attachment.mimeType, attachment.buffer.length);
+            delivery = 'binary';
         }
-        return `${message}${(0, ai_attachment_fragments_1.attachedFileBlock)(attachment.filename, text)}`;
+        return {
+            content: `${message}${(0, ai_attachment_fragments_1.attachedFileBlock)(attachment.filename, text)}`,
+            delivery,
+        };
     }
     isImageMime(mimeType) {
         return mimeType.startsWith('image/');
@@ -846,11 +1016,36 @@ let AiService = AiService_1 = class AiService {
             return '';
         }
     }
+    /** Páginas do PDF, ou 0 quando ele não abre — nesse caso o teto não barra. */
+    async countPdfPages(buffer) {
+        var _a, _b;
+        try {
+            return (_b = (_a = (await (0, pdf_parse_1.default)(buffer))) === null || _a === void 0 ? void 0 : _a.numpages) !== null && _b !== void 0 ? _b : 0;
+        }
+        catch (_c) {
+            return 0;
+        }
+    }
     toUtf8Text(buffer) {
         return buffer.toString('utf8');
     }
 };
 exports.AiService = AiService;
+/**
+ * Bytes crus de PDF acima disto não vão inline: base64 infla ~1,37x e a
+ * OpenAI limita a requisição a 50 MB.
+ */
+AiService.OPENAI_RESPONSES_MAX_PDF_BYTES = 20 * 1024 * 1024;
+/** Acima disto a conta de tokens das páginas renderizadas deixa de compensar. */
+AiService.OPENAI_RESPONSES_MAX_PDF_PAGES = 20;
+/**
+ * Modelos que renderizam as páginas do PDF como imagem na Responses API.
+ *
+ * Um modelo sem visão recebendo `input_file` só recebe a camada de texto de
+ * volta — o mesmo nada do chat/completions, num endpoint diferente. Deixá-lo
+ * no caminho antigo mantém a falha conhecida em vez de criar uma nova.
+ */
+AiService.OPENAI_DOCUMENT_MODEL_RE = /^(gpt-4o|gpt-4\.1|gpt-4-turbo|gpt-5|o3|o4)/i;
 exports.AiService = AiService = AiService_1 = __decorate([
     (0, common_1.Injectable)(),
     __param(0, (0, common_1.Inject)((0, common_1.forwardRef)(() => api_prisma_1.PrismaService))),