@hasna/mementos 0.14.16 → 0.14.17

package/dist/cli/index.js

@@ -25140,7 +25140,7 @@ function getPackageVersion2() {
   }
 }
 var program2 = new Command;
-program2.name("mementos").description("Universal memory system for AI agents").version(getPackageVersion2()).option("--project <path>", "Project path for scoping").option("--json", "Output as JSON").option("--format <fmt>", "Output format: compact, json, csv, yaml").option("--agent <name>", "Agent name or ID").option("--session <id>", "Session ID");
+program2.name("mementos").description("Universal memory system for AI agents").version(getPackageVersion2()).option("-p, --project <path>", "Project path for scoping").option("-j, --json", "Output as JSON").option("-f, --format <fmt>", "Output format: compact, json, csv, yaml").option("-a, --agent <name>", "Agent name or ID").option("-s, --session <id>", "Session ID");
 registerInitCommand(program2);
 registerMemoryCommands(program2);
 registerInfoCommands(program2);

package/dist/mcp/index.js

@@ -29704,6 +29704,19 @@ var server = new McpServer({
 When running with --dangerously-load-development-channels, mementos will proactively push relevant memories into your conversation via channel notifications. These appear as <channel source="mementos"> tags. They contain memories activated by your current task context \u2014 use them to inform your work. You don't need to call memory_inject when auto-inject is active.`
 });
 mcpServer = server;
+function hasFlag(...flags) {
+  return process.argv.some((arg) => flags.includes(arg));
+}
+function printHelp() {
+  process.stdout.write(`Usage: mementos-mcp [options]
+
+Mementos MCP server (stdio transport)
+
+Options:
+  -h, --help       Show help
+  -V, --version    Show version
+`);
+}
 registerMemoryTools(server);
 registerGraphTools(server);
 registerAgentTools(server);
@@ -29755,6 +29768,15 @@ async function ensureRestServerRunning() {
   }
 }
 async function main() {
+  if (hasFlag("--help", "-h")) {
+    printHelp();
+    return;
+  }
+  if (hasFlag("--version", "-V")) {
+    process.stdout.write(`${_pkg.version}
+`);
+    return;
+  }
   await ensureRestServerRunning();
   loadWebhooksFromDb();
   const transport = new StdioServerTransport;

package/dist/server/index.js

@@ -17256,20 +17256,49 @@ addRoute("GET", "/api/chains/:sequence_group", (_req, _url, params) => {
 
 // src/server/index.ts
 var DEFAULT_PORT = 19428;
+function hasFlag(...flags) {
+  return process.argv.some((arg) => flags.includes(arg));
+}
+function printHelp() {
+  process.stdout.write(`Usage: mementos-serve [options]
+
+Mementos REST API server.
+
+Options:
+  --port <number>  Port to bind (default: 19428)
+  -h, --help       Show help
+  -V, --version    Show version
+`);
+}
+function parsePortNumber(raw, source) {
+  if (!/^\d+$/.test(raw)) {
+    throw new Error(`Invalid ${source} value "${raw}". Expected an integer between 1 and 65535.`);
+  }
+  const parsed = Number(raw);
+  if (!Number.isInteger(parsed) || parsed < 1 || parsed > 65535) {
+    throw new Error(`Invalid ${source} value "${raw}". Expected an integer between 1 and 65535.`);
+  }
+  return parsed;
+}
 function parsePort() {
   const envPort = process.env["PORT"];
   if (envPort) {
-    const p = parseInt(envPort, 10);
-    if (!Number.isNaN(p))
-      return p;
+    return parsePortNumber(envPort, "PORT");
   }
   const portArg = process.argv.find((a) => a === "--port" || a.startsWith("--port="));
   if (portArg) {
     if (portArg.includes("=")) {
-      return parseInt(portArg.split("=")[1], 10) || DEFAULT_PORT;
+      const raw2 = portArg.split("=")[1] ?? "";
+      if (!raw2)
+        throw new Error("Missing value for --port. Example: --port 19428");
+      return parsePortNumber(raw2, "--port");
     }
     const idx = process.argv.indexOf(portArg);
-    return parseInt(process.argv[idx + 1], 10) || DEFAULT_PORT;
+    const raw = process.argv[idx + 1];
+    if (!raw || raw.startsWith("-")) {
+      throw new Error("Missing value for --port. Example: --port 19428");
+    }
+    return parsePortNumber(raw, "--port");
   }
   return DEFAULT_PORT;
 }
@@ -17384,6 +17413,18 @@ function startServer(port) {
   console.log(`Mementos server listening on http://${hostname}:${port}`);
 }
 async function main() {
+  if (hasFlag("--help", "-h")) {
+    printHelp();
+    return;
+  }
+  if (hasFlag("--version", "-V")) {
+    const { createRequire: createRequire2 } = await import("module");
+    const req = createRequire2(import.meta.url);
+    const pkg = req("../../package.json");
+    process.stdout.write(`${pkg.version}
+`);
+    return;
+  }
   const requestedPort = parsePort();
   const port = await findFreePort(requestedPort);
   if (port !== requestedPort) {
@@ -17391,7 +17432,11 @@ async function main() {
   }
   startServer(port);
 }
-main();
+main().catch((error) => {
+  const message = error instanceof Error ? error.message : String(error);
+  console.error(`[mementos-serve] ${message}`);
+  process.exit(1);
+});
 export {
   startServer
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/mementos",
-  "version": "0.14.16",
+  "version": "0.14.17",
   "description": "Universal memory system for AI agents - CLI + MCP server + library API",
   "type": "module",
   "main": "dist/index.js",
@@ -77,4 +77,4 @@
     "@types/react": "^18.3.18",
     "typescript": "^5.7.3"
   }
-}
+}