@withbuddi/buddi 0.1.0-pre.47 → 0.1.0-pre.48

package/node_modules/@buddi/core/dist/runtimes/download.js

@@ -0,0 +1,333 @@
+/**
+ * Downloading what buddi runs locally — the ONNX engine and shared models —
+ * with one set of safety rules (docs/plugin-host-api.md §4.2 `onnx`, 1.32):
+ *
+ *  - Everything is written under a `.tmp-*` name in the folder it will end up
+ *    in, so the final move is a same-filesystem `rename`, atomic.
+ *  - The sha256 and the length are checked against the pin while the bytes
+ *    arrive; a mismatch deletes the temporary file and nothing is moved.
+ *  - A download that dies half-way deletes what it wrote; one from a process
+ *    that died is swept by the next download into that folder.
+ *  - Nothing downloaded is opened, executed or loaded before its hash matched.
+ *
+ * The tarball reader is the smallest that reads an npm tarball (ustar, with
+ * pax and GNU long names): it streams through gunzip and writes only the
+ * entries asked for, hashing each as it goes.
+ */
+import { createHash, randomBytes } from 'node:crypto';
+import { createReadStream } from 'node:fs';
+import { open, readdir, rm } from 'node:fs/promises';
+import { request as httpsRequest } from 'node:https';
+import path from 'node:path';
+import { createGunzip } from 'node:zlib';
+import { guardedLookup } from '../host/http.js';
+import { DEFAULT_POLICY, checkUrl } from '../plugin/url.js';
+import { scrubText } from '../secrets/scrub.js';
+/** The most redirects one download follows. */
+export const DOWNLOAD_MAX_REDIRECTS = 5;
+/**
+ * GET over `node:https`, one connection per request and no pool (the reason
+ * the shared transport exists; it buffers whole answers, and an engine is a
+ * hundred megabytes). The same guards as the shared transport: every URL —
+ * the first and every redirect — goes through `checkUrl` (no credentials, the
+ * web's own ports, no private or local host), https only, and the socket
+ * resolves through `guardedLookup`, so a name that answers a private address
+ * is refused before anything is sent. Five redirects at most.
+ */
+export function nodeGet(options = {}) {
+    const request = options.request ?? httpsRequest;
+    const rewrite = options.rewrite ?? ((url) => url);
+    const policy = options.policy ?? DEFAULT_POLICY;
+    const lookup = guardedLookup(options.resolve, policy);
+    const once = (url, signal) => new Promise((resolve, reject) => {
+        const req = request(rewrite(url), { method: 'GET', agent: false, lookup, headers: { 'user-agent': 'buddi', accept: '*/*' }, ...(signal ? { signal } : {}) }, resolve);
+        req.setTimeout(60_000, () => req.destroy(new Error('the server went quiet for a minute')));
+        req.on('error', reject);
+        req.end();
+    });
+    return async (url, opts = {}) => {
+        let current = url;
+        for (let hop = 0; hop <= DOWNLOAD_MAX_REDIRECTS; hop += 1) {
+            const checked = checkUrl(current, policy);
+            if (checked.url.protocol !== 'https:')
+                throw new Error(`refusing ${checked.url.host}: downloads are https only`);
+            const res = await once(current, opts.signal);
+            const status = res.statusCode ?? 0;
+            const location = res.headers.location;
+            if (status >= 300 && status < 400 && typeof location === 'string') {
+                res.resume();
+                current = new URL(location, current).toString();
+                continue;
+            }
+            if (status < 200 || status >= 300)
+                res.resume();
+            return { status, body: res };
+        }
+        throw new Error('too many redirects');
+    };
+}
+/** Why a download was refused or failed, in a sentence for the owner. */
+export class DownloadError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'DownloadError';
+    }
+}
+/**
+ * A fresh temporary name in `dir`: `.tmp-<random><suffix>`, or
+ * `.tmp-<owner>+<random><suffix>` when an owner (a model id) is named, so a
+ * sweep for one owner never touches another's download in the same folder.
+ * `+` is not a character an id may hold, so `.tmp-a+` never matches `a-b`'s.
+ */
+export function tempName(dir, suffix = '', owner) {
+    return path.join(dir, `.tmp-${owner === undefined ? '' : `${owner}+`}${randomBytes(6).toString('hex')}${suffix}`);
+}
+/** The prefix of an owner's temporaries (`tempName`'s third argument). */
+export function tempPrefix(owner) {
+    return owner === undefined ? '.tmp-' : `.tmp-${owner}+`;
+}
+/**
+ * Delete every `.tmp-*` entry in `dir` (or only an owner's, `.tmp-<owner>+*`):
+ * what a download that died left. `keep` spares the entries a running download
+ * owns. Never throws.
+ */
+export async function sweepTemp(dir, owner, keep = () => false) {
+    let names;
+    try {
+        names = await readdir(dir);
+    }
+    catch {
+        return 0;
+    }
+    let swept = 0;
+    const prefix = tempPrefix(owner);
+    for (const name of names) {
+        if (!name.startsWith(prefix) || keep(name))
+            continue;
+        await rm(path.join(dir, name), { recursive: true, force: true }).catch(() => { });
+        swept += 1;
+    }
+    return swept;
+}
+/**
+ * Fetch `file.url` into `dest`, checking the length and sha256 as the bytes
+ * arrive. On any failure `dest` is deleted and a `DownloadError` thrown; on
+ * success `dest` holds exactly the pinned bytes.
+ */
+export async function downloadVerified(get, file, dest, opts = {}) {
+    let handle;
+    try {
+        let response;
+        try {
+            response = await get(file.url, opts.signal ? { signal: opts.signal } : {});
+        }
+        catch (err) {
+            throw new DownloadError(`Could not reach ${hostOf(file.url)}: ${safeReason(err instanceof Error ? err.message : String(err))}${errorCode(err)}`);
+        }
+        if (response.status < 200 || response.status >= 300) {
+            throw new DownloadError(`${hostOf(file.url)} answered ${response.status} for ${path.posix.basename(new URL(file.url).pathname)}.`);
+        }
+        handle = await open(dest, 'wx');
+        const hash = createHash('sha256');
+        let received = 0;
+        try {
+            for await (const chunk of response.body) {
+                received += chunk.byteLength;
+                if (received > file.bytes) {
+                    throw new DownloadError(`${path.posix.basename(new URL(file.url).pathname)} is larger than the ${file.bytes} bytes pinned for it.`);
+                }
+                hash.update(chunk);
+                await handle.write(chunk);
+                opts.onProgress?.(received);
+            }
+        }
+        catch (err) {
+            if (err instanceof DownloadError)
+                throw err;
+            throw new DownloadError(`The download from ${hostOf(file.url)} broke off after ${received} bytes: ${safeReason(err instanceof Error ? err.message : String(err))}${errorCode(err)}`);
+        }
+        if (received !== file.bytes) {
+            throw new DownloadError(`The download from ${hostOf(file.url)} ended after ${received} of ${file.bytes} bytes.`);
+        }
+        const digest = hash.digest('hex');
+        if (digest !== file.sha256.toLowerCase()) {
+            throw new DownloadError(`The file from ${hostOf(file.url)} does not match its pinned checksum (sha256 ${digest.slice(0, 12)}…, expected ${file.sha256.slice(0, 12)}…).`);
+        }
+        await handle.close();
+        handle = undefined;
+    }
+    catch (err) {
+        await handle?.close().catch(() => { });
+        await rm(dest, { force: true }).catch(() => { });
+        throw err;
+    }
+}
+/**
+ * Stream a `.tgz` and write only the wanted entries, each to its `dest`,
+ * checking each one's length and sha256. Throws a `DownloadError` naming the
+ * first entry that is missing, the wrong size or the wrong hash; the caller
+ * deletes the folder the entries went into.
+ */
+export async function extractVerified(tgz, wanted) {
+    const byEntry = new Map(wanted.map((w) => [w.entry, w]));
+    const done = new Set();
+    let pending = Buffer.alloc(0);
+    // The entry being read: how much of its body is left, the padding after it,
+    // and where its bytes go (a file, a pax/long-name buffer, or nowhere).
+    let body = null;
+    let nextName;
+    let zeros = 0;
+    let ended = false;
+    const finishEntry = async () => {
+        if (body === null)
+            return;
+        if (body.file) {
+            const { handle, hash, want } = body.file;
+            await handle.close();
+            const digest = hash.digest('hex');
+            if (digest !== want.sha256.toLowerCase()) {
+                throw new DownloadError(`${want.entry} does not match its pinned checksum.`);
+            }
+            done.add(want.entry);
+        }
+        if (body.meta) {
+            const text = Buffer.concat(body.meta.parts);
+            if (body.meta.kind === 'longname')
+                nextName = text.toString('utf8').replace(/\0.*$/s, '');
+            else {
+                const found = /(?:^|\n)\d+ path=([^\n]*)\n/.exec(text.toString('utf8'));
+                if (found)
+                    nextName = found[1];
+            }
+        }
+    };
+    const gunzip = createReadStream(tgz).pipe(createGunzip());
+    try {
+        for await (const chunk of gunzip) {
+            if (ended)
+                break;
+            pending = pending.length === 0 ? chunk : Buffer.concat([pending, chunk]);
+            while (!ended) {
+                if (body !== null) {
+                    if (body.remaining > 0) {
+                        if (pending.length === 0)
+                            break;
+                        const take = Math.min(body.remaining, pending.length);
+                        const slice = pending.subarray(0, take);
+                        if (body.file) {
+                            body.file.hash.update(slice);
+                            await body.file.handle.write(slice);
+                        }
+                        else if (body.meta) {
+                            body.meta.parts.push(Buffer.from(slice));
+                        }
+                        body.remaining -= take;
+                        pending = pending.subarray(take);
+                        if (body.remaining > 0)
+                            break;
+                    }
+                    if (pending.length < body.pad)
+                        break;
+                    pending = pending.subarray(body.pad);
+                    await finishEntry();
+                    body = null;
+                    continue;
+                }
+                if (pending.length < 512)
+                    break;
+                const header = pending.subarray(0, 512);
+                pending = pending.subarray(512);
+                if (header.every((byte) => byte === 0)) {
+                    zeros += 1;
+                    if (zeros >= 2)
+                        ended = true;
+                    continue;
+                }
+                zeros = 0;
+                const field = (start, length) => header.subarray(start, start + length).toString('utf8').replace(/\0.*$/s, '');
+                const size = parseInt(field(124, 12).trim() || '0', 8);
+                if (!Number.isFinite(size) || size < 0)
+                    throw new DownloadError('The tarball has an entry whose size cannot be read.');
+                const type = String.fromCharCode(header[156] ?? 0);
+                const prefix = field(345, 155);
+                const name = nextName ?? (prefix ? `${prefix}/${field(0, 100)}` : field(0, 100));
+                const pad = (512 - (size % 512)) % 512;
+                if (type === 'x' || type === 'L') {
+                    body = { remaining: size, pad, meta: { kind: type === 'x' ? 'pax' : 'longname', parts: [] } };
+                    continue;
+                }
+                nextName = undefined;
+                const want = (type === '0' || type === '\0') ? byEntry.get(name) : undefined;
+                if (want !== undefined && !done.has(name)) {
+                    if (size !== want.bytes) {
+                        throw new DownloadError(`${want.entry} is ${size} bytes, not the ${want.bytes} pinned for it.`);
+                    }
+                    const handle = await open(want.dest, 'wx');
+                    body = { remaining: size, pad, file: { handle, hash: createHash('sha256'), want } };
+                }
+                else {
+                    body = { remaining: size, pad };
+                }
+            }
+        }
+    }
+    catch (err) {
+        if (body?.file)
+            await body.file.handle.close().catch(() => { });
+        gunzip.destroy();
+        if (err instanceof DownloadError)
+            throw err;
+        throw new DownloadError(`The tarball could not be read: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    if (body?.file) {
+        await body.file.handle.close().catch(() => { });
+        throw new DownloadError(`The tarball ended inside ${body.file.want.entry}.`);
+    }
+    const missing = wanted.find((w) => !done.has(w.entry));
+    if (missing)
+        throw new DownloadError(`The tarball has no ${missing.entry}.`);
+}
+/** The sha256 of a file on disk, streamed. */
+export async function sha256OfFile(file) {
+    const hash = createHash('sha256');
+    for await (const chunk of createReadStream(file))
+        hash.update(chunk);
+    return hash.digest('hex');
+}
+function hostOf(url) {
+    try {
+        return new URL(url).host || 'the server';
+    }
+    catch {
+        return 'the server';
+    }
+}
+/** ` (ECONNRESET)`: a system error's short code, when it has one. */
+function errorCode(err) {
+    const code = err?.code;
+    return typeof code === 'string' && /^[A-Z0-9_]{2,32}$/.test(code) && !(err instanceof Error && err.message.includes(code)) ? ` (${code})` : '';
+}
+/** The longest failure reason kept, logged or shown. */
+export const REASON_MAX = 300;
+const URL_IN_TEXT = /\b[a-z][a-z0-9+.-]*:\/\/[^\s"'<>()`]+/gi;
+/**
+ * A failure reason safe to log, keep on disk and show in Settings: every
+ * stored secret scrubbed, every URL cut to its host (no credentials, path or
+ * query, where a signed link keeps its key), one line, at most 300 characters.
+ */
+export function safeReason(text) {
+    const scrubbed = scrubText(String(text)).replace(URL_IN_TEXT, (found) => hostOf(found));
+    const line = scrubbed.replace(/[\u0000-\u001f\u007f]+/g, ' ').replace(/\s+/g, ' ').trim();
+    return line.length > REASON_MAX ? `${line.slice(0, REASON_MAX - 1)}…` : line;
+}
+/** Bytes as the owner reads them: `114 MB`, `850 KB`, `1.2 GB`. */
+export function formatDownloadSize(bytes) {
+    if (bytes >= 1e9)
+        return `${(bytes / 1e9).toFixed(1)} GB`;
+    if (bytes >= 1e6)
+        return `${Math.round(bytes / 1e6)} MB`;
+    if (bytes >= 1e3)
+        return `${Math.round(bytes / 1e3)} KB`;
+    return `${bytes} bytes`;
+}
+//# sourceMappingURL=download.js.map

package/node_modules/@buddi/core/dist/runtimes/download.js.map

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

package/node_modules/@buddi/core/dist/runtimes/index.d.ts

@@ -0,0 +1,10 @@
+/** Local-model runtimes: the ONNX engine and shared models (host API 1.32). */
+export * from './pins.js';
+export * from './download.js';
+export * from './config.js';
+export * from './native.js';
+export * from './onnx.js';
+export * from './models.js';
+export * from './consent.js';
+export * from './area.js';
+//# sourceMappingURL=index.d.ts.map

package/node_modules/@buddi/core/dist/runtimes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtimes/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC"}

package/node_modules/@buddi/core/dist/runtimes/index.js

@@ -0,0 +1,10 @@
+/** Local-model runtimes: the ONNX engine and shared models (host API 1.32). */
+export * from './pins.js';
+export * from './download.js';
+export * from './config.js';
+export * from './native.js';
+export * from './onnx.js';
+export * from './models.js';
+export * from './consent.js';
+export * from './area.js';
+//# sourceMappingURL=index.js.map

package/node_modules/@buddi/core/dist/runtimes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtimes/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC"}

package/node_modules/@buddi/core/dist/runtimes/models.d.ts

@@ -0,0 +1,78 @@
+import { type PinnedDownload } from './download.js';
+/** One file of a model: where it comes from, its sha256 and its length. */
+export interface ModelFile extends PinnedDownload {
+    /** Its path inside the model's folder. The URL's last segment when absent. */
+    name?: string;
+}
+export interface ModelRequest {
+    /** Lower case, digits, `.`, `_`, `-`; at most 96. One folder per id across plugins. */
+    id: string;
+    files: readonly ModelFile[];
+}
+/** What `ctx.buddi.models.state(id)` answers. */
+export interface ModelState {
+    id: string;
+    state: 'absent' | 'downloading' | 'ready' | 'failed';
+    /** The sum of its files. */
+    sizeBytes: number;
+    /** The folder its files are in, once it is ready. Pass `path.join(path, name)` to `createSession`. */
+    path?: string;
+    reason?: string;
+    receivedBytes?: number;
+    /** An approval card raised by `ensure` and not decided yet. */
+    pending?: string;
+}
+/** The most one model may be: 8 GB. */
+export declare const MODEL_MAX_BYTES = 8000000000;
+/** A model request that is not one, in a sentence. */
+export declare class ModelRefusal extends Error {
+    constructor(message: string);
+}
+/** Check a request and answer it normalised: every file with its name. Throws a `ModelRefusal`. */
+export declare function checkModelRequest(req: ModelRequest): {
+    id: string;
+    files: Array<PinnedDownload & {
+        name: string;
+    }>;
+    bytes: number;
+};
+/** Keep the owner's yes for a model until its download ends (`runtimes.download`). */
+export declare function markModelApproved(id: string, files: ReadonlyArray<PinnedDownload & {
+    name: string;
+}>): Promise<void>;
+/**
+ * The files the owner approved for a model whose download has not finished
+ * (a restart cut it short), when they are exactly the files asked for now.
+ */
+export declare function approvedModelFiles(id: string, files: ReadonlyArray<{
+    name: string;
+    sha256: string;
+    url: string;
+    bytes: number;
+}>): boolean;
+/**
+ * A model's state. With the files asked for, a model already kept with other
+ * files is `failed`: one id is one model across plugins, and buddi will not
+ * replace another plugin's files.
+ */
+export declare function modelState(id: string, files?: ReadonlyArray<{
+    name: string;
+    sha256: string;
+}>): ModelState;
+/** Start a model's download, once the owner said yes. Joins one already running; never restarts a failure. */
+export declare function startModelDownload(req: ModelRequest): Promise<void>;
+/** Every model kept or failed, for Settings. */
+export declare function listModels(): ModelState[];
+/** Remove a model and any recorded failure. Refused while it downloads. */
+export declare function removeModel(id: string): Promise<{
+    removed: boolean;
+    refused?: string;
+}>;
+/**
+ * Sweep what downloads that died left in `models/` (once at boot): every
+ * temporary except those of a model downloading in this process.
+ */
+export declare function sweepModelTemps(): Promise<number>;
+/** Forget what this process was doing. Tests only. */
+export declare function resetModels(): void;
+//# sourceMappingURL=models.d.ts.map

package/node_modules/@buddi/core/dist/runtimes/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/runtimes/models.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAiE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAGnH,2EAA2E;AAC3E,MAAM,WAAW,SAAU,SAAQ,cAAc;IAC/C,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,uFAAuF;IACvF,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;CAC7B;AAED,iDAAiD;AACjD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,QAAQ,GAAG,aAAa,GAAG,OAAO,GAAG,QAAQ,CAAC;IACrD,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,sGAAsG;IACtG,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,uCAAuC;AACvC,eAAO,MAAM,eAAe,aAAM,CAAC;AAKnC,sDAAsD;AACtD,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAI5B;AAcD,mGAAmG;AACnG,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,YAAY,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,KAAK,CAAC,cAAc,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CA4BnI;AAcD,sFAAsF;AACtF,wBAAsB,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,CAAC,cAAc,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAG1H;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,OAAO,CAQ1I;AAWD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,aAAa,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,UAAU,CAkB1G;AAED,8GAA8G;AAC9G,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBnE;AAkCD,gDAAgD;AAChD,wBAAgB,UAAU,IAAI,UAAU,EAAE,CAezC;AAED,2EAA2E;AAC3E,wBAAsB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAQ7F;AAED;;;GAGG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,CAEvD;AAED,sDAAsD;AACtD,wBAAgB,WAAW,IAAI,IAAI,CAElC"}