videoclaw 3.0.0-alpha.1

package/dist/video/image-dimensions.js

@@ -0,0 +1,54 @@
+import { readFile } from 'node:fs/promises';
+const PNG_SIGNATURE = Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]);
+function readPngDimensions(buffer) {
+    if (buffer.length < 24 || !buffer.subarray(0, 8).equals(PNG_SIGNATURE)) {
+        return null;
+    }
+    return {
+        width: buffer.readUInt32BE(16),
+        height: buffer.readUInt32BE(20),
+        format: 'png',
+    };
+}
+function readJpegDimensions(buffer) {
+    if (buffer.length < 4 || buffer[0] !== 0xff || buffer[1] !== 0xd8) {
+        return null;
+    }
+    let offset = 2;
+    while (offset < buffer.length) {
+        while (buffer[offset] === 0xff) {
+            offset += 1;
+        }
+        const marker = buffer[offset];
+        offset += 1;
+        if (marker === undefined || marker === 0xd9 || marker === 0xda) {
+            break;
+        }
+        if (offset + 2 > buffer.length) {
+            break;
+        }
+        const segmentLength = buffer.readUInt16BE(offset);
+        if (segmentLength < 2 || offset + segmentLength > buffer.length) {
+            break;
+        }
+        const isStartOfFrame = marker >= 0xc0 &&
+            marker <= 0xcf &&
+            marker !== 0xc4 &&
+            marker !== 0xc8 &&
+            marker !== 0xcc;
+        if (isStartOfFrame && segmentLength >= 7) {
+            return {
+                height: buffer.readUInt16BE(offset + 3),
+                width: buffer.readUInt16BE(offset + 5),
+                format: 'jpeg',
+            };
+        }
+        offset += segmentLength;
+    }
+    return null;
+}
+export async function readImageDimensions(path) {
+    const buffer = await readFile(path);
+    return readPngDimensions(buffer) ?? readJpegDimensions(buffer);
+}
+//# sourceMappingURL=image-dimensions.js.map

package/dist/video/image-dimensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-dimensions.js","sourceRoot":"","sources":["../../src/video/image-dimensions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAQ5C,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AAEpF,SAAS,iBAAiB,CAAC,MAAc;IACvC,IAAI,MAAM,CAAC,MAAM,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;QACvE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,MAAM,EAAE,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;QAC/B,MAAM,EAAE,KAAK;KACd,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,MAAc;IACxC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAClE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,OAAO,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;YAC/B,MAAM,IAAI,CAAC,CAAC;QACd,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QAC9B,MAAM,IAAI,CAAC,CAAC;QAEZ,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YAC/D,MAAM;QACR,CAAC;QACD,IAAI,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;YAC/B,MAAM;QACR,CAAC;QACD,MAAM,aAAa,GAAG,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAClD,IAAI,aAAa,GAAG,CAAC,IAAI,MAAM,GAAG,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;YAChE,MAAM;QACR,CAAC;QAED,MAAM,cAAc,GAClB,MAAM,IAAI,IAAI;YACd,MAAM,IAAI,IAAI;YACd,MAAM,KAAK,IAAI;YACf,MAAM,KAAK,IAAI;YACf,MAAM,KAAK,IAAI,CAAC;QAClB,IAAI,cAAc,IAAI,aAAa,IAAI,CAAC,EAAE,CAAC;YACzC,OAAO;gBACL,MAAM,EAAE,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;gBACvC,KAAK,EAAE,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;gBACtC,MAAM,EAAE,MAAM;aACf,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,aAAa,CAAC;IAC1B,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAY;IACpD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;IACpC,OAAO,iBAAiB,CAAC,MAAM,CAAC,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC;AACjE,CAAC"}

package/dist/video/legacy-import.d.ts

