@devxiyang/agent-memo 0.0.1 → 0.0.3

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,47 @@
+import type { Memo, FilesystemAccess, MemoUri } from '../../core/memo/types.js';
+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);
+    /**
+     * 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>;
+    /**
+     * 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.
+     */
+    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,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

@@ -0,0 +1,133 @@
+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);
+    }
+    /**
+     * 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.
+     */
+    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,44 @@
+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 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. */
+    [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,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/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"}