zora-agent 0.9.4 → 0.9.6

package/dist/memory/observation-store.js.map

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

package/dist/memory/observer-worker.d.ts

@@ -0,0 +1,34 @@
+/**
+ * ObserverWorker — Background agent that compresses raw messages
+ * into dated, priority-tagged observations.
+ *
+ * Runs asynchronously so the agent never blocks during compression.
+ * Uses a cheap/fast model (e.g., Gemini Flash) for cost efficiency.
+ */
+import type { AgentEvent } from '../types.js';
+import type { ObservationBlock } from './observation-store.js';
+/**
+ * Function signature for the LLM compression call.
+ * Accepts a prompt string, returns the compressed observations.
+ */
+export type CompressFn = (prompt: string) => Promise<string>;
+export declare class ObserverWorker {
+    private readonly _compressFn;
+    constructor(compressFn: CompressFn);
+    /**
+     * Compress a chunk of messages into an observation block.
+     * This is the core compression operation — called in the background by ContextCompressor.
+     *
+     * @param messages The raw messages to compress
+     * @param startIndex The global message index of the first message (for the prompt)
+     * @param existingObservations Previously compressed observations (for dedup context)
+     * @param sessionId The session these messages belong to
+     */
+    compress(messages: AgentEvent[], startIndex: number, existingObservations: string, sessionId: string): Promise<ObservationBlock>;
+    /**
+     * Fallback compression when the LLM call fails.
+     * Produces a minimal summary from event types and timestamps.
+     */
+    private _fallbackCompress;
+}
+//# sourceMappingURL=observer-worker.d.ts.map

package/dist/memory/observer-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observer-worker.d.ts","sourceRoot":"","sources":["../../src/memory/observer-worker.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAO/D;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAsF7D,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;gBAE7B,UAAU,EAAE,UAAU;IAIlC;;;;;;;;OAQG;IACG,QAAQ,CACZ,QAAQ,EAAE,UAAU,EAAE,EACtB,UAAU,EAAE,MAAM,EAClB,oBAAoB,EAAE,MAAM,EAC5B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,gBAAgB,CAAC;IAmC5B;;;OAGG;IACH,OAAO,CAAC,iBAAiB;CAqC1B"}

package/dist/memory/observer-worker.js

