Frank
765b686859
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
21 lines
1.2 KiB
Markdown
21 lines
1.2 KiB
Markdown
# 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 is
|
|
> `agent/config.yml` + `agent/models.yml` in this repo; current fleet endpoints
|
|
> are on [System hosts](/system/index.md). The AGENTS.md format pages remain current.
|
|
|
|
## Concept Files
|
|
|
|
* [AGENTS.md Format Specification](agents-md-format.md) — Canonical structure and conventions for the system-level instruction file that governs agent behavior.
|
|
* [AGENTS.md Index](index-doc.md) — Overview of the cached tool documentation system and how to add new entries.
|
|
* [Pi Settings System](settings.md) — pi-era `settings.json` record (archive): providers, models, packages, subagent overrides.
|
|
* [dankvoice](dankvoice.md) — Cloned-voice vocalization extension: `/say` and auto-speak over frank-tts, endpoint read from `agent/models.yml`.
|
|
|
|
## Change Tracking
|
|
|
|
* [Bundle Change Log](log.md) — Chronological update history.
|