videobook 0.2.2 → 0.2.4

package/dist/media/ref-fields.js

@@ -1,4 +1,4 @@
-import { arrayBounds, arrayItems, isArraySchema, isUrlObject, propertyAt } from "./json-schema.js";
+import { arrayBounds, arrayItems, isArraySchema, isKeyframeItem, isUrlObject, propertyAt } from "./json-schema.js";
 const CANDIDATES = {
     first_frame: [
         "first_frame_url",
@@ -55,12 +55,14 @@ function expandField(input, field) {
     const required = isRequired(input, field);
     if (isArraySchema(schema)) {
         const bounds = arrayBounds(schema);
+        const items = arrayItems(schema);
         return [{
                 path: field,
                 multi: true,
                 max: bounds.max,
                 min: required ? Math.max(1, bounds.min) : 0,
-                urlObject: isUrlObject(arrayItems(schema)),
+                urlObject: isUrlObject(items),
+                ...(isKeyframeItem(items) ? { keyframe: true } : {}),
             }];
     }
     return [{ path: field, multi: false, max: 1, min: required ? 1 : 0, urlObject: isUrlObject(schema) }];
@@ -83,7 +85,13 @@ export function resolveSlot(role, input, entry) {
             throw new Error(`${entry.id}: ref field ${name} for ${role} is not in the apicity schema`);
     }
     const expanded = names.flatMap((name) => expandField(input, name));
-    const fields = expanded.map(({ path, multi, max, urlObject }) => ({ path, multi, max, urlObject }));
+    const fields = expanded.map(({ path, multi, max, urlObject, keyframe }) => ({
+        path,
+        multi,
+        max,
+        urlObject,
+        ...(keyframe ? { keyframe: true } : {}),
+    }));
     const max = expanded.some((field) => field.max === null)
         ? null
         : expanded.reduce((sum, field) => sum + (field.max ?? 0), 0);

package/dist/media/request.js

@@ -12,6 +12,15 @@ function childContainer(current, key, nextIsIndex) {
     holder[key] = created;
     return created;
 }
+function getPath(target, path) {
+    let current = target;
+    for (const segment of path.split(".")) {
+        if (current === null || typeof current !== "object")
+            return undefined;
+        current = current[segment];
+    }
+    return current;
+}
 function setPath(target, path, value) {
     const segments = path.split(".");
     let current = target;
@@ -67,12 +76,51 @@ function checkRefs(model, refs, mode) {
 function refValue(field, url, item) {
     return field.urlObject ? { ...item, url } : url;
 }
+function keyframeIndexes(count, lastFrame) {
+    if (count <= 1)
+        return [0];
+    return Array.from({ length: count }, (_, index) => Math.round((index * lastFrame) / (count - 1)));
+}
+function retimeKeyframeField(model, value, field) {
+    const fps = model.entry.keyframeFps;
+    if (!fps)
+        return;
+    const current = getPath(value, field.path);
+    if (!Array.isArray(current) || current.length === 0)
+        return;
+    const duration = typeof value.duration === "number" && Number.isFinite(value.duration) && value.duration > 0
+        ? value.duration
+        : 5;
+    const indexes = keyframeIndexes(current.length, Math.round(duration * fps));
+    setPath(value, field.path, current.map((frame, index) => {
+        const imageUrl = typeof frame === "object" && frame !== null && "image_url" in frame
+            ? frame.image_url
+            : frame;
+        return { image_url: imageUrl, frame_index: indexes[index] };
+    }));
+}
+function retimeKeyframes(model, value) {
+    if (!model.entry.keyframeFps)
+        return;
+    for (const slot of model.slots) {
+        for (const field of slot.fields) {
+            if (field.keyframe)
+                retimeKeyframeField(model, value, field);
+        }
+    }
+}
 function placeSlot(model, slot, value, urls) {
     const item = model.entry.refItem?.[slot.role];
     let cursor = 0;
     for (const field of slot.fields) {
         if (cursor >= urls.length)
             return;
+        if (field.keyframe) {
+            const taken = field.max === null ? urls.slice(cursor) : urls.slice(cursor, cursor + field.max);
+            setPath(value, field.path, taken.map((url) => ({ image_url: url, frame_index: 0 })));
+            cursor += taken.length;
+            continue;
+        }
         if (!field.multi) {
             setPath(value, field.path, refValue(field, urls[cursor], item));
             cursor += 1;
@@ -175,6 +223,7 @@ export function buildWireRequest(model, call) {
     if (optionError)
         return { ok: false, error: optionError };
     applyFrameOptions(model, value, refs, call.mode);
+    retimeKeyframes(model, value);
     if (isSeedanceEdit(model.id, call.mode)) {
         value.aspect_ratio = "adaptive";
         value.duration = -1;

package/dist/media/seedance-draft.js

@@ -0,0 +1,48 @@
+const SEEDANCE_DRAFT_COMPLETE_MODEL = "kie:bytedance/seedance-2-5-draft";
+const SEEDANCE_DRAFT_SOURCE_MODEL = "bytedance/seedance-2-5";
+function record(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+function seconds(value) {
+    return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : undefined;
+}
+async function readRecord(engine, artifactId, key) {
+    const result = await engine.metadata.artifacts.read(artifactId, key);
+    return result.ok ? record(result.value) : {};
+}
+async function draftArtifact(engine, taskId) {
+    for (const artifact of engine.artifacts.list()) {
+        if (artifact.kind !== "video")
+            continue;
+        const stored = await readRecord(engine, artifact.artifactId, "kie-task-id");
+        if (stored.taskId === taskId)
+            return artifact.artifactId;
+    }
+    return null;
+}
+function inputSeconds(input, hints) {
+    const stored = hints.inputDurationSeconds;
+    if (typeof stored === "number" && Number.isFinite(stored) && stored >= 0)
+        return stored;
+    const videos = input.reference_video_urls;
+    return Array.isArray(videos) && videos.length > 0 ? undefined : 0;
+}
+export async function seedanceDraftCostHints(engine, model, options) {
+    if (model !== SEEDANCE_DRAFT_COMPLETE_MODEL)
+        return {};
+    const taskId = typeof options.draft_task_id === "string" ? options.draft_task_id.trim() : "";
+    const artifactId = taskId ? await draftArtifact(engine, taskId) : null;
+    if (!artifactId)
+        return {};
+    const payload = await readRecord(engine, artifactId, "generation-payload");
+    const input = record(payload.input);
+    if (payload.model !== SEEDANCE_DRAFT_SOURCE_MODEL || input.draft !== true)
+        return {};
+    const generated = seconds((await readRecord(engine, artifactId, "original")).duration);
+    const durationSeconds = seconds(input.duration) ?? (generated === undefined ? undefined : Math.round(generated));
+    const inputDurationSeconds = inputSeconds(input, await readRecord(engine, artifactId, "generation-cost-hints"));
+    return {
+        ...(durationSeconds !== undefined ? { durationSeconds } : {}),
+        ...(inputDurationSeconds !== undefined ? { inputDurationSeconds } : {}),
+    };
+}

package/dist/media/wire.js

@@ -4,6 +4,7 @@ import { FAL_ENDPOINT_REQUEST_SCHEMAS } from "@apicity/fal/zod";
 import { XaiVideoGenerateRequestSchema } from "@apicity/xai/zod";
 import { AlibabaMultimodalGenerationParametersSchema, AlibabaQwenImageEditStableModelSchema, AlibabaQwenImageGenerationStableModelSchema, } from "@apicity/alibaba/zod";
 import { ElevenLabsComposeMusicRequestSchema, ElevenLabsSoundGenerationRequestSchema, ElevenLabsTextToSpeechRequestSchema, ElevenLabsVideoToMusicRequestSchema, } from "@apicity/elevenlabs/zod";
+import { machgenWire } from "./machgen.js";
 const KIE_VEO_MODELS = new Set(["veo3", "veo3_fast", "veo3_lite"]);
 const SUNO_CALLBACK_URL = "https://localhost/videobook/suno-callback";
 function objectShape(schema) {
@@ -157,5 +158,7 @@ export function wireSpec(parsed) {
             return alibabaWire(parsed.apiId);
         case "elevenlabs":
             return elevenLabsWire(parsed.apiId);
+        case "machgen":
+            return machgenWire(parsed.apiId);
     }
 }

package/dist/notebook-action-catalog.js

@@ -1,6 +1,8 @@
 import { LIGHTNING_SCENE_MODEL, LIGHTNING_VIDEO_MODEL } from "./lightning-defaults.js";
 import { notebookCellTableRows } from "videobook-engine";
 import { notebookGridTag } from "videobook-engine/notebook-grid";
+import { modelFrontierRankings } from "./media/frontier.js";
+import { PROVIDER_ENV_KEYS } from "./media/adapters/index.js";
 import { listModels } from "./media/listing.js";
 import { notebookGenerationInputContract } from "./notebook-generation-contract.js";
 import { controlsForModel } from "./notebook-generation-controls.js";
@@ -265,6 +267,7 @@ const providerLabels = {
     xai: "xAI",
     alibaba: "Alibaba",
     elevenlabs: "ElevenLabs",
+    machgen: "MachGen",
 };
 function hasDualFrame(model) {
     const roles = new Set(model.slots.map((slot) => slot.role));
@@ -297,6 +300,8 @@ function generationAction(model) {
         ...(DEFAULT_MODELS.has(model.id) ? { defaultPriority: 0, isDefault: true } : {}),
         inputContract: notebookGenerationInputContract(model),
         controls: controlsForModel(model),
+        available: Boolean(process.env[PROVIDER_ENV_KEYS[model.provider]]?.trim()),
+        frontier: modelFrontierRankings(model.id),
     };
 }
 export function listNotebookActions(options = {}) {

package/dist/one-password.js

@@ -35,14 +35,19 @@ export function readOnePasswordSettings(env) {
 export function redactToken(text, token) {
     return token ? text.split(token).join("***") : text;
 }
-export function planReferences(env, managedKeys, vault, vaultTitles) {
+/** Every vault item titled like an environment variable fills that variable, except the vault settings themselves. */
+function isVaultEnvTitle(title) {
+    return ENV_NAME.test(title) && title !== OP_VAULT_SETTING && title !== OP_TOKEN_SETTING;
+}
+export function planReferences(env, vault, vaultTitles) {
     const explicit = Object.entries(env)
         .filter((entry) => isOpReference(entry[1]))
         .map(([key, reference]) => [key, reference.trim()]);
     const covered = new Set(explicit.map(([key]) => key));
     const convention = vault
-        ? managedKeys
-            .filter((key) => !covered.has(key) && !env[key]?.trim() && vaultTitles.has(key))
+        ? [...vaultTitles]
+            .filter((key) => isVaultEnvTitle(key) && !covered.has(key) && !env[key]?.trim())
+            .sort()
             .map((key) => [key, vaultReference(vault, key)])
         : [];
     return { explicit, convention };
@@ -98,8 +103,9 @@ export function listVaultItemTitles(vault, env, token) {
     if (!Array.isArray(parsed))
         throw new Error("op item list did not return a list");
     return new Set(parsed.flatMap((item) => {
-        const title = item && typeof item === "object" ? item.title : undefined;
-        return typeof title === "string" ? [title] : [];
+        const { title, category } = item && typeof item === "object" ? item : {};
+        // SSH keys carry no password field, so op://<vault>/<title>/password cannot resolve them.
+        return typeof title === "string" && category !== "SSH_KEY" ? [title] : [];
     }));
 }
 function injectBatch(entries, env, token) {
@@ -169,13 +175,13 @@ function emptyResolution(settings) {
         error: null,
     };
 }
-export function resolveOnePasswordEnv(env, managedKeys) {
+export function resolveOnePasswordEnv(env) {
     const settings = readOnePasswordSettings(env);
     const hasReferences = Object.values(env).some((value) => isOpReference(value));
     if (!hasReferences && !settings.vault)
         return emptyResolution(settings);
     const listing = vaultTitles(settings, env);
-    const plan = planReferences(env, managedKeys, settings.vault, listing.titles);
+    const plan = planReferences(env, settings.vault, listing.titles);
     const result = resolveEntries([...plan.explicit, ...plan.convention], env, settings.token.value);
     for (const [key] of plan.explicit) {
         const value = result.values.get(key);

package/dist/provider-status-link.js

@@ -11,7 +11,7 @@ export function parseProviderTaskStatus(value) {
     if (!value || typeof value !== "object" || Array.isArray(value))
         return null;
     const record = value;
-    if (record.provider !== "kie" && record.provider !== "fal")
+    if (record.provider !== "kie" && record.provider !== "fal" && record.provider !== "machgen")
         return null;
     return {
         provider: record.provider,

package/dist/provider-task-status.js

@@ -1,3 +1,4 @@
+import { MEDIA_TASK_TYPES } from "./media/adapters/types.js";
 import { parseModelId } from "./media/model-id.js";
 import { legacyMediaForTaskType } from "./media/legacy-task-types.js";
 import { readProviderTaskRecord } from "./provider-task-record.js";
@@ -22,14 +23,16 @@ export async function readProviderTaskStatus(engine, artifactId, hints = {}) {
         return null;
     const model = firstString(endpoint, payload.model, catalogModel?.apiId, saved?.meta.apiModel, saved?.meta.model, hints.model);
     const taskId = firstString(saved?.taskId, storedId.taskId, hints.taskId);
+    const machgenTask = saved?.taskType === MEDIA_TASK_TYPES.machgen;
     if (saved && /^(?:xai|alibaba)_/u.test(saved.taskType))
         return null;
-    if (saved && saved.taskType !== "media_kie" && saved.taskType !== "isolate_vocals"
+    if (saved && !machgenTask && saved.taskType !== "media_kie" && saved.taskType !== "isolate_vocals"
         && !saved.taskType.startsWith("fal_") && legacyMediaForTaskType(saved.taskType) === null)
         return null;
     const provider = endpoint || saved?.taskType.startsWith("fal_") ? "fal"
-        : catalogModel?.provider ?? hints.provider ?? (storedId.taskId || saved ? "kie" : null);
-    if (provider !== "kie" && provider !== "fal")
+        : machgenTask ? "machgen"
+            : catalogModel?.provider ?? hints.provider ?? (storedId.taskId || saved ? "kie" : null);
+    if (provider !== "kie" && provider !== "fal" && provider !== "machgen")
         return null;
     return { provider, model, taskId: taskId === "queued" ? null : taskId };
 }

package/dist/provider-usage.js

@@ -4,6 +4,7 @@ import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { createCost, PRICING, PRICING_AS_OF } from "@apicity/cost";
 import { modelEntry } from "./media/catalog.js";
+import { estimateFalRequest } from "./media/cost.js";
 import { currentBookContext } from "./book-context.js";
 function installedPackageVersion(name) {
     let dir = dirname(fileURLToPath(import.meta.resolve(name)));
@@ -91,16 +92,27 @@ function tokenPrice(provider, model, tokens) {
     const usd = ((tokens.inputTokens - cached) * rate.rate.input + cached * (rate.rate.cacheRead ?? rate.rate.input) + tokens.outputTokens * rate.rate.output) / 1e6;
     return { ...unknownPrice([]), costUsd: usd, basis: "estimated", rateSource: rate.source.url, unit: "tokens", units: tokens.inputTokens + tokens.outputTokens };
 }
-function priceRequest(provider, model, payload, endpoint, hints) {
+function historicalAverage(warnings) {
+    return warnings.length > 0 && warnings.every((warning) => warning.includes("historical average per call"));
+}
+async function priceRequest(provider, model, payload, endpoint, hints) {
     try {
         const request = { provider, payload, ...(provider === "fal" ? { endpoint } : {}), ...(hints ? { costHints: hints } : {}) };
-        const estimate = cost.estimate(request);
-        if (estimate.warnings.length || estimate.source === "tokens-heuristic+table")
+        const estimate = provider === "fal"
+            ? await estimateFalRequest(endpoint, payload, hints)
+            : cost.estimate(request);
+        const historical = estimate.usd > 0 && historicalAverage(estimate.warnings);
+        if (!historical && (estimate.warnings.length || estimate.source === "tokens-heuristic+table")) {
             return unknownPrice(estimate.warnings.length ? estimate.warnings : ["Waiting for reported token usage"]);
+        }
         return {
-            ...unknownPrice([]), costUsd: estimate.usd, basis: estimate.source === "free" ? "free" : "estimated",
-            rateSource: rateFor(provider, model)?.source.url ?? null, pricingVersion: `apicity-${COST_PACKAGE_VERSION}:${estimate.rateAsOf}`,
-            units: estimate.breakdown.units ?? null, unit: estimate.breakdown.unit ?? null,
+            ...unknownPrice(historical ? estimate.warnings : []),
+            costUsd: estimate.usd,
+            basis: estimate.source === "free" ? "free" : "estimated",
+            rateSource: rateFor(provider, model)?.source.url ?? null,
+            pricingVersion: `apicity-${COST_PACKAGE_VERSION}:${estimate.rateAsOf ?? (historical ? "fal-historical" : PRICING_AS_OF)}`,
+            units: estimate.breakdown.units ?? null,
+            unit: estimate.breakdown.unit ?? null,
         };
     }
     catch {
@@ -134,6 +146,8 @@ function isBillable(provider, path, method) {
         return path.includes("/services/aigc/");
     if (provider === "elevenlabs")
         return /\/(text-to-speech|speech-to-text|speech-to-speech|sound-generation|audio-isolation|music)(\/|$)/u.test(path);
+    if (provider === "machgen")
+        return path === "/api/v0/generate";
     return /\/(videos|images)(\/|$)/u.test(path);
 }
 async function payloadOf(input, init) {
@@ -165,7 +179,7 @@ function remoteId(body, url, method) {
         ?? (/\/(requests|tasks|jobs|videos)\/([^/]+)(?:\/status)?$/u.exec(url.pathname)?.[2] ?? null);
     if (method === "GET" && pathId)
         return decodeURIComponent(pathId);
-    return text(data.taskId) ?? text(data.task_id) ?? text(body.request_id) ?? text(body.job_id)
+    return text(data.taskId) ?? text(data.task_id) ?? text(body.task_id) ?? text(body.request_id) ?? text(body.job_id)
         ?? text(output.task_id) ?? text(body.id);
 }
 function responseStatus(body, accepted) {
@@ -235,12 +249,12 @@ export function providerUsageFetch(provider, transport = fetch) {
             catch {
                 void 0;
             }
-            const activity = activityFor(model, url.pathname, context.operation);
+            const activity = provider === "machgen" ? "video" : activityFor(model, url.pathname, context.operation);
             entry = {
                 id: randomUUID(), provider, model, activity, status: "pending",
                 tokenBased: /\/(responses|completions|embeddings)$/u.test(url.pathname) || rateFor(provider, model)?.kind === "tokens",
                 operation: context.operation ?? null, artifactId: context.artifactId ?? null,
-                ...priceRequest(provider, model, payload, endpoint, hints),
+                ...await priceRequest(provider, model, payload, endpoint, hints),
             };
             safeRecord(engine, entry);
         }
@@ -258,7 +272,7 @@ export function providerUsageFetch(provider, transport = fetch) {
             const body = json ? object(await response.clone().json()) : {};
             const externalId = remoteId(body, url, method);
             if (entry) {
-                const accepted = !!externalId && (provider === "kie" || provider === "fal" || /videos|tasks/u.test(url.pathname) || !!object(body.output).task_id);
+                const accepted = !!externalId && (provider === "kie" || provider === "fal" || provider === "machgen" || /videos|tasks/u.test(url.pathname) || !!object(body.output).task_id);
                 const status = response.ok ? responseStatus(body, accepted) : "failed";
                 safeRecord(engine, { ...entry, ...(externalId ? { externalId } : {}), ...observedPatch(provider, entry, body, status) });
             }

package/dist/queue.js

@@ -443,6 +443,9 @@ async function createBookRunner(bookId) {
     const runner = engine.jobs.queue.createRunner({
         concurrency: 5,
         pollIntervalMs: 250,
+        // The engine default lease is 30s. Remotion can stall the event loop
+        // longer than that, and the reaper then fails the subtitle render.
+        leaseMs: 10 * 60_000,
         preferredJobTypes: SEARCH_REFERENCE_JOB_TYPES,
         resolveHandler: makeWrappedResolver(bookId, engine),
     });

package/dist/tools/commands.js

@@ -1088,7 +1088,7 @@ const CANONICAL_COMMANDS = [
     },
     {
         command: "/transcribe",
-        description: "Transcribe audio using ElevenLabs",
+        description: "Open a chat review to transcribe a video or audio clip",
         example: "/transcribe @a1",
         category: "action",
         icon: "Mic",

package/dist/tools/estimate-cost.js

@@ -6,6 +6,7 @@ import { DEFAULT_IMAGE_EDIT_MODEL_ID, findImageEditModel } from "../image-edit-m
 import { tryResolveModel } from "../media/descriptor.js";
 import { estimateGeneration } from "../media/cost.js";
 import { checkSeedanceEditSource, normalizeRefs } from "../media/refs.js";
+import { seedanceDraftCostHints } from "../media/seedance-draft.js";
 import { REF_ROLES } from "../media/types.js";
 const GENERATION_TOOLS = new Set(["generate_image", "generate_video", "generate_audio"]);
 const REWRITE_MODEL = "gpt-5.6-sol";
@@ -70,15 +71,16 @@ async function estimateMedia(engine, input) {
     const sourceError = await checkSeedanceEditSource(engine, model, refs, input.mode);
     if (sourceError)
         return unavailable(sourceError);
-    const result = estimateGeneration(model, {
+    const hints = { ...await mediaHints(engine, refs), ...await seedanceDraftCostHints(engine, model.id, options) };
+    const result = await estimateGeneration(model, {
         prompt: text(input.prompt),
         refUrls: placeholderRefs(refs),
         options,
         mode: text(input.mode),
-    }, await mediaHints(engine, refs));
+    }, hints);
     return result.ok ? result.estimate : unavailable(result.error);
 }
-function estimateImageEdit(input) {
+async function estimateImageEdit(input) {
     if (input.model === "sharp/layer-composite" && input.operation === "remove")
         return { ...FREE_ESTIMATE };
     const editModel = findImageEditModel(text(input.model) ?? DEFAULT_IMAGE_EDIT_MODEL_ID);
@@ -86,7 +88,7 @@ function estimateImageEdit(input) {
     if (!model)
         return unavailable(`unknown image edit model '${String(input.model)}'`);
     const imageCount = Array.isArray(input.image_refs) && input.image_refs.length > 0 ? input.image_refs.length : 1;
-    const result = estimateGeneration(model, {
+    const result = await estimateGeneration(model, {
         prompt: text(input.prompt) ?? "edit",
         refUrls: { image: Array.from({ length: imageCount }, (_, index) => `https://example.test/edit-${index + 1}.png`) },
     });
@@ -145,7 +147,7 @@ export function estimateCostDef(engine, books) {
     };
     return {
         name: "estimate_cost",
-        description: "Estimate the USD cost of one or more generate_image, generate_video or generate_audio calls, given as {tool_name, input}, before running them. Models without published rates return $0 with a warning.",
+        description: "Estimate the USD cost of one or more generate_image, generate_video or generate_audio calls, given as {tool_name, input}, before running them. Dynamically billed fal models use fal's historical average per call when FAL_ADMIN_API_KEY is set, and that estimate warns that it ignores the request. Without that key, or without a published rate, the estimate is $0 with a warning.",
         schema,
         handler: async (args) => {
             const calls = args.calls;

package/dist/tools/provider-key-status.js

@@ -13,7 +13,9 @@ const KEY_REGISTRY = {
     DROPBOX_CLIENT_SECRET: { provider: "dropbox", label: "Dropbox OAuth" },
     KIMI_CODING_API_KEY: { provider: "kimicoding", label: "Kimi Coding" },
     FAL_API_KEY: { provider: "fal", label: "FAL" },
+    FAL_ADMIN_API_KEY: { provider: "fal", label: "FAL admin" },
     DASHSCOPE_API_KEY: { provider: "dashscope", label: "DashScope" },
+    MACHGEN_API_KEY: { provider: "machgen", label: "MachGen" },
     B2_ACCESS_KEY_ID: { provider: "b2", label: "Backblaze B2" },
     B2_SECRET_ACCESS_KEY: { provider: "b2", label: "Backblaze B2" },
     B2_REGION: { provider: "b2", label: "Backblaze B2" },
@@ -32,7 +34,9 @@ const ROW_ORDER = [
     "DROPBOX_CLIENT_SECRET",
     "KIMI_CODING_API_KEY",
     "FAL_API_KEY",
+    "FAL_ADMIN_API_KEY",
     "DASHSCOPE_API_KEY",
+    "MACHGEN_API_KEY",
     "B2_ACCESS_KEY_ID",
     "B2_SECRET_ACCESS_KEY",
     "B2_REGION",

package/dist/tools/reconcile-project-work.js

@@ -13,6 +13,7 @@ import { KieError } from "@apicity/kie";
 import { XaiError } from "@apicity/xai";
 import { AlibabaError } from "@apicity/alibaba";
 import { FalError } from "@apicity/fal";
+import { MachGenError } from "@apicity/machgen";
 import { EMPTY_TAG_SUMMARY, readAssetTagSummaries, } from "../asset-tags.js";
 import { logger } from "../logger.js";
 import { queue } from "../queue.js";
@@ -26,6 +27,8 @@ import { findUnprocessedUploads, processExternalUpload } from "../jobs/process-u
 import { planVideoTranscriptJobs } from "../jobs/process-video.js";
 import { probeVideo } from "../ffmpeg.js";
 import { providerEndpoints } from "../media/endpoints.js";
+import { machgenProvider } from "../media/adapters/machgen.js";
+import { MEDIA_TASK_TYPES } from "../media/adapters/types.js";
 import { submitQueuedKieTask } from "../jobs/kie-paygate.js";
 import { DEFAULT_KEYWORD_GRAPHICS_LINGER_SECONDS, DEFAULT_KEYWORD_GRAPHICS_MAX_COUNT, } from "../remotion/keyword-graphics.js";
 import { invalidVideoProxyMetadata, probeStoredVideoFile, videoProxyAssessmentMatches, videoProxyMetadata, videoProxyMetadataMatches, videoProxyValidationError, } from "../video-proxy.js";
@@ -742,9 +745,73 @@ export async function buildAssetList(engine, book_id, sort) {
     return [...assetRows, ...notebookRows].sort((left, right) => direction *
         (Date.parse(left.created_at) - Date.parse(right.created_at)));
 }
+const MACHGEN_RETRYABLE_STATUSES = new Set([408, 429, 499]);
+function machgenPollFailureIsFinal(error) {
+    if (!(error instanceof MachGenError))
+        return false;
+    const status = error.status;
+    return status >= 400 && status < 500 && !MACHGEN_RETRYABLE_STATUSES.has(status);
+}
+async function processMachGenTaskStatus(engine, task, status, result, bookId) {
+    const prompt = metaPrompt(task.meta);
+    if (status.status === "FAILED") {
+        const failMsg = status.error_msg || "MachGen task failed";
+        result.failed.push({ assetId: task.artifactId, taskType: task.taskType, failMsg, failedAt: new Date().toISOString(), prompt });
+        await failPendingTaskAndLog(engine, task.artifactId, task.taskId, { message: failMsg, prompt });
+        return;
+    }
+    if (status.status !== "COMPLETED") {
+        result.pending.push({
+            assetId: task.artifactId,
+            taskType: task.taskType,
+            progress: 0,
+            state: status.status.toLowerCase(),
+            prompt,
+            startedAt: task.createdAt,
+        });
+        return;
+    }
+    const assetDirResult = await engine.workspaces.resolveArtifact(task.artifactId);
+    if (!assetDirResult.ok) {
+        await failPendingTaskAndLog(engine, task.artifactId, task.taskId, { message: `Asset not found: ${task.artifactId}`, prompt });
+        return;
+    }
+    await engine.jobs.pending.markCompleting(task.artifactId);
+    const jobId = `complete-machgen-${task.artifactId}-${Date.now()}`;
+    const video = status.task_output?.video;
+    await queue.enqueue(jobId, {
+        type: "complete_kie_task",
+        taskId: task.taskId,
+        taskType: task.taskType,
+        assetId: task.artifactId,
+        assetDir: assetDirResult.value,
+        bookId,
+        meta: task.meta,
+        resultUrls: typeof video === "string" && video ? [video] : [],
+    });
+    result.completed.push({ assetId: task.artifactId, taskType: task.taskType, jobId });
+}
+async function pollMachGenTasks(engine, tasks, result, bookId, baseURL) {
+    const machgenTasks = tasks.filter((task) => task.taskType === MEDIA_TASK_TYPES.machgen);
+    if (!getApiKey("MACHGEN_API_KEY") || machgenTasks.length === 0)
+        return;
+    const provider = machgenProvider(30_000, baseURL);
+    await Promise.all(machgenTasks.map(async (task) => {
+        try {
+            await processMachGenTaskStatus(engine, task, await provider.api.v0.tasks(task.taskId), result, bookId);
+        }
+        catch (error) {
+            const failMsg = error instanceof Error ? error.message : "Poll failed";
+            const prompt = metaPrompt(task.meta);
+            result.failed.push({ assetId: task.artifactId, taskType: task.taskType, failMsg, failedAt: new Date().toISOString(), prompt });
+            if (machgenPollFailureIsFinal(error))
+                await failPendingTaskAndLog(engine, task.artifactId, task.taskId, { message: failMsg, prompt });
+        }
+    }));
+}
 /**
  * Poll provider-pending tasks: submit queued KIE rows, age out stale tasks,
- * and poll kie/veo/xai/alibaba/fal recordInfo lanes that mark
+ * and poll kie/veo/xai/alibaba/fal/machgen recordInfo lanes that mark
  * completing + enqueue complete_kie_task. Does NOT process external uploads,
  * auto-render, or auto-transcribe.
  */
@@ -1114,6 +1181,7 @@ export async function pollPendingProviderTasks(engine, book_id, options = {}) {
             }
         }));
     }
+    await pollMachGenTasks(engine, pollableTasks, result, book_id, options.machgenBaseURL ?? providerEndpoints().machgenBaseURL);
     for (const task of expiredTasks) {
         if (options.signal?.aborted)
             break;

package/dist/usage-providers.js

@@ -4,6 +4,7 @@ import { createKie as kie } from "@apicity/kie";
 import { createFal as fal } from "@apicity/fal";
 import { createAlibaba as alibaba } from "@apicity/alibaba";
 import { createElevenLabs as elevenlabs } from "@apicity/elevenlabs";
+import { createMachGen as machgen } from "@apicity/machgen";
 import { providerUsageFetch } from "./provider-usage.js";
 export function createOpenAi(options) {
     return openai({ ...options, fetch: providerUsageFetch("openai", options.fetch) });
@@ -23,3 +24,6 @@ export function createAlibaba(options) {
 export function createElevenLabs(options) {
     return elevenlabs({ ...options, fetch: providerUsageFetch("elevenlabs", options.fetch) });
 }
+export function createMachGen(options) {
+    return machgen({ ...options, fetch: providerUsageFetch("machgen", options.fetch) });
+}

package/dist/workspace-action-catalog.js

@@ -246,7 +246,7 @@ function toolAction(tool, command, reserved) {
         ...(mediaType ? { generation: { provider: "catalog", operation: tool.name, mediaType } } : {}),
         surfaces: target.kind === "asset" ? ["slash", "launcher", "cell-menu"]
             : target.kind === "cell" ? ["slash", "launcher", "cell-menu", "selection-menu"] : ["slash", "launcher"],
-        focus: "dialog",
+        focus: tool.name === "transcribe" ? "composer" : "dialog",
         confirmation: confirmationForTool(tool),
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "videobook",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Local-first MCP server and web UI for AI video creation: notebooks, generation, editing, rendering and publishing.",
   "keywords": [
     "mcp",
@@ -36,18 +36,19 @@
     "start": "node dist/index.js"
   },
   "dependencies": {
-    "@apicity/alibaba": "^0.16.2",
-    "@apicity/b2": "^0.16.2",
-    "@apicity/cost": "^0.16.2",
-    "@apicity/dropbox": "^0.16.2",
-    "@apicity/elevenlabs": "^0.16.2",
-    "@apicity/fal": "^0.16.2",
-    "@apicity/free-media-upload": "^0.16.2",
-    "@apicity/kie": "^0.16.2",
-    "@apicity/kimicoding": "^0.16.2",
-    "@apicity/openai": "^0.16.2",
-    "@apicity/x": "^0.16.2",
-    "@apicity/xai": "^0.16.2",
+    "@apicity/alibaba": "^0.17.0",
+    "@apicity/b2": "^0.17.0",
+    "@apicity/cost": "^0.17.0",
+    "@apicity/dropbox": "^0.17.0",
+    "@apicity/elevenlabs": "^0.17.0",
+    "@apicity/fal": "^0.17.0",
+    "@apicity/free-media-upload": "^0.17.0",
+    "@apicity/kie": "^0.17.0",
+    "@apicity/kimicoding": "^0.17.0",
+    "@apicity/machgen": "^0.17.0",
+    "@apicity/openai": "^0.17.0",
+    "@apicity/x": "^0.17.0",
+    "@apicity/xai": "^0.17.0",
     "@devmehq/open-graph-extractor": "^1.1.1",
     "@ffprobe-installer/ffprobe": "2.1.2",
     "@modelcontextprotocol/client": "^2.2.0",