Bee Box documentation · directory: https://beebox.run/docs/reference/cards/ · index: https://beebox.run/docs/reference/cards/index.md · root: https://beebox.run/llms.txt

# audio Card

# Audio Cards

An audio card represents a chunk of recorded speech from a capture
session. The audio file itself lives in the card's attach scope,
pointed to by `filename.ref:` (attach scope: see ABOUT_CARDS).

Frontmatter:
- `filename:` — `{ref, recorded, source, duration?}` for the audio
  file. `duration` is set after transcription.
- `summary:` — brief summary of what was said (filled during
  transcription).
- `transcript:` — full text transcription (added during
  transcription, absent when new).
- `transcription-error:` — set if transcription failed.

Status: new (not yet transcribed, no `transcript`/`summary`) →
transcribed (transcription complete).

If status is "new" with no `transcript:`, the audio hasn't been
transcribed yet — don't treat it as empty content. This usually means
the transcription provider was unavailable when the capture was
prepared (see the parent capture-session card's
`transcription-failed:` flag). You can retry it yourself: run
`bbx chat retranscribe --file <path-to-the-attached-audio-file>`,
copy the printed transcript into `transcript:` (and a short
`summary:`), and set `status: transcribed`. If the retry also
fails, record it in `transcription-error:` and note it in your
annotation instead of fabricating a transcript.

## The `contains:` field

Give this card a one-sentence `contains:` — the prime retrieval field for
`bbx search` and listings. How to write a good one (carry the information when
it's concise, never a list of parts, under 200 characters) is in the agent
guide's ABOUT_CARDS section.