@rodrigobeber/patoai-dtos 4.8.21 → 4.8.22

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

@@ -20,15 +20,31 @@ export interface LabActionParam {
     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';
+    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 {

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

@@ -10,8 +10,11 @@
 // 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.
+// 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;
@@ -29,6 +32,7 @@ exports.LAB_ACTIONS = [
         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: [
             {
@@ -50,7 +54,10 @@ exports.LAB_ACTIONS = [
         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.',
+        // 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,

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

@@ -1,7 +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";
+import { LabActionRender, LabActionReversible, LabProposalChangeDto } from "./lab-action-catalog";
 export interface SupportLabFocusDto {
     idStage?: number;
     runType?: string;
@@ -25,7 +25,14 @@ export interface SupportLabProposalDto {
     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;

package/package.json

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