kiokuko-dsh 0.1.0

package/dist/embedding/presets/local-small.js

@@ -0,0 +1,67 @@
+/**
+ * The only public local model preset. Every artifact coordinate is immutable;
+ * model installation code must consume this value rather than user input.
+ */
+export const LOCAL_SMALL_PRESET = Object.freeze({
+    id: 'local-small',
+    schemaVersion: 1,
+    displayName: 'multilingual-e5-small',
+    sourceModel: 'intfloat/multilingual-e5-small',
+    artifactRepository: 'Xenova/multilingual-e5-small',
+    revision: 'ae61bf0193ce3851dc8a45147e459b04ed783d8a',
+    transformersJsVersion: '4.2.0',
+    dimensions: 384,
+    maximumTokens: 512,
+    dtype: 'q8',
+    pooling: 'mean',
+    normalize: true,
+    distanceMetric: 'cosine',
+    distanceCeiling: 0.8,
+    inputContract: 'e5-query-passage-v1',
+    queryPrefix: 'query: ',
+    documentPrefix: 'passage: ',
+    files: Object.freeze([
+        {
+            path: 'README.md',
+            size: 553,
+            sha256: '000754b7b0eb4d281504ade130052d4ce887d132bb5c8a77ed53f1926b910f8b',
+        },
+        {
+            path: 'config.json',
+            size: 658,
+            sha256: 'cb99455288675345e1a4f411438d5d0adbba5fbd3a67ea4fb03c015433b996c1',
+        },
+        {
+            path: 'quant_config.json',
+            size: 674,
+            sha256: '59d175f15264115f18c698d76e443b5d49fc6c8c599911c421405ef4f236e87d',
+        },
+        {
+            path: 'tokenizer.json',
+            size: 17_082_730,
+            sha256: '0b44a9d7b51c3c62626640cda0e2c2f70fdacdc25bbbd68038369d14ebdf4c39',
+        },
+        {
+            path: 'tokenizer_config.json',
+            size: 443,
+            sha256: 'a1d6bc8734a6f635dc158508bef000f8e2e5a759c7d92f984b2c86e5ff53425b',
+        },
+        {
+            path: 'special_tokens_map.json',
+            size: 167,
+            sha256: 'd05497f1da52c5e09554c0cd874037a083e1dc1b9cfd48034d1c717f1afc07a7',
+        },
+        {
+            path: 'sentencepiece.bpe.model',
+            size: 5_069_051,
+            sha256: 'cfc8146abe2a0488e9e2a0c56de7952f7c11ab059eca145a0a727afce0db2865',
+        },
+        {
+            path: 'onnx/model_quantized.onnx',
+            size: 118_308_185,
+            sha256: 'f80102d3f2a1229f387d3c81909990d8945513e347b0eab049f7de3c6f98c193',
+        },
+    ]),
+});
+export const LOCAL_SMALL_PRESET_MANIFEST_HASH = '85d724217ffdda4333b6c2892f5138754d716f62e08a82cb0093ca5baca24fe4';
+//# sourceMappingURL=local-small.js.map

