@soulcraft/sdk 3.3.7 → 3.3.9

package/dist/read-only.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @module read-only
+ * @description Shared read-only enforcement for @soulcraft/sdk.
+ *
+ * Defines the canonical registry of mutation methods per SDK namespace. Both the
+ * client-side {@link ReadOnlyTransport} (blocks before the wire) and the server-side
+ * {@link createReadOnlyAuthorize} helper (blocks after the wire) import from this
+ * module to guarantee the same methods are blocked on both sides.
+ *
+ * ## Architecture
+ *
+ * ```
+ * Browser (Workshop)              Server (Venue)
+ * ┌─────────────────┐             ┌─────────────────┐
+ * │ ReadOnlyTransport│ ── wire ──▶│  authorize()     │
+ * │ blocks before   │             │  blocks after    │
+ * │ callNs()        │             │  dispatch()      │
+ * └────────┬────────┘             └────────┬────────┘
+ *          │                               │
+ *          └──── both use ────────────────┘
+ *                 isWriteMethod()
+ *                 from @soulcraft/sdk
+ * ```
+ *
+ * @example
+ * ```typescript
+ * import { isWriteMethod } from '@soulcraft/sdk'
+ *
+ * isWriteMethod('brainy', 'find')      // false (read)
+ * isWriteMethod('brainy', 'add')       // true  (write)
+ * isWriteMethod('brainy.vfs', 'readdir') // false (read)
+ * isWriteMethod('brainy.vfs', 'writeFile') // true (write)
+ * ```
+ */
+export { SDKReadOnlyError } from './modules/brainy/errors.js';
+/**
+ * Known mutation methods per SDK namespace. Any `callNs(ns, method)` matching
+ * an entry here is considered a write operation.
+ *
+ * Methods not in this registry are considered reads — the default is "allow".
+ * This registry is the single source of truth for both client-side
+ * {@link ReadOnlyTransport} and server-side {@link createReadOnlyAuthorize}.
+ */
+export declare const WRITE_METHODS: Readonly<Record<string, ReadonlySet<string>>>;
+/**
+ * Check whether a namespace + method combination is a known write operation.
+ *
+ * Used by both {@link ReadOnlyTransport} (client) and
+ * {@link createReadOnlyAuthorize} (server) to enforce read-only mode.
+ *
+ * @param ns - The target namespace (e.g. `'brainy'`, `'brainy.vfs'`).
+ * @param method - The method name (e.g. `'add'`, `'readdir'`).
+ * @returns `true` if the method mutates data, `false` if it's a read or unknown.
+ */
+export declare function isWriteMethod(ns: string, method: string): boolean;
+//# sourceMappingURL=read-only.d.ts.map

package/dist/read-only.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-only.d.ts","sourceRoot":"","sources":["../src/read-only.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAM7D;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CA2DvE,CAAA;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAEjE"}

package/dist/read-only.js

