promptspeak-mcp-server 0.1.0

package/dist/multi_agent/tool-dispatcher.d.ts

@@ -0,0 +1,325 @@
+/**
+ * ===============================================================================
+ * COMMANDER'S INTENT TOOL DISPATCHER
+ * ===============================================================================
+ *
+ * Dispatches MCP tool calls to the appropriate Commander's Intent handlers.
+ * Follows the pattern established in verification/tools.ts.
+ *
+ * Usage:
+ * ```typescript
+ * import { dispatchIntentTool, isIntentTool } from './tool-dispatcher.js';
+ *
+ * if (isIntentTool(toolName)) {
+ *   const result = await dispatchIntentTool(toolName, args);
+ *   if (result) return result;
+ * }
+ * ```
+ *
+ * ===============================================================================
+ */
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Check if a tool name is handled by the Intent dispatcher.
+ *
+ * @param toolName - The tool name to check
+ * @returns true if this is an Intent tool
+ */
+export declare function isIntentTool(toolName: string): boolean;
+/**
+ * Get all Intent tool names.
+ *
+ * @returns Array of tool names
+ */
+export declare function getIntentToolNames(): string[];
+/**
+ * Dispatch a tool call to the appropriate Intent handler.
+ *
+ * @param toolName - The tool name to dispatch
+ * @param args - Tool arguments
+ * @returns CallToolResult or null if not an Intent tool
+ *
+ * @example
+ * ```typescript
+ * const result = await dispatchIntentTool('ps_mission_create', {
+ *   name: 'Market Research',
+ *   objective: 'Analyze competitor products',
+ *   // ...
+ * });
+ * ```
+ */
+export declare function dispatchIntentTool(toolName: string, args: Record<string, unknown>): Promise<CallToolResult | null>;
+/**
+ * Get all Intent tool definitions for MCP registration.
+ *
+ * @returns Array of tool definitions
+ */
+export declare function getIntentToolDefinitions(): readonly [{
+    readonly name: "ps_mission_create";
+    readonly description: "Create a mission with Commander's Intent for multi-agent coordination.\n\nA mission defines:\n- OBJECTIVE: What we're trying to accomplish (the north star)\n- END STATE: How we know we're done (success/failure conditions)\n- RED LINES: Absolute prohibitions that must never be crossed\n- CONSTRAINTS: What agents must/must not do\n- AUTONOMY LEVEL: How much latitude agents have (strict|guided|autonomous|exploratory)\n\nThe Intent is automatically created and bound to the mission. Agents can then consult\nthe Intent for autonomous decision-making using ps_intent_consult.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly name: {
+                readonly type: "string";
+                readonly description: "Mission name (e.g., \"Market Research Q1 2025\")";
+            };
+            readonly description: {
+                readonly type: "string";
+                readonly description: "Mission description explaining the overall goal";
+            };
+            readonly objective: {
+                readonly type: "string";
+                readonly description: "What we are trying to accomplish - the north star objective";
+            };
+            readonly end_state: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly success: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                        readonly description: "Conditions that indicate mission success";
+                    };
+                    readonly failure: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                        readonly description: "Conditions that indicate mission failure";
+                    };
+                    readonly timeout: {
+                        readonly type: "string";
+                        readonly description: "Maximum duration before timeout (ISO 8601, e.g., \"PT2H\")";
+                    };
+                };
+                readonly required: readonly ["success", "failure"];
+            };
+            readonly red_lines: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Absolute prohibitions - agents must NEVER cross these";
+            };
+            readonly autonomy_level: {
+                readonly type: "string";
+                readonly enum: readonly ["strict", "guided", "autonomous", "exploratory"];
+                readonly description: "How much latitude agents have (default: guided)";
+            };
+            readonly constraints: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly id: {
+                            readonly type: "string";
+                        };
+                        readonly description: {
+                            readonly type: "string";
+                        };
+                        readonly severity: {
+                            readonly type: "string";
+                            readonly enum: readonly ["advisory", "required", "critical"];
+                        };
+                        readonly on_violation: {
+                            readonly type: "string";
+                            readonly enum: readonly ["warn", "block", "escalate", "terminate"];
+                        };
+                    };
+                };
+                readonly description: "Behavioral constraints for agents";
+            };
+            readonly agent_assignments: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly agent_id: {
+                            readonly type: "string";
+                        };
+                        readonly role: {
+                            readonly type: "string";
+                            readonly enum: readonly ["coordinator", "specialist", "support", "terminal"];
+                        };
+                    };
+                };
+                readonly description: "Initial agent assignments (agents must be registered first)";
+            };
+            readonly estimated_duration: {
+                readonly type: "string";
+                readonly description: "Estimated duration (ISO 8601, e.g., \"PT4H\")";
+            };
+            readonly created_by: {
+                readonly type: "string";
+                readonly description: "Creator identifier";
+            };
+            readonly namespace: {
+                readonly type: "string";
+                readonly description: "Optional namespace for multi-tenant isolation";
+            };
+        };
+        readonly required: readonly ["name", "description", "objective", "end_state", "red_lines", "created_by"];
+    };
+}, {
+    readonly name: "ps_mission_status";
+    readonly description: "Get the current status of a mission including progress, assigned agents, and Intent details.\n\nReturns:\n- Mission status (planning|briefing|active|paused|completed|failed|aborted)\n- Progress information (phase, percent complete, blockers)\n- Assigned agents and their status\n- Duration and timing information";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly mission_id: {
+                readonly type: "string";
+                readonly description: "Mission ID";
+            };
+            readonly include_agents: {
+                readonly type: "boolean";
+                readonly description: "Include detailed agent information (default: true)";
+            };
+            readonly include_intent: {
+                readonly type: "boolean";
+                readonly description: "Include full Intent details (default: false)";
+            };
+        };
+        readonly required: readonly ["mission_id"];
+    };
+}, {
+    readonly name: "ps_mission_complete";
+    readonly description: "Mark a mission as complete (success or failure).\n\nCompleting a mission:\n- Unbinds all agents from the Intent\n- Records completion metrics\n- Updates agent performance statistics\n- Marks mission status as completed or failed";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly mission_id: {
+                readonly type: "string";
+                readonly description: "Mission ID";
+            };
+            readonly success: {
+                readonly type: "boolean";
+                readonly description: "Whether the mission succeeded";
+            };
+            readonly summary: {
+                readonly type: "string";
+                readonly description: "Optional completion summary";
+            };
+            readonly metrics: {
+                readonly type: "object";
+                readonly description: "Optional completion metrics";
+            };
+        };
+        readonly required: readonly ["mission_id", "success"];
+    };
+}, {
+    readonly name: "ps_agent_register";
+    readonly description: "Register an agent in the multi-agent system.\n\nRoles:\n- coordinator: High-level orchestration (alpha agent)\n- specialist: Domain-specific execution (beta agent)\n- support: Auxiliary functions (gamma agent)\n- terminal: Final output generation (omega agent)\n\nAgents must be registered before they can be assigned to missions.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly agent_id: {
+                readonly type: "string";
+                readonly description: "Unique agent identifier";
+            };
+            readonly name: {
+                readonly type: "string";
+                readonly description: "Human-readable agent name";
+            };
+            readonly role: {
+                readonly type: "string";
+                readonly enum: readonly ["coordinator", "specialist", "support", "terminal"];
+                readonly description: "Agent role in multi-agent operations";
+            };
+            readonly capabilities: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "List of capabilities this agent provides";
+            };
+        };
+        readonly required: readonly ["agent_id", "name", "role", "capabilities"];
+    };
+}, {
+    readonly name: "ps_agent_heartbeat";
+    readonly description: "Send a heartbeat from an agent to update status and keep alive.\n\nUse this to:\n- Keep the agent registration alive (prevents TTL expiration)\n- Update agent status (executing, blocked, etc.)\n- Report progress on current task\n- Send status messages";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly agent_id: {
+                readonly type: "string";
+                readonly description: "Agent ID";
+            };
+            readonly status: {
+                readonly type: "string";
+                readonly enum: readonly ["idle", "briefed", "executing", "blocked", "completed", "failed", "recalled"];
+                readonly description: "New agent status (optional)";
+            };
+            readonly progress: {
+                readonly type: "number";
+                readonly description: "Progress percentage 0-100 (optional)";
+            };
+            readonly message: {
+                readonly type: "string";
+                readonly description: "Status message (optional)";
+            };
+        };
+        readonly required: readonly ["agent_id"];
+    };
+}, {
+    readonly name: "ps_intent_consult";
+    readonly description: "Consult Commander's Intent for decision guidance.\n\nUse this when an agent is uncertain about what action to take. The Intent will:\n1. Check if any option violates red lines (absolute prohibitions)\n2. Evaluate constraints for each option\n3. Assess if the action advances the mission objective\n4. Consider the autonomy level\n\nReturns a recommendation:\n- proceed: Action is aligned with Intent, go ahead\n- proceed_with_caution: Some concerns but acceptable\n- escalate: Requires human or coordinator decision\n- abort: Action would violate red lines or critical constraints";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly agent_id: {
+                readonly type: "string";
+                readonly description: "Agent making the consultation request";
+            };
+            readonly intent_id: {
+                readonly type: "string";
+                readonly description: "Intent ID to consult (e.g., \"XI.I.MISSION_001\")";
+            };
+            readonly situation: {
+                readonly type: "string";
+                readonly description: "Current situation description";
+            };
+            readonly options: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly id: {
+                            readonly type: "string";
+                        };
+                        readonly description: {
+                            readonly type: "string";
+                        };
+                        readonly pros: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "string";
+                            };
+                        };
+                        readonly cons: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "string";
+                            };
+                        };
+                    };
+                    readonly required: readonly ["id", "description"];
+                };
+                readonly description: "Options being considered";
+            };
+            readonly urgency: {
+                readonly type: "string";
+                readonly enum: readonly ["low", "medium", "high", "critical"];
+                readonly description: "Urgency level (default: medium)";
+            };
+        };
+        readonly required: readonly ["agent_id", "intent_id", "situation", "options"];
+    };
+}];
+/**
+ * Get Intent tool count for diagnostics.
+ */
+export declare function getIntentToolCount(): number;
+//# sourceMappingURL=tool-dispatcher.d.ts.map