package/dist/embedding/presets/local-small.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-small.js","sourceRoot":"","sources":["../../../src/embedding/presets/local-small.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAyB,MAAM,CAAC,MAAM,CAAC;IACpE,EAAE,EAAE,aAAa;IACjB,aAAa,EAAE,CAAC;IAChB,WAAW,EAAE,uBAAuB;IACpC,WAAW,EAAE,gCAAgC;IAC7C,kBAAkB,EAAE,8BAA8B;IAClD,QAAQ,EAAE,0CAA0C;IACpD,qBAAqB,EAAE,OAAO;IAC9B,UAAU,EAAE,GAAG;IACf,aAAa,EAAE,GAAG;IAClB,KAAK,EAAE,IAAI;IACX,OAAO,EAAE,MAAM;IACf,SAAS,EAAE,IAAI;IACf,cAAc,EAAE,QAAQ;IACxB,eAAe,EAAE,GAAG;IACpB,aAAa,EAAE,qBAAqB;IACpC,WAAW,EAAE,SAAS;IACtB,cAAc,EAAE,WAAW;IAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;QACnB;YACE,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,GAAG;YACT,MAAM,EAAE,kEAAkE;SAC3E;QACD;YACE,IAAI,EAAE,aAAa;YACnB,IAAI,EAAE,GAAG;YACT,MAAM,EAAE,kEAAkE;SAC3E;QACD;YACE,IAAI,EAAE,mBAAmB;YACzB,IAAI,EAAE,GAAG;YACT,MAAM,EAAE,kEAAkE;SAC3E;QACD;YACE,IAAI,EAAE,gBAAgB;YACtB,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,kEAAkE;SAC3E;QACD;YACE,IAAI,EAAE,uBAAuB;YAC7B,IAAI,EAAE,GAAG;YACT,MAAM,EAAE,kEAAkE;SAC3E;QACD;YACE,IAAI,EAAE,yBAAyB;YAC/B,IAAI,EAAE,GAAG;YACT,MAAM,EAAE,kEAAkE;SAC3E;QACD;YACE,IAAI,EAAE,yBAAyB;YAC/B,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,kEAAkE;SAC3E;QACD;YACE,IAAI,EAAE,2BAA2B;YACjC,IAAI,EAAE,WAAW;YACjB,MAAM,EAAE,kEAAkE;SAC3E;KACF,CAAC;CACH,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gCAAgC,GAC3C,kEAAkE,CAAC"}

package/dist/embedding/presets/manifest.d.ts

@@ -0,0 +1,27 @@
+export interface LocalEmbeddingPresetFile {
+    readonly path: string;
+    readonly size: number;
+    readonly sha256: string;
+}
+export interface LocalEmbeddingPreset {
+    readonly id: 'local-small';
+    readonly schemaVersion: 1;
+    readonly displayName: string;
+    readonly sourceModel: 'intfloat/multilingual-e5-small';
+    readonly artifactRepository: 'Xenova/multilingual-e5-small';
+    readonly revision: string;
+    readonly transformersJsVersion: string;
+    readonly dimensions: 384;
+    readonly maximumTokens: 512;
+    readonly dtype: 'q8';
+    readonly pooling: 'mean';
+    readonly normalize: true;
+    readonly distanceMetric: 'cosine';
+    readonly distanceCeiling: number;
+    readonly inputContract: 'e5-query-passage-v1';
+    readonly queryPrefix: 'query: ';
+    readonly documentPrefix: 'passage: ';
+    readonly files: readonly LocalEmbeddingPresetFile[];
+}
+export declare function presetManifestHash(preset: LocalEmbeddingPreset): string;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/embedding/presets/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/embedding/presets/manifest.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,EAAE,aAAa,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,gCAAgC,CAAC;IACvD,QAAQ,CAAC,kBAAkB,EAAE,8BAA8B,CAAC;IAC5D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,GAAG,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,qBAAqB,CAAC;IAC9C,QAAQ,CAAC,WAAW,EAAE,SAAS,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,SAAS,wBAAwB,EAAE,CAAC;CACrD;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAEvE"}

package/dist/embedding/presets/manifest.js

@@ -0,0 +1,5 @@
+import { canonicalContentHash } from '../../serialization/validate.js';
+export function presetManifestHash(preset) {
+    return canonicalContentHash(preset);
+}
+//# sourceMappingURL=manifest.js.map

package/dist/embedding/presets/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../../src/embedding/presets/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AA6BvE,MAAM,UAAU,kBAAkB,CAAC,MAA4B;IAC7D,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC;AACtC,CAAC"}

package/dist/embedding/profile.d.ts

