@weavelogic/knowledge-graph-agent 0.2.0 → 0.4.0

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

@@ -0,0 +1,286 @@
+/**
+ * MCP Server Type Definitions
+ *
+ * Core types for the Knowledge Graph MCP Server including tool definitions,
+ * handlers, results, and configuration.
+ *
+ * @module mcp-server/types
+ */
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Tool category grouping for organizing related tools
+ */
+export interface ToolCategory {
+    /** Category name */
+    name: string;
+    /** Category description */
+    description: string;
+    /** Tools in this category */
+    tools: Tool[];
+}
+/**
+ * Tool handler function signature
+ * Async function that takes parameters and returns a result
+ */
+export type ToolHandler = (params: Record<string, unknown>) => Promise<ToolResult>;
+/**
+ * Tool handler registry entry combining definition with handler
+ */
+export interface ToolHandlerEntry {
+    /** MCP tool definition */
+    definition: Tool;
+    /** Handler function */
+    handler: ToolHandler;
+}
+/**
+ * Standard tool result format
+ * All tool handlers return this standardized format
+ */
+export interface ToolResult {
+    /** Whether the operation succeeded */
+    success: boolean;
+    /** Result data (varies by tool) */
+    data?: unknown;
+    /** Error message if success is false */
+    error?: string;
+    /** Additional metadata about the execution */
+    metadata?: {
+        /** Execution time in milliseconds */
+        executionTime?: number;
+        /** Whether result came from cache */
+        cacheHit?: boolean;
+        /** Number of items processed */
+        itemCount?: number;
+        /** Additional tool-specific metadata */
+        [key: string]: unknown;
+    };
+}
+/**
+ * Tool execution context
+ * Provides context information for tool execution
+ */
+export interface ToolContext {
+    /** Name of the tool being executed */
+    toolName: string;
+    /** Parameters passed to the tool */
+    params: Record<string, unknown>;
+    /** Timestamp when execution started */
+    timestamp: number;
+    /** Request ID for tracing */
+    requestId?: string;
+}
+/**
+ * MCP Server configuration
+ */
+export interface MCPServerConfig {
+    /** Server name */
+    name: string;
+    /** Server version */
+    version: string;
+    /** Server capabilities */
+    capabilities: {
+        /** Tools capability configuration */
+        tools: Record<string, unknown>;
+        /** Resources capability configuration */
+        resources?: Record<string, unknown>;
+        /** Prompts capability configuration */
+        prompts?: Record<string, unknown>;
+    };
+}
+/**
+ * Server health status
+ */
+export interface ServerHealth {
+    /** Overall health status */
+    status: 'healthy' | 'degraded' | 'unhealthy';
+    /** Component health details */
+    components: {
+        /** Database connection status */
+        database: boolean;
+        /** Cache status */
+        cache: boolean;
+        /** Agents availability */
+        agents: boolean;
+    };
+    /** Server uptime in milliseconds */
+    uptime: number;
+    /** Total requests handled */
+    requestCount: number;
+    /** Number of registered tools */
+    toolCount: number;
+}
+/**
+ * Tool input validation schema
+ */
+export interface ToolInputSchema {
+    /** JSON Schema type */
+    type: 'object';
+    /** Property definitions */
+    properties: Record<string, {
+        type: string;
+        description?: string;
+        default?: unknown;
+        enum?: unknown[];
+        items?: unknown;
+    }>;
+    /** Required property names */
+    required?: string[];
+}
+/**
+ * Tool definition with handler
+ */
+export interface ToolDefinition {
+    /** Tool name (unique identifier) */
+    name: string;
+    /** Tool description */
+    description: string;
+    /** Input schema */
+    inputSchema: ToolInputSchema;
+    /** Handler function */
+    handler: ToolHandler;
+    /** Tool category */
+    category?: string;
+}
+/**
+ * Graph query parameters
+ */
+export interface GraphQueryParams {
+    /** Search query string */
+    query?: string;
+    /** Node type filter */
+    type?: string;
+    /** Node status filter */
+    status?: string;
+    /** Tag filter */
+    tag?: string;
+    /** Maximum results */
+    limit?: number;
+    /** Include node content */
+    includeContent?: boolean;
+}
+/**
+ * Graph node result
+ */
+export interface GraphNodeResult {
+    /** Node ID */
+    id: string;
+    /** Node path */
+    path: string;
+    /** Node title */
+    title: string;
+    /** Node type */
+    type: string;
+    /** Node status */
+    status: string;
+    /** Node tags */
+    tags: string[];
+    /** Word count */
+    wordCount: number;
+    /** Outgoing link count */
+    outgoingLinkCount: number;
+    /** Incoming link count */
+    incomingLinkCount: number;
+    /** Node content (optional) */
+    content?: string;
+}
+/**
+ * Agent invocation parameters
+ */
+export interface AgentInvokeParams {
+    /** Agent type */
+    agent: string;
+    /** Task description */
+    task: string;
+    /** Additional context */
+    context?: Record<string, unknown>;
+    /** Timeout in milliseconds */
+    timeout?: number;
+}
+/**
+ * Agent result
+ */
+export interface AgentResult {
+    /** Agent type that executed */
+    agent: string;
+    /** Task that was executed */
+    task: string;
+    /** Execution result */
+    result: unknown;
+    /** Execution time in milliseconds */
+    executionTime: number;
+    /** Whether agent completed successfully */
+    completed: boolean;
+}
+/**
+ * Workflow execution parameters
+ */
+export interface WorkflowParams {
+    /** Workflow name */
+    workflow: string;
+    /** Workflow input */
+    input: Record<string, unknown>;
+    /** Execution options */
+    options?: {
+        /** Run in parallel */
+        parallel?: boolean;
+        /** Continue on error */
+        continueOnError?: boolean;
+        /** Timeout in milliseconds */
+        timeout?: number;
+    };
+}
+/**
+ * Workflow result
+ */
+export interface WorkflowResult {
+    /** Workflow name */
+    workflow: string;
+    /** Workflow status */
+    status: 'completed' | 'failed' | 'partial';
+    /** Step results */
+    steps: Array<{
+        name: string;
+        status: 'completed' | 'failed' | 'skipped';
+        result?: unknown;
+        error?: string;
+        duration: number;
+    }>;
+    /** Total execution time */
+    totalDuration: number;
+}
+/**
+ * Memory operation parameters
+ */
+export interface MemoryParams {
+    /** Operation type */
+    operation: 'store' | 'retrieve' | 'search' | 'delete';
+    /** Memory key */
+    key?: string;
+    /** Value to store */
+    value?: unknown;
+    /** Search pattern */
+    pattern?: string;
+    /** Memory namespace */
+    namespace?: string;
+    /** TTL in milliseconds */
+    ttl?: number;
+}
+/**
+ * Memory operation result
+ */
+export interface MemoryResult {
+    /** Operation that was performed */
+    operation: string;
+    /** Whether operation succeeded */
+    success: boolean;
+    /** Retrieved or stored value */
+    value?: unknown;
+    /** Search results */
+    matches?: Array<{
+        key: string;
+        value: unknown;
+    }>;
+    /** Number of affected entries */
+    affected?: number;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/types/index.ts"],"names":[],"mappings":"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"}

package/dist/memory/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Memory Module
+ *
+ * Provides synchronization between the knowledge graph vault and
+ * claude-flow memory for persistent agent coordination.
+ *
+ * @module memory
+ */
+export { VaultMemorySync, createVaultMemorySync, type SyncDirection, type ConflictStrategy, type SyncStatus, type MemoryNode, type SyncConflict, type VaultSyncOptions, type SyncOperationResult, type FullSyncResult, } from './vault-sync.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/memory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,cAAc,GACpB,MAAM,iBAAiB,CAAC"}

package/dist/memory/vault-sync.d.ts

@@ -0,0 +1,212 @@
+/**
+ * Vault Memory Sync
+ *
+ * Provides bidirectional synchronization between the knowledge graph
+ * and claude-flow memory system for persistent agent coordination.
+ *
+ * @module memory/vault-sync
+ */
+import { type RetryOptions } from '../utils/index.js';
+import { type FileChange } from '../core/cache.js';
+import { KnowledgeGraphDatabase } from '../core/database.js';
+/**
+ * Sync direction
+ */
+export type SyncDirection = 'to-memory' | 'from-memory' | 'bidirectional';
+/**
+ * Conflict resolution strategy
+ */
+export type ConflictStrategy = 'memory-wins' | 'vault-wins' | 'newest-wins' | 'merge' | 'manual';
+/**
+ * Sync status
+ */
+export interface SyncStatus {
+    /** Last successful sync timestamp */
+    lastSync: Date | null;
+    /** Whether sync is currently running */
+    isSyncing: boolean;
+    /** Number of pending changes in vault */
+    pendingVaultChanges: number;
+    /** Number of pending changes in memory */
+    pendingMemoryChanges: number;
+    /** Any sync errors */
+    errors: string[];
+    /** Sync health status */
+    health: 'healthy' | 'warning' | 'error';
+}
+/**
+ * Memory entry format for claude-flow
+ */
+export interface MemoryNode {
+    id: string;
+    title: string;
+    type: string;
+    status: string;
+    path: string;
+    tags: string[];
+    outgoingLinks: string[];
+    incomingLinks: string[];
+    summary: string;
+    contentHash: string;
+    lastModified: string;
+    syncedAt: string;
+}
+/**
+ * Conflict record
+ */
+export interface SyncConflict {
+    nodeId: string;
+    path: string;
+    vaultVersion: {
+        hash: string;
+        modifiedAt: Date;
+        content?: string;
+    };
+    memoryVersion: {
+        hash: string;
+        modifiedAt: Date;
+        content?: string;
+    };
+    resolvedAs?: 'vault' | 'memory' | 'merged';
+    resolvedAt?: Date;
+}
+/**
+ * Sync options
+ */
+export interface VaultSyncOptions {
+    /** Project root directory */
+    projectRoot: string;
+    /** Claude-flow memory namespace */
+    namespace?: string;
+    /** Conflict resolution strategy */
+    conflictStrategy?: ConflictStrategy;
+    /** Whether to auto-sync on changes */
+    autoSync?: boolean;
+    /** Auto-sync interval in milliseconds */
+    autoSyncInterval?: number;
+    /** Retry options for network operations */
+    retryOptions?: RetryOptions;
+    /** Maximum batch size for sync operations */
+    batchSize?: number;
+    /** Whether to include content in memory entries */
+    includeContent?: boolean;
+    /** Maximum content length to store */
+    maxContentLength?: number;
+}
+/**
+ * Sync result for a single operation
+ */
+export interface SyncOperationResult {
+    success: boolean;
+    synced: number;
+    skipped: number;
+    failed: number;
+    conflicts: SyncConflict[];
+    errors: Array<{
+        nodeId: string;
+        error: string;
+    }>;
+    duration: number;
+}
+/**
+ * Full sync result
+ */
+export interface FullSyncResult {
+    success: boolean;
+    toMemory: SyncOperationResult;
+    fromMemory: SyncOperationResult;
+    totalDuration: number;
+    timestamp: Date;
+}
+/**
+ * Vault Memory Sync
+ *
+ * Manages bidirectional synchronization between the knowledge graph vault
+ * and claude-flow memory for cross-session persistence and agent coordination.
+ *
+ * @example
+ * ```typescript
+ * const sync = new VaultMemorySync({
+ *   projectRoot: '/my/project',
+ *   namespace: 'knowledge-graph',
+ *   conflictStrategy: 'newest-wins',
+ * });
+ *
+ * // Initialize with database
+ * await sync.initialize(db);
+ *
+ * // Sync to memory
+ * const result = await sync.syncToMemory();
+ *
+ * // Check status
+ * const status = sync.getStatus();
+ * ```
+ */
+export declare class VaultMemorySync {
+    private options;
+    private shadowCache;
+    private db;
+    private memoryCache;
+    private conflicts;
+    private lastSyncTime;
+    private isSyncing;
+    private syncErrors;
+    private autoSyncTimer;
+    constructor(options: VaultSyncOptions);
+    /**
+     * Initialize the sync system with database
+     */
+    initialize(db: KnowledgeGraphDatabase): Promise<void>;
+    /**
+     * Sync knowledge graph to claude-flow memory
+     */
+    syncToMemory(): Promise<SyncOperationResult>;
+    /**
+     * Sync from claude-flow memory to knowledge graph
+     */
+    syncFromMemory(): Promise<SyncOperationResult>;
+    /**
+     * Perform full bidirectional sync
+     */
+    fullSync(): Promise<FullSyncResult>;
+    /**
+     * Get current sync status
+     */
+    getStatus(): SyncStatus;
+    /**
+     * Get unresolved conflicts
+     */
+    getConflicts(): SyncConflict[];
+    /**
+     * Manually resolve a conflict
+     */
+    resolveConflictManually(nodeId: string, resolution: 'vault' | 'memory'): Promise<boolean>;
+    /**
+     * Detect changes in vault since last sync
+     */
+    detectChanges(): Promise<FileChange[]>;
+    /**
+     * Stop the sync system
+     */
+    stop(): void;
+    private startAutoSync;
+    private nodeToMemoryEntry;
+    private extractSummary;
+    private computeContentHash;
+    private storeToMemory;
+    private retrieveFromMemory;
+    private syncIndexesToMemory;
+    private detectConflict;
+    private createConflictRecord;
+    private resolveConflict;
+    private countPendingVaultChanges;
+    private countPendingMemoryChanges;
+    private createBatches;
+    private loadMemoryCache;
+    private saveMemoryCache;
+}
+/**
+ * Create a vault memory sync instance
+ */
+export declare function createVaultMemorySync(options: VaultSyncOptions): VaultMemorySync;
+//# sourceMappingURL=vault-sync.d.ts.map

package/dist/memory/vault-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault-sync.d.ts","sourceRoot":"","sources":["../../src/memory/vault-sync.ts"],"names":[],"mappings":"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"}