@devxiyang/agent-memo 0.0.1 → 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 devxiyang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,5 +1,9 @@
 # agent.memo
 
+[![npm version](https://img.shields.io/npm/v/@devxiyang/agent-memo)](https://www.npmjs.com/package/@devxiyang/agent-memo)
+[![npm downloads](https://img.shields.io/npm/dm/@devxiyang/agent-memo)](https://www.npmjs.com/package/@devxiyang/agent-memo)
+[![license](https://img.shields.io/github/license/devxiyang/agent.memo)](./LICENSE)
+
 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
@@ -28,7 +32,14 @@ Every directory carries up to four meta files managed by the **caller** (typical
 ## Installation
 
 ```bash
+# npm
 npm install @devxiyang/agent-memo
+
+# pnpm
+pnpm add @devxiyang/agent-memo
+
+# yarn
+yarn add @devxiyang/agent-memo
 ```
 
 > `RipgrepSearchBackend` (default) uses a bundled `rg` binary via `@vscode/ripgrep` — no manual installation needed.
@@ -72,14 +83,23 @@ const detail       = await memo.context(['memo://user/memories/preferences/codin
 
 ## 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:
+`FileMemo` implements the `BinaryMemo` interface for direct binary I/O:
 
 ```typescript
-const path = memo.toPath('memo://user/memories/photos/avatar.jpg')
+// Write binary content
+await memo.writeBinary('memo://media/avatar.jpg', imageBytes)
+
+// Read binary content
+const bytes = await memo.readBinary('memo://media/avatar.jpg')
+
+// Or get the physical path to pass to external tools
+const path = memo.toPath('memo://media/avatar.jpg')
 await sharp(imageBuffer).toFile(path)
-// onWrite hook fires automatically, caller generates .abstract.md via VLM
+// onWritten hook fires automatically
 ```
 
+For cached remote binary resources, use `AgentResource.readBinary()` — see the Plugins section.
+
 ## API
 
 ### `new FileMemo(options: FileMemoOptions)`
@@ -121,10 +141,19 @@ search(query, options?): Promise<SearchResult[]>
 context(uris, tier: 0 | 1 | 2): Promise<string>
 ```
 
+### `FilesystemAccess` interface
+
+Implemented by local filesystem backends. Consumed by plugins that need direct path access.
+
+```typescript
+toPath(uri): string          // convert memo URI to absolute filesystem path
+```
+
 ### `MemoLifecycle` interface
 
+Manages the lifecycle of the filesystem watcher. Consumed by application code.
+
 ```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`
@@ -166,6 +195,211 @@ class MyDetector implements MimeDetector {
 }
 ```
 
+## Plugins
+
+### `AgentMemory` — semantic memory for agents
+
+#### File format
+
+Every memory is stored as a Markdown file with YAML frontmatter. The SDK manages three standard fields automatically; any extra fields you pass are persisted as custom frontmatter alongside the content.
+
+```
+---
+createdAt: "2024-01-15T10:30:00.000Z"   # set on first write, preserved on updates
+source: "conversation-42"               # optional: where this memory came from
+forgottenAt: "2024-02-01T09:00:00.000Z" # set by forget(), absent until then
+confidence: 0.9                         # any custom fields you add
+---
+
+Prefers TypeScript strict mode with explicit return types.
+```
+
+#### Directory layout
+
+Memories are plain files — you choose the structure that makes sense for your agent:
+
+```
+{workspace}/
+├── agent/
+│   ├── .abstract.md              # L0 summary maintained by caller
+│   ├── preferences/
+│   │   ├── coding.md             # memo://agent/preferences/coding.md
+│   │   └── communication.md
+│   ├── facts/
+│   │   ├── user-name.md
+│   │   └── timezone.md
+│   └── episodes/
+│       ├── 2024-01-15.md
+│       └── 2024-01-16.md
+```
+
+#### API
+
+```typescript
+import { AgentMemory } from '@devxiyang/agent-memo/memory'
+
+const memory = new AgentMemory(memo)
+
+// Store a memory
+// - createdAt is set automatically on first write, preserved on subsequent updates
+// - extra fields in options are stored as custom frontmatter
+await memory.remember('memo://agent/preferences/coding.md', 'Prefers TypeScript strict mode', {
+  source:     'conversation-42',
+  confidence: 0.9,
+})
+
+// Read a single memory
+// Returns null if the file doesn't exist or forgottenAt is set
+const entry = await memory.recall('memo://agent/preferences/coding.md')
+// {
+//   uri:         'memo://agent/preferences/coding.md',
+//   content:     'Prefers TypeScript strict mode',
+//   frontmatter: { createdAt, source, confidence }
+// }
+
+// Full-text search across memories
+const hits = await memory.search('TypeScript', {
+  scope:            ['memo://agent/preferences/'],  // restrict to subtree (optional)
+  limit:            10,
+  excludeForgotten: true,                           // default: true
+  source:           'conversation-42',              // filter by source field (optional)
+})
+// hits: MemoryEntry[]
+
+// Soft-delete: sets forgottenAt in frontmatter, file stays on disk
+// recall() and search() exclude it by default; can be recovered manually
+await memory.forget('memo://agent/preferences/coding.md')
+
+// Hard-delete: removes the file entirely, no recovery possible
+await memory.purge('memo://agent/preferences/coding.md')
+
+// Get the physical filesystem path (e.g. to pass to an indexing tool)
+const path = memory.toPath('memo://agent/preferences/coding.md')
+```
+
+---
+
+### `AgentResource` — external resource caching
+
+#### File layout
+
+Each resource is stored as a file at the URI path. Metadata (source URL, fetch time, TTL, content type) is stored in the parent directory's `.meta.json` under the `_resource` key — no separate sidecar files.
+
+```
+{workspace}/
+└── resources/
+    ├── .meta.json                 # stores metadata for all files in this dir
+    ├── api-docs.md                # memo://resources/api-docs.md  (text)
+    ├── report.pdf                 # memo://resources/report.pdf   (binary)
+    └── avatars/
+        ├── .meta.json
+        └── user.png               # memo://resources/avatars/user.png
+```
+
+The `.meta.json` for the `resources/` directory looks like:
+
+```json
+{
+  "_resource": {
+    "api-docs.md": {
+      "source":      "https://example.com/api.md",
+      "fetchedAt":   "2024-01-15T10:00:00.000Z",
+      "expiresAt":   "2024-01-16T10:00:00.000Z",
+      "contentType": "text/markdown"
+    },
+    "report.pdf": {
+      "source":      "/local/reports/q4.pdf",
+      "fetchedAt":   "2024-01-15T11:00:00.000Z",
+      "contentType": "application/pdf"
+    }
+  }
+}
+```
+
+#### Built-in fetchers
+
+| Fetcher | Handles | Notes |
+|---------|---------|-------|
+| `UrlFetcher` | `http://`, `https://` | Auto text/binary via Content-Type |
+| `LocalFetcher` | `/abs`, `./rel`, `../rel`, `C:\win`, `C:/win` | Copies file, MIME from extension |
+
+`UrlFetcher` treats `text/*` and common `application/*` subtypes (json, yaml, xml, toml, graphql, javascript, typescript…) as text (UTF-8). Everything else is stored as binary.
+
+#### API
+
+```typescript
+import { AgentResource, UrlFetcher, LocalFetcher } from '@devxiyang/agent-memo/resource'
+
+// Default: [new UrlFetcher()]. Pass custom list to extend or replace.
+const resource = new AgentResource(memo, [new UrlFetcher(), new LocalFetcher()])
+
+// Fetch and cache from any source the fetchers can handle
+await resource.fetch('https://example.com/api.md',  'memo://resources/api-docs.md', { ttl: '1d' })
+await resource.fetch('/local/reports/q4.pdf',       'memo://resources/report.pdf')
+await resource.fetch('https://example.com/img.png', 'memo://resources/img.png',     { ttl: '7d' })
+
+// Read cached text content
+// Returns null if the resource was never fetched, or the TTL has expired
+const entry = await resource.read('memo://resources/api-docs.md')
+// {
+//   uri:     'memo://resources/api-docs.md',
+//   content: '# API Docs ...',
+//   meta:    { source, fetchedAt, expiresAt?, contentType? }
+// }
+
+// Read cached binary content (images, PDFs, audio, etc.)
+const bin = await resource.readBinary('memo://resources/report.pdf')
+// {
+//   uri:     'memo://resources/report.pdf',
+//   content: Uint8Array,
+//   meta:    { source, fetchedAt, expiresAt?, contentType? }
+// }
+
+// Get the physical filesystem path — for external tools (PDF parsers, image processors…)
+const path = resource.toPath('memo://resources/report.pdf')
+
+// Re-fetch from the originally stored source (respects new options if provided)
+await resource.refresh('memo://resources/api-docs.md')
+await resource.refresh('memo://resources/api-docs.md', { ttl: '7d' })  // extend TTL
+
+// Check if a resource is missing or its TTL has expired
+const stale = await resource.isStale('memo://resources/api-docs.md')
+
+// Read metadata without fetching the file content
+const meta = await resource.getMeta('memo://resources/api-docs.md')
+// { source, fetchedAt, expiresAt?, contentType? }  or  null
+
+// Remove the file and its metadata entry
+await resource.delete('memo://resources/api-docs.md')
+```
+
+TTL format: `30s` · `5m` · `1h` · `7d` · `1y`
+
+#### Custom fetchers
+
+Implement `ResourceFetcher` to support any source — S3, databases, internal APIs, etc. Fetchers are tried in order; the first one whose `canHandle()` returns `true` is used.
+
+```typescript
+import type { ResourceFetcher, FetchMeta } from '@devxiyang/agent-memo/resource'
+import { writeFile } from 'node:fs/promises'
+
+class S3Fetcher implements ResourceFetcher {
+  canHandle(source: string): boolean {
+    return source.startsWith('s3://')
+  }
+  async fetch(source: string, destPath: string): Promise<FetchMeta> {
+    const data = await downloadFromS3(source)        // your S3 logic
+    await writeFile(destPath, data)
+    return { contentType: 'application/octet-stream' }
+  }
+}
+
+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.
+
 ## Filesystem Structure
 
 ```

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

@@ -1,5 +1,5 @@
-import type { Memo, MemoLifecycle, MemoUri, MemoNode, DirMeta, Relation, SearchOptions, SearchResult, FileMemoOptions } from './types.js';
-export declare class FileMemo implements Memo, MemoLifecycle {
+import type { Memo, BinaryMemo, FilesystemAccess, MemoLifecycle, MemoUri, MemoNode, DirMeta, Relation, SearchOptions, SearchResult, FileMemoOptions } from './types.js';
+export declare class FileMemo implements Memo, BinaryMemo, FilesystemAccess, MemoLifecycle {
     private readonly options;
     private readonly hooks;
     private readonly backend;
@@ -11,7 +11,6 @@ export declare class FileMemo implements Memo, MemoLifecycle {
     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.
@@ -25,6 +24,8 @@ export declare class FileMemo implements Memo, MemoLifecycle {
     read(uri: MemoUri): Promise<string | null>;
     write(uri: MemoUri, content: string): Promise<void>;
     delete(uri: MemoUri): Promise<void>;
+    readBinary(uri: MemoUri): Promise<Uint8Array | null>;
+    writeBinary(uri: MemoUri, content: Uint8Array): Promise<void>;
     ls(uri: MemoUri): Promise<MemoNode[]>;
     mkdir(uri: MemoUri): Promise<void>;
     rmdir(uri: MemoUri, recursive?: boolean): Promise<void>;

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

@@ -1 +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"}
+{"version":3,"file":"file-fs.d.ts","sourceRoot":"","sources":["../../../src/core/memo/file-fs.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,IAAI,EACJ,UAAU,EACV,gBAAgB,EAChB,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,UAAU,EAAE,gBAAgB,EAAE,aAAa;IAOpE,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,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;IAOnC,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAQpD,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAW7D,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;IAepD,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

@@ -54,8 +54,7 @@ export class FileMemo {
         ]);
         return { mimeType, size: s?.size ?? 0, modTime: s?.mtimeMs ?? 0 };
     }
-    // ── MemoLifecycle ────────────────────────────────────────────────────────
-    /** Convert a memo URI to an absolute filesystem path (for binary file access). */
+    // ── FilesystemAccess ─────────────────────────────────────────────────────
     toPath(uri) {
         return join(this.workspace, uriToRel(uri));
     }
@@ -139,6 +138,22 @@ export class FileMemo {
             this.fire(this.hooks.onDeleted?.(uri, parentDirs(uri)), 'delete');
         }
     }
+    async readBinary(uri) {
+        try {
+            return await readFile(this.toPath(uri));
+        }
+        catch {
+            return null;
+        }
+    }
+    async writeBinary(uri, content) {
+        const p = this.toPath(uri);
+        await mkdir(dirname(p), { recursive: true });
+        await writeFile(p, content);
+        if (!this.watcher) {
+            this.fire(this.hooks.onWritten?.(uri, parentDirs(uri)), 'write');
+        }
+    }
     // ── Directory ──────────────────────────────────────────────────────────────
     async ls(uri) {
         const p = this.toPath(uri);
@@ -230,7 +245,9 @@ export class FileMemo {
         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');
+        if (!this.watcher) {
+            this.fire(this.hooks.onUnlinked?.(uri, target), 'unlink');
+        }
     }
     // ── Search ─────────────────────────────────────────────────────────────────
     async search(query, options) {

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

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

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

@@ -1,8 +1,9 @@
 import type { MimeDetector } from './types.js';
+export declare const EXTENSION_MIME: Record<string, string>;
 /**
- * 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.
+ * MIME type detector using two-stage detection:
+ *  1. Magic bytes via file-type (accurate for binary formats)
+ *  2. Extension-based fallback (for text formats with no magic bytes)
  */
 export declare class MagicMimeDetector implements MimeDetector {
     detect(path: string): Promise<string | undefined>;

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

@@ -1 +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"}
+{"version":3,"file":"mime.d.ts","sourceRoot":"","sources":["../../../src/core/memo/mime.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAI9C,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAwDjD,CAAA;AAED;;;;GAIG;AACH,qBAAa,iBAAkB,YAAW,YAAY;IAC9C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;CAOxD"}

package/dist/core/memo/mime.js

@@ -1,13 +1,73 @@
 import { fileTypeFromFile } from 'file-type';
+import { extname } from 'node:path';
+// Fallback MIME types by file extension for text-based formats
+// that have no magic bytes and cannot be detected by file-type.
+export const EXTENSION_MIME = {
+    // Markup & docs
+    '.md': 'text/markdown',
+    '.mdx': 'text/markdown',
+    '.txt': 'text/plain',
+    '.rst': 'text/x-rst',
+    '.tex': 'text/x-tex',
+    '.html': 'text/html',
+    '.htm': 'text/html',
+    '.xml': 'application/xml',
+    '.svg': 'image/svg+xml',
+    // Data formats
+    '.json': 'application/json',
+    '.jsonl': 'application/x-ndjson',
+    '.ndjson': 'application/x-ndjson',
+    '.yaml': 'application/yaml',
+    '.yml': 'application/yaml',
+    '.toml': 'application/toml',
+    '.csv': 'text/csv',
+    '.tsv': 'text/tab-separated-values',
+    '.ini': 'text/plain',
+    '.env': 'text/plain',
+    // Code
+    '.ts': 'text/typescript',
+    '.tsx': 'text/typescript',
+    '.js': 'text/javascript',
+    '.jsx': 'text/javascript',
+    '.mjs': 'text/javascript',
+    '.cjs': 'text/javascript',
+    '.css': 'text/css',
+    '.scss': 'text/x-scss',
+    '.less': 'text/x-less',
+    '.py': 'text/x-python',
+    '.rb': 'text/x-ruby',
+    '.rs': 'text/x-rust',
+    '.go': 'text/x-go',
+    '.java': 'text/x-java',
+    '.c': 'text/x-c',
+    '.cpp': 'text/x-c++',
+    '.h': 'text/x-c',
+    '.cs': 'text/x-csharp',
+    '.php': 'text/x-php',
+    '.sh': 'text/x-sh',
+    '.bash': 'text/x-sh',
+    '.zsh': 'text/x-sh',
+    '.sql': 'text/x-sql',
+    '.r': 'text/x-r',
+    // Config & misc
+    '.graphql': 'application/graphql',
+    '.gql': 'application/graphql',
+    '.proto': 'text/plain',
+    '.tf': 'text/plain',
+    '.lock': 'text/plain',
+};
 /**
- * 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.
+ * MIME type detector using two-stage detection:
+ *  1. Magic bytes via file-type (accurate for binary formats)
+ *  2. Extension-based fallback (for text formats with no magic bytes)
  */
 export class MagicMimeDetector {
     async detect(path) {
         const result = await fileTypeFromFile(path);
-        return result?.mime;
+        if (result)
+            return result.mime;
+        const ext = extname(path).toLowerCase();
+        return EXTENSION_MIME[ext];
     }
 }
 //# sourceMappingURL=mime.js.map

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

@@ -1 +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"}
+{"version":3,"file":"mime.js","sourceRoot":"","sources":["../../../src/core/memo/mime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGnC,+DAA+D;AAC/D,gEAAgE;AAChE,MAAM,CAAC,MAAM,cAAc,GAA2B;IACpD,gBAAgB;IAChB,KAAK,EAAK,eAAe;IACzB,MAAM,EAAI,eAAe;IACzB,MAAM,EAAI,YAAY;IACtB,MAAM,EAAI,YAAY;IACtB,MAAM,EAAI,YAAY;IACtB,OAAO,EAAG,WAAW;IACrB,MAAM,EAAI,WAAW;IACrB,MAAM,EAAI,iBAAiB;IAC3B,MAAM,EAAI,eAAe;IAEzB,eAAe;IACf,OAAO,EAAG,kBAAkB;IAC5B,QAAQ,EAAE,sBAAsB;IAChC,SAAS,EAAC,sBAAsB;IAChC,OAAO,EAAG,kBAAkB;IAC5B,MAAM,EAAI,kBAAkB;IAC5B,OAAO,EAAG,kBAAkB;IAC5B,MAAM,EAAI,UAAU;IACpB,MAAM,EAAI,2BAA2B;IACrC,MAAM,EAAI,YAAY;IACtB,MAAM,EAAI,YAAY;IAEtB,OAAO;IACP,KAAK,EAAI,iBAAiB;IAC1B,MAAM,EAAG,iBAAiB;IAC1B,KAAK,EAAI,iBAAiB;IAC1B,MAAM,EAAG,iBAAiB;IAC1B,MAAM,EAAG,iBAAiB;IAC1B,MAAM,EAAG,iBAAiB;IAC1B,MAAM,EAAG,UAAU;IACnB,OAAO,EAAE,aAAa;IACtB,OAAO,EAAE,aAAa;IACtB,KAAK,EAAI,eAAe;IACxB,KAAK,EAAI,aAAa;IACtB,KAAK,EAAI,aAAa;IACtB,KAAK,EAAI,WAAW;IACpB,OAAO,EAAE,aAAa;IACtB,IAAI,EAAK,UAAU;IACnB,MAAM,EAAG,YAAY;IACrB,IAAI,EAAK,UAAU;IACnB,KAAK,EAAI,eAAe;IACxB,MAAM,EAAG,YAAY;IACrB,KAAK,EAAI,WAAW;IACpB,OAAO,EAAE,WAAW;IACpB,MAAM,EAAG,WAAW;IACpB,MAAM,EAAG,YAAY;IACrB,IAAI,EAAK,UAAU;IAEnB,gBAAgB;IAChB,UAAU,EAAE,qBAAqB;IACjC,MAAM,EAAM,qBAAqB;IACjC,QAAQ,EAAI,YAAY;IACxB,KAAK,EAAO,YAAY;IACxB,OAAO,EAAK,YAAY;CACzB,CAAA;AAED;;;;GAIG;AACH,MAAM,OAAO,iBAAiB;IAC5B,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAA;QAC3C,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC,IAAI,CAAA;QAE9B,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAA;QACvC,OAAO,cAAc,CAAC,GAAG,CAAC,CAAA;IAC5B,CAAC;CACF"}

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

@@ -77,13 +77,27 @@ export interface FileMemoOptions {
     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.
+ * Optional extension for implementations that support binary file I/O.
+ * Separate from Memo so text-only consumers are unaffected.
  */
-export interface MemoLifecycle extends AsyncDisposable {
-    /** Convert a memo URI to an absolute filesystem path (for binary file access). */
+export interface BinaryMemo {
+    readBinary(uri: MemoUri): Promise<Uint8Array | null>;
+    writeBinary(uri: MemoUri, content: Uint8Array): Promise<void>;
+}
+/**
+ * Implemented by backends that run on a local filesystem.
+ * Gives consumers direct access to the physical path for a URI —
+ * used by plugins (AgentMemory, AgentResource) and external tools.
+ */
+export interface FilesystemAccess {
+    /** Convert a memo URI to an absolute filesystem path. */
     toPath(uri: MemoUri): string;
+}
+/**
+ * Manages the lifecycle of the filesystem watcher.
+ * Consumed by application code, not by plugins.
+ */
+export interface MemoLifecycle extends AsyncDisposable {
     /** Start watching the workspace; hooks fire for all filesystem changes. */
     watch(): void;
     /** Stop watching and release resources. */

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

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

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

@@ -0,0 +1,39 @@
+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 };
+export declare class AgentMemory {
+    private readonly memo;
+    constructor(memo: Memo & FilesystemAccess);
+    /**
+     * Get the physical filesystem path for a memory URI.
+     */
+    toPath(uri: MemoUri): string;
+    /**
+     * Write a memory with frontmatter.
+     * If the file already exists, createdAt is preserved and frontmatter is merged.
+     * Standard fields: createdAt, source, forgottenAt.
+     * Any extra fields in options are stored as custom extensions.
+     */
+    remember(uri: MemoUri, content: string, options?: RememberOptions): Promise<void>;
+    /**
+     * Read a single memory.
+     * Returns null if not found or if forgottenAt is set.
+     */
+    recall(uri: MemoUri): Promise<MemoryEntry | null>;
+    /**
+     * Soft-delete: set forgottenAt in frontmatter.
+     * File stays on disk but recall/search will exclude it by default.
+     */
+    forget(uri: MemoUri): Promise<void>;
+    /**
+     * Hard-delete: remove the file entirely.
+     * No metadata cleanup needed — everything is in the file.
+     */
+    purge(uri: MemoUri): Promise<void>;
+    /**
+     * Full-text search with frontmatter filtering.
+     * Excludes forgotten memories by default.
+     */
+    search(query: string, options?: MemorySearchOptions): Promise<MemoryEntry[]>;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

package/dist/plugins/memory/index.js

@@ -0,0 +1,101 @@
+import matter from 'gray-matter';
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+function serialize(content, frontmatter) {
+    return matter.stringify(content, frontmatter);
+}
+function parse(raw) {
+    const { content, data } = matter(raw);
+    return { content: content.trim(), frontmatter: data };
+}
+// ─── AgentMemory ─────────────────────────────────────────────────────────────
+export class AgentMemory {
+    memo;
+    constructor(memo) {
+        this.memo = memo;
+    }
+    /**
+     * Get the physical filesystem path for a memory URI.
+     */
+    toPath(uri) {
+        return this.memo.toPath(uri);
+    }
+    /**
+     * Write a memory with frontmatter.
+     * If the file already exists, createdAt is preserved and frontmatter is merged.
+     * Standard fields: createdAt, source, forgottenAt.
+     * Any extra fields in options are stored as custom extensions.
+     */
+    async remember(uri, content, options = {}) {
+        const { source, ...extensions } = options;
+        let createdAt = new Date().toISOString();
+        // Preserve createdAt if file already exists
+        const existing = await this.memo.read(uri);
+        if (existing !== null) {
+            const { frontmatter } = parse(existing);
+            if (frontmatter.createdAt)
+                createdAt = frontmatter.createdAt;
+        }
+        const frontmatter = {
+            createdAt,
+            ...(source !== undefined && { source }),
+            ...extensions,
+        };
+        await this.memo.write(uri, serialize(content, frontmatter));
+    }
+    /**
+     * Read a single memory.
+     * Returns null if not found or if forgottenAt is set.
+     */
+    async recall(uri) {
+        const raw = await this.memo.read(uri);
+        if (raw === null)
+            return null;
+        const { content, frontmatter } = parse(raw);
+        if (frontmatter.forgottenAt)
+            return null;
+        return { uri, content, frontmatter };
+    }
+    /**
+     * Soft-delete: set forgottenAt in frontmatter.
+     * File stays on disk but recall/search will exclude it by default.
+     */
+    async forget(uri) {
+        const raw = await this.memo.read(uri);
+        if (raw === null)
+            return;
+        const { content, frontmatter } = parse(raw);
+        await this.memo.write(uri, serialize(content, {
+            ...frontmatter,
+            forgottenAt: new Date().toISOString(),
+        }));
+    }
+    /**
+     * Hard-delete: remove the file entirely.
+     * No metadata cleanup needed — everything is in the file.
+     */
+    async purge(uri) {
+        await this.memo.delete(uri);
+    }
+    /**
+     * Full-text search with frontmatter filtering.
+     * Excludes forgotten memories by default.
+     */
+    async search(query, options = {}) {
+        const { scope, limit, excludeForgotten = true, source, } = options;
+        const raw = await this.memo.search(query, { scope, limit });
+        const results = [];
+        for (const result of raw) {
+            const file = await this.memo.read(result.uri);
+            if (file === null)
+                continue;
+            const { content, frontmatter } = parse(file);
+            if (excludeForgotten && frontmatter.forgottenAt)
+                continue;
+            if (source !== undefined && frontmatter.source !== source)
+                continue;
+            results.push({ uri: result.uri, content, frontmatter });
+        }
+        return results;
+    }
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,29 @@
+import type { MemoUri } from '../../core/memo/types.js';
+/** Standard fields managed by AgentMemory. */
+export type MemoryStandardFields = {
+    createdAt: string;
+    source?: string;
+    forgottenAt?: string;
+};
+/** Full frontmatter = standard fields + caller-defined extensions. */
+export type MemoryFrontmatter = MemoryStandardFields & Record<string, unknown>;
+export type MemoryEntry = {
+    uri: MemoUri;
+    /** Body content without frontmatter. */
+    content: string;
+    frontmatter: MemoryFrontmatter;
+};
+export type RememberOptions = {
+    source?: string;
+    /** Any custom frontmatter fields. */
+    [key: string]: unknown;
+};
+export type MemorySearchOptions = {
+    scope?: MemoUri[];
+    limit?: number;
+    /** Exclude memories where forgottenAt is set. Default: true. */
+    excludeForgotten?: boolean;
+    /** Filter by frontmatter source field. */
+    source?: string;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +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"}

package/dist/plugins/memory/types.js

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

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

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

package/dist/plugins/resource/fetchers/local.d.ts

@@ -0,0 +1,11 @@
+import type { ResourceFetcher, FetchMeta } from '../types.js';
+/**
+ * Built-in fetcher for local filesystem paths.
+ * Copies the file into the memo workspace.
+ * Supports Unix and Windows paths (absolute and relative).
+ */
+export declare class LocalFetcher implements ResourceFetcher {
+    canHandle(source: string): boolean;
+    fetch(source: string, destPath: string): Promise<FetchMeta>;
+}
+//# sourceMappingURL=local.d.ts.map

package/dist/plugins/resource/fetchers/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../../../src/plugins/resource/fetchers/local.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAK7D;;;;GAIG;AACH,qBAAa,YAAa,YAAW,eAAe;IAClD,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAY5B,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;CAKlE"}

package/dist/plugins/resource/fetchers/local.js

@@ -0,0 +1,33 @@
+import { copyFile } from 'node:fs/promises';
+import { extname } from 'node:path';
+import { EXTENSION_MIME } from '../../../core/memo/mime.js';
+// Matches Windows absolute paths: C:\... or C:/...
+const WINDOWS_ABS_RE = /^[a-zA-Z]:[/\\]/;
+/**
+ * Built-in fetcher for local filesystem paths.
+ * Copies the file into the memo workspace.
+ * Supports Unix and Windows paths (absolute and relative).
+ */
+export class LocalFetcher {
+    canHandle(source) {
+        // Unix absolute
+        if (source.startsWith('/'))
+            return true;
+        // Unix relative
+        if (source.startsWith('./') || source.startsWith('../'))
+            return true;
+        // Windows absolute: C:\ or C:/
+        if (WINDOWS_ABS_RE.test(source))
+            return true;
+        // Windows relative: .\ or ..\
+        if (source.startsWith('.\\') || source.startsWith('..\\'))
+            return true;
+        return false;
+    }
+    async fetch(source, destPath) {
+        await copyFile(source, destPath);
+        const ext = extname(source).toLowerCase();
+        return { contentType: EXTENSION_MIME[ext] };
+    }
+}
+//# sourceMappingURL=local.js.map

package/dist/plugins/resource/fetchers/local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.js","sourceRoot":"","sources":["../../../../src/plugins/resource/fetchers/local.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAG3D,mDAAmD;AACnD,MAAM,cAAc,GAAG,iBAAiB,CAAA;AAExC;;;;GAIG;AACH,MAAM,OAAO,YAAY;IACvB,SAAS,CAAC,MAAc;QACtB,gBAAgB;QAChB,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAA;QACvC,gBAAgB;QAChB,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAA;QACpE,+BAA+B;QAC/B,IAAI,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,CAAA;QAC5C,8BAA8B;QAC9B,IAAI,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,CAAA;QACtE,OAAO,KAAK,CAAA;IACd,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAc,EAAE,QAAgB;QAC1C,MAAM,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;QAChC,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAA;QACzC,OAAO,EAAE,WAAW,EAAE,cAAc,CAAC,GAAG,CAAC,EAAE,CAAA;IAC7C,CAAC;CACF"}

package/dist/plugins/resource/fetchers/url.d.ts

@@ -0,0 +1,10 @@
+import type { ResourceFetcher, FetchMeta, FetchOptions } from '../types.js';
+/**
+ * Built-in fetcher for HTTP/HTTPS URLs.
+ * Automatically handles binary vs text content based on Content-Type.
+ */
+export declare class UrlFetcher implements ResourceFetcher {
+    canHandle(source: string): boolean;
+    fetch(source: string, destPath: string, options?: FetchOptions): Promise<FetchMeta>;
+}
+//# sourceMappingURL=url.d.ts.map

package/dist/plugins/resource/fetchers/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../../../src/plugins/resource/fetchers/url.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAgB3E;;;GAGG;AACH,qBAAa,UAAW,YAAW,eAAe;IAChD,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI5B,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC;CAkB1F"}

package/dist/plugins/resource/fetchers/url.js

@@ -0,0 +1,41 @@
+import { writeFile } from 'node:fs/promises';
+// Text-based application/* subtypes that should be saved as UTF-8 strings
+const TEXT_APP_SUBTYPES = new Set([
+    'json', 'yaml', 'xml', 'toml', 'graphql', 'x-ndjson',
+    'x-www-form-urlencoded', 'javascript', 'typescript',
+]);
+function isTextContentType(contentType) {
+    const [type] = contentType.split(';').map(s => s.trim());
+    const [main, sub] = type.split('/');
+    if (main === 'text')
+        return true;
+    if (main === 'application' && sub && TEXT_APP_SUBTYPES.has(sub))
+        return true;
+    return false;
+}
+/**
+ * Built-in fetcher for HTTP/HTTPS URLs.
+ * Automatically handles binary vs text content based on Content-Type.
+ */
+export class UrlFetcher {
+    canHandle(source) {
+        return source.startsWith('http://') || source.startsWith('https://');
+    }
+    async fetch(source, destPath, options) {
+        const response = await globalThis.fetch(source, { headers: options?.headers });
+        if (!response.ok) {
+            throw new Error(`Failed to fetch "${source}": ${response.status} ${response.statusText}`);
+        }
+        const contentType = response.headers.get('content-type') ?? '';
+        if (isTextContentType(contentType)) {
+            const text = await response.text();
+            await writeFile(destPath, text, 'utf-8');
+        }
+        else {
+            const buffer = await response.arrayBuffer();
+            await writeFile(destPath, new Uint8Array(buffer));
+        }
+        return { contentType: contentType || undefined };
+    }
+}
+//# sourceMappingURL=url.js.map

package/dist/plugins/resource/fetchers/url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.js","sourceRoot":"","sources":["../../../../src/plugins/resource/fetchers/url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAG5C,0EAA0E;AAC1E,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IAChC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU;IACpD,uBAAuB,EAAE,YAAY,EAAE,YAAY;CACpD,CAAC,CAAA;AAEF,SAAS,iBAAiB,CAAC,WAAmB;IAC5C,MAAM,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;IACxD,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IACnC,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,IAAI,CAAA;IAChC,IAAI,IAAI,KAAK,aAAa,IAAI,GAAG,IAAI,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAA;IAC5E,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,UAAU;IACrB,SAAS,CAAC,MAAc;QACtB,OAAO,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,CAAA;IACtE,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAc,EAAE,QAAgB,EAAE,OAAsB;QAClE,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAA;QAC9E,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,oBAAoB,MAAM,MAAM,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAA;QAC3F,CAAC;QAED,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAA;QAE9D,IAAI,iBAAiB,CAAC,WAAW,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;YAClC,MAAM,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;QAC1C,CAAC;aAAM,CAAC;YACN,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAA;YAC3C,MAAM,SAAS,CAAC,QAAQ,EAAE,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,CAAA;QACnD,CAAC;QAED,OAAO,EAAE,WAAW,EAAE,WAAW,IAAI,SAAS,EAAE,CAAA;IAClD,CAAC;CACF"}

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

@@ -0,0 +1,50 @@
+import type { Memo, BinaryMemo, FilesystemAccess, MemoUri } from '../../core/memo/types.js';
+import type { FetchOptions, ResourceMeta, ResourceEntry, BinaryResourceEntry, ResourceFetcher } from './types.js';
+export type { FetchOptions, ResourceMeta, ResourceEntry, BinaryResourceEntry, ResourceFetcher };
+export { UrlFetcher } from './fetchers/url.js';
+export { LocalFetcher } from './fetchers/local.js';
+type FullMemo = Memo & BinaryMemo & FilesystemAccess;
+export declare class AgentResource {
+    private readonly memo;
+    private readonly fetchers;
+    constructor(memo: FullMemo, fetchers?: ResourceFetcher[]);
+    /**
+     * Fetch content from any source (URL, local path, or custom) and store at uri.
+     * The appropriate fetcher is selected via canHandle().
+     */
+    fetch(source: string, uri: MemoUri, options?: FetchOptions): Promise<void>;
+    /**
+     * Re-fetch a resource from its stored source.
+     * Throws if no metadata exists for the URI.
+     */
+    refresh(uri: MemoUri, options?: FetchOptions): Promise<void>;
+    /**
+     * Read cached text content. Returns null if not found or expired.
+     * For binary files, use toPath() to get the physical path instead.
+     */
+    read(uri: MemoUri): Promise<ResourceEntry | null>;
+    /**
+     * Read cached binary content. Returns null if not found or expired.
+     * Use this for images, PDFs, audio, and other binary formats.
+     */
+    readBinary(uri: MemoUri): Promise<BinaryResourceEntry | null>;
+    /**
+     * Get the physical filesystem path for direct binary file access.
+     * Useful for passing to external tools (PDF parsers, image processors, etc.).
+     */
+    toPath(uri: MemoUri): string;
+    /**
+     * Remove the resource file and its metadata entry.
+     */
+    delete(uri: MemoUri): Promise<void>;
+    /**
+     * Check whether a cached resource is missing or expired.
+     */
+    isStale(uri: MemoUri): Promise<boolean>;
+    /**
+     * Get metadata for a resource without reading its content.
+     */
+    getMeta(uri: MemoUri): Promise<ResourceMeta | null>;
+    private _writeMeta;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/resource/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAA;AAC3F,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAIjH,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,eAAe,EAAE,CAAA;AAC/F,OAAO,EAAE,UAAU,EAAE,MAAQ,mBAAmB,CAAA;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAIlD,KAAK,QAAQ,GAAG,IAAI,GAAG,UAAU,GAAG,gBAAgB,CAAA;AAQpD,qBAAa,aAAa;IAItB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;gBAGzB,IAAI,EAAE,QAAQ,EAC/B,QAAQ,CAAC,EAAE,eAAe,EAAE;IAK9B;;;OAGG;IACG,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBpF;;;OAGG;IACG,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAMtE;;;OAGG;IACG,IAAI,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAUvD;;;OAGG;IACG,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAUnE;;;OAGG;IACH,MAAM,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM;IAI5B;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAWzC;;OAEG;IACG,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAM7C;;OAEG;IACG,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;YAU3C,UAAU;CAQzB"}

package/dist/plugins/resource/index.js

@@ -0,0 +1,123 @@
+import { mkdir } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { parseTtl, uriBasename, uriDirname } from '../utils.js';
+import { UrlFetcher } from './fetchers/url.js';
+export { UrlFetcher } from './fetchers/url.js';
+export { LocalFetcher } from './fetchers/local.js';
+function isExpired(meta) {
+    return !!meta.expiresAt && new Date(meta.expiresAt) < new Date();
+}
+// ─── AgentResource ───────────────────────────────────────────────────────────
+export class AgentResource {
+    memo;
+    fetchers;
+    constructor(memo, fetchers) {
+        this.memo = memo;
+        this.fetchers = fetchers ?? [new UrlFetcher()];
+    }
+    /**
+     * Fetch content from any source (URL, local path, or custom) and store at uri.
+     * The appropriate fetcher is selected via canHandle().
+     */
+    async fetch(source, uri, options = {}) {
+        const fetcher = this.fetchers.find(f => f.canHandle(source));
+        if (!fetcher)
+            throw new Error(`No fetcher found for source: "${source}"`);
+        const destPath = this.memo.toPath(uri);
+        await mkdir(dirname(destPath), { recursive: true });
+        const { contentType } = await fetcher.fetch(source, destPath, options);
+        const now = new Date();
+        await this._writeMeta(uri, {
+            source,
+            fetchedAt: now.toISOString(),
+            contentType,
+            expiresAt: options.ttl
+                ? new Date(now.getTime() + parseTtl(options.ttl)).toISOString()
+                : undefined,
+        });
+    }
+    /**
+     * Re-fetch a resource from its stored source.
+     * Throws if no metadata exists for the URI.
+     */
+    async refresh(uri, options = {}) {
+        const meta = await this.getMeta(uri);
+        if (!meta)
+            throw new Error(`No resource metadata found for "${uri}". Fetch it first.`);
+        await this.fetch(meta.source, uri, options);
+    }
+    /**
+     * Read cached text content. Returns null if not found or expired.
+     * For binary files, use toPath() to get the physical path instead.
+     */
+    async read(uri) {
+        const meta = await this.getMeta(uri);
+        if (!meta || isExpired(meta))
+            return null;
+        const content = await this.memo.read(uri);
+        if (content === null)
+            return null;
+        return { uri, content, meta };
+    }
+    /**
+     * Read cached binary content. Returns null if not found or expired.
+     * Use this for images, PDFs, audio, and other binary formats.
+     */
+    async readBinary(uri) {
+        const meta = await this.getMeta(uri);
+        if (!meta || isExpired(meta))
+            return null;
+        const content = await this.memo.readBinary(uri);
+        if (content === null)
+            return null;
+        return { uri, content, meta };
+    }
+    /**
+     * Get the physical filesystem path for direct binary file access.
+     * Useful for passing to external tools (PDF parsers, image processors, etc.).
+     */
+    toPath(uri) {
+        return this.memo.toPath(uri);
+    }
+    /**
+     * Remove the resource file and its metadata entry.
+     */
+    async delete(uri) {
+        await this.memo.delete(uri);
+        const dirUri = uriDirname(uri);
+        const name = uriBasename(uri);
+        const existing = await this.memo.readMeta(dirUri);
+        const files = existing.meta?._resource ?? {};
+        delete files[name];
+        await this.memo.writeMeta(dirUri, { meta: { ...existing.meta, _resource: files } });
+    }
+    /**
+     * Check whether a cached resource is missing or expired.
+     */
+    async isStale(uri) {
+        const meta = await this.getMeta(uri);
+        if (!meta)
+            return true;
+        return isExpired(meta);
+    }
+    /**
+     * Get metadata for a resource without reading its content.
+     */
+    async getMeta(uri) {
+        const dirUri = uriDirname(uri);
+        const name = uriBasename(uri);
+        const meta = await this.memo.readMeta(dirUri);
+        const files = meta.meta?._resource ?? {};
+        return files[name] ?? null;
+    }
+    // ── Private ────────────────────────────────────────────────────────────────
+    async _writeMeta(uri, resMeta) {
+        const dirUri = uriDirname(uri);
+        const name = uriBasename(uri);
+        const existing = await this.memo.readMeta(dirUri);
+        const files = existing.meta?._resource ?? {};
+        files[name] = resMeta;
+        await this.memo.writeMeta(dirUri, { meta: { ...existing.meta, _resource: files } });
+    }
+}
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,39 @@
+import type { MemoUri } from '../../core/memo/types.js';
+export type FetchMeta = {
+    contentType?: string;
+};
+/**
+ * Pluggable fetcher interface. Implement this to support custom sources
+ * (S3, database, internal APIs, etc.).
+ */
+export interface ResourceFetcher {
+    /** Return true if this fetcher can handle the given source string. */
+    canHandle(source: string): boolean;
+    /** Fetch content from source and write it to destPath (physical path). */
+    fetch(source: string, destPath: string, options?: FetchOptions): Promise<FetchMeta>;
+}
+export type FetchOptions = {
+    /** Time-to-live for cached content, e.g. '1d', '7d'. Omit to cache indefinitely. */
+    ttl?: string;
+    /** Additional HTTP request headers (used by UrlFetcher). */
+    headers?: Record<string, string>;
+};
+export type ResourceMeta = {
+    source: string;
+    fetchedAt: string;
+    expiresAt?: string;
+    contentType?: string;
+};
+/** Text resource entry — returned by read(). */
+export type ResourceEntry = {
+    uri: MemoUri;
+    content: string;
+    meta: ResourceMeta;
+};
+/** Binary resource entry — returned by readBinary(). */
+export type BinaryResourceEntry = {
+    uri: MemoUri;
+    content: Uint8Array;
+    meta: ResourceMeta;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/plugins/resource/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAA;AAIvD,MAAM,MAAM,SAAS,GAAG;IACtB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,sEAAsE;IACtE,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAA;IAClC,0EAA0E;IAC1E,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,CAAA;CACpF;AAID,MAAM,MAAM,YAAY,GAAG;IACzB,oFAAoF;IACpF,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC,CAAA;AAID,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAQ,MAAM,CAAA;IACpB,SAAS,EAAK,MAAM,CAAA;IACpB,SAAS,CAAC,EAAI,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAID,gDAAgD;AAChD,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,EAAM,OAAO,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAK,YAAY,CAAA;CACtB,CAAA;AAED,wDAAwD;AACxD,MAAM,MAAM,mBAAmB,GAAG;IAChC,GAAG,EAAM,OAAO,CAAA;IAChB,OAAO,EAAE,UAAU,CAAA;IACnB,IAAI,EAAK,YAAY,CAAA;CACtB,CAAA"}

package/dist/plugins/resource/types.js

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

package/dist/plugins/resource/types.js.map

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

package/dist/plugins/utils.d.ts

@@ -0,0 +1,5 @@
+import type { MemoUri } from '../core/memo/types.js';
+export declare function parseTtl(ttl: string): number;
+export declare function uriBasename(uri: MemoUri): string;
+export declare function uriDirname(uri: MemoUri): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/plugins/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/plugins/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA;AAEpD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAS5C;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAEhD;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAI/C"}

package/dist/plugins/utils.js

@@ -0,0 +1,20 @@
+export function parseTtl(ttl) {
+    const match = ttl.match(/^(\d+)([smhdwy])$/);
+    if (!match)
+        throw new Error(`Invalid TTL: "${ttl}". Expected format: 30d, 1h, 7d, etc.`);
+    const n = parseInt(match[1], 10);
+    const units = {
+        s: 1_000, m: 60_000, h: 3_600_000,
+        d: 86_400_000, w: 604_800_000, y: 31_536_000_000,
+    };
+    return n * units[match[2]];
+}
+export function uriBasename(uri) {
+    return uri.split('/').filter(Boolean).at(-1) ?? '';
+}
+export function uriDirname(uri) {
+    const parts = uri.replace('memo://', '').split('/').filter(Boolean);
+    parts.pop();
+    return parts.length ? `memo://${parts.join('/')}` : 'memo://';
+}
+//# sourceMappingURL=utils.js.map

package/dist/plugins/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/plugins/utils.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAA;IAC5C,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,GAAG,uCAAuC,CAAC,CAAA;IACxF,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IAChC,MAAM,KAAK,GAA2B;QACpC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS;QACjC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,cAAc;KACjD,CAAA;IACD,OAAO,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;AAC5B,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAY;IACtC,OAAO,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;AACpD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAY;IACrC,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACnE,KAAK,CAAC,GAAG,EAAE,CAAA;IACX,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;AAC/D,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devxiyang/agent-memo",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "Agent memory and memo SDK",
   "license": "MIT",
   "repository": {
@@ -25,6 +25,14 @@
     "./memo": {
       "types": "./dist/core/memo/index.d.ts",
       "import": "./dist/core/memo/index.js"
+    },
+    "./memory": {
+      "types": "./dist/plugins/memory/index.d.ts",
+      "import": "./dist/plugins/memory/index.js"
+    },
+    "./resource": {
+      "types": "./dist/plugins/resource/index.d.ts",
+      "import": "./dist/plugins/resource/index.js"
     }
   },
   "files": [
@@ -45,6 +53,7 @@
   "dependencies": {
     "@vscode/ripgrep": ">=1.17.0",
     "chokidar": ">=5.0.0",
-    "file-type": ">=21.0.0"
+    "file-type": ">=21.0.0",
+    "gray-matter": "^4.0.3"
   }
 }