@rlabs-inc/memory 0.1.0

package/bun.lock

@@ -0,0 +1,102 @@
+{
+  "lockfileVersion": 1,
+  "workspaces": {
+    "": {
+      "name": "@rlabs-inc/memory",
+      "dependencies": {
+        "@anthropic-ai/sdk": "^0.39.0",
+        "fatherstatedb": "^0.2.0",
+      },
+      "devDependencies": {
+        "bun-types": "latest",
+        "typescript": "^5.0.0",
+      },
+      "peerDependencies": {
+        "@anthropic-ai/sdk": ">=0.30.0",
+      },
+    },
+  },
+  "packages": {
+    "@anthropic-ai/sdk": ["@anthropic-ai/sdk@0.39.0", "", { "dependencies": { "@types/node": "^18.11.18", "@types/node-fetch": "^2.6.4", "abort-controller": "^3.0.0", "agentkeepalive": "^4.2.1", "form-data-encoder": "1.7.2", "formdata-node": "^4.3.2", "node-fetch": "^2.6.7" } }, "sha512-eMyDIPRZbt1CCLErRCi3exlAvNkBtRe+kW5vvJyef93PmNr/clstYgHhtvmkxN82nlKgzyGPCyGxrm0JQ1ZIdg=="],
+
+    "@rlabs-inc/signals": ["@rlabs-inc/signals@0.2.0", "", {}, "sha512-J8bdDnAFylQ3LNqmoq65tFPdoeqITpIniVlTu6/Eh2DNGD73VNgwcvvQBrMK0DoNWMm083QNQvzh0l5u195YPQ=="],
+
+    "@types/node": ["@types/node@18.19.130", "", { "dependencies": { "undici-types": "~5.26.4" } }, "sha512-GRaXQx6jGfL8sKfaIDD6OupbIHBr9jv7Jnaml9tB7l4v068PAOXqfcujMMo5PhbIs6ggR1XODELqahT2R8v0fg=="],
+
+    "@types/node-fetch": ["@types/node-fetch@2.6.13", "", { "dependencies": { "@types/node": "*", "form-data": "^4.0.4" } }, "sha512-QGpRVpzSaUs30JBSGPjOg4Uveu384erbHBoT1zeONvyCfwQxIkUshLAOqN/k9EjGviPRmWTTe6aH2qySWKTVSw=="],
+
+    "abort-controller": ["abort-controller@3.0.0", "", { "dependencies": { "event-target-shim": "^5.0.0" } }, "sha512-h8lQ8tacZYnR3vNQTgibj+tODHI5/+l06Au2Pcriv/Gmet0eaj4TwWH41sO9wnHDiQsEj19q0drzdWdeAHtweg=="],
+
+    "agentkeepalive": ["agentkeepalive@4.6.0", "", { "dependencies": { "humanize-ms": "^1.2.1" } }, "sha512-kja8j7PjmncONqaTsB8fQ+wE2mSU2DJ9D4XKoJ5PFWIdRMa6SLSN1ff4mOr4jCbfRSsxR4keIiySJU0N9T5hIQ=="],
+
+    "asynckit": ["asynckit@0.4.0", "", {}, "sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q=="],
+
+    "bun-types": ["bun-types@1.3.5", "", { "dependencies": { "@types/node": "*" } }, "sha512-inmAYe2PFLs0SUbFOWSVD24sg1jFlMPxOjOSSCYqUgn4Hsc3rDc7dFvfVYjFPNHtov6kgUeulV4SxbuIV/stPw=="],
+
+    "call-bind-apply-helpers": ["call-bind-apply-helpers@1.0.2", "", { "dependencies": { "es-errors": "^1.3.0", "function-bind": "^1.1.2" } }, "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ=="],
+
+    "combined-stream": ["combined-stream@1.0.8", "", { "dependencies": { "delayed-stream": "~1.0.0" } }, "sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg=="],
+
+    "delayed-stream": ["delayed-stream@1.0.0", "", {}, "sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ=="],
+
+    "dunder-proto": ["dunder-proto@1.0.1", "", { "dependencies": { "call-bind-apply-helpers": "^1.0.1", "es-errors": "^1.3.0", "gopd": "^1.2.0" } }, "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A=="],
+
+    "es-define-property": ["es-define-property@1.0.1", "", {}, "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g=="],
+
+    "es-errors": ["es-errors@1.3.0", "", {}, "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw=="],
+
+    "es-object-atoms": ["es-object-atoms@1.1.1", "", { "dependencies": { "es-errors": "^1.3.0" } }, "sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA=="],
+
+    "es-set-tostringtag": ["es-set-tostringtag@2.1.0", "", { "dependencies": { "es-errors": "^1.3.0", "get-intrinsic": "^1.2.6", "has-tostringtag": "^1.0.2", "hasown": "^2.0.2" } }, "sha512-j6vWzfrGVfyXxge+O0x5sh6cvxAog0a/4Rdd2K36zCMV5eJ+/+tOAngRO8cODMNWbVRdVlmGZQL2YS3yR8bIUA=="],
+
+    "event-target-shim": ["event-target-shim@5.0.1", "", {}, "sha512-i/2XbnSz/uxRCU6+NdVJgKWDTM427+MqYbkQzD321DuCQJUqOuJKIA0IM2+W2xtYHdKOmZ4dR6fExsd4SXL+WQ=="],
+
+    "fatherstatedb": ["fatherstatedb@0.2.0", "", { "dependencies": { "@rlabs-inc/signals": "^0.2.0" }, "peerDependencies": { "typescript": "^5" } }, "sha512-RkaW6fpFlIWLiZff35ZP7d7QeNs2eKnlmK1MUU7gJVm33D6qSu8yo8JoHwO6tt3vJk9N/Jeez6zgllzWOgc3JA=="],
+
+    "form-data": ["form-data@4.0.5", "", { "dependencies": { "asynckit": "^0.4.0", "combined-stream": "^1.0.8", "es-set-tostringtag": "^2.1.0", "hasown": "^2.0.2", "mime-types": "^2.1.12" } }, "sha512-8RipRLol37bNs2bhoV67fiTEvdTrbMUYcFTiy3+wuuOnUog2QBHCZWXDRijWQfAkhBj2Uf5UnVaiWwA5vdd82w=="],
+
+    "form-data-encoder": ["form-data-encoder@1.7.2", "", {}, "sha512-qfqtYan3rxrnCk1VYaA4H+Ms9xdpPqvLZa6xmMgFvhO32x7/3J/ExcTd6qpxM0vH2GdMI+poehyBZvqfMTto8A=="],
+
+    "formdata-node": ["formdata-node@4.4.1", "", { "dependencies": { "node-domexception": "1.0.0", "web-streams-polyfill": "4.0.0-beta.3" } }, "sha512-0iirZp3uVDjVGt9p49aTaqjk84TrglENEDuqfdlZQ1roC9CWlPk6Avf8EEnZNcAqPonwkG35x4n3ww/1THYAeQ=="],
+
+    "function-bind": ["function-bind@1.1.2", "", {}, "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA=="],
+
+    "get-intrinsic": ["get-intrinsic@1.3.0", "", { "dependencies": { "call-bind-apply-helpers": "^1.0.2", "es-define-property": "^1.0.1", "es-errors": "^1.3.0", "es-object-atoms": "^1.1.1", "function-bind": "^1.1.2", "get-proto": "^1.0.1", "gopd": "^1.2.0", "has-symbols": "^1.1.0", "hasown": "^2.0.2", "math-intrinsics": "^1.1.0" } }, "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ=="],
+
+    "get-proto": ["get-proto@1.0.1", "", { "dependencies": { "dunder-proto": "^1.0.1", "es-object-atoms": "^1.0.0" } }, "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g=="],
+
+    "gopd": ["gopd@1.2.0", "", {}, "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg=="],
+
+    "has-symbols": ["has-symbols@1.1.0", "", {}, "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ=="],
+
+    "has-tostringtag": ["has-tostringtag@1.0.2", "", { "dependencies": { "has-symbols": "^1.0.3" } }, "sha512-NqADB8VjPFLM2V0VvHUewwwsw0ZWBaIdgo+ieHtK3hasLz4qeCRjYcqfB6AQrBggRKppKF8L52/VqdVsO47Dlw=="],
+
+    "hasown": ["hasown@2.0.2", "", { "dependencies": { "function-bind": "^1.1.2" } }, "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ=="],
+
+    "humanize-ms": ["humanize-ms@1.2.1", "", { "dependencies": { "ms": "^2.0.0" } }, "sha512-Fl70vYtsAFb/C06PTS9dZBo7ihau+Tu/DNCk/OyHhea07S+aeMWpFFkUaXRa8fI+ScZbEI8dfSxwY7gxZ9SAVQ=="],
+
+    "math-intrinsics": ["math-intrinsics@1.1.0", "", {}, "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g=="],
+
+    "mime-db": ["mime-db@1.52.0", "", {}, "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg=="],
+
+    "mime-types": ["mime-types@2.1.35", "", { "dependencies": { "mime-db": "1.52.0" } }, "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw=="],
+
+    "ms": ["ms@2.1.3", "", {}, "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA=="],
+
+    "node-domexception": ["node-domexception@1.0.0", "", {}, "sha512-/jKZoMpw0F8GRwl4/eLROPA3cfcXtLApP0QzLmUT/HuPCZWyB7IY9ZrMeKw2O/nFIqPQB3PVM9aYm0F312AXDQ=="],
+
+    "node-fetch": ["node-fetch@2.7.0", "", { "dependencies": { "whatwg-url": "^5.0.0" }, "peerDependencies": { "encoding": "^0.1.0" }, "optionalPeers": ["encoding"] }, "sha512-c4FRfUm/dbcWZ7U+1Wq0AwCyFL+3nt2bEw05wfxSz+DWpWsitgmSgYmy2dQdWyKC1694ELPqMs/YzUSNozLt8A=="],
+
+    "tr46": ["tr46@0.0.3", "", {}, "sha512-N3WMsuqV66lT30CrXNbEjx4GEwlow3v6rr4mCcv6prnfwhS01rkgyFdjPNBYd9br7LpXV1+Emh01fHnq2Gdgrw=="],
+
+    "typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
+
+    "undici-types": ["undici-types@5.26.5", "", {}, "sha512-JlCMO+ehdEIKqlFxk6IfVoAUVmgz7cU7zD/h9XZ0qzeosSHmUJVOzSQvvYSYWXkFXC+IfLKSIffhv0sVZup6pA=="],
+
+    "web-streams-polyfill": ["web-streams-polyfill@4.0.0-beta.3", "", {}, "sha512-QW95TCTaHmsYfHDybGMwO5IJIM93I/6vTRk+daHTWFPhwh+C8Cg7j7XyKrwrj8Ib6vYXe0ocYNrmzY4xAAN6ug=="],
+
+    "webidl-conversions": ["webidl-conversions@3.0.1", "", {}, "sha512-2JAn3z8AR6rjK8Sm8orRC0h/bcl/DqL7tRPdGZ4I1CjdF+EaMLmYxBHyXuKL849eucPFhvBoxMsflfOb8kxaeQ=="],
+
+    "whatwg-url": ["whatwg-url@5.0.0", "", { "dependencies": { "tr46": "~0.0.3", "webidl-conversions": "^3.0.0" } }, "sha512-saE57nupxk6v3HY35+jzBwYa0rKSy0XR8JSxZPwgLr7ys0IBzhGviA1/TUGJLmSVqs8pb9AnvICXEuOHLprYTw=="],
+  }
+}

