@aaronsb/kg-cli 0.6.6 → 0.8.0

package/dist/mcp/graph-operations.d.ts

@@ -0,0 +1,242 @@
+/**
+ * GraphOperationExecutor - Handles graph CRUD operations for MCP tool
+ * ADR-089 Phase 3a refactoring: Extracted from mcp-server.ts handler
+ */
+import type { KnowledgeGraphClient } from '../api/client';
+import type { MatchingMode, ConceptCRUDResponse, EdgeResponse, ConceptListCRUDResponse, EdgeListResponse } from '../types';
+/**
+ * Entity types for graph operations.
+ */
+export type GraphEntity = 'concept' | 'edge';
+/**
+ * Action types for graph operations.
+ */
+export type GraphAction = 'create' | 'edit' | 'delete' | 'list';
+/**
+ * Base operation result with status.
+ */
+export interface OperationResult {
+    success: boolean;
+    error?: string;
+}
+/**
+ * Result from concept create/edit/delete operations.
+ */
+export interface ConceptOperationResult extends OperationResult {
+    data?: ConceptCRUDResponse & {
+        from_label?: string;
+        to_label?: string;
+    };
+}
+/**
+ * Result from edge create/edit/delete operations.
+ */
+export interface EdgeOperationResult extends OperationResult {
+    data?: EdgeResponse & {
+        from_label?: string;
+        to_label?: string;
+    };
+}
+/**
+ * Result from concept list operation.
+ */
+export interface ConceptListResult extends OperationResult {
+    data?: ConceptListCRUDResponse;
+}
+/**
+ * Result from edge list operation.
+ */
+export interface EdgeListResult extends OperationResult {
+    data?: EdgeListResponse;
+}
+/**
+ * Parameters for creating a concept.
+ */
+export interface CreateConceptParams {
+    label: string;
+    ontology: string;
+    description?: string;
+    search_terms?: string[];
+    matching_mode?: MatchingMode;
+}
+/**
+ * Parameters for creating an edge.
+ */
+export interface CreateEdgeParams {
+    from_concept_id?: string;
+    from_label?: string;
+    to_concept_id?: string;
+    to_label?: string;
+    relationship_type: string;
+    category?: string;
+    confidence?: number;
+}
+/**
+ * Parameters for editing a concept.
+ */
+export interface EditConceptParams {
+    concept_id: string;
+    label?: string;
+    description?: string;
+    search_terms?: string[];
+}
+/**
+ * Parameters for editing an edge.
+ */
+export interface EditEdgeParams {
+    from_concept_id?: string;
+    from_label?: string;
+    to_concept_id?: string;
+    to_label?: string;
+    relationship_type: string;
+    confidence?: number;
+    category?: string;
+}
+/**
+ * Parameters for deleting a concept.
+ */
+export interface DeleteConceptParams {
+    concept_id: string;
+    cascade?: boolean;
+}
+/**
+ * Parameters for deleting an edge.
+ */
+export interface DeleteEdgeParams {
+    from_concept_id?: string;
+    from_label?: string;
+    to_concept_id?: string;
+    to_label?: string;
+    relationship_type: string;
+}
+/**
+ * Parameters for listing concepts.
+ */
+export interface ListConceptsParams {
+    ontology?: string;
+    label_contains?: string;
+    creation_method?: string;
+    offset?: number;
+    limit?: number;
+}
+/**
+ * Parameters for listing edges.
+ */
+export interface ListEdgesParams {
+    from_concept_id?: string;
+    from_label?: string;
+    to_concept_id?: string;
+    to_label?: string;
+    relationship_type?: string;
+    category?: string;
+    source?: string;
+    offset?: number;
+    limit?: number;
+}
+/**
+ * Queue operation definition.
+ */
+export interface QueueOperation {
+    op: GraphAction;
+    entity: GraphEntity;
+    label?: string;
+    ontology?: string;
+    description?: string;
+    search_terms?: string[];
+    matching_mode?: MatchingMode;
+    concept_id?: string;
+    cascade?: boolean;
+    label_contains?: string;
+    creation_method?: string;
+    from_concept_id?: string;
+    from_label?: string;
+    to_concept_id?: string;
+    to_label?: string;
+    relationship_type?: string;
+    category?: string;
+    confidence?: number;
+    source?: string;
+    offset?: number;
+    limit?: number;
+}
+/**
+ * Result from a single queue operation.
+ */
+export interface QueueOperationResult {
+    index: number;
+    status: 'ok' | 'error';
+    op: string;
+    entity: string;
+    label?: string;
+    id?: string;
+    relationship?: string;
+    count?: number;
+    total?: number;
+    matched_existing?: boolean;
+    concepts?: Array<{
+        id: string;
+        label: string;
+    }>;
+    edges?: Array<{
+        from: string;
+        type: string;
+        to: string;
+    }>;
+    error?: string;
+}
+/**
+ * Result from queue execution.
+ */
+export interface QueueExecutionResult {
+    results: QueueOperationResult[];
+    stopIndex: number;
+    successCount: number;
+    errorCount: number;
+}
+/**
+ * Executes graph CRUD operations with semantic resolution support.
+ */
+export declare class GraphOperationExecutor {
+    private client;
+    constructor(client: KnowledgeGraphClient);
+    /**
+     * Resolve a concept label to its ID using semantic search.
+     * @param label - The concept label to resolve
+     * @returns The concept ID
+     * @throws Error if no confident match found
+     */
+    resolveConceptByLabel(label: string): Promise<string>;
+    /**
+     * Resolve concept ID from params, using label resolution if needed.
+     * @param id - Explicit concept ID (optional)
+     * @param label - Concept label for resolution (optional)
+     * @param fieldName - Name of the field for error messages
+     * @param throwOnMissing - Whether to throw if neither ID nor label provided
+     * @returns The resolved concept ID or undefined
+     */
+    resolveConceptId(id: string | undefined, label: string | undefined, fieldName: string, throwOnMissing?: boolean): Promise<string | undefined>;
+    /**
+     * Resolve concept ID for list operations (silently skip on error).
+     */
+    resolveConceptIdForList(id: string | undefined, label: string | undefined): Promise<string | undefined>;
+    createConcept(params: CreateConceptParams): Promise<ConceptOperationResult>;
+    createEdge(params: CreateEdgeParams): Promise<EdgeOperationResult>;
+    listConcepts(params: ListConceptsParams): Promise<ConceptListResult>;
+    listEdges(params: ListEdgesParams): Promise<EdgeListResult>;
+    editConcept(params: EditConceptParams): Promise<ConceptOperationResult>;
+    editEdge(params: EditEdgeParams): Promise<EdgeOperationResult>;
+    deleteConcept(params: DeleteConceptParams): Promise<ConceptOperationResult>;
+    deleteEdge(params: DeleteEdgeParams): Promise<EdgeOperationResult>;
+    /**
+     * Execute a queue of operations sequentially.
+     * @param operations - Array of operations to execute
+     * @param continueOnError - Whether to continue after errors
+     * @returns Queue execution result with all operation results
+     */
+    executeQueue(operations: QueueOperation[], continueOnError?: boolean): Promise<QueueExecutionResult>;
+    /**
+     * Execute a single queue operation.
+     */
+    private executeSingleOperation;
+}
+//# sourceMappingURL=graph-operations.d.ts.map

package/dist/mcp/graph-operations.d.ts.map

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