videobook 0.2.4 → 0.3.0

package/dist/media/catalog.js

@@ -203,6 +203,26 @@ export const MODEL_ENTRIES = [
     { id: "fal:alibaba/wan-3.0-prime/text-to-video", media: "video", operations: ["text_to_video"], hidden: true },
     { id: "fal:alibaba/wan-3.0-prime/image-to-video", media: "video", operations: ["image_to_video"], hidden: true },
     { id: "fal:alibaba/wan-3.0-prime/reference-to-video", media: "video", operations: ["reference_to_video"], hidden: true },
+    { id: "fal:kling/v4/text-to-video", media: "video", operations: ["text_to_video"], dialect: "seedance" },
+    { id: "fal:kling/v4/image-to-video", media: "video", operations: ["image_to_video"], dialect: "seedance", modes: FRAME_MODES },
+    { id: "fal:kling/v4/reference-to-video", media: "video", operations: ["reference_to_video"], dialect: "seedance" },
+    { id: "fal:kling/v4/video-to-video/edit", media: "video", operations: ["edit_video"], dialect: "seedance" },
+    { id: "fal:heygen/heygen-video/text-to-video", media: "video", operations: ["text_to_video"], dialect: "natural" },
+    { id: "fal:heygen/heygen-video/image-to-video", media: "video", operations: ["image_to_video"], dialect: "strip_frames", refs: { first_frame: "image_url" } },
+    { id: "fal:heygen/heygen-video/reference-to-video", media: "video", operations: ["reference_to_video"], dialect: "natural", modes: [{ id: "r2v", label: "References", roles: ["image", "video", "audio"], requireAny: ["image", "video"] }] },
+    ...[3, 4].map((version) => ({
+        id: `fal:fal-ai/heygen/avatar${version}/digital-twin`,
+        media: "video",
+        operations: ["text_to_video"],
+        dialect: "plain",
+        prompt: "voice.prompt",
+        defaults: { character: { avatar: "Abigail Office Front" }, voice: { voice: "Ivy" } },
+        aliases: { avatar: "character.avatar", avatar_style: "character.avatar_style", voice: "voice.voice", voice_id: "voice.voice_id", speed: "voice.speed" },
+    })),
+    { id: "fal:fal-ai/heygen/avatar5/digital-twin", media: "video", operations: ["text_to_video"], dialect: "plain" },
+    { id: "fal:fal-ai/heygen/avatar4/image-to-video", media: "video", operations: ["image_to_video"], dialect: "plain", defaults: { voice: "Ivy" } },
+    { id: "fal:fal-ai/heygen/v2/video-agent", media: "video", operations: ["text_to_video"], dialect: "plain" },
+    { id: "fal:fal-ai/heygen/v3/video-agent", media: "video", operations: ["text_to_video"], dialect: "plain" },
     { id: "fal:blackforestlabs/flux-3-max/text-to-video", media: "video", operations: ["text_to_video"], title: "FLUX 3 Max", defaults: FLUX_3_MAX_DEFAULTS },
     { id: "fal:blackforestlabs/flux-3-max/image-to-video", media: "video", operations: ["image_to_video"], title: "FLUX 3 Max Image", refs: { first_frame: "image_url" }, modes: FRAME_MODES, defaults: FLUX_3_MAX_DEFAULTS },
     { id: "fal:blackforestlabs/flux-3-max/keyframes-to-video", media: "video", operations: ["image_to_video"], title: "FLUX 3 Max Keyframes", refs: { image: "keyframes" }, keyframeFps: 24, defaults: FLUX_3_MAX_DEFAULTS },

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/package-version.js

@@ -0,0 +1,18 @@
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+export function installedPackageVersion(name) {
+    let dir = dirname(fileURLToPath(import.meta.resolve(name)));
+    while (dir !== dirname(dir)) {
+        try {
+            const manifest = JSON.parse(readFileSync(join(dir, "package.json"), "utf8"));
+            if (manifest.name === name && manifest.version)
+                return manifest.version;
+        }
+        catch {
+            void 0;
+        }
+        dir = dirname(dir);
+    }
+    return "unknown";
+}

package/dist/posts/dropbox-auth.js

@@ -1,6 +1,6 @@
 import { createHash, randomBytes } from "node:crypto";
 import { createServer } from "node:http";
-import { createDropbox } from "@apicity/dropbox";
+import { createDropbox } from "../usage-providers.js";
 import { appState } from "../app-state.js";
 const KEY = "dropbox.oauth.tokens";
 const REDIRECT = "http://127.0.0.1:8766/callback";

package/dist/posts/post-metrics.js

@@ -1,4 +1,5 @@
-import { createX, XError } from "@apicity/x";
+import { createX } from "../usage-providers.js";
+import { XError } from "@apicity/x";
 import { v7 as uuidv7 } from "uuid";
 import { getValidAccessToken } from "../x/x-tokens.js";
 import { listBookEngines, queue } from "../queue.js";

package/dist/provider-usage.js

@@ -1,26 +1,9 @@
 import { randomUUID } from "node:crypto";
-import { readFileSync } from "node:fs";
-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)));
-    while (dir !== dirname(dir)) {
-        try {
-            const manifest = JSON.parse(readFileSync(join(dir, "package.json"), "utf8"));
-            if (manifest.name === name && manifest.version)
-                return manifest.version;
-        }
-        catch {
-            void 0;
-        }
-        dir = dirname(dir);
-    }
-    return "unknown";
-}
+import { installedPackageVersion } from "./package-version.js";
 const COST_PACKAGE_VERSION = installedPackageVersion("@apicity/cost");
 const incomplete = new WeakSet();
 const cost = createCost();

