@weavelogic/knowledge-graph-agent 0.3.0 → 0.4.0

package/dist/mcp-server/tools/workflow/list.js

@@ -0,0 +1,195 @@
+import "../../../workflow/config.js";
+import "../../../workflow/adapters/goap-adapter.js";
+import { createWorkflowService } from "../../../workflow/services/workflow-service.js";
+let workflowServiceInstance;
+function getWorkflowService() {
+  if (!workflowServiceInstance) {
+    workflowServiceInstance = createWorkflowService();
+  }
+  return workflowServiceInstance;
+}
+const workflowListTool = {
+  name: "kg_workflow_list",
+  description: "List all active workflows with optional filtering",
+  inputSchema: {
+    type: "object",
+    properties: {
+      status: {
+        type: "string",
+        description: "Filter by workflow status",
+        enum: ["running", "completed", "failed", "suspended", "all"]
+      },
+      type: {
+        type: "string",
+        description: "Filter by workflow type",
+        enum: ["realtime-collab", "analysis", "sync", "custom", "all"]
+      },
+      limit: {
+        type: "number",
+        description: "Maximum number of workflows to return",
+        default: 50
+      },
+      offset: {
+        type: "number",
+        description: "Number of workflows to skip (for pagination)",
+        default: 0
+      },
+      sortBy: {
+        type: "string",
+        description: "Field to sort by",
+        enum: ["startedAt", "lastEventAt", "status", "type"],
+        default: "startedAt"
+      },
+      sortOrder: {
+        type: "string",
+        description: "Sort order",
+        enum: ["asc", "desc"],
+        default: "desc"
+      }
+    }
+  }
+};
+function filterWorkflows(workflows, options) {
+  let filtered = workflows.map((w) => ({
+    id: w.id,
+    type: w.type,
+    startedAt: w.startedAt,
+    status: w.status,
+    currentStep: w.currentStep,
+    lastEventAt: w.lastEventAt,
+    duration: w.lastEventAt ? w.lastEventAt.getTime() - w.startedAt.getTime() : Date.now() - w.startedAt.getTime(),
+    isActive: w.status === "running" || w.status === "suspended"
+  }));
+  if (options.status && options.status !== "all") {
+    filtered = filtered.filter((w) => w.status === options.status);
+  }
+  if (options.type && options.type !== "all") {
+    filtered = filtered.filter((w) => w.type === options.type);
+  }
+  const sortBy = options.sortBy || "startedAt";
+  const sortOrder = options.sortOrder || "desc";
+  const multiplier = sortOrder === "desc" ? -1 : 1;
+  filtered.sort((a, b) => {
+    let aVal;
+    let bVal;
+    switch (sortBy) {
+      case "startedAt":
+        aVal = a.startedAt.getTime();
+        bVal = b.startedAt.getTime();
+        break;
+      case "lastEventAt":
+        aVal = a.lastEventAt?.getTime() || 0;
+        bVal = b.lastEventAt?.getTime() || 0;
+        break;
+      case "status":
+        aVal = a.status;
+        bVal = b.status;
+        break;
+      case "type":
+        aVal = a.type;
+        bVal = b.type;
+        break;
+      default:
+        aVal = a.startedAt.getTime();
+        bVal = b.startedAt.getTime();
+    }
+    if (aVal < bVal) return -1 * multiplier;
+    if (aVal > bVal) return 1 * multiplier;
+    return 0;
+  });
+  return filtered;
+}
+function createWorkflowListHandler() {
+  return async (params) => {
+    const startTime = Date.now();
+    const {
+      status = "all",
+      type = "all",
+      limit = 50,
+      offset = 0,
+      sortBy = "startedAt",
+      sortOrder = "desc"
+    } = params || {};
+    try {
+      const service = getWorkflowService();
+      const serviceStatus = service.getStatus();
+      const allWorkflows = serviceStatus.activeWorkflows;
+      const filteredWorkflows = filterWorkflows(allWorkflows, {
+        status,
+        type,
+        sortBy,
+        sortOrder
+      });
+      const numLimit = typeof limit === "number" ? limit : 50;
+      const numOffset = typeof offset === "number" ? offset : 0;
+      const paginatedWorkflows = filteredWorkflows.slice(
+        numOffset,
+        numOffset + numLimit
+      );
+      const summary = {
+        total: allWorkflows.length,
+        filtered: filteredWorkflows.length,
+        returned: paginatedWorkflows.length,
+        byStatus: {
+          running: allWorkflows.filter((w) => w.status === "running").length,
+          completed: allWorkflows.filter((w) => w.status === "completed").length,
+          failed: allWorkflows.filter((w) => w.status === "failed").length,
+          suspended: allWorkflows.filter((w) => w.status === "suspended").length
+        },
+        byType: allWorkflows.reduce((acc, w) => {
+          acc[w.type] = (acc[w.type] || 0) + 1;
+          return acc;
+        }, {})
+      };
+      const workflows = paginatedWorkflows.map((w) => ({
+        id: w.id,
+        type: w.type,
+        status: w.status,
+        currentStep: w.currentStep,
+        startedAt: w.startedAt.toISOString(),
+        lastEventAt: w.lastEventAt?.toISOString(),
+        duration: w.duration,
+        isActive: w.isActive
+      }));
+      return {
+        success: true,
+        data: {
+          workflows,
+          summary,
+          pagination: {
+            limit: numLimit,
+            offset: numOffset,
+            hasMore: numOffset + numLimit < filteredWorkflows.length,
+            nextOffset: numOffset + numLimit < filteredWorkflows.length ? numOffset + numLimit : null
+          },
+          serviceStatus: {
+            isRunning: serviceStatus.isRunning,
+            watchedPaths: serviceStatus.watchedPaths.length,
+            lastActivity: serviceStatus.lastActivity?.toISOString()
+          }
+        },
+        metadata: {
+          executionTime: Date.now() - startTime,
+          filters: {
+            status: status || "all",
+            type: type || "all",
+            sortBy: sortBy || "startedAt",
+            sortOrder: sortOrder || "desc"
+          },
+          itemCount: workflows.length
+        }
+      };
+    } catch (error) {
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : String(error),
+        metadata: { executionTime: Date.now() - startTime }
+      };
+    }
+  };
+}
+export {
+  createWorkflowListHandler,
+  workflowListTool
+};
+//# sourceMappingURL=list.js.map

