videoclaw 3.0.0-alpha.1

package/dist/video/provider-platform/route-capabilities.d.ts

@@ -0,0 +1,133 @@
+import type { ProviderRouteId } from './types.js';
+/**
+ * Declarative, single-sourced capability envelope for one provider route.
+ *
+ * The numeric/enum values here are NOT re-derived heuristics — they mirror the
+ * limits the transports already enforce:
+ *  - dreamina-useapi: `src/video/providers/dreamina-useapi.ts`
+ *    (DREAMINA_MAX_IMAGE_REFS / _VIDEO / _AUDIO, resolutionFor(), clampDuration()).
+ *  - runway-useapi: `src/video/providers/runway-useapi.ts`
+ *    (RUNWAY_MAX_IMAGE_REFS / _VIDEO, clampDuration(), default mode 'explore').
+ *  - seedance-direct: `src/video/native-seedance.ts`
+ *    (REFERENCE_BUDGET images/videos/audios via assertReferenceBudget).
+ *  - veo-useapi: `src/video/native-veo.ts` (veoRatio landscape/portrait/square;
+ *    conservative defaults — UseAPI enforces the rest server-side).
+ *
+ * This matrix is the read-only contract used by `assertRouteRequestValid` to
+ * fail fast (or warn under VCLAW_ALLOW_UNSAFE_MODELS) BEFORE a provider submit.
+ * Keep it in sync with the transport limits above — do not let it drift.
+ */
+export interface RouteCapabilities {
+    /** Submission modes the route understands (e.g. 'explore' | 'credits'). */
+    modes: string[];
+    /** Output resolutions the route can deliver (e.g. '720p', '1080p'). */
+    resolutions: string[];
+    /**
+     * Discrete clip durations (seconds) the route accepts/clamps to. An empty
+     * array means the transport enforces no client-side duration set (the
+     * provider applies model-specific limits server-side), so duration is not
+     * checked for this route.
+     */
+    durationsSec: number[];
+    /** Maximum number of image reference inputs per submission. */
+    maxImageRefs: number;
+    /** Maximum number of video reference inputs per submission. */
+    maxVideoRefs: number;
+    /** Maximum number of audio reference inputs per submission. */
+    maxAudioRefs: number;
+    /** Whether the route can attach/generate audio. */
+    audioCapable: boolean;
+    /** When a capability is gated to a region (e.g. '1080p is CA-only'). */
+    regionGated?: string;
+    /** Free-form operator notes carried into warnings/diagnostics. */
+    notes?: string[];
+}
+/**
+ * Capability matrix for the four live provider routes. `veo-direct` is
+ * intentionally absent — it was an adapter-only phantom route with no native
+ * transport and has been removed from `ProviderRouteId`.
+ */
+export declare const ROUTE_CAPABILITIES: Record<ProviderRouteId, RouteCapabilities>;
+/**
+ * A request to validate against a route's capability envelope. Every field is
+ * optional: an absent field is simply not checked (so callers that only know a
+ * subset of the request — e.g. just resolution + aspect ratio at payload-build
+ * time — never trip a false violation for a value they did not supply).
+ */
+export interface RouteRequest {
+    resolution?: string;
+    durationSec?: number;
+    aspectRatio?: string;
+    imageRefs?: number;
+    videoRefs?: number;
+    audioRefs?: number;
+    mode?: string;
+    /**
+     * Resolved Veo model for a `veo-useapi` request (`fast | quality | omni-flash`).
+     * Only consulted by the veo-useapi-specific gate below. Other routes ignore it.
+     */
+    veoModel?: string;
+    /**
+     * True when this request carries a voice-narration preset (`flow.ts --voice`).
+     * Provider-side this is `omni-flash`-only on the veo-useapi route.
+     */
+    hasVoice?: boolean;
+    /**
+     * True when this request carries a V2V edit video reference
+     * (`flow.ts --ref-video`). NOTE: this is NOT the scene-chaining seed
+     * (`inputKind: 'video'`), which the route supports on any model — it is the
+     * dedicated omni-flash V2V edit source. omni-flash-only on the veo-useapi route.
+     */
+    hasVideoRef?: boolean;
+    /**
+     * True when this request carries an omni-flash First-Frame (startImage / I2V)
+     * seed — the gated build-ahead identity-lock path (see VideoExecutionTask.
+     * firstFrame). A start image satisfies the omni-flash "voice needs a visual
+     * anchor" precondition just like an R2V image or V2V video. Only ever true on
+     * omni-flash once the `VCLAW_OMNI_FIRST_FRAME` gate is enabled; absent →
+     * byte-identical legacy behavior on the veo-useapi route.
+     */
+    hasStartImage?: boolean;
+}
+/** Options for {@link assertRouteRequestValid}. */
+export interface AssertRouteRequestValidOptions {
+    /** Defaults to `process.env`. Pure callers can inject a fixed map. */
+    env?: NodeJS.ProcessEnv;
+}
+/** Result of a capability check. `ok` is always true when no Error is thrown. */
+export interface RouteRequestValidation {
+    ok: boolean;
+    warnings: string[];
+}
+/**
+ * Gate for the omni-flash First-Frame (startImage / I2V) path, shared by the
+ * execution-runtime payload builder and the veo-useapi transport so a single env
+ * flag controls both layers.
+ *
+ * As of 2026-06-06 omni-flash startImage is LIVE on useapi.net (live-verified:
+ * the request routes to abra_i2v_8s / IMAGE_TO_VIDEO), so this is now ENABLED BY
+ * DEFAULT. `VCLAW_OMNI_FIRST_FRAME` is a kill-switch — only 0/false/no/off
+ * disables it (e.g. if the provider regresses). See VideoExecutionTask.firstFrame.
+ */
+export declare function isOmniFirstFrameEnabled(env?: NodeJS.ProcessEnv): boolean;
+/**
+ * Validate a {@link RouteRequest} against {@link ROUTE_CAPABILITIES} for the
+ * given route. Pure and deterministic (no fs/network); the only side input is
+ * `env` (default `process.env`), read once for the `VCLAW_ALLOW_UNSAFE_MODELS`
+ * escape hatch.
+ *
+ * Behavior:
+ *  - On a hard violation (resolution/duration/mode not supported, or refs over
+ *    budget), throws a clear {@link Error} — UNLESS `VCLAW_ALLOW_UNSAFE_MODELS`
+ *    is truthy, in which case each violation is downgraded to a `warnings[]`
+ *    entry and `{ ok: true }` is returned.
+ *  - A fully-valid (or empty) request returns `{ ok: true, warnings: [] }`.
+ *  - veo-useapi only: a `hasVoice` or `hasVideoRef` request whose `veoModel`
+ *    is not `omni-flash` is a violation (voice/V2V are omni-flash-only),
+ *    pushed through the same downgradable path.
+ *
+ * Only fields that are present on the request are checked, so partial requests
+ * never produce spurious violations for fields the caller did not supply.
+ */
+export declare function assertRouteRequestValid(routeId: ProviderRouteId, req: RouteRequest, opts?: AssertRouteRequestValidOptions): RouteRequestValidation;
+//# sourceMappingURL=route-capabilities.d.ts.map