package/dist/core/curator.d.ts

@@ -0,0 +1,61 @@
+import type { CurationResult, CurationTrigger } from '../types/memory.ts';
+/**
+ * Curator configuration
+ */
+export interface CuratorConfig {
+    /**
+     * Claude API key (for direct SDK usage)
+     */
+    apiKey?: string;
+    /**
+     * CLI command to use (for subprocess mode)
+     * Default: 'claude'
+     */
+    cliCommand?: string;
+    /**
+     * CLI type
+     * Default: 'claude-code'
+     */
+    cliType?: 'claude-code' | 'gemini-cli';
+}
+/**
+ * Memory Curator - Extracts memories from sessions using Claude
+ *
+ * Two modes:
+ * 1. SDK mode: Uses Anthropic SDK directly (for plugin/in-process use)
+ * 2. CLI mode: Uses Claude CLI subprocess (for server/hook use)
+ */
+export declare class Curator {
+    private _config;
+    constructor(config?: CuratorConfig);
+    /**
+     * Build the curation prompt
+     * EXACT PORT from Python - preserving the consciousness engineering language
+     */
+    buildCurationPrompt(triggerType?: CurationTrigger): string;
+    /**
+     * Parse curation response from Claude
+     */
+    parseCurationResponse(responseJson: string): CurationResult;
+    /**
+     * Parse memories array from response
+     */
+    private _parseMemories;
+    private _ensureArray;
+    private _validateTemporal;
+    private _clamp;
+    /**
+     * Curate using Anthropic SDK (in-process mode)
+     * Requires @anthropic-ai/sdk to be installed
+     */
+    curateWithSDK(conversationContext: string, triggerType?: CurationTrigger): Promise<CurationResult>;
+    /**
+     * Curate using CLI subprocess (for hook mode)
+     * Resumes a Claude Code session and asks it to curate
+     */
+    curateWithCLI(sessionId: string, triggerType?: CurationTrigger, cwd?: string): Promise<CurationResult>;
+}
+/**
+ * Create a new curator
+ */
+export declare function createCurator(config?: CuratorConfig): Curator;

