minutes-mcp 0.27.1 → 0.28.0

package/dist/index.js

@@ -1591,7 +1591,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.27.1";
+const MCP_SERVER_VERSION = "0.28.0";
 export function parseKnowledgeConfig(configContent) {
     const knowledgeMatch = configContent.match(/\[knowledge\][\s\S]*?(?=\n\[|$)/);
     if (!knowledgeMatch) {
@@ -2695,6 +2695,27 @@ async function oldCliReadinessGuidance(runner, platform) {
         return null;
     }
 }
+function linuxLoaderGuidance(error, platform) {
+    if (platform !== "linux")
+        return null;
+    const stderr = error?.stderr;
+    if (typeof stderr !== "string")
+        return null;
+    // These are loader failures before Minutes can run, not policy diagnostics.
+    // Never echo stderr or paths; recognize only known runtime prerequisites.
+    if (/error while loading shared libraries: (?:libpipewire-0\.3|libasound)\.so\.[0-9]+: cannot open shared object file/.test(stderr)) {
+        return "The Minutes Linux engine cannot start because an audio runtime library is missing. " +
+            "On Ubuntu 24.04, install libasound2t64 and libpipewire-0.3-0t64, then restart the MCP host. " +
+            "These libraries are required even for read-only tools. " +
+            "See https://github.com/silverstein/minutes/blob/main/docs/install.md#linux";
+    }
+    if (/version [`']GLIBC_2\.[0-9]{1,2}' not found/.test(stderr)) {
+        return "The downloaded Minutes Linux engine requires glibc 2.39 or newer (Ubuntu 24.04). " +
+            "On an older distribution such as Debian 12, build minutes-cli from source on that machine. " +
+            "See https://github.com/silverstein/minutes/blob/main/docs/install.md#linux";
+    }
+    return null;
+}
 export async function readAgentTrustReadiness(runner = runMinutes, platform = process.platform) {
     let stdout;
     try {
@@ -2708,6 +2729,9 @@ export async function readAgentTrustReadiness(runner = runMinutes, platform = pr
         // "could not be verified safely" and nothing to do about it (#774).
         if (error?.cliMissing)
             throw error;
+        const loaderGuidance = linuxLoaderGuidance(error, platform);
+        if (loaderGuidance)
+            throw new Error(loaderGuidance);
         if (rejectedUnknownSubcommand(error, "agent-readiness")) {
             const guidance = await oldCliReadinessGuidance(runner, platform);
             if (guidance)
@@ -3110,12 +3134,14 @@ async function spawnCopilotCli(goal, surface) {
     const stdoutFd = openSync(paths.nudges, "a");
     const stderrFd = openSync(paths.stderr, "a");
     let child;
+    let exitCode;
     try {
         child = spawn(MINUTES_BIN, ["copilot", "start", "--goal", goal, "--surface", surface], {
             detached: true,
             stdio: ["ignore", stdoutFd, stderrFd],
             env: mcpCliChildEnv({ RUST_LOG: "info" }),
         });
+        child.once("exit", (code) => { exitCode = code; });
     }
     finally {
         closeSync(stdoutFd);
@@ -3148,7 +3174,7 @@ async function spawnCopilotCli(goal, surface) {
         }
         throw error;
     }
-    return session;
+    return { session, exitedSuccessfully: () => exitCode === 0 };
 }
 function processIsAlive(pid) {
     try {
@@ -6657,7 +6683,7 @@ if (COPILOT_SUPPORTED) {
             };
         }
         try {
-            const observerSession = await spawnCopilotCli(goal, surface);
+            const { session: observerSession, exitedSuccessfully } = await spawnCopilotCli(goal, surface);
             const status = await waitForCopilotStatus((candidate) => candidate.active || !processIsAlive(observerSession.pid), 5000);
             const observation = await readCopilotNudgeObservation(status);
             const snapshot = buildLiveCopilotResourcePayload(status, observation);
@@ -6691,6 +6717,16 @@ if (COPILOT_SUPPORTED) {
                     structuredContent: snapshot,
                 };
             }
+            if (status.available && status.setup_needed && exitedSuccessfully()) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: "Coach needs a local AI model before it can start. " +
+                                "Run `minutes coach setup`, then start Coach again. No recording was opened.",
+                        }],
+                    structuredContent: snapshot,
+                };
+            }
             const stderr = await readCopilotStderrTail();
             return {
                 content: [{