package/dist/video/provider-platform/route-capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-capabilities.d.ts","sourceRoot":"","sources":["../../../src/video/provider-platform/route-capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,iBAAiB;IAChC,2EAA2E;IAC3E,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,uEAAuE;IACvE,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB;;;;;OAKG;IACH,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,+DAA+D;IAC/D,YAAY,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,YAAY,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,YAAY,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,YAAY,EAAE,OAAO,CAAC;IACtB,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,eAAe,EAAE,iBAAiB,CAwEzE,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,mDAAmD;AACnD,MAAM,WAAW,8BAA8B;IAC7C,sEAAsE;IACtE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED,iFAAiF;AACjF,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAQD;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAGrF;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,eAAe,EACxB,GAAG,EAAE,YAAY,EACjB,IAAI,GAAE,8BAAmC,GACxC,sBAAsB,CAuGxB"}

package/dist/video/provider-platform/route-capabilities.js

@@ -0,0 +1,192 @@
+/**
+ * Capability matrix for the four live provider routes. `veo-direct` is
+ * intentionally absent — it was an adapter-only phantom route with no native
+ * transport and has been removed from `ProviderRouteId`.
+ */
+export const ROUTE_CAPABILITIES = {
+    'veo-useapi': {
+        // These describe the ROUTE's capability envelope, not the current
+        // native-veo.ts transport's completeness. The Bun/Flow transport today
+        // forwards only referencePaths[0] and silently ignores extra references
+        // (it never rejects them), so the matrix must NOT hard-fail payloads the
+        // transport tolerates — doing so would change existing behavior:
+        //  - first-frame + last-frame image-to-video and ingredients-to-video
+        //    legitimately carry up to ~3 image references (cf. the former veo
+        //    descriptor's ingredients-to-video maxReferenceImages: 3).
+        //  - scene chaining carries the previous scene's video output as a single
+        //    seed input → maxVideoRefs: 1.
+        //  - no audio reference path exists, and no flow submits audio refs to this
+        //    route → audioCapable:false, maxAudioRefs:0.
+        //  - durationSeconds is passed straight through; UseAPI enforces
+        //    model-specific limits server-side → durationsSec left empty (=
+        //    unconstrained) so valid durations are never rejected here.
+        // veoRatio maps aspect → landscape/portrait/square (no resolution clamp).
+        modes: ['default'],
+        resolutions: ['720p', '1080p'],
+        durationsSec: [],
+        maxImageRefs: 3,
+        maxVideoRefs: 1,
+        maxAudioRefs: 0,
+        audioCapable: false,
+        notes: [
+            'Aggregator Veo route (native-veo.ts, Google Flow via useapi.net). Image refs cover first-frame/last-frame/ingredients (≤3); a single video ref is the scene-chaining seed. The transport currently forwards only the first image and ignores extras, so these caps describe route capability, not transport completeness. UseAPI enforces model-specific duration limits server-side.',
+        ],
+    },
+    'runway-useapi': {
+        // runway-useapi.ts: RUNWAY_MAX_IMAGE_REFS=11, RUNWAY_MAX_VIDEO_REFS=3,
+        // clampDuration -> 5/8/10/15, default mode 'explore' (free, low-res).
+        modes: ['explore', 'credits'],
+        resolutions: ['720p', '1080p'],
+        durationsSec: [5, 8, 10, 15],
+        maxImageRefs: 11,
+        maxVideoRefs: 3,
+        maxAudioRefs: 0,
+        audioCapable: false,
+        notes: [
+            "Default mode 'explore' is free, queued, and low-res; 'credits' is the paid faster path.",
+        ],
+    },
+    'dreamina-useapi': {
+        // dreamina-useapi.ts: 9 image / 3 video / 3 audio refs; resolutionFor ->
+        // 1080p (CA-only) else 720p; clampDuration -> 4/5/8/10/12/15.
+        modes: ['default'],
+        resolutions: ['720p', '1080p'],
+        durationsSec: [4, 5, 8, 10, 12, 15],
+        maxImageRefs: 9,
+        maxVideoRefs: 3,
+        maxAudioRefs: 3,
+        audioCapable: true,
+        regionGated: '1080p is CA-only; 720p works on both US and CA regions.',
+        notes: [
+            'Seedance 2.0 via Dreamina (useapi.net). Real human faces are rejected by content moderation.',
+        ],
+    },
+    'seedance-direct': {
+        // native-seedance.ts REFERENCE_BUDGET = { images: 9, videos: 3, audios: 3 }.
+        // 15s max per generation; longer videos use segmented stitching.
+        modes: ['fast', 'quality'],
+        resolutions: ['720p', '1080p'],
+        durationsSec: [5, 8, 10, 15],
+        maxImageRefs: 9,
+        maxVideoRefs: 3,
+        maxAudioRefs: 3,
+        audioCapable: true,
+        notes: [
+            'Direct Seedance 2.0 via xskill.ai. 15s max per generation. Photoreal face references are rejected — describe characters by visual descriptor.',
+        ],
+    },
+};
+function isTruthyEnv(value) {
+    if (!value)
+        return false;
+    const v = value.trim().toLowerCase();
+    return v !== '' && v !== '0' && v !== 'false' && v !== 'no' && v !== 'off';
+}
+/**
+ * Gate for the omni-flash First-Frame (startImage / I2V) path, shared by the
+ * execution-runtime payload builder and the veo-useapi transport so a single env
+ * flag controls both layers.
+ *
+ * As of 2026-06-06 omni-flash startImage is LIVE on useapi.net (live-verified:
+ * the request routes to abra_i2v_8s / IMAGE_TO_VIDEO), so this is now ENABLED BY
+ * DEFAULT. `VCLAW_OMNI_FIRST_FRAME` is a kill-switch — only 0/false/no/off
+ * disables it (e.g. if the provider regresses). See VideoExecutionTask.firstFrame.
+ */
+export function isOmniFirstFrameEnabled(env = process.env) {
+    const v = (env.VCLAW_OMNI_FIRST_FRAME ?? '').trim().toLowerCase();
+    return !(v === '0' || v === 'false' || v === 'no' || v === 'off');
+}
+/**
+ * Validate a {@link RouteRequest} against {@link ROUTE_CAPABILITIES} for the
+ * given route. Pure and deterministic (no fs/network); the only side input is
+ * `env` (default `process.env`), read once for the `VCLAW_ALLOW_UNSAFE_MODELS`
+ * escape hatch.
+ *
+ * Behavior:
+ *  - On a hard violation (resolution/duration/mode not supported, or refs over
+ *    budget), throws a clear {@link Error} — UNLESS `VCLAW_ALLOW_UNSAFE_MODELS`
+ *    is truthy, in which case each violation is downgraded to a `warnings[]`
+ *    entry and `{ ok: true }` is returned.
+ *  - A fully-valid (or empty) request returns `{ ok: true, warnings: [] }`.
+ *  - veo-useapi only: a `hasVoice` or `hasVideoRef` request whose `veoModel`
+ *    is not `omni-flash` is a violation (voice/V2V are omni-flash-only),
+ *    pushed through the same downgradable path.
+ *
+ * Only fields that are present on the request are checked, so partial requests
+ * never produce spurious violations for fields the caller did not supply.
+ */
+export function assertRouteRequestValid(routeId, req, opts = {}) {
+    const env = opts.env ?? process.env;
+    const allowUnsafe = isTruthyEnv(env.VCLAW_ALLOW_UNSAFE_MODELS);
+    const caps = ROUTE_CAPABILITIES[routeId];
+    const violations = [];
+    const warnings = [];
+    if (!caps) {
+        // Unknown route — treat as a hard violation (caller passed a non-live id).
+        violations.push(`Unknown provider route: ${routeId}`);
+    }
+    else {
+        if (req.resolution !== undefined && !caps.resolutions.includes(req.resolution)) {
+            violations.push(`Route ${routeId} does not support resolution ${req.resolution} (supported: ${caps.resolutions.join(', ')}).`);
+        }
+        if (req.durationSec !== undefined &&
+            caps.durationsSec.length > 0 &&
+            !caps.durationsSec.includes(req.durationSec)) {
+            violations.push(`Route ${routeId} does not support duration ${req.durationSec}s (supported: ${caps.durationsSec.join(', ')}s).`);
+        }
+        if (req.mode !== undefined && !caps.modes.includes(req.mode)) {
+            violations.push(`Route ${routeId} does not support mode '${req.mode}' (supported: ${caps.modes.join(', ')}).`);
+        }
+        if (req.imageRefs !== undefined && req.imageRefs > caps.maxImageRefs) {
+            violations.push(`Route ${routeId} accepts at most ${caps.maxImageRefs} image references (got ${req.imageRefs}).`);
+        }
+        if (req.videoRefs !== undefined && req.videoRefs > caps.maxVideoRefs) {
+            violations.push(`Route ${routeId} accepts at most ${caps.maxVideoRefs} video references (got ${req.videoRefs}).`);
+        }
+        if (req.audioRefs !== undefined && req.audioRefs > caps.maxAudioRefs) {
+            violations.push(`Route ${routeId} accepts at most ${caps.maxAudioRefs} audio references (got ${req.audioRefs}).`);
+        }
+        if (req.audioRefs !== undefined &&
+            req.audioRefs > 0 &&
+            caps.maxAudioRefs > 0 &&
+            !caps.audioCapable) {
+            violations.push(`Route ${routeId} is not audio-capable but ${req.audioRefs} audio reference(s) were supplied.`);
+        }
+        // veo-useapi model gate: voice narration and V2V edits are unlocked only by
+        // the omni-flash Flow v1 model (mirrors the Bun sidecar's validateFlowVideo
+        // throws). Fires only when the carrier field is actually present, so every
+        // legacy payload (voice/V2V absent) is a no-op and stays byte-identical.
+        if (routeId === 'veo-useapi') {
+            if (req.hasVideoRef && req.veoModel !== 'omni-flash') {
+                violations.push("Route veo-useapi: video-to-video (referenceVideoMediaId) requires veoModel 'omni-flash'.");
+            }
+            if (req.hasVoice && req.veoModel !== 'omni-flash') {
+                violations.push("Route veo-useapi: voice narration (voicePreset) requires veoModel 'omni-flash'.");
+            }
+            // Provider rule: referenceAudio requires an image (R2V), a video (V2V),
+            // or a first-frame startImage (I2V) reference — pure text-to-video + voice
+            // is rejected by Google. Fail fast in-process rather than burning a submit
+            // on a guaranteed rejection. (`hasStartImage` only goes true on omni-flash
+            // once the VCLAW_OMNI_FIRST_FRAME gate is enabled, so legacy stays exact.)
+            if (req.hasVoice &&
+                req.veoModel === 'omni-flash' &&
+                !(req.imageRefs && req.imageRefs > 0) &&
+                !req.hasVideoRef &&
+                !req.hasStartImage) {
+                violations.push("Route veo-useapi: voice narration requires a reference image (R2V) or referenceVideoMediaId (V2V); omni-flash text-to-video + voice is rejected by the provider.");
+            }
+        }
+    }
+    if (violations.length === 0) {
+        return { ok: true, warnings };
+    }
+    if (allowUnsafe) {
+        for (const v of violations) {
+            warnings.push(`VCLAW_ALLOW_UNSAFE_MODELS: ${v}`);
+        }
+        return { ok: true, warnings };
+    }
+    throw new Error(`Route capability check failed for ${routeId}: ${violations.join(' ')} ` +
+        `Set VCLAW_ALLOW_UNSAFE_MODELS=1 to downgrade these to warnings.`);
+}
+//# sourceMappingURL=route-capabilities.js.map