@@ -0,0 +1,108 @@
+/**
+ * @module read-only
+ * @description Shared read-only enforcement for @soulcraft/sdk.
+ *
+ * Defines the canonical registry of mutation methods per SDK namespace. Both the
+ * client-side {@link ReadOnlyTransport} (blocks before the wire) and the server-side
+ * {@link createReadOnlyAuthorize} helper (blocks after the wire) import from this
+ * module to guarantee the same methods are blocked on both sides.
+ *
+ * ## Architecture
+ *
+ * ```
+ * Browser (Workshop)              Server (Venue)
+ * ┌─────────────────┐             ┌─────────────────┐
+ * │ ReadOnlyTransport│ ── wire ──▶│  authorize()     │
+ * │ blocks before   │             │  blocks after    │
+ * │ callNs()        │             │  dispatch()      │
+ * └────────┬────────┘             └────────┬────────┘
+ *          │                               │
+ *          └──── both use ────────────────┘
+ *                 isWriteMethod()
+ *                 from @soulcraft/sdk
+ * ```
+ *
+ * @example
+ * ```typescript
+ * import { isWriteMethod } from '@soulcraft/sdk'
+ *
+ * isWriteMethod('brainy', 'find')      // false (read)
+ * isWriteMethod('brainy', 'add')       // true  (write)
+ * isWriteMethod('brainy.vfs', 'readdir') // false (read)
+ * isWriteMethod('brainy.vfs', 'writeFile') // true (write)
+ * ```
+ */
+// Re-export the error class for convenience
+export { SDKReadOnlyError } from './modules/brainy/errors.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// Write method registry
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Known mutation methods per SDK namespace. Any `callNs(ns, method)` matching
+ * an entry here is considered a write operation.
+ *
+ * Methods not in this registry are considered reads — the default is "allow".
+ * This registry is the single source of truth for both client-side
+ * {@link ReadOnlyTransport} and server-side {@link createReadOnlyAuthorize}.
+ */
+export const WRITE_METHODS = {
+    // Brainy core — entity CRUD + relationship mutations
+    'brainy': new Set([
+        'add', 'update', 'remove', 'upsert', 'batch',
+        'relate', 'unrelate', 'flush',
+    ]),
+    // Brainy VFS — file system mutations
+    'brainy.vfs': new Set([
+        'writeFile', 'deleteFile', 'mkdir', 'rename',
+    ]),
+    // Brainy versions — commit/revert
+    'brainy.versions': new Set([
+        'commit', 'revert', 'createBranch', 'deleteBranch', 'checkout',
+    ]),
+    // Graph — node deletion
+    'graph': new Set(['deleteNode']),
+    // Collections — CRUD + membership
+    'collections': new Set([
+        'create', 'update', 'delete',
+        'addMember', 'removeMember',
+        'loadSampleData', 'clearSampleData',
+    ]),
+    // Annotations — CRUD
+    'annotations': new Set(['create', 'update', 'delete']),
+    // Import — file ingestion
+    'import': new Set(['uploadFiles', 'importData', 'cancel']),
+    // Workspace — mutations (but not reads)
+    'workspace': new Set([
+        'create', 'update', 'delete',
+        'backup', 'restore', 'connectVenue', 'updateSettings',
+    ]),
+    // Publish — link/deploy mutations
+    'publish': new Set([
+        'createLink', 'deleteLink',
+        'deployToVenue', 'publishToAcademy', 'to',
+    ]),
+    // Settings — key/config mutations
+    'settings': new Set(['saveApiKey', 'deleteApiKey', 'updateSettings']),
+    // Media — upload/delete
+    'media': new Set(['upload', 'delete']),
+    // Commerce — transactional mutations
+    'commerce': new Set(['createProduct', 'checkout']),
+    // Certification — issuance
+    'certification': new Set(['issue', 'revoke']),
+    // Pulse — event tracking (write-only namespace)
+    'pulse': new Set(['track']),
+};
+/**
+ * Check whether a namespace + method combination is a known write operation.
+ *
+ * Used by both {@link ReadOnlyTransport} (client) and
+ * {@link createReadOnlyAuthorize} (server) to enforce read-only mode.
+ *
+ * @param ns - The target namespace (e.g. `'brainy'`, `'brainy.vfs'`).
+ * @param method - The method name (e.g. `'add'`, `'readdir'`).
+ * @returns `true` if the method mutates data, `false` if it's a read or unknown.
+ */
+export function isWriteMethod(ns, method) {
+    return WRITE_METHODS[ns]?.has(method) === true;
+}
+//# sourceMappingURL=read-only.js.map

