gooseworks 0.5.0-dev.9.d3e7757f → 0.5.0

package/dist/kit/core/files.js

@@ -0,0 +1,213 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mimeOf = mimeOf;
+exports.mediaOfMime = mediaOfMime;
+exports.hashFile = hashFile;
+exports.fileRef = fileRef;
+exports.intact = intact;
+exports.isFrozenFile = isFrozenFile;
+exports.isLineFile = isLineFile;
+exports.materialize = materialize;
+// Files as the core moves them: FileRefs (path, sha256, bytes, media, mime,
+// and the probe's numbers), and the plan's frozen files downloaded and checked.
+const crypto_1 = require("crypto");
+const fs_1 = require("fs");
+const promises_1 = require("fs/promises");
+const path = __importStar(require("path"));
+const errors_1 = require("./errors");
+const save_1 = require("./save");
+const MIME_BY_EXT = {
+    mp4: 'video/mp4', mov: 'video/quicktime', webm: 'video/webm', m4v: 'video/mp4',
+    mp3: 'audio/mpeg', wav: 'audio/wav', m4a: 'audio/mp4', aac: 'audio/aac', ogg: 'audio/ogg', flac: 'audio/flac',
+    png: 'image/png', jpg: 'image/jpeg', jpeg: 'image/jpeg', webp: 'image/webp', gif: 'image/gif', svg: 'image/svg+xml',
+    json: 'application/json', txt: 'text/plain', vtt: 'text/vtt', srt: 'application/x-subrip', ass: 'text/x-ssa',
+    ttf: 'font/ttf', otf: 'font/otf', woff: 'font/woff', woff2: 'font/woff2',
+    html: 'text/html', htm: 'text/html', css: 'text/css', js: 'text/javascript', mjs: 'text/javascript',
+};
+const EXT_BY_MIME = {
+    'video/mp4': 'mp4', 'audio/mpeg': 'mp3', 'audio/wav': 'wav', 'audio/x-wav': 'wav', 'image/png': 'png', 'image/jpeg': 'jpg',
+    'image/webp': 'webp', 'image/svg+xml': 'svg', 'font/ttf': 'ttf', 'font/otf': 'otf', 'font/woff': 'woff', 'font/woff2': 'woff2',
+    'application/json': 'json', 'text/vtt': 'vtt', 'text/html': 'html',
+};
+function mimeOf(file) {
+    return MIME_BY_EXT[path.extname(file).slice(1).toLowerCase()] ?? 'application/octet-stream';
+}
+function mediaOfMime(mime) {
+    if (mime.startsWith('video/'))
+        return 'video';
+    if (mime.startsWith('audio/'))
+        return 'audio';
+    if (mime.startsWith('image/'))
+        return 'image';
+    if (mime.startsWith('font/'))
+        return 'font';
+    if (mime === 'text/html')
+        return 'html';
+    if (mime === 'application/json')
+        return 'json';
+    if (mime === 'text/vtt' || mime === 'application/x-subrip' || mime === 'text/x-ssa')
+        return 'subtitles';
+    return 'text';
+}
+async function hashFile(file) {
+    const hash = (0, crypto_1.createHash)('sha256');
+    let bytes = 0;
+    await new Promise((resolve, reject) => {
+        (0, fs_1.createReadStream)(file)
+            .on('data', (chunk) => {
+            hash.update(chunk);
+            bytes += chunk.length;
+        })
+            .on('end', () => resolve())
+            .on('error', reject);
+    });
+    return { sha256: hash.digest('hex'), bytes };
+}
+/** A FileRef for a file on disk: hashed, and probed when it is audio, video or an image. */
+async function fileRef(file, media, probe, mime) {
+    const info = await (0, promises_1.stat)(file);
+    if (!info.isFile())
+        throw new Error(`${path.basename(file)} is not a file`);
+    const { sha256, bytes } = await hashFile(file);
+    if (bytes < 1)
+        throw new Error(`${path.basename(file)} is empty`);
+    const ref = { kind: 'file', path: path.resolve(file), sha256, bytes, media, mime: mime ?? mimeOf(file) };
+    if (probe && (media === 'video' || media === 'audio' || media === 'image')) {
+        try {
+            const probed = await probe(ref.path);
+            if (probed.duration_s !== undefined && media !== 'image')
+                ref.duration_s = probed.duration_s;
+            if (probed.width !== undefined)
+                ref.width = probed.width;
+            if (probed.height !== undefined)
+                ref.height = probed.height;
+            if (probed.fps !== undefined && media === 'video')
+                ref.fps = probed.fps;
+        }
+        catch {
+            // A file the probe can't read keeps its hash; the part that needs the numbers fails on its own.
+        }
+    }
+    return ref;
+}
+/** Whether a FileRef's file is still there with the same bytes. */
+async function intact(ref) {
+    if (!(0, fs_1.existsSync)(ref.path))
+        return false;
+    try {
+        const { sha256, bytes } = await hashFile(ref.path);
+        return sha256 === ref.sha256 && bytes === ref.bytes;
+    }
+    catch {
+        return false;
+    }
+}
+function isFrozenFile(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    const v = value;
+    const keys = Object.keys(v).sort().join(',');
+    return keys === 'bytes,mime,sha256,url' && typeof v.url === 'string' && typeof v.sha256 === 'string' && /^[a-f0-9]{64}$/.test(v.sha256) && typeof v.bytes === 'number' && typeof v.mime === 'string';
+}
+function isLineFile(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    const v = value;
+    const keys = Object.keys(v).sort().join(',');
+    return (keys === 'bytes,file_id,mime,ref,sha256' &&
+        typeof v.file_id === 'string' &&
+        /^[A-Za-z0-9_-]{1,64}$/.test(v.file_id) &&
+        v.ref === `gooseworks-file:${v.file_id}` &&
+        typeof v.sha256 === 'string' &&
+        /^[a-f0-9]{64}$/.test(v.sha256) &&
+        typeof v.bytes === 'number' &&
+        typeof v.mime === 'string');
+}
+const MAX_INPUT_BYTES = 200 * 1024 * 1024;
+const mismatch = () => new errors_1.KitStop('A file in the plan does not match the one approved, so nothing was made and nothing was spent.', 'refused');
+/** The bytes of one plan file, checked against its size and hash; fetched once per sha256. */
+async function checkedFile(files, file, fetch) {
+    await (0, promises_1.mkdir)(files.dir, { recursive: true, mode: 0o700 });
+    const target = path.join(files.dir, `${file.sha256}.${EXT_BY_MIME[file.mime] ?? 'bin'}`);
+    const have = (0, fs_1.existsSync)(target) ? await hashFile(target) : null;
+    if (!have || have.sha256 !== file.sha256 || have.bytes !== file.bytes) {
+        if (file.bytes > MAX_INPUT_BYTES)
+            throw new errors_1.KitStop('A file in the plan is larger than the kit allows. Nothing was spent.', 'refused');
+        const data = await fetch();
+        if (data.length !== file.bytes || (0, crypto_1.createHash)('sha256').update(data).digest('hex') !== file.sha256)
+            throw mismatch();
+        await (0, save_1.atomicWrite)(target, data);
+    }
+    return fileRef(target, mediaOfMime(file.mime), files.probe, file.mime);
+}
+/**
+ * The value with every plan file (a frozen link, or a file the line hosts)
+ * downloaded into the run folder, checked against its hash and size, and
+ * swapped for its FileRef. One file that fails its check stops the run.
+ */
+async function materialize(value, files) {
+    if (isFrozenFile(value))
+        return checkedFile(files, value, () => files.download(value.url, MAX_INPUT_BYTES));
+    if (isLineFile(value)) {
+        const ref = await checkedFile(files, value, async () => {
+            // A hosted file's link lives a few minutes: a failed download asks for a fresh one once.
+            try {
+                return await files.download(await files.hostedLink(value.file_id), MAX_INPUT_BYTES);
+            }
+            catch (error) {
+                if (error instanceof errors_1.KitStop)
+                    throw error;
+                return files.download(await files.hostedLink(value.file_id), MAX_INPUT_BYTES);
+            }
+        });
+        files.onHosted?.(value.sha256, value.ref);
+        return ref;
+    }
+    if (Array.isArray(value)) {
+        const out = [];
+        for (const item of value)
+            out.push(await materialize(item, files));
+        return out;
+    }
+    if (value && typeof value === 'object') {
+        const out = {};
+        for (const [k, v] of Object.entries(value))
+            out[k] = await materialize(v, files);
+        return out;
+    }
+    return value;
+}
+//# sourceMappingURL=files.js.map

