minutes-mcp 0.16.0 → 0.16.2

package/dist/index.d.ts

@@ -36,6 +36,41 @@ export type KnowledgeConfigStatus = {
     adapter: string;
     engine: string;
 };
+type MeetingLike = {
+    path: string;
+    frontmatter: {
+        date?: string;
+        title?: string;
+        type?: string;
+        duration?: string;
+        recording_health?: unknown;
+    };
+};
+export declare function meetingListItem(meeting: MeetingLike): {
+    date: string | undefined;
+    title: string | undefined;
+    content_type: string | undefined;
+    path: string;
+    duration: string | undefined;
+};
+export declare function meetingSearchItem(meeting: MeetingLike): {
+    date: string | undefined;
+    title: string | undefined;
+    content_type: string | undefined;
+    path: string;
+};
+export declare function meetingDetailPayload(input: {
+    path: string;
+    speaker_map?: unknown;
+    recording_health?: unknown;
+    overlay_applied?: boolean;
+}): {
+    path: string;
+    view: "detail";
+    speaker_map?: unknown;
+    recording_health?: unknown;
+    overlay_applied?: boolean;
+};
 export declare function shouldRunMainEntry(argv1: string | null | undefined, moduleFilename: string): boolean;
 export declare function parseKnowledgeConfig(configContent: string): KnowledgeConfigStatus | null;
 export declare const LIVE_EVENTS_RESOURCE_URI = "minutes://events/live";
@@ -72,3 +107,4 @@ export type LiveEventsSubscriptionController = {
     subscriptionCount: () => number;
 };
 export declare function registerLiveEventsSubscriptionHandlers(mcpServer: McpServer, options?: LiveEventsSubscriptionOptions): LiveEventsSubscriptionController;
+export {};

package/dist/index.js

