Module agent_sessions 

Agent session model + persistence.

Session types and storage logic are defined in gestura-core-sessions and re-exported here. This module adds config-dependent extensions (SessionToolSettingsConfigExt) and migration wrappers that depend on crate::config::AppConfig.

Structs

AgentSession

A persisted agent session.

ConversationMessage

A message in a persisted conversation history.

FileAgentSessionStore

File-backed session store (one JSON file per session).

SessionActivityEvent

A durable session activity event captured for replay and export.

SessionInfo

Minimal session info used for list UIs.

SessionLlmConfig

Session-scoped LLM configuration override.

SessionMemoryBlocker

A blocker tracked in short-term memory.

SessionMemoryDecision

A durable decision made during the session.

SessionMemoryEntry

A compact timeline entry retained in session-local memory.

SessionMemoryFinding

A synthesized finding retained for the active session.

SessionMemoryPromotionCandidate

High-value short-term memory candidate for durable promotion.

SessionMemoryResource

A resource remembered for the active session only.

SessionReflectionSettings

Session-scoped experiential reflection override.

SessionState

Persisted session state.

SessionToolCall

Tool call record for session history.

SessionToolSettings

Session-scoped tool availability settings.

SessionVoiceConfig

Session-scoped Voice/STT configuration override.

SessionWorkingMemory

Session-scoped working memory for the active task.

Enums

MessageSource

Source of an end-user message.

SessionBlockerStatus

Status for a remembered blocker.

SessionFilter

Filter for listing sessions.

SessionMemoryEntryKind

Timeline entry kind for short-term memory.

SessionMemoryPromotionSource

Source bucket for promoting short-term memory into durable memory.

SessionMemoryResourceKind

Resource kind tracked in session working memory.

SessionPermissionLevel

Permission level for tool execution.

Traits

AgentSessionStore

A storage abstraction for agent sessions.

SessionToolSettingsConfigExt

Config-dependent constructors for SessionToolSettings.

Functions

default_agent_sessions_dir

Default directory for persisted agent sessions.

effective_session_reflection_enabled

Resolve whether experiential reflection is enabled for a session.

legacy_gui_sessions_file_path

Returns the path for the legacy GUI session history file: ~/.gestura/gui_sessions.json.

migrate_legacy_gui_sessions_to_core

One-time migration from the legacy gui_sessions.json file into the unified core store.

migrate_legacy_gui_sessions_to_core_at_path

One-time migration from a legacy GUI sessions file at a specific path.

sanitize_session_llm_override

Sanitize potentially invalid persisted (provider, model) overrides.

Type Aliases

AgentSessionResult

Result type for agent session store operations.