multimodemind 0.0.1 → 0.1.0

package/dist/tools/sources.js

@@ -0,0 +1,34 @@
+/**
+ * MCP tool: sources
+ * Returns health and metadata for all configured stores.
+ * Copyright Old Cart Technology LLC — MIT License
+ */
+export function registerSourcesTool(server, stores) {
+    server.tool('sources', 'List all configured memory stores, their availability, and entry counts.', {}, // no input params
+    async () => {
+        const results = await Promise.allSettled(stores.map((s) => s.sources()));
+        const lines = ['# Memory sources\n'];
+        for (let i = 0; i < results.length; i++) {
+            const result = results[i];
+            const store = stores[i];
+            if (result.status === 'fulfilled') {
+                const info = result.value;
+                const status = info.available ? '✓' : '✗';
+                const count = info.entryCount !== undefined ? ` | ${info.entryCount} entries` : '';
+                const size = info.sizeBytes !== undefined
+                    ? ` | ${(info.sizeBytes / 1024).toFixed(1)}KB`
+                    : '';
+                const path = info.path ? ` | path: ${info.path}` : '';
+                const err = info.error ? ` | error: ${info.error}` : '';
+                lines.push(`${status} **${info.type}** (${info.name})${count}${size}${path}${err}`);
+            }
+            else {
+                lines.push(`✗ **${store.type}** — failed to query: ${String(result.reason)}`);
+            }
+        }
+        return {
+            content: [{ type: 'text', text: lines.join('\n') }],
+        };
+    });
+}
+//# sourceMappingURL=sources.js.map

package/dist/tools/sources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources.js","sourceRoot":"","sources":["../../src/tools/sources.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,MAAqB;IAC1E,MAAM,CAAC,IAAI,CACT,SAAS,EACT,0EAA0E,EAC1E,EAAE,EAAE,kBAAkB;IACtB,KAAK,IAAI,EAAE;QACT,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAEzE,MAAM,KAAK,GAAa,CAAC,oBAAoB,CAAC,CAAC;QAE/C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC;YAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;YAEzB,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;gBAClC,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC;gBAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;gBAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,UAAU,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;gBACnF,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,KAAK,SAAS;oBACvC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;oBAC9C,CAAC,CAAC,EAAE,CAAC;gBACP,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACtD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACxD,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,MAAM,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,IAAI,IAAI,KAAK,GAAG,IAAI,GAAG,IAAI,GAAG,GAAG,EAAE,CAAC,CAAC;YACtF,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,IAAI,yBAAyB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAChF,CAAC;QACH,CAAC;QAED,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;SAC7D,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/store.d.ts

@@ -0,0 +1,10 @@
+/**
+ * MCP tool: store
+ * Persists a memory entry, generates an embedding, routes to the target store.
+ * Copyright Old Cart Technology LLC — MIT License
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { MemoryStore } from '../stores/base.js';
+import type { EmbeddingProvider } from '../embeddings/base.js';
+export declare function registerStoreTool(server: McpServer, stores: MemoryStore[], embedder: EmbeddingProvider): void;
+//# sourceMappingURL=store.d.ts.map

package/dist/tools/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/tools/store.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAa/D,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,WAAW,EAAE,EACrB,QAAQ,EAAE,iBAAiB,GAC1B,IAAI,CA2CN"}

package/dist/tools/store.js

@@ -0,0 +1,51 @@
+/**
+ * MCP tool: store
+ * Persists a memory entry, generates an embedding, routes to the target store.
+ * Copyright Old Cart Technology LLC — MIT License
+ */
+import { z } from 'zod';
+const STORE_TYPES = ['sqlite', 'leveldb', 'markdown', 'files', 'vector'];
+const StoreInput = z.object({
+    content: z.string().min(1).describe('The text content to store in memory'),
+    metadata: z.record(z.string(), z.unknown()).optional()
+        .describe('Arbitrary key-value metadata to attach to this entry'),
+    store: z.enum(STORE_TYPES).optional()
+        .describe('Target store type. Omit to use auto-routing (sqlite by default in v1)'),
+});
+export function registerStoreTool(server, stores, embedder) {
+    server.tool('store', 'Persist content to agent memory with optional metadata and target store.', StoreInput.shape, async ({ content, metadata = {}, store: storeType }) => {
+        // Auto-route: in v1, default to sqlite; v2 will classify content type
+        const targetType = storeType ?? 'sqlite';
+        const target = stores.find((s) => s.type === targetType);
+        if (!target) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Error: store type "${targetType}" is not configured.`,
+                    }],
+                isError: true,
+            };
+        }
+        // Generate embedding
+        let embedding;
+        try {
+            embedding = await embedder.embed(content);
+        }
+        catch (err) {
+            console.warn('[mmind:store] Embedding failed, storing without vector:', err);
+        }
+        const id = await target.store({
+            content,
+            metadata: metadata,
+            storeType: targetType,
+            embedding,
+        });
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Stored to ${targetType} (id: ${id})`,
+                }],
+        };
+    });
+}
+//# sourceMappingURL=store.js.map

