@hasna/mementos 0.3.3 → 0.3.5

package/dist/cli/index.js

@@ -3581,7 +3581,7 @@ program2.command("recall <key>").description("Recall a memory by key").option("-
     handleError(e);
   }
 });
-program2.command("list").description("List memories with optional filters").option("-s, --scope <scope>", "Scope filter").option("-c, --category <cat>", "Category filter").option("--tags <tags>", "Comma-separated tags filter").option("--importance-min <n>", "Minimum importance", parseInt).option("--pinned", "Show only pinned").option("--agent <name>", "Agent filter").option("--project <path>", "Project filter").option("--limit <n>", "Max results", parseInt).option("--offset <n>", "Offset for pagination", parseInt).option("--status <status>", "Status filter: active, archived, expired").action((opts) => {
+program2.command("list").description("List memories with optional filters").option("-s, --scope <scope>", "Scope filter").option("-c, --category <cat>", "Category filter").option("--tags <tags>", "Comma-separated tags filter").option("--importance-min <n>", "Minimum importance", parseInt).option("--pinned", "Show only pinned").option("--agent <name>", "Agent filter").option("--project <path>", "Project filter").option("--limit <n>", "Max results", parseInt).option("--offset <n>", "Offset for pagination", parseInt).option("--status <status>", "Status filter: active, archived, expired").option("--format <fmt>", "Output format: compact (default), json, csv").action((opts) => {
   try {
     const globalOpts = program2.opts();
     const agentId = opts.agent || globalOpts.agent;
@@ -3606,10 +3606,19 @@ program2.command("list").description("List memories with optional filters").opti
       session_id: globalOpts.session
     };
     const memories = listMemories(filter);
-    if (globalOpts.json) {
+    const fmt = opts.format || (globalOpts.json ? "json" : "compact");
+    if (fmt === "json") {
       outputJson(memories);
       return;
     }
+    if (fmt === "csv") {
+      console.log("key,value,scope,category,importance,id");
+      for (const m of memories) {
+        const v = m.value.replace(/"/g, '""');
+        console.log(`"${m.key}","${v}",${m.scope},${m.category},${m.importance},${m.id.slice(0, 8)}`);
+      }
+      return;
+    }
     if (memories.length === 0) {
       console.log(chalk.yellow("No memories found."));
       return;
@@ -3701,7 +3710,7 @@ program2.command("forget <keyOrId>").description("Delete a memory by key or ID")
     handleError(e);
   }
 });
-program2.command("search <query>").description("Full-text search across memories").option("-s, --scope <scope>", "Scope filter").option("-c, --category <cat>", "Category filter").option("--tags <tags>", "Comma-separated tags filter").option("--limit <n>", "Max results", parseInt).action((query, opts) => {
+program2.command("search <query>").description("Full-text search across memories").option("-s, --scope <scope>", "Scope filter").option("-c, --category <cat>", "Category filter").option("--tags <tags>", "Comma-separated tags filter").option("--limit <n>", "Max results", parseInt).option("--format <fmt>", "Output format: compact (default), json, csv").action((query, opts) => {
   try {
     const globalOpts = program2.opts();
     const filter = {
@@ -3711,10 +3720,19 @@ program2.command("search <query>").description("Full-text search across memories
       limit: opts.limit || 20
     };
     const results = searchMemories(query, filter);
-    if (globalOpts.json) {
+    const fmt = opts.format || (globalOpts.json ? "json" : "compact");
+    if (fmt === "json") {
       outputJson(results);
       return;
     }
+    if (fmt === "csv") {
+      console.log("key,value,scope,category,importance,score,id");
+      for (const r of results) {
+        const v = r.memory.value.replace(/"/g, '""');
+        console.log(`"${r.memory.key}","${v}",${r.memory.scope},${r.memory.category},${r.memory.importance},${r.score.toFixed(1)},${r.memory.id.slice(0, 8)}`);
+      }
+      return;
+    }
     if (results.length === 0) {
       console.log(chalk.yellow(`No memories found matching "${query}".`));
       return;

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,12 +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("Max approximate 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("Minimum importance threshold (default: 3)")
+  min_importance: exports_external.coerce.number().optional(),
+  raw: exports_external.boolean().optional()
 }, async (args) => {
   try {
     const maxTokens = args.max_tokens || 500;
@@ -5280,7 +5281,8 @@ server.tool("memory_inject", "Get memory context for system prompt injection. Se
     if (lines.length === 0) {
       return { content: [{ type: "text", text: "No relevant memories found for injection." }] };
     }
-    const context = `<agent-memories>
+    const context = args.raw ? lines.join(`
+`) : `<agent-memories>
 ${lines.join(`
 `)}
 </agent-memories>`;
@@ -5290,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);
@@ -5326,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);
@@ -5350,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;
@@ -5379,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) => {
@@ -5415,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));
@@ -5426,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(),
@@ -5460,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 = {
@@ -5507,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();
@@ -5518,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.3",
+  "version": "0.3.5",
   "description": "Universal memory system for AI agents - CLI + MCP server + library API",
   "type": "module",
   "main": "dist/index.js",