@plur-ai/mcp 0.21.1 → 0.21.2

package/dist/{chunk-OETJSRYE.js → chunk-22X2SQNV.js}

@@ -1,6 +1,6 @@
 import {
   VERSION
-} from "./chunk-O2NJFMNP.js";
+} from "./chunk-OQDR6UF6.js";
 
 // src/telemetry.ts
 import { recordEvent, flushIfNeeded, registerFlushOnExit } from "@plur-ai/core";
@@ -17,7 +17,7 @@ function recordTelemetry(event) {
 import { existsSync, unlinkSync } from "fs";
 import { join, dirname, resolve } from "path";
 import { homedir } from "os";
-import { extractMetaEngrams, validateMetaEngram, confidenceBand, generateProfile, getProfileForInjection, selectModelForOperation, getCachedUpdateCheck, minorVersionsBehind, scanForTensions, CapabilityCanary, NO_SESSION, findProjectConfigPath, readProjectConfigFromPath, isSharedScope, resolveRerankerName, getReranker, classifyRerankerFailure, hfCacheDirName, SUGGEST_DISPLAY_MIN_CONFIDENCE, mcpRemoteWarningLine, doctorRemoteRemediation, normalizeEndpointUrl, REMOTE_STATUS_TTL_MS, PROBE_CLEARABLE_STATES, summariseProvenance, formatLayer3, renderProvenanceSummary, describeNeedsAction, summarizeOutbox, folderMapProblem, tokenEnvUnsetDetail, tokenEnvUnsetFix } from "@plur-ai/core";
+import { extractMetaEngrams, validateMetaEngram, confidenceBand, generateProfile, getProfileForInjection, selectModelForOperation, getCachedUpdateCheck, minorVersionsBehind, scanForTensions, CapabilityCanary, NO_SESSION, findProjectConfigPath, readProjectConfigFromPath, isSharedScope, resolveRerankerName, getReranker, classifyRerankerFailure, hfCacheDirName, SUGGEST_DISPLAY_MIN_CONFIDENCE, mcpRemoteWarningLine, doctorRemoteRemediation, normalizeEndpointUrl, REMOTE_STATUS_TTL_MS, PROBE_CLEARABLE_STATES, summariseProvenance, formatLayer3, renderProvenanceSummary, describeNeedsAction, summarizeOutbox, folderMapProblem, tokenEnvUnsetDetail, tokenEnvUnsetFix, resolveRecallDeadlineMs } from "@plur-ai/core";
 
 // src/folder-map-advice.ts
 import { folderRepairCommand } from "@plur-ai/core";
@@ -71,6 +71,22 @@ function formatAge(ageMs) {
   if (h < 24) return `${h}h ago`;
   return `${Math.floor(h / 24)}d ago`;
 }
+function attachRecallReport(response, meta) {
+  const remote = meta.remote ?? { state: "not_dialed", hosts: [] };
+  response.remote = remote;
+  response.results_complete = meta.results_complete ?? true;
+  const notes = [];
+  if (meta.local_complete === false) {
+    notes.push("Local search did not finish within the recall deadline \u2014 results are incomplete; retrying is fine.");
+  }
+  if (remote.hosts.some((h) => h.detail === "recall_deadline")) {
+    notes.push("The server did not answer within the recall deadline \u2014 results may be missing team engrams this call.");
+  }
+  if (notes.length > 0) {
+    const line = notes.join(" ");
+    response.warning = typeof response.warning === "string" && response.warning.length > 0 ? `${response.warning} ${line}` : line;
+  }
+}
 function attachRemoteStoreDegradation(response, plur) {
   let status;
   try {
@@ -89,14 +105,16 @@ function attachRemoteStoreDegradation(response, plur) {
   response.warning = typeof response.warning === "string" && response.warning.length > 0 ? `${response.warning} ${line}` : line;
 }
 var recallHandler = async (args, plur) => {
+  const deadline_at = Date.now() + resolveRecallDeadlineMs();
   const mode = args.mode ?? "hybrid";
   if (mode === "keyword") {
-    const results = await plur.recall(args.query, {
+    const kwMeta = await plur.recallWithMeta(args.query, {
       scope: args.scope,
       domain: args.domain,
       limit: args.limit,
       remote_timeout_ms: 2e3,
       // MCP recall remote budget (#776)
+      deadline_at,
       // #243: session default scope (incl. mid-session plur_session_scope
       // changes) establishes the remote dialing org context when no explicit
       // scope filter is passed. Same rule as writes (E7, formal R2): not
@@ -105,6 +123,7 @@ var recallHandler = async (args, plur) => {
       // of its own, the workspace's scope — the one resolver writes use.
       session: await _readSession(args, plur)
     });
+    const results = kwMeta.engrams;
     const response2 = {
       results: results.map((e) => {
         const supersededBy = e.relations?.superseded_by;
@@ -138,6 +157,7 @@ var recallHandler = async (args, plur) => {
       mode: "keyword"
     };
     attachRemoteStoreDegradation(response2, plur);
+    attachRecallReport(response2, kwMeta);
     return response2;
   }
   const budget = args.budget;
@@ -149,6 +169,7 @@ var recallHandler = async (args, plur) => {
     limit: fetchLimit,
     remote_timeout_ms: 2e3,
     // MCP recall remote budget (#776)
+    deadline_at,
     // #243: session default scope (incl. mid-session plur_session_scope
     // changes) establishes the remote dialing org context when no explicit
     // scope filter is passed. Same rule as writes (E7, formal R2), and the
@@ -205,8 +226,9 @@ var recallHandler = async (args, plur) => {
     mode: meta.mode
   };
   if (meta.mode === "hybrid-degraded") {
-    response.warning = `Embedding layer unavailable \u2014 results are BM25-only. Run plur_doctor for diagnosis. Last error: ${meta.embedderError ?? "unknown"}`;
+    response.warning = meta.degraded_reason ? meta.embedderError ?? meta.degraded_reason : `Embedding layer unavailable \u2014 results are BM25-only. Run plur_doctor for diagnosis. Last error: ${meta.embedderError ?? "unknown"}`;
   }
+  if (meta.degraded_reason) response.degraded_reason = meta.degraded_reason;
   if (resolveRerankerName() !== "off") {
     response.reranked = meta.reranked ?? 0;
     const rr = plur.rerankerStatus();
@@ -216,6 +238,7 @@ var recallHandler = async (args, plur) => {
     }
   }
   attachRemoteStoreDegradation(response, plur);
+  attachRecallReport(response, meta);
   return response;
 };
 var RECALL_HYBRID_DEPRECATION = "plur_recall_hybrid is deprecated since 0.16 \u2014 use plur_recall (mode defaults to hybrid). This alias will be removed in 0.18.";
@@ -1312,12 +1335,14 @@ function getAllToolDefinitions() {
         required: ["task"]
       },
       handler: async (args, plur) => {
+        const deadline_at = Date.now() + resolveRecallDeadlineMs();
         const session_id = _resolveWriteSession(args);
         const result = await plur.injectHybrid(args.task, {
           budget: args.budget,
           scope: args.scope,
           source: "inject",
           session_id,
+          deadline_at,
           // #1566: the dialing context follows the same rule as writes — the
           // workspace's scope when the session has no default of its own.
           // session_id above stays the caller's for attribution.
@@ -1330,7 +1355,11 @@ function getAllToolDefinitions() {
           count: result.count,
           tokens_used: result.tokens_used,
           injected_ids: result.injected_ids,
-          mode: "hybrid",
+          // #1586 round 4: a degraded injection says so, instead of a fixed 'hybrid'.
+          // (Kept as 'hybrid' otherwise, as this reply always said.)
+          mode: result.mode === "hybrid-degraded" ? "hybrid-degraded" : "hybrid",
+          ...result.degraded_reason ? { degraded_reason: result.degraded_reason } : {},
+          ...(result.mode === "hybrid-degraded" || result.degraded_reason) && result.embedder_error ? { embedder_error: result.embedder_error } : {},
           // #181: unresolved-tension warnings — flag contradicted context
           ...result.warnings ? { warnings: result.warnings } : {},
           // #1142: pinned engrams that did not fit. `pinned: true` reads as a
@@ -1339,6 +1368,7 @@ function getAllToolDefinitions() {
           ...result.omitted_pinned?.length ? { omitted_pinned: result.omitted_pinned } : {}
         };
         attachRemoteStoreDegradation(response, plur);
+        attachRecallReport(response, result);
         return response;
       }
     },
@@ -2426,6 +2456,7 @@ function getAllToolDefinitions() {
         required: ["task"]
       },
       handler: async (args, plur) => {
+        const deadline_at = Date.now() + resolveRecallDeadlineMs();
         mcpCanary.reset();
         mcpCanary.signal("session_start_hook");
         const crypto = await import("crypto");
@@ -2497,15 +2528,23 @@ function getAllToolDefinitions() {
         await plur.warmRemoteCaches().catch(() => {
         });
         let engrams = null;
+        let injectionReport = {};
         try {
           const result = await plur.injectHybrid(task, {
             scope: tags?.length ? `tags:${tags.join(",")}` : void 0,
             session_id,
             // stamped on the co_injection provenance event (#452)
             source: "session_start",
-            remote_timeout_ms: 5e3
+            remote_timeout_ms: 5e3,
             // session_start warm budget (#776)
+            deadline_at
           });
+          injectionReport = {
+            remote: result.remote,
+            results_complete: result.results_complete,
+            ...result.degraded_reason ? { degraded_reason: result.degraded_reason } : {},
+            ...(result.mode === "hybrid-degraded" || result.degraded_reason) && result.embedder_error ? { embedder_error: result.embedder_error } : {}
+          };
           _recordInjectionTelemetry(session_id, result.injected_packs);
           if (result.count > 0) {
             const lines = [];
@@ -2656,6 +2695,11 @@ Tool profile "${session_tool_profile}": most plur_* tools are not exposed by nam
           ...default_scope ? { default_scope, scope_source } : {},
           ...default_domain ? { default_domain, domain_source: "project-config" } : {},
           ...projectConfig.warning ? { project_config_warning: projectConfig.warning } : {},
+          // #1586 audit L6: the injection's per-call remote report (added fields).
+          remote: injectionReport.remote ?? { state: "not_dialed", hosts: [] },
+          results_complete: injectionReport.results_complete ?? false,
+          ...injectionReport.degraded_reason ? { degraded_reason: injectionReport.degraded_reason } : {},
+          ...injectionReport.embedder_error ? { embedder_error: injectionReport.embedder_error } : {},
           // Ask LLM to check back — MCP can't push, but we can request a follow-up
           follow_up: store_stats.engram_count === 0 ? "This is a fresh store with 0 engrams. After your first exchange with the user, review what you learned and call plur_learn for any corrections, preferences, or patterns. Build the memory from this session." : void 0,
           // On fresh install, suggest hook setup for reliable injection

package/dist/{chunk-O2NJFMNP.js → chunk-OQDR6UF6.js}

@@ -1,5 +1,5 @@
 // src/version.ts
-var VERSION = "0.21.1";
+var VERSION = "0.21.2";
 
 export {
   VERSION

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   VERSION
-} from "./chunk-O2NJFMNP.js";
+} from "./chunk-OQDR6UF6.js";
 
 // src/index.ts
 import { existsSync, readFileSync as readFileSync2, writeFileSync, mkdirSync, readdirSync, statSync } from "fs";
@@ -485,7 +485,7 @@ if (arg === "packs") {
   process.exit(0);
 }
 if (arg === "serve" || arg === void 0) {
-  const { runStdio } = await import("./server-EHKHU4JH.js");
+  const { runStdio } = await import("./server-QOHVV2Z7.js");
   runStdio().catch((err) => {
     console.error("Failed to start PLUR MCP server:", err);
     process.exit(1);

package/dist/{server-EHKHU4JH.js → server-QOHVV2Z7.js}

@@ -9,10 +9,10 @@ import {
   resolveToolProfile,
   setActiveToolProfile,
   validateToolArgs
-} from "./chunk-OETJSRYE.js";
+} from "./chunk-22X2SQNV.js";
 import {
   VERSION
-} from "./chunk-O2NJFMNP.js";
+} from "./chunk-OQDR6UF6.js";
 
 // src/server.ts
 import { Server, ProtocolError, ProtocolErrorCode } from "@modelcontextprotocol/server";
@@ -20,7 +20,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/server/stdio";
 import { existsSync as existsSync2, readFileSync as readFileSync2, writeFileSync } from "fs";
 import { join as join2 } from "path";
 import { homedir } from "os";
-import { Plur, checkForUpdate, VERSION_CHECK_SUCCESS_TTL_MS } from "@plur-ai/core";
+import { Plur, checkForUpdate, VERSION_CHECK_SUCCESS_TTL_MS, allowBackgroundModelLoad } from "@plur-ai/core";
 
 // src/drop-log.ts
 import { appendFileSync, existsSync, mkdirSync, readFileSync } from "fs";
@@ -958,6 +958,7 @@ async function runStdio() {
   }
   const profile = resolveToolProfile();
   const server = await createServer(void 0, { profile });
+  allowBackgroundModelLoad(true);
   registerFlushOnExit({});
   try {
     writeFileSync(serverPidPath(), String(process.pid));

package/dist/tools-export.js

@@ -2,8 +2,8 @@ import {
   CURSOR_CORE_TOOL_NAMES,
   getToolDefinitions,
   validateToolArgs
-} from "./chunk-OETJSRYE.js";
-import "./chunk-O2NJFMNP.js";
+} from "./chunk-22X2SQNV.js";
+import "./chunk-OQDR6UF6.js";
 
 // src/tools-export.ts
 function getToolSchemas(profile) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@plur-ai/mcp",
   "mcpName": "io.github.plur-ai/plur",
-  "version": "0.21.1",
+  "version": "0.21.2",
   "type": "module",
   "bin": {
     "plur-mcp": "dist/index.js"
@@ -16,7 +16,7 @@
     "@modelcontextprotocol/client": "2.0.0-beta.4",
     "@modelcontextprotocol/core": "2.0.0-beta.4",
     "zod": "^3.23.0",
-    "@plur-ai/core": "0.21.1"
+    "@plur-ai/core": "0.21.2"
   },
   "devDependencies": {
     "@types/node": "^25.5.0"