@framers/agentos 0.6.30 → 0.7.1

package/dist/memory/io/integration/StandaloneMemoryBridge.js

@@ -1,421 +0,0 @@
-/**
- * @fileoverview Adapters that let the standalone SQLite-first `Memory`
- * facade participate in AgentOS long-term memory flows.
- *
- * These bridges intentionally use the public `Memory` API so the same memory
- * instance can power:
- * - agent-editable memory tools
- * - prompt-time long-term memory retrieval
- * - rolling-summary persistence
- *
- * @module agentos/memory/integration/StandaloneMemoryBridge
- */
-import { DEFAULT_LONG_TERM_MEMORY_POLICY, } from '../../../core/conversation/LongTermMemoryPolicy.js';
-const DEFAULT_BASE_TAGS = ['agentos', 'long_term_memory'];
-const CATEGORY_ORDER = [
-    'facts',
-    'preferences',
-    'people',
-    'projects',
-    'decisions',
-    'open_loops',
-    'todo',
-    'tags',
-];
-function nonEmptyString(value) {
-    if (typeof value !== 'string')
-        return null;
-    const trimmed = value.trim();
-    return trimmed ? trimmed : null;
-}
-function normalizeText(value) {
-    return nonEmptyString(value);
-}
-function formatPeopleEntry(person) {
-    if (typeof person !== 'object' || person === null)
-        return null;
-    const name = nonEmptyString(person.name);
-    const notes = nonEmptyString(person.notes);
-    if (!name)
-        return null;
-    return {
-        content: notes ? `Person: ${name}. ${notes}` : `Person: ${name}.`,
-        entities: [name],
-    };
-}
-function formatProjectEntry(project) {
-    if (typeof project !== 'object' || project === null)
-        return null;
-    const name = nonEmptyString(project.name);
-    const status = nonEmptyString(project.status);
-    const notes = nonEmptyString(project.notes);
-    if (!name)
-        return null;
-    const parts = [`Project: ${name}.`];
-    if (status)
-        parts.push(`Status: ${status}.`);
-    if (notes)
-        parts.push(notes);
-    return {
-        content: parts.join(' ').trim(),
-        entities: [name],
-    };
-}
-function unique(items) {
-    return Array.from(new Set(items));
-}
-export function buildStandaloneMemoryPersonaScopeId(userId, personaId) {
-    return `${userId}::${personaId}`;
-}
-function resolveScopeTargets(args) {
-    const targets = [];
-    const { userId, organizationId, conversationId, personaId, policy } = args;
-    if (policy.scopes.conversation && conversationId) {
-        targets.push({
-            key: `thread:${conversationId}`,
-            label: 'conversation',
-            memoryScope: 'thread',
-            scopeId: conversationId,
-        });
-    }
-    if (policy.scopes.persona && userId && personaId) {
-        targets.push({
-            key: `persona:${buildStandaloneMemoryPersonaScopeId(userId, personaId)}`,
-            label: 'persona',
-            memoryScope: 'persona',
-            scopeId: buildStandaloneMemoryPersonaScopeId(userId, personaId),
-        });
-    }
-    if (policy.scopes.user && userId) {
-        targets.push({
-            key: `user:${userId}`,
-            label: 'user',
-            memoryScope: 'user',
-            scopeId: userId,
-        });
-    }
-    if (policy.scopes.organization &&
-        policy.shareWithOrganization &&
-        organizationId) {
-        targets.push({
-            key: `organization:${organizationId}`,
-            label: 'organization',
-            memoryScope: 'organization',
-            scopeId: organizationId,
-        });
-    }
-    return targets;
-}
-function getScopeLimit(target, input, options) {
-    if (target.label === 'conversation') {
-        return options.conversationLimit;
-    }
-    if (target.label === 'user') {
-        return input.topKByScope?.user ?? options.defaultLimitPerScope;
-    }
-    if (target.label === 'persona') {
-        return input.topKByScope?.persona ?? options.defaultLimitPerScope;
-    }
-    if (target.label === 'organization') {
-        return input.topKByScope?.organization ?? options.defaultLimitPerScope;
-    }
-    return options.defaultLimitPerScope;
-}
-function trimContextText(text, maxContextChars) {
-    if (!maxContextChars || maxContextChars <= 0 || text.length <= maxContextChars) {
-        return { contextText: text, truncated: false };
-    }
-    const trimmed = text.slice(0, Math.max(0, maxContextChars - 1)).trimEnd();
-    return {
-        contextText: `${trimmed}…`,
-        truncated: true,
-    };
-}
-function renderScopeHeading(label) {
-    if (label === 'conversation')
-        return 'Conversation Memory';
-    if (label === 'persona')
-        return 'Persona Memory';
-    if (label === 'user')
-        return 'User Memory';
-    return 'Organization Memory';
-}
-export function createStandaloneMemoryLongTermRetriever(memory, options) {
-    const resolvedOptions = {
-        defaultLimitPerScope: options?.defaultLimitPerScope ?? 4,
-        conversationLimit: options?.conversationLimit ?? 4,
-        includeScopeHeadings: options?.includeScopeHeadings ?? true,
-    };
-    return {
-        async retrieveLongTermMemory(input) {
-            const policy = input.memoryPolicy ?? DEFAULT_LONG_TERM_MEMORY_POLICY;
-            const targets = resolveScopeTargets({
-                userId: input.userId,
-                organizationId: input.organizationId,
-                conversationId: input.conversationId,
-                personaId: input.personaId,
-                policy,
-            });
-            if (targets.length === 0) {
-                return null;
-            }
-            const scopeResults = [];
-            for (const target of targets) {
-                const recallPolicy = input.retrievalPolicy ?? policy.retrieval ?? undefined;
-                const recallOptions = {
-                    limit: getScopeLimit(target, input, resolvedOptions),
-                    scope: target.memoryScope,
-                    scopeId: target.scopeId,
-                    policy: recallPolicy,
-                };
-                const hits = await memory.recall(input.queryText, recallOptions);
-                if (hits.length > 0) {
-                    scopeResults.push({ target, hits });
-                }
-            }
-            if (scopeResults.length === 0) {
-                return null;
-            }
-            const seenContent = new Set();
-            const seenTraceIds = new Set();
-            const sections = [];
-            const selectedTraces = [];
-            const diagnostics = {
-                totalHits: 0,
-                queryText: input.queryText,
-                scopes: {},
-            };
-            for (const { target, hits } of scopeResults) {
-                const lines = [];
-                for (const hit of hits) {
-                    const content = normalizeText(hit.trace.content);
-                    if (!content)
-                        continue;
-                    if (seenContent.has(content))
-                        continue;
-                    seenContent.add(content);
-                    if (!seenTraceIds.has(hit.trace.id)) {
-                        seenTraceIds.add(hit.trace.id);
-                        selectedTraces.push(hit.trace);
-                    }
-                    lines.push(`- ${content}`);
-                }
-                if (lines.length === 0) {
-                    continue;
-                }
-                diagnostics.scopes[target.label] = lines.length;
-                diagnostics.totalHits = Number(diagnostics.totalHits) + lines.length;
-                if (resolvedOptions.includeScopeHeadings) {
-                    sections.push(`### ${renderScopeHeading(target.label)}`);
-                }
-                sections.push(...lines);
-            }
-            if (sections.length === 0) {
-                return null;
-            }
-            const rendered = sections.join('\n');
-            const { contextText, truncated } = trimContextText(rendered, input.maxContextChars);
-            diagnostics.truncated = truncated;
-            return {
-                contextText,
-                diagnostics,
-                feedbackPayload: selectedTraces.length > 0
-                    ? { traces: selectedTraces }
-                    : undefined,
-            };
-        },
-        async recordRetrievalFeedback(input) {
-            if (typeof memory.feedbackFromResponse !== 'function') {
-                return;
-            }
-            const traces = Array.isArray(input.feedbackPayload?.traces)
-                ? input.feedbackPayload.traces
-                : [];
-            if (!input.responseText.trim() || traces.length === 0) {
-                return;
-            }
-            await memory.feedbackFromResponse(traces, input.responseText, input.queryText);
-        },
-    };
-}
-function categoryAllowed(category, allowedCategories) {
-    if (allowedCategories === null)
-        return true;
-    return allowedCategories.includes(category);
-}
-function buildSummaryContent(update) {
-    return [
-        `Rolling summary for conversation ${update.conversationId} (persona ${update.personaId}).`,
-        update.summaryText.trim(),
-    ]
-        .filter(Boolean)
-        .join('\n\n');
-}
-function collectSummaryEntities(summaryJson) {
-    const entities = [];
-    if (!summaryJson || typeof summaryJson !== 'object') {
-        return entities;
-    }
-    if (Array.isArray(summaryJson.people)) {
-        for (const person of summaryJson.people) {
-            const name = nonEmptyString(person?.name);
-            if (name)
-                entities.push(name);
-        }
-    }
-    if (Array.isArray(summaryJson.projects)) {
-        for (const project of summaryJson.projects) {
-            const name = nonEmptyString(project?.name);
-            if (name)
-                entities.push(name);
-        }
-    }
-    return unique(entities);
-}
-function extractAtomicDocs(summaryJson, allowedCategories, baseTags) {
-    if (!summaryJson || typeof summaryJson !== 'object') {
-        return [];
-    }
-    const docs = [];
-    const pushDoc = (category, key, content, entities = []) => {
-        const normalized = normalizeText(content);
-        if (!normalized || !categoryAllowed(category, allowedCategories)) {
-            return;
-        }
-        docs.push({
-            key: `${category}:${key}`,
-            content: normalized,
-            tags: [...baseTags, 'rolling_memory_item', `category:${category}`],
-            entities: unique(entities),
-        });
-    };
-    if (Array.isArray(summaryJson.facts)) {
-        for (const item of summaryJson.facts) {
-            const text = normalizeText(item?.text);
-            pushDoc('facts', text ?? '', text ? `Fact: ${text}` : null);
-        }
-    }
-    if (Array.isArray(summaryJson.preferences)) {
-        for (const item of summaryJson.preferences) {
-            const text = normalizeText(item?.text);
-            pushDoc('preferences', text ?? '', text ? `Preference: ${text}` : null);
-        }
-    }
-    if (Array.isArray(summaryJson.people)) {
-        for (const person of summaryJson.people) {
-            const formatted = formatPeopleEntry(person);
-            pushDoc('people', formatted?.content ?? '', formatted?.content ?? null, formatted?.entities ?? []);
-        }
-    }
-    if (Array.isArray(summaryJson.projects)) {
-        for (const project of summaryJson.projects) {
-            const formatted = formatProjectEntry(project);
-            pushDoc('projects', formatted?.content ?? '', formatted?.content ?? null, formatted?.entities ?? []);
-        }
-    }
-    if (Array.isArray(summaryJson.decisions)) {
-        for (const item of summaryJson.decisions) {
-            const text = normalizeText(item?.text);
-            pushDoc('decisions', text ?? '', text ? `Decision: ${text}` : null);
-        }
-    }
-    if (Array.isArray(summaryJson.open_loops)) {
-        for (const item of summaryJson.open_loops) {
-            const text = normalizeText(item?.text);
-            pushDoc('open_loops', text ?? '', text ? `Open loop: ${text}` : null);
-        }
-    }
-    if (Array.isArray(summaryJson.todo)) {
-        for (const item of summaryJson.todo) {
-            const text = normalizeText(item?.text);
-            pushDoc('todo', text ?? '', text ? `Todo: ${text}` : null);
-        }
-    }
-    if (Array.isArray(summaryJson.tags) && categoryAllowed('tags', allowedCategories)) {
-        for (const tag of summaryJson.tags) {
-            const normalized = normalizeText(tag);
-            pushDoc('tags', normalized ?? '', normalized ? `Tag: ${normalized}` : null);
-        }
-    }
-    return docs;
-}
-export function createStandaloneMemoryRollingSummarySink(memory, options) {
-    const baseTags = unique(options?.baseTags ?? DEFAULT_BASE_TAGS);
-    const summaryImportance = options?.summaryImportance ?? 0.9;
-    const atomicDocImportance = options?.atomicDocImportance ?? 1.0;
-    const summaryTraceIds = new Map();
-    const atomicTraceIds = new Map();
-    const upsertDocsForScope = async (target, docs) => {
-        const next = new Map();
-        for (const doc of docs) {
-            const trace = await memory.remember(doc.content, {
-                type: 'semantic',
-                scope: target.memoryScope,
-                scopeId: target.scopeId,
-                tags: doc.tags,
-                entities: doc.entities,
-                importance: atomicDocImportance,
-            });
-            next.set(doc.key, trace.id);
-        }
-        const previous = atomicTraceIds.get(target.key);
-        if (previous) {
-            for (const [key, traceId] of previous.entries()) {
-                if (next.get(key) !== traceId) {
-                    await memory.forget(traceId);
-                }
-            }
-        }
-        atomicTraceIds.set(target.key, next);
-    };
-    return {
-        async upsertRollingSummaryMemory(update) {
-            const policy = update.memoryPolicy ?? DEFAULT_LONG_TERM_MEMORY_POLICY;
-            if (!policy.enabled) {
-                return;
-            }
-            const targets = resolveScopeTargets({
-                userId: update.userId,
-                organizationId: update.organizationId,
-                conversationId: update.conversationId,
-                personaId: update.personaId,
-                policy,
-            });
-            if (targets.length === 0) {
-                return;
-            }
-            const summaryTags = unique([
-                ...baseTags,
-                'rolling_summary',
-                ...(Array.isArray(update.summaryJson?.tags)
-                    ? update.summaryJson.tags
-                        .map((tag) => normalizeText(tag))
-                        .filter((tag) => Boolean(tag))
-                    : []),
-            ]);
-            const summaryEntities = collectSummaryEntities(update.summaryJson);
-            const summaryContent = buildSummaryContent(update);
-            const atomicDocs = policy.storeAtomicDocs === true
-                ? extractAtomicDocs(update.summaryJson, policy.allowedCategories, baseTags)
-                : [];
-            for (const target of targets) {
-                const summaryTrace = await memory.remember(summaryContent, {
-                    type: 'semantic',
-                    scope: target.memoryScope,
-                    scopeId: target.scopeId,
-                    tags: summaryTags,
-                    entities: summaryEntities,
-                    importance: summaryImportance,
-                });
-                const previousSummaryTraceId = summaryTraceIds.get(target.key);
-                if (previousSummaryTraceId &&
-                    previousSummaryTraceId !== summaryTrace.id) {
-                    await memory.forget(previousSummaryTraceId);
-                }
-                summaryTraceIds.set(target.key, summaryTrace.id);
-                await upsertDocsForScope(target, atomicDocs);
-            }
-        },
-    };
-}
-//# sourceMappingURL=StandaloneMemoryBridge.js.map

