@hasna/mementos 0.4.10 → 0.4.12

package/dist/index.d.ts

@@ -1,11 +1,11 @@
 export type { Memory, MemoryWithRelations, MemoryScope, MemoryCategory, MemorySource, MemoryStatus, MemoryFilter, MemorySearchResult, MemoryStats, CreateMemoryInput, UpdateMemoryInput, DedupeMode, Agent, Project, MementosConfig, SyncDirection, SyncOptions, SyncResult, ConflictResolution, Entity, Relation, EntityMemory, EntityType, RelationType, EntityRole, EntityWithRelations, CreateEntityInput, UpdateEntityInput, CreateRelationInput, } from "./types/index.js";
 export { MemoryNotFoundError, DuplicateMemoryError, MemoryExpiredError, InvalidScopeError, VersionConflictError, EntityNotFoundError, } from "./types/index.js";
 export { getDatabase, closeDatabase, resetDatabase, getDbPath, resolvePartialId, now, uuid, shortUuid, } from "./db/database.js";
-export { createMemory, getMemory, getMemoryByKey, listMemories, updateMemory, deleteMemory, bulkDeleteMemories, touchMemory, cleanExpiredMemories, } from "./db/memories.js";
-export { registerAgent, getAgent, listAgents, updateAgent, } from "./db/agents.js";
+export { createMemory, getMemory, getMemoryByKey, getMemoriesByKey, listMemories, updateMemory, deleteMemory, bulkDeleteMemories, touchMemory, cleanExpiredMemories, getMemoryVersions, } from "./db/memories.js";
+export { registerAgent, getAgent, listAgents, listAgentsByProject, updateAgent, touchAgent, } from "./db/agents.js";
 export { registerProject, getProject, listProjects, } from "./db/projects.js";
 export { searchMemories } from "./lib/search.js";
-export { loadConfig, DEFAULT_CONFIG } from "./lib/config.js";
+export { loadConfig, DEFAULT_CONFIG, getActiveProfile, setActiveProfile, listProfiles, deleteProfile, } from "./lib/config.js";
 export { MemoryInjector } from "./lib/injector.js";
 export type { InjectionOptions } from "./lib/injector.js";
 export { enforceQuotas, archiveStale, archiveUnused, deprioritizeStale, runCleanup } from "./lib/retention.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,YAAY,EACV,MAAM,EACN,mBAAmB,EACnB,WAAW,EACX,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,KAAK,EACL,OAAO,EACP,cAAc,EACd,aAAa,EACb,WAAW,EACX,UAAU,EACV,kBAAkB,EAElB,MAAM,EACN,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,UAAU,EACV,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,WAAW,EACX,aAAa,EACb,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,GAAG,EACH,IAAI,EACJ,SAAS,GACV,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,YAAY,EACZ,SAAS,EACT,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,aAAa,EACb,QAAQ,EACR,UAAU,EACV,WAAW,GACZ,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,eAAe,EACf,UAAU,EACV,YAAY,GACb,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGjD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAG7D,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAG1D,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAG/G,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGhE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGjE,OAAO,EACL,YAAY,EACZ,SAAS,EACT,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,cAAc,GACf,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,cAAc,EACd,WAAW,EACX,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,QAAQ,EACR,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,eAAe,EACf,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,YAAY,EACV,MAAM,EACN,mBAAmB,EACnB,WAAW,EACX,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,KAAK,EACL,OAAO,EACP,cAAc,EACd,aAAa,EACb,WAAW,EACX,UAAU,EACV,kBAAkB,EAElB,MAAM,EACN,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,UAAU,EACV,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,WAAW,EACX,aAAa,EACb,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,GAAG,EACH,IAAI,EACJ,SAAS,GACV,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,YAAY,EACZ,SAAS,EACT,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,aAAa,EACb,QAAQ,EACR,UAAU,EACV,mBAAmB,EACnB,WAAW,EACX,UAAU,GACX,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,eAAe,EACf,UAAU,EACV,YAAY,GACb,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGjD,OAAO,EACL,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,aAAa,GACd,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAG1D,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAG/G,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGhE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGjE,OAAO,EACL,YAAY,EACZ,SAAS,EACT,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,cAAc,GACf,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,cAAc,EACd,WAAW,EACX,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,QAAQ,EACR,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,eAAe,EACf,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -458,6 +458,18 @@ function listAgents(db) {
   const rows = d.query("SELECT * FROM agents ORDER BY last_seen_at DESC").all();
   return rows.map(parseAgentRow);
 }
