Audio Status-First Surface and Fault Matrix

This commit is contained in:
2026-03-24 13:40:52 +00:00
parent fd5a5cd22c
commit 9cb0e77b01
5 changed files with 166 additions and 54 deletions
@@ -192,6 +192,13 @@ In the current MVP:
- `audio.play` returns `status:int`;
- `audio.play_sample` returns `status:int`.
Return-shape matrix in v1 syscall surface:
| Syscall | Return | Policy basis |
| --------------------- | ------------ | -------------------------------------- |
| `audio.play` | `status:int` | operational rejection is observable |
| `audio.play_sample` | `status:int` | operational rejection is observable |
### 11.2 Minimum status table for `play`/`play_sample`
- `0` = `OK`
@@ -205,4 +212,5 @@ Operational rules:
- no fallback to default bank when an asset cannot be resolved;
- no silent no-op for invalid `voice_id`;
- invalid `voice_id` must return `VOICE_INVALID`, not `ARG_RANGE_INVALID`;
- invalid numeric ranges (e.g. `volume`, `pan`, `pitch`) must return explicit status.