Z jc UdZddlmZddlZddlmZdZded<edd hZ d ed <ejd Z ejd Z ddZ ddZ ddZy)uGaze direction enum SOT + target pairing + dispatch helper (Area #2 Q1 + Q3 + Q7). closed-world enum only — LLM producer (shot_staging) emit gaze_direction_kind + gaze_target_id, consumer = enum check via helper. regex / substring / NL fallback 금지 (Gate 1). validate_pairing = production runtime primary defense for kind↔target pairing. shot_staging v15 부터 schema 의 oneOf 조건부가 제거됐다 (OpenAI strict structured-output 호환 — combinator 미지원). schema 는 gaze_direction_kind enum + gaze_target_id required-nullable 만 강제하고, kind↔target 정합은 shot_staging 코드측에서 이 validate_pairing 으로 fail-fast 검증한다. Q7 closure: gaze_target_id shape = registered short_id only. ) annotationsN)AppError)cameradownupdistant closed_eyes off_screenlooks_at_characterlooks_at_objectztuple[str, ...]GAZE_DIRECTION_KINDSr r zfrozenset[str]TARGET_REQUIRED_KINDSz ^C\d{2,3}$z^(P|B)\d{2,3}$c|tvS)N)r)kinds M/Users/manta/Documents/Projects/TheRoad-I1/backend/app/core/gaze_direction.pyis_target_requiredr s ( ((c |tvrtd|d|dtt|}|r|std|d|d|s|td|d|d|d |rb|d k(r+tj |xsd std |d |d |dk(r,t j |xsd std |d|d yyy)Nz0step.contract_violation.gaze_direction_kind.enumz: invalid kind=z, expected one of z>step.contract_violation.gaze_target_id.missing_for_target_kindz: kind=z requires gaze_target_idzBstep.contract_violation.gaze_target_id.present_for_non_target_kindz forbids gaze_target_id (got )r z,step.contract_violation.gaze_target_id.shapez3: kind=looks_at_character requires ^C\d{2,3}$ (got r z4: kind=looks_at_object requires ^(P|B)\d{2,3}$ (got )r rr _CHAR_ID_REmatch _OBJECT_ID_RE)r target_idwheretarget_requireds rvalidate_pairingr$s% '' >g_TH,>?S>T U  ).Oy LgWTH$< =   y4 PgWTH$A)a P   ' ' 0A0A)/r0R>'OPY}\]^  $ $]-@-@b-Q>'PQZP]]^_ .R $ rcptj|xsdsy||vry|j|}|sy||fS)utarget_id (C##) → (sid, canonical_name) lookup. structural validation only: C## shape + visible_set membership. None = visible 밖 → consumer 가 결정 (skip or warn). name matching / noun matching / character/object 재판정 금지 (Gate 1).rN)rrget)rvisible_character_ids id_to_namernames r resolve_visible_character_targetr#CsD   Y_" --- >>) $D  t r)rstrreturnbool)rr$rz str | Nonerr$r%None) rr$r zset[str]r!zdict[str, str]rr$r%ztuple[str, str] | None)__doc__ __future__rreapp.core.errorsrr __annotations__ frozensetrcompilerrrrr#rrr0s # $)o )23GIZ2[(\~\bjj'  ,- )>#    r