Get a tool by name.

Run a subprocess command with standard error handling. On Windows, resolves .cmd/.bat wrappers (e.g. npx, npm) via shutil.which() so

Validate artifact data against its schema. Raises on failure.

Return full tool contract info for registry/discovery.

Load and validate a pipeline manifest by name. Args: name: Pipeline name (without .yaml extension). defs_dir: Override directory

* Deterministic pseudo-random based on seed index. * Produces the same value every frame for the same seed — required for Remotion.

Register a tool instance.

Write a fixed-size dummy file and return the path.

Copy/link a freshly downloaded clip file into the cache. ``source_path`` is the file as it already sits in the caller's project direc

Write a checkpoint file for a pipeline stage.

Return the first string value from a palette entry (list or scalar).

Load existing corpus from disk. Silently starts empty if absent.

Import a package tree and register any concrete tools it defines.

Load tool modules once before reporting capabilities.

Hard-link (or copy) a cached clip into ``dest`` if present. Returns ``True`` on cache hit, ``False`` on miss. On hit, the entry's ``l

Read the manifest file into a dict keyed by clip_id. Malformed lines are skipped silently — a single bad row must not poison the whol

Return availability state for the HyperFrames runtime. Checks BOTH local binaries (node >= 22, ffmpeg, npx) AND that the `hyperframes

Get a media profile by name.

Calculate WCAG 2.1 contrast ratio between foreground and background. Uses sRGB relative luminance: L = 0.2126*R + 0.7152*G + 0.0722*B Args:

Format seconds as SRT timestamp: HH:MM:SS,mmm

Format seconds as VTT timestamp: HH:MM:SS.mmm

Instantiate every registered adapter, whether available or not. Returned instances are cheap — adapters keep no state beyond env var reads, s

Submit → poll → download. Returns list of artifact paths.

Get all tools registered for a top-level capability family.

Check if this tool's dependencies are satisfied.

Load and validate a style playbook by name. Args: name: Playbook name (without .yaml extension). styles_dir: Override directory f

Run post-render self-review and produce a final_review artifact. This is the governance contract: the compose runtime MUST inspect th

Flatten Archive.org's sometimes-list-sometimes-string fields. The search API returns `creator`, `subject`, and `description` as either a stri

Append a new clip to the corpus. Idempotent by clip_id.

Estimate cost in USD for the given inputs. Override for paid tools.

Extract the ordered list of stage names from a manifest. ``include_sub_stages=True`` exposes declarative sample/preview units to the agent wi

Return best available torch device: cuda > mps (Apple Silicon Metal) > cpu. Priority order: 1. cuda — NVIDIA GPU (fastest for most diffusi

Return True if the ComfyUI server is reachable.

Load a workflow JSON template from disk.

Return a minimal schema-valid artifact for tests.

Return a cascade of search queries to try in preference order. Commons' CirrusSearch defaults to AND semantics for multi-word queries, so a 4

Compare a word-level transcript against the source script. Purpose: catch TTS failures that look fine on audio-volume/duration checks

Auto-discover video generation providers from the registry.

Render via Remotion (requires Node.js + npx). Handles compositions with still images, animated scenes, component types, and transitio

Check a list of colors for color-blind confusion pairs. Simulates deuteranopia, protanopia, and tritanopia confusion. Flags color pairs that

Human-readable explanation of this score.

Rank a list of tools by weighted score for a given task context. Returns scores sorted best-first.

Probe a single clip with ffprobe and return metadata dict.

Auto-discover TTS providers from the registry.

Auto-discover screen_capture providers from the registry.

Auto-discover image generation providers from the registry.

HyperFrames resolves src= relative to index.html. Our asset files live under workspace/assets/, so when we stage a copy we know the re

Invoke `npx hyperframes <args>` with the right Windows quirks. We intentionally bypass `self.run_command` here because we do NOT want

Parse a value to int, tolerating strings, None, and garbage.

Check which of *required* model filenames are available. Returns ``(found, missing)`` — two lists of filenames.

Collect tools across stages, sub-stages, and reference-input analysis.

Deep-copy *workflow* and apply *patches*. *patches* maps ``node_id`` → ``{input_name: value, ...}``.

Summarize source availability for preflight and tool contracts.