package/dist/video/provider-platform/route-capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-capabilities.js","sourceRoot":"","sources":["../../../src/video/provider-platform/route-capabilities.ts"],"names":[],"mappings":"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"}

package/dist/video/provider-platform/router.d.ts

@@ -0,0 +1,7 @@
+import type { ProviderHealthStatus, ProviderRouteId, ProviderRoutingPolicy, ProviderRoutingRequest, VideoProviderDescriptor, VideoProviderRoutingResult } from "./types.js";
+export declare function chooseVideoProviderRoute(request: ProviderRoutingRequest, options?: {
+    registry?: VideoProviderDescriptor[];
+    policy?: Partial<ProviderRoutingPolicy>;
+    health?: Partial<Record<ProviderRouteId, ProviderHealthStatus>>;
+}): VideoProviderRoutingResult;
+//# sourceMappingURL=router.d.ts.map

package/dist/video/provider-platform/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../../src/video/provider-platform/router.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,oBAAoB,EACpB,eAAe,EACf,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EAEvB,0BAA0B,EAC3B,MAAM,YAAY,CAAC;AAgIpB,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,sBAAsB,EAC/B,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,EAAE,uBAAuB,EAAE,CAAC;IACrC,MAAM,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACxC,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,oBAAoB,CAAC,CAAC,CAAC;CACjE,GACA,0BAA0B,CAyE5B"}

