@hasna/mementos 0.1.1 → 0.2.0

package/dist/db/agents.d.ts

@@ -3,4 +3,10 @@ import type { Agent } from "../types/index.js";
 export declare function registerAgent(name: string, description?: string, role?: string, db?: Database): Agent;
 export declare function getAgent(idOrName: string, db?: Database): Agent | null;
 export declare function listAgents(db?: Database): Agent[];
+export declare function updateAgent(id: string, updates: {
+    name?: string;
+    description?: string;
+    role?: string;
+    metadata?: Record<string, unknown>;
+}, db?: Database): Agent | null;
 //# sourceMappingURL=agents.d.ts.map

package/dist/db/agents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/db/agents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAe/C,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,MAAM,EACpB,IAAI,CAAC,EAAE,MAAM,EACb,EAAE,CAAC,EAAE,QAAQ,GACZ,KAAK,CAqCP;AAED,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,MAAM,EAChB,EAAE,CAAC,EAAE,QAAQ,GACZ,KAAK,GAAG,IAAI,CAsBd;AAED,wBAAgB,UAAU,CAAC,EAAE,CAAC,EAAE,QAAQ,GAAG,KAAK,EAAE,CAMjD"}
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/db/agents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAe/C,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,MAAM,EACpB,IAAI,CAAC,EAAE,MAAM,EACb,EAAE,CAAC,EAAE,QAAQ,GACZ,KAAK,CAqCP;AAED,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,MAAM,EAChB,EAAE,CAAC,EAAE,QAAQ,GACZ,KAAK,GAAG,IAAI,CAsBd;AAED,wBAAgB,UAAU,CAAC,EAAE,CAAC,EAAE,QAAQ,GAAG,KAAK,EAAE,CAMjD;AAED,wBAAgB,WAAW,CACzB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,EACnG,EAAE,CAAC,EAAE,QAAQ,GACZ,KAAK,GAAG,IAAI,CAkCd"}

package/dist/db/memories.d.ts

@@ -1,5 +1,6 @@
 import { Database } from "bun:sqlite";
 import type { CreateMemoryInput, DedupeMode, Memory, MemoryFilter, UpdateMemoryInput } from "../types/index.js";
+export declare function parseMemoryRow(row: Record<string, unknown>): Memory;
 export declare function createMemory(input: CreateMemoryInput, dedupeMode?: DedupeMode, db?: Database): Memory;
 export declare function getMemory(id: string, db?: Database): Memory | null;
 export declare function getMemoryByKey(key: string, scope?: string, agentId?: string, projectId?: string, sessionId?: string, db?: Database): Memory | null;