@@ -0,0 +1,11 @@
+import type { LegacyImportSummary } from './types.js';
+export interface LegacyImportResult {
+    slug: string;
+    sourcePath: string;
+    imported: boolean;
+    skipped: boolean;
+    summaryPath?: string;
+}
+export declare function inspectLegacyProject(sourcePath: string): Promise<LegacyImportSummary>;
+export declare function importLegacyProjects(sourceRoot: string, targetRoot?: string): Promise<LegacyImportResult[]>;
+//# sourceMappingURL=legacy-import.d.ts.map

package/dist/video/legacy-import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-import.d.ts","sourceRoot":"","sources":["../../src/video/legacy-import.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGtD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAqBD,wBAAsB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAwE3F;AAcD,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,EAClB,UAAU,SAAgB,GACzB,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAuE/B"}

package/dist/video/legacy-import.js

@@ -0,0 +1,181 @@
+import { mkdir, readdir, readFile, writeFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { basename, join, resolve } from 'node:path';
+import { appendProjectEvent } from './events.js';
+import { getBuiltinPipelineManifest } from './pipeline-manifest.js';
+import { ensureProjectWorkspace, readProjectManifest, updateProjectManifestMetadata, writeProjectManifest } from './workspace.js';
+async function countFiles(dirPath, pattern) {
+    if (!existsSync(dirPath))
+        return 0;
+    const entries = await readdir(dirPath, { withFileTypes: true });
+    return entries.filter((entry) => entry.isFile() && pattern.test(entry.name)).length;
+}
+function objectContainsPendingStatus(value) {
+    if (typeof value === 'string') {
+        return value.trim().toLowerCase() === 'pending';
+    }
+    if (Array.isArray(value)) {
+        return value.some((item) => objectContainsPendingStatus(item));
+    }
+    if (value && typeof value === 'object') {
+        return Object.values(value).some((item) => objectContainsPendingStatus(item));
+    }
+    return false;
+}
+export async function inspectLegacyProject(sourcePath) {
+    const imagesDir = join(sourcePath, 'images');
+    const videosDir = join(sourcePath, 'videos');
+    const finalDir = join(sourcePath, 'final');
+    const telemetryDir = join(sourcePath, 'telemetry');
+    const nestedRoot = join(sourcePath, basename(sourcePath));
+    const nestedVideosDir = join(nestedRoot, 'videos');
+    const nestedFinalDir = join(nestedRoot, 'final');
+    const manifestPath = join(sourcePath, 'manifest.json');
+    const queuePath = join(sourcePath, 'seedance_queue.json');
+    const imageCount = await countFiles(imagesDir, /\.(png|jpe?g|webp)$/i);
+    const videoCount = await countFiles(videosDir, /\.mp4$/i);
+    const finalCount = await countFiles(finalDir, /\.mp4$/i);
+    const telemetryCount = await countFiles(telemetryDir, /\.(jsonl|json)$/i);
+    const nestedVideoCount = await countFiles(nestedVideosDir, /\.mp4$/i);
+    const nestedFinalCount = await countFiles(nestedFinalDir, /\.mp4$/i);
+    const manifestPresent = existsSync(manifestPath);
+    const queueFilePresent = existsSync(queuePath);
+    let queuePendingStatusDetected = false;
+    if (queueFilePresent) {
+        try {
+            const queue = JSON.parse(await readFile(queuePath, 'utf-8'));
+            queuePendingStatusDetected = objectContainsPendingStatus(queue);
+        }
+        catch {
+            queuePendingStatusDetected = false;
+        }
+    }
+    const nestedOutputRootDetected = nestedVideoCount > 0 || nestedFinalCount > 0;
+    const queueStatusMismatch = queuePendingStatusDetected && (videoCount > 0
+        || finalCount > 0
+        || nestedVideoCount > 0
+        || nestedFinalCount > 0);
+    let inferredCurrentStage = 'brief';
+    let inferredLastCompletedStage = null;
+    let inferredCheckpointStatus = 'pending';
+    if (finalCount > 0 || nestedFinalCount > 0) {
+        inferredCurrentStage = null;
+        inferredLastCompletedStage = 'publish';
+        inferredCheckpointStatus = 'completed';
+    }
+    else if (videoCount > 0 || nestedVideoCount > 0) {
+        inferredCurrentStage = 'review';
+        inferredLastCompletedStage = 'assets';
+        inferredCheckpointStatus = 'completed';
+    }
+    else if (imageCount > 0) {
+        inferredCurrentStage = 'assets';
+        inferredLastCompletedStage = 'storyboard';
+        inferredCheckpointStatus = 'completed';
+    }
+    return {
+        sourcePath,
+        importedAt: new Date().toISOString(),
+        imageCount,
+        videoCount,
+        finalCount,
+        telemetryCount,
+        manifestPresent,
+        queueFilePresent,
+        queuePendingStatusDetected,
+        queueStatusMismatch,
+        nestedVideoCount,
+        nestedFinalCount,
+        nestedOutputRootDetected,
+        inferredCurrentStage,
+        inferredLastCompletedStage,
+        inferredCheckpointStatus,
+    };
+}
+function buildImportTags(summary) {
+    const tags = ['legacy-import'];
+    if (summary.finalCount > 0)
+        tags.push('legacy-final');
+    else if (summary.videoCount > 0)
+        tags.push('legacy-video');
+    else if (summary.imageCount > 0)
+        tags.push('legacy-image');
+    else
+        tags.push('legacy-empty');
+    if (summary.manifestPresent)
+        tags.push('legacy-manifest');
+    if (summary.nestedOutputRootDetected)
+        tags.push('legacy-nested-output');
+    if (summary.queueStatusMismatch)
+        tags.push('legacy-queue-drift');
+    return tags;
+}
+export async function importLegacyProjects(sourceRoot, targetRoot = process.cwd()) {
+    const normalizedSourceRoot = resolve(sourceRoot);
+    const entries = await readdir(normalizedSourceRoot, { withFileTypes: true });
+    const results = [];
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        const slug = entry.name;
+        const sourcePath = join(normalizedSourceRoot, slug);
+        const workspace = await ensureProjectWorkspace(slug, targetRoot);
+        const existingManifest = await readProjectManifest(workspace);
+        if (existingManifest) {
+            results.push({ slug, sourcePath, imported: false, skipped: true });
+            continue;
+        }
+        const summary = await inspectLegacyProject(sourcePath);
+        const pipeline = getBuiltinPipelineManifest('storyboard');
+        const manifest = {
+            slug,
+            productionMode: 'storyboard',
+            createdAt: summary.importedAt,
+            updatedAt: summary.importedAt,
+            pipeline,
+            currentStage: summary.inferredCurrentStage,
+            lastCompletedStage: summary.inferredLastCompletedStage,
+            lastCheckpointStatus: summary.inferredCheckpointStatus,
+            tags: buildImportTags(summary),
+        };
+        await writeProjectManifest(workspace, manifest);
+        await updateProjectManifestMetadata(workspace, {
+            updatedAt: summary.importedAt,
+            tags: buildImportTags(summary),
+        });
+        const stateDir = join(workspace.projectDir, 'state');
+        await mkdir(stateDir, { recursive: true });
+        const summaryPath = join(stateDir, 'legacy-import-summary.json');
+        await writeFile(summaryPath, `${JSON.stringify(summary, null, 2)}\n`);
+        await appendProjectEvent(workspace, {
+            type: 'project.legacy-imported',
+            recordedAt: summary.importedAt,
+            payload: {
+                sourcePath,
+                imageCount: summary.imageCount,
+                videoCount: summary.videoCount,
+                finalCount: summary.finalCount,
+                telemetryCount: summary.telemetryCount,
+                manifestPresent: summary.manifestPresent,
+                queueFilePresent: summary.queueFilePresent,
+                queuePendingStatusDetected: summary.queuePendingStatusDetected,
+                queueStatusMismatch: summary.queueStatusMismatch,
+                nestedVideoCount: summary.nestedVideoCount,
+                nestedFinalCount: summary.nestedFinalCount,
+                nestedOutputRootDetected: summary.nestedOutputRootDetected,
+                inferredCurrentStage: summary.inferredCurrentStage,
+                inferredLastCompletedStage: summary.inferredLastCompletedStage,
+                inferredCheckpointStatus: summary.inferredCheckpointStatus,
+            },
+        });
+        results.push({
+            slug,
+            sourcePath,
+            imported: true,
+            skipped: false,
+            summaryPath,
+        });
+    }
+    return results;
+}
+//# sourceMappingURL=legacy-import.js.map

