@vpxa/aikit 0.1.174 → 0.1.176

package/packages/store/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { ContentType, IndexStats, KnowledgeOrigin, KnowledgeRecord, SearchResult, SourceType } from "../../core/dist/index.js";
+import BetterSqlite3 from "better-sqlite3";
 
 //#region packages/store/src/graph-store.interface.d.ts
 /**
@@ -220,6 +221,16 @@ declare function createSqliteAdapter(dbPath: string): Promise<ISqliteAdapter>;
  */
 declare function createSqlJsAdapter(dbPath: string): Promise<ISqliteAdapter>;
 //#endregion
+//#region packages/store/src/migrations.d.ts
+type MigrationDb = Pick<ISqliteAdapter, 'exec' | 'queryAll' | 'run'>;
+interface Migration {
+  version: number;
+  name: string;
+  up: (db: MigrationDb) => void;
+}
+declare function runMigrations(db: MigrationDb, migrations: readonly Migration[]): void;
+declare const allMigrations: readonly Migration[];
+//#endregion
 //#region packages/store/src/sqlite-graph-store.d.ts
 declare class SqliteGraphStore implements IGraphStore {
   private adapter;
@@ -377,6 +388,7 @@ declare class SqliteVecStore implements IKnowledgeStore {
   private _onCloseHooks;
   constructor(options?: SqliteVecStoreOptions);
   initialize(): Promise<void>;
+  private configureConnectionPragmas;
   /**
    * Diagnostics for the status tool. Returns runtime info about the underlying
    * adapter and DB file (read-only; safe to call after initialize()).
@@ -438,6 +450,128 @@ declare class SqliteVecStore implements IKnowledgeStore {
   private fromRow;
 }
 //#endregion
+//#region packages/store/src/state-store.d.ts
+interface MemoryMeta {
+  entryId: string;
+  tier: string;
+  retentionScore: number;
+  accessCount: number;
+  lastAccessedAt: string | null;
+  createdAt: string;
+  promotedAt: string | null;
+  supersededBy: string | null;
+  confidence: number;
+}
+interface MemoryMetaListOptions {
+  tier?: string;
+  belowScore?: number;
+  limit?: number;
+}
+interface StateStore {
+  stashGet(key: string): string | undefined;
+  stashSet(key: string, value: string): void;
+  stashList(): Array<{
+    key: string;
+    value: string;
+    updatedAt: string;
+  }>;
+  stashDelete(key: string): boolean;
+  stashClear(): void;
+  signalPost(workspace: string, key: string, value: string, agent?: string, ttlSeconds?: number): number;
+  signalGet(workspace: string, key: string): Array<{
+    id: number;
+    value: string;
+    agent?: string;
+    createdAt: string;
+    expiresAt: string;
+  }>;
+  signalList(workspace: string): Array<{
+    id: number;
+    key: string;
+    value: string;
+    agent?: string;
+    createdAt: string;
+  }>;
+  signalClear(workspace: string, key?: string): number;
+  signalCleanExpired(): number;
+  leaseAcquire(resource: string, holder: string, workspace: string, intent?: string, ttlMinutes?: number): boolean;
+  leaseRelease(resource: string, holder: string, workspace: string): boolean;
+  leaseGet(resource: string, workspace: string): {
+    resource: string;
+    holder: string;
+    intent?: string;
+    workspace: string;
+    acquiredAt: string;
+    expiresAt: string;
+  } | undefined;
+  leaseList(workspace: string): Array<{
+    resource: string;
+    holder: string;
+    intent?: string;
+    acquiredAt: string;
+    expiresAt: string;
+  }>;
+  leaseCleanExpired(): number;
+  sessionCreate(sessionId: string, metadata?: Record<string, unknown>): void;
+  sessionTouch(sessionId: string): void;
+  sessionGet(sessionId: string): {
+    sessionId: string;
+    createdAt: string;
+    lastActivity: string;
+    metadata?: string;
+  } | undefined;
+  sessionList(): Array<{
+    sessionId: string;
+    createdAt: string;
+    lastActivity: string;
+  }>;
+  sessionDelete(sessionId: string): boolean;
+  sessionDeleteStale(maxInactiveMinutes: number): number;
+  checkpointSave(id: string, label: string, data: string, notes?: string): void;
+  checkpointLoad(id: string): {
+    id: string;
+    label: string;
+    data: string;
+    notes?: string;
+    createdAt: string;
+  } | undefined;
+  checkpointList(label?: string, limit?: number): Array<{
+    id: string;
+    label: string;
+    createdAt: string;
+    notes?: string;
+  }>;
+  checkpointLatest(label?: string): {
+    id: string;
+    label: string;
+    data: string;
+    notes?: string;
+    createdAt: string;
+  } | undefined;
+  checkpointDelete(id: string): boolean;
+  checkpointDiff(fromId: string, toId: string): {
+    from: string;
+    to: string;
+  } | undefined;
+  checkpointHistory(label?: string, limit?: number): Array<{
+    id: string;
+    label: string;
+    createdAt: string;
+    notes?: string;
+  }>;
+  checkpointGc(keepLast?: number, maxAgeDays?: number): number;
+  memoryMetaCreate(entryId: string, tier?: string): void;
+  memoryMetaGet(entryId: string): MemoryMeta | undefined;
+  memoryMetaTouch(entryId: string): void;
+  memoryMetaUpdateScore(entryId: string, score: number): void;
+  memoryMetaUpdateConfidence(entryId: string, confidence: number): void;
+  memoryMetaUpdateTier(entryId: string, tier: string): void;
+  memoryMetaSetSuperseded(entryId: string, supersededBy: string): void;
+  memoryMetaList(options?: MemoryMetaListOptions): MemoryMeta[];
+}
+declare function createStateStore(db: BetterSqlite3.Database): StateStore;
+declare function createStateStore(db: ISqliteAdapter): StateStore;
+//#endregion
 //#region packages/store/src/store-factory.d.ts
 type StoreBackend = 'lancedb' | 'sqlite-vec';
 interface StoreConfig {
@@ -451,4 +585,4 @@ interface StoreConfig {
 }
 declare function createStore(config: StoreConfig): Promise<IKnowledgeStore>;
 //#endregion
-export { type DepthGroupedResult, type GraphEdge, type GraphNode, type GraphStats, type GraphTraversalOptions, type GraphTraversalResult, type GraphValidationResult, type IGraphStore, type IKnowledgeStore, type ISqliteAdapter, type ProcessInfo, type SearchOptions, type SqliteAdapterType, SqliteGraphStore, SqliteVecStore, type SqliteVecStoreOptions, type StoreBackend, type StoreConfig, type Symbol360, createSqlJsAdapter, createSqliteAdapter, createStore };
+export { type DepthGroupedResult, type GraphEdge, type GraphNode, type GraphStats, type GraphTraversalOptions, type GraphTraversalResult, type GraphValidationResult, type IGraphStore, type IKnowledgeStore, type ISqliteAdapter, type MemoryMeta, type Migration, type MigrationDb, type ProcessInfo, type SearchOptions, type SqliteAdapterType, SqliteGraphStore, SqliteVecStore, type SqliteVecStoreOptions, type StateStore, type StoreBackend, type StoreConfig, type Symbol360, allMigrations, createSqlJsAdapter, createSqliteAdapter, createStateStore, createStore, runMigrations };