videobook 0.2.5 → 0.3.1

package/dist/library-asset-projection.js

@@ -0,0 +1,141 @@
+import { computeArtifactStatus } from "videobook-engine";
+import { EMPTY_TAG_SUMMARY, matchesTagFilter, readAssetTagSummaries, } from "./asset-tags.js";
+import { assetDuration, assetMediaUrls, assetStreamProfile, findAssetMediaFile, groupByArtifactId, indexByArtifactId, PARTIAL_DOWNLOAD_RE, scheduleMissingVideoPoster, servedVideoProxyFile, } from "./asset-media-projection.js";
+function metadataNumber(meta, key) {
+    const value = meta?.[key];
+    return typeof value === "number" ? value : null;
+}
+function metadataString(meta, key) {
+    const value = meta?.[key];
+    return typeof value === "string" ? value : null;
+}
+function readJobIndexes(engine) {
+    const pending = engine.jobs.pending.findAll();
+    const failures = engine.jobs.failures.findAll();
+    const work = engine.jobs.artifactWork.list();
+    const streams = engine.streams.list();
+    return {
+        pending: indexByArtifactId(pending.ok ? pending.value : []),
+        failures: indexByArtifactId(failures.ok ? failures.value : []),
+        work: indexByArtifactId(work.ok ? work.value : []),
+        streams: groupByArtifactId(streams.ok ? streams.value : []),
+    };
+}
+async function readCandidate(engine, artifact, jobs, tags) {
+    const [manifest, metadata] = await Promise.all([
+        engine.files.manifest(artifact.artifactId, { includeDotfiles: true }),
+        engine.metadata.artifacts.read(artifact.artifactId, "original"),
+    ]);
+    const files = manifest.ok ? manifest.value.files : [];
+    const meta = metadata.ok ? metadata.value : null;
+    const mediaFile = findAssetMediaFile(files, artifact);
+    const work = jobs.work.get(artifact.artifactId) ?? null;
+    const status = computeArtifactStatus({
+        kind: artifact.kind,
+        fileNames: new Set(files.map((file) => file.name)),
+        primaryMediaName: mediaFile?.name ?? null,
+        hasOriginalMetadata: metadata.ok,
+        hasPartFile: files.some((file) => PARTIAL_DOWNLOAD_RE.test(file.name)),
+        lockData: engine.jobs.locks.get(artifact.path),
+        pendingTask: jobs.pending.get(artifact.artifactId) ?? null,
+        generationError: jobs.failures.get(artifact.artifactId) ?? null,
+        artifactRow: work
+            ? { status: work.status, meta: work.meta, deadlineAt: work.deadlineAt }
+            : null,
+    });
+    return {
+        id: artifact.artifactId,
+        artifact_id: artifact.artifactId,
+        ...(artifact.label ? { label: artifact.label } : {}),
+        type: artifact.kind,
+        created_at: new Date(artifact.createdAt).toISOString(),
+        status,
+        prompt: metadataString(meta, "prompt"),
+        object_hash: mediaFile?.objectHash ?? null,
+        tags,
+        source: {
+            artifact,
+            files,
+            meta,
+            mediaFile,
+            work,
+            streams: jobs.streams.get(artifact.artifactId) ?? [],
+        },
+    };
+}
+export async function readLibraryCandidates(engine, input) {
+    const artifacts = engine.artifacts.list({ sort: "newest" })
+        .filter((artifact) => input.kinds.has(artifact.kind));
+    const tagsByArtifact = readAssetTagSummaries(engine, artifacts.map((artifact) => artifact.artifactId));
+    const tagged = artifacts.filter((artifact) => matchesTagFilter(tagsByArtifact.get(artifact.artifactId), input.tags));
+    if (tagged.length === 0)
+        return [];
+    const jobs = readJobIndexes(engine);
+    return Promise.all(tagged.map((artifact) => readCandidate(engine, artifact, jobs, tagsByArtifact.get(artifact.artifactId) ?? EMPTY_TAG_SUMMARY)));
+}
+function libraryAssetWork(work) {
+    return work
+        ? {
+            status: work.status,
+            meta: work.meta,
+            ownerKind: work.ownerKind,
+            deadlineAt: work.deadlineAt,
+        }
+        : null;
+}
+function framesPerSecond(meta, frameRate) {
+    const metadataFps = Number(meta?.fps);
+    if (Number.isFinite(metadataFps) && metadataFps > 0)
+        return metadataFps;
+    if (!frameRate || frameRate.denominator <= 0)
+        return null;
+    const streamFps = frameRate.numerator / frameRate.denominator;
+    return Number.isFinite(streamFps) && streamFps > 0 ? streamFps : null;
+}
+export async function projectLibraryAsset(engine, bookId, candidate) {
+    const { artifact, files, meta, mediaFile, work, streams } = candidate.source;
+    const profile = assetStreamProfile(streams, meta);
+    const proxyMetadata = artifact.kind === "video" && files.some((file) => file.name === "proxy.mp4")
+        ? await engine.metadata.artifacts.read(artifact.artifactId, "proxy")
+        : { ok: false, error: { code: "NOT_FOUND", message: "no proxy" } };
+    const proxyFile = servedVideoProxyFile({
+        bookId,
+        artifact,
+        files,
+        mediaFile,
+        proxyMetadata,
+        work,
+        sourceProfile: profile.sourceProfile,
+    });
+    await scheduleMissingVideoPoster(engine, {
+        bookId,
+        artifact,
+        files,
+        mediaFile,
+        status: candidate.status,
+    });
+    return {
+        id: candidate.id,
+        artifact_id: candidate.artifact_id,
+        ...(candidate.label ? { label: candidate.label } : {}),
+        type: candidate.type,
+        created_at: candidate.created_at,
+        ...assetMediaUrls({ bookId, artifact, files, mediaFile, proxyFile }),
+        object_hash: candidate.object_hash,
+        status: candidate.status,
+        assetWork: libraryAssetWork(work),
+        width: metadataNumber(meta, "width"),
+        height: metadataNumber(meta, "height"),
+        origin: metadataString(meta, "origin"),
+        prompt: candidate.prompt,
+        duration: assetDuration({
+            bookId,
+            artifactId: artifact.artifactId,
+            meta,
+            mediaFile,
+            profile,
+        }),
+        fps: framesPerSecond(meta, profile.frameRate),
+        tags: candidate.tags,
+    };
+}

