flowchart TB
    subgraph install["1 · Install lambda instrumentation"]
        direction TB
        A["Collect enabled <code>Instrumenter.ForLambda</code> implementations"]:::tracer
        B["<code>AgentBuilder</code> builds the decorated <code>ClassFileTransformer</code>"]:::third
        C["<code>onBeforeInstall</code> publishes the transformer to <code>LambdaTransformerHolder</code>"]:::tracer
        D["Register the transformer and retransform loaded <code>InnerClassLambdaMetafactory</code>"]:::jdk
        E["Inject a pre-definition call to <code>LambdaTransformerHelper.transform(...)</code> into <code>InnerClassLambdaMetafactory</code>"]:::tracer
        A --> B --> C --> D --> E
    end
    subgraph generate["2 · Prepare the lambda implementation (linkage) and invoke the lambda"]
        direction TB
        F["Application or library first executes an unlinked lambda <code>invokedynamic</code> call site"]:::third
        G["<code>InnerClassLambdaMetafactory</code> generates the lambda implementation bytes"]:::jdk
        H{"Can the agent transform this lambda?"}:::tracer
        O["Return the original generated bytes"]:::tracer
        F --> G --> H
        H -->|no| O

        subgraph transform["Transform before definition"]
            direction TB
            I["Call the Byte Buddy transformer with the declaring class's module, loader and protection domain"]:::tracer
            J["Byte Buddy runs Datadog's matching and transformation pipeline"]:::third
            K["Select <code>ForLambda</code> transformations by exact interface, lambda matcher, class-loader matcher and muzzle compatibility"]:::tracer
            L["Apply advice, inject helpers and add eligible context fields"]:::tracer
            M["Run cleanup: <code>SharedTypePools.endTransform(...)</code> releases owned type-pool state, then clear per-thread lambda markers"]:::tracer
            I --> J --> K --> L --> M
            J -. no change or failure .-> M
        end

        N["<code>InnerClassLambdaMetafactory</code> defines the lambda class from the returned bytes"]:::jdk
        P["Application invokes the lambda; injected behavior runs if a <code>ForLambda</code> transformation matched"]:::third
        H -->|yes| I
        M -->|transformed or original bytes| N
        O --> N
        N --> P
    end
    %% Connect groups to preserve their top-to-bottom direction within the left-to-right layout.
    install -. transformer published and generation hook installed .-> generate
    style install fill:#f3e8ff,stroke:#9333ea,stroke-width:2px,color:#581c87
    style generate fill:#ecfeff,stroke:#0891b2,stroke-width:2px,color:#164e63
    style transform fill:#fff1f2,stroke:#e11d48,stroke-width:2px,color:#881337
    classDef jdk fill:#dbeafe,stroke:#2563eb,color:#172554
    classDef tracer fill:#dcfce7,stroke:#16a34a,color:#14532d
    classDef third fill:#ffedd5,stroke:#ea580c,color:#7c2d12