diffusers-workflow 0.9.0__tar.gz → 0.11.0__tar.gz

{diffusers_workflow-0.9.0/diffusers_workflow.egg-info → diffusers_workflow-0.11.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: diffusers-workflow
-Version: 0.9.0
+Version: 0.11.0
 Summary: Declarative workflow engine and web UI for Hugging Face Diffusers
 Author: dkackman
 License: Apache-2.0

{diffusers_workflow-0.9.0 → diffusers_workflow-0.11.0/diffusers_workflow.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: diffusers-workflow
-Version: 0.9.0
+Version: 0.11.0
 Summary: Declarative workflow engine and web UI for Hugging Face Diffusers
 Author: dkackman
 License: Apache-2.0

{diffusers_workflow-0.9.0 → diffusers_workflow-0.11.0}/diffusers_workflow.egg-info/SOURCES.txt

@@ -19,12 +19,15 @@ dw/audio_qc.py
 dw/cache_blocks.json
 dw/cache_blocks.py
 dw/content_types.py
+dw/devices.py
 dw/dissolve_frame_errors.py
 dw/download_watch.py
 dw/dsp.py
 dw/elision.py
 dw/events.py
 dw/for_each.py
+dw/guides.py
+dw/hold_audio.py
 dw/host_memory.py
 dw/host_memory_projection.py
 dw/hub_cache.py
@@ -39,6 +42,7 @@ dw/lora_hub.py
 dw/media.py
 dw/media_frames.py
 dw/media_types.py
+dw/outbound.py
 dw/output_extraction.py
 dw/path_redaction.py
 dw/pipeline_ownership.py
@@ -57,6 +61,7 @@ dw/run.py
 dw/runs.py
 dw/scalar_result_validation.py
 dw/schema.py
+dw/script_lines.py
 dw/security.py
 dw/serve.py
 dw/settings.py
@@ -68,6 +73,7 @@ dw/step_cache.py
 dw/step_value_checks.py
 dw/subfolders.py
 dw/task_domains.py
+dw/task_problems.py
 dw/test.py
 dw/trust.py
 dw/type_helpers.py
@@ -80,6 +86,7 @@ dw/video_extensions.py
 dw/video_size_errors.py
 dw/vram_estimate.py
 dw/vram_inheritance.py
+dw/window_count_errors.py
 dw/worker.py
 dw/worker_manager.py
 dw/worker_protocol.py
@@ -89,6 +96,7 @@ dw/workflow_schema.json
 dw/workspace.py
 dw/writers.py
 dw/community_pipelines/pipeline_flux_rf_inversion.py
+dw/community_pipelines/pipeline_ltx2_refine.py
 dw/docs/ACCELERATION.md
 dw/docs/AGENT_LOOP.md
 dw/docs/ARCHITECTURE.md
@@ -113,6 +121,11 @@ dw/pipeline_processors/adapters.py
 dw/pipeline_processors/chain.py
 dw/pipeline_processors/components.py
 dw/pipeline_processors/config_objects.py
+dw/pipeline_processors/h3_guide_steps.py
+dw/pipeline_processors/h3_guides.py
+dw/pipeline_processors/h3_hold.py
+dw/pipeline_processors/h3_hold_steps.py
+dw/pipeline_processors/h3_rules.py
 dw/pipeline_processors/pipeline.py
 dw/pipeline_processors/placement.py
 dw/pipeline_processors/progress.py
@@ -132,13 +145,16 @@ dw/server/http_security.py
 dw/server/inline_media.py
 dw/server/job_history.py
 dw/server/job_record.py
+dw/server/job_results.py
 dw/server/jobs.py
 dw/server/mcp_mount.py
 dw/server/netinfo.py
 dw/server/observed_cost.py
 dw/server/outputs.py
+dw/server/pool.py
 dw/server/sysinfo.py
 dw/server/updater.py
+dw/server/worker_memory.py
 dw/server/routes/__init__.py
 dw/server/routes/assets.py
 dw/server/routes/files.py
@@ -156,52 +172,52 @@ dw/server/ui/assets/bat-i0X4ZdIN.js
 dw/server/ui/assets/bicep-B5-_aFwp.js
 dw/server/ui/assets/cameligo-DMUM7wLl.js
 dw/server/ui/assets/clojure-Cm7r79vr.js
-dw/server/ui/assets/codicon-Brq4_Ui5.ttf
+dw/server/ui/assets/codicon-DF1abBS2.ttf
 dw/server/ui/assets/coffee-Ba7i2nA0.js
 dw/server/ui/assets/cpp-C7h46wYY.js
 dw/server/ui/assets/csharp-BKxtCVv1.js
 dw/server/ui/assets/csp-bTuwJoIa.js
 dw/server/ui/assets/css-DIMkf-bt.js
-dw/server/ui/assets/css.worker-B3ciXF_0.js
-dw/server/ui/assets/cssMode-C1mrKegs.js
+dw/server/ui/assets/css.worker-C6lDtRpF.js
+dw/server/ui/assets/cssMode-ukxfz-ce.js
 dw/server/ui/assets/cypher-CVaqCwHa.js
 dw/server/ui/assets/dart-onAF5SnQ.js
 dw/server/ui/assets/dockerfile-DZFCIeNp.js
 dw/server/ui/assets/ecl-D05T4iGw.js
-dw/server/ui/assets/editor-jjEx9u7D.css
-dw/server/ui/assets/editor.api-EZbUgQvM.js
-dw/server/ui/assets/editor.worker-q-txB4vs.js
+dw/server/ui/assets/editor-DjpsE8to.css
+dw/server/ui/assets/editor.api-Bkt_tsj1.js
+dw/server/ui/assets/editor.worker-BmdWdrHZ.js
 dw/server/ui/assets/elixir-6RTg0lbw.js
 dw/server/ui/assets/flow9-C5_-GSwl.js
-dw/server/ui/assets/freemarker2-Dth1K2Vy.js
+dw/server/ui/assets/freemarker2-DbXygLvH.js
 dw/server/ui/assets/fsharp-C8Ef5oNN.js
 dw/server/ui/assets/go-C-y9NEjX.js
 dw/server/ui/assets/graphql-fmXr3nnJ.js
-dw/server/ui/assets/handlebars-8Sswqnxq.js
+dw/server/ui/assets/handlebars-BdhZGoSz.js
 dw/server/ui/assets/hcl-CpzslTdj.js
-dw/server/ui/assets/html-BYtYo7f1.js
-dw/server/ui/assets/html.worker-C93Ht9o9.js
-dw/server/ui/assets/htmlMode-B_AiWoXc.js
-dw/server/ui/assets/index-B6Ujrvuj.js
-dw/server/ui/assets/index-BChhQc7I.css
+dw/server/ui/assets/html-Chhg10Tp.js
+dw/server/ui/assets/html.worker-C5yZDBHz.js
+dw/server/ui/assets/htmlMode-cC3JW4lx.js
+dw/server/ui/assets/index-BYEwBCrU.css
+dw/server/ui/assets/index-CkD0GJG0.js
 dw/server/ui/assets/ini-sBoK_t0W.js
 dw/server/ui/assets/java-BEtHBSE6.js
-dw/server/ui/assets/javascript-E4m083D3.js
-dw/server/ui/assets/json.worker-B2V3pomh.js
-dw/server/ui/assets/jsonMode--h7ZikWy.js
+dw/server/ui/assets/javascript-BWWLMkof.js
+dw/server/ui/assets/json.worker-DdeUAmHa.js
+dw/server/ui/assets/jsonMode-DrC8C29V.js
 dw/server/ui/assets/julia-Bri6UV-V.js
 dw/server/ui/assets/kotlin-BOotOW0E.js
 dw/server/ui/assets/less-B9JPFI3C.js
 dw/server/ui/assets/lexon-CfSJPG6W.js
-dw/server/ui/assets/liquid-BzbKdLRW.js
-dw/server/ui/assets/lspLanguageFeatures-CRa0bRFV.js
+dw/server/ui/assets/liquid-CXdQfmUT.js
+dw/server/ui/assets/lspLanguageFeatures-BgAhb71w.js
 dw/server/ui/assets/lua-CsQS60Ue.js
 dw/server/ui/assets/m3-D-oSqn_W.js
 dw/server/ui/assets/markdown-Cimd5fb3.js
-dw/server/ui/assets/mdx-BJ4u6XQs.js
+dw/server/ui/assets/mdx-CQS0lFaZ.js
 dw/server/ui/assets/mips-CIPQ_RoX.js
-dw/server/ui/assets/monaco--ixms01u.css
-dw/server/ui/assets/monaco-DwaeaVri.js
+dw/server/ui/assets/monaco-Z_sI-RLU.js
+dw/server/ui/assets/monaco-n7clI0si.css
 dw/server/ui/assets/msdax-DauUninz.js
 dw/server/ui/assets/mysql-SOo6toE5.js
 dw/server/ui/assets/objective-c-FvmIjYaQ.js
@@ -216,10 +232,10 @@ dw/server/ui/assets/powerquery-D3hlyOfw.js
 dw/server/ui/assets/powershell-DmHpPYUd.js
 dw/server/ui/assets/protobuf-C531GsRP.js
 dw/server/ui/assets/pug-Z5eAx3Zn.js
-dw/server/ui/assets/python-CoX_gCAL.js
+dw/server/ui/assets/python-C9MtI630.js
 dw/server/ui/assets/qsharp-DkqhCAOL.js
 dw/server/ui/assets/r-BwWrilGY.js
-dw/server/ui/assets/razor-BCTdG5SN.js
+dw/server/ui/assets/razor-DPO5mHyR.js
 dw/server/ui/assets/redis-ClamHrr6.js
 dw/server/ui/assets/redshift-DT7zqm-g.js
 dw/server/ui/assets/restructuredtext-BYgofb2h.js
@@ -238,32 +254,40 @@ dw/server/ui/assets/st-DbInun42.js
 dw/server/ui/assets/swift-Bxkupp3x.js
 dw/server/ui/assets/systemverilog-Bz4Y3fRF.js
 dw/server/ui/assets/tcl-DISqw1ZD.js
-dw/server/ui/assets/ts.worker-D7T1-Ig5.js
-dw/server/ui/assets/tsMode-B6BV7a76.js
+dw/server/ui/assets/ts.worker-DGGa2mF8.js
+dw/server/ui/assets/tsMode-D8vGBTVc.js
 dw/server/ui/assets/twig-De2hgUGE.js
-dw/server/ui/assets/typescript-DJe7-fvZ.js
+dw/server/ui/assets/typescript-DyoEkQLT.js
 dw/server/ui/assets/typespec-B8J7ngcE.js
 dw/server/ui/assets/vb-DV3o63ZY.js
 dw/server/ui/assets/wgsl-DpFanUEy.js
-dw/server/ui/assets/workers-DCzLJTPE.js
-dw/server/ui/assets/xml-CNvWfUrB.js
-dw/server/ui/assets/yaml-ByARP6WE.js
+dw/server/ui/assets/workers-Bdewp_DS.js
+dw/server/ui/assets/xml-DmmKOVWo.js
+dw/server/ui/assets/yaml-C4jCTuer.js
 dw/tasks/assess.py
 dw/tasks/audio_dynamics.py
+dw/tasks/audio_handlers.py
 dw/tasks/audio_transcription.py
 dw/tasks/audio_utils.py
 dw/tasks/background_remover.py
+dw/tasks/beats.py
 dw/tasks/borders.py
 dw/tasks/compose_text.py
 dw/tasks/concat_videos.py
+dw/tasks/cuts.py
 dw/tasks/depth_estimator.py
 dw/tasks/diffusion_upscale.py
 dw/tasks/dissolve_videos.py
+dw/tasks/face_track.py
+dw/tasks/finish.py
+dw/tasks/finish_handlers.py
+dw/tasks/fit.py
 dw/tasks/format_messages.py
 dw/tasks/gather.py
 dw/tasks/grade.py
 dw/tasks/h3_latent_upscale.py
 dw/tasks/h3_latent_upscaler_model.py
+dw/tasks/image_ops.py
 dw/tasks/image_to_text.py
 dw/tasks/image_utils.py
 dw/tasks/interpolate_frames.py
@@ -271,11 +295,16 @@ dw/tasks/join_into_song.py
 dw/tasks/joins.py
 dw/tasks/judge.py
 dw/tasks/loop_bed.py
+dw/tasks/lut.py
+dw/tasks/measure_sync.py
 dw/tasks/model_cache.py
+dw/tasks/model_handlers.py
 dw/tasks/pair_audio.py
 dw/tasks/qr_code.py
+dw/tasks/registry.py
 dw/tasks/restore_faces.py
 dw/tasks/rife_model.py
+dw/tasks/script_check.py
 dw/tasks/segment.py
 dw/tasks/select.py
 dw/tasks/speech_generation.py
@@ -284,9 +313,12 @@ dw/tasks/task.py
 dw/tasks/tensor_image.py
 dw/tasks/text_generation.py
 dw/tasks/text_sections.py
+dw/tasks/trim.py
 dw/tasks/upscale.py
+dw/tasks/video_handlers.py
 dw/tasks/video_utils.py
 dw/tasks/voice_attribution.py
+dw/tasks/windows.py
 dw/tasks/zoe_depth.py
 dw/workflows/h3_context_ir.json
 dw/workflows/test.json
@@ -311,6 +343,8 @@ dw_mcp/tools_jobs.py
 dw_mcp/tools_media.py
 dw_mcp/workspaces.py
 tests/test_admission.py
+tests/test_admission_capacity.py
+tests/test_analyze_beats.py
 tests/test_api_contract.py
 tests/test_arch_metrics.py
 tests/test_arch_report.py
@@ -353,13 +387,23 @@ tests/test_dsp.py
 tests/test_elision.py
 tests/test_events.py
 tests/test_examples.py
+tests/test_face_track.py
 tests/test_find_loop_bed.py
+tests/test_finish.py
+tests/test_fit_templates.py
+tests/test_fit_to_model.py
 tests/test_for_each.py
 tests/test_gather.py
 tests/test_grade.py
+tests/test_guide_chain_validation.py
+tests/test_guides_validation.py
 tests/test_h3_adapters.py
 tests/test_h3_context_ir.py
+tests/test_h3_guides.py
+tests/test_h3_hold_audio.py
 tests/test_h3_latent_upscale.py
+tests/test_h3_refine.py
+tests/test_h3_rules.py
 tests/test_h3_schedule.py
 tests/test_h3_upscaler_source.py
 tests/test_h3_vram_ceiling.py
@@ -367,17 +411,23 @@ tests/test_hf_placement.py
 tests/test_host_memory.py
 tests/test_host_memory_projection.py
 tests/test_hub_cache.py
+tests/test_image_ops.py
 tests/test_image_to_text.py
 tests/test_image_utils.py
+tests/test_inductor_cache_default.py
+tests/test_ingredients_grid.py
+tests/test_inherited_cost.py
 tests/test_integration.py
 tests/test_interpolate_frames.py
 tests/test_introspection.py
+tests/test_job_history_device.py
 tests/test_job_history_wal.py
 tests/test_job_progress.py
 tests/test_job_warnings.py
 tests/test_jobs_listing.py
 tests/test_jobs_reused.py
 tests/test_join_into_song.py
+tests/test_join_windows.py
 tests/test_judge.py
 tests/test_kernel_availability.py
 tests/test_library_path.py
@@ -392,7 +442,9 @@ tests/test_lora_library.py
 tests/test_ltx2_diffusion_decode.py
 tests/test_ltx2_extend_clip.py
 tests/test_ltx2_ic_loras.py
+tests/test_ltx2_refine_pipeline.py
 tests/test_ltx_prompt_library.py
+tests/test_lut.py
 tests/test_mcp_assets.py
 tests/test_mcp_authoring.py
 tests/test_mcp_catalog.py
@@ -409,6 +461,7 @@ tests/test_mcp_prompts.py
 tests/test_mcp_server.py
 tests/test_mcp_twins.py
 tests/test_mcp_workspaces.py
+tests/test_measure_sync.py
 tests/test_media_audio.py
 tests/test_media_frames.py
 tests/test_media_info.py
@@ -421,8 +474,10 @@ tests/test_modular_progress.py
 tests/test_mps_fallback_warning.py
 tests/test_mps_rope_precision.py
 tests/test_null_media.py
+tests/test_numeric_coercion.py
 tests/test_observed_cost.py
 tests/test_offload_placement.py
+tests/test_outbound.py
 tests/test_output_references.py
 tests/test_pair_audio.py
 tests/test_pair_audio_fit.py
@@ -432,6 +487,7 @@ tests/test_phase_events.py
 tests/test_pipeline_caching.py
 tests/test_pipeline_components.py
 tests/test_plan.py
+tests/test_plan_cuts.py
 tests/test_plugin_skills.py
 tests/test_prepare_pipeline.py
 tests/test_previous_result_walker_parity.py
@@ -441,6 +497,7 @@ tests/test_prompt_parser.py
 tests/test_prompt_references.py
 tests/test_prompt_weighting.py
 tests/test_prompts.py
+tests/test_read_frame_range.py
 tests/test_real_models.py
 tests/test_realize.py
 tests/test_recenter_crop.py
@@ -450,6 +507,7 @@ tests/test_reference_skip_sets.py
 tests/test_references.py
 tests/test_rerun_new_seed.py
 tests/test_resize_bucket.py
+tests/test_restore_faces_video.py
 tests/test_result.py
 tests/test_result_fps.py
 tests/test_result_output_naming.py
@@ -458,6 +516,7 @@ tests/test_runs.py
 tests/test_scalar_result_validation.py
 tests/test_scheduler_config.py
 tests/test_schema.py
+tests/test_script_check.py
 tests/test_security.py
 tests/test_security_auth.py
 tests/test_security_decoder_bombs.py
@@ -469,6 +528,7 @@ tests/test_security_web_headers.py
 tests/test_segment.py
 tests/test_select.py
 tests/test_select_validation.py
+tests/test_separate_stems.py
 tests/test_serve_main.py
 tests/test_server.py
 tests/test_server_assess.py
@@ -496,6 +556,8 @@ tests/test_subfolders.py
 tests/test_task.py
 tests/test_task_discovery.py
 tests/test_task_domains.py
+tests/test_task_public_imports.py
+tests/test_task_registry_rules.py
 tests/test_task_signature_errors.py
 tests/test_template_defaults.py
 tests/test_template_subfolders.py
@@ -503,7 +565,9 @@ tests/test_tensor_image.py
 tests/test_text_generation.py
 tests/test_text_sections.py
 tests/test_transcribe_audio.py
+tests/test_trim_video.py
 tests/test_type_helpers.py
+tests/test_type_helpers_concurrency.py
 tests/test_ui_twins.py
 tests/test_updater.py
 tests/test_validate_arguments.py
@@ -515,12 +579,16 @@ tests/test_video_size_errors.py
 tests/test_video_utils.py
 tests/test_voice_attribution.py
 tests/test_vram_estimate.py
+tests/test_vram_guides.py
 tests/test_vram_inheritance.py
+tests/test_window_count_errors.py
+tests/test_window_video.py
 tests/test_worker.py
 tests/test_worker_execute.py
 tests/test_worker_job_peak_rss.py
 tests/test_worker_manager.py
 tests/test_worker_messages.py
+tests/test_worker_pool.py
 tests/test_workflow.py
 tests/test_workflow_snapshot.py
 tests/test_workflow_step_cache.py

{diffusers_workflow-0.9.0 → diffusers_workflow-0.11.0}/dw/__init__.py

@@ -48,6 +48,24 @@ def _parallel_loading_default(platform):
 if "HF_ENABLE_PARALLEL_LOADING" not in os.environ:
     os.environ["HF_ENABLE_PARALLEL_LOADING"] = _parallel_loading_default(sys.platform)
 
+
+def _inductor_cache_dir_default(environ):
+    """Where torch.compile keeps its on-disk cache.
+
+    Inductor's own default is /tmp/torchinductor_<user>, which a reboot wipes.
+    A fresh worker always retraces, but a cache hit skips codegen and kernel
+    builds - most of a cold compile, about 90s of MiniMax-H3's first step on a
+    3090 - so the user's cache directory keeps that paid once per shape rather
+    than once per boot. An empty XDG_CACHE_HOME counts as unset, per the spec."""
+    base = environ.get("XDG_CACHE_HOME") or os.path.join(
+        os.path.expanduser("~"), ".cache"
+    )
+    return os.path.join(base, "dw", "torchinductor")
+
+
+if "TORCHINDUCTOR_CACHE_DIR" not in os.environ:
+    os.environ["TORCHINDUCTOR_CACHE_DIR"] = _inductor_cache_dir_default(os.environ)
+
 # Suppress all common library warnings before any imports
 warnings.filterwarnings("ignore", category=FutureWarning)
 warnings.filterwarnings("ignore", category=UserWarning)

{diffusers_workflow-0.9.0 → diffusers_workflow-0.11.0}/dw/adapter_compatibility.py

@@ -30,7 +30,7 @@ names and the partition each one denoises against are diffusers' own, and
 import logging
 
 from . import references
-from .for_each import MEMBER_SEPARATOR, render_path
+from .references import render_path
 
 logger = logging.getLogger("dw")
 
@@ -109,13 +109,9 @@ def _lora_problems(steps, source_indices, written=None, supplied=()):
     """
     written_steps = (written or {}).get("steps")
     found = []
-    for index, step in enumerate(steps):
-        if not isinstance(step, dict):
-            continue
-        pipeline = step.get("pipeline")
-        if not isinstance(pipeline, dict):
-            continue
-        source = references.author_index(source_indices, index)
+    for _, _, pipeline, source, where in references.iter_steps(
+        steps, source_indices, "pipeline"
+    ):
         from_pretrained = pipeline.get(FROM_PRETRAINED_KEY)
         workflow = (
             from_pretrained.get(WORKFLOW_KEY)
@@ -127,12 +123,6 @@ def _lora_problems(steps, source_indices, written=None, supplied=()):
         loras = pipeline.get(LORAS_KEY)
         if not isinstance(loras, list):
             continue
-        name = step.get("name")
-        where = (
-            f" in member '{name}'"
-            if isinstance(name, str) and MEMBER_SEPARATOR in name
-            else ""
-        )
         for position, lora in enumerate(loras):
             if not isinstance(lora, dict):
                 continue
@@ -212,18 +202,12 @@ def _disabled_loras(steps, source_indices, written=None, supplied=()):
     engine's, and so is saying that it was used."""
     written_steps = (written or {}).get("steps")
     found = []
-    for index, step in enumerate(steps):
-        pipeline = step.get("pipeline") if isinstance(step, dict) else None
-        loras = pipeline.get(LORAS_KEY) if isinstance(pipeline, dict) else None
+    for _, _, pipeline, source, where in references.iter_steps(
+        steps, source_indices, "pipeline"
+    ):
+        loras = pipeline.get(LORAS_KEY)
         if not isinstance(loras, list):
             continue
-        source = references.author_index(source_indices, index)
-        name = step.get("name")
-        where = (
-            f" in member '{name}'"
-            if isinstance(name, str) and MEMBER_SEPARATOR in name
-            else ""
-        )
         for position, lora in enumerate(loras):
             if not isinstance(lora, dict) or lora.get(MODEL_NAME_KEY) is not None:
                 continue

{diffusers_workflow-0.9.0 → diffusers_workflow-0.11.0}/dw/argument_media.py

@@ -2,6 +2,7 @@
 {media_type, location} reference, an `image`/`video` argument's path or URL, and
 the frame rate and shots a loaded video carries."""
 
+import contextlib
 import io
 import os
 import logging
@@ -16,7 +17,8 @@ from .security import (
     ALLOWED_IMAGE_EXTENSIONS,
     ALLOWED_VIDEO_EXTENSIONS,
 )
-from .locations import safe_get, validate_media_path
+from .locations import is_http_url, validate_media_path
+from .outbound import safe_get
 
 logger = logging.getLogger("dw")
 
@@ -81,10 +83,14 @@ def fetch_image_with_context(v, base_dir, key):
         ) from error
 
 
-def fetch_video_with_context(v, base_dir, key):
+def fetch_video_with_context(v, base_dir, key, with_audio=False):
     """fetch_video, with the same argument-key context as
-    fetch_image_with_context."""
+    fetch_image_with_context. `with_audio` reads a file's soundtrack along with
+    its frames, as an AudioVideo - an H3 guide's `"audio": true` beside its
+    `video` (#649), where frames alone leave the guide no audio to hold."""
     try:
+        if with_audio:
+            return _fetch_audio_video(v, base_dir)
         return fetch_video(v, base_dir)
     except ValueError as error:
         raise ValueError(
@@ -94,7 +100,30 @@ def fetch_video_with_context(v, base_dir, key):
         ) from error
 
 
-def fetch_image(img_spec, base_dir=None):
+def _fetch_audio_video(video_spec, base_dir=None):
+    """A video file - a path, URL or {"location": ...} - loaded with its audio
+    as an AudioVideo. A deferred reference stays for later resolution, and a
+    value already loaded passes through, so a second realization keeps it."""
+    from .tasks.video_utils import is_video_location, load_audio_video
+
+    if isinstance(video_spec, str) and references.is_ref(
+        references.LAZY_MEDIA, video_spec
+    ):
+        return video_spec
+    if is_video_location(video_spec):
+        return load_audio_video(video_spec, base_dir)
+    return video_spec
+
+
+def _rgb_keeping_alpha(image):
+    """RGBA when the file carries transparency (an alpha band, or a palette
+    or greyscale image's transparency key), plain RGB otherwise."""
+    if "A" in image.getbands() or "transparency" in image.info:
+        return image.convert("RGBA")
+    return image.convert("RGB")
+
+
+def fetch_image(img_spec, base_dir=None, keep_alpha=False):
     """
     Load image from file path or URL with security validation.
 
@@ -102,6 +131,10 @@ def fetch_image(img_spec, base_dir=None):
         img_spec: Image specification (file path, URL, dict with 'location' key, PIL Image, or list of any of these)
         base_dir: Directory relative file paths are resolved against - the
             workflow file's directory. Defaults to the process working directory
+        keep_alpha: Load a file with transparency as RGBA instead of
+            flattening it to RGB. A pipeline input wants RGB; the finishing
+            commands (grade, sharpen, film_grain, apply_lut) put the alpha
+            back after their op, so a cutout stays a cutout (#775)
 
     Returns:
         Loaded PIL Image, list of PIL Images, or None if img_spec is None
@@ -116,7 +149,7 @@ def fetch_image(img_spec, base_dir=None):
     # Handle lists of images (recursively process each)
     if isinstance(img_spec, list):
         logger.debug(f"Loading list of {len(img_spec)} images")
-        return [fetch_image(img, base_dir) for img in img_spec]
+        return [fetch_image(img, base_dir, keep_alpha) for img in img_spec]
 
     # If already a PIL Image, return as-is (allows multiple realize_args calls)
     if hasattr(img_spec, "mode") and hasattr(img_spec, "size"):
@@ -140,6 +173,7 @@ def fetch_image(img_spec, base_dir=None):
         return img_spec
 
     logger.debug(f"Loading image from: {img_spec}")
+    convert_method = _rgb_keeping_alpha if keep_alpha else None
 
     try:
         # Check if it's a URL
@@ -150,7 +184,7 @@ def fetch_image(img_spec, base_dir=None):
             # without re-checking them; load_image still does the EXIF
             # transpose and RGB conversion on the decoded result
             response = safe_get(img_spec, "an image argument", timeout=60)
-            return load_image(Image.open(io.BytesIO(response.content)))
+            return load_image(Image.open(io.BytesIO(response.content)), convert_method)
         else:
             # Treat as file path, relative to the workflow file, and confined
             # to the directories this workflow may read (dw/locations.py)
@@ -164,7 +198,7 @@ def fetch_image(img_spec, base_dir=None):
                     f"Image file extension not allowed: {ext} - a video file "
                     "must go through video_frames first"
                 )
-            return load_image(validated_path)
+            return load_image(validated_path, convert_method)
 
     except SecurityError:
         raise
@@ -209,24 +243,41 @@ def _declared_fps(path):
         return None
 
 
-def _fetch_remote_video(url):
-    """A video URL's frames, fetched through `safe_get` and decoded from a
-    temporary file. `load_video` would fetch the URL itself and follow its
-    redirects unchecked; handed a path, it only decodes. The suffix comes
-    from the URL, as `load_video`'s own download names it, since a `.gif`
-    decodes differently."""
-    from .tasks.video_utils import FrameList
+@contextlib.contextmanager
+def local_media_file(location, what, default_suffix=""):
+    """`location` as a path a loader opens: a path as it is, an http(s) URL
+    fetched through `safe_get` into a temporary file that lasts as long as
+    the `with` block.
 
-    response = safe_get(url, "a video argument", timeout=300)
-    suffix = os.path.splitext(unquote(urlparse(url).path))[1] or ".mp4"
+    A loader handed a URL fetches it itself - diffusers' `load_video`,
+    `load_image` and its H3 references' `from_file` all call requests
+    directly, resolving the host a second time and following redirects
+    unchecked, with no cap on the body. Handed a path, they only decode.
+    The suffix comes from the URL, as those loaders' own downloads name
+    it, since a container is often told apart by it. The loader must have
+    read the file before the block ends.
+    """
+    if not is_http_url(location):
+        yield location
+        return
+    response = safe_get(location, what, timeout=300)
+    suffix = os.path.splitext(unquote(urlparse(location).path))[1] or default_suffix
     handle = tempfile.NamedTemporaryFile(suffix=suffix, delete=False)
     try:
         with handle:
             handle.write(response.content)
-        frames = load_video(handle.name)
-        fps = _declared_fps(handle.name)
+        yield handle.name
     finally:
         os.remove(handle.name)
+
+
+def _fetch_remote_video(url):
+    """A video URL's frames, decoded from `local_media_file`'s copy."""
+    from .tasks.video_utils import FrameList
+
+    with local_media_file(url, "a video argument", default_suffix=".mp4") as path:
+        frames = load_video(path)
+        fps = _declared_fps(path)
     # A URL has no run beside it, so it carries no shots
     return FrameList(frames, fps, None) if fps else frames