@nodetool-ai/websocket 0.7.0-rc.23 → 0.8.1

package/dist/lib/asset-response.js

@@ -0,0 +1,88 @@
+/**
+ * The wire shape of one asset row, shared by the REST asset routes and the
+ * tRPC `assets.*` procedures.
+ *
+ * Both surfaces answer the same JSON, so both mint it here: the same field
+ * list, the same owner-prefixed storage keys, and the same lazily-built URL
+ * builder. A field added on one path used to have to be added on the other.
+ */
+import { loadAssetStorageConfig } from "@nodetool-ai/config";
+import { assetObjectKey, createAssetUrlBuilder } from "@nodetool-ai/storage";
+import { getAssetFileName } from "./asset-paths.js";
+import { assetHasRasterThumbnail, thumbnailKey } from "./thumbnail.js";
+import { externalAssetMtime, isExternalAssetOffline } from "./external-asset-lookup.js";
+import { videoProxyState } from "./video-proxy.js";
+let cachedConfig = null;
+let cachedBuilder = null;
+/**
+ * The URL builder for the configured storage backend, rebuilt when the
+ * backend kind changes (a test switching backends mid-process).
+ */
+function assetUrlBuilder() {
+    const config = loadAssetStorageConfig();
+    if (!cachedBuilder || cachedConfig?.kind !== config.kind) {
+        cachedConfig = config;
+        cachedBuilder = createAssetUrlBuilder(config);
+    }
+    return cachedBuilder;
+}
+export async function toAssetResponse(asset) {
+    const isFolder = asset.content_type === "folder";
+    const fileName = isFolder
+        ? null
+        : getAssetFileName(asset.id, asset.content_type);
+    // Owner-prefixed keys. Objects written before this layout are flat; the
+    // `/api/storage` route falls back to the legacy path on a miss, and cloud
+    // backends need `nodetool storage migrate-keys` (see docs/configuration.md).
+    const getUrl = fileName
+        ? await assetUrlBuilder()(assetObjectKey(asset.user_id, fileName)).catch(() => null)
+        : null;
+    const hasThumbnail = assetHasRasterThumbnail(asset.content_type);
+    const thumbKeyUrl = hasThumbnail
+        ? await assetUrlBuilder()(assetObjectKey(asset.user_id, thumbnailKey(asset.id))).catch(() => null)
+        : null;
+    // A relink regenerates an external asset's thumbnail under the same key.
+    // The file's mtime in the URL keeps a cached thumbnail of the previous file
+    // from standing in for the new one. `get_url` stays unversioned (D5).
+    const externalMtime = externalAssetMtime(asset);
+    const thumbUrl = thumbKeyUrl && externalMtime !== null
+        ? `${thumbKeyUrl}?v=${Math.trunc(externalMtime)}`
+        : thumbKeyUrl;
+    const response = {
+        id: asset.id,
+        user_id: asset.user_id,
+        workflow_id: asset.workflow_id ?? null,
+        parent_id: asset.parent_id ?? null,
+        name: asset.name,
+        content_type: asset.content_type,
+        size: asset.size ?? null,
+        metadata: asset.metadata ?? null,
+        sketch_document_id: asset.sketch_document_id ?? null,
+        created_at: asset.created_at,
+        get_url: getUrl,
+        thumb_url: thumbUrl,
+        duration: asset.duration ?? null,
+        node_id: asset.node_id ?? null,
+        job_id: asset.job_id ?? null,
+        timeline_id: asset.timeline_id ?? null,
+        project_id: asset.project_id
+    };
+    // Only assets that reference a file in place carry the flag.
+    if (asset.external_path) {
+        response.offline = await isExternalAssetOffline(asset);
+    }
+    // Video on a local server: whether the preview may play the proxy. The URL
+    // carries the source version, so a remade proxy is never served from cache.
+    const proxy = await videoProxyState(asset);
+    if (proxy) {
+        response.proxy_status = proxy.status;
+        response.proxy_url =
+            proxy.key !== null
+                ? await assetUrlBuilder()(proxy.key)
+                    .then((url) => `${url}?v=${proxy.version}`)
+                    .catch(() => null)
+                : null;
+    }
+    return response;
+}
+//# sourceMappingURL=asset-response.js.map

