@lleverage-ai/agent-sdk 0.0.1

package/dist/memory/filesystem-store.d.ts

@@ -0,0 +1,217 @@
+/**
+ * Filesystem-based memory store implementation.
+ *
+ * Stores memory documents as markdown files on the local filesystem.
+ * Supports YAML frontmatter for metadata.
+ *
+ * @example
+ * ```typescript
+ * import { FilesystemMemoryStore } from "@lleverage-ai/agent-sdk";
+ *
+ * const store = new FilesystemMemoryStore();
+ *
+ * // Read user-level memory
+ * const userMemory = await store.read("~/.deepagents/my-agent/agent.md");
+ *
+ * // Write project memory
+ * await store.write("/project/.deepagents/agent.md", {
+ *   path: "/project/.deepagents/agent.md",
+ *   metadata: {},
+ *   content: "# Project Rules",
+ *   modifiedAt: Date.now(),
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+import type { MemoryDocument, MemoryStore } from "./store.js";
+/**
+ * Configuration options for FilesystemMemoryStore.
+ *
+ * @category Memory
+ */
+export interface FilesystemMemoryStoreOptions {
+    /**
+     * Override the home directory for `~` expansion.
+     *
+     * Useful for testing or running in sandboxed environments.
+     *
+     * @defaultValue os.homedir()
+     */
+    homeDir?: string;
+    /**
+     * Create parent directories if they don't exist when writing.
+     *
+     * @defaultValue true
+     */
+    createDirs?: boolean;
+    /**
+     * File extension to use for memory documents.
+     *
+     * @defaultValue ".md"
+     */
+    extension?: string;
+}
+/**
+ * Filesystem-based implementation of MemoryStore.
+ *
+ * Stores memory documents as markdown files on disk.
+ * Handles `~` expansion for home directory paths.
+ *
+ * @example
+ * ```typescript
+ * import { FilesystemMemoryStore } from "@lleverage-ai/agent-sdk";
+ *
+ * // Create with default options
+ * const store = new FilesystemMemoryStore();
+ *
+ * // Create with custom home directory
+ * const store = new FilesystemMemoryStore({
+ *   homeDir: "/custom/home",
+ * });
+ *
+ * // Read a memory document
+ * const doc = await store.read("~/.deepagents/my-agent/agent.md");
+ *
+ * // List all memory documents
+ * const paths = await store.list("~/.deepagents/my-agent");
+ * ```
+ *
+ * @category Memory
+ */
+export declare class FilesystemMemoryStore implements MemoryStore {
+    private readonly homeDir;
+    private readonly createDirs;
+    private readonly extension;
+    /**
+     * Create a new FilesystemMemoryStore.
+     *
+     * @param options - Configuration options
+     */
+    constructor(options?: FilesystemMemoryStoreOptions);
+    /**
+     * Expand `~` in paths to the home directory.
+     *
+     * @param filePath - Path that may contain `~`
+     * @returns Expanded path
+     *
+     * @internal
+     */
+    private expandPath;
+    /**
+     * Read a memory document from the filesystem.
+     *
+     * @param filePath - Path to the memory document
+     * @returns The memory document if found, undefined otherwise
+     */
+    read(filePath: string): Promise<MemoryDocument | undefined>;
+    /**
+     * Write a memory document to the filesystem.
+     *
+     * @param filePath - Path to write to
+     * @param document - Document to write
+     */
+    write(filePath: string, document: MemoryDocument): Promise<void>;
+    /**
+     * Delete a memory document from the filesystem.
+     *
+     * @param filePath - Path to delete
+     * @returns True if deleted, false if it didn't exist
+     */
+    delete(filePath: string): Promise<boolean>;
+    /**
+     * List memory documents matching a pattern.
+     *
+     * @param pattern - Directory or glob pattern to search
+     * @returns Array of paths to matching documents
+     */
+    list(pattern?: string): Promise<string[]>;
+    /**
+     * Check if a memory document exists.
+     *
+     * @param filePath - Path to check
+     * @returns True if the file exists
+     */
+    exists(filePath: string): Promise<boolean>;
+    /**
+     * List all memory documents in a directory recursively.
+     *
+     * @param dirPath - Directory to list
+     * @returns Array of file paths
+     *
+     * @internal
+     */
+    private listDirectory;
+}
+/**
+ * In-memory implementation of MemoryStore for testing.
+ *
+ * Documents are stored in a Map and not persisted.
+ *
+ * @example
+ * ```typescript
+ * const store = new InMemoryMemoryStore();
+ *
+ * await store.write("/test/doc.md", {
+ *   path: "/test/doc.md",
+ *   metadata: {},
+ *   content: "# Test",
+ *   modifiedAt: Date.now(),
+ * });
+ *
+ * const doc = await store.read("/test/doc.md");
+ * ```
+ *
+ * @category Memory
+ */
+export declare class InMemoryMemoryStore implements MemoryStore {
+    private documents;
+    /**
+     * Read a document from memory.
+     */
+    read(path: string): Promise<MemoryDocument | undefined>;
+    /**
+     * Write a document to memory.
+     */
+    write(path: string, document: MemoryDocument): Promise<void>;
+    /**
+     * Delete a document from memory.
+     */
+    delete(path: string): Promise<boolean>;
+    /**
+     * List all documents matching a prefix.
+     */
+    list(pattern?: string): Promise<string[]>;
+    /**
+     * Check if a document exists.
+     */
+    exists(path: string): Promise<boolean>;
+    /**
+     * Clear all documents.
+     *
+     * Useful for test cleanup.
+     */
+    clear(): void;
+    /**
+     * Get the number of documents.
+     */
+    get size(): number;
+}
+/**
+ * Create a new FilesystemMemoryStore.
+ *
+ * @param options - Configuration options
+ * @returns A new FilesystemMemoryStore instance
+ *
+ * @category Memory
+ */
+export declare function createFilesystemMemoryStore(options?: FilesystemMemoryStoreOptions): FilesystemMemoryStore;
+/**
+ * Create a new InMemoryMemoryStore.
+ *
+ * @returns A new InMemoryMemoryStore instance
+ *
+ * @category Memory
+ */
+export declare function createInMemoryMemoryStore(): InMemoryMemoryStore;
+//# sourceMappingURL=filesystem-store.d.ts.map

