Every speak-aloud path in the harness gates `--voice` against the bundled Kokoro enum, so the frank-tts cloned voices could only ever produce files. `agent/extensions/` auto-loads, so one tracked extension adds the missing transport: `/say <text>`, `/say on|off` (narrate the final answer at `agent_end`, silent when the harness schedules a continuation), `/say voice|voices|stop|status` — OpenAI speech POST plus playback through pw-play/paplay/ffplay. The endpoint and served id come from the `api: openai-speech` row of `agent/models.yml`, so the file carries no host and no secret; markdown is stripped, over-long utterances are cut at a sentence bound, and the temp WAV dir is always removed. Verified live in a real TUI session on the workstation (roster narrator1/narrator2/narrator3; 2.08 s and 1.44 s WAVs played; auto-speak spoke each finished answer, 1.20 s WAV; unknown voice answers with the roster). Black-box seam `tests/dankvoice.bats` (12 tests) drives the extension against a fixture speech endpoint and a stub player. cwd: /home/blank/.omp/wt/feat-21-dankvoice session: wt-20261017-181502-6d1fc1f
1.2 KiB
1.2 KiB
Core Documentation
These files define the structural conventions that govern the agent system itself. They are the grammar rules — boring until you break them, then devastating.
Archive note (2026-10-18). The settings pages (
settings.md,settings.json) capture the retired pi harness configuration (frank-default-*endpoints, RTX 3090-era hardware) and are historical records. The live config isagent/config.yml+agent/models.ymlin this repo; current fleet endpoints are on System hosts. The AGENTS.md format pages remain current.
Concept Files
- AGENTS.md Format Specification — Canonical structure and conventions for the system-level instruction file that governs agent behavior.
- AGENTS.md Index — Overview of the cached tool documentation system and how to add new entries.
- Pi Settings System — pi-era
settings.jsonrecord (archive): providers, models, packages, subagent overrides. - dankvoice — Cloned-voice vocalization extension:
/sayand auto-speak over frank-tts, endpoint read fromagent/models.yml.
Change Tracking
- Bundle Change Log — Chronological update history.