package/dist/video/legacy-import.js.map

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

package/dist/video/library-clean.d.ts

@@ -0,0 +1,34 @@
+export interface GoBananasCharacter {
+    id: number;
+    character_name: string;
+    base_prompt: string;
+    description?: string;
+    reference_images?: unknown[];
+    last_used_at?: string;
+}
+export interface CleanOptions {
+    dryRun: boolean;
+    ids: Set<number>;
+    nameRegex: RegExp | null;
+    bloated: boolean;
+    maxPromptChars: number;
+    yes: boolean;
+    patchId: number | null;
+    patchBasePrompt: string | null;
+    baseUrl: string;
+    apiKey: string;
+}
+export declare function listAllCharacters(apiKey: string, url?: string): Promise<GoBananasCharacter[]>;
+export declare function extractLibraryIntentQueries(userIntent: string): string[];
+export declare function searchCharactersByExactName(query: string, apiKey: string, url?: string): Promise<GoBananasCharacter[]>;
+export declare function findLibraryCharactersByIntent(userIntent: string, apiKey: string, url?: string): Promise<GoBananasCharacter[]>;
+export declare function deleteCharacter(id: number, apiKey: string, url?: string): Promise<{
+    deleted: boolean;
+}>;
+export declare function patchCharacter(id: number, updates: Partial<Pick<GoBananasCharacter, 'base_prompt' | 'description'>>, apiKey: string, url?: string): Promise<GoBananasCharacter>;
+export declare function selectCandidates(all: GoBananasCharacter[], opts: Pick<CleanOptions, 'ids' | 'nameRegex' | 'bloated' | 'maxPromptChars'>): GoBananasCharacter[];
+export declare function formatRow(character: GoBananasCharacter): string;
+export declare function runLibraryClean(opts: CleanOptions): Promise<number>;
+export declare function parseLibraryCleanArgs(rest: string[]): CleanOptions;
+export declare const LIBRARY_HELP = "vclaw video library - Go Bananas character library hygiene\n\nUsage:\n  vclaw video library find --intent \"<text>\" [--api-url <url>]\n  vclaw video library clean [options]\n  vclaw video library clean --patch <id> --base-prompt \"<text>\" [--dry-run]\n\nOptions:\n  --ids 244,141           Target specific character IDs\n  --name-regex PATTERN    Match character_name (case-insensitive)\n  --bloated               Include chars whose base_prompt > 400 chars\n  --max-prompt-chars N    Override the bloated threshold (default 400)\n  --dry-run               List candidates, do not delete\n  --yes / -y              Skip confirmation prompt\n  --patch <id>            Update a single character (requires --base-prompt)\n  --base-prompt \"<text>\"  New base_prompt for the --patch target\n  --api-url <url>         Override GO_BANANAS_API_URL (default https://gobananasai.com/api)\n\nEnv:\n  GO_BANANAS_API_KEY      Required. X-API-Key sent with every request.\n";
+//# sourceMappingURL=library-clean.d.ts.map