package/dist/multi_agent/tool-dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-dispatcher.d.ts","sourceRoot":"","sources":["../../src/multi_agent/tool-dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AA2BzE;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAE7C;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAwBhC;AAMD;;;;GAIG;AACH,wBAAgB,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAEvC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C"}

package/dist/multi_agent/tool-dispatcher.js

@@ -0,0 +1,108 @@
+/**
+ * ===============================================================================
+ * COMMANDER'S INTENT TOOL DISPATCHER
+ * ===============================================================================
+ *
+ * Dispatches MCP tool calls to the appropriate Commander's Intent handlers.
+ * Follows the pattern established in verification/tools.ts.
+ *
+ * Usage:
+ * ```typescript
+ * import { dispatchIntentTool, isIntentTool } from './tool-dispatcher.js';
+ *
+ * if (isIntentTool(toolName)) {
+ *   const result = await dispatchIntentTool(toolName, args);
+ *   if (result) return result;
+ * }
+ * ```
+ *
+ * ===============================================================================
+ */
+import { INTENT_TOOLS, handleMissionCreate, handleMissionStatus, handleMissionComplete, handleAgentRegister, handleAgentHeartbeat, handleIntentConsult, } from './intent-tools.js';
+// ===============================================================================
+// TOOL IDENTIFICATION
+// ===============================================================================
+/**
+ * Set of tool names handled by the Intent dispatcher.
+ */
+const INTENT_TOOL_NAMES = new Set([
+    'ps_mission_create',
+    'ps_mission_status',
+    'ps_mission_complete',
+    'ps_agent_register',
+    'ps_agent_heartbeat',
+    'ps_intent_consult',
+]);
+/**
+ * Check if a tool name is handled by the Intent dispatcher.
+ *
+ * @param toolName - The tool name to check
+ * @returns true if this is an Intent tool
+ */
+export function isIntentTool(toolName) {
+    return INTENT_TOOL_NAMES.has(toolName);
+}
+/**
+ * Get all Intent tool names.
+ *
+ * @returns Array of tool names
+ */
+export function getIntentToolNames() {
+    return Array.from(INTENT_TOOL_NAMES);
+}
+// ===============================================================================
+// DISPATCHER
+// ===============================================================================
+/**
+ * Dispatch a tool call to the appropriate Intent handler.
+ *
+ * @param toolName - The tool name to dispatch
+ * @param args - Tool arguments
+ * @returns CallToolResult or null if not an Intent tool
+ *
+ * @example
+ * ```typescript
+ * const result = await dispatchIntentTool('ps_mission_create', {
+ *   name: 'Market Research',
+ *   objective: 'Analyze competitor products',
+ *   // ...
+ * });
+ * ```
+ */
+export async function dispatchIntentTool(toolName, args) {
+    switch (toolName) {
+        case 'ps_mission_create':
+            return handleMissionCreate(args);
+        case 'ps_mission_status':
+            return handleMissionStatus(args);
+        case 'ps_mission_complete':
+            return handleMissionComplete(args);
+        case 'ps_agent_register':
+            return handleAgentRegister(args);
+        case 'ps_agent_heartbeat':
+            return handleAgentHeartbeat(args);
+        case 'ps_intent_consult':
+            return handleIntentConsult(args);
+        default:
+            // Not an Intent tool - return null so caller knows to try other dispatchers
+            return null;
+    }
+}
+// ===============================================================================
+// TOOL DEFINITIONS EXPORT
+// ===============================================================================
+/**
+ * Get all Intent tool definitions for MCP registration.
+ *
+ * @returns Array of tool definitions
+ */
+export function getIntentToolDefinitions() {
+    return INTENT_TOOLS;
+}
+/**
+ * Get Intent tool count for diagnostics.
+ */
+export function getIntentToolCount() {
+    return INTENT_TOOLS.length;
+}
+//# sourceMappingURL=tool-dispatcher.js.map

