@camstack/system 1.2.53 → 1.2.55

package/dist/builtins/sqlite-storage/vector-index-shared.d.ts

@@ -0,0 +1,47 @@
+import { VectorFilter, VectorMetadata, VectorMetric } from '@camstack/types';
+/** Metadata keys promoted to real, indexable columns in every backend. */
+export declare const PROMOTED_COLUMNS: readonly ["deviceId", "timestamp", "className", "modelId"];
+/** A ranked hit as a backend returns it. */
+export interface VectorMatchRow {
+    readonly id: string;
+    /** Similarity, higher is nearer — NOT a distance. Backends convert. */
+    readonly score: number;
+    readonly metadata: VectorMetadata;
+}
+export interface VectorIndexStats {
+    readonly backend: string;
+    readonly count: number;
+    readonly dim: number;
+    readonly metric: VectorMetric;
+    readonly exact: boolean;
+}
+export interface VectorIndexBackend {
+    loadIndexRegistry(): Promise<void>;
+    declareIndex(index: string, dim: number, metric: VectorMetric): Promise<void>;
+    upsert(index: string, items: readonly {
+        id: string;
+        vector: string;
+        metadata: VectorMetadata;
+    }[]): Promise<{
+        upserted: number;
+        rejected: number;
+    }>;
+    query(params: {
+        index: string;
+        vector: string;
+        topK: number;
+        minScore?: number;
+        filter?: VectorFilter;
+    }): Promise<{
+        matches: VectorMatchRow[];
+        scanned: number;
+        truncated: boolean;
+    }>;
+    getByIds(index: string, ids: readonly string[]): Promise<Array<{
+        id: string;
+        metadata: VectorMetadata;
+    }>>;
+    deleteByIds(index: string, ids: readonly string[]): Promise<number>;
+    deleteByFilter(index: string, filter: VectorFilter): Promise<number>;
+    stats(index: string): Promise<VectorIndexStats>;
+}

package/dist/builtins/sqlite-storage/vector-index-vec.d.ts

@@ -0,0 +1,55 @@
+import { IScopedLogger, VectorFilter, VectorMetadata, VectorMetric, encodeVectorBase64 } from '@camstack/types';
+import { VectorIndexStats, VectorMatchRow } from './vector-index-shared.js';
+/** The raw statement surface this index needs from better-sqlite3. */
+export interface RawSqliteDatabase {
+    exec(sql: string): unknown;
+    prepare(sql: string): {
+        run(...params: unknown[]): {
+            changes: number;
+        };
+        all(...params: unknown[]): unknown[];
+        get(...params: unknown[]): unknown;
+    };
+    loadExtension?(path: string): void;
+}
+export interface SqliteVecIndexDeps {
+    readonly db: RawSqliteDatabase;
+    readonly logger: IScopedLogger;
+}
+export declare class SqliteVecVectorIndex {
+    private readonly db;
+    private readonly logger;
+    private readonly specs;
+    constructor(deps: SqliteVecIndexDeps);
+    /** Recover index declarations so an existing table is usable from boot. */
+    loadIndexRegistry(): Promise<void>;
+    declareIndex(index: string, dim: number, metric: VectorMetric): Promise<void>;
+    private specOf;
+    upsert(index: string, items: readonly {
+        id: string;
+        vector: string;
+        metadata: VectorMetadata;
+    }[]): Promise<{
+        upserted: number;
+        rejected: number;
+    }>;
+    query(params: {
+        index: string;
+        vector: string;
+        topK: number;
+        minScore?: number;
+        filter?: VectorFilter;
+    }): Promise<{
+        matches: VectorMatchRow[];
+        scanned: number;
+        truncated: boolean;
+    }>;
+    getByIds(index: string, ids: readonly string[]): Promise<Array<{
+        id: string;
+        metadata: VectorMetadata;
+    }>>;
+    deleteByIds(index: string, ids: readonly string[]): Promise<number>;
+    deleteByFilter(index: string, filter: VectorFilter): Promise<number>;
+    stats(index: string): Promise<VectorIndexStats>;
+}
+export { encodeVectorBase64 };

package/dist/builtins/storage-orchestrator/storage-orchestrator.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-DKJqb0c7.js");
+const require_dist = require("../../dist-CblJsHb-.js");
 let node_path = require("node:path");
 node_path = require_chunk.__toESM(node_path);
 let node_fs_promises = require("node:fs/promises");

