minutes-mcp 0.22.1 → 0.24.0

package/dist/index.d.ts

@@ -204,4 +204,10 @@ export type LiveEventsSubscriptionController = {
     subscriptionCount: () => number;
 };
 export declare function registerLiveEventsSubscriptionHandlers(mcpServer: McpServer, options?: LiveEventsSubscriptionOptions): LiveEventsSubscriptionController;
+export interface DictationModelMissingError {
+    model: string;
+    expectedPath: string;
+    setupCommand: string;
+}
+export declare function parseDictationModelMissingError(stderr: string): DictationModelMissingError | null;
 export {};

package/dist/index.js

@@ -419,7 +419,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.22.1";
+const MCP_SERVER_VERSION = "0.24.0";
 export function parseKnowledgeConfig(configContent) {
     const knowledgeMatch = configContent.match(/\[knowledge\][\s\S]*?(?=\n\[|$)/);
     if (!knowledgeMatch) {
@@ -3064,7 +3064,14 @@ server.resource("recent-ideas", "minutes://ideas/recent", { description: "Recent
             }],
     };
 });
-// ── Tool: start_dictation ──────────────────────────────────
+export function parseDictationModelMissingError(stderr) {
+    const model = stderr.match(/Dictation model not installed:\s*([^\r\n]+)/)?.[1]?.trim();
+    const expectedPath = stderr.match(/Expected:\s*([^\r\n]+)/)?.[1]?.trim();
+    const setupCommand = stderr.match(/Fix:\s*([^\r\n]+)/)?.[1]?.trim();
+    if (!model || !expectedPath || !setupCommand)
+        return null;
+    return { model, expectedPath, setupCommand };
+}
 registerTool("start_dictation", "Start dictation mode. Speak naturally — text accumulates across pauses and the combined result is written when dictation ends. Runs until stop_dictation is called or silence timeout.", {
     language: z.string().optional().describe("Transcription language code (e.g. 'en', 'ur', 'es', 'zh'). Overrides config.toml setting."),
 }, { title: "Start Dictation", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false }, async ({ language }) => {
@@ -3099,6 +3106,48 @@ registerTool("start_dictation", "Start dictation mode. Speak naturally — text
             isError: true,
         };
     }
+    try {
+        await execFileAsync(MINUTES_BIN, ["dictate", "--preflight"], {
+            timeout: 5000,
+            env: augmentedEnv(),
+        });
+    }
+    catch (error) {
+        const stderr = typeof error?.stderr === "string" ? error.stderr : "";
+        const missing = parseDictationModelMissingError(stderr);
+        if (missing) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Dictation model '${missing.model}' is not installed. ` +
+                            `Expected it at ${missing.expectedPath}.\n\nFix: ${missing.setupCommand}`,
+                    },
+                ],
+                structuredContent: {
+                    status: "error",
+                    code: "MODEL_MISSING",
+                    model: missing.model,
+                    expectedPath: missing.expectedPath,
+                    setupCommand: missing.setupCommand,
+                },
+                isError: true,
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Dictation could not pass startup checks: ${stderr.trim() || error?.message || error}`,
+                },
+            ],
+            structuredContent: {
+                status: "error",
+                code: "DICTATION_PREFLIGHT_FAILED",
+            },
+            isError: true,
+        };
+    }
     // Spawn dictation as child (not detached — preserves macOS TCC mic grant)
     const dictArgs = ["dictate"];
     if (language)