package/dist/lib/asset-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-response.js","sourceRoot":"","sources":["../../src/lib/asset-response.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,sBAAsB,EAAsB,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAG7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,IAAI,YAAY,GAAyB,IAAI,CAAC;AAC9C,IAAI,aAAa,GAA8C,IAAI,CAAC;AAEpE;;;GAGG;AACH,SAAS,eAAe;IACtB,MAAM,MAAM,GAAG,sBAAsB,EAAE,CAAC;IACxC,IAAI,CAAC,aAAa,IAAI,YAAY,EAAE,IAAI,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC;QACzD,YAAY,GAAG,MAAM,CAAC;QACtB,aAAa,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,KAAY;IAChD,MAAM,QAAQ,GAAG,KAAK,CAAC,YAAY,KAAK,QAAQ,CAAC;IACjD,MAAM,QAAQ,GAAG,QAAQ;QACvB,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;IACnD,wEAAwE;IACxE,0EAA0E;IAC1E,6EAA6E;IAC7E,MAAM,MAAM,GAAG,QAAQ;QACrB,CAAC,CAAC,MAAM,eAAe,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,CACpE,GAAG,EAAE,CAAC,IAAI,CACX;QACH,CAAC,CAAC,IAAI,CAAC;IAET,MAAM,YAAY,GAAG,uBAAuB,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IACjE,MAAM,WAAW,GAAG,YAAY;QAC9B,CAAC,CAAC,MAAM,eAAe,EAAE,CACrB,cAAc,CAAC,KAAK,CAAC,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CACtD,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;QACrB,CAAC,CAAC,IAAI,CAAC;IACT,yEAAyE;IACzE,4EAA4E;IAC5E,sEAAsE;IACtE,MAAM,aAAa,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,QAAQ,GACZ,WAAW,IAAI,aAAa,KAAK,IAAI;QACnC,CAAC,CAAC,GAAG,WAAW,MAAM,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE;QACjD,CAAC,CAAC,WAAW,CAAC;IAElB,MAAM,QAAQ,GAAkB;QAC9B,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,IAAI;QACtC,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI;QAClC,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,IAAI;QACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,IAAI;QAChC,kBAAkB,EAAE,KAAK,CAAC,kBAAkB,IAAI,IAAI;QACpD,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,OAAO,EAAE,MAAM;QACf,SAAS,EAAE,QAAQ;QACnB,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,IAAI;QAChC,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,IAAI;QAC9B,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,IAAI;QAC5B,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,IAAI;QACtC,UAAU,EAAE,KAAK,CAAC,UAAU;KAC7B,CAAC;IACF,6DAA6D;IAC7D,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;QACxB,QAAQ,CAAC,OAAO,GAAG,MAAM,sBAAsB,CAAC,KAAK,CAAC,CAAC;IACzD,CAAC;IACD,2EAA2E;IAC3E,4EAA4E;IAC5E,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,KAAK,CAAC,CAAC;IAC3C,IAAI,KAAK,EAAE,CAAC;QACV,QAAQ,CAAC,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC;QACrC,QAAQ,CAAC,SAAS;YAChB,KAAK,CAAC,GAAG,KAAK,IAAI;gBAChB,CAAC,CAAC,MAAM,eAAe,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC;qBAC/B,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;qBAC1C,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;gBACtB,CAAC,CAAC,IAAI,CAAC;IACb,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/lib/audio-peaks.d.ts

