context-mode 1.0.105 → 1.0.107

package/.claude-plugin/marketplace.json

@@ -6,14 +6,14 @@
   },
   "metadata": {
     "description": "Claude Code plugins by Mert Koseoğlu",
-    "version": "1.0.105"
+    "version": "1.0.107"
   },
   "plugins": [
     {
       "name": "context-mode",
       "source": "./",
       "description": "Claude Code MCP 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.105",
+      "version": "1.0.107",
       "author": {
         "name": "Mert Koseoğlu"
       },

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "context-mode",
-  "version": "1.0.105",
+  "version": "1.0.107",
   "description": "MCP server that saves 98% of your context window with session continuity. Sandboxed code execution in 11 languages, FTS5 knowledge base with BM25 ranking, and automatic state restore across compactions.",
   "author": {
     "name": "Mert Koseoğlu",

package/.openclaw-plugin/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.105",
+  "version": "1.0.107",
   "sandbox": {
     "mode": "permissive",
     "filesystem_access": "full",

package/.openclaw-plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "context-mode",
-  "version": "1.0.105",
+  "version": "1.0.107",
   "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.",
   "author": {
     "name": "Mert Koseoğlu",

package/build/adapters/copilot-base.d.ts

@@ -34,9 +34,9 @@ export interface CopilotHookModule {
         readonly POST_TOOL_USE: string;
         readonly PRE_COMPACT: string;
         readonly SESSION_START: string;
-        readonly STOP: string;
-        readonly SUBAGENT_START: string;
-        readonly SUBAGENT_STOP: string;
+        readonly STOP?: string;
+        readonly SUBAGENT_START?: string;
+        readonly SUBAGENT_STOP?: string;
     };
     HOOK_SCRIPTS: Record<string, string>;
     buildHookCommand: (hookType: any, pluginRoot?: string) => string;

package/build/adapters/cursor/hooks.js

@@ -19,8 +19,16 @@ export const HOOK_SCRIPTS = {
     [HOOK_TYPES.POST_TOOL_USE]: "posttooluse.mjs",
     [HOOK_TYPES.SESSION_START]: "sessionstart.mjs",
     [HOOK_TYPES.STOP]: "stop.mjs",
+    [HOOK_TYPES.AFTER_AGENT_RESPONSE]: "afteragentresponse.mjs",
 };
 /** Canonical Cursor-native matchers for tools context-mode routes proactively. */
+// NOTE (Cursor-3, deferred): Cursor is closed-source and does not currently
+// publish the exact tool name it uses for sub-agent dispatch (the analogue of
+// Claude Code's "Task" tool). The "Task" matcher below is kept as a best-guess
+// placeholder until probe data from a real Cursor session confirms the wire
+// name. If/when that probe lands, replace or supplement this entry — do NOT
+// add unverified matchers in the meantime. See Phase 7 audit
+// `/tmp/v1.0.107-adapter-cursor.json` (Cursor-3) for the full deferral note.
 export const PRE_TOOL_USE_MATCHERS = [
     "Shell",
     "Read",

package/build/adapters/cursor/index.js

@@ -21,7 +21,10 @@ export class CursorAdapter extends BaseAdapter {
         preToolUse: true,
         postToolUse: true,
         preCompact: false,
-        sessionStart: false,
+        // Cursor v1 ships native sessionStart and the matching hook script
+        // (hooks/cursor/sessionstart.mjs) is wired through the dispatcher
+        // (src/cli.ts HOOK_MAP). Capability flag must reflect script presence.
+        sessionStart: true,
         canModifyArgs: true,
         canModifyOutput: false,
         canInjectSessionContext: true,

package/build/adapters/gemini-cli/hooks.d.ts

@@ -10,12 +10,17 @@
  * Gemini CLI hook system reference:
  *   - Hooks are registered in ~/.gemini/settings.json under "hooks" key
  *   - Each hook type maps to an array of { matcher, hooks } entries
- *   - Hook names: BeforeTool, AfterTool, PreCompress, SessionStart
+ *   - Hook names: BeforeAgent, BeforeTool, AfterTool, PreCompress, SessionStart
  *   - Input: JSON on stdin
  *   - Output: JSON on stdout (or empty for passthrough)
+ *   - BeforeAgent fires when user submits a prompt — input.prompt carries
+ *     the user message; hookSpecificOutput.additionalContext is appended
+ *     to the prompt (hookRunner.ts:183-197). Equivalent to Claude Code's
+ *     UserPromptSubmit for session-continuity capture.
  */
 /** Gemini CLI hook types. */
 export declare const HOOK_TYPES: {
+    readonly BEFORE_AGENT: "BeforeAgent";
     readonly BEFORE_TOOL: "BeforeTool";
     readonly AFTER_TOOL: "AfterTool";
     readonly PRE_COMPRESS: "PreCompress";

package/build/adapters/gemini-cli/hooks.js

@@ -11,15 +11,20 @@ import { buildNodeCommand } from "../types.js";
  * Gemini CLI hook system reference:
  *   - Hooks are registered in ~/.gemini/settings.json under "hooks" key
  *   - Each hook type maps to an array of { matcher, hooks } entries
- *   - Hook names: BeforeTool, AfterTool, PreCompress, SessionStart
+ *   - Hook names: BeforeAgent, BeforeTool, AfterTool, PreCompress, SessionStart
  *   - Input: JSON on stdin
  *   - Output: JSON on stdout (or empty for passthrough)
+ *   - BeforeAgent fires when user submits a prompt — input.prompt carries
+ *     the user message; hookSpecificOutput.additionalContext is appended
+ *     to the prompt (hookRunner.ts:183-197). Equivalent to Claude Code's
+ *     UserPromptSubmit for session-continuity capture.
  */
 // ─────────────────────────────────────────────────────────
 // Hook type constants
 // ─────────────────────────────────────────────────────────
 /** Gemini CLI hook types. */
 export const HOOK_TYPES = {
+    BEFORE_AGENT: "BeforeAgent",
     BEFORE_TOOL: "BeforeTool",
     AFTER_TOOL: "AfterTool",
     PRE_COMPRESS: "PreCompress",
@@ -30,6 +35,7 @@ export const HOOK_TYPES = {
 // ─────────────────────────────────────────────────────────
 /** Map of hook types to their script file names. */
 export const HOOK_SCRIPTS = {
+    [HOOK_TYPES.BEFORE_AGENT]: "beforeagent.mjs",
     [HOOK_TYPES.BEFORE_TOOL]: "beforetool.mjs",
     [HOOK_TYPES.AFTER_TOOL]: "aftertool.mjs",
     [HOOK_TYPES.PRE_COMPRESS]: "precompress.mjs",

package/build/adapters/gemini-cli/index.js

@@ -165,6 +165,17 @@ export class GeminiCLIAdapter extends BaseAdapter {
     }
     generateHookConfig(pluginRoot) {
         return {
+            [GEMINI_HOOK_NAMES.BEFORE_AGENT]: [
+                {
+                    matcher: "",
+                    hooks: [
+                        {
+                            type: "command",
+                            command: buildGeminiHookCommand(GEMINI_HOOK_NAMES.BEFORE_AGENT, pluginRoot),
+                        },
+                    ],
+                },
+            ],
             [GEMINI_HOOK_NAMES.BEFORE_TOOL]: [
                 {
                     matcher: "run_shell_command|read_file|read_many_files|grep_search|search_file_content|web_fetch|activate_skill|mcp__plugin_context-mode",
@@ -331,6 +342,7 @@ export class GeminiCLIAdapter extends BaseAdapter {
         const hooks = (settings.hooks ?? {});
         const changes = [];
         const hookConfigs = [
+            { name: GEMINI_HOOK_NAMES.BEFORE_AGENT },
             { name: GEMINI_HOOK_NAMES.BEFORE_TOOL },
             { name: GEMINI_HOOK_NAMES.SESSION_START },
         ];

package/build/adapters/kiro/hooks.js

@@ -20,6 +20,8 @@ export const HOOK_TYPES = {
 export const HOOK_SCRIPTS = {
     [HOOK_TYPES.PRE_TOOL_USE]: "pretooluse.mjs",
     [HOOK_TYPES.POST_TOOL_USE]: "posttooluse.mjs",
+    [HOOK_TYPES.USER_PROMPT_SUBMIT]: "userpromptsubmit.mjs",
+    [HOOK_TYPES.AGENT_SPAWN]: "agentspawn.mjs",
 };
 // ─────────────────────────────────────────────────────────
 // PreToolUse matchers
@@ -46,9 +48,11 @@ export const PRE_TOOL_USE_MATCHERS = [
 export const PRE_TOOL_USE_MATCHER_PATTERN = PRE_TOOL_USE_MATCHERS.join("|");
 export const REQUIRED_HOOKS = [
     HOOK_TYPES.PRE_TOOL_USE,
+    HOOK_TYPES.AGENT_SPAWN,
 ];
 export const OPTIONAL_HOOKS = [
     HOOK_TYPES.POST_TOOL_USE,
+    HOOK_TYPES.USER_PROMPT_SUBMIT,
 ];
 /**
  * Check if a hook entry points to a context-mode hook script.

package/build/adapters/kiro/index.d.ts

@@ -18,6 +18,13 @@
  *   - CLI hooks: https://kiro.dev/docs/cli/custom-agents/configuration-reference#hooks-field
  */
 import { BaseAdapter } from "../base.js";
+/**
+ * Steering integration: we ship a single context-mode-specific routing file
+ * at `configs/kiro/KIRO.md`. Users can copy it into `.kiro/steering/` to opt
+ * into deterministic injection. We do NOT deploy generic SDD scaffolds (e.g.
+ * cc-sdd's product/structure/tech + steering-custom/* templates) — those are
+ * project-template content, not adapter wiring.
+ */
 import type { HookAdapter, HookParadigm, PlatformCapabilities, DiagnosticResult, PreToolUseEvent, PostToolUseEvent, PreCompactEvent, SessionStartEvent, PreToolUseResponse, PostToolUseResponse, PreCompactResponse, SessionStartResponse, HookRegistration } from "../types.js";
 export declare class KiroAdapter extends BaseAdapter implements HookAdapter {
     constructor();
@@ -27,11 +34,11 @@ export declare class KiroAdapter extends BaseAdapter implements HookAdapter {
     parsePreToolUseInput(raw: unknown): PreToolUseEvent;
     parsePostToolUseInput(raw: unknown): PostToolUseEvent;
     parsePreCompactInput(_raw: unknown): PreCompactEvent;
-    parseSessionStartInput(_raw: unknown): SessionStartEvent;
+    parseSessionStartInput(raw: unknown): SessionStartEvent;
     formatPreToolUseResponse(response: PreToolUseResponse): unknown;
     formatPostToolUseResponse(_response: PostToolUseResponse): unknown;
     formatPreCompactResponse(_response: PreCompactResponse): unknown;
-    formatSessionStartResponse(_response: SessionStartResponse): unknown;
+    formatSessionStartResponse(response: SessionStartResponse): unknown;
     getSettingsPath(): string;
     /**
      * Kiro stores per-project context under .kiro/ (steering files, etc).

package/build/adapters/kiro/index.js

@@ -36,10 +36,10 @@ export class KiroAdapter extends BaseAdapter {
         preToolUse: true,
         postToolUse: true,
         preCompact: false,
-        sessionStart: false,
+        sessionStart: true, // Kiro agentSpawn = SessionStart equivalent
         canModifyArgs: false, // Kiro CLI uses exit codes, can't modify input
         canModifyOutput: false,
-        canInjectSessionContext: false,
+        canInjectSessionContext: true, // agentSpawn returns additionalContext via JSON stdout
     };
     // ── Input parsing ──────────────────────────────────────
     parsePreToolUseInput(raw) {
@@ -69,8 +69,16 @@ export class KiroAdapter extends BaseAdapter {
     parsePreCompactInput(_raw) {
         throw new Error("Kiro does not support PreCompact hooks");
     }
-    parseSessionStartInput(_raw) {
-        throw new Error("Kiro does not support SessionStart hooks (yet)");
+    parseSessionStartInput(raw) {
+        // Kiro maps agentSpawn -> SessionStart. Stdin shape mirrors codex/CC.
+        const input = (raw ?? {});
+        const source = input.source ?? "startup";
+        return {
+            source,
+            sessionId: `pid-${process.ppid}`,
+            projectDir: input.cwd ?? process.cwd(),
+            raw,
+        };
     }
     // ── Response formatting ────────────────────────────────
     formatPreToolUseResponse(response) {
@@ -91,8 +99,16 @@ export class KiroAdapter extends BaseAdapter {
     formatPreCompactResponse(_response) {
         return undefined;
     }
-    formatSessionStartResponse(_response) {
-        return undefined;
+    formatSessionStartResponse(response) {
+        // Kiro agentSpawn returns the same hookSpecificOutput shape as CC SessionStart.
+        if (!response?.context)
+            return undefined;
+        return {
+            hookSpecificOutput: {
+                hookEventName: "agentSpawn",
+                additionalContext: response.context,
+            },
+        };
     }
     // ── Configuration ──────────────────────────────────────
     getSettingsPath() {
@@ -111,8 +127,8 @@ export class KiroAdapter extends BaseAdapter {
         return ["KIRO.md"];
     }
     generateHookConfig(pluginRoot) {
-        // Kiro CLI hook config format: { preToolUse: [{ matcher, command }] }
-        // Note: This generates the entries for agent config files
+        // Kiro CLI hook config format: { <hookName>: [{ matcher, command }] }
+        // Note: This generates the entries for agent config files (~/.kiro/agents/*.json).
         return {
             [KIRO_HOOK_TYPES.PRE_TOOL_USE]: [{
                     matcher: KIRO_PRE_TOOL_USE_MATCHER_PATTERN,
@@ -122,6 +138,14 @@ export class KiroAdapter extends BaseAdapter {
                     matcher: "*",
                     hooks: [{ type: "command", command: buildKiroHookCommand(KIRO_HOOK_TYPES.POST_TOOL_USE, pluginRoot) }],
                 }],
+            [KIRO_HOOK_TYPES.AGENT_SPAWN]: [{
+                    matcher: "*",
+                    hooks: [{ type: "command", command: buildKiroHookCommand(KIRO_HOOK_TYPES.AGENT_SPAWN, pluginRoot) }],
+                }],
+            [KIRO_HOOK_TYPES.USER_PROMPT_SUBMIT]: [{
+                    matcher: "*",
+                    hooks: [{ type: "command", command: buildKiroHookCommand(KIRO_HOOK_TYPES.USER_PROMPT_SUBMIT, pluginRoot) }],
+                }],
         };
     }
     readSettings() {
@@ -233,25 +257,23 @@ export class KiroAdapter extends BaseAdapter {
                 // No existing config — create new
             }
             const hooks = (config.hooks ?? {});
-            // Add preToolUse hook if not present
-            const preToolUseEntries = (hooks[KIRO_HOOK_TYPES.PRE_TOOL_USE] ?? []);
-            if (!preToolUseEntries.some(e => isKiroContextModeHook(e, KIRO_HOOK_TYPES.PRE_TOOL_USE))) {
-                preToolUseEntries.push({
-                    matcher: KIRO_PRE_TOOL_USE_MATCHER_PATTERN,
-                    command: buildKiroHookCommand(KIRO_HOOK_TYPES.PRE_TOOL_USE, pluginRoot),
-                });
-                hooks[KIRO_HOOK_TYPES.PRE_TOOL_USE] = preToolUseEntries;
-                changes.push(`Added ${KIRO_HOOK_TYPES.PRE_TOOL_USE} hook to ${defaultAgent}`);
-            }
-            // Add postToolUse hook if not present
-            const postToolUseEntries = (hooks[KIRO_HOOK_TYPES.POST_TOOL_USE] ?? []);
-            if (!postToolUseEntries.some(e => isKiroContextModeHook(e, KIRO_HOOK_TYPES.POST_TOOL_USE))) {
-                postToolUseEntries.push({
-                    matcher: "*",
-                    command: buildKiroHookCommand(KIRO_HOOK_TYPES.POST_TOOL_USE, pluginRoot),
-                });
-                hooks[KIRO_HOOK_TYPES.POST_TOOL_USE] = postToolUseEntries;
-                changes.push(`Added ${KIRO_HOOK_TYPES.POST_TOOL_USE} hook to ${defaultAgent}`);
+            // Hooks to add: [hookType, matcher]
+            const hookSpecs = [
+                [KIRO_HOOK_TYPES.PRE_TOOL_USE, KIRO_PRE_TOOL_USE_MATCHER_PATTERN],
+                [KIRO_HOOK_TYPES.POST_TOOL_USE, "*"],
+                [KIRO_HOOK_TYPES.AGENT_SPAWN, "*"],
+                [KIRO_HOOK_TYPES.USER_PROMPT_SUBMIT, "*"],
+            ];
+            for (const [hookType, matcher] of hookSpecs) {
+                const entries = (hooks[hookType] ?? []);
+                if (!entries.some(e => isKiroContextModeHook(e, hookType))) {
+                    entries.push({
+                        matcher,
+                        command: buildKiroHookCommand(hookType, pluginRoot),
+                    });
+                    hooks[hookType] = entries;
+                    changes.push(`Added ${hookType} hook to ${defaultAgent}`);
+                }
             }
             config.hooks = hooks;
             writeFileSync(defaultAgent, JSON.stringify(config, null, 2), "utf-8");

package/build/adapters/opencode/index.js

@@ -152,11 +152,17 @@ export class OpenCodeAdapter extends BaseAdapter {
     }
     paths() {
         if (this.platform === "kilo") {
+            // Kilo runtime accepts `.kilo/`, `.kilocode/`, and `.opencode/` as
+            // project config dirs (refs/platforms/kilo/packages/opencode/src/
+            // kilocode/config/config.ts:50,408). Mirror that here so context-mode
+            // discovers config regardless of which suffix the user adopted.
             return [
                 resolve("kilo.json"),
                 resolve("kilo.jsonc"),
                 resolve(".kilo", "kilo.json"),
                 resolve(".kilo", "kilo.jsonc"),
+                resolve(".kilocode", "kilo.json"),
+                resolve(".kilocode", "kilo.jsonc"),
                 join(homedir(), ".config", "kilo", "kilo.json"),
                 join(homedir(), ".config", "kilo", "kilo.jsonc"),
             ];

package/build/adapters/qwen-code/index.js

@@ -230,6 +230,9 @@ export class QwenCodeAdapter extends ClaudeCodeBaseAdapter {
             }
         }
         // ── Phase 2: Register fresh hooks ────────────────────
+        // All 5 hooks must be wired (z6 — capabilities declare 5 events but
+        // configureAllHooks previously only wrote 2). Qwen Code's hook stdin shape
+        // is wire-identical to Claude Code, so we reuse top-level hook scripts.
         const hookTypes = [
             {
                 name: "PreToolUse",
@@ -242,11 +245,26 @@ export class QwenCodeAdapter extends ClaudeCodeBaseAdapter {
                     "mcp__plugin_context-mode_context-mode__ctx_batch_execute",
                 ].join("|"),
             },
+            {
+                name: "PostToolUse",
+                script: "posttooluse.mjs",
+                matcher: "run_shell_command|read_file|write_file|edit|glob|grep_search|todo_write|agent|ask_user_question|mcp__",
+            },
             {
                 name: "SessionStart",
                 script: "sessionstart.mjs",
                 matcher: "",
             },
+            {
+                name: "PreCompact",
+                script: "precompact.mjs",
+                matcher: "",
+            },
+            {
+                name: "UserPromptSubmit",
+                script: "userpromptsubmit.mjs",
+                matcher: "",
+            },
         ];
         for (const { name, script, matcher } of hookTypes) {
             const entry = {

package/build/adapters/vscode-copilot/hooks.d.ts

@@ -10,7 +10,6 @@
  * VS Code Copilot hook system reference:
  *   - Hooks are registered in .github/hooks/*.json
  *   - Hook names: PreToolUse, PostToolUse, PreCompact, SessionStart (PascalCase)
- *   - Additional hooks: Stop, SubagentStart, SubagentStop (unique to VS Code)
  *   - CRITICAL: matchers are parsed but IGNORED (all hooks fire on all tools)
  *   - Input: JSON on stdin
  *   - Output: JSON on stdout (or empty for passthrough)
@@ -22,9 +21,6 @@ export declare const HOOK_TYPES: {
     readonly POST_TOOL_USE: "PostToolUse";
     readonly PRE_COMPACT: "PreCompact";
     readonly SESSION_START: "SessionStart";
-    readonly STOP: "Stop";
-    readonly SUBAGENT_START: "SubagentStart";
-    readonly SUBAGENT_STOP: "SubagentStop";
 };
 export type HookType = (typeof HOOK_TYPES)[keyof typeof HOOK_TYPES];
 /** Map of hook types to their script file names. */

package/build/adapters/vscode-copilot/hooks.js

@@ -11,7 +11,6 @@ import { buildNodeCommand } from "../types.js";
  * VS Code Copilot hook system reference:
  *   - Hooks are registered in .github/hooks/*.json
  *   - Hook names: PreToolUse, PostToolUse, PreCompact, SessionStart (PascalCase)
- *   - Additional hooks: Stop, SubagentStart, SubagentStop (unique to VS Code)
  *   - CRITICAL: matchers are parsed but IGNORED (all hooks fire on all tools)
  *   - Input: JSON on stdin
  *   - Output: JSON on stdout (or empty for passthrough)
@@ -26,10 +25,6 @@ export const HOOK_TYPES = {
     POST_TOOL_USE: "PostToolUse",
     PRE_COMPACT: "PreCompact",
     SESSION_START: "SessionStart",
-    // Additional hooks unique to VS Code Copilot
-    STOP: "Stop",
-    SUBAGENT_START: "SubagentStart",
-    SUBAGENT_STOP: "SubagentStop",
 };
 // ─────────────────────────────────────────────────────────
 // Hook script file names
@@ -77,7 +72,12 @@ export function buildHookCommand(hookType, pluginRoot) {
         throw new Error(`No script defined for hook type: ${hookType}`);
     }
     if (pluginRoot) {
-        return buildNodeCommand(`${pluginRoot}/hooks/${scriptName}`);
+        // v1.0.107 fix — was `${pluginRoot}/hooks/${scriptName}` which resolved to
+        // the Claude-Code generic hook (`hooks/pretooluse.mjs`) instead of the
+        // VSCode-specific wrapper at `hooks/vscode-copilot/pretooluse.mjs`. JetBrains
+        // adapter already had the correct subdir (jetbrains-copilot/hooks.ts:98)
+        // so this brings VSCode to parity.
+        return buildNodeCommand(`${pluginRoot}/hooks/vscode-copilot/${scriptName}`);
     }
     return `context-mode hook vscode-copilot ${hookType.toLowerCase()}`;
 }

package/build/cli.js

@@ -50,6 +50,7 @@ const HOOK_MAP = {
         posttooluse: "hooks/cursor/posttooluse.mjs",
         sessionstart: "hooks/cursor/sessionstart.mjs",
         stop: "hooks/cursor/stop.mjs",
+        afteragentresponse: "hooks/cursor/afteragentresponse.mjs",
     },
     "codex": {
         pretooluse: "hooks/codex/pretooluse.mjs",

package/build/openclaw/mcp-tools.d.ts

@@ -0,0 +1,54 @@
+/**
+ * OpenClaw MCP tool registry.
+ *
+ * Catalogs the 11 ctx_* tools that OpenClaw plugin must register via
+ * api.registerTool(...) so the routing block (which nudges agents toward
+ * ctx_execute, ctx_search, etc.) actually has tools to call. Without this,
+ * Phase 7 audit (v1.0.107-adapter-openclaw.json) flagged severity=CRITICAL —
+ * routing-block premise is broken when the named tools don't exist.
+ *
+ * Pattern mirrors the swarmvault MCP plugin
+ * (refs/plugin-examples/openclaw/swarmvault/packages/engine/src/mcp.ts:46-51):
+ *   server.registerTool(name, { description, inputSchema }, handler)
+ *
+ * OpenClaw signature is slightly different — see building-plugins.md:116
+ *   api.registerTool({ name, description, parameters: TypeBox, execute(id, params) })
+ *
+ * Tool handlers are intentionally thin shims that delegate to the bundled CLI
+ * (cli.bundle.mjs) — same fall-through pattern already used by ctx-doctor and
+ * ctx-upgrade slash commands. This keeps the plugin's blast radius minimal:
+ * we don't re-export the entire MCP server stack inside OpenClaw's process.
+ *
+ * The 11 tools mirror src/server.ts registerTool calls (lines 897, 1226, 1371,
+ * 1497, 2034, 2256, 2440, 2501, 2592, 2712, 2808).
+ */
+/** Minimal JSON-schema-like parameter spec accepted by OpenClaw registerTool. */
+export interface OpenClawToolParameters {
+    type: "object";
+    properties: Record<string, {
+        type: string;
+        description?: string;
+    }>;
+    required?: string[];
+    additionalProperties?: boolean;
+}
+/** Tool definition shape returned to OpenClaw via api.registerTool. */
+export interface OpenClawToolDef {
+    name: string;
+    description: string;
+    parameters: OpenClawToolParameters;
+    execute: (id: string, params: Record<string, unknown>) => Promise<{
+        content: Array<{
+            type: "text";
+            text: string;
+        }>;
+    }>;
+}
+/**
+ * The 11 ctx_* tool definitions registered into OpenClaw via api.registerTool.
+ * Names + descriptions mirror src/server.ts registerTool blocks 1:1 so prompts
+ * referencing them (routing block, AGENTS.md) resolve to real callable tools.
+ */
+export declare const OPENCLAW_TOOL_DEFS: readonly OpenClawToolDef[];
+/** Stable list of tool names — used by tests and manifest validation. */
+export declare const OPENCLAW_TOOL_NAMES: readonly string[];