@usewhisper/mcp-server 2.12.0 → 2.13.0

package/dist/server.js

@@ -3894,6 +3894,7 @@ var RECOMMENDED_NEXT_CALL_ALLOWLIST = /* @__PURE__ */ new Set([
   "search_code",
   "grep",
   "context.list_sources",
+  "context.add_source",
   "index.local_scan_ingest",
   "context.get_relevant"
 ]);
@@ -3909,6 +3910,25 @@ function sanitizeRecommendedNextCalls(nextCalls) {
     )
   );
 }
+function getRepoReadinessNextCalls(readiness) {
+  if (readiness !== "project_bound_no_repo_source" && readiness !== "project_unverified") {
+    return [];
+  }
+  if (RUNTIME_MODE === "remote") {
+    return sanitizeRecommendedNextCalls([
+      "context.list_sources",
+      "context.add_source",
+      "index.workspace_status",
+      "context.get_relevant"
+    ]);
+  }
+  return sanitizeRecommendedNextCalls([
+    "context.list_sources",
+    "index.local_scan_ingest",
+    "index.workspace_status",
+    "context.get_relevant"
+  ]);
+}
 function resolveMcpRetrievalProfile(requested) {
   if (requested && MCP_RETRIEVAL_PROFILE_VALUES.includes(requested)) {
     return requested;
@@ -4449,7 +4469,7 @@ async function resolveRepoGroundingPreflight(args) {
   }
   const recommendedNextCalls = [...trust.recommended_next_calls];
   if (sourceVerification.retrieval_readiness === "project_bound_no_repo_source" || sourceVerification.retrieval_readiness === "project_unverified") {
-    recommendedNextCalls.push("context.list_sources", "index.local_scan_ingest");
+    recommendedNextCalls.push(...getRepoReadinessNextCalls(sourceVerification.retrieval_readiness));
   }
   return {
     repo_grounded: repoGrounded,
@@ -5109,7 +5129,9 @@ function saveIngestManifest(manifest) {
 }
 async function ingestLocalPath(params) {
   if (RUNTIME_MODE === "remote") {
-    throw new Error("Local ingestion is disabled in remote mode. Set WHISPER_MCP_MODE=auto or local.");
+    throw new Error(
+      "Local ingestion is disabled in remote mode. Use context.add_source for remote projects, or run MCP with WHISPER_MCP_MODE=auto/local."
+    );
   }
   const rootPath = params.path || process.cwd();
   const gate = isPathAllowed(rootPath);
@@ -5389,7 +5411,7 @@ server.tool(
         warnings: Array.from(/* @__PURE__ */ new Set([...trust.warnings, ...repoVerification.warnings])),
         recommended_next_calls: sanitizeRecommendedNextCalls([
           ...trust.recommended_next_calls,
-          ...repoVerification.retrieval_readiness === "project_bound_no_repo_source" ? ["context.list_sources", "index.local_scan_ingest"] : []
+          ...getRepoReadinessNextCalls(repoVerification.retrieval_readiness)
         ]),
         freshness: trust.freshness,
         coverage: trust.coverage,
@@ -5406,7 +5428,7 @@ server.tool(
 );
 server.tool(
   "index.workspace_run",
-  "Index workspace in full or incremental mode and update index metadata for freshness checks.",
+  "Refresh local workspace index metadata (coverage, commit, freshness) for trust checks. This does not upload files or create backend embeddings.",
   {
     workspace_id: z.string().optional(),
     path: z.string().optional(),
@@ -5448,7 +5470,7 @@ server.tool(
 );
 server.tool(
   "index.local_scan_ingest",
-  "Scan a local folder safely (allowlist + secret filters), ingest changed files, and persist incremental manifest.",
+  "Ingest local files into Whisper backend (chunk/embed/index) and persist incremental manifest. Requires WHISPER_MCP_MODE=auto or local.",
   {
     project: z.string().optional().describe("Project name or slug"),
     path: z.string().optional().describe("Local path to ingest. Defaults to current working directory."),
@@ -5484,7 +5506,7 @@ server.tool(
 );
 server.tool(
   "context.get_relevant",
-  "Default grounded retrieval step for workspace/project questions. Call this before answering when you need ranked evidence with file:line citations instead of relying on model memory.",
+  "Default grounded retrieval step for workspace/project questions. Returns ranked evidence with file:line citations and may abstain when workspace/repo trust is not ready.",
   {
     question: z.string().describe("Task/question to retrieve context for"),
     path: z.string().optional().describe("Workspace path. Defaults to current working directory."),
@@ -5831,7 +5853,7 @@ server.tool(
 );
 server.tool(
   "context.query",
-  "Use this when answering from project knowledge rather than general model memory. Retrieves packed context for a query using hybrid vector+keyword search with optional memory/graph expansion.",
+  "Use this when answering from project knowledge rather than general model memory. Retrieves packed context and auto-falls back between repo, local, and memory routes based on trust/readiness.",
   {
     project: z.string().optional().describe("Project name or slug (optional if WHISPER_PROJECT is set)"),
     query: z.string().describe("What are you looking for?"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usewhisper/mcp-server",
-  "version": "2.12.0",
+  "version": "2.13.0",
   "whisperContractVersion": "2026.03.10",
   "scripts": {
     "build": "tsup ../src/mcp/server.ts --format esm --out-dir dist",