minutes-mcp 0.25.1 → 0.25.3

package/dist/corpus-lease.js

@@ -5,6 +5,7 @@ import { lstat, mkdir, open, opendir, realpath, stat } from "node:fs/promises";
 import { basename, dirname, extname, isAbsolute, join, relative } from "node:path";
 import { fileURLToPath } from "node:url";
 import { decodePolicyUtf8, fingerprintTextFileFromBoundParent, readTextFileWithRevisionFromBoundParent, writeOperatorDiagnostic, } from "./secure-read.js";
+import { nodeChildEnvironment } from "./node-child.js";
 const MAX_AUTHORIZATION_ATTEMPTS = 2;
 const DEFAULT_FENCE_TIMEOUT_MS = 5_000;
 const DEFAULT_AUTHORIZATION_TIMEOUT_MS = 15_000;
@@ -1431,7 +1432,7 @@ async function dispatchStableCorpusLease(root, operation, hooks = {}) {
         detached: process.platform !== "win32",
         stdio: ["pipe", "pipe", "pipe"],
         windowsHide: true,
-        env: { ...process.env },
+        env: nodeChildEnvironment(),
     });
     child.stderr?.resume();
     let resolveTermination;

package/dist/index.d.ts

@@ -451,7 +451,8 @@ export type AgentTrustReadiness = {
     qmd_retirement: "ready-clean" | "blocked";
     remediation?: string;
 };
-export declare function readAgentTrustReadiness(runner?: MinutesRunner): Promise<AgentTrustReadiness>;
+export declare function cliTooOldGuidance(installedVersion: string, minimumVersion?: string, platform?: NodeJS.Platform): string;
+export declare function readAgentTrustReadiness(runner?: MinutesRunner, platform?: NodeJS.Platform): Promise<AgentTrustReadiness>;
 export declare function requireAgentTrustReadiness(runner?: MinutesRunner): Promise<AgentTrustReadiness>;
 export declare function afterAgentTrustReadiness<T>(operation: () => Promise<T>, runner?: MinutesRunner): Promise<T>;
 export declare function afterRequiredCli<T>(operation: () => Promise<T>, cliProbe?: () => Promise<boolean>): Promise<T>;

package/dist/index.js

@@ -51,7 +51,8 @@ import { homedir } from "os";
 import { parse as parseYaml } from "yaml";
 import * as reader from "minutes-sdk";
 import { canonicalizeRoot, expandHomeLikePath, readTextFileInDirectory, validatePathInDirectories, validatePathInDirectory, } from "./paths.js";
-import { isCliCompatible } from "./version.js";
+import { isCliCompatible, parseVersion } from "./version.js";
+import { nodeChildEnvironment } from "./node-child.js";
 import { hasFeature, probeCapabilitiesSync, } from "./capabilities.js";
 import { downloadReleaseBinaryWithChecksum, extractZipWithPowerShell, } from "./autoInstall.js";
 import { attachCaptureRelay, } from "./captureRelay.js";
@@ -1569,7 +1570,7 @@ const COPILOT_SUPPORTED = hasFeature(CLI_CAPABILITIES, "copilot_realtime");
 // `./version.ts` (see issue #183). Hosted `.mcpb` bundles will run
 // against CLIs with different minor/patch numbers within the same
 // major; that is explicitly supported.
