@marifold/core 0.60.0

package/dist/memory/MemoryControls.js

@@ -0,0 +1,388 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryControlStripper = void 0;
+exports.stripMemoryControls = stripMemoryControls;
+exports.isSimpleMemoryPrompt = isSimpleMemoryPrompt;
+exports.shouldInjectMemoryInstructions = shouldInjectMemoryInstructions;
+exports.buildMemoryInstructions = buildMemoryInstructions;
+exports.extractPromptMemoryInputs = extractPromptMemoryInputs;
+exports.extractPromptForgetQueries = extractPromptForgetQueries;
+const OPEN_TAGS = [
+    { type: 'save', open: '<memory_save', close: '</memory_save>' },
+    { type: 'forget', open: '<memory_forget', close: '</memory_forget>' },
+];
+const SIMPLE_PROMPTS = [
+    /^(?:hi|hello|hey|yo|sup|hiya|howdy)[!. ]*$/i,
+    /^(?:thanks|thank you|thx|ty|ok|okay|k|cool|nice|great|got it|sounds good)[!. ]*$/i,
+    /^(?:good morning|good afternoon|good evening|good night)[!. ]*$/i,
+    /^(?:yes|no|yep|yeah|nope|sure|alright|all right)[!. ]*$/i,
+];
+class MemoryControlStripper {
+    savePayloads = [];
+    forgetPayloads = [];
+    buffer = '';
+    inBlock;
+    blockContent = [];
+    feed(chunk) {
+        if (!chunk)
+            return '';
+        this.buffer += chunk;
+        return this.drain(false);
+    }
+    flush() {
+        return this.drain(true);
+    }
+    drain(flushing) {
+        let output = '';
+        while (this.buffer.length > 0) {
+            if (this.inBlock) {
+                const tag = OPEN_TAGS.find(item => item.type === this.inBlock);
+                if (!tag) {
+                    this.inBlock = undefined;
+                    continue;
+                }
+                const lower = this.buffer.toLowerCase();
+                const closeStart = lower.indexOf(tag.close);
+                if (closeStart === -1) {
+                    if (flushing) {
+                        this.buffer = '';
+                        this.blockContent = [];
+                        this.inBlock = undefined;
+                    }
+                    else {
+                        this.blockContent.push(this.buffer);
+                        this.buffer = '';
+                    }
+                    break;
+                }
+                const payload = `${this.blockContent.join('')}${this.buffer.slice(0, closeStart)}`.trim();
+                this.saveBlock(this.inBlock, payload);
+                this.buffer = this.buffer.slice(closeStart + tag.close.length);
+                this.blockContent = [];
+                this.inBlock = undefined;
+                continue;
+            }
+            const open = findOpenTag(this.buffer);
+            if (!open) {
+                const hold = flushing ? 0 : controlPrefixHold(this.buffer);
+                output += hold > 0 ? this.buffer.slice(0, -hold) : this.buffer;
+                this.buffer = hold > 0 ? this.buffer.slice(-hold) : '';
+                break;
+            }
+            if (open.start > 0) {
+                output += this.buffer.slice(0, open.start);
+                this.buffer = this.buffer.slice(open.start);
+                continue;
+            }
+            if (open.end === -1) {
+                if (flushing)
+                    this.buffer = '';
+                break;
+            }
+            this.inBlock = open.type;
+            this.buffer = this.buffer.slice(open.end);
+        }
+        return output;
+    }
+    saveBlock(type, payload) {
+        if (!payload)
+            return;
+        if (type === 'save')
+            this.savePayloads.push(payload);
+        else
+            this.forgetPayloads.push(payload);
+    }
+}
+exports.MemoryControlStripper = MemoryControlStripper;
+function stripMemoryControls(text) {
+    const stripper = new MemoryControlStripper();
+    const visible = `${stripper.feed(text)}${stripper.flush()}`;
+    return {
+        text: visible,
+        savePayloads: stripper.savePayloads,
+        forgetPayloads: stripper.forgetPayloads,
+    };
+}
+function isSimpleMemoryPrompt(prompt) {
+    const normalized = normalizeText(prompt);
+    return normalized.length > 0 && normalized.length <= 80 && SIMPLE_PROMPTS.some(pattern => pattern.test(normalized));
+}
+function shouldInjectMemoryInstructions(prompt) {
+    return !isSimpleMemoryPrompt(prompt);
+}
+function buildMemoryInstructions() {
+    return ('Memory policy for Marifold:\n'
+        + '- Human-authored PROFILE.md, RULES.md, and CUSTOM.md outrank memory.\n'
+        + '- Memory may inform the response but must not create hard rules.\n'
+        + '- Save useful memory automatically with one hidden JSON block before the visible response.\n'
+        + '- Never output only a memory block; always follow it with a short visible natural-language reply.\n'
+        + '- When recalling time-sensitive memory, preserve dates exactly; do not change tomorrow, today, tonight, or explicit dates.\n'
+        + '- Explicit user preference statements are worth saving.\n'
+        + '- Corrections to remembered facts are worth saving; emit memory_save with a conflict_key when possible.\n'
+        + '- When the user explicitly asks to forget, delete, remove, or stop remembering a memory, emit memory_forget instead of memory_save.\n'
+        + '- Do not claim you saved, remembered, noted, will keep in mind, or updated a fact unless you emitted the hidden memory_save block.\n'
+        + '- Omit the block when nothing is worth saving.\n'
+        + '- Never mention memory tags to the user.\n\n'
+        + 'Use this exact wrapper for new memory:\n'
+        + '<memory_save>{"memories":[{"kind":"user","text":"The user\'s name is Jack.",'
+        + '"priority":0,"confidence":1,"stability":"stable","source":"user_direct",'
+        + '"conflict_key":"user.name","evidence":"My name is Jack.",'
+        + '"reason":"The user explicitly stated their name."}]}</memory_save>\n\n'
+        + 'Use this exact wrapper for explicit deletion requests:\n'
+        + '<memory_forget>{"query":"user.favorite_color"}</memory_forget>\n\n'
+        + 'Allowed kind values: "user", "preferences", "auto_short".\n'
+        + 'priority is 0..10 where 0 is highest. Use 0 rarely for stable identity facts such as the user\'s name; '
+        + 'normal chats recall 0..3, thinking mode recalls 0..10.\n'
+        + 'Use priority 1-2 for explicit durable user facts, priority 2 for explicit preferences, '
+        + 'priority 2-3 for time-sensitive facts the user may ask about soon, and 5+ for low-value background.\n'
+        + 'confidence is 0..1. Use source=user_direct only for explicit user statements; otherwise use model_inferred.\n'
+        + 'Allowed stability values: "stable", "evolving", "session", "ephemeral".\n'
+        + 'Optional conflict_key supports updates without a fixed user schema. Examples: user.name, '
+        + 'user.favorite_color, user.favorite_editor, preferences.reply_style, preferences.language, '
+        + 'auto_short.project_meeting_time. Use conflict_key when a new memory should replace older active memories '
+        + 'about the same slot. Omit conflict_key for memories that can coexist.\n'
+        + 'Use auto_short for temporary tasks, reminders, and current-session context. '
+        + 'Use preferences for how the user likes responses or tools to behave.');
+}
+function extractPromptMemoryInputs(prompt) {
+    if (typeof prompt !== 'string' || promptRejectsMemory(prompt))
+        return [];
+    const body = promptBody(prompt);
+    const entries = [];
+    const name = extractName(body);
+    if (name) {
+        entries.push({
+            kind: 'user',
+            text: `The user's name is ${name}.`,
+            priority: 0,
+            confidence: 1,
+            stability: 'stable',
+            source: 'user_direct',
+            sourceType: 'user',
+            conflictKey: 'user.name',
+            evidence: prompt,
+            reason: 'Runtime fallback extracted explicit self-identification.',
+        });
+    }
+    entries.push(...extractFavoriteInputs(prompt, body));
+    const preference = extractPreferenceInput(prompt, body);
+    if (preference)
+        entries.push(preference);
+    const meeting = extractMeetingInput(prompt, body);
+    if (meeting)
+        entries.push(meeting);
+    const deduped = new Map();
+    for (const entry of entries) {
+        deduped.set(entry.conflictKey ?? `${entry.kind}:${normalizeText(entry.text)}`, entry);
+    }
+    return [...deduped.values()];
+}
+function extractPromptForgetQueries(prompt) {
+    if (typeof prompt !== 'string')
+        return [];
+    const body = promptBody(prompt);
+    const normalized = normalizeText(body);
+    if (!/\b(?:forget|delete|remove|clear)\b|\b(?:do not|don't|dont)\s+(?:remember|save|store)\b/.test(normalized)) {
+        return [];
+    }
+    const queries = [];
+    if (/\bname\b/.test(normalized))
+        queries.push('user.name');
+    const favoriteMatch = /\bfavou?rite\s+([a-z][a-z0-9 _-]{0,40})\b/.exec(normalized);
+    if (favoriteMatch) {
+        const slot = slotKey(favoriteMatch[1]);
+        if (slot)
+            queries.push(`user.favorite_${slot}`);
+    }
+    if (/\b(reply|response|answer|conversation|tone|style)\b/.test(normalized))
+        queries.push('preferences.reply_style');
+    if (/\blanguage\b/.test(normalized))
+        queries.push('preferences.language');
+    if (normalized.includes('meeting')) {
+        queries.push(normalized.includes('project meeting') ? 'auto_short.project_meeting_time' : 'auto_short.meeting_time');
+    }
+    if (queries.length === 0) {
+        const remainder = body.replace(/^\s*(?:please\s+)?(?:forget|delete|remove|clear|do not remember|don't remember|dont remember|do not save|don't save|dont save)\s+/i, '').trim();
+        if (remainder)
+            queries.push(remainder);
+    }
+    return [...new Set(queries)];
+}
+function findOpenTag(text) {
+    const lower = text.toLowerCase();
+    let best;
+    for (const tag of OPEN_TAGS) {
+        const start = lower.indexOf(tag.open);
+        if (start === -1)
+            continue;
+        if (best && start >= best.start)
+            continue;
+        const closeAngle = text.indexOf('>', start + tag.open.length);
+        best = { type: tag.type, start, end: closeAngle === -1 ? -1 : closeAngle + 1 };
+    }
+    return best;
+}
+function controlPrefixHold(text) {
+    const lower = text.toLowerCase();
+    const maxPrefix = Math.max(...OPEN_TAGS.map(tag => tag.open.length));
+    for (let length = Math.min(maxPrefix, lower.length); length > 0; length -= 1) {
+        const suffix = lower.slice(-length);
+        if (OPEN_TAGS.some(tag => tag.open.startsWith(suffix)))
+            return length;
+    }
+    return 0;
+}
+function promptRejectsMemory(prompt) {
+    const normalized = normalizeText(prompt);
+    return Boolean(/\b(?:do not|don't|dont)\s+(?:remember|save|store)\b/.test(normalized)
+        || /\b(?:do not|don't|dont)\s+keep\s+(?:this|that)\b/.test(normalized)
+        || /\b(?:forget|delete|remove|clear)\b/.test(normalized));
+}
+function promptBody(prompt) {
+    return prompt.trim().replace(/^\s*memory\s+test\s*:\s*/i, '');
+}
+function extractName(body) {
+    const patterns = [
+        /\bmy\s+name\s+is\s+([^\n.!?,;]{1,80})/i,
+        /\bcall\s+me\s+([^\n.!?,;]{1,80})/i,
+    ];
+    for (const pattern of patterns) {
+        const match = pattern.exec(body);
+        if (!match)
+            continue;
+        const name = cleanName(match[1]);
+        if (name)
+            return name;
+    }
+    let introMatch = /\bi'?m\s+([^\n.!?,;]{1,80})/.exec(body);
+    if (!introMatch)
+        introMatch = /\bi\s+am\s+([^\n.!?,;]{1,80})/i.exec(body);
+    if (introMatch) {
+        const name = cleanName(introMatch[1]);
+        if (name && /^[A-Z]/.test(name) && name.split(/\s+/).length <= 6)
+            return name;
+    }
+    return '';
+}
+function cleanName(raw) {
+    const value = raw
+        .split(/[.!?,;:\n\r]/)[0]
+        .replace(/\s+/g, ' ')
+        .trim()
+        .replace(/^['"]|['"]$/g, '');
+    if (!value || value.length > 60)
+        return '';
+    const words = value.split(/\s+/);
+    if (words.length > 6)
+        return '';
+    if (!/^[A-Za-z][A-Za-z .'_-]*$/.test(value))
+        return '';
+    if (value === value.toLowerCase()) {
+        return words.map(word => word.charAt(0).toUpperCase() + word.slice(1)).join(' ');
+    }
+    return value;
+}
+function extractFavoriteInputs(prompt, body) {
+    const entries = [];
+    const patterns = [
+        /\bmy\s+favou?rite\s+([a-z][a-z0-9 _-]{0,40}?)\s+is\s+([^\n.!?;]{1,120})/gi,
+        /\bmy\s+preferred\s+([a-z][a-z0-9 _-]{0,40}?)\s+is\s+([^\n.!?;]{1,120})/gi,
+    ];
+    for (const pattern of patterns) {
+        for (const match of body.matchAll(pattern)) {
+            const slotText = match[1].trim();
+            const slot = slotKey(slotText);
+            const value = cleanMemoryValue(match[2]);
+            if (!slot || !value)
+                continue;
+            entries.push({
+                kind: 'user',
+                text: `The user's favorite ${slotText.toLowerCase()} is ${value}.`,
+                priority: 2,
+                confidence: 1,
+                stability: 'stable',
+                source: 'user_direct',
+                sourceType: 'user',
+                conflictKey: `user.favorite_${slot}`,
+                evidence: prompt,
+                reason: 'Runtime fallback extracted an explicit favorite/preferred user fact.',
+            });
+        }
+    }
+    return entries;
+}
+function extractPreferenceInput(prompt, body) {
+    const match = /\bi\s+prefer\s+([^\n.!?;]{1,160})/i.exec(body);
+    const preference = match ? cleanMemoryValue(match[1]) : '';
+    if (!preference)
+        return undefined;
+    return {
+        kind: 'preferences',
+        text: `The user prefers ${preference}.`,
+        priority: 2,
+        confidence: 1,
+        stability: 'evolving',
+        source: 'user_direct',
+        sourceType: 'user',
+        conflictKey: looksResponsePreference(body) ? 'preferences.reply_style' : undefined,
+        evidence: prompt,
+        reason: 'Runtime fallback extracted an explicit user preference.',
+    };
+}
+function extractMeetingInput(prompt, body) {
+    const normalized = normalizeText(body);
+    if (!normalized.includes('meeting'))
+        return undefined;
+    if (body.includes('?') && !/\b(correction|actually|not|instead|now)\b/.test(normalized))
+        return undefined;
+    const timeMatch = /\b\d{1,2}(?::\d{2})?\s*(?:a\.?\s*m\.?|p\.?\s*m\.?|am|pm)\b/i.exec(body);
+    if (!timeMatch)
+        return undefined;
+    const dateMatch = /\b\d{4}-\d{2}-\d{2}\b|\btomorrow\b|\btoday\b|\btonight\b/i.exec(body);
+    const dateText = dateMatch ? dateMatch[0].toLowerCase() : '';
+    const topic = normalized.includes('project meeting') ? 'project meeting' : 'meeting';
+    const timeText = timeMatch[0].replace(/\s+/g, ' ').trim();
+    let text = `The user has a ${topic}`;
+    if (dateText)
+        text += ` ${dateText}`;
+    text += ` at ${timeText}.`;
+    return {
+        kind: 'auto_short',
+        text,
+        priority: 2,
+        confidence: 1,
+        stability: 'session',
+        source: 'user_direct',
+        sourceType: 'user',
+        conflictKey: topic === 'project meeting' ? 'auto_short.project_meeting_time' : 'auto_short.meeting_time',
+        evidence: prompt,
+        reason: 'Runtime fallback extracted an explicit meeting time.',
+    };
+}
+function cleanMemoryValue(value) {
+    const cleaned = value
+        .trim()
+        .replace(/^["'`]+|["'`]+$/g, '')
+        .split(/\s*,?\s+(?:not|instead of)\b/i)[0]
+        .trim()
+        .slice(0, 120);
+    return cleaned;
+}
+function normalizeText(text) {
+    return text.trim().toLowerCase().replace(/^\s*[-*]\s*/, '').replace(/\s+/g, ' ').replace(/[.;]+$/g, '');
+}
+function slotKey(value) {
+    let key = value.trim().toLowerCase().replace(/colour/g, 'color');
+    key = key.replace(/[^a-z0-9]+/g, '_').replace(/^_+|_+$/g, '').replace(/_+/g, '_');
+    if (key.startsWith('fav_'))
+        key = `favorite_${key.slice(4)}`;
+    return key.slice(0, 40).replace(/^_+|_+$/g, '');
+}
+function looksResponsePreference(text) {
+    const normalized = normalizeText(text);
+    if (!/\b(prefer|prefers|preference|like|likes)\b/.test(normalized))
+        return false;
+    return Boolean(/\b(reply|replies|answer|answers|response|responses|conversation|tone|style)\b/.test(normalized)
+        || /\b(short|brief|concise|detailed|normal|casual|formal)\b/.test(normalized));
+}
+//# sourceMappingURL=MemoryControls.js.map

package/dist/memory/MemoryControls.js.map

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

package/dist/memory/MemoryStore.d.ts

@@ -0,0 +1,122 @@
+export type MemoryKind = 'user' | 'preferences' | 'auto_short';
+export type MemoryStatus = 'active' | 'superseded';
+export type MemoryScope = 'profile' | 'workspace' | 'project' | 'session' | 'task' | 'global';
+export type MemorySourceType = 'user' | 'model' | 'system' | 'tool' | 'file' | 'browser' | 'external_agent';
+export type MemoryStability = 'stable' | 'evolving' | 'session' | 'ephemeral';
+export interface MemoryEntry {
+    id: string;
+    kind: MemoryKind;
+    text: string;
+    priority: number;
+    confidence: number;
+    stability: MemoryStability;
+    status: MemoryStatus;
+    source: string;
+    source_type: MemorySourceType;
+    scope: MemoryScope;
+    created_at: string;
+    updated_at: string;
+    last_seen_at: string;
+    session_id?: string;
+    task_id?: string;
+    scope_id?: string;
+    conflict_key?: string;
+    supersedes?: string[];
+    evidence?: string;
+    reason?: string;
+    expires_at?: string;
+    [key: string]: unknown;
+}
+export interface MemoryScaffoldFile {
+    path: string;
+    status: 'created' | 'kept';
+}
+export interface MemoryRememberOptions {
+    sessionId?: string;
+    taskId?: string;
+    source?: string;
+    sourceType?: MemorySourceType;
+    scope?: MemoryScope;
+    scopeId?: string;
+    conflictKey?: string;
+    priority?: number;
+    confidence?: number;
+    stability?: MemoryStability | string;
+    evidence?: string;
+    reason?: string;
+    expiresAt?: string;
+    status?: MemoryStatus;
+}
+export interface MemoryRememberResult {
+    profile: string;
+    kind: MemoryKind;
+    path: string;
+    entry: MemoryEntry;
+    created: boolean;
+}
+export interface MemoryMutationResult {
+    profile: string;
+    query: string;
+    count: number;
+    paths: string[];
+}
+export interface MemorySaveInput {
+    kind: MemoryKind;
+    text: string;
+    source?: string;
+    sourceType?: MemorySourceType;
+    scope?: MemoryScope;
+    scopeId?: string;
+    conflictKey?: string;
+    priority?: number;
+    confidence?: number;
+    stability?: MemoryStability | string;
+    evidence?: string;
+    reason?: string;
+    expiresAt?: string;
+    status?: MemoryStatus;
+}
+export interface MemorySaveResult {
+    profile: string;
+    created: number;
+    skipped: number;
+    entries: MemoryEntry[];
+    paths: string[];
+}
+export interface MemoryListOptions {
+    limit?: number;
+    contextLimit?: number;
+    thinking?: boolean;
+    prompt?: string;
+}
+export declare function ensureProfileMemoryFiles(profileDir: string): MemoryScaffoldFile[];
+export declare class MemoryStore {
+    private readonly profilesDir;
+    constructor(profilesDir: string);
+    ensureProfile(profile: string): MemoryScaffoldFile[];
+    remember(profile: string, kind: MemoryKind, text: string, options?: MemoryRememberOptions): MemoryRememberResult;
+    save(profile: string, inputs: MemorySaveInput[], options?: Pick<MemoryRememberOptions, 'sessionId' | 'taskId'>): MemorySaveResult;
+    applySavePayloads(profile: string, payloads: string[], options?: Pick<MemoryRememberOptions, 'sessionId' | 'taskId'>): MemorySaveResult;
+    applyForgetPayloads(profile: string, payloads: string[]): MemoryMutationResult;
+    forget(profile: string, query: string, kind?: MemoryKind | string): MemoryMutationResult;
+    delete(profile: string, query: string, kind?: MemoryKind | string): MemoryMutationResult;
+    /** Supersede exactly one entry by id (a per-row Forget — no fuzzy matching,
+     * unlike `forget`'s query semantics). */
+    forgetById(profile: string, id: string): MemoryMutationResult;
+    /** Permanently remove exactly one entry by id (a per-row Delete). */
+    deleteById(profile: string, id: string): MemoryMutationResult;
+    /** Exact-id mutation across all kinds: update returning undefined removes the line. */
+    private mutateById;
+    listEntries(profile: string): MemoryEntry[];
+    listPromptMemory(profile: string, options?: MemoryListOptions): string[];
+    trimShortTerm(profile: string, sizeLimit: number): void;
+    private saveEntry;
+    private updateMatching;
+    private readEntriesFromFile;
+    private readLegacyEntries;
+    private jsonlPath;
+    private memoriesDir;
+    private normalizeQuery;
+    private assertSafeProfileName;
+}
+//# sourceMappingURL=MemoryStore.d.ts.map

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

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