@weavelogic/knowledge-graph-agent 0.3.0 → 0.4.0

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"}

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

@@ -0,0 +1,125 @@
+const auditQueryTool = {
+  name: "kg_audit_query",
+  description: "Query the audit log for events with filtering by type, time range, and limit. Returns events from the deterministic append-only log.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      eventType: {
+        type: "string",
+        description: "Filter by event type (e.g., NodeCreated, WorkflowCompleted, SyncStarted)"
+      },
+      startTime: {
+        type: "string",
+        description: "Start time filter as ISO 8601 timestamp (e.g., 2024-01-01T00:00:00Z)"
+      },
+      endTime: {
+        type: "string",
+        description: "End time filter as ISO 8601 timestamp (e.g., 2024-12-31T23:59:59Z)"
+      },
+      limit: {
+        type: "number",
+        description: "Maximum number of results to return (default: 50, max: 1000)",
+        default: 50,
+        minimum: 1,
+        maximum: 1e3
+      },
+      includePayload: {
+        type: "boolean",
+        description: "Include the full event payload in results (default: false)",
+        default: false
+      }
+    }
+  }
+};
+function createAuditQueryHandler(auditChain) {
+  return async (params) => {
+    const startTime = Date.now();
+    const {
+      eventType,
+      startTime: startTimeParam,
+      endTime: endTimeParam,
+      limit = 50,
+      includePayload = false
+    } = 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 safeLimit = Math.min(Math.max(1, Number(limit) || 50), 1e3);
+      const queryOptions = {
+        limit: safeLimit
+      };
+      if (eventType && typeof eventType === "string") {
+        queryOptions.type = eventType;
+      }
+      if (startTimeParam && typeof startTimeParam === "string") {
+        const startMs = new Date(startTimeParam).getTime();
+        if (!isNaN(startMs)) {
+          queryOptions.since = { physicalMs: startMs, logical: 0 };
+        }
+      }
+      if (endTimeParam && typeof endTimeParam === "string") {
+        const endMs = new Date(endTimeParam).getTime();
+        if (!isNaN(endMs)) {
+          queryOptions.until = { physicalMs: endMs, logical: Number.MAX_SAFE_INTEGER };
+        }
+      }
+      const result = await auditChain.queryEvents(queryOptions);
+      const formattedEvents = result.events.map((event) => {
+        const baseEvent = {
+          id: event.id,
+          type: event.envelope.payload.type,
+          author: event.envelope.author,
+          timestamp: new Date(event.envelope.hlc.physicalMs).toISOString(),
+          hlc: {
+            physicalMs: event.envelope.hlc.physicalMs,
+            logical: event.envelope.hlc.logical
+          },
+          parentCount: event.envelope.parents.length
+        };
+        if (includePayload) {
+          return {
+            ...baseEvent,
+            payload: event.envelope.payload,
+            signature: event.signature,
+            parents: event.envelope.parents
+          };
+        }
+        return baseEvent;
+      });
+      return {
+        success: true,
+        data: {
+          events: formattedEvents,
+          count: formattedEvents.length,
+          totalCount: result.totalCount,
+          hasMore: result.hasMore,
+          filters: {
+            eventType: eventType || null,
+            startTime: startTimeParam || null,
+            endTime: endTimeParam || null
+          }
+        },
+        metadata: {
+          executionTime: Date.now() - startTime,
+          itemCount: formattedEvents.length
+        }
+      };
+    } catch (error) {
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : String(error),
+        metadata: { executionTime: Date.now() - startTime }
+      };
+    }
+  };
+}
+export {
+  auditQueryTool,
+  createAuditQueryHandler
+};
+//# sourceMappingURL=query.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sources":["../../../../src/mcp-server/tools/audit/query.ts"],"sourcesContent":["/**\n * Audit Query Tool\n *\n * MCP tool for querying the audit log with filtering by event type,\n * time range, and result limits.\n *\n * @module mcp-server/tools/audit/query\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';\nimport type { HybridLogicalClock, KnowledgeGraphEventPayload } from '../../../audit/types.js';\n\n/**\n * Audit query tool definition\n *\n * Provides filtering capabilities for the audit log including:\n * - Event type filtering\n * - Time range filtering via ISO timestamps\n * - Result limiting\n * - Optional payload inclusion\n */\nexport const auditQueryTool: Tool = {\n  name: 'kg_audit_query',\n  description: 'Query the audit log for events with filtering by type, time range, and limit. Returns events from the deterministic append-only log.',\n  inputSchema: {\n    type: 'object' as const,\n    properties: {\n      eventType: {\n        type: 'string',\n        description: 'Filter by event type (e.g., NodeCreated, WorkflowCompleted, SyncStarted)',\n      },\n      startTime: {\n        type: 'string',\n        description: 'Start time filter as ISO 8601 timestamp (e.g., 2024-01-01T00:00:00Z)',\n      },\n      endTime: {\n        type: 'string',\n        description: 'End time filter as ISO 8601 timestamp (e.g., 2024-12-31T23:59:59Z)',\n      },\n      limit: {\n        type: 'number',\n        description: 'Maximum number of results to return (default: 50, max: 1000)',\n        default: 50,\n        minimum: 1,\n        maximum: 1000,\n      },\n      includePayload: {\n        type: 'boolean',\n        description: 'Include the full event payload in results (default: false)',\n        default: false,\n      },\n    },\n  },\n};\n\n/**\n * Parameters for the audit query tool\n */\nexport interface AuditQueryParams {\n  /** Filter by event type */\n  eventType?: string;\n  /** Start time as ISO timestamp */\n  startTime?: string;\n  /** End time as ISO timestamp */\n  endTime?: string;\n  /** Maximum results to return */\n  limit?: number;\n  /** Include full payload in results */\n  includePayload?: boolean;\n}\n\n/**\n * Create audit query handler\n *\n * Factory function that creates a tool handler with access to the audit chain.\n *\n * @param auditChain - The audit chain instance to query\n * @returns Tool handler function\n *\n * @example\n * ```typescript\n * const auditChain = createAuditChain({ agentDid: 'did:exo:agent-1' });\n * const handler = createAuditQueryHandler(auditChain);\n *\n * const result = await handler({\n *   eventType: 'NodeCreated',\n *   limit: 10,\n *   includePayload: true\n * });\n * ```\n */\nexport function createAuditQueryHandler(auditChain?: AuditChain): ToolHandler {\n  return async (params: Record<string, unknown>): Promise<ToolResult> => {\n    const startTime = Date.now();\n    const {\n      eventType,\n      startTime: startTimeParam,\n      endTime: endTimeParam,\n      limit = 50,\n      includePayload = false,\n    } = params as AuditQueryParams;\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      // Enforce limits\n      const safeLimit = Math.min(Math.max(1, Number(limit) || 50), 1000);\n\n      // Build query options\n      const queryOptions: {\n        type?: KnowledgeGraphEventPayload['type'];\n        since?: HybridLogicalClock;\n        until?: HybridLogicalClock;\n        limit: number;\n        includeProof?: boolean;\n      } = {\n        limit: safeLimit,\n      };\n\n      // Add event type filter\n      if (eventType && typeof eventType === 'string') {\n        queryOptions.type = eventType as KnowledgeGraphEventPayload['type'];\n      }\n\n      // Add time range filters\n      if (startTimeParam && typeof startTimeParam === 'string') {\n        const startMs = new Date(startTimeParam).getTime();\n        if (!isNaN(startMs)) {\n          queryOptions.since = { physicalMs: startMs, logical: 0 };\n        }\n      }\n\n      if (endTimeParam && typeof endTimeParam === 'string') {\n        const endMs = new Date(endTimeParam).getTime();\n        if (!isNaN(endMs)) {\n          queryOptions.until = { physicalMs: endMs, logical: Number.MAX_SAFE_INTEGER };\n        }\n      }\n\n      // Execute query\n      const result = await auditChain.queryEvents(queryOptions);\n\n      // Format results\n      const formattedEvents = result.events.map((event) => {\n        const baseEvent = {\n          id: event.id,\n          type: event.envelope.payload.type,\n          author: event.envelope.author,\n          timestamp: new Date(event.envelope.hlc.physicalMs).toISOString(),\n          hlc: {\n            physicalMs: event.envelope.hlc.physicalMs,\n            logical: event.envelope.hlc.logical,\n          },\n          parentCount: event.envelope.parents.length,\n        };\n\n        if (includePayload) {\n          return {\n            ...baseEvent,\n            payload: event.envelope.payload,\n            signature: event.signature,\n            parents: event.envelope.parents,\n          };\n        }\n\n        return baseEvent;\n      });\n\n      return {\n        success: true,\n        data: {\n          events: formattedEvents,\n          count: formattedEvents.length,\n          totalCount: result.totalCount,\n          hasMore: result.hasMore,\n          filters: {\n            eventType: eventType || null,\n            startTime: startTimeParam || null,\n            endTime: endTimeParam || null,\n          },\n        },\n        metadata: {\n          executionTime: Date.now() - startTime,\n          itemCount: formattedEvents.length,\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"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,58 @@
+/**
+ * Sync Status Tool
+ *
+ * MCP tool for checking the syndication status of the audit chain
+ * across peer environments.
+ *
+ * @module mcp-server/tools/audit/sync
+ */
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { ToolHandler } from '../../types/index.js';
+import type { SyndicationService } from '../../../audit/services/syndication.js';
+/**
+ * Sync status tool definition
+ *
+ * Provides visibility into peer synchronization status,
+ * including connection state, sync history, and error tracking.
+ */
+export declare const syncStatusTool: Tool;
+/**
+ * Parameters for the sync status tool
+ */
+export interface SyncStatusParams {
+    /** Specific peer ID to check */
+    peerId?: string;
+    /** Include detailed information */
+    detailed?: boolean;
+}
+/**
+ * Create sync status handler
+ *
+ * Factory function that creates a tool handler for checking sync status.
+ *
+ * @param syndicationService - The syndication service instance
+ * @returns Tool handler function
+ *
+ * @example
+ * ```typescript
+ * const syndication = createSyndicationService({ auditChain, peers: [...] });
+ * const handler = createSyncStatusHandler(syndication);
+ *
+ * // Get all peers status
+ * const result = await handler({ detailed: true });
+ *
+ * // Get specific peer status
+ * const result = await handler({ peerId: 'peer-abc123', detailed: true });
+ * ```
+ */
+export declare function createSyncStatusHandler(syndicationService?: SyndicationService): ToolHandler;
+/**
+ * Trigger a manual sync with all peers
+ *
+ * Utility function to force an immediate sync operation.
+ *
+ * @param syndicationService - The syndication service instance
+ * @returns Array of sync results
+ */
+export declare function triggerManualSync(syndicationService: SyndicationService): Promise<import("../../../audit/services/syndication.js").SyncResult[]>;
+//# sourceMappingURL=sync.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/audit/sync.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,kBAAkB,EAAY,MAAM,wCAAwC,CAAC;AAE3F;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,IAiB5B,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AA2BD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,uBAAuB,CAAC,kBAAkB,CAAC,EAAE,kBAAkB,GAAG,WAAW,CAyH5F;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,kBAAkB,EAAE,kBAAkB,0EAE7E"}

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