package/dist/read-only.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-only.js","sourceRoot":"","sources":["../src/read-only.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,4CAA4C;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAE7D,gFAAgF;AAChF,wBAAwB;AACxB,gFAAgF;AAEhF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,aAAa,GAAkD;IAC1E,qDAAqD;IACrD,QAAQ,EAAE,IAAI,GAAG,CAAC;QAChB,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO;QAC5C,QAAQ,EAAE,UAAU,EAAE,OAAO;KAC9B,CAAC;IAEF,qCAAqC;IACrC,YAAY,EAAE,IAAI,GAAG,CAAC;QACpB,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ;KAC7C,CAAC;IAEF,kCAAkC;IAClC,iBAAiB,EAAE,IAAI,GAAG,CAAC;QACzB,QAAQ,EAAE,QAAQ,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU;KAC/D,CAAC;IAEF,wBAAwB;IACxB,OAAO,EAAE,IAAI,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC;IAEhC,kCAAkC;IAClC,aAAa,EAAE,IAAI,GAAG,CAAC;QACrB,QAAQ,EAAE,QAAQ,EAAE,QAAQ;QAC5B,WAAW,EAAE,cAAc;QAC3B,gBAAgB,EAAE,iBAAiB;KACpC,CAAC;IAEF,qBAAqB;IACrB,aAAa,EAAE,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAEtD,0BAA0B;IAC1B,QAAQ,EAAE,IAAI,GAAG,CAAC,CAAC,aAAa,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;IAE1D,wCAAwC;IACxC,WAAW,EAAE,IAAI,GAAG,CAAC;QACnB,QAAQ,EAAE,QAAQ,EAAE,QAAQ;QAC5B,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,gBAAgB;KACtD,CAAC;IAEF,kCAAkC;IAClC,SAAS,EAAE,IAAI,GAAG,CAAC;QACjB,YAAY,EAAE,YAAY;QAC1B,eAAe,EAAE,kBAAkB,EAAE,IAAI;KAC1C,CAAC;IAEF,kCAAkC;IAClC,UAAU,EAAE,IAAI,GAAG,CAAC,CAAC,YAAY,EAAE,cAAc,EAAE,gBAAgB,CAAC,CAAC;IAErE,wBAAwB;IACxB,OAAO,EAAE,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAEtC,qCAAqC;IACrC,UAAU,EAAE,IAAI,GAAG,CAAC,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;IAElD,2BAA2B;IAC3B,eAAe,EAAE,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAE7C,gDAAgD;IAChD,OAAO,EAAE,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC;CAC5B,CAAA;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,EAAU,EAAE,MAAc;IACtD,OAAO,aAAa,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,CAAA;AAChD,CAAC"}

package/dist/server/handlers/imagine.d.ts

@@ -0,0 +1,140 @@
+/**
+ * @module server/handlers/imagine
+ * @description Imagine namespace handler — generate, list, search, and manage
+ * images via a GPU inference backend.
+ *
+ * The handler delegates image generation to an injected {@link ImagineBackend}
+ * interface and stores results as Brainy noun entities with VFS-backed PNG files.
+ * The backend is the Rust ONNX sidecar (imagine-gpu binary) or any HTTP service
+ * that implements the generate contract.
+ *
+ * Storage is fully Brainy-native: each image is a `media` noun entity with prompt
+ * metadata (searchable via semantic search) and a VFS file at `/images/{id}.png`.
+ *
+ * Methods:
+ * - `generate` — Generate images and store in Brainy
+ * - `generateStream` — Streaming generation with progress events
+ * - `list` — List/search user's image gallery
+ * - `get` — Get single image metadata
+ * - `getBytes` — Get raw PNG bytes
+ * - `delete` — Delete image (entity + VFS file)
+ * - `getPresets` — Available style and size presets
+ * - `health` — GPU backend health check
+ */
+import type { NamespaceProvider } from '../namespace-router.js';
+/**
+ * @description GPU inference backend interface. Implemented by the Imagine
+ * service's `gpu-client.ts` and injected via handler options.
+ *
+ * Products that host the imagine namespace (i.e. imagine.soulcraft.com itself)
+ * provide this backend. Products that *consume* the imagine namespace (Workshop,
+ * Venue) call it via the SDK transport — they never see this interface.
+ */
+export interface ImagineBackend {
+    /**
+     * @description Generate a single image from a fully-resolved prompt.
+     * @param params - Generation parameters with resolved dimensions.
+     * @param userId - The requesting user's ID for tracking.
+     * @returns Raw PNG bytes, the seed used, and the resolved dimensions.
+     */
+    generate(params: {
+        prompt: string;
+        width: number;
+        height: number;
+        steps: number;
+        guidance: number;
+        seed: number;
+    }, userId: string): Promise<{
+        bytes: ArrayBuffer;
+        seed: number;
+        width: number;
+        height: number;
+    }>;
+    /**
+     * @description Stream generation progress events.
+     * @param params - Generation parameters.
+     * @param userId - The requesting user's ID.
+     * @returns Async iterable of progress/complete/error events.
+     */
+    generateStream?(params: {
+        prompt: string;
+        width: number;
+        height: number;
+        steps: number;
+        guidance: number;
+        seed: number;
+    }, userId: string): AsyncIterable<{
+        type: 'progress';
+        step: number;
+        total: number;
+    } | {
+        type: 'complete';
+        bytes: ArrayBuffer;
+        seed: number;
+        width: number;
+        height: number;
+    } | {
+        type: 'error';
+        message: string;
+    }>;
+    /**
+     * @description Check GPU backend health.
+     * @returns Health status object.
+     */
+    health(): Promise<{
+        status: 'ok' | 'unavailable';
+        gpu?: string;
+        info?: string;
+    }>;
+    /**
+     * @description Get available style presets.
+     * @returns Array of style presets.
+     */
+    getStylePresets(): Array<{
+        key: string;
+        label: string;
+        description: string;
+        prefix: string;
+    }>;
+    /**
+     * @description Get available size presets.
+     * @returns Array of size presets.
+     */
+    getSizePresets(): Array<{
+        key: string;
+        label: string;
+        width: number;
+        height: number;
+    }>;
+}
+/**
+ * @description Options for {@link createImagineHandler}.
+ */
+export interface ImagineHandlerOptions {
+    /** The GPU inference backend implementation. */
+    backend: ImagineBackend;
+}
+/**
+ * @description Creates the `imagine` namespace handler.
+ *
+ * The handler uses `ctx.brain` for per-user image storage (Brainy noun entities
+ * + VFS files) and delegates GPU inference to the injected {@link ImagineBackend}.
+ *
+ * @param options - Handler dependencies. If omitted, all methods throw.
+ * @returns A {@link NamespaceProvider} implementing {@link ImagineNamespace}.
+ *
+ * @example Wiring in Imagine's hooks.server.ts
+ * ```typescript
+ * import { createImagineHandler } from '@soulcraft/sdk/server'
+ * import { imagineBackend } from '$lib/server/gpu-client.js'
+ *
+ * export const routerConfig = {
+ *   resolveBrain: async (ctx) => getUserBrain(ctx.user.id, ctx.user.email),
+ *   providers: {
+ *     imagine: createImagineHandler({ backend: imagineBackend }),
+ *   },
+ * }
+ * ```
+ */
+export declare function createImagineHandler(options?: ImagineHandlerOptions): NamespaceProvider;
+//# sourceMappingURL=imagine.d.ts.map

package/dist/server/handlers/imagine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imagine.d.ts","sourceRoot":"","sources":["../../../src/server/handlers/imagine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAkB,MAAM,wBAAwB,CAAA;AAM/E;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,QAAQ,CACN,MAAM,EAAE;QACN,MAAM,EAAE,MAAM,CAAA;QACd,KAAK,EAAE,MAAM,CAAA;QACb,MAAM,EAAE,MAAM,CAAA;QACd,KAAK,EAAE,MAAM,CAAA;QACb,QAAQ,EAAE,MAAM,CAAA;QAChB,IAAI,EAAE,MAAM,CAAA;KACb,EACD,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;QAAE,KAAK,EAAE,WAAW,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAE/E;;;;;OAKG;IACH,cAAc,CAAC,CACb,MAAM,EAAE;QACN,MAAM,EAAE,MAAM,CAAA;QACd,KAAK,EAAE,MAAM,CAAA;QACb,MAAM,EAAE,MAAM,CAAA;QACd,KAAK,EAAE,MAAM,CAAA;QACb,QAAQ,EAAE,MAAM,CAAA;QAChB,IAAI,EAAE,MAAM,CAAA;KACb,EACD,MAAM,EAAE,MAAM,GACb,aAAa,CACZ;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GACjD;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,KAAK,EAAE,WAAW,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GACrF;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CACrC,CAAA;IAED;;;OAGG;IACH,MAAM,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,IAAI,GAAG,aAAa,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAEhF;;;OAGG;IACH,eAAe,IAAI,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAE7F;;;OAGG;IACH,cAAc,IAAI,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACvF;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,gDAAgD;IAChD,OAAO,EAAE,cAAc,CAAA;CACxB;AAwGD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,iBAAiB,CAqOvF"}

package/dist/server/handlers/imagine.js

@@ -0,0 +1,310 @@
+/**
+ * @module server/handlers/imagine
+ * @description Imagine namespace handler — generate, list, search, and manage
+ * images via a GPU inference backend.
+ *
+ * The handler delegates image generation to an injected {@link ImagineBackend}
+ * interface and stores results as Brainy noun entities with VFS-backed PNG files.
+ * The backend is the Rust ONNX sidecar (imagine-gpu binary) or any HTTP service
+ * that implements the generate contract.
+ *
+ * Storage is fully Brainy-native: each image is a `media` noun entity with prompt
+ * metadata (searchable via semantic search) and a VFS file at `/images/{id}.png`.
+ *
+ * Methods:
+ * - `generate` — Generate images and store in Brainy
+ * - `generateStream` — Streaming generation with progress events
+ * - `list` — List/search user's image gallery
+ * - `get` — Get single image metadata
+ * - `getBytes` — Get raw PNG bytes
+ * - `delete` — Delete image (entity + VFS file)
+ * - `getPresets` — Available style and size presets
+ * - `health` — GPU backend health check
+ */
+// ─────────────────────────────────────────────────────────────────────────────
+// Constants
+// ─────────────────────────────────────────────────────────────────────────────
+/** VFS directory where generated images are stored. */
+const IMAGES_VFS_PATH = '/images';
+// ─────────────────────────────────────────────────────────────────────────────
+// Internal helpers
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * @description Resolve a style preset key to its prompt prefix.
+ * @param key - Style preset key.
+ * @param backend - The GPU backend (for preset lookup).
+ * @returns The prefix string (empty for "none").
+ */
+function resolveStylePrefix(key, backend) {
+    const presets = backend.getStylePresets();
+    const preset = presets.find((s) => s.key === key);
+    return preset?.prefix ?? '';
+}
+/**
+ * @description Resolve a size preset key to dimensions.
+ * @param key - Size preset key.
+ * @param backend - The GPU backend (for preset lookup).
+ * @returns Width and height in pixels.
+ */
+function resolveDimensions(key, backend) {
+    const presets = backend.getSizePresets();
+    const preset = presets.find((s) => s.key === key);
+    return preset ?? { width: 1024, height: 576 };
+}
+/**
+ * @description Extract image metadata from a Brainy Result or Entity.
+ * @param r - A result from brain.find() or brain.get().
+ * @returns Normalized image metadata.
+ */
+function toImageMeta(r) {
+    const d = (r.data ?? {});
+    return {
+        id: r.id,
+        prompt: d['prompt'] ?? '',
+        style: d['style'] ?? 'none',
+        size: d['size'] ?? 'landscape',
+        steps: d['steps'] ?? 25,
+        guidance: d['guidance'] ?? 7.5,
+        seed: d['seed'] ?? 0,
+        width: d['width'] ?? 1024,
+        height: d['height'] ?? 576,
+        elapsed: d['elapsed'] ?? 0,
+        createdAt: d['createdAt'] ?? 0,
+        filename: `${r.id}.png`,
+    };
+}
+/**
+ * @description Store a generated image in Brainy (entity + VFS file).
+ * @returns The entity ID.
+ */
+async function storeImage(brain, imageBytes, meta) {
+    const id = await brain.add({
+        data: {
+            prompt: meta.prompt,
+            style: meta.style,
+            size: meta.size,
+            steps: meta.steps,
+            guidance: meta.guidance,
+            seed: meta.seed,
+            width: meta.width,
+            height: meta.height,
+            elapsed: meta.elapsed,
+            createdAt: Date.now(),
+        },
+        type: 'media',
+        metadata: {
+            name: meta.prompt.slice(0, 100),
+            mediaType: 'image/png',
+        },
+    });
+    // Write PNG to VFS
+    const vfsPath = `${IMAGES_VFS_PATH}/${id}.png`;
+    await brain.vfs.mkdir(IMAGES_VFS_PATH, { recursive: true });
+    await brain.vfs.writeFile(vfsPath, Buffer.from(imageBytes));
+    return id;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Handler factory
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * @description Creates the `imagine` namespace handler.
+ *
+ * The handler uses `ctx.brain` for per-user image storage (Brainy noun entities
+ * + VFS files) and delegates GPU inference to the injected {@link ImagineBackend}.
+ *
+ * @param options - Handler dependencies. If omitted, all methods throw.
+ * @returns A {@link NamespaceProvider} implementing {@link ImagineNamespace}.
+ *
+ * @example Wiring in Imagine's hooks.server.ts
+ * ```typescript
+ * import { createImagineHandler } from '@soulcraft/sdk/server'
+ * import { imagineBackend } from '$lib/server/gpu-client.js'
+ *
+ * export const routerConfig = {
+ *   resolveBrain: async (ctx) => getUserBrain(ctx.user.id, ctx.user.email),
+ *   providers: {
+ *     imagine: createImagineHandler({ backend: imagineBackend }),
+ *   },
+ * }
+ * ```
+ */
+export function createImagineHandler(options) {
+    const backend = options?.backend;
+    function requireBackend() {
+        if (!backend) {
+            throw new Error('imagine namespace is not configured — provide an ImagineBackend via providers.imagine. ' +
+                'The imagine backend is hosted by imagine.soulcraft.com.');
+        }
+        return backend;
+    }
+    return {
+        async generate(params, ctx) {
+            const gpu = requireBackend();
+            const { brain } = ctx;
+            const count = Math.min(Math.max(params.count ?? 1, 1), 4);
+            const style = params.style ?? 'none';
+            const sizeKey = params.size ?? 'landscape';
+            const steps = params.steps ?? 25;
+            const guidance = params.guidance ?? 7.5;
+            const prefix = resolveStylePrefix(style, gpu);
+            const { width, height } = resolveDimensions(sizeKey, gpu);
+            const fullPrompt = prefix + params.prompt;
+            const images = [];
+            for (let i = 0; i < count; i++) {
+                const seed = params.seed != null
+                    ? params.seed + i
+                    : Math.floor(Math.random() * 2147483647);
+                const start = performance.now();
+                const result = await gpu.generate({ prompt: fullPrompt, width, height, steps, guidance, seed }, ctx.user.id);
+                const elapsed = (performance.now() - start) / 1000;
+                const id = await storeImage(brain, result.bytes, {
+                    prompt: params.prompt,
+                    style,
+                    size: sizeKey,
+                    steps,
+                    guidance,
+                    seed: result.seed,
+                    width: result.width,
+                    height: result.height,
+                    elapsed,
+                });
+                images.push({
+                    id,
+                    prompt: params.prompt,
+                    style,
+                    size: sizeKey,
+                    steps,
+                    guidance,
+                    seed: result.seed,
+                    width: result.width,
+                    height: result.height,
+                    elapsed,
+                    createdAt: Date.now(),
+                    filename: `${id}.png`,
+                });
+            }
+            return images;
+        },
+        async *generateStream(params, ctx) {
+            const gpu = requireBackend();
+            const { brain } = ctx;
+            const style = params.style ?? 'none';
+            const sizeKey = params.size ?? 'landscape';
+            const steps = params.steps ?? 25;
+            const guidance = params.guidance ?? 7.5;
+            const seed = params.seed ?? Math.floor(Math.random() * 2147483647);
+            const prefix = resolveStylePrefix(style, gpu);
+            const { width, height } = resolveDimensions(sizeKey, gpu);
+            const fullPrompt = prefix + params.prompt;
+            if (gpu.generateStream) {
+                const start = performance.now();
+                let resultBytes = null;
+                let resultSeed = seed;
+                let resultWidth = width;
+                let resultHeight = height;
+                for await (const event of gpu.generateStream({ prompt: fullPrompt, width, height, steps, guidance, seed }, ctx.user.id)) {
+                    if (event.type === 'progress') {
+                        yield { type: 'progress', step: event.step, total: event.total };
+                    }
+                    else if (event.type === 'complete') {
+                        resultBytes = event.bytes;
+                        resultSeed = event.seed;
+                        resultWidth = event.width;
+                        resultHeight = event.height;
+                    }
+                    else if (event.type === 'error') {
+                        yield { type: 'error', message: event.message };
+                        return;
+                    }
+                }
+                if (resultBytes) {
+                    const elapsed = (performance.now() - start) / 1000;
+                    const id = await storeImage(brain, resultBytes, {
+                        prompt: params.prompt, style, size: sizeKey, steps, guidance,
+                        seed: resultSeed, width: resultWidth, height: resultHeight, elapsed,
+                    });
+                    yield {
+                        type: 'complete',
+                        images: [{
+                                id,
+                                prompt: params.prompt, style, size: sizeKey, steps, guidance,
+                                seed: resultSeed, width: resultWidth, height: resultHeight,
+                                elapsed, createdAt: Date.now(), filename: `${id}.png`,
+                            }],
+                    };
+                }
+            }
+            else {
+                // Fallback: non-streaming generate with simulated progress
+                for (let step = 1; step <= steps; step++) {
+                    yield { type: 'progress', step, total: steps };
+                }
+                const start = performance.now();
+                const result = await gpu.generate({ prompt: fullPrompt, width, height, steps, guidance, seed }, ctx.user.id);
+                const elapsed = (performance.now() - start) / 1000;
+                const id = await storeImage(brain, result.bytes, {
+                    prompt: params.prompt, style, size: sizeKey, steps, guidance,
+                    seed: result.seed, width: result.width, height: result.height, elapsed,
+                });
+                yield {
+                    type: 'complete',
+                    images: [{
+                            id,
+                            prompt: params.prompt, style, size: sizeKey, steps, guidance,
+                            seed: result.seed, width: result.width, height: result.height,
+                            elapsed, createdAt: Date.now(), filename: `${id}.png`,
+                        }],
+                };
+            }
+        },
+        async list(options, ctx) {
+            const { brain } = ctx;
+            const limit = options?.limit ?? 50;
+            const results = options?.query
+                ? await brain.find({ query: options.query, where: { noun: 'media' }, limit })
+                : await brain.find({ where: { noun: 'media' }, limit });
+            return results.map(toImageMeta);
+        },
+        async get(imageId, ctx) {
+            const entity = await ctx.brain.get(imageId);
+            if (!entity)
+                return null;
+            return toImageMeta(entity);
+        },
+        async getBytes(imageId, ctx) {
+            try {
+                const buffer = await ctx.brain.vfs.readFile(`${IMAGES_VFS_PATH}/${imageId}.png`);
+                // Return as ArrayBuffer
+                if (buffer instanceof ArrayBuffer)
+                    return buffer;
+                if (Buffer.isBuffer(buffer))
+                    return buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength);
+                return null;
+            }
+            catch {
+                return null;
+            }
+        },
+        async delete(imageId, ctx) {
+            await ctx.brain.delete(imageId);
+            try {
+                await ctx.brain.vfs.unlink(`${IMAGES_VFS_PATH}/${imageId}.png`);
+            }
+            catch {
+                // VFS file may already be gone
+            }
+        },
+        async getPresets() {
+            const gpu = requireBackend();
+            return {
+                styles: gpu.getStylePresets().map(({ key, label, description }) => ({ key, label, description })),
+                sizes: gpu.getSizePresets(),
+            };
+        },
+        async health() {
+            const gpu = requireBackend();
+            return gpu.health();
+        },
+    };
+}
+//# sourceMappingURL=imagine.js.map

package/dist/server/handlers/imagine.js.map

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

package/dist/server/handlers/index.d.ts

@@ -46,6 +46,8 @@ export type { ExportPipeline, ExportHandlerOptions } from './export.js';
 export { createFormatsHandler } from './formats.js';
 export type { FormatConverter, FormatsHandlerOptions } from './formats.js';
 export { createGraphHandler } from './graph.js';
+export { createImagineHandler } from './imagine.js';
+export type { ImagineBackend, ImagineHandlerOptions } from './imagine.js';
 export { createImportHandler } from './import.js';
 export type { ImportPipeline, ImportHandlerOptions } from './import.js';
 export { createMediaHandler } from './media.js';