feat: report failure tool

Author: Patrick-Erichsen

extensions/cli/src/tools/allBuiltIns.ts

@@ -4,9 +4,9 @@ import { fetchTool } from "./fetch.js";
 import { listFilesTool } from "./listFiles.js";
 import { multiEditTool } from "./multiEdit.js";
 import { readFileTool } from "./readFile.js";
+import { reportFailureTool } from "./reportFailure.js";
 import { runTerminalCommandTool } from "./runTerminalCommand.js";
 import { searchCodeTool } from "./searchCode.js";
-import { statusTool } from "./status.js";
 import { writeChecklistTool } from "./writeChecklist.js";
 import { writeFileTool } from "./writeFile.js";
 
@@ -22,5 +22,5 @@ export const ALL_BUILT_IN_TOOLS = [
   fetchTool,
   writeChecklistTool,
   exitTool,
-  statusTool,
+  reportFailureTool,
 ];

extensions/cli/src/tools/index.tsx

@@ -25,9 +25,9 @@ import { fetchTool } from "./fetch.js";
 import { listFilesTool } from "./listFiles.js";
 import { multiEditTool } from "./multiEdit.js";
 import { readFileTool } from "./readFile.js";
+import { reportFailureTool } from "./reportFailure.js";
 import { runTerminalCommandTool } from "./runTerminalCommand.js";
 import { searchCodeTool } from "./searchCode.js";
-import { statusTool } from "./status.js";
 import {
   type Tool,
   type ToolCall,
@@ -49,6 +49,7 @@ const BASE_BUILTIN_TOOLS: Tool[] = [
   runTerminalCommandTool,
   fetchTool,
   writeChecklistTool,
+  reportFailureTool,
 ];
 
 // Get all builtin tools including dynamic ones, with capability-based filtering
@@ -87,11 +88,6 @@ export async function getAllAvailableTools(
     tools.push(exitTool);
   }
 
-  // Add beta status tool if --beta-status-tool flag is present
-  if (process.argv.includes("--beta-status-tool")) {
-    tools.push(statusTool);
-  }
-
   const mcpState = await serviceContainer.get<MCPServiceState>(
     SERVICE_NAMES.MCP,
   );

extensions/cli/src/tools/reportFailure.ts

@@ -0,0 +1,88 @@
+import { ContinueError, ContinueErrorReason } from "core/util/errors.js";
+
+import {
+  ApiRequestError,
+  AuthenticationRequiredError,
+  post,
+} from "../util/apiClient.js";
+import { logger } from "../util/logger.js";
+
+import { Tool } from "./types.js";
+
+/**
+ * Extract the agent ID from the --id command line flag
+ */
+function getAgentIdFromArgs(): string | undefined {
+  const args = process.argv;
+  const idIndex = args.indexOf("--id");
+  if (idIndex !== -1 && idIndex + 1 < args.length) {
+    return args[idIndex + 1];
+  }
+  return undefined;
+}
+
+export const reportFailureTool: Tool = {
+  name: "ReportFailure",
+  displayName: "Report Failure",
+  description:
+    "Report that the task has failed due to an unrecoverable error. Include a succinct explanation for the user.",
+  parameters: {
+    type: "object",
+    required: ["errorMessage"],
+    properties: {
+      errorMessage: {
+        type: "string",
+        description: "Explain what went wrong and why you cannot continue.",
+      },
+    },
+  },
+  readonly: true,
+  isBuiltIn: true,
+  run: async (args: { errorMessage: string }): Promise<string> => {
+    try {
+      const trimmedMessage = args.errorMessage.trim();
+      if (!trimmedMessage) {
+        throw new ContinueError(
+          ContinueErrorReason.Unspecified,
+          "errorMessage is required to report a failure.",
+        );
+      }
+
+      const agentId = getAgentIdFromArgs();
+      if (!agentId) {
+        const errorMessage =
+          "Agent ID is required. Please use the --id flag with cn serve.";
+        logger.error(errorMessage);
+        throw new ContinueError(ContinueErrorReason.Unspecified, errorMessage);
+      }
+
+      await post(`agents/${agentId}/status`, {
+        status: "FAILED",
+        errorMessage: trimmedMessage,
+      });
+
+      logger.info(`Failure reported: ${trimmedMessage}`);
+      return "Failure reported to user.";
+    } catch (error) {
+      if (error instanceof ContinueError) {
+        throw error;
+      }
+
+      if (error instanceof AuthenticationRequiredError) {
+        logger.error(error.message);
+        throw new Error("Error: Authentication required");
+      }
+
+      if (error instanceof ApiRequestError) {
+        throw new Error(
+          `Error reporting failure: ${error.status} ${error.response || error.statusText}`,
+        );
+      }
+
+      const errorMessage =
+        error instanceof Error ? error.message : String(error);
+      logger.error(`Error reporting failure: ${errorMessage}`);
+      throw new Error(`Error reporting failure: ${errorMessage}`);
+    }
+  },
+};