peon-mem 1.0.8 → 1.0.9

package/bin/peon-mem.mjs

@@ -25,12 +25,16 @@ const DAEMON = join(PKG, "dist", "daemon-cli.js");
 const MCP = join(PKG, "dist", "index.js");
 const NODE = process.execPath;
 
-const cmd = process.argv[2] || "help";
+// An MCP client launches `npx -y peon-mem` with no arguments and stdin as a pipe; that is
+// exactly what the MCP registry entry and marketplaces install. Serve MCP then. A person at a
+// terminal (stdin is a TTY) still gets the help text.
+const cmd = process.argv[2] || (process.stdin.isTTY ? "help" : "mcp");
 const DRY = process.argv.includes("--dry-run");
 const YES = process.argv.includes("--yes") || !process.stdout.isTTY;
 const log = (s) => console.log(s);
 const act = (desc, fn) => { log((DRY ? "  [dry-run] " : "  ✔ ") + desc); if (!DRY) fn(); };
-const rl = YES ? null : createInterface({ input: process.stdin, output: process.stdout });
+// In MCP mode stdin/stdout carry JSON-RPC, so nothing else may read stdin or write stdout.
+const rl = YES || cmd === "mcp" ? null : createInterface({ input: process.stdin, output: process.stdout });
 async function ask(q, def) {
   if (!rl) return def;
   const a = (await rl.question(`${q}${def ? ` [${def}]` : ""}: `)).trim();
@@ -306,6 +310,8 @@ if (cmd === "install") {
   log("Remove [mcp_servers.peon] / mcpServers.peon from Codex/Gemini/Cursor/Cline configs if you added them.");
   log("Memory data untouched: <project>/.peon/ and " + DEFAULT_HOME);
   rl?.close();
+} else if (cmd === "mcp") {
+  await import(MCP);
 } else if (cmd === "daemon") {
   await import(DAEMON);
 } else if (cmd === "doctor") {
@@ -319,6 +325,7 @@ if (cmd === "install") {
   log("peon-mem — memory brain for AI coding agents");
   log("  peon-mem install [--yes] [--dry-run]   guided setup (memory home → LLM → daemon → apps)");
   log("  peon-mem uninstall                     remove service + hooks (data stays)");
+  log("  peon-mem mcp                           run the MCP server over stdio (what MCP clients launch)");
   log("  peon-mem daemon                        run daemon in foreground");
   log("  peon-mem doctor                        health check");
   rl?.close();

package/dist/tools.d.ts

@@ -233,4 +233,13 @@ export interface PeonTools {
 export declare function openStoreCacheStats(): {
     openStores: number;
 };
+/**
+ * PEON_DAEMON_URL as an http(s) base URL, or undefined to run the tools in-process.
+ *
+ * The variable is optional, and registry listings render it with a placeholder value
+ * ("your-peon-daemon-url-here"). A copied placeholder must not turn a working in-process
+ * server into one where every call fails, so anything that is not an http(s) URL is
+ * dropped with a warning on stderr (stdout carries the MCP protocol).
+ */
+export declare function resolveDaemonUrl(raw: string | undefined, warn?: (message: string) => void): string | undefined;
 export declare function createPeonTools(options?: CreatePeonToolsOptions): PeonTools;

package/dist/tools.js

@@ -28,9 +28,33 @@ let openStoreCount = 0;
 export function openStoreCacheStats() {
     return { openStores: openStoreCount };
 }
+/**
+ * PEON_DAEMON_URL as an http(s) base URL, or undefined to run the tools in-process.
+ *
+ * The variable is optional, and registry listings render it with a placeholder value
+ * ("your-peon-daemon-url-here"). A copied placeholder must not turn a working in-process
+ * server into one where every call fails, so anything that is not an http(s) URL is
+ * dropped with a warning on stderr (stdout carries the MCP protocol).
+ */
+export function resolveDaemonUrl(raw, warn = (message) => console.warn(message)) {
+    const value = raw?.trim();
+    if (!value)
+        return undefined;
+    try {
+        const { protocol } = new URL(value);
+        if (protocol === "http:" || protocol === "https:")
+            return value;
+    }
+    catch {
+        // not a URL at all: fall through to the warning
+    }
+    warn(`[peon] ignoring PEON_DAEMON_URL=${JSON.stringify(value)}: not an http(s) URL. Running the tools in-process instead.`);
+    return undefined;
+}
 export function createPeonTools(options = {}) {
-    if (options.daemonUrl) {
-        return createDaemonBackedTools(options.daemonUrl);
+    const daemonUrl = resolveDaemonUrl(options.daemonUrl);
+    if (daemonUrl) {
+        return createDaemonBackedTools(daemonUrl);
     }
     const storesByProject = new Map();
     const sessionIndex = new SessionIndex(options.sessionIndexPath);
@@ -392,7 +416,7 @@ function createDaemonBackedTools(daemonUrl) {
                 url.searchParams.set("query", input.query);
             if (input.maxChars)
                 url.searchParams.set("maxChars", String(input.maxChars));
-            const response = await fetch(url);
+            const response = await daemonFetch(url);
             return readJsonResponse(response);
         },
         async inspectBrain(input) {
@@ -402,7 +426,7 @@ function createDaemonBackedTools(daemonUrl) {
                 url.searchParams.set("query", input.query);
             if (input.maxChars)
                 url.searchParams.set("maxChars", String(input.maxChars));
-            const response = await fetch(url);
+            const response = await daemonFetch(url);
             return readJsonResponse(response);
         },
         async searchMemory(input) {
@@ -413,7 +437,7 @@ function createDaemonBackedTools(daemonUrl) {
                 url.searchParams.set("limit", String(input.limit));
             if (input.maxChars)
                 url.searchParams.set("maxChars", String(input.maxChars));
-            const response = await fetch(url);
+            const response = await daemonFetch(url);
             return readJsonResponse(response);
         },
         async qualityReport(input) {
@@ -421,7 +445,7 @@ function createDaemonBackedTools(daemonUrl) {
             url.searchParams.set("projectPath", input.projectPath);
             if (input.staleAfterDays)
                 url.searchParams.set("staleAfterDays", String(input.staleAfterDays));
-            const response = await fetch(url);
+            const response = await daemonFetch(url);
             return readJsonResponse(response);
         },
         async rememberGlobal(input) {
@@ -435,7 +459,7 @@ function createDaemonBackedTools(daemonUrl) {
                 url.searchParams.set("type", input.type);
             if (input.status)
                 url.searchParams.set("status", input.status);
-            const response = await fetch(url);
+            const response = await daemonFetch(url);
             return readJsonResponse(response);
         },
         async importGlobalMemory(input) {
@@ -460,17 +484,17 @@ function createDaemonBackedTools(daemonUrl) {
             const url = new URL(`${baseUrl}/brain/activity`);
             if (input.limit)
                 url.searchParams.set("limit", String(input.limit));
-            return readJsonResponse(await fetch(url));
+            return readJsonResponse(await daemonFetch(url));
         },
         async globalDashboard() {
-            return readJsonResponse(await fetch(`${baseUrl}/global/dashboard`));
+            return readJsonResponse(await daemonFetch(`${baseUrl}/global/dashboard`));
         },
         async brainActions(input) {
             const url = new URL(`${baseUrl}/brain/actions`);
             url.searchParams.set("projectPath", input.projectPath);
             if (input.limit)
                 url.searchParams.set("limit", String(input.limit));
-            return readJsonResponse(await fetch(url));
+            return readJsonResponse(await daemonFetch(url));
         },
         async restoreBackup(input) {
             return postJson(`${baseUrl}/brain/restore`, input);
@@ -496,7 +520,7 @@ function createDaemonBackedTools(daemonUrl) {
                 url.searchParams.set("maxChars", String(input.maxChars));
             if (input.includeInactive)
                 url.searchParams.set("includeInactive", "true");
-            const response = await fetch(url);
+            const response = await daemonFetch(url);
             return readJsonResponse(response);
         },
         async crossProjectSearch(input) {
@@ -512,7 +536,7 @@ function createDaemonBackedTools(daemonUrl) {
                 url.searchParams.set("limit", String(input.limit));
             if (input.maxProjects)
                 url.searchParams.set("maxProjects", String(input.maxProjects));
-            const response = await fetch(url);
+            const response = await daemonFetch(url);
             return readJsonResponse(response);
         },
         async processMemory(input) {
@@ -554,13 +578,25 @@ function formatSearchInjectionPreview(records) {
     return ["Peon Search Results", ...records.map(formatRankedMemoryRecord)].join("\n");
 }
 async function postJson(url, body) {
-    const response = await fetch(url, {
+    const response = await daemonFetch(url, {
         method: "POST",
         headers: { "content-type": "application/json" },
         body: JSON.stringify(body)
     });
     return readJsonResponse(response);
 }
+/** fetch against the daemon, with an actionable error when nothing answers there. */
+async function daemonFetch(url, init) {
+    try {
+        return await fetch(url, init);
+    }
+    catch (error) {
+        const reason = error.cause?.code ?? (error instanceof Error ? error.message : String(error));
+        throw new Error(`Peon daemon is not reachable at ${new URL(String(url)).origin} (${reason}). Start it with ` +
+            `"npx peon-mem install" (sets it up as a background service) or "npx peon-mem daemon", ` +
+            `or unset PEON_DAEMON_URL to run the tools in-process.`);
+    }
+}
 async function readJsonResponse(response) {
     const text = await response.text();
     const body = text ? JSON.parse(text) : {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "peon-mem",
-  "version": "1.0.8",
+  "version": "1.0.9",
   "type": "module",
   "main": "dist/index.js",
   "bin": {