anairyspirit 0.1.438 → 0.1.441

package/lib/core.js

@@ -8,7 +8,10 @@
 //   * nothing installed yet: `anairyspirit` / `anairyspirit setup` downloads
 //     the archive for this machine from the GitHub release, checks its sha256,
 //     unpacks it and runs `./anairyspirit setup` from it — the same install as
-//     from the archive by hand;
+//     from the archive by hand; `anairyspirit mcp` answers MCP with one tool
+//     that tells the agent the user has to run `npx anairyspirit setup`
+//     (lib/notice.js) — an MCP client sees a server that explains, not one
+//     that does not start;
 //   * installed (any way — disk image, Homebrew, .deb/.rpm, archive): every
 //     command goes to the installed program, so `npx -y anairyspirit mcp`
 //     works in an MCP client's configuration;
@@ -31,6 +34,7 @@ const crypto = require('crypto');
 const http = require('http');
 const https = require('https');
 const { spawn, spawnSync } = require('child_process');
+const notice = require('./notice.js');
 
 const RELEASES = 'https://github.com/Seventhwalllab/anairyspirit/releases/download';
 const TAG = 'anairyspirit (npm)';
@@ -214,6 +218,9 @@ async function main(args, opts) {
     }
     log(`${TAG}: anairyspirit is not installed on this machine yet.`);
     log('Install it first:  npx anairyspirit setup');
+    if (args[0] === 'mcp') {
+      return notice.serve(o.stdin || process.stdin, o.stdout || process.stdout, o.sums.version);
+    }
     return 1;
   }
 

package/lib/notice.js

