@camstack/system 1.2.57 → 1.2.59

package/dist/builtins/hub-forwarder/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BupxnZOi.js");
+const require_dist = require("../../dist-CV6XTApk.js");
 const require_formatter = require("../../formatter-DqAKDlvN.js");
 //#region src/builtins/hub-forwarder/hub-forwarder-destination.ts
 var DEFAULT_OUTBOUND_BUFFER_SIZE = 500;

package/dist/builtins/hub-forwarder/index.mjs

@@ -1,4 +1,4 @@
-import { U as logDestinationCapability, dt as BaseAddon } from "../../dist-DhL_zGRT.mjs";
+import { G as logDestinationCapability, pt as BaseAddon } from "../../dist-BqJJWCS8.mjs";
 import { t as formatLogLine } from "../../formatter-B7qW8bPJ.mjs";
 //#region src/builtins/hub-forwarder/hub-forwarder-destination.ts
 var DEFAULT_OUTBOUND_BUFFER_SIZE = 500;

package/dist/builtins/liveness-monitor/liveness-monitor.addon.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BupxnZOi.js");
+const require_dist = require("../../dist-CV6XTApk.js");
 //#region src/builtins/liveness-monitor/liveness-checks.ts
 var NO_DEVICES = "liveness:no-devices";
 var ALL_OFFLINE = "liveness:all-devices-offline";

package/dist/builtins/liveness-monitor/liveness-monitor.addon.mjs

@@ -1,4 +1,4 @@
-import { Lt as EventCategory, dt as BaseAddon, ut as errMsg, wt as createEvent } from "../../dist-DhL_zGRT.mjs";
+import { Et as createEvent, ft as errMsg, pt as BaseAddon, zt as EventCategory } from "../../dist-BqJJWCS8.mjs";
 //#region src/builtins/liveness-monitor/liveness-checks.ts
 var NO_DEVICES = "liveness:no-devices";
 var ALL_OFFLINE = "liveness:all-devices-offline";

package/dist/builtins/local-auth/local-auth.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-BupxnZOi.js");
+const require_dist = require("../../dist-CV6XTApk.js");
 let node_crypto = require("node:crypto");
 node_crypto = require_chunk.__toESM(node_crypto);
 let crypto$1 = require("crypto");

package/dist/builtins/local-auth/local-auth.addon.mjs

@@ -1,5 +1,5 @@
 import { i as __require, o as __toESM, t as __commonJSMin } from "../../chunk-CNf5ZN-e.mjs";
-import { d as ScopedTokenSchema, dt as BaseAddon, ot as userManagementCapability, p as UserRecordSchema, r as ApiKeyRecordSchema, y as authProviderCapability } from "../../dist-DhL_zGRT.mjs";
+import { ct as userManagementCapability, d as ScopedTokenSchema, p as UserRecordSchema, pt as BaseAddon, r as ApiKeyRecordSchema, y as authProviderCapability } from "../../dist-BqJJWCS8.mjs";
 import * as crypto$1 from "node:crypto";
 import { randomUUID } from "node:crypto";
 import nodeCrypto from "crypto";

package/dist/builtins/local-network/local-network.addon.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BupxnZOi.js");
+const require_dist = require("../../dist-CV6XTApk.js");
 let node_os = require("node:os");
 node_os = require_chunk.__toESM(node_os);
 //#region src/builtins/local-network/local-network.addon.ts

package/dist/builtins/local-network/local-network.addon.mjs

