Run a skill-backed chat completion on the Hermes gateway. The skill body * becomes the system prompt (via the same activation wrapper Hermes uses

Hydrate tool events from the image-pipeline envelope into the agent * ticker. Each event fires a short-lived visible entry so the demo * viewer c

Parse JSON emitted by Hermes even if the model wrapped it in a fence or * leaked commentary around it. Throws if nothing parseable is present.

Read a text/plain stream into a single string, updating the agent ticker * live so the user sees the agent typing. Throttled via requestAnimationFra

True when an exception came from the shared AbortController. We * don't want aborted fetches to surface as red agent errors — they * are intentio

Abort every inflight hermes fetch sharing this controller, then * arm a fresh controller for subsequent calls.

Resolve the prior-canon beat's rendered image URL, if any, so we can * pass it as a scene reference to the next image render. Single-frame * chai

Remove the per-call yt-dlp scratch dir. Best-effort; a leftover work dir is annoying but never breaks correctness.

Minimal urllib-based HTTP helper. Returns ``(status, body, headers)``. No third-party deps so the tool works in any venv that has stdlib.

Recursively collect downstream descendants (excluding the start node).

Return a set of character offsets in ``text`` where a new sentence begins (offset of the first word-character of each sentence).

Sync synthesis call. Returns (bytes_written, alignment). ``alignment`` is the per-character timing dict returned by ElevenLabs's ``with-time

Return raw word tokens preserving original case.

Apply a dictionary of case-insensitive whole-phrase substitutions. * Collects every replacement actually made so the UI can diff them. * Sorted by

Register a wav file as an ElevenLabs Instant Voice Cloning voice and return its ``voice_id``. Caller decides whether to delete the voice afte

Collect the CANON descendant chain from `start` (excluding start). Walks * a single path by preferring current → canon → author-canon insert → * n

Hermes Agent gateway client (OpenAI-compatible, served by `hermes gateway * run` on localhost:8642). Every narrative call goes through this path so

Public so consumers can fail fast when the key is missing without actually attempting a synthesis call.

Sync variant for consumers not running an event loop. Same retry semantics as the async version. Returns ``(bytes_written, alignment)``.

Subscribe to scene focus state. Returns: * - `hovered`: the scene currently hovered in the panel (or null) * - `thisNodeScene`: the scene this nod

Stable hash of the (query, duration window) tuple. Different duration windows are different samples — a 6 s slice and a 10 s slice from the s

Reverse-index parentId → [child ids] in insertion order.

Split proper-noun registry into characters vs objects. Heuristic: a multi-word phrase or a single-word name that appears in more than one bea

Return every word that appears lowercase anywhere in the corpus. Used to disambiguate sentence-initial Title-Case. A word whose lowercase fo

Return a list of (word, sentence_initial) pairs from ``text``.

Lazy-load the pyannote speaker-diarization pipeline. Returns the pipeline instance on success, ``None`` if pyannote isn't installed OR no HF

Download top YouTube result for ``query`` as an audio file. Returns ``{"audio_path": Path, "url": str, "title": str, "duration": float}`` on

Cut [start, end] segments from ``src`` and concat them into a single 24 kHz mono 16-bit PCM wav at ``dst``. For a single segment this is just

Re-encode ``src`` to 24 kHz mono 16-bit PCM wav at ``dst``. Raises on non-zero ffmpeg exit so the caller can write the error sentinel.