sequenceDiagram
    participant WB as WorkflowBlock
    participant SBR as SubBlockRow
    participant UDN as useDisplayName
    participant UCD as useCredentialDisplay
    participant DNS as DisplayNamesStore
    participant API as API Endpoints
    participant SEL as Selector Components

    Note over WB,SEL: Initial Render Flow
    WB->>SBR: Render with subBlock config + rawValue
    SBR->>UCD: Check credential display (if oauth-input)
    UCD->>DNS: Get cached credential name
    alt Cache Miss
        UCD->>API: GET /api/auth/oauth/credentials
        API-->>UCD: Return credentials list
        UCD->>DNS: setDisplayNames('credentials', provider, map)
    end
    DNS-->>UCD: Return display name
    
    SBR->>UDN: Check generic display name (if other selector)
    UDN->>DNS: Get cached display name by type + context
    alt Cache Miss
        alt Channel Selector
            UDN->>API: POST /api/tools/slack/channels
        else File Selector
            UDN->>API: Provider-specific file endpoint
        else Folder Selector
            UDN->>API: Gmail/Outlook folders endpoint
        else Project Selector
            UDN->>API: Jira/Linear projects endpoint
        else Document Selector
            UDN->>API: GET /api/knowledge/{id}/documents
        end
        API-->>UDN: Return items list
        UDN->>DNS: setDisplayNames(type, context, map)
    end
    DNS-->>UDN: Return display name
    UDN-->>SBR: Return resolved name
    SBR-->>WB: Display hydrated name

    Note over SEL,DNS: Selector Component Flow
    SEL->>API: Fetch items (on open/load)
    API-->>SEL: Return items with id + name
    SEL->>DNS: setDisplayNames(type, context, itemMap)
    Note over DNS: Cache persists across renders
    SEL->>SEL: Use cached display name for preview