@mxf-dev/core 2.0.4 → 3.0.0

package/dist/protocols/mcp/tools/KnowledgeGraphTools.d.ts

@@ -18,6 +18,36 @@
  * @documentation https://mxf-dev.github.io/mxf/
  */
 import { EntityType, RelationshipType } from '../../../types/KnowledgeGraphTypes.js';
+import { McpToolHandlerContext } from '../McpServerTypes.js';
+export interface KnowledgeGraphToolArguments extends Record<string, unknown> {
+    channelId?: string;
+    entityId?: string;
+    name?: string;
+    exact?: boolean;
+    limit?: number;
+    direction?: 'incoming' | 'outgoing' | 'both';
+    relationshipType?: RelationshipType;
+    fromEntityId?: string;
+    toEntityId?: string;
+    maxHops?: number;
+    taskId?: string;
+    keywords?: string[];
+    type?: string;
+    aliases?: string[];
+    description?: string;
+    confidence?: number;
+    label?: string;
+    text?: string;
+    sourceId?: string;
+    memoryId?: string;
+    memoryContent?: string;
+    phase?: 'observation' | 'reasoning' | 'planning' | 'action' | 'reflection';
+    taskContent?: string;
+    entityIds?: string[];
+    threshold?: number;
+    targetEntityId?: string;
+    sourceEntityIds?: string[];
+}
 /**
  * Get an entity by ID
  */
@@ -34,22 +64,7 @@ export declare const kg_get_entity: {
         };
         required: string[];
     };
