@nodetool-ai/runtime 0.8.7 → 0.8.9-beta.1

package/dist/media/transform.js

@@ -0,0 +1,371 @@
+/**
+ * One output file from filtered or copied input streams: the in-process form
+ * of the ffmpeg CLI invocations the video nodes ran, `-vf`, `-af`,
+ * `-filter_complex` with `-map`, `-c copy` and `-shortest`. The graph strings
+ * are the CLI's, unchanged.
+ */
+import { AV_NOPTS_VALUE, AVSEEK_FLAG_BACKWARD, Demuxer, Encoder, Rational } from "node-av";
+import { AudioEncoder } from "./audio-encoder.js";
+import { abortError, findEncoder, openFileMuxer, quietLibav, startTimeSeconds, throwIfAborted } from "./av.js";
+import { openFilterComplex, openFilterGraph } from "./filter-graph.js";
+/** The CLI's defaults for an `.mp4` output: H.264 in yuv420p. */
+export const DEFAULT_VIDEO_ENCODER = {
+    codec: "libx264",
+    pixelFormat: "yuv420p"
+};
+function seconds(ts, timeBase) {
+    return (Number(ts) * timeBase.num) / timeBase.den;
+}
+function packetSeconds(packet) {
+    const ts = packet.dts !== AV_NOPTS_VALUE ? packet.dts : packet.pts;
+    if (ts === AV_NOPTS_VALUE || !(packet.timeBase.den > 0))
+        return Number.NEGATIVE_INFINITY;
+    return seconds(ts, packet.timeBase);
+}
+function packetEndSeconds(packet) {
+    if (packet.pts === AV_NOPTS_VALUE || !(packet.timeBase.den > 0))
+        return Number.NEGATIVE_INFINITY;
+    return seconds(packet.pts + packet.duration, packet.timeBase);
+}
+/** The `[N:v]` and `[N:a]` labels a graph reads, in order of appearance. */
+function graphInputs(graph, inputs) {
+    const seen = new Set();
+    const found = [];
+    for (const match of graph.matchAll(/\[(\d+):([va])\]/g)) {
+        const label = `${match[1]}:${match[2]}`;
+        if (seen.has(label))
+            continue;
+        seen.add(label);
+        const input = inputs[Number(match[1])];
+        if (!input)
+            throw new Error(`The graph reads [${label}] but there is no input ${match[1]}`);
+        if (input.seekSec || input.toSec !== undefined) {
+            throw new Error(`Input ${match[1]} is seeked; a filter_complex input cannot be`);
+        }
+        found.push({ filePath: input.filePath, kind: match[2] === "v" ? "video" : "audio", label });
+    }
+    return found;
+}
+/** Open the filtered frames a plan names, or `null` for a missing optional stream. */
+async function openPlanFrames(plan, kind, inputs, tail, signal) {
+    if ("graph" in plan) {
+        const output = tail ? "__transform_out" : plan.output;
+        return openFilterComplex({
+            inputs: graphInputs(plan.graph, inputs),
+            graph: tail ? `${plan.graph};[${plan.output}]${tail}[${output}]` : plan.graph,
+            output,
+            outputKind: kind,
+            signal
+        });
+    }
+    const index = plan.input ?? 0;
+    const input = inputs[index];
+    if (!input)
+        throw new Error(`There is no input ${index}`);
+    const seekSec = input.seekSec && input.seekSec > 0 ? input.seekSec : 0;
+    const prefix = kind === "audio" ? "a" : "";
+    // Frames decoded from the keyframe before the seek point sit before zero; the
+    // CLI dropped them, and `-to` ends the read at a source time.
+    const trims = [
+        seekSec > 0 ? `${prefix}trim=start=0` : null,
+        input.toSec !== undefined && input.toSec > seekSec ? `${prefix}trim=end=${input.toSec - seekSec}` : null
+    ];
+    const run = await openFilterGraph({
+        filePath: input.filePath,
+        kind,
+        filter: [...trims, plan.filter, tail].filter((step) => step).join(",") || (kind === "audio" ? "anull" : "null"),
+        seekSec,
+        signal
+    });
+    if (!run && !plan.optional)
+        throw new Error(`${input.filePath} has no ${kind} stream`);
+    return run;
+}
+/** Packets of an input stream, copied, rebased to start near zero. */
+async function openCopySource(output, input, kind, optional, startSec, signal) {
+    const demuxer = await Demuxer.open(input.filePath, { signal });
+    try {
+        const stream = kind === "video" ? demuxer.video() : demuxer.audio();
+        if (!stream) {
+            await demuxer.close();
+            if (optional)
+                return null;
+            throw new Error(`${input.filePath} has no ${kind} stream`);
+        }
+        const formatStart = startTimeSeconds(demuxer.getFormatContext().startTime, { num: 1, den: 1_000_000 });
+        const seekSec = input.seekSec && input.seekSec > 0 ? input.seekSec : 0;
+        if (seekSec > 0)
+            await demuxer.seek(formatStart + seekSec, -1, AVSEEK_FLAG_BACKWARD);
+        const index = output.muxer.addStream(stream);
+        // Matroska and WebM name a codec by its id. A tag copied from MP4
+        // (`mp4a`) fails their header, so drop it, as the CLI drops a tag the
+        // output format does not take.
+        if (/^(matroska|webm)/.test(output.muxer.getFormatContext().oformat?.name ?? "")) {
+            const copied = output.muxer.getStream(index);
+            if (copied)
+                copied.codecpar.codecTag = 0;
+        }
+        const timeBase = stream.timeBase;
+        const packets = demuxer.packets(stream.index);
+        const endSec = input.toSec;
+        let offsetTicks = null;
+        let closed = false;
+        return {
+            index,
+            async next() {
+                for (;;) {
+                    if (closed)
+                        return null;
+                    const { value, done } = await packets.next();
+                    if (done)
+                        return null;
+                    if (!value)
+                        continue;
+                    if (signal?.aborted) {
+                        value.free();
+                        throw abortError(signal);
+                    }
+                    const ts = value.pts !== AV_NOPTS_VALUE ? value.pts : value.dts;
+                    const sourceSec = ts === AV_NOPTS_VALUE ? 0 : seconds(ts, timeBase) - formatStart;
+                    if (endSec !== undefined && sourceSec >= endSec) {
+                        value.free();
+                        return null;
+                    }
+                    if (offsetTicks === null) {
+                        // A copy cannot cut between keyframes: the output starts at the
+                        // keyframe the seek landed on, which the first copied stream
+                        // fixes for every stream of the file.
+                        startSec.value ??= seekSec > 0 ? sourceSec : 0;
+                        offsetTicks = BigInt(Math.round(((formatStart + startSec.value) * timeBase.den) / timeBase.num));
+                    }
+                    if (seekSec > 0 && sourceSec < startSec.value) {
+                        value.free();
+                        continue;
+                    }
+                    if (value.pts !== AV_NOPTS_VALUE)
+                        value.pts -= offsetTicks;
+                    if (value.dts !== AV_NOPTS_VALUE)
+                        value.dts -= offsetTicks;
+                    return value;
+                }
+            },
+            async close() {
+                if (closed)
+                    return;
+                closed = true;
+                await packets.return(undefined);
+                await demuxer.close();
+            }
+        };
+    }
+    catch (error) {
+        await demuxer.close();
+        throw error;
+    }
+}
+/** Packets of filtered video frames, encoded at the graph's output rate. */
+async function openVideoEncodeSource(output, run, spec, signal) {
+    const codec = findEncoder(spec.codec);
+    if (!codec)
+        throw new Error(`This libav build has no ${spec.codec} encoder`);
+    const frames = run.frames();
+    const first = await frames.next();
+    if (first.done) {
+        await run.close();
+        return null;
+    }
+    const head = first.value;
+    // x264 sizes its rate control by the frame rate; without one it reads the
+    // time base as the rate, and a flat picture drifts several levels.
+    const rate = run.frameRate();
+    let encoder;
+    try {
+        encoder = await Encoder.create(codec, {
+            options: spec.options,
+            context: rate ? { framerate: new Rational(rate.num, rate.den) } : undefined,
+            signal
+        });
+    }
+    catch (error) {
+        head.free();
+        await run.close();
+        throw error;
+    }
+    const index = output.muxer.addStream(encoder);
+    return packetSourceFrom(index, replayRun(run, head, frames), (frame) => encoder.encodeAll(frame), () => encoder.encodeAll(null), () => encoder.close(), signal);
+}
+/** `run` with `head`, already pulled from `frames`, put back in front. */
+function replayRun(run, head, frames) {
+    async function* replay() {
+        yield head;
+        yield* frames;
+    }
+    return { frames: replay, frameRate: () => run.frameRate(), close: () => run.close() };
+}
+/** Packets of filtered audio frames, encoded at the first frame's rate and channel count. */
+async function openAudioEncodeSource(output, run, codecName, signal) {
+    const frames = run.frames();
+    const first = await frames.next();
+    if (first.done) {
+        await run.close();
+        return null;
+    }
+    const head = first.value;
+    let encoder;
+    try {
+        encoder = await AudioEncoder.create(codecName, {
+            sampleRate: head.sampleRate,
+            channels: head.channels,
+            signal
+        });
+    }
+    catch (error) {
+        head.free();
+        await run.close();
+        throw error;
+    }
+    const index = output.muxer.addStream(encoder.encoder);
+    return packetSourceFrom(index, replayRun(run, head, frames), (frame) => encoder.encode(frame), () => encoder.flush(), () => encoder.close(), signal);
+}
+function packetSourceFrom(index, run, encode, flush, release, signal) {
+    const frames = run.frames();
+    const queue = [];
+    let ended = false;
+    let closed = false;
+    return {
+        index,
+        async next() {
+            while (queue.length === 0 && !ended) {
+                const { value, done } = await frames.next();
+                if (done) {
+                    ended = true;
+                    queue.push(...(await flush()));
+                    break;
+                }
+                try {
+                    if (signal?.aborted)
+                        throw abortError(signal);
+                    queue.push(...(await encode(value)));
+                }
+                finally {
+                    value.free();
+                }
+            }
+            return queue.shift() ?? null;
+        },
+        async close() {
+            if (closed)
+                return;
+            closed = true;
+            for (const packet of queue.splice(0))
+                packet.free();
+            await run.close();
+            release();
+        }
+    };
+}
+/**
+ * Write `outPath` from `inputs`. `video` and `audio` name where each output
+ * stream comes from, or `null` for none. Filtered streams are encoded with
+ * `videoEncoder` (H.264 yuv420p by default) and `audioCodec` (AAC by default,
+ * at the filtered rate and channel count). `shortest` ends the file when its
+ * first stream ends, as `-shortest` did.
+ */
+export async function transformMedia(opts) {
+    const { signal, inputs } = opts;
+    quietLibav();
+    throwIfAborted(signal);
+    if (!opts.video && !opts.audio)
+        throw new Error("The output has no stream");
+    const videoSpec = opts.videoEncoder ?? DEFAULT_VIDEO_ENCODER;
+    const output = await openFileMuxer(opts.outPath, {
+        format: opts.format,
+        muxerOptions: opts.muxerOptions,
+        signal
+    });
+    const sources = [];
+    const copyStart = { value: null };
+    try {
+        for (const [kind, plan] of [
+            ["video", opts.video],
+            ["audio", opts.audio]
+        ]) {
+            if (!plan)
+                continue;
+            if ("copy" in plan) {
+                const input = inputs[plan.copy];
+                if (!input)
+                    throw new Error(`There is no input ${plan.copy}`);
+                const source = await openCopySource(output, input, kind, plan.optional ?? false, copyStart, signal);
+                if (source)
+                    sources.push(source);
+                continue;
+            }
+            const tail = kind === "video"
+                ? [videoSpec.filter, `format=${videoSpec.pixelFormat}`].filter(Boolean).join(",")
+                : "";
+            const run = await openPlanFrames(plan, kind, inputs, tail, signal);
+            if (!run)
+                continue;
+            const source = kind === "video"
+                ? await openVideoEncodeSource(output, run, videoSpec, signal)
+                : await openAudioEncodeSource(output, run, opts.audioCodec ?? "aac", signal);
+            if (source)
+                sources.push(source);
+        }
+        if (sources.length === 0)
+            throw new Error("No input stream reached the output");
+        await interleave(output, sources, opts.shortest ?? false, signal);
+        await output.close();
+    }
+    finally {
+        for (const source of sources)
+            await source.close();
+        await output.close();
+    }
+}
+/**
+ * Write every source's packets in time order. With `shortest`, the first
+ * source to end sets the end of the file: later packets of the others are
+ * dropped, which also stops an endless one (an `apad`).
+ */
+async function interleave(output, sources, shortest, signal) {
+    // One at a time: the first copied stream fixes where every copy starts.
+    const heads = [];
+    for (const source of sources) {
+        heads.push({ source, packet: await source.next(), end: Number.NEGATIVE_INFINITY });
+    }
+    let endSec = Number.POSITIVE_INFINITY;
+    let written = 0;
+    for (;;) {
+        if (signal?.aborted)
+            throw abortError(signal);
+        let earliest = null;
+        for (const head of heads) {
+            if (!head.packet)
+                continue;
+            if (!earliest || packetSeconds(head.packet) < packetSeconds(earliest.packet))
+                earliest = head;
+        }
+        if (!earliest)
+            break;
+        const packet = earliest.packet;
+        if (packetSeconds(packet) >= endSec) {
+            // Past the end the shortest stream set: this source is done.
+            packet.free();
+            earliest.packet = null;
+            await earliest.source.close();
+            continue;
+        }
+        earliest.end = Math.max(earliest.end, packetEndSeconds(packet));
+        await output.muxer.writePacket(packet, earliest.source.index);
+        packet.free();
+        written += 1;
+        earliest.packet = await earliest.source.next();
+        if (!earliest.packet && shortest)
+            endSec = Math.min(endSec, earliest.end);
+    }
+    if (written === 0)
+        throw new Error("The inputs produced no packets");
+}
+//# sourceMappingURL=transform.js.map

