@pellux/goodvibes-sdk 0.30.2 → 0.33.0

package/dist/platform/state/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/platform/state/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,YAAY,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACxF,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EACV,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,kBAAkB,EAClB,0BAA0B,EAC1B,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,6BAA6B,EAC7B,gCAAgC,EAChC,mCAAmC,EACnC,oCAAoC,GACrC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACzF,OAAO,EACL,6BAA6B,EAC7B,gCAAgC,EAChC,+BAA+B,EAC/B,8BAA8B,GAC/B,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,2BAA2B,EAC3B,uBAAuB,EACvB,4BAA4B,EAC5B,6BAA6B,EAC7B,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/platform/state/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,YAAY,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACxF,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EACV,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,kBAAkB,EAClB,0BAA0B,EAC1B,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,6BAA6B,EAC7B,gCAAgC,EAChC,mCAAmC,EACnC,oCAAoC,GACrC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACzF,OAAO,EACL,6BAA6B,EAC7B,gCAAgC,EAChC,+BAA+B,EAC/B,8BAA8B,GAC/B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,qCAAqC,EAAE,MAAM,4BAA4B,CAAC;AACnF,YAAY,EACV,2BAA2B,EAC3B,uBAAuB,EACvB,4BAA4B,EAC5B,6BAA6B,EAC7B,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/platform/state/index.js

@@ -14,4 +14,5 @@ export { MemoryRegistry } from './memory-registry.js';
 export { buildIncidentMemoryAddOptions, buildMcpSecurityMemoryAddOptions, buildPluginSecurityMemoryAddOptions, buildPolicyPreflightMemoryAddOptions, } from './memory-ingest.js';
 export { MEMORY_VECTOR_DIMS, embedMemoryText, resolveMemoryVectorDbPath, SqliteVecMemoryIndex, } from './memory-vector-store.js';
 export { DEFAULT_MEMORY_EMBEDDING_DIMS, HASHED_MEMORY_EMBEDDING_PROVIDER, MemoryEmbeddingProviderRegistry, normalizeMemoryEmbeddingVector, } from './memory-embeddings.js';
+export { createBuiltinMemoryEmbeddingProviders } from './memory-embedding-http.js';
 export { selectKnowledgeForTask, buildKnowledgeInjectionPrompt } from './knowledge-injection.js';

package/dist/platform/state/json-file-store.d.ts

@@ -2,13 +2,13 @@
  * JsonFileStore — generic JSON file persistence with atomic writes.
  *
  * Handles lazy loading, atomic writes via a temporary file, and ensures the