package/dist/kit/core/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../../src/kit/core/files.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,wBAEC;AAED,kCASC;AAED,4BAaC;AAKD,0BAkBC;AAGD,wBAQC;AAUD,oCAKC;AAcD,gCAcC;AAoCD,kCA0BC;AAhMD,4EAA4E;AAC5E,gFAAgF;AAChF,mCAAoC;AACpC,2BAAkD;AAClD,0CAA0C;AAC1C,2CAA6B;AAE7B,qCAAmC;AACnC,iCAAqC;AAErC,MAAM,WAAW,GAA2B;IAC1C,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,iBAAiB,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,WAAW;IAC9E,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,YAAY;IAC7G,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,eAAe;IACnH,IAAI,EAAE,kBAAkB,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,sBAAsB,EAAE,GAAG,EAAE,YAAY;IAC5G,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY;IACxE,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE,EAAE,iBAAiB,EAAE,GAAG,EAAE,iBAAiB;CACpG,CAAC;AAEF,MAAM,WAAW,GAA2B;IAC1C,WAAW,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK;IAC1H,YAAY,EAAE,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO;IAC9H,kBAAkB,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM;CACnE,CAAC;AAEF,SAAgB,MAAM,CAAC,IAAY;IACjC,OAAO,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,0BAA0B,CAAC;AAC9F,CAAC;AAED,SAAgB,WAAW,CAAC,IAAY;IACtC,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,OAAO,CAAC;IAC9C,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,OAAO,CAAC;IAC9C,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,OAAO,CAAC;IAC9C,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,MAAM,CAAC;IAC5C,IAAI,IAAI,KAAK,WAAW;QAAE,OAAO,MAAM,CAAC;IACxC,IAAI,IAAI,KAAK,kBAAkB;QAAE,OAAO,MAAM,CAAC;IAC/C,IAAI,IAAI,KAAK,UAAU,IAAI,IAAI,KAAK,sBAAsB,IAAI,IAAI,KAAK,YAAY;QAAE,OAAO,WAAW,CAAC;IACxG,OAAO,MAAM,CAAC;AAChB,CAAC;AAEM,KAAK,UAAU,QAAQ,CAAC,IAAY;IACzC,MAAM,IAAI,GAAG,IAAA,mBAAU,EAAC,QAAQ,CAAC,CAAC;IAClC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC1C,IAAA,qBAAgB,EAAC,IAAI,CAAC;aACnB,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YACpB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACnB,KAAK,IAAI,KAAK,CAAC,MAAM,CAAC;QACxB,CAAC,CAAC;aACD,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;aAC1B,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC;AAC/C,CAAC;AAID,4FAA4F;AACrF,KAAK,UAAU,OAAO,CAAC,IAAY,EAAE,KAAgB,EAAE,KAAa,EAAE,IAAa;IACxF,MAAM,IAAI,GAAG,MAAM,IAAA,eAAI,EAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC5E,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC/C,IAAI,KAAK,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAClE,MAAM,GAAG,GAAY,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;IAClH,IAAI,KAAK,IAAI,CAAC,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,OAAO,CAAC,EAAE,CAAC;QAC3E,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACrC,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,IAAI,KAAK,KAAK,OAAO;gBAAE,GAAG,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;YAC7F,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;gBAAE,GAAG,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;YACzD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;gBAAE,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;YAC5D,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS,IAAI,KAAK,KAAK,OAAO;gBAAE,GAAG,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;QAC1E,CAAC;QAAC,MAAM,CAAC;YACP,gGAAgG;QAClG,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,mEAAmE;AAC5D,KAAK,UAAU,MAAM,CAAC,GAAY;IACvC,IAAI,CAAC,IAAA,eAAU,EAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACxC,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnD,OAAO,MAAM,KAAK,GAAG,CAAC,MAAM,IAAI,KAAK,KAAK,GAAG,CAAC,KAAK,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAUD,SAAgB,YAAY,CAAC,KAAc;IACzC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9E,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7C,OAAO,IAAI,KAAK,uBAAuB,IAAI,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC;AACvM,CAAC;AAcD,SAAgB,UAAU,CAAC,KAAc;IACvC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9E,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7C,OAAO,CACL,IAAI,KAAK,+BAA+B;QACxC,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ;QAC7B,uBAAuB,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;QACvC,CAAC,CAAC,GAAG,KAAK,mBAAmB,CAAC,CAAC,OAAO,EAAE;QACxC,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ;QAC5B,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;QAC/B,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ;QAC3B,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAC3B,CAAC;AACJ,CAAC;AAED,MAAM,eAAe,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;AAa1C,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,IAAI,gBAAO,CAAC,gGAAgG,EAAE,SAAS,CAAC,CAAC;AAEhJ,8FAA8F;AAC9F,KAAK,UAAU,WAAW,CAAC,KAAgB,EAAE,IAAqD,EAAE,KAA4B;IAC9H,MAAM,IAAA,gBAAK,EAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC;IACzF,MAAM,IAAI,GAAG,IAAA,eAAU,EAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAChE,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;QACtE,IAAI,IAAI,CAAC,KAAK,GAAG,eAAe;YAAE,MAAM,IAAI,gBAAO,CAAC,sEAAsE,EAAE,SAAS,CAAC,CAAC;QACvI,MAAM,IAAI,GAAG,MAAM,KAAK,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,KAAK,IAAI,IAAA,mBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,MAAM;YAAE,MAAM,QAAQ,EAAE,CAAC;QACpH,MAAM,IAAA,kBAAW,EAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,OAAO,CAAC,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;AACzE,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,WAAW,CAAC,KAAc,EAAE,KAAgB;IAChE,IAAI,YAAY,CAAC,KAAK,CAAC;QAAE,OAAO,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC;IAC5G,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE;YACrD,yFAAyF;YACzF,IAAI,CAAC;gBACH,OAAO,MAAM,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC;YACtF,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,KAAK,YAAY,gBAAO;oBAAE,MAAM,KAAK,CAAC;gBAC1C,OAAO,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC;YAChF,CAAC;QACH,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1C,OAAO,GAAG,CAAC;IACb,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,GAAG,GAAc,EAAE,CAAC;QAC1B,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,GAAG,CAAC,IAAI,CAAC,MAAM,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;QACnE,OAAO,GAAG,CAAC;IACb,CAAC;IACD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,WAAW,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAC5G,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/kit/core/host.d.ts