@@ -0,0 +1,10 @@
+import type { EmbeddingConfig, EmbeddingProfile, EmbeddingProfileIdentity, EnabledEmbeddingConfig, LocalEmbeddingProfile, LocalEmbeddingProfileIdentity } from './types.js';
+import type { LocalEmbeddingPreset } from './presets/manifest.js';
+export declare function endpointFingerprint(endpoint: string): string;
+export declare function embeddingProfileId(identity: EmbeddingProfileIdentity | LocalEmbeddingProfileIdentity): string;
+export declare function localEmbeddingProfileId(identity: LocalEmbeddingProfileIdentity): string;
+export declare function createEmbeddingProfileIdentity(config: EnabledEmbeddingConfig): EmbeddingProfileIdentity;
+export declare function createEmbeddingProfile(config: EmbeddingConfig): EmbeddingProfile;
+export declare function createLocalEmbeddingProfileIdentity(preset: LocalEmbeddingPreset, inferenceEngineVersion?: string): LocalEmbeddingProfileIdentity;
+export declare function createLocalEmbeddingProfile(preset: LocalEmbeddingPreset, inferenceEngineVersion?: string): LocalEmbeddingProfile;
+//# sourceMappingURL=profile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../../src/embedding/profile.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,6BAA6B,EAC9B,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAOlE,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,wBAAwB,GAAG,6BAA6B,GAAG,MAAM,CAE7G;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,6BAA6B,GAAG,MAAM,CAEvF;AAED,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,sBAAsB,GAAG,wBAAwB,CAYvG;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,eAAe,GAAG,gBAAgB,CAIhF;AAED,wBAAgB,mCAAmC,CACjD,MAAM,EAAE,oBAAoB,EAC5B,sBAAsB,SAA+B,GACpD,6BAA6B,CAwB/B;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,oBAAoB,EAC5B,sBAAsB,SAA+B,GACpD,qBAAqB,CAMvB"}

package/dist/embedding/profile.js

@@ -0,0 +1,67 @@
+import { createHash } from 'node:crypto';
+import { canonicalJson } from '../serialization/validate.js';
+import { requireEnabledEmbeddingConfig } from './config.js';
+import { presetManifestHash } from './presets/manifest.js';
+function sha256(value) {
+    return createHash('sha256').update(value).digest('hex');
+}
+export function endpointFingerprint(endpoint) {
+    return sha256(endpoint);
+}
+export function embeddingProfileId(identity) {
+    return sha256(canonicalJson(identity));
+}
+export function localEmbeddingProfileId(identity) {
+    return sha256(canonicalJson(identity));
+}
+export function createEmbeddingProfileIdentity(config) {
+    return {
+        schemaVersion: 1,
+        providerKind: config.provider,
+        endpointFingerprint: endpointFingerprint(config.baseUrl),
+        model: config.model,
+        dimensions: config.dimensions,
+        distanceMetric: 'cosine',
+        documentTemplateVersion: 1,
+        queryTemplateVersion: 1,
+        distanceCeiling: config.distanceCeiling,
+    };
+}
+export function createEmbeddingProfile(config) {
+    const enabled = requireEnabledEmbeddingConfig(config);
+    const identity = createEmbeddingProfileIdentity(enabled);
+    return Object.freeze({ profileId: embeddingProfileId(identity), identity: Object.freeze(identity) });
+}
+export function createLocalEmbeddingProfileIdentity(preset, inferenceEngineVersion = preset.transformersJsVersion) {
+    return {
+        schemaVersion: 2,
+        providerKind: 'local-transformers',
+        presetId: preset.id,
+        sourceModel: preset.sourceModel,
+        artifactRepository: preset.artifactRepository,
+        modelRevision: preset.revision,
+        artifactManifestHash: presetManifestHash(preset),
+        inferenceEngine: 'transformers-js',
+        inferenceEngineVersion,
+        dtype: preset.dtype,
+        pooling: preset.pooling,
+        normalize: preset.normalize,
+        maximumTokens: preset.maximumTokens,
+        dimensions: preset.dimensions,
+        distanceMetric: preset.distanceMetric,
+        distanceCeiling: preset.distanceCeiling,
+        inputContract: preset.inputContract,
+        documentTemplateVersion: 2,
+        queryTemplateVersion: 2,
+        queryPrefix: preset.queryPrefix,
+        documentPrefix: preset.documentPrefix,
+    };
+}
+export function createLocalEmbeddingProfile(preset, inferenceEngineVersion = preset.transformersJsVersion) {
+    const identity = createLocalEmbeddingProfileIdentity(preset, inferenceEngineVersion);
+    return Object.freeze({
+        profileId: localEmbeddingProfileId(identity),
+        identity: Object.freeze(identity),
+    });
+}
+//# sourceMappingURL=profile.js.map