- * directory hierarchy exists. Errors are logged but not re-thrown so that the
- * caller can decide how to recover.
+ * directory hierarchy exists. Invalid JSON and write failures are thrown so
+ * callers do not mistake corrupted state for an empty store or persisted write.
  */
 export declare class JsonFileStore<T> {
     private readonly filePath;
     constructor(filePath: string);
-    /** Load JSON data from disk, or return null if the file does not exist or is invalid. */
+    /** Load JSON data from disk, or return null if the file does not exist. */
     load(): Promise<T | null>;
     /** Atomically persist data to disk. */
     save(data: T): Promise<void>;

package/dist/platform/state/json-file-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"json-file-store.d.ts","sourceRoot":"","sources":["../../../src/platform/state/json-file-store.ts"],"names":[],"mappings":"AAKA;;;;;;GAMG;AACH,qBAAa,aAAa,CAAC,CAAC;IACd,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,MAAM;IAE7C,yFAAyF;IACnF,IAAI,IAAI,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAc/B,uCAAuC;IACjC,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAWnC"}
+{"version":3,"file":"json-file-store.d.ts","sourceRoot":"","sources":["../../../src/platform/state/json-file-store.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,qBAAa,aAAa,CAAC,CAAC;IACd,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,MAAM;IAE7C,2EAA2E;IACrE,IAAI,IAAI,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAa/B,uCAAuC;IACjC,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAOnC"}

package/dist/platform/state/json-file-store.js

@@ -1,20 +1,19 @@
 import { promises as fs, existsSync, mkdirSync, renameSync } from 'node:fs';
 import { dirname } from 'node:path';
-import { logger } from '../utils/logger.js';
 import { summarizeError } from '../utils/error-display.js';
 /**
  * JsonFileStore — generic JSON file persistence with atomic writes.
  *
  * Handles lazy loading, atomic writes via a temporary file, and ensures the
- * directory hierarchy exists. Errors are logged but not re-thrown so that the
- * caller can decide how to recover.
+ * directory hierarchy exists. Invalid JSON and write failures are thrown so
+ * callers do not mistake corrupted state for an empty store or persisted write.
  */
 export class JsonFileStore {
     filePath;
     constructor(filePath) {
         this.filePath = filePath;
     }
-    /** Load JSON data from disk, or return null if the file does not exist or is invalid. */
+    /** Load JSON data from disk, or return null if the file does not exist. */
     async load() {
         if (!existsSync(this.filePath)) {
             return null;
@@ -24,21 +23,15 @@ export class JsonFileStore {
             return JSON.parse(raw);
         }
         catch (err) {
-            logger.debug('JsonFileStore: failed to load, starting fresh', { file: this.filePath, error: summarizeError(err) });
-            return null;
+            throw new Error(`JsonFileStore failed to load ${this.filePath}: ${summarizeError(err)}`);
         }
     }
     /** Atomically persist data to disk. */
     async save(data) {
-        try {
-            mkdirSync(dirname(this.filePath), { recursive: true });
-            const tmpPath = `${this.filePath}.tmp`;
-            const content = JSON.stringify(data, null, 2) + '\n';
-            await fs.writeFile(tmpPath, content, 'utf-8');
-            renameSync(tmpPath, this.filePath);
-        }
-        catch (err) {
-            logger.debug('JsonFileStore: save failed (non-fatal)', { file: this.filePath, error: summarizeError(err) });
-        }
+        mkdirSync(dirname(this.filePath), { recursive: true });
+        const tmpPath = `${this.filePath}.tmp`;
+        const content = JSON.stringify(data, null, 2) + '\n';
+        await fs.writeFile(tmpPath, content, 'utf-8');
+        renameSync(tmpPath, this.filePath);
     }
 }

package/dist/platform/state/kv-state.d.ts

@@ -1,5 +1,5 @@
 export interface KVStateOptions {
-    readonly sessionId?: string;
+    readonly sessionId?: string | undefined;
     readonly stateDir: string;
 }
 /**
@@ -22,7 +22,6 @@ export declare class KVState {
     private loadPromise;
     private readonly store;
     constructor(options: KVStateOptions);
-    constructor(sessionId?: string, storageRoot?: string);
     get(keys: string[]): Promise<Record<string, unknown>>;
     set(values: Record<string, unknown>): Promise<void>;
     list(prefix?: string): Promise<Record<string, unknown>>;
@@ -31,9 +30,7 @@ export declare class KVState {
     persist(): Promise<void>;
     getSessionId(): string;
     static listSessions(options: Pick<KVStateOptions, 'stateDir'>): string[];
-    static listSessions(storageRoot?: string): string[];
     static cleanupOldSessions(keepCount: number, options: Pick<KVStateOptions, 'stateDir'>): void;
-    static cleanupOldSessions(keepCount: number, storageRoot?: string): void;
     dispose(): Promise<void>;
     private ensureLoaded;
     private schedulePersist;

package/dist/platform/state/kv-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kv-state.d.ts","sourceRoot":"","sources":["../../../src/platform/state/kv-state.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AA0BD;;;;;;;;;;GAUG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,IAAI,CAAwC;IACpD,OAAO,CAAC,YAAY,CAA8C;IAClE,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyC;gBAEnD,OAAO,EAAE,cAAc;gBACvB,SAAS,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;IAS9C,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAWrD,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAYnD,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAevD,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAapC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAerB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAK9B,YAAY,IAAI,MAAM;IAItB,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,GAAG,MAAM,EAAE;IACxE,MAAM,CAAC,YAAY,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE;IAgBnD,MAAM,CAAC,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,GAAG,IAAI;IAC7F,MAAM,CAAC,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IAoClE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAQhB,YAAY;IAU1B,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,MAAM,CAAC,UAAU;CAS1B"}
+{"version":3,"file":"kv-state.d.ts","sourceRoot":"","sources":["../../../src/platform/state/kv-state.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;GAUG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,IAAI,CAAwC;IACpD,OAAO,CAAC,YAAY,CAA8C;IAClE,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyC;gBAEnD,OAAO,EAAE,cAAc;IAU7B,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAWrD,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAYnD,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAevD,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAapC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAerB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAK9B,YAAY,IAAI,MAAM;IAItB,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,GAAG,MAAM,EAAE;IASxE,MAAM,CAAC,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,GAAG,IAAI;IAsBvF,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAQhB,YAAY;IAU1B,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,MAAM,CAAC,UAAU;CAS1B"}

package/dist/platform/state/kv-state.js

@@ -8,24 +8,6 @@ import { summarizeError } from '../utils/error-display.js';
  * Reserved keys that cannot be set by callers.
  */
 const RESERVED_KEYS = new Set(['id', 'started_at', '__proto__', 'constructor', 'prototype']);
-function resolveLegacyStateDir(storageRoot) {
-    if (!storageRoot) {
-        throw new Error('KVState requires an explicit stateDir or storageRoot');
-    }
-    return join(storageRoot, '.goodvibes', 'state');
-}
-function resolveKVStateOptions(sessionIdOrOptions, storageRoot) {
-    if (typeof sessionIdOrOptions === 'object' && sessionIdOrOptions !== null) {
-        if (!sessionIdOrOptions.stateDir || sessionIdOrOptions.stateDir.trim().length === 0) {
-            throw new Error('KVState requires a non-empty stateDir');
-        }
-        return sessionIdOrOptions;
-    }
-    return {
-        sessionId: sessionIdOrOptions,
-        stateDir: resolveLegacyStateDir(storageRoot),
-    };
-}
 /**
  * KVState — Session-scoped persistent key-value store.
  *
@@ -45,8 +27,10 @@ export class KVState {
     persistTimer = null;
     loadPromise = null;
     store;
-    constructor(sessionIdOrOptions, storageRoot) {
-        const options = resolveKVStateOptions(sessionIdOrOptions, storageRoot);
+    constructor(options) {
+        if (!options.stateDir || options.stateDir.trim().length === 0) {
+            throw new Error('KVState requires a non-empty stateDir');
+        }
         this.sessionId = options.sessionId ?? KVState.generateId();
         this.stateDir = options.stateDir;
         this.filePath = join(this.stateDir, `session_${this.sessionId}.json`);
@@ -123,57 +107,34 @@ export class KVState {
     getSessionId() {
         return this.sessionId;
     }
-    static listSessions(optionsOrStorageRoot) {
-        const stateDir = typeof optionsOrStorageRoot === 'object' && optionsOrStorageRoot !== null
-            ? resolveKVStateOptions(optionsOrStorageRoot).stateDir
-            : resolveLegacyStateDir(optionsOrStorageRoot);
+    static listSessions(options) {
+        const stateDir = readKVStateDir(options);
         if (!existsSync(stateDir))
             return [];
-        try {
-            return readdirSync(stateDir)
-                .filter(f => /^session_[0-9a-f]{8}\.json$/.test(f))
-                .map(f => f.replace(/^session_/, '').replace(/\.json$/, ''))
-                .sort();
-        }
-        catch {
-            return [];
-        }
+        return readdirSync(stateDir)
+            .filter(f => /^session_[0-9a-f]{8}\.json$/.test(f))
+            .map(f => f.replace(/^session_/, '').replace(/\.json$/, ''))
+            .sort();
     }
-    static cleanupOldSessions(keepCount, optionsOrStorageRoot) {
-        const stateDir = typeof optionsOrStorageRoot === 'object' && optionsOrStorageRoot !== null
-            ? resolveKVStateOptions(optionsOrStorageRoot).stateDir
-            : resolveLegacyStateDir(optionsOrStorageRoot);
+    static cleanupOldSessions(keepCount, options) {
+        const stateDir = readKVStateDir(options);
         if (!existsSync(stateDir))
             return;
-        try {
-            const files = readdirSync(stateDir)
-                .filter(f => /^session_[0-9a-f]{8}\.json$/.test(f))
-                .map(f => ({
+        const files = readdirSync(stateDir)
+            .filter(f => /^session_[0-9a-f]{8}\.json$/.test(f))
+            .map(f => {
+            const path = join(stateDir, f);
+            return {
                 name: f,
-                path: join(stateDir, f),
-                mtime: (() => {
-                    try {
-                        return statSync(join(stateDir, f)).mtimeMs;
-                    }
-                    catch {
-                        return 0;
-                    }
-                })(),
-            }))
-                .sort((a, b) => b.mtime - a.mtime);
-            const toDelete = files.slice(keepCount);
-            for (const f of toDelete) {
-                try {
-                    unlinkSync(f.path);
-                    logger.debug('KVState: cleaned up old session', { file: f.name });
-                }
-                catch (err) {
-                    logger.debug('KVState: could not delete session file', { file: f.name, error: summarizeError(err) });
-                }
-            }
-        }
-        catch (err) {
-            logger.debug('KVState: cleanupOldSessions failed (non-fatal)', { error: summarizeError(err) });
+                path,
+                mtime: statSync(path).mtimeMs,
+            };
+        })
+            .sort((a, b) => b.mtime - a.mtime);
+        const toDelete = files.slice(keepCount);
+        for (const f of toDelete) {
+            unlinkSync(f.path);
+            logger.debug('KVState: cleaned up expired session', { file: f.name });
         }
     }
     async dispose() {
@@ -200,7 +161,7 @@ export class KVState {
         this.persistTimer = setTimeout(() => {
             this.persistTimer = null;
             this.persist().catch(err => {
-                logger.debug('KVState: scheduled persist failed', { error: summarizeError(err) });
+                logger.warn('KVState: scheduled persist failed', { filePath: this.filePath, error: summarizeError(err) });
             });
         }, 5000);
         this.persistTimer.unref?.();
@@ -214,3 +175,9 @@ export class KVState {
             .join('');
     }
 }
+function readKVStateDir(options) {
+    if (!options.stateDir || options.stateDir.trim().length === 0) {
+        throw new Error('KVState requires a non-empty stateDir');
+    }
+    return options.stateDir;
+}

package/dist/platform/state/memory-embedding-http.d.ts

@@ -1,8 +1,8 @@
 import type { MemoryEmbeddingProvider } from './memory-embeddings.js';
 type EnvMap = Record<string, string | undefined>;
 interface CreateProviderContext {
-    readonly env?: EnvMap;
-    readonly fetchImpl?: EmbeddingFetchLike;
+    readonly env?: EnvMap | undefined;
+    readonly fetchImpl?: EmbeddingFetchLike | undefined;
 }
 type EmbeddingFetchLike = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
 export declare function createBuiltinMemoryEmbeddingProviders(context?: CreateProviderContext): MemoryEmbeddingProvider[];

package/dist/platform/state/memory-embedding-http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-embedding-http.d.ts","sourceRoot":"","sources":["../../../src/platform/state/memory-embedding-http.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,uBAAuB,EAKxB,MAAM,wBAAwB,CAAC;AAEhC,KAAK,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AA2BjD,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,kBAAkB,CAAC;CACzC;AAED,KAAK,kBAAkB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAanG,wBAAgB,qCAAqC,CAAC,OAAO,GAAE,qBAA0B,GAAG,uBAAuB,EAAE,CAQpH"}
+{"version":3,"file":"memory-embedding-http.d.ts","sourceRoot":"","sources":["../../../src/platform/state/memory-embedding-http.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,uBAAuB,EAKxB,MAAM,wBAAwB,CAAC;AAEhC,KAAK,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AA2BjD,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;CACrD;AAED,KAAK,kBAAkB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAanG,wBAAgB,qCAAqC,CAAC,OAAO,GAAE,qBAA0B,GAAG,uBAAuB,EAAE,CAQpH"}

package/dist/platform/state/memory-embeddings.d.ts

@@ -6,14 +6,14 @@ export interface MemoryEmbeddingRequest {
     readonly text: string;
     readonly dimensions: number;
     readonly usage: MemoryEmbeddingUsage;
-    readonly recordId?: string;
-    readonly metadata?: Record<string, unknown>;
+    readonly recordId?: string | undefined;
+    readonly metadata?: Record<string, unknown> | undefined;
 }
 export interface MemoryEmbeddingResult {
     readonly vector: Float32Array | readonly number[];
     readonly dimensions: number;
-    readonly modelId?: string;
-    readonly metadata?: Record<string, unknown>;
+    readonly modelId?: string | undefined;
+    readonly metadata?: Record<string, unknown> | undefined;
 }
 export interface MemoryEmbeddingProviderStatus {
     readonly id: string;
@@ -21,16 +21,16 @@ export interface MemoryEmbeddingProviderStatus {
     readonly state: MemoryEmbeddingProviderState;
     readonly dimensions: number;
     readonly configured: boolean;
-    readonly deterministic?: boolean;
-    readonly detail?: string;
+    readonly deterministic?: boolean | undefined;
+    readonly detail?: string | undefined;
     readonly metadata: Record<string, unknown>;
 }
 export interface MemoryEmbeddingProvider {
     readonly id: string;
     readonly label: string;
     readonly dimensions: number;
-    readonly deterministic?: boolean;
-    readonly local?: boolean;
+    readonly deterministic?: boolean | undefined;
+    readonly local?: boolean | undefined;
     embedSync?(request: MemoryEmbeddingRequest): MemoryEmbeddingResult;
     embed?(request: MemoryEmbeddingRequest): Promise<MemoryEmbeddingResult>;
     status?(): MemoryEmbeddingProviderStatus | Promise<MemoryEmbeddingProviderStatus>;
@@ -58,6 +58,8 @@ export declare class MemoryEmbeddingProviderRegistry {
     }): () => void;
     unregister(id: string): boolean;
     setDefaultProvider(id: string): void;
+    getDefaultProviderId(): string;
+    getDefaultProviderOrNull(): MemoryEmbeddingProvider | null;
     getDefaultProvider(): MemoryEmbeddingProvider;
     get(id: string): MemoryEmbeddingProvider | null;
     list(): MemoryEmbeddingProvider[];

package/dist/platform/state/memory-embeddings.d.ts.map

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

package/dist/platform/state/memory-embeddings.js

@@ -1,7 +1,5 @@
 import { ConfigManager, getConfiguredEmbeddingProviderId } from '../config/index.js';
-import { logger } from '../utils/logger.js';
 import { createBuiltinMemoryEmbeddingProviders } from './memory-embedding-http.js';
-import { summarizeError } from '../utils/error-display.js';
 export const DEFAULT_MEMORY_EMBEDDING_DIMS = 384;
 export function embedMemoryText(text, dims = DEFAULT_MEMORY_EMBEDDING_DIMS) {
     const vector = new Float32Array(dims);
@@ -68,8 +66,8 @@ export class MemoryEmbeddingProviderRegistry {
         const registered = { ...provider, id };
         this.providers.set(id, registered);
         if (options.makeDefault) {
-            this.activeProviderId = id;
             persistDefaultEmbeddingProviderId(this.configManager, id);
+            this.activeProviderId = id;
         }
         return () => {
             if (this.providers.get(id) === registered)
@@ -87,8 +85,18 @@ export class MemoryEmbeddingProviderRegistry {
         this.activeProviderId = id;
         persistDefaultEmbeddingProviderId(this.configManager, id);
     }
+    getDefaultProviderId() {
+        return this.activeProviderId;
+    }
+    getDefaultProviderOrNull() {
+        return this.providers.get(this.activeProviderId) ?? null;
+    }
     getDefaultProvider() {
-        return this.providers.get(this.activeProviderId) ?? HASHED_MEMORY_EMBEDDING_PROVIDER;
+        const provider = this.getDefaultProviderOrNull();
+        if (!provider) {
+            throw new Error(`Active memory embedding provider '${this.activeProviderId}' is not registered.`);
+        }
+        return provider;
     }
     get(id) {
         return this.providers.get(id) ?? null;
@@ -100,25 +108,17 @@ export class MemoryEmbeddingProviderRegistry {
         const provider = this.getDefaultProvider();
         if (provider.embedSync)
             return provider.embedSync(request);
-        return HASHED_MEMORY_EMBEDDING_PROVIDER.embedSync(request);
+        throw new Error(`Active memory embedding provider '${provider.id}' does not support synchronous embeddings.`);
     }
     async embedAsync(request) {
         const provider = this.getDefaultProvider();
         if (provider.embed) {
-            try {
-                return await provider.embed(request);
-            }
-            catch (error) {
-                logger.warn('Memory embedding provider failed; falling back to hashed local embeddings', {
-                    providerId: provider.id,
-                    error: summarizeError(error),
-                });
-            }
+            return await provider.embed(request);
         }
         if (provider.embedSync) {
             return provider.embedSync(request);
         }
-        return HASHED_MEMORY_EMBEDDING_PROVIDER.embedSync(request);
+        throw new Error(`Active memory embedding provider '${provider.id}' does not provide embeddings.`);
     }
     async status() {
         const statuses = [];
@@ -148,7 +148,7 @@ export class MemoryEmbeddingProviderRegistry {
                 state: 'unconfigured',
                 dimensions: DEFAULT_MEMORY_EMBEDDING_DIMS,
                 configured: false,
-                detail: `Persisted embedding provider '${this.activeProviderId}' is not registered; sqlite-vec will use '${HASHED_MEMORY_EMBEDDING_PROVIDER.id}' until it returns.`,
+                detail: `Persisted embedding provider '${this.activeProviderId}' is not registered; embedding operations will fail until it is registered or the default provider is changed.`,
                 metadata: {
                     local: true,
                     hasSyncEmbed: false,
@@ -163,25 +163,25 @@ export class MemoryEmbeddingProviderRegistry {
         const providers = await this.status();
         const syncProviders = this.list().filter((provider) => typeof provider.embedSync === 'function').map((provider) => provider.id);
         const asyncProviders = this.list().filter((provider) => typeof provider.embed === 'function').map((provider) => provider.id);
-        const active = this.getDefaultProvider();
-        const activeStatus = providers.find((provider) => provider.id === active.id);
+        const active = this.getDefaultProviderOrNull();
+        const activeStatus = active ? providers.find((provider) => provider.id === active.id) : undefined;
         const warnings = [];
         if (!this.providers.has(this.activeProviderId)) {
-            warnings.push(`Persisted embedding provider '${this.activeProviderId}' is not currently registered; falling back to '${HASHED_MEMORY_EMBEDDING_PROVIDER.id}'.`);
+            warnings.push(`Persisted embedding provider '${this.activeProviderId}' is not currently registered; embedding operations will fail until it is registered or the default provider is changed.`);
         }
-        if (activeStatus && !activeStatus.configured) {
+        if (active && activeStatus && !activeStatus.configured) {
             warnings.push(`Active embedding provider '${active.id}' is not fully configured: ${activeStatus.detail ?? 'configuration is incomplete'}`);
         }
-        if (!active.embedSync) {
+        if (active && !active.embedSync) {
             if (active.embed) {
-                warnings.push(`Active embedding provider '${active.id}' is async-only; sqlite-vec indexing will fall back to '${HASHED_MEMORY_EMBEDDING_PROVIDER.id}' for live writes and can be rebuilt asynchronously.`);
+                warnings.push(`Active embedding provider '${active.id}' is async-only; sqlite-vec live writes will skip vector updates until an async rebuild completes.`);
             }
             else {
-                warnings.push(`Active embedding provider '${active.id}' has no sync embed path; sqlite-vec indexing will fall back to '${HASHED_MEMORY_EMBEDDING_PROVIDER.id}'.`);
+                warnings.push(`Active embedding provider '${active.id}' has no sync embed path; sqlite-vec live writes cannot update vectors.`);
             }
         }
-        const activeDimensions = active.dimensions;
-        if (activeDimensions !== DEFAULT_MEMORY_EMBEDDING_DIMS) {
+        const activeDimensions = active?.dimensions;
+        if (active && activeDimensions !== DEFAULT_MEMORY_EMBEDDING_DIMS) {
             warnings.push(`Active embedding provider '${active.id}' advertises ${active.dimensions} dimensions; vectors are normalized to ${DEFAULT_MEMORY_EMBEDDING_DIMS} dimensions for sqlite-vec storage.`);
         }
         return {
@@ -194,12 +194,7 @@ export class MemoryEmbeddingProviderRegistry {
     }
 }
 function persistDefaultEmbeddingProviderId(configManager, providerId) {
-    try {
-        configManager.set('provider.embeddingProvider', providerId, { bypassManagedLock: true });
-    }
-    catch {
-        // Persistence is best-effort; runtime selection still takes effect immediately.
-    }
+    configManager.set('provider.embeddingProvider', providerId, { bypassManagedLock: true });
 }
 export const HASHED_MEMORY_EMBEDDING_PROVIDER = {
     id: 'hashed-local',

package/dist/platform/state/memory-ingest.d.ts

@@ -10,9 +10,9 @@ export interface McpSecurityCapture {
     readonly allowedPaths: readonly string[];
     readonly allowedHosts: readonly string[];
     readonly schemaFreshness: string;
-    readonly quarantineReason?: string;
-    readonly quarantineDetail?: string;
-    readonly quarantineApprovedBy?: string;
+    readonly quarantineReason?: string | undefined;
+    readonly quarantineDetail?: string | undefined;
+    readonly quarantineApprovedBy?: string | undefined;
 }
 export declare function buildIncidentMemoryAddOptions(bundle: ForensicsBundle): MemoryAddOptions;
 export declare function buildPolicyPreflightMemoryAddOptions(review: PolicyPreflightReview): MemoryAddOptions;

package/dist/platform/state/memory-ingest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-ingest.d.ts","sourceRoot":"","sources":["../../../src/platform/state/memory-ingest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAkB,MAAM,mBAAmB,CAAC;AAC1E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AACjF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CACxC;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,eAAe,GAAG,gBAAgB,CAkCvF;AAED,wBAAgB,oCAAoC,CAAC,MAAM,EAAE,qBAAqB,GAAG,gBAAgB,CAmBpG;AAED,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,kBAAkB,GAAG,gBAAgB,CA2B7F;AAED,wBAAgB,mCAAmC,CACjD,MAAM,EAAE,YAAY,EACpB,gBAAgB,CAAC,EAAE,MAAM,GACxB,gBAAgB,CAwBlB"}
+{"version":3,"file":"memory-ingest.d.ts","sourceRoot":"","sources":["../../../src/platform/state/memory-ingest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAkB,MAAM,mBAAmB,CAAC;AAC1E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AACjF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpD;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,eAAe,GAAG,gBAAgB,CAkCvF;AAED,wBAAgB,oCAAoC,CAAC,MAAM,EAAE,qBAAqB,GAAG,gBAAgB,CAmBpG;AAED,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,kBAAkB,GAAG,gBAAgB,CA2B7F;AAED,wBAAgB,mCAAmC,CACjD,MAAM,EAAE,YAAY,EACpB,gBAAgB,CAAC,EAAE,MAAM,GACxB,gBAAgB,CAwBlB"}

package/dist/platform/state/memory-store-helpers.d.ts

@@ -22,7 +22,7 @@ export declare function isReviewCandidate(record: MemoryRecord): boolean;
 export declare function reviewQueueScore(record: MemoryRecord): number;
 export declare function scoreRecord(record: MemoryRecord, filter: MemorySearchFilter): number;
 export declare function recordMatchesPostSqlFilter(record: MemoryRecord, filter: MemorySearchFilter): boolean;
-export declare function safeParseJson<T>(raw: unknown, fallback: T): T;
+export declare function parseMemoryJsonField<T>(raw: unknown, fieldName: string): T;
 export declare function memoryLink(fromId: string, toId: string, relation: string, createdAt: number): MemoryLink;
 export declare function memoryDoctorReport(vector: MemoryDoctorReport['vector'], embeddings: MemoryDoctorReport['embeddings'], checkedAt: number): MemoryDoctorReport;
 //# sourceMappingURL=memory-store-helpers.d.ts.map

package/dist/platform/state/memory-store-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-store-helpers.d.ts","sourceRoot":"","sources":["../../../src/platform/state/memory-store-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE1I,wBAAgB,YAAY,CAAC,EAAE,EAAE;IAAE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAA;KAAE,CAAC,CAAA;CAAE,GAAG,IAAI,CAuCrK;AAED,wBAAgB,YAAY,CAC1B,EAAE,EAAE;IAAE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAA;KAAE,CAAC,CAAA;CAAE,EAClI,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,IAAI,CAcN;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,YAAY,CAkB9E;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,CAEtE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAE1D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAGtD;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAE7D;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAK/D;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAS7D;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAWpF;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAUpG;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAO7D;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU,CAExG;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,kBAAkB,CAAC,YAAY,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,kBAAkB,CAE5J"}
+{"version":3,"file":"memory-store-helpers.d.ts","sourceRoot":"","sources":["../../../src/platform/state/memory-store-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE1I,wBAAgB,YAAY,CAAC,EAAE,EAAE;IAAE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAA;KAAE,CAAC,CAAA;CAAE,GAAG,IAAI,CAuCrK;AAED,wBAAgB,YAAY,CAC1B,EAAE,EAAE;IAAE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAA;KAAE,CAAC,CAAA;CAAE,EAClI,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,IAAI,CAcN;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,YAAY,CAuB9E;AAqCD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,CAEtE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAE1D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAGtD;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAE7D;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAK/D;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAS7D;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAWpF;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAUpG;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,CAAC,CAU1E;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU,CAExG;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,kBAAkB,CAAC,YAAY,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,kBAAkB,CAE5J"}

package/dist/platform/state/memory-store-helpers.js

@@ -38,8 +38,8 @@ export function ensureColumn(db, table, columnSql, columnName) {
     const rows = db.exec(`PRAGMA table_info(${table})`);
     const existing = new Set();
     if (rows[0]) {
-        const nameIndex = rows[0].columns.indexOf('name');
-        for (const value of rows[0].values) {
+        const nameIndex = rows[0]?.columns.indexOf('name') ?? -1;
+        for (const value of (rows[0]?.values ?? [])) {
             if (nameIndex >= 0) {
                 existing.add(String(value[nameIndex]));
             }
@@ -51,23 +51,59 @@ export function ensureColumn(db, table, columnSql, columnName) {
 }
 export function rowToRecord(columns, values) {
     const row = Object.fromEntries(columns.map((column, index) => [column, values[index]]));
+    const id = requireMemoryString(row.id, 'id');
+    const cls = requireMemoryString(row.cls, 'cls');
+    const summary = requireMemoryString(row.summary, 'summary');
+    const createdAt = requireMemoryTimestamp(row.created_at, 'created_at');
+    const updatedAt = requireMemoryTimestamp(row.updated_at, 'updated_at');
     return {
-        id: String(row.id),
-        scope: normalizeScope(row.scope),
-        cls: String(row.cls),
-        summary: String(row.summary),
+        id,
+        scope: normalizePersistedScope(row.scope),
+        cls,
+        summary,
         ...(typeof row.detail === 'string' && row.detail.trim() ? { detail: row.detail.trim() } : {}),
-        tags: safeParseJson(row.tags, []),
-        provenance: safeParseJson(row.provenance, []),
-        reviewState: normalizeReviewState(row.review_state),
-        confidence: clampConfidence(row.confidence),
-        ...(typeof row.reviewed_at === 'number' ? { reviewedAt: Number(row.reviewed_at) } : {}),
+        tags: parseMemoryJsonField(row.tags, 'tags'),
+        provenance: parseMemoryJsonField(row.provenance, 'provenance'),
+        reviewState: normalizePersistedReviewState(row.review_state),
+        confidence: requirePersistedConfidence(row.confidence),
+        ...(row.reviewed_at !== null && row.reviewed_at !== undefined ? { reviewedAt: requireMemoryTimestamp(row.reviewed_at, 'reviewed_at') } : {}),
         ...(typeof row.reviewed_by === 'string' && row.reviewed_by.trim() ? { reviewedBy: row.reviewed_by.trim() } : {}),
         ...(typeof row.stale_reason === 'string' && row.stale_reason.trim() ? { staleReason: row.stale_reason.trim() } : {}),
-        createdAt: Number(row.created_at),
-        updatedAt: Number(row.updated_at),
+        createdAt,
+        updatedAt,
     };
 }
+function throwInvalidMemoryRow(fieldName, reason) {
+    throw new Error(`Memory record field '${fieldName}' is invalid: ${reason}`);
+}
+function requireMemoryString(value, fieldName) {
+    if (typeof value !== 'string' || !value.trim()) {
+        throwInvalidMemoryRow(fieldName, 'expected a non-empty string');
+    }
+    return value;
+}
+function requireMemoryTimestamp(value, fieldName) {
+    if (typeof value !== 'number' || !Number.isFinite(value)) {
+        throwInvalidMemoryRow(fieldName, 'expected a finite timestamp number');
+    }
+    return value;
+}
+function normalizePersistedScope(value) {
+    if (value === 'session' || value === 'project' || value === 'team')
+        return value;
+    throwInvalidMemoryRow('scope', 'expected session, project, or team');
+}
+function normalizePersistedReviewState(value) {
+    if (value === 'fresh' || value === 'reviewed' || value === 'stale' || value === 'contradicted')
+        return value;
+    throwInvalidMemoryRow('review_state', 'expected fresh, reviewed, stale, or contradicted');
+}
+function requirePersistedConfidence(value) {
+    if (typeof value !== 'number' || !Number.isFinite(value) || value < 0 || value > 100) {
+        throwInvalidMemoryRow('confidence', 'expected a finite number from 0 to 100');
+    }
+    return Math.round(value);
+}
 export function normalizeReviewState(value) {
     return value === 'reviewed' || value === 'stale' || value === 'contradicted' ? value : 'fresh';
 }
@@ -119,7 +155,7 @@ export function scoreRecord(record, filter) {
 }
 export function recordMatchesPostSqlFilter(record, filter) {
     if (filter.provenanceKinds?.length) {
-        if (!record.provenance.some((entry) => filter.provenanceKinds.includes(entry.kind)))
+        if (!record.provenance.some((entry) => filter.provenanceKinds?.includes(entry.kind)))
             return false;
     }
     if (filter.reviewState) {
@@ -131,14 +167,16 @@ export function recordMatchesPostSqlFilter(record, filter) {
         return false;
     return true;
 }
-export function safeParseJson(raw, fallback) {
-    if (typeof raw !== 'string')
-        return fallback;
+export function parseMemoryJsonField(raw, fieldName) {
+    if (typeof raw !== 'string') {
+        throwInvalidMemoryRow(fieldName, 'expected JSON text');
+    }
     try {
         return JSON.parse(raw);
     }
-    catch {
-        return fallback;
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throwInvalidMemoryRow(fieldName, `invalid JSON: ${message}`);
     }
 }
 export function memoryLink(fromId, toId, relation, createdAt) {