@rodrigobeber/patoai-dtos 4.8.20 → 4.8.22

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,56 @@
+/** 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[];
+}
+/**
+ * Como o usuário volta atrás depois de aplicar. É isto — e não o verbo da operação — que define quanto
+ * atrito o diálogo impõe.
+ *   historico → dá para restaurar a versão anterior pela tela (ex.: roteiro)
+ *   tela      → dá para reeditar/refazer na mão (o valor antigo está no próprio diálogo)
+ *   nenhuma   → não volta: o valor antigo se perde no momento em que aplica
+ */
+export type LabActionReversible = 'historico' | 'tela' | 'nenhuma';
+export interface LabAction {
+    id: string;
+    op: 'update' | 'create' | 'delete';
+    render: LabActionRender;
+    title: string;
+    path: string;
+    summary: string;
+    params: LabActionParam[];
+    reversible: LabActionReversible;
+    undoHint: string;
+    /**
+     * O que mais quebra junto, quando o alvo é referenciado em outro lugar (mídia usada em roteiro,
+     * template usado em lembrete, estágio com leads dentro). O texto ESTÁTICO fica aqui; a lista do que
+     * de fato depende deste item é calculada na materialização e vai em `SupportLabProposalDto.impact`.
+     * Cascata é o que o cartão do item NÃO mostra — é por isso que ela precisa ser explícita.
+     */
+    impactHint?: 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,77 @@
+"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.
+//
+// O eixo de risco NÃO é update × delete (apagar um roteiro é SOFT delete, com restaurar na tela; já
+// reescrever um campo do contexto sobrescreve sem histórico nenhum). O que decide o atrito é
+// `reversible` + `impact`, e o diálogo escala: aplicar direto → caixa de aviso → confirmação digitada.
+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).',
+        reversible: 'historico',
+        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).',
+        // O endpoint sobrescreve sem gravar histórico: o texto antigo só existe no diálogo, e some no
+        // instante em que aplica. Por isso é 'nenhuma' — e leva mais atrito que o roteiro, que tem restaurar.
+        reversible: 'nenhuma',
+        undoHint: 'Este campo não tem histórico: copie o texto atual antes de aplicar se quiser poder voltar.',
+        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, LabActionReversible, LabProposalChangeDto } from "./lab-action-catalog";
 export interface SupportLabFocusDto {
     idStage?: number;
     runType?: string;
@@ -18,14 +19,30 @@ 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;
+    reversible: LabActionReversible;
+    undoHint: string;
+    /**
+     * O que quebra junto se aplicar (mídia usada em roteiro, template usado em lembrete...). Calculado na
+     * materialização, não estático: é o que o cartão do item NÃO mostra. Lista não-vazia => confirmação
+     * digitada no diálogo.
+     */
+    impact?: 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.20",
+  "version": "4.8.22",
   "description": "Data Transfer Objects for PatoAI",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",