package/dist/embedding/profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.js","sourceRoot":"","sources":["../../src/embedding/profile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAC;AAU5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D,SAAS,MAAM,CAAC,KAA0B;IACxC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAClD,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,QAAkE;IACnG,OAAO,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,QAAuC;IAC7E,OAAO,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,MAA8B;IAC3E,OAAO;QACL,aAAa,EAAE,CAAC;QAChB,YAAY,EAAE,MAAM,CAAC,QAAQ;QAC7B,mBAAmB,EAAE,mBAAmB,CAAC,MAAM,CAAC,OAAO,CAAC;QACxD,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,cAAc,EAAE,QAAQ;QACxB,uBAAuB,EAAE,CAAC;QAC1B,oBAAoB,EAAE,CAAC;QACvB,eAAe,EAAE,MAAM,CAAC,eAAe;KACxC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,MAAuB;IAC5D,MAAM,OAAO,GAAG,6BAA6B,CAAC,MAAM,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,8BAA8B,CAAC,OAAO,CAAC,CAAC;IACzD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,kBAAkB,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AACvG,CAAC;AAED,MAAM,UAAU,mCAAmC,CACjD,MAA4B,EAC5B,sBAAsB,GAAG,MAAM,CAAC,qBAAqB;IAErD,OAAO;QACL,aAAa,EAAE,CAAC;QAChB,YAAY,EAAE,oBAAoB;QAClC,QAAQ,EAAE,MAAM,CAAC,EAAE;QACnB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;QAC7C,aAAa,EAAE,MAAM,CAAC,QAAQ;QAC9B,oBAAoB,EAAE,kBAAkB,CAAC,MAAM,CAAC;QAChD,eAAe,EAAE,iBAAiB;QAClC,sBAAsB;QACtB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,eAAe,EAAE,MAAM,CAAC,eAAe;QACvC,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,uBAAuB,EAAE,CAAC;QAC1B,oBAAoB,EAAE,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,cAAc,EAAE,MAAM,CAAC,cAAc;KACtC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,MAA4B,EAC5B,sBAAsB,GAAG,MAAM,CAAC,qBAAqB;IAErD,MAAM,QAAQ,GAAG,mCAAmC,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IACrF,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,SAAS,EAAE,uBAAuB,CAAC,QAAQ,CAAC;QAC5C,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;KAClC,CAAC,CAAC;AACL,CAAC"}

package/dist/embedding/provider.d.ts

@@ -0,0 +1,13 @@
+import type { EmbeddingProvider } from './types.js';
+export type EmbeddingProviderFailureCode = 'timeout' | 'rate_limited' | 'provider_unavailable' | 'invalid_response' | 'dimension_mismatch' | 'secret_blocked';
+/** A provider failure contains only a stable classification, never remote data. */
+export declare class EmbeddingProviderError extends Error {
+    readonly code: EmbeddingProviderFailureCode;
+    readonly retryable: boolean;
+    readonly retryAfterMs: number | null;
+    readonly name = "EmbeddingProviderError";
+    constructor(code: EmbeddingProviderFailureCode, retryable: boolean, retryAfterMs?: number | null);
+}
+export declare function isEmbeddingProviderError(value: unknown): value is EmbeddingProviderError;
+export type { EmbeddingProvider };
+//# sourceMappingURL=provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/embedding/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,MAAM,4BAA4B,GACpC,SAAS,GACT,cAAc,GACd,sBAAsB,GACtB,kBAAkB,GAClB,oBAAoB,GACpB,gBAAgB,CAAC;AAErB,mFAAmF;AACnF,qBAAa,sBAAuB,SAAQ,KAAK;IAI7C,QAAQ,CAAC,IAAI,EAAE,4BAA4B;IAC3C,QAAQ,CAAC,SAAS,EAAE,OAAO;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IALtC,SAAkB,IAAI,4BAA4B;gBAGvC,IAAI,EAAE,4BAA4B,EAClC,SAAS,EAAE,OAAO,EAClB,YAAY,GAAE,MAAM,GAAG,IAAW;CAI9C;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,sBAAsB,CAExF;AAED,YAAY,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/embedding/provider.js

