@weavelogic/knowledge-graph-agent 0.2.0 → 0.4.0

package/dist/mcp-server/server.js

@@ -0,0 +1,280 @@
+import { Server } from "../node_modules/@modelcontextprotocol/sdk/dist/esm/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { McpError, ErrorCode, ListToolsRequestSchema, CallToolRequestSchema } from "../node_modules/@modelcontextprotocol/sdk/dist/esm/types.js";
+import { createLogger } from "../utils/logger.js";
+import { getToolDefinitions, initializeTools, getToolCount } from "./tools/registry.js";
+import { handleToolCall } from "./handlers/index.js";
+const logger = createLogger("mcp-server");
+function generateErrorRefId() {
+  const timestamp = Date.now().toString(36);
+  const random = Math.random().toString(36).substring(2, 8);
+  return `ERR-${timestamp}-${random}`.toUpperCase();
+}
+const DEFAULT_CONFIG = {
+  name: "knowledge-graph-mcp-server",
+  version: "0.3.0",
+  capabilities: {
+    tools: {}
+  }
+};
+class KnowledgeGraphMCPServer {
+  server;
+  isRunning = false;
+  startTime = 0;
+  requestCount = 0;
+  config;
+  // Rate limiting - tracks request counts per minute
+  requestCounts = /* @__PURE__ */ new Map();
+  MAX_REQUESTS_PER_MINUTE = 100;
+  database;
+  cache;
+  projectRoot;
+  /**
+   * Create new MCP server instance
+   *
+   * @param config - Server configuration
+   * @param database - Knowledge graph database instance
+   * @param cache - Shadow cache instance
+   * @param projectRoot - Project root path
+   */
+  constructor(config, database, cache, projectRoot) {
+    this.database = database;
+    this.cache = cache;
+    this.projectRoot = projectRoot;
+    this.config = {
+      name: config?.name || DEFAULT_CONFIG.name,
+      version: config?.version || DEFAULT_CONFIG.version,
+      capabilities: {
+        ...DEFAULT_CONFIG.capabilities,
+        ...config?.capabilities
+      }
+    };
+    this.server = new Server(
+      {
+        name: this.config.name,
+        version: this.config.version
+      },
+      {
+        capabilities: this.config.capabilities
+      }
+    );
+    this.setupHandlers();
+    logger.info("KnowledgeGraphMCPServer initialized", {
+      name: this.config.name,
+      version: this.config.version
+    });
+  }
+  /**
+   * Check rate limit and throw if exceeded
+   *
+   * Implements a fixed-window rate limit of MAX_REQUESTS_PER_MINUTE per minute.
+   * Cleans up old entries to prevent memory leaks.
+   *
+   * @throws McpError if rate limit is exceeded
+   */
+  checkRateLimit() {
+    const now = Math.floor(Date.now() / 6e4);
+    const count = (this.requestCounts.get(now) || 0) + 1;
+    for (const key of this.requestCounts.keys()) {
+      if (key < now - 1) this.requestCounts.delete(key);
+    }
+    if (count > this.MAX_REQUESTS_PER_MINUTE) {
+      logger.warn("Rate limit exceeded", { requestsThisMinute: count - 1 });
+      throw new McpError(
+        ErrorCode.InvalidRequest,
+        "Rate limit exceeded. Please slow down."
+      );
+    }
+    this.requestCounts.set(now, count);
+  }
+  /**
+   * Setup MCP request handlers
+   */
+  setupHandlers() {
+    this.server.setRequestHandler(ListToolsRequestSchema, async () => {
+      try {
+        const tools = getToolDefinitions();
+        logger.debug(`Listing ${tools.length} tools`);
+        return { tools };
+      } catch (error) {
+        const errorRefId = generateErrorRefId();
+        logger.error(
+          "Failed to list tools",
+          error instanceof Error ? error : new Error(String(error)),
+          { errorRefId }
+        );
+        throw new McpError(
+          ErrorCode.InternalError,
+          `An internal error occurred [${errorRefId}]`
+        );
+      }
+    });
+    this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+      this.checkRateLimit();
+      this.requestCount++;
+      const toolName = request.params.name;
+      try {
+        logger.debug(`Handling tool call: ${toolName}`);
+        return await handleToolCall(request);
+      } catch (error) {
+        if (error instanceof McpError) {
+          throw error;
+        }
+        const errorRefId = generateErrorRefId();
+        logger.error(
+          "Tool execution failed",
+          error instanceof Error ? error : new Error(String(error)),
+          { errorRefId, toolName }
+        );
+        throw new McpError(
+          ErrorCode.InternalError,
+          `An internal error occurred [${errorRefId}]`
+        );
+      }
+    });
+    logger.debug("Request handlers configured");
+  }
+  /**
+   * Start the MCP server
+   *
+   * @throws Error if server is already running
+   */
+  async run() {
+    if (this.isRunning) {
+      throw new Error("Server is already running");
+    }
+    try {
+      await initializeTools(this.database, this.cache, this.projectRoot);
+      const transport = new StdioServerTransport();
+      await this.server.connect(transport);
+      this.isRunning = true;
+      this.startTime = Date.now();
+      logger.info("KnowledgeGraphMCPServer running on stdio transport");
+      logger.info("Ready to accept tool requests from MCP clients");
+    } catch (error) {
+      logger.error(
+        "Failed to start MCP server",
+        error instanceof Error ? error : void 0
+      );
+      throw error;
+    }
+  }
+  /**
+   * Shutdown the MCP server gracefully
+   */
+  async shutdown() {
+    if (!this.isRunning) {
+      logger.warn("Server is not running, shutdown skipped");
+      return;
+    }
+    try {
+      await this.server.close();
+      this.isRunning = false;
+      const uptime = Date.now() - this.startTime;
+      logger.info("KnowledgeGraphMCPServer shutdown complete", {
+        uptime: `${(uptime / 1e3).toFixed(2)}s`,
+        requestsHandled: this.requestCount
+      });
+    } catch (error) {
+      logger.error(
+        "Error during shutdown",
+        error instanceof Error ? error : void 0
+      );
+      throw error;
+    }
+  }
+  /**
+   * Get server health status
+   *
+   * @returns Health status object
+   */
+  getHealth() {
+    return {
+      status: this.isRunning ? "healthy" : "unhealthy",
+      components: {
+        database: !!this.database,
+        cache: !!this.cache,
+        agents: true
+        // Agents are always available
+      },
+      uptime: this.isRunning ? Date.now() - this.startTime : 0,
+      requestCount: this.requestCount,
+      toolCount: getToolCount()
+    };
+  }
+  /**
+   * Check if server is currently running
+   *
+   * @returns true if server is running
+   */
+  isServerRunning() {
+    return this.isRunning;
+  }
+  /**
+   * Get server configuration
+   *
+   * @returns Server configuration
+   */
+  getConfig() {
+    return { ...this.config };
+  }
+  /**
+   * Get request count
+   *
+   * @returns Number of requests handled
+   */
+  getRequestCount() {
+    return this.requestCount;
+  }
+  /**
+   * Get server uptime in milliseconds
+   *
+   * @returns Uptime in milliseconds, 0 if not running
+   */
+  getUptime() {
+    return this.isRunning ? Date.now() - this.startTime : 0;
+  }
+}
+async function createMCPServer(config, database, cache, projectRoot) {
+  const server = new KnowledgeGraphMCPServer(config, database, cache, projectRoot);
+  await server.run();
+  return server;
+}
+async function runServer(options) {
+  const server = new KnowledgeGraphMCPServer(
+    options?.config,
+    options?.database,
+    options?.cache,
+    options?.projectRoot
+  );
+  process.on("SIGINT", async () => {
+    logger.info("Received SIGINT, shutting down...");
+    await server.shutdown();
+    process.exit(0);
+  });
+  process.on("SIGTERM", async () => {
+    logger.info("Received SIGTERM, shutting down...");
+    await server.shutdown();
+    process.exit(0);
+  });
+  process.on("uncaughtException", async (error) => {
+    logger.error("Uncaught exception", error);
+    await server.shutdown();
+    process.exit(1);
+  });
+  process.on("unhandledRejection", async (reason) => {
+    logger.error(
+      "Unhandled rejection",
+      reason instanceof Error ? reason : void 0
+    );
+    await server.shutdown();
+    process.exit(1);
+  });
+  await server.run();
+}
+export {
+  KnowledgeGraphMCPServer,
+  createMCPServer,
+  runServer
+};
+//# sourceMappingURL=server.js.map

