# V2 Iris Commentary Orchestration

`@v2/iris-commentary-orchestration` is the TypeScript contract behind the
`V2AICommentary` Unreal plugin.

- Calls `createMatchCommentaryStream` from `@iris/conversation-orchestration`.
- Forces `determinismMode: "off-rollback-only"` and rejects cues marked
  `fromRollbackFrame`.
- Treats outputs as audio/subtitle only; commentary never feeds simulation
  state, AI Director hints, balance counters, or rollback inputs.
- Preserves Iris record-and-replay cache keys
  `(matchId, cueId, cueTriggerFrame, branchId)`.
- Reserves the 800 ms KO-trigger latency budget across Iris LLM round trip,
  persona TTS render, Psyche lipsync render, and safety margin.
- Falls back to a pre-recorded bank line keyed by
  `(cueKind,ruleset,commentatorId,seed)` when the latency envelope is missed.