Module agent_sessions

Expand description

Agent session model + persistence.

This module provides a single shared agent-session representation used by both the CLI and GUI layers.

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.

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.

default_agent_sessions_dir: Default directory for persisted agent sessions.
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 into the unified core store.
sanitize_session_llm_override: Sanitize potentially invalid persisted (provider, model) overrides.