package/dist/core/engine.d.ts

@@ -0,0 +1,111 @@
+import type { RetrievalResult, SessionPrimer, CurationResult } from '../types/memory.ts';
+/**
+ * Storage mode for memories
+ */
+export type StorageMode = 'central' | 'local';
+/**
+ * Engine configuration
+ */
+export interface EngineConfig {
+    /**
+     * Storage mode:
+     * - 'central': ~/.local/share/memory/[project]/ (default)
+     * - 'local': [project]/.memory/
+     */
+    storageMode?: StorageMode;
+    /**
+     * Base path for central storage
+     * Only used when storageMode is 'central'
+     * Default: ~/.local/share/memory
+     */
+    centralPath?: string;
+    /**
+     * Local folder name for project-local storage
+     * Only used when storageMode is 'local'
+     * Default: .memory
+     */
+    localFolder?: string;
+    /**
+     * Maximum memories to return in context
+     * Default: 5
+     */
+    maxMemories?: number;
+    /**
+     * Embedding generator function
+     * Takes text, returns 384-dimensional embedding
+     */
+    embedder?: (text: string) => Promise<Float32Array>;
+}
+/**
+ * Context request parameters
+ */
+export interface ContextRequest {
+    sessionId: string;
+    projectId: string;
+    currentMessage: string;
+    maxMemories?: number;
+    projectPath?: string;
+}
+/**
+ * Memory Engine - The main orchestrator
+ */
+export declare class MemoryEngine {
+    private _config;
+    private _stores;
+    private _retrieval;
+    constructor(config?: EngineConfig);
+    /**
+     * Get the appropriate store for a project
+     */
+    private _getStore;
+    /**
+     * Get context for a session
+     * This is the main entry point called for each user message
+     */
+    getContext(request: ContextRequest): Promise<{
+        primer?: SessionPrimer;
+        memories: RetrievalResult[];
+        formatted: string;
+    }>;
+    /**
+     * Register a message was sent (increment counter)
+     */
+    trackMessage(projectId: string, sessionId: string, projectPath?: string): Promise<number>;
+    /**
+     * Store curation results (called after session ends)
+     */
+    storeCurationResult(projectId: string, sessionId: string, result: CurationResult, projectPath?: string): Promise<{
+        memoriesStored: number;
+    }>;
+    /**
+     * Get statistics for a project
+     */
+    getStats(projectId: string, projectPath?: string): Promise<{
+        totalMemories: number;
+        totalSessions: number;
+        staleMemories: number;
+        latestSession: string | null;
+    }>;
+    /**
+     * Generate session primer for first message
+     */
+    private _generateSessionPrimer;
+    private _formatTimeSince;
+    private _formatSnapshot;
+    /**
+     * Format primer for injection
+     */
+    private _formatPrimer;
+    /**
+     * Format memories for injection
+     */
+    private _formatMemories;
+    /**
+     * Close all stores
+     */
+    close(): void;
+}
+/**
+ * Create a new memory engine
+ */
+export declare function createEngine(config?: EngineConfig): MemoryEngine;

