@framers/agentos 0.1.125 → 0.1.127

package/dist/memory/pipeline/context/strategies/HierarchicalStrategy.d.ts

@@ -0,0 +1,25 @@
+/**
+ * HierarchicalStrategy — Multi-level summary tree for very long conversations.
+ *
+ * Maintains 4 levels of compression:
+ *   L0: Raw messages (last N turns)
+ *   L1: Per-segment summaries (~50 turns each)
+ *   L2: Per-session summaries (merges L1 nodes)
+ *   L3: Overall conversation summary (single node)
+ *
+ * Each level compresses ~5-10x, giving total compression of up to 1000x
+ * for multi-day conversations.
+ */
+import type { CompactionInput, CompactionResult, ICompactionStrategy, InfiniteContextConfig } from '../../../core/types.js';
+export declare class HierarchicalStrategy implements ICompactionStrategy {
+    readonly name: "hierarchical";
+    private readonly llmInvoker;
+    constructor(llmInvoker: (prompt: string) => Promise<string>);
+    compact(input: CompactionInput, config: InfiniteContextConfig): Promise<CompactionResult>;
+    private createL0Summary;
+    private mergeLevel;
+    private extractEntitiesFromText;
+    private collectEntities;
+    private noopResult;
+}
+//# sourceMappingURL=HierarchicalStrategy.d.ts.map

package/dist/memory/pipeline/context/strategies/HierarchicalStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HierarchicalStrategy.d.ts","sourceRoot":"","sources":["../../../../../src/memory/pipeline/context/strategies/HierarchicalStrategy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAEV,eAAe,EACf,gBAAgB,EAEhB,mBAAmB,EACnB,qBAAqB,EAEtB,MAAM,wBAAwB,CAAC;AAehC,qBAAa,oBAAqB,YAAW,mBAAmB;IAC9D,QAAQ,CAAC,IAAI,EAAG,cAAc,CAAU;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsC;gBAErD,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC;IAIrD,OAAO,CACX,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,gBAAgB,CAAC;YA0Gd,eAAe;YA+Cf,UAAU;IAuDxB,OAAO,CAAC,uBAAuB;IAgB/B,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,UAAU;CAwBnB"}

package/dist/memory/pipeline/context/strategies/HierarchicalStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HierarchicalStrategy.js","sourceRoot":"","sources":["../../../../../src/memory/pipeline/context/strategies/HierarchicalStrategy.ts"],"names":[],"mappings":"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"}

package/dist/memory/pipeline/context/strategies/HybridStrategy.d.ts

@@ -0,0 +1,26 @@
+/**
+ * HybridStrategy — Best-quality compaction using the full cognitive memory pipeline.
+ *
+ * Combines three approaches:
+ * 1. MemoryObserver — personality-biased note extraction from conversation
+ * 2. MemoryReflector — consolidation of notes into typed long-term traces
+ * 3. Rolling summary — narrative continuity via SlidingSummaryStrategy
+ *
+ * Produces both a readable summary AND long-term memory traces, giving
+ * the agent both narrative context and structured recall.
+ */
+import type { MemoryObserver } from '../../observation/MemoryObserver.js';
+import type { MemoryReflector } from '../../observation/MemoryReflector.js';
+import type { CompactionInput, CompactionResult, ICompactionStrategy, InfiniteContextConfig } from '../../../core/types.js';
+export declare class HybridStrategy implements ICompactionStrategy {
+    readonly name: "hybrid";
+    private readonly llmInvoker;
+    private readonly observer?;
+    private readonly reflector?;
+    constructor(llmInvoker: (prompt: string) => Promise<string>, observer?: MemoryObserver, reflector?: MemoryReflector);
+    compact(input: CompactionInput, config: InfiniteContextConfig): Promise<CompactionResult>;
+    private generateHybridSummary;
+    private extractEntities;
+    private noopResult;
+}
+//# sourceMappingURL=HybridStrategy.d.ts.map