@@ -0,0 +1,17 @@
+/** A provider failure contains only a stable classification, never remote data. */
+export class EmbeddingProviderError extends Error {
+    code;
+    retryable;
+    retryAfterMs;
+    name = 'EmbeddingProviderError';
+    constructor(code, retryable, retryAfterMs = null) {
+        super(code);
+        this.code = code;
+        this.retryable = retryable;
+        this.retryAfterMs = retryAfterMs;
+    }
+}
+export function isEmbeddingProviderError(value) {
+    return value instanceof EmbeddingProviderError;
+}
+//# sourceMappingURL=provider.js.map

package/dist/embedding/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/embedding/provider.ts"],"names":[],"mappings":"AAUA,mFAAmF;AACnF,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAIpC;IACA;IACA;IALO,IAAI,GAAG,wBAAwB,CAAC;IAElD,YACW,IAAkC,EAClC,SAAkB,EAClB,eAA8B,IAAI;QAE3C,KAAK,CAAC,IAAI,CAAC,CAAC;QAJH,SAAI,GAAJ,IAAI,CAA8B;QAClC,cAAS,GAAT,SAAS,CAAS;QAClB,iBAAY,GAAZ,YAAY,CAAsB;IAG7C,CAAC;CACF;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAc;IACrD,OAAO,KAAK,YAAY,sBAAsB,CAAC;AACjD,CAAC"}

package/dist/embedding/query-cache.d.ts

@@ -0,0 +1,45 @@
+import type { SqliteDatabase } from '../db/adapter.js';
+export declare const QUERY_TEMPLATE_VERSION: 1;
+export declare const QUERY_TEMPLATE_VERSION_V2: 2;
+export declare const EMBEDDING_QUERY_INPUT_CONTRACT: "e5-query-passage-v1";
+export declare const MAX_QUERY_TEXT_BYTES: number;
+export declare const QUERY_EMBEDDING_CACHE_LIMIT = 512;
+export interface StoredQueryEmbedding {
+    readonly profileId: string;
+    readonly queryHash: string;
+    readonly dimensions: number;
+    readonly vector: Float32Array;
+    readonly vectorHash: string;
+    readonly createdAt: string;
+    readonly lastUsedAt: string;
+}
+export interface QueryEmbeddingInput {
+    readonly profileId: string;
+    readonly queryHash: string;
+    readonly vector: Float32Array | readonly number[];
+}
+export interface QueryEmbeddingWriteOptions {
+    readonly now?: string;
+    readonly expectedGeneration?: number;
+}
+export declare function normalizeEmbeddingQuery(value: string): string;
+/** Hash only the canonical query template; the raw query is never stored. */
+export declare function queryEmbeddingHash(value: string): string;
+export declare function normalizeCanonicalEmbeddingQuery(value: string): string;
+export declare function renderEmbeddingQueryInput(value: string, prefix?: string): string;
+/** Hash the complete v2 provider input contract without storing raw query text. */
+export declare function queryEmbeddingHashV2(value: string): string;
+export declare const embeddingQueryHash: typeof queryEmbeddingHash;
+export declare function readQueryEmbeddingInTransaction(database: SqliteDatabase, input: {
+    profileId: string;
+    queryHash: string;
+    now?: string;
+}): StoredQueryEmbedding | undefined;
+export declare function readQueryEmbedding(database: SqliteDatabase, input: {
+    profileId: string;
+    queryHash: string;
+    now?: string;
+}): StoredQueryEmbedding | undefined;
+export declare function writeQueryEmbeddingInTransaction(database: SqliteDatabase, input: QueryEmbeddingInput, options?: QueryEmbeddingWriteOptions): StoredQueryEmbedding;
+export declare function writeQueryEmbedding(database: SqliteDatabase, input: QueryEmbeddingInput, options?: QueryEmbeddingWriteOptions): StoredQueryEmbedding;
+//# sourceMappingURL=query-cache.d.ts.map

