@askdkc/kiokuko 0.2.6 → 0.2.7

package/dist/embedding/config.js

@@ -0,0 +1,125 @@
+import { KiokukoError } from '../errors.js';
+const DEFAULT_TIMEOUT_MS = 30_000;
+const DEFAULT_BATCH_SIZE = 16;
+const MAX_MODEL_LENGTH = 256;
+const MAX_API_KEY_LENGTH = 4_096;
+const LOOPBACK_HOSTS = new Set(['localhost', '127.0.0.1', '::1']);
+function invalid(message) {
+    throw new KiokukoError('VALIDATION_ERROR', message);
+}
+function enumValue(value, fallback, allowed, field) {
+    const selected = value === undefined ? fallback : value;
+    if (!allowed.includes(selected))
+        invalid(`${field} has an unsupported value`);
+    return selected;
+}
+function boundedText(value, field, maxLength) {
+    const normalized = value.normalize('NFKC').trim();
+    if (normalized.length === 0 || normalized.length > maxLength || /[\u0000-\u001f\u007f]/u.test(normalized)) {
+        invalid(`${field} is invalid`);
+    }
+    return normalized;
+}
+function optionalText(value, field, maxLength) {
+    return value === undefined || value.length === 0 ? undefined : boundedText(value, field, maxLength);
+}
+function integerValue(value, fallback, minimum, maximum, field) {
+    if (value === undefined)
+        return fallback;
+    if (!/^\d+$/u.test(value))
+        invalid(`${field} must be an integer in the supported range`);
+    const parsed = Number(value);
+    if (!Number.isSafeInteger(parsed) || parsed < minimum || parsed > maximum) {
+        invalid(`${field} must be an integer in the supported range`);
+    }
+    return parsed;
+}
+function distanceCeilingValue(value) {
+    if (value === undefined)
+        return undefined;
+    if (!/^(?:\d+\.?\d*|\.\d+)$/u.test(value))
+        invalid('KIOKUKO_EMBEDDING_DISTANCE_CEILING is invalid');
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed) || parsed <= 0 || parsed >= 2) {
+        invalid('KIOKUKO_EMBEDDING_DISTANCE_CEILING is invalid');
+    }
+    return parsed;
+}
+function booleanValue(value, fallback, field) {
+    if (value === undefined)
+        return fallback;
+    if (value !== 'true' && value !== 'false')
+        invalid(`${field} must be true or false`);
+    return value === 'true';
+}
+/** Normalize and validate an embedding endpoint without retaining credentials. */
+export function normalizeEmbeddingBaseUrl(value, allowRemote) {
+    const input = boundedText(value, 'KIOKUKO_EMBEDDING_BASE_URL', 2_048);
+    let url;
+    try {
+        url = new URL(input);
+    }
+    catch {
+        invalid('KIOKUKO_EMBEDDING_BASE_URL must be an absolute URL');
+    }
+    if (url.username !== '' || url.password !== '' || url.search !== '' || url.hash !== '') {
+        invalid('KIOKUKO_EMBEDDING_BASE_URL must not contain credentials, query, or fragment data');
+    }
+    const hostname = url.hostname.replace(/^\[|\]$/gu, '').toLowerCase();
+    if (url.protocol === 'http:') {
+        if (!LOOPBACK_HOSTS.has(hostname))
+            invalid('HTTP embedding endpoints must use a loopback host');
+    }
+    else if (url.protocol === 'https:') {
+        if (!allowRemote)
+            invalid('HTTPS embedding endpoints require explicit remote opt-in');
+    }
+    else {
+        invalid('KIOKUKO_EMBEDDING_BASE_URL must use HTTP or HTTPS');
+    }
+    return url.toString();
+}
+export function isEnabledEmbeddingConfig(config) {
+    return config.mode !== 'off'
+        && config.baseUrl !== undefined
+        && config.model !== undefined
+        && config.dimensions !== undefined
+        && config.distanceCeiling !== undefined;
+}
+export function requireEnabledEmbeddingConfig(config) {
+    if (!isEnabledEmbeddingConfig(config))
+        invalid('Embedding configuration is disabled or incomplete');
+    return config;
+}
+export function parseEmbeddingConfig(environment = process.env) {
+    const mode = enumValue(environment.KIOKUKO_EMBEDDINGS, 'off', ['off', 'optional', 'required'], 'KIOKUKO_EMBEDDINGS');
+    const provider = enumValue(environment.KIOKUKO_EMBEDDING_PROVIDER, 'openai-compatible', ['openai-compatible'], 'KIOKUKO_EMBEDDING_PROVIDER');
+    const allowRemote = booleanValue(environment.KIOKUKO_EMBEDDING_ALLOW_REMOTE, false, 'KIOKUKO_EMBEDDING_ALLOW_REMOTE');
+    const vectorBackend = enumValue(environment.KIOKUKO_VECTOR_BACKEND, 'auto', ['auto', 'javascript', 'sqlite-vec'], 'KIOKUKO_VECTOR_BACKEND');
+    const baseUrl = environment.KIOKUKO_EMBEDDING_BASE_URL === undefined
+        ? undefined
+        : normalizeEmbeddingBaseUrl(environment.KIOKUKO_EMBEDDING_BASE_URL, allowRemote);
+    const model = optionalText(environment.KIOKUKO_EMBEDDING_MODEL, 'KIOKUKO_EMBEDDING_MODEL', MAX_MODEL_LENGTH);
+    const dimensions = integerValue(environment.KIOKUKO_EMBEDDING_DIMENSIONS, 0, 2, 8_192, 'KIOKUKO_EMBEDDING_DIMENSIONS');
+    const configuredDistanceCeiling = distanceCeilingValue(environment.KIOKUKO_EMBEDDING_DISTANCE_CEILING);
+    const timeoutMs = integerValue(environment.KIOKUKO_EMBEDDING_TIMEOUT_MS, DEFAULT_TIMEOUT_MS, 100, 120_000, 'KIOKUKO_EMBEDDING_TIMEOUT_MS');
+    const batchSize = integerValue(environment.KIOKUKO_EMBEDDING_BATCH_SIZE, DEFAULT_BATCH_SIZE, 1, 64, 'KIOKUKO_EMBEDDING_BATCH_SIZE');
+    const apiKey = optionalText(environment.KIOKUKO_EMBEDDING_API_KEY, 'KIOKUKO_EMBEDDING_API_KEY', MAX_API_KEY_LENGTH);
+    if (mode !== 'off' && (baseUrl === undefined || model === undefined || dimensions === 0 || configuredDistanceCeiling === undefined)) {
+        invalid('Enabled embeddings require base URL, model, dimensions, and distance ceiling');
+    }
+    return {
+        mode,
+        provider,
+        ...(baseUrl === undefined ? {} : { baseUrl }),
+        ...(model === undefined ? {} : { model }),
+        ...(dimensions === 0 ? {} : { dimensions }),
+        ...(configuredDistanceCeiling === undefined ? {} : { distanceCeiling: configuredDistanceCeiling }),
+        ...(apiKey === undefined ? {} : { apiKey }),
+        allowRemote,
+        vectorBackend,
+        timeoutMs,
+        batchSize,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/embedding/config.js.map

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

package/dist/embedding/diagnostics.d.ts

@@ -0,0 +1,34 @@
+import type { SqliteDatabase } from '../db/adapter.js';
+import type { EmbeddingConfig, EmbeddingMode, VectorSearchBackend } from './types.js';
+export interface EmbeddingStatus {
+    readonly mode: EmbeddingMode;
+    readonly activeProfileId: string | null;
+    readonly providerKind: string | null;
+    readonly model: string | null;
+    readonly dimensions: number | null;
+    readonly distanceMetric: string | null;
+    readonly distanceCeiling: number | null;
+    readonly backend: string | null;
+    readonly backendVersion: string | null;
+    readonly eligibleEntries: number;
+    readonly readyVectors: number;
+    readonly staleVectors: number;
+    readonly missingVectors: number;
+    readonly pendingJobs: number;
+    readonly leasedJobs: number;
+    readonly failedJobs: number;
+    readonly blockedJobs: number;
+    readonly coverageRatio: number;
+    readonly queryCacheRows: number;
+}
+export interface EmbeddingHealth {
+    readonly status: EmbeddingStatus;
+    readonly check: {
+        readonly ok: boolean;
+        readonly count: number;
+        readonly detail: string;
+    };
+}
+export declare function readEmbeddingStatus(database: SqliteDatabase, config?: EmbeddingConfig, backend?: VectorSearchBackend): EmbeddingStatus;
+export declare function inspectEmbeddingHealth(database: SqliteDatabase, environment?: NodeJS.ProcessEnv, backend?: VectorSearchBackend): EmbeddingHealth;
+//# sourceMappingURL=diagnostics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/embedding/diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAa,MAAM,kBAAkB,CAAC;AAMlE,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAoB,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAgBxG,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;QACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AA+GD,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,cAAc,EACxB,MAAM,GAAE,eAAwC,EAChD,OAAO,CAAC,EAAE,mBAAmB,GAC5B,eAAe,CAOjB;AAyFD,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,cAAc,EACxB,WAAW,GAAE,MAAM,CAAC,UAAwB,EAC5C,OAAO,CAAC,EAAE,mBAAmB,GAC5B,eAAe,CA0CjB"}

package/dist/embedding/diagnostics.js

@@ -0,0 +1,248 @@
+import { KiokukoError } from '../errors.js';
+import { parseEmbeddingConfig, isEnabledEmbeddingConfig } from './config.js';
+import { embeddingProfileId, createEmbeddingProfile } from './profile.js';
+import { readActiveEmbeddingProfile, readEmbeddingRuntimeState } from './store.js';
+import { decodeVector, hashVectorBytes } from './vector.js';
+const EMBEDDING_TABLES = [
+    'embedding_profiles',
+    'embedding_runtime',
+    'entry_embeddings',
+    'embedding_jobs',
+    'query_embeddings',
+];
+const EMBEDDING_INDEXES = [
+    'idx_entry_embeddings_profile_revision',
+    'idx_embedding_jobs_claim',
+    'idx_query_embeddings_lru',
+];
+function countRows(database, sql, ...parameters) {
+    return Number(database.prepare(sql).get(...parameters)?.count ?? 0);
+}
+function objectNames(database, kind) {
+    return new Set(database.prepare(`
+    SELECT name FROM sqlite_schema WHERE type = ? AND name IS NOT NULL
+  `).all(kind).map((row) => row.name));
+}
+function configuredBackend(config, backend) {
+    if (config.mode === 'off')
+        return { id: null, version: null };
+    if (backend !== undefined)
+        return { id: backend.id, version: backend.id === 'sqlite-vec' ? 'v0.1.9' : null };
+    if (config.vectorBackend === 'sqlite-vec')
+        return { id: 'sqlite-vec', version: 'v0.1.9' };
+    return { id: 'javascript', version: null };
+}
+function emptyStatus(config, backend) {
+    const selectedBackend = configuredBackend(config, backend);
+    return {
+        mode: config.mode,
+        activeProfileId: null,
+        providerKind: config.mode === 'off' ? null : config.provider,
+        model: config.model ?? null,
+        dimensions: config.dimensions ?? null,
+        distanceMetric: config.mode === 'off' ? null : 'cosine',
+        distanceCeiling: config.distanceCeiling ?? null,
+        backend: selectedBackend.id,
+        backendVersion: selectedBackend.version,
+        eligibleEntries: 0,
+        readyVectors: 0,
+        staleVectors: 0,
+        missingVectors: 0,
+        pendingJobs: 0,
+        leasedJobs: 0,
+        failedJobs: 0,
+        blockedJobs: 0,
+        coverageRatio: 0,
+        queryCacheRows: 0,
+    };
+}
+function activeStatus(database, config, active, backend) {
+    const selectedBackend = configuredBackend(config, backend);
+    const eligibleEntries = countRows(database, 'SELECT COUNT(*) AS count FROM entries');
+    if (active === null) {
+        return { ...emptyStatus(config, backend), eligibleEntries, missingVectors: eligibleEntries };
+    }
+    const readyVectors = countRows(database, `
+    SELECT COUNT(*) AS count
+      FROM entry_embeddings AS ee
+      JOIN entries AS e ON e.id = ee.entry_id
+      JOIN entry_revisions AS r ON r.entry_id = e.id AND r.revision = e.current_revision
+     WHERE ee.profile_id = ?
+       AND ee.revision = e.current_revision
+       AND ee.content_hash = r.content_hash
+  `, active.profileId);
+    const totalVectors = countRows(database, 'SELECT COUNT(*) AS count FROM entry_embeddings WHERE profile_id = ?', active.profileId);
+    const jobs = new Map(database.prepare(`
+      SELECT state, COUNT(*) AS count
+        FROM embedding_jobs
+       WHERE profile_id = ?
+       GROUP BY state
+    `).all(active.profileId).map((row) => [row.state, Number(row.count)]));
+    const selected = {
+        pending: jobs.get('pending') ?? 0,
+        leased: jobs.get('leased') ?? 0,
+        failed: jobs.get('failed') ?? 0,
+        blocked: jobs.get('blocked') ?? 0,
+    };
+    const queryCacheRows = countRows(database, 'SELECT COUNT(*) AS count FROM query_embeddings WHERE profile_id = ?', active.profileId);
+    return {
+        mode: config.mode,
+        activeProfileId: active.profileId,
+        providerKind: active.identity.providerKind,
+        model: active.identity.model,
+        dimensions: active.identity.dimensions,
+        distanceMetric: active.identity.distanceMetric,
+        distanceCeiling: active.identity.distanceCeiling,
+        backend: selectedBackend.id,
+        backendVersion: selectedBackend.version,
+        eligibleEntries,
+        readyVectors,
+        staleVectors: Math.max(0, totalVectors - readyVectors),
+        missingVectors: Math.max(0, eligibleEntries - readyVectors),
+        pendingJobs: selected.pending,
+        leasedJobs: selected.leased,
+        failedJobs: selected.failed,
+        blockedJobs: selected.blocked,
+        coverageRatio: eligibleEntries === 0 ? 0 : readyVectors / eligibleEntries,
+        queryCacheRows,
+    };
+}
+export function readEmbeddingStatus(database, config = parseEmbeddingConfig(), backend) {
+    const runtime = readEmbeddingRuntimeState(database);
+    const active = readActiveEmbeddingProfile(database);
+    if (active !== null && runtime.activeProfileId !== active.profile.profileId) {
+        throw new KiokukoError('INTEGRITY_ERROR', 'Embedding runtime active profile is inconsistent');
+    }
+    return activeStatus(database, config, active?.profile ?? null, backend);
+}
+function inspectVectors(database) {
+    let findings = 0;
+    const rows = database.prepare(`
+    SELECT entry_id, profile_id, dimensions, embedding, vector_hash
+      FROM entry_embeddings
+     ORDER BY profile_id ASC, entry_id ASC
+  `).all();
+    for (const row of rows) {
+        try {
+            if (typeof row.profile_id !== 'string' || typeof row.dimensions !== 'number' || typeof row.vector_hash !== 'string') {
+                findings += 1;
+                continue;
+            }
+            const bytes = row.embedding instanceof Uint8Array ? row.embedding : null;
+            if (bytes === null || bytes.byteLength !== row.dimensions * 4 || hashVectorBytes(bytes) !== row.vector_hash) {
+                findings += 1;
+                continue;
+            }
+            decodeVector(bytes, row.dimensions, row.vector_hash);
+        }
+        catch {
+            findings += 1;
+        }
+    }
+    return findings;
+}
+function inspectQueryCache(database) {
+    let findings = 0;
+    const rows = database.prepare(`
+    SELECT profile_id, dimensions, embedding, vector_hash
+      FROM query_embeddings
+     ORDER BY profile_id ASC, query_hash ASC
+  `).all();
+    for (const row of rows) {
+        try {
+            if (typeof row.dimensions !== 'number' || typeof row.vector_hash !== 'string' || !(row.embedding instanceof Uint8Array)) {
+                findings += 1;
+                continue;
+            }
+            decodeVector(row.embedding, row.dimensions, row.vector_hash);
+        }
+        catch {
+            findings += 1;
+        }
+    }
+    return findings;
+}
+function inspectJobReferences(database) {
+    return countRows(database, `
+    SELECT COUNT(*) AS count
+      FROM embedding_jobs AS j
+      LEFT JOIN entries AS e ON e.id = j.entry_id
+      LEFT JOIN entry_revisions AS r ON r.entry_id = j.entry_id AND r.revision = j.revision
+     WHERE e.id IS NULL OR r.entry_id IS NULL
+        OR (j.state = 'leased' AND (j.lease_id IS NULL OR j.lease_expires_at IS NULL))
+        OR (j.state <> 'leased' AND (j.lease_id IS NOT NULL OR j.lease_expires_at IS NOT NULL))
+  `);
+}
+function inspectConfiguration(database, config, active, backend) {
+    if (config.mode === 'off')
+        return 0;
+    let findings = 0;
+    if (active === null || !isEnabledEmbeddingConfig(config))
+        findings += 1;
+    else {
+        try {
+            if (embeddingProfileId(createEmbeddingProfile(config).identity) !== active.profile.profileId)
+                findings += 1;
+        }
+        catch {
+            findings += 1;
+        }
+    }
+    if (config.vectorBackend === 'sqlite-vec' && backend?.id !== 'sqlite-vec')
+        findings += 1;
+    return findings;
+}
+function safeConfig(environment) {
+    try {
+        return { config: parseEmbeddingConfig(environment), invalid: false };
+    }
+    catch {
+        return { invalid: true };
+    }
+}
+export function inspectEmbeddingHealth(database, environment = process.env, backend) {
+    const parsed = safeConfig(environment);
+    const config = parsed.config ?? { mode: 'off', provider: 'openai-compatible', allowRemote: false, vectorBackend: 'auto', timeoutMs: 30_000, batchSize: 16 };
+    let status = emptyStatus(config, backend);
+    let findings = parsed.invalid ? 1 : 0;
+    const tables = objectNames(database, 'table');
+    const indexes = objectNames(database, 'index');
+    const triggers = objectNames(database, 'trigger');
+    findings += EMBEDDING_TABLES.filter((name) => !tables.has(name)).length;
+    findings += EMBEDDING_INDEXES.filter((name) => !indexes.has(name)).length;
+    if (!triggers.has('embedding_profiles_immutable_update'))
+        findings += 1;
+    try {
+        const runtime = readEmbeddingRuntimeState(database);
+        const active = readActiveEmbeddingProfile(database);
+        status = activeStatus(database, config, active?.profile ?? null, backend);
+        findings += inspectConfiguration(database, config, active, backend);
+        findings += inspectVectors(database);
+        findings += inspectQueryCache(database);
+        findings += inspectJobReferences(database);
+        const runtimeRows = countRows(database, 'SELECT COUNT(*) AS count FROM embedding_runtime');
+        if (runtimeRows !== 1)
+            findings += 1;
+        const stale = countRows(database, `
+      SELECT COUNT(*) AS count
+        FROM entry_embeddings AS ee
+        JOIN entries AS e ON e.id = ee.entry_id
+        JOIN entry_revisions AS r ON r.entry_id = e.id AND r.revision = e.current_revision
+       WHERE ee.revision != e.current_revision OR ee.content_hash != r.content_hash
+    `);
+        if (stale !== status.staleVectors)
+            findings += 1;
+    }
+    catch {
+        findings += 1;
+    }
+    return {
+        status,
+        check: {
+            ok: findings === 0,
+            count: findings,
+            detail: parsed.invalid ? `findings=${findings}, configuration=invalid` : `findings=${findings}, mode=${config.mode}, backend=${status.backend ?? 'disabled'}`,
+        },
+    };
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/embedding/diagnostics.js.map

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

package/dist/embedding/document.d.ts

@@ -0,0 +1,15 @@
+import { type JsonObject, type EntryKind } from '../serialization/validate.js';
+import type { EmbeddingDocument } from './types.js';
+export declare const EMBEDDING_DOCUMENT_TEMPLATE_VERSION: 1;
+export declare const MAX_EMBEDDING_DOCUMENT_BYTES: number;
+export declare const BODY_TRUNCATION_MARKER: "[body truncated]";
+export interface EmbeddingDocumentInput {
+    readonly kind: EntryKind;
+    readonly title: string;
+    readonly summary: string | null;
+    readonly body: string;
+    readonly tags: readonly string[];
+    readonly scope: JsonObject;
+}
+export declare function buildEmbeddingDocument(input: EmbeddingDocumentInput): EmbeddingDocument;
+//# sourceMappingURL=document.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../src/embedding/document.ts"],"names":[],"mappings":"AAGA,OAAO,EAAoC,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAGjH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,eAAO,MAAM,mCAAmC,EAAG,CAAU,CAAC;AAC9D,eAAO,MAAM,4BAA4B,QAAY,CAAC;AACtD,eAAO,MAAM,sBAAsB,EAAG,kBAA2B,CAAC;AAElE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC5B;AAmDD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,sBAAsB,GAAG,iBAAiB,CA6CvF"}

package/dist/embedding/document.js

@@ -0,0 +1,102 @@
+import { createHash } from 'node:crypto';
+import { TextDecoder, TextEncoder } from 'node:util';
+import { KiokukoError } from '../errors.js';
+import { canonicalJson, canonicalTagOrder } from '../serialization/validate.js';
+import { findSecret } from '../memory/secrets.js';
+import { validateApplicability, validateSignals } from '../memory/structured-memory.js';
+export const EMBEDDING_DOCUMENT_TEMPLATE_VERSION = 1;
+export const MAX_EMBEDDING_DOCUMENT_BYTES = 32 * 1024;
+export const BODY_TRUNCATION_MARKER = '[body truncated]';
+const encoder = new TextEncoder();
+const decoder = new TextDecoder('utf-8', { fatal: true });
+function invalid(message) {
+    throw new KiokukoError('VALIDATION_ERROR', message);
+}
+function normalizeText(value, field) {
+    const normalized = value.normalize('NFKC').replaceAll('\r\n', '\n').replaceAll('\r', '\n');
+    if (/[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f]/u.test(normalized))
+        invalid(`${field} contains a forbidden control character`);
+    return normalized;
+}
+function normalizedTagList(tags) {
+    for (const tag of tags) {
+        if (typeof tag !== 'string' || tag.trim().length === 0 || tag.length > 200)
+            invalid('Embedding document tags are invalid');
+    }
+    return canonicalTagOrder(tags.map((tag) => normalizeText(tag, 'tag')));
+}
+function structuredScope(scope) {
+    const candidate = scope;
+    if (candidate.schemaVersion !== 2 && candidate.schemaVersion !== 3)
+        return { applicability: {}, signals: {} };
+    const applicability = candidate.applicability === undefined ? {} : validateApplicability(candidate.applicability);
+    const signals = candidate.signals === undefined ? {} : validateSignals(candidate.signals);
+    return {
+        applicability: applicability,
+        signals: signals,
+    };
+}
+function truncateUtf8(value, maxBytes) {
+    if (encoder.encode(value).byteLength <= maxBytes)
+        return value;
+    const bytes = encoder.encode(value);
+    let end = Math.min(bytes.byteLength, maxBytes);
+    while (end > 0) {
+        try {
+            return decoder.decode(bytes.subarray(0, end));
+        }
+        catch {
+            end -= 1;
+        }
+    }
+    return '';
+}
+function documentHash(bytes) {
+    return createHash('sha256').update(bytes).digest('hex');
+}
+export function buildEmbeddingDocument(input) {
+    if (input.kind !== 'fact' && input.kind !== 'decision' && input.kind !== 'lesson' && input.kind !== 'preference' && input.kind !== 'reference') {
+        invalid('Embedding document kind is invalid');
+    }
+    const title = normalizeText(input.title, 'title').trim();
+    const summary = input.summary === null ? '' : normalizeText(input.summary, 'summary').trim();
+    const body = normalizeText(input.body, 'body');
+    const tags = normalizedTagList(input.tags);
+    const { applicability, signals } = structuredScope(input.scope);
+    const metadataText = [
+        'kiokuko-memory-v1',
+        `kind: ${input.kind}`,
+        `title: ${title}`,
+        `summary: ${summary}`,
+        'tags:',
+        ...tags.map((tag) => `- ${tag}`),
+        'applicability:',
+        canonicalJson(applicability),
+        'signals:',
+        canonicalJson(signals),
+        'body:',
+    ].join('\n') + '\n';
+    const metadataBytes = encoder.encode(metadataText);
+    if (metadataBytes.byteLength >= MAX_EMBEDDING_DOCUMENT_BYTES) {
+        invalid('Embedding document metadata exceeds the byte limit');
+    }
+    const bodyBytes = encoder.encode(body);
+    let text = metadataText + body;
+    let truncated = false;
+    if (metadataBytes.byteLength + bodyBytes.byteLength > MAX_EMBEDDING_DOCUMENT_BYTES) {
+        const marker = `\n${BODY_TRUNCATION_MARKER}`;
+        const markerBytes = encoder.encode(marker);
+        const available = MAX_EMBEDDING_DOCUMENT_BYTES - metadataBytes.byteLength - markerBytes.byteLength;
+        if (available < 0)
+            invalid('Embedding document metadata exceeds the byte limit');
+        text = metadataText + truncateUtf8(body, available) + marker;
+        truncated = true;
+    }
+    const bytes = encoder.encode(text);
+    const secretFinding = findSecret(text);
+    if (secretFinding !== undefined) {
+        throw new KiokukoError('SECURITY_REJECTION', 'Embedding document resembles a secret and was not sent');
+    }
+    return Object.freeze({ text, bytes, documentHash: documentHash(bytes), truncated });
+}
+//# sourceMappingURL=document.js.map

package/dist/embedding/document.js.map

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

package/dist/embedding/javascript-backend.d.ts

@@ -0,0 +1,11 @@
+import type { SqliteDatabase } from '../db/adapter.js';
+import type { VectorHit, VectorSearchBackend, VectorSearchInput } from './types.js';
+export declare const JAVASCRIPT_BACKEND_ID = "javascript";
+export declare const MAX_JAVASCRIPT_BACKEND_ENTRIES = 10000;
+export declare const MAX_VECTOR_SEARCH_LIMIT = 120;
+export declare class JavaScriptVectorSearchBackend implements VectorSearchBackend {
+    readonly id = "javascript";
+    search(database: SqliteDatabase, input: VectorSearchInput): VectorHit[];
+}
+export declare const createJavaScriptVectorSearchBackend: () => VectorSearchBackend;
+//# sourceMappingURL=javascript-backend.d.ts.map

package/dist/embedding/javascript-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"javascript-backend.d.ts","sourceRoot":"","sources":["../../src/embedding/javascript-backend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAa,MAAM,kBAAkB,CAAC;AAIlE,OAAO,KAAK,EAAE,SAAS,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpF,eAAO,MAAM,qBAAqB,eAAe,CAAC;AAClD,eAAO,MAAM,8BAA8B,QAAS,CAAC;AACrD,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAqH3C,qBAAa,6BAA8B,YAAW,mBAAmB;IACvE,QAAQ,CAAC,EAAE,gBAAyB;IAEpC,MAAM,CAAC,QAAQ,EAAE,cAAc,EAAE,KAAK,EAAE,iBAAiB,GAAG,SAAS,EAAE;CAgDxE;AAED,eAAO,MAAM,mCAAmC,QAAO,mBAA0D,CAAC"}