OjdZddlmZddlZddlZddlZddlmZddl m Z ddl m Z m Z mZmZmZddlmZej&eZdZGd d eZed Gd dZ ddZeGddZddZddZ ddZddZ d d!dZ ddddd d"dZ! d#dZ" d$ d%dZ#y)&u(T2I 프롬프트 최종 조립 서비스 — Phase 3b.1. 기존 `image_service._build_final_scene_prompt` 211줄을 4단계 함수로 분리. 단계: 1. `resolve_ref_roles` — labeled_refs → ref_roles + ref_instructions 2. `replace_entity_ids` — t2i_prompt 내 C##/C##O##/P##/L## ID를 참조 이미지 번호 또는 entity 텍스트로 치환 3. `translate_if_korean` — 한국어 잔재 있으면 LLM 번역 4. `build_scene_text` — 최종 조립 공개 진입점: `build_final_scene_prompt` (기존 함수 계약과 동일한 시그니처). ) annotationsN) dataclass)Path)AnyDictListOptionalTuple)settings)outfit_ref_explicitprevious_shot_same_frame_zoomedprevious_shot_same_roomprevious_shot_continuitybackground_chain_ref character_refcharacter_state_refoutfit_ref_inlineprop_refbackground_generalgrounding_part_detail_refgrounding_context_detail_reffallbackcomposition_guideimmobilized_pose_guideindoor_pose_guideoutdoor_canon_photo_refoutdoor_canon_map_refceZdZdZy) RefRoleErroruKLabeledRefPayload invariant 위반 — fail-fast (No Silent Fallback gate).N)__name__ __module__ __qualname____doc__Q/Users/manta/Documents/Projects/TheRoad-I1/backend/app/services/prompt_service.pyrrHsUr%rT)frozenc:eZdZUdZded<ded<ded<ded <y ) LabeledRefPayloaduArea #11 v1 — producer-side structured payload for reference image dispatch. Invariants (fail-fast via make_labeled_ref_payload factory): - len(labeled_refs) == len(ref_roles) == len(ref_role_metadata) == len(attached_meta) - 각 ref_roles entry ∈ REF_ROLE_VALUES (else RefRoleError) - 각 ref_role_metadata entry 는 dict - 모든 4 collection 은 list (factory top-level isinstance gate) W1 = container + factory + REF_ROLE_VALUES + RefRoleError 신설. Production 진입은 W2 atomic switch. List[Tuple[str, Any]] labeled_refs List[str] ref_rolesList[Dict[str, Any]]ref_role_metadataList[Tuple[str, str]] attached_metaN)r r!r"r#__annotations__r$r%r&r)r)Ls! ('++((r%r)c t|ts"tdt|jdt|ts"tdt|jdt|ts"tdt|jdt|ts"tdt|jdt |}t ||k7rtdt |d|t ||k7rtdt |d|t ||k7rtd t |d|t |D]&\}}|tvstd |d |d td t |D]:\}}t|trtd|dt|jdtt|t|t|t|S)uFactory — fail-fast on invariant violation (No Silent Fallback gate). 9 fail-fast paths: - 4 non-list isinstance: labeled_refs / ref_roles / ref_role_metadata / attached_meta - 3 length mismatch: ref_roles / ref_role_metadata / attached_meta vs labeled_refs - 1 invalid enum value: ref_roles entry not in REF_ROLE_VALUES - 1 non-dict metadata entry: ref_role_metadata entry not dict zlabeled_refs is z , not listz ref_roles is zref_role_metadata is zattached_meta is zref_roles length z != labeled_refs length zref_role_metadata length zattached_meta length z ref_roles[z]=z" not in REF_ROLE_VALUES (allowed: )ref_role_metadata[z] is z , not dict)r+r-r/r1) isinstancelistrtyper len enumerateREF_ROLE_VALUESdictr))r+r-r/r1nirolems r&make_labeled_ref_payloadrA`s  lD )-d<.@.I.I-J*UVV i &]4 ?+C+C*DJOPP ' .248I3J3S3S2TT^_`` mT *.tM/B/K/K.LJWXX LA 9~.s9~.>>VWXVYZ[[ "',=(>'??WXYWZ [   =Q23}3E2FF^_`^abccY'4  &QCr$*,-Q0 (+,1!T"!3A3eDGs r&_back_to_camera_instructionrRs$ 1#334# 6# $r%c8d|d}d|dd|dd|dg}||fS) u W21B-W8 재배선 v2 — 같은 장소·순간 인접 샷의 '완성 프레임' 을 연속성 anchor 로 사용(마네킹 스케치 대신). 장소·조명·인물 외형 + broad staging/figure placement 의 연속성은 이 프레임에서, 이 샷의 카메라/프레이밍/POV/crop/액션은 본문 SOT (충돌 시 본문 우선 — 예: 같은 그룹 샷이 '엿보는 POV' 등 고유 프레이밍을 가질 때 그 프레이밍 보존). 인접 샷끼리 '같은 연속된 순간' 으로 읽히게 한다.Reference image ue: SAME-PLACE COMPLETED FRAME from an adjacent shot at the same moment — visual continuity referencez0- keep this shot visually continuous with image z: the same location, environment, architecture, materials, lighting, weather and time of day, and the same people's appearance, build and clothingz- match image u 's broad staging — where each figure stands across the space and their relative scale — so the adjacent shots read as one continuous moment; this is the one exception to the 'do not copy compositions' rule below, limited to continuity of place and figure placementu- follow the prompt text for THIS shot's specific camera position, framing, point of view, crop and action — where the prompt text and image z5 differ on framing or viewpoint, the prompt text winsr$)r> role_text instructionss r&_continuity_anchor_refrWsi 1#= > ;1#>D E    H J L l ""r%chd|d}|r d|d|d}n d|d|d|d}d |d |d |d d |g}||fS)u?A5 (2026-07-02) — immobilized 그룹 env 멤버의 '완성 프레임' 연속성 ref. 부동(dead/unconscious/severely_injured) 인물은 샷 사이에 움직일 수 없으므로 이 프레임이 그 인물의 포즈/접촉점/지지면 + 방 상태·소품의 연속성 SOT. 단 등록 pose 가이드가 함께 붙으면 자세/접촉/지지면의 1차 SOT 는 가이드 (P8 I-1 역할 분리) — 이 프레임은 same-configuration 확인 + 환경/소품 연속성. 프레이밍/카메라/crop 은 본문 프롬프트 SOT. 시나리오 토큰 0. rTug: COMPLETED EARLIER FRAME from this same scene — state continuity reference for an immobilized figureze- any figure in an immobilized state (dead, unconscious, severely injured) has NOT moved since image z. Take its body pose, contact points and the surface it rests on from the attached pose guide (the source of truth for this figure's pose and contact); image z< shows the same configuration for environment and continuityzY: reproduce its exact body pose, contact points and the surface supporting it from image u] — if the prompt text implies a different body position for this immobilized figure, image  winsz!- keep the room state from image z^: the same architecture, furniture, materials, lighting, and the same props in the same placesup- follow the prompt text for THIS shot's camera position, framing, point of view and crop — do NOT copy image z's composition4- do NOT copy any standing/moving people from image r$)r>pose_guide_presentrU _pose_linerVs r&_immobilized_prev_frame_refr]s 1#? @2235OOPcRJ K 2235MMNCP))*5  2  ,A3/E F 889s. J >qcB L l ""r%c &g}g}d|jv}td|jD}t|jdD]\}\}}|j|dz }|j|dz } |dk(r| j d} t | tr.t| dk7s t| dxsdjstd|dz d | d |d t| dj} |jd |d | |jd| d|d|dk(r^|jd |d||jd|d| j ddk(s-|jt|I|dk(r(|jd |dt| j d} | r d|d|d} n d|d|d} |jd|d| dd |g| r|r|jd!|d"n| r|jd#|d$|d%|d&| j d'gxsgD]I}t |t r|j d(dn t|}|s3|jd#|d)|K| j d*d}|s^|jd#|d+|w|d,k(r| j d-r2t#||\}}|j||j|n| j d.r1t%|\}}|j||j|nt| j d/r4|jd |d0|jd1|d2|d3d4|gn/|jd |d5|jd6|d7d4|g| j d'gxsgD]I}t |t r|j d(dn t|}|s3|jd#|d)|K| j d*d}|s|jd#|d+||d8k(r| j d-r3t#||\}}|j||j|Q| j d.r2t%|\}}|j||j|| j d9r7|jd |d:|jd;|d<d=d>|d?d@|g|jd |dA|jdB|dC|dD|g|dEk(r<|jd |dF|jd|dGdH|dIdJ|dK|dLdMgQ|dNk(r^|jd |d||jd|dO| j ddk(s|jt||dPk(r\| j dQd}|jd |d||r|jd|dR|dS|jd|dT|dUk(r-|jd |d||jdV|G|dWk(r+|jd |dX|jdY|w|dZk(r,|jd |d[|jd\|d]|d^k(r,|jd |d_|jd`|da|dbk(r@|jd |dc|rdd|dendd|df}|j|dg|dhdJ|g|dik(r2|jd |dj|jd|dkdl|dmgU|dnk(r<|jd |do|jdp|dqdr|dsdd|dtdu|dvg|dk(rt| j dwxsd}t| j dxxsdjj'}|dyk(rdznd}|jd |d{|jdd|d||d&d}|d~d|rd|dndzdzdd|dgE|dk(r3|jd |d|jdd|dddd|dg}|jd |d||jd|d||jgdt)||S)uArea #11 v1 W2 — `payload.ref_roles` enum dispatch only. `_classify_label` substring branch 폐기 (production dispatch path). consumer 는 producer 가 emit 한 11-enum sidecar 만 read (No Silent Fallback gate). spec §3.3 / plan Task 2.5. rc3bK|]'}t|txr|jd)yw)outdoor_direct_place_continuityN)r6r<get).0mds r& z$resolve_ref_roles..!s1$+B 2tJ(I!JJ+s-/r subject_final_idsrr5zM] of outfit_ref_explicit must carry exactly one subject_final_ids entry (got u/) — the prompt cannot say whose outfit image z isrTz*: standalone outfit/costume reference for z- dress z in the outfit shown in image uO; this image is the outfit only — do not take face, body, or identity from itrz: z - use image uh as character appearance reference — match the person's identity and outfit where visible in the sceneview_angle_constraintback_to_camerar uF: PREVIOUS SHOT (SAME MOMENT, zoomed-in reframing) — continuity baseimmobilized_subjectsz@- keep the environment, lighting, and spatial layout from image zw; render the poses of any standing or moving subject as described in the prompt text (for a true zoom they match image r4zh; render the subjects and their poses as described in the prompt text (for a true zoom they match image ul as the continuity base for a zoomed-in reframing — same moment, same environment, the camera moved closerz- do NOT duplicate body partszx- render the focused region (hand, wrist, face area, object, etc.) enlarged, consistent with the frame context of image a1- the immobilized figure (dead, unconscious, severely injured) has NOT moved between these two shots. Take its body pose, the visible limb (hand, wrist, arm), the surface it rests on, and its hand-object contact from the attached pose guide (the source of truth for this figure's pose and contact); image u shows the same configuration for environment and continuity. The crop and framing may change (this is a closer insert), but reproduce that one pose and contact exactly — do not let the prompt wording move the immobilized figurez - from image z: any figure in an immobilized state (dead, unconscious, severely injured) has NOT moved between these two shots. Lock to image u: its body and the visible limb (hand, wrist, arm), their exact position and orientation, the surface the figure/limb rests on, and how the hand contacts any held object — reproduce them precisely. The crop and framing may change (this is a closer insert), but if the prompt text implies a different body position, resting/support surface, or hand-object contact for this immobilized figure, image rY keep_elementslabelz: keep ignorez : ignore rimmobilized_prev_frame_anchorcomposition_continuity_anchorcomposition_relaxeduK: BACKGROUND from a previous shot (SAME PLACE) — place identity referencezd- keep this location's materials, architecture, furniture identity, lighting and weather from image z:- do NOT copy the camera position or composition of image uJ — the composition sketch and the prompt text define this shot's framingrZu;: BACKGROUND from a previous shot (SAME ROOM) — use as-iszG- use the background, furniture layout, walls, and lighting from image z as-isrr`u[: PREVIOUS STILL at the same property — continuity source for stable visible details onlyz!- where this shot overlaps image z~'s view, keep the same stable visible details (openings, fixed fittings, lettering, local object placement) consistent with itzs- the attached LOCATION PHOTOGRAPH/SITE PLAN stay the primary source for the property's overall identity and layoutz1- do NOT copy lighting or time of day from image u3 — the shot text is the sole time/lighting sourcezC- do NOT copy characters, people, poses, or composition from image zB: BACKGROUND/ENVIRONMENT from a previous shot at the same locationzH- use ONLY the lighting, color palette, and environment mood from image zB- do NOT copy characters, people, or their appearances from image z<- do NOT copy the composition or character poses from image ruU: pre-rendered BACKGROUND environment reference — layout/material/lighting identityzX for this location's wall/floor/ceiling materials, furniture identity, and lighting moodu- follow the camera position, framing, and action requested in the prompt text — do NOT copy the camera position or composition of image z) unless the prompt explicitly asks for itz$- do NOT copy any people from image zG- architectural openings (doors, windows, thresholds) must match image u — same position, type, and material; do NOT invent additional doors or windows unless the prompt text explicitly asks for themu3- if the prompt text places the camera inside or at one of these openings, camera-side walls and door/window frames may appear only as local foreground edges — do NOT show the same opening again in the scene, and do NOT show the exterior facade of the structure that contains the camera out in front of itru] as character appearance reference — match the person's identity where visible in the scenerstatez as state-variant reference (uA) — match the character's body language for this specific stateu[ as state-variant reference — match the character's body language for this specific staterz$- include the object shown in image rz#: background/environment reference.zB- use the lighting, architecture, and environment mood from image ru?: FIXED PART OF THE PLACE — how this component itself is madez)- reproduce the component shown in image uu — its shape, proportions, materials and markings; take its form only, not the photograph's framing or surroundingsruK: THE PLACE AND ITS FIXED PART — the setting, and the component within itz9- take the place's architecture and materials from image uc, and reproduce the component within it — form only, not the photograph's framing or surroundingsruH: LOCATION PHOTOGRAPH — the real filming property this shot happens atrQz is the PRIMARY source of how this place looks (building, materials, aging, colours, surroundings); the previous-still reference refines stable visible details in overlapping areasz^ is the SOLE source of how this place looks: building, materials, aging, colours, surroundingsz- do NOT copy image ud's camera angle, composition, time of day or lighting — the prompt text defines this shot's momentru?: SITE-PLAN DRAWING of the same property — layout source onlyzS ONLY to understand where things are on the property (positions, adjacency, routes)z- NEVER draw image zB itself or its colours, circles, markers or labels into the outputru: POSE + COMPOSITION STORYBOARD SKETCH of THIS exact shot — figures drawn as featureless artist's mannequins (framing + pose guide only)z*- match this frame's composition to image u: the same figure screen positions, relative sizes and depth, and the same receding path / vanishing perspective — this sketch is the one exception to the 'do not copy compositions' rule belowz- each human figure in image u* is a featureless posed mannequin with a constructed head: reproduce its body pose, stance and head-facing direction exactly, then render it as a real clothed person — identity, face, hair, clothing and skin come from the prompt text and the character reference image(s), never from the mannequinu is only a rough construction sketch: do NOT draw any mannequin, joints, spheres or construction lines in the final image, and do NOT copy its flat tones, line style or any environment surface detail — environment identity comes from the other reference images and the prompt textzu- the final image must be a full-colour PHOTOREALISTIC render under the scene's real lighting: never reproduce image z's monochrome line-art look, pencil/marker strokes, sketch shading, unfinished background or paper texture in ANY part of the frame visible_focus subject_statedeadz (now lifeless)u: POSE / SUPPORT GUIDE for the immobilized figure — a line-art mannequin registered over a faint room (pose / contact / support-surface reference only, NOT identity, appearance or environment)u  fixes the immobilized figure's exact body posture, limb positions, the support surface it rests on, and how its hand contacts any held or adjacent object: reproduce that one pose and contact exactly so the body stays supported on that surface and never floats. This guide is the source of truth for this figure's pose, resting/support surface and hand-object contact — it is the one exception to the 'do not copy poses' rule below, and where the prompt wording implies a different body position or contact for this immobilized figure, image z=- render this figure as ONE real, photorealistic human personu with real skin, hair, fabric clothing and a natural human face and body: its identity, face, hair, clothing and state come from the prompt text and the character reference image(s), and its environment from the background reference — NEVER from this guide. It must NOT look like a wooden mannequin, an articulated dummy, a doll, a statue, a figurine or a 3D render — no wooden or plastic surface, no visible ball joints, no smooth featureless or missing facez- this shot's camera, framing and crop come from the prompt text: if it is a tight insert, show only the visible portion relevant to this shotz (z/ and do NOT force the whole body into the framez is only a rough pose sketch: do NOT draw any mannequin, joints, spheres or construction lines in the final image, and do NOT copy any environment, surface texture or background from itru: POSE + PLACEMENT GUIDE for this shot — line-art mannequins registered over a faint underlay of this room (pose/placement reference only, NOT identity, appearance, style or environment)u fixes each figure's screen position, depth, body posture and facing direction: reproduce that placement and pose for the matching figures — it is an exception to the 'do not copy poses' rule belowz- render those figures as real clothed people: identity, face, hair and clothing come from the prompt text and the character reference image(s), never from the mannequinsu is only a rough registration sketch: do NOT draw any mannequin, joints or construction lines in the final image, and never reproduce its monochrome line-art look, pencil strokes, faint washed-out underlay or paper texture in ANY part of the frame — the final image is a full-colour PHOTOREALISTIC render under the scene's real lighting, and its environment comes from the background reference and the prompt text, not from this guidez- reference image )z9- do not copy poses or compositions from reference imageszL- do not alter character identities where their face is visible in the scenez- each character's clothing/outfit must match that character's appearance reference image EXACTLY; if any clothing wording in the text conflicts with the reference image, follow the reference image and ignore that wordingu{- only render what the scene description asks for — if only a hand or wrist is described, do NOT add the character's face)r-rD)r-anyr/r:r+rar6r7r9rNstriprappendrRboolextendr<r]rWlowerrC)payloadref_roles_textrDr[direct_place_prev_presentr>rl_r?metadata _subjects_sid_has_immobilizedr\elem_label_ignore_rt_ins_state_canon_authority_vf_lifes r&resolve_ref_rolesrs !#N"$2W5F5FF !$$++$!#7#7#7; :E1  Q',,QU3 ( ( ! %89Ii.#i.A2Ey|1r288:"(Q0F m$Cs$%% y|$**,D  ! !"1#&f   # #4& >qcB ( (  ! !$4QCr%"A B  # #qc"TU ||348HH ''(CA(FG 6 6  ! !"1#&12  $HLL1G$HI C Cq"C LLM3aQ  # #qc"IJ/HHIsL % " $6 ''' ()c*) * " ''#A3'667S91235 : ! _b9?R?2315 T%%c* ''-34%%&qc*@A!''AABEPc*+K1#N )%%&qc)de!'']^_]``fgJ1#N)! _b9?R?2215 T%%c* ''-?@ %%&qc*HI!''7s;ABLGsKABYZ[Y\] ) %%&qc)kl!''^_`^abXYZX[\RSTRUV) + +  ! !"1#&45   # #qc"89DF7qc: !)% 6_ $  ! !$4QCr%"A B  # #qc"IJ ||348HH ''(CA(FG * *\\'2.F  ! !$4QCr%"A B ''"1#%B6(KRS !''"1#&RSZ   ! !$4QCr%"A B  # #&J1#$N O ) )  ! !$4QC7Z"[ \  # #&hijhk$l m 0 0  ! !"1#&+,   # #;A3??@  3 3  ! !"1#&78   # #K#?@  . .  ! !"1#&01 - 1#$% 1#DE   # # &qc*QR6qc: %  , ,  ! !"1#&)*   # #qc":;%aS)45%  ( (  ! !"1#&9:   # #( (  ! !"1#&()   # #1#12J1#34% $  ! !$4QCr%"A B  # #&82eW$E Fy <|    >DT UUr%c|xsi}dfd }i}tjd|D]Y}|jd}||vs||}|r d|||<,||vr ||||<9|jdd} | |vsR|| ||<[tjd|D]8}|jd}||vs||}|r d|||<,||vs1||||<:tjd|D]8}|jd}||vs||}|r d|||<,||vs1||||<:tjd |D]%}|jd }||vs||vs||||<'|} tjd d | } t |j d D]\}} | j|| } tjdd| } | S)ut2i_prompt 내 short_id(C##/C##O##/P##/L##)를 참조 이미지 번호 또는 엔티티 텍스트로 치환. - labeled_refs에 해당 ID가 있으면 "the {type} shown in image N" - 없으면 entity_text_map 경유 한글/영어 설명으로 치환 - 대괄호 `[L##: desc]`은 치환 전 내용만 남겨 global replace 간섭 방지 표현 주의 (Area #5 v1, 2026-05-18): numbered image wording (e.g. "the character shown in image N") is preserved for reference mapping. phantom validation is handled by structured `reference_phrase_kinds` sidecar (scene_detail v26 producer + ref_contract_validator step 6), not prompt-prose regex. legacy "from Reference image N" 표현은 의미 동등 표현 "shown in image N" 으로 치환. cDtdD]\}\}}||vs|cSy)Nre)r:)sididxrlr~r+s r& _get_ref_numz(replace_entity_ids.._get_ref_num s-(q9OC%e|  :r%zC\d{2,3}O\d{2,3}rzthe character shown in image Oz(?z$replace_entity_ids..@sS1YJr%)keyz,?\s*in O\d{2,3}\brg)rrNrMz Optional[int])refinditergroupsplitsubsorteditemsreplace) t2i_promptr+entity_text_map_etmr id_to_refmatchrref_nchar_sidcleaned replacements ` r&replace_entity_idsrs$  bD !#I0*=kk!n i  %E#@!H #$;%)#YIcN"yy~a0H4')-h #> :JGkk!n i  %E#@!H #!%c #H2J?kk!n i  %E#=eW!E #!%c #@CZPkk!n i C4K!#YIcNQ Gff0%AG#9??#4:NO[//#{3Pff*B8G Nr%) scene_indexproject_configtracerlabeled_refs_countctjd|s|Sddlm}ddlm}  | dd||||} d } tj} |d d | |d }ttj| z dz}t|trT|j!rD|j!}d} |r0|j#d t$j&| d ddz|d|d|i|| s0tjd|rtjd||d d|S#t ttf$r"} tjd| |cYd } ~ Sd } ~ wwxYw#t($r } tj+d| Yd } ~ d } ~ wwxYw)u한국어가 남아있으면 LLM으로 영어 번역. 실패 시 원본 유지. 프롬프트 템플릿은 `prompts/_base/scene_image/{version}/translate_prompt.md`에서 읽음. 번역 후에도 한국어 잔재가 있으면 error 로그 (안전 필터 위험). u [가-힣]r) call_text) load_prompt scene_imagetranslate_prompt)r|rD style_contextruPtranslate_prompt unavailable for scene_image module — skipping translation: %sNFprompt_translationu5T2I 프롬프트 번역 전문가. 한국어를 영어로 변환하세요. 'the character/object shown in image N' 표현은 정확히 보존하세요. 원문에 없던 reference attribution 표현을 새로 추가하지 마세요 (producer 가 declare 한 reference_phrase_kinds sidecar 와 mismatch 차단).g?)step system_prompt user_promptr temperatureiTiz...)translation_prompt ref_countr)stagemodel input_data output_datar elapsed_mszPrompt translation failed: %szqPrompt translation failed and Korean text remains in prompt (scene=%s). Gemini may trigger safety filter. Raw: %si,)rsearchapp.modules.llm.llm_clientrapp.modules.prompt_loaderrFileNotFoundError RuntimeErrorKeyErrorloggererror_timetimeintr6rNrvlogr gemini_flash_model Exceptionwarning)rr|ref_instructions_textrrrrrrrrexc translated_t0result_elapseds r&translate_if_koreanrMs 99\7 +45(  )2'  "J$=jjl%a +)   s*d23 fc "v||~llnGJ . #55.@#.F.N%7 !(+[9'& "))L':  D  DSM  No |X 6  '(+  Z =6<<=s5DB(E E 'E>E E  E5E00E5cVd|d|jddjd|dS)u 최종 조립: ref_roles + 씬 본문 + 지시 + CRITICAL 주의. 단일 프레임 계약 (2026-07-02): 하나의 t2i = 한 순간·한 프레임 (CLAUDE.md 단일 스틸컷 원칙)의 렌더측 강제 — 매체 형식 계약이라 시나리오 무관. z!Photorealistic cinematic still. z zPhotorealistic cinematic still.rgz Generate one image: u` - CRITICAL: Only render what the scene description explicitly describes. If a character's face is visible in the scene, match it to the reference. If only a body part is shown, do NOT add the face. - CRITICAL: Output exactly ONE single continuous photograph of ONE moment — never a panel grid, collage, contact sheet, split-screen, storyboard sheet, or multiple sub-frames inside one image. - CRITICAL: Every person must be physically grounded and weight-bearing — in real contact with a supporting surface, with body weight visibly carried by that contact. For a figure caught mid-action (falling, stumbling, collapsing, jumping off something), render a physically plausible instant: joints bent, weight clearly transferring, at least one believable point of contact or support — never a rigid body hovering, tilted or suspended in mid-air without support.)rrvr|rrs r&build_scene_textrsE .  $ ??>#%w334 G %00,>> E  Z9M9MuU Lr%) r+r*r-r,r/r.r1r0rMr))r>rrMrN)r>rrMTuple[str, List[str]])r>rr[rxrMr)r{r)rMrC)N)rrNr+r*rOptional[Dict[str, str]]rMrN)rrNr|rNrrNrrNrrrOptional[Dict]rrrrrMrN)r|rNrrNrrNrMrN)NrNN)rrNr{r)rrNrrrrrrrrrMrN)$r# __future__rloggingrrr dataclassesrpathlibrtypingrrrr r app.core.configr getLoggerr rr;rrr)rArCrRrWr]rrrrrr$r%r&rs # !33$   8 $&RV9V $)))&1'11,1) 1  1p  0 0  022#4'# '# $'#'#T`VT15PP'P.P Pz%)a aaa a  a#a aa aP  T%)04$$ $$  $  $ # $.$ $r%