sequenceDiagram
    participant User
    participant UI as Folder/Workflow Item
    participant Hook as useDuplicate Hook
    participant Store as Folder/Workflow Store
    participant API as Duplicate API
    participant Helper as duplicateWorkflow Helper
    participant DB as Database

    User->>UI: Right-click & select "Duplicate"
    UI->>Hook: handleDuplicate()
    Hook->>Hook: Check isDuplicating state
    Hook->>Store: duplicateFolder/Workflow(id)
    
    alt Folder Duplication
        Store->>API: POST /api/folders/{id}/duplicate
        API->>DB: Check permissions & get source folder
        API->>DB: BEGIN TRANSACTION
        API->>DB: Create root folder with new ID
        API->>API: duplicateFolderStructure (recursive)
        loop For each child folder
            API->>DB: Create child folder
            API->>API: Recurse for nested children
        end
        DB-->>API: COMMIT (folder structure complete)
        
        API->>API: duplicateWorkflowsInFolderTree
        loop For each folder in mapping
            API->>DB: Get workflows in folder
            loop For each workflow
                API->>Helper: duplicateWorkflow()
                Helper->>DB: BEGIN TRANSACTION
                Helper->>DB: Create workflow with new ID
                Helper->>DB: Copy blocks (remap IDs & parentIds)
                Helper->>DB: Copy edges (remap block references)
                Helper->>DB: Copy subflows (remap IDs & node refs)
                DB-->>Helper: COMMIT
                Helper-->>API: Return new workflow ID
            end
        end
        API-->>Store: Return folder stats
    else Workflow Duplication
        Store->>API: POST /api/workflows/{id}/duplicate
        API->>Helper: duplicateWorkflow()
        Helper->>DB: Check permissions & get source
        Helper->>DB: BEGIN TRANSACTION
        Helper->>DB: Create workflow with new ID
        Helper->>DB: Copy blocks (remap IDs)
        Helper->>DB: Copy edges (remap references)
        Helper->>DB: Copy subflows (remap IDs)
        DB-->>Helper: COMMIT
        Helper-->>API: Return new workflow
        API-->>Store: Return workflow metadata
    end
    
    Store->>Store: Refresh folders/workflows
    Store-->>Hook: Return new ID(s)
    Hook->>Store: clearSelection()
    
    alt Single Workflow Duplication
        Hook->>UI: Navigate to new workflow
    end
    
    Hook-->>UI: Complete
    UI-->>User: Show duplicated item