Files
majordomo/docs/adr/README.md
T
steve 434d721b99
CI / Tidy (pull_request) Successful in 10m9s
CI / Build & Test (pull_request) Successful in 11m16s
Adversarial Review (Gadfly) / review (pull_request) Successful in 14m51s
feat: audio surfaces (TTS + transcription), imagegen.Editor, llamaswap health probe
- New leaf package `audio` (ADR-0017): SpeechModel/SpeechProvider and
  TranscriptionModel/TranscriptionProvider with imagegen conventions
  (zero value = backend default, functional options + Apply, bytes
  in/out, never URLs). Root re-exports added.
- imagegen.Editor (ADR-0018): optional image-to-image interface —
  EditRequest carries the generation knobs plus Init image and
  denoising Strength; separate interface so existing Models keep
  compiling.
- provider/llamaswap implements all of it: POST /v1/audio/speech (JSON,
  raw-audio response, MIME from Content-Type with format fallback),
  POST /v1/audio/transcriptions (multipart, response_format=json),
  ListVoices (GET /v1/audio/voices?model=, tolerant of string-list and
  object-list shapes), POST /sdapi/v1/img2img (txt2img wire +
  init_images/denoising_strength, shared image decode), and Health(ctx)
  (GET /health) — a cheap liveness probe for often-offline hosts.
- Hermetic httptest coverage for every new wire shape and validation
  path; README sections + support-matrix footnote updated in the same
  commit (also corrects the stale /v1/images/generations claim — the
  image path has been SDAPI since the seed fix).

First consumer: mort's llamaswap media tool cluster (status / image /
TTS / STT agent tools against the netherstorm host).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01AXQxVhXBw8PwFAtsVrXSmj
2026-07-11 23:24:14 -04:00

2.0 KiB

Architecture Decision Records

One decision per file, append-only; supersede rather than rewrite.

ADR Title Status
0001 Package layout — canonical types in leaf llm, root re-exports Accepted
0002 Canonical message/content model Accepted
0003 Parse grammar — verbatim ids, inline alias expansion, chains Accepted
0004 LLM_* env-DSN provider definitions (go-llm parity + eager load) Accepted
0005 Provider interface and capabilities model Accepted
0006 Model health tracking and backoff Accepted
0007 Dependency policy — stdlib-first, hand-rolled REST clients Accepted
0008 Failover-chain execution semantics Accepted
0009 Multimodal strategy — normalize per target, enforce at provider Accepted
0010 Tools and structured output — canonical shape, native mappings Accepted
0011 Google provider on the official Gen AI SDK Accepted
0012 Agent run loop Accepted
0013 Skill model — additive instruction+tool bundles Accepted
0014 Conversion-driven extensions (resolvers, typed tools, hooks, ops controls) Accepted
0015 llama-swap provider — reuse openai for chat, tailored management + image Accepted
0016 imagegen — a canonical text-to-image interface Accepted
0017 audio — canonical speech synthesis + transcription interfaces Accepted
0018 imagegen.Editor — image-to-image as a separate optional interface Accepted