StateOptions Class

Configuration for the per-turn state layer.

Scope keys are namespaced under key_prefix. Storage-specific behavior, including expiry, is configured directly on the selected storage provider.

Constructor

StateOptions(storage: Storage[str, Any] | None = None, key_prefix: str = 'ts')

Parameters

Name	Description
storage	Default value: None
key_prefix	Default value: ts

Attributes

key_prefix

Namespace prefix for scope keys ({prefix}:conv:... / {prefix}:user:...).

key_prefix: str = 'ts'

storage

Backing store for state blobs. When None the loader must be given one.

storage: Storage[str, Any] | None = None