@devxiyang/agent-memo 0.0.1

package/README.md

@@ -0,0 +1,193 @@
+# agent.memo
+
+Agent memory SDK based on a filesystem paradigm. Organizes memories, resources and skills as a hierarchical virtual filesystem with `memo://` URIs — inspired by [OpenViking](https://github.com/volcengine/OpenViking).
+
+## Concepts
+
+Every directory carries up to four meta files managed by the **caller** (typically via LLM):
+
+```
+{workspace}/user/memories/preferences/
+├── .abstract.md      # L0 ~100 tokens, one-sentence summary
+├── .overview.md      # L1 ~1-2k tokens, navigational overview
+├── .relations.json   # links to other nodes
+├── .meta.json        # arbitrary structured metadata
+└── coding.md         # L2 actual content
+```
+
+**Tiered context loading:**
+
+| Tier | Source | Cost |
+|------|--------|------|
+| 0 | `.abstract.md` | cheap, always-on |
+| 1 | `.overview.md` | medium |
+| 2 | full file content | full |
+
+**URI scheme:** `memo://path/to/node` maps directly to `{workspace}/path/to/node`.
+
+## Installation
+
+```bash
+npm install @devxiyang/agent-memo
+```
+
+> `RipgrepSearchBackend` (default) uses a bundled `rg` binary via `@vscode/ripgrep` — no manual installation needed.
+
+## Quick Start
+
+```typescript
+import { FileMemo, type Memo, type MemoLifecycle } from '@devxiyang/agent-memo'
+
+await using memo = new FileMemo({
+  workspace: '/path/to/workspace',
+  hooks: {
+    onWritten: async (uri, parentDirs) => {
+      // Called after any file write or update (SDK or external tool)
+      // Regenerate .abstract.md for affected directories
+      for (const dir of parentDirs) {
+        const abstract = await myLLM.summarize(await memo.ls(dir))
+        await memo.writeMeta(dir, { abstract })
+      }
+    },
+    onError: (err, event) => console.error(`[memo:${event}]`, err),
+  },
+})
+
+// Write content
+await memo.write('memo://user/memories/preferences/coding.md', 'Prefers TypeScript strict mode')
+
+// List directory (includes mimeType for files, abstract for subdirs)
+const nodes = await memo.ls('memo://user/memories/')
+
+// Search
+const results = await memo.search('TypeScript', {
+  scope: ['memo://user/memories/'],
+  limit: 10,
+})
+
+// Build LLM context
+const systemPrompt = await memo.context(['memo://user/memories/'], 0)  // L0, cheap
+const detail       = await memo.context(['memo://user/memories/preferences/coding.md'], 2)  // full
+```
+
+## Binary Files
+
+For binary files (images, PDFs, audio), use `toPath()` to get the physical path and write directly — the filesystem watcher picks it up automatically:
+
+```typescript
+const path = memo.toPath('memo://user/memories/photos/avatar.jpg')
+await sharp(imageBuffer).toFile(path)
+// onWrite hook fires automatically, caller generates .abstract.md via VLM
+```
+
+## API
+
+### `new FileMemo(options: FileMemoOptions)`
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `workspace` | `string` | required | Root directory |
+| `hooks` | `MemoHooks` | — | Lifecycle hooks |
+| `search` | `SearchBackend` | `RipgrepSearchBackend` | Search implementation |
+| `mime` | `MimeDetector` | `MagicMimeDetector` | MIME type detection |
+| `watch` | `boolean` | `true` | Auto-start filesystem watcher |
+
+### `Memo` interface
+
+```typescript
+// Content
+read(uri): Promise<string | null>
+write(uri, content): Promise<void>
+delete(uri): Promise<void>
+
+// Directory
+ls(uri): Promise<MemoNode[]>
+mkdir(uri): Promise<void>
+rmdir(uri, recursive?): Promise<void>
+
+// Meta (caller manages content)
+readMeta(uri): Promise<DirMeta>
+writeMeta(uri, meta): Promise<void>
+
+// Relations
+link(uri, targets, reason?): Promise<void>
+unlink(uri, target): Promise<void>
+relations(uri): Promise<Relation[]>
+
+// Search
+search(query, options?): Promise<SearchResult[]>
+
+// LLM context assembly
+context(uris, tier: 0 | 1 | 2): Promise<string>
+```
+
+### `MemoLifecycle` interface
+
+```typescript
+toPath(uri): string          // get physical path for binary access
+watch(): void                // start watcher
+unwatch(): Promise<void>     // stop watcher
+[Symbol.asyncDispose]()      // used by `await using`
+```
+
+### Hooks
+
+```typescript
+interface MemoHooks {
+  onWritten?(uri, parentDirs): void | Promise<void>
+  onDeleted?(uri, parentDirs): void | Promise<void>
+  onLinked?(uri, targets): void | Promise<void>
+  onUnlinked?(uri, target): void | Promise<void>
+  onError?(err, event): void
+}
+```
+
+All hooks are **fire-and-forget** — the SDK does not await them. Errors are forwarded to `onError`.
+
+### Search Backends
+
+```typescript
+// Default — bundled rg binary, fast
+new RipgrepSearchBackend()
+
+// Fallback — pure JS, no system dependencies
+new SimpleSearchBackend()
+```
+
+### MIME Detector
+
+```typescript
+// Default — magic bytes detection via file-type
+new MagicMimeDetector()
+
+// Custom
+class MyDetector implements MimeDetector {
+  async detect(path: string): Promise<string | undefined> { ... }
+}
+```
+
+## Filesystem Structure
+
+```
+{workspace}/
+├── user/
+│   └── memories/
+│       ├── .abstract.md
+│       ├── .overview.md
+│       ├── .relations.json
+│       ├── preferences/
+│       │   ├── .abstract.md
+│       │   └── coding.md
+│       └── photos/
+│           └── avatar.jpg
+├── agent/
+│   └── memories/
+│       ├── cases/
+│       └── patterns/
+└── session/
+    └── {session-id}/
+```
+
+## License
+
+MIT

package/dist/core/memo/constants.d.ts

@@ -0,0 +1,6 @@
+export declare const META_ABSTRACT = ".abstract.md";
+export declare const META_OVERVIEW = ".overview.md";
+export declare const META_RELATIONS = ".relations.json";
+export declare const META_META = ".meta.json";
+export declare const META_FILES: Set<string>;
+//# sourceMappingURL=constants.d.ts.map

package/dist/core/memo/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/core/memo/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,iBAAkB,CAAA;AAC5C,eAAO,MAAM,aAAa,iBAAkB,CAAA;AAC5C,eAAO,MAAM,cAAc,oBAAoB,CAAA;AAC/C,eAAO,MAAM,SAAS,eAAoB,CAAA;AAE1C,eAAO,MAAM,UAAU,aAAqE,CAAA"}

package/dist/core/memo/constants.js

@@ -0,0 +1,6 @@
+export const META_ABSTRACT = '.abstract.md';
+export const META_OVERVIEW = '.overview.md';
+export const META_RELATIONS = '.relations.json';
+export const META_META = '.meta.json';
+export const META_FILES = new Set([META_ABSTRACT, META_OVERVIEW, META_RELATIONS, META_META]);
+//# sourceMappingURL=constants.js.map

package/dist/core/memo/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/core/memo/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAI,cAAc,CAAA;AAC5C,MAAM,CAAC,MAAM,aAAa,GAAI,cAAc,CAAA;AAC5C,MAAM,CAAC,MAAM,cAAc,GAAG,iBAAiB,CAAA;AAC/C,MAAM,CAAC,MAAM,SAAS,GAAQ,YAAY,CAAA;AAE1C,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,SAAS,CAAC,CAAC,CAAA"}

package/dist/core/memo/file-fs.d.ts

@@ -0,0 +1,39 @@
+import type { Memo, MemoLifecycle, MemoUri, MemoNode, DirMeta, Relation, SearchOptions, SearchResult, FileMemoOptions } from './types.js';
+export declare class FileMemo implements Memo, MemoLifecycle {
+    private readonly options;
+    private readonly hooks;
+    private readonly backend;
+    private readonly mime;
+    private readonly index;
+    private watcher;
+    constructor(options: FileMemoOptions);
+    private get workspace();
+    private absToUri;
+    private fire;
+    private _indexFile;
+    /** Convert a memo URI to an absolute filesystem path (for binary file access). */
+    toPath(uri: MemoUri): string;
+    /**
+     * Start watching the workspace with chokidar.
+     * On startup: scans existing files to build the index (no hooks fired).
+     * Afterwards: all filesystem changes update the index and fire hooks.
+     * Meta files are excluded to prevent infinite loops.
+     */
+    watch(): void;
+    unwatch(): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
+    read(uri: MemoUri): Promise<string | null>;
+    write(uri: MemoUri, content: string): Promise<void>;
+    delete(uri: MemoUri): Promise<void>;
+    ls(uri: MemoUri): Promise<MemoNode[]>;
+    mkdir(uri: MemoUri): Promise<void>;
+    rmdir(uri: MemoUri, recursive?: boolean): Promise<void>;
+    readMeta(uri: MemoUri): Promise<DirMeta>;
+    writeMeta(uri: MemoUri, meta: Partial<DirMeta>): Promise<void>;
+    relations(uri: MemoUri): Promise<Relation[]>;
+    link(uri: MemoUri, targets: MemoUri[], reason?: string): Promise<void>;
+    unlink(uri: MemoUri, target: MemoUri): Promise<void>;
+    search(query: string, options?: SearchOptions): Promise<SearchResult[]>;
+    context(uris: MemoUri[], tier: 0 | 1 | 2): Promise<string>;
+}
+//# sourceMappingURL=file-fs.d.ts.map

package/dist/core/memo/file-fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-fs.d.ts","sourceRoot":"","sources":["../../../src/core/memo/file-fs.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,IAAI,EACJ,aAAa,EACb,OAAO,EACP,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,aAAa,EACb,YAAY,EAKZ,eAAe,EAChB,MAAM,YAAY,CAAA;AA+BnB,qBAAa,QAAS,YAAW,IAAI,EAAE,aAAa;IAOtC,OAAO,CAAC,QAAQ,CAAC,OAAO;IANpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAiB;IACtC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuC;IAC7D,OAAO,CAAC,OAAO,CAAkC;gBAEpB,OAAO,EAAE,eAAe;IAWrD,OAAO,KAAK,SAAS,GAAoC;IAEzD,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,IAAI;YAME,UAAU;IAUxB,kFAAkF;IAClF,MAAM,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM;IAI5B;;;;;OAKG;IACH,KAAK,IAAI,IAAI;IAiDP,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAMxB,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtC,IAAI,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAQ1C,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASnD,MAAM,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IASnC,EAAE,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAiCrC,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlC,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAMrD,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAcxC,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB9D,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAS5C,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBtE,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAapD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAMvE,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;CAqBjE"}

package/dist/core/memo/file-fs.js

@@ -0,0 +1,259 @@
+import { readFile, writeFile, mkdir, rm, readdir, stat } from 'node:fs/promises';
+import { join, dirname, basename } from 'node:path';
+import { randomUUID } from 'node:crypto';
+import chokidar from 'chokidar';
+import { META_ABSTRACT, META_OVERVIEW, META_RELATIONS, META_META, META_FILES } from './constants.js';
+import { RipgrepSearchBackend } from './search/index.js';
+import { MagicMimeDetector } from './mime.js';
+// ─── URI helpers ──────────────────────────────────────────────────────────────
+function uriToRel(uri) {
+    if (!uri.startsWith('memo://'))
+        throw new Error(`Invalid memo URI: "${uri}"`);
+    return uri.slice('memo://'.length);
+}
+function parentDirs(uri) {
+    const parts = uriToRel(uri).split('/').filter(Boolean);
+    const dirs = [];
+    for (let i = parts.length - 1; i > 0; i--) {
+        dirs.push(`memo://${parts.slice(0, i).join('/')}`);
+    }
+    return dirs;
+}
+// ─── FileMemo ───────────────────────────────────────────────────────────────
+export class FileMemo {
+    options;
+    hooks;
+    backend;
+    mime;
+    index = new Map();
+    watcher = null;
+    constructor(options) {
+        this.options = options;
+        this.hooks = options.hooks ?? {};
+        this.backend = options.search ?? new RipgrepSearchBackend();
+        this.mime = options.mime ?? new MagicMimeDetector();
+        this.backend.init(options.workspace);
+        if (options.watch !== false)
+            this.watch();
+    }
+    // ── Internal helpers ───────────────────────────────────────────────────────
+    get workspace() { return this.options.workspace; }
+    absToUri(absPath) {
+        const rel = absPath.slice(this.workspace.length).replace(/^[/\\]/, '');
+        return `memo://${rel}`;
+    }
+    fire(result, event) {
+        if (result instanceof Promise) {
+            result.catch(err => this.hooks.onError?.(err, event));
+        }
+    }
+    async _indexFile(absPath) {
+        const [s, mimeType] = await Promise.all([
+            stat(absPath).catch(() => null),
+            this.mime.detect(absPath).catch(() => undefined),
+        ]);
+        return { mimeType, size: s?.size ?? 0, modTime: s?.mtimeMs ?? 0 };
+    }
+    // ── MemoLifecycle ────────────────────────────────────────────────────────
+    /** Convert a memo URI to an absolute filesystem path (for binary file access). */
+    toPath(uri) {
+        return join(this.workspace, uriToRel(uri));
+    }
+    /**
+     * Start watching the workspace with chokidar.
+     * On startup: scans existing files to build the index (no hooks fired).
+     * Afterwards: all filesystem changes update the index and fire hooks.
+     * Meta files are excluded to prevent infinite loops.
+     */
+    watch() {
+        if (this.watcher)
+            return;
+        let ready = false;
+        this.watcher = chokidar.watch(this.workspace, {
+            ignoreInitial: false,
+            ignored: (p) => META_FILES.has(basename(p)),
+        });
+        this.watcher.on('add', async (p) => {
+            const entry = await this._indexFile(p);
+            this.index.set(p, entry);
+            if (ready) {
+                const uri = this.absToUri(p);
+                this.fire(this.hooks.onWritten?.(uri, parentDirs(uri)), 'write');
+            }
+        });
+        this.watcher.on('change', async (p) => {
+            const entry = await this._indexFile(p);
+            this.index.set(p, entry);
+            if (ready) {
+                const uri = this.absToUri(p);
+                this.fire(this.hooks.onWritten?.(uri, parentDirs(uri)), 'write');
+            }
+        });
+        this.watcher.on('unlink', (p) => {
+            this.index.delete(p);
+            if (ready) {
+                const uri = this.absToUri(p);
+                this.fire(this.hooks.onDeleted?.(uri, parentDirs(uri)), 'delete');
+            }
+        });
+        this.watcher.on('unlinkDir', (p) => {
+            for (const key of this.index.keys()) {
+                if (key.startsWith(p))
+                    this.index.delete(key);
+            }
+            if (ready) {
+                const uri = this.absToUri(p);
+                this.fire(this.hooks.onDeleted?.(uri, parentDirs(uri)), 'delete');
+            }
+        });
+        this.watcher.on('ready', () => { ready = true; });
+    }
+    async unwatch() {
+        await this.watcher?.close();
+        this.watcher = null;
+        this.index.clear();
+    }
+    async [Symbol.asyncDispose]() {
+        await this.unwatch();
+    }
+    // ── Content files ──────────────────────────────────────────────────────────
+    async read(uri) {
+        try {
+            return await readFile(this.toPath(uri), 'utf-8');
+        }
+        catch {
+            return null;
+        }
+    }
+    async write(uri, content) {
+        const p = this.toPath(uri);
+        await mkdir(dirname(p), { recursive: true });
+        await writeFile(p, content, 'utf-8');
+        if (!this.watcher) {
+            this.fire(this.hooks.onWritten?.(uri, parentDirs(uri)), 'write');
+        }
+    }
+    async delete(uri) {
+        await rm(this.toPath(uri), { force: true });
+        if (!this.watcher) {
+            this.fire(this.hooks.onDeleted?.(uri, parentDirs(uri)), 'delete');
+        }
+    }
+    // ── Directory ──────────────────────────────────────────────────────────────
+    async ls(uri) {
+        const p = this.toPath(uri);
+        let entries;
+        try {
+            entries = await readdir(p, { withFileTypes: true, encoding: 'utf8' });
+        }
+        catch {
+            return [];
+        }
+        return Promise.all(entries
+            .filter(e => !META_FILES.has(e.name))
+            .map(async (e) => {
+            const childPath = join(p, e.name);
+            const isDir = e.isDirectory();
+            const indexed = !isDir ? this.index.get(childPath) : undefined;
+            const s = indexed ? null : await stat(childPath).catch(() => null);
+            return {
+                uri: this.absToUri(childPath),
+                name: e.name,
+                isDir,
+                size: indexed?.size ?? s?.size ?? 0,
+                modTime: indexed?.modTime ?? s?.mtimeMs ?? 0,
+                mimeType: indexed?.mimeType,
+                abstract: isDir
+                    ? await readFile(join(childPath, META_ABSTRACT), 'utf-8').catch(() => undefined)
+                    : undefined,
+            };
+        }));
+    }
+    async mkdir(uri) {
+        await mkdir(this.toPath(uri), { recursive: true });
+    }
+    async rmdir(uri, recursive = false) {
+        await rm(this.toPath(uri), { recursive, force: true });
+    }
+    // ── Meta ───────────────────────────────────────────────────────────────────
+    async readMeta(uri) {
+        const p = this.toPath(uri);
+        const [abstract, overview, metaRaw] = await Promise.all([
+            readFile(join(p, META_ABSTRACT), 'utf-8').catch(() => undefined),
+            readFile(join(p, META_OVERVIEW), 'utf-8').catch(() => undefined),
+            readFile(join(p, META_META), 'utf-8').catch(() => undefined),
+        ]);
+        return {
+            abstract,
+            overview,
+            meta: metaRaw ? JSON.parse(metaRaw) : undefined,
+        };
+    }
+    async writeMeta(uri, meta) {
+        const p = this.toPath(uri);
+        await mkdir(p, { recursive: true });
+        const writes = [];
+        if (meta.abstract !== undefined)
+            writes.push(writeFile(join(p, META_ABSTRACT), meta.abstract, 'utf-8'));
+        if (meta.overview !== undefined)
+            writes.push(writeFile(join(p, META_OVERVIEW), meta.overview, 'utf-8'));
+        if (meta.meta !== undefined)
+            writes.push(writeFile(join(p, META_META), JSON.stringify(meta.meta, null, 2), 'utf-8'));
+        await Promise.all(writes);
+    }
+    // ── Relations ──────────────────────────────────────────────────────────────
+    async relations(uri) {
+        try {
+            const raw = await readFile(join(this.toPath(uri), META_RELATIONS), 'utf-8');
+            return JSON.parse(raw);
+        }
+        catch {
+            return [];
+        }
+    }
+    async link(uri, targets, reason) {
+        const p = this.toPath(uri);
+        await mkdir(p, { recursive: true });
+        const existing = await this.relations(uri);
+        existing.push({
+            id: randomUUID(),
+            uris: [uri, ...targets],
+            reason,
+            createdAt: new Date().toISOString(),
+        });
+        await writeFile(join(p, META_RELATIONS), JSON.stringify(existing, null, 2), 'utf-8');
+        if (!this.watcher) {
+            this.fire(this.hooks.onLinked?.(uri, targets), 'link');
+        }
+    }
+    async unlink(uri, target) {
+        const existing = await this.relations(uri);
+        const filtered = existing.filter(r => !r.uris.includes(target));
+        await writeFile(join(this.toPath(uri), META_RELATIONS), JSON.stringify(filtered, null, 2), 'utf-8');
+        this.fire(this.hooks.onUnlinked?.(uri, target), 'unlink');
+    }
+    // ── Search ─────────────────────────────────────────────────────────────────
+    async search(query, options) {
+        return this.backend.search(query, options);
+    }
+    // ── Context assembly ───────────────────────────────────────────────────────
+    async context(uris, tier) {
+        const parts = await Promise.all(uris.map(async (uri) => {
+            let body;
+            if (tier === 0) {
+                const m = await this.readMeta(uri);
+                body = m.abstract;
+            }
+            else if (tier === 1) {
+                const m = await this.readMeta(uri);
+                body = m.overview ?? m.abstract;
+            }
+            else {
+                body = (await this.read(uri)) ?? undefined;
+            }
+            return body ? `## ${uri}\n\n${body}` : null;
+        }));
+        return parts.filter(Boolean).join('\n\n---\n\n');
+    }
+}
+//# sourceMappingURL=file-fs.js.map

package/dist/core/memo/file-fs.js.map

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

package/dist/core/memo/index.d.ts

@@ -0,0 +1,7 @@
+export * from './types.js';
+export * from './constants.js';
+export { FileMemo } from './file-fs.js';
+export { MagicMimeDetector } from './mime.js';
+export { SimpleSearchBackend } from './search/text.js';
+export { RipgrepSearchBackend } from './search/ripgrep.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/memo/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/memo/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,OAAO,EAAE,QAAQ,EAAE,MAAe,cAAc,CAAA;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAQ,WAAW,CAAA;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/core/memo/index.js

@@ -0,0 +1,7 @@
+export * from './types.js';
+export * from './constants.js';
+export { FileMemo } from './file-fs.js';
+export { MagicMimeDetector } from './mime.js';
+export { SimpleSearchBackend } from './search/text.js';
+export { RipgrepSearchBackend } from './search/ripgrep.js';
+//# sourceMappingURL=index.js.map

package/dist/core/memo/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/memo/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,OAAO,EAAE,QAAQ,EAAE,MAAe,cAAc,CAAA;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAQ,WAAW,CAAA;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/core/memo/memo.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=memo.d.ts.map

package/dist/core/memo/memo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memo.d.ts","sourceRoot":"","sources":["../../../src/core/memo/memo.ts"],"names":[],"mappings":""}

package/dist/core/memo/memo.js

@@ -0,0 +1,3 @@
+"use strict";
+// Superseded by FileMemoFS in ./file-fs.ts
+//# sourceMappingURL=memo.js.map

package/dist/core/memo/memo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memo.js","sourceRoot":"","sources":["../../../src/core/memo/memo.ts"],"names":[],"mappings":";AAAA,2CAA2C"}

package/dist/core/memo/mime.d.ts

@@ -0,0 +1,10 @@
+import type { MimeDetector } from './types.js';
+/**
+ * MIME type detector based on magic bytes (file-type).
+ * More accurate than extension-based detection since it reads the file header.
+ * Returns undefined for plain text files or unrecognised formats.
+ */
+export declare class MagicMimeDetector implements MimeDetector {
+    detect(path: string): Promise<string | undefined>;
+}
+//# sourceMappingURL=mime.d.ts.map

package/dist/core/memo/mime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mime.d.ts","sourceRoot":"","sources":["../../../src/core/memo/mime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C;;;;GAIG;AACH,qBAAa,iBAAkB,YAAW,YAAY;IAC9C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;CAIxD"}

package/dist/core/memo/mime.js

@@ -0,0 +1,13 @@
+import { fileTypeFromFile } from 'file-type';
+/**
+ * MIME type detector based on magic bytes (file-type).
+ * More accurate than extension-based detection since it reads the file header.
+ * Returns undefined for plain text files or unrecognised formats.
+ */
+export class MagicMimeDetector {
+    async detect(path) {
+        const result = await fileTypeFromFile(path);
+        return result?.mime;
+    }
+}
+//# sourceMappingURL=mime.js.map

package/dist/core/memo/mime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mime.js","sourceRoot":"","sources":["../../../src/core/memo/mime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAG5C;;;;GAIG;AACH,MAAM,OAAO,iBAAiB;IAC5B,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAA;QAC3C,OAAO,MAAM,EAAE,IAAI,CAAA;IACrB,CAAC;CACF"}

package/dist/core/memo/search/index.d.ts

@@ -0,0 +1,3 @@
+export { SimpleSearchBackend } from './text.js';
+export { RipgrepSearchBackend } from './ripgrep.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/memo/search/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/memo/search/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAS,WAAW,CAAA;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA"}

package/dist/core/memo/search/index.js

@@ -0,0 +1,3 @@
+export { SimpleSearchBackend } from './text.js';
+export { RipgrepSearchBackend } from './ripgrep.js';
+//# sourceMappingURL=index.js.map

package/dist/core/memo/search/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/memo/search/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAS,WAAW,CAAA;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA"}

package/dist/core/memo/search/ripgrep.d.ts

@@ -0,0 +1,11 @@
+import type { SearchBackend, SearchOptions, SearchResult } from '../types.js';
+export declare class RipgrepSearchBackend implements SearchBackend {
+    private readonly rgBin;
+    private workspace;
+    constructor(rgBin?: string);
+    init(workspace: string): void;
+    search(query: string, options?: SearchOptions): Promise<SearchResult[]>;
+    private _toPath;
+    private _toUri;
+}
+//# sourceMappingURL=ripgrep.d.ts.map

package/dist/core/memo/search/ripgrep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ripgrep.d.ts","sourceRoot":"","sources":["../../../../src/core/memo/search/ripgrep.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAW,MAAM,aAAa,CAAA;AActF,qBAAa,oBAAqB,YAAW,aAAa;IAG5C,OAAO,CAAC,QAAQ,CAAC,KAAK;IAFlC,OAAO,CAAC,SAAS,CAAK;gBAEO,KAAK,SAAS;IAE3C,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIvB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAkD7E,OAAO,CAAC,OAAO;IAKf,OAAO,CAAC,MAAM;CAIf"}

package/dist/core/memo/search/ripgrep.js

@@ -0,0 +1,71 @@
+import { spawn } from 'node:child_process';
+import { join } from 'node:path';
+import { rgPath } from '@vscode/ripgrep';
+import { META_FILES } from '../constants.js';
+export class RipgrepSearchBackend {
+    rgBin;
+    workspace = '';
+    constructor(rgBin = rgPath) {
+        this.rgBin = rgBin;
+    }
+    init(workspace) {
+        this.workspace = workspace;
+    }
+    async search(query, options) {
+        const limit = options?.limit ?? 20;
+        const paths = options?.scope?.map(u => this._toPath(u)) ?? [this.workspace];
+        const args = [
+            query,
+            ...paths,
+            '--json',
+            '--max-count', '1',
+            ...[...META_FILES].flatMap(f => ['--glob', `!${f}`]),
+        ];
+        return new Promise((resolve, reject) => {
+            const child = spawn(this.rgBin, args);
+            const results = [];
+            let buffer = '';
+            child.stderr.resume(); // drain stderr to prevent buffer blocking
+            child.stdout.on('data', (chunk) => {
+                buffer += chunk.toString('utf-8');
+                const lines = buffer.split('\n');
+                buffer = lines.pop() ?? '';
+                for (const line of lines) {
+                    if (!line.trim() || results.length >= limit)
+                        continue;
+                    try {
+                        const msg = JSON.parse(line);
+                        if (msg.type !== 'match')
+                            continue;
+                        results.push({
+                            uri: this._toUri(msg.data.path.text),
+                            snippet: msg.data.lines.text.trim(),
+                        });
+                    }
+                    catch { /* skip malformed lines */ }
+                }
+                if (results.length >= limit)
+                    child.kill();
+            });
+            child.on('close', () => resolve(results));
+            child.on('error', err => {
+                if (err.code === 'ENOENT') {
+                    reject(new Error(`ripgrep binary not found: "${this.rgBin}". Try reinstalling @vscode/ripgrep.`));
+                }
+                else {
+                    reject(err);
+                }
+            });
+        });
+    }
+    _toPath(uri) {
+        if (!uri.startsWith('memo://'))
+            throw new Error(`Invalid memo URI: "${uri}"`);
+        return join(this.workspace, uri.slice('memo://'.length));
+    }
+    _toUri(absPath) {
+        const rel = absPath.slice(this.workspace.length).replace(/^[/\\]/, '');
+        return `memo://${rel}`;
+    }
+}
+//# sourceMappingURL=ripgrep.js.map

package/dist/core/memo/search/ripgrep.js.map

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

package/dist/core/memo/search/text.d.ts

@@ -0,0 +1,10 @@
+import type { SearchBackend, SearchOptions, SearchResult } from '../types.js';
+export declare class SimpleSearchBackend implements SearchBackend {
+    private workspace;
+    init(workspace: string): void;
+    search(query: string, options?: SearchOptions): Promise<SearchResult[]>;
+    private _searchDir;
+    private _toPath;
+    private _toUri;
+}
+//# sourceMappingURL=text.d.ts.map

package/dist/core/memo/search/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../../src/core/memo/search/text.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAW,MAAM,aAAa,CAAA;AAGtF,qBAAa,mBAAoB,YAAW,aAAa;IACvD,OAAO,CAAC,SAAS,CAAK;IAEtB,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIvB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;YAY/D,UAAU;IAoCxB,OAAO,CAAC,OAAO;IAKf,OAAO,CAAC,MAAM;CAIf"}

package/dist/core/memo/search/text.js

@@ -0,0 +1,63 @@
+import { readFile, readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { META_FILES } from '../constants.js';
+export class SimpleSearchBackend {
+    workspace = '';
+    init(workspace) {
+        this.workspace = workspace;
+    }
+    async search(query, options) {
+        const limit = options?.limit ?? 20;
+        const roots = options?.scope?.map(u => this._toPath(u)) ?? [this.workspace];
+        const results = [];
+        for (const root of roots) {
+            await this._searchDir(root, query, results, limit);
+            if (results.length >= limit)
+                break;
+        }
+        return results;
+    }
+    async _searchDir(dir, query, results, limit) {
+        if (results.length >= limit)
+            return;
+        let entries;
+        try {
+            entries = await readdir(dir, { withFileTypes: true, encoding: 'utf8' });
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            if (results.length >= limit)
+                return;
+            const childPath = join(dir, e.name);
+            if (e.isDirectory()) {
+                await this._searchDir(childPath, query, results, limit);
+            }
+            else if (!META_FILES.has(e.name)) {
+                try {
+                    const content = await readFile(childPath, 'utf-8');
+                    const idx = content.toLowerCase().indexOf(query.toLowerCase());
+                    if (idx === -1)
+                        continue;
+                    const start = Math.max(0, idx - 60);
+                    const end = Math.min(content.length, idx + query.length + 60);
+                    results.push({ uri: this._toUri(childPath), snippet: content.slice(start, end) });
+                }
+                catch {
+                    // skip binary / unreadable files
+                }
+            }
+        }
+    }
+    _toPath(uri) {
+        if (!uri.startsWith('memo://'))
+            throw new Error(`Invalid memo URI: "${uri}"`);
+        return join(this.workspace, uri.slice('memo://'.length));
+    }
+    _toUri(absPath) {
+        const rel = absPath.slice(this.workspace.length).replace(/^[/\\]/, '');
+        return `memo://${rel}`;
+    }
+}
+//# sourceMappingURL=text.js.map

package/dist/core/memo/search/text.js.map

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

package/dist/core/memo/types.d.ts

@@ -0,0 +1,113 @@
+/** memo://user/memories/preferences/coding */
+export type MemoUri = string;
+export type MemoNode = {
+    uri: MemoUri;
+    name: string;
+    isDir: boolean;
+    size: number;
+    modTime: number;
+    mimeType?: string;
+    abstract?: string;
+};
+/**
+ * Every directory can carry three meta files:
+ *  - .abstract.md   L0 ~100 tokens, one-sentence summary
+ *  - .overview.md   L1 ~1-2k tokens, navigational overview
+ *  - .meta.json     arbitrary structured metadata
+ *
+ * Content is always written by the caller; the SDK only stores and retrieves.
+ */
+export type DirMeta = {
+    abstract?: string;
+    overview?: string;
+    meta?: Record<string, unknown>;
+};
+export type Relation = {
+    id: string;
+    uris: MemoUri[];
+    reason?: string;
+    createdAt: string;
+};
+export interface MimeDetector {
+    detect(path: string): Promise<string | undefined>;
+}
+export type SearchOptions = {
+    /** Scope search to these directory URIs. Defaults to entire workspace. */
+    scope?: MemoUri[];
+    limit?: number;
+};
+export type SearchResult = {
+    uri: MemoUri;
+    snippet: string;
+};
+export interface SearchBackend {
+    /** Called by FileMemo after construction to provide the workspace path. */
+    init(workspace: string): void;
+    search(query: string, options?: SearchOptions): Promise<SearchResult[]>;
+}
+export type HookEvent = 'write' | 'delete' | 'link' | 'unlink';
+/**
+ * All hooks are fire-and-forget: the SDK does not await them.
+ * Promise rejections are forwarded to `onError` if provided.
+ */
+export interface MemoHooks {
+    /** Called after a content file is written or created. `parentDirs` lists all ancestor directory URIs. */
+    onWritten?: (uri: MemoUri, parentDirs: MemoUri[]) => void | Promise<void>;
+    /** Called after a content file or directory is deleted. */
+    onDeleted?: (uri: MemoUri, parentDirs: MemoUri[]) => void | Promise<void>;
+    /** Called after a relation is created. */
+    onLinked?: (uri: MemoUri, targets: MemoUri[]) => void | Promise<void>;
+    /** Called after a relation is removed. */
+    onUnlinked?: (uri: MemoUri, target: MemoUri) => void | Promise<void>;
+    /** Catches errors thrown inside any hook. */
+    onError?: (err: unknown, event: HookEvent) => void;
+}
+export interface FileMemoOptions {
+    workspace: string;
+    hooks?: MemoHooks;
+    /** Search backend. Defaults to RipgrepSearchBackend. */
+    search?: SearchBackend;
+    /** MIME type detector. Defaults to MagicMimeDetector (magic bytes). */
+    mime?: MimeDetector;
+    /**
+     * Auto-start filesystem watcher on construction. Default: true.
+     * When enabled, hooks fire for ALL filesystem changes and the in-memory
+     * index is kept up-to-date automatically.
+     */
+    watch?: boolean;
+}
+/**
+ * Optional lifecycle interface for implementations that support filesystem
+ * watching and direct path access. Separate from Memo so that consumers
+ * can depend only on the storage primitives they need.
+ */
+export interface MemoLifecycle extends AsyncDisposable {
+    /** Convert a memo URI to an absolute filesystem path (for binary file access). */
+    toPath(uri: MemoUri): string;
+    /** Start watching the workspace; hooks fire for all filesystem changes. */
+    watch(): void;
+    /** Stop watching and release resources. */
+    unwatch(): Promise<void>;
+}
+export interface Memo {
+    read(uri: MemoUri): Promise<string | null>;
+    write(uri: MemoUri, content: string): Promise<void>;
+    delete(uri: MemoUri): Promise<void>;
+    ls(uri: MemoUri): Promise<MemoNode[]>;
+    mkdir(uri: MemoUri): Promise<void>;
+    rmdir(uri: MemoUri, recursive?: boolean): Promise<void>;
+    readMeta(uri: MemoUri): Promise<DirMeta>;
+    writeMeta(uri: MemoUri, meta: Partial<DirMeta>): Promise<void>;
+    link(uri: MemoUri, targets: MemoUri[], reason?: string): Promise<void>;
+    unlink(uri: MemoUri, target: MemoUri): Promise<void>;
+    relations(uri: MemoUri): Promise<Relation[]>;
+    search(query: string, options?: SearchOptions): Promise<SearchResult[]>;
+    /**
+     * Build a context string from a list of URIs at the given tier.
+     *  tier 0 → .abstract.md (L0)
+     *  tier 1 → .overview.md (L1), falls back to .abstract.md
+     *  tier 2 → full file content (L2)
+     */
+    context(uris: MemoUri[], tier: 0 | 1 | 2): Promise<string>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/memo/types.d.ts.map

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

package/dist/core/memo/types.js

@@ -0,0 +1,3 @@
+// ─── URI ──────────────────────────────────────────────────────────────────────
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/memo/types.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './core/memo/index.js';
+//# 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,cAAc,sBAAsB,CAAA"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from './core/memo/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAA"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@devxiyang/agent-memo",
+  "version": "0.0.1",
+  "description": "Agent memory and memo SDK",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/devxiyang/agent.memo.git"
+  },
+  "keywords": [
+    "agent",
+    "memory",
+    "memo",
+    "llm",
+    "typescript"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./memo": {
+      "types": "./dist/core/memo/index.d.ts",
+      "import": "./dist/core/memo/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "devDependencies": {
+    "@types/node": "^24.11.0",
+    "typescript": "^5.8.0",
+    "vitest": "^4.0.18"
+  },
+  "dependencies": {
+    "@vscode/ripgrep": ">=1.17.0",
+    "chokidar": ">=5.0.0",
+    "file-type": ">=21.0.0"
+  }
+}