@@ -0,0 +1,115 @@
+'use strict';
+// `npx -y anairyspirit mcp` before anairyspirit is installed. An MCP client — or
+// a registry's checker — starts the server and waits for `initialize`; a line
+// on stderr and exit 1 reads to it as «does not start», and the agent never
+// learns why. So the launcher answers MCP itself, over stdio (one JSON-RPC 2.0
+// message per line), with one tool, `setup_required`, whose result says what
+// the user has to run.
+//
+// It installs nothing. `setup` asks the user to accept the licence and downloads
+// about 1.5 GB of models: the user's to do, not the agent's.
+
+const TOOL = 'setup_required';
+// Newest first: an `initialize` asking for one of these gets it back; any other
+// gets the newest.
+const PROTOCOL_VERSIONS = ['2025-11-25', '2025-06-18', '2025-03-26', '2024-11-05'];
+
+const INSTRUCTIONS = 'anairyspirit — an AI agent\'s own long-term memory, on this machine — is not '
+  + 'installed here yet, so there is no memory to read or write. Tell the user; the one tool, '
+  + `${TOOL}, gives the command they have to run.`;
+
+const TOOL_DEF = {
+  name: TOOL,
+  title: 'anairyspirit: setup required',
+  description: 'anairyspirit (the memory) is not installed on this machine yet. Call this to get '
+    + 'the command the user has to run to install it.',
+  inputSchema: { type: 'object', properties: {}, additionalProperties: false },
+  annotations: { readOnlyHint: true, openWorldHint: false },
+};
+
+function setupText(version) {
+  return [
+    'anairyspirit is not installed on this machine yet, so there is no memory to read or write.',
+    '',
+    'Ask the user to run, in a terminal on this machine:',
+    '',
+    '  npx anairyspirit setup',
+    '',
+    `It downloads release v${version} for this machine, checks it against the release's signed `
+      + 'checksums, asks the user to accept the licence, downloads the models (about 1.5 GB) and '
+      + 'starts the memory service. Then restart this MCP client: the same configuration '
+      + '(npx -y anairyspirit mcp) reaches the memory.',
+    '',
+    'Only the user can do this: the install asks them to accept the licence.',
+  ].join('\n');
+}
+
+function reply(id, result) {
+  return { jsonrpc: '2.0', id, result };
+}
+
+function failure(id, code, message) {
+  return { jsonrpc: '2.0', id, error: { code, message } };
+}
+
+/** One JSON-RPC message in, its response out — null for a notification. */
+function respond(msg, version) {
+  if (!msg || typeof msg !== 'object' || Array.isArray(msg)) {
+    return failure(null, -32600, 'Invalid Request');
+  }
+  const { id, method, params } = msg;
+  if (id === undefined || id === null) return null;
+  switch (method) {
+    case 'initialize': {
+      const asked = params && params.protocolVersion;
+      return reply(id, {
+        protocolVersion: PROTOCOL_VERSIONS.includes(asked) ? asked : PROTOCOL_VERSIONS[0],
+        capabilities: { tools: {} },
+        serverInfo: { name: 'anairyspirit', version },
+        instructions: INSTRUCTIONS,
+      });
+    }
+    case 'ping':
+      return reply(id, {});
+    case 'tools/list':
+      return reply(id, { tools: [TOOL_DEF] });
+    case 'tools/call': {
+      const name = params && params.name;
+      if (name !== TOOL) return failure(id, -32602, `Unknown tool: ${name}`);
+      return reply(id, { content: [{ type: 'text', text: setupText(version) }], isError: false });
+    }
+    default:
+      return failure(id, -32601, `Method not found: ${method}`);
+  }
+}
+
+/** Answer MCP on `input`/`output` until `input` closes; resolves to 0. */
+function serve(input, output, version) {
+  return new Promise((resolve) => {
+    let buf = '';
+    const send = (m) => output.write(`${JSON.stringify(m)}\n`);
+    input.setEncoding('utf8');
+    input.on('data', (chunk) => {
+      buf += chunk;
+      let nl;
+      while ((nl = buf.indexOf('\n')) >= 0) {
+        const line = buf.slice(0, nl).trim();
+        buf = buf.slice(nl + 1);
+        if (!line) continue;
+        let msg;
+        try {
+          msg = JSON.parse(line);
+        } catch {
+          send(failure(null, -32700, 'Parse error'));
+          continue;
+        }
+        const out = respond(msg, version);
+        if (out) send(out);
+      }
+    });
+    input.on('end', () => resolve(0));
+    input.on('error', () => resolve(0));
+  });
+}
+
+module.exports = { TOOL, PROTOCOL_VERSIONS, respond, serve, setupText };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "anairyspirit",
-  "version": "0.1.438",
+  "version": "0.1.441",
   "mcpName": "io.github.Seventhwalllab/anairyspirit",
   "description": "Personal AI memory graph that runs locally: long-term memory for your AI agents over MCP and REST",
   "homepage": "https://github.com/Seventhwalllab/anairyspirit",

package/sums.json

@@ -1,8 +1,8 @@
 {
-  "version": "0.1.438",
+  "version": "0.1.441",
   "files": {
-    "anairyspirit-0.1.438-macos-universal.tar.gz": "5f1e73fc4e48279c20e0a2d8c40645a22b684fb97c608c0fd75a3f4cd230439a",
-    "anairyspirit-0.1.438-arm64.tar.gz": "d0bdc0b25fe757f61b7c1906ada60c91d9b2025c43e9bf9e9da92cf0bfb6f7eb",
-    "anairyspirit-0.1.438-x86_64.tar.gz": "635d50517303df614be826289287bdb0cde61ca207893f8517b0f6b434b3ee1f"
+    "anairyspirit-0.1.441-macos-universal.tar.gz": "faeed30c6bf4e2a57b7f0519b64acd059937ebcb45ac87f2e0ebb9ed30c54bfe",
+    "anairyspirit-0.1.441-arm64.tar.gz": "c5a4109c626ccf2c3f3a22c9eb6487dd1df31499fef1d22ead2faa3933b6fd4a",
+    "anairyspirit-0.1.441-x86_64.tar.gz": "7644b41d4ad02d45726c19515e6721652ca48196e266242640405d6167c0c7be"
   }
 }