package/dist/memory/io/integration/StandaloneMemoryBridge.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"StandaloneMemoryBridge.js","sourceRoot":"","sources":["../../../../src/memory/io/integration/StandaloneMemoryBridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAYH,OAAO,EACL,+BAA+B,GAGhC,MAAM,oDAAoD,CAAC;AAyB5D,MAAM,iBAAiB,GAAG,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;AAC1D,MAAM,cAAc,GAAmC;IACrD,OAAO;IACP,aAAa;IACb,QAAQ;IACR,UAAU;IACV,WAAW;IACX,YAAY;IACZ,MAAM;IACN,MAAM;CACP,CAAC;AA0CF,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AAClC,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAe;IACxC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/D,MAAM,IAAI,GAAG,cAAc,CAAE,MAAc,CAAC,IAAI,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,cAAc,CAAE,MAAc,CAAC,KAAK,CAAC,CAAC;IACpD,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,WAAW,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,WAAW,IAAI,GAAG;QACjE,QAAQ,EAAE,CAAC,IAAI,CAAC;KACjB,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,OAAgB;IAC1C,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACjE,MAAM,IAAI,GAAG,cAAc,CAAE,OAAe,CAAC,IAAI,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,cAAc,CAAE,OAAe,CAAC,MAAM,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,cAAc,CAAE,OAAe,CAAC,KAAK,CAAC,CAAC;IACrD,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAEvB,MAAM,KAAK,GAAG,CAAC,YAAY,IAAI,GAAG,CAAC,CAAC;IACpC,IAAI,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,MAAM,GAAG,CAAC,CAAC;IAC7C,IAAI,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAE7B,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE;QAC/B,QAAQ,EAAE,CAAC,IAAI,CAAC;KACjB,CAAC;AACJ,CAAC;AAED,SAAS,MAAM,CAAI,KAAU;IAC3B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,mCAAmC,CAAC,MAAc,EAAE,SAAiB;IACnF,OAAO,GAAG,MAAM,KAAK,SAAS,EAAE,CAAC;AACnC,CAAC;AAED,SAAS,mBAAmB,CAAC,IAM5B;IACC,MAAM,OAAO,GAAwB,EAAE,CAAC;IACxC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAE3E,IAAI,MAAM,CAAC,MAAM,CAAC,YAAY,IAAI,cAAc,EAAE,CAAC;QACjD,OAAO,CAAC,IAAI,CAAC;YACX,GAAG,EAAE,UAAU,cAAc,EAAE;YAC/B,KAAK,EAAE,cAAc;YACrB,WAAW,EAAE,QAAQ;YACrB,OAAO,EAAE,cAAc;SACxB,CAAC,CAAC;IACL,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,IAAI,SAAS,EAAE,CAAC;QACjD,OAAO,CAAC,IAAI,CAAC;YACX,GAAG,EAAE,WAAW,mCAAmC,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE;YACxE,KAAK,EAAE,SAAS;YAChB,WAAW,EAAE,SAAS;YACtB,OAAO,EAAE,mCAAmC,CAAC,MAAM,EAAE,SAAS,CAAC;SAChE,CAAC,CAAC;IACL,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,MAAM,EAAE,CAAC;QACjC,OAAO,CAAC,IAAI,CAAC;YACX,GAAG,EAAE,QAAQ,MAAM,EAAE;YACrB,KAAK,EAAE,MAAM;YACb,WAAW,EAAE,MAAM;YACnB,OAAO,EAAE,MAAM;SAChB,CAAC,CAAC;IACL,CAAC;IAED,IACE,MAAM,CAAC,MAAM,CAAC,YAAY;QAC1B,MAAM,CAAC,qBAAqB;QAC5B,cAAc,EACd,CAAC;QACD,OAAO,CAAC,IAAI,CAAC;YACX,GAAG,EAAE,gBAAgB,cAAc,EAAE;YACrC,KAAK,EAAE,cAAc;YACrB,WAAW,EAAE,cAAc;YAC3B,OAAO,EAAE,cAAc;SACxB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,aAAa,CACpB,MAAyB,EACzB,KAAmC,EACnC,OAA2D;IAE3D,IAAI,MAAM,CAAC,KAAK,KAAK,cAAc,EAAE,CAAC;QACpC,OAAO,OAAO,CAAC,iBAAiB,CAAC;IACnC,CAAC;IAED,IAAI,MAAM,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC,WAAW,EAAE,IAAI,IAAI,OAAO,CAAC,oBAAoB,CAAC;IACjE,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC,WAAW,EAAE,OAAO,IAAI,OAAO,CAAC,oBAAoB,CAAC;IACpE,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,KAAK,cAAc,EAAE,CAAC;QACpC,OAAO,KAAK,CAAC,WAAW,EAAE,YAAY,IAAI,OAAO,CAAC,oBAAoB,CAAC;IACzE,CAAC;IAED,OAAO,OAAO,CAAC,oBAAoB,CAAC;AACtC,CAAC;AAED,SAAS,eAAe,CAAC,IAAY,EAAE,eAAwB;IAI7D,IAAI,CAAC,eAAe,IAAI,eAAe,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,IAAI,eAAe,EAAE,CAAC;QAC/E,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACjD,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,eAAe,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IAC1E,OAAO;QACL,WAAW,EAAE,GAAG,OAAO,GAAG;QAC1B,SAAS,EAAE,IAAI;KAChB,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAiC;IAC3D,IAAI,KAAK,KAAK,cAAc;QAAE,OAAO,qBAAqB,CAAC;IAC3D,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,gBAAgB,CAAC;IACjD,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,aAAa,CAAC;IAC3C,OAAO,qBAAqB,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,uCAAuC,CACrD,MAAqC,EACrC,OAAkD;IAElD,MAAM,eAAe,GAAuD;QAC1E,oBAAoB,EAAE,OAAO,EAAE,oBAAoB,IAAI,CAAC;QACxD,iBAAiB,EAAE,OAAO,EAAE,iBAAiB,IAAI,CAAC;QAClD,oBAAoB,EAAE,OAAO,EAAE,oBAAoB,IAAI,IAAI;KAC5D,CAAC;IAEF,OAAO;QACL,KAAK,CAAC,sBAAsB,CAC1B,KAAmC;YAEnC,MAAM,MAAM,GAAG,KAAK,CAAC,YAAY,IAAI,+BAA+B,CAAC;YACrE,MAAM,OAAO,GAAG,mBAAmB,CAAC;gBAClC,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,cAAc,EAAE,KAAK,CAAC,cAAc;gBACpC,cAAc,EAAE,KAAK,CAAC,cAAc;gBACpC,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,MAAM;aACP,CAAC,CAAC;YAEH,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO,IAAI,CAAC;YACd,CAAC;YAED,MAAM,YAAY,GAGb,EAAE,CAAC;YAER,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,MAAM,YAAY,GAAG,KAAK,CAAC,eAAe,IAAI,MAAM,CAAC,SAAS,IAAI,SAAS,CAAC;gBAC5E,MAAM,aAAa,GAAkB;oBACnC,KAAK,EAAE,aAAa,CAAC,MAAM,EAAE,KAAK,EAAE,eAAe,CAAC;oBACpD,KAAK,EAAE,MAAM,CAAC,WAAW;oBACzB,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,MAAM,EAAE,YAAY;iBACrB,CAAC;gBACF,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;gBACjE,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACpB,YAAY,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;gBACtC,CAAC;YACH,CAAC;YAED,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC9B,OAAO,IAAI,CAAC;YACd,CAAC;YAED,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;YACtC,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;YACvC,MAAM,QAAQ,GAAa,EAAE,CAAC;YAC9B,MAAM,cAAc,GAAkB,EAAE,CAAC;YACzC,MAAM,WAAW,GAA4B;gBAC3C,SAAS,EAAE,CAAC;gBACZ,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,MAAM,EAAE,EAA4B;aACrC,CAAC;YAEF,KAAK,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,YAAY,EAAE,CAAC;gBAC5C,MAAM,KAAK,GAAa,EAAE,CAAC;gBAC3B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;oBACvB,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;oBACjD,IAAI,CAAC,OAAO;wBAAE,SAAS;oBACvB,IAAI,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC;wBAAE,SAAS;oBACvC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;oBACzB,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;wBACpC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;wBAC/B,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;oBACjC,CAAC;oBACD,KAAK,CAAC,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;gBAC7B,CAAC;gBAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACvB,SAAS;gBACX,CAAC;gBAEA,WAAW,CAAC,MAAiC,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;gBAC5E,WAAW,CAAC,SAAS,GAAG,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;gBAErE,IAAI,eAAe,CAAC,oBAAoB,EAAE,CAAC;oBACzC,QAAQ,CAAC,IAAI,CAAC,OAAO,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBAC3D,CAAC;gBACD,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;YAC1B,CAAC;YAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO,IAAI,CAAC;YACd,CAAC;YAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,eAAe,CAAC,QAAQ,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC;YACpF,WAAW,CAAC,SAAS,GAAG,SAAS,CAAC;YAElC,OAAO;gBACL,WAAW;gBACX,WAAW;gBACX,eAAe,EAAE,cAAc,CAAC,MAAM,GAAG,CAAC;oBACxC,CAAC,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE;oBAC5B,CAAC,CAAC,SAAS;aACd,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,uBAAuB,CAC3B,KAAkC;YAElC,IAAI,OAAO,MAAM,CAAC,oBAAoB,KAAK,UAAU,EAAE,CAAC;gBACtD,OAAO;YACT,CAAC;YAED,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAE,KAAK,CAAC,eAAuB,EAAE,MAAM,CAAC;gBAClE,CAAC,CAAG,KAAK,CAAC,eAAuB,CAAC,MAAwB;gBAC1D,CAAC,CAAC,EAAE,CAAC;YAEP,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtD,OAAO;YACT,CAAC;YAED,MAAM,MAAM,CAAC,oBAAoB,CAAC,MAAM,EAAE,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QACjF,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CACtB,QAAsC,EACtC,iBAAwD;IAExD,IAAI,iBAAiB,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC5C,OAAO,iBAAiB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,mBAAmB,CAAC,MAAkC;IAC7D,OAAO;QACL,oCAAoC,MAAM,CAAC,cAAc,aAAa,MAAM,CAAC,SAAS,IAAI;QAC1F,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE;KAC1B;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC;AAED,SAAS,sBAAsB,CAAC,WAAgB;IAC9C,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,CAAC,WAAW,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;QACpD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,KAAK,MAAM,MAAM,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;YACxC,MAAM,IAAI,GAAG,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YAC1C,IAAI,IAAI;gBAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxC,KAAK,MAAM,OAAO,IAAI,WAAW,CAAC,QAAQ,EAAE,CAAC;YAC3C,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAC3C,IAAI,IAAI;gBAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,iBAAiB,CACxB,WAAgB,EAChB,iBAAwD,EACxD,QAAkB;IAElB,IAAI,CAAC,WAAW,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;QACpD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,IAAI,GAAgB,EAAE,CAAC;IAE7B,MAAM,OAAO,GAAG,CACd,QAAsC,EACtC,GAAW,EACX,OAAsB,EACtB,WAAqB,EAAE,EACjB,EAAE;QACR,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,CAAC,UAAU,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,iBAAiB,CAAC,EAAE,CAAC;YACjE,OAAO;QACT,CAAC;QACD,IAAI,CAAC,IAAI,CAAC;YACR,GAAG,EAAE,GAAG,QAAQ,IAAI,GAAG,EAAE;YACzB,OAAO,EAAE,UAAU;YACnB,IAAI,EAAE,CAAC,GAAG,QAAQ,EAAE,qBAAqB,EAAE,YAAY,QAAQ,EAAE,CAAC;YAClE,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;SAC3B,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC;YACrC,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACvC,OAAO,CAAC,OAAO,EAAE,IAAI,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,CAAC;QAC3C,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,WAAW,EAAE,CAAC;YAC3C,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACvC,OAAO,CAAC,aAAa,EAAE,IAAI,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,KAAK,MAAM,MAAM,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;YACxC,MAAM,SAAS,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;YAC5C,OAAO,CACL,QAAQ,EACR,SAAS,EAAE,OAAO,IAAI,EAAE,EACxB,SAAS,EAAE,OAAO,IAAI,IAAI,EAC1B,SAAS,EAAE,QAAQ,IAAI,EAAE,CAC1B,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxC,KAAK,MAAM,OAAO,IAAI,WAAW,CAAC,QAAQ,EAAE,CAAC;YAC3C,MAAM,SAAS,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;YAC9C,OAAO,CACL,UAAU,EACV,SAAS,EAAE,OAAO,IAAI,EAAE,EACxB,SAAS,EAAE,OAAO,IAAI,IAAI,EAC1B,SAAS,EAAE,QAAQ,IAAI,EAAE,CAC1B,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC;QACzC,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,SAAS,EAAE,CAAC;YACzC,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACvC,OAAO,CAAC,WAAW,EAAE,IAAI,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1C,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,UAAU,EAAE,CAAC;YAC1C,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACvC,OAAO,CAAC,YAAY,EAAE,IAAI,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC;YACpC,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACvC,OAAO,CAAC,MAAM,EAAE,IAAI,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,eAAe,CAAC,MAAM,EAAE,iBAAiB,CAAC,EAAE,CAAC;QAClF,KAAK,MAAM,GAAG,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC;YACnC,MAAM,UAAU,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;YACtC,OAAO,CAAC,MAAM,EAAE,UAAU,IAAI,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,wCAAwC,CACtD,MAA+B,EAC/B,OAAmD;IAEnD,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,EAAE,QAAQ,IAAI,iBAAiB,CAAC,CAAC;IAChE,MAAM,iBAAiB,GAAG,OAAO,EAAE,iBAAiB,IAAI,GAAG,CAAC;IAC5D,MAAM,mBAAmB,GAAG,OAAO,EAAE,mBAAmB,IAAI,GAAG,CAAC;IAChE,MAAM,eAAe,GAAG,IAAI,GAAG,EAAkB,CAAC;IAClD,MAAM,cAAc,GAAG,IAAI,GAAG,EAA+B,CAAC;IAE9D,MAAM,kBAAkB,GAAG,KAAK,EAC9B,MAAyB,EACzB,IAAiB,EACF,EAAE;QACjB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;QAEvC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE;gBAC/C,IAAI,EAAE,UAAU;gBAChB,KAAK,EAAE,MAAM,CAAC,WAAW;gBACzB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,QAAQ,EAAE,GAAG,CAAC,QAAQ;gBACtB,UAAU,EAAE,mBAAmB;aACN,CAAC,CAAC;YAC7B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;QAC9B,CAAC;QAED,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAChD,IAAI,QAAQ,EAAE,CAAC;YACb,KAAK,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;gBAChD,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,OAAO,EAAE,CAAC;oBAC9B,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC;QACH,CAAC;QAED,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACvC,CAAC,CAAC;IAEF,OAAO;QACL,KAAK,CAAC,0BAA0B,CAAC,MAAkC;YACjE,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,IAAI,+BAA+B,CAAC;YACtE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,OAAO;YACT,CAAC;YAED,MAAM,OAAO,GAAG,mBAAmB,CAAC;gBAClC,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,cAAc,EAAE,MAAM,CAAC,cAAc;gBACrC,cAAc,EAAE,MAAM,CAAC,cAAc;gBACrC,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,MAAM;aACP,CAAC,CAAC;YAEH,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO;YACT,CAAC;YAED,MAAM,WAAW,GAAG,MAAM,CAAC;gBACzB,GAAG,QAAQ;gBACX,iBAAiB;gBACjB,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC;oBACzC,CAAC,CAAE,MAAM,CAAC,WAAW,CAAC,IAAkB;yBACnC,GAAG,CAAC,CAAC,GAAY,EAAiB,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;yBACxD,MAAM,CAAC,CAAC,GAAG,EAAiB,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;oBACjD,CAAC,CAAC,EAAE,CAAC;aACR,CAAC,CAAC;YACH,MAAM,eAAe,GAAG,sBAAsB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;YACnE,MAAM,cAAc,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;YACnD,MAAM,UAAU,GACd,MAAM,CAAC,eAAe,KAAK,IAAI;gBAC7B,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,iBAAiB,EAAE,QAAQ,CAAC;gBAC3E,CAAC,CAAC,EAAE,CAAC;YAET,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,cAAc,EAAE;oBACzD,IAAI,EAAE,UAAU;oBAChB,KAAK,EAAE,MAAM,CAAC,WAAW;oBACzB,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,IAAI,EAAE,WAAW;oBACjB,QAAQ,EAAE,eAAe;oBACzB,UAAU,EAAE,iBAAiB;iBACJ,CAAC,CAAC;gBAE7B,MAAM,sBAAsB,GAAG,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC/D,IACE,sBAAsB;oBACtB,sBAAsB,KAAK,YAAY,CAAC,EAAE,EAC1C,CAAC;oBACD,MAAM,MAAM,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC;gBAC9C,CAAC;gBACD,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,YAAY,CAAC,EAAE,CAAC,CAAC;gBAEjD,MAAM,kBAAkB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/memory/io/tools/MemoryAddTool.d.ts

@@ -1,98 +0,0 @@
-/**
- * @fileoverview MemoryAddTool — lets an agent store a new memory trace.
- *
- * The agent calls this tool to remember important facts, decisions, or
- * observations. Each invocation inserts a fresh row into `memory_traces`
- * with strength 1.0 (full encoding strength at creation time).
- *
- * ID format: `mt_<timestamp>_<counter>` — monotonically increasing within a
- * process, collision-safe across typical agent interaction rates.
- *
- * @module memory/tools/MemoryAddTool
- */
-import type { ITool, ToolExecutionResult, ToolExecutionContext, JSONSchemaObject } from '../../../core/tools/ITool.js';
-import type { Brain } from '../../retrieval/store/Brain.js';
-/**
- * Input arguments for {@link MemoryAddTool}.
- *
- * @property content - The text content of the memory to store.
- * @property type    - Tulving memory type (episodic, semantic, procedural, prospective, relational). Defaults to 'episodic'.
- * @property scope   - Visibility scope (thread, user, persona, organization). Defaults to 'user'.
- * @property tags    - Optional array of free-form tag strings for filtering.
- */
-export interface MemoryAddInput extends Record<string, any> {
-    content: string;
-    type?: string;
-    scope?: string;
-    tags?: string[];
-}
-/**
- * Output returned by {@link MemoryAddTool} on success.
- *
- * @property traceId - The unique ID of the newly stored memory trace.
- */
-export interface MemoryAddOutput {
-    traceId: string;
-}
-/**
- * ITool implementation that stores a new memory trace in the agent's
- * SQLite brain database.
- *
- * **Usage:**
- * ```ts
- * const tool = new MemoryAddTool(brain);
- * const result = await tool.execute(
- *   { content: 'User prefers dark mode.', tags: ['preference', 'ui'] },
- *   context,
- * );
- * // result.output.traceId → 'mt_1711234567890_0'
- * ```
- */
-export declare class MemoryAddTool implements ITool<MemoryAddInput, MemoryAddOutput> {
-    private readonly brain;
-    /** Globally unique tool identifier. */
-    readonly id = "memory-add-v1";
-    /** LLM-facing tool name (snake_case, as the LLM will call it). */
-    readonly name = "memory_add";
-    /** Human-readable display name for UIs and logs. */
-    readonly displayName = "Add Memory";
-    /**
-     * Description shown to the LLM when deciding which tool to invoke.
-     * Must be comprehensive enough for the model to understand when to call this.
-     */
-    readonly description = "Store a new memory trace. The agent calls this to remember important facts, decisions, or observations.";
-    /** Logical category for discovery and grouping. */
-    readonly category = "memory";
-    /**
-     * This tool writes to the database.
-     * Callers may request confirmation before execution when `hasSideEffects = true`.
-     */
-    readonly hasSideEffects = true;
-    /**
-     * JSON schema for input validation and LLM tool-call construction.
-     * All optional fields default gracefully inside `execute()`.
-     */
-    readonly inputSchema: JSONSchemaObject;
-    /**
-     * @param brain - The agent's shared SQLite brain database connection.
-     */
-    constructor(brain: Brain);
-    /**
-     * Insert a new memory trace row into `memory_traces`.
-     *
-     * Defaults applied when optional fields are absent:
-     * - `type`  → `'episodic'`
-     * - `scope` → `'user'`
-     * - `tags`  → `[]`
-     *
-     * The trace is created with `strength = 1.0` (maximum encoding strength)
-     * and `deleted = 0` (active). No embedding is computed here — the background
-     * EmbeddingEncoder will embed it asynchronously.
-     *
-     * @param args    - Memory add input (content, optional type/scope/tags).
-     * @param context - Tool execution context used to resolve the scope ID.
-     * @returns `{ traceId }` on success, or an error result.
-     */
-    execute(args: MemoryAddInput, context: ToolExecutionContext): Promise<ToolExecutionResult<MemoryAddOutput>>;
-}
-//# sourceMappingURL=MemoryAddTool.d.ts.map

package/dist/memory/io/tools/MemoryAddTool.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"MemoryAddTool.d.ts","sourceRoot":"","sources":["../../../../src/memory/io/tools/MemoryAddTool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,KAAK,EACL,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gCAAgC,CAAC;AAe5D;;;;;;;GAOG;AACH,MAAM,WAAW,cAAe,SAAQ,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD;;;;;;;;;;;;;GAaG;AACH,qBAAa,aAAc,YAAW,KAAK,CAAC,cAAc,EAAE,eAAe,CAAC;IA2D9D,OAAO,CAAC,QAAQ,CAAC,KAAK;IA1DlC,uCAAuC;IACvC,QAAQ,CAAC,EAAE,mBAAmB;IAE9B,kEAAkE;IAClE,QAAQ,CAAC,IAAI,gBAAgB;IAE7B,oDAAoD;IACpD,QAAQ,CAAC,WAAW,gBAAgB;IAEpC;;;OAGG;IACH,QAAQ,CAAC,WAAW,6GACwF;IAE5G,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,YAAY;IAE7B;;;OAGG;IACH,QAAQ,CAAC,cAAc,QAAQ;IAE/B;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAwBpC;IAEF;;OAEG;gBAC0B,KAAK,EAAE,KAAK;IAMzC;;;;;;;;;;;;;;;OAeG;IACG,OAAO,CACX,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,eAAe,CAAC,CAAC;CA0CjD"}

package/dist/memory/io/tools/MemoryAddTool.js.map

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

package/dist/memory/io/tools/MemoryDeleteTool.d.ts

@@ -1,83 +0,0 @@
-/**
- * @fileoverview MemoryDeleteTool — lets an agent soft-delete a memory trace.
- *
- * Deletion is always a soft-delete: the row in `memory_traces` is kept intact
- * but its `deleted` flag is set to `1`. This preserves the audit trail and
- * allows the consolidation engine to later log or compact the removal.
- *
- * The optional `reason` argument is currently captured in the tool contract
- * but not stored in the database; it is reserved for a future `deleted_reason`
- * column when schema migration tooling is in place.
- *
- * @module memory/tools/MemoryDeleteTool
- */
-import type { ITool, ToolExecutionResult, ToolExecutionContext, JSONSchemaObject } from '../../../core/tools/ITool.js';
-import type { Brain } from '../../retrieval/store/Brain.js';
-/**
- * Input arguments for {@link MemoryDeleteTool}.
- *
- * @property traceId - ID of the trace to soft-delete.
- * @property reason  - Optional human-readable explanation for the deletion.
- *                     Useful for agents to self-document their pruning decisions.
- */
-export interface MemoryDeleteInput extends Record<string, any> {
-    traceId: string;
-    reason?: string;
-}
-/**
- * Output returned by {@link MemoryDeleteTool} on success.
- *
- * @property deleted - `true` if the trace was found and marked deleted.
- *                     `false` if no active trace matched the given `traceId`.
- */
-export interface MemoryDeleteOutput {
-    deleted: boolean;
-}
-/**
- * ITool implementation that soft-deletes a memory trace from the agent's
- * SQLite brain database.
- *
- * **Usage:**
- * ```ts
- * const tool = new MemoryDeleteTool(brain);
- * const result = await tool.execute(
- *   { traceId: 'mt_1711234567890_0', reason: 'Information is outdated.' },
- *   context,
- * );
- * // result.output.deleted → true
- * ```
- */
-export declare class MemoryDeleteTool implements ITool<MemoryDeleteInput, MemoryDeleteOutput> {
-    private readonly brain;
-    /** Globally unique tool identifier. */
-    readonly id = "memory-delete-v1";
-    /** LLM-facing tool name. */
-    readonly name = "memory_delete";
-    /** Human-readable display name. */
-    readonly displayName = "Delete Memory";
-    /** LLM-facing description. */
-    readonly description: string;
-    /** Logical category for discovery and grouping. */
-    readonly category = "memory";
-    /** This tool writes to the database. */
-    readonly hasSideEffects = true;
-    /** JSON schema for input validation and LLM tool-call construction. */
-    readonly inputSchema: JSONSchemaObject;
-    /**
-     * @param brain - The agent's shared SQLite brain database connection.
-     */
-    constructor(brain: Brain);
-    /**
-     * Set `deleted = 1` on the memory trace matching `traceId`.
-     *
-     * The WHERE clause filters to `deleted = 0` so that attempting to
-     * delete an already-deleted trace returns `{ deleted: false }` rather
-     * than silently succeeding — this gives callers accurate feedback.
-     *
-     * @param args     - Delete input (traceId, optional reason).
-     * @param _context - Tool execution context (not used by this tool).
-     * @returns `{ deleted }` status, or an error result.
-     */
-    execute(args: MemoryDeleteInput, _context: ToolExecutionContext): Promise<ToolExecutionResult<MemoryDeleteOutput>>;
-}
-//# sourceMappingURL=MemoryDeleteTool.d.ts.map

package/dist/memory/io/tools/MemoryDeleteTool.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"MemoryDeleteTool.d.ts","sourceRoot":"","sources":["../../../../src/memory/io/tools/MemoryDeleteTool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACvH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gCAAgC,CAAC;AAM5D;;;;;;GAMG;AACH,MAAM,WAAW,iBAAkB,SAAQ,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;CAClB;AAMD;;;;;;;;;;;;;GAaG;AACH,qBAAa,gBAAiB,YAAW,KAAK,CAAC,iBAAiB,EAAE,kBAAkB,CAAC;IAyCvE,OAAO,CAAC,QAAQ,CAAC,KAAK;IAxClC,uCAAuC;IACvC,QAAQ,CAAC,EAAE,sBAAsB;IAEjC,4BAA4B;IAC5B,QAAQ,CAAC,IAAI,mBAAmB;IAEhC,mCAAmC;IACnC,QAAQ,CAAC,WAAW,mBAAmB;IAEvC,8BAA8B;IAC9B,QAAQ,CAAC,WAAW,SAG+C;IAEnE,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,YAAY;IAE7B,wCAAwC;IACxC,QAAQ,CAAC,cAAc,QAAQ;IAE/B,uEAAuE;IACvE,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAapC;IAEF;;OAEG;gBAC0B,KAAK,EAAE,KAAK;IAMzC;;;;;;;;;;OAUG;IACG,OAAO,CACX,IAAI,EAAE,iBAAiB,EACvB,QAAQ,EAAE,oBAAoB,GAC7B,OAAO,CAAC,mBAAmB,CAAC,kBAAkB,CAAC,CAAC;CAepD"}

package/dist/memory/io/tools/MemoryDeleteTool.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"MemoryDeleteTool.js","sourceRoot":"","sources":["../../../../src/memory/io/tools/MemoryDeleteTool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA+BH,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,gBAAgB;IAsC3B;;OAEG;IACH,YAA6B,KAAY;QAAZ,UAAK,GAAL,KAAK,CAAO;QAxCzC,uCAAuC;QAC9B,OAAE,GAAG,kBAAkB,CAAC;QAEjC,4BAA4B;QACnB,SAAI,GAAG,eAAe,CAAC;QAEhC,mCAAmC;QAC1B,gBAAW,GAAG,eAAe,CAAC;QAEvC,8BAA8B;QACrB,gBAAW,GAClB,0EAA0E;YAC1E,gFAAgF;YAChF,gEAAgE,CAAC;QAEnE,mDAAmD;QAC1C,aAAQ,GAAG,QAAQ,CAAC;QAE7B,wCAAwC;QAC/B,mBAAc,GAAG,IAAI,CAAC;QAE/B,uEAAuE;QAC9D,gBAAW,GAAqB;YACvC,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,8CAA8C;iBAC5D;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,0DAA0D;iBACxE;aACF;YACD,QAAQ,EAAE,CAAC,SAAS,CAAC;SACtB,CAAC;IAK0C,CAAC;IAE7C,8EAA8E;IAC9E,UAAU;IACV,8EAA8E;IAE9E;;;;;;;;;;OAUG;IACH,KAAK,CAAC,OAAO,CACX,IAAuB,EACvB,QAA8B;QAE9B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAC/B,oFAAoF,EACpF,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CACnC,CAAC;YAEF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE,EAAE,CAAC;QAClE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACxD,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}