package/dist/media/transform.js.map

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

package/dist/media/verify.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Decode a whole stream with libav's strict error detection and keep nothing:
+ * the in-process form of `ffmpeg -xerror -err_detect explode -i in -f null -`.
+ */
+import type { MediaKind } from "./decode.js";
+/**
+ * Decode every frame of `bytes`' first `kind` stream. `format` names the
+ * demuxer (`wav`, `ogg`, `mp3`, `png_pipe`, `jpeg_pipe`, `webp_pipe`) instead
+ * of probing for it. Throws when the stream is missing, any packet fails to
+ * decode, or the stream decodes to nothing.
+ */
+export declare function verifyDecodes(bytes: Uint8Array, opts: {
+    kind: MediaKind;
+    format?: string;
+    signal?: AbortSignal;
+}): Promise<void>;
+//# sourceMappingURL=verify.d.ts.map

package/dist/media/verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../src/media/verify.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,GAC/D,OAAO,CAAC,IAAI,CAAC,CA6Cf"}

package/dist/media/verify.js

@@ -0,0 +1,65 @@
+/**
+ * Decode a whole stream with libav's strict error detection and keep nothing:
+ * the in-process form of `ffmpeg -xerror -err_detect explode -i in -f null -`.
+ */
+import { AV_PKT_FLAG_CORRUPT, Decoder, Demuxer } from "node-av";
+import { abortError, quietLibav, throwIfAborted } from "./av.js";
+/**
+ * Decode every frame of `bytes`' first `kind` stream. `format` names the
+ * demuxer (`wav`, `ogg`, `mp3`, `png_pipe`, `jpeg_pipe`, `webp_pipe`) instead
+ * of probing for it. Throws when the stream is missing, any packet fails to
+ * decode, or the stream decodes to nothing.
+ */
+export async function verifyDecodes(bytes, opts) {
+    const { signal } = opts;
+    quietLibav();
+    throwIfAborted(signal);
+    const demuxer = await Demuxer.open(Buffer.from(bytes.buffer, bytes.byteOffset, bytes.byteLength), {
+        format: opts.format,
+        // SAFETY: `err_detect` is a generic AVFormatContext option, which every
+        // demuxer takes; the per-format option types list only private ones.
+        options: { err_detect: "explode" },
+        signal
+    });
+    let decoder = null;
+    try {
+        const stream = opts.kind === "audio" ? demuxer.audio() : demuxer.video();
+        if (!stream)
+            throw new Error(`The file has no ${opts.kind} stream`);
+        // SAFETY: `err_detect` is a generic AVCodecContext option, which every
+        // decoder takes; the per-codec option types list only private ones.
+        const options = { err_detect: "explode" };
+        decoder = await Decoder.create(stream, { exitOnError: true, options, signal });
+        let decoded = 0;
+        const index = stream.index;
+        // A short read marks the packet corrupt; the CLI's `-xerror` failed on it.
+        async function* checked() {
+            for await (const packet of demuxer.packets(index)) {
+                if (packet && (packet.flags & AV_PKT_FLAG_CORRUPT) !== 0) {
+                    packet.free();
+                    throw new Error("A packet is corrupt or cut short");
+                }
+                yield packet;
+            }
+        }
+        for await (const frame of decoder.frames(checked())) {
+            if (!frame)
+                continue;
+            try {
+                if (signal?.aborted)
+                    throw abortError(signal);
+                decoded += opts.kind === "audio" ? frame.nbSamples : frame.width * frame.height;
+            }
+            finally {
+                frame.free();
+            }
+        }
+        if (decoded === 0)
+            throw new Error(`The ${opts.kind} stream decoded to nothing`);
+    }
+    finally {
+        decoder?.close();
+        await demuxer.close();
+    }
+}
+//# sourceMappingURL=verify.js.map