@@ -0,0 +1,23 @@
+/** The count the timeline asks for; also the default. */
+export declare const DEFAULT_PEAK_COUNT = 2000;
+export declare const MAX_PEAK_COUNT = 20000;
+export interface AudioPeaks {
+    /** `count` abs-max values of channel 0, each in [0, 1] for normal audio. */
+    peaks: number[];
+    /** Decoded length of the audio stream. */
+    duration_ms: number;
+}
+/**
+ * Decode channel 0 of the first audio stream of `filePath` with ffmpeg and
+ * reduce it to `count` abs-max peaks. Returns null when the file has no audio
+ * stream. Throws {@link MediaToolingMissingError} when ffmpeg is missing.
+ */
+export declare function computeAudioPeaks(filePath: string, count: number): Promise<AudioPeaks | null>;
+/**
+ * GET /api/assets/:id/peaks?count=<n>
+ *
+ * Answers `{ peaks, duration_ms }` for an audio or video asset the caller
+ * owns. The `x-peaks-cache` header says whether the disk cache answered.
+ */
+export declare function handleAssetPeaks(userId: string, assetId: string, searchParams: URLSearchParams): Promise<Response>;
+//# sourceMappingURL=audio-peaks.d.ts.map

package/dist/lib/audio-peaks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-peaks.d.ts","sourceRoot":"","sources":["../../src/lib/audio-peaks.ts"],"names":[],"mappings":"AA8BA,yDAAyD;AACzD,eAAO,MAAM,kBAAkB,OAAO,CAAC;AACvC,eAAO,MAAM,cAAc,QAAS,CAAC;AAUrC,MAAM,WAAW,UAAU;IACzB,4EAA4E;IAC5E,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;CACrB;AA8FD;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CA8E5B;AA0DD;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,eAAe,GAC5B,OAAO,CAAC,QAAQ,CAAC,CAwEnB"}

package/dist/lib/audio-peaks.js