@@ -0,0 +1,26 @@
+import type { KitBrowserProvider } from '../part-interface';
+import { type PartLoader } from '../parts/loader';
+import type { ToolReport } from '../line/types';
+export interface BrowserSupport {
+    /** The bundled browser for the device report; sets it up first when `setup` is true. */
+    check(opts: {
+        home: string;
+        setup: boolean;
+        env: NodeJS.ProcessEnv;
+        say: (line: string) => void;
+    }): Promise<ToolReport & {
+        problem?: string;
+    }>;
+    /** The Playwright-shaped browser a render_html part gets. Pages may load only file:// under `allowDirs`. */
+    provider(opts: {
+        allowDirs: string[];
+        signal: AbortSignal;
+    }): KitBrowserProvider;
+}
+export type { LoadedPart, PartLoader } from '../parts/loader';
+export interface KitHost {
+    browser: BrowserSupport;
+    loader: PartLoader;
+}
+export declare function defaultHost(): KitHost;
+//# sourceMappingURL=host.d.ts.map

package/dist/kit/core/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../../src/kit/core/host.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,WAAW,cAAc;IAC7B,wFAAwF;IACxF,KAAK,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;QAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,GAAG;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/I,4GAA4G;IAC5G,QAAQ,CAAC,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,WAAW,CAAA;KAAE,GAAG,kBAAkB,CAAC;CAClF;AAED,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE9D,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,wBAAgB,WAAW,IAAI,OAAO,CAErC"}

