Spaces:
Sleeping
Download docs/plan/03-interaction.md from JuanCS-Dev/twitch-byte-bot: direct link, hf CLI and curl.
- Browser
- Download file 2.93 kB
-
https://huggingface.co/spaces/JuanCS-Dev/twitch-byte-bot/resolve/main/docs/plan/03-interaction.md
- Command line
-
hf download hf://spaces/JuanCS-Dev/twitch-byte-bot/docs/plan/03-interaction.md
-
curl -L -o 03-interaction.md https://huggingface.co/spaces/JuanCS-Dev/twitch-byte-bot/resolve/main/docs/plan/03-interaction.md
Fase 3 — Interação (o viewer sente) · Tier B
Objetivo: o público interage diretamente com o Byte. Contém o MVP do "uau" (3.1 + Fase 2.1).
Tarefas
- 3.1 Channel Points → Byte fala ⭐ — handler EventSub
channel.channel_points_custom_reward_redemption.addemeventsub_runtime.py(subscription nosetup_hook) → risk queue existente (control_plane, anti-abuso) →voice_runtime. - 3.2 Memória de regulars — saudação por nome de quem volta, via
persistence_semantic_memory_repository(após Fase 1.3). - 3.3 Segmentos/bits — segmentos (trivia, "pergunte ao Byte", marcos de hype) como
ops_playbooks(máquina de estados auditável); gatilho no/studio.
Testes científicos
bot/tests/scientific/test_phase28_interaction_scientific.py — prova: redemption vira item de risk queue e só fala após aprovação/política; saudação de regular usa memória persistida e não repete; playbook de segmento transita estados corretamente. Estende suite_irc_control.py, suite_recap.py.
Meta-Reflexão (2026-06-29)
Os 3 módulos foram construídos e testados; a ativação ao vivo de cada um depende de infra/modo (documentado abaixo), por isso não foram fiados nos hot paths do bot em produção (risco não-validável).
3.3 Segmentos — ✅ CONCLUÍDA e LIVE. segments_runtime + /api/segments + /api/segments/run. Validação e2e ao vivo: POST /api/segments/run {hype} → linha entrou na fila de voz (source=segment). Testes: test_phase28 (known→fala, unknown→lista, rotas).
3.1 Channel Points — ✅ código pronto + testado. channel_points_runtime.process_redemption: voice reward → voz; outros → risk queue (anti-abuso). Testes provam os 3 caminhos. Ativação: TWITCH_CHAT_MODE=eventsub + scope channel:read:redemptions + subscription de redemption no setup_hook chamando process_redemption.
3.2 Regulars — ✅ código pronto + testado. regulars_runtime.note_chatter: first-timer não saúda; retorno após gap → saúda 1x; chat contínuo não re-saúda. Ativação: chamar note_chatter no handler de mensagem (IRC/eventsub) e mandar a saudação via voz/chat; memória persistente entra com Supabase (Fase 1.3).
Go: ✅ código concluído. Abuso de redemption é contido (voice reward limita 200 chars + sanitiza; não-voz vai pra fila). Memória de regulars é por sessão (in-memory, com eviction LRU), respeitando isolamento por canal.
⚠️ Status honesto (ver VALIDATION_REPORT):
channel_points_runtimeeregulars_runtimesão lógica testada, NÃO wiradas (0 refs de produção). Ativação pendente de ambiente validável (EventSub mode + scope de redemptions; hook no caminho de mensagens). Não foram injetadas nos hot paths do bot live sem validação — decisão de integridade pro backend "relógio suíço".