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, via, duration?}for the audio file.via.channelis how it was recorded (microphone),via.atwhen recording started;via.notemay say how or why, in prose.durationis set after transcription.transcript:— full text transcription. Present means the clip is transcribed.transcription-error:— set if transcription failed.
If there is 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>, and copy the printed transcript into transcript:. 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.