@moxxy/plugin-memory 0.27.0

package/dist/embedding-cache.js

@@ -0,0 +1,146 @@
+import { createHash } from 'node:crypto';
+import { promises as fs } from 'node:fs';
+import * as path from 'node:path';
+import { writeFileAtomic } from '@moxxy/sdk/server';
+const INDEX_FILE = '.embeddings.json';
+const INDEX_VERSION = 1;
+/**
+ * Persists computed embeddings to `<memoryDir>/.embeddings.json` keyed by
+ * content hash. The cache is invalidated when the embedder name OR its
+ * dimensionality changes — a name alone is too coarse (e.g. the OpenAI embedder
+ * reports a fixed name across models/`dimensions` settings, so a 1536→3072
+ * model switch must invalidate on the dim mismatch or recall compares
+ * incomparable vectors).
+ */
+export class EmbeddingIndex {
+    dir;
+    embedderName;
+    dim;
+    cache = new Map();
+    dirty = false;
+    loaded = false;
+    constructor(dir, embedderName, dim) {
+        this.dir = dir;
+        this.embedderName = embedderName;
+        this.dim = dim;
+    }
+    static hash(text) {
+        return createHash('sha256').update(text).digest('hex').slice(0, 24);
+    }
+    get filePath() {
+        return path.join(this.dir, INDEX_FILE);
+    }
+    async load() {
+        // Read the on-disk cache at most once per instance. The store memoizes this
+        // index for its lifetime and is the single writer (flush() keeps disk in
+        // sync for our own writes), so re-reading + re-parsing the whole file on
+        // every recall is pure overhead — the in-memory Map is already authoritative.
+        if (this.loaded)
+            return;
+        let raw;
+        try {
+            raw = await fs.readFile(this.filePath, 'utf8');
+        }
+        catch (err) {
+            if (!isEnoent(err))
+                throw err;
+            // No file on disk yet — still treat as loaded so subsequent recalls don't
+            // re-stat. This process is the single writer; flush() creates the file.
+            this.loaded = true;
+            return;
+        }
+        // The cache is a pure optimization: a corrupt/garbled/half-synced file
+        // (truncated JSON, manual edit, partial cloud-drive sync, schema drift) must
+        // degrade to a COLD cache, never permanently break every recall. Parse and
+        // shape-check defensively; on any failure, log and start empty.
+        this.loaded = true;
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch (err) {
+            console.warn(`[plugin-memory] ignoring corrupt embedding cache (${this.filePath}): ${String(err)}`);
+            return;
+        }
+        if (!isValidIndexFile(parsed))
+            return; // malformed shape → cold cache
+        if (parsed.version !== INDEX_VERSION)
+            return; // unknown format, ignore
+        if (parsed.embedder !== this.embedderName)
+            return; // embedder changed, invalidate
+        // Dim mismatch (incl. an old file written before dim was tracked) → the
+        // vectors are a different dimensionality; invalidate rather than mix them.
+        if (this.dim !== undefined && parsed.dim !== this.dim)
+            return;
+        for (const [name, entry] of Object.entries(parsed.entries)) {
+            if (isValidIndexEntry(entry))
+                this.cache.set(name, entry);
+        }
+    }
+    /**
+     * For a `(name, body)` pair, return either the cached vector (if the body
+     * hash matches) or `null` (miss). Callers re-embed the misses and call
+     * `set()` with the fresh vectors.
+     */
+    lookup(name, body) {
+        const entry = this.cache.get(name);
+        if (!entry)
+            return null;
+        if (entry.hash !== EmbeddingIndex.hash(body))
+            return null;
+        return entry.vector;
+    }
+    set(name, body, vector) {
+        const hash = EmbeddingIndex.hash(body);
+        const existing = this.cache.get(name);
+        if (existing && existing.hash === hash)
+            return;
+        this.cache.set(name, { hash, vector });
+        this.dirty = true;
+    }
+    /** Drop entries that no longer correspond to existing memories. */
+    prune(currentNames) {
+        const wanted = new Set(currentNames);
+        for (const name of [...this.cache.keys()]) {
+            if (!wanted.has(name)) {
+                this.cache.delete(name);
+                this.dirty = true;
+            }
+        }
+    }
+    async flush() {
+        if (!this.dirty)
+            return;
+        const data = {
+            version: INDEX_VERSION,
+            embedder: this.embedderName,
+            ...(this.dim !== undefined ? { dim: this.dim } : {}),
+            entries: Object.fromEntries(this.cache),
+        };
+        await writeFileAtomic(this.filePath, JSON.stringify(data), { mode: 0o600 });
+        this.dirty = false;
+    }
+    get size() {
+        return this.cache.size;
+    }
+}
+function isEnoent(err) {
+    return err instanceof Error && 'code' in err && err.code === 'ENOENT';
+}
+/** Structural guard so a valid-JSON-but-wrong-shape file (e.g. a missing
+ *  `entries`) degrades to a cold cache instead of throwing in load(). */
+function isValidIndexFile(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const v = value;
+    return typeof v.entries === 'object' && v.entries !== null;
+}
+function isValidIndexEntry(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const e = value;
+    return (typeof e.hash === 'string' &&
+        Array.isArray(e.vector) &&
+        e.vector.every((n) => typeof n === 'number'));
+}
+//# sourceMappingURL=embedding-cache.js.map

