@lionchat/mcp-server 0.5.18 → 0.5.19

package/dist/docs/instructions.md

@@ -261,6 +261,8 @@ Antes de QUALQUER ação que escreve, modifica, apaga ou envia, pare e avalie se
 
 **Aja sem perguntar apenas em operações idempotentes:** leitura, busca, resumo, classificação.
 
+**Excluir agente/usuário (`lionchat_agents_destroy`) — SEMPRE pergunte o destino primeiro.** Se o agente tem recursos vinculados (conversas, tarefas — inclusive as que ele **criou** —, cards do Kanban, campanhas, agendamentos), o sistema EXIGE um destino de reatribuição. Antes de excluir: consulte `lionchat_agents_assigned_resources` (o retorno inclui `tasks_created`, tarefas criadas por ele); se houver QUALQUER recurso, **pergunte pra qual agente transferir tudo** e passe `reassign_to_agent_id` no destroy. Nunca tente excluir sem o destino — o sistema recusa e o trabalho do agente ficaria órfão. Ao excluir, tudo passa pro agente escolhido; o excluído fica só no histórico.
+
 **NUNCA sobrescreva por inferência dados já preenchidos.** Em especial, **NUNCA sobrescreva telefone ou e-mail existente de um contato** — se já há valor preenchido, pergunte antes de alterar.
 
 ## 8. Índice de roteamento (intenção → tool certa)

package/dist/docs/resources/best-practices.md

@@ -117,6 +117,10 @@ Pra reativar: `paused=false`. Toggle é auditado (`audited only: [:paused]`).
 
 **Janela de inconsistência:** ~5-8s. Jobs que já estão dentro do LLM no momento da pausa enviam a resposta mesmo. Use o botão pra parar **novas** respostas, não pra cancelar uma que já saiu.
 
+## Formato do `config` no `captain_assistants_update` (2026-07-11)
+
+O `config` DEVE ser enviado como **objeto** (ex.: `config: { disabled_tools: [...] }`), NUNCA como string/texto. Se vier em formato errado, o backend retorna **422** (não salva ignorando em silêncio). O update do `config` é **merge parcial** — mandar só o subset que muda (ex.: só `disabled_tools`) preserva os demais campos.
+
 ## Limite do prompt e cache OpenAI (2026-05-22)
 
 - `config.instructions` (system prompt do agente) aceita até **20.000 caracteres** (antes 10k). Acima de 15k, o frontend mostra aviso "lost in the middle" — prefira colocar instruções críticas no início ou final.
@@ -140,6 +144,37 @@ Dispara quando o CLIENTE fica inativo após resposta da IA. O motor de follow-up
 **só-leitura** (não executa ferramentas, não coleta dado — só redige a mensagem de retomada,
 com saída estruturada garantida). `paused=true` no assistente corta os follow-ups também.
 
+## Condições para NÃO fazer follow-up + horário de silêncio (2026-07)
+
+`config.follow_up_skip_conditions` — array de até 3 condições (lógica OU: qualquer uma verdadeira
+pula o follow-up). Tipos:
+
+```json
+{ "config": { "follow_up_skip_conditions": [
+  { "type": "label", "operator": "present", "labels": ["follow-pausar"] },
+  { "type": "conversation_attr", "attribute": "status_negociacao", "operator": "equal", "value": "fechado" },
+  { "type": "time_window", "start": 22, "end": 7 }
+] } }
+```
+
+- `label`: pula se a conversa TEM (`present`) / NÃO tem (`absent`) alguma das etiquetas.
+- `contact_attr` / `conversation_attr`: pula quando o atributo do contato/conversa bate o operador
+  (`equal`, `not_equal`, `contains`, `present`, `blank`, `gt`, `lt`) com `value`.
+- **`time_window` (horário de silêncio)**: `start` e `end` são horas inteiras 0-23 (fuso America/Sao_Paulo).
+  No período a IA **NÃO envia follow-up**, mas **continua respondendo o cliente normalmente**. Janela
+  **circular**: `22→7` = silêncio das 22h até as 7h (22,23,0…6). O passo que cai no silêncio é PULADO
+  (não empurra pra frente — evita disparo em massa na abertura); a cadência segue nos passos seguintes.
+  `start == end` = janela inválida (ignorada). Ideal pra não incomodar cliente de madrugada.
+
+## Desligar a IA quando um humano assume (2026-07)
+
+`config.feature_pause_on_human_reply` (bool, padrão false). Ligado, a IA **se desliga sozinha** na
+conversa (fica `captain_assistant_id=null` + `custom_attributes.captain_manually_disabled=true`)
+assim que um HUMANO DE VERDADE assume — atendente responde o cliente pelo painel (ao vivo) OU a
+mensagem sai do celular (coexistência WhatsApp). NÃO desliga: nota privada, mensagem da própria IA,
+follow-up, automação, campanha, confirmação de agendamento, mensagem agendada. Gera uma pílula
+"atendimento assumido pela equipe" na conversa. Pra religar: reatribuir o agente na conversa.
+
 ## Guardrails e diretrizes de resposta (2026-06)
 
 Dois arrays no assistente (top-level, fora do config):

