ruvnet/ruflo · error

TASK_FAILED

TASK_FAILED

Error message

Task failed to complete

What it means

handleTaskResults() found the task exists but has no stored result entry and its terminal status is 'failed' (not completed). TASK_FAILED sentinel: the referenced task finished unsuccessfully, so no output payload exists to return; the failure detail lives in the task's own record/logs.

Source

Thrown at v3/mcp/tools/task-tools.ts:856

  }

  // Check if task has results
  const result = taskResults.get(input.taskId);
  if (result) {
    return {
      ...result,
      artifacts: input.includeArtifacts ? result.artifacts : undefined,
    };
  }

  // Task exists but no results yet
  return {
    taskId: input.taskId,
    status: task.status,
    success: task.status === 'completed',
    output: undefined,
    error: task.status === 'failed' ? {
      code: 'TASK_FAILED',
      message: 'Task failed to complete',
    } : undefined,
    completedAt: task.completedAt,
  };
}

// ============================================================================
// Tool Definitions
// ============================================================================

/**
 * tasks/create tool
 */
export const createTaskTool: MCPTool = {
  name: 'tasks/create',
  description: 'Create a new task for execution with specified type, priority, and configuration',
  inputSchema: {
    type: 'object',

View on GitHub (pinned to fa13ee4ad6)

Solutions

1. Inspect the task's underlying error and logs; fix the failing step and retry the task.
2. Add per-step error capture so the failing step's diagnostic is propagated to the caller.

When it happens

Trigger: Thrown at v3/mcp/tools/task-tools.ts:856 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of ruvnet/ruflo@fa13ee4ad6 (2026-08-18). Data as JSON: /api/errors/e13684f452b55b5d. Report an issue: GitHub.