@@ -1,4 +1,4 @@
-import { H as localNetworkCapability, Lt as EventCategory, dt as BaseAddon } from "../../dist-DhL_zGRT.mjs";
+import { W as localNetworkCapability, pt as BaseAddon, zt as EventCategory } from "../../dist-BqJJWCS8.mjs";
 import * as os from "node:os";
 //#region src/builtins/local-network/local-network.addon.ts
 /**

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

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BupxnZOi.js");
+const require_dist = require("../../dist-CV6XTApk.js");
 //#region src/builtins/loki-logging/loki-payload.ts
 /**
 * Loki rejects a label name that is not a valid Prometheus label

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

@@ -1,4 +1,4 @@
-import { U as logDestinationCapability, dt as BaseAddon } from "../../dist-DhL_zGRT.mjs";
+import { G as logDestinationCapability, pt as BaseAddon } from "../../dist-BqJJWCS8.mjs";
 //#region src/builtins/loki-logging/loki-payload.ts
 /**
 * Loki rejects a label name that is not a valid Prometheus label

package/dist/builtins/native-metrics/native-metrics.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-BupxnZOi.js");
+const require_dist = require("../../dist-CV6XTApk.js");
 let node_fs = require("node:fs");
 node_fs = require_chunk.__toESM(node_fs);
 let node_child_process = require("node:child_process");

package/dist/builtins/native-metrics/native-metrics.addon.mjs

@@ -1,4 +1,4 @@
-import { K as metricsProviderCapability, Lt as EventCategory, dt as BaseAddon, wt as createEvent } from "../../dist-DhL_zGRT.mjs";
+import { Et as createEvent, J as metricsProviderCapability, pt as BaseAddon, zt as EventCategory } from "../../dist-BqJJWCS8.mjs";
 import * as fs from "node:fs";
 import { execFile, execFileSync } from "node:child_process";
 import { promisify } from "node:util";

package/dist/builtins/platform-probe/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-BupxnZOi.js");
+const require_dist = require("../../dist-CV6XTApk.js");
 let node_fs = require("node:fs");
 node_fs = require_chunk.__toESM(node_fs);
 let node_child_process = require("node:child_process");

package/dist/builtins/platform-probe/index.mjs

@@ -1,5 +1,5 @@
 import { o as __toESM } from "../../chunk-CNf5ZN-e.mjs";
-import { Et as emitReadiness, Lt as EventCategory, Q as scoreRuntimes, X as platformProbeCapability, dt as BaseAddon, k as enumerateInferenceDevices, ut as errMsg } from "../../dist-DhL_zGRT.mjs";
+import { A as enumerateInferenceDevices, Ot as emitReadiness, Q as platformProbeCapability, et as scoreRuntimes, ft as errMsg, pt as BaseAddon, zt as EventCategory } from "../../dist-BqJJWCS8.mjs";
 import * as fs from "node:fs";
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";

package/dist/builtins/remote-access-orchestrator/remote-access-orchestrator.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BupxnZOi.js");
+const require_dist = require("../../dist-CV6XTApk.js");
 //#region src/builtins/remote-access-orchestrator/enabled-providers-reconcile.ts
 /**
 * Reconcile the durable `enabledProviders` set against authoritative

package/dist/builtins/remote-access-orchestrator/remote-access-orchestrator.addon.mjs

@@ -1,4 +1,4 @@
-import { Lt as EventCategory, dt as BaseAddon } from "../../dist-DhL_zGRT.mjs";
+import { pt as BaseAddon, zt as EventCategory } from "../../dist-BqJJWCS8.mjs";
 //#region src/builtins/remote-access-orchestrator/enabled-providers-reconcile.ts
 /**
 * Reconcile the durable `enabledProviders` set against authoritative

package/dist/builtins/snapshot/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BupxnZOi.js");
+const require_dist = require("../../dist-CV6XTApk.js");
 let node_child_process = require("node:child_process");
 //#region src/builtins/snapshot/snapshot-coalescing.ts
 /**
@@ -604,7 +604,7 @@ var SnapshotAddon = class SnapshotAddon extends require_dist.BaseAddon {
 				access: "authenticated",
 				handler
 			}) ?? null;
-			this.ctx.logger.info("snapshot media data-plane served", { meta: { baseUrl: this.mediaDataPlane ? `/addon/${this.ctx.id}/media` : "(no dataPlane facility)" } });
+			this.ctx.logger.info("snapshot media data-plane served", { meta: { baseUrl: this.mediaDataPlane ? `/addon/${require_dist.bareAddonId(this.ctx.id)}/media` : "(no dataPlane facility)" } });
 		} catch (err) {
 			this.ctx.logger.warn("snapshot media data-plane failed to serve", { meta: { error: require_dist.errMsg(err) } });
 			this.mediaDataPlane = null;

package/dist/builtins/snapshot/index.mjs

@@ -1,4 +1,4 @@
-import { At as nodePin, _t as DeviceType, dt as BaseAddon, ht as DeviceFeature, i as BatteryStatusSchema, it as streamQualityLabel, tt as snapshotCapability, ut as errMsg } from "../../dist-DhL_zGRT.mjs";
+import { Mt as nodePin, _t as DeviceFeature, ft as errMsg, i as BatteryStatusSchema, ot as streamQualityLabel, pt as BaseAddon, rt as snapshotCapability, x as bareAddonId, yt as DeviceType } from "../../dist-BqJJWCS8.mjs";
 import { execFile, spawn } from "node:child_process";
 //#region src/builtins/snapshot/snapshot-coalescing.ts
 /**
@@ -599,7 +599,7 @@ var SnapshotAddon = class SnapshotAddon extends BaseAddon {
 				access: "authenticated",
 				handler
 			}) ?? null;
-			this.ctx.logger.info("snapshot media data-plane served", { meta: { baseUrl: this.mediaDataPlane ? `/addon/${this.ctx.id}/media` : "(no dataPlane facility)" } });
+			this.ctx.logger.info("snapshot media data-plane served", { meta: { baseUrl: this.mediaDataPlane ? `/addon/${bareAddonId(this.ctx.id)}/media` : "(no dataPlane facility)" } });
 		} catch (err) {
 			this.ctx.logger.warn("snapshot media data-plane failed to serve", { meta: { error: errMsg(err) } });
 			this.mediaDataPlane = null;

package/dist/builtins/sqlite-storage/filesystem-storage.addon.js

@@ -3,12 +3,12 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BupxnZOi.js");
+const require_dist = require("../../dist-CV6XTApk.js");
+let node_crypto = require("node:crypto");
 let node_fs = require("node:fs");
 node_fs = require_chunk.__toESM(node_fs);
 let node_path = require("node:path");
 node_path = require_chunk.__toESM(node_path);
-let node_crypto = require("node:crypto");
 let node_os = require("node:os");
 let node_fs_promises = require("node:fs/promises");
 //#region src/builtins/sqlite-storage/path-guard.ts

package/dist/builtins/sqlite-storage/filesystem-storage.addon.mjs

@@ -1,8 +1,8 @@
-import { P as filesystemBrowseCapability, dt as BaseAddon, rt as storageProviderCapability } from "../../dist-DhL_zGRT.mjs";
+import { F as filesystemBrowseCapability, at as storageProviderCapability, pt as BaseAddon } from "../../dist-BqJJWCS8.mjs";
+import { randomUUID } from "node:crypto";
 import * as fs from "node:fs";
 import * as path$1 from "node:path";
 import { basename, dirname, join, resolve, sep } from "node:path";
-import { randomUUID } from "node:crypto";
 import { homedir } from "node:os";
 import { mkdir, readdir, realpath, statfs } from "node:fs/promises";
 //#region src/builtins/sqlite-storage/path-guard.ts

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

@@ -3,5 +3,8 @@ export type { DeviceRow } from './device-store.js';
 export { DeviceStore } from './device-store.js';
 export { FilesystemStorageAddon, FilesystemStorageAddon as default, } from './filesystem-storage.addon.js';
 export { FilesystemStorageProvider } from './filesystem-storage-provider.js';
+export { SQLITE_JOURNAL_SIZE_LIMIT_BYTES, SQLITE_MMAP_SIZE_BYTES, SQLITE_PAGE_CACHE_KIB, } from './sqlite-pragmas.js';
 export { SqliteSettingsAddon } from './sqlite-settings.addon.js';
 export { SqliteSettingsBackend } from './sqlite-settings-backend.js';
+export type { WalMaintenanceOptions, WalMaintenanceOutcome } from './wal-maintenance.js';
+export { WAL_CHECKPOINT_BUSY_TIMEOUT_MS, WAL_HIGH_WATER_BYTES, WAL_IDLE_QUIET_MS, WAL_MAINTENANCE_INTERVAL_MS, WalMaintenance, } from './wal-maintenance.js';

package/dist/builtins/sqlite-storage/index.js

@@ -57,6 +57,14 @@ exports.DeviceStore = DeviceStore;
 exports.DeviceStore$1 = DeviceStore;
 exports.FilesystemStorageAddon = require_builtins_sqlite_storage_filesystem_storage_addon.FilesystemStorageAddon;
 exports.FilesystemStorageProvider = require_builtins_sqlite_storage_filesystem_storage_addon.FilesystemStorageProvider;
+exports.SQLITE_JOURNAL_SIZE_LIMIT_BYTES = require_builtins_sqlite_storage_sqlite_settings_addon.SQLITE_JOURNAL_SIZE_LIMIT_BYTES;
+exports.SQLITE_MMAP_SIZE_BYTES = require_builtins_sqlite_storage_sqlite_settings_addon.SQLITE_MMAP_SIZE_BYTES;
+exports.SQLITE_PAGE_CACHE_KIB = require_builtins_sqlite_storage_sqlite_settings_addon.SQLITE_PAGE_CACHE_KIB;
 exports.SqliteSettingsAddon = require_builtins_sqlite_storage_sqlite_settings_addon.SqliteSettingsAddon;
 exports.SqliteSettingsBackend = require_builtins_sqlite_storage_sqlite_settings_addon.SqliteSettingsBackend;
+exports.WAL_CHECKPOINT_BUSY_TIMEOUT_MS = require_builtins_sqlite_storage_sqlite_settings_addon.WAL_CHECKPOINT_BUSY_TIMEOUT_MS;
+exports.WAL_HIGH_WATER_BYTES = require_builtins_sqlite_storage_sqlite_settings_addon.WAL_HIGH_WATER_BYTES;
+exports.WAL_IDLE_QUIET_MS = require_builtins_sqlite_storage_sqlite_settings_addon.WAL_IDLE_QUIET_MS;
+exports.WAL_MAINTENANCE_INTERVAL_MS = require_builtins_sqlite_storage_sqlite_settings_addon.WAL_MAINTENANCE_INTERVAL_MS;
+exports.WalMaintenance = require_builtins_sqlite_storage_sqlite_settings_addon.WalMaintenance;
 exports.default = require_builtins_sqlite_storage_filesystem_storage_addon.FilesystemStorageAddon;

package/dist/builtins/sqlite-storage/index.mjs

@@ -1,5 +1,5 @@
 import { FilesystemStorageAddon, t as FilesystemStorageProvider } from "./filesystem-storage.addon.mjs";
-import { SqliteSettingsAddon, t as SqliteSettingsBackend } from "./sqlite-settings.addon.mjs";
+import { SqliteSettingsAddon, a as WalMaintenance, c as SQLITE_MMAP_SIZE_BYTES, i as WAL_MAINTENANCE_INTERVAL_MS, l as SQLITE_PAGE_CACHE_KIB, n as WAL_HIGH_WATER_BYTES, o as SqliteSettingsBackend, r as WAL_IDLE_QUIET_MS, s as SQLITE_JOURNAL_SIZE_LIMIT_BYTES, t as WAL_CHECKPOINT_BUSY_TIMEOUT_MS } from "./sqlite-settings.addon.mjs";
 //#region src/builtins/sqlite-storage/config-store.ts
 var ConfigStore = class {
 	db;
@@ -46,4 +46,4 @@ var DeviceStore = class {
 	}
 };
 //#endregion
-export { ConfigStore, DeviceStore, FilesystemStorageAddon, FilesystemStorageAddon as default, FilesystemStorageProvider, SqliteSettingsAddon, SqliteSettingsBackend };
+export { ConfigStore, DeviceStore, FilesystemStorageAddon, FilesystemStorageAddon as default, FilesystemStorageProvider, SQLITE_JOURNAL_SIZE_LIMIT_BYTES, SQLITE_MMAP_SIZE_BYTES, SQLITE_PAGE_CACHE_KIB, SqliteSettingsAddon, SqliteSettingsBackend, WAL_CHECKPOINT_BUSY_TIMEOUT_MS, WAL_HIGH_WATER_BYTES, WAL_IDLE_QUIET_MS, WAL_MAINTENANCE_INTERVAL_MS, WalMaintenance };

package/dist/builtins/sqlite-storage/retired-settings-keys.d.ts

@@ -0,0 +1,94 @@
+import { ISettingsBackend, SettingsCollection } from '@camstack/types';
+/** One retired-key declaration, scoped to a single store row. */
+export interface RetiredKeySpec {
+    /** Addon id owning the store (the settings-store namespace). */
+    readonly namespace: string;
+    /** Collection inside that namespace, e.g. `addon-settings`. */
+    readonly collection: SettingsCollection;
+    /** Row id inside the collection, e.g. `root`. */
+    readonly row: string;
+    /** Keys retired verbatim. Matched exactly. */
+    readonly keys: readonly string[];
+    /**
+     * Keys retired in both their bare form and their per-node form
+     * (`<key>@<nodeId>`), which is how `nodeScopedKey` persists a
+     * `perNode: true` schema field.
+     */
+    readonly perNodeKeys: readonly string[];
+    /** Why they are dead — cited in the record, not re-derived at the call site. */
+    readonly reason: string;
+}
+/** What a purge pass deleted from one row. */
+export interface RetiredKeyPurgeResult {
+    readonly addon: string;
+    readonly collection: string;
+    readonly row: string;
+    readonly keys: readonly string[];
+}
+/** The store access the purge needs. Narrow on purpose — trivially fakeable. */
+export interface RetiredKeyStore {
+    /** Current row value, or `null` when the row does not exist. Throws on fault. */
+    read(spec: RetiredKeySpec): Promise<Record<string, unknown> | null>;
+    /** Replace the row with `value`. */
+    write(spec: RetiredKeySpec, value: Record<string, unknown>): Promise<void>;
+}
+/**
+ * Is THIS node the one whose settings store is the cluster's authority?
+ *
+ * Mirrors `resolveNodeRole` (server/backend `node-role.ts`) — unset or `'hub'`
+ * means hub, which is the launcher's own default. It is duplicated rather than
+ * imported because `@camstack/system` is a dependency OF the backend, not the
+ * other way round; the parse is four lines and the env var is the contract.
+ *
+ * Anything else answers `false`. Skipping where the purge should have run is a
+ * missed cleanup the next hub boot fixes; running where it should not have is a
+ * write to a store this node does not own. Only one of those is recoverable.
+ */
+export declare function settingsStoreIsAuthoritativeHere(env: NodeJS.ProcessEnv): boolean;
+/** The logging surface the purge uses — a structural subset of `IScopedLogger`. */
+export interface RetiredKeyLogger {
+    info(message: string, context?: {
+        readonly meta?: Record<string, unknown>;
+    }): void;
+    warn(message: string, context?: {
+        readonly meta?: Record<string, unknown>;
+    }): void;
+}
+/**
+ * The dead keys, per row.
+ *
+ * `detection-pipeline` / `addon-settings` / `root` — every key in this row is
+ * dead; the row itself is kept because the addon writes live keys into it
+ * (`pipelineTemplates`, `videoPipelineSteps`).
+ *
+ *  - `pipelineSteps` / `pipelineEngine`: the persisted GLOBAL step + engine
+ *    seed. Removed with `getGlobalSteps` becoming pure — dispatch builds steps
+ *    from the orchestrator's `agentSettings` plus per-camera overrides, and
+ *    never consulted the seed. See `addon-pipeline/src/detection-pipeline/provider.ts`.
+ *  - `engineRuntime` / `engineBackend` / `engineDevice` / `probedBestEngine`:
+ *    the per-node engine CASCADE, removed with the operator-facing engine
+ *    election. Each node now runs a device-array of inference pools balanced
+ *    per session, and the node-default pool derives live from the node's own
+ *    hardware (`resolveAutoEngine`). See
+ *    `addon-pipeline/src/detection-pipeline/engine-store-keys.ts`.
+ */
+export declare const RETIRED_SETTINGS_KEYS: readonly RetiredKeySpec[];
+/**
+ * Adapt the settings backend to {@link RetiredKeyStore}.
+ *
+ * `get` answering a non-object (missing row) is a MISS, not a fault: it maps to
+ * `null` and the purge skips the row. A backend throw propagates, which is what
+ * routes it to the "read failed, row left untouched" branch.
+ */
+export declare function retiredKeyStoreOf(backend: ISettingsBackend): RetiredKeyStore;
+/** Keys of `blob` that `spec` retires. Pure. */
+export declare function planRetiredKeyPurge(blob: Readonly<Record<string, unknown>>, spec: RetiredKeySpec): readonly string[];
+/**
+ * Delete every retired key present in the declared rows — on the hub.
+ *
+ * Off the authoritative node this is a no-op that touches nothing and says
+ * nothing (see the module header). Returns one entry per row that actually
+ * changed — empty when the store is already clean, which is the steady state
+ * after the first boot that ran it.
+ */
+export declare function purgeRetiredSettingsKeys(store: RetiredKeyStore, logger: RetiredKeyLogger, specs?: readonly RetiredKeySpec[], env?: NodeJS.ProcessEnv): Promise<readonly RetiredKeyPurgeResult[]>;