@@ -122,6 +122,39 @@ function handleDemoSetup() {
 const UI_RESOURCE_URI = "ui://minutes/dashboard";
 const MCP_TOOLS_DOCS_BASE_URL = "https://useminutes.app/docs/mcp/tools";
 export const MEETING_INSIGHT_KINDS = ["decision", "commitment", "question"];
+export function meetingListItem(meeting) {
+    return {
+        date: meeting.frontmatter.date,
+        title: meeting.frontmatter.title,
+        content_type: meeting.frontmatter.type,
+        path: meeting.path,
+        duration: meeting.frontmatter.duration,
+    };
+}
+export function meetingSearchItem(meeting) {
+    return {
+        date: meeting.frontmatter.date,
+        title: meeting.frontmatter.title,
+        content_type: meeting.frontmatter.type,
+        path: meeting.path,
+    };
+}
+export function meetingDetailPayload(input) {
+    const payload = {
+        path: input.path,
+        view: "detail",
+    };
+    if (input.speaker_map !== undefined) {
+        payload.speaker_map = input.speaker_map;
+    }
+    if (input.recording_health !== undefined) {
+        payload.recording_health = input.recording_health;
+    }
+    if (input.overlay_applied !== undefined) {
+        payload.overlay_applied = input.overlay_applied;
+    }
+    return payload;
+}
 function toolDocsUrl(name) {
     return `${MCP_TOOLS_DOCS_BASE_URL}#tool-${name}`;
 }
@@ -315,7 +348,7 @@ const LIVE_EVENTS_SUPPORTED = hasFeature(CLI_CAPABILITIES, "events_since_seq");
 // `./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.16.0";
+const MCP_SERVER_VERSION = "0.16.2";
 export function parseKnowledgeConfig(configContent) {
     const knowledgeMatch = configContent.match(/\[knowledge\][\s\S]*?(?=\n\[|$)/);
     if (!knowledgeMatch) {
@@ -1009,7 +1042,12 @@ registerTool("start_recording", "Start recording audio with call-aware preflight
         .default(false)
         .describe("Allow a mic-only capture to continue even if Minutes detects a call but no system-audio route is configured."),
     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, intent, allow_degraded, language }) => {
+    skip_audio_probe_reason: z
+        .string()
+        .min(1)
+        .optional()
+        .describe("Per-call reason to skip the system-audio readiness probe. This is not persisted and is written into recording_health."),
+}, { title: "Start Recording", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false }, async ({ title, mode, intent, allow_degraded, language, skip_audio_probe_reason }) => {
     if (!(await isCliAvailable())) {
         return { content: [{ type: "text", text: CLI_INSTALL_MSG }] };
     }
@@ -1035,6 +1073,16 @@ registerTool("start_recording", "Start recording audio with call-aware preflight
     // For non-extension mode, still delegate call recordings to the desktop app
     // (it has system audio capture that the CLI can't do).
     if (isExtensionRuntime || preflight.intent === "call") {
+        if (skip_audio_probe_reason) {
+            return {
+                content: [{
+                        type: "text",
+                        text: "skip_audio_probe_reason cannot be honored for desktop-delegated recordings yet. Start the recording from the CLI with --skip-audio-probe \"<reason>\" if you intentionally want to bypass the system-audio readiness probe.",
+                    }],
+                structuredContent: { preflight },
+                isError: true,
+            };
+        }
         let response;
         try {
             response = await delegateRecordingToDesktop({
@@ -1129,6 +1177,8 @@ registerTool("start_recording", "Start recording audio with call-aware preflight
         args.push("--intent", intent);
     if (allow_degraded)
         args.push("--allow-degraded");
+    if (skip_audio_probe_reason)
+        args.push("--skip-audio-probe", skip_audio_probe_reason);
     if (language)
         args.push("--language", language);
     const child = spawn(MINUTES_BIN, args, {
@@ -1310,13 +1360,7 @@ registerDocsAppTool(server, "list_meetings", {
         const text = filtered
             .map((m) => `${m.frontmatter.date} — ${m.frontmatter.title} [${m.frontmatter.type}]\n  ${m.path}`)
             .join("\n\n");
-        const meetingsJson = filtered.map((m) => ({
-            date: m.frontmatter.date,
-            title: m.frontmatter.title,
-            content_type: m.frontmatter.type,
-            path: m.path,
-            duration: m.frontmatter.duration,
-        }));
+        const meetingsJson = filtered.map(meetingListItem);
         return {
             content: [{ type: "text", text }],
             structuredContent: { meetings: meetingsJson, actions: openActions.map((a) => a.item), view: "dashboard" },
@@ -1399,12 +1443,7 @@ registerDocsAppTool(server, "search_meetings", {
         return {
             content: [{ type: "text", text }],
             structuredContent: {
-                results: filtered.map((m) => ({
-                    date: m.frontmatter.date,
-                    title: m.frontmatter.title,
-                    content_type: m.frontmatter.type,
-                    path: m.path,
-                })),
+                results: filtered.map(meetingSearchItem),
                 view: "search",
             },
             _meta: { ui: { resourceUri: UI_RESOURCE_URI }, view: "search" },
@@ -1821,19 +1860,23 @@ registerDocsAppTool(server, "get_meeting", {
         // disk is never mutated — the CLI just layers ~/.minutes/overlays.db on
         // top of the parsed frontmatter. If the CLI is unavailable or the call
         // fails, degrade gracefully to raw content.
-        let structured = { path: resolved, view: "detail" };
+        const rawParsed = reader.parseFrontmatter(rawContent, resolved);
+        let structured = meetingDetailPayload({
+            path: resolved,
+            recording_health: rawParsed?.frontmatter?.recording_health,
+        });
         if (await isCliAvailable()) {
             try {
                 const { stdout } = await runMinutes(["get", resolved, "--json"], 10000);
                 const parsed = parseJsonOutput(stdout);
                 if (parsed && typeof parsed === "object" && !parsed.raw) {
                     const speakerMap = parsed.frontmatter?.speaker_map;
-                    structured = {
+                    structured = meetingDetailPayload({
                         path: resolved,
-                        view: "detail",
                         speaker_map: Array.isArray(speakerMap) ? speakerMap : [],
+                        recording_health: parsed.frontmatter?.recording_health,
                         overlay_applied: Boolean(parsed.overlay_applied),
-                    };
+                    });
                 }
             }
             catch {
@@ -2116,10 +2159,7 @@ registerDocsAppTool(server, "relationship_map", {
 server.resource("recent_meetings", "minutes://meetings/recent", { description: "List of recent meetings and memos" }, async () => {
     if (!(await isCliAvailable())) {
         const meetings = await reader.listMeetings(MEETINGS_DIR, 20);
-        const json = JSON.stringify(meetings.map((m) => ({
-            date: m.frontmatter.date, title: m.frontmatter.title,
-            content_type: m.frontmatter.type, path: m.path, duration: m.frontmatter.duration,
-        })));
+        const json = JSON.stringify(meetings.map(meetingListItem));
         return { contents: [{ uri: "minutes://meetings/recent", mimeType: "application/json", text: json }] };
     }
     const { stdout } = await runMinutes(["list", "--limit", "20"]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minutes-mcp",
-  "version": "0.16.0",
+  "version": "0.16.2",
   "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",
@@ -42,7 +42,7 @@
   "dependencies": {
     "@modelcontextprotocol/ext-apps": "^1.6.0",
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "minutes-sdk": "^0.16.0",
+    "minutes-sdk": "^0.16.2",
     "yaml": "^2.8.3",
     "zod": "^3.25 || ^4.0"
   },