package/dist/tools/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/tools/store.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,MAAM,WAAW,GAAgC,CAAC,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;AAEtG,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IAC1E,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;SACnD,QAAQ,CAAC,sDAAsD,CAAC;IACnE,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,QAAQ,EAAE;SAClC,QAAQ,CAAC,uEAAuE,CAAC;CACrF,CAAC,CAAC;AAEH,MAAM,UAAU,iBAAiB,CAC/B,MAAiB,EACjB,MAAqB,EACrB,QAA2B;IAE3B,MAAM,CAAC,IAAI,CACT,OAAO,EACP,0EAA0E,EAC1E,UAAU,CAAC,KAAK,EAChB,KAAK,EAAE,EAAE,OAAO,EAAE,QAAQ,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE;QACrD,sEAAsE;QACtE,MAAM,UAAU,GAAc,SAAS,IAAI,QAAQ,CAAC;QACpD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;QAEzD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,sBAAsB,UAAU,sBAAsB;qBAC7D,CAAC;gBACF,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,qBAAqB;QACrB,IAAI,SAA+B,CAAC;QACpC,IAAI,CAAC;YACH,SAAS,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC5C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,yDAAyD,EAAE,GAAG,CAAC,CAAC;QAC/E,CAAC;QAED,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC;YAC5B,OAAO;YACP,QAAQ,EAAE,QAAmC;YAC7C,SAAS,EAAE,UAAU;YACrB,SAAS;SACV,CAAC,CAAC;QAEH,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,aAAa,UAAU,SAAS,EAAE,GAAG;iBAC5C,CAAC;SACH,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Core types for Multimode Mind
+ * Copyright Old Cart Technology LLC — MIT License
+ */
+export type StoreType = 'sqlite' | 'leveldb' | 'markdown' | 'files' | 'vector';
+export interface MemoryEntry {
+    id: string;
+    content: string;
+    metadata: Record<string, unknown>;
+    storeType: StoreType;
+    createdAt: string;
+    updatedAt: string;
+    embedding?: number[];
+}
+export interface RankedEntry {
+    entry: MemoryEntry;
+    /** 0–1, higher is more relevant */
+    score: number;
+    /** Human-readable provenance: "sqlite:notes", "markdown:vault/ideas.md" */
+    source: string;
+}
+export interface RetrieveResult {
+    entries: RankedEntry[];
+    query: string;
+    totalCandidates: number;
+    storesQueried: StoreType[];
+    conflicts?: ConflictNote[];
+}
+/** Reserved for v2 conflict detection */
+export interface ConflictNote {
+    entryIds: [string, string];
+    description: string;
+}
+export interface SourceInfo {
+    type: StoreType;
+    name: string;
+    available: boolean;
+    path?: string;
+    entryCount?: number;
+    sizeBytes?: number;
+    error?: string;
+}
+export interface MultimodeMindConfig {
+    /** Absolute path to the Markdown vault directory */
+    vaultPath?: string;
+    /** Absolute path to the general files directory */
+    filesPath?: string;
+    /** Absolute path to the SQLite database file */
+    sqlitePath?: string;
+    /** Absolute path to the LevelDB directory */
+    leveldbPath?: string;
+    /** Absolute path to persist the Vectra vector index */
+    vectorIndexPath?: string;
+    /** OpenAI API key — falls back to OPENAI_API_KEY env var */
+    openAiApiKey?: string;
+    /** Max results returned by retrieve() across all stores */
+    retrieveLimit?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;AAI/E,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAID,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,WAAW,CAAC;IACnB,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,SAAS,EAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,YAAY,EAAE,CAAC;CAC5B;AAED,yCAAyC;AACzC,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;CACrB;AAID,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID,MAAM,WAAW,mBAAmB;IAClC,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,4DAA4D;IAC5D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB"}

package/dist/types.js

@@ -0,0 +1,6 @@
+/**
+ * Core types for Multimode Mind
+ * Copyright Old Cart Technology LLC — MIT License
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -1,19 +1,62 @@
 {
   "name": "multimodemind",
-  "version": "0.0.1",
-  "description": "Placeholder. This package name is reserved; a real release is coming.",
-  "license": "MIT",
-  "author": "benmclendon@gmail.com",
-  "keywords": [
-    "mmind",
-    "multimodemind"
-  ],
-  "main": "index.js",
+  "version": "0.1.0",
+  "description": "Multi-store memory layer for AI agents, exposed over MCP",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "mmind": "dist/index.js"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=20.0.0"
+  },
   "files": [
-    "index.js",
-    "README.md"
+    "dist",
+    "README.md",
+    "LICENSE"
   ],
-  "publishConfig": {
-    "access": "public"
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "lint": "tsc --noEmit",
+    "dashboard": "tsx src/cli/dashboard.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "memory",
+    "ai-agent",
+    "sqlite",
+    "vector",
+    "leveldb",
+    "obsidian"
+  ],
+  "author": "Old Cart Technology LLC",
+  "license": "MIT",
+  "dependencies": {
+    "@huggingface/transformers": "^4.2.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "better-sqlite3": "^12.11.1",
+    "fast-glob": "^3.3.3",
+    "gray-matter": "^4.0.3",
+    "level": "^10.0.0",
+    "openai": "^6.48.0",
+    "user": "^0.0.0",
+    "vectra": "^0.15.0",
+    "zod": "^4.4.3"
+  },
+  "overrides": {
+    "adm-zip": ">=0.6.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^26.1.1",
+    "tsx": "^4.23.1",
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.10"
   }
 }

package/index.js

@@ -1 +0,0 @@
-module.exports = {};