@basegrid_tech/mcp 0.6.5 → 0.7.0

package/dist/index.js

@@ -1334,7 +1334,6 @@ var DEFAULTS_KEYS_MAP = {
   layoutMode: true,
   mainViewMode: true,
   activeWorkspace: true,
-  updateChannel: true,
   webAccessEnabled: true,
   mobileAccessEnabled: true,
   networkAccessEnabled: true,
@@ -1362,7 +1361,11 @@ var DEFAULTS_KEYS_MAP = {
   navigationHistoryEnabled: true,
   experimentalClaudeStreamRuntime: true,
   costForecastEnabled: true,
-  sendAnonymousUsageData: true
+  sendAnonymousUsageData: true,
+  reviewAgent: true,
+  reviewClaudeModel: true,
+  reviewCodexModel: true,
+  reviewCodexEffort: true
 };
 var DEFAULTS_KEYS = Object.keys(DEFAULTS_KEYS_MAP);
 var INTERNAL_DEFAULTS_KEYS = /* @__PURE__ */ new Set([
@@ -2669,18 +2672,19 @@ function readPort() {
     return discoverAndHeal();
   }
 }
-async function rpcCall(method, params) {
+async function rpcCall(method, params, opts = {}) {
   const result = readPort();
   if (!result.port) {
     throw new Error(result.reason === "invalid" ? PORT_FILE_INVALID_MSG : PORT_FILE_MISSING_MSG);
   }
+  const effectiveTimeout = opts.timeoutMs ?? TIMEOUT_MS;
   return new Promise((resolve, reject) => {
     const ws = new WebSocket(`ws://127.0.0.1:${result.port}/ws`);
     const id = ++rpcId;
-    const timer = setTimeout(() => {
+    const timer = effectiveTimeout > 0 ? setTimeout(() => {
       ws.close();
-      reject(new Error(`RPC call "${method}" timed out after ${TIMEOUT_MS}ms`));
-    }, TIMEOUT_MS);
+      reject(new Error(`RPC call "${method}" timed out after ${effectiveTimeout}ms`));
+    }, effectiveTimeout) : null;
     ws.on("open", () => {
       ws.send(JSON.stringify({ jsonrpc: "2.0", id, method, params }));
     });
@@ -2688,7 +2692,7 @@ async function rpcCall(method, params) {
       try {
         const msg = JSON.parse(raw.toString());
         if (msg.id !== id) return;
-        clearTimeout(timer);
+        if (timer) clearTimeout(timer);
         ws.close();
         if (msg.error) {
           reject(new Error(msg.error.message));
@@ -2699,7 +2703,7 @@ async function rpcCall(method, params) {
       }
     });
     ws.on("error", (err) => {
-      clearTimeout(timer);
+      if (timer) clearTimeout(timer);
       reject(new Error(`Cannot connect to BaseGrid server: ${err.message}. Is the app running?`));
     });
   });
@@ -3425,6 +3429,93 @@ function registerWorkspaceTools(server) {
   );
 }
 
+// src/tools/ask-user-question.ts
+import { z as z7 } from "zod";
+var ASK_TIMEOUT_MS = 60 * 60 * 1e3;
+var questionSchema = z7.object({
+  question: z7.string().min(1).max(1e3).describe("The question to ask the user."),
+  header: z7.string().max(40).optional().describe("Very short label/chip shown above the question (max 40 chars)."),
+  multiSelect: z7.boolean().optional().describe("Allow multiple options to be selected. Defaults to single-select."),
+  options: z7.array(z7.string().min(1).max(200)).min(2).max(4).describe(
+    'Available choices (2\u20134). Do NOT include "Other" yourself \u2014 the UI adds it automatically when supported.'
+  )
+});
+function registerAskUserQuestionTool(server) {
+  server.tool(
+    "ask_user_question",
+    [
+      "Ask the user a question during execution. Use to: gather preferences,",
+      "clarify ambiguous instructions, get a decision on an implementation",
+      "choice, or offer the user options about the next direction.",
+      "",
+      "Each question shows 2\u20134 mutually exclusive options. The UI returns the",
+      "selected label(s). If the user dismisses the card, the tool returns",
+      '`status: "skipped"` \u2014 proceed with your best judgement.',
+      "",
+      'Do NOT add an "Other" option to `options` \u2014 the host UI handles free-',
+      "text input separately when needed."
+    ].join(" "),
+    {
+      questions: z7.array(questionSchema).min(1).max(4).describe("Questions to ask (1\u20134). Each independent and mutually exclusive.")
+    },
+    async (args) => {
+      const terminalId = process.env.BASEGRID_TERMINAL_ID;
+      if (!terminalId) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: "Error: BASEGRID_TERMINAL_ID is not set in the environment. This tool can only be used from a BaseGrid-managed session."
+            }
+          ],
+          isError: true
+        };
+      }
+      const normalized = args.questions.map((q) => ({
+        question: q.question,
+        ...q.header ? { header: q.header } : {},
+        ...typeof q.multiSelect === "boolean" ? { multiSelect: q.multiSelect } : {},
+        options: q.options.map((label) => ({ label }))
+      }));
+      try {
+        const res = await rpcCall(
+          "mcp:askUserQuestion",
+          { terminalId, questions: normalized },
+          { timeoutMs: ASK_TIMEOUT_MS }
+        );
+        if (res.skipped || !res.answers) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: "The user dismissed the question card without answering. Proceed with your best judgement based on prior context."
+              }
+            ]
+          };
+        }
+        const out = {};
+        args.questions.forEach((q, i) => {
+          const value = res.answers?.[String(i)] ?? res.answers?.[q.question];
+          if (value !== void 0) out[q.question] = value;
+        });
+        return {
+          content: [{ type: "text", text: JSON.stringify(out, null, 2) }]
+        };
+      } catch (err) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Error asking user: ${err instanceof Error ? err.message : String(err)}`
+            }
+          ],
+          isError: true
+        };
+      }
+    }
+  );
+}
+
 // src/server.ts
 function createMcpServer(version) {
   const server = new McpServer({ name: "basegrid", version }, { capabilities: { tools: {} } });
@@ -3434,6 +3525,7 @@ function createMcpServer(version) {
   registerSessionTools(server);
   registerWorkflowTools(server);
   registerWorkspaceTools(server);
+  registerAskUserQuestionTool(server);
   return server;
 }
 
@@ -3446,7 +3538,7 @@ console.warn = (...args) => _origError("[mcp:warn]", ...args);
 console.error = (...args) => _origError("[mcp:error]", ...args);
 async function main() {
   configManager.init();
-  const version = true ? "0.6.5" : createRequire(import.meta.url)("../package.json").version;
+  const version = true ? "0.7.0" : createRequire(import.meta.url)("../package.json").version;
   const server = createMcpServer(version);
   const transport = new StdioServerTransport();
   await server.connect(transport);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@basegrid_tech/mcp",
-  "version": "0.6.5",
+  "version": "0.7.0",
   "description": "BaseGrid MCP server — task management, git, and workflow tools for AI coding agents",
   "type": "module",
   "license": "MIT",
@@ -26,6 +26,10 @@
   "files": [
     "dist"
   ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
   "scripts": {
     "build": "tsup",
     "dev": "tsx src/index.ts"
@@ -38,8 +42,8 @@
     "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@basegrid/server": "0.6.5",
-    "@basegrid/shared": "0.6.5",
+    "@basegrid/server": "0.7.0",
+    "@basegrid/shared": "0.7.0",
     "tsup": "^8.5.1",
     "tsx": "^4.21.0",
     "typescript": "^6.0.3"