-    handler: (args: any, context: any) => Promise<{
-        success: boolean;
-        entity: null;
-        message: string;
-        error?: undefined;
-    } | {
-        success: boolean;
-        entity: import("../../../types/KnowledgeGraphTypes.js").Entity;
-        message: string;
-        error?: undefined;
-    } | {
-        success: boolean;
-        entity: null;
-        message: string;
-        error: any;
-    }>;
+    handler: (args: KnowledgeGraphToolArguments, context: McpToolHandlerContext) => Promise<Record<string, unknown>>;
 };
 /**
  * Find entities by name
@@ -83,28 +98,7 @@ export declare const kg_find_entity: {
         };
         required: string[];
     };
-    handler: (args: any, context: any) => Promise<{
-        success: boolean;
-        entities: never[];
-        message: string;
-        count?: undefined;
-        totalFound?: undefined;
-        error?: undefined;
-    } | {
-        success: boolean;
-        entities: import("../../../types/KnowledgeGraphTypes.js").Entity[];
-        count: number;
-        totalFound: number;
-        message: string;
-        error?: undefined;
-    } | {
-        success: boolean;
-        entities: never[];
-        message: string;
-        error: any;
-        count?: undefined;
-        totalFound?: undefined;
-    }>;
+    handler: (args: KnowledgeGraphToolArguments, context: McpToolHandlerContext) => Promise<Record<string, unknown>>;
 };
 /**
  * Get neighbors of an entity
@@ -139,31 +133,7 @@ export declare const kg_get_neighbors: {
         };
         required: string[];
     };
-    handler: (args: any, context: any) => Promise<{
-        success: boolean;
-        entities: never[];
-        relationships: never[];
-        message: string;
-        entityCount?: undefined;
-        relationshipCount?: undefined;
-        error?: undefined;
-    } | {
-        success: boolean;
-        entities: import("../../../types/KnowledgeGraphTypes.js").Entity[];
-        relationships: import("../../../types/KnowledgeGraphTypes.js").Relationship[];
-        entityCount: number;
-        relationshipCount: number;
-        message: string;
-        error?: undefined;
-    } | {
-        success: boolean;
-        entities: never[];
-        relationships: never[];
-        message: string;
-        error: any;
-        entityCount?: undefined;
-        relationshipCount?: undefined;
-    }>;
+    handler: (args: KnowledgeGraphToolArguments, context: McpToolHandlerContext) => Promise<Record<string, unknown>>;
 };
 /**
  * Find path between entities
@@ -192,35 +162,7 @@ export declare const kg_find_path: {
         };
         required: string[];
     };
-    handler: (args: any, context: any) => Promise<{
-        success: boolean;
-        path: null;
-        message: string;
-        found?: undefined;
-        hopCount?: undefined;
-        error?: undefined;
-    } | {
-        success: boolean;
-        path: null;
-        found: boolean;
-        message: string;
-        hopCount?: undefined;
-        error?: undefined;
-    } | {
-        success: boolean;
-        path: import("../../../types/KnowledgeGraphTypes.js").GraphPath;
-        found: boolean;
-        hopCount: number;
-        message: string;
-        error?: undefined;
-    } | {
-        success: boolean;
-        path: null;
-        message: string;
-        error: any;
-        found?: undefined;
-        hopCount?: undefined;
-    }>;
+    handler: (args: KnowledgeGraphToolArguments, context: McpToolHandlerContext) => Promise<Record<string, unknown>>;
 };
 /**
  * Get graph context for a task
@@ -249,31 +191,7 @@ export declare const kg_get_context: {
         };
         required: never[];
     };
-    handler: (args: any, context: any) => Promise<{
-        success: boolean;
-        context: null;
-        message: string;
-        stats?: undefined;
-        error?: undefined;
-    } | {
-        success: boolean;
-        context: import("../../../types/KnowledgeGraphTypes.js").GraphContext;
-        stats: {
-            entityCount: number;
-            relationshipCount: number;
-            avgQValue: number;
-            maxQValue: number;
-            avgConfidence: number;
-        };
-        message: string;
-        error?: undefined;
-    } | {
-        success: boolean;
-        context: null;
-        message: string;
-        error: any;
-        stats?: undefined;
-    }>;
+    handler: (args: KnowledgeGraphToolArguments, context: McpToolHandlerContext) => Promise<Record<string, unknown>>;
 };
 /**
  * Get high-utility entities
@@ -298,25 +216,7 @@ export declare const kg_get_high_utility_entities: {
         };
         required: never[];
     };
-    handler: (args: any, context: any) => Promise<{
-        success: boolean;
-        entities: never[];
-        message: string;
-        count?: undefined;
-        error?: undefined;
-    } | {
-        success: boolean;
-        entities: import("../../../types/KnowledgeGraphTypes.js").Entity[];
-        count: number;
-        message: string;
-        error?: undefined;
-    } | {
-        success: boolean;
-        entities: never[];
-        message: string;
-        error: any;
-        count?: undefined;
-    }>;
+    handler: (args: KnowledgeGraphToolArguments, context: McpToolHandlerContext) => Promise<Record<string, unknown>>;
 };
 /**
  * Create an entity
@@ -361,22 +261,7 @@ export declare const kg_create_entity: {
         };
         required: string[];
     };
-    handler: (args: any, context: any) => Promise<{
-        success: boolean;
-        entity: null;
-        message: string;
-        error?: undefined;
-    } | {
-        success: boolean;
-        entity: import("../../../types/KnowledgeGraphTypes.js").Entity;
-        message: string;
-        error?: undefined;
-    } | {
-        success: boolean;
-        entity: null;
-        message: string;
-        error: any;
-    }>;
+    handler: (args: KnowledgeGraphToolArguments, context: McpToolHandlerContext) => Promise<Record<string, unknown>>;
 };
 /**
  * Create a relationship
@@ -418,22 +303,7 @@ export declare const kg_create_relationship: {
         };
         required: string[];
     };
-    handler: (args: any, context: any) => Promise<{
-        success: boolean;
-        relationship: null;
-        message: string;
-        error?: undefined;
-    } | {
-        success: boolean;
-        relationship: import("../../../types/KnowledgeGraphTypes.js").Relationship;
-        message: string;
-        error?: undefined;
-    } | {
-        success: boolean;
-        relationship: null;
-        message: string;
-        error: any;
-    }>;
+    handler: (args: KnowledgeGraphToolArguments, context: McpToolHandlerContext) => Promise<Record<string, unknown>>;
 };
 /**
  * Extract entities from text
@@ -459,31 +329,7 @@ export declare const kg_extract_from_text: {
         };
         required: string[];
     };
-    handler: (args: any, context: any) => Promise<{
-        success: boolean;
-        result: null;
-        message: string;
-        entitiesExtracted?: undefined;
-        relationshipsExtracted?: undefined;
-        executionTimeMs?: undefined;
-        error?: undefined;
-    } | {
-        success: boolean;
-        result: import("../../../services/kg/EntityExtractionService.js").ExtractionResult;
-        entitiesExtracted: number;
-        relationshipsExtracted: number;
-        executionTimeMs: number;
-        message: string;
-        error?: undefined;
-    } | {
-        success: boolean;
-        result: null;
-        message: string;
-        error: any;
-        entitiesExtracted?: undefined;
-        relationshipsExtracted?: undefined;
-        executionTimeMs?: undefined;
-    }>;
+    handler: (args: KnowledgeGraphToolArguments, context: McpToolHandlerContext) => Promise<Record<string, unknown>>;
 };
 /**
  * Extract entities from a memory
@@ -509,31 +355,7 @@ export declare const kg_extract_from_memory: {
         };
         required: string[];
     };
-    handler: (args: any, context: any) => Promise<{
-        success: boolean;
-        result: null;
-        message: string;
-        entitiesExtracted?: undefined;
-        relationshipsExtracted?: undefined;
-        executionTimeMs?: undefined;
-        error?: undefined;
-    } | {
-        success: boolean;
-        result: import("../../../services/kg/EntityExtractionService.js").ExtractionResult;
-        entitiesExtracted: number;
-        relationshipsExtracted: number;
-        executionTimeMs: number;
-        message: string;
-        error?: undefined;
-    } | {
-        success: boolean;
-        result: null;
-        message: string;
-        error: any;
-        entitiesExtracted?: undefined;
-        relationshipsExtracted?: undefined;
-        executionTimeMs?: undefined;
-    }>;
+    handler: (args: KnowledgeGraphToolArguments, context: McpToolHandlerContext) => Promise<Record<string, unknown>>;
 };
 /**
  * Get ORPAR phase context
@@ -567,34 +389,7 @@ export declare const kg_get_phase_context: {
         };
         required: string[];
     };
-    handler: (args: any, context: any) => Promise<{
-        success: boolean;
-        phaseContext: null;
-        message: string;
-        entityCount?: undefined;
-        relationshipCount?: undefined;
-        summary?: undefined;
-        executionTimeMs?: undefined;
-        error?: undefined;
-    } | {
-        success: boolean;
-        phaseContext: import("../../../services/kg/OrparGraphIntegration.js").PhaseGraphContext;
-        entityCount: number;
-        relationshipCount: number;
-        summary: string;
-        executionTimeMs: number;
-        message: string;
-        error?: undefined;
-    } | {
-        success: boolean;
-        phaseContext: null;
-        message: string;
-        error: any;
-        entityCount?: undefined;
-        relationshipCount?: undefined;
-        summary?: undefined;
-        executionTimeMs?: undefined;
-    }>;
+    handler: (args: KnowledgeGraphToolArguments, context: McpToolHandlerContext) => Promise<Record<string, unknown>>;
 };
 /**
  * Find similar entities (potential duplicates)
@@ -619,25 +414,7 @@ export declare const kg_find_duplicates: {
         };
         required: never[];
     };
-    handler: (args: any, context: any) => Promise<{
-        success: boolean;
-        duplicates: never[];
-        message: string;
-        count?: undefined;
-        error?: undefined;
-    } | {
-        success: boolean;
-        duplicates: import("../../../types/KnowledgeGraphTypes.js").EntitySimilarity[];
-        count: number;
-        message: string;
-        error?: undefined;
-    } | {
-        success: boolean;
-        duplicates: never[];
-        message: string;
-        error: any;
-        count?: undefined;
-    }>;
+    handler: (args: KnowledgeGraphToolArguments, context: McpToolHandlerContext) => Promise<Record<string, unknown>>;
 };
 /**
  * Merge entities
@@ -662,22 +439,7 @@ export declare const kg_merge_entities: {
         };
         required: string[];
     };
-    handler: (args: any, context: any) => Promise<{
-        success: boolean;
-        result: null;
-        message: string;
-        error?: undefined;
-    } | {
-        success: boolean;
-        result: import("../../../types/KnowledgeGraphTypes.js").EntityMergeResult;
-        message: string;
-        error?: undefined;
-    } | {
-        success: boolean;
-        result: null;
-        message: string;
-        error: any;
-    }>;
+    handler: (args: KnowledgeGraphToolArguments, context: McpToolHandlerContext) => Promise<Record<string, unknown>>;
 };
 /**
  * Export all Knowledge Graph tools
@@ -695,22 +457,7 @@ export declare const knowledgeGraphTools: ({
         };
         required: string[];
     };
-    handler: (args: any, context: any) => Promise<{
-        success: boolean;
-        entity: null;
-        message: string;
-        error?: undefined;
-    } | {
-        success: boolean;
-        entity: import("../../../types/KnowledgeGraphTypes.js").Entity;
-        message: string;
-        error?: undefined;
-    } | {
-        success: boolean;
-        entity: null;
-        message: string;
-        error: any;
-    }>;
+    handler: (args: KnowledgeGraphToolArguments, context: McpToolHandlerContext) => Promise<Record<string, unknown>>;
 } | {
     name: string;
     description: string;
@@ -740,83 +487,7 @@ export declare const knowledgeGraphTools: ({
         };
         required: string[];
     };
-    handler: (args: any, context: any) => Promise<{
-        success: boolean;
-        entities: never[];
-        message: string;
-        count?: undefined;
-        totalFound?: undefined;
-        error?: undefined;
-    } | {
-        success: boolean;
-        entities: import("../../../types/KnowledgeGraphTypes.js").Entity[];
-        count: number;
-        totalFound: number;
-        message: string;
-        error?: undefined;
-    } | {
-        success: boolean;
-        entities: never[];
-        message: string;
-        error: any;
-        count?: undefined;
-        totalFound?: undefined;
-    }>;
-} | {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: string;
-        properties: {
-            entityId: {
-                type: string;
-                description: string;
-            };
-            direction: {
-                type: string;
-                enum: string[];
-                default: string;
-                description: string;
-            };
-            relationshipType: {
-                type: string;
-                description: string;
-            };
-            limit: {
-                type: string;
-                minimum: number;
-                maximum: number;
-                default: number;
-                description: string;
-            };
-        };
-        required: string[];
-    };
-    handler: (args: any, context: any) => Promise<{
-        success: boolean;
-        entities: never[];
-        relationships: never[];
-        message: string;
-        entityCount?: undefined;
-        relationshipCount?: undefined;
-        error?: undefined;
-    } | {
-        success: boolean;
-        entities: import("../../../types/KnowledgeGraphTypes.js").Entity[];
-        relationships: import("../../../types/KnowledgeGraphTypes.js").Relationship[];
-        entityCount: number;
-        relationshipCount: number;
-        message: string;
-        error?: undefined;
-    } | {
-        success: boolean;
-        entities: never[];
-        relationships: never[];
-        message: string;
-        error: any;
-        entityCount?: undefined;
-        relationshipCount?: undefined;
-    }>;
+    handler: (args: KnowledgeGraphToolArguments, context: McpToolHandlerContext) => Promise<Record<string, unknown>>;
 } | {
     name: string;
     description: string;
@@ -841,35 +512,7 @@ export declare const knowledgeGraphTools: ({
         };
         required: string[];
     };
-    handler: (args: any, context: any) => Promise<{
-        success: boolean;
-        path: null;
-        message: string;
-        found?: undefined;
-        hopCount?: undefined;
-        error?: undefined;
-    } | {
-        success: boolean;
-        path: null;
-        found: boolean;
-        message: string;
-        hopCount?: undefined;
-        error?: undefined;
-    } | {
-        success: boolean;
-        path: import("../../../types/KnowledgeGraphTypes.js").GraphPath;
-        found: boolean;
-        hopCount: number;
-        message: string;
-        error?: undefined;
-    } | {
-        success: boolean;
-        path: null;
-        message: string;
-        error: any;
-        found?: undefined;
-        hopCount?: undefined;
-    }>;
+    handler: (args: KnowledgeGraphToolArguments, context: McpToolHandlerContext) => Promise<Record<string, unknown>>;
 } | {
     name: string;
     description: string;
@@ -894,31 +537,7 @@ export declare const knowledgeGraphTools: ({
         };
         required: never[];
     };
-    handler: (args: any, context: any) => Promise<{
-        success: boolean;
-        context: null;
-        message: string;
-        stats?: undefined;
-        error?: undefined;
-    } | {
-        success: boolean;
-        context: import("../../../types/KnowledgeGraphTypes.js").GraphContext;
-        stats: {
-            entityCount: number;
-            relationshipCount: number;
-            avgQValue: number;
-            maxQValue: number;
-            avgConfidence: number;
-        };
-        message: string;
-        error?: undefined;
-    } | {
-        success: boolean;
-        context: null;
-        message: string;
-        error: any;
-        stats?: undefined;
-    }>;
+    handler: (args: KnowledgeGraphToolArguments, context: McpToolHandlerContext) => Promise<Record<string, unknown>>;
 } | {
     name: string;
     description: string;
@@ -939,25 +558,7 @@ export declare const knowledgeGraphTools: ({
         };
         required: never[];
     };
-    handler: (args: any, context: any) => Promise<{
-        success: boolean;
-        entities: never[];
-        message: string;
-        count?: undefined;
-        error?: undefined;
-    } | {
-        success: boolean;
-        entities: import("../../../types/KnowledgeGraphTypes.js").Entity[];
-        count: number;
-        message: string;
-        error?: undefined;
-    } | {
-        success: boolean;
-        entities: never[];
-        message: string;
-        error: any;
-        count?: undefined;
-    }>;
+    handler: (args: KnowledgeGraphToolArguments, context: McpToolHandlerContext) => Promise<Record<string, unknown>>;
 } | {
     name: string;
     description: string;
@@ -998,22 +599,7 @@ export declare const knowledgeGraphTools: ({
         };
         required: string[];
     };
-    handler: (args: any, context: any) => Promise<{
-        success: boolean;
-        entity: null;
-        message: string;
-        error?: undefined;
-    } | {
-        success: boolean;
-        entity: import("../../../types/KnowledgeGraphTypes.js").Entity;
-        message: string;
-        error?: undefined;
-    } | {
-        success: boolean;
-        entity: null;
-        message: string;
-        error: any;
-    }>;
+    handler: (args: KnowledgeGraphToolArguments, context: McpToolHandlerContext) => Promise<Record<string, unknown>>;
 } | {
     name: string;
     description: string;
@@ -1051,22 +637,7 @@ export declare const knowledgeGraphTools: ({
         };
         required: string[];
     };
-    handler: (args: any, context: any) => Promise<{
-        success: boolean;
-        relationship: null;
-        message: string;
-        error?: undefined;
-    } | {
-        success: boolean;
-        relationship: import("../../../types/KnowledgeGraphTypes.js").Relationship;
-        message: string;
-        error?: undefined;
-    } | {
-        success: boolean;
-        relationship: null;
-        message: string;
-        error: any;
-    }>;
+    handler: (args: KnowledgeGraphToolArguments, context: McpToolHandlerContext) => Promise<Record<string, unknown>>;
 } | {
     name: string;
     description: string;
@@ -1088,31 +659,7 @@ export declare const knowledgeGraphTools: ({
         };
         required: string[];
     };
-    handler: (args: any, context: any) => Promise<{
-        success: boolean;
-        result: null;
-        message: string;
-        entitiesExtracted?: undefined;
-        relationshipsExtracted?: undefined;
-        executionTimeMs?: undefined;
-        error?: undefined;
-    } | {
-        success: boolean;
-        result: import("../../../services/kg/EntityExtractionService.js").ExtractionResult;
-        entitiesExtracted: number;
-        relationshipsExtracted: number;
-        executionTimeMs: number;
-        message: string;
-        error?: undefined;
-    } | {
-        success: boolean;
-        result: null;
-        message: string;
-        error: any;
-        entitiesExtracted?: undefined;
-        relationshipsExtracted?: undefined;
-        executionTimeMs?: undefined;
-    }>;
+    handler: (args: KnowledgeGraphToolArguments, context: McpToolHandlerContext) => Promise<Record<string, unknown>>;
 } | {
     name: string;
     description: string;
@@ -1134,31 +681,7 @@ export declare const knowledgeGraphTools: ({
         };
         required: string[];
     };
-    handler: (args: any, context: any) => Promise<{
-        success: boolean;
-        result: null;
-        message: string;
-        entitiesExtracted?: undefined;
-        relationshipsExtracted?: undefined;
-        executionTimeMs?: undefined;
-        error?: undefined;
-    } | {
-        success: boolean;
-        result: import("../../../services/kg/EntityExtractionService.js").ExtractionResult;
-        entitiesExtracted: number;
-        relationshipsExtracted: number;
-        executionTimeMs: number;
-        message: string;
-        error?: undefined;
-    } | {
-        success: boolean;
-        result: null;
-        message: string;
-        error: any;
-        entitiesExtracted?: undefined;
-        relationshipsExtracted?: undefined;
-        executionTimeMs?: undefined;
-    }>;
+    handler: (args: KnowledgeGraphToolArguments, context: McpToolHandlerContext) => Promise<Record<string, unknown>>;
 } | {
     name: string;
     description: string;
@@ -1188,34 +711,7 @@ export declare const knowledgeGraphTools: ({
         };
         required: string[];
     };
-    handler: (args: any, context: any) => Promise<{
-        success: boolean;
-        phaseContext: null;
-        message: string;
-        entityCount?: undefined;
-        relationshipCount?: undefined;
-        summary?: undefined;
-        executionTimeMs?: undefined;
-        error?: undefined;
-    } | {
-        success: boolean;
-        phaseContext: import("../../../services/kg/OrparGraphIntegration.js").PhaseGraphContext;
-        entityCount: number;
-        relationshipCount: number;
-        summary: string;
-        executionTimeMs: number;
-        message: string;
-        error?: undefined;
-    } | {
-        success: boolean;
-        phaseContext: null;
-        message: string;
-        error: any;
-        entityCount?: undefined;
-        relationshipCount?: undefined;
-        summary?: undefined;
-        executionTimeMs?: undefined;
-    }>;
+    handler: (args: KnowledgeGraphToolArguments, context: McpToolHandlerContext) => Promise<Record<string, unknown>>;
 } | {
     name: string;
     description: string;
@@ -1236,25 +732,7 @@ export declare const knowledgeGraphTools: ({
         };
         required: never[];
     };
-    handler: (args: any, context: any) => Promise<{
-        success: boolean;
-        duplicates: never[];
-        message: string;
-        count?: undefined;
-        error?: undefined;
-    } | {
-        success: boolean;
-        duplicates: import("../../../types/KnowledgeGraphTypes.js").EntitySimilarity[];
-        count: number;
-        message: string;
-        error?: undefined;
-    } | {
-        success: boolean;
-        duplicates: never[];
-        message: string;
-        error: any;
-        count?: undefined;
-    }>;
+    handler: (args: KnowledgeGraphToolArguments, context: McpToolHandlerContext) => Promise<Record<string, unknown>>;
 } | {
     name: string;
     description: string;
@@ -1275,21 +753,6 @@ export declare const knowledgeGraphTools: ({
         };
         required: string[];
     };
-    handler: (args: any, context: any) => Promise<{
-        success: boolean;
-        result: null;
-        message: string;
-        error?: undefined;
-    } | {
-        success: boolean;
-        result: import("../../../types/KnowledgeGraphTypes.js").EntityMergeResult;
-        message: string;
-        error?: undefined;
-    } | {
-        success: boolean;
-        result: null;
-        message: string;
-        error: any;
-    }>;
+    handler: (args: KnowledgeGraphToolArguments, context: McpToolHandlerContext) => Promise<Record<string, unknown>>;
 })[];
 //# sourceMappingURL=KnowledgeGraphTools.d.ts.map