package/dist/embedding-cache.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+import { type Plugin } from '@moxxy/sdk';
+import { MemoryStore, type MemoryStoreOptions } from './store.js';
+export { MemoryStore, memoryTypeSchema, memoryFrontmatterSchema, defaultMemoryDir, type MemoryEntry, type MemoryFrontmatter, type MemoryStoreOptions, type MemoryType, type RankedMemory, type RecallMode, } from './store.js';
+export { parseMdFile, parseFrontmatter, renderFrontmatter } from './parse.js';
+export { recentExchanges, summarizeSession, type SessionFact } from './stm.js';
+export { TfIdfEmbedder, cosineSimilarity, tokenize } from './tfidf.js';
+export { EmbeddingIndex } from './embedding-cache.js';
+export { planConsolidation, consolidateMemory, buildMemoryConsolidatePlugin, memoryConsolidatePlugin, type ConsolidatePlan, type ConsolidateOptions, type ConsolidationOutcome, } from './consolidate.js';
+export interface BuildMemoryPluginOptions extends MemoryStoreOptions {
+}
+export declare function buildMemoryPlugin(opts?: BuildMemoryPluginOptions): {
+    plugin: Plugin;
+    store: MemoryStore;
+};
+/**
+ * Discovery-loadable instance: the WHOLE memory feature (long-term store +
+ * memory_save/recall/… tools + the tfidf embedder + memory_consolidate and
+ * its nudge hooks) as ONE plugin, so the package unbundles cleanly — the
+ * loader takes a single default export per package. Composition over the
+ * existing builders:
+ *  - the store's embedder resolves LAZILY from the host-published
+ *    'embedders' registry service (captured in onInit, read on first
+ *    recall), replacing the bootstrap closure the CLI used to inject;
+ *  - our onInit registers the 'memory' service FIRST, then runs
+ *    consolidate's onInit, which resolves it — same ordering the two
+ *    separate builtin entries relied on.
+ * `buildMemoryPlugin` stays for hosts/tests that inject their own store.
+ */
+export declare const memoryPlugin: Plugin;
+export default memoryPlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+C,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AACtF,OAAO,EAAE,WAAW,EAAoB,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGpF,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,uBAAuB,EACvB,gBAAgB,EAChB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,UAAU,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,4BAA4B,EAC5B,uBAAuB,EACvB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,GAC1B,MAAM,kBAAkB,CAAC;AAG1B,MAAM,WAAW,wBAAyB,SAAQ,kBAAkB;CAAG;AAEvE,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,wBAA6B,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,CAuK7G;AAGD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,YAAY,EAAE,MA0BvB,CAAC;AAGL,eAAe,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,217 @@
+import { defineTool, defineEmbedder, definePlugin, z } from '@moxxy/sdk';
+import { MemoryStore, memoryTypeSchema } from './store.js';
+import { TfIdfEmbedder } from './tfidf.js';
+export { MemoryStore, memoryTypeSchema, memoryFrontmatterSchema, defaultMemoryDir, } from './store.js';
+export { parseMdFile, parseFrontmatter, renderFrontmatter } from './parse.js';
+export { recentExchanges, summarizeSession } from './stm.js';
+export { TfIdfEmbedder, cosineSimilarity, tokenize } from './tfidf.js';
+export { EmbeddingIndex } from './embedding-cache.js';
+export { planConsolidation, consolidateMemory, buildMemoryConsolidatePlugin, memoryConsolidatePlugin, } from './consolidate.js';
+import { memoryConsolidatePlugin as memoryConsolidatePluginRef } from './consolidate.js';
+export function buildMemoryPlugin(opts = {}) {
+    const store = new MemoryStore(opts);
+    const plugin = definePlugin({
+        name: '@moxxy/plugin-memory',
+        version: '0.0.0',
+        // Publish the long-term store on the inter-plugin service registry so the
+        // sibling @moxxy/memory-consolidate plugin can resolve it in its own onInit
+        // instead of being hand-built with the store — the seam that lets both be
+        // discovery-loaded. memory-consolidate is registered after this plugin, so
+        // this onInit runs first.
+        hooks: {
+            onInit: (ctx) => {
+                ctx.services.register('memory', store);
+            },
+        },
+        // The zero-dep TF-IDF embedder, contributed as a selectable embedder so it
+        // sits in the same registry as openai/transformers/custom ones.
+        embedders: [
+            defineEmbedder({
+                name: 'tfidf',
+                displayName: 'TF-IDF (built-in, zero-dep)',
+                createClient: () => new TfIdfEmbedder(),
+            }),
+        ],
+        tools: [
+            defineTool({
+                name: 'memory_save',
+                description: 'Persist a memory to long-term storage. Use sparingly — only for facts/preferences/' +
+                    'project context that would help you in future sessions. Keep the body terse.',
+                inputSchema: z.object({
+                    name: z.string().min(1).regex(/^[a-z0-9][a-z0-9-]*$/, 'name must be slug-like'),
+                    type: memoryTypeSchema,
+                    description: z.string().min(1).max(280),
+                    body: z.string().min(1).max(4000),
+                    tags: z.array(z.string().min(1)).optional(),
+                }),
+                permission: { action: 'prompt' },
+                isolation: {
+                    capabilities: {
+                        fs: { read: ['~/.moxxy/memory/**'], write: ['~/.moxxy/memory/**'] },
+                        net: { mode: 'none' },
+                        timeMs: 5_000,
+                    },
+                },
+                handler: async ({ name, type, description, body, tags }) => {
+                    const saved = await store.save({ name, type, description, body, tags });
+                    const cap = await store.capStatus();
+                    return {
+                        name: saved.frontmatter.name,
+                        path: saved.path,
+                        // Warn-only soft cap: the save succeeded, but tell the model the
+                        // store is overgrown so it consolidates / forgets stale entries.
+                        ...(cap.over
+                            ? {
+                                warning: `memory store holds ${cap.count} entries (soft cap ${cap.max}). ` +
+                                    `Nothing was evicted — consider consolidating related memories or using memory_forget on stale ones.`,
+                            }
+                            : {}),
+                    };
+                },
+            }),
+            defineTool({
+                name: 'memory_recall',
+                description: 'Search long-term memory by free-text query. Uses vector similarity (TF-IDF by default, ' +
+                    'or a configured EmbeddingProvider) when mode is "auto" or "vector". Returns the most ' +
+                    'relevant entries with their full bodies.',
+                inputSchema: z.object({
+                    query: z.string().min(1),
+                    limit: z.number().int().min(1).max(20).optional().default(5),
+                    type: memoryTypeSchema.optional(),
+                    mode: z.enum(['auto', 'vector', 'keyword']).optional().default('auto'),
+                }),
+                isolation: {
+                    capabilities: {
+                        fs: { read: ['~/.moxxy/memory/**'] },
+                        // Vector recall may call out to an EmbeddingProvider (OpenAI,
+                        // local transformers, …). The inproc isolator can't enforce
+                        // this; a stronger isolator should constrain to the actual
+                        // configured embedder's host.
+                        net: { mode: 'any' },
+                        timeMs: 15_000,
+                    },
+                },
+                handler: async ({ query, limit, type, mode }) => {
+                    const matches = await store.recall(query, { limit, type, mode });
+                    return matches.map(({ entry, score }) => ({
+                        name: entry.frontmatter.name,
+                        type: entry.frontmatter.type,
+                        description: entry.frontmatter.description,
+                        body: entry.body,
+                        score,
+                    }));
+                },
+            }),
+            defineTool({
+                name: 'memory_list',
+                description: 'List all stored memories (name + type + description, no body).',
+                inputSchema: z.object({ type: memoryTypeSchema.optional() }),
+                isolation: {
+                    capabilities: {
+                        fs: { read: ['~/.moxxy/memory/**'] },
+                        net: { mode: 'none' },
+                        timeMs: 5_000,
+                    },
+                },
+                handler: async ({ type }) => {
+                    const entries = await store.list(type);
+                    return entries.map((e) => ({
+                        name: e.frontmatter.name,
+                        type: e.frontmatter.type,
+                        description: e.frontmatter.description,
+                        tags: e.frontmatter.tags ?? [],
+                    }));
+                },
+            }),
+            defineTool({
+                name: 'memory_forget',
+                description: 'Delete a memory by name. Use only when the memory is incorrect or no longer relevant.',
+                // Slug-only name: the inproc isolator does NOT enforce the fs.write glob,
+                // so this Zod guard is the sole defense against a path-traversal `name`
+                // (e.g. '../../vault') reaching fs.unlink. Mirror memory_save's regex.
+                inputSchema: z.object({
+                    name: z.string().min(1).max(120).regex(/^[a-z0-9][a-z0-9-]*$/, 'name must be slug-like'),
+                }),
+                permission: { action: 'prompt' },
+                isolation: {
+                    capabilities: {
+                        fs: { read: ['~/.moxxy/memory/**'], write: ['~/.moxxy/memory/**'] },
+                        net: { mode: 'none' },
+                        timeMs: 5_000,
+                    },
+                },
+                handler: async ({ name }) => {
+                    const removed = await store.forget(name);
+                    return removed ? `forgot ${name}` : `not found: ${name}`;
+                },
+            }),
+            defineTool({
+                name: 'memory_update',
+                description: 'Update an existing memory in place. createdAt is preserved; updatedAt bumps.',
+                inputSchema: z.object({
+                    // Slug-only: see memory_forget — the schema is the only traversal guard.
+                    name: z.string().min(1).max(120).regex(/^[a-z0-9][a-z0-9-]*$/, 'name must be slug-like'),
+                    description: z.string().min(1).max(280).optional(),
+                    body: z.string().min(1).max(4000).optional(),
+                    tags: z.array(z.string().min(1)).optional(),
+                }),
+                permission: { action: 'prompt' },
+                isolation: {
+                    capabilities: {
+                        fs: { read: ['~/.moxxy/memory/**'], write: ['~/.moxxy/memory/**'] },
+                        net: { mode: 'none' },
+                        timeMs: 5_000,
+                    },
+                },
+                handler: async ({ name, description, body, tags }) => {
+                    const updated = await store.update(name, { description, body, tags });
+                    if (!updated)
+                        throw new Error(`memory '${name}' not found`);
+                    return { name: updated.frontmatter.name, updatedAt: updated.frontmatter.updatedAt };
+                },
+            }),
+        ],
+    });
+    return { plugin, store };
+}
+/**
+ * Discovery-loadable instance: the WHOLE memory feature (long-term store +
+ * memory_save/recall/… tools + the tfidf embedder + memory_consolidate and
+ * its nudge hooks) as ONE plugin, so the package unbundles cleanly — the
+ * loader takes a single default export per package. Composition over the
+ * existing builders:
+ *  - the store's embedder resolves LAZILY from the host-published
+ *    'embedders' registry service (captured in onInit, read on first
+ *    recall), replacing the bootstrap closure the CLI used to inject;
+ *  - our onInit registers the 'memory' service FIRST, then runs
+ *    consolidate's onInit, which resolves it — same ordering the two
+ *    separate builtin entries relied on.
+ * `buildMemoryPlugin` stays for hosts/tests that inject their own store.
+ */
+export const memoryPlugin = (() => {
+    let embeddersReg = null;
+    const { plugin: base } = buildMemoryPlugin({
+        // The registry hands back an EmbedderClient-compatible instance; the
+        // structural cast keeps this file free of a core import.
+        embedder: () => (embeddersReg?.tryGetActive() ?? null),
+    });
+    const consolidate = memoryConsolidatePluginRef;
+    return definePlugin({
+        name: '@moxxy/plugin-memory',
+        version: '0.0.0',
+        ...(base.embedders ? { embedders: base.embedders } : {}),
+        tools: [...(base.tools ?? []), ...(consolidate.tools ?? [])],
+        hooks: {
+            ...consolidate.hooks,
+            onInit: async (ctx) => {
+                embeddersReg =
+                    ctx.services.get('embedders') ?? null;
+                await base.hooks?.onInit?.(ctx);
+                await consolidate.hooks?.onInit?.(ctx);
+            },
+        },
+    });
+})();
+// Discovery entry: `createPluginLoader` requires a default Plugin export.
+export default memoryPlugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/parse.d.ts

