@rodrigobeber/patoai-dtos 4.8.19 → 4.8.21

package/dist/ai/text/response-create.dto.d.ts

@@ -2,11 +2,25 @@ import { AIFunctionCallItem, AIFunctionCallOutput, AITextConfig, AITool } from "
 import { InputMessageDto } from "./input-message.dto";
 import { ProviderDto } from "../core/provider.dto";
 export type AIConversationTurn = AIFunctionCallItem | AIFunctionCallOutput;
+/**
+ * Pedaco do prompt de sistema com controle proprio de cache (Anthropic; achatado em string unica pelos
+ * demais providers). Existe porque `instructions` e UM bloco so: com estavel e volatil no mesmo texto,
+ * qualquer parte que mude por pergunta reescreve o prefixo inteiro e nada do prompt cacheia.
+ * A ORDEM do array e a ordem no prompt — estavel primeiro, volatil depois.
+ */
+export interface AIInstructionBlock {
+    text: string;
+    cacheable?: boolean;
+}
+/** 1h custa 2x na escrita (contra 1,25x de 5m) — so compensa em prefixo global/de trafego esparso. */
+export type AICacheTtl = '5m' | '1h';
 export interface ResponseCreateDto {
     provider: ProviderDto;
     model: string;
     background: boolean;
     instructions: string;
+    /** Vence `instructions` quando presente (que segue como caminho unico dos demais consumidores). */
+    instructionBlocks?: AIInstructionBlock[];
     messages: InputMessageDto[];
     toolOutputs: AIFunctionCallOutput[];
     turns?: AIConversationTurn[];
@@ -18,6 +32,13 @@ export interface ResponseCreateDto {
     tools: AITool[];
     userId: string;
     cacheKey?: string;
+    /**
+     * Fecha um breakpoint no FIM das mensagens (depois dos `turns`), avancando a cada ida do tool loop.
+     * Sem ele, historico + bloco volatil + turns anteriores sao reenviados a 1x em TODA ida — o custo
+     * de um agente com ferramentas e dominado por essa reemissao, nao pelo prefixo.
+     */
+    cacheTurns?: boolean;
+    cacheTtl?: AICacheTtl;
     previousResponseId?: string;
     includeFileSearchResults?: boolean;
     skipSanitize?: boolean;

package/dist/support/index.d.ts

@@ -14,3 +14,4 @@ export * from './support-insight-access.dto';
 export * from './support-agent-balance.dto';
 export * from './support-lab-session.dto';
 export * from './support-lab-onboarding.dto';
+export * from './lab-action-catalog';

package/dist/support/index.js

@@ -30,3 +30,4 @@ __exportStar(require("./support-insight-access.dto"), exports);
 __exportStar(require("./support-agent-balance.dto"), exports);
 __exportStar(require("./support-lab-session.dto"), exports);
 __exportStar(require("./support-lab-onboarding.dto"), exports);
+__exportStar(require("./lab-action-catalog"), exports);

package/dist/support/lab-action-catalog.d.ts

@@ -0,0 +1,40 @@
+/** Como o DIÁLOGO renderiza a proposta (é o que decide se um leigo entende o que vai mudar). */
+export type LabActionRender = 'text' | // diff antes/depois (roteiro, contexto — campos longos)
+'field' | // tabela "Antes -> Depois" com rótulo em pt-BR (liga/desliga, número, enum, horário)
+'item';
+export type LabActionParamKind = 'text' | 'boolean' | 'number' | 'enum' | 'time';
+export interface LabActionOption {
+    value: string | number;
+    label: string;
+}
+export interface LabActionParam {
+    name: string;
+    kind: LabActionParamKind;
+    label: string;
+    description: string;
+    required?: boolean;
+    /** Identifica QUAL item/campo a ação altera (ex.: idPrompt). Compõe a chave anti-duplicata. */
+    identity?: boolean;
+    min?: number;
+    max?: number;
+    unit?: string;
+    options?: LabActionOption[];
+}
+export interface LabAction {
+    id: string;
+    op: 'update' | 'create';
+    render: LabActionRender;
+    title: string;
+    path: string;
+    summary: string;
+    params: LabActionParam[];
+    undoHint: string;
+}
+/** Uma linha "Antes -> Depois" já formatada em pt-BR (render 'field' e 'item'). */
+export interface LabProposalChangeDto {
+    label: string;
+    before: string;
+    after: string;
+}
+export declare const LAB_ACTIONS: LabAction[];
+export declare function findLabAction(id: string): LabAction | undefined;

package/dist/support/lab-action-catalog.js

@@ -0,0 +1,70 @@
+"use strict";
+// CATÁLOGO DE AÇÕES da Oráculo (Laboratório) — fonte única, consumida pelos DOIS lados:
+// `patoai-support` renderiza o índice no prompt, valida o que o modelo pediu e materializa a proposta;
+// `patoai-frontend` mapeia cada `id` para {ler valor atual, aplicar} e escolhe o formato do diálogo.
+//
+// Por que um catálogo em vez de um alvo por vez: o painel tem 176 endpoints de escrita e quase tudo é
+// ESTRUTURADO (liga/desliga, número, enum, item de lista). Sem uma declaração comum, cada alvo novo
+// reescreveria DTO, diálogo e persona. Aqui, alvo novo = 1 entrada aqui + 1 linha no registro do
+// frontend. O modelo continua com UMA tool genérica (`propose_change`) — tool nova encareceria toda
+// chamada da Oráculo, porque schema de tool entra no prefixo cacheado.
+//
+// A IA NUNCA aplica: a proposta é um formulário pré-preenchido e quem aplica é o usuário, pelo diálogo,
+// no endpoint REST normal — com o guard que já existe. Por isso não há `delete` no catálogo: sem
+// exclusão não existe perda de dado possível por sugestão de IA.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LAB_ACTIONS = void 0;
+exports.findLabAction = findLabAction;
+const CONTEXT_FIELDS = [
+    { value: 'about', label: 'Sobre a empresa/oferta' },
+    { value: 'role', label: 'Papel do agente' },
+    { value: 'audience', label: 'Público-alvo' },
+    { value: 'behavior', label: 'Comportamento/tom' },
+];
+exports.LAB_ACTIONS = [
+    {
+        id: 'prompt.update',
+        op: 'update',
+        render: 'text',
+        title: 'Roteiro',
+        path: 'Configurações → Agente → Prompts',
+        summary: 'Reescrever o texto de um roteiro do agente (informe o id do roteiro).',
+        undoHint: 'Configurações → Agente → Prompts: o roteiro tem histórico e dá para restaurar a versão anterior.',
+        params: [
+            {
+                name: 'idPrompt', kind: 'number', identity: true, required: true,
+                label: 'Roteiro',
+                description: 'Id do roteiro a alterar — o número entre colchetes no ÍNDICE dos roteiros.',
+            },
+            {
+                name: 'proposedText', kind: 'text', required: true,
+                label: 'Texto do roteiro',
+                description: 'O texto INTEGRAL novo do roteiro (como deve ficar por completo, não um trecho nem instruções).',
+            },
+        ],
+    },
+    {
+        id: 'context.update',
+        op: 'update',
+        render: 'text',
+        title: 'Contexto básico',
+        path: 'Configurações → Agente → Contexto Básico',
+        summary: 'Reescrever um campo do contexto básico (sobre, papel, público ou comportamento).',
+        undoHint: 'Configurações → Agente → Contexto Básico: dá para editar o campo de novo a qualquer momento.',
+        params: [
+            {
+                name: 'field', kind: 'enum', identity: true, required: true, options: CONTEXT_FIELDS,
+                label: 'Campo',
+                description: 'Qual campo do contexto básico alterar.',
+            },
+            {
+                name: 'proposedText', kind: 'text', required: true,
+                label: 'Texto do campo',
+                description: 'O texto INTEGRAL novo do campo (como deve ficar por completo).',
+            },
+        ],
+    },
+];
+function findLabAction(id) {
+    return exports.LAB_ACTIONS.find(a => a.id === id);
+}

package/dist/support/support-lab-ask.dto.d.ts

@@ -1,6 +1,7 @@
 import { SupportMessageDto } from "./support-message.dto";
 import { SupportAgentBalanceDto } from "./support-agent-balance.dto";
 import { SupportLabPendingAnalysisDto } from "./support-lab-analyze.dto";
+import { LabActionRender, LabProposalChangeDto } from "./lab-action-catalog";
 export interface SupportLabFocusDto {
     idStage?: number;
     runType?: string;
@@ -18,14 +19,23 @@ export interface SupportLabAskDto {
 }
 export interface SupportLabProposalDto {
     id: string;
-    target: 'context' | 'prompt';
-    field?: 'about' | 'role' | 'audience' | 'behavior';
-    idPrompt?: number;
-    kind: 'markdown' | 'spin-yaml';
+    actionId: string;
+    render: LabActionRender;
     title: string;
-    baseText: string;
-    proposedText: string;
+    path: string;
+    params: Record<string, unknown>;
     rationale: string;
+    undoHint: string;
+    kind?: 'markdown' | 'spin-yaml';
+    baseText?: string;
+    proposedText?: string;
+    changes?: LabProposalChangeDto[];
+    /** @deprecated compat 1 deploy (frontend antigo lê estes); use `actionId` + `params`. */
+    target?: 'context' | 'prompt';
+    /** @deprecated compat 1 deploy; use `params.field`. */
+    field?: 'about' | 'role' | 'audience' | 'behavior';
+    /** @deprecated compat 1 deploy; use `params.idPrompt`. */
+    idPrompt?: number;
 }
 export interface SupportLabAnswerDto {
     content: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rodrigobeber/patoai-dtos",
-  "version": "4.8.19",
+  "version": "4.8.21",
   "description": "Data Transfer Objects for PatoAI",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",