package/dist/mcp-server/tools/workflow/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sources":["../../../../src/mcp-server/tools/workflow/list.ts"],"sourcesContent":["/**\n * Workflow List Tool\n *\n * MCP tool for listing all active workflows with filtering\n * and sorting capabilities.\n *\n * @module mcp-server/tools/workflow/list\n */\n\nimport type { Tool } from '@modelcontextprotocol/sdk/types.js';\nimport type { ToolHandler, ToolResult } from '../../types/index.js';\nimport {\n  createWorkflowService,\n  type WorkflowService,\n  type WorkflowRunMetadata,\n} from '../../../workflow/index.js';\n\n/** Singleton workflow service instance */\nlet workflowServiceInstance: WorkflowService | undefined;\n\n/**\n * Get or create the workflow service instance\n *\n * @returns WorkflowService instance\n */\nfunction getWorkflowService(): WorkflowService {\n  if (!workflowServiceInstance) {\n    workflowServiceInstance = createWorkflowService();\n  }\n  return workflowServiceInstance;\n}\n\n/**\n * Workflow list tool definition\n *\n * Defines the MCP tool interface for listing workflows.\n * Supports filtering by status and type with pagination.\n */\nexport const workflowListTool: Tool = {\n  name: 'kg_workflow_list',\n  description: 'List all active workflows with optional filtering',\n  inputSchema: {\n    type: 'object' as const,\n    properties: {\n      status: {\n        type: 'string',\n        description: 'Filter by workflow status',\n        enum: ['running', 'completed', 'failed', 'suspended', 'all'],\n      },\n      type: {\n        type: 'string',\n        description: 'Filter by workflow type',\n        enum: ['realtime-collab', 'analysis', 'sync', 'custom', 'all'],\n      },\n      limit: {\n        type: 'number',\n        description: 'Maximum number of workflows to return',\n        default: 50,\n      },\n      offset: {\n        type: 'number',\n        description: 'Number of workflows to skip (for pagination)',\n        default: 0,\n      },\n      sortBy: {\n        type: 'string',\n        description: 'Field to sort by',\n        enum: ['startedAt', 'lastEventAt', 'status', 'type'],\n        default: 'startedAt',\n      },\n      sortOrder: {\n        type: 'string',\n        description: 'Sort order',\n        enum: ['asc', 'desc'],\n        default: 'desc',\n      },\n    },\n  },\n};\n\n/**\n * Workflow filter options\n */\ninterface WorkflowFilterOptions {\n  status?: string;\n  type?: string;\n  limit?: number;\n  offset?: number;\n  sortBy?: string;\n  sortOrder?: 'asc' | 'desc';\n}\n\n/**\n * Extended workflow info with computed fields\n */\ninterface WorkflowInfo {\n  /** Unique run identifier */\n  id: string;\n  /** Type of workflow being executed */\n  type: string;\n  /** Timestamp when the workflow started */\n  startedAt: Date;\n  /** Current status of the workflow */\n  status: 'running' | 'completed' | 'failed' | 'suspended';\n  /** ID of the currently executing step */\n  currentStep?: string;\n  /** Timestamp of the last event in this workflow */\n  lastEventAt?: Date;\n  /** Computed duration in milliseconds */\n  duration?: number;\n  /** Whether workflow is currently active */\n  isActive: boolean;\n}\n\n/**\n * Filter workflows based on provided options\n *\n * @param workflows - Array of workflow metadata\n * @param options - Filter options\n * @returns Filtered array of workflows\n */\nfunction filterWorkflows(\n  workflows: WorkflowRunMetadata[],\n  options: WorkflowFilterOptions\n): WorkflowInfo[] {\n  let filtered: WorkflowInfo[] = workflows.map(w => ({\n    id: w.id,\n    type: w.type,\n    startedAt: w.startedAt,\n    status: w.status,\n    currentStep: w.currentStep,\n    lastEventAt: w.lastEventAt,\n    duration: w.lastEventAt\n      ? w.lastEventAt.getTime() - w.startedAt.getTime()\n      : Date.now() - w.startedAt.getTime(),\n    isActive: w.status === 'running' || w.status === 'suspended',\n  }));\n\n  // Filter by status\n  if (options.status && options.status !== 'all') {\n    filtered = filtered.filter(w => w.status === options.status);\n  }\n\n  // Filter by type\n  if (options.type && options.type !== 'all') {\n    filtered = filtered.filter(w => w.type === options.type);\n  }\n\n  // Sort\n  const sortBy = options.sortBy || 'startedAt';\n  const sortOrder = options.sortOrder || 'desc';\n  const multiplier = sortOrder === 'desc' ? -1 : 1;\n\n  filtered.sort((a, b) => {\n    let aVal: string | number | Date;\n    let bVal: string | number | Date;\n\n    switch (sortBy) {\n      case 'startedAt':\n        aVal = a.startedAt.getTime();\n        bVal = b.startedAt.getTime();\n        break;\n      case 'lastEventAt':\n        aVal = a.lastEventAt?.getTime() || 0;\n        bVal = b.lastEventAt?.getTime() || 0;\n        break;\n      case 'status':\n        aVal = a.status;\n        bVal = b.status;\n        break;\n      case 'type':\n        aVal = a.type;\n        bVal = b.type;\n        break;\n      default:\n        aVal = a.startedAt.getTime();\n        bVal = b.startedAt.getTime();\n    }\n\n    if (aVal < bVal) return -1 * multiplier;\n    if (aVal > bVal) return 1 * multiplier;\n    return 0;\n  });\n\n  return filtered;\n}\n\n/**\n * Create handler for workflow list tool\n *\n * Creates an async handler that lists all workflows with\n * optional filtering, sorting, and pagination.\n *\n * @returns ToolHandler function for listing workflows\n *\n * @example\n * ```typescript\n * const handler = createWorkflowListHandler();\n *\n * // List all running workflows\n * const running = await handler({ status: 'running' });\n *\n * // List with pagination\n * const page2 = await handler({ limit: 10, offset: 10 });\n *\n * // List sorted by type\n * const byType = await handler({ sortBy: 'type', sortOrder: 'asc' });\n * ```\n */\nexport function createWorkflowListHandler(): ToolHandler {\n  return async (params): Promise<ToolResult> => {\n    const startTime = Date.now();\n    const {\n      status = 'all',\n      type = 'all',\n      limit = 50,\n      offset = 0,\n      sortBy = 'startedAt',\n      sortOrder = 'desc',\n    } = params || {};\n\n    try {\n      const service = getWorkflowService();\n      const serviceStatus = service.getStatus();\n\n      // Get all active workflows\n      const allWorkflows = serviceStatus.activeWorkflows;\n\n      // Apply filters\n      const filteredWorkflows = filterWorkflows(allWorkflows, {\n        status: status as string,\n        type: type as string,\n        sortBy: sortBy as string,\n        sortOrder: sortOrder as 'asc' | 'desc',\n      });\n\n      // Apply pagination\n      const numLimit = typeof limit === 'number' ? limit : 50;\n      const numOffset = typeof offset === 'number' ? offset : 0;\n      const paginatedWorkflows = filteredWorkflows.slice(\n        numOffset,\n        numOffset + numLimit\n      );\n\n      // Compute summary statistics\n      const summary = {\n        total: allWorkflows.length,\n        filtered: filteredWorkflows.length,\n        returned: paginatedWorkflows.length,\n        byStatus: {\n          running: allWorkflows.filter(w => w.status === 'running').length,\n          completed: allWorkflows.filter(w => w.status === 'completed').length,\n          failed: allWorkflows.filter(w => w.status === 'failed').length,\n          suspended: allWorkflows.filter(w => w.status === 'suspended').length,\n        },\n        byType: allWorkflows.reduce((acc, w) => {\n          acc[w.type] = (acc[w.type] || 0) + 1;\n          return acc;\n        }, {} as Record<string, number>),\n      };\n\n      // Format workflow data for response\n      const workflows = paginatedWorkflows.map(w => ({\n        id: w.id,\n        type: w.type,\n        status: w.status,\n        currentStep: w.currentStep,\n        startedAt: w.startedAt.toISOString(),\n        lastEventAt: w.lastEventAt?.toISOString(),\n        duration: w.duration,\n        isActive: w.isActive,\n      }));\n\n      return {\n        success: true,\n        data: {\n          workflows,\n          summary,\n          pagination: {\n            limit: numLimit,\n            offset: numOffset,\n            hasMore: numOffset + numLimit < filteredWorkflows.length,\n            nextOffset: numOffset + numLimit < filteredWorkflows.length\n              ? numOffset + numLimit\n              : null,\n          },\n          serviceStatus: {\n            isRunning: serviceStatus.isRunning,\n            watchedPaths: serviceStatus.watchedPaths.length,\n            lastActivity: serviceStatus.lastActivity?.toISOString(),\n          },\n        },\n        metadata: {\n          executionTime: Date.now() - startTime,\n          filters: {\n            status: status || 'all',\n            type: type || 'all',\n            sortBy: sortBy || 'startedAt',\n            sortOrder: sortOrder || 'desc',\n          },\n          itemCount: workflows.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/workflow/start.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Workflow Start Tool
+ *
+ * MCP tool for starting a new workflow execution.
+ * Integrates with the WorkflowService for workflow orchestration.
+ *
+ * @module mcp-server/tools/workflow/start
+ */
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { ToolHandler } from '../../types/index.js';
+/**
+ * Workflow start tool definition
+ *
+ * Defines the MCP tool interface for starting workflows.
+ * Supports multiple workflow types including collaboration,
+ * analysis, and custom workflows.
+ */
+export declare const workflowStartTool: Tool;
+/**
+ * Create handler for workflow start tool
+ *
+ * Creates an async handler that starts the specified workflow type
+ * and returns execution metadata.
+ *
+ * @returns ToolHandler function for starting workflows
+ *
+ * @example
+ * ```typescript
+ * const handler = createWorkflowStartHandler();
+ * const result = await handler({
+ *   workflowId: 'collaboration',
+ *   input: {
+ *     graphId: 'graph-123',
+ *     docPath: './docs/spec.md'
+ *   }
+ * });
+ * ```
+ */
+export declare function createWorkflowStartHandler(): ToolHandler;
+//# sourceMappingURL=start.d.ts.map

package/dist/mcp-server/tools/workflow/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/workflow/start.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,sBAAsB,CAAC;AAqBpE;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,IA+C/B,CAAC;AAoBF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,0BAA0B,IAAI,WAAW,CAsHxD"}

package/dist/mcp-server/tools/workflow/start.js

@@ -0,0 +1,165 @@
+import "../../../workflow/config.js";
+import "../../../workflow/adapters/goap-adapter.js";
+import { createWorkflowService } from "../../../workflow/services/workflow-service.js";
+let workflowServiceInstance;
+function getWorkflowService() {
+  if (!workflowServiceInstance) {
+    workflowServiceInstance = createWorkflowService();
+  }
+  return workflowServiceInstance;
+}
+const workflowStartTool = {
+  name: "kg_workflow_start",
+  description: "Start a new workflow for knowledge graph operations",
+  inputSchema: {
+    type: "object",
+    properties: {
+      workflowId: {
+        type: "string",
+        description: "Workflow type to start (collaboration, analysis, sync)",
+        enum: ["collaboration", "analysis", "sync", "custom"]
+      },
+      input: {
+        type: "object",
+        description: "Workflow input data",
+        properties: {
+          graphId: {
+            type: "string",
+            description: "Knowledge graph identifier"
+          },
+          docPath: {
+            type: "string",
+            description: "Path to the source document"
+          },
+          options: {
+            type: "object",
+            description: "Additional workflow options",
+            properties: {
+              autoStart: {
+                type: "boolean",
+                description: "Auto-start development when ready"
+              },
+              watchPaths: {
+                type: "array",
+                description: "Paths to watch for changes",
+                items: { type: "string" }
+              },
+              threshold: {
+                type: "number",
+                description: "Completeness threshold (0-1)"
+              }
+            }
+          }
+        }
+      }
+    },
+    required: ["workflowId"]
+  }
+};
+function createWorkflowStartHandler() {
+  return async (params) => {
+    const startTime = Date.now();
+    const { workflowId, input = {} } = params || {};
+    if (!workflowId || typeof workflowId !== "string") {
+      return {
+        success: false,
+        error: "Workflow ID is required",
+        metadata: { executionTime: Date.now() - startTime }
+      };
+    }
+    const validWorkflowTypes = ["collaboration", "analysis", "sync", "custom"];
+    if (!validWorkflowTypes.includes(workflowId)) {
+      return {
+        success: false,
+        error: `Invalid workflow type: ${workflowId}. Valid types: ${validWorkflowTypes.join(", ")}`,
+        metadata: { executionTime: Date.now() - startTime }
+      };
+    }
+    try {
+      const service = getWorkflowService();
+      const typedInput = input;
+      const status = service.getStatus();
+      if (!status.isRunning) {
+        await service.start();
+      }
+      if (typedInput.options?.watchPaths) {
+        for (const path of typedInput.options.watchPaths) {
+          service.watch(path);
+        }
+      }
+      let result;
+      switch (workflowId) {
+        case "collaboration":
+          result = await service.startCollaborationWorkflow(
+            typedInput.graphId || `graph-${Date.now()}`,
+            typedInput.docPath || "./"
+          );
+          break;
+        case "analysis":
+          const analysis = await service.analyzeGaps(typedInput.docPath || "./");
+          result = {
+            success: true,
+            workflowId: `analysis-${Date.now()}`,
+            startedAt: /* @__PURE__ */ new Date(),
+            completedAt: /* @__PURE__ */ new Date(),
+            outcome: "completed",
+            artifacts: analysis.recommendations,
+            data: analysis
+          };
+          break;
+        case "sync":
+          const watchPaths = typedInput.options?.watchPaths || [typedInput.docPath || "./"];
+          for (const path of watchPaths) {
+            service.watch(path);
+          }
+          result = {
+            success: true,
+            workflowId: `sync-${Date.now()}`,
+            startedAt: /* @__PURE__ */ new Date(),
+            outcome: "completed",
+            artifacts: watchPaths
+          };
+          break;
+        case "custom":
+          const plan = await service.createPlan("start-development");
+          result = {
+            success: plan.achievable,
+            workflowId: `custom-${Date.now()}`,
+            startedAt: /* @__PURE__ */ new Date(),
+            completedAt: /* @__PURE__ */ new Date(),
+            outcome: plan.achievable ? "completed" : "failed",
+            artifacts: plan.actionIds,
+            data: { plan }
+          };
+          break;
+      }
+      return {
+        success: result.success,
+        data: {
+          workflowId: result.workflowId,
+          type: workflowId,
+          startedAt: result.startedAt,
+          completedAt: result.completedAt,
+          outcome: result.outcome,
+          artifacts: result.artifacts,
+          ...result.error ? { error: result.error } : {}
+        },
+        metadata: {
+          executionTime: Date.now() - startTime,
+          serviceStatus: service.getStatus().isRunning ? "running" : "stopped"
+        }
+      };
+    } catch (error) {
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : String(error),
+        metadata: { executionTime: Date.now() - startTime }
+      };
+    }
+  };
+}
+export {
+  createWorkflowStartHandler,
+  workflowStartTool
+};
+//# sourceMappingURL=start.js.map

