minutes-mcp 0.8.4 → 0.9.0

package/dist/index.d.ts

@@ -20,6 +20,7 @@
  *   - register_qmd_collection: Register Minutes output as QMD collection
  *   - list_voices: List enrolled voice profiles for speaker identification
  *   - confirm_speaker: Confirm/correct speaker attribution in a meeting
+ *   - get_meeting_insights: Query structured insights (decisions, commitments, etc.) with confidence filtering
  *
  * All tools use execFile (not exec) to shell out to the `minutes` CLI binary.
  * No shell interpolation — safe from injection.

package/dist/index.js

@@ -20,6 +20,7 @@
  *   - register_qmd_collection: Register Minutes output as QMD collection
  *   - list_voices: List enrolled voice profiles for speaker identification
  *   - confirm_speaker: Confirm/correct speaker attribution in a meeting
+ *   - get_meeting_insights: Query structured insights (decisions, commitments, etc.) with confidence filtering
  *
  * All tools use execFile (not exec) to shell out to the `minutes` CLI binary.
  * No shell interpolation — safe from injection.
@@ -32,7 +33,7 @@ import { execFile, spawn } from "child_process";
 import { promisify } from "util";
 import { existsSync } from "fs";
 import { readFile } from "fs/promises";
-import { dirname, join } from "path";
+import { delimiter, dirname, join } from "path";
 import { fileURLToPath } from "url";
 import { homedir } from "os";
 import * as reader from "minutes-sdk";
