context-mode 1.0.89 → 1.0.90

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

@@ -1,30 +1,18 @@
 /**
  * adapters/vscode-copilot — VS Code Copilot platform adapter.
  *
- * Implements HookAdapter for VS Code Copilot's JSON stdin/stdout hook paradigm.
- *
- * VS Code Copilot hook specifics:
- *   - I/O: JSON on stdin, JSON on stdout (same paradigm as Claude Code)
- *   - Hook names: PreToolUse, PostToolUse, PreCompact, SessionStart (PascalCase)
- *   - Additional hooks: Stop, SubagentStart, SubagentStop (unique to VS Code)
- *   - Arg modification: `updatedInput` in hookSpecificOutput wrapper (NOT flat)
- *   - Blocking: `permissionDecision: "deny"` (same as Claude Code)
- *   - Output modification: `additionalContext` in hookSpecificOutput,
- *     `decision: "block"` + reason
- *   - Tool input fields: tool_name, tool_input (snake_case, same as Claude Code)
- *   - But tool input PROPERTY names are camelCase (filePath not file_path)
- *   - Session ID: sessionId (camelCase, NOT session_id)
- *   - MCP tool prefix: f1e_ (not mcp__server__tool)
- *   - CRITICAL: matchers are parsed but IGNORED (all hooks fire on all tools)
- *   - Config: .github/hooks/*.json (primary), also reads .claude/settings.json
- *   - Env detection: VSCODE_PID, TERM_PROGRAM=vscode
- *   - Session dir: ~/.vscode/context-mode/sessions/ (fallback)
- *   - Preview status — API may change
+ * Extends CopilotBaseAdapter with VS Code-specific logic:
+ *   - extractSessionId: VSCODE_PID fallback
+ *   - getProjectDir: CLAUDE_PROJECT_DIR
+ *   - getSessionDir: .github/ detection with ~/.vscode/ fallback
+ *   - checkPluginRegistration: reads .vscode/mcp.json
+ *   - getInstalledVersion: scans VS Code extensions dir
+ *   - validateHooks: preview status + matcher warnings
  */
-import { createHash } from "node:crypto";
-import { readFileSync, writeFileSync, mkdirSync, copyFileSync, accessSync, existsSync, chmodSync, constants, } from "node:fs";
+import { readFileSync, mkdirSync, accessSync, existsSync, constants, } from "node:fs";
 import { resolve, join } from "node:path";
 import { homedir } from "node:os";
+import { CopilotBaseAdapter } from "../copilot-base.js";
 // ─────────────────────────────────────────────────────────
 // Hook constants (re-exported from hooks.ts)
 // ─────────────────────────────────────────────────────────
