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

package/packages/core/dist/runtimes/__fixtures__/server.d.ts

@@ -0,0 +1,26 @@
+import { type DownloadGet } from '../download.js';
+export type Mode = 'ok' | 'corrupt' | 'partial' | 'missing';
+export interface FakeServer {
+    get: DownloadGet;
+    /** What each path answers. */
+    files: Map<string, Buffer>;
+    /** How the next answers behave, by path; `ok` when unset. */
+    modes: Map<string, Mode>;
+    /** How many times each path was asked for. */
+    hits: Map<string, number>;
+    /** Paths answered with a 302 to another https address. */
+    redirects: Map<string, string>;
+    /** Paths whose answer waits this many milliseconds first. */
+    delays: Map<string, number>;
+    /** The port it listens on, 127.0.0.1. */
+    port: number;
+    close(): Promise<void>;
+}
+export declare function startFakeServer(): Promise<FakeServer>;
+export declare function sha256(bytes: Buffer): string;
+/** A gzipped ustar archive of these entries. */
+export declare function tgz(entries: ReadonlyArray<{
+    name: string;
+    body: Buffer;
+}>): Buffer;
+//# sourceMappingURL=server.d.ts.map

package/packages/core/dist/runtimes/__fixtures__/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/runtimes/__fixtures__/server.ts"],"names":[],"mappings":"AAUA,OAAO,EAAW,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE3D,MAAM,MAAM,IAAI,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAE5D,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,WAAW,CAAC;IACjB,8BAA8B;IAC9B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,6DAA6D;IAC7D,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACzB,8CAA8C;IAC9C,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1B,0DAA0D;IAC1D,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,6DAA6D;IAC7D,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,UAAU,CAAC,CAqD3D;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,gDAAgD;AAChD,wBAAgB,GAAG,CAAC,OAAO,EAAE,aAAa,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,MAAM,CAqBlF"}

package/packages/core/dist/runtimes/__fixtures__/server.js

@@ -0,0 +1,93 @@
+/**
+ * A fake download server for the runtimes tests: a real HTTP server on
+ * 127.0.0.1, an ephemeral port, and a `DownloadGet` that sends the pinned
+ * https addresses to it. Nothing here reaches the network.
+ */
+import { createHash } from 'node:crypto';
+import { createServer } from 'node:http';
+import { gzipSync } from 'node:zlib';
+import { request as httpRequest } from 'node:http';
+import { nodeGet } from '../download.js';
+export async function startFakeServer() {
+    const files = new Map();
+    const modes = new Map();
+    const hits = new Map();
+    const redirects = new Map();
+    const delays = new Map();
+    const server = createServer(async (req, res) => {
+        const url = new URL(req.url ?? '/', 'http://x');
+        hits.set(url.pathname, (hits.get(url.pathname) ?? 0) + 1);
+        const wait = delays.get(url.pathname);
+        if (wait !== undefined)
+            await new Promise((resolve) => setTimeout(resolve, wait));
+        const to = redirects.get(url.pathname);
+        if (to !== undefined) {
+            res.writeHead(302, { location: to }).end();
+            return;
+        }
+        const body = files.get(url.pathname);
+        const mode = modes.get(url.pathname) ?? 'ok';
+        if (body === undefined || mode === 'missing') {
+            res.writeHead(404).end();
+            return;
+        }
+        res.writeHead(200, { 'content-length': String(body.length), 'content-type': 'application/octet-stream' });
+        if (mode === 'corrupt') {
+            const bad = Buffer.from(body);
+            bad[Math.floor(bad.length / 2)] = (bad[Math.floor(bad.length / 2)] + 1) % 256;
+            res.end(bad);
+            return;
+        }
+        if (mode === 'partial') {
+            res.write(body.subarray(0, Math.floor(body.length / 2)), () => {
+                res.socket?.destroy();
+            });
+            return;
+        }
+        res.end(body);
+    });
+    await new Promise((resolve) => server.listen(0, '127.0.0.1', resolve));
+    const port = server.address().port;
+    const get = nodeGet({
+        request: httpRequest,
+        rewrite: (url) => `http://127.0.0.1:${port}${new URL(url).pathname}`,
+    });
+    return {
+        get,
+        files,
+        modes,
+        hits,
+        redirects,
+        delays,
+        port,
+        close: () => new Promise((resolve) => server.close(() => resolve())),
+    };
+}
+export function sha256(bytes) {
+    return createHash('sha256').update(bytes).digest('hex');
+}
+/** A gzipped ustar archive of these entries. */
+export function tgz(entries) {
+    const blocks = [];
+    for (const entry of entries) {
+        const header = Buffer.alloc(512);
+        header.write(entry.name, 0, 100, 'utf8');
+        header.write('0000644\0', 100, 'ascii');
+        header.write('0000000\0', 108, 'ascii');
+        header.write('0000000\0', 116, 'ascii');
+        header.write(`${entry.body.length.toString(8).padStart(11, '0')}\0`, 124, 'ascii');
+        header.write('00000000000\0', 136, 'ascii');
+        header.write('        ', 148, 'ascii');
+        header.write('0', 156, 'ascii');
+        header.write('ustar\0', 257, 'ascii');
+        header.write('00', 263, 'ascii');
+        let sum = 0;
+        for (const byte of header)
+            sum += byte;
+        header.write(`${sum.toString(8).padStart(6, '0')}\0 `, 148, 'ascii');
+        blocks.push(header, entry.body, Buffer.alloc((512 - (entry.body.length % 512)) % 512));
+    }
+    blocks.push(Buffer.alloc(1024));
+    return gzipSync(Buffer.concat(blocks));
+}
+//# sourceMappingURL=server.js.map

package/packages/core/dist/runtimes/__fixtures__/server.js.map

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

package/packages/core/dist/runtimes/area.d.ts

@@ -0,0 +1,22 @@
+import type { Pool } from 'pg';
+import type { ActionRecord } from '../actions/types.js';
+import type { ModelsArea, OnnxArea } from '../host/types.js';
+/**
+ * Sweep what downloads that died left (half-written `.tmp-*` tarballs and
+ * folders) under the engine's version folder and `models/`, once per data
+ * directory per process: at boot, from `configurePluginHost`. Never throws.
+ */
+export declare function sweepRuntimesOnce(): Promise<void>;
+export interface RuntimeAreaFacts {
+    plugin: string;
+    /** The plugin's own directory: a model there may be opened. Made on first use. */
+    dir: () => string;
+    pool: () => Pool;
+    agentId?: string | undefined;
+    conversationId?: string | undefined;
+    now: () => Date;
+    askApproval?: ((action: ActionRecord) => Promise<void>) | undefined;
+}
+export declare function onnxAreaOf(facts: RuntimeAreaFacts): OnnxArea;
+export declare function modelsAreaOf(facts: RuntimeAreaFacts): ModelsArea;
+//# sourceMappingURL=area.d.ts.map

package/packages/core/dist/runtimes/area.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"area.d.ts","sourceRoot":"","sources":["../../src/runtimes/area.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAQ7D;;;;GAIG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAMvD;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,kFAAkF;IAClF,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,GAAG,EAAE,MAAM,IAAI,CAAC;IAChB,WAAW,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC;CACrE;AAgBD,wBAAgB,UAAU,CAAC,KAAK,EAAE,gBAAgB,GAAG,QAAQ,CAkE5D;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,gBAAgB,GAAG,UAAU,CAsBhE"}

package/packages/core/dist/runtimes/area.js