package/dist/kit/core/host.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultHost = defaultHost;
+const browser_1 = require("../maker/browser");
+const loader_1 = require("../parts/loader");
+const version_1 = require("./version");
+function defaultHost() {
+    return { browser: (0, browser_1.createKitBrowserSupport)(), loader: (0, loader_1.createPartLoader)({ kitVersion: version_1.KIT_VERSION }) };
+}
+//# sourceMappingURL=host.js.map

package/dist/kit/core/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","sourceRoot":"","sources":["../../../src/kit/core/host.ts"],"names":[],"mappings":";;AAwBA,kCAEC;AArBD,8CAA2D;AAC3D,4CAAoE;AACpE,uCAAwC;AAiBxC,SAAgB,WAAW;IACzB,OAAO,EAAE,OAAO,EAAE,IAAA,iCAAuB,GAAE,EAAE,MAAM,EAAE,IAAA,yBAAgB,EAAC,EAAE,UAAU,EAAE,qBAAW,EAAE,CAAC,EAAE,CAAC;AACvG,CAAC"}

package/dist/kit/core/log.d.ts

@@ -0,0 +1,17 @@
+import type { PartLogger } from '../part-interface';
+export type Redactor = (text: string) => string;
+export declare class KitLog {
+    private readonly print;
+    private readonly redactor;
+    private file;
+    constructor(print: (line: string) => void, redactor?: Redactor);
+    /** Start writing log.ndjson in the run folder. */
+    attach(file: string): void;
+    clean(text: string): string;
+    /** A line for the person running the kit (and the worker's output tail). */
+    say(line: string): void;
+    write(level: 'debug' | 'info' | 'warn' | 'error', message: string, fields?: Record<string, unknown>): void;
+    /** The logger a part gets: file only, tagged with its step. */
+    forStep(step: string): PartLogger;
+}
+//# sourceMappingURL=log.d.ts.map

