minutes-mcp 0.5.1 → 0.5.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mat Silverstein
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.js

@@ -144,16 +144,24 @@ const MINUTES_BIN = findMinutesBinary();
 // When installed via `npx minutes-mcp`, the Rust CLI may not be present.
 // In that case, read-only tools use the pure-TS reader module.
 let cliAvailable = null;
+let cliCheckedAt = 0;
+const CLI_CACHE_TTL_MS = 5 * 60 * 1000; // re-check every 5 minutes
 async function isCliAvailable() {
-    if (cliAvailable !== null)
-        return cliAvailable;
+    // Cache hit: return true permanently (CLI won't disappear mid-session)
+    // Cache miss (false): re-probe after TTL so installing CLI mid-session works
+    if (cliAvailable === true)
+        return true;
+    if (cliAvailable === false && Date.now() - cliCheckedAt < CLI_CACHE_TTL_MS)
+        return false;
     try {
         await execFileAsync(MINUTES_BIN, ["--version"], { timeout: 5000 });
         cliAvailable = true;
+        cliCheckedAt = Date.now();
         console.error("[Minutes] CLI found — full mode (all tools enabled)");
     }
     catch {
         cliAvailable = false;
+        cliCheckedAt = Date.now();
         console.error("[Minutes] CLI not found — read-only mode. Install for recording: brew install minutes");
     }
     return cliAvailable;
@@ -229,7 +237,7 @@ function validatePathInDirectories(path, roots, allowedExts) {
 // ── MCP Server ──────────────────────────────────────────────
 const server = new McpServer({
     name: "minutes",
-    version: "0.5.0",
+    version: "0.5.2",
 });
 // Configurable directories — override via env vars in Claude Desktop extension settings
 const MEETINGS_DIR = process.env.MEETINGS_DIR || join(homedir(), "meetings");
@@ -960,6 +968,67 @@ server.resource("meeting", new ResourceTemplate("minutes://meetings/{slug}", { l
     }
     return { contents: [{ uri: uri.href, mimeType: "text/plain", text: `Meeting not found: ${slug}` }] };
 });
+// ── Tool: start_dictation ──────────────────────────────────
+server.tool("start_dictation", "Start dictation mode. Speak naturally — text goes to clipboard and daily note after each pause. Runs until stop_dictation is called or silence timeout.", {}, { title: "Start Dictation", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false }, async () => {
+    if (!(await isCliAvailable())) {
+        return { content: [{ type: "text", text: CLI_INSTALL_MSG }] };
+    }
+    const { stdout: statusOut } = await runMinutes(["status"]);
+    const status = parseJsonOutput(statusOut);
+    if (status.recording) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "Recording in progress — stop recording before dictating.",
+                },
+            ],
+        };
+    }
+    // Spawn detached dictation process
+    const child = spawn(MINUTES_BIN, ["dictate"], {
+        detached: true,
+        stdio: "ignore",
+        env: { ...process.env, RUST_LOG: "info" },
+    });
+    child.unref();
+    // Wait briefly for startup
+    await new Promise((r) => setTimeout(r, 500));
+    return {
+        content: [
+            {
+                type: "text",
+                text: "Dictation started. Speak naturally — text will be copied to clipboard after each pause. Say \"stop dictation\" when done.",
+            },
+        ],
+    };
+});
+// ── Tool: stop_dictation ───────────────────────────────────
+server.tool("stop_dictation", "Stop the current dictation session.", {}, { title: "Stop Dictation", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false }, async () => {
+    // Send stop signal by killing the dictation process via PID file
+    const minutesDir = join(homedir(), ".minutes");
+    const pidPath = join(minutesDir, "dictation.pid");
+    if (existsSync(pidPath)) {
+        try {
+            const pidContent = await readFile(pidPath, "utf-8");
+            const pid = parseInt(pidContent.trim(), 10);
+            if (Number.isFinite(pid) && pid > 0) {
+                process.kill(pid, "SIGTERM");
+            }
+        }
+        catch {
+            // Process already dead or PID file invalid
+        }
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: "Dictation stop requested.",
+            },
+        ],
+    };
+});
 // ── Start server ────────────────────────────────────────────
 async function main() {
     const transport = new StdioServerTransport();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minutes-mcp",
-  "version": "0.5.1",
+  "version": "0.5.2",
   "description": "MCP server for minutes — conversation memory for AI assistants. Works with Claude Desktop, Cursor, Windsurf, and any MCP client.",
   "main": "dist/index.js",
   "type": "module",
@@ -9,7 +9,8 @@
   },
   "files": [
     "dist/",
-    "dist-ui/"
+    "dist-ui/",
+    "LICENSE"
   ],
   "keywords": [
     "mcp",
@@ -38,11 +39,11 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.27.1",
+    "@modelcontextprotocol/ext-apps": "^1.2.2",
     "minutes-sdk": "^0.5.0",
     "yaml": "^2.8.3"
   },
   "devDependencies": {
-    "@modelcontextprotocol/ext-apps": "^1.2.2",
     "@types/node": "^22.0.0",
     "tsx": "^4.0.0",
     "typescript": "^5.5.0",