@hasna/mementos 0.1.1 → 0.1.2

package/dist/cli/index.js

@@ -4,6 +4,7 @@ var __create = Object.create;
 var __getProtoOf = Object.getPrototypeOf;
 var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __toESM = (mod, isNodeMode, target) => {
   target = mod != null ? __create(__getProtoOf(mod)) : {};
@@ -16,7 +17,31 @@ var __toESM = (mod, isNodeMode, target) => {
       });
   return to;
 };
+var __moduleCache = /* @__PURE__ */ new WeakMap;
+var __toCommonJS = (from) => {
+  var entry = __moduleCache.get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function")
+    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    }));
+  __moduleCache.set(from, entry);
+  return entry;
+};
 var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 var __require = import.meta.require;
 
 // node_modules/commander/lib/error.js
@@ -2053,28 +2078,6 @@ var require_commander = __commonJS((exports) => {
   exports.InvalidOptionArgumentError = InvalidArgumentError;
 });
 
-// node_modules/commander/esm.mjs
-var import__ = __toESM(require_commander(), 1);
-var {
-  program,
-  createCommand,
-  createArgument,
-  createOption,
-  CommanderError,
-  InvalidArgumentError,
-  InvalidOptionArgumentError,
-  Command,
-  Argument,
-  Option,
-  Help
-} = import__.default;
-
-// src/cli/index.tsx
-import chalk from "chalk";
-import { readFileSync as readFileSync2 } from "fs";
-import { dirname as dirname3, join as join3, resolve as resolve3 } from "path";
-import { fileURLToPath } from "url";
-
 // src/db/database.ts
 import { Database } from "bun:sqlite";
 import { existsSync, mkdirSync } from "fs";
@@ -2132,8 +2135,59 @@ function ensureDir(filePath) {
     mkdirSync(dir, { recursive: true });
   }
 }