package/dist/media/verify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.js","sourceRoot":"","sources":["../../src/media/verify.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAE,OAAO,EAAe,MAAM,SAAS,CAAC;AAE7E,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAGjE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAAiB,EACjB,IAAgE;IAEhE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,CAAC;IACb,cAAc,CAAC,MAAM,CAAC,CAAC;IACvB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE;QAChG,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,wEAAwE;QACxE,qEAAqE;QACrE,OAAO,EAAE,EAAE,UAAU,EAAE,SAAS,EAA4B;QAC5D,MAAM;KACP,CAAC,CAAC;IACH,IAAI,OAAO,GAAmB,IAAI,CAAC;IACnC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACzE,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,CAAC,IAAI,SAAS,CAAC,CAAC;QACpE,uEAAuE;QACvE,oEAAoE;QACpE,MAAM,OAAO,GAAG,EAAE,UAAU,EAAE,SAAS,EAA4B,CAAC;QACpE,OAAO,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QAC/E,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC3B,2EAA2E;QAC3E,KAAK,SAAS,CAAC,CAAC,OAAO;YACrB,IAAI,KAAK,EAAE,MAAM,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBAClD,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;oBACzD,MAAM,CAAC,IAAI,EAAE,CAAC;oBACd,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;gBACtD,CAAC;gBACD,MAAM,MAAM,CAAC;YACf,CAAC;QACH,CAAC;QACD,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;YACpD,IAAI,CAAC,KAAK;gBAAE,SAAS;YACrB,IAAI,CAAC;gBACH,IAAI,MAAM,EAAE,OAAO;oBAAE,MAAM,UAAU,CAAC,MAAM,CAAC,CAAC;gBAC9C,OAAO,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC;YAClF,CAAC;oBAAS,CAAC;gBACT,KAAK,CAAC,IAAI,EAAE,CAAC;YACf,CAAC;QACH,CAAC;QACD,IAAI,OAAO,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,CAAC,IAAI,4BAA4B,CAAC,CAAC;IACnF,CAAC;YAAS,CAAC;QACT,OAAO,EAAE,KAAK,EAAE,CAAC;QACjB,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;AACH,CAAC"}

