@framers/agentos 0.1.46 → 0.1.48

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

@@ -0,0 +1,245 @@
+/**
+ * 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.
+ */
+function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+function generateId() {
+    return `hybrid-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+}
+export class HybridStrategy {
+    constructor(llmInvoker, observer, reflector) {
+        this.name = 'hybrid';
+        this.llmInvoker = llmInvoker;
+        this.observer = observer;
+        this.reflector = reflector;
+    }
+    async compact(input, config) {
+        const startTime = Date.now();
+        const { messages } = input;
+        const preserveCount = Math.min(config.preserveRecentTurns * 2, messages.length - 2);
+        const splitIdx = messages.length - preserveCount;
+        if (splitIdx <= 0) {
+            return this.noopResult(messages, startTime);
+        }
+        const toCompact = messages.slice(0, splitIdx);
+        const toKeep = messages.slice(splitIdx);
+        const inputTokens = toCompact.reduce((s, m) => s + m.tokenEstimate, 0);
+        const turnRange = [
+            toCompact[0].turnIndex,
+            toCompact[toCompact.length - 1].turnIndex,
+        ];
+        // ── Phase 1: Extract observation notes via MemoryObserver ────────
+        const observationNotes = [];
+        if (this.observer) {
+            // Feed all compactable messages through the observer.
+            for (const msg of toCompact) {
+                const notes = await this.observer.observe(msg.role, msg.content, input.emotionalContext
+                    ? {
+                        valence: input.emotionalContext.valence,
+                        arousal: input.emotionalContext.arousal,
+                        dominance: input.emotionalContext.dominance,
+                    }
+                    : undefined);
+                if (notes)
+                    observationNotes.push(...notes);
+            }
+            // Force-extract any remaining buffered content.
+            const remaining = await this.observer.extractNotes(input.emotionalContext
+                ? {
+                    valence: input.emotionalContext.valence,
+                    arousal: input.emotionalContext.arousal,
+                    dominance: input.emotionalContext.dominance,
+                }
+                : undefined);
+            if (remaining)
+                observationNotes.push(...remaining);
+        }
+        // ── Phase 2: Consolidate notes into long-term traces via Reflector
+        const tracesToEncode = [];
+        if (this.reflector && observationNotes.length > 0) {
+            // Feed notes to reflector.
+            for (const note of observationNotes) {
+                const result = await this.reflector.addNotes([note]);
+                if (result) {
+                    tracesToEncode.push(...result.traces);
+                }
+            }
+            // Force reflect if notes remain.
+            if (this.reflector.getPendingNoteCount() > 0) {
+                const result = await this.reflector.reflect();
+                if (result) {
+                    tracesToEncode.push(...result.traces);
+                }
+            }
+        }
+        // ── Phase 3: Generate narrative summary (for prompt context) ─────
+        const summary = await this.generateHybridSummary(toCompact, observationNotes, tracesToEncode, config);
+        const outputTokens = estimateTokens(summary);
+        // ── Assemble result ──────────────────────────────────────────────
+        const summaryMessage = {
+            role: 'system',
+            content: [
+                `[Hybrid compaction — turns ${turnRange[0]}–${turnRange[1]}]`,
+                `[${inputTokens} tokens → ${outputTokens} tokens, ${observationNotes.length} observations, ${tracesToEncode.length} traces created]`,
+                summary,
+            ].join('\n'),
+            timestamp: Date.now(),
+            turnIndex: toCompact[0].turnIndex,
+            tokenEstimate: outputTokens + 30,
+            compacted: true,
+        };
+        const entryId = generateId();
+        const entities = this.extractEntities(summary, observationNotes);
+        const node = {
+            id: `chain-${entryId}`,
+            level: 0,
+            turnRange,
+            summary,
+            tokenEstimate: outputTokens,
+            createdAt: Date.now(),
+            childIds: [],
+            entities,
+            compactionEntryId: entryId,
+        };
+        const entry = {
+            id: entryId,
+            timestamp: Date.now(),
+            turnRange,
+            strategy: 'hybrid',
+            inputTokens,
+            outputTokens,
+            compressionRatio: outputTokens > 0
+                ? Math.round((inputTokens / outputTokens) * 10) / 10
+                : inputTokens,
+            summary,
+            droppedContent: [],
+            preservedEntities: entities,
+            tracesCreated: tracesToEncode
+                .filter((t) => t.id)
+                .map((t) => t.id),
+            observationNotes,
+            emotionalContext: input.emotionalContext,
+            durationMs: Date.now() - startTime,
+        };
+        return {
+            messages: [summaryMessage, ...toKeep],
+            newNodes: [node],
+            entry,
+            tracesToEncode,
+        };
+    }
+    // ── Summary generation ─────────────────────────────────────────────
+    async generateHybridSummary(messages, notes, traces, config) {
+        const conversationText = messages
+            .map((m) => `[${m.role}] ${m.content}`)
+            .join('\n');
+        const inputTokens = estimateTokens(conversationText);
+        const targetTokens = Math.max(120, Math.ceil(inputTokens / config.targetCompressionRatio));
+        // Build context from extracted notes and traces.
+        const notesSummary = notes.length > 0
+            ? `\n\nExtracted observations (${notes.length}):\n${notes
+                .slice(0, 15)
+                .map((n) => `- [${n.type}] ${n.content} (importance: ${n.importance.toFixed(2)})`)
+                .join('\n')}`
+            : '';
+        const tracesSummary = traces.length > 0
+            ? `\n\nConsolidated memory traces (${traces.length}):\n${traces
+                .slice(0, 10)
+                .map((t) => `- [${t.type}/${t.scope}] ${t.content?.slice(0, 150)}`)
+                .join('\n')}`
+            : '';
+        const prompt = [
+            'Create a rich conversation summary that serves as context for an ongoing conversation.',
+            'You have access to both the raw conversation AND extracted cognitive observations.',
+            '',
+            'Structure your summary as:',
+            '1. **Key context**: What the conversation is about, who is involved',
+            '2. **Decisions & outcomes**: What was decided, built, or resolved',
+            '3. **Open threads**: Unresolved questions, pending work, next steps',
+            '4. **Important details**: Technical specifics, file paths, configurations',
+            '',
+            `Target: ~${targetTokens} tokens.`,
+            '',
+            'Raw conversation:',
+            conversationText,
+            notesSummary,
+            tracesSummary,
+            '',
+            'Summary:',
+        ].join('\n');
+        try {
+            return (await this.llmInvoker(prompt)).trim();
+        }
+        catch {
+            // Fallback: use observation notes as summary.
+            if (notes.length > 0) {
+                return notes
+                    .sort((a, b) => b.importance - a.importance)
+                    .slice(0, 10)
+                    .map((n) => `[${n.type}] ${n.content}`)
+                    .join('\n');
+            }
+            return `Conversation turns ${messages[0].turnIndex}–${messages[messages.length - 1].turnIndex}: ${messages
+                .filter((m) => m.role === 'user')
+                .slice(0, 3)
+                .map((m) => m.content.slice(0, 100))
+                .join('; ')}`;
+        }
+    }
+    // ── Helpers ────────────────────────────────────────────────────────
+    extractEntities(summary, notes) {
+        const entities = new Set();
+        // From summary text.
+        const patterns = [
+            /[\w/.-]+\.\w{1,5}/g,
+            /https?:\/\/[^\s)]+/g,
+            /`[^`]+`/g,
+        ];
+        for (const p of patterns) {
+            const matches = summary.match(p);
+            if (matches) {
+                for (const m of matches)
+                    entities.add(m.replace(/`/g, ''));
+            }
+        }
+        // From observation notes.
+        for (const note of notes) {
+            if (note.entities) {
+                for (const e of note.entities)
+                    entities.add(e);
+            }
+        }
+        return Array.from(entities).slice(0, 50);
+    }
+    noopResult(messages, startTime) {
+        return {
+            messages,
+            newNodes: [],
+            entry: {
+                id: generateId(),
+                timestamp: Date.now(),
+                turnRange: [0, 0],
+                strategy: 'hybrid',
+                inputTokens: 0,
+                outputTokens: 0,
+                compressionRatio: 1,
+                summary: '',
+                droppedContent: [],
+                preservedEntities: [],
+                tracesCreated: [],
+                durationMs: Date.now() - startTime,
+            },
+            tracesToEncode: [],
+        };
+    }
+}
+//# sourceMappingURL=HybridStrategy.js.map

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

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

package/dist/memory/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 '../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/context/strategies/SlidingSummaryStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SlidingSummaryStrategy.d.ts","sourceRoot":"","sources":["../../../../src/memory/context/strategies/SlidingSummaryStrategy.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAEV,eAAe,EACf,gBAAgB,EAEhB,mBAAmB,EACnB,qBAAqB,EAEtB,MAAM,aAAa,CAAC;AAWrB,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/context/strategies/SlidingSummaryStrategy.js

@@ -0,0 +1,203 @@
+/**
+ * SlidingSummaryStrategy — Default compaction strategy.
+ *
+ * Summarizes the oldest N messages into a single paragraph, preserving
+ * the most recent K turns raw. Simple, predictable, low latency.
+ */
+/** ~4 chars per token. */
+function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+function generateId() {
+    return `compact-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+}
+export class SlidingSummaryStrategy {
+    constructor(llmInvoker) {
+        this.name = 'sliding';
+        this.llmInvoker = llmInvoker;
+    }
+    async compact(input, config) {
+        const startTime = Date.now();
+        const { messages, maxContextTokens } = input;
+        // Determine how many messages to keep raw.
+        const preserveCount = Math.min(config.preserveRecentTurns * 2, // turns → messages (user+assistant)
+        messages.length - 2);
+        const splitIdx = messages.length - preserveCount;
+        if (splitIdx <= 0) {
+            // Nothing to compact.
+            return this.noopResult(messages, startTime);
+        }
+        const toCompact = messages.slice(0, splitIdx);
+        const toKeep = messages.slice(splitIdx);
+        // Calculate input tokens.
+        const inputTokens = toCompact.reduce((s, m) => s + m.tokenEstimate, 0);
+        // Build the summarization prompt.
+        const targetTokens = Math.max(100, Math.ceil(inputTokens / config.targetCompressionRatio));
+        const conversationText = toCompact
+            .map((m) => `[${m.role}] ${m.content}`)
+            .join('\n');
+        const prompt = [
+            'Summarize this conversation segment concisely, preserving:',
+            '- All decisions made and their rationale',
+            '- Action items and commitments',
+            '- Named entities (people, projects, URLs, file paths)',
+            '- Technical details that affect ongoing work',
+            '- Any unresolved questions or open threads',
+            '',
+            'Drop: greetings, filler, repeated information, verbose explanations of things already decided.',
+            `Target length: ~${targetTokens} tokens.`,
+            '',
+            `Conversation (turns ${toCompact[0].turnIndex}–${toCompact[toCompact.length - 1].turnIndex}):`,
+            '',
+            conversationText,
+            '',
+            'Summary:',
+        ].join('\n');
+        let summary;
+        let entities;
+        let droppedContent = [];
+        try {
+            const raw = await this.llmInvoker(prompt);
+            summary = raw.trim();
+            entities = this.extractEntities(summary);
+            droppedContent = this.detectDropped(toCompact, summary);
+        }
+        catch {
+            // Fallback: take first and last messages as crude summary.
+            summary = this.fallbackSummary(toCompact);
+            entities = this.extractEntities(summary);
+        }
+        const outputTokens = estimateTokens(summary);
+        const turnRange = [
+            toCompact[0].turnIndex,
+            toCompact[toCompact.length - 1].turnIndex,
+        ];
+        // Build the summary message that replaces compacted messages.
+        const summaryMessage = {
+            role: 'system',
+            content: `[Conversation summary — turns ${turnRange[0]}–${turnRange[1]}, ${inputTokens} tokens compressed to ${outputTokens}]\n${summary}`,
+            timestamp: Date.now(),
+            turnIndex: toCompact[0].turnIndex,
+            tokenEstimate: outputTokens + 20, // overhead for the header
+            compacted: true,
+        };
+        const entryId = generateId();
+        const node = {
+            id: `chain-${entryId}`,
+            level: 0,
+            turnRange,
+            summary,
+            tokenEstimate: outputTokens,
+            createdAt: Date.now(),
+            childIds: [],
+            entities,
+            compactionEntryId: entryId,
+        };
+        const entry = {
+            id: entryId,
+            timestamp: Date.now(),
+            turnRange,
+            strategy: 'sliding',
+            inputTokens,
+            outputTokens,
+            compressionRatio: outputTokens > 0
+                ? Math.round((inputTokens / outputTokens) * 10) / 10
+                : inputTokens,
+            summary,
+            droppedContent,
+            preservedEntities: entities,
+            tracesCreated: [],
+            emotionalContext: input.emotionalContext,
+            durationMs: Date.now() - startTime,
+        };
+        return {
+            messages: [summaryMessage, ...toKeep],
+            newNodes: [node],
+            entry,
+            tracesToEncode: [],
+        };
+    }
+    // ── Helpers ────────────────────────────────────────────────────────
+    /** Extract likely entity names from summary text. */
+    extractEntities(text) {
+        const entities = new Set();
+        // File paths.
+        const pathMatches = text.match(/[\w/.-]+\.\w{1,5}/g);
+        if (pathMatches) {
+            for (const p of pathMatches)
+                entities.add(p);
+        }
+        // URLs.
+        const urlMatches = text.match(/https?:\/\/[^\s)]+/g);
+        if (urlMatches) {
+            for (const u of urlMatches)
+                entities.add(u);
+        }
+        // Capitalized multi-word names (simple heuristic).
+        const nameMatches = text.match(/[A-Z][a-z]+(?:\s+[A-Z][a-z]+)+/g);
+        if (nameMatches) {
+            for (const n of nameMatches)
+                entities.add(n);
+        }
+        // Backtick-quoted identifiers.
+        const codeMatches = text.match(/`[^`]+`/g);
+        if (codeMatches) {
+            for (const c of codeMatches)
+                entities.add(c.replace(/`/g, ''));
+        }
+        return Array.from(entities).slice(0, 50); // cap at 50
+    }
+    /** Detect content fragments from compacted messages missing from summary. */
+    detectDropped(messages, summary) {
+        const dropped = [];
+        const summaryLower = summary.toLowerCase();
+        for (const msg of messages) {
+            // Check if any significant user statements are absent.
+            if (msg.role !== 'user' || msg.content.length < 30)
+                continue;
+            // Extract key phrases (first sentence or up to 80 chars).
+            const firstSentence = msg.content.split(/[.!?\n]/)[0].trim();
+            if (firstSentence.length > 15 &&
+                !summaryLower.includes(firstSentence.toLowerCase().slice(0, 30))) {
+                dropped.push(`Turn ${msg.turnIndex}: "${firstSentence.slice(0, 100)}"`);
+            }
+        }
+        return dropped.slice(0, 20); // cap
+    }
+    /** Crude fallback when LLM is unavailable. */
+    fallbackSummary(messages) {
+        const userMsgs = messages.filter((m) => m.role === 'user');
+        if (userMsgs.length === 0)
+            return 'Previous conversation context.';
+        // Take first and last user messages as anchors.
+        const first = userMsgs[0].content.slice(0, 200);
+        const last = userMsgs[userMsgs.length - 1].content.slice(0, 200);
+        if (userMsgs.length === 1) {
+            return `User discussed: ${first}`;
+        }
+        return `Conversation started with: ${first}\n\nMost recently discussed: ${last}`;
+    }
+    /** No-op result when nothing needs compaction. */
+    noopResult(messages, startTime) {
+        return {
+            messages,
+            newNodes: [],
+            entry: {
+                id: generateId(),
+                timestamp: Date.now(),
+                turnRange: [0, 0],
+                strategy: 'sliding',
+                inputTokens: 0,
+                outputTokens: 0,
+                compressionRatio: 1,
+                summary: '',
+                droppedContent: [],
+                preservedEntities: [],
+                tracesCreated: [],
+                durationMs: Date.now() - startTime,
+            },
+            tracesToEncode: [],
+        };
+    }
+}
+//# sourceMappingURL=SlidingSummaryStrategy.js.map

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

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

package/dist/memory/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 '../types.js';
+import type { ObservationNote } from '../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/context/types.d.ts.map

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

package/dist/memory/context/types.js

@@ -0,0 +1,17 @@
+/**
+ * Infinite Context Window — Types
+ *
+ * Data model for context window lifecycle management, compaction strategies,
+ * and transparency logging.
+ */
+export const DEFAULT_INFINITE_CONTEXT_CONFIG = {
+    enabled: false,
+    strategy: 'sliding',
+    compactionThreshold: 0.75,
+    preserveRecentTurns: 20,
+    transparencyLevel: 'summary',
+    logRetention: 100,
+    maxSummaryChainTokens: 2000,
+    targetCompressionRatio: 8,
+};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/memory/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"}