-var MIGRATIONS = [
-  `
+function getDatabase(dbPath) {
+  if (_db)
+    return _db;
+  const path = dbPath || getDbPath();
+  ensureDir(path);
+  _db = new Database(path, { create: true });
+  _db.run("PRAGMA journal_mode = WAL");
+  _db.run("PRAGMA busy_timeout = 5000");
+  _db.run("PRAGMA foreign_keys = ON");
+  runMigrations(_db);
+  return _db;
+}
+function runMigrations(db) {
+  try {
+    const result = db.query("SELECT MAX(id) as max_id FROM _migrations").get();
+    const currentLevel = result?.max_id ?? 0;
+    for (let i = currentLevel;i < MIGRATIONS.length; i++) {
+      try {
+        db.exec(MIGRATIONS[i]);
+      } catch {}
+    }
+  } catch {
+    for (const migration of MIGRATIONS) {
+      try {
+        db.exec(migration);
+      } catch {}
+    }
+  }
+}
+function now() {
+  return new Date().toISOString();
+}
+function uuid() {
+  return crypto.randomUUID();
+}
+function shortUuid() {
+  return crypto.randomUUID().slice(0, 8);
+}
+function resolvePartialId(db, table, partialId) {
+  if (partialId.length >= 36) {
+    const row = db.query(`SELECT id FROM ${table} WHERE id = ?`).get(partialId);
+    return row?.id ?? null;
+  }
+  const rows = db.query(`SELECT id FROM ${table} WHERE id LIKE ?`).all(`${partialId}%`);
+  if (rows.length === 1) {
+    return rows[0].id;
+  }
+  return null;
+}
+var MIGRATIONS, _db = null;
+var init_database = __esm(() => {
+  MIGRATIONS = [
+    `
   CREATE TABLE IF NOT EXISTS projects (
     id TEXT PRIMARY KEY,
     name TEXT NOT NULL,
@@ -2220,75 +2274,29 @@ var MIGRATIONS = [
 
   INSERT OR IGNORE INTO _migrations (id) VALUES (1);
   `
-];
-var _db = null;
-function getDatabase(dbPath) {
-  if (_db)
-    return _db;
-  const path = dbPath || getDbPath();
-  ensureDir(path);
-  _db = new Database(path, { create: true });
-  _db.run("PRAGMA journal_mode = WAL");
-  _db.run("PRAGMA busy_timeout = 5000");
-  _db.run("PRAGMA foreign_keys = ON");
-  runMigrations(_db);
-  return _db;
-}
-function runMigrations(db) {
-  try {
-    const result = db.query("SELECT MAX(id) as max_id FROM _migrations").get();
-    const currentLevel = result?.max_id ?? 0;
-    for (let i = currentLevel;i < MIGRATIONS.length; i++) {
-      try {
-        db.exec(MIGRATIONS[i]);
-      } catch {}
-    }
-  } catch {
-    for (const migration of MIGRATIONS) {
-      try {
-        db.exec(migration);
-      } catch {}
-    }
-  }
-}
-function now() {
-  return new Date().toISOString();
-}
-function uuid() {
-  return crypto.randomUUID();
-}
-function shortUuid() {
-  return crypto.randomUUID().slice(0, 8);
-}
-function resolvePartialId(db, table, partialId) {
-  if (partialId.length >= 36) {
-    const row = db.query(`SELECT id FROM ${table} WHERE id = ?`).get(partialId);
-    return row?.id ?? null;
-  }
-  const rows = db.query(`SELECT id FROM ${table} WHERE id LIKE ?`).all(`${partialId}%`);
-  if (rows.length === 1) {
-    return rows[0].id;
-  }
-  return null;
-}
+  ];
+});
 
 // src/types/index.ts
-class MemoryNotFoundError extends Error {
-  constructor(id) {
-    super(`Memory not found: ${id}`);
-    this.name = "MemoryNotFoundError";
-  }
-}
-class VersionConflictError extends Error {
-  expected;
-  actual;
-  constructor(id, expected, actual) {
-    super(`Version conflict for memory ${id}: expected ${expected}, got ${actual}`);
-    this.name = "VersionConflictError";
-    this.expected = expected;
-    this.actual = actual;
-  }
-}
+var MemoryNotFoundError, VersionConflictError;
+var init_types = __esm(() => {
+  MemoryNotFoundError = class MemoryNotFoundError extends Error {
+    constructor(id) {
+      super(`Memory not found: ${id}`);
+      this.name = "MemoryNotFoundError";
+    }
+  };
+  VersionConflictError = class VersionConflictError extends Error {
+    expected;
+    actual;
+    constructor(id, expected, actual) {
+      super(`Version conflict for memory ${id}: expected ${expected}, got ${actual}`);
+      this.name = "VersionConflictError";
+      this.expected = expected;
+      this.actual = actual;
+    }
+  };
+});
 
 // src/db/memories.ts
 function parseMemoryRow(row) {
@@ -2591,8 +2599,150 @@ function cleanExpiredMemories(db) {
   const result = d.run("DELETE FROM memories WHERE expires_at IS NOT NULL AND expires_at < ?", [timestamp]);
   return result.changes;
 }
+var init_memories = __esm(() => {
+  init_types();
+  init_database();
+});
+
+// src/lib/poll.ts
+var exports_poll = {};
+__export(exports_poll, {
+  startPolling: () => startPolling
+});
+function startPolling(opts) {
+  const interval = opts.interval_ms ?? 500;
+  const db = opts.db ?? getDatabase();
+  let stopped = false;
+  let inFlight = false;
+  let lastSeen = null;
+  const seedLastSeen = () => {
+    try {
+      const latest = listMemories({
+        scope: opts.scope,
+        category: opts.category,
+        agent_id: opts.agent_id,
+        project_id: opts.project_id,
+        limit: 1
+      }, db);
+      if (latest.length > 0 && latest[0]) {
+        lastSeen = latest[0].updated_at;
+      }
+    } catch (err) {
+      opts.on_error?.(err instanceof Error ? err : new Error(String(err)));
+    }
+  };
+  const poll = () => {
+    if (stopped || inFlight)
+      return;
+    inFlight = true;
+    try {
+      const conditions = ["status = 'active'"];
+      const params = [];
+      if (lastSeen) {
+        conditions.push("(updated_at > ? OR created_at > ?)");
+        params.push(lastSeen, lastSeen);
+      }
+      if (opts.scope) {
+        conditions.push("scope = ?");
+        params.push(opts.scope);
+      }
+      if (opts.category) {
+        conditions.push("category = ?");
+        params.push(opts.category);
+      }
+      if (opts.agent_id) {
+        conditions.push("agent_id = ?");
+        params.push(opts.agent_id);
+      }
+      if (opts.project_id) {
+        conditions.push("project_id = ?");
+        params.push(opts.project_id);
+      }
+      const sql = `SELECT * FROM memories WHERE ${conditions.join(" AND ")} ORDER BY updated_at ASC`;
+      const rows = db.query(sql).all(...params);
+      if (rows.length > 0) {
+        const memories = rows.map(parseMemoryRow3);
+        const lastRow = memories[memories.length - 1];
+        if (lastRow) {
+          lastSeen = lastRow.updated_at;
+        }
+        try {
+          opts.on_memories(memories);
+        } catch (err) {
+          opts.on_error?.(err instanceof Error ? err : new Error(String(err)));
+        }
+      }
+    } catch (err) {
+      opts.on_error?.(err instanceof Error ? err : new Error(String(err)));
+    } finally {
+      inFlight = false;
+    }
+  };
+  seedLastSeen();
+  const timer = setInterval(poll, interval);
+  return {
+    stop: () => {
+      stopped = true;
+      clearInterval(timer);
+    }
+  };
+}
+function parseMemoryRow3(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
+  };
+}
+var init_poll = __esm(() => {
+  init_memories();
+  init_database();
+});
+
+// node_modules/commander/esm.mjs
+var import__ = __toESM(require_commander(), 1);
+var {
+  program,
+  createCommand,
+  createArgument,
+  createOption,
+  CommanderError,
+  InvalidArgumentError,
+  InvalidOptionArgumentError,
+  Command,
+  Argument,
+  Option,
+  Help
+} = import__.default;
+
+// src/cli/index.tsx
+init_database();
+init_memories();
+import chalk from "chalk";
+import { readFileSync as readFileSync2 } from "fs";
+import { dirname as dirname3, join as join3, resolve as resolve3 } from "path";
+import { fileURLToPath } from "url";
 
 // src/db/agents.ts
+init_database();
 function parseAgentRow(row) {
   return {
     id: row["id"],
@@ -2650,8 +2800,34 @@ 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
+init_database();
 function parseProjectRow(row) {
   return {
     id: row["id"],
@@ -2696,6 +2872,7 @@ function listProjects(db) {
 }
 
 // src/lib/search.ts
+init_database();
 function parseMemoryRow2(row) {
   return {
     id: row["id"],
@@ -2929,6 +3106,8 @@ function loadConfig() {
 }
 
 // src/lib/retention.ts
+init_database();
+init_memories();
 function enforceQuotas(config, db) {
   const d = db || getDatabase();
   let totalEvicted = 0;
@@ -3440,6 +3619,47 @@ program2.command("agents").description("List all registered agents").action(() =
     handleError(e);
   }
 });
+program2.command("agent-update <id>").description("Update an agent's name, description, or role").option("--name <name>", "New agent name").option("-d, --description <text>", "New description").option("-r, --role <role>", "New role").action((id, opts) => {
+  try {
+    const globalOpts = program2.opts();
+    const updates = {};
+    if (opts.name !== undefined)
+      updates.name = opts.name;
+    if (opts.description !== undefined)
+      updates.description = opts.description;
+    if (opts.role !== undefined)
+      updates.role = opts.role;
+    if (Object.keys(updates).length === 0) {
+      if (globalOpts.json) {
+        outputJson({ error: "No updates provided. Use --name, --description, or --role." });
+      } else {
+        console.error(chalk.red("No updates provided. Use --name, --description, or --role."));
+      }
+      process.exit(1);
+    }
+    const agent = updateAgent(id, updates);
+    if (!agent) {
+      if (globalOpts.json) {
+        outputJson({ error: `Agent not found: ${id}` });
+      } else {
+        console.error(chalk.red(`Agent not found: ${id}`));
+      }
+      process.exit(1);
+    }
+    if (globalOpts.json) {
+      outputJson(agent);
+    } else {
+      console.log(chalk.green("Agent updated:"));
+      console.log(`  ${chalk.bold("ID:")}          ${agent.id}`);
+      console.log(`  ${chalk.bold("Name:")}        ${agent.name}`);
+      console.log(`  ${chalk.bold("Description:")} ${agent.description || "-"}`);
+      console.log(`  ${chalk.bold("Role:")}        ${agent.role || "agent"}`);
+      console.log(`  ${chalk.bold("Last seen:")}   ${agent.last_seen_at}`);
+    }
+  } catch (e) {
+    handleError(e);
+  }
+});
 program2.command("projects").description("Manage projects").option("--add", "Add a new project").option("--name <name>", "Project name").option("--path <path>", "Project path").option("--description <text>", "Project description").action((opts) => {
   try {
     const globalOpts = program2.opts();
@@ -3717,4 +3937,105 @@ args = []
     }
   }
 });
+program2.command("watch").description("Watch for new and changed memories in real-time").option("-s, --scope <scope>", "Scope filter: global, shared, private").option("-c, --category <cat>", "Category filter: preference, fact, knowledge, history").option("--agent <name>", "Agent filter").option("--project <path>", "Project filter").option("--interval <ms>", "Poll interval in milliseconds", parseInt).action((opts) => {
+  try {
+    const globalOpts = program2.opts();
+    const agentId = opts.agent || globalOpts.agent;
+    const projectPath = opts.project || globalOpts.project;
+    let projectId;
+    if (projectPath) {
+      const project = getProject(resolve3(projectPath));
+      if (project)
+        projectId = project.id;
+    }
+    const intervalMs = opts.interval || 500;
+    console.log(chalk.bold.cyan("Watching memories...") + chalk.dim(" (Ctrl+C to stop)"));
+    const filters = [];
+    if (opts.scope)
+      filters.push(`scope=${colorScope(opts.scope)}`);
+    if (opts.category)
+      filters.push(`category=${colorCategory(opts.category)}`);
+    if (agentId)
+      filters.push(`agent=${chalk.dim(agentId)}`);
+    if (projectId)
+      filters.push(`project=${chalk.dim(projectId)}`);
+    if (filters.length > 0) {
+      console.log(chalk.dim("Filters: ") + filters.join(chalk.dim(" | ")));
+    }
+    console.log(chalk.dim(`Poll interval: ${intervalMs}ms`));
+    console.log();
+    const filter = {
+      scope: opts.scope,
+      category: opts.category,
+      agent_id: agentId,
+      project_id: projectId,
+      limit: 20
+    };
+    const recent = listMemories(filter);
+    if (recent.length > 0) {
+      console.log(chalk.bold.dim(`Recent (${recent.length}):`));
+      for (const m of recent.reverse()) {
+        console.log(formatWatchLine(m));
+      }
+    } else {
+      console.log(chalk.dim("No recent memories."));
+    }
+    console.log(chalk.dim("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 Live \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+    console.log();
+    const { startPolling: startPolling2 } = (init_poll(), __toCommonJS(exports_poll));
+    const handle = startPolling2({
+      interval_ms: intervalMs,
+      scope: opts.scope,
+      category: opts.category,
+      agent_id: agentId,
+      project_id: projectId,
+      on_memories: (memories) => {
+        for (const m of memories) {
+          console.log(formatWatchLine(m));
+          sendNotification(m);
+        }
+      },
+      on_error: (err) => {
+        console.error(chalk.red(`Poll error: ${err.message}`));
+      }
+    });
+    const cleanup = () => {
+      handle.stop();
+      console.log();
+      console.log(chalk.dim("Stopped watching."));
+      process.exit(0);
+    };
+    process.on("SIGINT", cleanup);
+    process.on("SIGTERM", cleanup);
+  } catch (e) {
+    handleError(e);
+  }
+});
+function formatWatchLine(m) {
+  const scope = colorScope(m.scope);
+  const cat = colorCategory(m.category);
+  const imp = colorImportance(m.importance);
+  const value = m.value.length > 100 ? m.value.slice(0, 100) + "..." : m.value;
+  const main = `  [${scope}/${cat}] ${chalk.bold(m.key)} = ${value} ${chalk.dim(`(importance: ${imp})`)}`;
+  const parts = [];
+  if (m.tags.length > 0)
+    parts.push(`Tags: ${m.tags.join(", ")}`);
+  if (m.agent_id)
+    parts.push(`Agent: ${m.agent_id}`);
+  parts.push(`Updated: ${m.updated_at}`);
+  const detail = chalk.dim(`    ${parts.join("  |  ")}`);
+  return `${main}
+${detail}`;
+}
+function sendNotification(m) {
+  if (process.platform !== "darwin")
+    return;
+  try {
+    const title = "Mementos";
+    const msg = `[${m.scope}/${m.category}] ${m.key} = ${m.value.slice(0, 60)}`;
+    const escaped = msg.replace(/"/g, "\\\"");
+    const { execSync } = __require("child_process");
+    execSync(`osascript -e 'display notification "${escaped}" with title "${title}"'`, { stdio: "ignore", timeout: 2000 });
+  } catch {}
+}
 program2.parse(process.argv);

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/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/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) {
@@ -5059,6 +5084,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"),

package/package.json

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