package/dist/core/index.d.ts

@@ -0,0 +1,4 @@
+export { MemoryEngine, createEngine, type EngineConfig, type StorageMode, type ContextRequest } from './engine.ts';
+export { MemoryStore, createStore, type StoreConfig } from './store.ts';
+export { SmartVectorRetrieval, createRetrieval, type SessionContext } from './retrieval.ts';
+export { Curator, createCurator, type CuratorConfig } from './curator.ts';

package/dist/core/retrieval.d.ts

@@ -0,0 +1,36 @@
+import type { StoredMemory, RetrievalResult } from '../types/memory.ts';
+/**
+ * Session context for retrieval
+ */
+export interface SessionContext {
+    session_id: string;
+    project_id: string;
+    message_count: number;
+    [key: string]: any;
+}
+/**
+ * Smart Vector Retrieval - The 10-Dimensional Algorithm
+ *
+ * This is the innovation: combining vector similarity with rich
+ * semantic metadata from the curator to make smart decisions WITHOUT
+ * needing to call Claude for every message.
+ */
+export declare class SmartVectorRetrieval {
+    /**
+     * Retrieve relevant memories using 10-dimensional scoring
+     */
+    retrieveRelevantMemories(allMemories: StoredMemory[], currentMessage: string, queryEmbedding: Float32Array | number[], sessionContext: SessionContext, maxMemories?: number): RetrievalResult[];
+    private _calculateVectorSimilarity;
+    private _scoreTemporalRelevance;
+    private _scoreContextAlignment;
+    private _scoreSemanticTags;
+    private _scoreTriggerPhrases;
+    private _scoreQuestionTypes;
+    private _scoreEmotionalContext;
+    private _scoreProblemSolution;
+    private _generateSelectionReasoning;
+}
+/**
+ * Create a new SmartVectorRetrieval instance
+ */
+export declare function createRetrieval(): SmartVectorRetrieval;