package/dist/kit/core/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../../src/kit/core/log.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAc,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGhE,MAAM,MAAM,QAAQ,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;AAEhD,qBAAa,MAAM;IAIf,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAJ3B,OAAO,CAAC,IAAI,CAAuB;gBAGhB,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAC7B,QAAQ,GAAE,QAAiC;IAG9D,kDAAkD;IAClD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK1B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI3B,4EAA4E;IAC5E,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMvB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAU1G,+DAA+D;IAC/D,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU;CAKlC"}

package/dist/kit/core/log.js

@@ -0,0 +1,82 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KitLog = void 0;
+// The kit's structured log: log.ndjson in the run folder, secrets redacted.
+// Lines meant for the person go through `say`; part logs stay in the file.
+const fs_1 = require("fs");
+const path = __importStar(require("path"));
+const secrets_1 = require("./secrets");
+class KitLog {
+    print;
+    redactor;
+    file = null;
+    constructor(print, redactor = (text) => (0, secrets_1.redact)(text)) {
+        this.print = print;
+        this.redactor = redactor;
+    }
+    /** Start writing log.ndjson in the run folder. */
+    attach(file) {
+        (0, fs_1.mkdirSync)(path.dirname(file), { recursive: true, mode: 0o700 });
+        this.file = file;
+    }
+    clean(text) {
+        return (0, secrets_1.redact)(this.redactor(text));
+    }
+    /** A line for the person running the kit (and the worker's output tail). */
+    say(line) {
+        const text = this.clean(line);
+        this.print(text);
+        this.write('info', text);
+    }
+    write(level, message, fields) {
+        if (!this.file)
+            return;
+        const entry = { at: new Date().toISOString(), level, message, ...(fields ? { fields } : {}) };
+        try {
+            (0, fs_1.appendFileSync)(this.file, this.clean(JSON.stringify(entry)) + '\n', { mode: 0o600 });
+        }
+        catch {
+            // A full disk must not hide the real error.
+        }
+    }
+    /** The logger a part gets: file only, tagged with its step. */
+    forStep(step) {
+        const at = (level) => (message, fields) => this.write(level, String(message).slice(0, 4000), { step, ...(fields ?? {}) });
+        return { debug: at('debug'), info: at('info'), warn: at('warn'), error: at('error') };
+    }
+}
+exports.KitLog = KitLog;
+//# sourceMappingURL=log.js.map

package/dist/kit/core/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../../src/kit/core/log.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,4EAA4E;AAC5E,2EAA2E;AAC3E,2BAA+C;AAC/C,2CAA6B;AAE7B,uCAAmC;AAInC,MAAa,MAAM;IAIE;IACA;IAJX,IAAI,GAAkB,IAAI,CAAC;IAEnC,YACmB,KAA6B,EAC7B,WAAqB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,gBAAM,EAAC,IAAI,CAAC;QAD3C,UAAK,GAAL,KAAK,CAAwB;QAC7B,aAAQ,GAAR,QAAQ,CAAmC;IAC3D,CAAC;IAEJ,kDAAkD;IAClD,MAAM,CAAC,IAAY;QACjB,IAAA,cAAS,EAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAChE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,IAAY;QAChB,OAAO,IAAA,gBAAM,EAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IACrC,CAAC;IAED,4EAA4E;IAC5E,GAAG,CAAC,IAAY;QACd,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjB,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,KAA0C,EAAE,OAAe,EAAE,MAAgC;QACjG,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,OAAO;QACvB,MAAM,KAAK,GAAG,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QAC9F,IAAI,CAAC;YACH,IAAA,mBAAc,EAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACvF,CAAC;QAAC,MAAM,CAAC;YACP,4CAA4C;QAC9C,CAAC;IACH,CAAC;IAED,+DAA+D;IAC/D,OAAO,CAAC,IAAY;QAClB,MAAM,EAAE,GAAG,CAAC,KAA0C,EAAE,EAAE,CAAC,CAAC,OAAe,EAAE,MAAmB,EAAE,EAAE,CAClG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QACjF,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IACxF,CAAC;CACF;AAzCD,wBAyCC"}