package/dist/video/library-clean.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"library-clean.d.ts","sourceRoot":"","sources":["../../src/video/library-clean.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,OAAO,EAAE,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAwCD,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,GAAG,GAAE,MAA0B,GAC9B,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAyB/B;AAED,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAkBxE;AAED,wBAAsB,2BAA2B,CAC/C,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,GAAG,GAAE,MAA0B,GAC9B,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAY/B;AAiBD,wBAAsB,6BAA6B,CACjD,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,GAAG,GAAE,MAA0B,GAC9B,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAqB/B;AAED,wBAAsB,eAAe,CACnC,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,EACd,GAAG,GAAE,MAA0B,GAC9B,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAW/B;AAED,wBAAsB,cAAc,CAClC,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,aAAa,GAAG,aAAa,CAAC,CAAC,EACzE,MAAM,EAAE,MAAM,EACd,GAAG,GAAE,MAA0B,GAC9B,OAAO,CAAC,kBAAkB,CAAC,CAW7B;AAED,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,kBAAkB,EAAE,EACzB,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,KAAK,GAAG,WAAW,GAAG,SAAS,GAAG,gBAAgB,CAAC,GAC3E,kBAAkB,EAAE,CAWtB;AAED,wBAAgB,SAAS,CAAC,SAAS,EAAE,kBAAkB,GAAG,MAAM,CAI/D;AAYD,wBAAsB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAwEzE;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,YAAY,CA0DlE;AAED,eAAO,MAAM,YAAY,u8BAoBxB,CAAC"}