@@ -0,0 +1,161 @@
+/**
+ * ObserverWorker — Background agent that compresses raw messages
+ * into dated, priority-tagged observations.
+ *
+ * Runs asynchronously so the agent never blocks during compression.
+ * Uses a cheap/fast model (e.g., Gemini Flash) for cost efficiency.
+ */
+import { ObservationStore } from './observation-store.js';
+import { estimateTokens } from './token-estimator.js';
+import { createLogger } from '../utils/logger.js';
+const log = createLogger('observer-worker');
+/**
+ * Serializes an AgentEvent into a human-readable string for the observer prompt.
+ */
+function serializeEvent(event, index) {
+    const ts = event.timestamp instanceof Date
+        ? event.timestamp.toISOString()
+        : String(event.timestamp);
+    const content = event.content;
+    if (typeof content === 'string') {
+        return `[${index}] ${ts} [${event.type}] ${content}`;
+    }
+    if (content && typeof content === 'object') {
+        const obj = content;
+        switch (event.type) {
+            case 'text':
+            case 'thinking':
+            case 'steering':
+                return `[${index}] ${ts} [${event.type}] ${String(obj['text'] ?? '')}`;
+            case 'tool_call':
+                return `[${index}] ${ts} [tool_call] ${String(obj['tool'] ?? 'unknown')}(${JSON.stringify(obj['arguments'] ?? {}).substring(0, 500)})`;
+            case 'tool_result': {
+                const resultStr = JSON.stringify(obj['result'] ?? '');
+                const truncated = resultStr.length > 500 ? resultStr.substring(0, 500) + '...' : resultStr;
+                return `[${index}] ${ts} [tool_result] ${truncated}`;
+            }
+            case 'error':
+                return `[${index}] ${ts} [error] ${String(obj['message'] ?? JSON.stringify(content))}`;
+            case 'done':
+                return `[${index}] ${ts} [done] ${String(obj['text'] ?? '')}`;
+            default:
+                return `[${index}] ${ts} [${event.type}] ${JSON.stringify(content).substring(0, 500)}`;
+        }
+    }
+    return `[${index}] ${ts} [${event.type}] ${String(content)}`;
+}
+/**
+ * Build the observer prompt.
+ */
+function buildObserverPrompt(messages, startIndex, existingObservations) {
+    const serialized = messages.map((m, i) => serializeEvent(m, startIndex + i)).join('\n');
+    const existingBlock = existingObservations
+        ? `\nExisting observations (for context, do NOT repeat these):\n${existingObservations}\n`
+        : '';
+    return `You are a conversation observer. Compress the following messages into concise, dated observations. Preserve:
+- Decisions made and their reasoning
+- Key facts learned or stated
+- Tool results that inform future actions
+- Errors encountered and how they were resolved
+- User preferences expressed
+
+Format each observation as:
+[YYYY-MM-DD HH:MM] <PRIORITY> <observation>
+
+Priority levels:
+  CRITICAL — Decisions, errors, blockers that affect future actions
+  IMPORTANT — Key facts, preferences, tool outcomes
+  NOTE — Background context, minor details
+
+Rules:
+- Be concise. Target 3-6x compression ratio.
+- Preserve exact names, paths, IDs, and values (never paraphrase these).
+- Group related observations by topic when possible.
+- If a tool result is very large, summarize the outcome, not the raw output.
+- Do not repeat information from existing observations.
+${existingBlock}
+Messages to compress:
+${serialized}`;
+}
+export class ObserverWorker {
+    _compressFn;
+    constructor(compressFn) {
+        this._compressFn = compressFn;
+    }
+    /**
+     * Compress a chunk of messages into an observation block.
+     * This is the core compression operation — called in the background by ContextCompressor.
+     *
+     * @param messages The raw messages to compress
+     * @param startIndex The global message index of the first message (for the prompt)
+     * @param existingObservations Previously compressed observations (for dedup context)
+     * @param sessionId The session these messages belong to
+     */
+    async compress(messages, startIndex, existingObservations, sessionId) {
+        const prompt = buildObserverPrompt(messages, startIndex, existingObservations);
+        let observations;
+        try {
+            observations = await this._compressFn(prompt);
+        }
+        catch (err) {
+            // On failure, fall back to a basic summary
+            log.error({ err, messageCount: messages.length }, 'Observer compression failed, using fallback');
+            observations = this._fallbackCompress(messages, startIndex);
+        }
+        const block = {
+            id: ObservationStore.generateId(),
+            sessionId,
+            createdAt: new Date().toISOString(),
+            tier: 'session',
+            observations,
+            sourceMessageRange: [startIndex, startIndex + messages.length],
+            estimatedTokens: estimateTokens(observations),
+        };
+        log.info({
+            sessionId,
+            inputMessages: messages.length,
+            outputTokens: block.estimatedTokens,
+            range: block.sourceMessageRange,
+        }, 'Observation block created');
+        return block;
+    }
+    /**
+     * Fallback compression when the LLM call fails.
+     * Produces a minimal summary from event types and timestamps.
+     */
+    _fallbackCompress(messages, startIndex) {
+        const first = messages[0];
+        const last = messages[messages.length - 1];
+        const firstTs = first?.timestamp instanceof Date
+            ? first.timestamp.toISOString().substring(0, 16).replace('T', ' ')
+            : 'unknown';
+        const lastTs = last?.timestamp instanceof Date
+            ? last.timestamp.toISOString().substring(0, 16).replace('T', ' ')
+            : 'unknown';
+        const typeCounts = new Map();
+        for (const m of messages) {
+            typeCounts.set(m.type, (typeCounts.get(m.type) ?? 0) + 1);
+        }
+        const typeBreakdown = [...typeCounts.entries()]
+            .map(([type, count]) => `${count} ${type}`)
+            .join(', ');
+        // Extract text content from text events for minimal context
+        const textSnippets = [];
+        for (const m of messages) {
+            if (m.type === 'text' && m.content && typeof m.content === 'object') {
+                const text = m.content['text'];
+                if (typeof text === 'string' && text.length > 0) {
+                    textSnippets.push(text.substring(0, 100));
+                    if (textSnippets.length >= 3)
+                        break;
+                }
+            }
+        }
+        let summary = `[${firstTs}] NOTE — Compressed ${messages.length} messages (indices ${startIndex}-${startIndex + messages.length - 1}): ${typeBreakdown}`;
+        if (textSnippets.length > 0) {
+            summary += `\n[${lastTs}] NOTE — Key content: ${textSnippets.join(' | ')}`;
+        }
+        return summary;
+    }
+}
+//# sourceMappingURL=observer-worker.js.map

