strands.experimental.bidi.hooks.events

Hook events emitted by bidirectional agents.

BidiHookEvent

@dataclass
class BidiHookEvent(BaseHookEvent)

Defined in: src/strands/experimental/bidi/hooks/events.py:15

Base class for BidiAgent hook events.

Attributes:

• agent - The BidiAgent instance that triggered this event.

BidiAgentStopEvent

@dataclass
class BidiAgentStopEvent(BidiHookEvent)

Defined in: src/strands/experimental/bidi/hooks/events.py:26

Event triggered after BidiAgent attempts to stop its streaming session.

This event is fired after background-task and model cleanup have been attempted, including when cleanup raises an exception. Hook providers can use this event for cleanup, logging, or state persistence.

Note: This event uses reverse callback ordering, meaning callbacks registered later will be invoked first during cleanup.

This event is triggered at the end of agent.stop().

should_reverse_callbacks

@property
def should_reverse_callbacks() -> bool

Defined in: src/strands/experimental/bidi/hooks/events.py:40

True to invoke callbacks in reverse order.

BidiResponseCompleteEvent

@dataclass
class BidiResponseCompleteEvent(BidiHookEvent)

Defined in: src/strands/experimental/bidi/hooks/events.py:46

Event triggered when the model reports that a response has ended.

A connection failure or shutdown without a model-reported completion does not emit this event.

Attributes:

• response_id - Identifier of the response that ended.
• stop_reason - Why the response ended, including completion or interruption.

BidiInterruptionEvent

@dataclass
class BidiInterruptionEvent(BidiHookEvent)

Defined in: src/strands/experimental/bidi/hooks/events.py:62

Event triggered when model generation is interrupted.

This event is fired when the user interrupts the assistant (e.g., by speaking during the assistant’s response) or when an error causes interruption. This is specific to bidirectional streaming and doesn’t exist in standard agents.

Hook providers can use this event to log interruptions, implement custom interruption handling, or trigger cleanup logic.

Attributes:

• reason - The reason for the interruption (“user_speech” or “error”).
• interrupted_response_id - Optional ID of the response that was interrupted.

BidiBeforeConnectionRestartEvent

@dataclass
class BidiBeforeConnectionRestartEvent(BidiHookEvent)

Defined in: src/strands/experimental/bidi/hooks/events.py:82

Event emitted before the agent restarts the model connection.

A restart is triggered either reactively, after the model reports a timeout, or proactively, when the reconnect timer fires ahead of the provider’s limit.

Attributes:

• reason - What triggered the restart (“timeout” reactively, “scheduled” proactively).
• timeout_error - The model’s timeout error on the reactive path; None when scheduled.

BidiAfterConnectionRestartEvent

@dataclass
class BidiAfterConnectionRestartEvent(BidiHookEvent)

Defined in: src/strands/experimental/bidi/hooks/events.py:98

Event emitted after the agent attempts to restart the model connection.

Attributes:

• reason - What triggered the restart (“timeout” reactively, “scheduled” proactively).
• exception - Populated if an exception was raised during the restart. None means success.