package/dist/mcp-server/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sources":["../../src/mcp-server/server.ts"],"sourcesContent":["/**\n * Knowledge Graph MCP Server\n *\n * Main MCP server implementation for exposing knowledge graph functionality\n * to Claude Desktop and other MCP clients.\n *\n * @module mcp-server/server\n */\n\nimport { Server } from '@modelcontextprotocol/sdk/server/index.js';\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\nimport {\n  CallToolRequestSchema,\n  ListToolsRequestSchema,\n  ErrorCode,\n  McpError,\n} from '@modelcontextprotocol/sdk/types.js';\nimport { createLogger } from '../utils/index.js';\nimport { getToolDefinitions, initializeTools, getToolCount } from './tools/registry.js';\nimport { handleToolCall } from './handlers/index.js';\nimport type { MCPServerConfig, ServerHealth } from './types/index.js';\nimport type { KnowledgeGraphDatabase } from '../core/database.js';\nimport type { ShadowCache } from '../core/cache.js';\n\nconst logger = createLogger('mcp-server');\n\n/**\n * Generate a unique error reference ID for log correlation\n * @returns A unique error reference ID\n */\nfunction generateErrorRefId(): string {\n  const timestamp = Date.now().toString(36);\n  const random = Math.random().toString(36).substring(2, 8);\n  return `ERR-${timestamp}-${random}`.toUpperCase();\n}\n\n/**\n * Default server configuration\n */\nconst DEFAULT_CONFIG: MCPServerConfig = {\n  name: 'knowledge-graph-mcp-server',\n  version: '0.3.0',\n  capabilities: {\n    tools: {},\n  },\n};\n\n/**\n * Knowledge Graph MCP Server\n *\n * Provides MCP protocol implementation for knowledge graph operations.\n * Supports tool listing and execution over stdio transport.\n *\n * @example\n * ```typescript\n * const server = new KnowledgeGraphMCPServer();\n * await server.run();\n * ```\n */\nexport class KnowledgeGraphMCPServer {\n  private server: Server;\n  private isRunning: boolean = false;\n  private startTime: number = 0;\n  private requestCount: number = 0;\n  private config: MCPServerConfig;\n\n  // Rate limiting - tracks request counts per minute\n  private requestCounts: Map<number, number> = new Map();\n  private readonly MAX_REQUESTS_PER_MINUTE = 100;\n\n  private database?: KnowledgeGraphDatabase;\n  private cache?: ShadowCache;\n  private projectRoot?: string;\n\n  /**\n   * Create new MCP server instance\n   *\n   * @param config - Server configuration\n   * @param database - Knowledge graph database instance\n   * @param cache - Shadow cache instance\n   * @param projectRoot - Project root path\n   */\n  constructor(\n    config?: Partial<MCPServerConfig>,\n    database?: KnowledgeGraphDatabase,\n    cache?: ShadowCache,\n    projectRoot?: string\n  ) {\n    this.database = database;\n    this.cache = cache;\n    this.projectRoot = projectRoot;\n\n    // Merge with default config\n    this.config = {\n      name: config?.name || DEFAULT_CONFIG.name,\n      version: config?.version || DEFAULT_CONFIG.version,\n      capabilities: {\n        ...DEFAULT_CONFIG.capabilities,\n        ...config?.capabilities,\n      },\n    };\n\n    // Create MCP server instance\n    this.server = new Server(\n      {\n        name: this.config.name,\n        version: this.config.version,\n      },\n      {\n        capabilities: this.config.capabilities,\n      }\n    );\n\n    // Setup request handlers\n    this.setupHandlers();\n\n    logger.info('KnowledgeGraphMCPServer initialized', {\n      name: this.config.name,\n      version: this.config.version,\n    });\n  }\n\n  /**\n   * Check rate limit and throw if exceeded\n   *\n   * Implements a fixed-window rate limit of MAX_REQUESTS_PER_MINUTE per minute.\n   * Cleans up old entries to prevent memory leaks.\n   *\n   * @throws McpError if rate limit is exceeded\n   */\n  private checkRateLimit(): void {\n    const now = Math.floor(Date.now() / 60000); // Current minute\n    const count = (this.requestCounts.get(now) || 0) + 1;\n\n    // Clean old entries to prevent memory leaks\n    for (const key of this.requestCounts.keys()) {\n      if (key < now - 1) this.requestCounts.delete(key);\n    }\n\n    if (count > this.MAX_REQUESTS_PER_MINUTE) {\n      logger.warn('Rate limit exceeded', { requestsThisMinute: count - 1 });\n      throw new McpError(\n        ErrorCode.InvalidRequest,\n        'Rate limit exceeded. Please slow down.'\n      );\n    }\n\n    this.requestCounts.set(now, count);\n  }\n\n  /**\n   * Setup MCP request handlers\n   */\n  private setupHandlers(): void {\n    // Handle ListTools requests\n    this.server.setRequestHandler(ListToolsRequestSchema, async () => {\n      try {\n        const tools = getToolDefinitions();\n        logger.debug(`Listing ${tools.length} tools`);\n        return { tools };\n      } catch (error) {\n        const errorRefId = generateErrorRefId();\n        logger.error(\n          'Failed to list tools',\n          error instanceof Error ? error : new Error(String(error)),\n          { errorRefId }\n        );\n        throw new McpError(\n          ErrorCode.InternalError,\n          `An internal error occurred [${errorRefId}]`\n        );\n      }\n    });\n\n    // Handle CallTool requests\n    this.server.setRequestHandler(CallToolRequestSchema, async (request) => {\n      // Check rate limit before processing\n      this.checkRateLimit();\n\n      this.requestCount++;\n      const toolName = request.params.name;\n\n      try {\n        logger.debug(`Handling tool call: ${toolName}`);\n        return await handleToolCall(request);\n      } catch (error) {\n        // Re-throw MCP errors as they are already sanitized\n        if (error instanceof McpError) {\n          throw error;\n        }\n\n        // Generate error reference for log correlation\n        const errorRefId = generateErrorRefId();\n        logger.error(\n          'Tool execution failed',\n          error instanceof Error ? error : new Error(String(error)),\n          { errorRefId, toolName }\n        );\n\n        // Return sanitized error message with reference ID\n        throw new McpError(\n          ErrorCode.InternalError,\n          `An internal error occurred [${errorRefId}]`\n        );\n      }\n    });\n\n    logger.debug('Request handlers configured');\n  }\n\n  /**\n   * Start the MCP server\n   *\n   * @throws Error if server is already running\n   */\n  async run(): Promise<void> {\n    if (this.isRunning) {\n      throw new Error('Server is already running');\n    }\n\n    try {\n      // Initialize tools with dependencies\n      await initializeTools(this.database, this.cache, this.projectRoot);\n\n      // Create stdio transport\n      const transport = new StdioServerTransport();\n\n      // Connect server to transport\n      await this.server.connect(transport);\n\n      this.isRunning = true;\n      this.startTime = Date.now();\n\n      logger.info('KnowledgeGraphMCPServer running on stdio transport');\n      logger.info('Ready to accept tool requests from MCP clients');\n    } catch (error) {\n      logger.error(\n        'Failed to start MCP server',\n        error instanceof Error ? error : undefined\n      );\n      throw error;\n    }\n  }\n\n  /**\n   * Shutdown the MCP server gracefully\n   */\n  async shutdown(): Promise<void> {\n    if (!this.isRunning) {\n      logger.warn('Server is not running, shutdown skipped');\n      return;\n    }\n\n    try {\n      // Close server connection\n      await this.server.close();\n\n      this.isRunning = false;\n\n      const uptime = Date.now() - this.startTime;\n      logger.info('KnowledgeGraphMCPServer shutdown complete', {\n        uptime: `${(uptime / 1000).toFixed(2)}s`,\n        requestsHandled: this.requestCount,\n      });\n    } catch (error) {\n      logger.error(\n        'Error during shutdown',\n        error instanceof Error ? error : undefined\n      );\n      throw error;\n    }\n  }\n\n  /**\n   * Get server health status\n   *\n   * @returns Health status object\n   */\n  getHealth(): ServerHealth {\n    return {\n      status: this.isRunning ? 'healthy' : 'unhealthy',\n      components: {\n        database: !!this.database,\n        cache: !!this.cache,\n        agents: true, // Agents are always available\n      },\n      uptime: this.isRunning ? Date.now() - this.startTime : 0,\n      requestCount: this.requestCount,\n      toolCount: getToolCount(),\n    };\n  }\n\n  /**\n   * Check if server is currently running\n   *\n   * @returns true if server is running\n   */\n  isServerRunning(): boolean {\n    return this.isRunning;\n  }\n\n  /**\n   * Get server configuration\n   *\n   * @returns Server configuration\n   */\n  getConfig(): MCPServerConfig {\n    return { ...this.config };\n  }\n\n  /**\n   * Get request count\n   *\n   * @returns Number of requests handled\n   */\n  getRequestCount(): number {\n    return this.requestCount;\n  }\n\n  /**\n   * Get server uptime in milliseconds\n   *\n   * @returns Uptime in milliseconds, 0 if not running\n   */\n  getUptime(): number {\n    return this.isRunning ? Date.now() - this.startTime : 0;\n  }\n}\n\n/**\n * Create and start an MCP server\n *\n * Convenience function for creating and running an MCP server in one call.\n *\n * @param config - Server configuration\n * @param database - Knowledge graph database instance\n * @param cache - Shadow cache instance\n * @param projectRoot - Project root path\n * @returns Running MCP server instance\n *\n * @example\n * ```typescript\n * const server = await createMCPServer(\n *   { name: 'my-kg-server' },\n *   database,\n *   cache,\n *   '/my/project'\n * );\n * ```\n */\nexport async function createMCPServer(\n  config?: Partial<MCPServerConfig>,\n  database?: KnowledgeGraphDatabase,\n  cache?: ShadowCache,\n  projectRoot?: string\n): Promise<KnowledgeGraphMCPServer> {\n  const server = new KnowledgeGraphMCPServer(config, database, cache, projectRoot);\n  await server.run();\n  return server;\n}\n\n/**\n * Run MCP server as standalone process\n *\n * Entry point for running the MCP server from command line.\n *\n * @param options - Server options\n */\nexport async function runServer(options?: {\n  config?: Partial<MCPServerConfig>;\n  database?: KnowledgeGraphDatabase;\n  cache?: ShadowCache;\n  projectRoot?: string;\n}): Promise<void> {\n  const server = new KnowledgeGraphMCPServer(\n    options?.config,\n    options?.database,\n    options?.cache,\n    options?.projectRoot\n  );\n\n  // Handle graceful shutdown\n  process.on('SIGINT', async () => {\n    logger.info('Received SIGINT, shutting down...');\n    await server.shutdown();\n    process.exit(0);\n  });\n\n  process.on('SIGTERM', async () => {\n    logger.info('Received SIGTERM, shutting down...');\n    await server.shutdown();\n    process.exit(0);\n  });\n\n  // Handle uncaught errors\n  process.on('uncaughtException', async (error) => {\n    logger.error('Uncaught exception', error);\n    await server.shutdown();\n    process.exit(1);\n  });\n\n  process.on('unhandledRejection', async (reason) => {\n    logger.error(\n      'Unhandled rejection',\n      reason instanceof Error ? reason : undefined\n    );\n    await server.shutdown();\n    process.exit(1);\n  });\n\n  await server.run();\n}\n"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/agents/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Agent Tools - Barrel Export
+ *
+ * Exports agent management MCP tools.
+ *
+ * @module mcp-server/tools/agents
+ */
+export { agentSpawnTool, createAgentSpawnHandler } from './spawn.js';
+export { agentListTool, createAgentListHandler } from './list.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp-server/tools/agents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/agents/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC"}

package/dist/mcp-server/tools/agents/list.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Agent List Tool
+ *
+ * MCP tool for listing all active agents and their status.
+ * Provides filtering by type and status.
+ *
+ * @module mcp-server/tools/agents/list
+ */
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { ToolHandler } from '../../types/index.js';
+/**
+ * Agent list tool definition
+ */
+export declare const agentListTool: Tool;
+/**
+ * Create handler for agent list tool
+ */
+export declare function createAgentListHandler(): ToolHandler;
+//# sourceMappingURL=list.d.ts.map

package/dist/mcp-server/tools/agents/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/agents/list.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,sBAAsB,CAAC;AAGpE;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,IAkB3B,CAAC;AAqCF;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,WAAW,CA6FpD"}

package/dist/mcp-server/tools/agents/spawn.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Agent Spawn Tool
+ *
+ * MCP tool for spawning specialized agents to perform tasks.
+ * Integrates with the agent registry for lifecycle management.
+ *
+ * @module mcp-server/tools/agents/spawn
+ */
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { ToolHandler } from '../../types/index.js';
+/**
+ * Agent spawn tool definition
+ */
+export declare const agentSpawnTool: Tool;
+/**
+ * Create handler for agent spawn tool
+ */
+export declare function createAgentSpawnHandler(): ToolHandler;
+//# sourceMappingURL=spawn.d.ts.map

package/dist/mcp-server/tools/agents/spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/agents/spawn.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,sBAAsB,CAAC;AAGpE;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,IA6B5B,CAAC;AAmCF;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,WAAW,CA2FrD"}

package/dist/mcp-server/tools/audit/checkpoint.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Audit Checkpoint Tool
+ *
+ * MCP tool for creating checkpoints in the audit chain.
+ * Checkpoints provide periodic state snapshots for efficient
+ * verification and sync recovery.
+ *
+ * @module mcp-server/tools/audit/checkpoint
+ */
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { ToolHandler } from '../../types/index.js';
+import type { AuditChain } from '../../../audit/services/audit-chain.js';
+/**
+ * Audit checkpoint tool definition
+ *
+ * Creates a checkpoint in the audit chain with optional
+ * name and tags for identification.
+ */
+export declare const auditCheckpointTool: Tool;
+/**
+ * Parameters for the audit checkpoint tool
+ */
+export interface AuditCheckpointParams {
+    /** Optional checkpoint name */
+    name?: string;
+    /** Optional tags for the checkpoint */
+    tags?: string[];
+}
+/**
+ * Create audit checkpoint handler
+ *
+ * Factory function that creates a tool handler for checkpoint creation.
+ *
+ * @param auditChain - The audit chain instance
+ * @returns Tool handler function
+ *
+ * @example
+ * ```typescript
+ * const auditChain = createAuditChain({ agentDid: 'did:exo:agent-1' });
+ * const handler = createAuditCheckpointHandler(auditChain);
+ *
+ * const result = await handler({
+ *   name: 'pre-migration',
+ *   tags: ['migration', 'backup']
+ * });
+ * ```
+ */
+export declare function createAuditCheckpointHandler(auditChain?: AuditChain): ToolHandler;
+/**
+ * Get the latest checkpoint from the audit chain
+ *
+ * Utility function to retrieve the most recent checkpoint.
+ *
+ * @param auditChain - The audit chain instance
+ * @returns The latest checkpoint or null if none exist
+ */
+export declare function getLatestCheckpoint(auditChain: AuditChain): import("../../../audit/types.js").Checkpoint | null;
+//# sourceMappingURL=checkpoint.d.ts.map

package/dist/mcp-server/tools/audit/checkpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/audit/checkpoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,sBAAsB,CAAC;AACpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AAEzE;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,IAmBjC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,+BAA+B;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,4BAA4B,CAAC,UAAU,CAAC,EAAE,UAAU,GAAG,WAAW,CA4DjF;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,UAAU,uDAEzD"}

package/dist/mcp-server/tools/audit/checkpoint.js

@@ -0,0 +1,73 @@
+const auditCheckpointTool = {
+  name: "kg_audit_checkpoint",
+  description: "Create a checkpoint in the audit chain. Checkpoints provide periodic state snapshots for efficient verification and sync recovery points.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      name: {
+        type: "string",
+        description: "Optional name for the checkpoint (for reference purposes)"
+      },
+      tags: {
+        type: "array",
+        description: "Optional tags for categorizing the checkpoint",
+        items: {
+          type: "string"
+        }
+      }
+    }
+  }
+};
+function createAuditCheckpointHandler(auditChain) {
+  return async (params) => {
+    const startTime = Date.now();
+    const { name, tags } = params;
+    try {
+      if (!auditChain) {
+        return {
+          success: false,
+          error: "Audit chain not initialized. The exochain audit system is not available.",
+          metadata: { executionTime: Date.now() - startTime }
+        };
+      }
+      const statsBefore = auditChain.getStats();
+      const previousCheckpoint = auditChain.getLatestCheckpoint();
+      const checkpoint = await auditChain.createCheckpoint();
+      const statsAfter = auditChain.getStats();
+      const checkpointData = {
+        height: checkpoint.height,
+        eventRoot: checkpoint.eventRoot,
+        stateRoot: checkpoint.stateRoot,
+        timestamp: checkpoint.timestamp.toISOString(),
+        validatorCount: checkpoint.validatorSignatures.length,
+        metadata: {
+          name: name || null,
+          tags: tags || []
+        },
+        stats: {
+          totalEventsAtCheckpoint: statsAfter.totalEvents,
+          eventsSincePreviousCheckpoint: previousCheckpoint ? statsAfter.totalEvents - statsBefore.totalEvents : statsAfter.totalEvents,
+          previousCheckpointHeight: previousCheckpoint?.height ?? null
+        }
+      };
+      return {
+        success: true,
+        data: checkpointData,
+        metadata: {
+          executionTime: Date.now() - startTime
+        }
+      };
+    } catch (error) {
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : String(error),
+        metadata: { executionTime: Date.now() - startTime }
+      };
+    }
+  };
+}
+export {
+  auditCheckpointTool,
+  createAuditCheckpointHandler
+};
+//# sourceMappingURL=checkpoint.js.map

