videoclaw 3.0.0-alpha.1

package/dist/video/seedance-asset-library.js

@@ -0,0 +1,146 @@
+import { existsSync } from 'node:fs';
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { resolveProjectWorkspace } from './workspace.js';
+const DEFAULT_BASE_URL = 'https://api.xskill.ai';
+function resolved(options) {
+    const apiKey = options.apiKey?.trim();
+    if (!apiKey) {
+        throw new Error('Seedance Asset Library requires an API key (SUTUI_API_KEY).');
+    }
+    return {
+        apiKey,
+        baseUrl: (options.baseUrl || DEFAULT_BASE_URL).replace(/\/+$/, ''),
+        fetchImpl: options.fetchImpl ?? fetch,
+        pollIntervalMs: options.pollIntervalMs ?? 1500,
+        maxSyncAttempts: options.maxSyncAttempts ?? 30,
+        sleep: options.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms))),
+    };
+}
+function headers(apiKey) {
+    return {
+        'Content-Type': 'application/json',
+        Authorization: `Bearer ${apiKey}`,
+        // Mirror the web app so the request is treated as a first-party call.
+        Origin: 'https://www.xskill.ai',
+        Referer: 'https://www.xskill.ai/',
+    };
+}
+async function request(fetchImpl, method, url, apiKey, body) {
+    const response = await fetchImpl(url, {
+        method,
+        headers: headers(apiKey),
+        ...(body !== undefined ? { body: JSON.stringify(body) } : {}),
+    });
+    if (!response.ok) {
+        throw new Error(`Asset Library ${method} ${url} failed with HTTP ${response.status}: ${await response.text()}`);
+    }
+    return response.json();
+}
+function pick(node, key) {
+    if (node && typeof node === 'object') {
+        const record = node;
+        if (key in record)
+            return record[key];
+        if (record.data && typeof record.data === 'object' && key in record.data) {
+            return record.data[key];
+        }
+    }
+    return undefined;
+}
+/** Find a group by exact name, or create it. Returns the group_id. */
+export async function ensureAssetGroup(name, options) {
+    const { apiKey, baseUrl, fetchImpl } = resolved(options);
+    const listed = await request(fetchImpl, 'GET', `${baseUrl}/api/v3/assets/groups`, apiKey);
+    const items = (pick(listed, 'items') ?? pick(listed, 'groups') ?? []);
+    const existing = items.find((group) => group.name === name);
+    if (existing && typeof existing.group_id === 'string') {
+        return existing.group_id;
+    }
+    const created = await request(fetchImpl, 'POST', `${baseUrl}/api/v3/assets/groups`, apiKey, {
+        name,
+        description: 'videoclaw character consistency assets',
+    });
+    const groupId = pick(created, 'group_id');
+    if (!groupId) {
+        throw new Error(`Asset Library group create for "${name}" returned no group_id.`);
+    }
+    return groupId;
+}
+async function findAssetSync(fetchImpl, baseUrl, apiKey, assetId) {
+    const listed = await request(fetchImpl, 'GET', `${baseUrl}/api/v3/assets?page_size=600`, apiKey);
+    const items = (pick(listed, 'items') ?? []);
+    return items.find((item) => item.asset_id === assetId);
+}
+/**
+ * Register a public image URL as an Image asset under the group, then poll until
+ * it has synced to the international Ark profile (sync_status "active") — ark
+ * rejects assets that are still "processing". Returns the Asset:// URI.
+ */
+export async function registerImageAsset(input, options) {
+    const { apiKey, baseUrl, fetchImpl, pollIntervalMs, maxSyncAttempts, sleep } = resolved(options);
+    const created = await request(fetchImpl, 'POST', `${baseUrl}/api/v3/assets`, apiKey, {
+        group_id: input.groupId,
+        name: input.name,
+        asset_type: 'Image',
+        image_url: input.imageUrl,
+        media_url: input.imageUrl,
+    });
+    const assetId = pick(created, 'asset_id');
+    const assetUri = pick(created, 'asset_uri');
+    if (!assetId || !assetUri) {
+        throw new Error(`Asset Library create for "${input.name}" returned no asset id/uri.`);
+    }
+    const intlAssetUri = pick(created, 'intl_asset_uri') ?? assetUri.replace(/^Asset:\/\//, 'asset://');
+    let syncStatus = pick(created, 'sync_status') ?? 'processing';
+    for (let attempt = 0; attempt < maxSyncAttempts && syncStatus !== 'active'; attempt += 1) {
+        await sleep(pollIntervalMs);
+        const found = await findAssetSync(fetchImpl, baseUrl, apiKey, assetId);
+        if (found?.sync_status)
+            syncStatus = found.sync_status;
+    }
+    if (syncStatus !== 'active') {
+        throw new Error(`Asset "${input.name}" (${assetId}) did not reach sync_status "active" (last: ${syncStatus}).`);
+    }
+    return { name: input.name, assetId, assetUri, intlAssetUri, syncStatus };
+}
+/**
+ * Read `artifacts/seedance-assets.json` for a project. Returns an empty lookup
+ * (no entries, empty map) when the artifact is absent — Seedance generations
+ * degrade gracefully to description-only / unmanaged references rather than
+ * failing. A present-but-malformed file is NOT swallowed: JSON.parse surfaces
+ * the corruption, matching sibling readers like product-references.ts.
+ */
+export async function readSeedanceAssets(workspaceRoot, slug) {
+    const workspace = resolveProjectWorkspace(slug, workspaceRoot);
+    const path = join(workspace.artifactsDir, 'seedance-assets.json');
+    if (!existsSync(path)) {
+        return { assets: [], assetUriByName: new Map() };
+    }
+    const parsed = JSON.parse(await readFile(path, 'utf-8'));
+    const assets = Array.isArray(parsed.assets)
+        ? parsed.assets.map((asset) => ({
+            name: asset.name,
+            assetId: asset.assetId,
+            assetUri: asset.assetUri,
+            intlAssetUri: asset.intlAssetUri,
+        }))
+        : [];
+    const assetUriByName = new Map();
+    for (const asset of assets) {
+        if (asset.name && asset.assetUri) {
+            assetUriByName.set(asset.name, asset.assetUri);
+        }
+    }
+    return { assets, assetUriByName };
+}
+/** High-level: ensure the group, register each character image, return the Asset:// URIs. */
+export async function registerCharacterAssets(input, options) {
+    const groupId = await ensureAssetGroup(input.groupName, options);
+    const registered = [];
+    for (const character of input.characters) {
+        registered.push(await registerImageAsset({ groupId, name: character.name, imageUrl: character.imageUrl }, options));
+    }
+    return registered;
+}
+//# sourceMappingURL=seedance-asset-library.js.map

package/dist/video/seedance-asset-library.js.map

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

package/dist/video/seedance-blocks.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Joey-style Seedance block emitters: Subject Lock / Frame Map / Cross-Frame /
+ * Last Frame. Pure/deterministic — no I/O.
+ *
+ * WS0 binding probe (docs/superpowers/notes/ark-reference-order-result.md) is
+ * RESOLVED positional: per UseAPI docs + production ARK payloads (2026-05-30),
+ * all three gateways honor reference ORDER as the `@imageN` mapping, so `@imageN`
+ * slots are emitted as a HARD positional binding contract — the slot label is the
+ * reference-order key, not a descriptive hint.
+ */
+/**
+ * WS0 reference-order binding mode. Resolved to `true`: positional binding is
+ * confirmed (UseAPI docs + production ARK payloads, 2026-05-30 — all three
+ * gateways honor reference ORDER as the `@imageN` mapping). `@imageN` is a hard
+ * positional reference-order contract, not guidance only.
+ */
+export declare const POSITIONAL_BINDING = true;
+export interface SubjectLockEntry {
+    label: string;
+    slot: string;
+}
+export interface FrameMapEntry {
+    t: string;
+    beat: string;
+}
+/** FRAME MAP — ordered beats with timecodes. */
+export declare function frameMapBlock(entries: FrameMapEntry[]): string;
+/** SUBJECT LOCK — per-character identity binding to @imageN slots. */
+export declare function subjectLockBlock(entries: SubjectLockEntry[]): string;
+/** CROSS-FRAME RULES — identity/geography stability across cuts. */
+export declare function crossFrameBlock(): string;
+/**
+ * Per-character POSITIONAL visual-descriptor line. Each subject is placed at a
+ * frame position (Center / Left / Right / …) carrying its VISUAL DESCRIPTOR
+ * (`entry.label`) — never a proper name. A missing descriptor falls back to a
+ * stable "as established in the reference image" so the slot still reads. Returns
+ * `''` for an empty list so single-subject / character-free scenes add nothing.
+ */
+export declare function buildPositionalDescriptorLine(entries: SubjectLockEntry[]): string;
+/**
+ * Explicit identity-lock / no-face-morph discipline line. Reuses the standing
+ * {@link noFaceMorphTag} rule (prompt-rules) so the "no face morphing" wording
+ * stays canonical across surfaces.
+ */
+export declare function buildIdentityLockLine(): string;
+/**
+ * Single-full-frame guard: forces the model to perform grid panels over time
+ * instead of reproducing a 3x3 collage as a moving split-screen. Shared between
+ * the grid-bearing packet variants and the opt-in text-discipline path so every
+ * multi-reference packet can carry the same guard text.
+ * See multi-shot-framework Anti-patterns ("Grid leakage").
+ */
+export declare const SINGLE_FULL_FRAME_GUARD = "Output a single full-frame cinematic shot that fills the entire frame edge to edge \u2014 no 3x3 grid, no split-screen, no panel borders, no collage, no multi-panel montage, no contact sheet, no reference-card layout. The character reference sheets and storyboard grid are reference ONLY \u2014 never reproduce the multi-panel sheet, the character-sheet grid, or any panel layout in the video; read identity and motion from them and render one continuous live scene. Perform any grid panels as consecutive moments over time, never as one image.";
+/** LAST FRAME — closing composition lock + sanctioned text suppression. */
+export declare function lastFrameBlock(closing: string): string;
+//# sourceMappingURL=seedance-blocks.d.ts.map

package/dist/video/seedance-blocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seedance-blocks.d.ts","sourceRoot":"","sources":["../../src/video/seedance-blocks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,CAAC,EAAE,MAAM,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;CACd;AAED,gDAAgD;AAChD,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,MAAM,CAG9D;AAED,sEAAsE;AACtE,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAMpE;AAED,oEAAoE;AACpE,wBAAgB,eAAe,IAAI,MAAM,CAExC;AA4BD;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,MAAM,CASjF;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,qiBACsf,CAAC;AAE3hB,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtD"}

package/dist/video/seedance-blocks.js

@@ -0,0 +1,97 @@
+/**
+ * Joey-style Seedance block emitters: Subject Lock / Frame Map / Cross-Frame /
+ * Last Frame. Pure/deterministic — no I/O.
+ *
+ * WS0 binding probe (docs/superpowers/notes/ark-reference-order-result.md) is
+ * RESOLVED positional: per UseAPI docs + production ARK payloads (2026-05-30),
+ * all three gateways honor reference ORDER as the `@imageN` mapping, so `@imageN`
+ * slots are emitted as a HARD positional binding contract — the slot label is the
+ * reference-order key, not a descriptive hint.
+ */
+import { noFaceMorphTag } from './prompt-rules.js';
+/**
+ * WS0 reference-order binding mode. Resolved to `true`: positional binding is
+ * confirmed (UseAPI docs + production ARK payloads, 2026-05-30 — all three
+ * gateways honor reference ORDER as the `@imageN` mapping). `@imageN` is a hard
+ * positional reference-order contract, not guidance only.
+ */
+export const POSITIONAL_BINDING = true;
+/** FRAME MAP — ordered beats with timecodes. */
+export function frameMapBlock(entries) {
+    const lines = entries.map((e) => `  ${e.t}: ${e.beat}`).join('\n');
+    return `FRAME MAP:\n${lines}`;
+}
+/** SUBJECT LOCK — per-character identity binding to @imageN slots. */
+export function subjectLockBlock(entries) {
+    if (entries.length === 0) {
+        return 'SUBJECT LOCK: preserve the primary subject identical across every frame.';
+    }
+    const lines = entries.map((e) => `  ${e.slot}: ${e.label} — lock this identity, do not alter.`).join('\n');
+    return `SUBJECT LOCK:\n${lines}`;
+}
+/** CROSS-FRAME RULES — identity/geography stability across cuts. */
+export function crossFrameBlock() {
+    return 'CROSS-FRAME RULES: face, hair, wardrobe, silhouette, palette, and geography stay identical across every cut; lighting logic and lens language established once and held.';
+}
+// ---------------------------------------------------------------------------
+// Text-discipline emitters (WS-C). The canonical multi-reference discipline
+// proven by the user's ARK payloads, factored as pure helpers so the same
+// wording is reused everywhere (and never drifts). All are opt-in: callers gate
+// them behind a flag so default output stays byte-stable.
+// ---------------------------------------------------------------------------
+/**
+ * Positional placements for {@link buildPositionalDescriptorLine}. Index 0 is
+ * the hero/centre, then the frame is read outward L/R. Matches the ARK habit of
+ * naming where each subject sits ("Center: …. Left: …. Right: ….").
+ */
+const POSITIONAL_PLACEMENTS = [
+    'Center',
+    'Left',
+    'Right',
+    'Far left',
+    'Far right',
+    'Background left',
+    'Background right',
+    'Background center',
+    'Foreground',
+];
+const POSITIONAL_FALLBACK_DESCRIPTOR = 'as established in the reference image';
+/**
+ * Per-character POSITIONAL visual-descriptor line. Each subject is placed at a
+ * frame position (Center / Left / Right / …) carrying its VISUAL DESCRIPTOR
+ * (`entry.label`) — never a proper name. A missing descriptor falls back to a
+ * stable "as established in the reference image" so the slot still reads. Returns
+ * `''` for an empty list so single-subject / character-free scenes add nothing.
+ */
+export function buildPositionalDescriptorLine(entries) {
+    if (entries.length === 0)
+        return '';
+    return entries
+        .map((entry, index) => {
+        const placement = POSITIONAL_PLACEMENTS[index] ?? `Subject ${index + 1}`;
+        const descriptor = entry.label.trim() || POSITIONAL_FALLBACK_DESCRIPTOR;
+        return `${placement}: ${descriptor}.`;
+    })
+        .join(' ');
+}
+/**
+ * Explicit identity-lock / no-face-morph discipline line. Reuses the standing
+ * {@link noFaceMorphTag} rule (prompt-rules) so the "no face morphing" wording
+ * stays canonical across surfaces.
+ */
+export function buildIdentityLockLine() {
+    return `Keep each character identical to her reference image, ${noFaceMorphTag().split(',')[0]}.`;
+}
+/**
+ * Single-full-frame guard: forces the model to perform grid panels over time
+ * instead of reproducing a 3x3 collage as a moving split-screen. Shared between
+ * the grid-bearing packet variants and the opt-in text-discipline path so every
+ * multi-reference packet can carry the same guard text.
+ * See multi-shot-framework Anti-patterns ("Grid leakage").
+ */
+export const SINGLE_FULL_FRAME_GUARD = 'Output a single full-frame cinematic shot that fills the entire frame edge to edge — no 3x3 grid, no split-screen, no panel borders, no collage, no multi-panel montage, no contact sheet, no reference-card layout. The character reference sheets and storyboard grid are reference ONLY — never reproduce the multi-panel sheet, the character-sheet grid, or any panel layout in the video; read identity and motion from them and render one continuous live scene. Perform any grid panels as consecutive moments over time, never as one image.';
+/** LAST FRAME — closing composition lock + sanctioned text suppression. */
+export function lastFrameBlock(closing) {
+    return `LAST FRAME: ${closing}. No on-screen text, no captions, no signage typography, no rendered text in the frame.`;
+}
+//# sourceMappingURL=seedance-blocks.js.map

package/dist/video/seedance-blocks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seedance-blocks.js","sourceRoot":"","sources":["../../src/video/seedance-blocks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAYvC,gDAAgD;AAChD,MAAM,UAAU,aAAa,CAAC,OAAwB;IACpD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnE,OAAO,eAAe,KAAK,EAAE,CAAC;AAChC,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,gBAAgB,CAAC,OAA2B;IAC1D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,0EAA0E,CAAC;IACpF,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,KAAK,sCAAsC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3G,OAAO,kBAAkB,KAAK,EAAE,CAAC;AACnC,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,eAAe;IAC7B,OAAO,0KAA0K,CAAC;AACpL,CAAC;AAED,8EAA8E;AAC9E,4EAA4E;AAC5E,0EAA0E;AAC1E,gFAAgF;AAChF,0DAA0D;AAC1D,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,qBAAqB,GAAG;IAC5B,QAAQ;IACR,MAAM;IACN,OAAO;IACP,UAAU;IACV,WAAW;IACX,iBAAiB;IACjB,kBAAkB;IAClB,mBAAmB;IACnB,YAAY;CACJ,CAAC;AAEX,MAAM,8BAA8B,GAAG,uCAAuC,CAAC;AAE/E;;;;;;GAMG;AACH,MAAM,UAAU,6BAA6B,CAAC,OAA2B;IACvE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACpC,OAAO,OAAO;SACX,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QACpB,MAAM,SAAS,GAAG,qBAAqB,CAAC,KAAK,CAAC,IAAI,WAAW,KAAK,GAAG,CAAC,EAAE,CAAC;QACzE,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,8BAA8B,CAAC;QACxE,OAAO,GAAG,SAAS,KAAK,UAAU,GAAG,CAAC;IACxC,CAAC,CAAC;SACD,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO,yDAAyD,cAAc,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;AACpG,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAClC,whBAAwhB,CAAC;AAE3hB,2EAA2E;AAC3E,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,OAAO,eAAe,OAAO,yFAAyF,CAAC;AACzH,CAAC"}

package/dist/video/seedance-chain-host.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Hosting the auto-chain seed for the seedance-direct route.
+ *
+ * Auto-chain feeds scene N's rendered video into scene N+1 as a continuity
+ * reference. On runway/dreamina-useapi the transport uploads that local file
+ * itself, but **seedance-direct rejects local paths** — a reference must be a
+ * hosted HTTP(S) URL or an `Asset://` avatar URI. A whole-video host is also not
+ * available with the project's current credentials, so this module takes the
+ * proven seedance keyframe path instead: extract the prior scene's **last
+ * frame** as a still image, upload it to Go Bananas (which returns a public R2
+ * URL), and hand that hosted image back as the chain seed. native-seedance then
+ * routes a `.jpg` URL into `reference_images` (the image-to-video keyframe).
+ *
+ * Pure orchestration with injectable I/O deps (`extractLastFrame` + `uploadImage`)
+ * so the wiring is exercised fully offline; `defaultChainSeedHostDeps` supplies
+ * the real ffmpeg + Go Bananas implementations for production.
+ */
+/** Injected I/O for {@link hostChainSeedAsImage} — real impls in {@link defaultChainSeedHostDeps}. */
+export interface ChainSeedHostDeps {
+    /** Extract the final frame of a local video into an image file (jpg). */
+    extractLastFrame: (videoPath: string, outImagePath: string) => Promise<void>;
+    /** Upload a local image file; resolve to its public hosted URL. */
+    uploadImage: (imagePath: string) => Promise<string>;
+}
+/**
+ * True when a chain-seed path is a LOCAL video that must be hosted before a
+ * seedance-direct submit. Already-hosted URLs, `Asset://` avatar URIs, and
+ * non-video paths are left alone (they submit as-is or are not chain seeds).
+ */
+export declare function chainSeedNeedsHosting(path: string): boolean;
+/**
+ * Transform a local-video chain seed into a hosted last-frame image URL. Returns
+ * the path UNCHANGED when it doesn't need hosting (already a URL / `Asset://` /
+ * not a local video), so the caller can apply it unconditionally.
+ *
+ * On the hosting path it writes the extracted frame under `workDir` and returns
+ * the uploaded image's public URL.
+ */
+export declare function hostChainSeedAsImage(localVideoPath: string, workDir: string, deps: ChainSeedHostDeps): Promise<string>;
+/** Production deps: real ffmpeg last-frame extraction + Go Bananas image hosting. */
+export declare function defaultChainSeedHostDeps(env?: NodeJS.ProcessEnv, fetcher?: typeof fetch): ChainSeedHostDeps;
+//# sourceMappingURL=seedance-chain-host.d.ts.map

package/dist/video/seedance-chain-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seedance-chain-host.d.ts","sourceRoot":"","sources":["../../src/video/seedance-chain-host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAUH,sGAAsG;AACtG,MAAM,WAAW,iBAAiB;IAChC,yEAAyE;IACzE,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E,mEAAmE;IACnE,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACrD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAM3D;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,MAAM,CAAC,CAOjB;AA4ED,qFAAqF;AACrF,wBAAgB,wBAAwB,CACtC,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,OAAO,GAAE,OAAO,KAAa,GAC5B,iBAAiB,CAKnB"}

package/dist/video/seedance-chain-host.js

@@ -0,0 +1,128 @@
+/**
+ * Hosting the auto-chain seed for the seedance-direct route.
+ *
+ * Auto-chain feeds scene N's rendered video into scene N+1 as a continuity
+ * reference. On runway/dreamina-useapi the transport uploads that local file
+ * itself, but **seedance-direct rejects local paths** — a reference must be a
+ * hosted HTTP(S) URL or an `Asset://` avatar URI. A whole-video host is also not
+ * available with the project's current credentials, so this module takes the
+ * proven seedance keyframe path instead: extract the prior scene's **last
+ * frame** as a still image, upload it to Go Bananas (which returns a public R2
+ * URL), and hand that hosted image back as the chain seed. native-seedance then
+ * routes a `.jpg` URL into `reference_images` (the image-to-video keyframe).
+ *
+ * Pure orchestration with injectable I/O deps (`extractLastFrame` + `uploadImage`)
+ * so the wiring is exercised fully offline; `defaultChainSeedHostDeps` supplies
+ * the real ffmpeg + Go Bananas implementations for production.
+ */
+import { mkdir, readFile } from 'node:fs/promises';
+import { basename, extname, join } from 'node:path';
+import { runFfmpeg } from './assemble/ffmpeg.js';
+const HOSTED_RE = /^https?:\/\//i;
+const VIDEO_EXTS = new Set(['.mp4', '.mov', '.webm', '.avi', '.mkv']);
+const GO_BANANAS_DEFAULT_BASE_URL = 'https://gobananasai.com/api';
+/**
+ * True when a chain-seed path is a LOCAL video that must be hosted before a
+ * seedance-direct submit. Already-hosted URLs, `Asset://` avatar URIs, and
+ * non-video paths are left alone (they submit as-is or are not chain seeds).
+ */
+export function chainSeedNeedsHosting(path) {
+    if (!path)
+        return false;
+    if (HOSTED_RE.test(path))
+        return false; // already a hosted URL
+    if (path.startsWith('Asset://'))
+        return false; // managed avatar URI
+    const ext = (path.split('?')[0]?.match(/\.[^.\\/]+$/)?.[0] ?? '').toLowerCase();
+    return VIDEO_EXTS.has(ext);
+}
+/**
+ * Transform a local-video chain seed into a hosted last-frame image URL. Returns
+ * the path UNCHANGED when it doesn't need hosting (already a URL / `Asset://` /
+ * not a local video), so the caller can apply it unconditionally.
+ *
+ * On the hosting path it writes the extracted frame under `workDir` and returns
+ * the uploaded image's public URL.
+ */
+export async function hostChainSeedAsImage(localVideoPath, workDir, deps) {
+    if (!chainSeedNeedsHosting(localVideoPath))
+        return localVideoPath;
+    await mkdir(workDir, { recursive: true });
+    const stem = basename(localVideoPath, extname(localVideoPath));
+    const outImage = join(workDir, `${stem}-lastframe.jpg`);
+    await deps.extractLastFrame(localVideoPath, outImage);
+    return deps.uploadImage(outImage);
+}
+/** Extract the final frame of `videoPath` to `outImagePath` (jpg) via ffmpeg. */
+async function ffmpegExtractLastFrame(videoPath, outImagePath) {
+    // `-sseof -1` seeks to one second before EOF (an input option, so it precedes
+    // `-i`); `-update 1 -frames:v 1` then writes the single final decoded frame.
+    await runFfmpeg([
+        '-sseof', '-1',
+        '-i', videoPath,
+        '-update', '1',
+        '-frames:v', '1',
+        '-q:v', '2',
+        outImagePath,
+    ]);
+}
+/** Pull the public hosted URL out of a Go Bananas `/images/upload` response (shape-tolerant). */
+function extractPublicUrl(json) {
+    const data = json.data;
+    const candidates = [
+        json.public_url,
+        json.publicUrl,
+        json.full_url,
+        json.fullUrl,
+        json.url,
+        json.image_url,
+        json.imageUrl,
+        data?.public_url,
+        data?.url,
+    ];
+    for (const candidate of candidates) {
+        if (typeof candidate === 'string' && candidate.length > 0)
+            return candidate;
+    }
+    return undefined;
+}
+/**
+ * Upload a local image to Go Bananas' multipart upload endpoint and return its
+ * public R2 URL. Mirrors the proven flow in `outpaint-keyframe.ts`:
+ *   POST {apiBase}/images/upload  (multipart/form-data, field `file`)
+ *     → { image_id, public_url, ... }
+ */
+async function goBananasUploadImage(imagePath, env, fetcher) {
+    const apiKey = (env.GO_BANANAS_API_KEY ?? '').trim();
+    if (!apiKey) {
+        throw new Error('GO_BANANAS_API_KEY is required to host the seedance chain seed (last-frame image).');
+    }
+    const apiBase = (env.GO_BANANAS_API_URL ?? GO_BANANAS_DEFAULT_BASE_URL).trim();
+    const bytes = await readFile(imagePath);
+    const form = new FormData();
+    // Do NOT set Content-Type — FormData sets the multipart boundary itself.
+    form.append('file', new Blob([new Uint8Array(bytes)], { type: 'image/jpeg' }), basename(imagePath));
+    const res = await fetcher(`${apiBase}/images/upload`, {
+        method: 'POST',
+        headers: { 'X-API-Key': apiKey },
+        body: form,
+    });
+    if (!res.ok) {
+        const text = await res.text().catch(() => '(no body)');
+        throw new Error(`go-bananas chain-seed upload HTTP ${res.status}: ${text.slice(0, 200)}`);
+    }
+    const json = (await res.json().catch(() => ({})));
+    const url = extractPublicUrl(json);
+    if (!url) {
+        throw new Error(`go-bananas chain-seed upload returned no public URL: ${JSON.stringify(json).slice(0, 200)}`);
+    }
+    return url;
+}
+/** Production deps: real ffmpeg last-frame extraction + Go Bananas image hosting. */
+export function defaultChainSeedHostDeps(env = process.env, fetcher = fetch) {
+    return {
+        extractLastFrame: ffmpegExtractLastFrame,
+        uploadImage: (imagePath) => goBananasUploadImage(imagePath, env, fetcher),
+    };
+}
+//# sourceMappingURL=seedance-chain-host.js.map

package/dist/video/seedance-chain-host.js.map

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

package/dist/video/seedance-content-filter.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Seedance 2.0 content-filter logic.
+ *
+ * A faithful TypeScript port of the content-filter functions in
+ * `skills/video-replicator/scripts/seedance_client.py`
+ * (pre_validate_prompt, sanitize_prompt L1/L2, is_content_violation,
+ * _suggest_recovery). Pure and deterministic — no I/O, no network.
+ *
+ * Seedance enforces strict server-side safety filters (prompt scan + input
+ * analysis). Filters tightened significantly after launch due to Hollywood IP
+ * backlash, deepfake concerns, and Chinese regulatory requirements. Risk
+ * categories (per the source skill):
+ *
+ *   HIGH RISK (almost always blocked):
+ *   - Real human faces/photos as reference images
+ *   - Children/minors
+ *   - Celebrity/public figure names or strong likenesses
+ *   - Copyrighted characters/IP (Marvel, Disney, Star Wars, anime named, ...)
+ *   - NSFW / nudity / sexual / suggestive content
+ *   - Political figures or sensitive political topics
+ *
+ *   MEDIUM RISK (sometimes blocked, retry with sanitization):
+ *   - Realistic human figures without stylization cues
+ *   - Brand names, trademarks, product names
+ *   - Violence/combat (graphic)
+ *
+ *   SAFE (reliable):
+ *   - Generic "young adult figure", "elegant dancer", "athletic person"
+ *   - Fully stylized: anime, cartoon, 3D render, illustration, painting
+ *   - Camera/motion descriptors: dolly, pan, push in, slow zoom, cinematic
+ *   - Environment/nature/architecture without identifiable real places
+ */
+export type ContentFilterLevel = 'HIGH' | 'MEDIUM' | 'LOW';
+export interface ContentFilterWarning {
+    level: ContentFilterLevel;
+    reason: string;
+    match: string;
+}
+/**
+ * Check if an error message indicates a content regulation violation
+ * (error code 2038). These errors come from Seedance's Chinese content
+ * moderation and are retryable with prompt sanitization.
+ *
+ * Port of `is_content_violation`.
+ */
+export declare function isContentViolation(errorMsg: string): boolean;
+/**
+ * Check a prompt for likely content filter triggers before submission.
+ *
+ * Returns a list of warnings, each with `{ level, reason, match }`.
+ *   HIGH   — near-certain filter triggers.
+ *   MEDIUM — sometimes pass but should be reworded if errors occur.
+ *   LOW    — advisory only.
+ *
+ * Port of `pre_validate_prompt`.
+ */
+export declare function preValidatePrompt(prompt: string): ContentFilterWarning[];
+/**
+ * Sanitize a prompt to avoid content regulation violations.
+ *
+ * @param prompt Original prompt text (may contain @image1/@video1/@audio1 refs).
+ * @param level  Sanitization aggressiveness:
+ *   1 = Light: strip brand names, celebrity/IP names, marketing superlatives,
+ *       replace minors with "young adult".
+ *   2 = Heavy: reduce to pure camera motion + generic visual description.
+ *
+ * Media references (@image1, @video1, @audio1) are extracted and re-prefixed
+ * at the start (where Seedance expects them).
+ *
+ * Port of `sanitize_prompt`.
+ */
+export declare function sanitizePrompt(prompt: string, level?: number): string;
+/**
+ * Suggest a fix based on the error message.
+ *
+ * Port of `_suggest_recovery` (the `prompt` argument in the Python source is
+ * unused, so it is omitted here).
+ */
+export declare function suggestRecovery(errorMsg: string): string;
+//# sourceMappingURL=seedance-content-filter.d.ts.map

package/dist/video/seedance-content-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seedance-content-filter.d.ts","sourceRoot":"","sources":["../../src/video/seedance-content-filter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE3D,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,kBAAkB,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAkDD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAW5D;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,oBAAoB,EAAE,CAqGxE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,MAAM,CAmBhE;AAkDD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA8BxD"}