package/dist/memory/observer-worker.js.map

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

package/dist/memory/reflector-worker.d.ts

@@ -0,0 +1,40 @@
+/**
+ * ReflectorWorker — Condenses session observations into cross-session memory.
+ *
+ * When session-tier observations exceed their token budget, the Reflector:
+ *   1. Extracts persistent facts worth remembering across sessions
+ *   2. Condenses remaining observations (merge related, drop stale)
+ *   3. Feeds extracted facts into StructuredMemory as new MemoryItems
+ *
+ * Also runs on session end to capture any remaining valuable observations.
+ */
+import type { MemoryManager } from './memory-manager.js';
+import { ObservationStore } from './observation-store.js';
+import type { CompressFn } from './observer-worker.js';
+export interface ReflectionResult {
+    itemsCreated: number;
+    condensedObservations: string;
+    condensedTokens: number;
+}
+export declare class ReflectorWorker {
+    private readonly _compressFn;
+    private readonly _memoryManager;
+    constructor(compressFn: CompressFn, memoryManager: MemoryManager);
+    /**
+     * Reflect on session observations: extract persistent facts and condense.
+     *
+     * @param observations The session-tier observation text to reflect on
+     * @param sessionId The session ID (used as source for created items)
+     */
+    reflect(observations: string, sessionId: string): Promise<ReflectionResult>;
+    /**
+     * Run reflection and persist condensed observations as a cross-session block.
+     */
+    reflectAndPersist(observations: string, sessionId: string, store: ObservationStore): Promise<ReflectionResult>;
+    /**
+     * Parse the reflector's response into facts and condensed observations.
+     * Handles malformed responses gracefully.
+     */
+    private _parseReflectorResponse;
+}
+//# sourceMappingURL=reflector-worker.d.ts.map

package/dist/memory/reflector-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflector-worker.d.ts","sourceRoot":"","sources":["../../src/memory/reflector-worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAyB,MAAM,wBAAwB,CAAC;AACjF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAevD,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,eAAe,EAAE,MAAM,CAAC;CACzB;AAkCD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IACzC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgB;gBAEnC,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa;IAKhE;;;;;OAKG;IACG,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAkEjF;;OAEG;IACG,iBAAiB,CACrB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,gBAAgB,CAAC;IAqB5B;;;OAGG;IACH,OAAO,CAAC,uBAAuB;CAgDhC"}

package/dist/memory/reflector-worker.js

