From 97a26ec4e64a98a24dad7969337d2569339db9a7 Mon Sep 17 00:00:00 2001 From: salmonik Date: Wed, 4 Nov 2026 01:33:33 +0100 Subject: docs: sync with current behavior --- AGENTS.md | 49 +++++++++++++++++++++++++++---------------------- 1 file changed, 27 insertions(+), 22 deletions(-) (limited to 'AGENTS.md') diff --git a/AGENTS.md b/AGENTS.md index 0c1c2d7..760e790 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -4,28 +4,33 @@ ``` src/ -├── main.rs — Entry: init tracing, dotenvy, build Config/Data, start poise+serenity -├── config.rs — Config struct (env-driven), pub const TEMP_PATH +├── main.rs — Entry: tracing, dotenvy, temp dir, Config/Data, poise+serenity +├── config.rs — Config struct (env-driven), temp dir init/access ├── error.rs — Unified Error enum + From impls, pub type Result +├── net.rs — public-IP check for user-supplied URLs (SSRF guard) ├── music.rs — MusicState: per-guild queue, now/next/last, skip, auto-advance +├── recording/mod.rs — per-guild rolling PCM recorder for /record +├── tts.rs — TtsState (piper-rs in-process, bounded DashMap cache, resampler, WAV encoder) ├── commands/ │ ├── mod.rs — all_commands() aggregates every submodule -│ ├── ai.rs — /senator (OpenRouter chat + optional TTS) +│ ├── ai.rs — /senator (LLM chat + optional TTS) +│ ├── autocomplete.rs — Copyparty autocomplete + trigger_name │ ├── cron.rs — /cron group (6 subcommands) -│ ├── math.rs — /math (qalc subprocess) +│ ├── leaderboard.rs — /leaderboard group (me/messages/active/afk/total) +│ ├── math.rs — /math (qalc subprocess, 5s timeout) │ ├── music.rs — /music group (grajcuj, skip, queue, stop, join) + context menu -│ ├── qr.rs — /qr encode + decode +│ ├── qr.rs — /qr encode + decode (dimension/allocation limits) +│ ├── record.rs — /record (flush this guild's buffer to Copyparty) │ ├── trigger.rs — /trigger group (6 subcommands) -│ ├── tts.rs — /tts (local Piper TTS → file/vc), /log_volume -│ ├── utilities.rs — compress🟡, convert🟡, upload, search, download, say +│ ├── tts.rs — /tts (local Piper TTS → file/vc) +│ ├── utilities.rs — compress, convert, upload, search, download, say │ └── web.rs — /web (DuckDuckGo scrape) -├── copyparty/mod.rs — CopypartyClient (search, upload) -├── database/mod.rs — DbPool, 21 query fns, 6 tables, migration -├── events/mod.rs — handle_ready, handle_voice_state_update, handle_message -├── openrouter/mod.rs — OpenRouterClient (chat, chat_with_history) -├── tasks/mod.rs — cron_scheduler_loop (30s polling, stub exec bodies) -├── tts.rs — TtsState (piper-rs in-process, DashMap cache, pre-gen, resampler, WAV encoder) -└── voice/mod.rs — VoiceManager (connect, disconnect, get_call), mp3_to_input +├── copyparty/mod.rs — CopypartyClient (search, upload, credential-safe URLs) +├── database/mod.rs — DbPool, migrations, query helpers (7 tables) +├── events/mod.rs — handle_ready, voice-state, message (triggers + LLM) +├── openrouter/mod.rs — OpenRouterClient (chat, chat_with_history, timeouts) +├── tasks/mod.rs — cron_scheduler_loop (60s polling, real execution) +└── voice/mod.rs — VoiceManager (connect, disconnect, get_call), ffmpeg/symphonia inputs ``` ## Key Conventions @@ -35,18 +40,18 @@ src/ - **Errors**: `crate::error::Error` enum with `?` propagation; use `Error::Custom(string)` for ad-hoc - **Shared state**: `Data` struct in `main.rs` — passed as poise `user_data` - **Commands**: each submodule exports `pub fn commands() -> Vec>` -- **Temp path**: always use `crate::config::TEMP_PATH` (resolves to `/tmp/senator_sperma`) -- **TTS**: piper-rs in-process (no subprocess). `TtsState` in `Data` holds `OnceLock>` + `DashMap` cache. Synthesize via `data.tts.synthesize(text)`. Pre-generates 6 event phrases per user on first voice event. No Google TTS fallback. +- **Permissions**: admin commands use `required_permissions`; recording/cron/trigger are `guild_only` and scoped by `guild_id` in the DB +- **Temp path**: always use `crate::config::temp_path()` (initialized with mode `0700`; never hardcode `/tmp/senator_sperma`) +- **Outbound URLs**: user-supplied `http(s)` URLs go through `crate::net::ensure_public_http_url` unless they belong to the configured Copyparty origin +- **TTS**: piper-rs in-process (no subprocess). `TtsState` holds `OnceLock>>` + a bounded `DashMap` cache. Synthesize via `data.tts.synthesize(text)`; work runs on `spawn_blocking`. No external TTS fallback. +- **Recording**: opt-in (`RECORDING_ENABLED=false` by default), one buffer per guild. ## Build - `build.rs` — compiles C stubs for espeak-rs-sys missing sonic/audio_object symbols -## Stubs to Fill (see COMPARISON.md) -- `commands/utilities.rs` — `/compress`, `/convert`, `/download` upload part -- `tasks/mod.rs` — cron execution bodies are `info!` only, no actual action - ## Database Tables -`settings` (key/value), `voice_activity`, `cron_jobs`, `triggers`, `trigger_keywords`, `trigger_responses` +`settings`, `voice_activity`, `user_stats`, `cron_jobs`, `triggers`, `trigger_keywords`, `trigger_responses` ## Commands -`/senator`, `/cron` (6), `/math`, `/music` (5: grajcuj, skip, queue, stop, join), `/qr` (2), `/trigger` (6), `/tts`, `/log_volume`, `/compress`, `/convert`, `/upload`, `/search`, `/download`, `/say`, `/web`, `/record`, `/leaderboard` +`/senator`, `/cron` (6), `/leaderboard` (5), `/math`, `/music` (5: grajcuj, skip, queue, stop, join), `/qr` (2), `/trigger` (6), `/tts`, `/record`, `/compress`, `/convert`, `/upload`, `/search`, `/download`, `/say`, `/web`. +Context menus: "Odtwórz", "Wyślij załączniki", "kompresja", "Pobierz z linku". -- cgit v1.2.3