package/dist/lightning-defaults.js

@@ -1,12 +1,12 @@
 export const LIGHTNING_SCENE_MODEL = "kie:nano-banana-2-1";
-export const LIGHTNING_SCENE_ASPECT_RATIO = "16:9";
-export const LIGHTNING_SCENE_RESOLUTION = "2K";
+export const LIGHTNING_SCENE_ASPECT_RATIO = "9:16";
+export const LIGHTNING_SCENE_RESOLUTION = "4K";
 export const LIGHTNING_SCENE_OUTPUT_FORMAT = "jpg";
 export const LIGHTNING_SCENE_PROMPT_WORDS = 25;
 export const LIGHTNING_VIDEO_MODEL = "kie:bytedance/seedance-2-5";
-export const LIGHTNING_VIDEO_ASPECT_RATIO = "16:9";
+export const LIGHTNING_VIDEO_ASPECT_RATIO = "9:16";
 export const LIGHTNING_VIDEO_RESOLUTION = "1080p";
-export const LIGHTNING_VIDEO_DURATION_SECONDS = 13;
+export const LIGHTNING_VIDEO_DURATION_SECONDS = 12;
 export const LIGHTNING_VIDEO_OUTPUT_FORMAT = "mp4";
 export const LIGHTNING_VIDEO_GENERATE_AUDIO = true;
 export const LIGHTNING_VIDEO_PROMPT_WORDS = 60;

package/dist/media/adapters/kie.js

@@ -1,5 +1,6 @@
 import { setTimeout as delay } from "node:timers/promises";
-import { KieError, submitMediaJob } from "@apicity/kie";
+import { submitMediaJob } from "../../usage-providers.js";
+import { KieError } from "@apicity/kie";
 import { createKie } from "../../usage-providers.js";
 import { requireApiKey } from "../../api-key.js";
 import { authorizeKiePaygate, ensurePaygateSecret, mintKieOtp } from "../../jobs/kie-paygate.js";

