clementine-agent 1.18.20 → 1.18.21

package/dist/memory/store.d.ts

@@ -9,7 +9,7 @@
  * Concurrency: WAL mode allows concurrent readers. Writes are serialized
  * (single-user, one MCP subprocess handles all writes).
  */
-import type { Feedback, MemoryExtraction, SearchResult, SessionSummary, SyncStats, TranscriptTurn, WikilinkConnection } from '../types.js';
+import type { Feedback, MemoryExtraction, SearchResult, SessionLineageEntry, SessionSummary, SyncStats, TranscriptTurn, WikilinkConnection } from '../types.js';
 import { HotCache } from './hot-cache.js';
 import { type WriteQueueOpts } from './write-queue.js';
 export type MemoryPromotionDecision = 'pending' | 'promoted' | 'rejected' | 'superseded';
@@ -54,6 +54,19 @@ export interface SearchContextOptions {
     /** Set false to keep retrieval on FTS/sparse/recency only even when dense is warm. */
     useDense?: boolean;
 }
+export type RecallBackendCounts = {
+    fts: number;
+    vector: number;
+    graph: number;
+    recency: number;
+};
+export interface RecallEvidence {
+    chunkId: number;
+    matchType: string;
+    score: number;
+    sourceFile?: string;
+    section?: string;
+}
 export declare class MemoryStore {
     private dbPath;
     private vaultDir;
@@ -65,6 +78,8 @@ export declare class MemoryStore {
     private writeQueue;
     constructor(dbPath: string, vaultDir: string);
     private static confidenceMultiplier;
+    private static formatBytes;
+    private static dirSizeBytes;
     /**
      * Create the database and schema if needed.
      */
@@ -311,6 +326,11 @@ export declare class MemoryStore {
         scores: number[];
         agentSlug?: string | null;
         matchTypes?: string[];
+        backendCounts?: RecallBackendCounts | null;
+        evidence?: RecallEvidence[];
+        confidence?: number | null;
+        emptyReason?: string | null;
+        allowEmpty?: boolean;
     }): void;
     /** Internal sync recall_trace insert. Called by the WriteQueue. */
     _logRecallTraceSync(opts: {
@@ -321,6 +341,11 @@ export declare class MemoryStore {
         scores: number[];
         agentSlug?: string | null;
         matchTypes?: string[];
+        backendCounts?: RecallBackendCounts | null;
+        evidence?: RecallEvidence[];
+        confidence?: number | null;
+        emptyReason?: string | null;
+        allowEmpty?: boolean;
     }): void;
     /**
      * Fetch recent recall traces for a session, newest first.
@@ -332,6 +357,10 @@ export declare class MemoryStore {
         query: string;
         chunkIds: number[];
         scores: number[];
+        backendCounts: RecallBackendCounts | null;
+        evidence: RecallEvidence[];
+        confidence: number | null;
+        emptyReason: string | null;
         retrievedAt: string;
     }>;
     /**
@@ -344,6 +373,10 @@ export declare class MemoryStore {
         messageId: string | null;
         query: string;
         retrievedAt: string;
+        backendCounts: RecallBackendCounts | null;
+        evidence: RecallEvidence[];
+        confidence: number | null;
+        emptyReason: string | null;
         chunks: Array<{
             id: number;
             sourceFile: string;
@@ -393,6 +426,7 @@ export declare class MemoryStore {
     /** Drop the whole cache — fullSync and similar bulk operations call this. */
     clearChunkCache(): void;
     private _parseJsonArray;
+    private _parseJsonObject;
     /** The fixed slot vocabulary. Adding new slots is a code change so the
      *  agent doesn't sprawl into ad-hoc namespaces. */
     static readonly USER_MODEL_SLOTS: readonly ["user_facts", "goals", "relationships", "agent_persona"];
@@ -537,6 +571,19 @@ export declare class MemoryStore {
      * Get the most recent session summaries.
      */
     getRecentSummaries(limit?: number): SessionSummary[];
+    /**
+     * Get recent session summaries scoped to one conversation.
+     */
+    getRecentSummariesForSession(sessionKey: string, limit?: number): SessionSummary[];
+    recordSessionLineage(input: {
+        sessionKey: string;
+        parentSessionId?: string | null;
+        childSessionId?: string | null;
+        reason: string;
+        summary: string;
+        exchangeCount?: number;
+    }): void;
+    getSessionLineage(sessionKey: string, limit?: number): SessionLineageEntry[];
     /**
      * Record that chunks were accessed (retrieved/displayed). Routes through
      * the write queue when enabled.
@@ -619,6 +666,22 @@ export declare class MemoryStore {
         sessionKey?: string | null;
         agentSlug?: string | null;
     }): number;
+    recordMemoryEvent(input: {
+        sourceType: string;
+        sourceId?: number | null;
+        sessionKey?: string | null;
+        agentSlug?: string | null;
+        content: string;
+        indexed?: boolean;
+    }): void;
+    getMemoryEventStats(): {
+        total: number;
+        indexed: number;
+        bySourceType: Array<{
+            sourceType: string;
+            count: number;
+        }>;
+    };
     /**
      * Search artifacts via FTS over summary + content + tool_name + tags.
      * Returns metadata only — use getArtifact(id) to pull the full blob.
@@ -697,6 +760,8 @@ export declare class MemoryStore {
         recordsWritten?: number;
         recordsSkipped?: number;
         recordsFailed?: number;
+        recordsUnchanged?: number;
+        recallCheckStatus?: string | null;
         overviewNotePath?: string | null;
         errorsJson?: string | null;
         status?: 'running' | 'ok' | 'error' | 'partial';
@@ -711,6 +776,8 @@ export declare class MemoryStore {
         recordsWritten: number;
         recordsSkipped: number;
         recordsFailed: number;
+        recordsUnchanged: number;
+        recallCheckStatus: string | null;
         overviewNotePath: string | null;
         errorsJson: string | null;
         status: string;
@@ -773,6 +840,7 @@ export declare class MemoryStore {
         transcriptRetentionDays?: number;
         behavioralRetentionDays?: number;
         recallTraceRetentionDays?: number;
+        memoryEventRetentionDays?: number;
     }): {
         episodicPruned: number;
         accessLogPruned: number;
@@ -782,6 +850,7 @@ export declare class MemoryStore {
         reflectionsPruned: number;
         usageLogPruned: number;
         recallTracesPruned: number;
+        memoryEventsPruned: number;
     };
     /**
      * User-model slots whose `updated_at` is older than maxAgeDays. These are
@@ -1330,6 +1399,19 @@ export declare class MemoryStore {
             recallTracesLast30d: number;
             extractionSkipsLast30d: number;
         };
+        retrievalProof: {
+            tracesLast7d: number;
+            emptyTracesLast7d: number;
+            tracedChunksLast7d: number;
+        };
+        memoryEvents: {
+            total: number;
+            indexed: number;
+            bySourceType: Array<{
+                sourceType: string;
+                count: number;
+            }>;
+        };
         topCitedLast30d: Array<{
             chunkId: number;
             sourceFile: string;
@@ -1378,6 +1460,11 @@ export declare class MemoryStore {
             }>;
             currentModel: string;
             ready: boolean;
+            cacheDir: string;
+            cacheExists: boolean;
+            cacheBytes: number;
+            cacheSize: string;
+            installed: boolean;
         };
     };
     /**