@@ -0,0 +1,126 @@
+const syncStatusTool = {
+  name: "kg_sync_status",
+  description: "Check the syndication status of the audit chain across peer environments. Shows peer connections, sync history, and error states.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      peerId: {
+        type: "string",
+        description: "Specific peer ID to check status for (optional, returns all peers if not specified)"
+      },
+      detailed: {
+        type: "boolean",
+        description: "Include detailed sync metrics and history (default: false)",
+        default: false
+      }
+    }
+  }
+};
+function createSyncStatusHandler(syndicationService) {
+  return async (params) => {
+    const startTime = Date.now();
+    const { peerId, detailed = false } = params;
+    try {
+      if (!syndicationService) {
+        return {
+          success: false,
+          error: "Syndication service not initialized. Cross-environment sync is not available.",
+          metadata: { executionTime: Date.now() - startTime }
+        };
+      }
+      const formatPeerInfo = (peer) => {
+        const baseInfo = {
+          id: peer.id,
+          endpoint: peer.endpoint,
+          status: peer.status,
+          lastSyncTime: peer.lastSyncTime?.toISOString() || null,
+          errorCount: peer.errors,
+          lastError: peer.lastError || null
+        };
+        if (detailed) {
+          baseInfo.metrics = {
+            eventsReceived: peer.eventsReceived,
+            eventsSent: peer.eventsSent,
+            latency: peer.latency ?? null,
+            lastCheckpointHeight: peer.lastCheckpointHeight ?? null
+          };
+        }
+        return baseInfo;
+      };
+      if (peerId && typeof peerId === "string") {
+        const peer = syndicationService.getPeer(peerId);
+        if (!peer) {
+          return {
+            success: false,
+            error: `Peer not found: ${peerId}`,
+            metadata: { executionTime: Date.now() - startTime }
+          };
+        }
+        return {
+          success: true,
+          data: {
+            peer: formatPeerInfo(peer),
+            serviceStatus: {
+              running: syndicationService.isServiceRunning(),
+              syncing: syndicationService.isSyncing()
+            }
+          },
+          metadata: {
+            executionTime: Date.now() - startTime
+          }
+        };
+      }
+      const allPeers = syndicationService.getAllPeers();
+      const stats = syndicationService.getStats();
+      const formattedPeers = allPeers.map(formatPeerInfo);
+      const peersByStatus = {
+        connected: formattedPeers.filter((p) => p.status === "connected"),
+        syncing: formattedPeers.filter((p) => p.status === "syncing"),
+        disconnected: formattedPeers.filter((p) => p.status === "disconnected"),
+        error: formattedPeers.filter((p) => p.status === "error")
+      };
+      const responseData = {
+        peers: formattedPeers,
+        peersByStatus,
+        summary: {
+          totalPeers: stats.totalPeers,
+          connectedPeers: stats.connectedPeers,
+          syncingPeers: stats.syncingPeers,
+          errorPeers: stats.errorPeers
+        },
+        serviceStatus: {
+          running: stats.isRunning,
+          autoSyncEnabled: stats.autoSyncEnabled,
+          syncInterval: stats.syncInterval,
+          syncing: syndicationService.isSyncing()
+        }
+      };
+      if (detailed) {
+        responseData.aggregateMetrics = {
+          totalEventsReceived: stats.totalEventsReceived,
+          totalEventsSent: stats.totalEventsSent,
+          totalErrors: stats.totalErrors
+        };
+      }
+      return {
+        success: true,
+        data: responseData,
+        metadata: {
+          executionTime: Date.now() - startTime,
+          itemCount: formattedPeers.length
+        }
+      };
+    } catch (error) {
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : String(error),
+        metadata: { executionTime: Date.now() - startTime }
+      };
+    }
+  };
+}
+export {
+  createSyncStatusHandler,
+  syncStatusTool
+};
+//# sourceMappingURL=sync.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sources":["../../../../src/mcp-server/tools/audit/sync.ts"],"sourcesContent":["/**\n * Sync Status Tool\n *\n * MCP tool for checking the syndication status of the audit chain\n * across peer environments.\n *\n * @module mcp-server/tools/audit/sync\n */\n\nimport type { Tool } from '@modelcontextprotocol/sdk/types.js';\nimport type { ToolHandler, ToolResult } from '../../types/index.js';\nimport type { SyndicationService, PeerInfo } from '../../../audit/services/syndication.js';\n\n/**\n * Sync status tool definition\n *\n * Provides visibility into peer synchronization status,\n * including connection state, sync history, and error tracking.\n */\nexport const syncStatusTool: Tool = {\n  name: 'kg_sync_status',\n  description: 'Check the syndication status of the audit chain across peer environments. Shows peer connections, sync history, and error states.',\n  inputSchema: {\n    type: 'object' as const,\n    properties: {\n      peerId: {\n        type: 'string',\n        description: 'Specific peer ID to check status for (optional, returns all peers if not specified)',\n      },\n      detailed: {\n        type: 'boolean',\n        description: 'Include detailed sync metrics and history (default: false)',\n        default: false,\n      },\n    },\n  },\n};\n\n/**\n * Parameters for the sync status tool\n */\nexport interface SyncStatusParams {\n  /** Specific peer ID to check */\n  peerId?: string;\n  /** Include detailed information */\n  detailed?: boolean;\n}\n\n/**\n * Formatted peer status for API response\n */\ninterface FormattedPeerStatus {\n  /** Peer identifier */\n  id: string;\n  /** Network endpoint */\n  endpoint: string;\n  /** Connection status */\n  status: string;\n  /** Last sync timestamp */\n  lastSyncTime: string | null;\n  /** Error count */\n  errorCount: number;\n  /** Last error message */\n  lastError: string | null;\n  /** Detailed metrics (when detailed=true) */\n  metrics?: {\n    eventsReceived: number;\n    eventsSent: number;\n    latency: number | null;\n    lastCheckpointHeight: number | null;\n  };\n}\n\n/**\n * Create sync status handler\n *\n * Factory function that creates a tool handler for checking sync status.\n *\n * @param syndicationService - The syndication service instance\n * @returns Tool handler function\n *\n * @example\n * ```typescript\n * const syndication = createSyndicationService({ auditChain, peers: [...] });\n * const handler = createSyncStatusHandler(syndication);\n *\n * // Get all peers status\n * const result = await handler({ detailed: true });\n *\n * // Get specific peer status\n * const result = await handler({ peerId: 'peer-abc123', detailed: true });\n * ```\n */\nexport function createSyncStatusHandler(syndicationService?: SyndicationService): ToolHandler {\n  return async (params: Record<string, unknown>): Promise<ToolResult> => {\n    const startTime = Date.now();\n    const { peerId, detailed = false } = params as SyncStatusParams;\n\n    try {\n      // Check syndication service availability\n      if (!syndicationService) {\n        return {\n          success: false,\n          error: 'Syndication service not initialized. Cross-environment sync is not available.',\n          metadata: { executionTime: Date.now() - startTime },\n        };\n      }\n\n      // Format peer info for response\n      const formatPeerInfo = (peer: PeerInfo): FormattedPeerStatus => {\n        const baseInfo: FormattedPeerStatus = {\n          id: peer.id,\n          endpoint: peer.endpoint,\n          status: peer.status,\n          lastSyncTime: peer.lastSyncTime?.toISOString() || null,\n          errorCount: peer.errors,\n          lastError: peer.lastError || null,\n        };\n\n        if (detailed) {\n          baseInfo.metrics = {\n            eventsReceived: peer.eventsReceived,\n            eventsSent: peer.eventsSent,\n            latency: peer.latency ?? null,\n            lastCheckpointHeight: peer.lastCheckpointHeight ?? null,\n          };\n        }\n\n        return baseInfo;\n      };\n\n      // Handle specific peer query\n      if (peerId && typeof peerId === 'string') {\n        const peer = syndicationService.getPeer(peerId);\n\n        if (!peer) {\n          return {\n            success: false,\n            error: `Peer not found: ${peerId}`,\n            metadata: { executionTime: Date.now() - startTime },\n          };\n        }\n\n        return {\n          success: true,\n          data: {\n            peer: formatPeerInfo(peer),\n            serviceStatus: {\n              running: syndicationService.isServiceRunning(),\n              syncing: syndicationService.isSyncing(),\n            },\n          },\n          metadata: {\n            executionTime: Date.now() - startTime,\n          },\n        };\n      }\n\n      // Get all peers status\n      const allPeers = syndicationService.getAllPeers();\n      const stats = syndicationService.getStats();\n\n      const formattedPeers = allPeers.map(formatPeerInfo);\n\n      // Group peers by status\n      const peersByStatus: Record<string, FormattedPeerStatus[]> = {\n        connected: formattedPeers.filter((p) => p.status === 'connected'),\n        syncing: formattedPeers.filter((p) => p.status === 'syncing'),\n        disconnected: formattedPeers.filter((p) => p.status === 'disconnected'),\n        error: formattedPeers.filter((p) => p.status === 'error'),\n      };\n\n      const responseData: Record<string, unknown> = {\n        peers: formattedPeers,\n        peersByStatus,\n        summary: {\n          totalPeers: stats.totalPeers,\n          connectedPeers: stats.connectedPeers,\n          syncingPeers: stats.syncingPeers,\n          errorPeers: stats.errorPeers,\n        },\n        serviceStatus: {\n          running: stats.isRunning,\n          autoSyncEnabled: stats.autoSyncEnabled,\n          syncInterval: stats.syncInterval,\n          syncing: syndicationService.isSyncing(),\n        },\n      };\n\n      // Include aggregate metrics if detailed\n      if (detailed) {\n        responseData.aggregateMetrics = {\n          totalEventsReceived: stats.totalEventsReceived,\n          totalEventsSent: stats.totalEventsSent,\n          totalErrors: stats.totalErrors,\n        };\n      }\n\n      return {\n        success: true,\n        data: responseData,\n        metadata: {\n          executionTime: Date.now() - startTime,\n          itemCount: formattedPeers.length,\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 * Trigger a manual sync with all peers\n *\n * Utility function to force an immediate sync operation.\n *\n * @param syndicationService - The syndication service instance\n * @returns Array of sync results\n */\nexport async function triggerManualSync(syndicationService: SyndicationService) {\n  return syndicationService.forceSyncNow();\n}\n"],"names":[],"mappings":"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"}

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

