recallnest 2.3.0 → 2.6.0

package/src/mcp-tool-deps.ts

@@ -0,0 +1,48 @@
+/**
+ * Shared dependency contract for MCP tool registration modules.
+ *
+ * P3-B split: the 43 `registerTool(...)` calls that used to live inline in
+ * mcp-server.ts now live in tier modules (mcp-tools-core / -advanced /
+ * -governance). mcp-server.ts owns the heavy module-level state (config,
+ * component resolver, stores, lazy KG handles, the tier-aware registerTool
+ * wrapper) and hands it to each tier module through this contract.
+ *
+ * Mutable module-level handles (kgExtractor / kgStoreInstance) are exposed as
+ * getters so tier handlers read the live value after ensureComponents() runs,
+ * not the null they would capture at registration time.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { createComponentResolver, loadConfig } from "./runtime-config.js";
+import type { SessionCheckpointStore } from "./session-store.js";
+import type { ConflictCandidateStore } from "./conflict-store.js";
+import type { WorkflowObservationStore } from "./workflow-observation-store.js";
+import type { KGExtractor } from "./kg-extractor.js";
+import type { KGStore } from "./kg-store.js";
+import type { AuditLogger } from "./audit-log.js";
+
+export type ToolTier = "core" | "advanced" | "governance";
+export type ToolSchema = Parameters<McpServer["tool"]>[2];
+export type ToolHandler = Parameters<McpServer["tool"]>[3];
+export type ComponentResolver = ReturnType<typeof createComponentResolver>;
+
+export interface ToolRegistryDeps {
+  /** Tier-aware registration wrapper from mcp-server.ts (shouldRegisterTool gate + lazy component init). */
+  registerTool: (name: string, description: string, schema: ToolSchema, handler: ToolHandler) => void;
+  /** Memoized component resolver: getComponents(profileName?) => { store, embedder, retriever, llm, profile }. */
+  getComponents: ComponentResolver;
+  /** Loaded runtime config (used by resume_context for recall-mode resolution). */
+  config: ReturnType<typeof loadConfig>;
+  checkpointStore: SessionCheckpointStore;
+  conflictStore: ConflictCandidateStore;
+  workflowObservationStore: WorkflowObservationStore;
+  /** F-1/F-3b: persistent audit trail — must be injected at the runtime entry or store/reject audit entries never land on disk (codex review 2026-07-10). */
+  auditLogger: AuditLogger;
+  /** Live map of registered tool name -> description, populated by the registerTool wrapper (read by list_tools). */
+  toolDescriptions: Map<string, string>;
+  /** Static tool-name -> tier map (read by list_tools to group/filter tools). */
+  toolTiers: Record<string, ToolTier>;
+  /** Live getter for the lazily-initialized KG extractor (null unless RECALLNEST_KG_MODE=true). */
+  getKGExtractor: () => KGExtractor | null;
+  /** Live getter for the lazily-initialized KG store (null unless RECALLNEST_KG_MODE=true). */
+  getKGStore: () => KGStore | null;
+}