diegosouzapw/OmniRoute · error · Error

Video frames could not be described

Error message

Video frames could not be described

What it means

Error "Video frames could not be described" thrown in diegosouzapw/OmniRoute.

Source

Thrown at src/lib/guardrails/videoBridgeHelpers.ts:629

        const caption = (await captionFrame(frame.dataUri, frame.timestampSeconds, signal)).trim();
        if (caption) {
          descriptions.push(
            `${
              contactSheet?.used
                ? `contact-sheet[timestamps=${contactSheet.timestamps.map(formatVideoTimestamp).join(",")}]`
                : `frame@t=${formatVideoTimestamp(frame.timestampSeconds)}`
            } ${caption}`
          );
        }
      } catch {
        if (signal.aborted) {
          throw new Error("Video Bridge processing timed out or was aborted");
        }
        // Partial frame failures are omitted. An all-frame failure is handled below.
      }
    }
    if (descriptions.length === 0) {
      throw new Error("Video frames could not be described");
    }
    let fusionTelemetry: VideoFusionTelemetry | undefined;
    if (part.audioTranscript !== undefined) {
      // Audio validation runs inside the fusion's audio branch on purpose: an
      // invalid audioTranscript must surface as a partial fusion (video kept,
      // failures.audio recorded), never fail the whole video description.
      const fused = await fuseVideoAndAudio({
        audio: async () => ({
          observations: normalizeVideoTranscript(
            part.audioTranscript,
            extracted.durationSeconds
          ).map((cue) => ({ ...cue, source: "audio" as const })),
        }),
        signal,
        timeoutMs: options.timeoutMs,
        video: async () => ({
          observations: descriptions.map((text, index) => ({
            confidence: 1,

View on GitHub (pinned to a179ffed5b)

When it happens

Trigger: Thrown at src/lib/guardrails/videoBridgeHelpers.ts:629 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of diegosouzapw/OmniRoute@a179ffed5b (2026-08-25). Data as JSON: /api/errors/a2a818997d2cf8d8. Report an issue: GitHub.