@@ -0,0 +1,5 @@
+import { parseFrontmatterFile, type ParsedFrontmatter } from '@moxxy/sdk';
+export type ParsedFile = ParsedFrontmatter;
+export declare const parseMdFile: typeof parseFrontmatterFile;
+export { parseFrontmatter, renderFrontmatter } from '@moxxy/sdk';
+//# sourceMappingURL=parse.d.ts.map

package/dist/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,oBAAoB,EAAE,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE1E,MAAM,MAAM,UAAU,GAAG,iBAAiB,CAAC;AAE3C,eAAO,MAAM,WAAW,6BAAuB,CAAC;AAEhD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/dist/parse.js

@@ -0,0 +1,9 @@
+// The MD+frontmatter parser now lives canonically in @moxxy/sdk
+// (`parseFrontmatterFile`/`parseFrontmatter`/`renderFrontmatter`), shared with
+// @moxxy/core so the previously-copy-pasted copies can't diverge. This module
+// keeps the historical `parseMdFile`/`ParsedFile` names as thin re-exports.
+// (The plugin already depends on @moxxy/sdk, so this stays leaf-only.)
+import { parseFrontmatterFile } from '@moxxy/sdk';
+export const parseMdFile = parseFrontmatterFile;
+export { parseFrontmatter, renderFrontmatter } from '@moxxy/sdk';
+//# sourceMappingURL=parse.js.map

