@askdkc/kiokuko 0.2.7 → 0.2.9

package/dist/embedding/settings.js

@@ -0,0 +1,69 @@
+import { KiokukoError } from '../errors.js';
+const DISABLED_CONFIG = Object.freeze({
+    mode: 'off',
+    provider: 'openai-compatible',
+    allowRemote: false,
+    vectorBackend: 'auto',
+    timeoutMs: 30_000,
+    batchSize: 16,
+});
+function invalid(message) {
+    throw new KiokukoError('INTEGRITY_ERROR', message);
+}
+function tableExists(database) {
+    return Boolean(database.prepare(`
+    SELECT 1 AS present FROM sqlite_schema WHERE type = 'table' AND name = 'embedding_settings'
+  `).get());
+}
+function vectorBackend(value) {
+    if (value !== 'auto' && value !== 'javascript' && value !== 'sqlite-vec')
+        invalid('Persisted embedding vector backend is invalid');
+    return value;
+}
+function integer(value, minimum, maximum, field) {
+    if (typeof value !== 'number' || !Number.isSafeInteger(value) || value < minimum || value > maximum) {
+        invalid(`Persisted embedding ${field} is invalid`);
+    }
+    return value;
+}
+/** Read durable embedding settings without consulting embedding environment variables. */
+export function readPersistedEmbeddingSettings(database) {
+    if (!tableExists(database))
+        return DISABLED_CONFIG;
+    const row = database.prepare(`
+    SELECT singleton, mode, provider_kind, vector_backend, batch_size, timeout_ms, setup_state
+      FROM embedding_settings
+  `).get();
+    if (row === undefined || row.singleton !== 1)
+        invalid('Persisted embedding settings must contain exactly one singleton row');
+    const backend = vectorBackend(row.vector_backend);
+    const batchSize = integer(row.batch_size, 1, 64, 'batch size');
+    const timeoutMs = integer(row.timeout_ms, 100, 120_000, 'timeout');
+    if (row.mode !== 'off' && row.mode !== 'optional' && row.mode !== 'required')
+        invalid('Persisted embedding mode is invalid');
+    if (row.setup_state !== 'disabled' && row.setup_state !== 'requires_setup' && row.setup_state !== 'installing'
+        && row.setup_state !== 'ready' && row.setup_state !== 'degraded')
+        invalid('Persisted embedding setup state is invalid');
+    // v1 remote profiles intentionally cannot be reconstructed and local v2
+    // loading is supplied by the local provider work unit. Until a verified
+    // provider is available, fail closed to lexical retrieval.
+    if (row.mode === 'off' || row.provider_kind !== 'local-transformers' || row.setup_state !== 'ready') {
+        return Object.freeze({ ...DISABLED_CONFIG, vectorBackend: backend, batchSize, timeoutMs });
+    }
+    return Object.freeze({
+        mode: row.mode,
+        provider: 'openai-compatible',
+        baseUrl: 'http://127.0.0.1/kiokuko-local',
+        model: 'intfloat/multilingual-e5-small',
+        dimensions: 384,
+        distanceCeiling: 0.8,
+        allowRemote: false,
+        vectorBackend: backend,
+        batchSize,
+        timeoutMs,
+    });
+}
+export function defaultEmbeddingConfig() {
+    return DISABLED_CONFIG;
+}
+//# sourceMappingURL=settings.js.map

package/dist/embedding/settings.js.map

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

package/dist/embedding/setup-lock.d.ts

@@ -0,0 +1,7 @@
+import { type PathEnvironment } from '../config/paths.js';
+export interface EmbeddingSetupLock {
+    readonly path: string;
+    release(): Promise<void>;
+}
+export declare function acquireEmbeddingSetupLock(options?: PathEnvironment): Promise<EmbeddingSetupLock>;
+//# sourceMappingURL=setup-lock.d.ts.map

package/dist/embedding/setup-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-lock.d.ts","sourceRoot":"","sources":["../../src/embedding/setup-lock.ts"],"names":[],"mappings":"AAEA,OAAO,EAA0D,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGlH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,wBAAsB,yBAAyB,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAwB1G"}