@@ -10,4 +10,7 @@ export { graphQueryTool, createGraphQueryHandler, graphStatsTool, createGraphSta
 export { searchNodesTool, createSearchNodesHandler, searchTagsTool, createSearchTagsHandler, } from './search/index.js';
 export { agentSpawnTool, createAgentSpawnHandler, agentListTool, createAgentListHandler, } from './agents/index.js';
 export { healthCheckTool, createHealthCheckHandler, } from './health.js';
+export { auditQueryTool, createAuditQueryHandler, auditCheckpointTool, createAuditCheckpointHandler, getLatestCheckpoint, syncStatusTool, createSyncStatusHandler, triggerManualSync, auditToolDefinitions, } from './audit/index.js';
+export { vectorSearchTool, createVectorSearchHandler, vectorUpsertTool, createVectorUpsertHandler, trajectoryListTool, createTrajectoryListHandler, } from './vector/index.js';
+export { workflowStartTool, createWorkflowStartHandler, workflowStatusTool, createWorkflowStatusHandler, workflowListTool, createWorkflowListHandler, } from './workflow/index.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,eAAe,EACf,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,eAAe,EACf,WAAW,EACX,QAAQ,EACR,cAAc,GACf,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,cAAc,EACd,uBAAuB,EACvB,iBAAiB,EACjB,0BAA0B,GAC3B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,eAAe,EACf,wBAAwB,EACxB,cAAc,EACd,uBAAuB,GACxB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,aAAa,EACb,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,eAAe,EACf,wBAAwB,GACzB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,eAAe,EACf,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,eAAe,EACf,WAAW,EACX,QAAQ,EACR,cAAc,GACf,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,cAAc,EACd,uBAAuB,EACvB,iBAAiB,EACjB,0BAA0B,GAC3B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,eAAe,EACf,wBAAwB,EACxB,cAAc,EACd,uBAAuB,GACxB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,aAAa,EACb,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,eAAe,EACf,wBAAwB,GACzB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,mBAAmB,EACnB,4BAA4B,EAC5B,mBAAmB,EACnB,cAAc,EACd,uBAAuB,EACvB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,gBAAgB,EAChB,yBAAyB,EACzB,gBAAgB,EAChB,yBAAyB,EACzB,kBAAkB,EAClB,2BAA2B,GAC5B,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,iBAAiB,EACjB,0BAA0B,EAC1B,kBAAkB,EAClB,2BAA2B,EAC3B,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC"}

package/dist/mcp-server/tools/registry.js

@@ -308,6 +308,9 @@ async function registerCoreTools() {
     "graph"
   );
   await registerAgentTools();
+  await registerWorkflowTools();
+  await registerVectorTools();
+  await registerAuditTools();
   logger.debug("Core tools registered");
 }
 async function registerAgentTools() {
@@ -648,6 +651,93 @@ async function registerAgentTools() {
   );
   logger.debug("Agent tools registered");
 }
