zora-agent 0.9.0

package/dist/memory/extraction-pipeline.js

@@ -0,0 +1,156 @@
+/**
+ * ExtractionPipeline — Schema-guided memory extraction.
+ *
+ * Spec SS5.4 "Proactive Memory Extraction Pipeline":
+ * Extracts structured MemoryItems from conversation messages,
+ * validates against the schema, and deduplicates against existing items.
+ */
+const VALID_TYPES = ['profile', 'event', 'knowledge', 'behavior', 'skill', 'tool'];
+const VALID_SOURCE_TYPES = ['user_instruction', 'agent_analysis', 'tool_output'];
+const MAX_RETRIES = 2;
+const DEDUP_THRESHOLD = 0.8;
+export class ExtractionPipeline {
+    _extractFn;
+    constructor(extractFn) {
+        this._extractFn = extractFn;
+    }
+    async extract(messages, existingCategories) {
+        const errors = [];
+        let retries = 0;
+        let lastErrors = [];
+        for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
+            const prompt = this._buildPrompt(messages, existingCategories, lastErrors);
+            let raw;
+            try {
+                raw = await this._extractFn(prompt);
+            }
+            catch (err) {
+                errors.push(`Extraction call failed: ${String(err)}`);
+                retries++;
+                continue;
+            }
+            let parsed;
+            try {
+                parsed = JSON.parse(raw);
+            }
+            catch {
+                const parseErr = 'Response is not valid JSON';
+                errors.push(parseErr);
+                lastErrors = [parseErr];
+                retries++;
+                continue;
+            }
+            if (!Array.isArray(parsed)) {
+                const arrErr = 'Response is not a JSON array';
+                errors.push(arrErr);
+                lastErrors = [arrErr];
+                retries++;
+                continue;
+            }
+            const validItems = [];
+            const itemErrors = [];
+            for (const raw of parsed) {
+                const result = this.validateItem(raw);
+                if (result.valid) {
+                    validItems.push(raw);
+                }
+                else {
+                    itemErrors.push(...result.errors);
+                }
+            }
+            if (itemErrors.length > 0 && validItems.length === 0 && attempt < MAX_RETRIES) {
+                errors.push(...itemErrors);
+                lastErrors = itemErrors;
+                retries++;
+                continue;
+            }
+            errors.push(...itemErrors);
+            return { items: validItems, errors, retries };
+        }
+        return { items: [], errors, retries };
+    }
+    validateItem(item) {
+        const errors = [];
+        if (typeof item !== 'object' || item === null) {
+            return { valid: false, errors: ['Item is not an object'] };
+        }
+        const obj = item;
+        const stringFields = ['id', 'summary', 'source', 'created_at', 'last_accessed', 'category'];
+        for (const field of stringFields) {
+            if (typeof obj[field] !== 'string' || obj[field].length === 0) {
+                errors.push(`Missing or invalid field: ${field}`);
+            }
+        }
+        if (typeof obj['type'] !== 'string' || !VALID_TYPES.includes(obj['type'])) {
+            errors.push(`Invalid type: ${String(obj['type'])}. Must be one of: ${VALID_TYPES.join(', ')}`);
+        }
+        if (typeof obj['source_type'] !== 'string' || !VALID_SOURCE_TYPES.includes(obj['source_type'])) {
+            errors.push(`Invalid source_type: ${String(obj['source_type'])}. Must be one of: ${VALID_SOURCE_TYPES.join(', ')}`);
+        }
+        if (typeof obj['access_count'] !== 'number') {
+            errors.push('Missing or invalid field: access_count');
+        }
+        if (typeof obj['reinforcement_score'] !== 'number') {
+            errors.push('Missing or invalid field: reinforcement_score');
+        }
+        if (!Array.isArray(obj['tags'])) {
+            errors.push('Missing or invalid field: tags (must be array)');
+        }
+        return { valid: errors.length === 0, errors };
+    }
+    deduplicateItems(newItems, existingItems) {
+        return newItems.filter(newItem => {
+            const newWords = this._wordSet(newItem.summary);
+            return !existingItems.some(existing => {
+                const existingWords = this._wordSet(existing.summary);
+                return this._jaccardSimilarity(newWords, existingWords) > DEDUP_THRESHOLD;
+            });
+        });
+    }
+    // ── Private helpers ──────────────────────────────────────────────
+    _buildPrompt(messages, existingCategories, previousErrors) {
+        const conversationBlock = messages.map((m, i) => `[${i + 1}] ${m}`).join('\n');
+        const categoriesBlock = existingCategories.length > 0
+            ? `Existing categories: ${existingCategories.join(', ')}`
+            : 'No existing categories yet.';
+        let errorBlock = '';
+        if (previousErrors.length > 0) {
+            errorBlock = `\nPrevious attempt had these errors. Please fix them:\n${previousErrors.join('\n')}\n`;
+        }
+        return `Extract structured memory items from the following conversation.
+Return a JSON array of objects with these required fields:
+- id (string): unique identifier
+- type (string): one of: profile, event, knowledge, behavior, skill, tool
+- summary (string): concise description
+- source (string): session or job ID
+- source_type (string): one of: user_instruction, agent_analysis, tool_output
+- created_at (string): ISO 8601 timestamp
+- last_accessed (string): ISO 8601 timestamp
+- access_count (number): initial 0
+- reinforcement_score (number): initial 0
+- tags (string[]): relevant tags
+- category (string): e.g. "coding/my-web-app"
+
+${categoriesBlock}
+${errorBlock}
+Conversation:
+${conversationBlock}
+
+Respond with ONLY a JSON array. No markdown fences, no explanation.`;
+    }
+    _wordSet(text) {
+        return new Set(text.toLowerCase().split(/\W+/).filter(w => w.length > 0));
+    }
+    _jaccardSimilarity(a, b) {
+        if (a.size === 0 && b.size === 0)
+            return 1;
+        let intersection = 0;
+        for (const word of a) {
+            if (b.has(word))
+                intersection++;
+        }
+        const union = a.size + b.size - intersection;
+        return union === 0 ? 0 : intersection / union;
+    }
+}
+//# sourceMappingURL=extraction-pipeline.js.map