package/dist/builtins/sqlite-storage/sqlite-pragmas.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Connection tuning for the hub's SQLite database.
+ *
+ * Every number here is sized against a MEASURED database, not a blog post.
+ * On the live hub (2026-08-06), 20 Hz syscall sampling of hub-main put **210
+ * of 2,561 samples inside `pread64`** — 161 on `camstack.db` and 49 on
+ * `camstack.db-wal`, all 4 KiB page reads, i.e. page-cache misses. That is
+ * 8.2% of wall-clock and ~20% during bursts, on the single thread that also
+ * serves every tRPC request. fds 79/81 of hub-main were the two files, so the
+ * cost is proven in-process rather than inferred.
+ *
+ * The database was **130 MB** with a **249 MB** WAL high-water mark. Its
+ * tenants are not settings: the analytics event/track/media stores and the
+ * sqlite-vec index all live in this one file.
+ */
+/**
+ * Page cache, in KiB (SQLite reads a NEGATIVE `cache_size` as KiB rather than
+ * as a page count, which is what makes it independent of `page_size`).
+ *
+ * -65536 = **64 MiB**. Sized from the 130 MB file: the hot working set is the
+ * B-tree interior pages plus the indexes the analytics queries walk, which is
+ * a fraction of the total — 64 MiB covers roughly half the file outright, so a
+ * repeated query stops re-reading the same 4 KiB pages from disk. Going to the
+ * full 130 MB would buy the tail of a cold table scan for twice the resident
+ * cost; going smaller leaves the measured miss rate roughly where it is.
+ *
+ * Why the build default is not enough: better-sqlite3 compiles with
+ * `SQLITE_DEFAULT_CACHE_SIZE=-16000`, so the starting point is ~16 MiB — 8x
+ * short of the file, not the ~2 MiB stock SQLite default. This is a 4x
+ * increase, not a 32x one.
+ *
+ * Cost: 64 MiB of malloc'd C memory, ONE connection's worth (better-sqlite3
+ * holds a single handle and the vector index shares it). It is off-heap, so it
+ * does not move V8's heap ceiling — the thing that produced the hub's previous
+ * OOM.
+ */
+export declare const SQLITE_PAGE_CACHE_KIB = -65536;
+/**
+ * Memory-mapped I/O window, in bytes. 268435456 = **256 MiB**.
+ *
+ * Chosen to exceed the 130 MB database with room for it to roughly double, so
+ * the whole main file can be mapped. Pages then arrive as minor faults against
+ * the OS page cache instead of `pread64` syscalls — which is precisely the
+ * 161-sample half of the measurement. It also means a page evicted from
+ * SQLite's own cache is usually still resident in the OS cache, so the two
+ * knobs compound rather than duplicate.
+ *
+ * Two honest caveats:
+ *  - SQLite **never mmaps the WAL**. The 49 WAL samples are not addressed
+ *    here; they are addressed by keeping the WAL small (see
+ *    {@link SQLITE_JOURNAL_SIZE_LIMIT_BYTES} and `wal-maintenance.ts`).
+ *  - With mmap, an I/O error on a mapped page surfaces as SIGBUS rather than a
+ *    catchable SQLite error. The pragma is asserted in
+ *    `__tests__/sqlite-pragmas.spec.ts` by reading it back, so a build that
+ *    ignores it (`SQLITE_MAX_MMAP_SIZE=0`) fails loudly instead of quietly
+ *    doing nothing.
+ */
+export declare const SQLITE_MMAP_SIZE_BYTES = 268435456;
+/**
+ * Upper bound on the WAL file left on disk after a checkpoint resets it, in
+ * bytes. 67108864 = **64 MiB**.
+ *
+ * This is the passive half of the WAL fix and it carries no stall risk at all:
+ * it takes no lock and blocks nothing. It only says "when a checkpoint has
+ * already succeeded, truncate the file rather than leaving the space
+ * allocated". Without it, a WAL that spiked once stays spiked — which is how
+ * a 130 MB database ends up with a 249 MB sidecar.
+ *
+ * 64 MiB is deliberately well above the ~4 MiB `wal_autocheckpoint` threshold
+ * (1000 pages), so ordinary operation never touches this ceiling and the file
+ * is not being repeatedly truncated and re-grown.
+ */
+export declare const SQLITE_JOURNAL_SIZE_LIMIT_BYTES = 67108864;
+/**
+ * `synchronous` is deliberately NOT set here.
+ *
+ * better-sqlite3 compiles with `SQLITE_DEFAULT_WAL_SYNCHRONOUS=1`, so a WAL
+ * database is **already** at `NORMAL`. Writing `PRAGMA synchronous = NORMAL`
+ * would be a no-op that reads, forever after, like a durability decision
+ * somebody made — the kind of leftover that is worse than nothing because it
+ * looks like verification. `__tests__/sqlite-pragmas.spec.ts` asserts the
+ * effective value instead, so a dependency bump that changes the default is
+ * caught rather than assumed.
+ */
+export declare const SQLITE_SYNCHRONOUS_IS_BUILD_DEFAULT = true;

package/dist/builtins/sqlite-storage/sqlite-settings.addon.d.ts

@@ -20,6 +20,7 @@ import { SqliteVecVectorIndex } from './vector-index-vec.js';
 export declare class SqliteSettingsAddon extends BaseAddon {
     private backend;
     private vectorIndex;
+    private walMaintenance;
     constructor();
     protected onInitialize(): Promise<ProviderRegistration[]>;
     protected onShutdown(): Promise<void>;