@@ -32,143 +20,29 @@ import { HOOK_TYPES as VSCODE_HOOK_NAMES, HOOK_SCRIPTS as VSCODE_HOOK_SCRIPTS, b
 // ─────────────────────────────────────────────────────────
 // Adapter implementation
 // ─────────────────────────────────────────────────────────
-export class VSCodeCopilotAdapter {
+export class VSCodeCopilotAdapter extends CopilotBaseAdapter {
+    constructor() {
+        // sessionDirSegments unused — vscode-copilot overrides getSessionDir()
+        // with .github directory detection fallback logic
+        super([".vscode"]);
+    }
     name = "VS Code Copilot";
-    paradigm = "json-stdio";
-    capabilities = {
-        preToolUse: true,
-        postToolUse: true,
-        preCompact: true,
-        sessionStart: true,
-        canModifyArgs: true,
-        canModifyOutput: true,
-        canInjectSessionContext: true,
+    hookModule = {
+        HOOK_TYPES: VSCODE_HOOK_NAMES,
+        HOOK_SCRIPTS: VSCODE_HOOK_SCRIPTS,
+        buildHookCommand: buildVSCodeHookCommand,
     };
-    // ── Input parsing ──────────────────────────────────────
-    parsePreToolUseInput(raw) {
-        const input = raw;
-        return {
-            toolName: input.tool_name ?? "",
-            toolInput: input.tool_input ?? {},
-            sessionId: this.extractSessionId(input),
-            projectDir: process.env.CLAUDE_PROJECT_DIR || process.cwd(),
-            raw,
-        };
-    }
-    parsePostToolUseInput(raw) {
-        const input = raw;
-        return {
-            toolName: input.tool_name ?? "",
-            toolInput: input.tool_input ?? {},
-            toolOutput: input.tool_output,
-            isError: input.is_error,
-            sessionId: this.extractSessionId(input),
-            projectDir: process.env.CLAUDE_PROJECT_DIR || process.cwd(),
-            raw,
-        };
-    }
-    parsePreCompactInput(raw) {
-        const input = raw;
-        return {
-            sessionId: this.extractSessionId(input),
-            projectDir: process.env.CLAUDE_PROJECT_DIR || process.cwd(),
-            raw,
-        };
-    }
-    parseSessionStartInput(raw) {
-        const input = raw;
-        const rawSource = input.source ?? "startup";
-        let source;
-        switch (rawSource) {
-            case "compact":
-                source = "compact";
-                break;
-            case "resume":
-                source = "resume";
-                break;
-            case "clear":
-                source = "clear";
-                break;
-            default:
-                source = "startup";
-        }
-        return {
-            sessionId: this.extractSessionId(input),
-            source,
-            projectDir: process.env.CLAUDE_PROJECT_DIR || process.cwd(),
-            raw,
-        };
-    }
-    // ── Response formatting ────────────────────────────────
-    formatPreToolUseResponse(response) {
-        if (response.decision === "deny") {
-            return {
-                permissionDecision: "deny",
-                reason: response.reason ?? "Blocked by context-mode hook",
-            };
-        }
-        if (response.decision === "modify" && response.updatedInput) {
-            // VS Code Copilot: updatedInput is wrapped in hookSpecificOutput
-            return {
-                hookSpecificOutput: {
-                    hookEventName: VSCODE_HOOK_NAMES.PRE_TOOL_USE,
-                    updatedInput: response.updatedInput,
-                },
-            };
-        }
-        if (response.decision === "context" && response.additionalContext) {
-            // VS Code Copilot: inject additionalContext via hookSpecificOutput
-            return {
-                hookSpecificOutput: {
-                    hookEventName: VSCODE_HOOK_NAMES.PRE_TOOL_USE,
-                    additionalContext: response.additionalContext,
-                },
-            };
-        }
-        if (response.decision === "ask") {
-            // VS Code Copilot: use deny to force user attention (no native "ask")
-            return {
-                permissionDecision: "deny",
-                reason: response.reason ?? "Action requires user confirmation (security policy)",
-            };
-        }
-        // "allow" — return undefined for passthrough
-        return undefined;
-    }
-    formatPostToolUseResponse(response) {
-        if (response.updatedOutput) {
-            // VS Code Copilot: decision "block" + reason for output replacement
-            return {
-                hookSpecificOutput: {
-                    hookEventName: VSCODE_HOOK_NAMES.POST_TOOL_USE,
-                    decision: "block",
-                    reason: response.updatedOutput,
-                },
-            };
-        }
-        if (response.additionalContext) {
-            return {
-                hookSpecificOutput: {
-                    hookEventName: VSCODE_HOOK_NAMES.POST_TOOL_USE,
-                    additionalContext: response.additionalContext,
-                },
-            };
-        }
-        return undefined;
-    }
-    formatPreCompactResponse(response) {
-        // VS Code Copilot: stdout content on exit 0 is injected as context
-        return response.context ?? "";
-    }
-    formatSessionStartResponse(response) {
-        // VS Code Copilot: stdout content is injected as additional context
-        return response.context ?? "";
+    hookSubdir = "vscode-copilot";
+    // ── Platform-specific overrides ────────────────────────
+    extractSessionId(input) {
+        if (input.sessionId)
+            return input.sessionId;
+        if (process.env.VSCODE_PID)
+            return `vscode-${process.env.VSCODE_PID}`;
+        return `pid-${process.ppid}`;
     }
-    // ── Configuration ──────────────────────────────────────
-    getSettingsPath() {
-        // VS Code Copilot primarily uses .github/hooks/*.json
-        // but also reads .claude/settings.json
-        return resolve(".github", "hooks", "context-mode.json");
+    getProjectDir() {
+        return process.env.CLAUDE_PROJECT_DIR || process.cwd();
     }
     getSessionDir() {
         // Prefer .github/context-mode/sessions/ if .github exists,
@@ -179,91 +53,6 @@ export class VSCodeCopilotAdapter {
         mkdirSync(dir, { recursive: true });
         return dir;
     }
-    getSessionDBPath(projectDir) {
-        const hash = createHash("sha256")
-            .update(projectDir)
-            .digest("hex")
-            .slice(0, 16);
-        return join(this.getSessionDir(), `${hash}.db`);
-    }
-    getSessionEventsPath(projectDir) {
-        const hash = createHash("sha256")
-            .update(projectDir)
-            .digest("hex")
-            .slice(0, 16);
-        return join(this.getSessionDir(), `${hash}-events.md`);
-    }
-    generateHookConfig(pluginRoot) {
-        return {
-            [VSCODE_HOOK_NAMES.PRE_TOOL_USE]: [
-                {
-                    matcher: "",
-                    hooks: [
-                        {
-                            type: "command",
-                            command: buildVSCodeHookCommand(VSCODE_HOOK_NAMES.PRE_TOOL_USE, pluginRoot),
-                        },
-                    ],
-                },
-            ],
-            [VSCODE_HOOK_NAMES.POST_TOOL_USE]: [
-                {
-                    matcher: "",
-                    hooks: [
-                        {
-                            type: "command",
-                            command: buildVSCodeHookCommand(VSCODE_HOOK_NAMES.POST_TOOL_USE, pluginRoot),
-                        },
-                    ],
-                },
-            ],
-            [VSCODE_HOOK_NAMES.PRE_COMPACT]: [
-                {
-                    matcher: "",
-                    hooks: [
-                        {
-                            type: "command",
-                            command: buildVSCodeHookCommand(VSCODE_HOOK_NAMES.PRE_COMPACT, pluginRoot),
-                        },
-                    ],
-                },
-            ],
-            [VSCODE_HOOK_NAMES.SESSION_START]: [
-                {
-                    matcher: "",
-                    hooks: [
-                        {
-                            type: "command",
-                            command: buildVSCodeHookCommand(VSCODE_HOOK_NAMES.SESSION_START, pluginRoot),
-                        },
-                    ],
-                },
-            ],
-        };
-    }
-    readSettings() {
-        // Try .github/hooks/context-mode.json first, then .claude/settings.json
-        const paths = [
-            this.getSettingsPath(),
-            resolve(".claude", "settings.json"),
-        ];
-        for (const configPath of paths) {
-            try {
-                const raw = readFileSync(configPath, "utf-8");
-                return JSON.parse(raw);
-            }
-            catch {
-                continue;
-            }
-        }
-        return null;
-    }
-    writeSettings(settings) {
-        const configPath = this.getSettingsPath();
-        const dir = resolve(".github", "hooks");
-        mkdirSync(dir, { recursive: true });
-        writeFileSync(configPath, JSON.stringify(settings, null, 2) + "\n", "utf-8");
-    }
     // ── Diagnostics (doctor) ─────────────────────────────────
     validateHooks(pluginRoot) {
         const results = [];
@@ -397,84 +186,4 @@ export class VSCodeCopilotAdapter {
         }
         return "not installed";
     }
-    // ── Upgrade ────────────────────────────────────────────
-    configureAllHooks(pluginRoot) {
-        const changes = [];
-        const hookConfig = { hooks: {} };
-        const hooks = hookConfig.hooks;
-        const hookTypes = [
-            VSCODE_HOOK_NAMES.PRE_TOOL_USE,
-            VSCODE_HOOK_NAMES.POST_TOOL_USE,
-            VSCODE_HOOK_NAMES.PRE_COMPACT,
-            VSCODE_HOOK_NAMES.SESSION_START,
-        ];
-        for (const hookType of hookTypes) {
-            const script = VSCODE_HOOK_SCRIPTS[hookType];
-            if (!script)
-                continue;
-            hooks[hookType] = [
-                {
-                    matcher: "",
-                    hooks: [
-                        {
-                            type: "command",
-                            command: buildVSCodeHookCommand(hookType, pluginRoot),
-                        },
-                    ],
-                },
-            ];
-            changes.push(`Configured ${hookType} hook`);
-        }
-        // Write to .github/hooks/context-mode.json
-        const outputDir = resolve(".github", "hooks");
-        mkdirSync(outputDir, { recursive: true });
-        const outputPath = resolve(outputDir, "context-mode.json");
-        writeFileSync(outputPath, JSON.stringify(hookConfig, null, 2) + "\n", "utf-8");
-        changes.push(`Wrote hook config to ${outputPath}`);
-        return changes;
-    }
-    backupSettings() {
-        const settingsPath = this.getSettingsPath();
-        try {
-            accessSync(settingsPath, constants.R_OK);
-            const backupPath = settingsPath + ".bak";
-            copyFileSync(settingsPath, backupPath);
-            return backupPath;
-        }
-        catch {
-            return null;
-        }
-    }
-    setHookPermissions(pluginRoot) {
-        const set = [];
-        const hooksDir = join(pluginRoot, "hooks", "vscode-copilot");
-        for (const scriptName of Object.values(VSCODE_HOOK_SCRIPTS)) {
-            const scriptPath = resolve(hooksDir, scriptName);
-            try {
-                accessSync(scriptPath, constants.R_OK);
-                chmodSync(scriptPath, 0o755);
-                set.push(scriptPath);
-            }
-            catch {
-                /* skip missing scripts */
-            }
-        }
-        return set;
-    }
-    updatePluginRegistry(_pluginRoot, _version) {
-        // VS Code manages extensions through its own marketplace/extension system.
-        // No manual registry update needed.
-    }
-    // ── Internal helpers ───────────────────────────────────
-    /**
-     * Extract session ID from VS Code Copilot hook input.
-     * VS Code Copilot uses camelCase sessionId (NOT session_id).
-     */
-    extractSessionId(input) {
-        if (input.sessionId)
-            return input.sessionId;
-        if (process.env.VSCODE_PID)
-            return `vscode-${process.env.VSCODE_PID}`;
-        return `pid-${process.ppid}`;
-    }
 }

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

@@ -10,8 +10,10 @@
  *   - All capabilities are false — MCP is the only integration path
  *   - Session dir: ~/.config/zed/context-mode/sessions/
  */
+import { BaseAdapter } from "../base.js";
 import type { HookAdapter, HookParadigm, PlatformCapabilities, DiagnosticResult, PreToolUseEvent, PostToolUseEvent, PreCompactEvent, SessionStartEvent, PreToolUseResponse, PostToolUseResponse, PreCompactResponse, SessionStartResponse, HookRegistration } from "../types.js";
-export declare class ZedAdapter implements HookAdapter {
+export declare class ZedAdapter extends BaseAdapter implements HookAdapter {
+    constructor();
     readonly name = "Zed";
     readonly paradigm: HookParadigm;
     readonly capabilities: PlatformCapabilities;
@@ -24,9 +26,6 @@ export declare class ZedAdapter implements HookAdapter {
     formatPreCompactResponse(_response: PreCompactResponse): unknown;
     formatSessionStartResponse(_response: SessionStartResponse): unknown;
     getSettingsPath(): string;
-    getSessionDir(): string;
-    getSessionDBPath(projectDir: string): string;
-    getSessionEventsPath(projectDir: string): string;
     generateHookConfig(_pluginRoot: string): HookRegistration;
     readSettings(): Record<string, unknown> | null;
     writeSettings(settings: Record<string, unknown>): void;
@@ -34,7 +33,6 @@ export declare class ZedAdapter implements HookAdapter {
     checkPluginRegistration(): DiagnosticResult;
     getInstalledVersion(): string;
     configureAllHooks(_pluginRoot: string): string[];
-    backupSettings(): string | null;
     setHookPermissions(_pluginRoot: string): string[];
     updatePluginRegistry(_pluginRoot: string, _version: string): void;
     getRoutingInstructions(): string;

package/build/adapters/zed/index.js

@@ -10,15 +10,18 @@
  *   - All capabilities are false — MCP is the only integration path
  *   - Session dir: ~/.config/zed/context-mode/sessions/
  */
-import { createHash } from "node:crypto";
-import { readFileSync, writeFileSync, mkdirSync, copyFileSync, accessSync, constants, } from "node:fs";
-import { resolve, join, dirname } from "node:path";
+import { readFileSync, writeFileSync, mkdirSync, } from "node:fs";
+import { resolve, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
 import { homedir } from "node:os";
+import { BaseAdapter } from "../base.js";
 // ─────────────────────────────────────────────────────────
 // Adapter implementation
 // ─────────────────────────────────────────────────────────
-export class ZedAdapter {
+export class ZedAdapter extends BaseAdapter {
+    constructor() {
+        super([".config", "zed"]);
+    }
     name = "Zed";
     paradigm = "mcp-only";
     capabilities = {
@@ -63,25 +66,6 @@ export class ZedAdapter {
     getSettingsPath() {
         return resolve(homedir(), ".config", "zed", "settings.json");
     }
-    getSessionDir() {
-        const dir = join(homedir(), ".config", "zed", "context-mode", "sessions");
-        mkdirSync(dir, { recursive: true });
-        return dir;
-    }
-    getSessionDBPath(projectDir) {
-        const hash = createHash("sha256")
-            .update(projectDir)
-            .digest("hex")
-            .slice(0, 16);
-        return join(this.getSessionDir(), `${hash}.db`);
-    }
-    getSessionEventsPath(projectDir) {
-        const hash = createHash("sha256")
-            .update(projectDir)
-            .digest("hex")
-            .slice(0, 16);
-        return join(this.getSessionDir(), `${hash}-events.md`);
-    }
     generateHookConfig(_pluginRoot) {
         // Zed does not support hooks — return empty registration
         return {};
@@ -156,18 +140,6 @@ export class ZedAdapter {
         // Zed does not support hooks — nothing to configure
         return [];
     }
-    backupSettings() {
-        const settingsPath = this.getSettingsPath();
-        try {
-            accessSync(settingsPath, constants.R_OK);
-            const backupPath = settingsPath + ".bak";
-            copyFileSync(settingsPath, backupPath);
-            return backupPath;
-        }
-        catch {
-            return null;
-        }
-    }
     setHookPermissions(_pluginRoot) {
         // No hook scripts for Zed
         return [];

package/build/cli.js

@@ -60,6 +60,19 @@ const HOOK_MAP = {
         pretooluse: "hooks/kiro/pretooluse.mjs",
         posttooluse: "hooks/kiro/posttooluse.mjs",
     },
+    "jetbrains-copilot": {
+        pretooluse: "hooks/jetbrains-copilot/pretooluse.mjs",
+        posttooluse: "hooks/jetbrains-copilot/posttooluse.mjs",
+        precompact: "hooks/jetbrains-copilot/precompact.mjs",
+        sessionstart: "hooks/jetbrains-copilot/sessionstart.mjs",
+    },
+    "qwen-code": {
+        pretooluse: "hooks/pretooluse.mjs",
+        posttooluse: "hooks/posttooluse.mjs",
+        precompact: "hooks/precompact.mjs",
+        sessionstart: "hooks/sessionstart.mjs",
+        userpromptsubmit: "hooks/userpromptsubmit.mjs",
+    },
 };
 async function hookDispatch(platform, event) {
     // Suppress stderr at OS fd level — native C++ modules (better-sqlite3) write

package/build/lifecycle.d.ts

@@ -17,6 +17,29 @@ export interface LifecycleGuardOptions {
     /** Injectable parent-alive check (for testing). Default: ppid-based check. */
     isParentAlive?: () => boolean;
 }
+/** Injectable dependencies for {@link makeDefaultIsParentAlive}. */
+export interface IsParentAliveDeps {
+    /** Read the current ppid. Default: `() => process.ppid`. */
+    getPpid?: () => number;
+    /** Read the grandparent ppid. Default: ps-based POSIX probe, NaN on Windows. */
+    readGrandparentPpid?: () => number;
+}
+/**
+ * Build a parent-liveness check that handles the npm-exec wrapper case (#311).
+ *
+ * A plain ppid comparison misses Claude Code sessions launched via
+ * `start.mjs → npm exec → context-mode server`: when Claude Code dies,
+ * `start.mjs` reparents to init but `npm exec` stays alive, so the server's
+ * direct ppid never changes. We additionally check whether the grandparent
+ * process has been reparented to init (PID 1). When the original grandparent
+ * was already 1 (daemonized startup) the check is skipped, and on Windows
+ * where there's no cheap `ps` equivalent we also skip — so this change is
+ * strictly additive to the previous behavior.
+ *
+ * Exported for unit-testing with injected readers. Production code uses
+ * {@link defaultIsParentAlive} (captured once at module load).
+ */
+export declare function makeDefaultIsParentAlive(deps?: IsParentAliveDeps): () => boolean;
 /**
  * Start the lifecycle guard. Returns a cleanup function.
  * Skipped automatically when stdin is a TTY (e.g. OpenCode ts-plugin).

package/build/lifecycle.js

@@ -9,23 +9,64 @@
  *
  * Cross-platform: macOS, Linux, Windows.
  */
+import { execFileSync } from "node:child_process";
+/** Read grandparent PID via `ps -o ppid= -p $PPID`. Returns NaN on failure or Windows. */
+function readGrandparentPpidImpl() {
+    if (process.platform === "win32")
+        return NaN;
+    const ppid = process.ppid;
+    if (!ppid || ppid <= 1)
+        return NaN;
+    try {
+        const out = execFileSync("ps", ["-o", "ppid=", "-p", String(ppid)], {
+            encoding: "utf-8",
+            timeout: 2000,
+            stdio: ["ignore", "pipe", "ignore"],
+        }).trim();
+        const n = parseInt(out, 10);
+        return Number.isFinite(n) ? n : NaN;
+    }
+    catch {
+        return NaN;
+    }
+}
 /**
- * Default parent liveness check.
- * Compares current ppid against the original — if it changed (reparented to
- * init/launchd/systemd), parent is dead. This is more reliable than
- * kill(ppid, 0) which succeeds for PID 1 on all platforms.
+ * Build a parent-liveness check that handles the npm-exec wrapper case (#311).
+ *
+ * A plain ppid comparison misses Claude Code sessions launched via
+ * `start.mjs → npm exec → context-mode server`: when Claude Code dies,
+ * `start.mjs` reparents to init but `npm exec` stays alive, so the server's
+ * direct ppid never changes. We additionally check whether the grandparent
+ * process has been reparented to init (PID 1). When the original grandparent
+ * was already 1 (daemonized startup) the check is skipped, and on Windows
+ * where there's no cheap `ps` equivalent we also skip — so this change is
+ * strictly additive to the previous behavior.
  *
- * On Windows, ppid becomes 0 when parent exits.
+ * Exported for unit-testing with injected readers. Production code uses
+ * {@link defaultIsParentAlive} (captured once at module load).
  */
-const originalPpid = process.ppid;
-function defaultIsParentAlive() {
-    const ppid = process.ppid;
-    if (ppid !== originalPpid)
-        return false;
-    if (ppid === 0 || ppid === 1)
-        return false;
-    return true;
+export function makeDefaultIsParentAlive(deps = {}) {
+    const getPpid = deps.getPpid ?? (() => process.ppid);
+    const readGp = deps.readGrandparentPpid ?? readGrandparentPpidImpl;
+    const originalPpid = getPpid();
+    const originalGrandparentPpid = readGp();
+    return () => {
+        const ppid = getPpid();
+        if (ppid !== originalPpid)
+            return false;
+        if (ppid === 0 || ppid === 1)
+            return false;
+        // Grandparent orphan check (#311): npm-exec wrappers stay alive past the
+        // session owner. If our grandparent is now PID 1 but wasn't at startup,
+        // the wrapping chain is orphaned and we should shut down.
+        if (!Number.isNaN(originalGrandparentPpid) && originalGrandparentPpid > 1) {
+            if (readGp() === 1)
+                return false;
+        }
+        return true;
+    };
 }
+const defaultIsParentAlive = makeDefaultIsParentAlive();
 /**
  * Start the lifecycle guard. Returns a cleanup function.
  * Skipped automatically when stdin is a TTY (e.g. OpenCode ts-plugin).

package/build/opencode-plugin.d.ts

@@ -1,12 +1,16 @@
 /**
- * OpenCode TypeScript plugin entry point for context-mode.
+ * OpenCode / KiloCode TypeScript plugin entry point for context-mode.
  *
  * Provides three hooks:
  *   - tool.execute.before  — Routing enforcement (deny/modify/passthrough)
  *   - tool.execute.after   — Session event capture
  *   - experimental.session.compacting — Compaction snapshot generation
  *
- * Loaded by OpenCode via: import("context-mode/plugin").ContextModePlugin(ctx)
+ * KiloCode loads this via: import("context-mode") → expects default export
+ * with shape { server: (input) => Promise<Hooks> } (PluginModule).
+ *
+ * OpenCode loads this via: import("context-mode/plugin") → also supports
+ * the named export ContextModePlugin for backward compat.
  *
  * Constraints:
  *   - No SessionStart hook (OpenCode doesn't support it — #14808, #5409)
@@ -14,9 +18,10 @@
  *   - No routing file auto-write (avoid dirtying project trees)
  *   - Session cleanup happens at plugin init (no SessionStart)
  */
-/** OpenCode plugin context passed to the factory function. */
+/** KiloCode/OpenCode plugin input — both platforms pass at least `directory`. */
 interface PluginContext {
     directory: string;
+    [key: string]: unknown;
 }
 /** OpenCode tool.execute.before — first parameter */
 interface BeforeHookInput {
@@ -51,12 +56,19 @@ interface CompactingHookOutput {
     prompt?: string;
 }
 /**
- * OpenCode plugin factory. Called once when OpenCode loads the plugin.
+ * Plugin factory. Called once when KiloCode/OpenCode loads the plugin.
  * Returns an object mapping hook event names to async handler functions.
-*/
-export declare const ContextModePlugin: (ctx: PluginContext) => Promise<{
+ *
+ * KiloCode expects: export default { server: (input) => Promise<Hooks> }
+ * OpenCode expects: export const ContextModePlugin = (ctx) => Promise<Hooks>
+ */
+declare function createContextModePlugin(ctx: PluginContext): Promise<{
     "tool.execute.before": (input: BeforeHookInput, output: BeforeHookOutput) => Promise<void>;
     "tool.execute.after": (input: AfterHookInput, output: AfterHookOutput) => Promise<void>;
     "experimental.session.compacting": (input: CompactingHookInput, output: CompactingHookOutput) => Promise<string>;
 }>;
-export {};
+declare const _default: {
+    server: typeof createContextModePlugin;
+};
+export default _default;
+export { createContextModePlugin as ContextModePlugin };