Slack Watcher

Extensão do Pi que deixa o modelo observar uma thread, canal ou DM do Slack. A extensão faz polling do Slack e empurra cada mensagem nova pro agente conforme ela chega — igual ao pi monitor, mas a fonte é o Slack. O modelo então julga se aquilo requer ação.

• O modelo chama slack_watch(target) no meio da conversa quando fizer sentido.
• A cada mensagem nova daquele alvo, a extensão injeta a mensagem na sessão (via sendUserMessage em modo steer) com um enquadramento de observador.
• O modelo decide: agir (responder/reagir usando o MCP slack-advanced) ou ignorar em silêncio.

Não é um bot standalone: roda dentro da sua sessão Pi. Os watches são session-scoped — param quando a sessão fecha ou no /reload.

Como funciona

| Passo | Mecanismo | |---|---| | Ligar | o modelo chama a tool slack_watch({ target, ... }) | | Observar | setInterval faz poll de conversations.history (canal/DM) ou conversations.replies (thread), guardando o último ts e deduplicando | | Filtrar (opcional) | pré-filtro barato na extensão: keywords, mentionsOnly, questionsOnly | | Empurrar | mensagem nova → sendUserMessage(..., { deliverAs: "steer" }) com framing "julgue se requer ação" | | Agir | o modelo usa o MCP slack-advanced (send_channel_message, add_reaction, …) |

Mensagens do próprio usuário do token e de bots são ignoradas (sem eco/loop).

Por que polling com user token (e não Socket Mode)

O slack-bridge usa Socket Mode + bot token — um bot só vê canais onde foi convidado e não vê suas DMs. O watcher usa um user token com escopos *:history, então enxerga tudo que você enxerga: threads, canais privados e DMs, sem convidar bot nenhum. É o que casa com "thread, canal ou DM".

Setup

Variável de ambiente

SLACK_WATCHER_TOKEN=xoxp-...

| Variável | Obrigatória | Descrição | |---|---|---| | SLACK_WATCHER_TOKEN | sim | User token xoxp-… (aceita SLACK_USER_TOKEN como fallback) |

Escopos necessários no token: channels:history, groups:history, im:history, mpim:history, channels:read, groups:read, users:read. Sem o token a extensão fica inativa silenciosamente (as tools retornam aviso).

Tools (chamadas pelo modelo)

| Tool | Descrição | |---|---| | slack_watch({ target, id?, keywords?, mentionsOnly?, questionsOnly?, pollIntervalMs? }) | começa a observar. target = link de mensagem/thread, #canal, @usuario (DM) ou ID (C…/D…/G…) | | slack_unwatch({ id? , all? }) | para um watch (ou todos) | | slack_watch_list() | lista watches ativos com uptime e contadores |

Comandos

| Comando | Descrição | |---|---| | /slack-watch | mostra os watches ativos nesta sessão |

Exemplo de uso

você: fica de olho no #eng-prs e me avisa se alguém reportar um deploy quebrado

modelo: (chama slack_watch({ target: "#eng-prs", keywords: ["deploy", "quebr", "erro", "prod"] })) Observando #eng-prs. Vou te avisar se algo relevante aparecer.

(mensagem nova é empurrada; o modelo julga e, se relevante, responde na thread via slack-advanced)