package/dist/video/provider-platform/router.js

@@ -0,0 +1,150 @@
+import { DEFAULT_PROVIDER_REGISTRY, DEFAULT_ROUTING_POLICY, } from "./registry.js";
+function getSupport(route, request) {
+    return route.operationSupport.find((support) => support.operation === request.operation &&
+        support.aspectRatios.includes(request.aspectRatio));
+}
+function costScore(route) {
+    switch (route.routingHints.costClass) {
+        case "free":
+            return 10;
+        case "low":
+            return 6;
+        case "medium":
+            return 3;
+        case "high":
+            return 0;
+    }
+}
+function latencyScore(route) {
+    switch (route.routingHints.latencyClass) {
+        case "low":
+            return 8;
+        case "medium":
+            return 4;
+        case "high":
+            return 1;
+    }
+}
+function providerOrderScore(routeId, providerOrder) {
+    const index = providerOrder.indexOf(routeId);
+    return index === -1 ? 0 : Math.max(providerOrder.length - index, 0);
+}
+function normalizeHealthStatus(routeId, health) {
+    return (health[routeId] ?? {
+        state: "healthy",
+        updatedAt: new Date(0).toISOString(),
+    });
+}
+function scoreRoute(route, request, policy) {
+    const reasons = [];
+    let score = providerOrderScore(route.id, policy.providerOrder);
+    if (request.preferredProvider === route.provider) {
+        score += 30;
+        reasons.push(`preferred provider matched (${route.provider})`);
+    }
+    if (request.preferredPath === route.path) {
+        score += 20;
+        reasons.push(`preferred path matched (${route.path})`);
+    }
+    if (policy.preferDirectForTrust && route.path === "direct") {
+        score += 15;
+        reasons.push("policy prefers direct path when capabilities already match");
+    }
+    if (policy.preferUseApiWhenCapabilitiesUnlock &&
+        route.id === "veo-useapi" &&
+        request.aspectRatio === "portrait" &&
+        (request.operation === "image-to-video" || request.operation === "frames-to-video")) {
+        score += 25;
+        reasons.push("useapi unlocks portrait Veo coverage missing on the direct path");
+    }
+    if (route.routingHints.preferredWorkflows.includes(request.workflow)) {
+        score += 12;
+        reasons.push(`route is tuned for ${request.workflow}`);
+    }
+    if (request.preferLowCost) {
+        score += costScore(route);
+        reasons.push(`cost class ${route.routingHints.costClass}`);
+    }
+    if (request.preferLowLatency) {
+        score += latencyScore(route);
+        reasons.push(`latency class ${route.routingHints.latencyClass}`);
+    }
+    if (request.requiredControls && request.requiredControls.length > 0) {
+        score += request.requiredControls.length * 5;
+        reasons.push(`supports required controls: ${request.requiredControls.join(", ")}`);
+    }
+    if (route.path === "useapi" && request.providerOptions) {
+        reasons.push("provider-specific options preserved via escape hatches");
+    }
+    if (reasons.length === 0) {
+        reasons.push("route satisfied the normalized contract");
+    }
+    return {
+        route,
+        score,
+        reasons,
+        retainedEscapeHatches: route.escapeHatches,
+    };
+}
+export function chooseVideoProviderRoute(request, options) {
+    const registry = options?.registry ?? DEFAULT_PROVIDER_REGISTRY;
+    const policy = {
+        ...DEFAULT_ROUTING_POLICY,
+        ...options?.policy,
+    };
+    const health = options?.health ?? {};
+    const filteredOut = [];
+    const candidates = registry.filter((route) => {
+        if (request.allowProviders && !request.allowProviders.includes(route.id)) {
+            filteredOut.push({ routeId: route.id, reason: "not in allowed provider set" });
+            return false;
+        }
+        if (request.denyProviders?.includes(route.id)) {
+            filteredOut.push({ routeId: route.id, reason: "explicitly denied" });
+            return false;
+        }
+        const routeHealth = normalizeHealthStatus(route.id, health);
+        if (routeHealth.state === "offline") {
+            filteredOut.push({ routeId: route.id, reason: "provider health is offline" });
+            return false;
+        }
+        if (routeHealth.state === "deprecated" && !policy.allowDeprecatedProviders) {
+            filteredOut.push({ routeId: route.id, reason: "provider is deprecated" });
+            return false;
+        }
+        if (routeHealth.state === "degraded" && !policy.allowDegradedProviders) {
+            filteredOut.push({ routeId: route.id, reason: "provider is degraded" });
+            return false;
+        }
+        const support = getSupport(route, request);
+        if (!support) {
+            filteredOut.push({
+                routeId: route.id,
+                reason: `${request.operation} ${request.aspectRatio} is unsupported`,
+            });
+            return false;
+        }
+        const missingControls = (request.requiredControls ?? []).filter((control) => !route.controls.includes(control));
+        if (missingControls.length > 0) {
+            filteredOut.push({
+                routeId: route.id,
+                reason: `missing required controls: ${missingControls.join(", ")}`,
+            });
+            return false;
+        }
+        return true;
+    });
+    if (candidates.length === 0) {
+        const reasons = filteredOut.map(({ routeId, reason }) => `${routeId}: ${reason}`);
+        throw new Error(`No provider route satisfies ${request.operation} (${request.aspectRatio}). ${reasons.join("; ")}`);
+    }
+    const decisions = candidates
+        .map((route) => scoreRoute(route, request, policy))
+        .sort((left, right) => right.score - left.score);
+    return {
+        primary: decisions[0],
+        fallbacks: decisions.slice(1),
+        filteredOut,
+    };
+}
+//# sourceMappingURL=router.js.map