package/dist/queue.js

@@ -1,3 +1,4 @@
+import { sweepHarCaptures } from "./har-retention.js";
 import { appendDiagnostic, registerDiagnosticName } from "./diagnostics.js";
 import { createEngine, } from "videobook-engine";
 import { activeBookEngine, withBookContext } from "./book-context.js";
@@ -54,11 +55,13 @@ export function isProviderPollDriverActive(bookId) {
     const info = runnerByBook.get(bookId);
     return info?.providerPollTimer != null;
 }
+let harRetentionTimer = null;
 async function tickProviderPoll(info) {
     if (info.providerPollInFlight || info.pollAbort.signal.aborted)
         return;
     info.providerPollInFlight = true;
     try {
+        await sweepHarCaptures();
         if (providerPollWorkHook) {
             await providerPollWorkHook(info.pollAbort.signal);
         }
@@ -258,7 +261,10 @@ function makeWrappedResolver(bookId, engine) {
         const handler = handlers.get(type);
         if (!handler)
             return null;
-        return async (job, queueSignal) => withBookContext({ bookId, engine, operation: type, ...(job.artifactId ? { artifactId: job.artifactId } : {}) }, () => runWithJobDeadline(type, async (signal) => {
+        return async (job, queueSignal) => withBookContext({ bookId, engine, operation: type, ...(job.artifactId ? { artifactId: job.artifactId } : {}),
+            ...(typeof job.payload.runId === "string" ? { runId: job.payload.runId } : {}),
+            ...(typeof job.payload.generationId === "string" ? { attemptId: job.payload.generationId } : {}),
+            ...(typeof job.payload.model === "string" ? { model: job.payload.model } : {}) }, () => runWithJobDeadline(type, async (signal) => {
             const jobSignal = queueSignal
                 ? AbortSignal.any([signal, queueSignal])
                 : signal;
@@ -579,6 +585,8 @@ export const queue = {
         };
     },
     async start() {
+        await sweepHarCaptures(true);
+        harRetentionTimer ??= setInterval(() => { void sweepHarCaptures(); }, 60_000).unref();
         await ensureJobHandlersLoaded();
         await reconcileQueueOnStartup();
     },
@@ -586,6 +594,9 @@ export const queue = {
         await ensureRunner(bookId);
     },
     async stop() {
+        if (harRetentionTimer)
+            clearInterval(harRetentionTimer);
+        harRetentionTimer = null;
         if (stoppingQueue)
             return stoppingQueue;
         const pending = stopQueueRunners();

package/dist/serve.js

@@ -1,3 +1,4 @@
+import { flushHarCaptures } from "./har-capture.js";
 import { once } from "node:events";
 import { setTimeout as delay } from "node:timers/promises";
 import { stopAceServer } from "./acestep/process.js";
@@ -22,6 +23,7 @@ async function shutdownServices(services) {
     await services.voiceSessions.close();
     await services.mcpHandler.close();
     await queue.stop();
+    await flushHarCaptures();
     await stopAceServer();
     await bookManager.close();
 }

package/dist/tools/api-status.js

@@ -1,4 +1,4 @@
-import { createKimiCoding } from "@apicity/kimicoding";
+import { createKimiCoding } from "../usage-providers.js";
 import { isPlaceholderApiKey } from "../api-key.js";
 export function apiStatusDef() {
     return {

package/dist/tools/generate-media.js

@@ -1,3 +1,4 @@
+import { currentBookContext } from "../book-context.js";
 import { z } from "zod";
 import { queue } from "../queue.js";
 import { generationLabel } from "../artifact-label.js";
@@ -92,6 +93,8 @@ async function enqueueGeneration(engine, model, args, refs) {
     const jobId = `generate-${model.media}-${artifactId}-${Date.now()}`;
     const job = {
         type: "generate_media",
+        runId: currentBookContext()?.runId,
+        generationId: currentBookContext()?.attemptId,
         model: model.id,
         bookId: String(args.book_id),
         assetId: artifactId,

package/dist/tools/generation-payload.js

@@ -1,20 +1,34 @@
 import { z } from "zod";
+import { captureKeys, generationHarStatus } from "../generation-har.js";
+import { readHarSettings } from "../har-settings.js";
+import { logger } from "../logger.js";
 import { readProviderTaskStatus } from "../provider-task-status.js";
+async function inspectionHar(engine, assetId) {
+    try {
+        const { mode } = await readHarSettings();
+        return await generationHarStatus(await captureKeys(engine, [assetId]), mode);
+    }
+    catch (error) {
+        logger.warn("har-capture-failed", { error });
+        return null;
+    }
+}
 export function generationPayloadDef(engine) {
     return {
         name: "inspect_generation_request",
-        description: "Read the persisted provider request payload, task details, status-page information, and failure info for a single asset. Used by the generating-cell inspector to show what was sent to the provider.",
+        description: "Read the persisted provider request payload, task details, status-page information, failure info and HAR capture status for a single asset. Used by the generating-cell inspector to show what was sent to the provider.",
         schema: {
             book_id: z.string().describe("Book id"),
             asset_id: z.string().describe("Artifact id"),
         },
         handler: async (args) => {
             const { book_id: _book_id, asset_id } = args;
-            const [payloadRes, taskRes, errorRes, providerTask] = await Promise.all([
+            const [payloadRes, taskRes, errorRes, providerTask, har] = await Promise.all([
                 engine.metadata.artifacts.read(asset_id, "generation-payload"),
                 engine.jobs.pending.read(asset_id),
                 engine.jobs.failures.read(asset_id),
                 readProviderTaskStatus(engine, asset_id),
+                inspectionHar(engine, asset_id),
             ]);
             const task = taskRes.ok ? taskRes.value : null;
             const errorRecord = errorRes.ok ? errorRes.value : null;
@@ -32,6 +46,7 @@ export function generationPayloadDef(engine) {
                 error,
                 taskType: task ? task.taskType : null,
                 providerTask,
+                har,
                 task: task
                     ? {
                         taskId: task.taskId,

package/dist/tools/get-generation-har.js

@@ -0,0 +1,43 @@
+import { z } from "zod";
+import { generationCaptureKeys, generationHar } from "../generation-har.js";
+import { readHarSettings } from "../har-settings.js";
+function errorResult(message) {
+    return { isError: true, content: [{ type: "text", text: message }] };
+}
+export function getGenerationHarDef(engine) {
+    return {
+        name: "get_generation_har",
+        description: "Return the scrubbed provider HAR capture of one generation attempt, by attempt id or asset id. Several captured calls are combined into one HAR with a page per call. Needs provider capture (set_har_capture).",
+        schema: {
+            book_id: z.string().describe("Book id"),
+            generation_id: z.string().min(1).describe("Generation attempt id or its asset id"),
+        },
+        annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+        handler: async (args) => {
+            const { generation_id } = args;
+            try {
+                const result = await generationHar(await generationCaptureKeys(engine, generation_id), generation_id);
+                if (!result) {
+                    const { mode } = await readHarSettings();
+                    return errorResult(mode === "off"
+                        ? "No HAR capture for this generation. Provider capture is off; turn it on in Settings > Diagnostics or with set_har_capture."
+                        : "No HAR capture for this generation.");
+                }
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                generationId: generation_id,
+                                filename: `videobook-generation-${generation_id.replace(/[^A-Za-z0-9._-]+/gu, "-")}.har`,
+                                captures: result.captures,
+                                har: result.har,
+                            }),
+                        }],
+                };
+            }
+            catch (error) {
+                return errorResult(error instanceof Error ? error.message : String(error));
+            }
+        },
+    };
+}

package/dist/tools/index.js

@@ -1,3 +1,4 @@
+import { setHarCaptureDef } from "./set-har-capture.js";
 import { coldOpenDefs } from "./cold-open.js";
 import { withBookContext } from "../book-context.js";
 import { bookManager } from "../engine.js";
@@ -78,6 +79,7 @@ import { listAssetsDef } from "./list-assets.js";
 import { listCellGenerationsDef } from "./list-cell-generations.js";
 import { waitForAssetReadyDef } from "./wait-for-asset-ready.js";
 import { generationPayloadDef } from "./generation-payload.js";
+import { getGenerationHarDef } from "./get-generation-har.js";
 import { concatImagesDef } from "./concat-images.js";
 import { chatDef } from "./chat.js";
 import { chainDef } from "./chain.js";
@@ -250,6 +252,7 @@ export function getAllToolDefs(engine, books = bookManager) {
         listChatModelsDef(),
         providerKeyStatusDef(),
         setEnvSecretDef(),
+        setHarCaptureDef(),
         listElevenLabsVoicesDef(),
         estimateCostDef(engine, books),
         bookUsageDef(engine),
@@ -285,6 +288,7 @@ export function getAllToolDefs(engine, books = bookManager) {
         listCellGenerationsDef(engine),
         waitForAssetReadyDef(engine),
         generationPayloadDef(engine),
+        getGenerationHarDef(engine),
         concatImagesDef(engine),
         chatDef(engine),
         chainDef(engine),

package/dist/tools/list-cell-generations.js

@@ -2,6 +2,20 @@ import { z } from "zod";
 import { findGenerateAudioOutput, findGenerateImageOutput, findGenerateVideoOutput, listGenerateImageOutputs, listGenerateVideoOutputs, } from "../notebook-cell-outputs.js";
 import { buildAssetList } from "./reconcile-project-work.js";
 import { readProviderTaskStatus } from "../provider-task-status.js";
+import { captureKeys, generationHarStatus } from "../generation-har.js";
+import { readHarIndex } from "../har-index.js";
+import { readHarSettings } from "../har-settings.js";
+import { logger } from "../logger.js";
+async function attemptHarLookup(engine) {
+    try {
+        const [{ mode }, rows] = await Promise.all([readHarSettings(), readHarIndex()]);
+        return { mode, status: async (ids) => generationHarStatus(await captureKeys(engine, ids), mode, rows) };
+    }
+    catch (error) {
+        logger.warn("har-capture-failed", { error });
+        return null;
+    }
+}
 function generationArtifactIds(generations) {
     return [...new Set(generations.flatMap((row) => [
             ...(row.outputArtifactId ? [row.outputArtifactId] : []),
@@ -132,6 +146,7 @@ export function listCellGenerationsDef(engine) {
                     ? generationsResult.value.filter((row) => !row.outputCellId || row.outputCellId === requestedResult.id)
                     : generationsResult.value;
                 const transitions = generationTransitions(engine, rows);
+                const harLookup = await attemptHarLookup(engine);
                 const assets = await buildAssetList(engine, book_id);
                 const assetById = new Map(assets.map((asset) => [asset.artifact_id, asset]));
                 const attempts = [];
@@ -180,6 +195,9 @@ export function listCellGenerationsDef(engine) {
                         ...(include_payloads ? { payload } : {}),
                         commandPlan,
                         transitions: transitions.get(row.generationId) ?? [],
+                        har: harLookup
+                            ? await harLookup.status([row.generationId, row.providerArtifactId, row.outputArtifactId])
+                            : null,
                         createdAt: row.createdAt,
                         updatedAt: row.updatedAt,
                     });
@@ -205,6 +223,7 @@ export function listCellGenerationsDef(engine) {
                         latestStatus: rows[0]?.status ?? null,
                         artifactIds: generationArtifactIds(rows),
                     },
+                    harMode: harLookup?.mode ?? null,
                 };
                 return {
                     content: [{

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

@@ -791,12 +791,18 @@ async function processMachGenTaskStatus(engine, task, status, result, bookId) {
     });
     result.completed.push({ assetId: task.artifactId, taskType: task.taskType, jobId });
 }
+function withProviderTaskContext(engine, bookId, task, operation) {
+    return withBookContext({ bookId, engine, operation: "poll_pending_provider_tasks", artifactId: task.artifactId,
+        providerTaskId: task.taskId, attemptId: typeof task.meta.attemptId === "string" ? task.meta.attemptId : task.artifactId,
+        runId: typeof task.meta.runId === "string" ? task.meta.runId : undefined,
+        model: typeof task.meta.model === "string" ? task.meta.model : undefined }, operation);
+}
 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) => {
+    await Promise.all(machgenTasks.map(async (task) => withProviderTaskContext(engine, bookId, task, async () => {
         try {
             await processMachGenTaskStatus(engine, task, await provider.api.v0.tasks(task.taskId), result, bookId);
         }
@@ -807,7 +813,7 @@ async function pollMachGenTasks(engine, tasks, result, bookId, baseURL) {
             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,
@@ -887,7 +893,7 @@ export async function pollPendingProviderTasks(engine, book_id, options = {}) {
             timeout: 30_000,
             ...(kieBaseURL ? { baseURL: kieBaseURL } : {}),
         });
-        await Promise.all(kieTasks.map(async (task) => {
+        await Promise.all(kieTasks.map(async (task) => withProviderTaskContext(engine, book_id, task, async () => {
             try {
                 const taskInfo = await provider.get.api.v1.jobs.recordInfo(task.taskId);
                 await processKieTaskResult(engine, task, taskInfo, result, book_id);
@@ -904,7 +910,7 @@ export async function pollPendingProviderTasks(engine, book_id, options = {}) {
                     }
                 }
             }
-        }));
+        })));
     }
     // Poll KIE Veo tasks (separate namespace: kie.veo.get.api.v1.veo.recordInfo)
     const veoTasks = pollableTasks.filter(isVeoPendingTask);
@@ -914,7 +920,7 @@ export async function pollPendingProviderTasks(engine, book_id, options = {}) {
             timeout: 30_000,
             ...(kieBaseURL ? { baseURL: kieBaseURL } : {}),
         });
-        await Promise.all(veoTasks.map(async (task) => {
+        await Promise.all(veoTasks.map(async (task) => withProviderTaskContext(engine, book_id, task, async () => {
             const prompt = metaPrompt(task.meta);
             try {
                 const recordInfo = await provider.veo.get.api.v1.veo.recordInfo(task.taskId);
@@ -973,13 +979,13 @@ export async function pollPendingProviderTasks(engine, book_id, options = {}) {
                     }
                 }
             }
-        }));
+        })));
     }
     // Poll xAI tasks (only if API key is set)
     const xaiTasks = pollableTasks.filter((t) => t.taskType.startsWith("xai_"));
     if (process.env.XAI_API_KEY && xaiTasks.length > 0) {
         const provider = createXai({ apiKey: process.env.XAI_API_KEY, timeout: 30_000 });
-        await Promise.all(xaiTasks.map(async (task) => {
+        await Promise.all(xaiTasks.map(async (task) => withProviderTaskContext(engine, book_id, task, async () => {
             const prompt = metaPrompt(task.meta);
             try {
                 const videoResult = await provider.get.v1.videos(task.taskId);
@@ -1029,13 +1035,13 @@ export async function pollPendingProviderTasks(engine, book_id, options = {}) {
                     }
                 }
             }
-        }));
+        })));
     }
     // Poll Alibaba tasks (only if API key is set)
     const alibabaTasks = pollableTasks.filter((t) => t.taskType.startsWith("alibaba_"));
     if (process.env.DASHSCOPE_API_KEY && alibabaTasks.length > 0) {
         const provider = createAlibaba({ apiKey: process.env.DASHSCOPE_API_KEY, timeout: 30_000 });
-        await Promise.all(alibabaTasks.map(async (task) => {
+        await Promise.all(alibabaTasks.map(async (task) => withProviderTaskContext(engine, book_id, task, async () => {
             const prompt = metaPrompt(task.meta);
             try {
                 const taskStatus = await provider.get.api.v1.tasks(task.taskId);
@@ -1105,7 +1111,7 @@ export async function pollPendingProviderTasks(engine, book_id, options = {}) {
                     }
                 }
             }
-        }));
+        })));
     }
     // Poll FAL tasks (only if API key is set)
     const falTasks = pollableTasks.filter((t) => t.taskType.startsWith("fal_"));
@@ -1116,7 +1122,7 @@ export async function pollPendingProviderTasks(engine, book_id, options = {}) {
         // — e.g. `fal-ai/elevenlabs/speech-to-text/scribe-v2` — 405s. Strip back
         // to `fal-ai/elevenlabs` for polling.
         const falNamespace = (endpointId) => endpointId.split("/").slice(0, 2).join("/");
-        await Promise.all(falTasks.map(async (task) => {
+        await Promise.all(falTasks.map(async (task) => withProviderTaskContext(engine, book_id, task, async () => {
             const prompt = metaPrompt(task.meta);
             const endpointId = typeof task.meta?.falEndpointId === "string" ? task.meta.falEndpointId : null;
             if (!endpointId) {
@@ -1179,7 +1185,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) {

package/dist/tools/set-har-capture.js

@@ -0,0 +1,30 @@
+import { z } from "zod";
+import { harSettingsSchema, readHarSettings, writeHarSettings, harDirectory } from "../har-settings.js";
+import { appState } from "../app-state.js";
+export function setHarCaptureDef(store = appState) {
+    return {
+        name: "set_har_capture",
+        description: "Read or change opt-in local provider HAR diagnostics. Captures retain prompts, media URLs, parameters, responses and errors; secrets, cookies and oversized media bytes are scrubbed. Omit mode to read settings. Environment override wins.",
+        schema: {
+            mode: harSettingsSchema.shape.mode.removeDefault().optional(),
+            maxAgeDays: harSettingsSchema.shape.maxAgeDays.removeDefault().optional(),
+            maxTotalMB: harSettingsSchema.shape.maxTotalMB.removeDefault().optional(),
+        },
+        handler: async (args) => {
+            try {
+                const changes = z.object({
+                    mode: harSettingsSchema.shape.mode.removeDefault().optional(),
+                    maxAgeDays: harSettingsSchema.shape.maxAgeDays.removeDefault().optional(),
+                    maxTotalMB: harSettingsSchema.shape.maxTotalMB.removeDefault().optional(),
+                }).parse(args);
+                const settings = Object.values(changes).some((value) => value !== undefined)
+                    ? await writeHarSettings({ ...await readHarSettings(store, {}), ...changes }, store)
+                    : await readHarSettings(store);
+                return { content: [{ type: "text", text: JSON.stringify({ ...settings, dir: harDirectory(), overridden: Boolean(process.env.VIDEOBOOK_HAR_CAPTURE?.trim()) }) }] };
+            }
+            catch (error) {
+                return { isError: true, content: [{ type: "text", text: error instanceof Error ? error.message : String(error) }] };
+            }
+        },
+    };
+}

package/dist/upload.js

@@ -1,4 +1,5 @@
-import { createFreeMediaUpload, uploadToAnyHost } from "@apicity/free-media-upload";
+import { createFreeMediaUpload } from "./usage-providers.js";
+import { uploadToAnyHost } from "@apicity/free-media-upload";
 import { createHash } from "node:crypto";
 import { maybeReencodeImage, maybeUpscaleSmallImage } from "./image-compress.js";
 export function contentHash(data) {

package/dist/usage-providers.js

@@ -1,29 +1,67 @@
+import { createFreeMediaUpload as freemediaupload } from "@apicity/free-media-upload";
+import { createKimiCoding as kimicoding } from "@apicity/kimicoding";
+import { createXOAuth as xoauth } from "@apicity/x";
+import { createX as x } from "@apicity/x";
+import { createDropbox as dropbox } from "@apicity/dropbox";
+import { createB2 as b2 } from "@apicity/b2";
 import { createOpenAi as openai } from "@apicity/openai";
 import { createXai as xai } from "@apicity/xai";
-import { createKie as kie } from "@apicity/kie";
-import { createFal as fal } from "@apicity/fal";
-import { createAlibaba as alibaba } from "@apicity/alibaba";
+import { createKie as kie, uploadFile as kieUpload, submitMediaJob as submitKieMediaJob } from "@apicity/kie";
+import { createFal as fal, uploadFile as falUpload } from "@apicity/fal";
+import { createAlibaba as alibaba, uploadFile as alibabaUpload } from "@apicity/alibaba";
 import { createElevenLabs as elevenlabs } from "@apicity/elevenlabs";
 import { createMachGen as machgen } from "@apicity/machgen";
+import { capturedProvider, withHarCapture, withProviderCall } from "./har-capture.js";
 import { providerUsageFetch } from "./provider-usage.js";
 export function createOpenAi(options) {
-    return openai({ ...options, fetch: providerUsageFetch("openai", options.fetch) });
+    return capturedProvider("openai", (fetch) => openai({ ...options, fetch }), providerUsageFetch("openai", options.fetch));
 }
 export function createXai(options) {
-    return xai({ ...options, fetch: providerUsageFetch("xai", options.fetch) });
+    return capturedProvider("xai", (fetch) => xai({ ...options, fetch }), providerUsageFetch("xai", options.fetch));
 }
 export function createKie(options) {
-    return kie({ ...options, fetch: providerUsageFetch("kie", options.fetch) });
+    return capturedProvider("kie", (fetch) => kie({ ...options, fetch }), providerUsageFetch("kie", options.fetch));
 }
 export function createFal(options) {
-    return fal({ ...options, fetch: providerUsageFetch("fal", options.fetch) });
+    return capturedProvider("fal", (fetch) => fal({ ...options, fetch }), providerUsageFetch("fal", options.fetch));
 }
 export function createAlibaba(options) {
-    return alibaba({ ...options, fetch: providerUsageFetch("alibaba", options.fetch) });
+    return capturedProvider("alibaba", (fetch) => alibaba({ ...options, fetch }), providerUsageFetch("alibaba", options.fetch));
 }
 export function createElevenLabs(options) {
-    return elevenlabs({ ...options, fetch: providerUsageFetch("elevenlabs", options.fetch) });
+    return capturedProvider("elevenlabs", (fetch) => elevenlabs({ ...options, fetch }), providerUsageFetch("elevenlabs", options.fetch));
 }
 export function createMachGen(options) {
-    return machgen({ ...options, fetch: providerUsageFetch("machgen", options.fetch) });
+    return capturedProvider("machgen", (fetch) => machgen({ ...options, fetch }), providerUsageFetch("machgen", options.fetch));
+}
+export function createB2(options) {
+    return capturedProvider("b2", (fetch) => b2({ ...options, fetch }), options?.fetch);
+}
+export function createDropbox(options) {
+    return capturedProvider("dropbox", (fetch) => dropbox({ ...options, fetch }), options?.fetch);
+}
+export function createX(options) {
+    return capturedProvider("x", (fetch) => x({ ...options, fetch }), options?.fetch);
+}
+export function createXOAuth(options) {
+    return capturedProvider("x", (fetch) => xoauth({ ...options, fetch }), options?.fetch);
+}
+export function createKimiCoding(options) {
+    return capturedProvider("kimicoding", (fetch) => kimicoding({ ...options, fetch }), options?.fetch);
+}
+export function createFreeMediaUpload(options = {}) {
+    return capturedProvider("free-media-upload", (fetch) => freemediaupload({ ...options, fetch }), options?.fetch);
+}
+export function uploadFalFile(options, input) {
+    return withHarCapture({ provider: "fal", endpoint: "uploadFile", input }, (fetch) => falUpload(fal({ ...options, fetch }), input), providerUsageFetch("fal", options.fetch));
+}
+export function uploadAlibabaFile(options, input) {
+    return withHarCapture({ provider: "alibaba", endpoint: "uploadFile", input }, (fetch) => alibabaUpload(alibaba({ ...options, fetch }), input), providerUsageFetch("alibaba", options.fetch));
+}
+export function uploadKieFile(options, file, filename) {
+    return withHarCapture({ provider: "kie", endpoint: "uploadFile", input: { file, filename } }, (fetch) => kieUpload(kie({ ...options, fetch }), file, filename), providerUsageFetch("kie", options.fetch));
+}
+export function submitMediaJob(...args) {
+    const [provider, request, approval] = args;
+    return withProviderCall(provider, { provider: "kie", endpoint: "api.v1.jobs.createTask", input: request }, (original) => submitKieMediaJob(original, request, approval));
 }

package/dist/workspace-action-groups.js

@@ -79,7 +79,7 @@ export const WORKSPACE_TOOL_GROUPS = {
     ],
     History: [
         "asset_history", "restore_asset_version", "read_file_at_commit",
-        "list_cell_generations", "inspect_generation_request",
+        "list_cell_generations", "inspect_generation_request", "get_generation_har",
         "record_prompt", "list_prompt_history", "list_book_actions",
         "get_history_action",
     ],
@@ -92,7 +92,7 @@ export const WORKSPACE_TOOL_GROUPS = {
     ],
     Publishing: ["create_post", "update_post", "get_post", "list_posts", "link_post", "upload_post_to_dropbox", "save_post_to_icloud", "refresh_post_metrics", "record_post_metrics", "connect_service", "service_status", "post_icloud_sync_status", "draft_post_copy", "post", "verify_x_mentions"],
     Providers: [
-        "check_kimi_coding_api", "list_chat_models", "provider_key_status", "set_env_secret",
+        "check_kimi_coding_api", "list_chat_models", "provider_key_status", "set_env_secret", "set_har_capture",
         "list_elevenlabs_voices",
     ],
 };

package/dist/x/account.js

@@ -7,7 +7,7 @@
  * store next to the OAuth tokens, so posting never spends an extra API call.
  * Callers refresh it after a new authorization or on explicit request.
  */
-import { createX } from "@apicity/x";
+import { createX } from "../usage-providers.js";
 import { appState } from "../app-state.js";
 import { getValidAccessToken } from "./x-tokens.js";
 export const X_POST_MAX_CHARACTERS = 280;

package/dist/x/authenticated-handle.js

@@ -5,7 +5,7 @@
  * API rejects, or the response is malformed. Callers should treat null as
  * "unknown" and fall back to a cached value or prompt the user.
  */
-import { createX } from "@apicity/x";
+import { createX } from "../usage-providers.js";
 import { getValidAccessToken } from "./x-tokens.js";
 import { normalizeHandle } from "../watermark-config.js";
 export async function fetchAuthenticatedXHandle() {

package/dist/x/oauth-flow.js

@@ -1,6 +1,6 @@
 import http from "node:http";
 import crypto from "node:crypto";
-import { createXOAuth } from "@apicity/x";
+import { createXOAuth } from "../usage-providers.js";
 import { appState } from "../app-state.js";
 import { readTokens, writeTokens } from "./x-tokens.js";
 import { clearXAccount, fetchXAccount, resolveXAccount, xPostMaxCharacters, } from "./account.js";

package/dist/x/post-to-x.js

@@ -1,5 +1,6 @@
 import { findPrimaryMediaFile } from "videobook-engine";
-import { createX, XError } from "@apicity/x";
+import { createX } from "../usage-providers.js";
+import { XError } from "@apicity/x";
 import { extname, join } from "node:path";
 import { tmpdir } from "node:os";
 import { readFile, unlink } from "node:fs/promises";