3.4 KiB
Disposable guest audio capture
Technical evidence extract for the VCC Plus white paper. Only reviewed contracts, mechanisms, methods, results and limitations are retained. Original validation dates and configuration limits remain historical; this export is not a new test run.
A newly exported C connection
uses toolset 7. capture_playtest_audio requires both the native Allow
Disposable Playtests permission and the exported playtestAudio: true flag.
Older grants retain their advertised tools. No microphone permission is used.
{
"name": "capture_playtest_audio",
"arguments": {"run_id": "<owned run>", "request_id": "tone-01", "fields": 60}
}
The operation releases held keys, drains earlier audio, resumes the owned guest
and advances at most the requested 1–120 emulated fields, then pauses it.
An armed verified breakpoint can shorten the interval; completed reports that
case. It does not record wall-clock playback or the personal emulator session.
For a sound triggered by a key, use ordinary playtest_input first and then
capture the following interval. That preceding input's audio is deliberately
outside the clip. Framebuffer capture remains a separate nonadvancing operation.
The result contains one standard MCP audio content block with mimeType: "audio/wav". Text and structured metadata omit the base64 payload. The WAV is
uncompressed 44,100 Hz stereo, signed 16-bit little-endian PCM from the emulator's
normal audio output, before host volume or playback. No filtering or synthetic
silence is added. A constant DAC level can be silent with a DC offset; analyze
variation or centered RMS rather than requiring all-zero samples.
The receipt binds the clip to run_id, project_id, revision, artifact_id
and boot. Its audio object reports encoding, sample rate, channels, bit depth,
sample_frames (stereo pairs), sample_count (interleaved scalar samples), WAV
byte count and SHA-256. field_start, field_end, fields_requested,
fields_advanced, cycles_start and cycles_end describe the actual guest
interval; advances_execution: true makes the timing effect explicit.
Reuse an identical request ID and plan after a transport retry: it returns the original bytes and interval without advancing again. Changing its plan is a conflict. A retry after a cold restart still identifies the original clip's boot; a new clip has the new boot number. Revoked or incompatible runs cannot replay their clips through a stale grant.
Each clip is limited to 131,072 stereo sample frames (524,332 WAV bytes). A run retains at most 16 unique audio requests and 4 MiB of WAV bytes across all its boots. Before a new request, enough byte allowance must remain for a maximum clip. Retried receipts consume no additional allowance. Existing emulated-field, boot and 1,024 mutation-request limits also apply. Receipts expose remaining audio and mutation budgets. No audio files are automatically written to a project or published to a server.
stop_playtest is exempt from execution/audio request budgets and retains its
usual ownership, request-conflict, disk-preservation and retry safeguards. Even
after the execution ledger is full, an assistant can stop and retain its owned
worker. This exemption does not authorize another input, step or restart.
See verified debugging and diagnostics, owned playtests and project refresh for related contracts.