package/dist/embedding/setup-lock.js

@@ -0,0 +1,35 @@
+import { randomUUID } from 'node:crypto';
+import { mkdir, open, unlink } from 'node:fs/promises';
+import { getEmbeddingModelsDirectory, getEmbeddingSetupLockPath } from '../config/paths.js';
+import { KiokukoError } from '../errors.js';
+export async function acquireEmbeddingSetupLock(options = {}) {
+    await mkdir(getEmbeddingModelsDirectory(options), { recursive: true, mode: 0o700 });
+    const lockPath = getEmbeddingSetupLockPath(options);
+    let handle;
+    try {
+        handle = await open(lockPath, 'wx', 0o600);
+        await handle.writeFile(`${randomUUID()}\n`, 'utf8');
+    }
+    catch (error) {
+        try {
+            await handle?.close();
+        }
+        catch { /* preserve the lock conflict */ }
+        if (error instanceof Error && 'code' in error && error.code === 'EEXIST') {
+            throw new KiokukoError('CONFLICT', 'Another embedding setup is already in progress');
+        }
+        throw error;
+    }
+    let released = false;
+    return Object.freeze({
+        path: lockPath,
+        release: async () => {
+            if (released)
+                return;
+            released = true;
+            await handle.close();
+            await unlink(lockPath);
+        },
+    });
+}
+//# sourceMappingURL=setup-lock.js.map

package/dist/embedding/setup-lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-lock.js","sourceRoot":"","sources":["../../src/embedding/setup-lock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,2BAA2B,EAAE,yBAAyB,EAAwB,MAAM,oBAAoB,CAAC;AAClH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAO5C,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,UAA2B,EAAE;IAC3E,MAAM,KAAK,CAAC,2BAA2B,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACpF,MAAM,QAAQ,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAC;IACpD,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;QAC3C,MAAM,MAAM,CAAC,SAAS,CAAC,GAAG,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACtD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC;YAAC,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,gCAAgC,CAAC,CAAC;QACzE,IAAI,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACpG,MAAM,IAAI,YAAY,CAAC,UAAU,EAAE,gDAAgD,CAAC,CAAC;QACvF,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IACD,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,IAAI,QAAQ;gBAAE,OAAO;YACrB,QAAQ,GAAG,IAAI,CAAC;YAChB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YACrB,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;QACzB,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/embedding/setup-service.d.ts

@@ -0,0 +1,53 @@
+import { type InstalledModel } from './model-installation.js';
+import { LOCAL_SMALL_PRESET } from './presets/local-small.js';
+import type { ModelDownloader, ModelDownloadProgress } from './model-download.js';
+import type { SqliteDatabase } from '../db/adapter.js';
+import type { EmbeddingProvider } from './types.js';
+import type { PathEnvironment } from '../config/paths.js';
+export interface EmbeddingSetupInput {
+    readonly presetId: string;
+    readonly confirmed: boolean;
+    readonly dryRun: boolean;
+    readonly offline: boolean;
+    readonly replace: boolean;
+}
+export interface EmbeddingSetupResult {
+    readonly presetId: string;
+    readonly model: {
+        readonly repository: string;
+        readonly revision: string;
+        readonly installation: 'installed' | 'reused';
+        readonly bytes: number;
+    };
+    readonly migration: {
+        readonly fromVersion: number;
+        readonly toVersion: number;
+        readonly backupPath: string | null;
+        readonly applied: readonly number[];
+    };
+    readonly profile: {
+        readonly profileId: string;
+        readonly generation: number;
+        readonly activated: boolean;
+    };
+    readonly embeddings: {
+        readonly eligible: number;
+        readonly completed: number;
+        readonly failed: number;
+        readonly blocked: number;
+        readonly remaining: number;
+    };
+    readonly backend: string;
+    readonly semanticEnabled: boolean;
+    readonly restartRequired: boolean;
+}
+export interface EmbeddingSetupOptions extends PathEnvironment {
+    readonly downloader?: ModelDownloader;
+    readonly installer?: (preset: typeof LOCAL_SMALL_PRESET, options: EmbeddingSetupOptions) => Promise<InstalledModel>;
+    readonly provider?: EmbeddingProvider;
+    readonly backendId?: string;
+    readonly now?: () => string;
+    readonly onProgress?: (progress: ModelDownloadProgress) => void;
+}
+export declare function runEmbeddingSetup(database: SqliteDatabase, input: EmbeddingSetupInput, options?: EmbeddingSetupOptions): Promise<EmbeddingSetupResult>;
+//# sourceMappingURL=setup-service.d.ts.map

package/dist/embedding/setup-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-service.d.ts","sourceRoot":"","sources":["../../src/embedding/setup-service.ts"],"names":[],"mappings":"AAQA,OAAO,EAAyB,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACrF,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAG9D,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,YAAY,EAAE,WAAW,GAAG,QAAQ,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAClJ,QAAQ,CAAC,SAAS,EAAE;QAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC;IAC1J,QAAQ,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IAC3G,QAAQ,CAAC,UAAU,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9J,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,qBAAsB,SAAQ,eAAe;IAC5D,QAAQ,CAAC,UAAU,CAAC,EAAE,eAAe,CAAC;IACtC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,kBAAkB,EAAE,OAAO,EAAE,qBAAqB,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IACpH,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,qBAAqB,KAAK,IAAI,CAAC;CACjE;AAgGD,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE,mBAAmB,EAC1B,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,oBAAoB,CAAC,CA0E/B"}

package/dist/embedding/setup-service.js

@@ -0,0 +1,184 @@
+import { createHash, randomUUID } from 'node:crypto';
+import { lstat } from 'node:fs/promises';
+import { withImmediateTransaction } from '../db/transaction.js';
+import { KiokukoError } from '../errors.js';
+import { readEntry } from '../memory/entries.js';
+import { buildCanonicalEmbeddingDocument, renderEmbeddingProviderInput } from './document.js';
+import { claimEmbeddingJobs, failEmbeddingJob, finalizeEmbeddingJob, listEmbeddingJobs } from './jobs.js';
+import { acquireEmbeddingSetupLock } from './setup-lock.js';
+import { installEmbeddingModel } from './model-installation.js';
+import { LOCAL_SMALL_PRESET } from './presets/local-small.js';
+import { createLocalEmbeddingProfile } from './profile.js';
+import { activateLocalEmbeddingProfileInTransaction } from './store.js';
+function now(options) {
+    return options.now?.() ?? new Date().toISOString();
+}
+function setupFailureCode(error) {
+    if (error instanceof KiokukoError && error.code === 'SERVICE_UNAVAILABLE')
+        return 'provider_unavailable';
+    if (error instanceof KiokukoError && error.code === 'VALIDATION_ERROR')
+        return 'dimension_mismatch';
+    return 'provider_unavailable';
+}
+async function installationExists(directory) {
+    try {
+        return (await lstat(directory)).isDirectory();
+    }
+    catch (error) {
+        if (error instanceof Error && 'code' in error && error.code === 'ENOENT')
+            return false;
+        throw error;
+    }
+}
+function installationId(presetId, revision, manifestHash) {
+    return createHash('sha256').update(`${presetId}\u0000${revision}\u0000${manifestHash}`, 'utf8').digest('hex');
+}
+function activateSettings(database, input) {
+    database.prepare(`
+    UPDATE embedding_settings
+       SET mode = 'optional', provider_kind = 'local-transformers', preset_id = ?,
+           model_installation_id = ?, vector_backend = 'auto', batch_size = 16,
+           timeout_ms = 30000, legacy_profile_id = NULL, setup_state = ?, updated_at = ?
+     WHERE singleton = 1
+  `).run(LOCAL_SMALL_PRESET.id, input.installationId, input.setupState, input.now);
+}
+async function drainSetupJobs(database, provider, profileId, generation, options) {
+    let completed = 0;
+    let failed = 0;
+    let blocked = 0;
+    for (let round = 0; round < 3; round += 1) {
+        const jobs = claimEmbeddingJobs(database, { maxJobs: 64, now: now(options) });
+        if (jobs.length === 0)
+            break;
+        for (const job of jobs) {
+            try {
+                const entry = readEntry(database, { workspace: job.workspace, entryId: job.entryId });
+                const canonical = buildCanonicalEmbeddingDocument({
+                    kind: entry.kind,
+                    title: entry.title,
+                    summary: entry.summary,
+                    body: entry.body,
+                    tags: entry.tags,
+                    scope: entry.scope,
+                });
+                const providerInput = renderEmbeddingProviderInput(canonical.text);
+                const vectors = await provider.embed([providerInput]);
+                if (vectors.length !== 1)
+                    throw new KiokukoError('VALIDATION_ERROR', 'Local provider returned an invalid batch');
+                const documentHash = createHash('sha256').update(providerInput, 'utf8').digest('hex');
+                finalizeEmbeddingJob(database, {
+                    entryId: job.entryId,
+                    profileId,
+                    generation,
+                    leaseId: job.leaseId,
+                    revision: job.revision,
+                    contentHash: job.contentHash,
+                    documentHash,
+                    vector: vectors[0],
+                    now: now(options),
+                });
+                completed += 1;
+            }
+            catch (error) {
+                const code = setupFailureCode(error);
+                if (code === 'dimension_mismatch')
+                    blocked += 1;
+                else
+                    failed += 1;
+                failEmbeddingJob(database, {
+                    entryId: job.entryId,
+                    profileId,
+                    generation,
+                    leaseId: job.leaseId,
+                    errorCode: code,
+                    availableAt: now(options),
+                    now: now(options),
+                    permanent: code === 'dimension_mismatch',
+                });
+            }
+        }
+    }
+    const remaining = listEmbeddingJobs(database, { profileId }).filter((job) => job.state !== 'leased').length;
+    return { completed, failed, blocked, remaining };
+}
+export async function runEmbeddingSetup(database, input, options = {}) {
+    if (input.presetId !== LOCAL_SMALL_PRESET.id)
+        throw new KiokukoError('VALIDATION_ERROR', 'Only the local-small embedding preset is supported');
+    if (typeof input.confirmed !== 'boolean' || typeof input.dryRun !== 'boolean' || typeof input.offline !== 'boolean' || typeof input.replace !== 'boolean') {
+        throw new KiokukoError('VALIDATION_ERROR', 'Embedding setup options are invalid');
+    }
+    const eligible = Number(database.prepare('SELECT COUNT(*) AS count FROM entries').get()?.count ?? 0);
+    const fromVersion = Number(database.prepare('SELECT MAX(version) AS version FROM schema_migrations').get()?.version ?? 0);
+    if (input.dryRun) {
+        return {
+            presetId: LOCAL_SMALL_PRESET.id,
+            model: { repository: LOCAL_SMALL_PRESET.artifactRepository, revision: LOCAL_SMALL_PRESET.revision, installation: 'reused', bytes: LOCAL_SMALL_PRESET.files.reduce((sum, file) => sum + file.size, 0) },
+            migration: { fromVersion, toVersion: fromVersion, backupPath: null, applied: [] },
+            profile: { profileId: createLocalEmbeddingProfile(LOCAL_SMALL_PRESET).profileId, generation: 0, activated: false },
+            embeddings: { eligible, completed: 0, failed: 0, blocked: 0, remaining: eligible },
+            backend: options.backendId ?? 'javascript',
+            semanticEnabled: false,
+            restartRequired: false,
+        };
+    }
+    if (!input.confirmed)
+        throw new KiokukoError('USAGE_ERROR', 'Embedding setup requires explicit confirmation');
+    const lock = await acquireEmbeddingSetupLock(options);
+    try {
+        const finalDirectory = (await import('../config/paths.js')).getEmbeddingPresetDirectory(LOCAL_SMALL_PRESET.id, LOCAL_SMALL_PRESET.revision, options);
+        if (input.offline && !(await installationExists(finalDirectory)))
+            throw new KiokukoError('SERVICE_UNAVAILABLE', 'The pinned local embedding model is not installed for offline setup');
+        const installed = await (options.installer ?? installEmbeddingModel)(LOCAL_SMALL_PRESET, {
+            ...options,
+            ...(input.offline ? { downloader: { download: async () => { throw new KiokukoError('SERVICE_UNAVAILABLE', 'Offline setup cannot download the model'); } } } : {}),
+        });
+        const profile = createLocalEmbeddingProfile(LOCAL_SMALL_PRESET);
+        const setupNow = now(options);
+        const setupId = randomUUID();
+        const installation = installationId(LOCAL_SMALL_PRESET.id, LOCAL_SMALL_PRESET.revision, installed.manifestHash);
+        const activation = withImmediateTransaction(database, () => {
+            database.prepare(`
+        INSERT INTO embedding_model_installations (
+          installation_id, preset_id, repository_id, revision, artifact_manifest_hash,
+          relative_path, state, total_bytes, installed_at, verified_at, last_checked_at
+        ) VALUES (?, ?, ?, ?, ?, ?, 'verified', ?, ?, ?, ?)
+        ON CONFLICT(installation_id) DO UPDATE SET state = 'verified', verified_at = excluded.verified_at, last_checked_at = excluded.last_checked_at
+      `).run(installation, LOCAL_SMALL_PRESET.id, LOCAL_SMALL_PRESET.artifactRepository, LOCAL_SMALL_PRESET.revision, installed.manifestHash, installed.relativePath, installed.totalBytes, setupNow, setupNow, setupNow);
+            database.prepare(`
+        INSERT INTO embedding_setup_runs (setup_id, preset_id, phase, initial_entry_count, processed_entry_count, started_at, updated_at)
+        VALUES (?, ?, 'activating', ?, 0, ?, ?)
+      `).run(setupId, LOCAL_SMALL_PRESET.id, eligible, setupNow, setupNow);
+            const result = activateLocalEmbeddingProfileInTransaction(database, profile, { replace: input.replace, now: setupNow });
+            activateSettings(database, { installationId: installation, setupState: 'installing', now: setupNow });
+            database.prepare('UPDATE embedding_setup_runs SET active_profile_id = ?, model_installation_id = ?, phase = \'embedding\', updated_at = ? WHERE setup_id = ?').run(profile.profileId, installation, setupNow, setupId);
+            return result;
+        });
+        const provider = options.provider ?? new (await import('./local-transformers-provider.js')).LocalTransformersEmbeddingProvider({ profile: profile.identity, modelDirectory: installed.directory });
+        let drain;
+        try {
+            drain = await drainSetupJobs(database, provider, profile.profileId, activation.generation, options);
+        }
+        finally {
+            await provider.close?.();
+        }
+        const finalState = drain.remaining === 0 ? 'ready' : 'degraded';
+        withImmediateTransaction(database, () => {
+            activateSettings(database, { installationId: installation, setupState: finalState, now: now(options) });
+            database.prepare('UPDATE embedding_setup_runs SET phase = ?, processed_entry_count = ?, updated_at = ?, completed_at = ? WHERE setup_id = ?').run(finalState === 'ready' ? 'completed' : 'failed', drain.completed, now(options), now(options), setupId);
+        });
+        return {
+            presetId: LOCAL_SMALL_PRESET.id,
+            model: { repository: LOCAL_SMALL_PRESET.artifactRepository, revision: LOCAL_SMALL_PRESET.revision, installation: installed.installation, bytes: installed.totalBytes },
+            migration: { fromVersion, toVersion: fromVersion, backupPath: null, applied: [] },
+            profile: { profileId: profile.profileId, generation: activation.generation, activated: activation.activated },
+            embeddings: { eligible, completed: drain.completed, failed: drain.failed, blocked: drain.blocked, remaining: drain.remaining },
+            backend: options.backendId ?? 'javascript',
+            semanticEnabled: true,
+            restartRequired: true,
+        };
+    }
+    finally {
+        await lock.release();
+    }
+}
+//# sourceMappingURL=setup-service.js.map

package/dist/embedding/setup-service.js.map

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

package/dist/embedding/store.d.ts

@@ -1,5 +1,5 @@
 import type { SqliteDatabase } from '../db/adapter.js';
-import type { EmbeddingProfile } from './types.js';
+import type { EmbeddingProfile, LocalEmbeddingProfile } from './types.js';
 export interface EmbeddingRuntimeState {
     readonly activeProfileId: string | null;
     readonly generation: number;
@@ -55,6 +55,8 @@ export declare function enqueueCurrentEntryEmbeddingInTransaction(database: Sqli
 export declare function enqueueAllCurrentEntryEmbeddingsInTransaction(database: SqliteDatabase, requestedNow?: string, requestedWorkspace?: string): number;
 export declare function activateEmbeddingProfileInTransaction(database: SqliteDatabase, profile: EmbeddingProfile, options: ActivateEmbeddingProfileOptions): EmbeddingProfileActivation;
 export declare function activateEmbeddingProfile(database: SqliteDatabase, profile: EmbeddingProfile, options: ActivateEmbeddingProfileOptions): EmbeddingProfileActivation;
+export declare function activateLocalEmbeddingProfileInTransaction(database: SqliteDatabase, profile: LocalEmbeddingProfile, options: ActivateEmbeddingProfileOptions): EmbeddingProfileActivation;
+export declare function activateLocalEmbeddingProfile(database: SqliteDatabase, profile: LocalEmbeddingProfile, options: ActivateEmbeddingProfileOptions): EmbeddingProfileActivation;
 export declare function upsertEntryEmbeddingInTransaction(database: SqliteDatabase, input: EntryEmbeddingInput): void;
 export declare function upsertEntryEmbedding(database: SqliteDatabase, input: EntryEmbeddingInput): void;
 export declare function readEntryEmbedding(database: SqliteDatabase, input: {

package/dist/embedding/store.d.ts.map

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

package/dist/embedding/store.js

@@ -54,6 +54,32 @@ function entryIdValue(value, label) {
     return value;
 }
 function requireProfileIdentity(identity) {
+    if (identity.schemaVersion === 2) {
+        if (identity.providerKind !== 'local-transformers'
+            || identity.presetId !== 'local-small'
+            || identity.sourceModel !== 'intfloat/multilingual-e5-small'
+            || identity.artifactRepository !== 'Xenova/multilingual-e5-small'
+            || !/^[0-9a-f]{40}$/u.test(identity.modelRevision)
+            || !HASH_PATTERN.test(identity.artifactManifestHash)
+            || identity.inferenceEngine !== 'transformers-js'
+            || identity.inferenceEngineVersion.length === 0
+            || identity.dtype !== 'q8'
+            || identity.pooling !== 'mean'
+            || identity.normalize !== true
+            || identity.maximumTokens !== 512
+            || identity.dimensions !== 384
+            || identity.distanceMetric !== 'cosine'
+            || identity.documentTemplateVersion !== 2
+            || identity.queryTemplateVersion !== 2
+            || identity.inputContract !== 'e5-query-passage-v1'
+            || identity.queryPrefix !== 'query: '
+            || identity.documentPrefix !== 'passage: '
+            || !Number.isFinite(identity.distanceCeiling)
+            || identity.distanceCeiling <= 0 || identity.distanceCeiling >= 2) {
+            invalid('Embedding local profile identity is invalid');
+        }
+        return;
+    }
     if (identity.schemaVersion !== 1
         || identity.providerKind !== 'openai-compatible'
         || !HASH_PATTERN.test(identity.endpointFingerprint)
@@ -82,6 +108,51 @@ function requireProfile(profile) {
     }
 }
 function profileIdentityFromRow(row) {
+    if (row.schema_version === 2) {
+        if (typeof row.profile_id !== 'string' || !HASH_PATTERN.test(row.profile_id)
+            || row.provider_kind !== 'local-transformers' || row.endpoint_fingerprint !== null
+            || row.preset_id !== 'local-small' || row.source_model !== 'intfloat/multilingual-e5-small'
+            || row.artifact_repository !== 'Xenova/multilingual-e5-small'
+            || typeof row.model_revision !== 'string' || !/^[0-9a-f]{40}$/u.test(row.model_revision)
+            || typeof row.artifact_manifest_hash !== 'string' || !HASH_PATTERN.test(row.artifact_manifest_hash)
+            || row.inference_engine !== 'transformers-js'
+            || typeof row.inference_engine_version !== 'string' || row.inference_engine_version.length === 0
+            || row.dtype !== 'q8' || row.pooling !== 'mean' || row.normalize !== 1
+            || row.maximum_tokens !== 512 || row.dimensions !== 384 || row.distance_metric !== 'cosine'
+            || row.document_template_version !== 2 || row.query_template_version !== 2
+            || row.input_contract !== 'e5-query-passage-v1' || row.query_prefix !== 'query: '
+            || row.document_prefix !== 'passage: '
+            || typeof row.distance_ceiling !== 'number' || !Number.isFinite(row.distance_ceiling)
+            || row.distance_ceiling <= 0 || row.distance_ceiling >= 2)
+            integrity('Stored local embedding profile is invalid');
+        const identity = {
+            schemaVersion: 2,
+            providerKind: 'local-transformers',
+            presetId: 'local-small',
+            sourceModel: 'intfloat/multilingual-e5-small',
+            artifactRepository: 'Xenova/multilingual-e5-small',
+            modelRevision: row.model_revision,
+            artifactManifestHash: row.artifact_manifest_hash,
+            inferenceEngine: 'transformers-js',
+            inferenceEngineVersion: row.inference_engine_version,
+            dtype: 'q8',
+            pooling: 'mean',
+            normalize: true,
+            maximumTokens: 512,
+            dimensions: 384,
+            distanceMetric: 'cosine',
+            distanceCeiling: row.distance_ceiling,
+            inputContract: 'e5-query-passage-v1',
+            documentTemplateVersion: 2,
+            queryTemplateVersion: 2,
+            queryPrefix: 'query: ',
+            documentPrefix: 'passage: ',
+        };
+        if (embeddingProfileId(identity) !== row.profile_id)
+            integrity('Stored local embedding profile ID does not match its identity');
+        storedTimestamp(row.created_at, 'embedding profile created_at');
+        return Object.freeze({ profileId: row.profile_id, identity: Object.freeze(identity) });
+    }
     if (typeof row.profile_id !== 'string' || !HASH_PATTERN.test(row.profile_id)
         || row.provider_kind !== 'openai-compatible'
         || typeof row.endpoint_fingerprint !== 'string' || !HASH_PATTERN.test(row.endpoint_fingerprint)
@@ -111,15 +182,7 @@ function profileIdentityFromRow(row) {
     return Object.freeze({ profileId: row.profile_id, identity: Object.freeze(identity) });
 }
 function profileIdentitiesEqual(left, right) {
-    return left.schemaVersion === right.schemaVersion
-        && left.providerKind === right.providerKind
-        && left.endpointFingerprint === right.endpointFingerprint
-        && left.model === right.model
-        && left.dimensions === right.dimensions
-        && left.distanceMetric === right.distanceMetric
-        && left.documentTemplateVersion === right.documentTemplateVersion
-        && left.queryTemplateVersion === right.queryTemplateVersion
-        && left.distanceCeiling === right.distanceCeiling;
+    return left.schemaVersion === right.schemaVersion && embeddingProfileId(left) === embeddingProfileId(right);
 }
 function schemaTables(database) {
     return new Set(database.prepare(`
@@ -147,9 +210,12 @@ function embeddingSchemaInstalled(database) {
 }
 function readProfileRow(database, profileId) {
     const row = database.prepare(`
-    SELECT profile_id, provider_kind, endpoint_fingerprint, model, dimensions,
+    SELECT profile_id, schema_version, provider_kind, endpoint_fingerprint, model, dimensions,
            distance_metric, distance_ceiling, document_template_version,
-           query_template_version, created_at
+           query_template_version, preset_id, source_model, artifact_repository,
+           model_revision, artifact_manifest_hash, inference_engine,
+           inference_engine_version, dtype, pooling, normalize, maximum_tokens,
+           input_contract, query_prefix, document_prefix, created_at
       FROM embedding_profiles
      WHERE profile_id = ?
   `).get(profileId);
@@ -273,6 +339,8 @@ export function enqueueAllCurrentEntryEmbeddingsInTransaction(database, requeste
 }
 export function activateEmbeddingProfileInTransaction(database, profile, options) {
     requireProfile(profile);
+    if (profile.identity.schemaVersion !== 1)
+        invalid('Legacy embedding activation requires a v1 profile identity');
     if (typeof options.replace !== 'boolean')
         invalid('replace must be a boolean');
     const now = validateTimestamp(options.now ?? new Date().toISOString(), 'now');
@@ -313,6 +381,51 @@ export function activateEmbeddingProfileInTransaction(database, profile, options
 export function activateEmbeddingProfile(database, profile, options) {
     return withImmediateTransaction(database, () => activateEmbeddingProfileInTransaction(database, profile, options));
 }
+export function activateLocalEmbeddingProfileInTransaction(database, profile, options) {
+    requireProfile(profile);
+    if (profile.identity.schemaVersion !== 2)
+        invalid('Local embedding activation requires a v2 profile identity');
+    if (typeof options.replace !== 'boolean')
+        invalid('replace must be a boolean');
+    const now = validateTimestamp(options.now ?? new Date().toISOString(), 'now');
+    requireEmbeddingSchema(database);
+    const existing = readProfileRow(database, profile.profileId);
+    if (existing === undefined) {
+        database.prepare(`
+      INSERT INTO embedding_profiles (
+        profile_id, schema_version, provider_kind, endpoint_fingerprint, model,
+        dimensions, distance_metric, distance_ceiling, document_template_version,
+        query_template_version, preset_id, source_model, artifact_repository,
+        model_revision, artifact_manifest_hash, inference_engine,
+        inference_engine_version, dtype, pooling, normalize, maximum_tokens,
+        input_contract, query_prefix, document_prefix, created_at
+      ) VALUES (?, 2, 'local-transformers', NULL, ?, 384, 'cosine', ?, 2, 2,
+        ?, ?, ?, ?, ?, 'transformers-js', ?, 'q8', 'mean', 1, 512,
+        'e5-query-passage-v1', 'query: ', 'passage: ', ?)
+    `).run(profile.profileId, profile.identity.sourceModel, profile.identity.distanceCeiling, profile.identity.presetId, profile.identity.sourceModel, profile.identity.artifactRepository, profile.identity.modelRevision, profile.identity.artifactManifestHash, profile.identity.inferenceEngineVersion, now);
+    }
+    else if (!profileIdentitiesEqual(existing.identity, profile.identity)) {
+        conflict('Embedding profile ID already refers to different profile fields');
+    }
+    const runtime = readEmbeddingRuntimeState(database);
+    if (runtime.activeProfileId === profile.profileId)
+        return { profileId: profile.profileId, generation: runtime.generation, activated: false, enqueued: 0 };
+    if (runtime.activeProfileId !== null && !options.replace)
+        conflict('An active embedding profile already exists; use replace to switch it');
+    const generation = runtime.activeProfileId === null ? runtime.generation : runtime.generation + 1;
+    database.prepare(`
+    UPDATE embedding_runtime SET active_profile_id = ?, generation = ?, activated_at = ?
+     WHERE singleton = 1 AND generation = ?
+  `).run(profile.profileId, generation, now, runtime.generation);
+    const updated = readEmbeddingRuntimeState(database);
+    if (updated.activeProfileId !== profile.profileId || updated.generation !== generation || updated.activatedAt !== now)
+        conflict('Embedding runtime changed while activating a local profile');
+    const enqueued = enqueueAllCurrentEntryEmbeddingsInTransaction(database, now);
+    return { profileId: profile.profileId, generation, activated: true, enqueued };
+}
+export function activateLocalEmbeddingProfile(database, profile, options) {
+    return withImmediateTransaction(database, () => activateLocalEmbeddingProfileInTransaction(database, profile, options));
+}
 function storedEmbedding(row) {
     const entryId = entryIdValue(row.entry_id, 'entryId');
     const profileId = hashValue(row.profile_id, 'profileId');