package/dist/kit/core/paths.d.ts

@@ -0,0 +1,27 @@
+export declare function kitHome(env?: NodeJS.ProcessEnv): string;
+export declare function kitDir(home: string): string;
+export declare function devicePath(home: string): string;
+export declare function partsCacheDir(home: string): string;
+export declare function kitBinDir(home: string): string;
+/** Every path inside one video's run folder. */
+export interface RunLayout {
+    root: string;
+    lock: string;
+    run: string;
+    plan: string;
+    partsLock: string;
+    style: string;
+    inputs: string;
+    steps: string;
+    layers: string;
+    pieces: string;
+    final: string;
+    upload: string;
+    log: string;
+}
+export declare function runLayout(home: string, videoId: string): RunLayout;
+/** A timeline step's folder, or a layer's ("layer-<slot>" lives under layers/<slot>). */
+export declare function stepFolder(layout: RunLayout, stepId: string): string;
+/** True when `child` is `parent` or inside it. */
+export declare function isInside(parent: string, child: string): boolean;
+//# sourceMappingURL=paths.d.ts.map

package/dist/kit/core/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/kit/core/paths.ts"],"names":[],"mappings":"AAcA,wBAAgB,OAAO,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAIpE;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,gDAAgD;AAChD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAkBlE;AAED,yFAAyF;AACzF,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,kDAAkD;AAClD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAG/D"}

package/dist/kit/core/paths.js

@@ -0,0 +1,103 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.kitHome = kitHome;
+exports.kitDir = kitDir;
+exports.devicePath = devicePath;
+exports.partsCacheDir = partsCacheDir;
+exports.kitBinDir = kitBinDir;
+exports.runLayout = runLayout;
+exports.stepFolder = stepFolder;
+exports.isInside = isInside;
+// The kit's save folder layout (part-interface.md section 8).
+//
+//   ~/.gooseworks/kit/device.json          device_id, a UUID made once
+//   ~/.gooseworks/kit/parts/<id>/<ver>/    part cache, hash-checked on every load
+//   ~/.gooseworks/kit/bin/                 the kit's own ffmpeg and ffprobe
+//   ~/.gooseworks/videos/<video_id>/       one run folder per video
+//
+// GOOSE_KIT_HOME replaces ~/.gooseworks.
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const env_1 = require("../env");
+const SAFE_ID = /^[A-Za-z0-9_-]{1,64}$/;
+function kitHome(env = process.env) {
+    const home = env[env_1.KIT_DEV_ENV.home];
+    if (home)
+        return path.resolve(home);
+    return path.join(env.GOOSEWORKS_USER_HOME || os.homedir(), '.gooseworks');
+}
+function kitDir(home) {
+    return path.join(home, 'kit');
+}
+function devicePath(home) {
+    return path.join(kitDir(home), 'device.json');
+}
+function partsCacheDir(home) {
+    return path.join(kitDir(home), 'parts');
+}
+function kitBinDir(home) {
+    return path.join(kitDir(home), 'bin');
+}
+function runLayout(home, videoId) {
+    if (!SAFE_ID.test(videoId))
+        throw new Error('That video id is not valid.');
+    const root = path.join(home, 'videos', videoId);
+    return {
+        root,
+        lock: path.join(root, 'run.lock'),
+        run: path.join(root, 'run.json'),
+        plan: path.join(root, 'plan.json'),
+        partsLock: path.join(root, 'parts.lock.json'),
+        style: path.join(root, 'style'),
+        inputs: path.join(root, 'inputs'),
+        steps: path.join(root, 'steps'),
+        layers: path.join(root, 'layers'),
+        pieces: path.join(root, 'pieces'),
+        final: path.join(root, 'final'),
+        upload: path.join(root, 'upload.json'),
+        log: path.join(root, 'log.ndjson'),
+    };
+}
+/** A timeline step's folder, or a layer's ("layer-<slot>" lives under layers/<slot>). */
+function stepFolder(layout, stepId) {
+    return stepId.startsWith('layer-') ? path.join(layout.layers, stepId.slice('layer-'.length)) : path.join(layout.steps, stepId);
+}
+/** True when `child` is `parent` or inside it. */
+function isInside(parent, child) {
+    const rel = path.relative(path.resolve(parent), path.resolve(child));
+    return rel === '' || (!rel.startsWith('..') && !path.isAbsolute(rel));
+}
+//# sourceMappingURL=paths.js.map