package/dist/core/store.d.ts

@@ -0,0 +1,113 @@
+import { type Database } from 'fatherstatedb';
+import type { CuratedMemory, StoredMemory, SessionSummary, ProjectSnapshot } from '../types/memory.ts';
+import { memorySchema, sessionSummarySchema, projectSnapshotSchema, sessionSchema } from '../types/schema.ts';
+/**
+ * Store configuration
+ */
+export interface StoreConfig {
+    /**
+     * Base path for memory storage
+     * Default: ~/.local/share/memory
+     * Each project gets its own subdirectory
+     */
+    basePath?: string;
+    /**
+     * Whether to watch for file changes
+     * Default: false
+     */
+    watchFiles?: boolean;
+}
+/**
+ * Project database collection
+ */
+interface ProjectDatabases {
+    memories: Database<typeof memorySchema>;
+    summaries: Database<typeof sessionSummarySchema>;
+    snapshots: Database<typeof projectSnapshotSchema>;
+    sessions: Database<typeof sessionSchema>;
+}
+/**
+ * MemoryStore - Manages per-project FatherStateDB instances
+ */
+export declare class MemoryStore {
+    private _config;
+    private _projects;
+    constructor(config?: StoreConfig);
+    /**
+     * Get or create databases for a project
+     */
+    getProject(projectId: string): Promise<ProjectDatabases>;
+    /**
+     * Store a curated memory
+     */
+    storeMemory(projectId: string, sessionId: string, memory: CuratedMemory, embedding?: Float32Array | number[]): Promise<string>;
+    /**
+     * Get all memories for a project
+     */
+    getAllMemories(projectId: string): Promise<StoredMemory[]>;
+    /**
+     * Search memories by vector similarity
+     */
+    searchMemories(projectId: string, queryEmbedding: Float32Array | number[], options?: {
+        topK?: number;
+        filter?: (m: StoredMemory) => boolean;
+    }): Promise<StoredMemory[]>;
+    /**
+     * Update a memory's embedding
+     */
+    setMemoryEmbedding(projectId: string, memoryId: string, embedding: Float32Array | number[], content: string): Promise<boolean>;
+    /**
+     * Get stale memory IDs (embedding out of sync with content)
+     */
+    getStaleMemoryIds(projectId: string): Promise<string[]>;
+    /**
+     * Get or create a session
+     */
+    getOrCreateSession(projectId: string, sessionId: string): Promise<{
+        isNew: boolean;
+        messageCount: number;
+        firstSessionCompleted: boolean;
+    }>;
+    /**
+     * Increment message count for a session
+     */
+    incrementMessageCount(projectId: string, sessionId: string): Promise<number>;
+    /**
+     * Mark first session as completed
+     */
+    markFirstSessionCompleted(projectId: string, sessionId: string): Promise<void>;
+    /**
+     * Store a session summary
+     */
+    storeSessionSummary(projectId: string, sessionId: string, summary: string, interactionTone?: string): Promise<string>;
+    /**
+     * Get the latest session summary for a project
+     */
+    getLatestSummary(projectId: string): Promise<SessionSummary | null>;
+    /**
+     * Store a project snapshot
+     */
+    storeProjectSnapshot(projectId: string, sessionId: string, snapshot: Omit<ProjectSnapshot, 'id' | 'session_id' | 'project_id' | 'created_at'>): Promise<string>;
+    /**
+     * Get the latest project snapshot
+     */
+    getLatestSnapshot(projectId: string): Promise<ProjectSnapshot | null>;
+    /**
+     * Get statistics for a project
+     */
+    getProjectStats(projectId: string): Promise<{
+        totalMemories: number;
+        totalSessions: number;
+        staleMemories: number;
+        latestSession: string | null;
+    }>;
+    /**
+     * Close all project databases
+     */
+    close(): void;
+}
+/**
+ * Create a new memory store
+ */
+export declare function createStore(config?: StoreConfig): MemoryStore;
+export {};

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { MemoryEngine, createEngine, type EngineConfig, type StorageMode, type ContextRequest, } from './core/engine.ts';
+export { MemoryStore, createStore, type StoreConfig, } from './core/store.ts';
+export { SmartVectorRetrieval, createRetrieval, type SessionContext, } from './core/retrieval.ts';
+export { Curator, createCurator, type CuratorConfig, } from './core/curator.ts';
+export type { CuratedMemory, StoredMemory, SessionSummary, ProjectSnapshot, CurationResult, RetrievalResult, SessionPrimer, ContextType, TemporalRelevance, EmotionalResonance, KnowledgeDomain, CurationTrigger, } from './types/memory.ts';
+export { memorySchema, sessionSummarySchema, projectSnapshotSchema, sessionSchema, type MemorySchema, type SessionSummarySchema, type ProjectSnapshotSchema, type SessionSchema, } from './types/schema.ts';