package/dist/multi_agent/tool-dispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-dispatcher.js","sourceRoot":"","sources":["../../src/multi_agent/tool-dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAE3B,kFAAkF;AAClF,sBAAsB;AACtB,kFAAkF;AAElF;;GAEG;AACH,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IAChC,mBAAmB;IACnB,mBAAmB;IACnB,qBAAqB;IACrB,mBAAmB;IACnB,oBAAoB;IACpB,mBAAmB;CACpB,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,OAAO,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AACzC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;AACvC,CAAC;AAED,kFAAkF;AAClF,aAAa;AACb,kFAAkF;AAElF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,QAAgB,EAChB,IAA6B;IAE7B,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,mBAAmB;YACtB,OAAO,mBAAmB,CAAC,IAAiD,CAAC,CAAC;QAEhF,KAAK,mBAAmB;YACtB,OAAO,mBAAmB,CAAC,IAAiD,CAAC,CAAC;QAEhF,KAAK,qBAAqB;YACxB,OAAO,qBAAqB,CAAC,IAAmD,CAAC,CAAC;QAEpF,KAAK,mBAAmB;YACtB,OAAO,mBAAmB,CAAC,IAAiD,CAAC,CAAC;QAEhF,KAAK,oBAAoB;YACvB,OAAO,oBAAoB,CAAC,IAAkD,CAAC,CAAC;QAElF,KAAK,mBAAmB;YACtB,OAAO,mBAAmB,CAAC,IAAiD,CAAC,CAAC;QAEhF;YACE,4EAA4E;YAC5E,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED,kFAAkF;AAClF,0BAA0B;AAC1B,kFAAkF;AAElF;;;;GAIG;AACH,MAAM,UAAU,wBAAwB;IACtC,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,YAAY,CAAC,MAAM,CAAC;AAC7B,CAAC"}