package/dist/memory/extraction-pipeline.js.map

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

package/dist/memory/index.d.ts

@@ -0,0 +1,7 @@
+export * from './memory-types.js';
+export * from './memory-manager.js';
+export * from './structured-memory.js';
+export * from './salience-scorer.js';
+export * from './extraction-pipeline.js';
+export * from './category-organizer.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/memory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC"}

package/dist/memory/index.js

@@ -0,0 +1,7 @@
+export * from './memory-types.js';
+export * from './memory-manager.js';
+export * from './structured-memory.js';
+export * from './salience-scorer.js';
+export * from './extraction-pipeline.js';
+export * from './category-organizer.js';
+//# sourceMappingURL=index.js.map

package/dist/memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC"}

package/dist/memory/memory-manager.d.ts

@@ -0,0 +1,56 @@
+/**
+ * MemoryManager — Hierarchical context management.
+ *
+ * Spec §5.4 "Memory System":
+ *   - Tier 1: Long-term salience (MEMORY.md)
+ *   - Tier 2: Rolling context (Daily Notes)
+ *   - Tier 3: Structured items, salience, categories
+ *   - Aggregates fragments into TaskContext.memoryContext
+ */
+import type { MemoryConfig } from '../types.js';
+import { StructuredMemory } from './structured-memory.js';
+import type { MemoryItem, CategorySummary, SalienceScore } from './memory-types.js';
+export declare class MemoryManager {
+    private readonly _config;
+    private readonly _baseDir;
+    private _structuredMemory;
+    private _scorer;
+    private _categoryOrganizer;
+    constructor(config: MemoryConfig, baseDir?: string, summarizeFn?: (items: MemoryItem[]) => Promise<string>);
+    /**
+     * Initializes memory directories (Tiers 1-3).
+     */
+    init(): Promise<void>;
+    /**
+     * Loads context for a new task based on tiers.
+     */
+    loadContext(days?: number): Promise<string[]>;
+    /**
+     * Appends an entry to today's daily note.
+     */
+    appendDailyNote(text: string): Promise<void>;
+    /**
+     * Searches structured memory items by query, ranked by salience.
+     */
+    searchMemory(query: string, limit?: number): Promise<SalienceScore[]>;
+    /**
+     * Deletes a structured memory item by ID.
+     */
+    forgetItem(id: string): Promise<boolean>;
+    /**
+     * Returns all category summaries.
+     */
+    getCategories(): Promise<CategorySummary[]>;
+    /**
+     * Exposes the underlying StructuredMemory for direct access.
+     */
+    get structuredMemory(): StructuredMemory;
+    private _resolvePath;
+    private _getLongTermPath;
+    private _getDailyNotesPath;
+    private _getItemsPath;
+    private _getCategoriesPath;
+    private _readLongTerm;
+    private _readDailyNotes;
+}
+//# sourceMappingURL=memory-manager.d.ts.map

package/dist/memory/memory-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-manager.d.ts","sourceRoot":"","sources":["../../src/memory/memory-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG1D,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEpF,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,iBAAiB,CAAmB;IAC5C,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,kBAAkB,CAAoB;gBAG5C,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,MAAyC,EAClD,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC;IAYxD;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB3B;;OAEG;IACG,WAAW,CAAC,IAAI,GAAE,MAAkC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA6C9E;;OAEG;IACG,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBlD;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAK3E;;OAEG;IACG,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI9C;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAIjD;;OAEG;IACH,IAAI,gBAAgB,IAAI,gBAAgB,CAEvC;IAED,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,kBAAkB;YAOZ,aAAa;YAWb,eAAe;CAwB9B"}

package/dist/memory/memory-manager.js

@@ -0,0 +1,198 @@
+/**
+ * MemoryManager — Hierarchical context management.
+ *
+ * Spec §5.4 "Memory System":
+ *   - Tier 1: Long-term salience (MEMORY.md)
+ *   - Tier 2: Rolling context (Daily Notes)
+ *   - Tier 3: Structured items, salience, categories
+ *   - Aggregates fragments into TaskContext.memoryContext
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import os from 'node:os';
+import { StructuredMemory } from './structured-memory.js';
+import { SalienceScorer } from './salience-scorer.js';
+import { CategoryOrganizer } from './category-organizer.js';
+export class MemoryManager {
+    _config;
+    _baseDir;
+    _structuredMemory;
+    _scorer;
+    _categoryOrganizer;
+    constructor(config, baseDir = path.join(os.homedir(), '.zora'), summarizeFn) {
+        this._config = config;
+        this._baseDir = baseDir;
+        this._structuredMemory = new StructuredMemory(this._getItemsPath());
+        this._scorer = new SalienceScorer();
+        this._categoryOrganizer = new CategoryOrganizer(this._getCategoriesPath(), summarizeFn ?? (async (items) => `${items.length} items in category`));
+    }
+    /**
+     * Initializes memory directories (Tiers 1-3).
+     */
+    async init() {
+        const dailyNotesDir = this._getDailyNotesPath();
+        await fs.mkdir(dailyNotesDir, { recursive: true, mode: 0o700 });
+        const longTermFile = this._getLongTermPath();
+        const longTermDir = path.dirname(longTermFile);
+        await fs.mkdir(longTermDir, { recursive: true, mode: 0o700 });
+        try {
+            const defaultContent = '# Zora Long-term Memory\n\n- No persistent memories yet.\n';
+            // Use 'wx' to atomically fail if the file already exists (preventing race conditions)
+            await fs.writeFile(longTermFile, defaultContent, { mode: 0o600, flag: 'wx' });
+        }
+        catch (err) {
+            if (err.code !== 'EEXIST') {
+                throw err;
+            }
+        }
+        // Tier 3: Structured memory + categories
+        await this._structuredMemory.init();
+        await this._categoryOrganizer.init();
+    }
+    /**
+     * Loads context for a new task based on tiers.
+     */
+    async loadContext(days = this._config.context_days) {
+        const context = [];
+        // Tier 1: Long-term salience
+        const tier1 = await this._readLongTerm();
+        if (tier1)
+            context.push(`[LONG-TERM MEMORY]:\n${tier1}`);
+        // Tier 2: Rolling context (last N days of notes)
+        const tier2 = await this._readDailyNotes(days);
+        if (tier2.length > 0) {
+            context.push(`[RECENT CONTEXT]:\n${tier2.join('\n\n')}`);
+        }
+        // Tier 3: Category summaries + top-N salience-ranked items
+        const { summaries, topItems } = await this._categoryOrganizer.getDualModeContext('', // empty query for general context loading
+        this._structuredMemory, this._scorer, this._config.max_category_summaries, this._config.max_context_items);
+        if (summaries.length > 0) {
+            const catLines = summaries.map(s => `- [${s.category}]: ${s.summary}`).join('\n');
+            context.push(`[CATEGORY SUMMARIES]:\n${catLines}`);
+        }
+        if (topItems.length > 0) {
+            const allItems = await this._structuredMemory.listItems();
+            const itemMap = new Map(allItems.map(i => [i.id, i]));
+            const itemLines = topItems
+                .map(s => {
+                const item = itemMap.get(s.itemId);
+                return item ? `- [${item.type}] ${item.summary} (salience: ${s.score.toFixed(2)})` : null;
+            })
+                .filter(Boolean)
+                .join('\n');
+            if (itemLines) {
+                context.push(`[MEMORY ITEMS]:\n${itemLines}`);
+            }
+        }
+        return context;
+    }
+    /**
+     * Appends an entry to today's daily note.
+     */
+    async appendDailyNote(text) {
+        const today = new Date().toISOString().split('T')[0];
+        const filePath = path.join(this._getDailyNotesPath(), `${today}.md`);
+        const entry = `\n### ${new Date().toLocaleTimeString()}\n${text}\n`;
+        try {
+            await fs.appendFile(filePath, entry, { mode: 0o600 });
+        }
+        catch (err) {
+            if (err.code === 'ENOENT') {
+                // Create file with header if it doesn't exist
+                await fs.writeFile(filePath, `# Daily Notes: ${today}\n${entry}`, { mode: 0o600 });
+            }
+            else {
+                throw err;
+            }
+        }
+    }
+    /**
+     * Searches structured memory items by query, ranked by salience.
+     */
+    async searchMemory(query, limit) {
+        const items = await this._structuredMemory.searchItems(query);
+        return this._scorer.rankItems(items, query, limit);
+    }
+    /**
+     * Deletes a structured memory item by ID.
+     */
+    async forgetItem(id) {
+        return this._structuredMemory.deleteItem(id);
+    }
+    /**
+     * Returns all category summaries.
+     */
+    async getCategories() {
+        return this._categoryOrganizer.listCategories();
+    }
+    /**
+     * Exposes the underlying StructuredMemory for direct access.
+     */
+    get structuredMemory() {
+        return this._structuredMemory;
+    }
+    _resolvePath(p) {
+        if (p.startsWith('~/')) {
+            return path.join(os.homedir(), p.slice(2));
+        }
+        return p;
+    }
+    _getLongTermPath() {
+        const resolved = this._resolvePath(this._config.long_term_file);
+        return path.isAbsolute(resolved)
+            ? resolved
+            : path.join(this._baseDir, resolved);
+    }
+    _getDailyNotesPath() {
+        const resolved = this._resolvePath(this._config.daily_notes_dir);
+        return path.isAbsolute(resolved)
+            ? resolved
+            : path.join(this._baseDir, resolved);
+    }
+    _getItemsPath() {
+        const resolved = this._resolvePath(this._config.items_dir);
+        return path.isAbsolute(resolved)
+            ? resolved
+            : path.join(this._baseDir, resolved);
+    }
+    _getCategoriesPath() {
+        const resolved = this._resolvePath(this._config.categories_dir);
+        return path.isAbsolute(resolved)
+            ? resolved
+            : path.join(this._baseDir, resolved);
+    }
+    async _readLongTerm() {
+        try {
+            return await fs.readFile(this._getLongTermPath(), 'utf8');
+        }
+        catch (err) {
+            if (err.code === 'ENOENT') {
+                return null;
+            }
+            throw err;
+        }
+    }
+    async _readDailyNotes(days) {
+        const notes = [];
+        const dir = this._getDailyNotesPath();
+        try {
+            const files = await fs.readdir(dir);
+            const dateFiles = files
+                .filter(f => /^\d{4}-\d{2}-\d{2}\.md$/.test(f))
+                .sort()
+                .reverse()
+                .slice(0, days);
+            for (const file of dateFiles) {
+                const content = await fs.readFile(path.join(dir, file), 'utf8');
+                notes.push(`--- ${file} ---\n${content}`);
+            }
+        }
+        catch (err) {
+            if (err.code !== 'ENOENT') {
+                throw err;
+            }
+        }
+        return notes;
+    }
+}
+//# sourceMappingURL=memory-manager.js.map

package/dist/memory/memory-manager.js.map

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

package/dist/memory/memory-types.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Memory module types — Tier 3 structured memory.
+ *
+ * Spec SS5.4: Salience-aware retrieval, proactive extraction,
+ * category auto-organization.
+ */
+export type MemoryItemType = 'profile' | 'event' | 'knowledge' | 'behavior' | 'skill' | 'tool';
+export type SourceType = 'user_instruction' | 'agent_analysis' | 'tool_output';
+export interface MemoryItem {
+    id: string;
+    type: MemoryItemType;
+    summary: string;
+    source: string;
+    source_type: SourceType;
+    created_at: string;
+    last_accessed: string;
+    access_count: number;
+    reinforcement_score: number;
+    tags: string[];
+    category: string;
+}
+export interface SalienceScore {
+    itemId: string;
+    score: number;
+    components: {
+        accessWeight: number;
+        recencyDecay: number;
+        relevanceScore: number;
+        sourceTrustBonus: number;
+    };
+}
+export interface CategorySummary {
+    category: string;
+    summary: string;
+    item_count: number;
+    last_updated: string;
+    member_item_ids: string[];
+}
+export interface ExtractionResult {
+    items: MemoryItem[];
+    errors: string[];
+    retries: number;
+}
+//# sourceMappingURL=memory-types.d.ts.map

package/dist/memory/memory-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-types.d.ts","sourceRoot":"","sources":["../../src/memory/memory-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;AAC/F,MAAM,MAAM,UAAU,GAAG,kBAAkB,GAAG,gBAAgB,GAAG,aAAa,CAAC;AAE/E,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,UAAU,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE;QACV,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,cAAc,EAAE,MAAM,CAAC;QACvB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/memory/memory-types.js

@@ -0,0 +1,8 @@
+/**
+ * Memory module types — Tier 3 structured memory.
+ *
+ * Spec SS5.4: Salience-aware retrieval, proactive extraction,
+ * category auto-organization.
+ */
+export {};
+//# sourceMappingURL=memory-types.js.map

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

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

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

@@ -0,0 +1,19 @@
+/**
+ * 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)
+ */
+import type { MemoryItem, SalienceScore, SourceType } from './memory-types.js';
+export declare class SalienceScorer {
+    scoreItem(item: MemoryItem, query: string): SalienceScore;
+    rankItems(items: MemoryItem[], query: string, limit?: number): SalienceScore[];
+    recencyDecay(lastAccessed: string): number;
+    relevanceScore(query: string, item: MemoryItem): number;
+    sourceTrustBonus(sourceType: SourceType): number;
+    private _tokenize;
+}
+//# sourceMappingURL=salience-scorer.d.ts.map

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