package/dist/embedding/query-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-cache.d.ts","sourceRoot":"","sources":["../../src/embedding/query-cache.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAa,MAAM,kBAAkB,CAAC;AAKlE,eAAO,MAAM,sBAAsB,EAAG,CAAU,CAAC;AACjD,eAAO,MAAM,yBAAyB,EAAG,CAAU,CAAC;AACpD,eAAO,MAAM,8BAA8B,EAAG,qBAA8B,CAAC;AAC7E,eAAO,MAAM,oBAAoB,QAAY,CAAC;AAC9C,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAM/C,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,MAAM,EAAE,CAAC;CACnD;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CACtC;AAqCD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,SAAY,GAAG,MAAM,CAInF;AAED,mFAAmF;AACnF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ1D;AAED,eAAO,MAAM,kBAAkB,2BAAqB,CAAC;AA2DrD,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5D,oBAAoB,GAAG,SAAS,CAoBlC;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5D,oBAAoB,GAAG,SAAS,CAElC;AAED,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE,mBAAmB,EAC1B,OAAO,GAAE,0BAA+B,GACvC,oBAAoB,CA0BtB;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE,mBAAmB,EAC1B,OAAO,GAAE,0BAA+B,GACvC,oBAAoB,CAEtB"}

package/dist/embedding/query-cache.js