package/dist/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,+EAA+E;AAC/E,8EAA8E;AAC9E,4EAA4E;AAC5E,uEAAuE;AACvE,OAAO,EAAE,oBAAoB,EAA0B,MAAM,YAAY,CAAC;AAI1E,MAAM,CAAC,MAAM,WAAW,GAAG,oBAAoB,CAAC;AAEhD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/dist/stm.d.ts

@@ -0,0 +1,20 @@
+import type { EventLogReader } from '@moxxy/sdk';
+export interface SessionFact {
+    readonly turnId: string;
+    readonly seq: number;
+    readonly source: 'user' | 'assistant';
+    readonly text: string;
+}
+/**
+ * Short-term memory helpers. STM is the event log itself — these selectors
+ * just project a useful view over it.
+ */
+export declare function recentExchanges(log: EventLogReader, n?: number): ReadonlyArray<SessionFact>;
+export declare function summarizeSession(log: EventLogReader): {
+    turns: number;
+    toolCalls: number;
+    errors: number;
+    skillsCreated: number;
+    pluginsLoaded: number;
+};
+//# sourceMappingURL=stm.d.ts.map

package/dist/stm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stm.d.ts","sourceRoot":"","sources":["../src/stm.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AAEH,wBAAgB,eAAe,CAAC,GAAG,EAAE,cAAc,EAAE,CAAC,SAAI,GAAG,aAAa,CAAC,WAAW,CAAC,CAUtF;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,cAAc,GAAG;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB,CAeA"}

