@nodetool-ai/runtime 0.8.8 → 0.8.9-beta.2

package/dist/providers/video-frames.js

@@ -1,37 +1,21 @@
 /**
- * Sample a video into still frames with ffmpeg.
+ * Sample a video into still frames, decoded in process.
  *
  * This is what lets a vision model that cannot read a clip still answer
  * questions about one: the bytes are decoded here, a bounded number of frames
  * come back as JPEGs, and the caller sends them as ordinary image content.
- *
- * The argv is ours, not a model's — the only input path is a temp file this
- * module wrote — so the containment `packages/agents/src/host-binary-guard.ts`
- * applies to a model-supplied argv is not needed. `-protocol_whitelist file`
- * and `-nostdin` still go in: an mp4 can name an external opener, and a child
- * that inherits the server's stdin outlives the call.
+ * The only input is a temp file this module wrote.
  */
 import { importNodeBuiltin } from "@nodetool-ai/config";
+import { loadSharpOrThrow } from "../image-codec.js";
+import { loadMediaModule } from "../media-loader.js";
 import { withSpan } from "../tracing-helpers.js";
 import { mp4DurationSeconds } from "./video-duration.js";
-/** ffmpeg or ffprobe is not installed. Names the binary and the way out. */
-export class FrameSamplingUnavailableError extends Error {
-    binary;
-    constructor(binary) {
-        super(`${binary} is not installed or not on PATH. Reading a video with a ` +
-            `provider that has no video content part samples frames with ffmpeg ` +
-            `first — install ffmpeg (the Package Manager UI can do this), or use ` +
-            `a provider whose chat models read video natively (gemini).`);
-        this.name = "FrameSamplingUnavailableError";
-        this.binary = binary;
-    }
-}
 const DEFAULT_MAX_FRAMES = 16;
 const DEFAULT_MAX_FPS = 1;
 const DEFAULT_MAX_DIMENSION = 768;