package/dist/media-loader.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The media module, loaded on demand. It loads node-av's native addon, which
+ * no browser, edge or Turbopack bundle can place, so those bundlers are told
+ * to leave the import alone. esbuild ignores the hint and inlines it, which is
+ * what the packaged backend needs.
+ */
+export declare function loadMediaModule(): Promise<typeof import("./media/index.js")>;
+//# sourceMappingURL=media-loader.d.ts.map

package/dist/media-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-loader.d.ts","sourceRoot":"","sources":["../src/media-loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAAC,cAAc,kBAAkB,CAAC,CAAC,CAE5E"}

package/dist/media-loader.js

@@ -0,0 +1,10 @@
+/**
+ * The media module, loaded on demand. It loads node-av's native addon, which
+ * no browser, edge or Turbopack bundle can place, so those bundlers are told
+ * to leave the import alone. esbuild ignores the hint and inlines it, which is
+ * what the packaged backend needs.
+ */
+export function loadMediaModule() {
+    return import(/* webpackIgnore: true */ /* turbopackIgnore: true */ "./media/index.js");
+}
+//# sourceMappingURL=media-loader.js.map

package/dist/media-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-loader.js","sourceRoot":"","sources":["../src/media-loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,MAAM,CAAC,yBAAyB,CAAC,2BAA2B,CAAC,kBAAkB,CAAC,CAAC;AAC1F,CAAC"}