package/dist/memory/pipeline/context/strategies/HybridStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HybridStrategy.d.ts","sourceRoot":"","sources":["../../../../../src/memory/pipeline/context/strategies/HybridStrategy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAmB,MAAM,qCAAqC,CAAC;AAC3F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAE5E,OAAO,KAAK,EAEV,eAAe,EACf,gBAAgB,EAEhB,mBAAmB,EACnB,qBAAqB,EAEtB,MAAM,wBAAwB,CAAC;AAUhC,qBAAa,cAAe,YAAW,mBAAmB;IACxD,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsC;IACjE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAiB;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAkB;gBAG3C,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,EAC/C,QAAQ,CAAC,EAAE,cAAc,EACzB,SAAS,CAAC,EAAE,eAAe;IAOvB,OAAO,CACX,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,gBAAgB,CAAC;YAqJd,qBAAqB;IAyEnC,OAAO,CAAC,eAAe;IA6BvB,OAAO,CAAC,UAAU;CAwBnB"}

package/dist/memory/pipeline/context/strategies/HybridStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HybridStrategy.js","sourceRoot":"","sources":["../../../../../src/memory/pipeline/context/strategies/HybridStrategy.ts"],"names":[],"mappings":"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"}

package/dist/memory/pipeline/context/strategies/SlidingSummaryStrategy.d.ts

@@ -0,0 +1,22 @@
+/**
+ * SlidingSummaryStrategy — Default compaction strategy.
+ *
+ * Summarizes the oldest N messages into a single paragraph, preserving
+ * the most recent K turns raw. Simple, predictable, low latency.
+ */
+import type { CompactionInput, CompactionResult, ICompactionStrategy, InfiniteContextConfig } from '../../../core/types.js';
+export declare class SlidingSummaryStrategy implements ICompactionStrategy {
+    readonly name: "sliding";
+    private readonly llmInvoker;
+    constructor(llmInvoker: (prompt: string) => Promise<string>);
+    compact(input: CompactionInput, config: InfiniteContextConfig): Promise<CompactionResult>;
+    /** Extract likely entity names from summary text. */
+    private extractEntities;
+    /** Detect content fragments from compacted messages missing from summary. */
+    private detectDropped;
+    /** Crude fallback when LLM is unavailable. */
+    private fallbackSummary;
+    /** No-op result when nothing needs compaction. */
+    private noopResult;
+}
+//# sourceMappingURL=SlidingSummaryStrategy.d.ts.map

package/dist/memory/pipeline/context/strategies/SlidingSummaryStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SlidingSummaryStrategy.d.ts","sourceRoot":"","sources":["../../../../../src/memory/pipeline/context/strategies/SlidingSummaryStrategy.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAEV,eAAe,EACf,gBAAgB,EAEhB,mBAAmB,EACnB,qBAAqB,EAEtB,MAAM,wBAAwB,CAAC;AAWhC,qBAAa,sBAAuB,YAAW,mBAAmB;IAChE,QAAQ,CAAC,IAAI,EAAG,SAAS,CAAU;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsC;gBAErD,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC;IAIrD,OAAO,CACX,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,gBAAgB,CAAC;IA0H5B,qDAAqD;IACrD,OAAO,CAAC,eAAe;IA8BvB,6EAA6E;IAC7E,OAAO,CAAC,aAAa;IAyBrB,8CAA8C;IAC9C,OAAO,CAAC,eAAe;IAcvB,kDAAkD;IAClD,OAAO,CAAC,UAAU;CAwBnB"}

package/dist/memory/pipeline/context/strategies/SlidingSummaryStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SlidingSummaryStrategy.js","sourceRoot":"","sources":["../../../../../src/memory/pipeline/context/strategies/SlidingSummaryStrategy.ts"],"names":[],"mappings":"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"}

