Graphorin

Appearance

Graphorin API reference v0.12.1

Graphorin API reference / @graphorin/memory / tools

tools ​

Eleven memory tools registered with @graphorin/tools by the createMemory() facade - plus an opt-in twelfth, deep_recall (P2-4), appended only when iterative retrieval is configured. Each factory takes a MemoryToolDeps bundle so consumers can scope the tool surface (per-tier ACL, scope resolver, etc.) without rebuilding the underlying memory facade.

Wave-D D3 adds tool PROFILES: 'full' (the canonical stable-order set), 'interactive' (read-only - the front-line conversational agent cannot write memory by construction; curation belongs to the reviser), and 'reviser' (the full read+write surface, semantically reserved for the sleep-time curation agent). The single-writer split mirrors the channels-wave discipline: interactive agents observe, the reviser mutates.

Interfaces ​

InterfaceDescription
BuildMemoryToolsOptionsOptions for buildMemoryTools.

Type Aliases ​

Type AliasDescription
MemoryToolProfileMemory tool profile (wave-D D3): which slice of the canonical set an agent receives. 'interactive' is read-only by construction.

Variables ​

VariableDescription
MEMORY_TOOL_PROFILESThe valid profile values (runtime validation source).

Functions ​

FunctionDescription
buildMemoryToolsBuild the canonical memory-tool array for a profile. Order is stable for 'full' / 'reviser' - consumers can rely on the indices for snapshot tests. fact_history (P0-2) and fact_validate (P1-4) are appended last so the original nine indices are unchanged. With { includeDeepRecall: true } the gated deep_recall tool (P2-4) is appended after the stable eleven; runbook_search after it. Both gated appendices are reads, so they appear in every profile.
createRunbookSearchToolrunbook_search - find validated procedures matching a task description. Quarantined (unvalidated induced) procedures never surface here: they must not drive actions until validated.

References ​

createBlockAppendTool ​

Re-exports createBlockAppendTool

createBlockReplaceTool ​

Re-exports createBlockReplaceTool

createBlockRethinkTool ​

Re-exports createBlockRethinkTool

createConversationSearchTool ​

Re-exports createConversationSearchTool

createDeepRecallTool ​

Re-exports createDeepRecallTool

createFactForgetTool ​

Re-exports createFactForgetTool

createFactHistoryTool ​

Re-exports createFactHistoryTool

createFactRememberTool ​

Re-exports createFactRememberTool

createFactSearchTool ​

Re-exports createFactSearchTool

createFactSupersedeTool ​

Re-exports createFactSupersedeTool

createFactValidateTool ​

Re-exports createFactValidateTool

createRecallEpisodesTool ​

Re-exports createRecallEpisodesTool

MemoryToolDeps ​

Re-exports MemoryToolDeps

ScopeResolver ​

Re-exports ScopeResolver