@devxiyang/agent-memo 0.0.2 → 0.0.3

package/README.md

@@ -8,26 +8,44 @@ Agent memory SDK based on a filesystem paradigm. Organizes memories, resources a
 
 ## Concepts
 
-Every directory carries up to four meta files managed by the **caller** (typically via LLM):
+### Why a filesystem paradigm?
+
+AI agents need persistent memory that is inspectable, portable, and tool-friendly. A local filesystem satisfies all three: you can open any file in your editor, grep across memories, back them up with git, and pass paths directly to external tools (PDF parsers, image processors, embedding pipelines). The SDK adds structure on top — a URI scheme, tiered summaries, relations, and search — without hiding the files from you.
+
+### URI scheme
+
+`memo://` URIs map 1:1 to physical paths:
 
 ```
-{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
+memo://user/preferences/coding.md  →  {workspace}/user/preferences/coding.md
+memo://resources/api-docs.md       →  {workspace}/resources/api-docs.md
 ```
 
-**Tiered context loading:**
+### Directory meta files
 
-| Tier | Source | Cost |
-|------|--------|------|
-| 0 | `.abstract.md` | cheap, always-on |
-| 1 | `.overview.md` | medium |
-| 2 | full file content | full |
+Every directory can carry up to four meta files. Their content is always written by the **caller** (your agent or LLM) — the SDK only stores and retrieves them.
+
+```
+{workspace}/user/preferences/
+├── .abstract.md      # L0: one-sentence summary, ~100 tokens
+├── .overview.md      # L1: navigational overview, ~1-2k tokens
+├── .relations.json   # typed links to other nodes
+├── .meta.json        # arbitrary structured metadata (used internally by plugins)
+├── coding.md         # L2: actual content file
+└── communication.md
+```
 
-**URI scheme:** `memo://path/to/node` maps directly to `{workspace}/path/to/node`.
+### Tiered context loading
+
+Loading everything into every LLM call is wasteful. The tier system lets you control context budget:
+
+| Tier | Source | Typical use |
+|------|--------|-------------|
+| 0 | `.abstract.md` | Always-on system prompt — "what the agent knows exists" |
+| 1 | `.overview.md` | On-demand navigation — drill into a relevant area |
+| 2 | Full file content | Final retrieval — read the actual memory or document |
+
+A typical agent loop: load tier-0 summaries at startup → search to find relevant nodes → load tier-2 content for those nodes only.
 
 ## Installation
 
@@ -46,39 +64,130 @@ yarn add @devxiyang/agent-memo
 
 ## Quick Start
 
+The example below shows a **coding assistant** that remembers user preferences, caches reference documentation, and assembles focused context for each LLM call.
+
+### 1. Initialize
+
 ```typescript
-import { FileMemo, type Memo, type MemoLifecycle } from '@devxiyang/agent-memo'
+import { FileMemo } from '@devxiyang/agent-memo'
+import { AgentMemory } from '@devxiyang/agent-memo/memory'
+import { AgentResource, UrlFetcher, LocalFetcher } from '@devxiyang/agent-memo/resource'
 
+// FileMemo is the filesystem backend.
+// The onWritten hook fires after every file write — use it to keep
+// directory summaries up to date so tier-0 context stays accurate.
 await using memo = new FileMemo({
-  workspace: '/path/to/workspace',
+  workspace: './agent-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 })
+        const nodes   = await memo.ls(dir)
+        const summary = await llm.summarize(nodes)          // your LLM call
+        await memo.writeMeta(dir, { abstract: summary })
       }
     },
     onError: (err, event) => console.error(`[memo:${event}]`, err),
   },
 })
 
-// Write content
-await memo.write('memo://user/memories/preferences/coding.md', 'Prefers TypeScript strict mode')
+const memory   = new AgentMemory(memo)
+const resource = new AgentResource(memo, [new UrlFetcher(), new LocalFetcher()])
+```
 
-// List directory (includes mimeType for files, abstract for subdirs)
-const nodes = await memo.ls('memo://user/memories/')
+### 2. Store user preferences
 