package/dist/builtins/storage-orchestrator/storage-orchestrator.addon.mjs

@@ -1,4 +1,4 @@
-import { Mt as parseJsonObject, f as StorageLocationTypeSchema, ft as BaseAddon, rt as storageCapability, tt as settingsStoreCapability } from "../../dist-f_YvZJaQ.mjs";
+import { dt as BaseAddon, et as settingsStoreCapability, f as StorageLocationTypeSchema, jt as parseJsonObject, nt as storageCapability } from "../../dist-BOpRqInW.mjs";
 import * as path$1 from "node:path";
 import * as fs from "node:fs/promises";
 import { buildStorageLocationRegistry } from "@camstack/system";

package/dist/builtins/system-config/system-config.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-DKJqb0c7.js");
+const require_dist = require("../../dist-CblJsHb-.js");
 //#region src/builtins/system-config/system-config.addon.ts
 /**
 * Built-in `system-config` addon — Phase 4 of the settings redesign.

package/dist/builtins/system-config/system-config.addon.mjs

@@ -1,4 +1,4 @@
-import { dt as errMsg, ft as BaseAddon, kt as hydrateSchema } from "../../dist-f_YvZJaQ.mjs";
+import { Ot as hydrateSchema, dt as BaseAddon, ut as errMsg } from "../../dist-BOpRqInW.mjs";
 //#region src/builtins/system-config/system-config.addon.ts
 /**
 * Built-in `system-config` addon — Phase 4 of the settings redesign.

package/dist/builtins/winston-logging/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-DKJqb0c7.js");
+const require_dist = require("../../dist-CblJsHb-.js");
 const require_formatter = require("../../formatter-DqAKDlvN.js");
 let node_path = require("node:path");
 node_path = require_chunk.__toESM(node_path);

package/dist/builtins/winston-logging/index.mjs

@@ -1,4 +1,4 @@
-import { W as logDestinationCapability, ft as BaseAddon } from "../../dist-f_YvZJaQ.mjs";
+import { U as logDestinationCapability, dt as BaseAddon } from "../../dist-BOpRqInW.mjs";
 import { t as formatLogLine } from "../../formatter-B7qW8bPJ.mjs";
 import * as path$1 from "node:path";
 import path from "node:path";

package/dist/{dist-f_YvZJaQ.mjs → dist-BOpRqInW.mjs}

@@ -30289,20 +30289,6 @@ TimelapseRuleInputSchema.extend({
 	createdAt: z.number(),
 	updatedAt: z.number()
 });
-/** Cosine similarity between two embedding vectors */
-function cosineSimilarity(a, b) {
-	if (a.length !== b.length) return 0;
-	let dotProduct = 0;
-	let normA = 0;
-	let normB = 0;
-	for (let i = 0; i < a.length; i++) {
-		dotProduct += a[i] * b[i];
-		normA += a[i] * a[i];
-		normB += b[i] * b[i];
-	}
-	const denom = Math.sqrt(normA) * Math.sqrt(normB);
-	return denom === 0 ? 0 : dotProduct / denom;
-}
 /**
 * Decode base64 little-endian Float32 back into a vector.
 *
@@ -30435,4 +30421,4 @@ function enumerateInferenceDevices(hw) {
 	return out;
 }
 //#endregion
-export { scoreRuntimes as $, enumerateInferenceDevices as A, isDeviceConfigCap as At, isVoidInput as B, cosineSimilarity as C, asNumber as Ct, deviceStateCapability as D, emitReadiness as Dt, deviceManagerCapability as E, emitDownForOwnedCaps as Et, filesystemBrowseCapability as F, resolveCapMount as Ft, logLevelAtMost as G, lifecycleJobSchema as H, getByPath as I, scopeKey as It, normalizeUnit as J, looseSchema as K, isArrayOutputSchema as L, sleep as Lt, enumerateSchemaFields as M, parseJsonObject as Mt, evaluateLinkExpression as N, parseJsonUnknown as Nt, deviceStatusCapability as O, expandCapMethods as Ot, extractNestedAddonId as P, readinessKey as Pt, procedureAuthKey as Q, isCollectionArrayMethod as R, EventCategory as Rt, coreBlocksCapability as S, asJsonObject as St, decodeVectorBase64 as T, createEvent as Tt, localNetworkCapability as U, kebabToCamel as V, logDestinationCapability as W, parseStreamParamsFormPatch as X, objectInputDeclaresAddonId as Y, platformProbeCapability as Z, alertsCapability as _, DeviceRole as _t, CAP_NAMES_WITH_STATUS as a, streamQualityLabel as at, backupCapability as b, ReadinessTimeoutError as bt, METHOD_ACCESS_MAP as c, validateExpressionSource as ct, ScopedTokenSchema as d, errMsg as dt, setByPath as et, StorageLocationTypeSchema as f, BaseAddon as ft, addonWidgetsCapability as g, DeviceFeature as gt, addonSettingsCapability as h, DEVICE_STATUS_METHOD as ht, BatteryStatusSchema as i, storageProviderCapability as it, enumerateItemArrayFields as j, nodePin as jt, doorbellCapability as k, hydrateSchema as kt, RUNTIME_DEFAULTS as l, vectorDimFromBase64 as lt, addonPagesCapability as m, DEVICE_SETTINGS_CONTRIBUTION_METHODS as mt, AlertSchema as n, snapshotCapability as nt, CoreBlockSchema as o, toExpressionValue as ot, UserRecordSchema as p, DATAPLANE_SECRET_HEADER as pt, metricsProviderCapability as q, ApiKeyRecordSchema as r, storageCapability as rt, DeviceStatusSchema as s, userManagementCapability as st, ALL_CAPABILITY_DEFINITIONS as t, settingsStoreCapability as tt, STREAM_PROFILE_META as u, vectorStoreCapability as ut, applyTransform as v, DeviceType as vt, dataStoreProviderCapability as w, asString as wt, buildStreamParamsConfigSchema as x, WELL_KNOWN_TAB_MAP as xt, authProviderCapability as y, ReadinessRegistry as yt, isObjectInput as z };
+export { setByPath as $, enumerateItemArrayFields as A, nodePin as At, kebabToCamel as B, dataStoreProviderCapability as C, asString as Ct, deviceStatusCapability as D, expandCapMethods as Dt, deviceStateCapability as E, emitReadiness as Et, getByPath as F, scopeKey as Ft, looseSchema as G, localNetworkCapability as H, isArrayOutputSchema as I, sleep as It, objectInputDeclaresAddonId as J, metricsProviderCapability as K, isCollectionArrayMethod as L, EventCategory as Lt, evaluateLinkExpression as M, parseJsonUnknown as Mt, extractNestedAddonId as N, readinessKey as Nt, doorbellCapability as O, hydrateSchema as Ot, filesystemBrowseCapability as P, resolveCapMount as Pt, scoreRuntimes as Q, isObjectInput as R, coreBlocksCapability as S, asNumber as St, deviceManagerCapability as T, emitDownForOwnedCaps as Tt, logDestinationCapability as U, lifecycleJobSchema as V, logLevelAtMost as W, platformProbeCapability as X, parseStreamParamsFormPatch as Y, procedureAuthKey as Z, alertsCapability as _, DeviceType as _t, CAP_NAMES_WITH_STATUS as a, toExpressionValue as at, backupCapability as b, WELL_KNOWN_TAB_MAP as bt, METHOD_ACCESS_MAP as c, vectorDimFromBase64 as ct, ScopedTokenSchema as d, BaseAddon as dt, settingsStoreCapability as et, StorageLocationTypeSchema as f, DATAPLANE_SECRET_HEADER as ft, addonWidgetsCapability as g, DeviceRole as gt, addonSettingsCapability as h, DeviceFeature as ht, BatteryStatusSchema as i, streamQualityLabel as it, enumerateSchemaFields as j, parseJsonObject as jt, enumerateInferenceDevices as k, isDeviceConfigCap as kt, RUNTIME_DEFAULTS as l, vectorStoreCapability as lt, addonPagesCapability as m, DEVICE_STATUS_METHOD as mt, AlertSchema as n, storageCapability as nt, CoreBlockSchema as o, userManagementCapability as ot, UserRecordSchema as p, DEVICE_SETTINGS_CONTRIBUTION_METHODS as pt, normalizeUnit as q, ApiKeyRecordSchema as r, storageProviderCapability as rt, DeviceStatusSchema as s, validateExpressionSource as st, ALL_CAPABILITY_DEFINITIONS as t, snapshotCapability as tt, STREAM_PROFILE_META as u, errMsg as ut, applyTransform as v, ReadinessRegistry as vt, decodeVectorBase64 as w, createEvent as wt, buildStreamParamsConfigSchema as x, asJsonObject as xt, authProviderCapability as y, ReadinessTimeoutError as yt, isVoidInput as z };

package/dist/{dist-DKJqb0c7.js → dist-CblJsHb-.js}

@@ -30289,20 +30289,6 @@ TimelapseRuleInputSchema.extend({
 	createdAt: zod.z.number(),
 	updatedAt: zod.z.number()
 });
-/** Cosine similarity between two embedding vectors */
-function cosineSimilarity(a, b) {
-	if (a.length !== b.length) return 0;
-	let dotProduct = 0;
-	let normA = 0;
-	let normB = 0;
-	for (let i = 0; i < a.length; i++) {
-		dotProduct += a[i] * b[i];
-		normA += a[i] * a[i];
-		normB += b[i] * b[i];
-	}
-	const denom = Math.sqrt(normA) * Math.sqrt(normB);
-	return denom === 0 ? 0 : dotProduct / denom;
-}
 /**
 * Decode base64 little-endian Float32 back into a vector.
 *
@@ -30651,12 +30637,6 @@ Object.defineProperty(exports, "coreBlocksCapability", {
 		return coreBlocksCapability;
 	}
 });
-Object.defineProperty(exports, "cosineSimilarity", {
-	enumerable: true,
-	get: function() {
-		return cosineSimilarity;
-	}
-});
 Object.defineProperty(exports, "createEvent", {
 	enumerable: true,
 	get: function() {

package/dist/index.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_chunk = require("./chunk-Cek0wNdY.js");
-const require_dist = require("./dist-DKJqb0c7.js");
+const require_dist = require("./dist-CblJsHb-.js");
 const require_model_download_service = require("./model-download-service-hf0ookyy.js");
 const require_manifest_python_deps = require("./manifest-python-deps-BqE5j0-O.js");
 const require_resource_monitor = require("./resource-monitor-DNNomR-i.js");

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { a as __toCommonJS, i as __require, n as __esmMin, o as __toESM$1, r as __exportAll, t as __commonJSMin$1 } from "./chunk-CNf5ZN-e.mjs";
-import { B as isVoidInput, Ct as asNumber, Et as emitDownForOwnedCaps, Ft as resolveCapMount, G as logLevelAtMost, H as lifecycleJobSchema, It as scopeKey, K as looseSchema, L as isArrayOutputSchema, Mt as parseJsonObject, Nt as parseJsonUnknown$1, Ot as expandCapMethods, P as extractNestedAddonId, Pt as readinessKey, Q as procedureAuthKey, R as isCollectionArrayMethod, Rt as EventCategory$1, St as asJsonObject$1, Tt as createEvent, V as kebabToCamel, Y as objectInputDeclaresAddonId, bt as ReadinessTimeoutError, c as METHOD_ACCESS_MAP, dt as errMsg$1, h as addonSettingsCapability, ht as DEVICE_STATUS_METHOD, l as RUNTIME_DEFAULTS, mt as DEVICE_SETTINGS_CONTRIBUTION_METHODS, pt as DATAPLANE_SECRET_HEADER$1, t as ALL_CAPABILITY_DEFINITIONS, wt as asString$1, yt as ReadinessRegistry, z as isObjectInput } from "./dist-f_YvZJaQ.mjs";
+import { B as kebabToCamel, Ct as asString$1, Dt as expandCapMethods, Ft as scopeKey, G as looseSchema, I as isArrayOutputSchema, J as objectInputDeclaresAddonId, L as isCollectionArrayMethod, Lt as EventCategory$1, Mt as parseJsonUnknown$1, N as extractNestedAddonId, Nt as readinessKey, Pt as resolveCapMount, R as isObjectInput, St as asNumber, Tt as emitDownForOwnedCaps, V as lifecycleJobSchema, W as logLevelAtMost, Z as procedureAuthKey, c as METHOD_ACCESS_MAP, ft as DATAPLANE_SECRET_HEADER$1, h as addonSettingsCapability, jt as parseJsonObject, l as RUNTIME_DEFAULTS, mt as DEVICE_STATUS_METHOD, pt as DEVICE_SETTINGS_CONTRIBUTION_METHODS, t as ALL_CAPABILITY_DEFINITIONS, ut as errMsg$1, vt as ReadinessRegistry, wt as createEvent, xt as asJsonObject$1, yt as ReadinessTimeoutError, z as isVoidInput } from "./dist-BOpRqInW.mjs";
 import { a as downloadModel, c as getModelFilePath, d as contentTypeFor, f as createAuthenticatedFileServer, h as resolveFilePath, i as downloadFile, l as isModelDownloaded, m as parseTokenizedUrl, n as collectModelFiles, o as ensureModel, p as parseRangeHeader, r as deleteModelFromDisk, s as fetchJson, t as ModelDownloadService, u as createFileDataPlaneHandler } from "./model-download-service-Cp9f4dk6.mjs";
 import { $ as buildNativeCapProxy, A as createHubCapForwardService, B as AGENT_CAP_FWD_ACTION, C as brokerTransportLink, Ct as resolveAddonClass, D as localProviderLink, E as ipcParentLink, F as createUdsLogger, G as callWithServiceDiscovery, H as CapRouteResolver, I as createUdsLoggerWithControl, J as UdsLocalTransportServer, K as createLocalTransport, L as LocalChildClient, M as createUdsEventBridge, N as createUdsEventBus, O as HUB_CAP_FWD_ACTION, P as udsChildLogToWorkerEntry, Q as encodeFrame, R as LocalChildRegistry, S as brokerCallForCap, St as runNpm, T as ipcChildLink, U as CapRouteError, V as AGENT_CAP_FWD_SERVICE, W as classifyCapRoute, X as localEndpointPath, Y as SocketChannel, Z as FrameDecoder, _ as createKernelHwAccel, _t as CapabilityHandle, a as getWorkerDeviceRegistry, b as __resetCapUsageRegistryForTests, bt as installManifestNativeDeps, c as setHubConnected, ct as NATIVE_PROVIDER_SERVICE_INFIX, d as getBrokerEventBus, dt as capBareAction, et as buildUdsNativeCapProxy, f as getMoleculerEventStats, ft as capServiceName, g as AddonDepsManager, gt as DeviceRegistry, h as subscribePassthrough, ht as serializeTypedArrays, i as createUdsAddonContext, it as mountNativeCapService, j as createParentUnownedCallHandler, k as HUB_CAP_FWD_SERVICE, l as EVENT_TOPIC_PREFIX, lt as capActionName, m as setNodeEventInterest, mt as deserializeTypedArrays, n as adaptBrokerToCluster, o as getOrInitReadinessRegistry, ot as createAddonService, p as registerEventBusService, pt as parseCapAction, q as UdsLocalTransportClient, r as createAddonContext, s as getOrInitReadinessRegistryForClient, st as validateProviderRegistrations, t as installManifestPythonDeps, tt as createBrokerDeviceManagerApi, u as clusterEventTopic, ut as capActionSuffix, v as resolveHwAccel, vt as CapabilityUnavailableError, w as buildLinkChain, wt as createAddonDataPlaneFacility, x as getCapUsageRegistry, xt as resolveNpmInvocation, y as CapUsageRegistry, yt as copyBundledNativeModules, z as UDS_NO_ROUTE_PREFIX } from "./manifest-python-deps-Ck4-9K9m.mjs";
 import { n as getSinglePidStats, t as getPidStats } from "./resource-monitor-BkP504Vq.mjs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/system",
-  "version": "1.2.53",
+  "version": "1.2.55",
   "description": "Core addon for CamStack — builtins, pipeline, process management, auth, logging, events",
   "keywords": [
     "camstack",
@@ -53,10 +53,13 @@
         "category": "system",
         "name": "SQLite Settings",
         "entry": "./dist/builtins/sqlite-storage/sqlite-settings.addon.js",
-        "description": "The relational ENGINE behind the data door (SQLite WAL). Registers `data-store-provider`, an internal collection cap; the public `settings-store` door is owned by `storage-orchestrator`, which dispatches here. Callers never reach this addon directly — that is what makes the engine replaceable.",
+        "description": "The relational ENGINE behind the data door (SQLite WAL). Registers `data-store-provider`, an internal collection cap; the public `settings-store` door is owned by `storage-orchestrator`, which dispatches here. Callers never reach this addon directly — that is what makes the engine replaceable. It ALSO registers `vector-store` (sqlite-vec) from the same database file and the same open handle.",
         "capabilities": [
           {
             "name": "data-store-provider"
+          },
+          {
+            "name": "vector-store"
           }
         ]
       },
@@ -337,9 +340,9 @@
     "publish": "npm publish --access public"
   },
   "dependencies": {
-    "@camstack/types": "*",
     "@camstack/sdk": "*",
     "@camstack/shm-ring": "*",
+    "@camstack/types": "*",
     "@msgpack/msgpack": "^3.1.3",
     "@trpc/client": "^11.16.0",
     "@trpc/server": "^11.16.0",
@@ -350,6 +353,7 @@
     "jsonwebtoken": "^9.0.0",
     "moleculer": "^0.15.0",
     "otplib": "13.4.1",
+    "sqlite-vec": "^0.1.9",
     "superjson": "^2.2.0",
     "systeminformation": "^5.0.0",
     "tar": "7.5.16",

package/dist/builtins/sqlite-storage/vector-index.d.ts

@@ -1,197 +0,0 @@
-import { IScopedLogger, VectorFilter, VectorItem, VectorMatch, VectorMetadata, VectorMetric } from '@camstack/types';
-/** Metadata keys promoted to real, indexable columns. */
-export declare const PROMOTED_COLUMNS: readonly ["deviceId", "timestamp", "className", "modelId"];
-/** Ceiling on rows compared in one query, so a pathological index cannot wedge the runner. */
-export declare const MAX_SCAN_ROWS = 200000;
-/** Per-index declaration kept in memory; re-declared on boot by each caller. */
-export interface VectorIndexSpec {
-    readonly dim: number;
-    readonly metric: VectorMetric;
-}
-/**
- * The slice of `SqliteSettingsBackend` this index uses.
- *
- * Narrowed on purpose: the real backend satisfies it structurally and a test
- * fake implements exactly these four methods without a cast. Depending on the
- * whole backend would have forced an `as any` in the fake, which is how a fake
- * ends up quietly diverging from the surface it stands in for.
- */
-export interface VectorBackend {
-    declareCollection(input: {
-        collection: string;
-        columns: readonly TableColumn[];
-        indexes?: readonly TableIndex[];
-    }): Promise<void>;
-    set(input: {
-        collection: string;
-        key: string;
-        value: unknown;
-    }): Promise<void>;
-    delete(input: {
-        collection: string;
-        key: string;
-    }): Promise<void>;
-    query(input: {
-        collection: string;
-        filter?: StoreQueryFilter;
-    }): Promise<readonly StoreRecord[]>;
-    /**
-     * Bulk delete in ONE statement.
-     *
-     * `deleteByFilter` used to collect ids and delete them one at a time, which
-     * on a live index of 8,686 rows blew through a 60s UDS timeout mid-way and
-     * left the index half-emptied. The engine has always had this; using it is
-     * the difference between one statement and eight thousand.
-     */
-    deleteWhere(input: {
-        collection: string;
-        filter: StoreQueryFilter;
-    }): Promise<{
-        deleted: number;
-    }>;
-}
-/** Column spec accepted by `declareCollection`. */
-export interface TableColumn {
-    readonly name: string;
-    readonly type: 'TEXT' | 'INTEGER' | 'REAL' | 'JSON' | 'BOOLEAN';
-    readonly primaryKey?: boolean;
-    readonly notNull?: boolean;
-}
-/** Index spec accepted by `declareCollection`. */
-export interface TableIndex {
-    readonly name: string;
-    readonly columns: readonly string[];
-}
-/** The filter shape this index sends to the store. */
-export interface StoreQueryFilter {
-    readonly where?: Record<string, unknown>;
-    readonly whereBetween?: Record<string, [number, number]>;
-    readonly orderBy?: {
-        field: string;
-        direction: 'asc' | 'desc';
-    };
-    readonly limit?: number;
-}
-/** A row as the store returns it. */
-export interface StoreRecord {
-    readonly id: string;
-    readonly data: Record<string, unknown>;
-}
-export interface SqliteVectorIndexDeps {
-    readonly store: VectorBackend;
-    readonly logger: IScopedLogger;
-}
-interface StoredRow {
-    readonly vector: string;
-    readonly deviceId: number | null;
-    readonly timestamp: number | null;
-    readonly className: string | null;
-    readonly modelId: string | null;
-    readonly extra: VectorMetadata;
-}
-export declare class SqliteVectorIndex {
-    private readonly store;
-    private readonly logger;
-    private readonly specs;
-    constructor(deps: SqliteVectorIndexDeps);
-    /**
-     * Load persisted index declarations. Call once at startup, BEFORE serving:
-     * without it every method on an existing index throws until a write
-     * re-declares it.
-     */
-    loadIndexRegistry(): Promise<void>;
-    /**
-     * Idempotent. Re-declaring an index with a DIFFERENT dim throws rather than
-     * wiping: silently dropping a populated index because a caller shipped a new
-     * model would destroy history that cannot be rebuilt.
-     */
-    declareIndex(index: string, dim: number, metric: VectorMetric): Promise<void>;
-    /**
-     * Resolve an index's spec, recovering it from stored rows when the registry
-     * has no entry.
-     *
-     * The recovery is not belt-and-braces, it is required: indexes created before
-     * the registry existed have rows and no declaration, and so would be
-     * permanently unqueryable — which is exactly how this was found, with 8,494
-     * live vectors that `stats` refused to look at. The dimension is derivable
-     * from any stored vector, so derive it and persist it rather than demanding
-     * the caller redeclare. The metric is NOT derivable and falls back to
-     * `cosine`, which is what every current caller declares.
-     */
-    private resolveSpec;
-    /** Upsert items, refusing any whose vector length disagrees with the index. */
-    upsert(index: string, items: readonly VectorItem[]): Promise<{
-        upserted: number;
-        rejected: number;
-    }>;
-    /** Exhaustive ranked search over the rows a prefilter admits. */
-    query(params: {
-        index: string;
-        vector: string;
-        topK: number;
-        minScore?: number;
-        filter?: VectorFilter;
-    }): Promise<{
-        matches: VectorMatch[];
-        scanned: number;
-        truncated: boolean;
-    }>;
-    /**
-     * Metadata for the given ids, WITHOUT decoding their vectors.
-     *
-     * The caller is a best-of gate comparing confidences, so the vector is dead
-     * weight on that path — reading it would reintroduce exactly the per-row cost
-     * this index exists to remove. Missing ids are absent from the result rather
-     * than present with an empty metadata object.
-     */
-    getByIds(index: string, ids: readonly string[]): Promise<Array<{
-        id: string;
-        metadata: VectorMetadata;
-    }>>;
-    deleteByIds(index: string, ids: readonly string[]): Promise<number>;
-    /**
-     * Delete every row the filter admits.
-     *
-     * When every clause is pushable, this is ONE bulk statement. When the filter
-     * touches a non-promoted key it falls back to select-then-delete, because
-     * those clauses live in the JSON remainder and only JS can evaluate them —
-     * and an unapplied clause would delete rows the caller wanted kept, which is
-     * the one failure mode a delete must not have.
-     */
-    deleteByFilter(index: string, filter: VectorFilter): Promise<number>;
-    stats(index: string): Promise<{
-        backend: string;
-        count: number;
-        dim: number;
-        metric: VectorMetric;
-        exact: boolean;
-    }>;
-}
-/** Split caller metadata into promoted columns plus a verbatim remainder. */
-export declare function splitMetadata(metadata: VectorMetadata): {
-    deviceId: number | null;
-    timestamp: number | null;
-    className: string | null;
-    modelId: string | null;
-    extra: VectorMetadata;
-};
-/** Rebuild the caller's metadata from the promoted columns plus the remainder. */
-export declare function rebuildMetadata(row: StoredRow): VectorMetadata;
-/** The part of a filter SQLite can apply: promoted columns only. */
-export declare function buildSqlFilter(filter: VectorFilter | undefined): {
-    where?: Record<string, unknown>;
-    whereBetween?: Record<string, [number, number]>;
-};
-/**
- * Apply the clauses SQL could not.
- *
- * A filter key that is not a promoted column lives inside the `extra` JSON
- * blob, so it is checked here in JS. It is applied rather than ignored — an
- * unapplied filter returns rows the caller will treat as matches.
- */
-export declare function passesUnpushedFilter(row: StoredRow, filter: VectorFilter | undefined): boolean;
-/** True when every clause of the filter maps to a promoted column. */
-export declare function isFullyPushable(filter: VectorFilter): boolean;
-/** Score two vectors under the index's metric. Higher is nearer in every case. */
-export declare function scoreFor(metric: VectorMetric, a: Float32Array, b: Float32Array): number;
-export {};