Module: Mneme

Defined in:
lib/mneme.rb,
lib/mneme/runner.rb,
lib/mneme/search.rb,
lib/mneme/l2_runner.rb,
lib/mneme/base_runner.rb,
lib/mneme/recall_runner.rb,
lib/mneme/tools/everything_ok.rb,
lib/mneme/tools/save_snapshot.rb,
lib/mneme/tools/surface_memory.rb,
lib/mneme/tools/nothing_to_surface.rb,
lib/mneme/tools/attach_messages_to_goals.rb

Overview

Mneme — the muse of memory. Watches for viewport eviction and creates summaries before context is lost. One of the Three Muses: she remembers while Melete prepares and Aoide performs.

Operates as a phantom LLM loop: observes the main session, creates snapshots, but leaves no trace of her own reasoning.

Defined Under Namespace

Modules: Tools Classes: BaseRunner, L2Runner, RecallRunner, Runner, Search

Constant Summary collapse

TOOL_PAIR_OVERHEAD_TOKENS =

Estimated token overhead for a synthetic tool_use/tool_result pair — the wrapper JSON that phantom promotions emit around their content (tool name, input hash, ids, framing). Added to the content’s token estimate when sizing phantom pairs in the viewport.

50

Class Method Summary collapse

Class Method Details

.logger ⇒ Logger

Dev-only logger that writes to log/mneme.log. In non-development environments returns a null logger so call sites don’t need conditionals.

Returns:

  • (Logger) 


21
22
23
 
# File 'lib/mneme.rb', line 21

def self.logger
  @logger ||= build_logger
end