package/dist/mcp-server/tools/audit/checkpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.js","sources":["../../../../src/mcp-server/tools/audit/checkpoint.ts"],"sourcesContent":["/**\n * Audit Checkpoint Tool\n *\n * MCP tool for creating checkpoints in the audit chain.\n * Checkpoints provide periodic state snapshots for efficient\n * verification and sync recovery.\n *\n * @module mcp-server/tools/audit/checkpoint\n */\n\nimport type { Tool } from '@modelcontextprotocol/sdk/types.js';\nimport type { ToolHandler, ToolResult } from '../../types/index.js';\nimport type { AuditChain } from '../../../audit/services/audit-chain.js';\n\n/**\n * Audit checkpoint tool definition\n *\n * Creates a checkpoint in the audit chain with optional\n * name and tags for identification.\n */\nexport const auditCheckpointTool: Tool = {\n  name: 'kg_audit_checkpoint',\n  description: 'Create a checkpoint in the audit chain. Checkpoints provide periodic state snapshots for efficient verification and sync recovery points.',\n  inputSchema: {\n    type: 'object' as const,\n    properties: {\n      name: {\n        type: 'string',\n        description: 'Optional name for the checkpoint (for reference purposes)',\n      },\n      tags: {\n        type: 'array',\n        description: 'Optional tags for categorizing the checkpoint',\n        items: {\n          type: 'string',\n        },\n      },\n    },\n  },\n};\n\n/**\n * Parameters for the audit checkpoint tool\n */\nexport interface AuditCheckpointParams {\n  /** Optional checkpoint name */\n  name?: string;\n  /** Optional tags for the checkpoint */\n  tags?: string[];\n}\n\n/**\n * Create audit checkpoint handler\n *\n * Factory function that creates a tool handler for checkpoint creation.\n *\n * @param auditChain - The audit chain instance\n * @returns Tool handler function\n *\n * @example\n * ```typescript\n * const auditChain = createAuditChain({ agentDid: 'did:exo:agent-1' });\n * const handler = createAuditCheckpointHandler(auditChain);\n *\n * const result = await handler({\n *   name: 'pre-migration',\n *   tags: ['migration', 'backup']\n * });\n * ```\n */\nexport function createAuditCheckpointHandler(auditChain?: AuditChain): ToolHandler {\n  return async (params: Record<string, unknown>): Promise<ToolResult> => {\n    const startTime = Date.now();\n    const { name, tags } = params as AuditCheckpointParams;\n\n    try {\n      // Check audit chain availability\n      if (!auditChain) {\n        return {\n          success: false,\n          error: 'Audit chain not initialized. The exochain audit system is not available.',\n          metadata: { executionTime: Date.now() - startTime },\n        };\n      }\n\n      // Get current stats before checkpoint\n      const statsBefore = auditChain.getStats();\n      const previousCheckpoint = auditChain.getLatestCheckpoint();\n\n      // Create checkpoint\n      const checkpoint = await auditChain.createCheckpoint();\n\n      // Get stats after checkpoint\n      const statsAfter = auditChain.getStats();\n\n      // Format response\n      const checkpointData = {\n        height: checkpoint.height,\n        eventRoot: checkpoint.eventRoot,\n        stateRoot: checkpoint.stateRoot,\n        timestamp: checkpoint.timestamp.toISOString(),\n        validatorCount: checkpoint.validatorSignatures.length,\n        metadata: {\n          name: name || null,\n          tags: tags || [],\n        },\n        stats: {\n          totalEventsAtCheckpoint: statsAfter.totalEvents,\n          eventsSincePreviousCheckpoint: previousCheckpoint\n            ? statsAfter.totalEvents - statsBefore.totalEvents\n            : statsAfter.totalEvents,\n          previousCheckpointHeight: previousCheckpoint?.height ?? null,\n        },\n      };\n\n      return {\n        success: true,\n        data: checkpointData,\n        metadata: {\n          executionTime: Date.now() - startTime,\n        },\n      };\n    } catch (error) {\n      return {\n        success: false,\n        error: error instanceof Error ? error.message : String(error),\n        metadata: { executionTime: Date.now() - startTime },\n      };\n    }\n  };\n}\n\n/**\n * Get the latest checkpoint from the audit chain\n *\n * Utility function to retrieve the most recent checkpoint.\n *\n * @param auditChain - The audit chain instance\n * @returns The latest checkpoint or null if none exist\n */\nexport function getLatestCheckpoint(auditChain: AuditChain) {\n  return auditChain.getLatestCheckpoint();\n}\n"],"names":[],"mappings":"AAoBO,MAAM,sBAA4B;AAAA,EACvC,MAAM;AAAA,EACN,aAAa;AAAA,EACb,aAAa;AAAA,IACX,MAAM;AAAA,IACN,YAAY;AAAA,MACV,MAAM;AAAA,QACJ,MAAM;AAAA,QACN,aAAa;AAAA,MAAA;AAAA,MAEf,MAAM;AAAA,QACJ,MAAM;AAAA,QACN,aAAa;AAAA,QACb,OAAO;AAAA,UACL,MAAM;AAAA,QAAA;AAAA,MACR;AAAA,IACF;AAAA,EACF;AAEJ;AA+BO,SAAS,6BAA6B,YAAsC;AACjF,SAAO,OAAO,WAAyD;AACrE,UAAM,YAAY,KAAK,IAAA;AACvB,UAAM,EAAE,MAAM,KAAA,IAAS;AAEvB,QAAI;AAEF,UAAI,CAAC,YAAY;AACf,eAAO;AAAA,UACL,SAAS;AAAA,UACT,OAAO;AAAA,UACP,UAAU,EAAE,eAAe,KAAK,IAAA,IAAQ,UAAA;AAAA,QAAU;AAAA,MAEtD;AAGA,YAAM,cAAc,WAAW,SAAA;AAC/B,YAAM,qBAAqB,WAAW,oBAAA;AAGtC,YAAM,aAAa,MAAM,WAAW,iBAAA;AAGpC,YAAM,aAAa,WAAW,SAAA;AAG9B,YAAM,iBAAiB;AAAA,QACrB,QAAQ,WAAW;AAAA,QACnB,WAAW,WAAW;AAAA,QACtB,WAAW,WAAW;AAAA,QACtB,WAAW,WAAW,UAAU,YAAA;AAAA,QAChC,gBAAgB,WAAW,oBAAoB;AAAA,QAC/C,UAAU;AAAA,UACR,MAAM,QAAQ;AAAA,UACd,MAAM,QAAQ,CAAA;AAAA,QAAC;AAAA,QAEjB,OAAO;AAAA,UACL,yBAAyB,WAAW;AAAA,UACpC,+BAA+B,qBAC3B,WAAW,cAAc,YAAY,cACrC,WAAW;AAAA,UACf,0BAA0B,oBAAoB,UAAU;AAAA,QAAA;AAAA,MAC1D;AAGF,aAAO;AAAA,QACL,SAAS;AAAA,QACT,MAAM;AAAA,QACN,UAAU;AAAA,UACR,eAAe,KAAK,QAAQ;AAAA,QAAA;AAAA,MAC9B;AAAA,IAEJ,SAAS,OAAO;AACd,aAAO;AAAA,QACL,SAAS;AAAA,QACT,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,QAC5D,UAAU,EAAE,eAAe,KAAK,IAAA,IAAQ,UAAA;AAAA,MAAU;AAAA,IAEtD;AAAA,EACF;AACF;"}

package/dist/mcp-server/tools/audit/index.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Audit Tools
+ *
+ * MCP tools for the exochain audit system, providing:
+ * - Event querying with filtering
+ * - Checkpoint creation for state snapshots
+ * - Sync status monitoring for peer environments
+ *
+ * @module mcp-server/tools/audit
+ */
+export { auditQueryTool, createAuditQueryHandler, type AuditQueryParams, } from './query.js';
+export { auditCheckpointTool, createAuditCheckpointHandler, getLatestCheckpoint, type AuditCheckpointParams, } from './checkpoint.js';
+export { syncStatusTool, createSyncStatusHandler, triggerManualSync, type SyncStatusParams, } from './sync.js';
+/**
+ * All audit tool definitions for registration
+ */
+export declare const auditToolDefinitions: {
+    inputSchema: {
+        [x: string]: unknown;
+        type: "object";
+        properties?: {
+            [x: string]: object;
+        } | undefined;
+        required?: string[] | undefined;
+    };
+    name: string;
+    description?: string | undefined;
+    outputSchema?: {
+        [x: string]: unknown;
+        type: "object";
+        properties?: {
+            [x: string]: object;
+        } | undefined;
+        required?: string[] | undefined;
+    } | undefined;
+    annotations?: {
+        title?: string | undefined;
+        readOnlyHint?: boolean | undefined;
+        destructiveHint?: boolean | undefined;
+        idempotentHint?: boolean | undefined;
+        openWorldHint?: boolean | undefined;
+    } | undefined;
+    _meta?: {
+        [x: string]: unknown;
+    } | undefined;
+    icons?: {
+        src: string;
+        mimeType?: string | undefined;
+        sizes?: string[] | undefined;
+    }[] | undefined;
+    title?: string | undefined;
+}[];
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp-server/tools/audit/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/audit/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,KAAK,gBAAgB,GACtB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,mBAAmB,EACnB,4BAA4B,EAC5B,mBAAmB,EACnB,KAAK,qBAAqB,GAC3B,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,iBAAiB,EACjB,KAAK,gBAAgB,GACtB,MAAM,WAAW,CAAC;AAMnB;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAIhC,CAAC"}

package/dist/mcp-server/tools/audit/index.js

@@ -0,0 +1,12 @@
+import { auditQueryTool, createAuditQueryHandler } from "./query.js";
+import { auditCheckpointTool, createAuditCheckpointHandler } from "./checkpoint.js";
+import { createSyncStatusHandler, syncStatusTool } from "./sync.js";
+export {
+  auditCheckpointTool,
+  auditQueryTool,
+  createAuditCheckpointHandler,
+  createAuditQueryHandler,
+  createSyncStatusHandler,
+  syncStatusTool
+};
+//# sourceMappingURL=index.js.map

package/dist/mcp-server/tools/audit/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;"}

package/dist/mcp-server/tools/audit/query.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Audit Query Tool
+ *
+ * MCP tool for querying the audit log with filtering by event type,
+ * time range, and result limits.
+ *
+ * @module mcp-server/tools/audit/query
+ */
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { ToolHandler } from '../../types/index.js';
+import type { AuditChain } from '../../../audit/services/audit-chain.js';
+/**
+ * Audit query tool definition
+ *
+ * Provides filtering capabilities for the audit log including:
+ * - Event type filtering
+ * - Time range filtering via ISO timestamps
+ * - Result limiting
+ * - Optional payload inclusion
+ */
+export declare const auditQueryTool: Tool;
+/**
+ * Parameters for the audit query tool
+ */
+export interface AuditQueryParams {
+    /** Filter by event type */
+    eventType?: string;
+    /** Start time as ISO timestamp */
+    startTime?: string;
+    /** End time as ISO timestamp */
+    endTime?: string;
+    /** Maximum results to return */
+    limit?: number;
+    /** Include full payload in results */
+    includePayload?: boolean;
+}
+/**
+ * Create audit query handler
+ *
+ * Factory function that creates a tool handler with access to the audit chain.
+ *
+ * @param auditChain - The audit chain instance to query
+ * @returns Tool handler function
+ *
+ * @example
+ * ```typescript
+ * const auditChain = createAuditChain({ agentDid: 'did:exo:agent-1' });
+ * const handler = createAuditQueryHandler(auditChain);
+ *
+ * const result = await handler({
+ *   eventType: 'NodeCreated',
+ *   limit: 10,
+ *   includePayload: true
+ * });
+ * ```
+ */
+export declare function createAuditQueryHandler(auditChain?: AuditChain): ToolHandler;
+//# sourceMappingURL=query.d.ts.map

package/dist/mcp-server/tools/audit/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/audit/query.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,sBAAsB,CAAC;AACpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AAGzE;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,EAAE,IAgC5B,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,CAAC,EAAE,UAAU,GAAG,WAAW,CA8G5E"}