@@ -0,0 +1,185 @@
+/**
+ * ReflectorWorker — Condenses session observations into cross-session memory.
+ *
+ * When session-tier observations exceed their token budget, the Reflector:
+ *   1. Extracts persistent facts worth remembering across sessions
+ *   2. Condenses remaining observations (merge related, drop stale)
+ *   3. Feeds extracted facts into StructuredMemory as new MemoryItems
+ *
+ * Also runs on session end to capture any remaining valuable observations.
+ */
+import { ObservationStore } from './observation-store.js';
+import { estimateTokens } from './token-estimator.js';
+import { createLogger } from '../utils/logger.js';
+const log = createLogger('reflector-worker');
+const VALID_TYPES = ['profile', 'event', 'knowledge', 'behavior', 'skill', 'tool'];
+/**
+ * Build the reflector prompt.
+ */
+function buildReflectorPrompt(observations) {
+    return `You are a memory reflector. Review these session observations and produce TWO sections:
+
+## SECTION 1: PERSISTENT FACTS
+Extract facts worth remembering across sessions. These are things like:
+- User preferences, habits, or identity facts
+- Project decisions that affect future work
+- Important configurations, paths, or environment details
+- Skills or procedures the agent learned
+- Recurring patterns or behaviors
+
+Output as a JSON array on a SINGLE line after the header "FACTS:":
+FACTS: [{"summary": "...", "type": "knowledge|behavior|profile|event|skill|tool", "tags": ["tag1", "tag2"]}]
+
+If no persistent facts, output: FACTS: []
+
+## SECTION 2: CONDENSED OBSERVATIONS
+Condense the remaining observations:
+- Merge related entries
+- Drop anything no longer relevant (completed tasks, resolved errors)
+- Keep CRITICAL items verbatim
+- Preserve exact names, paths, IDs
+
+Output the condensed observations in the same dated format after the header "CONDENSED:"
+
+Observations to reflect on:
+${observations}`;
+}
+export class ReflectorWorker {
+    _compressFn;
+    _memoryManager;
+    constructor(compressFn, memoryManager) {
+        this._compressFn = compressFn;
+        this._memoryManager = memoryManager;
+    }
+    /**
+     * Reflect on session observations: extract persistent facts and condense.
+     *
+     * @param observations The session-tier observation text to reflect on
+     * @param sessionId The session ID (used as source for created items)
+     */
+    async reflect(observations, sessionId) {
+        if (!observations.trim()) {
+            return { itemsCreated: 0, condensedObservations: '', condensedTokens: 0 };
+        }
+        const prompt = buildReflectorPrompt(observations);
+        let response;
+        try {
+            response = await this._compressFn(prompt);
+        }
+        catch (err) {
+            log.error({ err }, 'Reflector compression call failed');
+            // On failure, return observations unchanged
+            return {
+                itemsCreated: 0,
+                condensedObservations: observations,
+                condensedTokens: estimateTokens(observations),
+            };
+        }
+        // Parse the response into facts + condensed observations
+        const { facts, condensed } = this._parseReflectorResponse(response);
+        // Create memory items from extracted facts
+        let itemsCreated = 0;
+        for (const fact of facts) {
+            try {
+                const itemType = VALID_TYPES.includes(fact.type)
+                    ? fact.type
+                    : 'knowledge';
+                await this._memoryManager.structuredMemory.createItem({
+                    type: itemType,
+                    summary: fact.summary,
+                    source: sessionId,
+                    source_type: 'agent_analysis',
+                    tags: fact.tags,
+                    category: `${itemType}/reflected`,
+                });
+                itemsCreated++;
+            }
+            catch (err) {
+                log.debug({ err, fact: fact.summary }, 'Failed to create reflected memory item');
+            }
+        }
+        // Invalidate memory index since we added items
+        if (itemsCreated > 0) {
+            this._memoryManager.invalidateIndex();
+        }
+        const condensedTokens = estimateTokens(condensed);
+        log.info({
+            sessionId,
+            factsExtracted: facts.length,
+            itemsCreated,
+            inputTokens: estimateTokens(observations),
+            condensedTokens,
+        }, 'Reflection complete');
+        return { itemsCreated, condensedObservations: condensed, condensedTokens };
+    }
+    /**
+     * Run reflection and persist condensed observations as a cross-session block.
+     */
+    async reflectAndPersist(observations, sessionId, store) {
+        const result = await this.reflect(observations, sessionId);
+        if (result.condensedObservations.trim()) {
+            const block = {
+                id: ObservationStore.generateId(),
+                sessionId,
+                createdAt: new Date().toISOString(),
+                tier: 'cross-session',
+                observations: result.condensedObservations,
+                sourceMessageRange: [0, 0], // Not applicable for cross-session
+                estimatedTokens: result.condensedTokens,
+            };
+            await store.append(block);
+        }
+        return result;
+    }
+    // ── Private helpers ──────────────────────────────────────────────
+    /**
+     * Parse the reflector's response into facts and condensed observations.
+     * Handles malformed responses gracefully.
+     */
+    _parseReflectorResponse(response) {
+        let facts = [];
+        let condensed = '';
+        // Extract FACTS line
+        const factsMatch = response.match(/FACTS:\s*(\[[\s\S]*?\])\s*(?:\n|CONDENSED:|$)/);
+        if (factsMatch?.[1]) {
+            try {
+                const parsed = JSON.parse(factsMatch[1]);
+                if (Array.isArray(parsed)) {
+                    facts = parsed.filter((f) => typeof f === 'object' &&
+                        f !== null &&
+                        typeof f.summary === 'string' &&
+                        f.summary.length > 0).map(f => ({
+                        summary: f.summary,
+                        type: typeof f.type === 'string' ? f.type : 'knowledge',
+                        tags: Array.isArray(f.tags) ? f.tags.filter((t) => typeof t === 'string') : [],
+                    }));
+                }
+            }
+            catch {
+                log.debug('Failed to parse FACTS JSON from reflector response');
+            }
+        }
+        // Extract CONDENSED section (everything after "CONDENSED:")
+        const condensedMatch = response.match(/CONDENSED:\s*([\s\S]*)/);
+        if (condensedMatch?.[1]) {
+            condensed = condensedMatch[1].trim();
+        }
+        else {
+            // Fallback: if no CONDENSED marker, use the part after FACTS
+            // Use proper bracket matching to avoid cutting off inside JSON arrays
+            const factsMatch = response.match(/FACTS:\s*(\[[\s\S]*?\](?:\s*,\s*\[[\s\S]*?\])*)/);
+            if (factsMatch) {
+                const afterFacts = response.substring(factsMatch.index + factsMatch[0].length).trim();
+                if (afterFacts) {
+                    condensed = afterFacts;
+                }
+            }
+            else {
+                // No FACTS found at all, use entire response as condensed
+                condensed = response.trim();
+            }
+        }
+        return { facts, condensed };
+    }
+}
+//# sourceMappingURL=reflector-worker.js.map

package/dist/memory/reflector-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflector-worker.js","sourceRoot":"","sources":["../../src/memory/reflector-worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,gBAAgB,EAAyB,MAAM,wBAAwB,CAAC;AAGjF,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,GAAG,GAAG,YAAY,CAAC,kBAAkB,CAAC,CAAC;AAE7C,MAAM,WAAW,GAAqB,CAAC,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AAcrG;;GAEG;AACH,SAAS,oBAAoB,CAAC,YAAoB;IAChD,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;EAyBP,YAAY,EAAE,CAAC;AACjB,CAAC;AAED,MAAM,OAAO,eAAe;IACT,WAAW,CAAa;IACxB,cAAc,CAAgB;IAE/C,YAAY,UAAsB,EAAE,aAA4B;QAC9D,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAC9B,IAAI,CAAC,cAAc,GAAG,aAAa,CAAC;IACtC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,OAAO,CAAC,YAAoB,EAAE,SAAiB;QACnD,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC;YACzB,OAAO,EAAE,YAAY,EAAE,CAAC,EAAE,qBAAqB,EAAE,EAAE,EAAE,eAAe,EAAE,CAAC,EAAE,CAAC;QAC5E,CAAC;QAED,MAAM,MAAM,GAAG,oBAAoB,CAAC,YAAY,CAAC,CAAC;QAElD,IAAI,QAAgB,CAAC;QACrB,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAC5C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,EAAE,mCAAmC,CAAC,CAAC;YACxD,4CAA4C;YAC5C,OAAO;gBACL,YAAY,EAAE,CAAC;gBACf,qBAAqB,EAAE,YAAY;gBACnC,eAAe,EAAE,cAAc,CAAC,YAAY,CAAC;aAC9C,CAAC;QACJ,CAAC;QAED,yDAAyD;QACzD,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,uBAAuB,CAAC,QAAQ,CAAC,CAAC;QAEpE,2CAA2C;QAC3C,IAAI,YAAY,GAAG,CAAC,CAAC;QACrB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAsB,CAAC;oBAChE,CAAC,CAAE,IAAI,CAAC,IAAuB;oBAC/B,CAAC,CAAC,WAAW,CAAC;gBAEhB,MAAM,IAAI,CAAC,cAAc,CAAC,gBAAgB,CAAC,UAAU,CAAC;oBACpD,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,IAAI,CAAC,OAAO;oBACrB,MAAM,EAAE,SAAS;oBACjB,WAAW,EAAE,gBAAgB;oBAC7B,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,QAAQ,EAAE,GAAG,QAAQ,YAAY;iBAClC,CAAC,CAAC;gBACH,YAAY,EAAE,CAAC;YACjB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,wCAAwC,CAAC,CAAC;YACnF,CAAC;QACH,CAAC;QAED,+CAA+C;QAC/C,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;YACrB,IAAI,CAAC,cAAc,CAAC,eAAe,EAAE,CAAC;QACxC,CAAC;QAED,MAAM,eAAe,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;QAElD,GAAG,CAAC,IAAI,CACN;YACE,SAAS;YACT,cAAc,EAAE,KAAK,CAAC,MAAM;YAC5B,YAAY;YACZ,WAAW,EAAE,cAAc,CAAC,YAAY,CAAC;YACzC,eAAe;SAChB,EACD,qBAAqB,CACtB,CAAC;QAEF,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7E,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,iBAAiB,CACrB,YAAoB,EACpB,SAAiB,EACjB,KAAuB;QAEvB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;QAE3D,IAAI,MAAM,CAAC,qBAAqB,CAAC,IAAI,EAAE,EAAE,CAAC;YACxC,MAAM,KAAK,GAAqB;gBAC9B,EAAE,EAAE,gBAAgB,CAAC,UAAU,EAAE;gBACjC,SAAS;gBACT,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,IAAI,EAAE,eAAe;gBACrB,YAAY,EAAE,MAAM,CAAC,qBAAqB;gBAC1C,kBAAkB,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,mCAAmC;gBAC/D,eAAe,EAAE,MAAM,CAAC,eAAe;aACxC,CAAC;YACF,MAAM,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,oEAAoE;IAEpE;;;OAGG;IACK,uBAAuB,CAAC,QAAgB;QAC9C,IAAI,KAAK,GAAoB,EAAE,CAAC;QAChC,IAAI,SAAS,GAAG,EAAE,CAAC;QAEnB,qBAAqB;QACrB,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACnF,IAAI,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACpB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;gBACzC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC1B,KAAK,GAAG,MAAM,CAAC,MAAM,CACnB,CAAC,CAAC,EAAsB,EAAE,CACxB,OAAO,CAAC,KAAK,QAAQ;wBACrB,CAAC,KAAK,IAAI;wBACV,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ;wBAC7B,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CACvB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;wBACV,OAAO,EAAE,CAAC,CAAC,OAAO;wBAClB,IAAI,EAAE,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW;wBACvD,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAU,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE;qBACxF,CAAC,CAAC,CAAC;gBACN,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,GAAG,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAAC;YAClE,CAAC;QACH,CAAC;QAED,4DAA4D;QAC5D,MAAM,cAAc,GAAG,QAAQ,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAChE,IAAI,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxB,SAAS,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACvC,CAAC;aAAM,CAAC;YACN,6DAA6D;YAC7D,sEAAsE;YACtE,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;YACrF,IAAI,UAAU,EAAE,CAAC;gBACf,MAAM,UAAU,GAAG,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,KAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;gBACvF,IAAI,UAAU,EAAE,CAAC;oBACf,SAAS,GAAG,UAAU,CAAC;gBACzB,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,0DAA0D;gBAC1D,SAAS,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;YAC9B,CAAC;QACH,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IAC9B,CAAC;CACF"}