package/dist/kit/core/paths.js.map

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

package/dist/kit/core/pieces.d.ts

@@ -0,0 +1,84 @@
+import type { MediaKind, ModelNeed, PartRef, PieceOrder, PieceResult } from '../part-interface';
+import { type Sleep, type VideoLine } from '../line/client';
+import { type LineErrorBody } from '../line/types';
+import { PartError } from './errors';
+import { type Probe } from './files';
+/** A piece the line refused or failed: final, or worth one new attempt. The line's words travel with it. */
+export declare class PieceFailure extends PartError {
+    readonly line: LineErrorBody;
+    constructor(code: 'provider_rejected' | 'provider_failed', line: LineErrorBody);
+}
+/**
+ * Every key this video sent for one piece, and how it ended, saved before the
+ * call goes out. A key whose piece is running or done is asked again, never
+ * replaced, so a finished paid piece is never ordered under a new key; only a
+ * provider failure earns the one new attempt.
+ */
+interface OrderState {
+    inputs_hash: string;
+    piece_key: string;
+    attempts: Array<{
+        attempt: number;
+        key: string;
+        outcome: 'sent' | 'done' | 'failed';
+        failure?: LineErrorBody;
+    }>;
+}
+interface CachedPiece {
+    inputs_hash: string;
+    json: unknown;
+    files: Record<string, {
+        sha256: string;
+        bytes: number;
+        mime: string;
+        media: MediaKind;
+    }>;
+}
+/** pieces/<inputs_hash>/: downloaded paid results, reused by any re-run. */
+export declare class PieceCache {
+    private readonly root;
+    constructor(root: string);
+    private dir;
+    /** The saved piece when it holds every result asked for, intact. */
+    lookup(hash: string, results: PieceOrder['results']): Promise<CachedPiece | null>;
+    fileOf(hash: string, sha256: string): string;
+    saveFile(hash: string, data: Buffer): Promise<string>;
+    saveRecord(record: CachedPiece): Promise<void>;
+    readOrder(hash: string): Promise<OrderState | null>;
+    saveOrder(state: OrderState): Promise<void>;
+}
+/** What one step's ctx.line needs from the core. */
+export interface PieceLine {
+    line: VideoLine;
+    videoId: string;
+    stepId: string;
+    part: PartRef;
+    /** The models this part may order: the lock's entry (or the manifest's, for dev parts). */
+    models: ModelNeed[];
+    workDir: string;
+    runRoot: string;
+    cache: PieceCache;
+    signal: AbortSignal;
+    sleep: Sleep;
+    probe?: Probe;
+    /** Hosted files by sha256, shared by the whole run. */
+    hosted: Map<string, string>;
+    /** One order at a time per piece hash, shared by the whole run. */
+    locks: Map<string, Promise<void>>;
+    /** Called after every piece, with the piece's record, once its files are saved. */
+    onPiece: (record: {
+        piece: string;
+        piece_key: string;
+        inputs_hash: string;
+        idempotency_key: string;
+        attempt: 1 | 2;
+        reused: boolean;
+        credits?: number;
+    }) => Promise<void>;
+    /** Called while a piece is still running at the provider. */
+    onWait: () => void;
+}
+/** ctx.line.order for one step run. */
+export declare function pieceOrderer(ctx: PieceLine): (order: PieceOrder) => Promise<PieceResult>;
+export {};
+//# sourceMappingURL=pieces.d.ts.map

package/dist/kit/core/pieces.d.ts.map

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