ruvnet/ruflo · error · Error

Workflow ${workflowId} not found

Error message

Workflow ${workflowId} not found

What it means

getWorkflowState() looked up workflowId in the in-memory workflows map and found no entry. The workflow was never started in this engine instance, already completed and removed, or the id is wrong — there is no execution record to report state for.

Source

Thrown at v3/src/task-execution/application/WorkflowEngine.ts:225

  async resumeWorkflow(workflowId: string): Promise<void> {
    const execution = this.workflows.get(workflowId);
    if (execution && execution.state.status === 'paused') {
      execution.state.status = 'in-progress';
      execution.eventLog.push({
        timestamp: Date.now(),
        event: 'workflow:resumed',
        data: { workflowId }
      });
    }
  }

  /**
   * Get workflow state
   */
  async getWorkflowState(workflowId: string): Promise<WorkflowState> {
    const execution = this.workflows.get(workflowId);
    if (!execution) {
      throw new Error(`Workflow ${workflowId} not found`);
    }
    return execution.state;
  }

  /**
   * Execute tasks in parallel
   */
  async executeParallel(tasks: ITask[]): Promise<TaskResult[]> {
    return this.coordinator.executeTasksConcurrently(tasks);
  }

  /**
   * Execute a distributed workflow
   */
  async executeDistributedWorkflow(
    workflow: WorkflowDefinition,
    coordinators: SwarmCoordinator[]
  ): Promise<WorkflowResult> {

View on GitHub (pinned to fa13ee4ad6)

Solutions

1. Verify the referenced identifier exists before use (list available items and match against user input).
2. Return a clear 404-style error listing valid identifiers, and have the caller retry with an existing id.

When it happens

Trigger: Thrown at v3/src/task-execution/application/WorkflowEngine.ts:225 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/9922cd10a7a21fe4. Report an issue: GitHub.