context-mode 1.0.41 → 1.0.42

package/hooks/core/routing.mjs

@@ -10,7 +10,11 @@
  * - null (passthrough)
  */
 
-import { ROUTING_BLOCK, READ_GUIDANCE, GREP_GUIDANCE, BASH_GUIDANCE } from "../routing-block.mjs";
+import {
+  ROUTING_BLOCK, READ_GUIDANCE, GREP_GUIDANCE, BASH_GUIDANCE,
+  createRoutingBlock, createReadGuidance, createGrepGuidance, createBashGuidance,
+} from "../routing-block.mjs";
+import { createToolNamer } from "./tool-naming.mjs";
 import { existsSync, mkdirSync, rmSync, openSync, closeSync, constants as fsConstants } from "node:fs";
 import { tmpdir } from "node:os";
 import { resolve } from "node:path";
@@ -129,8 +133,22 @@ const TOOL_ALIASES = {
 
 /**
  * Route a PreToolUse event. Returns normalized decision object or null for passthrough.
+ *
+ * @param {string} toolName - The tool name as reported by the platform
+ * @param {object} toolInput - The tool input/parameters
+ * @param {string} [projectDir] - Project directory for security policy lookup
+ * @param {string} [platform="claude-code"] - Platform ID for tool name formatting
  */
-export function routePreToolUse(toolName, toolInput, projectDir) {
+export function routePreToolUse(toolName, toolInput, projectDir, platform) {
+  // Build platform-specific tool namer (defaults to claude-code for backward compat)
+  const t = createToolNamer(platform || "claude-code");
+
+  // Build platform-specific guidance/routing content
+  const routingBlock = platform ? createRoutingBlock(t) : ROUTING_BLOCK;
+  const readGuidance = platform ? createReadGuidance(t) : READ_GUIDANCE;
+  const grepGuidance = platform ? createGrepGuidance(t) : GREP_GUIDANCE;
+  const bashGuidance = platform ? createBashGuidance(t) : BASH_GUIDANCE;
+
   // Normalize platform-specific tool name to canonical
   const canonical = TOOL_ALIASES[toolName] ?? toolName;
 
@@ -167,7 +185,7 @@ export function routePreToolUse(toolName, toolInput, projectDir) {
       return {
         action: "modify",
         updatedInput: {
-          command: 'echo "context-mode: curl/wget blocked. You MUST use mcp__plugin_context-mode_context-mode__ctx_fetch_and_index(url, source) to fetch URLs, or mcp__plugin_context-mode_context-mode__ctx_execute(language, code) to run HTTP calls in sandbox. Do NOT retry with curl/wget."',
+          command: `echo "context-mode: curl/wget blocked. You MUST use ${t("ctx_fetch_and_index")}(url, source) to fetch URLs, or ${t("ctx_execute")}(language, code) to run HTTP calls in sandbox. Do NOT retry with curl/wget."`,
         },
       };
     }
@@ -186,7 +204,7 @@ export function routePreToolUse(toolName, toolInput, projectDir) {
       return {
         action: "modify",
         updatedInput: {
-          command: 'echo "context-mode: Inline HTTP blocked. Use mcp__plugin_context-mode_context-mode__ctx_execute(language, code) to run HTTP calls in sandbox, or mcp__plugin_context-mode_context-mode__ctx_fetch_and_index(url, source) for web pages. Do NOT retry with Bash."',
+          command: `echo "context-mode: Inline HTTP blocked. Use ${t("ctx_execute")}(language, code) to run HTTP calls in sandbox, or ${t("ctx_fetch_and_index")}(url, source) for web pages. Do NOT retry with Bash."`,
         },
       };
     }
@@ -198,23 +216,23 @@ export function routePreToolUse(toolName, toolInput, projectDir) {
       return {
         action: "modify",
         updatedInput: {
-          command: `echo "context-mode: Build tool redirected to sandbox. Use mcp__plugin_context-mode_context-mode__ctx_execute(language: \\"shell\\", code: \\"${safeCmd}\\") to run this command. Do NOT retry with Bash."`,
+          command: `echo "context-mode: Build tool redirected to sandbox. Use ${t("ctx_execute")}(language: \\"shell\\", code: \\"${safeCmd}\\") to run this command. Do NOT retry with Bash."`,
         },
       };
     }
 
     // allow all other Bash commands, but inject routing nudge (once per session)
-    return guidanceOnce("bash", BASH_GUIDANCE);
+    return guidanceOnce("bash", bashGuidance);
   }
 
   // ─── Read: nudge toward execute_file (once per session) ───
   if (canonical === "Read") {
-    return guidanceOnce("read", READ_GUIDANCE);
+    return guidanceOnce("read", readGuidance);
   }
 
   // ─── Grep: nudge toward execute (once per session) ───
   if (canonical === "Grep") {
-    return guidanceOnce("grep", GREP_GUIDANCE);
+    return guidanceOnce("grep", grepGuidance);
   }
 
   // ─── WebFetch: deny + redirect to sandbox ───
@@ -222,7 +240,7 @@ export function routePreToolUse(toolName, toolInput, projectDir) {
     const url = toolInput.url ?? "";
     return {
       action: "deny",
-      reason: `context-mode: WebFetch blocked. Use mcp__plugin_context-mode_context-mode__ctx_fetch_and_index(url: "${url}", source: "...") to fetch this URL in sandbox. Then use mcp__plugin_context-mode_context-mode__ctx_search(queries: [...]) to query results. Do NOT use curl, wget, mcp_web_fetch, or mcp_fetch_tool.`,
+      reason: `context-mode: WebFetch blocked. Use ${t("ctx_fetch_and_index")}(url: "${url}", source: "...") to fetch this URL in sandbox. Then use ${t("ctx_search")}(queries: [...]) to query results. Do NOT use curl, wget, mcp_web_fetch, or mcp_fetch_tool.`,
     };
   }
 
@@ -235,8 +253,8 @@ export function routePreToolUse(toolName, toolInput, projectDir) {
 
     const updatedInput =
       subagentType === "Bash"
-        ? { ...toolInput, [fieldName]: prompt + ROUTING_BLOCK, subagent_type: "general-purpose" }
-        : { ...toolInput, [fieldName]: prompt + ROUTING_BLOCK };
+        ? { ...toolInput, [fieldName]: prompt + routingBlock, subagent_type: "general-purpose" }
+        : { ...toolInput, [fieldName]: prompt + routingBlock };
 
     return { action: "modify", updatedInput };
   }

package/hooks/core/tool-naming.mjs

@@ -0,0 +1,50 @@
+/**
+ * Platform-aware MCP tool naming.
+ * Each platform has its own convention for how MCP tool names appear to the LLM.
+ *
+ * Evidence-based naming conventions (from official docs):
+ * | Platform           | Pattern                                                    |
+ * |--------------------|------------------------------------------------------------|
+ * | Claude Code        | mcp__plugin_context-mode_context-mode__<tool>               |
+ * | Gemini CLI         | mcp__context-mode__<tool>                                  |
+ * | Antigravity        | mcp__context-mode__<tool>                                  |
+ * | OpenCode           | context-mode_<tool>                                        |
+ * | VS Code Copilot    | context-mode_<tool>                                        |
+ * | Kiro               | @context-mode/<tool>                                       |
+ * | Zed                | mcp:context-mode:<tool>                                    |
+ * | Cursor / Codex / OpenClaw / Pi | bare <tool>                                    |
+ */
+
+const TOOL_PREFIXES = {
+  "claude-code":    (tool) => `mcp__plugin_context-mode_context-mode__${tool}`,
+  "gemini-cli":     (tool) => `mcp__context-mode__${tool}`,
+  "antigravity":    (tool) => `mcp__context-mode__${tool}`,
+  "opencode":       (tool) => `context-mode_${tool}`,
+  "vscode-copilot": (tool) => `context-mode_${tool}`,
+  "kiro":           (tool) => `@context-mode/${tool}`,
+  "zed":            (tool) => `mcp:context-mode:${tool}`,
+  "cursor":         (tool) => tool,
+  "codex":          (tool) => tool,
+  "openclaw":       (tool) => tool,
+  "pi":             (tool) => tool,
+};
+
+/**
+ * Get the platform-specific MCP tool name for a bare tool name.
+ * Falls back to claude-code convention if platform is unknown.
+ */
+export function getToolName(platform, bareTool) {
+  const fn = TOOL_PREFIXES[platform] || TOOL_PREFIXES["claude-code"];
+  return fn(bareTool);
+}
+
+/**
+ * Create a namer function bound to a specific platform.
+ * Returns (bareTool) => platformSpecificToolName.
+ */
+export function createToolNamer(platform) {
+  return (bareTool) => getToolName(platform, bareTool);
+}
+
+/** List of all known platform IDs. */
+export const KNOWN_PLATFORMS = Object.keys(TOOL_PREFIXES);

package/hooks/cursor/pretooluse.mjs

@@ -19,7 +19,7 @@ const tool = input.tool_name ?? "";
 const toolInput = input.tool_input ?? {};
 const projectDir = getInputProjectDir(input, CURSOR_OPTS);
 
-const decision = routePreToolUse(tool, toolInput, projectDir);
+const decision = routePreToolUse(tool, toolInput, projectDir, "cursor");
 const response = formatDecision("cursor", decision);
 // Cursor treats empty stdout as an invalid hook response,
 // so even passthrough decisions must emit a syntactically valid no-op payload.

package/hooks/cursor/sessionstart.mjs

@@ -4,7 +4,10 @@ import "../suppress-stderr.mjs";
  * Cursor sessionStart hook for context-mode.
  */
 
-import { ROUTING_BLOCK } from "../routing-block.mjs";
+import { createRoutingBlock } from "../routing-block.mjs";
+import { createToolNamer } from "../core/tool-naming.mjs";
+
+const ROUTING_BLOCK = createRoutingBlock(createToolNamer("cursor"));
 import {
   writeSessionEventsFile,
   buildSessionDirective,

package/hooks/gemini-cli/beforetool.mjs

@@ -19,7 +19,7 @@ const input = JSON.parse(raw);
 const tool = input.tool_name ?? "";
 const toolInput = input.tool_input ?? {};
 
-const decision = routePreToolUse(tool, toolInput, process.env.GEMINI_PROJECT_DIR || process.env.CLAUDE_PROJECT_DIR);
+const decision = routePreToolUse(tool, toolInput, process.env.GEMINI_PROJECT_DIR || process.env.CLAUDE_PROJECT_DIR, "gemini-cli");
 const response = formatDecision("gemini-cli", decision);
 if (response !== null) {
   process.stdout.write(JSON.stringify(response) + "\n");

package/hooks/gemini-cli/sessionstart.mjs

@@ -10,7 +10,10 @@ import "../suppress-stderr.mjs";
  * - "clear"    → No action needed
  */
 
-import { ROUTING_BLOCK } from "../routing-block.mjs";
+import { createRoutingBlock } from "../routing-block.mjs";
+import { createToolNamer } from "../core/tool-naming.mjs";
+
+const ROUTING_BLOCK = createRoutingBlock(createToolNamer("gemini-cli"));
 import { writeSessionEventsFile, buildSessionDirective, getSessionEvents, getLatestSessionEvents } from "../session-directive.mjs";
 import {
   readStdin, getSessionId, getSessionDBPath, getSessionEventsPath, getCleanupFlagPath,

package/hooks/kiro/pretooluse.mjs

@@ -24,7 +24,7 @@ const tool = input.tool_name ?? "";
 const toolInput = input.tool_input ?? {};
 const projectDir = input.cwd ?? process.cwd();
 
-const decision = routePreToolUse(tool, toolInput, projectDir);
+const decision = routePreToolUse(tool, toolInput, projectDir, "kiro");
 
 if (!decision) process.exit(0);
 

package/hooks/pretooluse.mjs

@@ -136,7 +136,7 @@ const tool = input.tool_name ?? "";
 const toolInput = input.tool_input ?? {};
 
 // ─── Route and format response ───
-const decision = routePreToolUse(tool, toolInput, process.env.CLAUDE_PROJECT_DIR);
+const decision = routePreToolUse(tool, toolInput, process.env.CLAUDE_PROJECT_DIR, "claude-code");
 const response = formatDecision("claude-code", decision);
 if (response !== null) {
   process.stdout.write(JSON.stringify(response) + "\n");

package/hooks/routing-block.mjs

@@ -1,28 +1,39 @@
 /**
  * Shared routing block for context-mode hooks.
  * Single source of truth — imported by pretooluse.mjs and sessionstart.mjs.
+ *
+ * Factory functions accept a tool namer `t(bareTool) => platformSpecificName`
+ * so each platform gets correct tool names in guidance messages.
+ *
+ * Backward compat: static exports (ROUTING_BLOCK, READ_GUIDANCE, etc.)
+ * default to claude-code naming convention.
  */
 
-export const ROUTING_BLOCK = `
+import { createToolNamer } from "./core/tool-naming.mjs";
+
+// ── Factory functions ─────────────────────────────────────
+
+export function createRoutingBlock(t) {
+  return `
 <context_window_protection>
   <priority_instructions>
     Raw tool output floods your context window. You MUST use context-mode MCP tools to keep raw data in the sandbox.
   </priority_instructions>
 
   <tool_selection_hierarchy>
-    1. GATHER: mcp__plugin_context-mode_context-mode__ctx_batch_execute(commands, queries)
+    1. GATHER: ${t("ctx_batch_execute")}(commands, queries)
        - Primary tool for research. Runs all commands, auto-indexes, and searches.
        - ONE call replaces many individual steps.
-    2. FOLLOW-UP: mcp__plugin_context-mode_context-mode__ctx_search(queries: ["q1", "q2", ...])
+    2. FOLLOW-UP: ${t("ctx_search")}(queries: ["q1", "q2", ...])
        - Use for all follow-up questions. ONE call, many queries.
-    3. PROCESSING: mcp__plugin_context-mode_context-mode__ctx_execute(language, code) | mcp__plugin_context-mode_context-mode__ctx_execute_file(path, language, code)
+    3. PROCESSING: ${t("ctx_execute")}(language, code) | ${t("ctx_execute_file")}(path, language, code)
        - Use for API calls, log analysis, and data processing.
   </tool_selection_hierarchy>
 
   <forbidden_actions>
     - DO NOT use Bash for commands producing >20 lines of output.
     - DO NOT use Read for analysis (use execute_file). Read IS correct for files you intend to Edit.
-    - DO NOT use WebFetch (use mcp__plugin_context-mode_context-mode__ctx_fetch_and_index instead).
+    - DO NOT use WebFetch (use ${t("ctx_fetch_and_index")} instead).
     - Bash is ONLY for git/mkdir/rm/mv/navigation.
   </forbidden_actions>
 
@@ -52,9 +63,24 @@ export const ROUTING_BLOCK = `
     → Call the upgrade MCP tool, execute the returned shell command, display results as a checklist.
   </ctx_commands>
 </context_window_protection>`;
+}
+
+export function createReadGuidance(t) {
+  return '<context_guidance>\n  <tip>\n    If you are reading this file to Edit it, Read is the correct tool — Edit needs file content in context.\n    If you are reading to analyze or explore, use ' + t("ctx_execute_file") + '(path, language, code) instead — only your printed summary will enter the context.\n  </tip>\n</context_guidance>';
+}
+
+export function createGrepGuidance(t) {
+  return '<context_guidance>\n  <tip>\n    This operation may flood your context window. To stay efficient:\n    - Use ' + t("ctx_execute") + '(language: "shell", code: "...") to run searches in the sandbox.\n    - Only your final printed summary will enter the context.\n  </tip>\n</context_guidance>';
+}
 
-export const READ_GUIDANCE = '<context_guidance>\n  <tip>\n    If you are reading this file to Edit it, Read is the correct tool — Edit needs file content in context.\n    If you are reading to analyze or explore, use mcp__plugin_context-mode_context-mode__ctx_execute_file(path, language, code) instead — only your printed summary will enter the context.\n  </tip>\n</context_guidance>';
+export function createBashGuidance(t) {
+  return '<context_guidance>\n  <tip>\n    This Bash command may produce large output. To stay efficient:\n    - Use ' + t("ctx_batch_execute") + '(commands, queries) for multiple commands\n    - Use ' + t("ctx_execute") + '(language: "shell", code: "...") to run in sandbox\n    - Only your final printed summary will enter the context.\n    - Bash is best for: git, mkdir, rm, mv, navigation, and short-output commands only.\n  </tip>\n</context_guidance>';
+}
 
-export const GREP_GUIDANCE = '<context_guidance>\n  <tip>\n    This operation may flood your context window. To stay efficient:\n    - Use mcp__plugin_context-mode_context-mode__ctx_execute(language: "shell", code: "...") to run searches in the sandbox.\n    - Only your final printed summary will enter the context.\n  </tip>\n</context_guidance>';
+// ── Backward compat: static exports defaulting to claude-code ──
 
-export const BASH_GUIDANCE = '<context_guidance>\n  <tip>\n    This Bash command may produce large output. To stay efficient:\n    - Use mcp__plugin_context-mode_context-mode__ctx_batch_execute(commands, queries) for multiple commands\n    - Use mcp__plugin_context-mode_context-mode__ctx_execute(language: "shell", code: "...") to run in sandbox\n    - Only your final printed summary will enter the context.\n    - Bash is best for: git, mkdir, rm, mv, navigation, and short-output commands only.\n  </tip>\n</context_guidance>';
+const _t = createToolNamer("claude-code");
+export const ROUTING_BLOCK = createRoutingBlock(_t);
+export const READ_GUIDANCE = createReadGuidance(_t);
+export const GREP_GUIDANCE = createGrepGuidance(_t);
+export const BASH_GUIDANCE = createBashGuidance(_t);

package/hooks/sessionstart.mjs

@@ -14,7 +14,10 @@ import "./suppress-stderr.mjs";
  * - "clear"    → User cleared context. No resume.
  */
 
-import { ROUTING_BLOCK } from "./routing-block.mjs";
+import { createRoutingBlock } from "./routing-block.mjs";
+import { createToolNamer } from "./core/tool-naming.mjs";
+
+const ROUTING_BLOCK = createRoutingBlock(createToolNamer("claude-code"));
 import { readStdin, getSessionId, getSessionDBPath, getSessionEventsPath, getCleanupFlagPath } from "./session-helpers.mjs";
 import { writeSessionEventsFile, buildSessionDirective, getSessionEvents, getLatestSessionEvents } from "./session-directive.mjs";
 import { createSessionLoaders } from "./session-loaders.mjs";

package/hooks/vscode-copilot/pretooluse.mjs

@@ -19,7 +19,7 @@ const input = JSON.parse(raw);
 const tool = input.tool_name ?? "";
 const toolInput = input.tool_input ?? {};
 
-const decision = routePreToolUse(tool, toolInput, process.env.VSCODE_CWD || process.env.CLAUDE_PROJECT_DIR);
+const decision = routePreToolUse(tool, toolInput, process.env.VSCODE_CWD || process.env.CLAUDE_PROJECT_DIR, "vscode-copilot");
 const response = formatDecision("vscode-copilot", decision);
 if (response !== null) {
   process.stdout.write(JSON.stringify(response) + "\n");

package/hooks/vscode-copilot/sessionstart.mjs

@@ -11,7 +11,10 @@ import "../suppress-stderr.mjs";
  */
 
 import { createSessionLoaders } from "../session-loaders.mjs";
-import { ROUTING_BLOCK } from "../routing-block.mjs";
+import { createRoutingBlock } from "../routing-block.mjs";
+import { createToolNamer } from "../core/tool-naming.mjs";
+
+const ROUTING_BLOCK = createRoutingBlock(createToolNamer("vscode-copilot"));
 import { writeSessionEventsFile, buildSessionDirective, getSessionEvents, getLatestSessionEvents } from "../session-directive.mjs";
 import {
   readStdin, getSessionId, getSessionDBPath, getSessionEventsPath, getCleanupFlagPath,

package/openclaw.plugin.json

@@ -3,7 +3,7 @@
   "name": "Context Mode",
   "kind": "tool",
   "description": "OpenClaw plugin that saves 98% of your context window. Sandboxed code execution in 11 languages, FTS5 knowledge base with BM25 ranking, and intent-driven search.",
-  "version": "1.0.41",
+  "version": "1.0.42",
   "sandbox": {
     "mode": "permissive",
     "filesystem_access": "full",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "context-mode",
-  "version": "1.0.41",
+  "version": "1.0.42",
   "type": "module",
   "description": "MCP plugin that saves 98% of your context window. Works with Claude Code, Gemini CLI, VS Code Copilot, OpenCode, and Codex CLI. Sandboxed code execution, FTS5 knowledge base, and intent-driven search.",
   "author": "Mert Koseoğlu",