Struct ResponseHandler 

pub struct ResponseHandler { /* private fields */ }

Handles all response store operations: lookup, rehydration, and persistence.

Implementations

impl ResponseHandler

pub fn new(store: ResponseStore) -> Self

pub async fn get(&self, ctx: &RequestContext) -> ExecutorResult<ResponseData>

Retrieves the stored response for previous_response_id.

Reads previous_response_id from ctx.original_request.

Errors

Returns ExecutorError if previous_response_id is absent, the response is not found, the store is disabled, or the database query fails.

pub async fn validate_exists(&self, ctx: &RequestContext) -> ExecutorResult<()>

Validates that the response for previous_response_id exists.

Used in the store=false path where we only need to confirm the ID is valid without loading any history.

Errors

Returns ExecutorError if previous_response_id is absent, the response is not found, or the store is disabled.

pub async fn rehydrate( &self, ctx: &RequestContext, ) -> ExecutorResult<Vec<InOutItem>>

Loads all history items referenced by the previous response.

Reads previous_response_id from ctx.original_request. Returns an empty vec if there is no previous response.

Errors

Returns ExecutorError if the store is disabled or the database query fails.

pub async fn execute_turn( &self, ctx: RequestContext, output_items: Vec<OutputItem>, ) -> ExecutorResult<()>

Persists a response record — only the new items from this turn.

Takes ctx and output_items by value so fields can be moved directly into ResponseMetadata without cloning. Prior history must not be re-inserted; the response store records item IDs for this response only.

Errors

Returns ExecutorError if the store is disabled or the database operation fails.

Trait Implementations

impl Clone for ResponseHandler

fn clone(&self) -> ResponseHandler

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ResponseHandler

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.