Skip to content

spec: audio-out.md — container-authoritative audio format; mime/sample_rate optional#106

Draft
JarbasAl wants to merge 1 commit into
devfrom
spec/audio-out
Draft

spec: audio-out.md — container-authoritative audio format; mime/sample_rate optional#106
JarbasAl wants to merge 1 commit into
devfrom
spec/audio-out

Conversation

@JarbasAl

@JarbasAl JarbasAl commented Jul 4, 2026

Copy link
Copy Markdown
Member

Refines OVOS-AUDIO-1 to a single, pure audio-format rule.

Changes

  • New §4.0 — Audio format. The container (WAV/MP3/OGG/FLAC) is the single source of truth: it self-describes via magic bytes, and WAV even carries sample rate/channels. mime is therefore OPTIONAL and advisory (a hint a consumer MAY use to skip container detection; the container is authoritative on disagreement). sample_rate is OPTIONAL. Both become REQUIRED only when the payload is a headerless raw stream (raw PCM) with no container. Applied uniformly to ovos.audio.queue (§4.1), ovos.audio.play_sound (§4.2), and ovos.audio.speech (§4.3).
  • §5.3 — the speaking-status query is answered via the MSG-1 response derivation (ovos.audio.is_speaking.response), closing an unspecified reply leg.
  • OVOS-TRANSFORM-1 referenced by its title, Transformer Plugins Specification (two places).
  • CHANGELOG entry appended under the spec's class-2 section.

Version stays 2: these are editorial/additive refinements within the existing compatibility class (VERSIONING.md).

🤖 Generated with Claude Code

…ample_rate

The audio format is intrinsic to the payload's container: WAV/MP3/OGG/
FLAC self-describe via their leading bytes, so a mandatory mime field
would be a second, contradictable declaration. mime and sample_rate are
OPTIONAL advisory hints; both are REQUIRED only for headerless raw
streams (raw PCM). Applied uniformly to ovos.audio.queue, play_sound
and speech (new §4.0). is_speaking now answers via the MSG-1 response
derivation. TRANSFORM-1 referenced by its actual title.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Jul 4, 2026

Copy link
Copy Markdown

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: a74c8a67-c118-4d35-87f4-ce271e70bbd3

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch spec/audio-out

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant