@bendyline/gezel-inference 1.0.6 → 1.0.8

package/dist/engines/native-manifest.d.ts

@@ -40,12 +40,12 @@
  * but logs that it could not anchor to a baked-in digest.
  */
 /** Native release version this build pins. Placeholder until first public release. */
-export declare const NATIVE_ENGINE_RELEASE = "0.1.54";
+export declare const NATIVE_ENGINE_RELEASE = "0.1.57";
 /** sha256 of the pinned release's `SHA256SUMS` asset. All-zeros = unpinned. */
-export declare const SHA256SUMS_DIGEST = "087215a12096127a779b20e0dcb7d2ed9ce5dda1c81f33fdeb6b6eb730485b20";
-/** Exact SHA256 values for every engine archive published by native-v0.1.54. */
+export declare const SHA256SUMS_DIGEST = "977b0ad4cdb8983ed44d7a3223267038b1f35b2806d8a1807d7d15c5c7e94f47";
+/** Exact SHA256 values for every engine archive published by native-v0.1.57. */
 export declare const NATIVE_ENGINE_ARCHIVE_SHA256: Readonly<Record<string, string>>;
-/** Download size in bytes of every engine archive published by native-v0.1.54. */
+/** Download size in bytes of every engine archive published by native-v0.1.57. */
 export declare const NATIVE_ENGINE_ARCHIVE_BYTES: Readonly<Record<string, number>>;
 /**
  * True only when the pinned release's standalone macOS archives were

package/dist/engines/native-manifest.js

@@ -40,47 +40,47 @@
  * but logs that it could not anchor to a baked-in digest.
  */
 /** Native release version this build pins. Placeholder until first public release. */
-export const NATIVE_ENGINE_RELEASE = '0.1.54';
+export const NATIVE_ENGINE_RELEASE = '0.1.57';
 /** sha256 of the pinned release's `SHA256SUMS` asset. All-zeros = unpinned. */
-export const SHA256SUMS_DIGEST = '087215a12096127a779b20e0dcb7d2ed9ce5dda1c81f33fdeb6b6eb730485b20';
+export const SHA256SUMS_DIGEST = '977b0ad4cdb8983ed44d7a3223267038b1f35b2806d8a1807d7d15c5c7e94f47';
 // BEGIN PINNED NATIVE ARCHIVE HASHES
-/** Exact SHA256 values for every engine archive published by native-v0.1.54. */
+/** Exact SHA256 values for every engine archive published by native-v0.1.57. */
 export const NATIVE_ENGINE_ARCHIVE_SHA256 = Object.freeze({
-    'gezel-native-0.1.54-darwin-arm64-metal.tar.gz': 'f2990970303b954af2fd2e2bd31efef7d1c231bea16e026e0cdc0a7f9cc17842',
-    'gezel-native-0.1.54-darwin-arm64.tar.gz': '850f28338c52f945996c55edd77cf14d451c9bc4a09f719f6608885ddab99687',
-    'gezel-native-0.1.54-linux-arm64-cpu.tar.gz': '7dac7fed45c46b591cd6d597d639c385f54a3a367ac15d6097d3ad04d9c3c6e6',
-    'gezel-native-0.1.54-linux-arm64-cuda.tar.gz': 'f73c4569c356c4584199513c6c1f1f0bd3f0151fb1845696e2fa43f2b3626803',
-    'gezel-native-0.1.54-linux-arm64.tar.gz': 'f034ad2d3d12165c979d2fff2d34752c8d4f8ff836d3c416c9c64535f3bb652b',
-    'gezel-native-0.1.54-linux-x64-cpu.tar.gz': '57de7d52b0e95e3886bf4ffad7e015b98ba8bbea96b95d8cb3e26bc1ff309e99',
-    'gezel-native-0.1.54-linux-x64-cuda.tar.gz': 'c2d8616410f72b8bb217194f7c71d5175ed1c94ac6d9d94f660e0f535a3cff22',
-    'gezel-native-0.1.54-linux-x64-vulkan.tar.gz': '89f3233f41861404db082219962eb25d1b2c3f6e42bbc2696fda122ce845371d',
-    'gezel-native-0.1.54-linux-x64.tar.gz': 'f42e42d71187c6ef5af9685ebb65511bb7ac638815105f09f3df22cfdb9e6bce',
-    'gezel-native-0.1.54-win32-arm64-cpu.zip': 'e482e2af92f28135aea2e21ae97290e231b0dc77eadc8cc532d2506304d27575',
-    'gezel-native-0.1.54-win32-arm64-cuda.zip': 'ff6eaf7f070e9aba7fc087a155896f73b12664d867e0374af5546e941c153b82',
-    'gezel-native-0.1.54-win32-arm64.zip': '9b854d824117fe56d7d532ab83c01693a97cf6b45752e69cb895aa183c8cff35',
-    'gezel-native-0.1.54-win32-x64-cpu.zip': '93c8f22b47831ba8e0808033e87ce91cdb0d481890602857b6b8b5295cc7d50b',
-    'gezel-native-0.1.54-win32-x64-cuda.zip': '84da0b362e502d0bb6e3509528e7a4ccff50c2b9fcaa2fa1a62b3d9b0ad9f5d2',
-    'gezel-native-0.1.54-win32-x64-vulkan.zip': '1a3c99ce8343552fb17af80c36ba8ebb7c13ac8d6b4966f3aa3054018d41fa11',
-    'gezel-native-0.1.54-win32-x64.zip': 'f224fcdea6945ce574d32bee6ace345f82847f317c40cfa9059feba9b87ac0ca',
+    'gezel-native-0.1.57-darwin-arm64-metal.tar.gz': '6b97be648b032980cf73663db4424140f4cc04577972dc283b956af677ce884a',
+    'gezel-native-0.1.57-darwin-arm64.tar.gz': 'e8ca070c4d3961e95946ed32fe7376ddbc97e407dd3f5b78e26cab20c8fb286a',
+    'gezel-native-0.1.57-linux-arm64-cpu.tar.gz': 'cc87822123602a0024c63a0d65789232a665140cb2fe37b106d5bd680d12f795',
+    'gezel-native-0.1.57-linux-arm64-cuda.tar.gz': '315a441e5698800945f7030e9da961e20f3cf379a4b75c98e1d6ba88c8fee1c5',
+    'gezel-native-0.1.57-linux-arm64.tar.gz': '0684b77d23f008f8a2aa0d9d8931437bacd8569fb6c10d3ddab61a5fb25b6a06',
+    'gezel-native-0.1.57-linux-x64-cpu.tar.gz': 'b2100842f51c393b92667535798e49932173d52626f5ae72c40005b3408f1201',
+    'gezel-native-0.1.57-linux-x64-cuda.tar.gz': '2fca7720614687e8491be17366060c604551257199d395f795b27a87216bcde9',
+    'gezel-native-0.1.57-linux-x64-vulkan.tar.gz': 'c1014a1fe1d241ad1ee9abfa5badafcce208cbff8d38b4b4deb4779f31a95bef',
+    'gezel-native-0.1.57-linux-x64.tar.gz': 'a7f3dbe1941c3d03ed121c32be1bdd199aea47080b03d89989590a0f5d13c5ff',
+    'gezel-native-0.1.57-win32-arm64-cpu.zip': '12d66681cec1872f23b015c7d0bd45a25ed262342da6b0ecea8bea303adf2105',
+    'gezel-native-0.1.57-win32-arm64-cuda.zip': 'b437a9f0894673179f91a1af75d5d7d058dafa1b4f48a57eab123596f1c21ca4',
+    'gezel-native-0.1.57-win32-arm64.zip': '21cddb8b733f9a2669d64b1ada18002f60bb2779f2d5e2aacfb88214db00da7e',
+    'gezel-native-0.1.57-win32-x64-cpu.zip': 'a81f7c6754f1954a0ed5de1efc47d6194dc60d912138a9d2b8e4f992168b12c6',
+    'gezel-native-0.1.57-win32-x64-cuda.zip': '9e3f21713fe77c23536dd4124244ac3834f90c82d6e470cb6836a73bb4f7c592',
+    'gezel-native-0.1.57-win32-x64-vulkan.zip': '0d473300317b4f6cb072bdd7875ce1536a85fe50e781c435e1aef1c4cbdb08e5',
+    'gezel-native-0.1.57-win32-x64.zip': '89a073abcfc97e50b9a0c39f56862b51ac21139b7ca4a3e7a75105dca56292a2',
 });
-/** Download size in bytes of every engine archive published by native-v0.1.54. */
+/** Download size in bytes of every engine archive published by native-v0.1.57. */
 export const NATIVE_ENGINE_ARCHIVE_BYTES = Object.freeze({
-    'gezel-native-0.1.54-darwin-arm64-metal.tar.gz': 7056387,
-    'gezel-native-0.1.54-darwin-arm64.tar.gz': 42224129,
-    'gezel-native-0.1.54-linux-arm64-cpu.tar.gz': 8838944,
-    'gezel-native-0.1.54-linux-arm64-cuda.tar.gz': 620429935,
-    'gezel-native-0.1.54-linux-arm64.tar.gz': 42037092,
-    'gezel-native-0.1.54-linux-x64-cpu.tar.gz': 12914025,
-    'gezel-native-0.1.54-linux-x64-cuda.tar.gz': 993587032,
-    'gezel-native-0.1.54-linux-x64-vulkan.tar.gz': 25672135,
-    'gezel-native-0.1.54-linux-x64.tar.gz': 57185943,
-    'gezel-native-0.1.54-win32-arm64-cpu.zip': 5623741,
-    'gezel-native-0.1.54-win32-arm64-cuda.zip': 242341587,
-    'gezel-native-0.1.54-win32-arm64.zip': 42236457,
-    'gezel-native-0.1.54-win32-x64-cpu.zip': 8719660,
-    'gezel-native-0.1.54-win32-x64-cuda.zip': 749849595,
-    'gezel-native-0.1.54-win32-x64-vulkan.zip': 21128362,
-    'gezel-native-0.1.54-win32-x64.zip': 55668353,
+    'gezel-native-0.1.57-darwin-arm64-metal.tar.gz': 7387963,
+    'gezel-native-0.1.57-darwin-arm64.tar.gz': 42223786,
+    'gezel-native-0.1.57-linux-arm64-cpu.tar.gz': 9223249,
+    'gezel-native-0.1.57-linux-arm64-cuda.tar.gz': 621626283,
+    'gezel-native-0.1.57-linux-arm64.tar.gz': 42040003,
+    'gezel-native-0.1.57-linux-x64-cpu.tar.gz': 13398337,
+    'gezel-native-0.1.57-linux-x64-cuda.tar.gz': 1000325316,
+    'gezel-native-0.1.57-linux-x64-vulkan.tar.gz': 26290440,
+    'gezel-native-0.1.57-linux-x64.tar.gz': 57190295,
+    'gezel-native-0.1.57-win32-arm64-cpu.zip': 6049234,
+    'gezel-native-0.1.57-win32-arm64-cuda.zip': 243595554,
+    'gezel-native-0.1.57-win32-arm64.zip': 42236484,
+    'gezel-native-0.1.57-win32-x64-cpu.zip': 9131460,
+    'gezel-native-0.1.57-win32-x64-cuda.zip': 756439338,
+    'gezel-native-0.1.57-win32-x64-vulkan.zip': 21673895,
+    'gezel-native-0.1.57-win32-x64.zip': 55668381,
 });
 // END PINNED NATIVE ARCHIVE HASHES
 /**

package/dist/engines/resolver.js

@@ -33,6 +33,7 @@ const ENGINE_ENV_VAR = {
     uv: 'GEZEL_UV_BIN',
     duckdb: 'GEZEL_DUCKDB_BIN',
     'apple-fm': 'GEZEL_APPLE_FM_BIN',
+    sandbox: 'GEZEL_SANDBOX_BIN',
 };
 /**
  * Thrown for the "can't resolve, and that's expected/actionable" cases:

package/dist/http/auth-context.d.ts

@@ -18,6 +18,18 @@ declare module 'hono' {
             projectId?: string;
             gezelId?: string;
             team?: boolean;
+            /**
+             * The signed-in account behind an account session (ADR 0029, the
+             * principal from ADR 0004). Absent for app, device and owner
+             * credentials.
+             */
+            account?: {
+                id: string;
+                source: 'password' | 'device' | 'os';
+                label: string;
+            };
+            /** The account session this request came in on, for "sign out this browser". */
+            accountSessionId?: string;
         };
     }
 }

package/dist/http/routes/image-ensure-routes.d.ts

@@ -0,0 +1,4 @@
+import type { Hono } from 'hono';
+import type { ImageModelPullRegistry } from '../../providers/image/pull-registry.js';
+/** One resumable download protocol, with separate registries for models and styles. */
+export declare function registerImageEnsureRoutes(app: Hono, prefix: string, pulls: ImageModelPullRegistry, qualified: (id: string) => string): void;

package/dist/http/routes/image-ensure-routes.js

@@ -0,0 +1,102 @@
+import { streamSSE } from 'hono/streaming';
+function apiError(code, message) {
+    return { error: { message, type: 'invalid_request_error', code } };
+}
+function ensureEvent(jobId, event, totalBytes, qualified) {
+    const job = { jobId, modelId: qualified(jobId) };
+    switch (event.type) {
+        case 'progress':
+            return {
+                ...job,
+                type: 'progress',
+                bytesWritten: event.bytesWritten,
+                totalBytes: event.totalBytes ?? totalBytes,
+            };
+        case 'retrying':
+            return {
+                ...job,
+                type: 'retrying',
+                attempt: event.attempt,
+                maxAttempts: event.maxAttempts,
+                delayMs: event.delayMs,
+                reason: event.reason,
+            };
+        case 'error':
+            return { ...job, type: 'error', error: event.error };
+        case 'done':
+            return { ...job, type: 'done' };
+    }
+}
+function pullStatus(pull) {
+    if (!pull.finished)
+        return 'running';
+    return pull.error ? 'error' : 'done';
+}
+/** One resumable download protocol, with separate registries for models and styles. */
+export function registerImageEnsureRoutes(app, prefix, pulls, qualified) {
+    app.get(`${prefix}/:jobId`, (c) => {
+        const pull = pulls.get(c.req.param('jobId'));
+        if (!pull)
+            return c.json(apiError('job_not_found', 'job not found'), 404);
+        return c.json({
+            job_id: pull.id,
+            model_id: qualified(pull.id),
+            status: pullStatus(pull),
+            started_at: Date.parse(pull.startedAt),
+            bytes_written: pull.bytesWritten,
+            total_bytes: pull.totalBytes,
+            ...(pull.error ? { error: pull.error } : {}),
+        });
+    });
+    app.get(`${prefix}/:jobId/events`, (c) => {
+        const jobId = c.req.param('jobId');
+        const snapshot = pulls.get(jobId);
+        if (!snapshot)
+            return c.json(apiError('job_not_found', 'job not found'), 404);
+        return streamSSE(c, async (stream) => {
+            let closed = false;
+            let sawError = false;
+            const unsubscribe = pulls.subscribe(jobId, (event) => {
+                // A failed pull ends with an error and then its done; the error is terminal.
+                if (sawError)
+                    return;
+                if (event.type === 'error')
+                    sawError = true;
+                const terminal = event.type === 'done' || event.type === 'error';
+                void stream
+                    .writeSSE({
+                    data: JSON.stringify(ensureEvent(jobId, event, snapshot.totalBytes, qualified)),
+                })
+                    .then(() => {
+                    if (terminal)
+                        closed = true;
+                })
+                    .catch(() => {
+                    closed = true;
+                });
+            });
+            if (!unsubscribe)
+                return;
+            stream.onAbort(() => {
+                closed = true;
+                unsubscribe();
+            });
+            while (!closed) {
+                await stream.sleep(1000);
+                try {
+                    await stream.writeSSE({ event: 'ping', data: '' });
+                }
+                catch {
+                    closed = true;
+                }
+            }
+            unsubscribe();
+        });
+    });
+    app.delete(`${prefix}/:jobId`, (c) => {
+        if (!pulls.cancel(c.req.param('jobId'))) {
+            return c.json(apiError('job_not_found', 'No download in progress for that job'), 404);
+        }
+        return c.json({ cancelled: true });
+    });
+}

package/dist/http/routes/v1-image-styles.d.ts

@@ -0,0 +1,5 @@
+import { Hono } from 'hono';
+import type { ImageModelPullRegistry } from '../../providers/image/pull-registry.js';
+import type { ImagesRouteContext } from './v1-images.js';
+/** App-scoped access to catalog LoRAs; no paths, URLs or engine arguments from callers. */
+export declare function v1ImageStylesRoutes(ctx: ImagesRouteContext, pulls: ImageModelPullRegistry): Hono;

package/dist/http/routes/v1-image-styles.js

@@ -0,0 +1,91 @@
+import { Hono } from 'hono';
+import { z } from 'zod';
+import { isSafeModelId } from '../../models/model-id.js';
+import { registerImageEnsureRoutes } from './image-ensure-routes.js';
+const styleId = z.string().min(1).max(512).refine(isSafeModelId);
+const ensureRequest = z.object({ style: styleId }).strict();
+const apiError = (code, message) => ({
+    error: { code, message, type: 'invalid_request_error' },
+});
+/** App-scoped access to catalog LoRAs; no paths, URLs or engine arguments from callers. */
+export function v1ImageStylesRoutes(ctx, pulls) {
+    const app = new Hono();
+    app.get('/', async (c) => {
+        const provider = await ctx.images.current();
+        if (!provider.listLoras || !provider.pullLora || !provider.deleteLora) {
+            return c.json(apiError('styles_unsupported', 'Update Gezel to add image styles.'), 409);
+        }
+        const [installed, catalog] = await Promise.all([
+            provider.listLoras(),
+            ctx.catalog.list('image-lora'),
+        ]);
+        const data = [];
+        for (const item of catalog) {
+            const m = item.manifest;
+            if (m.kind !== 'image-lora' || m.purpose !== 'style')
+                continue;
+            data.push({
+                id: m.id,
+                object: 'image_style',
+                name: m.name,
+                description: m.description,
+                availability: installed.some((l) => l.id === m.id)
+                    ? 'available'
+                    : pulls.get(m.id)?.finished === false
+                        ? 'downloading'
+                        : 'download-required',
+                base_models: m.baseModels.map((id) => `sd-cpp:${id}`),
+                download_bytes: m.approxSizeBytes,
+                ...((m.licenseShortName ?? m.license) ? { license: m.licenseShortName ?? m.license } : {}),
+                commercial_use: m.commercialUse,
+                ...(m.licenseUrl ? { license_url: m.licenseUrl } : {}),
+            });
+        }
+        for (const l of installed) {
+            if (l.purpose !== 'style' || data.some((s) => s.id === l.id))
+                continue;
+            data.push({
+                id: l.id,
+                object: 'image_style',
+                name: l.name,
+                availability: 'available',
+                download_bytes: l.approxSizeBytes,
+                base_models: l.baseModels.map((id) => `sd-cpp:${id}`),
+            });
+        }
+        return c.json({ object: 'list', data });
+    });
+    app.post('/ensure', async (c) => {
+        const { style } = ensureRequest.parse(await c.req.json());
+        const provider = await ctx.images.current();
+        if (!provider.listLoras || !provider.pullLora)
+            return c.json(apiError('styles_unsupported', 'Update Gezel to add image styles.'), 409);
+        const installed = await provider.listLoras();
+        if (installed.some((l) => l.id === style && l.purpose === 'style'))
+            return c.json({ status: 'ready', model_id: style });
+        const item = await ctx.catalog.get('image-lora', style);
+        if (item?.manifest.kind !== 'image-lora' || item.manifest.purpose !== 'style')
+            return c.json(apiError('unknown_style', 'That style is not in the catalog.'), 404);
+        const models = await provider.listInstalledModels();
+        if (!models.some((model) => item.manifest.kind === 'image-lora' && item.manifest.baseModels.includes(model.id))) {
+            return c.json(apiError('style_model_required', 'Download a compatible image model before adding this style.'), 409);
+        }
+        await pulls.start(style);
+        return c.json({ status: 'downloading', model_id: style, job_id: style }, 202);
+    });
+    registerImageEnsureRoutes(app, '/ensure', pulls, (id) => id);
+    app.delete('/:id', async (c) => {
+        const id = styleId.parse(c.req.param('id'));
+        if (pulls.get(id)?.finished === false)
+            return c.json(apiError('style_downloading', 'Cancel the style download before removing it.'), 409);
+        await ctx.images.reset();
+        const provider = await ctx.images.current();
+        if (!provider.deleteLora || !provider.listLoras)
+            return c.json(apiError('styles_unsupported', 'Update Gezel to manage image styles.'), 409);
+        if (!(await provider.listLoras()).some((l) => l.id === id && l.purpose === 'style'))
+            return c.json(apiError('unknown_style', 'That style is not installed.'), 404);
+        await provider.deleteLora(id);
+        return c.body(null, 204);
+    });
+    return app;
+}

package/dist/http/routes/v1-images.d.ts