@@ -0,0 +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"}

package/dist/memory/salience-scorer.js

@@ -0,0 +1,72 @@
+/**
+ * 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)
+ */
+const HALF_LIFE_DAYS = 7;
+const LN2 = Math.LN2;
+export class SalienceScorer {
+    scoreItem(item, query) {
+        const accessWeight = item.access_count * 0.3;
+        const recencyDecay = this.recencyDecay(item.last_accessed);
+        const relevanceScore = this.relevanceScore(query, item);
+        const sourceTrustBonus = this.sourceTrustBonus(item.source_type);
+        return {
+            itemId: item.id,
+            score: accessWeight + recencyDecay + relevanceScore + sourceTrustBonus,
+            components: {
+                accessWeight,
+                recencyDecay,
+                relevanceScore,
+                sourceTrustBonus,
+            },
+        };
+    }
+    rankItems(items, query, limit) {
+        const scored = items.map(item => this.scoreItem(item, query));
+        scored.sort((a, b) => b.score - a.score);
+        return limit !== undefined ? scored.slice(0, limit) : scored;
+    }
+    recencyDecay(lastAccessed) {
+        const now = Date.now();
+        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);
+    }
+    relevanceScore(query, item) {
+        const queryWords = this._tokenize(query);
+        if (queryWords.length === 0)
+            return 0;
+        const itemWords = new Set(this._tokenize(`${item.summary} ${item.tags.join(' ')}`));
+        if (itemWords.size === 0)
+            return 0;
+        let matchCount = 0;
+        for (const w of queryWords) {
+            if (itemWords.has(w))
+                matchCount++;
+        }
+        return matchCount / queryWords.length; // normalize 0-1
+    }
+    sourceTrustBonus(sourceType) {
+        switch (sourceType) {
+            case 'user_instruction':
+                return 0.2;
+            case 'agent_analysis':
+                return 0.1;
+            case 'tool_output':
+                return 0.0;
+        }
+    }
+    _tokenize(text) {
+        return text
+            .toLowerCase()
+            .split(/\W+/)
+            .filter(w => w.length > 0);
+    }
+}
+//# sourceMappingURL=salience-scorer.js.map

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

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

package/dist/memory/structured-memory.d.ts

@@ -0,0 +1,28 @@
+/**
+ * StructuredMemory — Tier 3 CRUD for memory items.
+ *
+ * Stores each MemoryItem as a JSON file in the items directory.
+ * Uses atomic writes (write to .tmp, rename) for crash safety.
+ */
+import type { MemoryItem, MemoryItemType } from './memory-types.js';
+type CreateItemInput = Omit<MemoryItem, 'id' | 'created_at' | 'last_accessed' | 'access_count' | 'reinforcement_score'>;
+export declare class StructuredMemory {
+    private readonly _itemsDir;
+    constructor(itemsDir: string);
+    init(): Promise<void>;
+    createItem(input: CreateItemInput): Promise<MemoryItem>;
+    getItem(id: string): Promise<MemoryItem | null>;
+    updateItem(id: string, updates: Partial<MemoryItem>): Promise<MemoryItem | null>;
+    deleteItem(id: string): Promise<boolean>;
+    listItems(filter?: {
+        type?: MemoryItemType;
+        category?: string;
+        tags?: string[];
+    }): Promise<MemoryItem[]>;
+    searchItems(query: string): Promise<MemoryItem[]>;
+    private _itemPath;
+    private _writeItem;
+    private _readAllItems;
+}
+export {};
+//# sourceMappingURL=structured-memory.d.ts.map