package/dist/memory/filesystem-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem-store.d.ts","sourceRoot":"","sources":["../../src/memory/filesystem-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAO9D;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,qBAAsB,YAAW,WAAW;IACvD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC;;;;OAIG;gBACS,OAAO,GAAE,4BAAiC;IAMtD;;;;;;;OAOG;IACH,OAAO,CAAC,UAAU;IAOlB;;;;;OAKG;IACG,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAwBjE;;;;;OAKG;IACG,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBtE;;;;;OAKG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAchD;;;;;OAKG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAwB/C;;;;;OAKG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWhD;;;;;;;OAOG;YACW,aAAa;CA2B5B;AAMD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,mBAAoB,YAAW,WAAW;IACrD,OAAO,CAAC,SAAS,CAAqC;IAEtD;;OAEG;IACG,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAW7D;;OAEG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IASlE;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI5C;;OAEG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAU/C;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI5C;;;;OAIG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF;AAMD;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,CAAC,EAAE,4BAA4B,GACrC,qBAAqB,CAEvB;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,IAAI,mBAAmB,CAE/D"}

package/dist/memory/filesystem-store.js

@@ -0,0 +1,343 @@
+/**
+ * Filesystem-based memory store implementation.
+ *
+ * Stores memory documents as markdown files on the local filesystem.
+ * Supports YAML frontmatter for metadata.
+ *
+ * @example
+ * ```typescript
+ * import { FilesystemMemoryStore } from "@lleverage-ai/agent-sdk";
+ *
+ * const store = new FilesystemMemoryStore();
+ *
+ * // Read user-level memory
+ * const userMemory = await store.read("~/.deepagents/my-agent/agent.md");
+ *
+ * // Write project memory
+ * await store.write("/project/.deepagents/agent.md", {
+ *   path: "/project/.deepagents/agent.md",
+ *   metadata: {},
+ *   content: "# Project Rules",
+ *   modifiedAt: Date.now(),
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+import * as fs from "node:fs/promises";
+import * as os from "node:os";
+import * as path from "node:path";
+import { parseMarkdownWithFrontmatter, serializeMarkdownWithFrontmatter } from "./store.js";
+// =============================================================================
+// Filesystem Memory Store Implementation
+// =============================================================================
+/**
+ * Filesystem-based implementation of MemoryStore.
+ *
+ * Stores memory documents as markdown files on disk.
+ * Handles `~` expansion for home directory paths.
+ *
+ * @example
+ * ```typescript
+ * import { FilesystemMemoryStore } from "@lleverage-ai/agent-sdk";
+ *
+ * // Create with default options
+ * const store = new FilesystemMemoryStore();
+ *
+ * // Create with custom home directory
+ * const store = new FilesystemMemoryStore({
+ *   homeDir: "/custom/home",
+ * });
+ *
+ * // Read a memory document
+ * const doc = await store.read("~/.deepagents/my-agent/agent.md");
+ *
+ * // List all memory documents
+ * const paths = await store.list("~/.deepagents/my-agent");
+ * ```
+ *
+ * @category Memory
+ */
+export class FilesystemMemoryStore {
+    homeDir;
+    createDirs;
+    extension;
+    /**
+     * Create a new FilesystemMemoryStore.
+     *
+     * @param options - Configuration options
+     */
+    constructor(options = {}) {
+        this.homeDir = options.homeDir ?? os.homedir();
+        this.createDirs = options.createDirs ?? true;
+        this.extension = options.extension ?? ".md";
+    }
+    /**
+     * Expand `~` in paths to the home directory.
+     *
+     * @param filePath - Path that may contain `~`
+     * @returns Expanded path
+     *
+     * @internal
+     */
+    expandPath(filePath) {
+        if (filePath.startsWith("~")) {
+            return path.join(this.homeDir, filePath.slice(1));
+        }
+        return filePath;
+    }
+    /**
+     * Read a memory document from the filesystem.
+     *
+     * @param filePath - Path to the memory document
+     * @returns The memory document if found, undefined otherwise
+     */
+    async read(filePath) {
+        const expandedPath = this.expandPath(filePath);
+        try {
+            const content = await fs.readFile(expandedPath, "utf-8");
+            const stats = await fs.stat(expandedPath);
+            const { metadata, content: markdownContent } = parseMarkdownWithFrontmatter(content);
+            return {
+                path: filePath, // Keep original path for consistency
+                metadata,
+                content: markdownContent,
+                modifiedAt: stats.mtimeMs,
+            };
+        }
+        catch (error) {
+            // File doesn't exist or can't be read
+            if (error.code === "ENOENT") {
+                return undefined;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Write a memory document to the filesystem.
+     *
+     * @param filePath - Path to write to
+     * @param document - Document to write
+     */
+    async write(filePath, document) {
+        const expandedPath = this.expandPath(filePath);
+        // Create parent directories if needed
+        if (this.createDirs) {
+            const dir = path.dirname(expandedPath);
+            await fs.mkdir(dir, { recursive: true });
+        }
+        // Serialize to markdown with frontmatter
+        const content = serializeMarkdownWithFrontmatter({
+            metadata: document.metadata,
+            content: document.content,
+        });
+        await fs.writeFile(expandedPath, content, "utf-8");
+    }
+    /**
+     * Delete a memory document from the filesystem.
+     *
+     * @param filePath - Path to delete
+     * @returns True if deleted, false if it didn't exist
+     */
+    async delete(filePath) {
+        const expandedPath = this.expandPath(filePath);
+        try {
+            await fs.unlink(expandedPath);
+            return true;
+        }
+        catch (error) {
+            if (error.code === "ENOENT") {
+                return false;
+            }
+            throw error;
+        }
+    }
+    /**
+     * List memory documents matching a pattern.
+     *
+     * @param pattern - Directory or glob pattern to search
+     * @returns Array of paths to matching documents
+     */
+    async list(pattern) {
+        // Default to listing all .md files in the current directory
+        const searchPath = pattern ? this.expandPath(pattern) : ".";
+        try {
+            const stats = await fs.stat(searchPath);
+            if (stats.isDirectory()) {
+                // List all .md files in the directory
+                return this.listDirectory(searchPath);
+            }
+            else if (stats.isFile() && searchPath.endsWith(this.extension)) {
+                // Single file
+                return [pattern ?? searchPath];
+            }
+            return [];
+        }
+        catch (error) {
+            if (error.code === "ENOENT") {
+                return [];
+            }
+            throw error;
+        }
+    }
+    /**
+     * Check if a memory document exists.
+     *
+     * @param filePath - Path to check
+     * @returns True if the file exists
+     */
+    async exists(filePath) {
+        const expandedPath = this.expandPath(filePath);
+        try {
+            await fs.access(expandedPath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * List all memory documents in a directory recursively.
+     *
+     * @param dirPath - Directory to list
+     * @returns Array of file paths
+     *
+     * @internal
+     */
+    async listDirectory(dirPath) {
+        const results = [];
+        async function walk(dir, extension) {
+            try {
+                const entries = await fs.readdir(dir, { withFileTypes: true });
+                for (const entry of entries) {
+                    const fullPath = path.join(dir, entry.name);
+                    if (entry.isDirectory()) {
+                        await walk(fullPath, extension);
+                    }
+                    else if (entry.isFile() && entry.name.endsWith(extension)) {
+                        results.push(fullPath);
+                    }
+                }
+            }
+            catch (error) {
+                // Ignore permission errors for directories
+                if (error.code !== "EACCES") {
+                    throw error;
+                }
+            }
+        }
+        await walk(dirPath, this.extension);
+        return results;
+    }
+}
+// =============================================================================
+// In-Memory Memory Store (for testing)
+// =============================================================================
+/**
+ * In-memory implementation of MemoryStore for testing.
+ *
+ * Documents are stored in a Map and not persisted.
+ *
+ * @example
+ * ```typescript
+ * const store = new InMemoryMemoryStore();
+ *
+ * await store.write("/test/doc.md", {
+ *   path: "/test/doc.md",
+ *   metadata: {},
+ *   content: "# Test",
+ *   modifiedAt: Date.now(),
+ * });
+ *
+ * const doc = await store.read("/test/doc.md");
+ * ```
+ *
+ * @category Memory
+ */
+export class InMemoryMemoryStore {
+    documents = new Map();
+    /**
+     * Read a document from memory.
+     */
+    async read(path) {
+        const doc = this.documents.get(path);
+        if (!doc)
+            return undefined;
+        // Return a copy to prevent mutation
+        return {
+            ...doc,
+            metadata: { ...doc.metadata },
+        };
+    }
+    /**
+     * Write a document to memory.
+     */
+    async write(path, document) {
+        // Store a copy to prevent mutation
+        this.documents.set(path, {
+            ...document,
+            metadata: { ...document.metadata },
+            modifiedAt: Date.now(),
+        });
+    }
+    /**
+     * Delete a document from memory.
+     */
+    async delete(path) {
+        return this.documents.delete(path);
+    }
+    /**
+     * List all documents matching a prefix.
+     */
+    async list(pattern) {
+        if (!pattern) {
+            return Array.from(this.documents.keys());
+        }
+        return Array.from(this.documents.keys()).filter((p) => p.startsWith(pattern) && p.endsWith(".md"));
+    }
+    /**
+     * Check if a document exists.
+     */
+    async exists(path) {
+        return this.documents.has(path);
+    }
+    /**
+     * Clear all documents.
+     *
+     * Useful for test cleanup.
+     */
+    clear() {
+        this.documents.clear();
+    }
+    /**
+     * Get the number of documents.
+     */
+    get size() {
+        return this.documents.size;
+    }
+}
+// =============================================================================
+// Factory Functions
+// =============================================================================
+/**
+ * Create a new FilesystemMemoryStore.
+ *
+ * @param options - Configuration options
+ * @returns A new FilesystemMemoryStore instance
+ *
+ * @category Memory
+ */
+export function createFilesystemMemoryStore(options) {
+    return new FilesystemMemoryStore(options);
+}
+/**
+ * Create a new InMemoryMemoryStore.
+ *
+ * @returns A new InMemoryMemoryStore instance
+ *
+ * @category Memory
+ */
+export function createInMemoryMemoryStore() {
+    return new InMemoryMemoryStore();
+}
+//# sourceMappingURL=filesystem-store.js.map

package/dist/memory/filesystem-store.js.map

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

package/dist/memory/index.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Memory system for persistent agent memory.
+ *
+ * This module provides a two-tier memory architecture:
+ * - **User-Level Memory**: Personal preferences stored at `~/.deepagents/{agentId}/`
+ * - **Project-Level Memory**: Project conventions stored at `[git-root]/.deepagents/`
+ *
+ * Memory documents are markdown files with optional YAML frontmatter for metadata.
+ *
+ * ## Quick Start
+ *
+ * ```typescript
+ * import {
+ *   loadAllMemory,
+ *   buildMemorySection,
+ *   matchesPathPattern,
+ * } from "@lleverage-ai/agent-sdk";
+ *
+ * // Load all agent memory
+ * const memory = await loadAllMemory({
+ *   agentId: "my-agent",
+ *   workingDirectory: process.cwd(),
+ * });
+ *
+ * // Use in system prompt
+ * const systemPrompt = `You are a helpful assistant.\n\n${memory.memorySection}`;
+ *
+ * // Filter by current file
+ * if (matchesPathPattern("src/api/users.ts", "src/api/**\/*.ts")) {
+ *   // Apply API-specific rules
+ * }
+ * ```
+ *
+ * @packageDocumentation
+ */
+export type { FilesystemMemoryStoreOptions } from "./filesystem-store.js";
+export { createFilesystemMemoryStore, createInMemoryMemoryStore, FilesystemMemoryStore, InMemoryMemoryStore, } from "./filesystem-store.js";
+export type { AdditionalMemoryFile, BuildMemorySectionOptions, LoadAdditionalMemoryOptions, LoadAgentMemoryOptions, LoadAllMemoryOptions, LoadAllMemoryResult, MemoryAuditEvent, } from "./loader.js";
+export { buildMemorySection, findGitRoot, getProjectMemoryPath, getUserAgentDir, getUserMemoryPath, loadAdditionalMemoryFiles, loadAgentMemory, loadAllMemory, } from "./loader.js";
+export type { FileMemoryPermissionStoreOptions, MemoryApproval, MemoryPermissionStore, } from "./permissions.js";
+export { computeContentHash, computeFileHash, createInMemoryPermissionStore, createMemoryPermissionStore, FileMemoryPermissionStore, InMemoryPermissionStore, } from "./permissions.js";
+export type { BuildPathMemoryContextOptions, PathMemoryContext, } from "./rules.js";
+export { buildPathMemoryContext, filterAdditionalFilesByPath, filterAutoLoadAdditionalFiles, filterAutoLoadMemories, filterMemoriesByAllTags, filterMemoriesByPath, filterMemoriesByTags, matchesAnyPathPattern, matchesPathPattern, } from "./rules.js";
+export type { MemoryDocument, MemoryMetadata, MemoryStore, ParsedMarkdown, } from "./store.js";
+export { parseMarkdownWithFrontmatter, parseSimpleYaml, serializeMarkdownWithFrontmatter, } from "./store.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,YAAY,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAE1E,OAAO,EACL,2BAA2B,EAC3B,yBAAyB,EACzB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,oBAAoB,EACpB,yBAAyB,EACzB,2BAA2B,EAC3B,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,yBAAyB,EACzB,eAAe,EACf,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,gCAAgC,EAChC,cAAc,EACd,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,6BAA6B,EAC7B,2BAA2B,EAC3B,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,6BAA6B,EAC7B,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,sBAAsB,EACtB,2BAA2B,EAC3B,6BAA6B,EAC7B,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,cAAc,EACd,cAAc,EACd,WAAW,EACX,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,4BAA4B,EAC5B,eAAe,EACf,gCAAgC,GACjC,MAAM,YAAY,CAAC"}

package/dist/memory/index.js

@@ -0,0 +1,46 @@
+/**
+ * Memory system for persistent agent memory.
+ *
+ * This module provides a two-tier memory architecture:
+ * - **User-Level Memory**: Personal preferences stored at `~/.deepagents/{agentId}/`
+ * - **Project-Level Memory**: Project conventions stored at `[git-root]/.deepagents/`
+ *
+ * Memory documents are markdown files with optional YAML frontmatter for metadata.
+ *
+ * ## Quick Start
+ *
+ * ```typescript
+ * import {
+ *   loadAllMemory,
+ *   buildMemorySection,
+ *   matchesPathPattern,
+ * } from "@lleverage-ai/agent-sdk";
+ *
+ * // Load all agent memory
+ * const memory = await loadAllMemory({
+ *   agentId: "my-agent",
+ *   workingDirectory: process.cwd(),
+ * });
+ *
+ * // Use in system prompt
+ * const systemPrompt = `You are a helpful assistant.\n\n${memory.memorySection}`;
+ *
+ * // Filter by current file
+ * if (matchesPathPattern("src/api/users.ts", "src/api/**\/*.ts")) {
+ *   // Apply API-specific rules
+ * }
+ * ```
+ *
+ * @packageDocumentation
+ */
+// Filesystem store implementation
+export { createFilesystemMemoryStore, createInMemoryMemoryStore, FilesystemMemoryStore, InMemoryMemoryStore, } from "./filesystem-store.js";
+// Memory loading functions
+export { buildMemorySection, findGitRoot, getProjectMemoryPath, getUserAgentDir, getUserMemoryPath, loadAdditionalMemoryFiles, loadAgentMemory, loadAllMemory, } from "./loader.js";
+// Permission store for approval persistence
+export { computeContentHash, computeFileHash, createInMemoryPermissionStore, createMemoryPermissionStore, FileMemoryPermissionStore, InMemoryPermissionStore, } from "./permissions.js";
+// Path-based rule matching
+export { buildPathMemoryContext, filterAdditionalFilesByPath, filterAutoLoadAdditionalFiles, filterAutoLoadMemories, filterMemoriesByAllTags, filterMemoriesByPath, filterMemoriesByTags, matchesAnyPathPattern, matchesPathPattern, } from "./rules.js";
+// Store interface and types
+export { parseMarkdownWithFrontmatter, parseSimpleYaml, serializeMarkdownWithFrontmatter, } from "./store.js";
+//# sourceMappingURL=index.js.map

package/dist/memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAGH,kCAAkC;AAClC,OAAO,EACL,2BAA2B,EAC3B,yBAAyB,EACzB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAU/B,2BAA2B;AAC3B,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,yBAAyB,EACzB,eAAe,EACf,aAAa,GACd,MAAM,aAAa,CAAC;AAMrB,4CAA4C;AAC5C,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,6BAA6B,EAC7B,2BAA2B,EAC3B,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAK1B,2BAA2B;AAC3B,OAAO,EACL,sBAAsB,EACtB,2BAA2B,EAC3B,6BAA6B,EAC7B,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAOpB,4BAA4B;AAC5B,OAAO,EACL,4BAA4B,EAC5B,eAAe,EACf,gCAAgC,GACjC,MAAM,YAAY,CAAC"}