Files
command-center/omp-docs/core/index.md
T
Frank 765b686859 feat(dankvoice): speak the cloned voices in the TUI (Refs #21)
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
2026-10-18 20:00:52 -07:00

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 is agent/config.yml + agent/models.yml in 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.json record (archive): providers, models, packages, subagent overrides.
  • dankvoice — Cloned-voice vocalization extension: /say and auto-speak over frank-tts, endpoint read from agent/models.yml.

Change Tracking