package/dist/docs/resources/data-model.md

@@ -246,6 +246,14 @@ Captain::Assistant
 │     model, temperature, instructions (max 20.000 chars), feature_memory, feature_faq,
 │     feature_follow_up (bool), follow_up_steps (array de {after_minutes, prompt} — ATE 3 etapas,
 │       cada uma >= 5 min, soma <= 1440 min/24h; legado follow_up_time+follow_up_prompt = 1 etapa),
+│     follow_up_skip_conditions (array — condicoes pra NAO fazer follow-up, logica OU, ate 3; tipos:
+│       label {operator present|absent, labels[]}; contact_attr/conversation_attr {attribute, operator
+│       equal|not_equal|contains|present|blank|gt|lt, value}; time_window {start, end — horas inteiras
+│       0-23; NAO envia follow-up nesse periodo, janela circular ex 22->7; a IA SEGUE respondendo o
+│       cliente normal — o silencio e so do follow-up}),
+│     feature_pause_on_human_reply (bool — a IA se DESLIGA sozinha na conversa quando um HUMANO
+│       assume: atendente responde pelo painel (ao vivo) OU mensagem enviada do celular. NAO conta:
+│       nota privada, msg da propria IA, automacao, campanha, confirmacao de agendamento, msg agendada),
 │     activation_label (etiqueta que ativa o agente — unica por conta),
 │     min_response_time / max_response_time (delay humanizado, 1-60s),
 │     disabled_tools (array de IDs de tools desativadas pro assistente),

package/dist/docs/resources/glossary.md

@@ -213,6 +213,11 @@ os de `user_ids` viram membros comuns. A resposta traz `is_supervisor` (boolean)
 - `config.feature_faq`: gera FAQs sugeridas ao resolver conversas
 - `config.feature_follow_up` + `config.follow_up_steps`: follow-up automático em cadência de até
   3 etapas (cada ≥5 min, soma ≤24h) quando o cliente some — motor dedicado só-leitura
+- `config.follow_up_skip_conditions`: array (até 3, lógica OU) de condições pra NÃO fazer follow-up.
+  Tipos: `label`, `contact_attr`/`conversation_attr`, e `time_window` (horário de silêncio: `start`/`end`
+  horas 0-23, janela circular — no período não envia follow-up, mas a IA segue respondendo o cliente)
+- `config.feature_pause_on_human_reply`: bool — a IA se desliga sozinha na conversa quando um humano
+  assume (atendente responde pelo painel OU mensagem do celular); nota privada/automação/campanha não contam
 - `config.model`: modelo OpenAI usado (gpt-4o, gpt-4o-mini)
 - `config.temperature`: 0.0-1.0
 - `config.instructions`: prompt sistema (Liquid template, até 20.000 chars)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lionchat/mcp-server",
-  "version": "0.5.18",
+  "version": "0.5.19",
   "description": "MCP server for LionChat API — 547 tools + 10 resources + 9 prompts. Audit-log aware, completion API, progress notifications.",
   "type": "module",
   "main": "dist/index.js",