videobook-engine 2.0.1 → 5.0.1

package/dist/streams.js

@@ -0,0 +1,183 @@
+import { ok } from "./engine-types.js";
+import { resultOf, syncResultOf, } from "./context.js";
+import { assertUuidV7, newUuidV7 } from "./ids.js";
+import { normalizeRational } from "./mvp-time.js";
+import { canonicalJson, parseJson } from "./store.js";
+import { EngineFault } from "./store.js";
+export function createStreamsApi(context) {
+    return {
+        register: (input) => registerStream(context, input),
+        get: (streamId) => syncResultOf(() => requiredStream(context, streamId)),
+        getAtRevision: (streamId, revision) => syncResultOf(() => requiredStream(context, streamId, revision)),
+        list: (artifact) => syncResultOf(() => listStreams(context, artifact)),
+    };
+}
+async function registerStream(context, input) {
+    return resultOf(async () => {
+        const artifact = context.artifactRow(input.artifactId);
+        const streamId = input.streamId ?? newUuidV7();
+        assertUuidV7(streamId, "Stream ID");
+        const sourcePath = requiredText(input.sourcePath, "Stream source path");
+        const objectHash = requiredText(input.objectHash, "Stream object hash");
+        const timeBase = normalizeRational(input.timeBase);
+        safeIntegerAtLeast(input.streamIndex, 0, "Stream index");
+        safeIntegerAtLeast(input.durationTicks, 1, "Stream duration");
+        const codec = requiredText(input.codec, "Stream codec");
+        validateProfile(input);
+        const file = context.store.db
+            .prepare(`SELECT object_hash FROM artifact_files
+         WHERE artifact_id=? AND path=?`)
+            .get(artifact.artifact_id, sourcePath);
+        if (!file) {
+            throw new EngineFault({
+                code: "NOT_FOUND",
+                message: `Artifact source file not found: ${artifact.artifact_id}/${sourcePath}`,
+            });
+        }
+        if (file.object_hash !== objectHash) {
+            throw new EngineFault({
+                code: "OBJECT_UNAVAILABLE",
+                message: "Stream object hash does not match the artifact file",
+                details: {
+                    artifactId: artifact.artifact_id,
+                    sourcePath,
+                    expectedObjectHash: file.object_hash,
+                    objectHash,
+                },
+            });
+        }
+        const existing = findStreamBySource(context, artifact.artifact_id, sourcePath, objectHash, input.streamIndex);
+        if (existing)
+            return existing;
+        const profile = {
+            ...(input.video ? { video: input.video } : {}),
+            ...(input.audio ? { audio: input.audio } : {}),
+        };
+        const mutation = await context.store.semantic({
+            operation: "register_artifact_stream",
+            tables: ["artifact_streams"],
+            artifactId: artifact.artifact_id,
+            details: {
+                streamId,
+                sourcePath,
+                objectHash,
+                streamIndex: input.streamIndex,
+                kind: input.kind,
+            },
+            writeSet: [
+                `artifact:${artifact.artifact_id}`,
+                `stream:${streamId}`,
+                `object:${objectHash}`,
+            ],
+        }, (_operationId, now) => {
+            context.store.db
+                .prepare(`INSERT INTO artifact_streams(
+              stream_id, artifact_id, source_path, object_hash,
+              stream_index, kind, time_base_numerator,
+              time_base_denominator, duration_ticks, codec,
+              profile_json, created_at
+            ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
+                .run(streamId, artifact.artifact_id, sourcePath, objectHash, input.streamIndex, input.kind, timeBase.numerator, timeBase.denominator, input.durationTicks, codec, canonicalJson(profile), now);
+        });
+        return ok(requiredStream(context, streamId), mutation.revision);
+    });
+}
+function requiredStream(context, streamId, revision) {
+    assertUuidV7(streamId, "Stream ID");
+    const source = revision
+        ? "dolt_at_artifact_streams(?)"
+        : "artifact_streams";
+    const row = context.store.db
+        .prepare(`${STREAM_SELECT} FROM ${source} WHERE stream_id=?`)
+        .get(...(revision ? [revision, streamId] : [streamId]));
+    if (!row) {
+        throw new EngineFault({
+            code: "NOT_FOUND",
+            message: revision
+                ? `Stream not found at revision: ${streamId}`
+                : `Stream not found: ${streamId}`,
+        });
+    }
+    return streamFromRow(row);
+}
+function listStreams(context, artifact) {
+    const artifactId = artifact
+        ? context.artifactRow(artifact).artifact_id
+        : undefined;
+    const rows = artifactId
+        ? context.store.db
+            .prepare(`${STREAM_SELECT} FROM artifact_streams
+           WHERE artifact_id=?
+           ORDER BY source_path, stream_index, stream_id`)
+            .all(artifactId)
+        : context.store.db
+            .prepare(`${STREAM_SELECT} FROM artifact_streams
+           ORDER BY artifact_id, source_path, stream_index, stream_id`)
+            .all();
+    return rows.map(streamFromRow);
+}
+function findStreamBySource(context, artifactId, sourcePath, objectHash, streamIndex) {
+    const row = context.store.db
+        .prepare(`${STREAM_SELECT} FROM artifact_streams
+       WHERE artifact_id=? AND source_path=? AND object_hash=? AND stream_index=?`)
+        .get(artifactId, sourcePath, objectHash, streamIndex);
+    return row ? streamFromRow(row) : null;
+}
+function streamFromRow(row) {
+    const profile = parseJson(row.profile_json, {});
+    return {
+        streamId: row.stream_id,
+        artifactId: row.artifact_id,
+        sourcePath: row.source_path,
+        objectHash: row.object_hash,
+        streamIndex: row.stream_index,
+        kind: row.kind,
+        timeBase: {
+            numerator: row.time_base_numerator,
+            denominator: row.time_base_denominator,
+        },
+        durationTicks: row.duration_ticks,
+        codec: row.codec,
+        ...(profile.video ? { video: profile.video } : {}),
+        ...(profile.audio ? { audio: profile.audio } : {}),
+    };
+}
+function validateProfile(input) {
+    if (input.kind === "video") {
+        if (!input.video || input.audio) {
+            throw new Error("Video streams require only a video profile");
+        }
+        safeIntegerAtLeast(input.video.width, 1, "Video width");
+        safeIntegerAtLeast(input.video.height, 1, "Video height");
+        normalizeRational(input.video.pixelAspect);
+        if (input.video.nominalFrameRate) {
+            normalizeRational(input.video.nominalFrameRate);
+        }
+        if (input.video.averageFrameRate) {
+            normalizeRational(input.video.averageFrameRate);
+        }
+        return;
+    }
+    if (!input.audio || input.video) {
+        throw new Error("Audio streams require only an audio profile");
+    }
+    safeIntegerAtLeast(input.audio.sampleRateHz, 1, "Audio sample rate");
+    safeIntegerAtLeast(input.audio.channels, 1, "Audio channels");
+    requiredText(input.audio.channelLayout, "Audio channel layout");
+}
+function requiredText(value, label) {
+    const normalized = value.trim();
+    if (!normalized)
+        throw new Error(`${label} is required`);
+    return normalized;
+}
+function safeIntegerAtLeast(value, minimum, label) {
+    if (!Number.isSafeInteger(value) || value < minimum) {
+        throw new Error(`${label} must be a safe integer of at least ${minimum}`);
+    }
+}
+const STREAM_SELECT = `
+  SELECT stream_id, artifact_id, source_path, object_hash,
+         stream_index, kind, time_base_numerator, time_base_denominator,
+         duration_ticks, codec, profile_json`;
+//# sourceMappingURL=streams.js.map

package/dist/streams.js.map

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

package/dist/temporal-models.d.ts

@@ -0,0 +1,48 @@
+import type { IndexManifest, TemporalSearchProvider } from "./mvp-contracts.js";
+export declare const LOCAL_CLIP_MODEL_ID = "Xenova/clip-vit-base-patch32";
+export declare const LOCAL_CLIP_MODEL_REVISION = "d15189d7028b43f1d3e65039190477f6af591c2a";
+export declare const LOCAL_CLIP_MANIFEST: IndexManifest;
+export declare const LOCAL_CLAP_MODEL_ID = "Xenova/clap-htsat-unfused";
+export declare const LOCAL_CLAP_MODEL_REVISION = "c28f2883575e590e04d3146ff0713c2448d691ba";
+export declare const LOCAL_CLAP_MANIFEST: IndexManifest;
+export interface LocalClipTemporalProviderOptions {
+    modelCacheDir: string;
+    allowModelDownload?: boolean;
+}
+export interface LocalClapTemporalProviderOptions {
+    modelCacheDir: string;
+    ffmpegPath?: string;
+    allowModelDownload?: boolean;
+}
+export declare class LocalClipTemporalProvider implements TemporalSearchProvider {
+    private readonly options;
+    readonly manifestId: string;
+    readonly embeddingSpace: string;
+    readonly dimensions: number;
+    private imagePipeline;
+    private tokenizer;
+    private textModel;
+    constructor(options: LocalClipTemporalProviderOptions);
+    prepare(): Promise<void>;
+    embedText(text: string): Promise<Float32Array>;
+    embedImage(sourcePath: string): Promise<Float32Array>;
+    private loadImagePipeline;
+    private loadTextModel;
+}
+export declare class LocalClapTemporalProvider implements TemporalSearchProvider {
+    private readonly options;
+    readonly manifestId: string;
+    readonly embeddingSpace: string;
+    readonly dimensions: number;
+    private processor;
+    private audioModel;
+    private tokenizer;
+    private textModel;
+    constructor(options: LocalClapTemporalProviderOptions);
+    prepare(): Promise<void>;
+    embedText(text: string): Promise<Float32Array>;
+    embedAudio(sourcePath: string, startSeconds?: number, durationSeconds?: number): Promise<Float32Array>;
+    private loadAudioModel;
+    private loadTextModel;
+}
+//# sourceMappingURL=temporal-models.d.ts.map

package/dist/temporal-models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal-models.d.ts","sourceRoot":"","sources":["../src/temporal-models.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACV,aAAa,EACb,sBAAsB,EACvB,MAAM,oBAAoB,CAAC;AAG5B,eAAO,MAAM,mBAAmB,iCAAiC,CAAC;AAClE,eAAO,MAAM,yBAAyB,6CACM,CAAC;AAC7C,eAAO,MAAM,mBAAmB,EAAE,aAcjC,CAAC;AAEF,eAAO,MAAM,mBAAmB,8BAA8B,CAAC;AAC/D,eAAO,MAAM,yBAAyB,6CACM,CAAC;AAC7C,eAAO,MAAM,mBAAmB,EAAE,aAcjC,CAAC;AAEF,MAAM,WAAW,gCAAgC;IAC/C,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,gCAAgC;IAC/C,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AA0CD,qBAAa,yBAA0B,YAAW,sBAAsB;IAQ1D,OAAO,CAAC,QAAQ,CAAC,OAAO;IAPpC,QAAQ,CAAC,UAAU,SAAkC;IACrD,QAAQ,CAAC,cAAc,SAAsC;IAC7D,QAAQ,CAAC,UAAU,SAAkC;IACrD,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,SAAS,CAA8B;IAC/C,OAAO,CAAC,SAAS,CAA8B;gBAElB,OAAO,EAAE,gCAAgC;IAEhE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAkB9C,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;YAgB7C,iBAAiB;YAoBjB,aAAa;CA2B5B;AAED,qBAAa,yBAA0B,YAAW,sBAAsB;IAS1D,OAAO,CAAC,QAAQ,CAAC,OAAO;IARpC,QAAQ,CAAC,UAAU,SAAkC;IACrD,QAAQ,CAAC,cAAc,SAAsC;IAC7D,QAAQ,CAAC,UAAU,SAAkC;IACrD,OAAO,CAAC,SAAS,CAA8B;IAC/C,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,SAAS,CAA8B;IAC/C,OAAO,CAAC,SAAS,CAA8B;gBAElB,OAAO,EAAE,gCAAgC;IAEhE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAa9C,UAAU,CACd,UAAU,EAAE,MAAM,EAClB,YAAY,SAAI,EAChB,eAAe,SAAK,GACnB,OAAO,CAAC,YAAY,CAAC;YAgBV,cAAc;YAgCd,aAAa;CA+B5B"}

package/dist/temporal-models.js

@@ -0,0 +1,278 @@
+import { spawn } from "node:child_process";
+import { mkdir } from "node:fs/promises";
+import { AutoProcessor, AutoTokenizer, ClapAudioModelWithProjection, ClapTextModelWithProjection, CLIPTextModelWithProjection, pipeline, RawImage, } from "@huggingface/transformers";
+import sharp from "sharp";
+import { EngineFault } from "./store.js";
+export const LOCAL_CLIP_MODEL_ID = "Xenova/clip-vit-base-patch32";
+export const LOCAL_CLIP_MODEL_REVISION = "d15189d7028b43f1d3e65039190477f6af591c2a";
+export const LOCAL_CLIP_MANIFEST = {
+    manifestId: "videobook-clip-vit-b32-q8-v1",
+    provider: "huggingface-transformers",
+    modelId: LOCAL_CLIP_MODEL_ID,
+    modelRevision: LOCAL_CLIP_MODEL_REVISION,
+    license: "MIT",
+    embeddingSpace: "clip-vit-b32-q8-d15189d7028b43f1d3e65039190477f6af591c2a-v1",
+    dimensions: 512,
+    modalities: ["visual"],
+    supportedLanguages: ["en"],
+    preprocessingVersion: "clip-224-rgb-v1",
+    extractorVersion: "transformers-js-4.2.0",
+    createdAt: 1,
+};
+export const LOCAL_CLAP_MODEL_ID = "Xenova/clap-htsat-unfused";
+export const LOCAL_CLAP_MODEL_REVISION = "c28f2883575e590e04d3146ff0713c2448d691ba";
+export const LOCAL_CLAP_MANIFEST = {
+    manifestId: "videobook-clap-htsat-q8-v1",
+    provider: "huggingface-transformers",
+    modelId: LOCAL_CLAP_MODEL_ID,
+    modelRevision: LOCAL_CLAP_MODEL_REVISION,
+    license: "Apache-2.0",
+    embeddingSpace: "clap-htsat-q8-c28f2883575e590e04d3146ff0713c2448d691ba-v1",
+    dimensions: 512,
+    modalities: ["audio"],
+    supportedLanguages: ["en"],
+    preprocessingVersion: "clap-mono-48khz-10s-v1",
+    extractorVersion: "transformers-js-4.2.0",
+    createdAt: 1,
+};
+export class LocalClipTemporalProvider {
+    options;
+    manifestId = LOCAL_CLIP_MANIFEST.manifestId;
+    embeddingSpace = LOCAL_CLIP_MANIFEST.embeddingSpace;
+    dimensions = LOCAL_CLIP_MANIFEST.dimensions;
+    imagePipeline = null;
+    tokenizer = null;
+    textModel = null;
+    constructor(options) {
+        this.options = options;
+    }
+    async prepare() {
+        await Promise.all([this.loadImagePipeline(), this.loadTextModel()]);
+    }
+    async embedText(text) {
+        const { tokenizer, model } = await this.loadTextModel();
+        const output = await model(tokenizer([text], {
+            padding: true,
+            truncation: true,
+        }));
+        if (output.text_embeds.dims.length !== 2
+            || output.text_embeds.dims[0] !== 1
+            || output.text_embeds.dims[1] !== this.dimensions) {
+            throw new Error(`Unexpected CLIP text embedding shape: ${output.text_embeds.dims.join("x")}`);
+        }
+        return normalized(output.text_embeds.data.slice());
+    }
+    async embedImage(sourcePath) {
+        const embedder = await this.loadImagePipeline();
+        const image = await readNormalizedImage(sourcePath);
+        const output = await embedder(image);
+        if (output.dims.length !== 2
+            || output.dims[0] !== 1
+            || output.dims[1] !== this.dimensions) {
+            throw new Error(`Unexpected CLIP image embedding shape: ${output.dims.join("x")}`);
+        }
+        return normalized(output.data.slice());
+    }
+    async loadImagePipeline() {
+        if (this.imagePipeline)
+            return this.imagePipeline;
+        await mkdir(this.options.modelCacheDir, { recursive: true });
+        try {
+            this.imagePipeline = await pipeline("image-feature-extraction", LOCAL_CLIP_MODEL_ID, {
+                dtype: "q8",
+                cache_dir: this.options.modelCacheDir,
+                local_files_only: this.options.allowModelDownload === false,
+                revision: LOCAL_CLIP_MODEL_REVISION,
+            });
+            return this.imagePipeline;
+        }
+        catch (error) {
+            throw modelFault(error, this.options.allowModelDownload);
+        }
+    }
+    async loadTextModel() {
+        if (this.tokenizer && this.textModel) {
+            return { tokenizer: this.tokenizer, model: this.textModel };
+        }
+        await mkdir(this.options.modelCacheDir, { recursive: true });
+        try {
+            const options = {
+                cache_dir: this.options.modelCacheDir,
+                local_files_only: this.options.allowModelDownload === false,
+                revision: LOCAL_CLIP_MODEL_REVISION,
+            };
+            this.tokenizer = await AutoTokenizer.from_pretrained(LOCAL_CLIP_MODEL_ID, options);
+            this.textModel = await CLIPTextModelWithProjection.from_pretrained(LOCAL_CLIP_MODEL_ID, { ...options, dtype: "q8" });
+            return { tokenizer: this.tokenizer, model: this.textModel };
+        }
+        catch (error) {
+            throw modelFault(error, this.options.allowModelDownload);
+        }
+    }
+}
+export class LocalClapTemporalProvider {
+    options;
+    manifestId = LOCAL_CLAP_MANIFEST.manifestId;
+    embeddingSpace = LOCAL_CLAP_MANIFEST.embeddingSpace;
+    dimensions = LOCAL_CLAP_MANIFEST.dimensions;
+    processor = null;
+    audioModel = null;
+    tokenizer = null;
+    textModel = null;
+    constructor(options) {
+        this.options = options;
+    }
+    async prepare() {
+        await Promise.all([this.loadAudioModel(), this.loadTextModel()]);
+    }
+    async embedText(text) {
+        const { tokenizer, model } = await this.loadTextModel();
+        const output = await model(tokenizer([text], {
+            padding: true,
+            truncation: true,
+        }));
+        return checkedEmbedding(output.text_embeds, this.dimensions, "CLAP text");
+    }
+    async embedAudio(sourcePath, startSeconds = 0, durationSeconds = 10) {
+        const { processor, model } = await this.loadAudioModel();
+        const decoded = await decodeAudio(this.options.ffmpegPath ?? "ffmpeg", sourcePath, startSeconds, durationSeconds);
+        const output = await model(await processor(decoded));
+        return checkedEmbedding(output.audio_embeds, this.dimensions, "CLAP audio");
+    }
+    async loadAudioModel() {
+        if (this.processor && this.audioModel) {
+            return { processor: this.processor, model: this.audioModel };
+        }
+        await mkdir(this.options.modelCacheDir, { recursive: true });
+        try {
+            const options = modelOptions(this.options.modelCacheDir, this.options.allowModelDownload, LOCAL_CLAP_MODEL_REVISION);
+            this.processor = await AutoProcessor.from_pretrained(LOCAL_CLAP_MODEL_ID, options);
+            this.audioModel = await ClapAudioModelWithProjection.from_pretrained(LOCAL_CLAP_MODEL_ID, { ...options, dtype: "q8" });
+            return { processor: this.processor, model: this.audioModel };
+        }
+        catch (error) {
+            throw localModelFault("CLAP audio", error, this.options.allowModelDownload);
+        }
+    }
+    async loadTextModel() {
+        if (this.tokenizer && this.textModel) {
+            return { tokenizer: this.tokenizer, model: this.textModel };
+        }
+        await mkdir(this.options.modelCacheDir, { recursive: true });
+        try {
+            const options = modelOptions(this.options.modelCacheDir, this.options.allowModelDownload, LOCAL_CLAP_MODEL_REVISION);
+            this.tokenizer = await AutoTokenizer.from_pretrained(LOCAL_CLAP_MODEL_ID, options);
+            this.textModel = await ClapTextModelWithProjection.from_pretrained(LOCAL_CLAP_MODEL_ID, { ...options, dtype: "q8" });
+            return { tokenizer: this.tokenizer, model: this.textModel };
+        }
+        catch (error) {
+            throw localModelFault("CLAP text", error, this.options.allowModelDownload);
+        }
+    }
+}
+async function readNormalizedImage(sourcePath) {
+    const decoded = await sharp(sourcePath, { animated: false })
+        .rotate()
+        .toColourspace("srgb")
+        .removeAlpha()
+        .raw()
+        .toBuffer({ resolveWithObject: true });
+    if (decoded.info.width <= 0
+        || decoded.info.height <= 0
+        || decoded.info.channels !== 3) {
+        throw new Error(`Unable to normalize image for CLIP: ${sourcePath}`);
+    }
+    return new RawImage(decoded.data, decoded.info.width, decoded.info.height, 3);
+}
+function normalized(vector) {
+    const magnitude = Math.sqrt(vector.reduce((sum, value) => sum + value * value, 0));
+    if (!Number.isFinite(magnitude) || magnitude <= 0) {
+        throw new Error("CLIP returned a zero or invalid embedding");
+    }
+    return Float32Array.from(vector, (value) => value / magnitude);
+}
+function checkedEmbedding(output, dimensions, label) {
+    if (output.dims.length !== 2
+        || output.dims[0] !== 1
+        || output.dims[1] !== dimensions) {
+        throw new Error(`Unexpected ${label} embedding shape: ${output.dims.join("x")}`);
+    }
+    return normalized(output.data.slice());
+}
+function modelOptions(cacheDir, allowModelDownload, revision) {
+    return {
+        cache_dir: cacheDir,
+        local_files_only: allowModelDownload === false,
+        revision,
+    };
+}
+function decodeAudio(ffmpegPath, sourcePath, startSeconds, durationSeconds) {
+    if (!Number.isFinite(startSeconds)
+        || startSeconds < 0
+        || !Number.isFinite(durationSeconds)
+        || durationSeconds <= 0) {
+        throw new Error("CLAP audio range must have a non-negative start and positive duration");
+    }
+    return new Promise((resolve, reject) => {
+        const child = spawn(ffmpegPath, [
+            "-hide_banner",
+            "-loglevel",
+            "error",
+            "-nostdin",
+            "-ss",
+            String(startSeconds),
+            "-i",
+            sourcePath,
+            "-map",
+            "0:a:0",
+            "-vn",
+            "-ac",
+            "1",
+            "-ar",
+            "48000",
+            "-t",
+            String(Math.min(durationSeconds, 10)),
+            "-f",
+            "f32le",
+            "-acodec",
+            "pcm_f32le",
+            "pipe:1",
+        ], { stdio: ["ignore", "pipe", "pipe"] });
+        const stdout = [];
+        const stderr = [];
+        child.stdout.on("data", (chunk) => stdout.push(chunk));
+        child.stderr.on("data", (chunk) => stderr.push(chunk));
+        child.once("error", (error) => reject(localModelFault("CLAP audio decoder", error, true)));
+        child.once("close", (code) => {
+            if (code !== 0) {
+                reject(new EngineFault({
+                    code: "INVALID_INPUT",
+                    message: `Unable to decode audio for CLAP: ${Buffer.concat(stderr).toString("utf8").trim()}`,
+                }));
+                return;
+            }
+            const buffer = Buffer.concat(stdout);
+            if (buffer.byteLength === 0
+                || buffer.byteLength % Float32Array.BYTES_PER_ELEMENT !== 0) {
+                reject(new Error("CLAP audio decoder returned invalid PCM"));
+                return;
+            }
+            const bytes = new Uint8Array(buffer.byteLength);
+            bytes.set(buffer);
+            resolve(new Float32Array(bytes.buffer));
+        });
+    });
+}
+function modelFault(error, allowModelDownload) {
+    return new EngineFault({
+        code: allowModelDownload === false ? "OFFLINE" : "FEATURE_UNAVAILABLE",
+        message: `Unable to load the pinned local CLIP model: ${error instanceof Error ? error.message : String(error)}`,
+    });
+}
+function localModelFault(label, error, allowModelDownload) {
+    return new EngineFault({
+        code: allowModelDownload === false ? "OFFLINE" : "FEATURE_UNAVAILABLE",
+        message: `Unable to load the pinned local ${label} model: ${error instanceof Error ? error.message : String(error)}`,
+    });
+}
+//# sourceMappingURL=temporal-models.js.map

package/dist/temporal-models.js.map

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

package/dist/temporal-search.d.ts

@@ -0,0 +1,29 @@
+import type { EngineError, Result } from "./engine-types.js";
+import type { CommitTemporalIndexBatchInput, IndexBatchResult, IndexManifest, PreparedSearchOptions, PreparedSearchReference, SearchCoverage, SearchPage, SearchQuery, TemporalIndexPlan, TemporalSearchProvider, TemporalSearchStats } from "./mvp-contracts.js";
+import { EngineContext } from "./context.js";
+export declare function createTemporalSearchApi(context: EngineContext): {
+    providers: {
+        register: (provider: TemporalSearchProvider) => void;
+        list: () => string[];
+    };
+    manifests: {
+        register: (manifest: IndexManifest) => Result<IndexManifest, EngineError>;
+        list: () => IndexManifest[];
+        get: (manifestId: string) => Result<IndexManifest, EngineError>;
+    };
+    plan: (artifact: string, objectHash: string, manifestId: string, generation: string) => Result<TemporalIndexPlan, EngineError>;
+    commitBatch: (input: CommitTemporalIndexBatchInput) => Result<IndexBatchResult, EngineError>;
+    activate: (manifestId: string, generation: string) => Result<{
+        manifestId: string;
+        generation: string;
+    }, EngineError>;
+    coverage: (artifact?: string) => Result<SearchCoverage, EngineError>;
+    query: (query: SearchQuery) => Promise<Result<SearchPage, EngineError>>;
+    queryPrepared: (query: SearchQuery, reference: PreparedSearchReference, options?: PreparedSearchOptions) => Promise<Result<SearchPage, EngineError>>;
+    invalidate: (artifact: string, objectHash?: string) => Result<number, EngineError>;
+    cleanup: () => Result<{
+        removedSegments: number;
+    }, EngineError>;
+    stats: () => TemporalSearchStats;
+};
+//# sourceMappingURL=temporal-search.d.ts.map

package/dist/temporal-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal-search.d.ts","sourceRoot":"","sources":["../src/temporal-search.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAgB,WAAW,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,KAAK,EACV,6BAA6B,EAC7B,gBAAgB,EAEhB,aAAa,EAGb,qBAAqB,EACrB,uBAAuB,EACvB,cAAc,EAGd,UAAU,EACV,WAAW,EAIX,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAQ5B,OAAO,EAAE,aAAa,EAA0B,MAAM,cAAc,CAAC;AA2HrE,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,aAAa;;6BAInC,sBAAsB,KAAG,IAAI;oBAIxC,MAAM,EAAE;;;6BAGG,aAAa,KAAG,MAAM,CAAC,aAAa,EAAE,WAAW,CAAC;oBAE7D,aAAa,EAAE;0BACP,MAAM,KAAG,MAAM,CAAC,aAAa,EAAE,WAAW,CAAC;;qBAInD,MAAM,cACJ,MAAM,cACN,MAAM,cACN,MAAM,KACjB,MAAM,CAAC,iBAAiB,EAAE,WAAW,CAAC;yBAKhC,6BAA6B,KACnC,MAAM,CAAC,gBAAgB,EAAE,WAAW,CAAC;2BAG1B,MAAM,cACN,MAAM,KACjB,MAAM,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EAAE,WAAW,CAAC;0BAE5C,MAAM,KAAG,MAAM,CAAC,cAAc,EAAE,WAAW,CAAC;mBAGzD,WAAW,KACjB,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;2BAGlC,WAAW,aACP,uBAAuB,YACzB,qBAAqB,KAC7B,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;2BAG/B,MAAM,eACH,MAAM,KAClB,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC;mBAEjB,MAAM,CAAC;QAAE,eAAe,EAAE,MAAM,CAAA;KAAE,EAAE,WAAW,CAAC;iBAElD,mBAAmB;EAEjC"}