What problem does it solve?
Audits AgentStack agents for unwired kb_search nodes (missing knowledgeBaseId),
proposes a fix plan, and — after confirmation — patches each node using only
live MCP data. Zero hallucination tolerance: every ID used in a patch comes
from a real tool response in the current session.
Core Features & Use Cases
- Inspect production agents for unwired kb_search nodes
- Match each unwired node to its correct KB in a strict 1:1 manner
- Build and present a patch plan before applying changes
- Patch nodes using as_patch_node_field with only live IDs
- Verify patches via post-patch re-read
Hard rules (zero-hallucination constraints):
- Every agent ID, KB ID, and node ID used in a patch command must come from a live
MCP tool response in the current session. Never use values from memory or previous
sessions.
- Never call as_patch_node_field without first reading current node state via
as_inspect_flow.
- Never mark a node as FIXED without a post-patch re-read confirming the field is set.
- If KB matching is ambiguous (0 or 2+ KBs for an agent) → halt that agent and report.
Never guess which KB to use.
Quick Start
Run soma-memory-fix to audit, plan, and patch unwired kb_search nodes across all production agents.