@@ -238,7 +239,7 @@ async function tryAutoInstall() {
 // ── CLI version check ───────────────────────────────────────
 async function checkCliVersion() {
     try {
-        const { stdout } = await execFileAsync(MINUTES_BIN, ["--version"], { timeout: 5000 });
+        const { stdout } = await execFileAsync(MINUTES_BIN, ["--version"], { timeout: 5000, env: augmentedEnv() });
         // Output is like "minutes 0.8.0" or just "0.8.0"
         const match = stdout.trim().match(/(\d+\.\d+\.\d+)/);
         if (match) {
@@ -268,7 +269,7 @@ async function ensureWhisperModel() {
     try {
         // health --json returns an array of { label, state, detail, optional } items.
         // The "Speech model" item has state "ready" when downloaded.
-        const { stdout } = await execFileAsync(MINUTES_BIN, ["health", "--json"], { timeout: 10000 });
+        const { stdout } = await execFileAsync(MINUTES_BIN, ["health", "--json"], { timeout: 10000, env: augmentedEnv() });
         const items = JSON.parse(stdout);
         const modelItem = Array.isArray(items) && items.find((i) => i.label === "Speech model");
         if (modelItem && modelItem.state === "ready") {
@@ -282,7 +283,7 @@ async function ensureWhisperModel() {
     // Model not found — download tiny model in background
     console.error("[Minutes] Whisper model not found — downloading tiny model (~75MB)...");
     try {
-        await execFileAsync(MINUTES_BIN, ["setup", "--model", "tiny"], { timeout: 300000 });
+        await execFileAsync(MINUTES_BIN, ["setup", "--model", "tiny"], { timeout: 300000, env: augmentedEnv() });
         console.error("[Minutes] ✓ Whisper tiny model downloaded — recording is ready");
     }
     catch (e) {
@@ -304,7 +305,7 @@ async function isCliAvailable() {
     if (cliAvailable === false && Date.now() - cliCheckedAt < CLI_CACHE_TTL_MS)
         return false;
     try {
-        await execFileAsync(MINUTES_BIN, ["--version"], { timeout: 5000 });
+        await execFileAsync(MINUTES_BIN, ["--version"], { timeout: 5000, env: augmentedEnv() });
         cliAvailable = true;
         cliCheckedAt = Date.now();
         console.error("[Minutes] CLI found — full mode (all tools enabled)");
@@ -318,7 +319,7 @@ async function isCliAvailable() {
             const installed = await tryAutoInstall();
             if (installed) {
                 try {
-                    await execFileAsync(MINUTES_BIN, ["--version"], { timeout: 5000 });
+                    await execFileAsync(MINUTES_BIN, ["--version"], { timeout: 5000, env: augmentedEnv() });
                     cliAvailable = true;
                     cliCheckedAt = Date.now();
                     console.error("[Minutes] CLI now available after auto-install — full mode");
@@ -337,16 +338,32 @@ async function isCliAvailable() {
     }
     return cliAvailable;
 }
-const CLI_INSTALL_MSG = "Recording requires the minutes CLI binary. Install it:\n" +
-    "  macOS:   brew tap silverstein/tap && brew install minutes\n" +
-    "  Any:     cargo install minutes-cli\n" +
-    "  Source:  https://github.com/silverstein/minutes";
+const CLI_INSTALL_MSG = `Recording requires the minutes CLI binary.\n` +
+    `Searched: ${MINUTES_BIN}\n\n` +
+    `Install it:\n` +
+    `  macOS:   brew tap silverstein/tap && brew install minutes\n` +
+    `  Any:     cargo install minutes-cli\n` +
+    `  Source:  https://github.com/silverstein/minutes\n\n` +
+    `If already installed via Homebrew, try:\n` +
+    `  sudo ln -s /opt/homebrew/bin/minutes /usr/local/bin/minutes`;
+// Common binary locations that may not be in Claude Desktop's restricted PATH.
+const EXTRA_PATH_DIRS = [
+    join(homedir(), ".local", "bin"),
+    join(homedir(), ".cargo", "bin"),
+    "/opt/homebrew/bin",
+    "/usr/local/bin",
+];
+function augmentedEnv(extra) {
+    const currentPath = process.env.PATH || "";
+    const augmentedPath = [...EXTRA_PATH_DIRS, currentPath].join(delimiter);
+    return { ...process.env, PATH: augmentedPath, ...extra };
+}
 // ── Helper: run minutes CLI command (uses execFile, not exec) ──
 async function runMinutes(args, timeoutMs = 30000) {
     try {
         const { stdout, stderr } = await execFileAsync(MINUTES_BIN, args, {
             timeout: timeoutMs,
-            env: { ...process.env, RUST_LOG: "info" },
+            env: augmentedEnv({ RUST_LOG: "info" }),
         });
         return { stdout: stdout.trim(), stderr: stderr.trim() };
     }
@@ -370,7 +387,7 @@ function parseJsonOutput(stdout) {
 // ── MCP Server ──────────────────────────────────────────────
 const server = new McpServer({
     name: "minutes",
-    version: "0.8.4",
+    version: "0.9.0",
 });
 // Declare MCP Apps extension support so hosts classify this server as interactive.
 // The `extensions` field is part of the draft MCP spec (SEP-1724) — not yet in the
@@ -424,7 +441,8 @@ server.tool("start_recording", "Start recording audio from the default input dev
         .optional()
         .default("meeting")
         .describe("Live capture mode"),
-}, { title: "Start Recording", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false }, async ({ title, mode }) => {
+    language: z.string().optional().describe("Transcription language code (e.g. 'en', 'ur', 'es', 'zh'). Overrides config.toml setting."),
+}, { title: "Start Recording", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false }, async ({ title, mode, language }) => {
     if (!(await isCliAvailable())) {
         return { content: [{ type: "text", text: CLI_INSTALL_MSG }] };
     }
@@ -445,6 +463,8 @@ server.tool("start_recording", "Start recording audio from the default input dev
     const args = ["record", "--mode", mode];
     if (title)
         args.push("--title", title);
+    if (language)
+        args.push("--language", language);
     const child = spawn(MINUTES_BIN, args, {
         detached: true,
         stdio: "ignore",
@@ -474,13 +494,60 @@ server.tool("stop_recording", "Stop the current recording and process it (transc
     try {
         const { stdout, stderr } = await runMinutes(["stop"], 180000);
         const result = parseJsonOutput(stdout);
-        const message = result.file
-            ? `Recording saved: ${result.file}\nTitle: ${result.title}\nWords: ${result.words}`
-            : stderr || "Recording stopped.";
+        if (result.status === "queued") {
+            const title = result.title ? ` for ${result.title}` : "";
+            const jobLine = result.job_id ? ` Job: ${result.job_id}.` : "";
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Recording stopped. Processing queued${title}.${jobLine}`,
+                    },
+                ],
+            };
+        }
+        if (!result.file) {
+            return { content: [{ type: "text", text: stderr || "Recording stopped." }] };
+        }
         // Trigger QMD re-index so new meeting is immediately searchable
-        if (result.file)
-            triggerQmdIndex();
-        return { content: [{ type: "text", text: message }] };
+        triggerQmdIndex();
+        // Build a rich summary by reading the meeting frontmatter
+        let summary = `## ${result.title ?? "Recording"}\n\n`;
+        summary += `**Saved:** ${result.file}\n`;
+        if (result.words != null)
+            summary += `**Words:** ${result.words}\n`;
+        try {
+            const meeting = await reader.getMeeting(result.file);
+            if (meeting) {
+                const fm = meeting.frontmatter;
+                if (fm.duration)
+                    summary += `**Duration:** ${fm.duration}\n`;
+                if (fm.people?.length)
+                    summary += `**People:** ${fm.people.join(", ")}\n`;
+                const actions = fm.action_items?.filter((a) => a.status === "open") || [];
+                if (actions.length > 0) {
+                    summary += `\n### Action Items\n`;
+                    for (const item of actions) {
+                        summary += `- [ ] ${item.task}`;
+                        if (item.assignee)
+                            summary += ` (${item.assignee})`;
+                        if (item.due)
+                            summary += ` — due ${item.due}`;
+                        summary += `\n`;
+                    }
+                }
+                if (fm.decisions?.length) {
+                    summary += `\n### Decisions\n`;
+                    for (const d of fm.decisions) {
+                        summary += `- ${d.text}\n`;
+                    }
+                }
+            }
+        }
+        catch {
+            // Frontmatter read is best-effort — basic info is already in the summary
+        }
+        return { content: [{ type: "text", text: summary }] };
     }
     catch (error) {
         return {
@@ -500,10 +567,47 @@ server.tool("get_status", "Check if a recording is currently in progress.", {},
     const text = status.recording
         ? `${modeLabel} in progress (PID: ${status.pid})`
         : status.processing
-            ? `${processingLabel}${status.processing_stage ? `: ${status.processing_stage}` : "."}`
+            ? `${processingLabel}${status.processing_title ? ` for ${status.processing_title}` : ""}${status.processing_stage ? `: ${status.processing_stage}` : "."}${status.processing_job_count > 1 ? ` (${status.processing_job_count} jobs queued)` : ""}`
             : "No recording in progress.";
     return { content: [{ type: "text", text }] };
 });
+server.tool("list_processing_jobs", "List background processing jobs for recent recordings, including queued, transcript-ready, failed, and completed work.", {
+    limit: z.number().optional().default(10).describe("Maximum number of jobs"),
+    include_completed: z.boolean().optional().default(true).describe("Include completed and failed jobs"),
+}, { title: "Processing Jobs", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }, async ({ limit, include_completed }) => {
+    if (!(await isCliAvailable())) {
+        return { content: [{ type: "text", text: CLI_INSTALL_MSG }] };
+    }
+    const args = ["jobs", "--json", "--limit", String(limit)];
+    if (include_completed)
+        args.push("--all");
+    try {
+        const { stdout } = await runMinutes(args);
+        const jobs = parseJsonOutput(stdout);
+        if (!Array.isArray(jobs) || jobs.length === 0) {
+            return {
+                content: [{ type: "text", text: "No processing jobs right now." }],
+                structuredContent: { jobs: [] },
+            };
+        }
+        const lines = jobs.map((job) => {
+            const title = job.title || "Queued recording";
+            const state = job.state || "queued";
+            const stage = job.stage ? ` — ${job.stage}` : "";
+            return `- ${job.id}: ${state} — ${title}${stage}`;
+        });
+        return {
+            content: [{ type: "text", text: `Processing jobs:\n\n${lines.join("\n")}` }],
+            structuredContent: { jobs },
+        };
+    }
+    catch (error) {
+        return {
+            content: [{ type: "text", text: `Failed to list processing jobs: ${error.message}` }],
+            isError: true,
+        };
+    }
+});
 // ── Tool: list_meetings ─────────────────────────────────────
 registerAppTool(server, "list_meetings", {
     description: "List recent meetings and voice memos.",
@@ -933,7 +1037,8 @@ server.tool("process_audio", "Process an audio file through the transcription pi
     file_path: z.string().describe("Path to audio file (.wav, .m4a, .mp3)"),
     type: z.enum(["meeting", "memo"]).optional().default("memo").describe("Content type"),
     title: z.string().optional().describe("Optional title"),
-}, { title: "Process Audio", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false }, async ({ file_path, type: contentType, title }) => {
+    language: z.string().optional().describe("Transcription language code (e.g. 'en', 'ur', 'es', 'zh'). Overrides config.toml setting."),
+}, { title: "Process Audio", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false }, async ({ file_path, type: contentType, title, language }) => {
     if (!(await isCliAvailable())) {
         return { content: [{ type: "text", text: CLI_INSTALL_MSG }] };
     }
@@ -948,6 +1053,8 @@ server.tool("process_audio", "Process an audio file through the transcription pi
         const args = ["process", resolved, "-t", contentType];
         if (title)
             args.push("--title", title);
+        if (language)
+            args.push("--language", language);
         const { stdout } = await runMinutes(args, 300000);
         const result = parseJsonOutput(stdout);
         return {
@@ -1282,7 +1389,9 @@ server.resource("recent-ideas", "minutes://ideas/recent", { description: "Recent
     };
 });
 // ── Tool: start_dictation ──────────────────────────────────
-server.tool("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.", {}, { title: "Start Dictation", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false }, async () => {
+server.tool("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 }) => {
     if (!(await isCliAvailable())) {
         return { content: [{ type: "text", text: CLI_INSTALL_MSG }] };
     }
@@ -1299,7 +1408,10 @@ server.tool("start_dictation", "Start dictation mode. Speak naturally — text a
         };
     }
     // Spawn detached dictation process
-    const child = spawn(MINUTES_BIN, ["dictate"], {
+    const dictArgs = ["dictate"];
+    if (language)
+        dictArgs.push("--language", language);
+    const child = spawn(MINUTES_BIN, dictArgs, {
         detached: true,
         stdio: "ignore",
         env: { ...process.env, RUST_LOG: "info" },
@@ -1389,8 +1501,60 @@ server.tool("confirm_speaker", "Confirm or correct a speaker attribution in a me
         };
     }
 });
+// ── Tool: get_meeting_insights ─────────────────────────────
+server.tool("get_meeting_insights", "Query structured insights extracted from meetings — decisions, commitments, approvals, questions, blockers, follow-ups, and risks. Each insight has a confidence level (tentative/inferred/strong/explicit). Use this to find what was decided, who committed to what, and what's still open across all meetings. External systems can subscribe to these events for workflow automation.", {
+    kind: z.enum(["decision", "commitment", "approval", "question", "blocker", "follow_up", "risk"]).optional().describe("Filter by insight type"),
+    confidence: z.enum(["tentative", "inferred", "strong", "explicit"]).optional().describe("Minimum confidence level"),
+    participant: z.string().optional().describe("Filter by participant name (partial match)"),
+    since: z.string().optional().describe("Only insights since this date (YYYY-MM-DD)"),
+    limit: z.number().optional().default(50).describe("Maximum number of results"),
+    actionable_only: z.boolean().optional().default(false).describe("Only return actionable insights (Strong or Explicit confidence)"),
+}, { title: "Get Meeting Insights", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }, async ({ kind, confidence, participant, since, limit, actionable_only }) => {
+    if (!(await isCliAvailable())) {
+        return { content: [{ type: "text", text: CLI_INSTALL_MSG }] };
+    }
+    const args = ["insights", "--limit", String(limit ?? 50)];
+    if (kind) {
+        args.push("--kind", kind);
+    }
+    if (actionable_only) {
+        args.push("--actionable");
+    }
+    else if (confidence) {
+        args.push("--confidence", confidence);
+    }
+    if (participant) {
+        args.push("--participant", participant);
+    }
+    if (since) {
+        args.push("--since", since);
+    }
+    try {
+        const { stdout } = await runMinutes(args);
+        const insights = parseJsonOutput(stdout);
+        const count = Array.isArray(insights) ? insights.length : 0;
+        if (count === 0) {
+            return {
+                content: [{ type: "text", text: "No meeting insights found matching the filter criteria. Insights are extracted when meetings are processed with summarization enabled." }],
+            };
+        }
+        return {
+            content: [{ type: "text", text: `Found ${count} insight(s):\n\n${JSON.stringify(insights, null, 2)}` }],
+            structuredContent: { count, insights },
+        };
+    }
+    catch (error) {
+        const msg = error?.stderr || error?.message || String(error);
+        return {
+            content: [{ type: "text", text: `Failed to query insights: ${msg}` }],
+            isError: true,
+        };
+    }
+});
 // ── Tool: start_live_transcript ──────────────────────────────
-server.tool("start_live_transcript", "Start a live transcript session. Records audio and transcribes in real-time, writing utterances to a JSONL file. Use read_live_transcript to read the transcript during the session. Runs until stop is called.", {}, { title: "Start Live Transcript", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false }, async () => {
+server.tool("start_live_transcript", "Start a live transcript session. Records audio and transcribes in real-time, writing utterances to a JSONL file. Use read_live_transcript to read the transcript during the session. Runs until stop is called.", {
+    language: z.string().optional().describe("Transcription language code (e.g. 'en', 'ur', 'es', 'zh'). Overrides config.toml setting."),
+}, { title: "Start Live Transcript", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false }, async ({ language }) => {
     if (!(await isCliAvailable())) {
         return { content: [{ type: "text", text: CLI_INSTALL_MSG }] };
     }
@@ -1414,7 +1578,10 @@ server.tool("start_live_transcript", "Start a live transcript session. Records a
     }
     catch { /* no active session, proceed */ }
     // Spawn detached live transcript process
-    const child = spawn(MINUTES_BIN, ["live"], {
+    const liveArgs = ["live"];
+    if (language)
+        liveArgs.push("--language", language);
+    const child = spawn(MINUTES_BIN, liveArgs, {
         detached: true,
         stdio: "ignore",
         env: { ...process.env, RUST_LOG: "info" },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minutes-mcp",
-  "version": "0.8.4",
+  "version": "0.9.0",
   "description": "MCP server for minutes — conversation memory for AI assistants. Works with Claude Desktop, Mistral Vibe, Cursor, Windsurf, and any MCP client.",
   "main": "dist/index.js",
   "type": "module",
@@ -40,7 +40,7 @@
   "dependencies": {
     "@modelcontextprotocol/ext-apps": "^1.2.2",
     "@modelcontextprotocol/sdk": "^1.27.1",
-    "minutes-sdk": "^0.8.3",
+    "minutes-sdk": "^0.9.0",
     "yaml": "^2.8.3"
   },
   "devDependencies": {