-const MCP_SERVER_VERSION = "0.25.1";
+const MCP_SERVER_VERSION = "0.25.3";
 export function parseKnowledgeConfig(configContent) {
     const knowledgeMatch = configContent.match(/\[knowledge\][\s\S]*?(?=\n\[|$)/);
     if (!knowledgeMatch) {
@@ -2483,7 +2484,47 @@ export async function readKnowledgeStatusSnapshot(runner = runMinutes) {
     }
     return result;
 }
-export async function readAgentTrustReadiness(runner = runMinutes) {
+const AGENT_READINESS_MIN_CLI_VERSION = "0.25.0";
+function isOlderVersion(installed, minimum) {
+    const found = parseVersion(installed);
+    const required = parseVersion(minimum);
+    if (!found || !required)
+        return false;
+    if (found.major !== required.major)
+        return found.major < required.major;
+    if (found.minor !== required.minor)
+        return found.minor < required.minor;
+    return found.patch < required.patch;
+}
+function rejectedUnknownSubcommand(error, subcommand) {
+    const diagnostic = [error?.stderr, error?.message]
+        .filter((value) => typeof value === "string")
+        .join("\n")
+        .toLowerCase();
+    return (diagnostic.includes(subcommand.toLowerCase()) &&
+        /(?:unrecognized|unknown|invalid) subcommand/.test(diagnostic));
+}
+export function cliTooOldGuidance(installedVersion, minimumVersion = AGENT_READINESS_MIN_CLI_VERSION, platform = process.platform) {
+    const update = platform === "darwin" || platform === "win32"
+        ? "Install the latest free Minutes desktop app from https://useminutes.app"
+        : "Update the Minutes CLI from https://useminutes.app, or run `cargo install minutes-cli`";
+    return (`The Minutes engine is too old for this extension (found v${installedVersion}; ` +
+        `needs v${minimumVersion} or newer). ${update}, then restart this app.`);
+}
+async function oldCliReadinessGuidance(runner, platform) {
+    try {
+        const { stdout } = await runner(["--version"], 5000);
+        const match = stdout.match(/\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?/);
+        if (!match || !isOlderVersion(match[0], AGENT_READINESS_MIN_CLI_VERSION)) {
+            return null;
+        }
+        return cliTooOldGuidance(match[0], AGENT_READINESS_MIN_CLI_VERSION, platform);
+    }
+    catch {
+        return null;
+    }
+}
+export async function readAgentTrustReadiness(runner = runMinutes, platform = process.platform) {
     let stdout;
     try {
         ({ stdout } = await runner(["agent-readiness", "--json"]));
@@ -2496,6 +2537,11 @@ export async function readAgentTrustReadiness(runner = runMinutes) {
         // "could not be verified safely" and nothing to do about it (#774).
         if (error?.cliMissing)
             throw error;
+        if (rejectedUnknownSubcommand(error, "agent-readiness")) {
+            const guidance = await oldCliReadinessGuidance(runner, platform);
+            if (guidance)
+                throw new Error(guidance);
+        }
         throw new Error("Minutes agent readiness could not be verified safely.");
     }
     let result;
@@ -2523,7 +2569,7 @@ export async function requireAgentTrustReadiness(runner = runMinutes) {
     const readiness = await readAgentTrustReadiness(runner);
     if (!readiness.ready) {
         throw new Error(readiness.remediation ||
-            "Run `minutes qmd cleanup`, repair or reinstall qmd if requested, then restart Minutes.");
+            "This machine shows a Minutes-owned QMD registration that qmd could not confirm was removed. Make sure `qmd` runs (`qmd collection list`), then run `minutes qmd cleanup` and restart Minutes.");
     }
     return readiness;
 }
@@ -4854,7 +4900,7 @@ export async function runIsolatedMcpProcessAudio(filePath, allowedDirs, audioExt
                 child = spawn(helper.binary, helper.args, {
                     detached: true,
                     stdio: ["pipe", "pipe", "pipe", "pipe"],
-                    env: mcpCliChildEnv(),
+                    env: nodeChildEnvironment(mcpCliChildEnv()),
                 });
             }
             catch {
@@ -5657,7 +5703,7 @@ registerTool("stop_dictation", "Stop the current dictation session.", {}, { titl
     };
 });
 // ── Tool: list_voices ────────────────────────────────────────
-registerTool("list_voices", "List enrolled voice profiles for speaker identification. Shows who has been enrolled, sample count, and model version.", {}, { title: "Voice Profiles", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }, async () => {
+registerTool("list_voices", "List active voice enrollments for speaker identification. Shows who has been enrolled, sample count, and model version.", {}, { title: "Voice Profiles", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }, async () => {
     if (!(await isCliAvailable())) {
         return { content: [{ type: "text", text: "Minutes CLI not available." }] };
     }
@@ -5665,7 +5711,7 @@ registerTool("list_voices", "List enrolled voice profiles for speaker identifica
     const profiles = parseJsonOutput(stdout);
     if (!Array.isArray(profiles) || profiles.length === 0) {
         return {
-            content: [{ type: "text", text: "No voice profiles enrolled. The user can enroll with: minutes enroll" }],
+            content: [{ type: "text", text: "No voice profiles enrolled. The user can enroll with: minutes voice enroll" }],
         };
     }
     const lines = profiles.map((p) => `${p.name} — ${p.sample_count} samples, ${p.source} (${p.model_version})`);

package/dist/node-child.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Environment for a helper that must run as Node through process.execPath.
+ *
+ * Electron hosts such as Claude Desktop expose their app executable as
+ * process.execPath. Spawning that executable with a JavaScript file does not
+ * start Node unless ELECTRON_RUN_AS_NODE is set for the child. Keep the switch
+ * scoped to helpers whose argv is a Node program; ordinary Minutes CLI children
+ * must continue to receive their existing policy environment unchanged.
+ */
+export declare function nodeChildEnvironment(base?: NodeJS.ProcessEnv, electronVersion?: string | undefined): NodeJS.ProcessEnv;

package/dist/node-child.js

@@ -0,0 +1,16 @@
+/**
+ * Environment for a helper that must run as Node through process.execPath.
+ *
+ * Electron hosts such as Claude Desktop expose their app executable as
+ * process.execPath. Spawning that executable with a JavaScript file does not
+ * start Node unless ELECTRON_RUN_AS_NODE is set for the child. Keep the switch
+ * scoped to helpers whose argv is a Node program; ordinary Minutes CLI children
+ * must continue to receive their existing policy environment unchanged.
+ */
+export function nodeChildEnvironment(base = process.env, electronVersion = process.versions.electron) {
+    const environment = { ...base };
+    if (electronVersion) {
+        environment.ELECTRON_RUN_AS_NODE = "1";
+    }
+    return environment;
+}

package/dist/secure-read.js

@@ -3,6 +3,7 @@ import { createHash } from "node:crypto";
 import { lstatSync, realpathSync, statSync, } from "node:fs";
 import { basename, dirname } from "path";
 import { TextDecoder } from "node:util";
+import { nodeChildEnvironment } from "./node-child.js";
 /**
  * Decode security-policy-bearing text without Unicode replacement.
  *
@@ -353,7 +354,7 @@ class BoundParentReader {
         });
         this.child = spawn(process.execPath, ["-e", BOUND_READER_SOURCE], {
             cwd: parent,
-            env: { ...process.env, MINUTES_BOUND_PARENT: parent },
+            env: nodeChildEnvironment({ ...process.env, MINUTES_BOUND_PARENT: parent }),
             stdio: ["pipe", "pipe", "pipe"],
             windowsHide: true,
         });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minutes-mcp",
-  "version": "0.25.1",
+  "version": "0.25.3",
   "description": "MCP server for minutes \u2014 conversation memory for AI assistants. Works with Claude Desktop, Mistral Vibe, Cursor, Windsurf, and any MCP client.",
   "main": "dist/index.js",
   "type": "module",
@@ -45,7 +45,7 @@
   "dependencies": {
     "@modelcontextprotocol/ext-apps": "^1.6.0",
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "minutes-sdk": "0.25.1",
+    "minutes-sdk": "0.25.3",
     "yaml": "^2.8.3",
     "zod": "^3.25 || ^4.0"
   },