+function touchAgent(idOrName, db) {
+  const d = db || getDatabase();
+  const agent = getAgent(idOrName, d);
+  if (!agent)
+    return;
+  d.run("UPDATE agents SET last_seen_at = ? WHERE id = ?", [now(), agent.id]);
+}
+function listAgentsByProject(projectId, db) {
+  const d = db || getDatabase();
+  const rows = d.query("SELECT * FROM agents WHERE active_project_id = ? ORDER BY last_seen_at DESC").all(projectId);
+  return rows.map(parseAgentRow);
+}
 function updateAgent(id, updates, db) {
   const d = db || getDatabase();
   const agent = getAgent(id, d);
@@ -1118,6 +1130,63 @@ function loadConfig() {
   }
   return merged;
 }
+function profilesDir() {
+  return join2(homedir(), ".mementos", "profiles");
+}
+function globalConfigPath() {
+  return join2(homedir(), ".mementos", "config.json");
+}
+function readGlobalConfig() {
+  const p = globalConfigPath();
+  if (!existsSync2(p))
+    return {};
+  try {
+    return JSON.parse(readFileSync(p, "utf-8"));
+  } catch {
+    return {};
+  }
+}
+function writeGlobalConfig(data) {
+  const p = globalConfigPath();
+  ensureDir2(dirname2(p));
+  writeFileSync(p, JSON.stringify(data, null, 2), "utf-8");
+}
+function getActiveProfile() {
+  const envProfile = process.env["MEMENTOS_PROFILE"];
+  if (envProfile)
+    return envProfile.trim();
+  const cfg = readGlobalConfig();
+  return cfg["active_profile"] || null;
+}
+function setActiveProfile(name) {
+  const cfg = readGlobalConfig();
+  if (name === null) {
+    delete cfg["active_profile"];
+  } else {
+    cfg["active_profile"] = name;
+  }
+  writeGlobalConfig(cfg);
+}
+function listProfiles() {
+  const dir = profilesDir();
+  if (!existsSync2(dir))
+    return [];
+  return readdirSync(dir).filter((f) => f.endsWith(".db")).map((f) => basename(f, ".db")).sort();
+}
+function deleteProfile(name) {
+  const dbPath = join2(profilesDir(), `${name}.db`);
+  if (!existsSync2(dbPath))
+    return false;
+  unlinkSync(dbPath);
+  if (getActiveProfile() === name)
+    setActiveProfile(null);
+  return true;
+}
+function ensureDir2(dir) {
+  if (!existsSync2(dir)) {
+    mkdirSync2(dir, { recursive: true });
+  }
+}
 
 // src/db/memories.ts
 function runEntityExtraction(memory, projectId, d) {
@@ -1281,6 +1350,26 @@ function getMemoryByKey(key, scope, agentId, projectId, sessionId, db) {
     return null;
   return parseMemoryRow(row);
 }
+function getMemoriesByKey(key, scope, agentId, projectId, db) {
+  const d = db || getDatabase();
+  let sql = "SELECT * FROM memories WHERE key = ?";
+  const params = [key];
+  if (scope) {
+    sql += " AND scope = ?";
+    params.push(scope);
+  }
+  if (agentId) {
+    sql += " AND agent_id = ?";
+    params.push(agentId);
+  }
+  if (projectId) {
+    sql += " AND project_id = ?";
+    params.push(projectId);
+  }
+  sql += " AND status = 'active' ORDER BY importance DESC";
+  const rows = d.query(sql).all(...params);
+  return rows.map(parseMemoryRow);
+}
 function listMemories(filter, db) {
   const d = db || getDatabase();
   const conditions = [];
@@ -1491,6 +1580,28 @@ function cleanExpiredMemories(db) {
   }
   return count;
 }
+function getMemoryVersions(memoryId, db) {
+  const d = db || getDatabase();
+  try {
+    const rows = d.query("SELECT * FROM memory_versions WHERE memory_id = ? ORDER BY version ASC").all(memoryId);
+    return rows.map((row) => ({
+      id: row["id"],
+      memory_id: row["memory_id"],
+      version: row["version"],
+      value: row["value"],
+      importance: row["importance"],
+      scope: row["scope"],
+      category: row["category"],
+      tags: JSON.parse(row["tags"] || "[]"),
+      summary: row["summary"] || null,
+      pinned: !!row["pinned"],
+      status: row["status"],
+      created_at: row["created_at"]
+    }));
+  } catch {
+    return [];
+  }
+}
 // src/lib/search.ts
 function parseMemoryRow2(row) {
   return {
@@ -2376,8 +2487,10 @@ export {
   updateAgent,
   unlinkEntityFromMemory,
   touchMemory,
+  touchAgent,
   syncMemories,
   shortUuid,
+  setActiveProfile,
   searchMemories,
   runCleanup,
   resolvePartialId,
@@ -2392,16 +2505,20 @@ export {
   loadConfig,
   listRelations,
   listProjects,
+  listProfiles,
   listMemories,
   listEntities,
+  listAgentsByProject,
   listAgents,
   linkEntityToMemory,
   getRelation,
   getRelatedEntities,
   getProject,
+  getMemoryVersions,
   getMemoryByKey,
   getMemory,
   getMemoriesForEntity,
+  getMemoriesByKey,
   getEntityMemoryLinks,
   getEntityGraph,
   getEntityByName,
@@ -2410,11 +2527,13 @@ export {
   getDbPath,
   getDatabase,
   getAgent,
+  getActiveProfile,
   findPath,
   extractEntities,
   enforceQuotas,
   deprioritizeStale,
   deleteRelation,
+  deleteProfile,
   deleteMemory,
   deleteEntity,
   defaultSyncAgents,

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AAkkCH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CA2G9C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AAkkCH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAkH9C"}

package/dist/server/index.js

@@ -3,7 +3,7 @@
 
 // src/server/index.ts
 import { existsSync as existsSync3 } from "fs";
-import { dirname as dirname3, extname, join as join3 } from "path";
+import { dirname as dirname3, extname, join as join3, resolve as resolve3, sep } from "path";
 import { fileURLToPath } from "url";
 
 // src/types/index.ts
@@ -2832,8 +2832,10 @@ async function findFreePort(start) {
   return start;
 }
 function startServer(port) {
+  const hostname = process.env["MEMENTOS_HOST"] ?? "127.0.0.1";
   Bun.serve({
     port,
+    hostname,
     async fetch(req) {
       const url = new URL(req.url);
       const { pathname } = url;
@@ -2842,7 +2844,7 @@ function startServer(port) {
       }
       if (pathname === "/api/health" || pathname === "/health") {
         const profile = getActiveProfile();
-        return json({ status: "ok", version: "0.1.0", profile: profile ?? "default", db_path: getDbPath2() });
+        return json({ status: "ok", version: "0.1.0", profile: profile ?? "default", db_path: getDbPath2(), hostname });
       }
       if (pathname === "/api/profile" && req.method === "GET") {
         const profile = getActiveProfile();
@@ -2892,9 +2894,13 @@ function startServer(port) {
         const dashDir = resolveDashboardDir();
         if (existsSync3(dashDir) && (req.method === "GET" || req.method === "HEAD")) {
           if (pathname !== "/") {
-            const staticRes = serveStaticFile(join3(dashDir, pathname));
-            if (staticRes)
-              return staticRes;
+            const resolvedDash = resolve3(dashDir) + sep;
+            const requestedPath = resolve3(join3(dashDir, pathname));
+            if (requestedPath.startsWith(resolvedDash)) {
+              const staticRes = serveStaticFile(requestedPath);
+              if (staticRes)
+                return staticRes;
+            }
           }
           const indexRes = serveStaticFile(join3(dashDir, "index.html"));
           if (indexRes)
@@ -2911,7 +2917,7 @@ function startServer(port) {
       }
     }
   });
-  console.log(`Mementos server listening on http://localhost:${port}`);
+  console.log(`Mementos server listening on http://${hostname}:${port}`);
 }
 async function main() {
   const requestedPort = parsePort();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/mementos",
-  "version": "0.4.10",
+  "version": "0.4.12",
   "description": "Universal memory system for AI agents - CLI + MCP server + library API",
   "type": "module",
   "main": "dist/index.js",