package/dist/video/provider-platform/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../../src/video/provider-platform/router.ts"],"names":[],"mappings":"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"}

package/dist/video/provider-platform/security.d.ts

@@ -0,0 +1,8 @@
+import type { ProviderRouteId } from "./types.js";
+/**
+ * Validates that escape-hatch params are declared in the provider's
+ * adapter definition. Rejects unknown params to prevent injection
+ * of unsanctioned controls into UseAPI calls.
+ */
+export declare function validateEscapeHatches(routeId: ProviderRouteId, params: Record<string, unknown>): void;
+//# sourceMappingURL=security.d.ts.map

package/dist/video/provider-platform/security.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../../src/video/provider-platform/security.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGlD;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,IAAI,CAiBN"}

package/dist/video/provider-platform/security.js

@@ -0,0 +1,21 @@
+import { DEFAULT_PROVIDER_REGISTRY } from "./registry.js";
+/**
+ * Validates that escape-hatch params are declared in the provider's
+ * adapter definition. Rejects unknown params to prevent injection
+ * of unsanctioned controls into UseAPI calls.
+ */
+export function validateEscapeHatches(routeId, params) {
+    const route = DEFAULT_PROVIDER_REGISTRY.find((r) => r.id === routeId);
+    if (!route) {
+        throw new Error(`Unknown provider route: ${routeId}`);
+    }
+    const declaredNames = new Set(route.escapeHatches.map((h) => h.name));
+    const paramKeys = Object.keys(params);
+    for (const key of paramKeys) {
+        if (!declaredNames.has(key)) {
+            throw new Error(`Unknown escape hatch "${key}" for provider ${routeId}. ` +
+                `Declared: [${[...declaredNames].join(", ")}]`);
+        }
+    }
+}
+//# sourceMappingURL=security.js.map