@@ -0,0 +1,181 @@
+import { canonicalContentHash } from '../serialization/validate.js';
+import { validateTimestamp } from '../ledger/validate.js';
+import { withImmediateTransaction } from '../db/transaction.js';
+import { KiokukoError } from '../errors.js';
+import { readEmbeddingProfile, readEmbeddingRuntimeState } from './store.js';
+import { decodeVector, encodeVector, hashVectorBytes } from './vector.js';
+export const QUERY_TEMPLATE_VERSION = 1;
+export const QUERY_TEMPLATE_VERSION_V2 = 2;
+export const EMBEDDING_QUERY_INPUT_CONTRACT = 'e5-query-passage-v1';
+export const MAX_QUERY_TEXT_BYTES = 32 * 1024;
+export const QUERY_EMBEDDING_CACHE_LIMIT = 512;
+const HASH_PATTERN = /^[0-9a-f]{64}$/u;
+const INVALID_CONTROL = /[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f]/u;
+const INVALID_UNICODE = /[\p{Cs}\uFFFD]/u;
+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 hash(value, label) {
+    if (typeof value !== 'string' || !HASH_PATTERN.test(value))
+        invalid(`${label} must be a lowercase SHA-256 hash`);
+    return value;
+}
+function canonicalQueryText(value) {
+    if (typeof value !== 'string')
+        invalid('Query text must be a string');
+    const normalized = value.normalize('NFKC').replaceAll('\r\n', '\n').replaceAll('\r', '\n').trim();
+    if (normalized.length === 0 || INVALID_CONTROL.test(normalized) || INVALID_UNICODE.test(normalized))
+        invalid('Query text is invalid');
+    if (Buffer.byteLength(normalized, 'utf8') > MAX_QUERY_TEXT_BYTES)
+        invalid('Query text exceeds the byte limit');
+    return normalized;
+}
+export function normalizeEmbeddingQuery(value) {
+    return canonicalQueryText(value);
+}
+/** Hash only the canonical query template; the raw query is never stored. */
+export function queryEmbeddingHash(value) {
+    return canonicalContentHash({ templateVersion: QUERY_TEMPLATE_VERSION, text: canonicalQueryText(value) });
+}
+export function normalizeCanonicalEmbeddingQuery(value) {
+    return canonicalQueryText(value);
+}
+export function renderEmbeddingQueryInput(value, prefix = 'query: ') {
+    const normalized = normalizeCanonicalEmbeddingQuery(value);
+    if (prefix !== 'query: ')
+        invalid('Embedding provider query prefix is invalid');
+    return `${prefix}${normalized}`;
+}
+/** Hash the complete v2 provider input contract without storing raw query text. */
+export function queryEmbeddingHashV2(value) {
+    const normalized = normalizeCanonicalEmbeddingQuery(value);
+    return canonicalContentHash({
+        contract: EMBEDDING_QUERY_INPUT_CONTRACT,
+        prefix: 'query: ',
+        templateVersion: QUERY_TEMPLATE_VERSION_V2,
+        text: normalized,
+    });
+}
+export const embeddingQueryHash = queryEmbeddingHash;
+function storedTimestamp(value, label) {
+    if (typeof value !== 'string')
+        integrity(`${label} is invalid`);
+    try {
+        return validateTimestamp(value, label);
+    }
+    catch {
+        integrity(`${label} is invalid`);
+    }
+}
+function storedQueryEmbedding(row) {
+    const profileId = hash(row.profile_id, 'Stored query embedding profile ID');
+    const queryHash = hash(row.query_hash, 'Stored query embedding query hash');
+    if (typeof row.dimensions !== 'number' || !Number.isSafeInteger(row.dimensions) || row.dimensions < 2 || row.dimensions > 8192) {
+        integrity('Stored query embedding dimensions are invalid');
+    }
+    const vectorHash = hash(row.vector_hash, 'Stored query embedding vector hash');
+    let vector;
+    try {
+        vector = decodeVector(row.embedding, row.dimensions, vectorHash);
+    }
+    catch {
+        integrity('Stored query embedding vector is invalid');
+    }
+    const createdAt = storedTimestamp(row.created_at, 'query embedding created_at');
+    const lastUsedAt = storedTimestamp(row.last_used_at, 'query embedding last_used_at');
+    return { profileId, queryHash, dimensions: row.dimensions, vector, vectorHash, createdAt, lastUsedAt };
+}
+function validateWriteInput(input) {
+    return {
+        profileId: hash(input.profileId, 'profileId'),
+        queryHash: hash(input.queryHash, 'queryHash'),
+    };
+}
+function assertExpectedGeneration(database, profileId, expectedGeneration) {
+    if (expectedGeneration === undefined)
+        return;
+    if (!Number.isSafeInteger(expectedGeneration) || expectedGeneration < 1)
+        invalid('expectedGeneration must be a positive integer');
+    const runtime = readEmbeddingRuntimeState(database);
+    if (runtime.activeProfileId !== profileId || runtime.generation !== expectedGeneration) {
+        conflict('Embedding profile changed while writing the query cache');
+    }
+}
+function pruneProfileCache(database, profileId) {
+    database.prepare(`
+    DELETE FROM query_embeddings
+     WHERE profile_id = ?
+       AND query_hash NOT IN (
+         SELECT query_hash
+           FROM query_embeddings
+          WHERE profile_id = ?
+          ORDER BY last_used_at DESC, query_hash ASC
+          LIMIT ?
+       )
+  `).run(profileId, profileId, QUERY_EMBEDDING_CACHE_LIMIT);
+}
+export function readQueryEmbeddingInTransaction(database, input) {
+    const profileId = hash(input.profileId, 'profileId');
+    const queryHash = hash(input.queryHash, 'queryHash');
+    const now = validateTimestamp(input.now ?? new Date().toISOString(), 'now');
+    readEmbeddingRuntimeState(database);
+    const row = database.prepare(`
+    SELECT profile_id, query_hash, dimensions, embedding, vector_hash, created_at, last_used_at
+      FROM query_embeddings
+     WHERE profile_id = ? AND query_hash = ?
+  `).get(profileId, queryHash);
+    if (row === undefined)
+        return undefined;
+    const stored = storedQueryEmbedding(row);
+    const profile = readEmbeddingProfile(database, profileId);
+    if (profile === undefined || profile.identity.dimensions !== stored.dimensions)
+        integrity('Stored query embedding profile is invalid');
+    database.prepare(`
+    UPDATE query_embeddings
+       SET last_used_at = ?
+     WHERE profile_id = ? AND query_hash = ?
+  `).run(now, profileId, queryHash);
+    return { ...stored, lastUsedAt: now, vector: new Float32Array(stored.vector) };
+}
+export function readQueryEmbedding(database, input) {
+    return withImmediateTransaction(database, () => readQueryEmbeddingInTransaction(database, input));
+}
+export function writeQueryEmbeddingInTransaction(database, input, options = {}) {
+    const { profileId, queryHash } = validateWriteInput(input);
+    const now = validateTimestamp(options.now ?? new Date().toISOString(), 'now');
+    assertExpectedGeneration(database, profileId, options.expectedGeneration);
+    const profile = readEmbeddingProfile(database, profileId);
+    if (profile === undefined)
+        throw new KiokukoError('NOT_FOUND', 'Embedding profile not found');
+    const bytes = encodeVector(input.vector, profile.identity.dimensions);
+    const vectorHash = hashVectorBytes(bytes);
+    database.prepare(`
+    INSERT INTO query_embeddings (
+      profile_id, query_hash, dimensions, embedding, vector_hash, created_at, last_used_at
+    ) VALUES (?, ?, ?, ?, ?, ?, ?)
+    ON CONFLICT(profile_id, query_hash) DO UPDATE SET
+      dimensions = excluded.dimensions,
+      embedding = excluded.embedding,
+      vector_hash = excluded.vector_hash,
+      last_used_at = excluded.last_used_at
+  `).run(profileId, queryHash, profile.identity.dimensions, bytes, vectorHash, now, now);
+    pruneProfileCache(database, profileId);
+    const row = database.prepare(`
+    SELECT profile_id, query_hash, dimensions, embedding, vector_hash, created_at, last_used_at
+      FROM query_embeddings
+     WHERE profile_id = ? AND query_hash = ?
+  `).get(profileId, queryHash);
+    if (row === undefined)
+        integrity('Query embedding write could not be read back');
+    return storedQueryEmbedding(row);
+}
+export function writeQueryEmbedding(database, input, options = {}) {
+    return withImmediateTransaction(database, () => writeQueryEmbeddingInTransaction(database, input, options));
+}
+//# sourceMappingURL=query-cache.js.map

