Programmatically call lifecycle event end chat for realtime conversations

[pr0j3c7t0dd]

Is your feature request related to a problem? Please describe.
I would like to be able to programmatically end a chat when I detect the end of a realtime conversation, so I can stop the agent, message the user, or redirect them to another page. This could also help with adding guardrails to realtime chats.

Describe the solution you'd like
I would like to have a method to close a chat programmatically end a chat, that calls a chat terminated lifecycle event

Describe alternatives you've considered
I'm not aware of any alternatives. The conversation does wrap up by the AI assistant, but then it just hangs there. I could detect the end of the conversation by watching the transcript, then take some action.

Additional context
None. This could be useful for text chats as well. I can imagine there could be a way to use this feature to terminate a chat from outside or using a tool, for instance, if the user is taking a timed exam, etc.