-/** ffmpeg `-q:v` for the JPEG encoder (2 = best, 31 = worst). */
-const JPEG_QUALITY = 4;
-const FFMPEG_MAX_BUFFER = 8 * 1024 * 1024;
+/** sharp JPEG quality, about what ffmpeg's `-q:v 4` gave. */
+const JPEG_QUALITY = 85;
 /** Read a positive number from the environment, or fall back. */
 function envNumber(name, fallback) {
     const raw = Number(globalThis.process?.env?.[name]);
@@ -46,63 +30,15 @@ function frameSamplingLimits() {
     };
 }
 async function nodeModules() {
-    const [cp, fs, os, path] = await Promise.all([
-        importNodeBuiltin("node:child_process"),
+    const [fs, os, path] = await Promise.all([
         importNodeBuiltin("node:fs/promises"),
         importNodeBuiltin("node:os"),
         importNodeBuiltin("node:path")
     ]);
-    if (!cp || !fs || !os || !path) {
+    if (!fs || !os || !path) {
         throw new Error("Video frame sampling requires Node built-in modules");
     }
-    return { cp, fs, os, path };
-}
-/** Whether a spawn failed because the binary is not on PATH. */
-function isSpawnEnoent(err) {
-    return (typeof err === "object" &&
-        err !== null &&
-        err.code === "ENOENT");
-}
-async function run(cp, binary, args, signal) {
-    return await new Promise((resolve, reject) => {
-        cp.execFile(binary, args, { maxBuffer: FFMPEG_MAX_BUFFER, signal, windowsHide: true }, (error, stdout, stderr) => {
-            if (error) {
-                if (isSpawnEnoent(error)) {
-                    reject(new FrameSamplingUnavailableError(binary));
-                    return;
-                }
-                reject(error);
-                return;
-            }
-            resolve({ stdout: String(stdout), stderr: String(stderr) });
-        });
-    });
-}
-/** Clip length in seconds, or null when ffprobe cannot say. */
-async function probeDuration(cp, file, signal) {
-    try {
-        const { stdout } = await run(cp, "ffprobe", [
-            "-v",
-            "error",
-            "-show_entries",
-            "format=duration",
-            "-of",
-            "csv=p=0",
-            file
-        ], signal);
-        const seconds = Number(stdout.trim().split("\n")[0]);
-        return Number.isFinite(seconds) && seconds > 0 ? seconds : null;
-    }
-    catch (error) {
-        if (signal?.aborted)
-            throw error;
-        // A missing binary is actionable and must reach the caller. A probe that
-        // ran and failed (an odd container, no format header) is not: the sample
-        // falls back to the ceiling rate below.
-        if (error instanceof FrameSamplingUnavailableError)
-            throw error;
-        return null;
-    }
+    return { fs, os, path };
 }
 /** Read a video duration from its bytes without decoding frames. */
 export async function probeVideoDurationSeconds(bytes, signal) {
@@ -113,17 +49,10 @@ export async function probeVideoDurationSeconds(bytes, signal) {
         return mp4Duration;
     }
     return withSpan("media.probe_video_duration", { "media.byte_length": bytes.byteLength }, async () => {
-        const { cp, fs, os, path } = await nodeModules();
-        const dir = await fs.mkdtemp(path.join(os.tmpdir(), "nodetool-vduration-"));
-        const input = path.join(dir, "input.bin");
-        try {
-            await fs.writeFile(input, bytes, { signal });
-            return await probeDuration(cp, input, signal);
-        }
-        finally {
-            // Cleanup failure must not replace the duration result or probe error.
-            await fs.rm(dir, { recursive: true, force: true }).catch(() => { });
-        }
+        // Loaded on demand: the media module is Node-only.
+        const { probeDurationSec } = await import("../media/probe.js");
+        const durationSec = await probeDurationSec(bytes, { signal });
+        return durationSec !== null && durationSec > 0 ? durationSec : null;
     });
 }
 /**
@@ -140,7 +69,7 @@ export function frameRateFor(durationSec, maxFrames, maxFps) {
     return Math.min(maxFps, Math.max(spread, 0.01));
 }
 /**
- * Fit inside a square of `maxDimension` without upscaling. ffmpeg's
+ * Fit inside a square of `maxDimension` without upscaling. libav's
  * `force_original_aspect_ratio=decrease` would enlarge a smaller frame, which
  * costs tokens and adds no detail.
  */
@@ -150,49 +79,52 @@ function scaleFilter(maxDimension) {
 }
 /**
  * Decode `bytes` and return up to `maxFrames` JPEG stills spread across the
- * clip. Throws {@link FrameSamplingUnavailableError} when ffmpeg is absent.
+ * clip.
  */
 export async function sampleVideoFrames(bytes, options = {}) {
     const limits = frameSamplingLimits();
     const maxFrames = Math.max(1, options.maxFrames ?? limits.maxFrames);
     const maxFps = options.maxFps ?? limits.maxFps;
     const maxDimension = options.maxDimension ?? limits.maxDimension;
-    const { cp, fs, os, path } = await nodeModules();
+    const signal = options.signal ?? new AbortController().signal;
+    const { fs, os, path } = await nodeModules();
+    const [{ openRgbaFrameReader }, sharp] = await Promise.all([
+        loadMediaModule(),
+        loadSharpOrThrow()
+    ]);
     const dir = await fs.mkdtemp(path.join(os.tmpdir(), "nodetool-vframes-"));
     const input = path.join(dir, "input.bin");
-    const outDir = path.join(dir, "frames");
     try {
         await fs.writeFile(input, bytes);
-        await fs.mkdir(outDir);
-        const durationSec = await probeDuration(cp, input, options.signal);
+        const durationSec = await probeVideoDurationSeconds(bytes, signal);
         const fps = frameRateFor(durationSec, maxFrames, maxFps);
-        await run(cp, "ffmpeg", [
-            "-nostdin",
-            "-y",
-            "-v",
-            "error",
-            "-protocol_whitelist",
-            "file",
-            "-i",
-            input,
-            "-vf",
-            `fps=${fps.toFixed(6)},${scaleFilter(maxDimension)}`,
-            "-frames:v",
-            String(maxFrames),
-            "-q:v",
-            String(JPEG_QUALITY),
-            path.join(outDir, "frame_%04d.jpg")
-        ], options.signal);
-        const names = (await fs.readdir(outDir))
-            .filter((n) => n.startsWith("frame_") && n.endsWith(".jpg"))
-            .sort();
+        const reader = await openRgbaFrameReader({
+            filePath: input,
+            filter: `fps=${fps.toFixed(6)},${scaleFilter(maxDimension)},format=rgba`,
+            signal
+        });
+        if (!reader)
+            throw new Error("The video has no picture to sample");
         const frames = [];
-        for (const [index, name] of names.entries()) {
-            frames.push({
-                data: new Uint8Array(await fs.readFile(path.join(outDir, name))),
-                mimeType: "image/jpeg",
-                timeSec: index / fps
-            });
+        try {
+            while (frames.length < maxFrames) {
+                const frame = await reader.next();
+                if (!frame)
+                    break;
+                const jpeg = await sharp(Buffer.from(frame.rgba.buffer, frame.rgba.byteOffset, frame.rgba.byteLength), {
+                    raw: { width: frame.width, height: frame.height, channels: 4 }
+                })
+                    .jpeg({ quality: JPEG_QUALITY })
+                    .toBuffer();
+                frames.push({
+                    data: new Uint8Array(jpeg),
+                    mimeType: "image/jpeg",
+                    timeSec: frames.length / fps
+                });
+            }
+        }
+        finally {
+            await reader.close();
         }
         return {
             frames,

package/dist/providers/video-frames.js.map

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

package/dist/storage-workspace.d.ts

@@ -1,62 +1,2 @@
-/**
- * The one {@link Workspace} implementation, over any {@link StorageAdapter}.
- *
- * There is deliberately no second implementation for local folders: a local
- * workspace is this class over a `FileStorageAdapter`, which is what keeps the
- * two deployments on the same code path instead of on two that drift.
- */
-import { type StorageAdapter } from "./context.js";
-import { type Workspace, type WorkspaceEntry, type WorkspaceStat } from "./workspace.js";
-export declare class StorageWorkspace implements Workspace {
-    readonly storage: StorageAdapter;
-    readonly localDir: string | null;
-    private scratch;
-    constructor(storage: StorageAdapter, opts?: {
-        localDir?: string | null;
-    });
-    private rootReady;
-    /** Create the workspace directory once, on first use. */
-    private ensureRoot;
-    key(path: string): string;
-    /**
-     * Refuse a path whose real location leaves the workspace.
-     *
-     * Called on every operation that touches a local workspace. `key()` already
-     * refuses a `..` that climbs out lexically; this is the half a symlink
-     * defeats.
-     */
-    private assertContained;
-    uri(path: string): string;
-    read(path: string): Promise<Uint8Array | null>;
-    readText(path: string): Promise<string | null>;
-    write(path: string, data: Uint8Array | string, contentType?: string): Promise<void>;
-    exists(path: string): Promise<boolean>;
-    stat(path: string): Promise<WorkspaceStat | null>;
-    list(path?: string, opts?: {
-        recursive?: boolean;
-    }): Promise<WorkspaceEntry[]>;
-    private listEntries;
-    delete(path: string): Promise<boolean>;
-    deleteAll(path: string): Promise<number>;
-    mkdir(path: string): Promise<void>;
-    copy(from: string, to: string): Promise<void>;
-    move(from: string, to: string): Promise<void>;
-    materialize(path: string): Promise<string>;
-    private stage;
-    absorb(localPath: string, path: string): Promise<void>;
-    private absorbFile;
-    scratchDir(): Promise<string>;
-    cleanupScratch(): Promise<void>;
-}
-/**
- * Build a workspace over a storage backend.
- *
- * `prefix` carves a namespace out of a shared bucket — how a cloud deployment
- * gives each user their own workspace inside the one bucket it has.
- */
-export declare function createWorkspace(storage: StorageAdapter, opts?: {
-    prefix?: string | null;
-}): Workspace;
-/** A workspace over a real directory. */
-export declare function createLocalWorkspace(dir: string): Workspace;
+export { StorageWorkspace, createWorkspace, createLocalWorkspace } from "@nodetool-ai/runtime-core";
 //# sourceMappingURL=storage-workspace.d.ts.map

package/dist/storage-workspace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage-workspace.d.ts","sourceRoot":"","sources":["../src/storage-workspace.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAGxE,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,gBAAgB,CAAC;AA+IxB,qBAAa,gBAAiB,YAAW,SAAS;IAChD,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,OAAO,CAAC,OAAO,CAAgC;IAE/C,YAAY,OAAO,EAAE,cAAc,EAAE,IAAI,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAO,EAG3E;IAED,OAAO,CAAC,SAAS,CAA8B;IAE/C,yDAAyD;IACzD,OAAO,CAAC,UAAU;IASlB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIxB;IAED;;;;;;OAMG;YACW,eAAe;IAa7B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExB;IAED,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAa7C;IAEK,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAGnD;IAED,KAAK,CACH,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,UAAU,GAAG,MAAM,EACzB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAWf;IAEK,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO3C;IAEK,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAuCtD;IAED,IAAI,CACF,IAAI,SAAK,EACT,IAAI,GAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAO,GACjC,OAAO,CAAC,cAAc,EAAE,CAAC,CAO3B;YAEa,WAAW;IA+BnB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAG3C;IAEK,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAuB7C;IAEK,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAavC;IAEK,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOlD;IAEK,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGlD;IAED,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIzC;YAEa,KAAK;IAenB,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIrD;YAEa,UAAU;IAalB,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAOlC;IAEK,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAMpC;CACF;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,cAAc,EACvB,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAO,GACpC,SAAS,CAUX;AAED,yCAAyC;AACzC,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAE3D"}
+{"version":3,"file":"storage-workspace.d.ts","sourceRoot":"","sources":["../src/storage-workspace.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC"}