-// Search
-const results = await memo.search('TypeScript', {
-  scope: ['memo://user/memories/'],
-  limit: 10,
+```typescript
+// First conversation — learn about the user
+await memory.remember('memo://user/preferences/coding.md',
+  'Prefers TypeScript with strict mode. Avoids classes, favors functional style. ' +
+  'Uses pnpm and Vitest for testing.',
+  { source: 'onboarding' },
+)
+
+await memory.remember('memo://user/preferences/communication.md',
+  'Prefers concise answers. Dislikes excessive bullet points. ' +
+  'Wants code examples for every non-trivial suggestion.',
+  { source: 'onboarding' },
+)
+
+// Later — update as you learn more (createdAt is preserved automatically)
+await memory.remember('memo://user/preferences/coding.md',
+  'Prefers TypeScript with strict mode. Avoids classes, favors functional style. ' +
+  'Uses pnpm and Vitest. Recently adopted Zod for runtime validation.',
+  { source: 'conversation-18' },
+)
+```
+
+### 3. Cache reference documentation
+
+```typescript
+// Fetch and cache external docs with a TTL
+await resource.fetch(
+  'https://zod.dev/README.md',
+  'memo://resources/zod-docs.md',
+  { ttl: '7d' },
+)
+
+// Cache a local design doc
+await resource.fetch(
+  './docs/architecture.md',
+  'memo://resources/architecture.md',
+)
+```
+
+### 4. Assemble context for an LLM call
+
+```typescript
+// --- System prompt (always cheap) ---
+// Tier-0 loads .abstract.md for each directory — one-sentence summaries only.
+// This tells the agent what it knows without burning context budget.
+const systemContext = await memo.context(
+  ['memo://user/preferences/', 'memo://resources/'],
+  0,
+)
+
+// --- Targeted retrieval (on demand) ---
+// The user asks about Zod. Search memories for anything relevant.
+const hits = await memory.search('zod validation', {
+  scope: ['memo://user/preferences/'],
+  limit: 5,
 })
 
-// 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
+// Load full content for matched memories + the cached Zod docs
+const detailUris  = hits.map(h => h.uri)
+const detailContext = await memo.context(detailUris, 2)
+
+const zodEntry = await resource.read('memo://resources/zod-docs.md')
+
+// Build the final prompt
+const prompt = `
+${systemContext}
+
+--- Relevant memories ---
+${detailContext}
+
+--- Zod reference ---
+${zodEntry?.content ?? '(not cached)'}
+
+User: How should I validate an API response with Zod given my preferences?
+`.trim()
+
+const reply = await llm.chat(prompt)
+```
+
+### 5. Soft-delete and hard-delete
+
+```typescript
+// Soft-delete: sets forgottenAt in frontmatter, file kept on disk
+// recall() and search() skip it by default
+await memory.forget('memo://user/preferences/communication.md')
+
+// Hard-delete: removes the file entirely
+await memory.purge('memo://user/preferences/communication.md')
+
+// Expired or re-fetched resources
+await resource.refresh('memo://resources/zod-docs.md')   // re-fetch from original URL
+await resource.delete('memo://resources/architecture.md') // remove file + metadata
 ```
 
 ## Binary Files
@@ -141,6 +250,15 @@ search(query, options?): Promise<SearchResult[]>
 context(uris, tier: 0 | 1 | 2): Promise<string>
 ```
 
+### `BinaryMemo` interface
+
+For binary file I/O. `FileMemo` implements this; plugins that handle binary resources depend on it.
+
+```typescript
+readBinary(uri): Promise<Uint8Array | null>
+writeBinary(uri, content: Uint8Array): Promise<void>
+```
+
 ### `FilesystemAccess` interface
 
 Implemented by local filesystem backends. Consumed by plugins that need direct path access.
@@ -257,6 +375,23 @@ const entry = await memory.recall('memo://agent/preferences/coding.md')
 //   frontmatter: { createdAt, source, confidence }
 // }
 
+// List direct children of a directory
+// Defaults to workspace root (memo://) if no URI provided
+// For files: reads frontmatter.summary, does NOT read body
+// For directories: reads .abstract.md if present
+// Excludes forgotten memories by default
+const items = await memory.list('memo://agent/')
+// [
+//   { uri, name, isDir: false, summary: 'TypeScript strict mode', forgottenAt?: string },
+//   { uri, name, isDir: true,  abstract: 'Coding preferences' },
+// ]
+
+// With a summary stored at remember() time, list() is enough to navigate
+// without reading every file's full content
+await memory.remember('memo://agent/preferences/coding.md', fullContent, {
+  summary: 'TypeScript strict mode, functional style, pnpm + Vitest',
+})
+
 // Full-text search across memories
 const hits = await memory.search('TypeScript', {
   scope:            ['memo://agent/preferences/'],  // restrict to subtree (optional)
@@ -398,7 +533,9 @@ const resource = new AgentResource(memo, [new S3Fetcher(), new UrlFetcher()])
 await resource.fetch('s3://my-bucket/model.bin', 'memo://models/model.bin')
 ```
 
-Each plugin accepts any `FileMemo` instance — works with `FileMemo` today, `CloudMemo` tomorrow.
+Each plugin depends on interfaces, not the concrete `FileMemo` class:
+- `AgentMemory` requires `Memo & FilesystemAccess`
+- `AgentResource` requires `Memo & BinaryMemo & FilesystemAccess`
 
 ## Filesystem Structure
 

package/dist/plugins/memory/index.d.ts

@@ -1,6 +1,6 @@
 import type { Memo, FilesystemAccess, MemoUri } from '../../core/memo/types.js';
-import type { RememberOptions, MemorySearchOptions, MemoryFrontmatter, MemoryEntry } from './types.js';
-export type { RememberOptions, MemorySearchOptions, MemoryFrontmatter, MemoryEntry };
+import type { RememberOptions, MemorySearchOptions, MemoryListOptions, MemoryListItem, MemoryFrontmatter, MemoryEntry } from './types.js';
+export type { RememberOptions, MemorySearchOptions, MemoryListOptions, MemoryListItem, MemoryFrontmatter, MemoryEntry };
 export declare class AgentMemory {
     private readonly memo;
     constructor(memo: Memo & FilesystemAccess);
@@ -30,6 +30,14 @@ export declare class AgentMemory {
      * No metadata cleanup needed — everything is in the file.
      */
     purge(uri: MemoUri): Promise<void>;
+    /**
+     * List direct children of a directory.
+     * Defaults to the workspace root (memo://) if no URI is provided.
+     * For files: reads frontmatter to surface summary and forgottenAt (no body read).
+     * For directories: includes abstract from .abstract.md if present.
+     * Excludes forgotten memories by default.
+     */
+    list(uri?: MemoUri, options?: MemoryListOptions): Promise<MemoryListItem[]>;
     /**
      * Full-text search with frontmatter filtering.
      * Excludes forgotten memories by default.

package/dist/plugins/memory/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/memory/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAA;AAC/E,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,WAAW,EACZ,MAAM,YAAY,CAAA;AAEnB,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,WAAW,EAAE,CAAA;AAepF,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,IAAI,GAAG,gBAAgB;IAE1D;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM;IAI5B;;;;;OAKG;IACG,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB3F;;;OAGG;IACG,MAAM,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAUvD;;;OAGG;IACG,MAAM,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAWzC;;;OAGG;IACG,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC;;;OAGG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;CAyBvF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/memory/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAA;AAC/E,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,WAAW,EACZ,MAAM,YAAY,CAAA;AAEnB,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,cAAc,EAAE,iBAAiB,EAAE,WAAW,EAAE,CAAA;AAevH,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,IAAI,GAAG,gBAAgB;IAE1D;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM;IAI5B;;;;;OAKG;IACG,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB3F;;;OAGG;IACG,MAAM,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAUvD;;;OAGG;IACG,MAAM,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAWzC;;;OAGG;IACG,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC;;;;;;OAMG;IACG,IAAI,CAAC,GAAG,GAAE,OAAmB,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IA6BhG;;;OAGG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;CAyBvF"}

package/dist/plugins/memory/index.js

@@ -76,6 +76,38 @@ export class AgentMemory {
     async purge(uri) {
         await this.memo.delete(uri);
     }
+    /**
+     * List direct children of a directory.
+     * Defaults to the workspace root (memo://) if no URI is provided.
+     * For files: reads frontmatter to surface summary and forgottenAt (no body read).
+     * For directories: includes abstract from .abstract.md if present.
+     * Excludes forgotten memories by default.
+     */
+    async list(uri = 'memo://', options = {}) {
+        const { includeForgotten = false } = options;
+        const nodes = await this.memo.ls(uri);
+        const items = [];
+        for (const node of nodes) {
+            if (node.isDir) {
+                items.push({ uri: node.uri, name: node.name, isDir: true, abstract: node.abstract });
+                continue;
+            }
+            const raw = await this.memo.read(node.uri);
+            if (raw === null)
+                continue;
+            const { frontmatter } = parse(raw);
+            if (!includeForgotten && frontmatter.forgottenAt)
+                continue;
+            items.push({
+                uri: node.uri,
+                name: node.name,
+                isDir: false,
+                summary: frontmatter.summary,
+                forgottenAt: frontmatter.forgottenAt,
+            });
+        }
+        return items;
+    }
     /**
      * Full-text search with frontmatter filtering.
      * Excludes forgotten memories by default.

package/dist/plugins/memory/index.js.map

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

package/dist/plugins/memory/types.d.ts

@@ -13,6 +13,21 @@ export type MemoryEntry = {
     content: string;
     frontmatter: MemoryFrontmatter;
 };
+export type MemoryListItem = {
+    uri: MemoUri;
+    name: string;
+    isDir: boolean;
+    /** Directories: content of .abstract.md (if present). */
+    abstract?: string;
+    /** Files: frontmatter.summary field (if set by caller). */
+    summary?: string;
+    /** Files: set if this memory has been forgotten. */
+    forgottenAt?: string;
+};
+export type MemoryListOptions = {
+    /** Include forgotten memories. Default: false. */
+    includeForgotten?: boolean;
+};
 export type RememberOptions = {
     source?: string;
     /** Any custom frontmatter fields. */

package/dist/plugins/memory/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/plugins/memory/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAA;AAIvD,8CAA8C;AAC9C,MAAM,MAAM,oBAAoB,GAAG;IACjC,SAAS,EAAK,MAAM,CAAA;IACpB,MAAM,CAAC,EAAO,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,sEAAsE;AACtE,MAAM,MAAM,iBAAiB,GAAG,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAI9E,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,EAAU,OAAO,CAAA;IACpB,wCAAwC;IACxC,OAAO,EAAM,MAAM,CAAA;IACnB,WAAW,EAAE,iBAAiB,CAAA;CAC/B,CAAA;AAID,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,qCAAqC;IACrC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,CAAC,EAAa,OAAO,EAAE,CAAA;IAC5B,KAAK,CAAC,EAAa,MAAM,CAAA;IACzB,gEAAgE;IAChE,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,0CAA0C;IAC1C,MAAM,CAAC,EAAY,MAAM,CAAA;CAC1B,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/plugins/memory/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAA;AAIvD,8CAA8C;AAC9C,MAAM,MAAM,oBAAoB,GAAG;IACjC,SAAS,EAAK,MAAM,CAAA;IACpB,MAAM,CAAC,EAAO,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,sEAAsE;AACtE,MAAM,MAAM,iBAAiB,GAAG,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAI9E,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,EAAU,OAAO,CAAA;IACpB,wCAAwC;IACxC,OAAO,EAAM,MAAM,CAAA;IACnB,WAAW,EAAE,iBAAiB,CAAA;CAC/B,CAAA;AAID,MAAM,MAAM,cAAc,GAAG;IAC3B,GAAG,EAAW,OAAO,CAAA;IACrB,IAAI,EAAU,MAAM,CAAA;IACpB,KAAK,EAAS,OAAO,CAAA;IACrB,yDAAyD;IACzD,QAAQ,CAAC,EAAK,MAAM,CAAA;IACpB,2DAA2D;IAC3D,OAAO,CAAC,EAAM,MAAM,CAAA;IACpB,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,kDAAkD;IAClD,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B,CAAA;AAID,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,qCAAqC;IACrC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,CAAC,EAAa,OAAO,EAAE,CAAA;IAC5B,KAAK,CAAC,EAAa,MAAM,CAAA;IACzB,gEAAgE;IAChE,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,0CAA0C;IAC1C,MAAM,CAAC,EAAY,MAAM,CAAA;CAC1B,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devxiyang/agent-memo",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "Agent memory and memo SDK",
   "license": "MIT",
   "repository": {

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

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

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

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

package/dist/core/memo/memo.js

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

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

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