package/dist/memory/salience-scorer.d.ts

@@ -1,18 +1,28 @@
 /**
  * SalienceScorer — Ranks memory items by contextual relevance.
  *
- * Spec SS5.4 "Salience-Aware Retrieval":
- *   salience = (access_count * 0.3)
- *            + recency_decay(last_accessed)
- *            + relevance_score(query, item)
- *            + source_trust_bonus(source_type)
+ * Spec SS5.4 "Salience-Aware Retrieval" (updated):
+ *   salience = bm25Score * recencyDecay * frequencyBoost * trustScore
+ *
+ * Multiplicative composition ensures all factors contribute.
+ * Half-life defaults to 14 days (configurable).
  */
 import type { MemoryItem, SalienceScore, SourceType } from './memory-types.js';
 export declare class SalienceScorer {
-    scoreItem(item: MemoryItem, query: string): SalienceScore;
+    private readonly _halfLifeDays;
+    constructor(halfLifeDays?: number);
+    /**
+     * Score an item using multiplicative composition.
+     * When a BM25 score is available (from MiniSearch), pass it as bm25Score.
+     * Falls back to keyword relevance score when bm25Score is not provided.
+     */
+    scoreItem(item: MemoryItem, query: string, bm25Score?: number): SalienceScore;
     rankItems(items: MemoryItem[], query: string, limit?: number): SalienceScore[];
     recencyDecay(lastAccessed: string): number;
+    frequencyBoost(accessCount: number): number;
+    trustScore(sourceType: SourceType): number;
     relevanceScore(query: string, item: MemoryItem): number;
+    /** @deprecated Use trustScore() instead */
     sourceTrustBonus(sourceType: SourceType): number;
     private _tokenize;
 }