package/dist/video/provider-platform/security.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.js","sourceRoot":"","sources":["../../../src/video/provider-platform/security.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAE1D;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAwB,EACxB,MAA+B;IAE/B,MAAM,KAAK,GAAG,yBAAyB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;IACtE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,2BAA2B,OAAO,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACtE,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEtC,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CACb,yBAAyB,GAAG,kBAAkB,OAAO,IAAI;gBACvD,cAAc,CAAC,GAAG,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACjD,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/video/provider-platform/telemetry.d.ts

@@ -0,0 +1,24 @@
+import type { TelemetryVerdict, VideoRunTelemetryRecord, VideoWorkflowKind } from "./types.js";
+export declare function createTelemetryRecord(input: Omit<VideoRunTelemetryRecord, "recordedAt">): VideoRunTelemetryRecord;
+export declare function appendTelemetryRecord(logPath: string, record: VideoRunTelemetryRecord): void;
+export declare function readTelemetryRecords(logPath: string): VideoRunTelemetryRecord[];
+export declare function summarizeTelemetry(records: VideoRunTelemetryRecord[]): {
+    totalRuns: number;
+    acceptedRuns: number;
+    averageLatencyMs: number;
+    averageRetries: number;
+    byWorkflow: {
+        workflow: VideoWorkflowKind;
+        runs: number;
+        accepted: number;
+        averageLatencyMs: number;
+    }[];
+};
+export declare function markVerdict(record: VideoRunTelemetryRecord, verdict: TelemetryVerdict, failureCause?: string): VideoRunTelemetryRecord;
+/**
+ * Sanitize a telemetry record by redacting any metadata values
+ * that match known secret env var values. Prevents accidental
+ * secret leakage in telemetry logs.
+ */
+export declare function sanitizeTelemetryRecord(record: VideoRunTelemetryRecord): VideoRunTelemetryRecord;
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/video/provider-platform/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../../src/video/provider-platform/telemetry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,gBAAgB,EAChB,uBAAuB,EACvB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,IAAI,CAAC,uBAAuB,EAAE,YAAY,CAAC,GACjD,uBAAuB,CAKzB;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,uBAAuB,GAC9B,IAAI,CAIN;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,uBAAuB,EAAE,CAU/E;AAOD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,uBAAuB,EAAE;;;;;;;;;;;EAqBpE;AAED,wBAAgB,WAAW,CACzB,MAAM,EAAE,uBAAuB,EAC/B,OAAO,EAAE,gBAAgB,EACzB,YAAY,CAAC,EAAE,MAAM,GACpB,uBAAuB,CAMzB;AAWD;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,uBAAuB,GAC9B,uBAAuB,CAqBzB"}