@@ -0,0 +1,331 @@
+/**
+ * Waveform peaks for an audio or video asset, computed on the server.
+ *
+ * The timeline draws a clip's waveform from a fixed number of abs-max peaks of
+ * channel 0. The browser used to fetch the whole file and decode it with
+ * `decodeAudioData`, which turned a two-hour WAV into gigabytes of float32 in
+ * the renderer. Here ffmpeg decodes the file as a stream, reading a local file
+ * (managed or external) in place, and only a small per-block maximum array is
+ * held while it runs.
+ *
+ * Results are cached on disk under the NodeTool cache directory, keyed by the
+ * asset id, the file's size and mtime (or the row's `updated_at` and size when
+ * the backend keeps no local file), and the peak count. A file changed in
+ * place gets a new key, so a stale waveform is never served.
+ */
+import { spawn, execFile as execFileCb } from "node:child_process";
+import { createHash } from "node:crypto";
+import { promises as fsp } from "node:fs";
+import os from "node:os";
+import nodePath from "node:path";
+import { promisify } from "node:util";
+import { getNodetoolCacheDir } from "@nodetool-ai/config";
+import { Asset } from "@nodetool-ai/models";
+import { getAssetAdapter } from "./storage.js";
+import { localAssetPath, retrieveAssetBytes } from "./asset-paths.js";
+import { MediaToolingMissingError } from "./media.js";
+import { isObjectLike } from "./wire-values.js";
+const execFile = promisify(execFileCb);
+/** The count the timeline asks for; also the default. */
+export const DEFAULT_PEAK_COUNT = 2000;
+export const MAX_PEAK_COUNT = 20_000;
+/** Bumped when the peak algorithm changes, so older cache entries miss. */
+const CACHE_FORMAT_VERSION = 1;
+/** Blocks per output peak kept while decoding, when the length is known. */
+const BLOCKS_PER_PEAK = 8;
+/** Block size when ffprobe reports no duration. */
+const FALLBACK_BLOCK_SAMPLES = 256;
+function isEnoent(err) {
+    return isObjectLike(err) && err.code === "ENOENT";
+}
+/** The first audio stream's sample rate, or null when the file has none. */
+async function probeAudio(filePath) {
+    let stdout;
+    try {
+        ({ stdout } = await execFile("ffprobe", [
+            "-v",
+            "error",
+            "-select_streams",
+            "a:0",
+            "-show_entries",
+            "stream=sample_rate:format=duration",
+            "-of",
+            "json",
+            filePath
+        ]));
+    }
+    catch (err) {
+        if (isEnoent(err))
+            throw new MediaToolingMissingError();
+        return null;
+    }
+    const parsed = JSON.parse(stdout);
+    const sampleRate = Number(parsed.streams?.[0]?.sample_rate);
+    if (!Number.isFinite(sampleRate) || sampleRate <= 0)
+        return null;
+    const durationSec = Number(parsed.format?.duration);
+    return {
+        sampleRate,
+        durationSec: Number.isFinite(durationSec) && durationSec > 0 ? durationSec : null
+    };
+}
+/** A growable array of per-block abs-max values. */
+class BlockMaxima {
+    values = new Float32Array(4096);
+    length = 0;
+    push(value) {
+        if (this.length === this.values.length) {
+            const grown = new Float32Array(this.values.length * 2);
+            grown.set(this.values);
+            this.values = grown;
+        }
+        this.values[this.length] = value;
+        this.length += 1;
+    }
+    maxIn(start, endExclusive) {
+        let max = 0;
+        const end = Math.min(endExclusive, this.length);
+        for (let i = start; i < end; i += 1) {
+            if (this.values[i] > max)
+                max = this.values[i];
+        }
+        return max;
+    }
+}
+/**
+ * Reduce the per-block maxima to `count` buckets over `totalSamples`. Bucket
+ * `i` covers samples `[floor(i * n / count), floor((i + 1) * n / count))`, at
+ * least one, rounded out to whole blocks.
+ */
+function reduceToPeaks(blocks, blockSamples, totalSamples, count) {
+    if (totalSamples === 0)
+        return [];
+    const peaks = new Array(count);
+    const samplesPerBucket = totalSamples / count;
+    for (let i = 0; i < count; i += 1) {
+        const start = Math.floor(i * samplesPerBucket);
+        const end = Math.max(start + 1, Math.floor((i + 1) * samplesPerBucket));
+        const firstBlock = Math.floor(start / blockSamples);
+        const endBlock = Math.max(firstBlock + 1, Math.ceil(end / blockSamples));
+        // Four decimals is below one pixel on any waveform and keeps the JSON small.
+        peaks[i] = Math.round(blocks.maxIn(firstBlock, endBlock) * 10_000) / 10_000;
+    }
+    return peaks;
+}
+/**
+ * Decode channel 0 of the first audio stream of `filePath` with ffmpeg and
+ * reduce it to `count` abs-max peaks. Returns null when the file has no audio
+ * stream. Throws {@link MediaToolingMissingError} when ffmpeg is missing.
+ */
+export async function computeAudioPeaks(filePath, count) {
+    const probe = await probeAudio(filePath);
+    if (!probe)
+        return null;
+    const estimatedSamples = probe.durationSec !== null ? probe.durationSec * probe.sampleRate : null;
+    const blockSamples = estimatedSamples !== null
+        ? Math.max(1, Math.floor(estimatedSamples / (count * BLOCKS_PER_PEAK)))
+        : FALLBACK_BLOCK_SAMPLES;
+    const blocks = new BlockMaxima();
+    let totalSamples = 0;
+    let blockMax = 0;
+    let inBlock = 0;
+    // A float can straddle two stdout chunks; its first bytes wait here.
+    let carry = Buffer.alloc(0);
+    const consume = (chunk) => {
+        const data = carry.length > 0 ? Buffer.concat([carry, chunk]) : chunk;
+        const whole = data.length - (data.length % 4);
+        // Copy into an aligned buffer so the samples read as one typed array.
+        // f32le matches every host NodeTool runs on.
+        const samples = new Float32Array(whole / 4);
+        new Uint8Array(samples.buffer).set(data.subarray(0, whole));
+        for (let i = 0; i < samples.length; i += 1) {
+            const v = Math.abs(samples[i]);
+            if (v > blockMax)
+                blockMax = v;
+            inBlock += 1;
+            if (inBlock === blockSamples) {
+                blocks.push(blockMax);
+                blockMax = 0;
+                inBlock = 0;
+            }
+        }
+        totalSamples += samples.length;
+        carry = Buffer.from(data.subarray(whole));
+    };
+    await new Promise((resolve, reject) => {
+        const child = spawn("ffmpeg", [
+            "-v",
+            "error",
+            "-nostdin",
+            "-i",
+            filePath,
+            "-map",
+            "0:a:0",
+            "-af",
+            "pan=mono|c0=c0",
+            "-f",
+            "f32le",
+            "-acodec",
+            "pcm_f32le",
+            "-"
+        ], { stdio: ["ignore", "pipe", "pipe"] });
+        let stderr = "";
+        child.stdout.on("data", consume);
+        child.stderr.on("data", (chunk) => {
+            if (stderr.length < 4096)
+                stderr += chunk.toString();
+        });
+        child.on("error", (err) => {
+            reject(isEnoent(err) ? new MediaToolingMissingError() : err);
+        });
+        child.on("close", (code) => {
+            if (code === 0)
+                resolve();
+            else
+                reject(new Error(`ffmpeg exited with ${code}: ${stderr.trim()}`));
+        });
+    });
+    if (inBlock > 0)
+        blocks.push(blockMax);
+    return {
+        peaks: reduceToPeaks(blocks, blockSamples, totalSamples, count),
+        duration_ms: (totalSamples / probe.sampleRate) * 1000
+    };
+}
+function peaksCacheDir() {
+    return nodePath.join(getNodetoolCacheDir(), "audio-peaks");
+}
+function cacheFileFor(assetId, version, count) {
+    const digest = createHash("sha256")
+        .update(JSON.stringify([CACHE_FORMAT_VERSION, assetId, version, count]))
+        .digest("hex");
+    return nodePath.join(peaksCacheDir(), `${digest}.json`);
+}
+async function readCached(file) {
+    try {
+        const parsed = JSON.parse(await fsp.readFile(file, "utf8"));
+        return Array.isArray(parsed.peaks) && typeof parsed.duration_ms === "number"
+            ? parsed
+            : null;
+    }
+    catch {
+        return null;
+    }
+}
+async function writeCached(file, peaks) {
+    await fsp.mkdir(nodePath.dirname(file), { recursive: true });
+    // Write then rename so a concurrent reader never sees a partial file.
+    const tmp = `${file}.${process.pid}.${Date.now()}.tmp`;
+    await fsp.writeFile(tmp, JSON.stringify(peaks));
+    await fsp.rename(tmp, file);
+}
+/** The asset row exists but its bytes are gone from the store. */
+class AssetBytesMissingError extends Error {
+}
+/** One computation per cache file, shared by concurrent requests. */
+const inFlight = new Map();
+function jsonResponse(status, body, headers = {}) {
+    return new Response(JSON.stringify(body), {
+        status,
+        headers: { "content-type": "application/json", ...headers }
+    });
+}
+/** The requested count, or null when the parameter is not a valid integer. */
+function parseCount(raw) {
+    if (raw === null || raw === "")
+        return DEFAULT_PEAK_COUNT;
+    const count = Number(raw);
+    return Number.isInteger(count) && count >= 1 && count <= MAX_PEAK_COUNT
+        ? count
+        : null;
+}
+/**
+ * GET /api/assets/:id/peaks?count=<n>
+ *
+ * Answers `{ peaks, duration_ms }` for an audio or video asset the caller
+ * owns. The `x-peaks-cache` header says whether the disk cache answered.
+ */
+export async function handleAssetPeaks(userId, assetId, searchParams) {
+    const count = parseCount(searchParams.get("count"));
+    if (count === null) {
+        return jsonResponse(400, {
+            detail: `count must be an integer from 1 to ${MAX_PEAK_COUNT}`
+        });
+    }
+    const asset = (await Asset.get(assetId));
+    // Another owner's asset is an absence, as in extract-audio.
+    if (!asset || asset.user_id !== userId) {
+        return jsonResponse(404, { detail: "Asset not found" });
+    }
+    const type = asset.content_type;
+    if (!type.startsWith("audio/") && !type.startsWith("video/")) {
+        return jsonResponse(400, { detail: "Asset is not audio or video" });
+    }
+    const adapter = getAssetAdapter();
+    const localPath = await localAssetPath(adapter, asset.user_id, asset.id, type);
+    let version;
+    if (localPath) {
+        const info = await fsp.stat(localPath);
+        version = `file:${info.size}:${Math.trunc(info.mtimeMs)}`;
+    }
+    else {
+        version = `row:${asset.size ?? ""}:${asset.updated_at}`;
+    }
+    const cacheFile = cacheFileFor(asset.id, version, count);
+    const cached = await readCached(cacheFile);
+    if (cached) {
+        return jsonResponse(200, cached, { "x-peaks-cache": "hit" });
+    }
+    let pending = inFlight.get(cacheFile);
+    if (!pending) {
+        pending = computeForAsset(asset, localPath, count).then(async (result) => {
+            if (result) {
+                // An unwritable cache costs a recompute next time, not this answer.
+                await writeCached(cacheFile, result).catch(() => undefined);
+            }
+            return result;
+        });
+        inFlight.set(cacheFile, pending);
+        void pending.then(() => inFlight.delete(cacheFile), () => inFlight.delete(cacheFile));
+    }
+    let result;
+    try {
+        result = await pending;
+    }
+    catch (err) {
+        if (err instanceof MediaToolingMissingError) {
+            return jsonResponse(503, {
+                detail: "ffmpeg is required to compute waveform peaks. Install the ffmpeg runtime."
+            });
+        }
+        if (err instanceof AssetBytesMissingError) {
+            return jsonResponse(404, { detail: "Asset bytes not found" });
+        }
+        throw err;
+    }
+    if (!result) {
+        return jsonResponse(422, { detail: "Asset has no audio stream" });
+    }
+    return jsonResponse(200, result, { "x-peaks-cache": "miss" });
+}
+/**
+ * Peaks from the local file in place, or from the stored bytes written to a
+ * temp file on a backend that keeps no local file.
+ */
+async function computeForAsset(asset, localPath, count) {
+    if (localPath)
+        return computeAudioPeaks(localPath, count);
+    const bytes = await retrieveAssetBytes(getAssetAdapter(), asset.user_id, asset.id, asset.content_type);
+    if (!bytes)
+        throw new AssetBytesMissingError();
+    const dir = await fsp.mkdtemp(nodePath.join(os.tmpdir(), "nodetool-peaks-"));
+    try {
+        const input = nodePath.join(dir, "input");
+        await fsp.writeFile(input, bytes);
+        return await computeAudioPeaks(input, count);
+    }
+    finally {
+        await fsp.rm(dir, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=audio-peaks.js.map

package/dist/lib/audio-peaks.js.map

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

package/dist/lib/bridge.d.ts

@@ -1,8 +1,16 @@
 import type { FastifyRequest, FastifyReply } from "fastify";
+import { Readable } from "node:stream";
+/**
+ * A response `bridge` sends as a stream: no buffering, no gzip, and no
+ * `content-length`. For large downloads such as an export zip. The route
+ * handler must `return reply` after `bridge`, or Fastify ends the response
+ * before the stream has sent anything.
+ */
+export declare function streamedResponse(body: Readable, init: ResponseInit): Response;
 /**
  * Converts a Fastify request into a Web API Request, calls the handler,
  * then forwards the Web API Response back through the Fastify reply.
  * Gzip-compresses large responses (>256KB) when client accepts it.
  */
-export declare function bridge(req: FastifyRequest, reply: FastifyReply, handler: (request: Request) => Promise<Response>): Promise<void>;
+export declare function bridge(req: FastifyRequest, reply: FastifyReply, handler: (request: Request) => Promise<Response>, authenticatedUserIdHeader?: string): Promise<void>;
 //# sourceMappingURL=bridge.d.ts.map

package/dist/lib/bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../src/lib/bridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAK5D;;;;GAIG;AACH,wBAAsB,MAAM,CAC1B,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,GAC/C,OAAO,CAAC,IAAI,CAAC,CAqEf"}
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../src/lib/bridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAQvC;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,GAAG,QAAQ,CAO7E;AAED;;;;GAIG;AACH,wBAAsB,MAAM,CAC1B,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,EAChD,yBAAyB,SAAc,GACtC,OAAO,CAAC,IAAI,CAAC,CAiFf"}

package/dist/lib/bridge.js

@@ -1,11 +1,25 @@
+import { Readable } from "node:stream";
 import { gzipSync } from "node:zlib";
-const GZIP_THRESHOLD = 256 * 1024;
+import { GZIP_THRESHOLD } from "./compression.js";
+/** Responses whose body `bridge` pipes to the client instead of buffering. */
+const streamedResponses = new WeakSet();
+/**
+ * A response `bridge` sends as a stream: no buffering, no gzip, and no
+ * `content-length`. For large downloads such as an export zip. The route
+ * handler must `return reply` after `bridge`, or Fastify ends the response
+ * before the stream has sent anything.
+ */
+export function streamedResponse(body, init) {
+    const response = new Response(Readable.toWeb(body), init);
+    streamedResponses.add(response);
+    return response;
+}
 /**
  * Converts a Fastify request into a Web API Request, calls the handler,
  * then forwards the Web API Response back through the Fastify reply.
  * Gzip-compresses large responses (>256KB) when client accepts it.
  */
-export async function bridge(req, reply, handler) {
+export async function bridge(req, reply, handler, authenticatedUserIdHeader = "x-user-id") {
     const proto = req.headers["x-forwarded-proto"] ?? "http";
     const host = req.headers.host ?? "localhost";
     const url = new URL(req.url, `${proto}://${host}`);
@@ -19,9 +33,14 @@ export async function bridge(req, reply, handler) {
             headers.set(key, value);
         }
     }
-    // Forward authenticated userId as x-user-id header for route handlers
+    // Strip any client-supplied identity header, then forward only the
+    // server-authenticated userId. x-user-id is meant to be server-set: without
+    // this, a client could inject an identity on auth-exempt/public routes (where
+    // req.userId is unset) and impersonate other users downstream.
+    headers.delete("x-user-id");
+    headers.delete(authenticatedUserIdHeader);
     if (req.userId != null) {
-        headers.set("x-user-id", req.userId);
+        headers.set(authenticatedUserIdHeader, req.userId);
     }
     const method = req.method;
     const hasBody = method !== "GET" && method !== "HEAD";
@@ -48,6 +67,10 @@ export async function bridge(req, reply, handler) {
         reply.send();
         return;
     }
+    if (streamedResponses.has(response)) {
+        reply.send(Readable.fromWeb(response.body));
+        return;
+    }
     const bodyBuffer = Buffer.from(await response.arrayBuffer());
     if (bodyBuffer.byteLength === 0) {
         reply.send();

package/dist/lib/bridge.js.map

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

package/dist/lib/compression.d.ts

@@ -0,0 +1,3 @@
+/** Minimum response size (bytes) before gzip compression is worth applying. */
+export declare const GZIP_THRESHOLD: number;
+//# sourceMappingURL=compression.d.ts.map

package/dist/lib/compression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compression.d.ts","sourceRoot":"","sources":["../../src/lib/compression.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,eAAO,MAAM,cAAc,QAAa,CAAC"}

package/dist/lib/compression.js

@@ -0,0 +1,3 @@
+/** Minimum response size (bytes) before gzip compression is worth applying. */
+export const GZIP_THRESHOLD = 256 * 1024;
+//# sourceMappingURL=compression.js.map

package/dist/lib/compression.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compression.js","sourceRoot":"","sources":["../../src/lib/compression.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,GAAG,IAAI,CAAC"}

package/dist/lib/document-model-interfaces.d.ts

@@ -0,0 +1,30 @@
+/**
+ * The model interfaces a graph uses to reach the documents a director approves:
+ * storyboards and the entity library.
+ *
+ * They live here rather than in `session/model-interfaces.ts` so the CLI's
+ * local (no-server) runs get the same implementations — a `nodetool debug` run
+ * of a graph that recasts a board has to write the same rows the server does,
+ * or the harness proves nothing about the server.
+ */
+import type { ProcessingContextModelInterfaces } from "@nodetool-ai/runtime";
+/** Storyboards, mirroring the script trio: owner-scoped reads, CAS updates. */
+export declare function storyboardModelInterfaces(): Pick<ProcessingContextModelInterfaces, "getStoryboard" | "listStoryboards" | "findRecastStoryboard" | "createStoryboard" | "updateStoryboard">;
+/**
+ * The entity library. An entity is an image asset carrying a marker, so every
+ * read here is an owner-scoped asset read and every write is a metadata write —
+ * the same path the `entities` agent capability takes.
+ */
+export declare function entityModelInterfaces(): Pick<ProcessingContextModelInterfaces, "listEntities" | "getEntity" | "upsertEntity">;
+/** All three groups, for a host installing the whole document surface. */
+/**
+ * Scripts and timeline sequences, owner-scoped with CAS updates.
+ *
+ * These live here rather than beside the server session because the CLI
+ * installs this module: without them `nodetool debug` cannot run a single
+ * `nodetool.script.*` or `nodetool.timeline.*` node, which is most of what the
+ * graph-resource fixtures do.
+ */
+export declare function scriptModelInterfaces(): Pick<ProcessingContextModelInterfaces, "getTimelineSequence" | "createTimelineSequence" | "updateTimelineSequence" | "getScript" | "createScript" | "updateScript">;
+export declare function documentModelInterfaces(): ProcessingContextModelInterfaces;
+//# sourceMappingURL=document-model-interfaces.d.ts.map

package/dist/lib/document-model-interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-model-interfaces.d.ts","sourceRoot":"","sources":["../../src/lib/document-model-interfaces.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAgBH,OAAO,KAAK,EAEV,gCAAgC,EACjC,MAAM,sBAAsB,CAAC;AA2F9B,+EAA+E;AAC/E,wBAAgB,yBAAyB,IAAI,IAAI,CAC/C,gCAAgC,EAC9B,eAAe,GACf,iBAAiB,GACjB,sBAAsB,GACtB,kBAAkB,GAClB,kBAAkB,CACrB,CA+DA;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAC3C,gCAAgC,EAChC,cAAc,GAAG,WAAW,GAAG,cAAc,CAC9C,CA0DA;AAED,0EAA0E;AAC1E;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAC3C,gCAAgC,EAC9B,qBAAqB,GACrB,wBAAwB,GACxB,wBAAwB,GACxB,WAAW,GACX,cAAc,GACd,cAAc,CACjB,CA0EA;AAED,wBAAgB,uBAAuB,IAAI,gCAAgC,CA8B1E"}