ArtiAgent - DefectFill/src/flux/model.py

from dataclasses import dataclass

import torch
from torch import Tensor, nn
import numpy as np

from flux.modules.layers import (DoubleStreamBlock, EmbedND, LastLayer,
                                 MLPEmbedder, SingleStreamBlock,
                                 timestep_embedding)


@dataclass
class FluxParams:
    in_channels: int
    out_channels: int
    vec_in_dim: int
    context_in_dim: int
    hidden_size: int
    mlp_ratio: float
    num_heads: int
    depth: int
    depth_single_blocks: int
    axes_dim: list[int]
    theta: int
    qkv_bias: bool
    guidance_embed: bool


class Flux(nn.Module):
    """
    Transformer model for flow matching on sequences.
    """

    def __init__(self, params: FluxParams):
        super().__init__()

        self.params = params
        self.in_channels = params.in_channels
        self.out_channels = params.out_channels
        if params.hidden_size % params.num_heads != 0:
            raise ValueError(
                f"Hidden size {params.hidden_size} must be divisible by num_heads {params.num_heads}"
            )
        pe_dim = params.hidden_size // params.num_heads
        if sum(params.axes_dim) != pe_dim:
            raise ValueError(f"Got {params.axes_dim} but expected positional dim {pe_dim}")
        self.hidden_size = params.hidden_size
        self.num_heads = params.num_heads
        self.pe_embedder = EmbedND(dim=pe_dim, theta=params.theta, axes_dim=params.axes_dim)
        self.img_in = nn.Linear(self.in_channels, self.hidden_size, bias=True)
        self.time_in = MLPEmbedder(in_dim=256, hidden_dim=self.hidden_size)
        self.vector_in = MLPEmbedder(params.vec_in_dim, self.hidden_size)
        self.guidance_in = (
            MLPEmbedder(in_dim=256, hidden_dim=self.hidden_size) if params.guidance_embed else nn.Identity()
        )
        self.txt_in = nn.Linear(params.context_in_dim, self.hidden_size)

        self.double_blocks = nn.ModuleList(
            [
                DoubleStreamBlock(
                    self.hidden_size,
                    self.num_heads,
                    mlp_ratio=params.mlp_ratio,
                    qkv_bias=params.qkv_bias,
                )
                for _ in range(params.depth)
            ]
        )

        self.single_blocks = nn.ModuleList(
            [
                SingleStreamBlock(self.hidden_size, self.num_heads, mlp_ratio=params.mlp_ratio)
                for _ in range(params.depth_single_blocks)
            ]
        )

        self.final_layer = LastLayer(self.hidden_size, 1, self.out_channels)
        self._sequential_offload = False

    def enable_sequential_cpu_offload(self):
        self._sequential_offload = True

    def forward(
        self,
        img: Tensor,
        img_ids: Tensor,
        txt: Tensor,
        txt_ids: Tensor,
        timesteps: Tensor,
        y: Tensor,
        guidance: Tensor | None = None,
        info = None,
        ref_img: Tensor | None = None,        # ← NEW
        ref_img_ids: Tensor | None = None,    # ← NEW
    ) -> Tensor:
        if img.ndim != 3 or txt.ndim != 3:
            raise ValueError("Input img and txt tensors must have 3 dimensions.")

        # Ensure inputs match the model's dtype (NF4 can silently upcast to float32)
        target_dtype = self.img_in.weight.dtype
        img = img.to(target_dtype)
        txt = txt.to(target_dtype)
        if y.dtype != target_dtype:
            y = y.to(target_dtype)

        # running on sequences img
        img = self.img_in(img)
        original_img_seq_len = img.shape[1]   # ← REMEMBER: how many original img tokens

        vec = self.time_in(timestep_embedding(timesteps, 256))
        if self.params.guidance_embed:
            if guidance is None:
                raise ValueError("Didn't get guidance strength for guidance distilled model.")
            vec = vec + self.guidance_in(timestep_embedding(guidance, 256))
        vec = vec + self.vector_in(y)
        txt = self.txt_in(txt)

        # ═══════════════════════════════════════════════════════
        # NEW: Concatenate reference tokens into image stream
        # ═══════════════════════════════════════════════════════
        if ref_img is not None and ref_img_ids is not None:
            ref = self.img_in(ref_img)        # project reference patches same way
            img = torch.cat([img, ref], dim=1)
            img_ids = torch.cat([img_ids, ref_img_ids], dim=1)

        if ref_img is not None:
            print(f"[Flux.forward] Attending to {ref_img.shape[1]} ref tokens + {original_img_seq_len} img tokens")
        # ═══════════════════════════════════════════════════════

        ids = torch.cat((txt_ids, img_ids), dim=1)
        pe = self.pe_embedder(ids)
        inject_pe = pe.clone()
        if not info['inverse']:
            # Defensive clamp: GSAM indices may exceed seq_len for non-16-divisible images
            seq_len = pe.shape[2]

            # Initialize accumulated lists for tracking all processed IDs
            accumulated_target_ids = []
            accumulated_ref_ids = []
            for artifact_data in info['artifact_data']:
                if artifact_data['artifact_type'] == 'addition' and info['addition']:
                    ref_ids = artifact_data['reference_patch_indices'].copy()
                    target_ids = artifact_data['target_patch_indices'].copy()
                    ref_ids = [max(0, min(int(i), seq_len - 1)) for i in ref_ids]
                    target_ids = [max(0, min(int(i), seq_len - 1)) for i in target_ids]
                    if len(target_ids) > 0 and len(ref_ids) > 0:
                        inject_pe[:,:,target_ids,:,:,:] = inject_pe[:,:,ref_ids,:,:,:]

                    # Accumulate IDs
                    if info['inject']:
                        accumulated_target_ids.extend(target_ids)
                        accumulated_ref_ids.extend(ref_ids)

                elif artifact_data['artifact_type'] == 'removal' and info['removal']:
                    ref_ids = artifact_data['reference_patch_indices'].copy()
                    target_ids = artifact_data['target_patch_indices'].copy()

                    ref_ids = [max(0, min(int(i), seq_len - 1)) for i in ref_ids]
                    target_ids = [max(0, min(int(i), seq_len - 1)) for i in target_ids]

                    # ref_ids = get_closest_patch_inds(info['patch_h'], info['patch_w'], target_ids, ref_ids)
                    if len(target_ids) > 0 and len(ref_ids) > 0:
                        inject_pe[:,:,target_ids,:,:,:] = inject_pe[:,:,ref_ids,:,:,:]
                    # Accumulate IDs (after target_ids modification)
                    if info['inject']:
                        accumulated_target_ids.extend(target_ids)
                        accumulated_ref_ids.extend(ref_ids)

                elif artifact_data['artifact_type'] == 'distortion' and info['distortion']:
                    ref_ids = artifact_data['reference_patch_indices'].copy()
                    target_ids = artifact_data['target_patch_indices'].copy()
                    ref_ids = [max(0, min(int(i), seq_len - 1)) for i in ref_ids]
                    target_ids = [max(0, min(int(i), seq_len - 1)) for i in target_ids]

                    if len(ref_ids) == 0:
                        # For distortion with no reference patches, shuffle target patches
                        ref_ids = target_ids.copy()
                        np.random.shuffle(ref_ids)
                    # Ensure target_ids and ref_ids are different for distortion
                    if len(target_ids) > 0 and len(ref_ids) > 0:
                        inject_pe[:,:,target_ids,:,:,:] = inject_pe[:,:,ref_ids,:,:,:]
                    # Accumulate IDs (after any ref_ids modification)
                    if info['inject']:
                        accumulated_target_ids.extend(target_ids)
                        accumulated_ref_ids.extend(ref_ids)

                elif artifact_data['artifact_type'] == 'fusion' and info['fusion']:
                    ref_ids = artifact_data['reference_patch_indices'].copy()
                    target_ids = artifact_data['target_patch_indices'].copy()
                    ref_ids = [max(0, min(int(i), seq_len - 1)) for i in ref_ids]
                    target_ids = [max(0, min(int(i), seq_len - 1)) for i in target_ids]

                    # np.random.shuffle(ref_ids)
                    if len(target_ids) > 0 and len(ref_ids) > 0:
                        inject_pe[:,:,target_ids,:,:,:] = inject_pe[:,:,ref_ids,:,:,:]
                        
                    # Accumulate IDs
                    if info['inject']:
                        accumulated_target_ids.extend(target_ids)
                        accumulated_ref_ids.extend(ref_ids)

            info['patch_ids'] = accumulated_target_ids
            info['patch_ref_ids'] = accumulated_ref_ids 
        info['timesteps'] = timesteps


        if self._sequential_offload:
            for block in self.double_blocks:
                block = block.to(img.device)
                img, txt = block(img=img, txt=txt, vec=vec, pe=inject_pe, info=info)
                block = block.cpu()
                torch.cuda.empty_cache()
        else:
            for block in self.double_blocks:
                img, txt = block(img=img, txt=txt, vec=vec, pe=inject_pe, info=info)

        cnt = 0
        img = torch.cat((txt, img), 1) 
        info['type'] = 'single'
        if self._sequential_offload:
            for block in self.single_blocks:
                block = block.to(img.device)
                info['id'] = cnt
                if cnt < 19:
                    img, info = block(img, vec=vec, pe=inject_pe, info=info)
                else:
                    img, info = block(img, vec=vec, pe=pe, info=info)
                block = block.cpu()
                torch.cuda.empty_cache()
                cnt += 1
        else:
            for block in self.single_blocks:
                info['id'] = cnt
                if cnt < 19:
                    img, info = block(img, vec=vec, pe=inject_pe, info=info)
                else:
                    img, info = block(img, vec=vec, pe=pe, info=info)
                cnt += 1
            

        # ═══════════════════════════════════════════════════════
        # MODIFIED: Extract only ORIGINAL img tokens
        # Before: img = img[:, txt.shape[1] :, ...]  (gets img + ref)
        # After:  img = img[:, txt.shape[1] : txt.shape[1] + original_img_seq_len, ...]
        # ═══════════════════════════════════════════════════════
        img = img[:, txt.shape[1] : txt.shape[1] + original_img_seq_len, ...]

        img = self.final_layer(img, vec)  # (N, T, patch_size ** 2 * out_channels)
        return img, info