package/dist/media/catalog.js

@@ -22,7 +22,7 @@ const SEEDANCE_US_REFERENCE_MODES = [
 ];
 const XAI_MODES = [
     { id: "i2v", label: "Image to video", roles: ["first_frame"] },
-    { id: "r2v", label: "References", roles: ["image"] },
+    { id: "r2v", label: "References", roles: ["image"], defaults: { duration: 10 } },
     { id: "v2v", label: "Edit video", roles: ["video"], requireAny: ["video"] },
 ];
 const MACHGEN_FRAMES = { id: "i2v", label: "Frames", roles: ["first_frame", "last_frame"], requireAny: ["first_frame"] };
@@ -157,10 +157,11 @@ export const MODEL_ENTRIES = [
     },
     { id: "kie:grok-imagine/image-to-video", media: "video", operations: ["image_to_video"], guide: "grok_imagine" },
     { id: "kie:grok-imagine/text-to-video", media: "video", operations: ["text_to_video"], guide: "grok_imagine", defaults: { duration: 6, resolution: "480p" } },
+    { id: "kie:grok-imagine-video-1-5-preview", media: "video", operations: ["image_to_video"], title: "Grok Imagine Video 1.5 Preview (Kie)", guide: "grok_imagine", dialect: "natural_strip_frames" },
     { id: "kie:grok-imagine/extend", media: "video", operations: ["extend_video"], hidden: true },
     { id: "kie:grok-imagine/upscale", media: "video", operations: ["upscale_video"], hidden: true },
     { id: "kie:kling-3.0-omni/text-to-video", media: "video", operations: ["text_to_video"], guide: "kling30", dialect: "natural", defaults: { customize_multi_shots: false } },
-    { id: "kie:kling-3.0-omni/image-to-video", media: "video", operations: ["image_to_video"], guide: "kling30", dialect: "natural" },
+    { id: "kie:kling-3.0-omni/image-to-video", media: "video", operations: ["image_to_video"], guide: "kling30", dialect: "natural", defaults: { aspect_ratio: "auto" }, pinnedDefaults: ["aspect_ratio"] },
     { id: "kie:kling-3.0-omni/reference-to-video", media: "video", operations: ["reference_to_video"], guide: "kling30", dialect: "natural", defaults: { audio: false } },
     {
         id: "kie:kling-3.0-omni/transformation",
@@ -174,6 +175,8 @@ export const MODEL_ENTRIES = [
         ],
     },
     { id: "kie:kling-3.0/motion-control", media: "video", operations: ["motion_control"], guide: "kling30", dialect: "natural", defaults: { mode: "720p" } },
+    { id: "kie:kling-4.0/reference-to-video", media: "video", operations: ["reference_to_video"], dialect: "kling4" },
+    { id: "kie:kling-4.0/keyframe-to-video", media: "video", operations: ["image_to_video"], dialect: "kling4_keyframes", refs: { image: "keyframe_urls" } },
     { id: "kie:gemini-omni-video", media: "video", operations: ["image_to_video", "edit_video"], dialect: "natural_source_video", defaults: { duration: "8" }, modes: [{ id: "i2v", label: "Image to video", roles: ["image"] }, { id: "v2v", label: "Edit video", roles: ["video", "image"], requireAny: ["video"] }], refItem: { video: { start: 0, ends: 8 } }, aliases: { clip_start: "video_list.0.start", clip_end: "video_list.0.ends" } },
     { id: "kie:wan/3-0-video", media: "video", operations: ["text_to_video", "image_to_video", "reference_to_video"], dialect: "seedance", modes: SEEDANCE_MODES },
     { id: "kie:wan/3-0-video-prime", media: "video", operations: ["text_to_video", "image_to_video", "reference_to_video"], dialect: "seedance", modes: SEEDANCE_MODES },
