@loxia-labs/loxia-autopilot-one 1.0.1

package/src/tools/jobDoneTool.js

@@ -0,0 +1,248 @@
+/**
+ * Job Done Tool - Signals task completion in autonomous mode
+ * 
+ * Purpose:
+ * - Allow agents to explicitly signal when a task is complete
+ * - Provide completion summary/reason
+ * - Gracefully exit autonomous mode
+ * - Return to chat mode (unless in locked mode)
+ */
+
+import { BaseTool } from './baseTool.js';
+import TagParser from '../utilities/tagParser.js';
+
+class JobDoneTool extends BaseTool {
+  constructor() {
+    super();
+    this.id = 'jobdone';
+    this.name = 'Job Done';
+    this.description = 'Call this tool when you have successfully completed the assigned task, OR if you are stuck/unable to proceed after multiple failed attempts. Provide a summary of what was accomplished or what prevented completion. This will exit autonomous mode and return control to the user.';
+    this.version = '1.0.0';
+    this.capabilities = ['task-completion', 'mode-control'];
+    this.requiresProject = false;
+    this.async = false;
+  }
+
+  /**
+   * Get tool description for LLM consumption
+   * @returns {string} Tool description
+   */
+  getDescription() {
+    return `
+Job Done Tool: Signal task completion in autonomous mode and exit to chat mode.
+
+Usage Instructions:
+- Call this tool when you have SUCCESSFULLY completed the assigned task
+- Also call this tool if you are STUCK or UNABLE to proceed after multiple failed attempts
+- Provide a clear summary of what was accomplished OR what prevented completion
+- This will immediately exit autonomous mode and return control to the user
+
+Examples:
+- "Created 5 song files successfully with lyrics and melodies"
+- "Unable to proceed: missing API credentials for the service"
+- "Stuck after 3 failed compilation attempts - syntax errors persist"
+- "Task partially complete: implemented 2 of 3 requested features"
+
+The tool will format a completion message and gracefully exit autonomous mode.
+    `.trim();
+  }
+
+  /**
+   * Parse parameters from tool command content
+   * @param {string} content - Raw tool command content
+   * @returns {Object} Parsed parameters object
+   */
+  parseParameters(content) {
+    try {
+      // For JobDoneTool, we expect the content to be structured with tags
+      // or we can parse it as a simple completion message
+      
+      // Try to extract structured content first
+      const summaryMatches = TagParser.extractContent(content, 'summary');
+      const detailsMatches = TagParser.extractContent(content, 'details');
+      const successMatches = TagParser.extractContent(content, 'success');
+      
+      let summary = '';
+      let details = '';
+      let success = true;
+      
+      if (summaryMatches.length > 0) {
+        // Structured format with tags
+        summary = summaryMatches[0].trim();
+        details = detailsMatches.length > 0 ? detailsMatches[0].trim() : '';
+        success = successMatches.length > 0 ? (successMatches[0].toLowerCase() !== 'false') : true;
+      } else {
+        // Fallback: use the entire content as summary
+        summary = content.trim() || 'Task completed';
+      }
+      
+      return {
+        actions: [{
+          action: 'complete',
+          summary: summary,
+          success: success,
+          details: details || undefined
+        }]
+      };
+      
+    } catch (error) {
+      // Fallback to simple parsing
+      return {
+        actions: [{
+          action: 'complete',
+          summary: content.trim() || 'Task completed',
+          success: true
+        }]
+      };
+    }
+  }
+
+  /**
+   * Get tool schema for AI model
+   * @returns {Object} Tool schema
+   */
+  getSchema() {
+    return {
+      type: 'object',
+      properties: {
+        actions: {
+          type: 'array',
+          items: {
+            type: 'object',
+            properties: {
+              action: {
+                type: 'string',
+                enum: ['complete'],
+                description: 'Mark task as complete - always use "complete"'
+              },
+              summary: {
+                type: 'string',
+                description: 'Clear summary of what you accomplished OR what prevented completion (e.g., "Created 5 song files successfully", "Unable to proceed: missing API credentials", "Stuck after 3 failed compilation attempts")'
+              },
+              success: {
+                type: 'boolean',
+                default: true,
+                description: 'Set to true if task completed successfully, false if stuck/failed or partial completion'
+              },
+              details: {
+                type: 'string',
+                description: 'Optional: Additional details about what was done, what failed, any files created, or next steps for the user'
+              }
+            },
+            required: ['action', 'summary'],
+            additionalProperties: false
+          },
+          minItems: 1,
+          maxItems: 1
+        }
+      },
+      required: ['actions'],
+      additionalProperties: false
+    };
+  }
+
+  /**
+   * Execute job done action
+   * @param {Object} parameters - Tool parameters
+   * @param {Object} context - Execution context
+   * @returns {Promise<Object>} Execution result
+   */
+  async execute(parameters, context = {}) {
+    try {
+      const { actions } = parameters;
+      
+      if (!actions || !Array.isArray(actions) || actions.length === 0) {
+        throw new Error('Actions array is required');
+      }
+
+      const action = actions[0];
+      
+      if (action.action !== 'complete') {
+        throw new Error('Invalid action. Only "complete" is supported');
+      }
+
+      if (!action.summary) {
+        throw new Error('Completion summary is required');
+      }
+
+      // Get agent information for context
+      const agentId = context.agentId;
+      let agentInfo = '';
+      
+      if (agentId && context.toolsRegistry) {
+        try {
+          // Try to get agent info through AgentPool if available
+          if (this.agentPool) {
+            const agent = await this.agentPool.getAgent(agentId);
+            if (agent) {
+              agentInfo = ` by agent "${agent.name}"`;
+            }
+          }
+        } catch (error) {
+          // Ignore agent info errors
+        }
+      }
+
+      // Format completion message
+      const completionMessage = `✅ Task completed${agentInfo}${action.success !== false ? ' successfully' : ' with issues'}
+
+**Summary:** ${action.summary}${action.details ? `
+
+**Details:** ${action.details}` : ''}
+
+*Autonomous mode will now exit.*`;
+
+      // Return result indicating task completion
+      return {
+        success: true,
+        output: completionMessage,
+        taskComplete: true,
+        summary: action.summary,
+        details: action.details || null,
+        successfulCompletion: action.success !== false,
+        metadata: {
+          toolId: this.id,
+          agentId: agentId || 'unknown',
+          completedAt: new Date().toISOString(),
+          action: action.action
+        }
+      };
+      
+    } catch (error) {
+      return {
+        success: false,
+        error: error.message,
+        output: `Failed to mark task as complete: ${error.message}`,
+        taskComplete: false
+      };
+    }
+  }
+
+  /**
+   * Set AgentPool dependency for agent information
+   * @param {AgentPool} agentPool - AgentPool instance
+   */
+  setAgentPool(agentPool) {
+    this.agentPool = agentPool;
+  }
+
+  /**
+   * Get tool capabilities
+   * @returns {Object} Tool capabilities
+   */
+  getCapabilities() {
+    return {
+      id: this.id,
+      name: this.name,
+      description: this.description,
+      version: this.version,
+      capabilities: this.capabilities,
+      requiresProject: this.requiresProject,
+      async: this.async,
+      enabled: true,
+      schema: this.getSchema()
+    };
+  }
+}
+
+export default JobDoneTool;