package/dist/memory/salience-scorer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"salience-scorer.d.ts","sourceRoot":"","sources":["../../src/memory/salience-scorer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAK/E,qBAAa,cAAc;IACzB,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa;IAkBzD,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE;IAM9E,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAQ1C,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM;IAgBvD,gBAAgB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM;IAWhD,OAAO,CAAC,SAAS;CAMlB"}
+{"version":3,"file":"salience-scorer.d.ts","sourceRoot":"","sources":["../../src/memory/salience-scorer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAK/E,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;gBAE3B,YAAY,GAAE,MAA+B;IAIzD;;;;OAIG;IACH,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,aAAa;IAkB7E,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE;IAM9E,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAQ1C,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAK3C,UAAU,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM;IAc1C,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM;IAgBvD,2CAA2C;IAC3C,gBAAgB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM;IAIhD,OAAO,CAAC,SAAS;CAMlB"}

package/dist/memory/salience-scorer.js

@@ -1,28 +1,37 @@
 /**
  * SalienceScorer — Ranks memory items by contextual relevance.
  *
- * Spec SS5.4 "Salience-Aware Retrieval":
- *   salience = (access_count * 0.3)
- *            + recency_decay(last_accessed)
- *            + relevance_score(query, item)
- *            + source_trust_bonus(source_type)
+ * Spec SS5.4 "Salience-Aware Retrieval" (updated):
+ *   salience = bm25Score * recencyDecay * frequencyBoost * trustScore
+ *
+ * Multiplicative composition ensures all factors contribute.
+ * Half-life defaults to 14 days (configurable).
  */
-const HALF_LIFE_DAYS = 7;
+const DEFAULT_HALF_LIFE_DAYS = 14;
 const LN2 = Math.LN2;
 export class SalienceScorer {
-    scoreItem(item, query) {
-        const accessWeight = item.access_count * 0.3;
+    _halfLifeDays;
+    constructor(halfLifeDays = DEFAULT_HALF_LIFE_DAYS) {
+        this._halfLifeDays = halfLifeDays;
+    }
+    /**
+     * Score an item using multiplicative composition.
+     * When a BM25 score is available (from MiniSearch), pass it as bm25Score.
+     * Falls back to keyword relevance score when bm25Score is not provided.
+     */
+    scoreItem(item, query, bm25Score) {
         const recencyDecay = this.recencyDecay(item.last_accessed);
-        const relevanceScore = this.relevanceScore(query, item);
-        const sourceTrustBonus = this.sourceTrustBonus(item.source_type);
+        const frequencyBoost = this.frequencyBoost(item.access_count);
+        const trustScore = this.trustScore(item.source_type);
+        const relevanceScore = bm25Score ?? this.relevanceScore(query, item);
         return {
             itemId: item.id,
-            score: accessWeight + recencyDecay + relevanceScore + sourceTrustBonus,
+            score: relevanceScore * recencyDecay * frequencyBoost * trustScore,
             components: {
-                accessWeight,
+                accessWeight: frequencyBoost,
                 recencyDecay,
                 relevanceScore,
-                sourceTrustBonus,
+                sourceTrustBonus: trustScore,
             },
         };
     }
@@ -36,7 +45,24 @@ export class SalienceScorer {
         const accessed = new Date(lastAccessed).getTime();
         const daysSince = Math.max(0, (now - accessed) / (1000 * 60 * 60 * 24));
         // Exponential decay: e^(-ln(2) * days / halfLife)
-        return Math.exp((-LN2 * daysSince) / HALF_LIFE_DAYS);
+        return Math.exp((-LN2 * daysSince) / this._halfLifeDays);
+    }
+    frequencyBoost(accessCount) {
+        // Logarithmic: diminishing returns after ~10 accesses
+        return 1.0 + Math.log2(1 + accessCount) * 0.15;
+    }
+    trustScore(sourceType) {
+        switch (sourceType) {
+            case 'user_instruction':
+                return 1.0;
+            case 'agent_analysis':
+                return 0.7;
+            case 'tool_output':
+                return 0.3;
+            default:
+                // Fallback for unknown source types (should not happen with proper typing)
+                return 0.0;
+        }
     }
     relevanceScore(query, item) {
         const queryWords = this._tokenize(query);
@@ -52,15 +78,9 @@ export class SalienceScorer {
         }
         return matchCount / queryWords.length; // normalize 0-1
     }
+    /** @deprecated Use trustScore() instead */
     sourceTrustBonus(sourceType) {
-        switch (sourceType) {
-            case 'user_instruction':
-                return 0.2;
-            case 'agent_analysis':
-                return 0.1;
-            case 'tool_output':
-                return 0.0;
-        }
+        return this.trustScore(sourceType);
     }
     _tokenize(text) {
         return text

package/dist/memory/salience-scorer.js.map

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