@@ -186,8 +189,11 @@ export const MODEL_ENTRIES = [
     { id: "kie:minimax-h3/reference-to-video", media: "video", operations: ["reference_to_video"], dialect: "natural", rules: { refDurationMs: MiniMaxH3ReferenceClipDurationMs } },
     { id: "kie:volcengine/video-to-video-lip-sync", media: "video", operations: ["lip_sync"] },
     { id: "kie:omnihuman-1-5", media: "video", operations: ["image_to_video", "lip_sync"], dialect: "natural" },
+    { id: "kie:omnihuman-2-0", media: "video", operations: ["image_to_video", "lip_sync"], dialect: "natural" },
     { id: "kie:vidu-q4/image-to-video", media: "video", operations: ["image_to_video"], dialect: "natural_kinds" },
     { id: "kie:vidu-q4/reference-to-video", media: "video", operations: ["reference_to_video"], dialect: "natural_kinds" },
+    { id: "kie:pixverse-v6-max/text-to-video", media: "video", operations: ["text_to_video"], defaults: { quality: "1080p" } },
+    { id: "kie:pixverse-v6-max/image-to-video", media: "video", operations: ["image_to_video"], dialect: "strip_frames", defaults: { quality: "1080p" } },
     { id: "kie:veo3", media: "video", operations: ["text_to_video", "image_to_video"], title: "Veo 3 (Kie)" },
     { id: "kie:veo3_fast", media: "video", operations: ["text_to_video", "image_to_video"], title: "Veo 3 Fast (Kie)" },
     { id: "xai:grok-imagine-video", media: "video", operations: ["text_to_video", "image_to_video", "reference_to_video", "edit_video"], guide: "grok_imagine", title: "Grok Imagine Video (xAI)", dialect: "natural", refs: { first_frame: "image", audio: null }, modes: XAI_MODES },

package/dist/media/cost.js

@@ -1,4 +1,4 @@
-import { createFal } from "@apicity/fal";
+import { createFal } from "../usage-providers.js";
 import { computeEstimate, createFalEstimateCache, resolveFalDynamicEstimate, } from "@apicity/cost";
 import { buildWireRequest } from "./request.js";
 const FAL_ESTIMATE_TTL_MS = 5 * 60 * 1000;

package/dist/media/descriptor.js

@@ -1,9 +1,10 @@
 import { MODEL_DISPLAY } from "@apicity/cost";
 import { modelEntry } from "./catalog.js";
 import { parseModelId } from "./model-id.js";
+import { preferredDefaults } from "./preferred-defaults.js";
 import { claimedFields, resolveSlot } from "./ref-fields.js";
 import { wireSpec } from "./wire.js";
-import { enumValues, numberBounds, propertyAt, schemaTypes, stringMaxLength, toJsonSchema, } from "./json-schema.js";
+import { acceptsNoValue, enumValues, numberBounds, propertyAt, schemaTypes, stringMaxLength, toJsonSchema, } from "./json-schema.js";
 import { REF_ROLES, } from "./types.js";
 const PROMPT_CANDIDATES = ["prompt", "text", "instruction", "description"];
 const cache = new Map();
@@ -74,7 +75,7 @@ function resolveOptions(entry, input, excluded, fixed) {
     const defaults = entry.defaults ?? {};
     const options = [];
     for (const [name, schema] of Object.entries(input.properties ?? {})) {
-        if (excluded.has(name) || name in fixed)
+        if (excluded.has(name) || name in fixed || acceptsNoValue(schema))
             continue;
         options.push(optionSpec(name, name, schema, required.has(name), defaults));
     }
@@ -121,8 +122,10 @@ function build(entry) {
         excluded.add(top);
     if (promptTop)
         excluded.add(promptTop);
+    const preferred = preferredDefaults(entry, resolveOptions(entry, input, excluded, wire.fixed));
+    const tuned = { ...entry, defaults: { ...entry.defaults, ...preferred } };
     return {
-        entry,
+        entry: tuned,
         id: entry.id,
         provider: parsed.provider,
         apiId: parsed.apiId,
@@ -132,7 +135,7 @@ function build(entry) {
         promptField,
         promptRequired: promptTop !== undefined && promptField === promptTop && (input.required ?? []).includes(promptTop),
         slots,
-        options: resolveOptions(entry, input, excluded, wire.fixed),
+        options: resolveOptions(tuned, input, excluded, wire.fixed),
         modes: entry.modes ? [...entry.modes] : defaultModes(slots),
     };
 }

package/dist/media/frontier-gaps.js

@@ -31,7 +31,6 @@ export const FRONTIER_CATALOG_GAPS = {
     "fal:bytedance.seedance2p0.imageToVideo": "This exact endpoint is not in the Videobook catalog.",
     "fal:blackforestlabs.flux3.imageToVideo": "This exact endpoint is not in the Videobook catalog.",
     "fal:xai.grokImagineVideo.v1p5.imageToVideo": "This exact endpoint is not in the Videobook catalog.",
-    "kie:grok-imagine-video-1-5-preview": "This exact endpoint is not in the Videobook catalog.",
     "xai:v1.videos.generations.imageToVideo": "The catalog uses grok-imagine-video, not the ranked 1.5 model id.",
     "fal:alibaba.happyHorse.v1p1.imageToVideo": "This exact endpoint is not in the Videobook catalog.",
     "fal:bytedance.seedance2p5.referenceToVideo": "This exact endpoint is not in the Videobook catalog.",

package/dist/media/har-endpoint.js

@@ -0,0 +1,25 @@
+import { isKieVeoModel } from "./wire.js";
+export function generationHarEndpoint(model) {
+    switch (model.provider) {
+        case "kie":
+            if (isKieVeoModel(model.apiId))
+                return "api.v1.veo.generate";
+            if (model.apiId === "suno/generate")
+                return "api.v1.generate";
+            if (model.apiId === "suno/sounds-generate")
+                return "api.v1.generate.sounds";
+            return "api.v1.jobs.createTask";
+        case "fal": return "v1.queue.submit";
+        case "xai": return "v1.videos.generations";
+        case "alibaba": return "api.v1.services.aigc.multimodalGeneration.generation";
+        case "machgen": return "api.v0.generate";
+        case "elevenlabs":
+            switch (model.apiId) {
+                case "sound-generation": return "v1.soundGeneration";
+                case "music": return "v1.music";
+                case "video-to-music": return "v1.music.videoToMusic";
+                case "text-to-speech": return "v1.textToSpeech";
+                default: throw new Error(`Unsupported ElevenLabs model ${model.apiId}`);
+            }
+    }
+}

package/dist/media/json-schema.js

@@ -43,6 +43,9 @@ export function isKeyframeItem(schema) {
         && branch.properties?.image_url !== undefined
         && branch.properties?.frame_index !== undefined);
 }
+export function acceptsNoValue(schema) {
+    return schema.not !== undefined && Object.keys(schema.not).length === 0;
+}
 export function isArraySchema(schema) {
     return branches(schema).some((branch) => branch.type === "array");
 }

package/dist/media/preferred-defaults.js

@@ -0,0 +1,161 @@
+const PREFERRED_DURATION_SECONDS = 12;
+const PREFERRED_ASPECT_RATIO = "9:16";
+const PREFERRED_IMAGE_SIZE_PRESET = "portrait_16_9";
+const IMAGE_SIZE_PRESETS = new Set(["square_hd", "square", "portrait_4_3", "portrait_16_9", "landscape_4_3", "landscape_16_9"]);
+const GROUP_FIELDS = {
+    duration: ["duration"],
+    aspect: ["aspect_ratio", "aspectRatio", "image_size"],
+    resolution: ["resolution", "output_resolution", "size", "mode"],
+    quality: ["quality"],
+    bitrate: ["bitrate_mode"],
+};
+const QUALITY_RANK = ["very_low", "low", "basic", "standard", "medium", "high"];
+const UNTIMED_VIDEO_OPERATIONS = new Set(["edit_video", "lip_sync", "upscale_video", "motion_control"]);
+export function stickySettingGroup(name) {
+    const entry = Object.entries(GROUP_FIELDS).find(([, fields]) => fields.includes(name));
+    return entry ? entry[0] : null;
+}
+function resolutionRank(value) {
+    if (typeof value === "number")
+        return value;
+    const match = /^(\d+(?:\.\d+)?)\s*(p|k|sq)?$/iu.exec(value.trim());
+    if (!match)
+        return null;
+    const amount = Number(match[1]);
+    return match[2]?.toLowerCase() === "k" ? amount * 1000 : amount;
+}
+function isResolutionEnum(values) {
+    return values.length > 0 && values.every((value) => resolutionRank(value) !== null);
+}
+function highestBy(values, rank) {
+    const ranked = values.flatMap((value) => {
+        const score = rank(value);
+        return score === null ? [] : [{ value, score }];
+    });
+    if (ranked.length === 0)
+        return undefined;
+    return ranked.reduce((best, candidate) => candidate.score > best.score ? candidate : best).value;
+}
+function qualityRank(value) {
+    const index = QUALITY_RANK.indexOf(String(value).toLowerCase());
+    return index < 0 ? null : index;
+}
+function isNumeric(option) {
+    return option.valueType === "number" || option.valueType === "integer" || option.valueType === "json";
+}
+function clampToBounds(option, value) {
+    const low = option.minimum ?? Number.NEGATIVE_INFINITY;
+    const high = option.maximum ?? Number.POSITIVE_INFINITY;
+    return Math.min(Math.max(value, low), high);
+}
+function nearestDurationChoice(values, target) {
+    const numeric = values.filter((value) => Number.isFinite(Number(value)));
+    if (numeric.length === 0)
+        return undefined;
+    const atOrBelow = numeric.filter((value) => Number(value) <= target);
+    const pool = atOrBelow.length > 0 ? atOrBelow : numeric;
+    return pool.reduce((best, candidate) => Math.abs(Number(candidate) - target) < Math.abs(Number(best) - target) ? candidate : best);
+}
+function preferredDuration(option) {
+    if (option.enumValues.length > 0)
+        return nearestDurationChoice(option.enumValues, PREFERRED_DURATION_SECONDS);
+    if (!isNumeric(option))
+        return undefined;
+    return clampToBounds(option, PREFERRED_DURATION_SECONDS);
+}
+function takesImageSizePreset(entry, option) {
+    if (option.name !== "image_size" || option.valueType !== "json" || !entry.id.startsWith("fal:"))
+        return false;
+    if (!entry.operations.includes("text_to_image"))
+        return false;
+    return option.defaultValue === undefined || IMAGE_SIZE_PRESETS.has(String(option.defaultValue));
+}
+function preferredAspect(entry, option) {
+    if (option.enumValues.includes(PREFERRED_ASPECT_RATIO))
+        return PREFERRED_ASPECT_RATIO;
+    return takesImageSizePreset(entry, option) ? PREFERRED_IMAGE_SIZE_PRESET : undefined;
+}
+function preferredResolution(option) {
+    if (!isResolutionEnum(option.enumValues.filter((value) => value !== "auto")))
+        return undefined;
+    return highestBy(option.enumValues, resolutionRank);
+}
+function preferredQuality(option) {
+    return highestBy(option.enumValues, qualityRank);
+}
+export function takesDuration(entry) {
+    return entry.media === "video" && entry.operations.some((operation) => !UNTIMED_VIDEO_OPERATIONS.has(operation));
+}
+function preferredValue(entry, option) {
+    if (option.name !== option.path || entry.pinnedDefaults?.includes(option.name))
+        return undefined;
+    const group = stickySettingGroup(option.name);
+    if (group === "duration")
+        return takesDuration(entry) ? preferredDuration(option) : undefined;
+    if (group === "aspect")
+        return preferredAspect(entry, option);
+    if (group === "resolution")
+        return preferredResolution(option);
+    if (group === "quality" || group === "bitrate")
+        return preferredQuality(option);
+    return undefined;
+}
+export function preferredDefaults(entry, options) {
+    if (entry.media !== "video" && entry.media !== "image")
+        return {};
+    return Object.fromEntries(options.flatMap((option) => {
+        const value = preferredValue(entry, option);
+        return value === undefined ? [] : [[option.name, value]];
+    }));
+}
+function sameResolution(left, right) {
+    const a = resolutionRank(left);
+    const b = resolutionRank(right);
+    return a !== null && a === b && String(left).toLowerCase().replace(/p$/u, "") === String(right).toLowerCase().replace(/p$/u, "");
+}
+function matchingChoice(choices, value) {
+    return choices.find((choice) => choice === value)
+        ?? choices.find((choice) => String(choice).toLowerCase() === String(value).toLowerCase())
+        ?? choices.find((choice) => typeof choice !== "boolean" && typeof value !== "boolean" && sameResolution(choice, value));
+}
+function acceptedStickyValue(control, value) {
+    if (control.options.length > 0)
+        return matchingChoice(control.options, value);
+    if (control.valueType !== "number")
+        return undefined;
+    const numeric = Number(value);
+    if (!Number.isFinite(numeric))
+        return undefined;
+    if (control.minimum !== undefined && numeric < control.minimum)
+        return undefined;
+    if (control.maximum !== undefined && numeric > control.maximum)
+        return undefined;
+    return numeric;
+}
+function isStickyValue(group, value) {
+    if (typeof value !== "string" && typeof value !== "number")
+        return false;
+    return group !== "resolution" || resolutionRank(value) !== null;
+}
+export function stickySettingsFrom(settings) {
+    return Object.fromEntries(Object.entries(settings).flatMap(([name, value]) => {
+        const group = stickySettingGroup(name);
+        if (!group || !isStickyValue(group, value))
+            return [];
+        return [[group, value]];
+    }));
+}
+function isStickySettingGroup(name) {
+    return Object.hasOwn(GROUP_FIELDS, name);
+}
+export function parseStickySettings(stored) {
+    return Object.fromEntries(Object.entries(stored).flatMap(([group, value]) => isStickySettingGroup(group) && isStickyValue(group, value) ? [[group, value]] : []));
+}
+export function stickySettingsFor(controls, sticky) {
+    return Object.fromEntries(controls.flatMap((control) => {
+        const group = stickySettingGroup(control.name);
+        const remembered = group ? sticky[group] : undefined;
+        const value = remembered === undefined ? undefined : acceptedStickyValue(control, remembered);
+        return value === undefined ? [] : [[control.name, value]];
+    }));
+}

package/dist/media/prompt-dialects.js

@@ -1,4 +1,4 @@
-import { replaceHappyHorseAssetMentions, replaceNaturalAssetMentions, rewriteImageRefMentionsToBrackets, rewriteSeedanceAssetMentions, rewriteViduReferenceMentions, stripRefMentions, } from "../generation-reference-mentions.js";
+import { replaceHappyHorseAssetMentions, replaceNaturalAssetMentions, rewriteImageRefMentionsToBrackets, rewriteKling4FrameMentions, rewriteKling4ReferenceMentions, rewriteSeedanceAssetMentions, rewriteViduReferenceMentions, stripRefMentions, } from "../generation-reference-mentions.js";
 const SLOT_TOKEN = /@((image|video|audio)(\d+)|firstframe|lastframe)(?![\w-])/giu;
 function refsFor(refs, role) {
     return (refs[role] ?? []).filter((ref) => !/^https?:\/\//u.test(ref));
@@ -58,6 +58,14 @@ function rewrite(dialect, prompt, refs) {
             return rewriteImageRefMentionsToBrackets(prompt, refsFor(refs, "image"));
         case "vidu":
             return rewriteViduReferenceMentions(prompt, refsFor(refs, "image"), refsFor(refs, "audio"));
+        case "kling4":
+            return rewriteKling4ReferenceMentions(prompt, refsFor(refs, "image"), refsFor(refs, "video"));
+        case "kling4_keyframes":
+            return rewriteKling4FrameMentions(prompt, {
+                first: refsFor(refs, "first_frame"),
+                keyframes: refsFor(refs, "image"),
+                last: refsFor(refs, "last_frame"),
+            });
         case "happyhorse_edit":
             return replaceHappyHorseAssetMentions(prompt, refsFor(refs, "video")[0] ?? null, refsFor(refs, "image"));
     }