Add turn trigger metadata (#40665)

## What changed

- Add an optional `turnTrigger` field to app-server `turn/start` requests and
  expose it in the generated protocol schemas.
- Propagate non-empty trigger values to Responses request metadata as the
  reserved `turn_trigger` field, while preserving the original value when a
  request steers an active turn.
- Classify turns started by queue dispatch, goal continuation, retry recovery,
  and realtime handoff.

## Testing

- Cover HTTP and WebSocket metadata forwarding, steering behavior, reserved
  metadata handling, and the built-in trigger classifications.

GitOrigin-RevId: c12fe2c522286db21b76081ae6154fbf6bfb3639
This commit is contained in:
pakrym-oai authored and copyberry committed 2026-08-25 18:11:04 +00:00
1 parent ba9567daf3
commit 538900ee76
29 files changed
+189 -11

No files matched your search

@@ -675,6 +675,13 @@
},
"threadId": {
"type": "string"
},
"turnTrigger": {
"description": "Optional source classification for the caller that starts this turn. Ignored when this request steers an already-active turn.",
"type": [
"string",
"null"
]
}
},
"required": [