package/dist/embedding/query-cache.js.map

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

package/dist/embedding/runtime.d.ts

@@ -0,0 +1,14 @@
+import type { EmbeddingConfig, EmbeddingProfile, EmbeddingProvider, EmbeddingRuntime, VectorSearchBackend } from './types.js';
+import type { SqliteDatabase } from '../db/adapter.js';
+import type { HybridSearchRuntime } from '../memory/hybrid-retrieval.js';
+export interface EmbeddingRuntimeOptions {
+    readonly provider?: EmbeddingProvider;
+    readonly backend?: VectorSearchBackend;
+    readonly now?: () => string;
+    readonly enqueueWrite?: <T>(operation: () => T | PromiseLike<T>) => Promise<T>;
+    readonly profile?: EmbeddingProfile;
+}
+export declare function createEmbeddingRuntime(database: SqliteDatabase, config?: EmbeddingConfig, options?: EmbeddingRuntimeOptions): EmbeddingRuntime;
+/** Convert an owned runtime into the retrieval-only shape consumed by search lanes. */
+export declare function prepareEmbeddingSearchRuntime(runtime: EmbeddingRuntime | undefined, database: SqliteDatabase, text: string): Promise<HybridSearchRuntime>;
+//# sourceMappingURL=runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/embedding/runtime.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EACV,eAAe,EAGf,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAGhB,mBAAmB,EAEpB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAOzE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,OAAO,CAAC,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAC/E,QAAQ,CAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC;CACrC;AA8VD,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,cAAc,EACxB,MAAM,CAAC,EAAE,eAAe,EACxB,OAAO,GAAE,uBAA4B,GACpC,gBAAgB,CA4BlB;AAED,uFAAuF;AACvF,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,gBAAgB,GAAG,SAAS,EACrC,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,mBAAmB,CAAC,CAK9B"}