videoclaw 3.0.0-alpha.1

package/dist/video/providers/public-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-host.d.ts","sourceRoot":"","sources":["../../../src/video/providers/public-host.ts"],"names":[],"mappings":"AAiBA,MAAM,MAAM,mBAAmB,GAAG,CAChC,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,KACzE,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;CAAE,CAAC,CAAC;AAEvE,0FAA0F;AAC1F,eAAO,MAAM,aAAa,+BAA+B,CAAC;AAE1D,4FAA4F;AAC5F,eAAO,MAAM,6BAA6B,QAAoB,CAAC;AAE/D,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,uDAAuD;IACvD,GAAG,EAAE,MAAM,CAAC;IACZ,4DAA4D;IAC5D,SAAS,EAAE,OAAO,CAAC;CACpB;AA6BD;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,mBAAmB,CAAC,CA0C9B"}

package/dist/video/providers/public-host.js

@@ -0,0 +1,91 @@
+/**
+ * public-host.ts — upload a LOCAL file to a temporary public HTTPS host and
+ * return its URL.
+ *
+ * WHY: the hosted post-production backends (the apiz/suitui aggregator, and the
+ * fal.ai models behind it — Topaz upscale, OmniHuman lip-sync) fetch their
+ * inputs by URL and CANNOT read a local path. They also reliably BLOCK
+ * `catbox.moe` (server-side fetch returns a download error). `uguu.se` is the
+ * proven host: a plain multipart POST, fal-reachable, ~128 MiB cap, ~3h TTL —
+ * which is fine for a transient render input.
+ *
+ * The transport is injectable (`fetchImpl`) so callers can unit-test the upload
+ * shape offline without touching the network.
+ */
+import { readFile, stat } from 'node:fs/promises';
+import { basename } from 'node:path';
+/** Default temporary host. Override via `VCLAW_PUBLIC_HOST_ENDPOINT` for self-hosting. */
+export const UGUU_ENDPOINT = 'https://uguu.se/upload.php';
+/** uguu.se's documented upload cap. Override via maxBytes / VCLAW_PUBLIC_HOST_MAX_BYTES. */
+export const DEFAULT_PUBLIC_HOST_MAX_BYTES = 128 * 1024 * 1024;
+/**
+ * MIME type for a local file by extension (uguu infers from the filename, but a
+ * correct Content-Type avoids the occasional rejected upload).
+ */
+function contentTypeFor(path) {
+    const ext = path.slice(path.lastIndexOf('.')).toLowerCase();
+    const map = {
+        '.mp4': 'video/mp4', '.mov': 'video/quicktime', '.webm': 'video/webm',
+        '.mp3': 'audio/mpeg', '.wav': 'audio/wav', '.m4a': 'audio/mp4', '.aac': 'audio/aac',
+        '.jpg': 'image/jpeg', '.jpeg': 'image/jpeg', '.png': 'image/png', '.webp': 'image/webp',
+    };
+    return map[ext] ?? 'application/octet-stream';
+}
+/** Pull the first URL out of uguu's `{ success, files: [{ url }] }` response. */
+function extractUrl(parsed) {
+    if (parsed && typeof parsed === 'object') {
+        const files = parsed.files;
+        if (Array.isArray(files) && files[0] && typeof files[0].url === 'string') {
+            return files[0].url;
+        }
+        const direct = parsed.url;
+        if (typeof direct === 'string')
+            return direct;
+    }
+    return null;
+}
+/**
+ * Upload `localPath` and return a public URL. Throws on a non-2xx response or an
+ * unparseable body. Uses the global `fetch`/`FormData`/`Blob` (Node 20+) unless
+ * an injected `fetchImpl` is provided.
+ */
+export async function hostPublicUrl(localPath, options = {}) {
+    const env = options.env ?? process.env;
+    const endpoint = options.endpoint ?? env.VCLAW_PUBLIC_HOST_ENDPOINT ?? UGUU_ENDPOINT;
+    const fieldName = options.fieldName ?? 'files[]';
+    const fetchImpl = options.fetchImpl ?? globalThis.fetch;
+    const envMax = Number(env.VCLAW_PUBLIC_HOST_MAX_BYTES);
+    const maxBytes = options.maxBytes
+        ?? (Number.isFinite(envMax) && envMax > 0 ? envMax : DEFAULT_PUBLIC_HOST_MAX_BYTES);
+    // Guard the host's size cap BEFORE buffering the whole file in memory — a
+    // multi-hundred-MB master would otherwise burn RAM + upload time only to be
+    // rejected (or truncated) server-side.
+    const { size } = await stat(localPath);
+    if (size > maxBytes) {
+        throw new Error(`public-host: ${localPath} is ${(size / 1024 / 1024).toFixed(1)} MiB — over the host's ` +
+            `${Math.round(maxBytes / 1024 / 1024)} MiB cap. Trim/re-encode the input, or set ` +
+            `VCLAW_PUBLIC_HOST_ENDPOINT + VCLAW_PUBLIC_HOST_MAX_BYTES for a roomier host.`);
+    }
+    const bytes = await readFile(localPath);
+    const form = new FormData();
+    const blob = new Blob([bytes], { type: contentTypeFor(localPath) });
+    form.append(fieldName, blob, basename(localPath));
+    const response = await fetchImpl(endpoint, { method: 'POST', body: form });
+    const text = await response.text();
+    if (!response.ok) {
+        throw new Error(`public-host upload failed (${response.status}): ${text.slice(0, 300)}`);
+    }
+    let parsed = text;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        /* keep raw text for the error below */
+    }
+    const url = extractUrl(parsed);
+    if (!url) {
+        throw new Error(`public-host upload returned no URL: ${text.slice(0, 300)}`);
+    }
+    return { url, rawResult: parsed };
+}
+//# sourceMappingURL=public-host.js.map

