promptspeak-mcp-server 0.1.0

package/dist/multi_agent/intent-tools.d.ts

@@ -0,0 +1,370 @@
+/**
+ * ===============================================================================
+ * COMMANDER'S INTENT MCP TOOLS
+ * ===============================================================================
+ *
+ * MCP tool definitions and handlers for Commander's Intent multi-agent operations.
+ * These tools follow the newer pattern using mcpSuccess/mcpFailure from core/result.
+ *
+ * Tools:
+ * - ps_mission_create - Create mission with Commander's Intent
+ * - ps_mission_status - Get mission status and agent info
+ * - ps_mission_complete - Mark mission complete
+ * - ps_agent_register - Register agent for mission
+ * - ps_agent_heartbeat - Agent heartbeat/status update
+ * - ps_intent_consult - Consult intent for decision guidance
+ *
+ * ===============================================================================
+ */
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { AgentRole, AutonomyLevel, AgentStatus } from './intent-types.js';
+export declare const INTENT_TOOLS: 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"];
+    };
+}];
+/**
+ * Handle ps_mission_create - Create mission with Commander's Intent
+ */
+export declare function handleMissionCreate(args: {
+    name: string;
+    description: string;
+    objective: string;
+    end_state: {
+        success: string[];
+        failure: string[];
+        timeout?: string;
+    };
+    red_lines: string[];
+    autonomy_level?: AutonomyLevel;
+    constraints?: Array<{
+        id: string;
+        description: string;
+        severity: 'advisory' | 'required' | 'critical';
+        on_violation: 'warn' | 'block' | 'escalate' | 'terminate';
+    }>;
+    context?: {
+        background?: string;
+        assumptions?: string[];
+        domain_hints?: string[];
+    };
+    agent_assignments?: Array<{
+        agent_id: string;
+        role: AgentRole;
+    }>;
+    estimated_duration?: string;
+    created_by: string;
+    namespace?: string;
+    tags?: string[];
+}): Promise<CallToolResult>;
+/**
+ * Handle ps_mission_status - Get mission status and agent info
+ */
+export declare function handleMissionStatus(args: {
+    mission_id: string;
+    include_agents?: boolean;
+    include_intent?: boolean;
+}): Promise<CallToolResult>;
+/**
+ * Handle ps_mission_complete - Mark mission complete
+ */
+export declare function handleMissionComplete(args: {
+    mission_id: string;
+    success: boolean;
+    summary?: string;
+    metrics?: Record<string, unknown>;
+}): Promise<CallToolResult>;
+/**
+ * Handle ps_agent_register - Register agent for mission
+ */
+export declare function handleAgentRegister(args: {
+    agent_id: string;
+    name: string;
+    role: AgentRole;
+    capabilities: string[];
+}): Promise<CallToolResult>;
+/**
+ * Handle ps_agent_heartbeat - Agent heartbeat/status update
+ */
+export declare function handleAgentHeartbeat(args: {
+    agent_id: string;
+    status?: AgentStatus;
+    progress?: number;
+    message?: string;
+}): Promise<CallToolResult>;
+/**
+ * Handle ps_intent_consult - Consult intent for decision guidance
+ */
+export declare function handleIntentConsult(args: {
+    agent_id: string;
+    intent_id: string;
+    situation: string;
+    options: Array<{
+        id: string;
+        description: string;
+        pros?: string[];
+        cons?: string[];
+    }>;
+    urgency?: 'low' | 'medium' | 'high' | 'critical';
+    context?: Record<string, unknown>;
+}): Promise<CallToolResult>;
+//# sourceMappingURL=intent-tools.d.ts.map

package/dist/multi_agent/intent-tools.d.ts.map

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