package/dist/stm.js

@@ -0,0 +1,38 @@
+/**
+ * Short-term memory helpers. STM is the event log itself — these selectors
+ * just project a useful view over it.
+ */
+export function recentExchanges(log, n = 5) {
+    const out = [];
+    for (const e of log.slice()) {
+        if (e.type === 'user_prompt') {
+            out.push({ turnId: e.turnId, seq: e.seq, source: 'user', text: e.text });
+        }
+        else if (e.type === 'assistant_message') {
+            out.push({ turnId: e.turnId, seq: e.seq, source: 'assistant', text: e.content });
+        }
+    }
+    return out.slice(-n);
+}
+export function summarizeSession(log) {
+    const seenTurns = new Set();
+    let toolCalls = 0;
+    let errors = 0;
+    let skillsCreated = 0;
+    let pluginsLoaded = 0;
+    for (const e of log.slice()) {
+        seenTurns.add(e.turnId);
+        if (e.type === 'tool_call_requested')
+            toolCalls += 1;
+        if (e.type === 'error')
+            errors += 1;
+        if (e.type === 'skill_created')
+            skillsCreated += 1;
+        if (e.type === 'plugin_registered')
+            pluginsLoaded += 1;
+        if (e.type === 'plugin_unregistered')
+            pluginsLoaded -= 1;
+    }
+    return { turns: seenTurns.size, toolCalls, errors, skillsCreated, pluginsLoaded };
+}
+//# sourceMappingURL=stm.js.map