+async function registerWorkflowTools() {
+  const {
+    workflowStartTool,
+    createWorkflowStartHandler,
+    workflowStatusTool,
+    createWorkflowStatusHandler,
+    workflowListTool,
+    createWorkflowListHandler
+  } = await import("./workflow/index.js");
+  registerTool(
+    workflowStartTool.name,
+    workflowStartTool,
+    createWorkflowStartHandler(),
+    "workflow"
+  );
+  registerTool(
+    workflowStatusTool.name,
+    workflowStatusTool,
+    createWorkflowStatusHandler(),
+    "workflow"
+  );
+  registerTool(
+    workflowListTool.name,
+    workflowListTool,
+    createWorkflowListHandler(),
+    "workflow"
+  );
+  logger.debug("Workflow tools registered");
+}
+async function registerVectorTools() {
+  const {
+    vectorSearchTool,
+    createVectorSearchHandler,
+    vectorUpsertTool,
+    createVectorUpsertHandler,
+    trajectoryListTool,
+    createTrajectoryListHandler
+  } = await import("./vector/index.js");
+  registerTool(
+    vectorSearchTool.name,
+    vectorSearchTool,
+    createVectorSearchHandler(),
+    "vector"
+  );
+  registerTool(
+    vectorUpsertTool.name,
+    vectorUpsertTool,
+    createVectorUpsertHandler(),
+    "vector"
+  );
+  registerTool(
+    trajectoryListTool.name,
+    trajectoryListTool,
+    createTrajectoryListHandler(),
+    "vector"
+  );
+  logger.debug("Vector tools registered");
+}
+async function registerAuditTools() {
+  const {
+    auditQueryTool,
+    createAuditQueryHandler,
+    auditCheckpointTool,
+    createAuditCheckpointHandler,
+    syncStatusTool,
+    createSyncStatusHandler
+  } = await import("./audit/index.js");
+  registerTool(
+    auditQueryTool.name,
+    auditQueryTool,
+    createAuditQueryHandler(),
+    "audit"
+  );
+  registerTool(
+    auditCheckpointTool.name,
+    auditCheckpointTool,
+    createAuditCheckpointHandler(),
+    "audit"
+  );
+  registerTool(
+    syncStatusTool.name,
+    syncStatusTool,
+    createSyncStatusHandler(),
+    "audit"
+  );
+  logger.debug("Audit tools registered");
+}
 export {
   getCache,
   getDatabase,