Expand description
Shared memory console service for CLI and GUI inspection workflows.
This module provides the unified memory-console surface used across CLI, GUI, and agent-facing memory inspection flows. It composes two underlying systems:
- session working memory from
agent_sessions - durable memory-bank entries from
gestura_core::memory_bank
§Design role
The memory console is intentionally a facade-level service instead of a standalone domain crate because it coordinates multiple domains at once:
- session storage
- durable memory-bank retrieval and mutation
- task lifecycle/memory event integration
- shared DTOs consumed by both CLI and GUI presentation layers
§High-signal workflows
- overview facets and counts for memory health
- cross-memory search over working and durable memory
- inspection of promotions, archival state, and provenance
- task-aware memory lifecycle views for handoffs and blockers
This keeps memory-related UX parity in one core-owned place instead of duplicating query logic in multiple frontends.
Structs§
- Memory
Console Count - A simple count bucket for overview facets.
- Memory
Console Entry Detail - Full durable memory detail including content.
- Memory
Console Entry Summary - Durable memory summary displayed in lists and search results.
- Memory
Console Overview - Overview payload for the memory console home screen.
- Memory
Console Query - Search filters shared by CLI, GUI, and slash/TUI memory consoles.
- Memory
Console Search Response - Combined search response for working + durable memory.
- Memory
Console Session Summary - Lightweight session summary used by the memory console.
- Promote
Memory Candidate Request - Request for promoting a working-memory candidate into durable memory.
- Task
Memory Console Detail - Task-memory detail view shared by CLI and GUI.
- Update
Memory Entry Request - Request for updating an existing durable memory entry.
- Working
Memory Match - Search hit from session working memory.
Enums§
- Memory
Console Error - Errors produced while inspecting or mutating memory-console state.
Functions§
- clear_
memory_ console - Clear all durable memory entries in the workspace.
- delete_
memory_ entry_ by_ id - Delete a durable memory entry by id.
- get_
memory_ console_ overview - Build a memory-console overview for a workspace and optional session.
- get_
memory_ entry_ detail - Look up a durable memory entry by CLI/GUI id.
- get_
memory_ promotion_ candidates - Return promotion candidates for the selected session.
- get_
task_ memory_ console_ detail - Read task-local memory lifecycle information.
- get_
working_ memory_ snapshot - Return the current session working-memory snapshot.
- list_
memory_ console_ sessions - List recent sessions for global memory-console browsing.
- load_
memory_ console_ session - Resolve a session id or prefix into a persisted session.
- promote_
memory_ candidate - Promote a working-memory candidate into durable memory.
- refresh_
memory_ console_ governance - Refresh persisted governance suggestions for durable memory.
- search_
memory_ console - Search across working memory and durable memory using shared filters.
- set_
memory_ entry_ archived - Archive or unarchive a durable memory entry.
- update_
memory_ entry_ detail - Update a durable memory entry in place.
Type Aliases§
- Memory
Console Result - Result type for memory-console workflows.