package/dist/stm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stm.js","sourceRoot":"","sources":["../src/stm.ts"],"names":[],"mappings":"AASA;;;GAGG;AAEH,MAAM,UAAU,eAAe,CAAC,GAAmB,EAAE,CAAC,GAAG,CAAC;IACxD,MAAM,GAAG,GAAkB,EAAE,CAAC;IAC9B,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC;QAC5B,IAAI,CAAC,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YAC7B,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3E,CAAC;aAAM,IAAI,CAAC,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;YAC1C,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QACnF,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAmB;IAOlD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC;QAC5B,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACxB,IAAI,CAAC,CAAC,IAAI,KAAK,qBAAqB;YAAE,SAAS,IAAI,CAAC,CAAC;QACrD,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO;YAAE,MAAM,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,CAAC,IAAI,KAAK,eAAe;YAAE,aAAa,IAAI,CAAC,CAAC;QACnD,IAAI,CAAC,CAAC,IAAI,KAAK,mBAAmB;YAAE,aAAa,IAAI,CAAC,CAAC;QACvD,IAAI,CAAC,CAAC,IAAI,KAAK,qBAAqB;YAAE,aAAa,IAAI,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,CAAC;AACpF,CAAC"}

package/dist/store/io.d.ts

@@ -0,0 +1,13 @@
+import { type MemoryEntry, type MemoryFrontmatter, type MemoryType } from './types.js';
+export declare function safeRead(filePath: string): Promise<{
+    frontmatter: MemoryFrontmatter;
+    body: string;
+} | null>;
+export declare function isEnoent(err: unknown): boolean;
+export declare function listEntries(dir: string, filterType?: MemoryType): Promise<ReadonlyArray<MemoryEntry>>;
+export declare function readEntry(filePath: string): Promise<MemoryEntry | null>;
+/** What the MEMORY.md index needs per entry — no body, so the incremental
+ *  index cache in MemoryStore can feed it without re-reading entry files. */
+export type IndexRow = Pick<MemoryEntry, 'frontmatter' | 'path'>;
+export declare function writeIndex(dir: string, entries: ReadonlyArray<IndexRow>): Promise<void>;
+//# sourceMappingURL=io.d.ts.map

package/dist/store/io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../../src/store/io.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,UAAU,EAChB,MAAM,YAAY,CAAC;AAEpB,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,WAAW,EAAE,iBAAiB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAelE;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAE9C;AAWD,wBAAsB,WAAW,CAC/B,GAAG,EAAE,MAAM,EACX,UAAU,CAAC,EAAE,UAAU,GACtB,OAAO,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,CAmDrC;AAED,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAW7E;AAED;6EAC6E;AAC7E,MAAM,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,aAAa,GAAG,MAAM,CAAC,CAAC;AAEjE,wBAAsB,UAAU,CAC9B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAC,GAC/B,OAAO,CAAC,IAAI,CAAC,CAkBf"}