package/dist/db/memories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memories.d.ts","sourceRoot":"","sources":["../../src/db/memories.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAyB,MAAM,YAAY,CAAC;AAC7D,OAAO,KAAK,EACV,iBAAiB,EACjB,UAAU,EACV,MAAM,EACN,YAAY,EACZ,iBAAiB,EAClB,MAAM,mBAAmB,CAAC;AAyC3B,wBAAgB,YAAY,CAC1B,KAAK,EAAE,iBAAiB,EACxB,UAAU,GAAE,UAAoB,EAChC,EAAE,CAAC,EAAE,QAAQ,GACZ,MAAM,CAoGR;AAMD,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,CAOlE;AAED,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,EAClB,EAAE,CAAC,EAAE,QAAQ,GACZ,MAAM,GAAG,IAAI,CA4Bf;AAMD,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,EAAE,CA4G3E;AAMD,wBAAgB,YAAY,CAC1B,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,iBAAiB,EACxB,EAAE,CAAC,EAAE,QAAQ,GACZ,MAAM,CAiER;AAMD,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAI/D;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAUvE;AAMD,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,IAAI,CAM3D;AAMD,wBAAgB,oBAAoB,CAAC,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAQ1D"}
+{"version":3,"file":"memories.d.ts","sourceRoot":"","sources":["../../src/db/memories.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAyB,MAAM,YAAY,CAAC;AAC7D,OAAO,KAAK,EACV,iBAAiB,EACjB,UAAU,EACV,MAAM,EACN,YAAY,EACZ,iBAAiB,EAClB,MAAM,mBAAmB,CAAC;AAW3B,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAwBnE;AAMD,wBAAgB,YAAY,CAC1B,KAAK,EAAE,iBAAiB,EACxB,UAAU,GAAE,UAAoB,EAChC,EAAE,CAAC,EAAE,QAAQ,GACZ,MAAM,CAoGR;AAMD,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,CAOlE;AAED,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,EAClB,EAAE,CAAC,EAAE,QAAQ,GACZ,MAAM,GAAG,IAAI,CA4Bf;AAMD,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,EAAE,CA4G3E;AAMD,wBAAgB,YAAY,CAC1B,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,iBAAiB,EACxB,EAAE,CAAC,EAAE,QAAQ,GACZ,MAAM,CAiER;AAMD,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAI/D;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAUvE;AAMD,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,IAAI,CAM3D;AAMD,wBAAgB,oBAAoB,CAAC,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAQ1D"}

package/dist/index.d.ts

@@ -2,7 +2,7 @@ export type { Memory, MemoryWithRelations, MemoryScope, MemoryCategory, MemorySo
 export { MemoryNotFoundError, DuplicateMemoryError, MemoryExpiredError, InvalidScopeError, VersionConflictError, } 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, } from "./db/agents.js";
+export { registerAgent, getAgent, listAgents, updateAgent, } 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";

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,GACnB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,GACrB,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,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,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,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAG7E,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,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,GACnB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,GACrB,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,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAG7E,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -602,6 +602,31 @@ function listAgents(db) {
   const rows = d.query("SELECT * FROM agents ORDER BY last_seen_at DESC").all();
   return rows.map(parseAgentRow);
 }
+function updateAgent(id, updates, db) {
+  const d = db || getDatabase();
+  const agent = getAgent(id, d);
+  if (!agent)
+    return null;
+  const timestamp = now();
+  if (updates.name && updates.name !== agent.name) {
+    const existing = d.query("SELECT id FROM agents WHERE name = ? AND id != ?").get(updates.name, agent.id);
+    if (existing) {
+      throw new Error(`Agent name already taken: ${updates.name}`);
+    }
+    d.run("UPDATE agents SET name = ? WHERE id = ?", [updates.name, agent.id]);
+  }
+  if (updates.description !== undefined) {
+    d.run("UPDATE agents SET description = ? WHERE id = ?", [updates.description, agent.id]);
+  }
+  if (updates.role !== undefined) {
+    d.run("UPDATE agents SET role = ? WHERE id = ?", [updates.role, agent.id]);
+  }
+  if (updates.metadata !== undefined) {
+    d.run("UPDATE agents SET metadata = ? WHERE id = ?", [JSON.stringify(updates.metadata), agent.id]);
+  }
+  d.run("UPDATE agents SET last_seen_at = ? WHERE id = ?", [timestamp, agent.id]);
+  return getAgent(agent.id, d);
+}
 // src/db/projects.ts
 function parseProjectRow(row) {
   return {
@@ -1136,6 +1161,7 @@ var defaultSyncAgents = ["claude", "codex", "gemini"];
 export {
   uuid,
   updateMemory,
+  updateAgent,
   touchMemory,
   syncMemories,
   shortUuid,

package/dist/lib/poll.d.ts

@@ -0,0 +1,17 @@
+import type { Database } from "bun:sqlite";
+import type { Memory, MemoryScope, MemoryCategory } from "../types/index.js";
+export interface PollOptions {
+    interval_ms?: number;
+    scope?: MemoryScope;
+    category?: MemoryCategory;
+    agent_id?: string;
+    project_id?: string;
+    on_memories: (memories: Memory[]) => void;
+    on_error?: (error: Error) => void;
+    db?: Database;
+}
+export interface PollHandle {
+    stop: () => void;
+}
+export declare function startPolling(opts: PollOptions): PollHandle;
+//# sourceMappingURL=poll.d.ts.map

package/dist/lib/poll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"poll.d.ts","sourceRoot":"","sources":["../../src/lib/poll.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAQ7E,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC1C,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAClC,EAAE,CAAC,EAAE,QAAQ,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AAMD,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,GAAG,UAAU,CA0F1D"}

package/dist/lib/project-detect.d.ts

@@ -0,0 +1,18 @@
+import { Database } from "bun:sqlite";
+import type { Project } from "../types/index.js";
+/**
+ * Auto-detect the current project from cwd's git root.
+ * - Finds the git root directory
+ * - Extracts the repo name from the directory basename
+ * - Checks if a project is already registered by path
+ * - If not, registers it automatically
+ * - Returns the Project object, or null if not in a git repo
+ *
+ * Results are cached for the lifetime of the process.
+ */
+export declare function detectProject(db?: Database): Project | null;
+/**
+ * Reset the cached project (useful for tests).
+ */
+export declare function resetProjectCache(): void;
+//# sourceMappingURL=project-detect.d.ts.map

package/dist/lib/project-detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-detect.d.ts","sourceRoot":"","sources":["../../src/lib/project-detect.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAkBjD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,IAAI,CA0B3D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}

package/dist/mcp/index.js

@@ -4577,6 +4577,31 @@ function listAgents(db) {
   const rows = d.query("SELECT * FROM agents ORDER BY last_seen_at DESC").all();
   return rows.map(parseAgentRow);
 }
+function updateAgent(id, updates, db) {
+  const d = db || getDatabase();
+  const agent = getAgent(id, d);
+  if (!agent)
+    return null;
+  const timestamp = now();
+  if (updates.name && updates.name !== agent.name) {
+    const existing = d.query("SELECT id FROM agents WHERE name = ? AND id != ?").get(updates.name, agent.id);
+    if (existing) {
+      throw new Error(`Agent name already taken: ${updates.name}`);
+    }
+    d.run("UPDATE agents SET name = ? WHERE id = ?", [updates.name, agent.id]);
+  }
+  if (updates.description !== undefined) {
+    d.run("UPDATE agents SET description = ? WHERE id = ?", [updates.description, agent.id]);
+  }
+  if (updates.role !== undefined) {
+    d.run("UPDATE agents SET role = ? WHERE id = ?", [updates.role, agent.id]);
+  }
+  if (updates.metadata !== undefined) {
+    d.run("UPDATE agents SET metadata = ? WHERE id = ?", [JSON.stringify(updates.metadata), agent.id]);
+  }
+  d.run("UPDATE agents SET last_seen_at = ? WHERE id = ?", [timestamp, agent.id]);
+  return getAgent(agent.id, d);
+}
 
 // src/db/projects.ts
 function parseProjectRow(row) {
@@ -4622,11 +4647,211 @@ function listProjects(db) {
   return rows.map(parseProjectRow);
 }
 
+// src/lib/search.ts
+function parseMemoryRow2(row) {
+  return {
+    id: row["id"],
+    key: row["key"],
+    value: row["value"],
+    category: row["category"],
+    scope: row["scope"],
+    summary: row["summary"] || null,
+    tags: JSON.parse(row["tags"] || "[]"),
+    importance: row["importance"],
+    source: row["source"],
+    status: row["status"],
+    pinned: !!row["pinned"],
+    agent_id: row["agent_id"] || null,
+    project_id: row["project_id"] || null,
+    session_id: row["session_id"] || null,
+    metadata: JSON.parse(row["metadata"] || "{}"),
+    access_count: row["access_count"],
+    version: row["version"],
+    expires_at: row["expires_at"] || null,
+    created_at: row["created_at"],
+    updated_at: row["updated_at"],
+    accessed_at: row["accessed_at"] || null
+  };
+}
+function determineMatchType(memory, queryLower) {
+  if (memory.key.toLowerCase() === queryLower)
+    return "exact";
+  if (memory.tags.some((t) => t.toLowerCase() === queryLower))
+    return "tag";
+  return "fuzzy";
+}
+function computeScore(memory, queryLower) {
+  let score = 0;
+  const keyLower = memory.key.toLowerCase();
+  if (keyLower === queryLower) {
+    score += 10;
+  } else if (keyLower.includes(queryLower)) {
+    score += 7;
+  }
+  if (memory.tags.some((t) => t.toLowerCase() === queryLower)) {
+    score += 6;
+  }
+  if (memory.summary && memory.summary.toLowerCase().includes(queryLower)) {
+    score += 4;
+  }
+  if (memory.value.toLowerCase().includes(queryLower)) {
+    score += 3;
+  }
+  return score;
+}
+function searchMemories(query, filter, db) {
+  const d = db || getDatabase();
+  const queryLower = query.toLowerCase();
+  const queryParam = `%${query}%`;
+  const conditions = [];
+  const params = [];
+  conditions.push("m.status = 'active'");
+  conditions.push("(m.expires_at IS NULL OR m.expires_at >= datetime('now'))");
+  conditions.push(`(m.key LIKE ? OR m.value LIKE ? OR m.summary LIKE ? OR m.id IN (SELECT memory_id FROM memory_tags WHERE tag LIKE ?))`);
+  params.push(queryParam, queryParam, queryParam, queryParam);
+  if (filter) {
+    if (filter.scope) {
+      if (Array.isArray(filter.scope)) {
+        conditions.push(`m.scope IN (${filter.scope.map(() => "?").join(",")})`);
+        params.push(...filter.scope);
+      } else {
+        conditions.push("m.scope = ?");
+        params.push(filter.scope);
+      }
+    }
+    if (filter.category) {
+      if (Array.isArray(filter.category)) {
+        conditions.push(`m.category IN (${filter.category.map(() => "?").join(",")})`);
+        params.push(...filter.category);
+      } else {
+        conditions.push("m.category = ?");
+        params.push(filter.category);
+      }
+    }
+    if (filter.source) {
+      if (Array.isArray(filter.source)) {
+        conditions.push(`m.source IN (${filter.source.map(() => "?").join(",")})`);
+        params.push(...filter.source);
+      } else {
+        conditions.push("m.source = ?");
+        params.push(filter.source);
+      }
+    }
+    if (filter.status) {
+      conditions.shift();
+      if (Array.isArray(filter.status)) {
+        conditions.push(`m.status IN (${filter.status.map(() => "?").join(",")})`);
+        params.push(...filter.status);
+      } else {
+        conditions.push("m.status = ?");
+        params.push(filter.status);
+      }
+    }
+    if (filter.project_id) {
+      conditions.push("m.project_id = ?");
+      params.push(filter.project_id);
+    }
+    if (filter.agent_id) {
+      conditions.push("m.agent_id = ?");
+      params.push(filter.agent_id);
+    }
+    if (filter.session_id) {
+      conditions.push("m.session_id = ?");
+      params.push(filter.session_id);
+    }
+    if (filter.min_importance) {
+      conditions.push("m.importance >= ?");
+      params.push(filter.min_importance);
+    }
+    if (filter.pinned !== undefined) {
+      conditions.push("m.pinned = ?");
+      params.push(filter.pinned ? 1 : 0);
+    }
+    if (filter.tags && filter.tags.length > 0) {
+      for (const tag of filter.tags) {
+        conditions.push("m.id IN (SELECT memory_id FROM memory_tags WHERE tag = ?)");
+        params.push(tag);
+      }
+    }
+  }
+  const sql = `SELECT m.* FROM memories m WHERE ${conditions.join(" AND ")}`;
+  const rows = d.query(sql).all(...params);
+  const scored = [];
+  for (const row of rows) {
+    const memory = parseMemoryRow2(row);
+    const rawScore = computeScore(memory, queryLower);
+    if (rawScore === 0)
+      continue;
+    const weightedScore = rawScore * memory.importance / 10;
+    const matchType = determineMatchType(memory, queryLower);
+    scored.push({
+      memory,
+      score: weightedScore,
+      match_type: matchType
+    });
+  }
+  scored.sort((a, b) => {
+    if (b.score !== a.score)
+      return b.score - a.score;
+    return b.memory.importance - a.memory.importance;
+  });
+  const offset = filter?.offset ?? 0;
+  const limit = filter?.limit ?? scored.length;
+  return scored.slice(offset, offset + limit);
+}
+
+// src/lib/project-detect.ts
+import { existsSync as existsSync2 } from "fs";
+import { basename, dirname as dirname2, join as join2, resolve as resolve2 } from "path";
+function findGitRoot2(startDir) {
+  let dir = resolve2(startDir);
+  while (true) {
+    if (existsSync2(join2(dir, ".git")))
+      return dir;
+    const parent = dirname2(dir);
+    if (parent === dir)
+      break;
+    dir = parent;
+  }
+  return null;
+}
+var _cachedProject = undefined;
+function detectProject(db) {
+  if (_cachedProject !== undefined)
+    return _cachedProject;
+  const d = db || getDatabase();
+  const cwd = process.cwd();
+  const gitRoot = findGitRoot2(cwd);
+  if (!gitRoot) {
+    _cachedProject = null;
+    return null;
+  }
+  const repoName = basename(gitRoot);
+  const absPath = resolve2(gitRoot);
+  const existing = getProject(absPath, d);
+  if (existing) {
+    _cachedProject = existing;
+    return existing;
+  }
+  const project = registerProject(repoName, absPath, undefined, undefined, d);
+  _cachedProject = project;
+  return project;
+}
+
 // src/mcp/index.ts
 var server = new McpServer({
   name: "mementos",
   version: "0.1.0"
 });
+var _autoProjectInitialized = false;
+function ensureAutoProject() {
+  if (_autoProjectInitialized)
+    return;
+  _autoProjectInitialized = true;
+  try {
+    detectProject();
+  } catch {}
+}
 function formatError(error) {
   if (error instanceof VersionConflictError)
     return `Version conflict: ${error.message}`;
@@ -4686,17 +4911,18 @@ server.tool("memory_save", "Save a memory (create or upsert). Use scope 'global'
   value: exports_external.string().describe("Memory content/value"),
   scope: exports_external.enum(["global", "shared", "private"]).optional().describe("Memory scope (default: private)"),
   category: exports_external.enum(["preference", "fact", "knowledge", "history"]).optional().describe("Memory category (default: knowledge)"),
-  importance: exports_external.number().min(1).max(10).optional().describe("Importance 1-10 (default: 5)"),
+  importance: exports_external.coerce.number().min(1).max(10).optional().describe("Importance 1-10 (default: 5)"),
   tags: exports_external.array(exports_external.string()).optional().describe("Tags for categorization"),
   summary: exports_external.string().optional().describe("Brief summary of the memory"),
   agent_id: exports_external.string().optional().describe("Agent ID (for scoping)"),
   project_id: exports_external.string().optional().describe("Project ID (for scoping)"),
   session_id: exports_external.string().optional().describe("Session ID (for scoping)"),
-  ttl_ms: exports_external.number().optional().describe("Time-to-live in milliseconds"),
+  ttl_ms: exports_external.coerce.number().optional().describe("Time-to-live in milliseconds"),
   source: exports_external.enum(["user", "agent", "system", "auto", "imported"]).optional().describe("Source of the memory"),
   metadata: exports_external.record(exports_external.unknown()).optional().describe("Arbitrary metadata")
 }, async (args) => {
   try {
+    ensureAutoProject();
     const memory = createMemory(args);
     return { content: [{ type: "text", text: `Memory saved:
 ${formatMemory(memory)}` }] };
@@ -4712,12 +4938,31 @@ server.tool("memory_recall", "Recall a memory by key. Returns the best matching
   session_id: exports_external.string().optional()
 }, async (args) => {
   try {
+    ensureAutoProject();
     const memory = getMemoryByKey(args.key, args.scope, args.agent_id, args.project_id, args.session_id);
-    if (!memory) {
-      return { content: [{ type: "text", text: `No memory found for key: ${args.key}` }] };
+    if (memory) {
+      touchMemory(memory.id);
+      return { content: [{ type: "text", text: formatMemory(memory) }] };
     }
-    touchMemory(memory.id);
-    return { content: [{ type: "text", text: formatMemory(memory) }] };
+    const results = searchMemories(args.key, {
+      scope: args.scope,
+      agent_id: args.agent_id,
+      project_id: args.project_id,
+      session_id: args.session_id,
+      limit: 1
+    });
+    if (results.length > 0) {
+      const best = results[0];
+      touchMemory(best.memory.id);
+      return {
+        content: [{
+          type: "text",
+          text: `No exact match for key "${args.key}", showing best result (score: ${best.score.toFixed(2)}, match: ${best.match_type}):
+${formatMemory(best.memory)}`
+        }]
+      };
+    }
+    return { content: [{ type: "text", text: `No memory found for key: ${args.key}` }] };
   } catch (e) {
     return { content: [{ type: "text", text: formatError(e) }], isError: true };
   }
@@ -4726,14 +4971,14 @@ server.tool("memory_list", "List memories with optional filters", {
   scope: exports_external.enum(["global", "shared", "private"]).optional(),
   category: exports_external.enum(["preference", "fact", "knowledge", "history"]).optional(),
   tags: exports_external.array(exports_external.string()).optional(),
-  min_importance: exports_external.number().optional(),
+  min_importance: exports_external.coerce.number().optional(),
   pinned: exports_external.boolean().optional(),
   agent_id: exports_external.string().optional(),
   project_id: exports_external.string().optional(),
   session_id: exports_external.string().optional(),
   status: exports_external.enum(["active", "archived", "expired"]).optional(),
-  limit: exports_external.number().optional().describe("Max results (default: 50)"),
-  offset: exports_external.number().optional()
+  limit: exports_external.coerce.number().optional().describe("Max results (default: 50)"),
+  offset: exports_external.coerce.number().optional()
 }, async (args) => {
   try {
     const filter = {
@@ -4757,14 +5002,14 @@ server.tool("memory_update", "Update a memory's metadata (value, importance, tag
   value: exports_external.string().optional(),
   category: exports_external.enum(["preference", "fact", "knowledge", "history"]).optional(),
   scope: exports_external.enum(["global", "shared", "private"]).optional(),
-  importance: exports_external.number().min(1).max(10).optional(),
+  importance: exports_external.coerce.number().min(1).max(10).optional(),
   tags: exports_external.array(exports_external.string()).optional(),
   summary: exports_external.string().nullable().optional(),
   pinned: exports_external.boolean().optional(),
   status: exports_external.enum(["active", "archived", "expired"]).optional(),
   metadata: exports_external.record(exports_external.unknown()).optional(),
   expires_at: exports_external.string().nullable().optional(),
-  version: exports_external.number().describe("Current version (for optimistic locking)")
+  version: exports_external.coerce.number().describe("Current version (for optimistic locking)")
 }, async (args) => {
   try {
     const id = resolveId(args.id);
@@ -4809,7 +5054,7 @@ server.tool("memory_search", "Search memories by keyword across key, value, summ
   tags: exports_external.array(exports_external.string()).optional(),
   agent_id: exports_external.string().optional(),
   project_id: exports_external.string().optional(),
-  limit: exports_external.number().optional().describe("Max results (default: 20)")
+  limit: exports_external.coerce.number().optional().describe("Max results (default: 20)")
 }, async (args) => {
   try {
     const filter = {
@@ -4898,7 +5143,7 @@ server.tool("memory_import", "Import memories from JSON array", {
     value: exports_external.string(),
     scope: exports_external.enum(["global", "shared", "private"]).optional(),
     category: exports_external.enum(["preference", "fact", "knowledge", "history"]).optional(),
-    importance: exports_external.number().optional(),
+    importance: exports_external.coerce.number().optional(),
     tags: exports_external.array(exports_external.string()).optional(),
     summary: exports_external.string().optional(),
     source: exports_external.enum(["user", "agent", "system", "auto", "imported"]).optional(),
@@ -4924,9 +5169,9 @@ server.tool("memory_inject", "Get formatted memory context for injection into ag
   agent_id: exports_external.string().optional().describe("Agent ID for scope filtering"),
   project_id: exports_external.string().optional().describe("Project ID for scope filtering"),
   session_id: exports_external.string().optional().describe("Session ID for scope filtering"),
-  max_tokens: exports_external.number().optional().describe("Max approximate token budget (default: 500)"),
+  max_tokens: exports_external.coerce.number().optional().describe("Max approximate token budget (default: 500)"),
   categories: exports_external.array(exports_external.enum(["preference", "fact", "knowledge", "history"])).optional(),
-  min_importance: exports_external.number().optional().describe("Minimum importance threshold (default: 3)")
+  min_importance: exports_external.coerce.number().optional().describe("Minimum importance threshold (default: 3)")
 }, async (args) => {
   try {
     const maxTokens = args.max_tokens || 500;
@@ -5059,6 +5304,35 @@ Last seen: ${agent.last_seen_at}`
     return { content: [{ type: "text", text: formatError(e) }], isError: true };
   }
 });
+server.tool("update_agent", "Update an agent's name, description, role, or metadata. Agents can update themselves.", {
+  id: exports_external.string().describe("Agent ID or name"),
+  name: exports_external.string().optional().describe("New agent name"),
+  description: exports_external.string().optional().describe("New description"),
+  role: exports_external.string().optional().describe("New role"),
+  metadata: exports_external.record(exports_external.unknown()).optional().describe("Updated metadata")
+}, async (args) => {
+  try {
+    const { id, ...updates } = args;
+    const agent = updateAgent(id, updates);
+    if (!agent) {
+      return { content: [{ type: "text", text: `Agent not found: ${id}` }] };
+    }
+    return {
+      content: [{
+        type: "text",
+        text: `Agent updated:
+ID: ${agent.id}
+Name: ${agent.name}
+Description: ${agent.description || "-"}
+Role: ${agent.role || "agent"}
+Metadata: ${JSON.stringify(agent.metadata)}
+Last seen: ${agent.last_seen_at}`
+      }]
+    };
+  } catch (e) {
+    return { content: [{ type: "text", text: formatError(e) }], isError: true };
+  }
+});
 server.tool("register_project", "Register a project for memory scoping", {
   name: exports_external.string().describe("Project name"),
   path: exports_external.string().describe("Absolute path to project"),
@@ -5108,7 +5382,7 @@ server.tool("bulk_forget", "Delete multiple memories by IDs", {
 });
 server.tool("bulk_update", "Update multiple memories with the same changes", {
   ids: exports_external.array(exports_external.string()).describe("Memory IDs to update"),
-  importance: exports_external.number().min(1).max(10).optional(),
+  importance: exports_external.coerce.number().min(1).max(10).optional(),
   tags: exports_external.array(exports_external.string()).optional(),
   pinned: exports_external.boolean().optional(),
   category: exports_external.enum(["preference", "fact", "knowledge", "history"]).optional(),
@@ -5142,7 +5416,7 @@ server.tool("memory_context", "Get all memories relevant to the current context.
   agent_id: exports_external.string().optional(),
   project_id: exports_external.string().optional(),
   scope: exports_external.enum(["global", "shared", "private"]).optional().describe("Limit to specific scope"),
-  limit: exports_external.number().optional().describe("Max memories (default: 30)")
+  limit: exports_external.coerce.number().optional().describe("Max memories (default: 30)")
 }, async (args) => {
   try {
     const filter = {

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;AAslBH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAkD9C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AAslBH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAoG9C"}

package/dist/server/index.js

@@ -1158,6 +1158,42 @@ function startServer(port) {
       if (pathname === "/api/health" || pathname === "/health") {
         return json({ status: "ok", version: "0.1.0" });
       }
+      if (pathname === "/api/memories/stream" && req.method === "GET") {
+        const stream = new ReadableStream({
+          start(controller) {
+            const encoder = new TextEncoder;
+            let lastSeen = new Date().toISOString();
+            const send = (data) => {
+              controller.enqueue(encoder.encode(`data: ${JSON.stringify(data)}
+
+`));
+            };
+            send({ type: "connected", timestamp: lastSeen });
+            const interval = setInterval(() => {
+              try {
+                const db = getDatabase();
+                const rows = db.query("SELECT * FROM memories WHERE updated_at > ? OR created_at > ? ORDER BY updated_at DESC LIMIT 50").all(lastSeen, lastSeen);
+                if (rows.length > 0) {
+                  lastSeen = new Date().toISOString();
+                  send({ type: "memories", data: rows, count: rows.length });
+                }
+              } catch {}
+            }, 1000);
+            req.signal.addEventListener("abort", () => {
+              clearInterval(interval);
+              controller.close();
+            });
+          }
+        });
+        return new Response(stream, {
+          headers: {
+            "Content-Type": "text/event-stream",
+            "Cache-Control": "no-cache",
+            Connection: "keep-alive",
+            ...CORS_HEADERS
+          }
+        });
+      }
       const matched = matchRoute(req.method, pathname);
       if (!matched) {
         if (pathname.startsWith("/api/")) {

package/package.json

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