package/dist/mcp-server/tools/workflow/start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.js","sources":["../../../../src/mcp-server/tools/workflow/start.ts"],"sourcesContent":["/**\n * Workflow Start Tool\n *\n * MCP tool for starting a new workflow execution.\n * Integrates with the WorkflowService for workflow orchestration.\n *\n * @module mcp-server/tools/workflow/start\n */\n\nimport type { Tool } from '@modelcontextprotocol/sdk/types.js';\nimport type { ToolHandler, ToolResult } from '../../types/index.js';\nimport {\n  createWorkflowService,\n  type WorkflowService,\n} from '../../../workflow/index.js';\n\n/** Singleton workflow service instance */\nlet workflowServiceInstance: WorkflowService | undefined;\n\n/**\n * Get or create the workflow service instance\n *\n * @returns WorkflowService instance\n */\nfunction getWorkflowService(): WorkflowService {\n  if (!workflowServiceInstance) {\n    workflowServiceInstance = createWorkflowService();\n  }\n  return workflowServiceInstance;\n}\n\n/**\n * Workflow start tool definition\n *\n * Defines the MCP tool interface for starting workflows.\n * Supports multiple workflow types including collaboration,\n * analysis, and custom workflows.\n */\nexport const workflowStartTool: Tool = {\n  name: 'kg_workflow_start',\n  description: 'Start a new workflow for knowledge graph operations',\n  inputSchema: {\n    type: 'object' as const,\n    properties: {\n      workflowId: {\n        type: 'string',\n        description: 'Workflow type to start (collaboration, analysis, sync)',\n        enum: ['collaboration', 'analysis', 'sync', 'custom'],\n      },\n      input: {\n        type: 'object',\n        description: 'Workflow input data',\n        properties: {\n          graphId: {\n            type: 'string',\n            description: 'Knowledge graph identifier',\n          },\n          docPath: {\n            type: 'string',\n            description: 'Path to the source document',\n          },\n          options: {\n            type: 'object',\n            description: 'Additional workflow options',\n            properties: {\n              autoStart: {\n                type: 'boolean',\n                description: 'Auto-start development when ready',\n              },\n              watchPaths: {\n                type: 'array',\n                description: 'Paths to watch for changes',\n                items: { type: 'string' },\n              },\n              threshold: {\n                type: 'number',\n                description: 'Completeness threshold (0-1)',\n              },\n            },\n          },\n        },\n      },\n    },\n    required: ['workflowId'],\n  },\n};\n\n/**\n * Workflow type definitions for different workflow scenarios\n */\ntype WorkflowType = 'collaboration' | 'analysis' | 'sync' | 'custom';\n\n/**\n * Input structure for workflow execution\n */\ninterface WorkflowInput {\n  graphId?: string;\n  docPath?: string;\n  options?: {\n    autoStart?: boolean;\n    watchPaths?: string[];\n    threshold?: number;\n  };\n}\n\n/**\n * Create handler for workflow start tool\n *\n * Creates an async handler that starts the specified workflow type\n * and returns execution metadata.\n *\n * @returns ToolHandler function for starting workflows\n *\n * @example\n * ```typescript\n * const handler = createWorkflowStartHandler();\n * const result = await handler({\n *   workflowId: 'collaboration',\n *   input: {\n *     graphId: 'graph-123',\n *     docPath: './docs/spec.md'\n *   }\n * });\n * ```\n */\nexport function createWorkflowStartHandler(): ToolHandler {\n  return async (params): Promise<ToolResult> => {\n    const startTime = Date.now();\n    const { workflowId, input = {} } = params || {};\n\n    // Validate required parameters\n    if (!workflowId || typeof workflowId !== 'string') {\n      return {\n        success: false,\n        error: 'Workflow ID is required',\n        metadata: { executionTime: Date.now() - startTime },\n      };\n    }\n\n    const validWorkflowTypes: WorkflowType[] = ['collaboration', 'analysis', 'sync', 'custom'];\n    if (!validWorkflowTypes.includes(workflowId as WorkflowType)) {\n      return {\n        success: false,\n        error: `Invalid workflow type: ${workflowId}. Valid types: ${validWorkflowTypes.join(', ')}`,\n        metadata: { executionTime: Date.now() - startTime },\n      };\n    }\n\n    try {\n      const service = getWorkflowService();\n      const typedInput = input as WorkflowInput;\n\n      // Ensure service is started\n      const status = service.getStatus();\n      if (!status.isRunning) {\n        await service.start();\n      }\n\n      // Add watch paths if specified\n      if (typedInput.options?.watchPaths) {\n        for (const path of typedInput.options.watchPaths) {\n          service.watch(path);\n        }\n      }\n\n      let result;\n      switch (workflowId as WorkflowType) {\n        case 'collaboration':\n          // Start collaboration workflow\n          result = await service.startCollaborationWorkflow(\n            typedInput.graphId || `graph-${Date.now()}`,\n            typedInput.docPath || './'\n          );\n          break;\n\n        case 'analysis':\n          // Run gap analysis workflow\n          const analysis = await service.analyzeGaps(typedInput.docPath || './');\n          result = {\n            success: true,\n            workflowId: `analysis-${Date.now()}`,\n            startedAt: new Date(),\n            completedAt: new Date(),\n            outcome: 'completed' as const,\n            artifacts: analysis.recommendations,\n            data: analysis,\n          };\n          break;\n\n        case 'sync':\n          // Sync workflow for file watching\n          const watchPaths = typedInput.options?.watchPaths || [typedInput.docPath || './'];\n          for (const path of watchPaths) {\n            service.watch(path);\n          }\n          result = {\n            success: true,\n            workflowId: `sync-${Date.now()}`,\n            startedAt: new Date(),\n            outcome: 'completed' as const,\n            artifacts: watchPaths,\n          };\n          break;\n\n        case 'custom':\n          // Custom workflow using GOAP planning\n          const plan = await service.createPlan('start-development');\n          result = {\n            success: plan.achievable,\n            workflowId: `custom-${Date.now()}`,\n            startedAt: new Date(),\n            completedAt: new Date(),\n            outcome: plan.achievable ? 'completed' as const : 'failed' as const,\n            artifacts: plan.actionIds,\n            data: { plan },\n          };\n          break;\n      }\n\n      return {\n        success: result.success,\n        data: {\n          workflowId: result.workflowId,\n          type: workflowId,\n          startedAt: result.startedAt,\n          completedAt: result.completedAt,\n          outcome: result.outcome,\n          artifacts: result.artifacts,\n          ...(result.error ? { error: result.error } : {}),\n        },\n        metadata: {\n          executionTime: Date.now() - startTime,\n          serviceStatus: service.getStatus().isRunning ? 'running' : 'stopped',\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/workflow/status.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Workflow Status Tool
+ *
+ * MCP tool for checking the status of a specific workflow
+ * or the overall workflow service status.
+ *
+ * @module mcp-server/tools/workflow/status
+ */
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { ToolHandler } from '../../types/index.js';
+/**
+ * Workflow status tool definition
+ *
+ * Defines the MCP tool interface for checking workflow status.
+ * Can query specific workflow by ID or get service-wide status.
+ */
+export declare const workflowStatusTool: Tool;
+/**
+ * Create handler for workflow status tool
+ *
+ * Creates an async handler that returns the status of a specific
+ * workflow or the overall workflow service.
+ *
+ * @returns ToolHandler function for checking workflow status
+ *
+ * @example
+ * ```typescript
+ * const handler = createWorkflowStatusHandler();
+ *
+ * // Check specific workflow
+ * const result = await handler({ workflowId: 'collab-123-abc' });
+ *
+ * // Check service status with metrics
+ * const serviceStatus = await handler({ includeMetrics: true });
+ * ```
+ */
+export declare function createWorkflowStatusHandler(): ToolHandler;
+//# sourceMappingURL=status.d.ts.map

package/dist/mcp-server/tools/workflow/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/workflow/status.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,sBAAsB,CAAC;AAsBpE;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,EAAE,IAsBhC,CAAC;AAkCF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,2BAA2B,IAAI,WAAW,CAqEzD"}

package/dist/mcp-server/tools/workflow/status.js

@@ -0,0 +1,97 @@
+import "../../../workflow/config.js";
+import "../../../workflow/adapters/goap-adapter.js";
+import { createWorkflowService } from "../../../workflow/services/workflow-service.js";
+let workflowServiceInstance;
+function getWorkflowService() {
+  if (!workflowServiceInstance) {
+    workflowServiceInstance = createWorkflowService();
+  }
+  return workflowServiceInstance;
+}
+const workflowStatusTool = {
+  name: "kg_workflow_status",
+  description: "Check the status of a workflow or the workflow service",
+  inputSchema: {
+    type: "object",
+    properties: {
+      workflowId: {
+        type: "string",
+        description: "Specific workflow ID to check (optional, returns service status if not provided)"
+      },
+      includeMetrics: {
+        type: "boolean",
+        description: "Include execution metrics and statistics",
+        default: false
+      },
+      includeConfig: {
+        type: "boolean",
+        description: "Include service configuration details",
+        default: false
+      }
+    }
+  }
+};
+function createWorkflowStatusHandler() {
+  return async (params) => {
+    const startTime = Date.now();
+    const { workflowId, includeMetrics = false, includeConfig = false } = params || {};
+    try {
+      const service = getWorkflowService();
+      const serviceStatus = service.getStatus();
+      const response = {
+        found: false,
+        service: {
+          isRunning: serviceStatus.isRunning,
+          activeWorkflowCount: serviceStatus.activeWorkflows.length,
+          watchedPaths: serviceStatus.watchedPaths,
+          lastActivity: serviceStatus.lastActivity
+        }
+      };
+      if (workflowId && typeof workflowId === "string") {
+        const workflow = service.getWorkflow(workflowId);
+        if (workflow) {
+          response.found = true;
+          response.workflow = workflow;
+        }
+      }
+      if (includeMetrics) {
+        const stats = serviceStatus.stats;
+        response.stats = {
+          totalExecutions: stats.totalExecutions,
+          successfulExecutions: stats.successfulExecutions,
+          failedExecutions: stats.failedExecutions,
+          averageDuration: stats.averageDuration,
+          successRate: stats.totalExecutions > 0 ? stats.successfulExecutions / stats.totalExecutions * 100 : 0
+        };
+      }
+      if (includeConfig) {
+        const config = service.getConfig();
+        response.config = {
+          inactivityTimeout: config.inactivityTimeout || 3e5,
+          autoStartThreshold: config.autoStartThreshold || 0.7,
+          watchPaths: config.watchPaths || [],
+          debug: config.debug || false
+        };
+      }
+      return {
+        success: true,
+        data: response,
+        metadata: {
+          executionTime: Date.now() - startTime,
+          requestedWorkflowId: workflowId || null
+        }
+      };
+    } catch (error) {
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : String(error),
+        metadata: { executionTime: Date.now() - startTime }
+      };
+    }
+  };
+}
+export {
+  createWorkflowStatusHandler,
+  workflowStatusTool
+};
+//# sourceMappingURL=status.js.map

package/dist/mcp-server/tools/workflow/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sources":["../../../../src/mcp-server/tools/workflow/status.ts"],"sourcesContent":["/**\n * Workflow Status Tool\n *\n * MCP tool for checking the status of a specific workflow\n * or the overall workflow service status.\n *\n * @module mcp-server/tools/workflow/status\n */\n\nimport type { Tool } from '@modelcontextprotocol/sdk/types.js';\nimport type { ToolHandler, ToolResult } from '../../types/index.js';\nimport {\n  createWorkflowService,\n  type WorkflowService,\n  type WorkflowRunMetadata,\n} from '../../../workflow/index.js';\n\n/** Singleton workflow service instance */\nlet workflowServiceInstance: WorkflowService | undefined;\n\n/**\n * Get or create the workflow service instance\n *\n * @returns WorkflowService instance\n */\nfunction getWorkflowService(): WorkflowService {\n  if (!workflowServiceInstance) {\n    workflowServiceInstance = createWorkflowService();\n  }\n  return workflowServiceInstance;\n}\n\n/**\n * Workflow status tool definition\n *\n * Defines the MCP tool interface for checking workflow status.\n * Can query specific workflow by ID or get service-wide status.\n */\nexport const workflowStatusTool: Tool = {\n  name: 'kg_workflow_status',\n  description: 'Check the status of a workflow or the workflow service',\n  inputSchema: {\n    type: 'object' as const,\n    properties: {\n      workflowId: {\n        type: 'string',\n        description: 'Specific workflow ID to check (optional, returns service status if not provided)',\n      },\n      includeMetrics: {\n        type: 'boolean',\n        description: 'Include execution metrics and statistics',\n        default: false,\n      },\n      includeConfig: {\n        type: 'boolean',\n        description: 'Include service configuration details',\n        default: false,\n      },\n    },\n  },\n};\n\n/**\n * Workflow status response structure\n */\ninterface WorkflowStatusResponse {\n  /** Whether a specific workflow was found */\n  found: boolean;\n  /** Workflow metadata if found */\n  workflow?: WorkflowRunMetadata;\n  /** Service-level status */\n  service: {\n    isRunning: boolean;\n    activeWorkflowCount: number;\n    watchedPaths: string[];\n    lastActivity?: Date;\n  };\n  /** Execution statistics (if requested) */\n  stats?: {\n    totalExecutions: number;\n    successfulExecutions: number;\n    failedExecutions: number;\n    averageDuration: number;\n    successRate: number;\n  };\n  /** Service configuration (if requested) */\n  config?: {\n    inactivityTimeout: number;\n    autoStartThreshold: number;\n    watchPaths: string[];\n    debug: boolean;\n  };\n}\n\n/**\n * Create handler for workflow status tool\n *\n * Creates an async handler that returns the status of a specific\n * workflow or the overall workflow service.\n *\n * @returns ToolHandler function for checking workflow status\n *\n * @example\n * ```typescript\n * const handler = createWorkflowStatusHandler();\n *\n * // Check specific workflow\n * const result = await handler({ workflowId: 'collab-123-abc' });\n *\n * // Check service status with metrics\n * const serviceStatus = await handler({ includeMetrics: true });\n * ```\n */\nexport function createWorkflowStatusHandler(): ToolHandler {\n  return async (params): Promise<ToolResult> => {\n    const startTime = Date.now();\n    const { workflowId, includeMetrics = false, includeConfig = false } = params || {};\n\n    try {\n      const service = getWorkflowService();\n      const serviceStatus = service.getStatus();\n\n      const response: WorkflowStatusResponse = {\n        found: false,\n        service: {\n          isRunning: serviceStatus.isRunning,\n          activeWorkflowCount: serviceStatus.activeWorkflows.length,\n          watchedPaths: serviceStatus.watchedPaths,\n          lastActivity: serviceStatus.lastActivity,\n        },\n      };\n\n      // Check specific workflow if ID provided\n      if (workflowId && typeof workflowId === 'string') {\n        const workflow = service.getWorkflow(workflowId);\n        if (workflow) {\n          response.found = true;\n          response.workflow = workflow;\n        }\n      }\n\n      // Include execution statistics if requested\n      if (includeMetrics) {\n        const stats = serviceStatus.stats;\n        response.stats = {\n          totalExecutions: stats.totalExecutions,\n          successfulExecutions: stats.successfulExecutions,\n          failedExecutions: stats.failedExecutions,\n          averageDuration: stats.averageDuration,\n          successRate: stats.totalExecutions > 0\n            ? (stats.successfulExecutions / stats.totalExecutions) * 100\n            : 0,\n        };\n      }\n\n      // Include configuration if requested\n      if (includeConfig) {\n        const config = service.getConfig();\n        response.config = {\n          inactivityTimeout: config.inactivityTimeout || 300000,\n          autoStartThreshold: config.autoStartThreshold || 0.7,\n          watchPaths: config.watchPaths || [],\n          debug: config.debug || false,\n        };\n      }\n\n      return {\n        success: true,\n        data: response,\n        metadata: {\n          executionTime: Date.now() - startTime,\n          requestedWorkflowId: workflowId || null,\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":";;;AAkBA,IAAI;AAOJ,SAAS,qBAAsC;AAC7C,MAAI,CAAC,yBAAyB;AAC5B,8BAA0B,sBAAA;AAAA,EAC5B;AACA,SAAO;AACT;AAQO,MAAM,qBAA2B;AAAA,EACtC,MAAM;AAAA,EACN,aAAa;AAAA,EACb,aAAa;AAAA,IACX,MAAM;AAAA,IACN,YAAY;AAAA,MACV,YAAY;AAAA,QACV,MAAM;AAAA,QACN,aAAa;AAAA,MAAA;AAAA,MAEf,gBAAgB;AAAA,QACd,MAAM;AAAA,QACN,aAAa;AAAA,QACb,SAAS;AAAA,MAAA;AAAA,MAEX,eAAe;AAAA,QACb,MAAM;AAAA,QACN,aAAa;AAAA,QACb,SAAS;AAAA,MAAA;AAAA,IACX;AAAA,EACF;AAEJ;AAqDO,SAAS,8BAA2C;AACzD,SAAO,OAAO,WAAgC;AAC5C,UAAM,YAAY,KAAK,IAAA;AACvB,UAAM,EAAE,YAAY,iBAAiB,OAAO,gBAAgB,MAAA,IAAU,UAAU,CAAA;AAEhF,QAAI;AACF,YAAM,UAAU,mBAAA;AAChB,YAAM,gBAAgB,QAAQ,UAAA;AAE9B,YAAM,WAAmC;AAAA,QACvC,OAAO;AAAA,QACP,SAAS;AAAA,UACP,WAAW,cAAc;AAAA,UACzB,qBAAqB,cAAc,gBAAgB;AAAA,UACnD,cAAc,cAAc;AAAA,UAC5B,cAAc,cAAc;AAAA,QAAA;AAAA,MAC9B;AAIF,UAAI,cAAc,OAAO,eAAe,UAAU;AAChD,cAAM,WAAW,QAAQ,YAAY,UAAU;AAC/C,YAAI,UAAU;AACZ,mBAAS,QAAQ;AACjB,mBAAS,WAAW;AAAA,QACtB;AAAA,MACF;AAGA,UAAI,gBAAgB;AAClB,cAAM,QAAQ,cAAc;AAC5B,iBAAS,QAAQ;AAAA,UACf,iBAAiB,MAAM;AAAA,UACvB,sBAAsB,MAAM;AAAA,UAC5B,kBAAkB,MAAM;AAAA,UACxB,iBAAiB,MAAM;AAAA,UACvB,aAAa,MAAM,kBAAkB,IAChC,MAAM,uBAAuB,MAAM,kBAAmB,MACvD;AAAA,QAAA;AAAA,MAER;AAGA,UAAI,eAAe;AACjB,cAAM,SAAS,QAAQ,UAAA;AACvB,iBAAS,SAAS;AAAA,UAChB,mBAAmB,OAAO,qBAAqB;AAAA,UAC/C,oBAAoB,OAAO,sBAAsB;AAAA,UACjD,YAAY,OAAO,cAAc,CAAA;AAAA,UACjC,OAAO,OAAO,SAAS;AAAA,QAAA;AAAA,MAE3B;AAEA,aAAO;AAAA,QACL,SAAS;AAAA,QACT,MAAM;AAAA,QACN,UAAU;AAAA,UACR,eAAe,KAAK,IAAA,IAAQ;AAAA,UAC5B,qBAAqB,cAAc;AAAA,QAAA;AAAA,MACrC;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/node_modules/ajv/dist/compile/index.js

@@ -1,4 +1,4 @@
-import { __exports as compile } from "../../../../_virtual/index6.js";
+import { __exports as compile } from "../../../../_virtual/index10.js";
 import { __require as requireCodegen } from "./codegen/index.js";
 import { __require as requireValidation_error } from "../runtime/validation_error.js";
 import { __require as requireNames } from "./names.js";

package/dist/node_modules/ajv/dist/vocabularies/applicator/index.js

@@ -1,4 +1,4 @@
-import { __exports as applicator } from "../../../../../_virtual/index9.js";
+import { __exports as applicator } from "../../../../../_virtual/index8.js";
 import { __require as requireAdditionalItems } from "./additionalItems.js";
 import { __require as requirePrefixItems } from "./prefixItems.js";
 import { __require as requireItems } from "./items.js";

package/dist/node_modules/ajv/dist/vocabularies/core/index.js

@@ -1,4 +1,4 @@
-import { __exports as core } from "../../../../../_virtual/index7.js";
+import { __exports as core } from "../../../../../_virtual/index6.js";
 import { __require as requireId } from "./id.js";
 import { __require as requireRef } from "./ref.js";
 var hasRequiredCore;

package/dist/node_modules/ajv/dist/vocabularies/format/index.js

@@ -1,4 +1,4 @@
-import { __exports as format } from "../../../../../_virtual/index10.js";
+import { __exports as format } from "../../../../../_virtual/index9.js";
 import { __require as requireFormat$1 } from "./format.js";
 var hasRequiredFormat;
 function requireFormat() {

package/dist/node_modules/ajv/dist/vocabularies/validation/index.js

@@ -1,4 +1,4 @@
-import { __exports as validation } from "../../../../../_virtual/index8.js";
+import { __exports as validation } from "../../../../../_virtual/index7.js";
 import { __require as requireLimitNumber } from "./limitNumber.js";
 import { __require as requireMultipleOf } from "./multipleOf.js";
 import { __require as requireLimitLength } from "./limitLength.js";