"""Constants shared by H3 Continuum Join.""" from __future__ import annotations FPS = 24.0 AUDIO_SAMPLE_RATE = 32_000 AUDIO_LATENT_FPS = 40.0 FRAME_RESCALE = AUDIO_LATENT_FPS / FPS FRAME_PER_TOKEN = (1, 4, 4, 4, 4) CHUNK_SECONDS_DEFAULT = 5.0 CHUNK_SECONDS_MIN = 4.1 CHUNK_SECONDS_MAX = 30.0 CHUNK_SECONDS_STEP = 0.1 CHUNK_SECONDS_TOOLTIP = ( "Target duration for each chunk. 5–15 seconds is the recommended " "and validated range. Values above 15 seconds are supported, but VRAM " "use and processing time can increase substantially, especially at high " "resolution." ) STATE_MAGIC = "H3_CONTINUUM_STATE" PLAN_MAGIC = "H3_CONTINUUM_PLAN" SESSION_MAGIC = "H3_CONTINUUM_SESSION" PROMPT_PLAN_MAGIC = "H3_CONTINUUM_PROMPT_PLAN" MARK_SCHEMA = "_h3cj_schema" MARK_VIDEO_SLOT = "_h3cj_video_slot" # legacy/internal-slot compatibility MARK_PIXEL_START = "_h3cj_pixel_start" MARK_VIDEO_CONTEXT = "_h3cj_video_context" MARK_CONTEXT_FRAMES = "_h3cj_context_frames" MARK_AUDIO_CONTEXT = "_h3cj_audio_context" MARK_AUDIO_END_FRAME = "_h3cj_audio_end_frame" MARK_AUDIO_OVERHANG = "_h3cj_audio_overhang" CONTINUUM_REFERENCE_METADATA_KEY = "_h3_continuum" CONTINUUM_INTEROP_KEY = "h3_continuum" CONTINUUM_INTEROP_API = 1 CONTINUUM_ACTUAL_PREFIX_STEPS = 2 MODEL_WRAPPER_KEY = "h3_continuum_join.apply_model.v1" V2_RUNTIME_KEY = "h3_continuum_v2" LAYOUT_ORIGINAL_TIME_ATTR = "_h3cj_original_time_v1" LAYOUT_SIGNATURE_ATTR = "_h3cj_patch_signature_v1" LAYOUT_DEVICE_CACHE_ATTR = "_h3cj_device_cache_v1" CONTINUITY_OPTIONS = ( "Balanced — 22 frames", "Fast — 5 frames", "Strong — 39 frames (Experimental)", ) CONTINUITY_FRAMES = { CONTINUITY_OPTIONS[0]: 22, CONTINUITY_OPTIONS[1]: 5, CONTINUITY_OPTIONS[2]: 39, } DEFAULT_STATE_CAPACITY_FRAMES = 39 V2_CONTINUITY_AUTO = "Auto — conservative" V2_CONTINUITY_OPTIONS = (V2_CONTINUITY_AUTO,) + CONTINUITY_OPTIONS # Older saved workflows and frontend help text used ASCII hyphens in these # labels. Keep the public labels canonical while accepting those persisted # aliases when a saved Run Storage session is resumed. _CONTINUITY_ALIASES = { "Auto - conservative": V2_CONTINUITY_AUTO, "Balanced - 22 frames": CONTINUITY_OPTIONS[0], "Fast - 5 frames": CONTINUITY_OPTIONS[1], "Strong - 39 frames (Experimental)": CONTINUITY_OPTIONS[2], } def normalize_continuity_mode(value: str) -> str: """Return the canonical continuity label for current and legacy saves.""" raw = str(value).strip() return _CONTINUITY_ALIASES.get(raw, raw) def continuity_storage_mode(value: str) -> str: """Return the stable ASCII label used in persisted contracts. Persisted V3.8 runs used ASCII hyphens. Keeping that storage spelling makes old manifests compatible while the runtime continues to accept and expose the public em-dash labels. """ return normalize_continuity_mode(value).replace("—", "-") PROMPT_MODE_FIXED = "Fixed — one prompt" PROMPT_MODE_LIST = "List — split with ---" PROMPT_MODE_TIMELINE = "Timeline — [0-5s] sections" PROMPT_MODE_OPTIONS = (PROMPT_MODE_FIXED, PROMPT_MODE_LIST, PROMPT_MODE_TIMELINE) PROMPT_FORMAT_AUTO = "Auto" PROMPT_FORMAT_FIXED = "Fixed" PROMPT_FORMAT_LIST = "List" PROMPT_FORMAT_TIMELINE = "Timeline" PROMPT_FORMAT_OPTIONS = ( PROMPT_FORMAT_AUTO, PROMPT_FORMAT_FIXED, PROMPT_FORMAT_LIST, PROMPT_FORMAT_TIMELINE, ) DIAGNOSTICS_OFF = "Off" DIAGNOSTICS_BASIC = "Basic" DIAGNOSTICS_FULL = "Detailed Report" DIAGNOSTICS_LEGACY_FULL = "Full" DIAGNOSTICS_OPTIONS = (DIAGNOSTICS_BASIC, DIAGNOSTICS_FULL, DIAGNOSTICS_OFF) DIAGNOSTICS_ACCEPTED_OPTIONS = DIAGNOSTICS_OPTIONS + (DIAGNOSTICS_LEGACY_FULL,) def normalize_diagnostics_mode(value: str) -> str: return DIAGNOSTICS_FULL if value == DIAGNOSTICS_LEGACY_FULL else value SEAM_CORRECTION_AUTO = "Auto" SEAM_CORRECTION_OFF = "Off" SEAM_CORRECTION_BASIC = "Basic" SEAM_CORRECTION_OPTIONS = ( SEAM_CORRECTION_AUTO, SEAM_CORRECTION_OFF, SEAM_CORRECTION_BASIC, )