@@ -0,0 +1,127 @@
+/**
+ * `ctx.buddi.onnx` and `ctx.buddi.models`, for a plugin that declares
+ * `uses: ['onnx']` (docs/plugin-host-api.md §4.2, 1.32). Built by
+ * `createPluginHost`; a plugin without the declaration has neither.
+ */
+import { realpathSync } from 'node:fs';
+import path from 'node:path';
+import { downloadArgs, raiseDownloadCard } from './consent.js';
+import { approvedModelFiles, checkModelRequest, modelState, ModelRefusal, startModelDownload, sweepModelTemps } from './models.js';
+import { createOnnxSession, onnxApproved, onnxState, OnnxUnavailable, startOnnxDownload, sweepOnnxTemps } from './onnx.js';
+import { modelsRoot } from './config.js';
+const swept = new Set();
+/**
+ * Sweep what downloads that died left (half-written `.tmp-*` tarballs and
+ * folders) under the engine's version folder and `models/`, once per data
+ * directory per process: at boot, from `configurePluginHost`. Never throws.
+ */
+export async function sweepRuntimesOnce() {
+    const root = modelsRoot();
+    if (swept.has(root))
+        return;
+    swept.add(root);
+    await sweepOnnxTemps().catch(() => 0);
+    await sweepModelTemps().catch(() => 0);
+}
+/** Inside `root`, after links are followed. */
+function within(file, root) {
+    let real;
+    let realRoot;
+    try {
+        real = realpathSync(file);
+        realRoot = realpathSync(root);
+    }
+    catch {
+        return false;
+    }
+    const relative = path.relative(realRoot, real);
+    return relative !== '' && !relative.startsWith('..') && !path.isAbsolute(relative);
+}
+export function onnxAreaOf(facts) {
+    const card = (args) => raiseDownloadCard({ pool: facts.pool(), plugin: facts.plugin, agentId: facts.agentId, conversationId: facts.conversationId, now: facts.now, askApproval: facts.askApproval }, args);
+    return {
+        async state() {
+            return onnxState();
+        },
+        async ensure(req) {
+            let state = onnxState();
+            // Approved before a restart cut the download short: it resumes, no second card.
+            if (state.state === 'absent' && onnxApproved()) {
+                void startOnnxDownload();
+                state = onnxState();
+            }
+            if (state.state === 'failed')
+                return state;
+            const model = req?.model;
+            // A shared model already kept, or downloading, needs no card of its own.
+            const shared = model !== undefined && (model.id !== undefined || model.files !== undefined);
+            let modelMissing = false;
+            if (shared) {
+                const checked = checkModelRequest({ id: model.id ?? '', files: model.files ?? [] });
+                const current = modelState(checked.id, checked.files);
+                if (current.state === 'failed')
+                    throw new ModelRefusal(current.reason ?? `Model ${checked.id} failed.`);
+                if (current.state === 'absent' && approvedModelFiles(checked.id, checked.files)) {
+                    void startModelDownload({ id: checked.id, files: checked.files }).catch(() => { });
+                }
+                else {
+                    modelMissing = current.state === 'absent';
+                }
+            }
+            if (state.state === 'downloading' && !modelMissing)
+                return state;
+            const engineMissing = state.state === 'absent';
+            // A model the plugin fetches itself rides on the engine's card; once the
+            // engine is here, it asks nothing more.
+            const forCard = shared ? (modelMissing ? model : undefined) : engineMissing ? model : undefined;
+            const args = downloadArgs(facts.plugin, req?.reason ?? '', engineMissing, forCard);
+            if (args === undefined)
+                return state;
+            return { ...state, pending: await card(args) };
+        },
+        async createSession(modelPath, opts) {
+            if (typeof modelPath !== 'string' || !path.isAbsolute(modelPath)) {
+                throw new TypeError('createSession takes an absolute path to a model file');
+            }
+            if (!within(modelPath, facts.dir()) && !within(modelPath, modelsRoot())) {
+                throw new OnnxUnavailable(`${facts.plugin} may open a model in its own directory or in buddi's shared models, not ${modelPath}.`);
+            }
+            const state = onnxState();
+            if (state.state !== 'ready') {
+                throw new OnnxUnavailable(state.reason ?? `The engine is ${state.state}; ask for it with ctx.buddi.onnx.ensure first.`);
+            }
+            const session = createOnnxSession(modelPath, opts ?? {});
+            // Only the plugin's part: the session's internals stay core's.
+            return {
+                run: (feeds) => session.run(feeds),
+                names: () => session.names(),
+                get loaded() {
+                    return session.loaded;
+                },
+                close: () => session.close(),
+            };
+        },
+    };
+}
+export function modelsAreaOf(facts) {
+    return {
+        async state(id) {
+            return modelState(id);
+        },
+        async ensure(req) {
+            const checked = checkModelRequest(req);
+            let current = modelState(checked.id, checked.files);
+            // Approved before a restart cut the download short: it resumes, no second card.
+            if (current.state === 'absent' && approvedModelFiles(checked.id, checked.files)) {
+                void startModelDownload({ id: checked.id, files: checked.files }).catch(() => { });
+                current = modelState(checked.id, checked.files);
+            }
+            if (current.state !== 'absent')
+                return { ...current, sizeBytes: current.sizeBytes || checked.bytes };
+            const args = downloadArgs(facts.plugin, req.reason, false, { id: checked.id, files: checked.files, ...(req.name ? { name: req.name } : {}) });
+            const pending = await raiseDownloadCard({ pool: facts.pool(), plugin: facts.plugin, agentId: facts.agentId, conversationId: facts.conversationId, now: facts.now, askApproval: facts.askApproval }, args);
+            return { ...current, sizeBytes: checked.bytes, pending };
+        },
+    };
+}
+//# sourceMappingURL=area.js.map

package/packages/core/dist/runtimes/area.js.map

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

package/packages/core/dist/runtimes/config.d.ts

@@ -0,0 +1,54 @@
+import { type EnvLike } from '../artifacts/store.js';
+import { type DownloadGet } from './download.js';
+import { type OnnxPin } from './pins.js';
+import type { OnnxNative } from './native.js';
+export interface RuntimesConfig {
+    env?: EnvLike;
+    /** How a download asks for a URL. `nodeGet()` unless a test points it at a local server. */
+    get?: DownloadGet;
+    platform?: string;
+    arch?: string;
+    /** The pin for a platform. `onnxPinFor` unless a test points it at a fixture. */
+    pinFor?: (platform: string, arch: string) => {
+        key: string;
+        pin: OnnxPin;
+    } | undefined;
+    /**
+     * Tests only: a fake binding run in this thread. Absent, the binding is
+     * opened with `process.dlopen` inside the engine's worker thread.
+     */
+    loadNative?: (dir: string, pin: OnnxPin) => OnnxNative;
+    /**
+     * Tests only: the engine's worker uses a fake binding written into it
+     * (`run` spins for its first input's milliseconds) instead of opening the
+     * real one, so a test can time the worker without native code.
+     */
+    fakeWorkerBinding?: boolean;
+    /** Where a background failure is logged. */
+    log?: (line: string) => void;
+    /** The most threads one session may ask for. Half the cores, at least 1, at most 8. */
+    maxThreads?: number;
+}
+/** Merge in what the caller owns. */
+export declare function configureRuntimes(more: RuntimesConfig): void;
+/** Forget it. Tests only. */
+export declare function resetRuntimesConfig(): void;
+export declare function runtimesConfig(): RuntimesConfig;
+export declare function runtimesEnv(): EnvLike;
+export declare function runtimesGet(): DownloadGet;
+export declare function runtimesLog(line: string): void;
+/** `<data>/runtimes`. */
+export declare function runtimesRoot(): string;
+/** `<data>/models`. */
+export declare function modelsRoot(): string;
+export declare function platformKey(): {
+    platform: string;
+    arch: string;
+    key: string;
+};
+export declare function currentPin(): {
+    key: string;
+    pin: OnnxPin;
+} | undefined;
+export declare function maxThreads(): number;
+//# sourceMappingURL=config.d.ts.map

package/packages/core/dist/runtimes/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/runtimes/config.ts"],"names":[],"mappings":"AASA,OAAO,EAAkB,KAAK,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAW,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAc,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,4FAA4F;IAC5F,GAAG,CAAC,EAAE,WAAW,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iFAAiF;IACjF,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS,CAAC;IACvF;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,KAAK,UAAU,CAAC;IACvD;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,4CAA4C;IAC5C,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,uFAAuF;IACvF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAID,qCAAqC;AACrC,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAE5D;AAED,6BAA6B;AAC7B,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED,wBAAgB,cAAc,IAAI,cAAc,CAE/C;AAED,wBAAgB,WAAW,IAAI,OAAO,CAErC;AAID,wBAAgB,WAAW,IAAI,WAAW,CAEzC;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE9C;AAED,yBAAyB;AACzB,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,uBAAuB;AACvB,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,wBAAgB,WAAW,IAAI;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAI7E;AAED,wBAAgB,UAAU,IAAI;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,CAGtE;AAED,wBAAgB,UAAU,IAAI,MAAM,CAGnC"}

package/packages/core/dist/runtimes/config.js

@@ -0,0 +1,57 @@
+/**
+ * What the runtimes area reads from its process: where the data directory is,
+ * how to fetch, which platform this is, how the native binding is opened.
+ * The composition root sets `env`; tests hand in a fetch over a local server,
+ * a platform and pins of their own, and a fake binding, so no test reaches the
+ * network or loads native code.
+ */
+import { cpus } from 'node:os';
+import path from 'node:path';
+import { resolveDataDir } from '../artifacts/store.js';
+import { nodeGet } from './download.js';
+import { onnxPinFor } from './pins.js';
+let config = {};
+/** Merge in what the caller owns. */
+export function configureRuntimes(more) {
+    config = { ...config, ...more };
+}
+/** Forget it. Tests only. */
+export function resetRuntimesConfig() {
+    config = {};
+}
+export function runtimesConfig() {
+    return config;
+}
+export function runtimesEnv() {
+    return config.env ?? process.env;
+}
+let defaultGet;
+export function runtimesGet() {
+    return config.get ?? (defaultGet ??= nodeGet());
+}
+export function runtimesLog(line) {
+    (config.log ?? ((text) => console.error(text)))(`[runtimes] ${line}`);
+}
+/** `<data>/runtimes`. */
+export function runtimesRoot() {
+    return path.join(resolveDataDir(runtimesEnv()), 'runtimes');
+}
+/** `<data>/models`. */
+export function modelsRoot() {
+    return path.join(resolveDataDir(runtimesEnv()), 'models');
+}
+export function platformKey() {
+    const platform = config.platform ?? process.platform;
+    const arch = config.arch ?? process.arch;
+    return { platform, arch, key: `${platform}-${arch}` };
+}
+export function currentPin() {
+    const { platform, arch } = platformKey();
+    return (config.pinFor ?? onnxPinFor)(platform, arch);
+}
+export function maxThreads() {
+    if (config.maxThreads !== undefined)
+        return Math.max(1, Math.floor(config.maxThreads));
+    return Math.min(8, Math.max(1, Math.floor(cpus().length / 2)));
+}
+//# sourceMappingURL=config.js.map

package/packages/core/dist/runtimes/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/runtimes/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC/B,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAgB,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAE,OAAO,EAAoB,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAgB,MAAM,WAAW,CAAC;AA4BrD,IAAI,MAAM,GAAmB,EAAE,CAAC;AAEhC,qCAAqC;AACrC,MAAM,UAAU,iBAAiB,CAAC,IAAoB;IACpD,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC;AAClC,CAAC;AAED,6BAA6B;AAC7B,MAAM,UAAU,mBAAmB;IACjC,MAAM,GAAG,EAAE,CAAC;AACd,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,MAAM,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;AACnC,CAAC;AAED,IAAI,UAAmC,CAAC;AAExC,MAAM,UAAU,WAAW;IACzB,OAAO,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,KAAK,OAAO,EAAE,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC;AAChF,CAAC;AAED,yBAAyB;AACzB,MAAM,UAAU,YAAY;IAC1B,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,WAAW,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC;AAC9D,CAAC;AAED,uBAAuB;AACvB,MAAM,UAAU,UAAU;IACxB,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,WAAW,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;IACrD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IACzC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,QAAQ,IAAI,IAAI,EAAE,EAAE,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,WAAW,EAAE,CAAC;IACzC,OAAO,CAAC,MAAM,CAAC,MAAM,IAAI,UAAU,CAAC,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;IACvF,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACjE,CAAC"}

package/packages/core/dist/runtimes/consent.d.ts

@@ -0,0 +1,170 @@
+/**
+ * The one card behind a local-model download (docs/plugin-host-api.md §4.2
+ * `onnx`, 1.32).
+ *
+ * A plugin asks with `ctx.buddi.onnx.ensure({ reason, model })` or
+ * `ctx.buddi.models.ensure(...)`; nothing is fetched until the owner says
+ * yes. The card covers what is missing in one question — "Download the
+ * Whisper base model (135 MB) and the engine that runs it (114 MB)?" — and
+ * approving it runs core's own `runtimes.download`, which starts both
+ * downloads. An engine that is already there is not asked about again, so a
+ * second plugin that only needs the engine gets no card.
+ *
+ * The card is an ordinary action on the existing path (`createAction`), the
+ * way an owner secret's use is: it reaches every surface the owner decides
+ * on. While one is pending for the same thing, asking again answers that card
+ * instead of raising another.
+ */
+import type { Pool } from 'pg';
+import { z } from 'zod';
+import type { ActionRecord } from '../actions/types.js';
+import type { EffectDescription, PluginManifest } from '../tools.js';
+import { type ModelFile } from './models.js';
+export declare const RUNTIMES_PLUGIN = "runtimes";
+export declare const RUNTIMES_TOOL = "runtimes.download";
+export declare const RUNTIMES_TOOL_VERSION = "1.0.0";
+declare const input: z.ZodObject<{
+    /** What the card is about, so a second ask for the same thing finds it. */
+    key: z.ZodString;
+    plugin: z.ZodString;
+    reason: z.ZodString;
+    engine: z.ZodOptional<z.ZodObject<{
+        version: z.ZodString;
+        platform: z.ZodString;
+        downloadBytes: z.ZodNumber;
+        sizeBytes: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        version: string;
+        sizeBytes: number;
+        platform: string;
+        downloadBytes: number;
+    }, {
+        version: string;
+        sizeBytes: number;
+        platform: string;
+        downloadBytes: number;
+    }>>;
+    model: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        bytes: z.ZodNumber;
+        /** A shared model core downloads into `models/<id>/`. */
+        id: z.ZodOptional<z.ZodString>;
+        files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+            sha256: z.ZodString;
+            bytes: z.ZodNumber;
+            name: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            name: string;
+            sha256: string;
+            bytes: number;
+            url: string;
+        }, {
+            name: string;
+            sha256: string;
+            bytes: number;
+            url: string;
+        }>, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        name: string;
+        bytes: number;
+        id?: string | undefined;
+        files?: {
+            name: string;
+            sha256: string;
+            bytes: number;
+            url: string;
+        }[] | undefined;
+    }, {
+        name: string;
+        bytes: number;
+        id?: string | undefined;
+        files?: {
+            name: string;
+            sha256: string;
+            bytes: number;
+            url: string;
+        }[] | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    plugin: string;
+    reason: string;
+    key: string;
+    engine?: {
+        version: string;
+        sizeBytes: number;
+        platform: string;
+        downloadBytes: number;
+    } | undefined;
+    model?: {
+        name: string;
+        bytes: number;
+        id?: string | undefined;
+        files?: {
+            name: string;
+            sha256: string;
+            bytes: number;
+            url: string;
+        }[] | undefined;
+    } | undefined;
+}, {
+    plugin: string;
+    reason: string;
+    key: string;
+    engine?: {
+        version: string;
+        sizeBytes: number;
+        platform: string;
+        downloadBytes: number;
+    } | undefined;
+    model?: {
+        name: string;
+        bytes: number;
+        id?: string | undefined;
+        files?: {
+            name: string;
+            sha256: string;
+            bytes: number;
+            url: string;
+        }[] | undefined;
+    } | undefined;
+}>;
+export type RuntimesDownload = z.infer<typeof input>;
+/** The card's question, and what it will do. Deterministic in its arguments. */
+export declare function describeRuntimesDownload(args: RuntimesDownload): EffectDescription;
+/** Core's manifest for the approval tool. Registered by the gateway beside the other core families. */
+export declare function createRuntimesManifest(): PluginManifest;
+/** What a plugin hands `ensure` about its model. */
+export interface EnsureModel {
+    /** How the owner reads it: "Whisper base model". */
+    name?: string;
+    /** Its size, when the plugin downloads it itself. */
+    bytes?: number;
+    /** A shared model core downloads (`models.ensure`'s `id` and `files`). */
+    id?: string;
+    files?: readonly ModelFile[];
+}
+export interface CardFacts {
+    pool: Pool;
+    plugin: string;
+    agentId?: string | undefined;
+    conversationId?: string | undefined;
+    now: () => Date;
+    /** Tells the owner's channels (Telegram, push) a card is waiting; the composition root's. */
+    askApproval?: ((action: ActionRecord) => Promise<void>) | undefined;
+}
+/**
+ * The arguments of the card for what is missing, or undefined when nothing is.
+ * `engine` is whether the engine must come too. Throws a `ModelRefusal` for a
+ * model that is not one.
+ */
+export declare function downloadArgs(plugin: string, reason: string, engine: boolean, model: EnsureModel | undefined): RuntimesDownload | undefined;
+/**
+ * Raise the card, or answer the one already pending for the same thing.
+ * Answers the action id. The lookup and the insert run under one advisory
+ * lock in one transaction, so two plugins asking in the same tick (speech and
+ * news at boot) get one card between them, not two.
+ */
+export declare function raiseDownloadCard(facts: CardFacts, args: RuntimesDownload): Promise<string>;
+export {};
+//# sourceMappingURL=consent.d.ts.map

package/packages/core/dist/runtimes/consent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consent.d.ts","sourceRoot":"","sources":["../../src/runtimes/consent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,IAAI,CAAC;AAC3C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAmB,iBAAiB,EAAE,cAAc,EAAkB,MAAM,aAAa,CAAC;AAEtG,OAAO,EAA4D,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAGvG,eAAO,MAAM,eAAe,aAAa,CAAC;AAC1C,eAAO,MAAM,aAAa,sBAAsB,CAAC;AACjD,eAAO,MAAM,qBAAqB,UAAU,CAAC;AAM7C,QAAA,MAAM,KAAK;IAEP,2EAA2E;;;;;;;;;;;;;;;;;;;;;;;QAYvE,yDAAyD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOtD,CAAC;AAEZ,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,KAAK,CAAC,CAAC;AAErD,gFAAgF;AAChF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,gBAAgB,GAAG,iBAAiB,CA6BlF;AAkCD,uGAAuG;AACvG,wBAAgB,sBAAsB,IAAI,cAAc,CAQvD;AAED,oDAAoD;AACpD,MAAM,WAAW,WAAW;IAC1B,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,GAAG,EAAE,MAAM,IAAI,CAAC;IAChB,6FAA6F;IAC7F,WAAW,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC;CACrE;AAID;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,gBAAgB,GAAG,SAAS,CAkB1I;AAUD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAI3F"}