@@ -16,6 +16,7 @@ export interface ImagesRouteContext {
         /** Stop the engine, draining renders, before its model files change. */
         reset(): Promise<void>;
         pulls: ImageModelPullRegistry;
+        loraPulls?: ImageModelPullRegistry;
     };
 }
 /**
@@ -24,7 +25,8 @@ export interface ImagesRouteContext {
  *   GET    /models                   Installed and downloadable image models,
  *                                    with this machine's fit. Never part of
  *                                    `/v1/models`, so chat pickers never
- *                                    offer them.
+ *                                    offer them. Models that only change a
+ *                                    given picture are left out.
  *   POST   /models/ensure            `{model: "sd-cpp:<id>"}` → ready, or a
  *                                    background download (`job_id`).
  *   GET    /models/ensure/:jobId     Snapshot of a download.

package/dist/http/routes/v1-images.js

@@ -4,8 +4,11 @@ import { streamSSE } from 'hono/streaming';
 import { z } from 'zod';
 import { imageCatalogFits, imageModelFit, wontRunRefusal } from '../../models/image-fit.js';
 import { ReadOnlyModelError, modelExistsOnlyReadOnly, modelStorageRoots, } from '../../models/storage-roots.js';
+import { resolveImageEditCapability } from '../../providers/image/img2img-support.js';
 import { NoLocalImageModelError } from '../../providers/image/local-factory.js';
-import { ImageCapacityError, ImageGenerationCancelledError, } from '../../providers/image/types.js';
+import { ImageCapacityError, ImageGenerationCancelledError, ImageSourceRequiredError, } from '../../providers/image/types.js';
+import { registerImageEnsureRoutes } from './image-ensure-routes.js';
+import { v1ImageStylesRoutes } from './v1-image-styles.js';
 const log = createLogger('v1-images');
 /** The one local image engine this host serves. */
 const ENGINE = 'sd-cpp';
@@ -26,6 +29,17 @@ function catalogIdOf(model) {
 function qualified(catalogId) {
     return `${ENGINE}:${catalogId}`;
 }
+/**
+ * Made only to change a picture it is given. Generations here take no source
+ * picture, so such a model can never render one: it is left out of the list
+ * and refused by name, never handed a blank page.
+ */
+function editsOnly(modelId, declared) {
+    return resolveImageEditCapability({ modelId, editOnly: declared }).editOnly;
+}
+function editOnlyError(name) {
+    return apiError('edit_only_model', `${name} only changes a picture it is given and cannot draw a new one. Pick another image model.`);
+}
 function downloadBytes(manifest) {
     return (manifest.approxSizeBytes + manifest.auxiliaryFiles.reduce((n, f) => n + f.approxSizeBytes, 0));
 }
@@ -36,6 +50,7 @@ function describeManifest(manifest) {
         description: manifest.description,
         download_bytes: downloadBytes(manifest),
         ...(license ? { license } : {}),
+        ...(manifest.licenseUrl ? { license_url: manifest.licenseUrl } : {}),
         commercial_use: manifest.commercialUse,
         ...(manifest.rendersText !== undefined ? { renders_text: manifest.rendersText } : {}),
         ...(manifest.promptStyle ? { prompt_style: manifest.promptStyle } : {}),
@@ -49,36 +64,6 @@ function describeManifest(manifest) {
             : {}),
     };
 }
-function ensureEvent(jobId, event, totalBytes) {
-    const job = { jobId, modelId: qualified(jobId) };
-    switch (event.type) {
-        case 'progress':
-            return {
-                ...job,
-                type: 'progress',
-                bytesWritten: event.bytesWritten,
-                totalBytes: event.totalBytes ?? totalBytes,
-            };
-        case 'retrying':
-            return {
-                ...job,
-                type: 'retrying',
-                attempt: event.attempt,
-                maxAttempts: event.maxAttempts,
-                delayMs: event.delayMs,
-                reason: event.reason,
-            };
-        case 'error':
-            return { ...job, type: 'error', error: event.error };
-        case 'done':
-            return { ...job, type: 'done' };
-    }
-}
-function pullStatus(pull) {
-    if (!pull.finished)
-        return 'running';
-    return pull.error ? 'error' : 'done';
-}
 function generationError(err) {
     const message = err instanceof Error ? err.message : String(err);
     if (err instanceof ImageGenerationCancelledError)
@@ -87,6 +72,8 @@ function generationError(err) {
         return { code: err.code, message };
     if (err instanceof NoLocalImageModelError)
         return { code: err.code, message };
+    if (err instanceof ImageSourceRequiredError)
+        return { code: err.code, message };
     const code = err?.code;
     if (code === 'capacity-denied')
         return { code: 'capacity_denied', message };
@@ -98,7 +85,8 @@ function generationError(err) {
  *   GET    /models                   Installed and downloadable image models,
  *                                    with this machine's fit. Never part of
  *                                    `/v1/models`, so chat pickers never
- *                                    offer them.
+ *                                    offer them. Models that only change a
+ *                                    given picture are left out.
  *   POST   /models/ensure            `{model: "sd-cpp:<id>"}` → ready, or a
  *                                    background download (`job_id`).
  *   GET    /models/ensure/:jobId     Snapshot of a download.
@@ -117,6 +105,8 @@ function generationError(err) {
  */
 export function v1ImagesRoutes(ctx) {
     const app = new Hono();
+    if (ctx.images.loraPulls)
+        app.route('/styles', v1ImageStylesRoutes(ctx, ctx.images.loraPulls));
     const fitContext = { catalog: ctx.catalog, readConfig: () => ctx.store.readConfig() };
     app.get('/models', async (c) => {
         const provider = await ctx.images.current();
@@ -142,6 +132,8 @@ export function v1ImagesRoutes(ctx) {
             if (manifest.kind !== 'image-model')
                 continue;
             seen.add(manifest.id);
+            if (editsOnly(manifest.id, manifest.editOnly))
+                continue;
             const fit = fitById.get(manifest.id);
             const isInstalled = installedIds.has(manifest.id);
             data.push({
@@ -162,7 +154,7 @@ export function v1ImagesRoutes(ctx) {
         }
         // Installed models the catalog no longer lists still render.
         for (const model of installed) {
-            if (seen.has(model.id))
+            if (seen.has(model.id) || editsOnly(model.id, model.editOnly))
                 continue;
             data.push({
                 id: qualified(model.id),
@@ -182,8 +174,17 @@ export function v1ImagesRoutes(ctx) {
             return c.json(apiError('unsupported_backend', `Image models are ${ENGINE}:<id>`), 400);
         }
         const provider = await ctx.images.current();
-        const installed = await provider.listInstalledModels();
-        if (installed.some((m) => m.id === id)) {
+        const [installed, item] = await Promise.all([
+            provider.listInstalledModels(),
+            ctx.catalog.get('image-model', id).catch(() => null),
+        ]);
+        const local = installed.find((m) => m.id === id);
+        const listed = item?.manifest.kind === 'image-model' ? item.manifest : undefined;
+        // Downloading one would fetch gigabytes no generation here can use.
+        if (editsOnly(id, local?.editOnly ?? listed?.editOnly)) {
+            return c.json(editOnlyError(local?.name ?? listed?.name ?? model), 409);
+        }
+        if (local) {
             return c.json({ status: 'ready', model_id: qualified(id) });
         }
         const refusal = await wontRunRefusal(() => imageModelFit(fitContext, id));
@@ -200,69 +201,7 @@ export function v1ImagesRoutes(ctx) {
         }
         return c.json({ status: 'downloading', model_id: qualified(id), job_id: id }, 202);
     });
-    app.get('/models/ensure/:jobId', (c) => {
-        const pull = ctx.images.pulls.get(c.req.param('jobId'));
-        if (!pull)
-            return c.json(apiError('job_not_found', 'job not found'), 404);
-        return c.json({
-            job_id: pull.id,
-            model_id: qualified(pull.id),
-            status: pullStatus(pull),
-            started_at: Date.parse(pull.startedAt),
-            bytes_written: pull.bytesWritten,
-            total_bytes: pull.totalBytes,
-            ...(pull.error ? { error: pull.error } : {}),
-        });
-    });
-    app.get('/models/ensure/:jobId/events', (c) => {
-        const jobId = c.req.param('jobId');
-        const snapshot = ctx.images.pulls.get(jobId);
-        if (!snapshot)
-            return c.json(apiError('job_not_found', 'job not found'), 404);
-        return streamSSE(c, async (stream) => {
-            let closed = false;
-            let sawError = false;
-            const unsubscribe = ctx.images.pulls.subscribe(jobId, (event) => {
-                // A failed pull ends with an error and then its done; the error is terminal.
-                if (sawError)
-                    return;
-                if (event.type === 'error')
-                    sawError = true;
-                const terminal = event.type === 'done' || event.type === 'error';
-                void stream
-                    .writeSSE({ data: JSON.stringify(ensureEvent(jobId, event, snapshot.totalBytes)) })
-                    .then(() => {
-                    if (terminal)
-                        closed = true;
-                })
-                    .catch(() => {
-                    closed = true;
-                });
-            });
-            if (!unsubscribe)
-                return;
-            stream.onAbort(() => {
-                closed = true;
-                unsubscribe();
-            });
-            while (!closed) {
-                await stream.sleep(1000);
-                try {
-                    await stream.writeSSE({ event: 'ping', data: '' });
-                }
-                catch {
-                    closed = true;
-                }
-            }
-            unsubscribe();
-        });
-    });
-    app.delete('/models/ensure/:jobId', (c) => {
-        if (!ctx.images.pulls.cancel(c.req.param('jobId'))) {
-            return c.json(apiError('job_not_found', 'No download in progress for that job'), 404);
-        }
-        return c.json({ cancelled: true });
-    });
+    registerImageEnsureRoutes(app, '/models/ensure', ctx.images.pulls, qualified);
     app.delete('/models/:id', async (c) => {
         const id = catalogIdOf(decodeURIComponent(c.req.param('id')));
         if (!id)
@@ -296,12 +235,21 @@ export function v1ImagesRoutes(ctx) {
             return c.json(apiError('unsupported_backend', `Image models are ${ENGINE}:<id>`), 400);
         }
         const modelId = requested ?? (await provider.resolveDefaultModelId?.());
-        if (!modelId || !installed.some((m) => m.id === modelId)) {
+        const chosen = modelId ? installed.find((m) => m.id === modelId) : undefined;
+        if (!modelId || !chosen) {
             const error = requested
                 ? apiError('model_not_installed', `${request.model} is not installed; ensure it first`)
                 : apiError('no_local_image_model', new NoLocalImageModelError().message);
             return c.json(error, 409);
         }
+        if (editsOnly(modelId, chosen.editOnly))
+            return c.json(editOnlyError(chosen.name), 409);
+        const style = request.style
+            ? chosen.loras?.find((lora) => lora.id === request.style && lora.purpose === 'style')
+            : undefined;
+        if (request.style && !style) {
+            return c.json(apiError('style_not_available', 'That style is not installed for this image model.'), 409);
+        }
         const item = await ctx.catalog.get('image-model', modelId).catch(() => null);
         const manifest = item?.manifest.kind === 'image-model' ? item.manifest : undefined;
         const { width, height } = resolveImageSize({
@@ -338,6 +286,7 @@ export function v1ImagesRoutes(ctx) {
                     prompt: request.prompt,
                     ...(request.negative_prompt ? { negativePrompt: request.negative_prompt } : {}),
                     model: modelId,
+                    ...(style ? { loras: [{ id: style.id }] } : {}),
                     width,
                     height,
                     ...(request.seed !== undefined ? { seed: request.seed } : {}),

package/dist/inference-service.js

@@ -2,7 +2,7 @@ import { randomBytes, randomUUID, timingSafeEqual } from 'node:crypto';
 import { join } from 'node:path';
 import { GEZEL_API_GENERATION, GEZEL_API_GENERATION_FLOOR, GEZEL_VERSION, GezelConfigSchema, createLogger, getLogOutput, nowIso, setLogOutput, startSuspendMonitor, stopSuspendMonitor, } from '@bendyline/gezel';
 import { BundledSource, CatalogService } from '@bendyline/gezel-catalog';
-import { discoverNativeBinaries } from '@bendyline/gezel/native';
+import { disableOnnxRuntimeTelemetry, discoverNativeBinaries } from '@bendyline/gezel/native';
 import { gezelHome } from '@bendyline/gezel/paths';
 import { Hono } from 'hono';
 import { bodyLimit } from 'hono/body-limit';
@@ -37,6 +37,7 @@ import './http/auth-context.js';
 const log = createLogger('inference');
 /** Direct Fetch host: no listener, product store, background downloads or daemon discovery. */
 export async function startService(options = {}) {
+    disableOnnxRuntimeTelemetry();
     const previousLogOutput = getLogOutput();
     const restoreLogOutput = () => setLogOutput(previousLogOutput);
     if (options.logOutput)