sequenceDiagram
    participant User
    participant NextRequest as "/api/workflows/[id]/execute"
    participant Auth as "checkHybridAuth"
    participant PreProcess as "preprocessExecution"
    participant WorkflowLoader as "loadDeployedWorkflowState"
    participant EnvUtils as "getPersonalAndWorkspaceEnv"
    participant FileProcessor as "processInputFileFields"
    participant ExecutionCore as "executeWorkflowCore"
    participant LoggingSession as "LoggingSession"
    participant PauseManager as "PauseResumeManager"
    participant AsyncTasks as "tasks.trigger"

    User->>NextRequest: "POST /api/workflows/[id]/execute"
    NextRequest->>Auth: "checkHybridAuth(req)"
    Auth-->>NextRequest: "{ success: true, userId, authType }"
    
    NextRequest->>PreProcess: "preprocessExecution({ workflowId, userId, triggerType })"
    PreProcess-->>NextRequest: "{ success: true, actorUserId, workflowRecord }"
    
    alt isAsyncMode
        NextRequest->>AsyncTasks: "tasks.trigger('workflow-execution', payload)"
        AsyncTasks-->>NextRequest: "{ jobId, statusUrl }"
        NextRequest-->>User: "202 Accepted { async: true, jobId }"
    else Synchronous/SSE Execution
        NextRequest->>WorkflowLoader: "loadDeployedWorkflowState(workflowId)"
        WorkflowLoader-->>NextRequest: "{ blocks, edges, loops, parallels }"
        
        NextRequest->>EnvUtils: "getPersonalAndWorkspaceEnv(userId, workspaceId)"
        EnvUtils-->>NextRequest: "{ personalEncrypted, workspaceEncrypted }"
        
        NextRequest->>FileProcessor: "processInputFileFields(input, blocks, context)"
        FileProcessor-->>NextRequest: "processedInput"
        
        NextRequest->>LoggingSession: "new LoggingSession(workflowId, executionId, triggerType)"
        LoggingSession-->>NextRequest: "loggingSession"
        
        NextRequest->>ExecutionCore: "executeWorkflowCore({ snapshot, callbacks, loggingSession })"
        ExecutionCore->>LoggingSession: "safeStart({ userId, workspaceId, variables })"
        ExecutionCore->>ExecutionCore: "Execute workflow blocks"
        
        alt Execution Paused
            ExecutionCore->>PauseManager: "persistPauseResult({ workflowId, executionId, pausePoints })"
            PauseManager-->>ExecutionCore: "Pause data persisted"
        else Execution Completed
            ExecutionCore->>PauseManager: "processQueuedResumes(executionId)"
            PauseManager-->>ExecutionCore: "Queued resumes processed"
        end
        
        ExecutionCore->>LoggingSession: "safeComplete({ finalOutput, traceSpans })"
        ExecutionCore-->>NextRequest: "ExecutionResult"
        
        alt enableSSE
            NextRequest-->>User: "SSE Stream with execution events"
        else Direct JSON Response
            NextRequest-->>User: "200 JSON { success, output, metadata }"
        end
    end