The agent's shared SQLite brain database connection. Accepted for symmetry with other memory tools and for future direct consolidation calls.
The ConsolidationLoop instance to invoke.
The refusal a consolidation meets whatever a human would answer, read before the tool orchestrator's approval gate
(ITool.refusalBeforeApproval), so no one is asked to approve a run that cannot act: a freeze, then any call that
carries a learning layer's session data (withdrawn). execute refuses the same call itself, in the same order.
The call's arguments.
The call's context.
The refusal, or undefined when the call may run.
Run one full consolidation cycle and return the statistics.
If a consolidation cycle is already in progress (mutex guard in
ConsolidationLoop), run() returns immediately with zero counts —
this is surfaced as a successful result with all-zero statistics.
Reflect input (optional topic hint, currently unused).
Tool execution context: a freeze refuses the call (frozen), and so does a call that carries
sessionData.learning (withdrawn), since consolidation merges and derives across every scope of the brain.
ConsolidationResult on success, or an error result.
Readonly idGlobally unique tool identifier.
Readonly nameLLM-facing tool name.
Readonly displayHuman-readable display name.
Readonly descriptionDescription shown to the LLM. The consolidation steps are described explicitly so the model understands what "reflect" means operationally.
Readonly categoryLogical category for discovery and grouping.
Readonly hasConsolidation writes to the database (pruning, merging, inserting insights). Mark as having side effects so callers may request confirmation if needed.
Readonly inputJSON schema for input validation and LLM tool-call construction.
ITool implementation that triggers one full memory consolidation cycle via ().
Usage: