@askdkc/kiokuko 0.2.6 → 0.2.7

package/dist/embedding/store.d.ts

@@ -0,0 +1,64 @@
+import type { SqliteDatabase } from '../db/adapter.js';
+import type { EmbeddingProfile } from './types.js';
+export interface EmbeddingRuntimeState {
+    readonly activeProfileId: string | null;
+    readonly generation: number;
+    readonly activatedAt: string | null;
+}
+export interface ActiveEmbeddingProfile {
+    readonly profile: EmbeddingProfile;
+    readonly generation: number;
+    readonly activatedAt: string;
+}
+export interface ActivateEmbeddingProfileOptions {
+    readonly replace: boolean;
+    readonly now?: string;
+}
+export interface EmbeddingProfileActivation {
+    readonly profileId: string;
+    readonly generation: number;
+    readonly activated: boolean;
+    readonly enqueued: number;
+}
+export interface CurrentEntryEmbeddingJobInput {
+    readonly entryId: string;
+    readonly revision: number;
+    readonly contentHash: string;
+    readonly now: string;
+}
+export interface EntryEmbeddingInput {
+    readonly entryId: string;
+    readonly profileId: string;
+    readonly revision: number;
+    readonly contentHash: string;
+    readonly documentHash: string;
+    readonly vector: Float32Array | readonly number[];
+    readonly createdAt: string;
+}
+export interface StoredEntryEmbedding {
+    readonly entryId: string;
+    readonly profileId: string;
+    readonly revision: number;
+    readonly contentHash: string;
+    readonly documentHash: string;
+    readonly dimensions: number;
+    readonly vector: Float32Array;
+    readonly vectorHash: string;
+    readonly createdAt: string;
+}
+export declare function readEmbeddingProfile(database: SqliteDatabase, profileId: string): EmbeddingProfile | undefined;
+export declare function readEmbeddingRuntimeState(database: SqliteDatabase): EmbeddingRuntimeState;
+export declare function readActiveEmbeddingProfile(database: SqliteDatabase): ActiveEmbeddingProfile | null;
+/** Enqueue the current entry revision for the active profile inside its caller-owned transaction. */
+export declare function enqueueCurrentEntryEmbeddingInTransaction(database: SqliteDatabase, input: CurrentEntryEmbeddingJobInput): void;
+/** Enqueue every current entry for an already-installed active profile. */
+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 upsertEntryEmbeddingInTransaction(database: SqliteDatabase, input: EntryEmbeddingInput): void;
+export declare function upsertEntryEmbedding(database: SqliteDatabase, input: EntryEmbeddingInput): void;
+export declare function readEntryEmbedding(database: SqliteDatabase, input: {
+    entryId: string;
+    profileId: string;
+}): StoredEntryEmbedding | undefined;
+//# sourceMappingURL=store.d.ts.map

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

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

package/dist/embedding/store.js

@@ -0,0 +1,377 @@
+import { withImmediateTransaction } from '../db/transaction.js';
+import { KiokukoError } from '../errors.js';
+import { validateTimestamp } from '../ledger/validate.js';
+import { requireWorkspace } from '../serialization/validate.js';
+import { embeddingProfileId } from './profile.js';
+import { decodeVector, encodeVector, hashVectorBytes } from './vector.js';
+const HASH_PATTERN = /^[0-9a-f]{64}$/u;
+const EMBEDDING_TABLES = [
+    'embedding_profiles',
+    'embedding_runtime',
+    'entry_embeddings',
+    'embedding_jobs',
+    'query_embeddings',
+];
+function invalid(message) {
+    throw new KiokukoError('VALIDATION_ERROR', message);
+}
+function integrity(message) {
+    throw new KiokukoError('INTEGRITY_ERROR', message);
+}
+function conflict(message) {
+    throw new KiokukoError('CONFLICT', message);
+}
+function positiveInteger(value, label) {
+    if (typeof value !== 'number' || !Number.isSafeInteger(value) || value < 1) {
+        invalid(`${label} must be a positive integer`);
+    }
+    return value;
+}
+function hashValue(value, label) {
+    if (typeof value !== 'string' || !HASH_PATTERN.test(value))
+        invalid(`${label} must be a lowercase SHA-256 hash`);
+    return value;
+}
+function storedHash(value, label) {
+    if (typeof value !== 'string' || !HASH_PATTERN.test(value))
+        integrity(`${label} is invalid`);
+    return value;
+}
+function storedTimestamp(value, label) {
+    if (typeof value !== 'string')
+        integrity(`${label} is invalid`);
+    try {
+        return validateTimestamp(value, label);
+    }
+    catch {
+        integrity(`${label} is invalid`);
+    }
+}
+function entryIdValue(value, label) {
+    if (typeof value !== 'string' || value.length === 0 || value.length > 512 || /[\u0000-\u001f\u007f]/u.test(value)) {
+        invalid(`${label} is invalid`);
+    }
+    return value;
+}
+function requireProfileIdentity(identity) {
+    if (identity.schemaVersion !== 1
+        || identity.providerKind !== 'openai-compatible'
+        || !HASH_PATTERN.test(identity.endpointFingerprint)
+        || typeof identity.model !== 'string'
+        || identity.model.length === 0
+        || identity.model.length > 256
+        || /[\u0000-\u001f\u007f]/u.test(identity.model)
+        || !Number.isSafeInteger(identity.dimensions)
+        || identity.dimensions < 2
+        || identity.dimensions > 8192
+        || identity.distanceMetric !== 'cosine'
+        || identity.documentTemplateVersion !== 1
+        || identity.queryTemplateVersion !== 1
+        || !Number.isFinite(identity.distanceCeiling)
+        || identity.distanceCeiling <= 0
+        || identity.distanceCeiling >= 2) {
+        invalid('Embedding profile identity is invalid');
+    }
+}
+function requireProfile(profile) {
+    if (typeof profile.profileId !== 'string' || !HASH_PATTERN.test(profile.profileId))
+        invalid('Embedding profile ID is invalid');
+    requireProfileIdentity(profile.identity);
+    if (embeddingProfileId(profile.identity) !== profile.profileId) {
+        invalid('Embedding profile ID does not match its identity');
+    }
+}
+function profileIdentityFromRow(row) {
+    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)
+        || typeof row.model !== 'string' || row.model.length === 0 || row.model.length > 256
+        || /[\u0000-\u001f\u007f]/u.test(row.model)
+        || typeof row.dimensions !== 'number' || !Number.isSafeInteger(row.dimensions) || row.dimensions < 2 || row.dimensions > 8192
+        || row.distance_metric !== 'cosine'
+        || typeof row.distance_ceiling !== 'number' || !Number.isFinite(row.distance_ceiling) || row.distance_ceiling <= 0 || row.distance_ceiling >= 2
+        || row.document_template_version !== 1
+        || row.query_template_version !== 1) {
+        integrity('Stored embedding profile is invalid');
+    }
+    const identity = {
+        schemaVersion: 1,
+        providerKind: 'openai-compatible',
+        endpointFingerprint: row.endpoint_fingerprint,
+        model: row.model,
+        dimensions: row.dimensions,
+        distanceMetric: 'cosine',
+        documentTemplateVersion: 1,
+        queryTemplateVersion: 1,
+        distanceCeiling: row.distance_ceiling,
+    };
+    if (embeddingProfileId(identity) !== row.profile_id)
+        integrity('Stored 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) });
+}
+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;
+}
+function schemaTables(database) {
+    return new Set(database.prepare(`
+    SELECT name
+      FROM sqlite_master
+     WHERE type = 'table' AND name IN (${EMBEDDING_TABLES.map(() => '?').join(', ')})
+  `).all(...EMBEDDING_TABLES).map((row) => row.name));
+}
+function requireEmbeddingSchema(database) {
+    const tables = schemaTables(database);
+    const missing = EMBEDDING_TABLES.filter((table) => !tables.has(table));
+    if (missing.length > 0)
+        integrity(`Embedding projection schema is incomplete: missing ${missing.join(', ')}`);
+}
+function embeddingSchemaInstalled(database) {
+    const tables = schemaTables(database);
+    const present = EMBEDDING_TABLES.filter((table) => tables.has(table));
+    if (present.length === 0)
+        return false;
+    if (present.length !== EMBEDDING_TABLES.length) {
+        const missing = EMBEDDING_TABLES.filter((table) => !tables.has(table));
+        integrity(`Embedding projection schema is incomplete: missing ${missing.join(', ')}`);
+    }
+    return true;
+}
+function readProfileRow(database, profileId) {
+    const row = database.prepare(`
+    SELECT profile_id, provider_kind, endpoint_fingerprint, model, dimensions,
+           distance_metric, distance_ceiling, document_template_version,
+           query_template_version, created_at
+      FROM embedding_profiles
+     WHERE profile_id = ?
+  `).get(profileId);
+    return row === undefined ? undefined : profileIdentityFromRow(row);
+}
+export function readEmbeddingProfile(database, profileId) {
+    hashValue(profileId, 'profileId');
+    if (!embeddingSchemaInstalled(database))
+        return undefined;
+    return readProfileRow(database, profileId);
+}
+export function readEmbeddingRuntimeState(database) {
+    requireEmbeddingSchema(database);
+    const rows = database.prepare(`
+    SELECT singleton, active_profile_id, generation, activated_at
+      FROM embedding_runtime
+  `).all();
+    if (rows.length !== 1)
+        integrity('Embedding runtime must contain exactly one singleton row');
+    const row = rows[0];
+    if (row.singleton !== 1
+        || (row.active_profile_id !== null && (typeof row.active_profile_id !== 'string' || !HASH_PATTERN.test(row.active_profile_id)))
+        || typeof row.generation !== 'number'
+        || !Number.isSafeInteger(row.generation)
+        || row.generation < 1
+        || (row.activated_at !== null && typeof row.activated_at !== 'string')) {
+        integrity('Stored embedding runtime is invalid');
+    }
+    const activatedAt = row.activated_at === null ? null : storedTimestamp(row.activated_at, 'embedding runtime activated_at');
+    if ((row.active_profile_id === null) !== (activatedAt === null))
+        integrity('Stored embedding runtime activation state is invalid');
+    if (row.active_profile_id !== null && readProfileRow(database, row.active_profile_id) === undefined) {
+        integrity('Active embedding profile is missing');
+    }
+    return { activeProfileId: row.active_profile_id, generation: row.generation, activatedAt };
+}
+export function readActiveEmbeddingProfile(database) {
+    const runtime = readEmbeddingRuntimeState(database);
+    if (runtime.activeProfileId === null || runtime.activatedAt === null)
+        return null;
+    const profile = readProfileRow(database, runtime.activeProfileId);
+    if (profile === undefined)
+        integrity('Active embedding profile is missing');
+    return Object.freeze({ profile, generation: runtime.generation, activatedAt: runtime.activatedAt });
+}
+function currentEntry(database, entryId) {
+    const row = database.prepare(`
+    SELECT e.current_revision, r.content_hash
+      FROM entries AS e
+      JOIN entry_revisions AS r
+        ON r.entry_id = e.id AND r.revision = e.current_revision
+     WHERE e.id = ?
+  `).get(entryId);
+    if (row === undefined)
+        throw new KiokukoError('NOT_FOUND', 'Entry not found');
+    if (typeof row.current_revision !== 'number' || !Number.isSafeInteger(row.current_revision) || row.current_revision < 1
+        || typeof row.content_hash !== 'string' || row.content_hash.length === 0) {
+        integrity('Current entry embedding source is invalid');
+    }
+    return { revision: row.current_revision, contentHash: row.content_hash };
+}
+function enqueueForProfile(database, profileId, input) {
+    const current = currentEntry(database, input.entryId);
+    if (current.revision !== input.revision || current.contentHash !== input.contentHash) {
+        conflict('Entry changed before its embedding job could be enqueued');
+    }
+    database.prepare(`
+    INSERT INTO embedding_jobs (
+      entry_id, profile_id, revision, content_hash, state, attempts,
+      available_at, lease_id, lease_expires_at, error_code, created_at, updated_at
+    ) VALUES (?, ?, ?, ?, 'pending', 0, ?, NULL, NULL, NULL, ?, ?)
+    ON CONFLICT(entry_id, profile_id) DO UPDATE SET
+      revision = excluded.revision,
+      content_hash = excluded.content_hash,
+      state = 'pending',
+      attempts = 0,
+      available_at = excluded.available_at,
+      lease_id = NULL,
+      lease_expires_at = NULL,
+      error_code = NULL,
+      updated_at = excluded.updated_at
+  `).run(input.entryId, profileId, input.revision, input.contentHash, input.now, input.now, input.now);
+}
+/** Enqueue the current entry revision for the active profile inside its caller-owned transaction. */
+export function enqueueCurrentEntryEmbeddingInTransaction(database, input) {
+    entryIdValue(input.entryId, 'entryId');
+    const revision = positiveInteger(input.revision, 'revision');
+    const contentHash = hashValue(input.contentHash, 'contentHash');
+    const now = validateTimestamp(input.now, 'now');
+    if (!embeddingSchemaInstalled(database))
+        return;
+    const runtime = readEmbeddingRuntimeState(database);
+    if (runtime.activeProfileId === null)
+        return;
+    enqueueForProfile(database, runtime.activeProfileId, { entryId: input.entryId, revision, contentHash, now });
+}
+/** Enqueue every current entry for an already-installed active profile. */
+export function enqueueAllCurrentEntryEmbeddingsInTransaction(database, requestedNow, requestedWorkspace) {
+    if (!embeddingSchemaInstalled(database))
+        return 0;
+    const runtime = readEmbeddingRuntimeState(database);
+    if (runtime.activeProfileId === null)
+        return 0;
+    const now = validateTimestamp(requestedNow ?? new Date().toISOString(), 'now');
+    const workspace = requestedWorkspace === undefined ? undefined : requireWorkspace(requestedWorkspace);
+    const rows = database.prepare(`
+    SELECT e.id, e.current_revision, r.content_hash
+      FROM entries AS e
+      JOIN entry_revisions AS r
+        ON r.entry_id = e.id AND r.revision = e.current_revision
+      ${workspace === undefined ? '' : 'WHERE e.workspace = ?'}
+     ORDER BY e.id ASC
+  `).all(...(workspace === undefined ? [] : [workspace]));
+    for (const row of rows) {
+        const entryId = entryIdValue(row.id, 'entryId');
+        const revision = positiveInteger(row.current_revision, 'revision');
+        const contentHash = hashValue(row.content_hash, 'contentHash');
+        enqueueForProfile(database, runtime.activeProfileId, { entryId, revision, contentHash, now });
+    }
+    return rows.length;
+}
+export function activateEmbeddingProfileInTransaction(database, profile, options) {
+    requireProfile(profile);
+    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 OR IGNORE INTO embedding_profiles (
+        profile_id, provider_kind, endpoint_fingerprint, model, dimensions,
+        distance_metric, distance_ceiling, document_template_version,
+        query_template_version, created_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `).run(profile.profileId, profile.identity.providerKind, profile.identity.endpointFingerprint, profile.identity.model, profile.identity.dimensions, profile.identity.distanceMetric, profile.identity.distanceCeiling, profile.identity.documentTemplateVersion, profile.identity.queryTemplateVersion, 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 profile');
+    }
+    const enqueued = enqueueAllCurrentEntryEmbeddingsInTransaction(database, now);
+    return { profileId: profile.profileId, generation, activated: true, enqueued };
+}
+export function activateEmbeddingProfile(database, profile, options) {
+    return withImmediateTransaction(database, () => activateEmbeddingProfileInTransaction(database, profile, options));
+}
+function storedEmbedding(row) {
+    const entryId = entryIdValue(row.entry_id, 'entryId');
+    const profileId = hashValue(row.profile_id, 'profileId');
+    const revision = positiveInteger(row.revision, 'revision');
+    const contentHash = storedHash(row.content_hash, 'entry embedding content_hash');
+    const documentHash = storedHash(row.document_hash, 'entry embedding document_hash');
+    const dimensions = positiveInteger(row.dimensions, 'dimensions');
+    if (dimensions < 2 || dimensions > 8192)
+        integrity('Stored entry embedding dimensions are invalid');
+    const vectorHash = storedHash(row.vector_hash, 'entry embedding vector_hash');
+    const vector = decodeVector(row.embedding, dimensions, vectorHash);
+    const createdAt = storedTimestamp(row.created_at, 'entry embedding created_at');
+    return { entryId, profileId, revision, contentHash, documentHash, dimensions, vector, vectorHash, createdAt };
+}
+export function upsertEntryEmbeddingInTransaction(database, input) {
+    requireEmbeddingSchema(database);
+    entryIdValue(input.entryId, 'entryId');
+    const profileId = hashValue(input.profileId, 'profileId');
+    const profile = readProfileRow(database, profileId);
+    if (profile === undefined)
+        throw new KiokukoError('NOT_FOUND', 'Embedding profile not found');
+    const revision = positiveInteger(input.revision, 'revision');
+    const contentHash = hashValue(input.contentHash, 'contentHash');
+    const documentHash = hashValue(input.documentHash, 'documentHash');
+    const createdAt = validateTimestamp(input.createdAt, 'createdAt');
+    const current = currentEntry(database, input.entryId);
+    if (current.revision !== revision || current.contentHash !== contentHash) {
+        conflict('Entry changed before its embedding could be stored');
+    }
+    const bytes = encodeVector(input.vector, profile.identity.dimensions);
+    const vectorHash = hashVectorBytes(bytes);
+    database.prepare(`
+    INSERT INTO entry_embeddings (
+      entry_id, profile_id, revision, content_hash, document_hash,
+      dimensions, embedding, vector_hash, created_at
+    ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+    ON CONFLICT(entry_id, profile_id) DO UPDATE SET
+      revision = excluded.revision,
+      content_hash = excluded.content_hash,
+      document_hash = excluded.document_hash,
+      dimensions = excluded.dimensions,
+      embedding = excluded.embedding,
+      vector_hash = excluded.vector_hash,
+      created_at = excluded.created_at
+  `).run(input.entryId, profileId, revision, contentHash, documentHash, profile.identity.dimensions, bytes, vectorHash, createdAt);
+}
+export function upsertEntryEmbedding(database, input) {
+    withImmediateTransaction(database, () => upsertEntryEmbeddingInTransaction(database, input));
+}
+export function readEntryEmbedding(database, input) {
+    requireEmbeddingSchema(database);
+    const entryId = entryIdValue(input.entryId, 'entryId');
+    const profileId = hashValue(input.profileId, 'profileId');
+    const row = database.prepare(`
+    SELECT entry_id, profile_id, revision, content_hash, document_hash,
+           dimensions, embedding, vector_hash, created_at
+      FROM entry_embeddings
+     WHERE entry_id = ? AND profile_id = ?
+  `).get(entryId, profileId);
+    return row === undefined ? undefined : storedEmbedding(row);
+}
+//# sourceMappingURL=store.js.map

package/dist/embedding/store.js.map

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

package/dist/embedding/types.d.ts

@@ -0,0 +1,97 @@
+import type { SqliteDatabase } from '../db/adapter.js';
+export type EmbeddingMode = 'off' | 'optional' | 'required';
+export type VectorBackendPreference = 'auto' | 'javascript' | 'sqlite-vec';
+export type EmbeddingProviderKind = 'openai-compatible';
+export interface EmbeddingConfig {
+    readonly mode: EmbeddingMode;
+    readonly provider: EmbeddingProviderKind;
+    readonly baseUrl?: string;
+    readonly model?: string;
+    readonly dimensions?: number;
+    readonly distanceCeiling?: number;
+    readonly apiKey?: string;
+    readonly allowRemote: boolean;
+    readonly vectorBackend: VectorBackendPreference;
+    readonly timeoutMs: number;
+    readonly batchSize: number;
+}
+export interface EnabledEmbeddingConfig extends EmbeddingConfig {
+    readonly mode: 'optional' | 'required';
+    readonly baseUrl: string;
+    readonly model: string;
+    readonly dimensions: number;
+    readonly distanceCeiling: number;
+}
+export interface EmbeddingProfileIdentity {
+    readonly schemaVersion: 1;
+    readonly providerKind: 'openai-compatible';
+    readonly endpointFingerprint: string;
+    readonly model: string;
+    readonly dimensions: number;
+    readonly distanceMetric: 'cosine';
+    readonly documentTemplateVersion: 1;
+    readonly queryTemplateVersion: 1;
+    readonly distanceCeiling: number;
+}
+export interface EmbeddingProfile {
+    readonly profileId: string;
+    readonly identity: EmbeddingProfileIdentity;
+}
+export interface PreparedSemanticQuery {
+    readonly profileId: string;
+    readonly dimensions: number;
+    readonly vector: Float32Array;
+    readonly vectorHash: string;
+    readonly backendId: string;
+    readonly distanceCeiling: number;
+}
+export interface EmbeddingDocument {
+    readonly text: string;
+    readonly bytes: Uint8Array;
+    readonly documentHash: string;
+    readonly truncated: boolean;
+}
+export interface VectorSearchInput {
+    readonly profileId: string;
+    readonly dimensions: number;
+    readonly queryVector: Float32Array;
+    readonly distanceCeiling: number;
+    readonly workspace?: string;
+    readonly excludedWorkspaces?: readonly string[];
+    readonly limit: number;
+}
+export interface VectorHit {
+    readonly entryId: string;
+    readonly distance: number;
+}
+export interface VectorSearchBackend {
+    readonly id: string;
+    search(database: SqliteDatabase, input: VectorSearchInput): VectorHit[];
+}
+export interface EmbeddingProvider {
+    readonly profile: EmbeddingProfileIdentity;
+    embed(inputs: readonly string[], options?: {
+        signal?: AbortSignal;
+    }): Promise<readonly Float32Array[]>;
+}
+export interface EmbeddingDrainResult {
+    readonly claimed: number;
+    readonly completed: number;
+    readonly failed: number;
+    readonly blocked: number;
+    readonly remaining: number;
+}
+export interface EmbeddingRuntime {
+    readonly mode: EmbeddingMode;
+    readonly profileId: string | null;
+    readonly backendId: string | null;
+    readonly backend: VectorSearchBackend | null;
+    prepareQuery(database: SqliteDatabase, text: string): Promise<PreparedSemanticQuery | null>;
+    drain(options: {
+        workspace?: string;
+        maxJobs: number;
+        deadlineMs: number;
+    }): Promise<EmbeddingDrainResult>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/embedding/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/embedding/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/embedding/types.ts"],"names":[],"mappings":""}

package/dist/embedding/vector.d.ts

@@ -0,0 +1,9 @@
+export declare const MIN_VECTOR_DIMENSIONS = 2;
+export declare const MAX_VECTOR_DIMENSIONS = 8192;
+export declare function normalizeVector(input: Float32Array | readonly number[], expectedDimensions?: number): Float32Array;
+export declare function encodeVector(input: Float32Array | readonly number[], expectedDimensions?: number): Uint8Array;
+export declare function decodeVector(blob: unknown, dimensions: number, expectedHash?: string): Float32Array;
+export declare function hashVectorBytes(bytes: Uint8Array): string;
+export declare function hashVector(input: Float32Array | readonly number[]): string;
+export declare function cosineDistance(left: Float32Array, right: Float32Array): number;
+//# sourceMappingURL=vector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vector.d.ts","sourceRoot":"","sources":["../../src/embedding/vector.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,qBAAqB,IAAI,CAAC;AACvC,eAAO,MAAM,qBAAqB,OAAQ,CAAC;AAyB3C,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,MAAM,EAAE,EAAE,kBAAkB,CAAC,EAAE,MAAM,GAAG,YAAY,CAGlH;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,MAAM,EAAE,EAAE,kBAAkB,CAAC,EAAE,MAAM,GAAG,UAAU,CAQ7G;AASD,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,YAAY,CAWnG;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEzD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,MAAM,EAAE,GAAG,MAAM,CAE1E;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,GAAG,MAAM,CAiB9E"}