package/dist/video/library-clean.js

@@ -0,0 +1,340 @@
+import { createInterface } from 'node:readline/promises';
+const DEFAULT_BASE_URL = 'https://gobananasai.com/api';
+const BROWSER_UA = 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) ' +
+    'AppleWebKit/537.36 (KHTML, like Gecko) Chrome/122.0.0.0 Safari/537.36';
+const FIND_STOPWORDS = new Set([
+    'the', 'and', 'but', 'for', 'with', 'about', 'from', 'into', 'onto',
+    'this', 'that', 'these', 'those', 'what', 'when', 'where', 'which',
+    'his', 'her', 'their', 'our', 'your', 'its',
+    'has', 'have', 'had', 'was', 'were', 'are', 'is', 'be',
+    'day', 'night', 'story', 'tale', 'storybook', 'adventure', 'scene',
+    'little', 'big', 'small', 'tall', 'tiny', 'huge', 'pet',
+    'japanese', 'chinese', 'korean', 'american', 'british',
+    'cute', 'adorable', 'sweet', 'warm', 'cold', 'quiet', 'loud',
+    'red', 'blue', 'green', 'yellow', 'brown', 'black', 'white', 'pink',
+    'old', 'new', 'young', 'lonely', 'happy', 'sad', 'brave',
+    'samurai', 'boy', 'girl', 'child', 'man', 'woman', 'bunny', 'rabbit',
+    'dog', 'cat', 'fox', 'bear', 'horse', 'bird',
+    'named', 'called', 'known',
+    'meets', 'meet', 'finds', 'find', 'discover', 'discovers', 'travel',
+    'back', 'time', 'place', 'world', 'house', 'home',
+    'scroll', 'sword', 'magic', 'forest', 'village', 'castle',
+    'courage', 'help', 'learn', 'teach',
+]);
+const ARCHETYPE_CONFLICTS = [
+    'android', 'robot', 'deity', 'vishnu', 'saraswati', 'ganesha',
+    'lakshmi', 'shiva', 'tech guru', 'mascot', 'moon-headed',
+    'data pipeline', 'creature', 'monster', 'ghost',
+];
+function resolvedBaseUrl() {
+    return process.env.GO_BANANAS_API_URL?.trim() || DEFAULT_BASE_URL;
+}
+function authHeaders(apiKey) {
+    return {
+        'X-API-Key': apiKey,
+        'Content-Type': 'application/json',
+        'Accept': 'application/json',
+        'User-Agent': BROWSER_UA,
+    };
+}
+export async function listAllCharacters(apiKey, url = resolvedBaseUrl()) {
+    const all = [];
+    let offset = 0;
+    for (let page = 0; page < 20; page += 1) {
+        const resp = await fetch(`${url}/characters?offset=${offset}`, { headers: authHeaders(apiKey) });
+        if (!resp.ok) {
+            throw new Error(`GET /characters failed: ${resp.status} ${await resp.text().then((t) => t.slice(0, 200))}`);
+        }
+        const data = await resp.json();
+        const pageRows = Array.isArray(data)
+            ? data
+            : (data.characters ?? data.data ?? []);
+        if (pageRows.length === 0)
+            break;
+        all.push(...pageRows);
+        const meta = !Array.isArray(data) ? data.pagination : undefined;
+        if (!meta?.hasMore)
+            break;
+        offset = (meta.offset ?? offset) + (meta.limit ?? pageRows.length);
+    }
+    return all;
+}
+export function extractLibraryIntentQueries(userIntent) {
+    const words = [];
+    for (const raw of userIntent.split(/\s+/)) {
+        const stripped = raw.trim().replace(/^[^A-Za-z]+|[^A-Za-z]+$/g, '');
+        if (!stripped || !stripped[0]?.match(/[A-Z]/))
+            continue;
+        const token = stripped.toLowerCase().replace(/[^a-z]/g, '');
+        if (token.length < 3 || FIND_STOPWORDS.has(token))
+            continue;
+        words.push(token);
+    }
+    const seen = new Set();
+    const queries = [];
+    for (const word of words) {
+        if (seen.has(word))
+            continue;
+        seen.add(word);
+        queries.push(word);
+    }
+    return queries;
+}
+export async function searchCharactersByExactName(query, apiKey, url = resolvedBaseUrl()) {
+    const resp = await fetch(`${url}/characters?search=${encodeURIComponent(query)}&exact=true`, {
+        headers: authHeaders(apiKey),
+    });
+    if (!resp.ok) {
+        throw new Error(`GET /characters?search=${query} failed: ${resp.status} ${await resp.text().then((t) => t.slice(0, 200))}`);
+    }
+    const data = await resp.json();
+    return Array.isArray(data) ? data : (data.characters ?? data.data ?? []);
+}
+function nameTokens(character) {
+    return String(character.character_name ?? '')
+        .toLowerCase()
+        .replace(/[^a-z]+/g, ' ')
+        .trim()
+        .split(/\s+/)
+        .filter(Boolean);
+}
+function candidateArchetypeClashes(character, userIntent) {
+    const blob = `${character.character_name ?? ''} ${character.base_prompt ?? ''} ${character.description ?? ''}`.toLowerCase();
+    const normalizedIntent = userIntent.toLowerCase();
+    return ARCHETYPE_CONFLICTS.some((marker) => blob.includes(marker) && !normalizedIntent.includes(marker));
+}
+export async function findLibraryCharactersByIntent(userIntent, apiKey, url = resolvedBaseUrl()) {
+    const queries = extractLibraryIntentQueries(userIntent);
+    const results = new Map();
+    for (const query of queries) {
+        const searchHits = await searchCharactersByExactName(query, apiKey, url);
+        const compatibleHits = searchHits
+            .filter((character) => nameTokens(character).includes(query))
+            .filter((character) => !candidateArchetypeClashes(character, userIntent))
+            .sort((left, right) => {
+            const leftFirstToken = nameTokens(left)[0] === query ? 1 : 0;
+            const rightFirstToken = nameTokens(right)[0] === query ? 1 : 0;
+            return rightFirstToken - leftFirstToken;
+        });
+        const picked = compatibleHits[0];
+        if (!picked || results.has(picked.id))
+            continue;
+        results.set(picked.id, picked);
+    }
+    return [...results.values()];
+}
+export async function deleteCharacter(id, apiKey, url = resolvedBaseUrl()) {
+    const resp = await fetch(`${url}/characters/${id}`, {
+        method: 'DELETE',
+        headers: authHeaders(apiKey),
+    });
+    if (resp.status === 404)
+        return { deleted: false };
+    if (!resp.ok) {
+        throw new Error(`DELETE /characters/${id} failed: ${resp.status} ${await resp.text().then((t) => t.slice(0, 200))}`);
+    }
+    const body = await resp.json();
+    return { deleted: Boolean(body?.data?.deleted ?? body?.deleted ?? false) };
+}
+export async function patchCharacter(id, updates, apiKey, url = resolvedBaseUrl()) {
+    const resp = await fetch(`${url}/characters/${id}`, {
+        method: 'PATCH',
+        headers: authHeaders(apiKey),
+        body: JSON.stringify(updates),
+    });
+    if (!resp.ok) {
+        throw new Error(`PATCH /characters/${id} failed: ${resp.status} ${await resp.text().then((t) => t.slice(0, 200))}`);
+    }
+    const body = await resp.json();
+    return body.data ?? body;
+}
+export function selectCandidates(all, opts) {
+    if (opts.ids.size === 0 && !opts.nameRegex && !opts.bloated)
+        return [];
+    const out = [];
+    for (const character of all) {
+        const basePrompt = character.base_prompt ?? '';
+        const name = character.character_name ?? '';
+        if (opts.ids.has(character.id)) {
+            out.push(character);
+            continue;
+        }
+        if (opts.nameRegex && opts.nameRegex.test(name)) {
+            out.push(character);
+            continue;
+        }
+        if (opts.bloated && basePrompt.length > opts.maxPromptChars) {
+            out.push(character);
+            continue;
+        }
+    }
+    return out;
+}
+export function formatRow(character) {
+    const basePrompt = (character.base_prompt ?? '').replace(/\s+/g, ' ').slice(0, 60);
+    const length = (character.base_prompt ?? '').length;
+    return `  id=${String(character.id).padStart(4)}  ${String(character.character_name ?? '?').padEnd(32).slice(0, 32)}  ${String(length).padStart(4)}ch  "${basePrompt}${length > 60 ? '…' : ''}"`;
+}
+async function confirm(prompt) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        const answer = (await rl.question(prompt)).trim().toLowerCase();
+        return answer === 'y' || answer === 'yes';
+    }
+    finally {
+        rl.close();
+    }
+}
+export async function runLibraryClean(opts) {
+    if (!opts.apiKey) {
+        console.error('GO_BANANAS_API_KEY is required (env var or pass via shell).');
+        return 2;
+    }
+    if (opts.patchId !== null) {
+        if (!opts.patchBasePrompt || opts.patchBasePrompt.length === 0) {
+            console.error('--patch requires --base-prompt');
+            return 2;
+        }
+        console.error(`PATCH /characters/${opts.patchId} base_prompt (${opts.patchBasePrompt.length} chars)`);
+        if (opts.dryRun) {
+            console.log('(dry-run) — no request sent');
+            return 0;
+        }
+        const updated = await patchCharacter(opts.patchId, { base_prompt: opts.patchBasePrompt }, opts.apiKey, opts.baseUrl);
+        console.log(`  ok — ${updated.character_name ?? opts.patchId}`);
+        return 0;
+    }
+    const all = await listAllCharacters(opts.apiKey, opts.baseUrl);
+    const candidates = selectCandidates(all, opts);
+    if (candidates.length === 0) {
+        const filterDesc = [];
+        if (opts.ids.size > 0)
+            filterDesc.push(`${opts.ids.size} id(s)`);
+        if (opts.nameRegex)
+            filterDesc.push(`name=~${opts.nameRegex.source}`);
+        if (opts.bloated)
+            filterDesc.push(`bloated (>${opts.maxPromptChars}ch)`);
+        if (filterDesc.length === 0) {
+            console.log('Pass at least one selector: --ids, --name-regex, or --bloated. (No selector = no action.)');
+        }
+        else {
+            console.log(`No candidates matched (filters: ${filterDesc.join(', ')}). Scanned ${all.length} character(s).`);
+        }
+        return 0;
+    }
+    console.log(`\nCandidates (${candidates.length}):`);
+    for (const candidate of candidates)
+        console.log(formatRow(candidate));
+    if (opts.dryRun) {
+        console.log('\n(dry-run) — pass --yes to delete, or rerun without --dry-run for interactive prompt.');
+        return 0;
+    }
+    if (!opts.yes) {
+        const go = await confirm(`\nDELETE all ${candidates.length} listed character(s)? [y/N] `);
+        if (!go) {
+            console.log('Aborted.');
+            return 0;
+        }
+    }
+    let deleted = 0;
+    let missing = 0;
+    for (const candidate of candidates) {
+        try {
+            const result = await deleteCharacter(candidate.id, opts.apiKey, opts.baseUrl);
+            if (result.deleted) {
+                deleted += 1;
+                console.log(`  ✓ deleted id=${candidate.id} (${candidate.character_name ?? '?'})`);
+            }
+            else {
+                missing += 1;
+                console.log(`  — id=${candidate.id} already missing`);
+            }
+        }
+        catch (error) {
+            console.error(`  ✗ id=${candidate.id}: ${error.message}`);
+        }
+    }
+    console.log(`\nDone. deleted=${deleted}  missing=${missing}  of ${candidates.length}`);
+    return 0;
+}
+export function parseLibraryCleanArgs(rest) {
+    const opts = {
+        dryRun: false,
+        ids: new Set(),
+        nameRegex: null,
+        bloated: false,
+        maxPromptChars: 400,
+        yes: false,
+        patchId: null,
+        patchBasePrompt: null,
+        baseUrl: resolvedBaseUrl(),
+        apiKey: process.env.GO_BANANAS_API_KEY ?? '',
+    };
+    for (let i = 0; i < rest.length; i += 1) {
+        const arg = rest[i];
+        switch (arg) {
+            case '--dry-run':
+                opts.dryRun = true;
+                break;
+            case '--yes':
+            case '-y':
+                opts.yes = true;
+                break;
+            case '--bloated':
+                opts.bloated = true;
+                break;
+            case '--max-prompt-chars':
+                opts.maxPromptChars = Math.max(1, parseInt(rest[++i] ?? '400', 10));
+                break;
+            case '--ids': {
+                const raw = rest[++i] ?? '';
+                for (const part of raw.split(',').map((value) => value.trim()).filter(Boolean)) {
+                    const id = parseInt(part, 10);
+                    if (!Number.isNaN(id))
+                        opts.ids.add(id);
+                }
+                break;
+            }
+            case '--name-regex': {
+                const src = rest[++i] ?? '';
+                if (src)
+                    opts.nameRegex = new RegExp(src, 'i');
+                break;
+            }
+            case '--patch':
+                opts.patchId = parseInt(rest[++i] ?? '', 10) || null;
+                break;
+            case '--base-prompt':
+                opts.patchBasePrompt = rest[++i] ?? null;
+                break;
+            case '--api-url':
+                opts.baseUrl = rest[++i] ?? opts.baseUrl;
+                break;
+            default:
+                throw new Error(`Unknown video library option: ${arg}`);
+        }
+    }
+    return opts;
+}
+export const LIBRARY_HELP = `vclaw video library - Go Bananas character library hygiene
+
+Usage:
+  vclaw video library find --intent "<text>" [--api-url <url>]
+  vclaw video library clean [options]
+  vclaw video library clean --patch <id> --base-prompt "<text>" [--dry-run]
+
+Options:
+  --ids 244,141           Target specific character IDs
+  --name-regex PATTERN    Match character_name (case-insensitive)
+  --bloated               Include chars whose base_prompt > 400 chars
+  --max-prompt-chars N    Override the bloated threshold (default 400)
+  --dry-run               List candidates, do not delete
+  --yes / -y              Skip confirmation prompt
+  --patch <id>            Update a single character (requires --base-prompt)
+  --base-prompt "<text>"  New base_prompt for the --patch target
+  --api-url <url>         Override GO_BANANAS_API_URL (default https://gobananasai.com/api)
+
+Env:
+  GO_BANANAS_API_KEY      Required. X-API-Key sent with every request.
+`;
+//# sourceMappingURL=library-clean.js.map