@framers/agentos 0.1.104 → 0.1.106

package/dist/memory/integration/StandaloneMemoryBridge.js

@@ -0,0 +1,398 @@
+/**
+ * @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 recallOptions = {
+                    limit: getScopeLimit(target, input, resolvedOptions),
+                    scope: target.memoryScope,
+                    scopeId: target.scopeId,
+                };
+                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 sections = [];
+            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);
+                    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,
+            };
+        },
+    };
+}
+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/integration/StandaloneMemoryBridge.js.map

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

package/dist/memory/io/CsvImporter.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @fileoverview CSV importer for AgentOS memory brain.
+ *
+ * Imports flat CSV files into a target `SqliteBrain`. A header row is
+ * required and must include a `content` column. Optional columns map onto
+ * `memory_traces` fields when present.
+ *
+ * Supported optional columns:
+ * - `id`
+ * - `type`
+ * - `scope`
+ * - `strength`
+ * - `created_at` / `createdAt`
+ * - `last_accessed`
+ * - `retrieval_count`
+ * - `deleted`
+ * - `tags` (JSON array, comma-separated, or pipe-separated)
+ * - `metadata` (JSON object)
+ *
+ * Deduplication uses SHA-256 of the `content` field and stores the hash in
+ * `metadata.import_hash`.
+ *
+ * @module memory/io/CsvImporter
+ */
+import type { ImportResult } from '../facade/types.js';
+import type { SqliteBrain } from '../store/SqliteBrain.js';
+/**
+ * Imports a flat CSV file into a `SqliteBrain`.
+ */
+export declare class CsvImporter {
+    private readonly brain;
+    constructor(brain: SqliteBrain);
+    /**
+     * Read, parse, and import a CSV file.
+     *
+     * @param sourcePath - Absolute or relative path to the CSV file.
+     * @returns Import summary with imported/skipped/error counts.
+     */
+    import(sourcePath: string): Promise<ImportResult>;
+    private _sha256;
+    private _readCell;
+    private _toNumber;
+    private _toInteger;
+    private _parseTags;
+    /**
+     * Small RFC4180-ish CSV parser that supports quoted fields, escaped quotes,
+     * and embedded newlines inside quoted cells.
+     */
+    private _parseCsv;
+}
+//# sourceMappingURL=CsvImporter.d.ts.map

package/dist/memory/io/CsvImporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CsvImporter.d.ts","sourceRoot":"","sources":["../../../src/memory/io/CsvImporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D;;GAEG;AACH,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,WAAW;IAE/C;;;;;OAKG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IA+GvD,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,UAAU;IAsBlB;;;OAGG;IACH,OAAO,CAAC,SAAS;CAsElB"}