package/dist/memory/pipeline/context/types.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Infinite Context Window — Types
+ *
+ * Data model for context window lifecycle management, compaction strategies,
+ * and transparency logging.
+ */
+import type { EmotionalContext, MemoryTrace } from '../../core/types.js';
+import type { ObservationNote } from '../../pipeline/observation/MemoryObserver.js';
+export type CompactionStrategy = 'sliding' | 'hierarchical' | 'hybrid';
+export type TransparencyLevel = 'full' | 'summary' | 'silent';
+export interface InfiniteContextConfig {
+    /** Enable infinite context window management. */
+    enabled: boolean;
+    /** Compaction strategy to use. */
+    strategy: CompactionStrategy;
+    /** Trigger compaction when context reaches this fraction of max tokens (0–1). */
+    compactionThreshold: number;
+    /** Never compact the most recent N turns. */
+    preserveRecentTurns: number;
+    /** Transparency logging level. */
+    transparencyLevel: TransparencyLevel;
+    /** Max compaction log entries retained in memory. */
+    logRetention: number;
+    /** Token budget for the rolling summary chain header. */
+    maxSummaryChainTokens: number;
+    /** Target compression ratio for summaries (e.g. 8 = 8:1). */
+    targetCompressionRatio: number;
+    /** LLM invoker for summarization. Falls back to Observer/Reflector invokers. */
+    llmInvoker?: (prompt: string) => Promise<string>;
+    /** Model ID for summarization calls. */
+    modelId?: string;
+}
+export declare const DEFAULT_INFINITE_CONTEXT_CONFIG: InfiniteContextConfig;
+export interface ContextMessage {
+    role: 'user' | 'assistant' | 'system' | 'tool';
+    content: string;
+    timestamp: number;
+    turnIndex: number;
+    tokenEstimate: number;
+    /** Set to true after this message has been compacted into a summary. */
+    compacted?: boolean;
+}
+export interface CompactionEntry {
+    id: string;
+    timestamp: number;
+    /** Inclusive turn range that was compacted. */
+    turnRange: [number, number];
+    /** Strategy that produced this compaction. */
+    strategy: CompactionStrategy;
+    /** Token count of the raw messages before compaction. */
+    inputTokens: number;
+    /** Token count of the produced summary. */
+    outputTokens: number;
+    /** Compression ratio (inputTokens / outputTokens). */
+    compressionRatio: number;
+    /** The summary text that replaced the raw messages. */
+    summary: string;
+    /** Content fragments intentionally dropped (low importance). */
+    droppedContent: string[];
+    /** Named entities preserved in the summary. */
+    preservedEntities: string[];
+    /** Memory trace IDs created from this compaction. */
+    tracesCreated: string[];
+    /** Observation notes extracted during compaction (hybrid strategy). */
+    observationNotes?: ObservationNote[];
+    /** Emotional context at time of compaction. */
+    emotionalContext?: EmotionalContext;
+    /** Duration of the compaction operation in ms. */
+    durationMs: number;
+}
+export interface SummaryChainNode {
+    id: string;
+    /** Level in the hierarchy (0 = leaf summary, higher = summary-of-summaries). */
+    level: number;
+    /** Turn range covered by this node. */
+    turnRange: [number, number];
+    /** The summary text. */
+    summary: string;
+    /** Token estimate for this summary. */
+    tokenEstimate: number;
+    /** Timestamp of creation. */
+    createdAt: number;
+    /** ID of the parent node (summary that absorbed this one), if any. */
+    parentId?: string;
+    /** IDs of child nodes that were merged to create this node. */
+    childIds: string[];
+    /** Key entities mentioned in this summary. */
+    entities: string[];
+    /** Compaction entry ID that produced this node. */
+    compactionEntryId: string;
+}
+export interface CompactionInput {
+    /** All messages in the conversation. */
+    messages: ContextMessage[];
+    /** Maximum token budget for the entire context window. */
+    maxContextTokens: number;
+    /** Current total token count. */
+    currentTokens: number;
+    /** Existing summary chain (for incremental compaction). */
+    summaryChain: SummaryChainNode[];
+    /** Current emotional context, if available. */
+    emotionalContext?: EmotionalContext;
+    /** Recent memory traces for context (hybrid strategy). */
+    recentTraces?: MemoryTrace[];
+}
+export interface CompactionResult {
+    /** Messages after compaction (some replaced with summary blocks). */
+    messages: ContextMessage[];
+    /** New summary chain nodes produced. */
+    newNodes: SummaryChainNode[];
+    /** Compaction log entry. */
+    entry: CompactionEntry;
+    /** Memory traces to encode from the compacted content. */
+    tracesToEncode: Partial<MemoryTrace>[];
+}
+export interface ICompactionStrategy {
+    readonly name: CompactionStrategy;
+    compact(input: CompactionInput, config: InfiniteContextConfig): Promise<CompactionResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/memory/pipeline/context/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/memory/pipeline/context/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAC;AAIpF,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,cAAc,GAAG,QAAQ,CAAC;AACvE,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE9D,MAAM,WAAW,qBAAqB;IACpC,iDAAiD;IACjD,OAAO,EAAE,OAAO,CAAC;IACjB,kCAAkC;IAClC,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,iFAAiF;IACjF,mBAAmB,EAAE,MAAM,CAAC;IAC5B,6CAA6C;IAC7C,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kCAAkC;IAClC,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,qBAAqB,EAAE,MAAM,CAAC;IAC9B,6DAA6D;IAC7D,sBAAsB,EAAE,MAAM,CAAC;IAC/B,gFAAgF;IAChF,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACjD,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,+BAA+B,EAAE,qBAS7C,CAAC;AAIF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAID,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,8CAA8C;IAC9C,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,yDAAyD;IACzD,WAAW,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,gBAAgB,EAAE,MAAM,CAAC;IACzB,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,+CAA+C;IAC/C,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,qDAAqD;IACrD,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,uEAAuE;IACvE,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;IACrC,+CAA+C;IAC/C,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC;CACpB;AAID,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,gFAAgF;IAChF,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,aAAa,EAAE,MAAM,CAAC;IACtB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,mDAAmD;IACnD,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAID,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,0DAA0D;IAC1D,gBAAgB,EAAE,MAAM,CAAC;IACzB,iCAAiC;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,YAAY,EAAE,gBAAgB,EAAE,CAAC;IACjC,+CAA+C;IAC/C,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,0DAA0D;IAC1D,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,qEAAqE;IACrE,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,wCAAwC;IACxC,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,4BAA4B;IAC5B,KAAK,EAAE,eAAe,CAAC;IACvB,0DAA0D;IAC1D,cAAc,EAAE,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;CACxC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,OAAO,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC3F"}

package/dist/memory/pipeline/context/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/memory/pipeline/context/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiCH,MAAM,CAAC,MAAM,+BAA+B,GAA0B;IACpE,OAAO,EAAE,KAAK;IACd,QAAQ,EAAE,SAAS;IACnB,mBAAmB,EAAE,IAAI;IACzB,mBAAmB,EAAE,EAAE;IACvB,iBAAiB,EAAE,SAAS;IAC5B,YAAY,EAAE,GAAG;IACjB,qBAAqB,EAAE,IAAI;IAC3B,sBAAsB,EAAE,CAAC;CAC1B,CAAC"}

package/dist/memory/pipeline/lifecycle/IMemoryLifecycleManager.d.ts

@@ -0,0 +1,163 @@
+/**
+ * @fileoverview Defines the interface for the MemoryLifecycleManager (IMemoryLifecycleManager).
+ * This manager is responsible for enforcing data retention and eviction policies
+ * across various memory stores, particularly those managed by the RAG system.
+ * It can interact with GMI instances to negotiate decisions about critical memories.
+ *
+ * @module backend/agentos/memory/lifecycle/IMemoryLifecycleManager
+ * @see ../core/config/MemoryLifecycleManagerConfiguration.ts for configuration.
+ * @see ../cognitive_substrate/IGMI.ts for GMI interaction types.
+ * @see ../core/vector-store/IVectorStoreManager.ts for interaction with storage.
+ */
+import { MemoryLifecycleManagerConfig } from '../../../core/config/MemoryLifecycleManagerConfiguration';
+import { IGMI, LifecycleAction } from '../../../cognitive_substrate/IGMI';
+import { IVectorStoreManager } from '../../../core/vector-store/IVectorStoreManager';
+import { IUtilityAI } from '../../../nlp/ai_utilities/IUtilityAI';
+import { RagMemoryCategory } from '../../../rag/IRetrievalAugmentor';
+/**
+ * Function signature for resolving a GMI instance by its ID.
+ * The MemoryLifecycleManager uses this to fetch a GMI instance for negotiation.
+ *
+ * @async
+ * @param {string} gmiId - The ID of the GMI instance to resolve.
+ * @param {string} [personaId] - Optional: The persona ID associated with the GMI, if relevant for resolving.
+ * @returns {Promise<IGMI | undefined>} The GMI instance, or undefined if not found or not active.
+ */
+export type GMIResolverFunction = (gmiId: string, personaId?: string) => Promise<IGMI | undefined>;
+/**
+ * Options to filter which policies or data items are processed during enforcement.
+ *
+ * @interface PolicyEnforcementFilter
+ * @property {string[]} [policyIds] - Specific policy IDs to enforce. If empty, all enabled policies are considered.
+ * @property {string[]} [dataSourceIds] - Specific RAG Data Source IDs to target.
+ * @property {RagMemoryCategory[]} [categories] - Specific RAG memory categories to target.
+ * @property {string} [gmiOwnerId] - Only process items owned by this GMI.
+ * @property {string} [personaOwnerId] - Only process items associated with this Persona.
+ */
+export interface PolicyEnforcementFilter {
+    policyIds?: string[];
+    dataSourceIds?: string[];
+    categories?: RagMemoryCategory[];
+    gmiOwnerId?: string;
+    personaOwnerId?: string;
+}
+/**
+ * Report detailing the results of a policy enforcement run.
+ *
+ * @interface LifecycleEnforcementReport
+ * @property {Date} startTime - When the enforcement process started.
+ * @property {Date} endTime - When the enforcement process completed.
+ * @property {number} policiesEvaluated - Number of policies considered.
+ * @property {number} itemsScanned - Total number of items scanned across data sources.
+ * @property {number} itemsAffected - Number of items upon which an action was taken (or would have been in dry run).
+ * @property {Record<string, { itemsProcessed: number; actionsTaken: Record<string, number> }>} [policyResults] -
+ * Results per policy ID, detailing items processed and counts of actions taken (e.g., {'delete': 10, 'archive': 5}).
+ * @property {Array<{ itemId: string; policyId: string; action: string; error?: string }>} [errors] - Any errors encountered.
+ * @property {boolean} [wasDryRun] - Indicates if the enforcement was a dry run.
+ */
+export interface LifecycleEnforcementReport {
+    startTime: Date;
+    endTime: Date;
+    policiesEvaluated: number;
+    itemsScanned: number;
+    itemsAffected: number;
+    policyResults?: Record<string, {
+        itemsProcessed: number;
+        actionsTaken: Record<string, number>;
+    }>;
+    errors?: Array<{
+        itemId?: string;
+        policyId?: string;
+        action?: string;
+        message: string;
+        details?: any;
+    }>;
+    wasDryRun?: boolean;
+}
+/**
+ * @interface IMemoryLifecycleManager
+ * @description Defines the contract for managing the lifecycle of stored memories.
+ * This includes applying retention policies, handling eviction, and negotiating
+ * with GMIs about the fate of specific memory items.
+ */
+export interface IMemoryLifecycleManager {
+    /**
+     * A unique identifier for this MemoryLifecycleManager instance.
+     * @readonly
+     */
+    readonly managerId: string;
+    /**
+     * Initializes the MemoryLifecycleManager with its configuration and necessary dependencies.
+     * This method must be called before any other operations.
+     *
+     * @async
+     * @param {MemoryLifecycleManagerConfig} config - The configuration for this manager, including all policies.
+     * @param {IVectorStoreManager} vectorStoreManager - An instance of IVectorStoreManager to interact with data stores.
+     * @param {GMIResolverFunction} gmiResolver - A function to resolve GMI instances for negotiation.
+     * @param {IUtilityAI} [utilityAI] - Optional: An instance of IUtilityAI, needed if any policies involve
+     * summarization actions.
+     * @returns {Promise<void>} A promise that resolves upon successful initialization.
+     * @throws {GMIError | Error} If initialization fails (e.g., invalid config, missing critical dependencies).
+     */
+    initialize(config: MemoryLifecycleManagerConfig, vectorStoreManager: IVectorStoreManager, gmiResolver: GMIResolverFunction, utilityAI?: IUtilityAI): Promise<void>;
+    /**
+     * Triggers the evaluation and enforcement of all applicable (and enabled) memory lifecycle policies.
+     * This can be called manually or be part of a scheduled internal loop.
+     *
+     * @async
+     * @param {PolicyEnforcementFilter} [filter] - Optional filters to narrow down which policies or data to process.
+     * If not provided, all enabled policies are evaluated against all relevant data.
+     * @returns {Promise<LifecycleEnforcementReport>} A report summarizing the actions taken (or that would be taken if dryRun).
+     * @throws {GMIError | Error} If a critical error occurs during the enforcement process.
+     */
+    enforcePolicies(filter?: PolicyEnforcementFilter): Promise<LifecycleEnforcementReport>;
+    /**
+     * Manually triggers a lifecycle check and potential GMI negotiation for a specific item.
+     * This might be used by other systems that detect a potentially obsolete item.
+     *
+     * @async
+     * @param {object} itemContext - Information about the item to process.
+     * @param {string} itemContext.itemId - The ID of the item.
+     * @param {string} itemContext.dataSourceId - The data source where the item resides.
+     * @param {string} [itemContext.gmiOwnerId] - The ID of the GMI that owns or is primarily associated with this item.
+     * @param {string} [itemContext.personaOwnerId] - The ID of the Persona that owns or is primarily associated with this item.
+     * @param {RagMemoryCategory} [itemContext.category] - The category of the item.
+     * @param {Record<string, any>} [itemContext.metadata] - The item's metadata.
+     * @param {string} [itemContext.contentSummary] - A summary of the item's content for GMI negotiation.
+     * @param {string} [triggeringReason] - Why this specific item check was triggered.
+     * @returns {Promise<{ actionTaken: LifecycleAction; details?: any }>} The outcome of processing the item.
+     * @throws {GMIError | Error} If processing the specific item fails.
+     */
+    processSingleItemLifecycle(itemContext: {
+        itemId: string;
+        dataSourceId: string;
+        gmiOwnerId?: string;
+        personaOwnerId?: string;
+        category?: RagMemoryCategory;
+        metadata?: Record<string, any>;
+        contentSummary?: string;
+    }, triggeringReason?: string): Promise<{
+        actionTaken: LifecycleAction;
+        details?: any;
+    }>;
+    /**
+     * Checks the health and operational status of the MemoryLifecycleManager.
+     *
+     * @async
+     * @returns {Promise<{ isHealthy: boolean; details?: Record<string, unknown> }>} Health status.
+     */
+    checkHealth(): Promise<{
+        isHealthy: boolean;
+        details?: Record<string, unknown>;
+    }>;
+    /**
+     * Gracefully shuts down the MemoryLifecycleManager.
+     * This should stop any ongoing background tasks (like periodic policy checks)
+     * and release any resources.
+     *
+     * @async
+     * @returns {Promise<void>} A promise that resolves when shutdown is complete.
+     */
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=IMemoryLifecycleManager.d.ts.map

package/dist/memory/pipeline/lifecycle/IMemoryLifecycleManager.d.ts.map

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

package/dist/memory/pipeline/lifecycle/IMemoryLifecycleManager.js

@@ -0,0 +1,13 @@
+/**
+ * @fileoverview Defines the interface for the MemoryLifecycleManager (IMemoryLifecycleManager).
+ * This manager is responsible for enforcing data retention and eviction policies
+ * across various memory stores, particularly those managed by the RAG system.
+ * It can interact with GMI instances to negotiate decisions about critical memories.
+ *
+ * @module backend/agentos/memory/lifecycle/IMemoryLifecycleManager
+ * @see ../core/config/MemoryLifecycleManagerConfiguration.ts for configuration.
+ * @see ../cognitive_substrate/IGMI.ts for GMI interaction types.
+ * @see ../core/vector-store/IVectorStoreManager.ts for interaction with storage.
+ */
+export {};
+//# sourceMappingURL=IMemoryLifecycleManager.js.map

package/dist/memory/pipeline/lifecycle/IMemoryLifecycleManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IMemoryLifecycleManager.js","sourceRoot":"","sources":["../../../../src/memory/pipeline/lifecycle/IMemoryLifecycleManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/memory/pipeline/lifecycle/MemoryLifecycleManager.d.ts

@@ -0,0 +1,98 @@
+/**
+ * @fileoverview Implements the MemoryLifecycleManager (MemoryLifecycleManager),
+ * responsible for enforcing data retention and eviction policies on memories
+ * stored within the AgentOS RAG system. It uses IUtilityAI for summarization tasks
+ * and interacts with IVectorStoreManager to query and act on stored items.
+ * GMI negotiation is a key feature for handling potentially critical memories.
+ *
+ * @module backend/agentos/memory/lifecycle/MemoryLifecycleManager
+ * @see ./IMemoryLifecycleManager.ts for the interface definition.
+ * @see ../core/config/MemoryLifecycleManagerConfiguration.ts for configuration.
+ * @see ../nlp/ai_utilities/IUtilityAI.ts for summarization.
+ * @see ../core/vector-store/IVectorStore.ts and ../rag/IVectorStoreManager.ts
+ */
+import { IMemoryLifecycleManager, GMIResolverFunction, PolicyEnforcementFilter, LifecycleEnforcementReport } from './IMemoryLifecycleManager';
+import { MemoryLifecycleManagerConfig } from '../../../core/config/MemoryLifecycleManagerConfiguration';
+import { IVectorStoreManager } from '../../../core/vector-store/IVectorStoreManager';
+import { IUtilityAI } from '../../../nlp/ai_utilities/IUtilityAI';
+import { RagMemoryCategory } from '../../../rag/IRetrievalAugmentor';
+import { LifecycleAction } from '../../../cognitive_substrate/IGMI';
+/**
+ * @class MemoryLifecycleManager
+ * @implements {IMemoryLifecycleManager}
+ * Manages the lifecycle of stored memories by enforcing configured policies,
+ * handling data retention, eviction, archival, and negotiating with GMIs.
+ */
+export declare class MemoryLifecycleManager implements IMemoryLifecycleManager {
+    readonly managerId: string;
+    private config;
+    private vectorStoreManager;
+    private gmiResolver;
+    private utilityAI?;
+    private isInitialized;
+    private periodicCheckTimer?;
+    /**
+     * Constructs a MemoryLifecycleManager instance.
+     * The manager is not operational until `initialize` is called.
+     */
+    constructor();
+    /**
+     * @inheritdoc
+     */
+    initialize(config: MemoryLifecycleManagerConfig, vectorStoreManager: IVectorStoreManager, gmiResolver: GMIResolverFunction, utilityAI?: IUtilityAI): Promise<void>;
+    /**
+     * Ensures the manager is initialized before performing operations.
+     * @private
+     */
+    private ensureInitialized;
+    /**
+     * Sets up periodic policy enforcement based on configuration.
+     * @private
+     */
+    private setupPeriodicChecks;
+    /**
+     * @inheritdoc
+     */
+    enforcePolicies(filter?: PolicyEnforcementFilter): Promise<LifecycleEnforcementReport>;
+    /**
+     * Finds candidate items for a given policy.
+     * This is a complex method that needs to interact with IVectorStoreManager and IVectorStore.
+     * @private
+     */
+    private findPolicyCandidates;
+    private negotiateAndDetermineAction;
+    private mapPolicyActionToEventType;
+    private executeLifecycleAction;
+    processSingleItemLifecycle(itemContext: {
+        itemId: string;
+        dataSourceId: string;
+        gmiOwnerId?: string;
+        personaOwnerId?: string;
+        category?: RagMemoryCategory;
+        metadata?: Record<string, any>;
+        contentSummary?: string;
+        textContent?: string;
+    }, triggeringReason?: string): Promise<{
+        actionTaken: LifecycleAction;
+        details?: any;
+    }>;
+    checkHealth(): Promise<{
+        isHealthy: boolean;
+        details?: Record<string, unknown>;
+        dependencies?: any[];
+    }>;
+    shutdown(): Promise<void>;
+    /**
+     * Helper to add entries to the enforcement report's error/trace log.
+     * This is an internal helper.
+     * @param report The report to add to.
+     * @param itemId ID of the item being processed.
+     * @param policyId ID of the policy being applied.
+     * @param action Action taken or intended.
+     * @param message Descriptive message.
+     * @param details Additional details.
+     * @private
+     */
+    private addTraceToReport;
+}
+//# sourceMappingURL=MemoryLifecycleManager.d.ts.map

package/dist/memory/pipeline/lifecycle/MemoryLifecycleManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryLifecycleManager.d.ts","sourceRoot":"","sources":["../../../../src/memory/pipeline/lifecycle/MemoryLifecycleManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,uBAAuB,EACvB,0BAA0B,EAC3B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,4BAA4B,EAG7B,MAAM,0DAA0D,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gDAAgD,CAAC;AAErF,OAAO,EAAE,UAAU,EAAwB,MAAM,sCAAsC,CAAC;AACxF,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAErE,OAAO,EAEL,eAAe,EAEhB,MAAM,mCAAmC,CAAC;AAmD3C;;;;;GAKG;AACH,qBAAa,sBAAuB,YAAW,uBAAuB;IACpE,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,kBAAkB,CAAuB;IACjD,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,SAAS,CAAC,CAAa;IAC/B,OAAO,CAAC,aAAa,CAAkB;IACvC,OAAO,CAAC,kBAAkB,CAAC,CAAiB;IAE5C;;;OAGG;;IAKH;;OAEG;IACU,UAAU,CACrB,MAAM,EAAE,4BAA4B,EACpC,kBAAkB,EAAE,mBAAmB,EACvC,WAAW,EAAE,mBAAmB,EAChC,SAAS,CAAC,EAAE,UAAU,GACrB,OAAO,CAAC,IAAI,CAAC;IAoChB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IA2B3B;;OAEG;IACU,eAAe,CAAC,MAAM,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAqEnG;;;;OAIG;YACW,oBAAoB;YA6EpB,2BAA2B;IAqCzC,OAAO,CAAC,0BAA0B;YAYpB,sBAAsB;IAqIvB,0BAA0B,CACrC,WAAW,EAAE;QACX,MAAM,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAC;QACnF,QAAQ,CAAC,EAAE,iBAAiB,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC7D,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;KAC/C,EACD,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC;QAAE,WAAW,EAAE,eAAe,CAAC;QAAC,OAAO,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC;IAqF9C,WAAW,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,YAAY,CAAC,EAAE,GAAG,EAAE,CAAA;KAAE,CAAC;IAevG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IActC;;;;;;;;;;OAUG;IACH,OAAO,CAAC,gBAAgB;CAqBzB"}