package/dist/prefixed-storage-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prefixed-storage-adapter.d.ts","sourceRoot":"","sources":["../src/prefixed-storage-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EACjB,MAAM,cAAc,CAAC;AAEtB;;;;;;;;;;;GAWG;AACH,qBAAa,sBAAuB,YAAW,cAAc;IAKzD,OAAO,CAAC,QAAQ,CAAC,KAAK;IAJxB,gDAAgD;IAChD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,YACmB,KAAK,EAAE,cAAc,EACtC,MAAM,EAAE,MAAM,EAGf;IAED,OAAO,CAAC,KAAK;IAIb,8DAA8D;IAC9D,OAAO,CAAC,OAAO;IAKf,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE1E;IAED,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAEhD;IAED,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEpC;IAED,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7B;IAEK,IAAI,CACR,MAAM,EAAE,MAAM,EACd,IAAI,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GAChC,OAAO,CAAC,iBAAiB,CAAC,CAe5B;IAED,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEpC;IAEK,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAKnD;IAED,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAE7C;CACF"}
+{"version":3,"file":"prefixed-storage-adapter.d.ts","sourceRoot":"","sources":["../src/prefixed-storage-adapter.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EACjB,MAAM,cAAc,CAAC;AAEtB;;;;;;;;;;;GAWG;AACH,qBAAa,sBAAuB,YAAW,cAAc;IAKzD,OAAO,CAAC,QAAQ,CAAC,KAAK;IAJxB,gDAAgD;IAChD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,YACmB,KAAK,EAAE,cAAc,EACtC,MAAM,EAAE,MAAM,EAGf;IAED,OAAO,CAAC,KAAK;IAIb,8DAA8D;IAC9D,OAAO,CAAC,OAAO;IAKf,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE1E;IAED,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAEhD;IAED,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEpC;IAED,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7B;IAEK,IAAI,CACR,MAAM,EAAE,MAAM,EACd,IAAI,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GAChC,OAAO,CAAC,iBAAiB,CAAC,CAe5B;IAED,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEpC;IAEK,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAKnD;IAED,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAE7C;CACF"}

package/dist/prefixed-storage-adapter.js

@@ -1,4 +1,4 @@
-import { normalizeStorageKey } from "./context.js";
+import { normalizeStorageKey } from "@nodetool-ai/storage/storage-keys";
 /**
  * A `StorageAdapter` that carves a key prefix out of another one.
  *

package/dist/prefixed-storage-adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"prefixed-storage-adapter.js","sourceRoot":"","sources":["../src/prefixed-storage-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EAIpB,MAAM,cAAc,CAAC;AAEtB;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,sBAAsB;IAKd,KAAK;IAJxB,gDAAgD;IACvC,MAAM,CAAS;IAExB,YACmB,KAAqB,EACtC,MAAc;qBADG,KAAK;QAGtB,IAAI,CAAC,MAAM,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5C,CAAC;IAEO,KAAK,CAAC,GAAW;QACvB,OAAO,GAAG,IAAI,CAAC,MAAM,IAAI,mBAAmB,CAAC,GAAG,CAAC,EAAE,CAAC;IACtD,CAAC;IAED,8DAA8D;IACtD,OAAO,CAAC,GAAW;QACzB,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC;QAC/B,OAAO,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,GAAW,EAAE,IAAgB,EAAE,WAAoB;QACvD,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;IAC9D,CAAC;IAED,QAAQ,CAAC,GAAW;QAClB,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,CAAC,GAAW;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,SAAS,CAAC,GAAW;QACnB,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,IAAI,CACR,MAAc,EACd,IAAI,GAA2B,EAAE;QAEjC,oEAAoE;QACpE,oDAAoD;QACpD,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;QACzD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACnD,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC;QAC/B,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;gBACxC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBACpC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACxC,CAAC,CAAC;YACF,cAAc,EAAE,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAClD,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CACjD;SACF,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,GAAW;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAW;QACpB,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QACrB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;QACjC,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACnC,CAAC;IAED,SAAS,CAAC,GAAW;QACnB,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;CACF"}
+{"version":3,"file":"prefixed-storage-adapter.js","sourceRoot":"","sources":["../src/prefixed-storage-adapter.ts"],"names":[],"mappings":"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"}

package/dist/providers/anthropic-provider.d.ts

@@ -6,10 +6,21 @@ interface AnthropicProviderOptions {
     clientFactory?: (apiKey: string) => Anthropic;
     fetchFn?: typeof fetch;
     clientOptions?: Pick<ClientOptions, "authToken" | "credentials" | "config" | "profile" | "baseURL">;
+    /**
+     * Top-level automatic caching marker. When set it caches the conversation
+     * tail in place of the explicit tail breakpoint, and its TTL is reused for
+     * the system breakpoint.
+     */
     cacheControl?: {
         type: "ephemeral";
         ttl?: "5m" | "1h";
     };
+    /**
+     * Place prompt-cache breakpoints on the system prompt and the conversation
+     * tail. On by default; pass `false` for a gateway that rejects
+     * `cache_control`.
+     */
+    promptCaching?: boolean;
     betas?: string[];
     /**
      * Provider id reported by this instance. Defaults to `"anthropic"`.
@@ -36,6 +47,7 @@ export declare class AnthropicProvider extends BaseProvider {
     private _fetch;
     private _clientOptions;
     private _cacheControl;
+    private _promptCaching;
     private _betas;
     constructor(secrets: {
         ANTHROPIC_API_KEY?: string;
@@ -65,6 +77,15 @@ export declare class AnthropicProvider extends BaseProvider {
     formatTools(tools: ProviderTool[]): Array<Record<string, unknown>>;
     private extractSystemMessage;
     private buildRequest;
+    /**
+     * Mark the request so consecutive calls reuse the provider's KV cache. The
+     * prefix renders as tools, then system, then messages, so one breakpoint at
+     * the end of the system prompt caches the tool catalog and the prompt, and
+     * one on the last message block caches the conversation so far. A tool loop
+     * resends that whole prefix every round, which then bills as cache reads.
+     * Breakpoints the caller set on tools count against the four allowed.
+     */
+    private applyCacheBreakpoints;
     generateMessages(args: {
         messages: Message[];
         model: string;

package/dist/providers/anthropic-provider.d.ts.map

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