@danhachuel/leadmaster 0.1.19 → 0.1.21

package/CHANGELOG.md

@@ -37,6 +37,55 @@ normaliza para a forma canônica (ex.: `0.1.0`).
    falha se `process.stdin.resume();` desaparecer, se `.unref()` aparecer, se o
    ciclo de vida vinculado for removido ou se os handlers globais sumirem.
 
+## [0.1.21] — 2026-11-09
+
+### Adicionado
+
+- **Módulo de Webhooks revisado conforme especificação:**
+  - `GET /api/webhook` agora retorna também **`ultimo_teste`** (registrado a cada
+    teste bem-sucedido no `config.json`).
+  - `PUT /api/webhook` e `POST /api/webhook/test` **validam a URL**: só
+    `http://`/`https://` são aceitos (400 com mensagem acionável).
+  - Novo evento **`campanha.iniciada`** — disparado quando uma campanha começa a
+    rodar; migração aditiva garante que ele apareça nas configurações existentes.
+  - Frontend `frontend/src/pages/Webhook.tsx` reformulado: eventos exibidos
+    diretamente e limpos (**Lead Criado**, **Campanha Iniciada**, **Campanha
+    Finalizada** — Lei de Hick), **prevenção de erros** (Nielsen): URL fora do
+    padrão http(s) bloqueia o salvamento e marca o input com **borda vermelha**,
+    botão **"Salvar Configurações"** em gradiente (Fitts) e **"Testar Webhook"**
+    em outline contrastante (von Restorff), toast de sucesso/erro no teste e card
+    **"Último teste realizado em: [data/hora]"**.
+- **7 novos testes pytest** (`backend/tests/test_webhook_routes.py`): leitura do
+  padrão, salvamento de URL/eventos com persistência, URL inválida (400), teste
+  com sucesso (mock do `httpx.post`, registra `ultimo_teste`), teste com falha de
+  conexão sem quebrar (mock de `httpx.ConnectError`) e URL de teste inválida.
+
+## [0.1.20] — 2026-11-09
+
+### Adicionado
+
+- **Módulo de Agentes de IA (controle e configuração):**
+  - Backend: `GET /api/agents` (status + prompt de cada agente, e flag
+    `llm_configurado`), `PUT /api/agents/{agent_id}/status` (ativo/inativo) e
+    `PUT /api/agents/{agent_id}/prompt` — persistência no novo arquivo
+    `storage/agents.json` (seed com prompts padrão em pt-BR).
+  - **Regra de bloqueio:** ativar o **Agente de Disparo** sem a chave do LLM
+    configurada retorna **400** com mensagem acionável ("Configure a API Key
+    do LLM em Ferramentas..."); desativar e o Atendimento são sempre
+    permitidos.
+  - Frontend: `frontend/src/pages/Agentes.tsx` reformulado em **dois cards
+    lado a lado** (Disparo / Atendimento): badge de status, **toggle grande**
+    (w-16 h-9 — Fitts), **pulso animado verde-esmeralda** e badge esmeralda
+    quando ativo (von Restorff + Zeigarnik), textarea do **Prompt do Sistema**
+    + botão "Salvar Prompt", toast específico ("Configure a API Key na aba
+    Ferramentas primeiro.") quando o bloqueio 400 ocorre, e **accordion** com
+    as configurações avançadas (modelo LLM/temperatura; modo texto/voz do
+    atendimento) — Lei de Hick.
+- **8 novos testes pytest** (`backend/tests/test_agents_routes.py`): listagem,
+  bloqueio do disparo sem LLM (400), ativação do atendimento, ativação do
+  disparo com LLM, desativação, status inválido/agente desconhecido (400/404),
+  persistência do prompt e erros de prompt.
+
 ## [0.1.19] — 2026-11-09
 
 ### Adicionado

package/backend/main.py

@@ -552,6 +552,56 @@ def buscar_cnpj(dados: CnpjSearchIn):
         raise HTTPException(502, str(e))
 
 
+# ---------------------------------------------------------------------------
+# Agentes de IA (status + prompt do sistema)
+# ---------------------------------------------------------------------------
+
+@app.get("/api/agents")
+def listar_agentes():
+    """Status e prompt de cada agente (disparo / atendimento)."""
+    agentes = storage.get_agents()
+    llm_ok = llm.configurado()
+    return {
+        "llm_configurado": llm_ok,
+        "agentes": {
+            agent_id: {
+                "status": agentes.get(agent_id, {}).get("status", "inativo"),
+                "prompt": agentes.get(agent_id, {}).get("prompt", ""),
+            }
+            for agent_id in storage.AGENTE_IDS
+        },
+    }
+
+
+@app.put("/api/agents/{agent_id}/status")
+def alterar_status_agente(agent_id: str, dados: dict):
+    """Liga/desliga um agente. Ativar o de disparo exige LLM configurada."""
+    if agent_id not in storage.AGENTE_IDS:
+        raise HTTPException(404, f"Agente desconhecido: {agent_id}. Use: disparo ou atendimento.")
+    status = (dados.get("status") or "").strip().lower()
+    if status not in ("ativo", "inativo"):
+        raise HTTPException(400, 'Status inválido. Use: ativo ou inativo.')
+    if status == "ativo" and agent_id == "disparo" and not llm.configurado():
+        raise HTTPException(
+            400,
+            "Configure a API Key do LLM em Ferramentas antes de ativar o Agente de Disparo.",
+        )
+    agente = storage.save_agent(agent_id, {"status": status})
+    return {"ok": True, "agent_id": agent_id, "status": agente["status"]}
+
+
+@app.put("/api/agents/{agent_id}/prompt")
+def salvar_prompt_agente(agent_id: str, dados: dict):
+    """Salva o prompt do sistema do agente em agents.json."""
+    if agent_id not in storage.AGENTE_IDS:
+        raise HTTPException(404, f"Agente desconhecido: {agent_id}. Use: disparo ou atendimento.")
+    prompt = dados.get("prompt")
+    if prompt is None:
+        raise HTTPException(400, "Informe o prompt do sistema.")
+    agente = storage.save_agent(agent_id, {"prompt": str(prompt)})
+    return {"ok": True, "agent_id": agent_id, "prompt": agente["prompt"]}
+
+
 # ---------------------------------------------------------------------------
 # Configuração e integrações
 # ---------------------------------------------------------------------------
@@ -662,21 +712,47 @@ def atendimento_chat(dados: ChatIn):
 
 @app.get("/api/webhook")
 def obter_webhook():
-    return storage.get_config().get("webhook", {})
+    webhook = storage.get_config().get("webhook", {})
+    return {
+        "url": webhook.get("url", ""),
+        "eventos": webhook.get("eventos", []),
+        "ultimo_teste": webhook.get("ultimo_teste"),
+    }
+
+
+def _url_valida(url: str) -> bool:
+    return isinstance(url, str) and (url.startswith("http://") or url.startswith("https://"))
 
 
 @app.put("/api/webhook")
 def salvar_webhook(patch: dict):
     config = storage.get_config()
     webhook = config.get("webhook", {})
+    url = patch.get("url", webhook.get("url", ""))
+    if url and not _url_valida(url):
+        raise HTTPException(400, "URL inválida: deve começar com http:// ou https://.")
     webhook.update({k: v for k, v in patch.items() if k in ("url", "eventos")})
     storage.update_config({"webhook": webhook})
-    return webhook
+    return {
+        "url": webhook.get("url", ""),
+        "eventos": webhook.get("eventos", []),
+        "ultimo_teste": webhook.get("ultimo_teste"),
+    }
 
 
 @app.post("/api/webhook/test")
 def testar_webhook(dados: WebhookTestIn):
-    return agents.testar_webhook(dados.url)
+    if dados.url and not _url_valida(dados.url):
+        raise HTTPException(400, "URL inválida: deve começar com http:// ou https://.")
+    resultado = agents.testar_webhook(dados.url)
+    if resultado.get("ok"):
+        # Registra o último teste bem-sucedido no config.json.
+        config = storage.get_config()
+        webhook = config.get("webhook", {})
+        webhook["ultimo_teste"] = storage.now_iso()
+        storage.update_config({"webhook": webhook})
+        resultado["ultimo_teste"] = webhook["ultimo_teste"]
+    return resultado
 
 
 # ---------------------------------------------------------------------------

package/backend/services/agents.py

@@ -100,6 +100,7 @@ def iniciar_campanha(campaign_id: str) -> dict:
     campaign.setdefault("erros", 0)
     campaign.setdefault("eventos", [])
     storage.upsert_campaign(campaign)
+    disparar_webhook("campanha.iniciada", {"campanha_id": campaign_id, "nome": campaign["nome"]})
 
     threading.Thread(target=_executar_campanha, args=(campaign_id,), daemon=True).start()
     return {"ok": True, "mensagem": "Campanha iniciada."}

package/backend/services/storage.py

@@ -20,6 +20,7 @@ LEADS_FILE = "leads.json"
 CAMPAIGNS_FILE = "campaigns.json"
 PIPELINE_FILE = "pipeline.json"
 CONFIG_FILE = "config.json"
+AGENTS_FILE = "agents.json"
 
 
 # ---------------------------------------------------------------------------
@@ -134,7 +135,7 @@ DEFAULT_CONFIG = {
     },
     "webhook": {
         "url": "",
-        "eventos": ["lead.criado", "lead.etapa", "campanha.concluida"],
+        "eventos": ["lead.criado", "campanha.iniciada", "campanha.concluida"],
     },
 }
 
@@ -188,11 +189,16 @@ def _limpar_deprecated(config: dict) -> dict:
                 mudou = True
     # Evento de webhook do recurso removido.
     webhook = config.get("webhook")
-    if isinstance(webhook, dict) and isinstance(webhook.get("eventos"), list):
-        eventos = [e for e in webhook["eventos"] if e != "video.publicado"]
-        if eventos != webhook["eventos"]:
-            webhook["eventos"] = eventos
-            mudou = True
+    if isinstance(webhook, dict):
+        if isinstance(webhook.get("eventos"), list):
+            eventos = [e for e in webhook["eventos"] if e != "video.publicado"]
+            # Migração aditiva: o evento "campanha.iniciada" passou a existir
+            # (0.1.21) — garantimos que configs antigas também o ofereçam.
+            if "campanha.iniciada" not in eventos:
+                eventos.append("campanha.iniciada")
+            if eventos != webhook["eventos"]:
+                webhook["eventos"] = eventos
+                mudou = True
     # Dados órfãos do pipeline de vídeos: o arquivo só existia para esse recurso.
     pipeline_path = storage_dir() / PIPELINE_FILE
     if pipeline_path.exists():
@@ -352,6 +358,47 @@ def delete_campaign(campaign_id: str) -> bool:
         return True
 
 
+# ---------------------------------------------------------------------------
+# Agentes de IA (status e prompt do sistema)
+# ---------------------------------------------------------------------------
+
+DEFAULT_AGENTS = {
+    "disparo": {
+        "status": "inativo",
+        "prompt": (
+            "Você é um especialista em prospecção consultiva. Escreva mensagens curtas, "
+            "educadas e personalizadas, sempre citando a empresa do lead. Nunca use "
+            "linguagem agressiva ou spam."
+        ),
+    },
+    "atendimento": {
+        "status": "inativo",
+        "prompt": (
+            "Você é o assistente de atendimento do LeadMaster. Responda de forma clara e "
+            "objetiva em português do Brasil, encaminhe dúvidas comerciais para o "
+            "responsável quando necessário."
+        ),
+    },
+}
+
+AGENTE_IDS = ("disparo", "atendimento")
+
+
+def get_agents() -> dict:
+    return _deep_merge(DEFAULT_AGENTS, _read(AGENTS_FILE, {}))
+
+
+def save_agent(agent_id: str, dados: dict) -> dict:
+    """Atualiza campos de um agente (status/prompt) e persiste em agents.json."""
+    with LOCK:
+        agents = get_agents()
+        if agent_id not in agents:
+            agents[agent_id] = {"status": "inativo", "prompt": ""}
+        agents[agent_id].update({k: v for k, v in dados.items() if k in ("status", "prompt")})
+        _write(AGENTS_FILE, agents)
+        return agents[agent_id]
+
+
 # ---------------------------------------------------------------------------
 # Seeds (primeira execução)
 # ---------------------------------------------------------------------------
@@ -433,6 +480,8 @@ def ensure_seeds() -> None:
             _write(CAMPAIGNS_FILE, _seed_campaigns())
         if not (d / CONFIG_FILE).exists():
             _write(CONFIG_FILE, DEFAULT_CONFIG)
+        if not (d / AGENTS_FILE).exists():
+            _write(AGENTS_FILE, DEFAULT_AGENTS)
 
 
 def limpar_seeds_demo() -> None:

package/backend/tests/test_agents_routes.py

@@ -0,0 +1,82 @@
+"""Testes do controle dos Agentes de IA (backend/main.py).
+
+GET /api/agents, PUT /api/agents/{id}/status (com bloqueio do disparo sem
+LLM configurada) e PUT /api/agents/{id}/prompt. Home isolado em tmp.
+"""
+
+import pytest
+from fastapi.testclient import TestClient
+
+import main
+
+
+@pytest.fixture()
+def client(tmp_path, monkeypatch):
+    monkeypatch.setenv("LEADMASTER_HOME", str(tmp_path))
+    with TestClient(main.app) as c:
+        yield c
+
+
+def test_listar_agentes(client):
+    r = client.get("/api/agents")
+    assert r.status_code == 200
+    corpo = r.json()
+    assert "disparo" in corpo["agentes"] and "atendimento" in corpo["agentes"]
+    assert corpo["agentes"]["disparo"]["status"] == "inativo"
+    assert corpo["llm_configurado"] is False  # seed sem chave de LLM
+
+
+def test_ativar_disparo_sem_llm_bloqueia(client):
+    r = client.put("/api/agents/disparo/status", json={"status": "ativo"})
+    assert r.status_code == 400
+    assert "API Key" in r.json()["detail"]
+    # Continua inativo
+    estado = client.get("/api/agents").json()["agentes"]["disparo"]["status"]
+    assert estado == "inativo"
+
+
+def test_ativar_atendimento_permitido_sem_llm(client):
+    r = client.put("/api/agents/atendimento/status", json={"status": "ativo"})
+    assert r.status_code == 200
+    assert r.json()["status"] == "ativo"
+    # Persistido em agents.json
+    estado = client.get("/api/agents").json()["agentes"]["atendimento"]["status"]
+    assert estado == "ativo"
+
+
+def test_ativar_disparo_com_llm(client):
+    # Configura a chave do LLM e ativa o disparo.
+    client.put("/api/config", json={"llm": {"api_key": "sk-teste-123"}})
+    r = client.put("/api/agents/disparo/status", json={"status": "ativo"})
+    assert r.status_code == 200
+    assert r.json()["status"] == "ativo"
+
+
+def test_desativar_agente(client):
+    client.put("/api/agents/atendimento/status", json={"status": "ativo"})
+    r = client.put("/api/agents/atendimento/status", json={"status": "inativo"})
+    assert r.status_code == 200
+    assert r.json()["status"] == "inativo"
+
+
+def test_status_invalido_e_agente_desconhecido(client):
+    r = client.put("/api/agents/disparo/status", json={"status": "talvez"})
+    assert r.status_code == 400
+    r2 = client.put("/api/agents/inexistente/status", json={"status": "ativo"})
+    assert r2.status_code == 404
+
+
+def test_salvar_prompt_persiste(client):
+    prompt = "Você é um agente de prospecção especialista em SaaS."
+    r = client.put("/api/agents/disparo/prompt", json={"prompt": prompt})
+    assert r.status_code == 200
+    assert r.json()["prompt"] == prompt
+    salvo = client.get("/api/agents").json()["agentes"]["disparo"]["prompt"]
+    assert salvo == prompt
+
+
+def test_salvar_prompt_agente_desconhecido(client):
+    r = client.put("/api/agents/inexistente/prompt", json={"prompt": "x"})
+    assert r.status_code == 404
+    r2 = client.put("/api/agents/disparo/prompt", json={})
+    assert r2.status_code == 400

package/backend/tests/test_webhook_routes.py

@@ -0,0 +1,83 @@
+"""Testes das rotas de Webhook (backend/main.py).
+
+GET/PUT /api/webhook (com validação de URL) e POST /api/webhook/test com o
+HTTP externo mockado — o endpoint de teste nunca quebra com URL inválida ou
+indisponível. HOME isolado em diretório temporário.
+"""
+
+from unittest.mock import patch
+
+import httpx
+import pytest
+from fastapi.testclient import TestClient
+
+import main
+
+
+@pytest.fixture()
+def client(tmp_path, monkeypatch):
+    monkeypatch.setenv("LEADMASTER_HOME", str(tmp_path))
+    with TestClient(main.app) as c:
+        yield c
+
+
+def test_obter_padrao(client):
+    r = client.get("/api/webhook")
+    assert r.status_code == 200
+    corpo = r.json()
+    assert corpo["url"] == ""
+    assert "lead.criado" in corpo["eventos"]
+    assert corpo["ultimo_teste"] is None
+
+
+def test_salvar_url_e_eventos(client):
+    r = client.put(
+        "/api/webhook",
+        json={"url": "https://n8n.exemplo.com/webhook/abc", "eventos": ["lead.criado"]},
+    )
+    assert r.status_code == 200
+    corpo = r.json()
+    assert corpo["url"] == "https://n8n.exemplo.com/webhook/abc"
+    assert corpo["eventos"] == ["lead.criado"]
+    # Persistido no config.json
+    salvo = client.get("/api/webhook").json()
+    assert salvo["url"] == "https://n8n.exemplo.com/webhook/abc"
+
+
+def test_salvar_url_invalida_400(client):
+    r = client.put("/api/webhook", json={"url": "nao-e-uma-url"})
+    assert r.status_code == 400
+    assert "http" in r.json()["detail"]
+
+
+def _resposta_ok(*_args, **_kwargs):
+    return httpx.Response(200, json={"ok": True})
+
+
+def test_testar_webhook_sucesso(client):
+    client.put("/api/webhook", json={"url": "https://exemplo.com/hook"})
+    with patch.object(main.agents.httpx, "post", side_effect=_resposta_ok):
+        r = client.post("/api/webhook/test", json={"url": "https://exemplo.com/hook"})
+    assert r.status_code == 200
+    corpo = r.json()
+    assert corpo["ok"] is True
+    assert corpo["status_http"] == 200
+    assert corpo["ultimo_teste"]  # registrado
+
+
+def test_testar_webhook_conexao_falha_nao_quebra(client):
+    # URL indisponível: retorna erro amigável (não 500).
+    with patch.object(main.agents.httpx, "post", side_effect=httpx.ConnectError("sem rede")):
+        r = client.post("/api/webhook/test", json={"url": "https://inexistente.invalid/hook"})
+    assert r.status_code == 200
+    assert r.json()["ok"] is False
+    assert "mensagem" in r.json()
+
+
+def test_testar_webhook_url_invalida_400(client):
+    # Passa o min_length do modelo, mas falha no esquema http(s) → 400.
+    r = client.post("/api/webhook/test", json={"url": "nao-http-url.com/webhook"})
+    assert r.status_code == 400
+    # URL curta demais falha na validação do modelo.
+    r2 = client.post("/api/webhook/test", json={"url": "xyz"})
+    assert r2.status_code == 422