@framers/agentos 0.10.10 → 0.10.12

package/dist/cognition/memory/retrieval/store/MemoryStore.d.ts

@@ -62,6 +62,8 @@ export declare class MemoryStore {
     private embeddingCache;
     /** Process-local deletion barrier for asynchronous vector refreshes and hydration. */
     private tombstonedTraceIds;
+    /** Tombstones whose local delete has not been durably confirmed. */
+    private authoritativeTombstoneIds;
     /** Track concrete scopes we have seen, so retrieval never falls back to a fake wildcard scope. */
     private knownScopes;
     /** Optional cognitive mechanisms engine for retrieval-time hooks. */
@@ -75,13 +77,24 @@ export declare class MemoryStore {
     private brain;
     /** Whether {@link MemoryStore.ensureHydratedFromBrain} has already run for this instance. */
     private brainHydrated;
+    /** Namespace shared by stores that address the same backing resource. */
+    private coordinationNamespace;
+    /** Lifecycle-registered callbacks used to invalidate sibling store caches. */
+    private readonly coordinationTarget;
+    private coordinationRegistration;
+    private disposed;
+    /** Brain attachment is immutable once any memory operation has started. */
+    private brainAttachmentLocked;
     constructor(config: MemoryStoreConfig);
     /**
      * Attach a Brain for durable write-through persistence.
      * Once attached, all store/softDelete/recordAccess operations also
-     * write to the brain's `memory_traces` table.
+     * write to the brain's `memory_traces` table. Initial attachment must happen
+     * before any memory operation; after that, only another handle with the same
+     * coordination token can be supplied.
      *
      * @param brain - Brain instance (already initialized with schema)
+     * @throws When attachment is late or would switch backing resources.
      */
     setBrain(brain: import('./Brain.js').Brain): void;
     /**
@@ -89,6 +102,24 @@ export declare class MemoryStore {
      * Returns null when no brain is attached (in-memory only mode).
      */
     getBrain(): import('./Brain.js').Brain | null;
+    /**
+     * Remove this store from sibling coordination. Recall and mutation methods
+     * reject after disposal; diagnostic cache accessors remain available.
+     */
+    dispose(): void;
+    private assertNotDisposed;
+    private beginOperation;
+    private markDeletedLocally;
+    private evictDeletedLocally;
+    private reviveLocally;
+    private getDurableTraceRows;
+    private reconcileDurableTraceStates;
+    /**
+     * Return the subset of cached trace IDs that remain recallable after a
+     * fail-closed durable-state check. Used by non-vector recall paths such as
+     * graph association injection so a tombstone cannot bypass vector filters.
+     */
+    filterRecallableTraceIds(traceIds: string[]): Promise<Set<string>>;
     /**
      * Hydrate the in-memory vector store + scope registry from the attached
      * Brain on first use. The Brain is the durable backing store, but the vector
@@ -106,6 +137,7 @@ export declare class MemoryStore {
      * and record as episodic memory in the knowledge graph.
      */
     store(trace: MemoryTrace): Promise<void>;
+    private storeWithTraceLock;
     /**
      * Query memory traces with cognitive scoring.
      */
@@ -127,6 +159,7 @@ export declare class MemoryStore {
      * Updates decay parameters via spaced repetition.
      */
     recordAccess(traceId: string): Promise<RetrievalUpdateResult | null>;
+    private recordAccessWithTraceLock;
     /**
      * Get all traces for a scope (for consolidation pipeline).
      *
@@ -149,10 +182,16 @@ export declare class MemoryStore {
      * not be durably updated.
      */
     persistTraceMetadata(traceId: string): Promise<void>;
+    private persistTraceMetadataWithTraceLock;
     /**
-     * Soft-delete a trace.
+     * Soft-delete a trace and preserve the local barrier if durable persistence
+     * cannot confirm the tombstone.
+     *
+     * @throws When an attached Brain cannot persist the tombstone or the trace
+     *   has no durable row to update.
      */
     softDelete(traceId: string): Promise<void>;
+    private softDeleteWithTraceLock;
     /**
      * Get a trace by ID.
      */

package/dist/cognition/memory/retrieval/store/MemoryStore.d.ts.map

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