@hasna/mementos 0.3.4 → 0.3.6

package/dist/cli/index.js

@@ -3526,8 +3526,7 @@ program2.command("save <key> <value>").description("Save a memory (create or ups
     if (globalOpts.json) {
       outputJson(memory);
     } else {
-      console.log(chalk.green("Memory saved:"));
-      console.log(formatMemoryDetail(memory));
+      console.log(chalk.green(`Saved: ${memory.key} (${memory.id.slice(0, 8)})`));
     }
   } catch (e) {
     handleError(e);
@@ -3669,8 +3668,7 @@ program2.command("update <id>").description("Update a memory by ID").option("--v
     if (globalOpts.json) {
       outputJson(updated);
     } else {
-      console.log(chalk.green("Memory updated:"));
-      console.log(formatMemoryDetail(updated));
+      console.log(chalk.green(`Updated: ${updated.key} (${updated.id.slice(0, 8)})`));
     }
   } catch (e) {
     handleError(e);

package/dist/mcp/index.js

@@ -4937,19 +4937,19 @@ function formatMemory(m) {
 `);
 }
 server.tool("memory_save", "Save/upsert a memory. scope: global=all agents, shared=project, private=single agent.", {
-  key: exports_external.string().describe("Unique key for the memory"),
-  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.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.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")
+  key: exports_external.string(),
+  value: exports_external.string(),
+  scope: exports_external.enum(["global", "shared", "private"]).optional(),
+  category: exports_external.enum(["preference", "fact", "knowledge", "history"]).optional(),
+  importance: exports_external.coerce.number().min(1).max(10).optional(),
+  tags: exports_external.array(exports_external.string()).optional(),
+  summary: exports_external.string().optional(),
+  agent_id: exports_external.string().optional(),
+  project_id: exports_external.string().optional(),
+  session_id: exports_external.string().optional(),
+  ttl_ms: exports_external.coerce.number().optional(),
+  source: exports_external.enum(["user", "agent", "system", "auto", "imported"]).optional(),
+  metadata: exports_external.record(exports_external.unknown()).optional()
 }, async (args) => {
   try {
     ensureAutoProject();
@@ -4960,7 +4960,7 @@ server.tool("memory_save", "Save/upsert a memory. scope: global=all agents, shar
   }
 });
 server.tool("memory_recall", "Recall a memory by key. Returns the best matching active memory.", {
-  key: exports_external.string().describe("Memory key to recall"),
+  key: exports_external.string(),
   scope: exports_external.enum(["global", "shared", "private"]).optional(),
   agent_id: exports_external.string().optional(),
   project_id: exports_external.string().optional(),
@@ -5006,10 +5006,10 @@ server.tool("memory_list", "List memories. Default: compact lines. full=true for
   project_id: exports_external.string().optional(),
   session_id: exports_external.string().optional(),
   status: exports_external.enum(["active", "archived", "expired"]).optional(),
-  limit: exports_external.coerce.number().optional().describe("Max results (default: 10)"),
+  limit: exports_external.coerce.number().optional(),
   offset: exports_external.coerce.number().optional(),
-  full: exports_external.boolean().optional().describe("Return full Memory objects as JSON instead of compact lines"),
-  fields: exports_external.array(exports_external.string()).optional().describe("Filter fields in full mode: e.g. ['key','value','importance']")
+  full: exports_external.boolean().optional(),
+  fields: exports_external.array(exports_external.string()).optional()
 }, async (args) => {
   try {
     const { full, fields, ...filterArgs } = args;
@@ -5043,7 +5043,7 @@ ${lines.join(`
   }
 });
 server.tool("memory_update", "Update a memory's metadata (value, importance, tags, etc.)", {
-  id: exports_external.string().describe("Memory ID (full or partial)"),
+  id: exports_external.string(),
   value: exports_external.string().optional(),
   category: exports_external.enum(["preference", "fact", "knowledge", "history"]).optional(),
   scope: exports_external.enum(["global", "shared", "private"]).optional(),
@@ -5054,7 +5054,7 @@ server.tool("memory_update", "Update a memory's metadata (value, importance, tag
   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.coerce.number().describe("Current version (for optimistic locking)")
+  version: exports_external.coerce.number()
 }, async (args) => {
   try {
     const id = resolveId(args.id);
@@ -5067,8 +5067,8 @@ ${formatMemory(memory)}` }] };
   }
 });
 server.tool("memory_forget", "Delete a memory by ID or key", {
-  id: exports_external.string().optional().describe("Memory ID (full or partial)"),
-  key: exports_external.string().optional().describe("Memory key"),
+  id: exports_external.string().optional(),
+  key: exports_external.string().optional(),
   scope: exports_external.enum(["global", "shared", "private"]).optional(),
   agent_id: exports_external.string().optional(),
   project_id: exports_external.string().optional()
@@ -5093,13 +5093,13 @@ server.tool("memory_forget", "Delete a memory by ID or key", {
   }
 });
 server.tool("memory_search", "Search memories by keyword across key, value, summary, and tags", {
-  query: exports_external.string().describe("Search query"),
+  query: exports_external.string(),
   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(),
   agent_id: exports_external.string().optional(),
   project_id: exports_external.string().optional(),
-  limit: exports_external.coerce.number().optional().describe("Max results (default: 20)")
+  limit: exports_external.coerce.number().optional()
 }, async (args) => {
   try {
     const filter = {
@@ -5195,8 +5195,8 @@ server.tool("memory_import", "Import memories from JSON array", {
     agent_id: exports_external.string().optional(),
     project_id: exports_external.string().optional(),
     metadata: exports_external.record(exports_external.unknown()).optional()
-  })).describe("Array of memories to import"),
-  overwrite: exports_external.boolean().optional().describe("Overwrite existing (default: true, uses merge dedup)")
+  })),
+  overwrite: exports_external.boolean().optional()
 }, async (args) => {
   try {
     let imported = 0;
@@ -5211,13 +5211,13 @@ server.tool("memory_import", "Import memories from JSON array", {
   }
 });
 server.tool("memory_inject", "Get memory context for system prompt injection. Selects by scope, importance, recency.", {
-  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.coerce.number().optional().describe("Token budget (default: 500)"),
+  agent_id: exports_external.string().optional(),
+  project_id: exports_external.string().optional(),
+  session_id: exports_external.string().optional(),
+  max_tokens: exports_external.coerce.number().optional(),
   categories: exports_external.array(exports_external.enum(["preference", "fact", "knowledge", "history"])).optional(),
-  min_importance: exports_external.coerce.number().optional().describe("Min importance 1-10 (default: 3)"),
-  raw: exports_external.boolean().optional().describe("Return plain lines only, no headers or tags")
+  min_importance: exports_external.coerce.number().optional(),
+  raw: exports_external.boolean().optional()
 }, async (args) => {
   try {
     const maxTokens = args.max_tokens || 500;
@@ -5292,9 +5292,9 @@ ${lines.join(`
   }
 });
 server.tool("register_agent", "Register an agent. Idempotent \u2014 same name returns existing agent.", {
-  name: exports_external.string().describe("Agent name"),
-  description: exports_external.string().optional().describe("Agent description"),
-  role: exports_external.string().optional().describe("Agent role")
+  name: exports_external.string(),
+  description: exports_external.string().optional(),
+  role: exports_external.string().optional()
 }, async (args) => {
   try {
     const agent = registerAgent(args.name, args.description, args.role);
@@ -5328,7 +5328,7 @@ ${lines.join(`
   }
 });
 server.tool("get_agent", "Get agent details by ID or name", {
-  id: exports_external.string().describe("Agent ID or name")
+  id: exports_external.string()
 }, async (args) => {
   try {
     const agent = getAgent(args.id);
@@ -5352,11 +5352,11 @@ Last seen: ${agent.last_seen_at}`
   }
 });
 server.tool("update_agent", "Update agent name, description, role, or metadata.", {
-  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")
+  id: exports_external.string(),
+  name: exports_external.string().optional(),
+  description: exports_external.string().optional(),
+  role: exports_external.string().optional(),
+  metadata: exports_external.record(exports_external.unknown()).optional()
 }, async (args) => {
   try {
     const { id, ...updates } = args;
@@ -5381,8 +5381,8 @@ Last seen: ${agent.last_seen_at}`
   }
 });
 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"),
+  name: exports_external.string(),
+  path: exports_external.string(),
   description: exports_external.string().optional(),
   memory_prefix: exports_external.string().optional()
 }, async (args) => {
@@ -5417,7 +5417,7 @@ ${lines.join(`
   }
 });
 server.tool("bulk_forget", "Delete multiple memories by IDs", {
-  ids: exports_external.array(exports_external.string()).describe("Memory IDs to delete")
+  ids: exports_external.array(exports_external.string())
 }, async (args) => {
   try {
     const resolvedIds = args.ids.map((id) => resolveId(id));
@@ -5428,7 +5428,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"),
+  ids: exports_external.array(exports_external.string()),
   importance: exports_external.coerce.number().min(1).max(10).optional(),
   tags: exports_external.array(exports_external.string()).optional(),
   pinned: exports_external.boolean().optional(),
@@ -5462,8 +5462,8 @@ server.tool("clean_expired", "Remove expired memories from the database", {}, as
 server.tool("memory_context", "Get memories relevant to current context, filtered by scope/importance/recency.", {
   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.coerce.number().optional().describe("Max memories (default: 30)")
+  scope: exports_external.enum(["global", "shared", "private"]).optional(),
+  limit: exports_external.coerce.number().optional()
 }, async (args) => {
   try {
     const filter = {
@@ -5509,7 +5509,7 @@ var TOOL_REGISTRY = [
   { name: "describe_tools", description: "Get full schemas for specific tools by name.", category: "meta" }
 ];
 server.tool("search_tools", "Search available tools by name or keyword. Returns names only.", {
-  query: exports_external.string().describe("Search term to match against tool names and descriptions"),
+  query: exports_external.string(),
   category: exports_external.enum(["memory", "agent", "project", "bulk", "utility", "meta"]).optional()
 }, async (args) => {
   const q = args.query.toLowerCase();
@@ -5520,7 +5520,7 @@ server.tool("search_tools", "Search available tools by name or keyword. Returns
 `) }] };
 });
 server.tool("describe_tools", "Get full schemas for specific tools by name.", {
-  names: exports_external.array(exports_external.string()).describe("Tool names to describe")
+  names: exports_external.array(exports_external.string())
 }, async (args) => {
   const found = TOOL_REGISTRY.filter((t) => args.names.includes(t.name));
   if (found.length === 0)

package/package.json

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