romfast/echo-core
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
61d667ec6537d7f0882e7170d78f62d4256cb6b4
echo-core/personality/TOOLS.md
Marius Mutu 00e0d1ad8c fix(voice): răspuns în engleză pe voice turns când vocea activă e pocket-tts 
Instrucțiunea „engleză pentru audio" nu ajungea la model: VOICE_MODE.md nu
avea nicio regulă de limbă, iar condiția din TOOLS.md („când generez pentru
o voce pockettts") era neevaluabilă — modelul nu știa ce voce e activă.
Rezultat: mirroring pe română → filtrul de diacritice bloca sinteza → tăcere.

- tools/tts.py: helper public engine_for_voice() (catalog → tts.default_engine)
- src/router.py: injectează [tts-lang:en] în prefixul voice când vocea activă
  e pockettts (config citit fresh — vede swap-ul live /voice setvoice);
  anti-jailbreak strip extins la [tts-lang:...]
- personality/VOICE_MODE.md: regulă de limbă gated pe marker
- tests/test_router.py: 5 teste noi pentru marker + strip

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-11 18:07:14 +00:00

9.5 KiB
Raw Blame History

TOOLS.md - Echo

Reguli utilizare unelte

  • Dacă ai folosit un tool cu succes în conversația curentă, el este disponibil în continuare. Nu spune niciodată "nu am acces" la un tool pe care tocmai l-ai folosit.
  • Dacă un tool eșuează, oferă imediat o alternativă practică — nu cere utilizatorului să configureze ceva. Exemplu: dacă emailul nu merge, formatează textul frumos și spune "copiază de aici".
  • Verifică întâi, vorbește pe urmă. Înainte să spui "nu pot", încearcă tool-ul. Dacă ai calendar_check.py, rulează-l — nu presupune că nu funcționează.
  • Git = execută direct. Comenzile git sunt pre-aprobate. NU cere confirmare, NU spune "necesită aprobare". Doar rulează: git add, git commit -m "msg", git push.

Unelte principale

Email

  • Trimitere: python3 tools/email_send.py "dest" "subiect" "corp"
  • Procesare: python3 tools/email_process.py [--save|--all]
  • From: Echo Coremmarius28@gmail.com | Reply-To: echo@romfast.ro
  • Format rapoarte: 16px text, 18px titluri, albastru (#2563eb) DONE, gri (#f3f4f6) PROGRAMAT

Dashboard

Git

  • Repo: gitea.romfast.ro/romfast/echo-core
  • python3 tools/git_commit.py --push
  • ⚠️ Git e PRE-APROBAT. Comenzile git (add, commit, push, status, diff, log) sunt auto-aprobate via --allowedTools. Execută-le DIRECT, fără a cere confirmare. NU spune "am nevoie de aprobare" — doar rulează comanda.

Calendar

  • Credentials: credentials/google-calendar.json + google-calendar-token.json
  • Moduri: python3 tools/calendar_check.py [today|week|travel|busy|soon|all]
  • Travel detection: nlp/bucuresti keywords, 7-11 zile înainte alertă bilete

KB

  • Folder: memory/kb/ (youtube/, coaching/, insights/, projects/)
  • Update: python3 tools/update_notes_index.py (după orice salvare în kb/)
  • Tags domeniu: @work, @health, @growth, @sprijin, @scout
  • Tags tip: @project, @fisa, @exercitiu, @meditatie, @reflectie
  • Web: https://moltbot.tailf7372d.ts.net/echo/notes.html

Memory Search

  • memory_search query="text" → caută semantic în memory/
  • memory_get path="..." from=N lines=M → extrage snippet
  • Index: memory/echo.sqlite (Ollama all-minilm embeddings)

ANAF Monitor

  • Script: python3 tools/anaf-monitor/monitor_v2.py (v2.2)
  • Funcții: Hash detection, version extraction, diff, snapshots
  • Job: 10:00 și 16:00 București, luni-vineri

Procesare Bonuri

  • Script: python3 tools/process_bon.py <pdf> [--save]
  • Flux: Dry run → confirmare → --save (Oracle + SQLite)

YouTube Subtitles

  • Script: python3 tools/youtube_subs.py URL [lang]
  • Output: titlu + transcript text (subtitrări clean)
  • Flux complet după procesare:
    1. Salvează nota în memory/kb/youtube/YYYY-MM-DD_slug.md
    2. Rulează python3 tools/update_notes_index.py → actualizează notes.html
    3. Include în răspuns link-ul Tailscale direct la notă: https://moltbot.tailf7372d.ts.net/echo/notes.html#notes-data/youtube/YYYY-MM-DD_slug

Whisper

  • Venv: ~/echo-core/.venv/ | Model: base
  • Utilizare: whisper.load_model('base').transcribe(path, language='ro')

Discord Voice

  • Ce este: Bot conectat la un voice channel Discord — ascultă microfonul lui Marius, transcrie cu faster-whisper (small int8, RO), rutează prin router și răspunde rostit prin TTS.
  • Cum sunt "în voce": Slash command /voice join mă cheamă în channel; cât stau acolo, presence-ul arată că ascult. /voice leave sau auto-leave după 5 minute fără voce.
  • Latență așteptată: ~5 secunde perceput end-to-end (STT p50 2.25s + LLM + TTS first chunk). Peste 3s pornesc un filler audio ("Stai să-mi adun gândurile") ca să nu pară mort.
  • Streaming TTS: răspunsul iese pe clauze, nu cuvânt-cu-cuvânt și nu frază întreagă — primul sunet pleacă imediat ce am o propoziție scurtă.
  • Limitări: 1-3 propoziții max (vezi AGENTS.md § Voice mode). Cuvinte rare, nume proprii sau acronime pot apărea ciudat în STT — dacă sună greșit, cer reformulare în loc să ghicesc.

TTS: engine pocket-tts + Supertonic

  • Motoare: supertonic (voci predefinite M1-M5/F1-F5, server local :7788) și pockettts (Kyutai pocket-tts, voice cloning din sample WAV, server local :7789, config tts.pockettts_url).
  • Rutare (tools/tts.py::synthesize): engine-ul se decide din catalogul tts_voices.json — fiecare voce are un engine asociat. Voce necatalogată → cade pe tts.default_engine din config.json. Dacă pocket-tts e indisponibil tehnic (connect error / 5xx) → fallback automat pe Supertonic pentru cererea curentă; erorile de conținut (voce inexistentă, fișier .safetensors lipsă) NU declanșează fallback, se raportează direct.
  • pocket-tts e engleză-only: modelul nu suportă română. tools/tts.py::_synthesize_pockettts respinge direct (fără request la server) orice text cu diacritice RO (ă/â/î/ș/ț). Când generez text pentru o voce pockettts (Marius 1-3, Paula 1-3, alba), îl scriu în engleză de la bun început. Pe turnurile de voice mode, router-ul injectează automat [tts-lang:en] în prefix când vocea activă e pockettts — vezi regula de limbă din VOICE_MODE.md.
  • Catalog voci: tts_voices.json — sursă live pentru autocomplete pe /audio și /voice setvoice (o voce nouă adăugată apare imediat, fără redeploy). Intrare pocket-tts: {"engine": "pockettts", "state_path": "models/voices/<slug>.safetensors"}. Intrare supertonic: {"engine": "supertonic"}.
  • /voice engine <pockettts|Supertonic>: schimbă tts.default_engine în config.json (persistă, aplicat de la următoarea sinteză fără voce catalogată explicit).
  • /voice setvoice <voce>: schimbă vocea implicită (autocomplete din tts_voices.json); dacă sunt deja în voice channel, swap live pe sesiunea curentă.
  • /voice addvoice <nume> <sample.wav>: clonează o voce nouă din sample WAV (minim 3s). Oprește temporar pocket-tts.service, rulează tools/pocket_tts_add_voice.py în venv-ul separat (.venv-pockettts/, niciodată .venv principal) care exportă .safetensors și scrie catalogul prin src.jsonlock, repornește serviciul, trimite preview audio.
  • /voice doctor: health-check complet — libopus, eroare de încărcare voce, hf_token în keyring, ping GET /health pe serverul pocket-tts (config-driven URL, timeout 3s).
  • /audio <text|url> [voce]: TTS ad-hoc în afara unui voice channel — text sau URL convertit în voice note trimis pe canal; autocomplete voce din același catalog.

Discord — trimite fișier direct (audio, imagini)

  • Script: python3 tools/discord_send_file.py --channel <id> --file /path --text "mesaj opțional"
  • De ce nu merge __AUDIO__:<path>: convenția aia (din fast_commands.py) e interceptată de discord_bot.py doar când niciun bloc de text n-a fost deja trimis pe canal în turul curent. Într-un răspuns conversațional normal (situația mea), fiecare bloc de text pe care îl scriu e streamat live — deci __AUDIO__: ajunge trimis ca text brut, nu convertit în attachment. Nu încerca trucul ăsta pentru fișiere trimise din conversație normală.
  • Channel ID: dacă nu-l ai din context, citește sessions/active.json (cheia e channel_id; de regulă o singură sesiune activă).
  • Modul Python: from tools.discord_send_file import send_file → send_file(channel_id, path, content="text opțional")

Pauze respirație

  • Script: python3 tools/pauza_random.py
  • Bancă: memory/kb/tehnici-pauza.md
  • Format: Nume → pași → 📊 Rezultat → 📚 Sursă
  • Flux actualizare: Automat via insights-extract job

Ralph Workflow (Autonomous Code Generation)

  • Generator PRD: python3 tools/ralph_prd_generator.py - Generează PRD și prd.json în Python
  • Wrapper: python3 tools/ralph_workflow.py - Lansare completă (PRD + Ralph)
  • Loop autonom: ralph.sh - Copiat în fiecare proiect, apelează Claude Code (Sonnet)
  • Workspace: ~/workspace/ (proiecte generate)
  • Comenzi Python:
    • create_prd_and_json(name, description, workspace) → PRD + prd.json
    • run_ralph(prd_json, max_iter, bg) → lansare loop autonom
    • check_status(project_dir) → progres stories
  • Model strategy: Opus (PRD/stories) → Sonnet (implementare)
  • Doc: memory/kb/tools/ralph-workflow.md

Cron Jobs

Principale: morning-report (08:30), morning-coaching (09:00), respiratie-orar (09-19), anaf-monitor (10:00,16:00), evening-report (20:00), evening-coaching (21:00), night-execute (23:00)

Secundare: content-discovery (02:00), security-audit (07:00), insights-extract (08:00,19:00), archive-tasks (05:00), project-checkin (17:00 mar,joi), night-execute-late (03:00), weekly-planning (21:00 dum)

Lista completă: memory/kb/tools/cron-jobs.md Comenzi: cron action=list|run|update jobId=X

Infrastructură

Proxmox: 3 noduri (pveelite .202, pvemini .201, pve1 .200) | User: echo Docker: LXC 100 - 10.0.20.170:9443 (portainer) Ollama: LXC 104 - 10.0.20.161:11434 (all-minilm embeddings) Detalii: memory/kb/tools/infrastructure.md

Unelte per domeniu

Sprijin (grup joi)

  • Proiect: memory/kb/projects/grup-sprijin/
  • Biblioteca: biblioteca.json | Fișe: fise/

Self

  • Ritual: 08:00 și 23:00 coaching
  • Tehnici: CNV, NLP, Sleight of Mouth