package/dist/video/providers/public-host.js.map

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

package/dist/video/providers/runway-useapi.d.ts

@@ -0,0 +1,159 @@
+export type RunwayModel = 'gen-4.5' | 'gen-4' | 'gen-4-turbo' | 'seedance-2.0';
+export type RunwayMode = 'explore' | 'credits';
+export type RunwayAspectRatio = '16:9' | '9:16' | '1:1' | '4:3' | '3:4' | '21:9';
+export type RunwayResolution = '720p' | '1080p';
+/**
+ * Valid duration depends on the model:
+ *   - Gen-4.5 / Gen-4 / Gen-4 Turbo: 5, 8, 10
+ *   - Seedance 2.0 (via /videos/create): 5, 8, 10, 15
+ * Other models have their own ranges. UseAPI enforces server-side.
+ */
+export type RunwayDurationSeconds = 5 | 8 | 10 | 15;
+/**
+ * Minimal `fetch` shape that allows tests to inject a mock without depending
+ * on a full DOM `Response` type. Compatible with both `globalThis.fetch` and
+ * the matching helper in `../native-runway.ts`.
+ */
+export type RunwayFetchLike = (input: string, init?: {
+    method?: string;
+    headers?: Record<string, string>;
+    body?: string | Uint8Array;
+}) => Promise<{
+    ok: boolean;
+    status: number;
+    text: () => Promise<string>;
+    json: () => Promise<unknown>;
+}>;
+export interface SubmitRunwayJobInput {
+    apiToken: string;
+    model: RunwayModel;
+    textPrompt: string;
+    mode: RunwayMode;
+    seconds?: RunwayDurationSeconds;
+    aspectRatio?: RunwayAspectRatio;
+    resolution?: RunwayResolution;
+    seed?: number;
+    /**
+     * Optional END keyframe (UseAPI asset id). Seedance 2.0 (and Gen-4.5 / Kling 3
+     * / Veo 3.1) keyframe-interpolation mode: the clip animates from
+     * `startFrameAssetId` (image A) to `endFrameAssetId` (image B). Requires
+     * `startFrameAssetId`; ignored without it. Lets two stills become one
+     * continuous shot.
+     */
+    endFrameAssetId?: string;
+    /** Optional fetch override (defaults to global fetch). Used by tests + native wrapper. */
+    fetchImpl?: RunwayFetchLike;
+    /**
+     * UseAPI asset id (not a URL) — e.g. "user:2305-runwayml:email@example.com:uuid".
+     * Switches Gen-4.5 / Gen-4 into image-to-video mode. Not supported on
+     * /runwayml/videos/create for all models — check the endpoint docs.
+     */
+    firstImageAssetId?: string;
+    /**
+     * UseAPI asset id used as the Seedance-2 keyframe (first frame) on the
+     * unified /runwayml/videos/create endpoint. Distinct from
+     * firstImageAssetId (Gen-4.x i2v) — Seedance-2 uses startFrameAssetId.
+     */
+    startFrameAssetId?: string;
+    /**
+     * Seedance-2 multi-reference image asset ids (up to 11). When more than one
+     * is supplied on the `seedance-2.0` model, the request emits individual
+     * `imageAssetId1`..`imageAssetIdN` fields (1-based, capped at 11) and does
+     * NOT set `startFrameAssetId` — keyframe mode and multi-reference mode are
+     * mutually exclusive per the UseAPI Runway contract. Exactly one id keeps the
+     * single-keyframe `startFrameAssetId` path. See
+     * `references/video/seedance-transport-payloads.md` (Gateway B).
+     */
+    imageAssetIds?: string[];
+    /**
+     * Force multi-reference mode even for a SINGLE image asset id. Set when the
+     * lone image is a character reference (not a keyframe): it must go into
+     * `imageAssetId1`, never `startFrameAssetId`, so a character sheet is never
+     * the literal first frame of the video (the grid-open bug).
+     */
+    forceMultiRef?: boolean;
+    /**
+     * Seedance-2 multi-reference video asset ids (up to 3). Emitted as
+     * `videoAssetId`, `videoAssetId2`, `videoAssetId3`.
+     */
+    videoAssetIds?: string[];
+    /**
+     * Request provider-generated audio (`audio: true` on the body). Seedance-2 then
+     * generates speech/ambience — and, when a voice-reference video is supplied via
+     * `videoAssetIds`, speaks the dialogue in that cloned voice (the r2v voice-lock).
+     * Only emitted on the `seedance-2.0` model. Default off → byte-identical legacy.
+     */
+    audio?: boolean;
+}
+/** Runway Seedance-2 caps: up to 11 image refs, up to 3 video refs. */
+export declare const RUNWAY_MAX_IMAGE_REFS = 11;
+export declare const RUNWAY_MAX_VIDEO_REFS = 3;
+export interface SubmitRunwayJobResult {
+    /** Namespaced taskId, e.g. "user:N-runwayml:email@x:task:uuid". Use as-is in poll/fetch. */
+    taskId: string;
+}
+export declare function submitRunwayJob(input: SubmitRunwayJobInput): Promise<SubmitRunwayJobResult>;
+export interface PollRunwayJobInput {
+    apiToken: string;
+    /** Namespaced taskId from SubmitRunwayJobResult. */
+    taskId: string;
+    /** Optional fetch override (defaults to global fetch). */
+    fetchImpl?: RunwayFetchLike;
+}
+export type RunwayPollStatus = 'pending' | 'running' | 'completed' | 'failed';
+export interface RunwayArtifact {
+    /** Signed CloudFront URL of the rendered video. JWT in query string — expires. */
+    url?: string;
+    /** Pre-signed JPG preview thumbnails (typically 3-5 frames sampled across the clip). */
+    previewUrls?: string[];
+    /** Reusable Runway asset id for chaining into i2v / multi-shot workflows. */
+    assetId?: string;
+    fileSize?: string;
+    metadata?: {
+        duration?: number;
+        frameRate?: number;
+        dimensions?: [number, number];
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+export interface PollRunwayJobResult {
+    status: RunwayPollStatus;
+    /** 0.0 - 1.0 progress fraction, parsed from UseAPI's stringy progressRatio. */
+    progress: number;
+    artifacts: RunwayArtifact[];
+    raw: Record<string, unknown>;
+}
+export declare function pollRunwayJob(input: PollRunwayJobInput): Promise<PollRunwayJobResult>;
+export interface FetchRunwayResultInput {
+    apiToken: string;
+    taskId: string;
+    /** Optional fetch override (defaults to global fetch). */
+    fetchImpl?: RunwayFetchLike;
+}
+export interface FetchRunwayResultResult {
+    videoUrl: string | null;
+    thumbnailUrl: string | null;
+    raw: Record<string, unknown>;
+}
+/**
+ * Convenience: poll once and extract the first artifact's video + thumbnail URLs.
+ * Use after a poll has returned status='completed'.
+ */
+export declare function fetchRunwayResult(input: FetchRunwayResultInput): Promise<FetchRunwayResultResult>;
+export interface RegisterRunwayAccountInput {
+    apiToken: string;
+    email: string;
+    password: string;
+    maxJobs: number;
+}
+export interface RegisterRunwayAccountResult {
+    /** JWT bearer token UseAPI uses to authenticate against the user's Runway session. */
+    token: string;
+    /** UseAPI internal account id. */
+    id: number;
+    exp: number;
+    iat: number;
+}
+export declare function registerRunwayAccount(input: RegisterRunwayAccountInput): Promise<RegisterRunwayAccountResult>;
+//# sourceMappingURL=runway-useapi.d.ts.map

package/dist/video/providers/runway-useapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runway-useapi.d.ts","sourceRoot":"","sources":["../../../src/video/providers/runway-useapi.ts"],"names":[],"mappings":"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"}

package/dist/video/providers/runway-useapi.js

@@ -0,0 +1,200 @@
+import { withRetry, fetchTransientRetry } from '../with-retry.js';
+import { safeErrorBody } from '../http-error-safety.js';
+/** Runway Seedance-2 caps: up to 11 image refs, up to 3 video refs. */
+export const RUNWAY_MAX_IMAGE_REFS = 11;
+export const RUNWAY_MAX_VIDEO_REFS = 3;
+const USEAPI_BASE = 'https://api.useapi.net/v1';
+function endpointForModel(model) {
+    switch (model) {
+        case 'gen-4.5':
+            return { url: `${USEAPI_BASE}/runwayml/gen4_5/create`, includesModelInBody: false, durationField: 'seconds' };
+        case 'gen-4':
+            return { url: `${USEAPI_BASE}/runwayml/gen4/create`, includesModelInBody: false, durationField: 'seconds' };
+        case 'gen-4-turbo':
+            return { url: `${USEAPI_BASE}/runwayml/gen4turbo/create`, includesModelInBody: false, durationField: 'seconds' };
+        case 'seedance-2.0':
+            return { url: `${USEAPI_BASE}/runwayml/videos/create`, includesModelInBody: true, durationField: 'duration' };
+    }
+}
+/** Maps our internal model alias to the string UseAPI's unified endpoint expects. */
+function unifiedModelName(model) {
+    if (model === 'seedance-2.0')
+        return 'seedance-2';
+    return model;
+}
+export async function submitRunwayJob(input) {
+    const routing = endpointForModel(input.model);
+    const body = {
+        text_prompt: input.textPrompt,
+        exploreMode: input.mode === 'explore',
+    };
+    if (routing.includesModelInBody) {
+        body.model = unifiedModelName(input.model);
+    }
+    if (input.seconds)
+        body[routing.durationField] = input.seconds;
+    if (input.aspectRatio)
+        body.aspect_ratio = input.aspectRatio;
+    // Only Seedance-2 accepts an explicit resolution; Gen-4/4.5/4-turbo reject
+    // a `resolution` parameter outright ("Parameter resolution not supported").
+    if (input.resolution && input.model === 'seedance-2.0')
+        body.resolution = input.resolution;
+    if (input.seed)
+        body.seed = input.seed;
+    // Provider-generated audio is a seedance-2.0 capability on the unified endpoint.
+    if (input.audio && input.model === 'seedance-2.0')
+        body.audio = true;
+    if (input.firstImageAssetId)
+        body.firstImage_assetId = input.firstImageAssetId;
+    // Seedance-2 multi-reference: when >1 image asset id is supplied, emit the
+    // individual `imageAssetId1`..`imageAssetIdN` fields (1-based, capped 11) and
+    // OMIT `startFrameAssetId` — keyframe and multi-ref modes are mutually
+    // exclusive. Exactly one image asset id falls through to the single
+    // `startFrameAssetId` keyframe path (unchanged behavior). Multi-ref is only
+    // valid on the unified seedance-2 endpoint.
+    const imageRefs = (input.imageAssetIds ?? []).filter((id) => !!id);
+    const videoRefs = (input.videoAssetIds ?? []).filter((id) => !!id);
+    const useMultiRef = input.model === 'seedance-2.0'
+        && (imageRefs.length > 1 || (input.forceMultiRef === true && imageRefs.length === 1));
+    if (useMultiRef) {
+        if (imageRefs.length > RUNWAY_MAX_IMAGE_REFS) {
+            throw new Error(`Runway seedance-2 multi-reference accepts at most ${RUNWAY_MAX_IMAGE_REFS} image refs (got ${imageRefs.length}).`);
+        }
+        if (videoRefs.length > RUNWAY_MAX_VIDEO_REFS) {
+            throw new Error(`Runway seedance-2 multi-reference accepts at most ${RUNWAY_MAX_VIDEO_REFS} video refs (got ${videoRefs.length}).`);
+        }
+        imageRefs.forEach((assetId, idx) => {
+            body[`imageAssetId${idx + 1}`] = assetId;
+        });
+        videoRefs.forEach((assetId, idx) => {
+            body[idx === 0 ? 'videoAssetId' : `videoAssetId${idx + 1}`] = assetId;
+        });
+        // startFrameAssetId is intentionally NOT set in multi-ref mode.
+    }
+    else {
+        if (input.startFrameAssetId)
+            body.startFrameAssetId = input.startFrameAssetId;
+        // Single-ref convenience: a lone image asset id routes to the keyframe
+        // field on the seedance-2 endpoint when startFrameAssetId was not given.
+        if (!input.startFrameAssetId && input.model === 'seedance-2.0' && imageRefs.length === 1) {
+            body.startFrameAssetId = imageRefs[0];
+        }
+        // END keyframe: only valid alongside a start frame (keyframe-interpolation
+        // mode). The clip animates from startFrameAssetId → endFrameAssetId.
+        if (input.endFrameAssetId && body.startFrameAssetId) {
+            body.endFrameAssetId = input.endFrameAssetId;
+        }
+        if (videoRefs.length > 0) {
+            videoRefs.slice(0, RUNWAY_MAX_VIDEO_REFS).forEach((assetId, idx) => {
+                body[idx === 0 ? 'videoAssetId' : `videoAssetId${idx + 1}`] = assetId;
+            });
+        }
+    }
+    const fetchImpl = input.fetchImpl ?? fetch;
+    // Submit is a paid, non-idempotent generation POST (credits mode charges per
+    // accepted request). It is deliberately NOT wrapped in withRetry: replaying
+    // the same POST on a transient 5xx could create duplicate charged jobs if the
+    // provider accepted the first request before returning a gateway error.
+    // A single attempt; a transient failure surfaces to the caller. Poll (GET) is
+    // idempotent and keeps its retry below.
+    const response = await fetchImpl(routing.url, {
+        method: 'POST',
+        headers: {
+            'Authorization': `Bearer ${input.apiToken}`,
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify(body),
+    });
+    if (!response.ok) {
+        const text = await response.text();
+        throw new Error(`Runway submit failed: ${response.status} ${safeErrorBody(text)}`);
+    }
+    const json = (await response.json());
+    const taskId = json.task?.taskId ?? json.task?.id;
+    if (!taskId) {
+        throw new Error(`Runway submit returned unexpected shape (no task.taskId or task.id): ${JSON.stringify(json)}`);
+    }
+    return { taskId };
+}
+export async function pollRunwayJob(input) {
+    // UseAPI's path params are passed verbatim (no encoding). The namespaced
+    // taskId contains ':' which is valid in URL paths.
+    const url = `${USEAPI_BASE}/runwayml/tasks/${input.taskId}`;
+    const fetchImpl = input.fetchImpl ?? fetch;
+    // Retry transient network failures + HTTP 5xx; 4xx/non-ok flow through to the
+    // existing "Runway poll failed" message unchanged.
+    const response = await withRetry(() => fetchTransientRetry(fetchImpl, url, {
+        method: 'GET',
+        headers: { 'Authorization': `Bearer ${input.apiToken}` },
+    }));
+    if (!response.ok) {
+        const text = await response.text();
+        throw new Error(`Runway poll failed: ${response.status} ${safeErrorBody(text)}`);
+    }
+    const json = (await response.json());
+    const status = mapPollStatus(json.status);
+    const progress = json.progressRatio !== undefined ? parseFloat(json.progressRatio) : 0;
+    return {
+        status,
+        progress: Number.isFinite(progress) ? progress : 0,
+        artifacts: (json.artifacts ?? []),
+        raw: json,
+    };
+}
+function mapPollStatus(raw) {
+    const s = raw.toUpperCase();
+    if (s === 'COMPLETED' || s === 'SUCCEEDED' || s === 'DONE')
+        return 'completed';
+    if (s === 'FAILED' || s === 'ERROR' || s === 'CANCELED' || s === 'CANCELLED')
+        return 'failed';
+    if (s === 'RUNNING')
+        return 'running';
+    return 'pending'; // PENDING, QUEUED, INITIALIZING, etc.
+}
+/**
+ * Convenience: poll once and extract the first artifact's video + thumbnail URLs.
+ * Use after a poll has returned status='completed'.
+ */
+export async function fetchRunwayResult(input) {
+    const polled = await pollRunwayJob({
+        apiToken: input.apiToken,
+        taskId: input.taskId,
+        fetchImpl: input.fetchImpl,
+    });
+    const first = polled.artifacts[0];
+    return {
+        videoUrl: first?.url ?? null,
+        thumbnailUrl: first?.previewUrls?.[0] ?? null,
+        raw: polled.raw,
+    };
+}
+export async function registerRunwayAccount(input) {
+    if (input.maxJobs < 1 || input.maxJobs > 10) {
+        throw new Error('maxJobs must be 1-10');
+    }
+    // UseAPI's server does NOT URL-decode the email path param. Verbatim is required.
+    const url = `${USEAPI_BASE}/runwayml/accounts/${input.email}`;
+    const response = await fetch(url, {
+        method: 'POST',
+        headers: {
+            'Authorization': `Bearer ${input.apiToken}`,
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({ email: input.email, password: input.password, maxJobs: input.maxJobs }),
+    });
+    if (!response.ok) {
+        const text = await response.text();
+        throw new Error(`Runway account registration failed: ${response.status} ${safeErrorBody(text)}`);
+    }
+    // UseAPI wraps the JWT response in `{...creds, jwt: {token, id, exp, iat}}`
+    // Some responses return the JWT at the top level — handle both shapes.
+    const json = (await response.json());
+    if (json.jwt) {
+        return json.jwt;
+    }
+    if (json.token && json.id !== undefined) {
+        return { token: json.token, id: json.id, exp: json.exp ?? 0, iat: json.iat ?? 0 };
+    }
+    throw new Error(`Runway account registration returned unexpected shape: ${JSON.stringify(json)}`);
+}
+//# sourceMappingURL=runway-useapi.js.map

package/dist/video/providers/runway-useapi.js.map

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

package/dist/video/providers/xskill.d.ts

@@ -0,0 +1,108 @@
+/**
+ * xskill.ts — a thin REST client for the apiz.ai / suitui-ai aggregator (also
+ * branded "xskill" / "速推" / "NEX AI"), which fronts the fal.ai post-production
+ * models we need: Topaz video upscale and OmniHuman audio-driven lip-sync.
+ *
+ * It is NOT a per-scene generation route (those go through the storyboard →
+ * execute pipeline). It is the async-task client the new `finish` / `lipsync`
+ * commands call directly:
+ *   xskillSubmit(modelId, params) → taskId
+ *     → xskillAwait(taskId) polls until completed → the output URL
+ *       → xskillDownload(url, dest).
+ *
+ * The HTTP contract (verified against the live API + the MCP tool schemas):
+ *   POST  {base}/api/v3/tasks/create     Bearer <key>   { model_id, params }       → { task_id, status }
+ *   GET   {base}/api/v3/tasks/{task_id}  Bearer <key>                              → { status, result }
+ *   status ∈ pending | processing | completed | failed
+ *   output URL lives in `result` — `result.video.url` (video) / `result.images[].url` (image).
+ * The key is read from APIZ_API_KEY (the official CLI's var) or XSKILL_API_KEY
+ * (kept for continuity); its form is `sk-...`. Transports are injectable so the
+ * whole client is unit-testable offline.
+ */
+export declare const XSKILL_BASE = "https://api.apiz.ai";
+export declare const XSKILL_SUBMIT_PATH = "/api/v3/tasks/create";
+export declare const xskillTaskPath: (taskId: string) => string;
+export type XskillTaskStatus = 'pending' | 'processing' | 'completed' | 'failed';
+/** Minimal fetch surface for JSON submit/poll — injectable for offline tests. */
+export type XskillFetchLike = (url: string, init: {
+    method: string;
+    headers: Record<string, string>;
+    body?: string;
+}) => Promise<{
+    ok: boolean;
+    status: number;
+    text(): Promise<string>;
+}>;
+/** Fetch surface for binary download — injectable for offline tests. */
+export type XskillDownloadFetchLike = (url: string) => Promise<{
+    ok: boolean;
+    status: number;
+    arrayBuffer(): Promise<ArrayBuffer>;
+}>;
+export interface XskillClientOptions {
+    /** Explicit key; falls back to APIZ_API_KEY / XSKILL_API_KEY. */
+    apiKey?: string;
+    /** Base URL override (default {@link XSKILL_BASE}). */
+    baseUrl?: string;
+    env?: NodeJS.ProcessEnv;
+    fetchImpl?: XskillFetchLike;
+    /** Transient-retry budget for 429/5xx/network errors (default 3). */
+    maxRetries?: number;
+    /** Base backoff between retries, ms (default 800; grows linearly). */
+    retryBackoffMs?: number;
+}
+/** Resolve the API key from options/env, or throw a clear, actionable error. */
+export declare function resolveXskillApiKey(options?: XskillClientOptions): string;
+/**
+ * A failed xskill HTTP exchange, carrying the status (0 = network error — the
+ * request may or may not have reached the server) and the response/error body
+ * so callers can discriminate failure modes instead of regexing messages.
+ */
+export declare class XskillHttpError extends Error {
+    readonly status: number;
+    readonly body: string;
+    constructor(status: number, body: string);
+}
+/**
+ * Submit an async task. Body is `{ model_id, params }`. If the API rejects
+ * `model_id` with a 4xx validation error, it retries once with the alternate
+ * `model` field name (both appear in the CLI docs). Returns the task id.
+ */
+export declare function xskillSubmit(modelId: string, parameters: Record<string, unknown>, options?: XskillClientOptions): Promise<string>;
+export interface XskillTaskResult {
+    status: XskillTaskStatus;
+    /** Model-specific output container (`result.video.url`, `result.images[].url`, …). */
+    result: Record<string, unknown> | undefined;
+    /** The full parsed response, for diagnostics. */
+    raw: Record<string, unknown>;
+}
+/** Poll a task once. Returns the normalized status + result container. */
+export declare function xskillPoll(taskId: string, options?: XskillClientOptions): Promise<XskillTaskResult>;
+/** Extract the first output media URL from a task `result` container. */
+export declare function extractOutputUrl(result: Record<string, unknown> | undefined): string | null;
+export interface XskillAwaitOptions extends XskillClientOptions {
+    /** Poll interval, ms (default 5000). */
+    pollIntervalMs?: number;
+    /** Give up after this long, ms (default 600000 = 10 min). */
+    timeoutMs?: number;
+    /** Called after each poll with the latest status (for progress logging). */
+    onTick?: (status: XskillTaskStatus, elapsedMs: number) => void;
+    /** Injected clock (ms) for deterministic tests; defaults to Date.now. */
+    now?: () => number;
+}
+export interface XskillCompleted {
+    taskId: string;
+    videoUrl: string;
+    result: Record<string, unknown>;
+}
+/**
+ * Poll `taskId` until it completes. Resolves with the output URL on `completed`,
+ * throws on `failed` or when `timeoutMs` elapses. Pure of wall-clock except the
+ * injected `now`/`sleep` (overridable for tests).
+ */
+export declare function xskillAwait(taskId: string, options?: XskillAwaitOptions): Promise<XskillCompleted>;
+/** Download a completed output URL to `dest`. Uses global fetch unless injected. */
+export declare function xskillDownload(url: string, dest: string, options?: {
+    fetchImpl?: XskillDownloadFetchLike;
+}): Promise<string>;
+//# sourceMappingURL=xskill.d.ts.map

package/dist/video/providers/xskill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xskill.d.ts","sourceRoot":"","sources":["../../../src/video/providers/xskill.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,eAAO,MAAM,WAAW,wBAAwB,CAAC;AACjD,eAAO,MAAM,kBAAkB,yBAAyB,CAAC;AACzD,eAAO,MAAM,cAAc,GAAI,QAAQ,MAAM,KAAG,MAAuD,CAAC;AAExG,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,YAAY,GAAG,WAAW,GAAG,QAAQ,CAAC;AAEjF,iFAAiF;AACjF,MAAM,MAAM,eAAe,GAAG,CAC5B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,KACrE,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;CAAE,CAAC,CAAC;AAEvE,wEAAwE;AACxE,MAAM,MAAM,uBAAuB,GAAG,CACpC,GAAG,EAAE,MAAM,KACR,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAAA;CAAE,CAAC,CAAC;AAEnF,MAAM,WAAW,mBAAmB;IAClC,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,gFAAgF;AAChF,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,mBAAwB,GAAG,MAAM,CAU7E;AASD;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,KAAK;aAEtB,MAAM,EAAE,MAAM;aACd,IAAI,EAAE,MAAM;gBADZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM;CAK/B;AA8DD;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,MAAM,CAAC,CAyCjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,gBAAgB,CAAC;IACzB,sFAAsF;IACtF,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC5C,iDAAiD;IACjD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9B;AAED,0EAA0E;AAC1E,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAgB7G;AAED,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAe3F;AAED,MAAM,WAAW,kBAAmB,SAAQ,mBAAmB;IAC7D,wCAAwC;IACxC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/D,yEAAyE;IACzE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,eAAe,CAAC,CAsB5G;AAED,oFAAoF;AACpF,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,uBAAuB,CAAA;CAAO,GACpD,OAAO,CAAC,MAAM,CAAC,CAQjB"}