context-mode 0.9.21 → 1.0.0

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

@@ -0,0 +1,468 @@
+/**
+ * adapters/gemini-cli — Gemini CLI platform adapter.
+ *
+ * Implements HookAdapter for Gemini CLI's JSON stdin/stdout hook paradigm.
+ *
+ * Gemini CLI hook specifics:
+ *   - I/O: JSON on stdin, JSON on stdout (same paradigm as Claude Code)
+ *   - Hook names: BeforeTool, AfterTool, PreCompress, SessionStart
+ *   - Arg modification: `hookSpecificOutput.tool_input` (merged with original)
+ *   - Blocking: `decision: "deny"` in response (NOT permissionDecision)
+ *   - Output modification: `decision: "deny"` + reason replaces output,
+ *     `hookSpecificOutput.additionalContext` appends
+ *   - PreCompress: advisory only (async, cannot block)
+ *   - No `decision: "ask"` support
+ *   - Hooks don't fire for subagents yet
+ *   - Config: ~/.gemini/settings.json (user), .gemini/settings.json (project)
+ *   - Session ID: session_id field
+ *   - Project dir env: GEMINI_PROJECT_DIR (also CLAUDE_PROJECT_DIR alias)
+ *   - Session dir: ~/.gemini/context-mode/sessions/
+ */
+import { createHash } from "node:crypto";
+import { readFileSync, writeFileSync, mkdirSync, copyFileSync, accessSync, chmodSync, constants, } from "node:fs";
+import { resolve, join } from "node:path";
+import { homedir } from "node:os";
+// ─────────────────────────────────────────────────────────
+// Hook constants (re-exported from hooks.ts)
+// ─────────────────────────────────────────────────────────
+import { HOOK_TYPES as GEMINI_HOOK_NAMES, HOOK_SCRIPTS as GEMINI_HOOK_SCRIPTS, } from "./hooks.js";
+// ─────────────────────────────────────────────────────────
+// Adapter implementation
+// ─────────────────────────────────────────────────────────
+export class GeminiCLIAdapter {
+    name = "Gemini CLI";
+    paradigm = "json-stdio";
+    capabilities = {
+        preToolUse: true,
+        postToolUse: true,
+        preCompact: true,
+        sessionStart: true,
+        canModifyArgs: true,
+        canModifyOutput: true,
+        canInjectSessionContext: true,
+    };
+    // ── Input parsing ──────────────────────────────────────
+    parsePreToolUseInput(raw) {
+        const input = raw;
+        return {
+            toolName: input.tool_name ?? "",
+            toolInput: input.tool_input ?? {},
+            sessionId: this.extractSessionId(input),
+            projectDir: this.getProjectDir(),
+            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: this.getProjectDir(),
+            raw,
+        };
+    }
+    parsePreCompactInput(raw) {
+        const input = raw;
+        return {
+            sessionId: this.extractSessionId(input),
+            projectDir: this.getProjectDir(),
+            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: this.getProjectDir(),
+            raw,
+        };
+    }
+    // ── Response formatting ────────────────────────────────
+    formatPreToolUseResponse(response) {
+        if (response.decision === "deny") {
+            return {
+                decision: "deny",
+                reason: response.reason ?? "Blocked by context-mode hook",
+            };
+        }
+        if (response.decision === "modify" && response.updatedInput) {
+            return {
+                hookSpecificOutput: {
+                    tool_input: response.updatedInput,
+                },
+            };
+        }
+        if (response.decision === "context" && response.additionalContext) {
+            // Gemini CLI: inject additionalContext via hookSpecificOutput
+            return {
+                hookSpecificOutput: {
+                    additionalContext: response.additionalContext,
+                },
+            };
+        }
+        if (response.decision === "ask") {
+            // Gemini CLI: no native "ask" — deny to be safe
+            return {
+                decision: "deny",
+                reason: response.reason ?? "Action requires user confirmation (security policy)",
+            };
+        }
+        // "allow" — return undefined for passthrough
+        return undefined;
+    }
+    formatPostToolUseResponse(response) {
+        if (response.updatedOutput) {
+            // Gemini CLI: decision "deny" + reason replaces output
+            return {
+                decision: "deny",
+                reason: response.updatedOutput,
+            };
+        }
+        if (response.additionalContext) {
+            return {
+                hookSpecificOutput: {
+                    additionalContext: response.additionalContext,
+                },
+            };
+        }
+        return undefined;
+    }
+    formatPreCompactResponse(response) {
+        // PreCompress is advisory only (async), but we can still return context
+        return response.context ?? "";
+    }
+    formatSessionStartResponse(response) {
+        return response.context ?? "";
+    }
+    // ── Configuration ──────────────────────────────────────
+    getSettingsPath() {
+        return resolve(homedir(), ".gemini", "settings.json");
+    }
+    getSessionDir() {
+        const dir = join(homedir(), ".gemini", "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) {
+        return {
+            [GEMINI_HOOK_NAMES.BEFORE_TOOL]: [
+                {
+                    matcher: "",
+                    hooks: [
+                        {
+                            type: "command",
+                            command: `context-mode hook gemini-cli ${GEMINI_HOOK_NAMES.BEFORE_TOOL.toLowerCase()}`,
+                        },
+                    ],
+                },
+            ],
+            [GEMINI_HOOK_NAMES.AFTER_TOOL]: [
+                {
+                    matcher: "",
+                    hooks: [
+                        {
+                            type: "command",
+                            command: `context-mode hook gemini-cli ${GEMINI_HOOK_NAMES.AFTER_TOOL.toLowerCase()}`,
+                        },
+                    ],
+                },
+            ],
+            [GEMINI_HOOK_NAMES.PRE_COMPRESS]: [
+                {
+                    matcher: "",
+                    hooks: [
+                        {
+                            type: "command",
+                            command: `context-mode hook gemini-cli ${GEMINI_HOOK_NAMES.PRE_COMPRESS.toLowerCase()}`,
+                        },
+                    ],
+                },
+            ],
+            [GEMINI_HOOK_NAMES.SESSION_START]: [
+                {
+                    matcher: "",
+                    hooks: [
+                        {
+                            type: "command",
+                            command: `context-mode hook gemini-cli ${GEMINI_HOOK_NAMES.SESSION_START.toLowerCase()}`,
+                        },
+                    ],
+                },
+            ],
+        };
+    }
+    readSettings() {
+        try {
+            const raw = readFileSync(this.getSettingsPath(), "utf-8");
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+    writeSettings(settings) {
+        const dir = resolve(homedir(), ".gemini");
+        mkdirSync(dir, { recursive: true });
+        writeFileSync(this.getSettingsPath(), JSON.stringify(settings, null, 2) + "\n", "utf-8");
+    }
+    // ── Diagnostics (doctor) ─────────────────────────────────
+    validateHooks(pluginRoot) {
+        const results = [];
+        const settings = this.readSettings();
+        if (!settings) {
+            results.push({
+                check: "BeforeTool hook",
+                status: "fail",
+                message: "Could not read ~/.gemini/settings.json",
+                fix: "context-mode upgrade",
+            });
+            return results;
+        }
+        const hooks = settings.hooks;
+        // Check BeforeTool
+        const beforeTool = hooks?.[GEMINI_HOOK_NAMES.BEFORE_TOOL];
+        if (beforeTool && beforeTool.length > 0) {
+            const hasHook = beforeTool.some((entry) => entry.hooks?.some((h) => h.command?.includes("context-mode")));
+            results.push({
+                check: "BeforeTool hook",
+                status: hasHook ? "pass" : "fail",
+                message: hasHook
+                    ? "BeforeTool hook configured"
+                    : "BeforeTool exists but does not point to context-mode",
+                fix: hasHook ? undefined : "context-mode upgrade",
+            });
+        }
+        else {
+            results.push({
+                check: "BeforeTool hook",
+                status: "fail",
+                message: "No BeforeTool hooks found",
+                fix: "context-mode upgrade",
+            });
+        }
+        // Check SessionStart
+        const sessionStart = hooks?.[GEMINI_HOOK_NAMES.SESSION_START];
+        if (sessionStart && sessionStart.length > 0) {
+            const hasHook = sessionStart.some((entry) => entry.hooks?.some((h) => h.command?.includes("context-mode")));
+            results.push({
+                check: "SessionStart hook",
+                status: hasHook ? "pass" : "fail",
+                message: hasHook
+                    ? "SessionStart hook configured"
+                    : "SessionStart exists but does not point to context-mode",
+                fix: hasHook ? undefined : "context-mode upgrade",
+            });
+        }
+        else {
+            results.push({
+                check: "SessionStart hook",
+                status: "fail",
+                message: "No SessionStart hooks found",
+                fix: "context-mode upgrade",
+            });
+        }
+        return results;
+    }
+    checkPluginRegistration() {
+        const settings = this.readSettings();
+        if (!settings) {
+            return {
+                check: "Plugin registration",
+                status: "warn",
+                message: "Could not read ~/.gemini/settings.json",
+            };
+        }
+        // Check in extensions or settings for context-mode
+        const extensions = settings.extensions;
+        if (extensions) {
+            const hasPlugin = Array.isArray(extensions)
+                ? extensions.some((e) => typeof e === "string" && e.includes("context-mode"))
+                : Object.keys(extensions).some((k) => k.includes("context-mode"));
+            if (hasPlugin) {
+                return {
+                    check: "Plugin registration",
+                    status: "pass",
+                    message: "context-mode found in extensions",
+                };
+            }
+        }
+        return {
+            check: "Plugin registration",
+            status: "warn",
+            message: "context-mode not found in extensions (might be using standalone MCP mode)",
+        };
+    }
+    getInstalledVersion() {
+        // Check ~/.gemini/ extension cache for context-mode
+        try {
+            const cachePath = resolve(homedir(), ".gemini", "extensions", "context-mode", "package.json");
+            const pkg = JSON.parse(readFileSync(cachePath, "utf-8"));
+            if (typeof pkg.version === "string")
+                return pkg.version;
+        }
+        catch {
+            /* not found */
+        }
+        return "not installed";
+    }
+    // ── Upgrade ────────────────────────────────────────────
+    configureAllHooks(_pluginRoot) {
+        const settings = this.readSettings() ?? {};
+        const hooks = (settings.hooks ?? {});
+        const changes = [];
+        const hookConfigs = [
+            { name: GEMINI_HOOK_NAMES.BEFORE_TOOL },
+            { name: GEMINI_HOOK_NAMES.SESSION_START },
+        ];
+        for (const config of hookConfigs) {
+            const command = `context-mode hook gemini-cli ${config.name.toLowerCase()}`;
+            const entry = {
+                matcher: "",
+                hooks: [{ type: "command", command }],
+            };
+            const existing = hooks[config.name];
+            if (existing && Array.isArray(existing)) {
+                const idx = existing.findIndex((e) => {
+                    const entryHooks = e.hooks;
+                    return entryHooks?.some((h) => h.command?.includes("context-mode"));
+                });
+                if (idx >= 0) {
+                    existing[idx] = entry;
+                    changes.push(`Updated existing ${config.name} hook entry`);
+                }
+                else {
+                    existing.push(entry);
+                    changes.push(`Added ${config.name} hook entry`);
+                }
+                hooks[config.name] = existing;
+            }
+            else {
+                hooks[config.name] = [entry];
+                changes.push(`Created ${config.name} hooks section`);
+            }
+        }
+        settings.hooks = hooks;
+        this.writeSettings(settings);
+        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", "gemini-cli");
+        for (const scriptName of Object.values(GEMINI_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) {
+        // Gemini CLI doesn't have a formal plugin registry like Claude Code.
+        // Update the extension cache package.json if it exists.
+        try {
+            const pkgPath = resolve(homedir(), ".gemini", "extensions", "context-mode", "package.json");
+            const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+            pkg.version = version;
+            pkg.installPath = pluginRoot;
+            pkg.lastUpdated = new Date().toISOString();
+            writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n", "utf-8");
+        }
+        catch {
+            /* best effort */
+        }
+    }
+    // ── Routing Instructions (soft enforcement) ────────────
+    getRoutingInstructionsConfig() {
+        return {
+            fileName: "GEMINI.md",
+            globalPath: resolve(homedir(), ".gemini", "GEMINI.md"),
+            projectRelativePath: "GEMINI.md",
+        };
+    }
+    writeRoutingInstructions(projectDir, pluginRoot) {
+        const config = this.getRoutingInstructionsConfig();
+        const targetPath = resolve(projectDir, config.projectRelativePath);
+        const sourcePath = resolve(pluginRoot, "configs", "gemini-cli", config.fileName);
+        try {
+            const content = readFileSync(sourcePath, "utf-8");
+            try {
+                const existing = readFileSync(targetPath, "utf-8");
+                if (existing.includes("context-mode"))
+                    return null;
+                writeFileSync(targetPath, existing.trimEnd() + "\n\n" + content, "utf-8");
+                return targetPath;
+            }
+            catch {
+                writeFileSync(targetPath, content, "utf-8");
+                return targetPath;
+            }
+        }
+        catch {
+            return null;
+        }
+    }
+    // ── Internal helpers ───────────────────────────────────
+    /** Get the project directory from environment variables. */
+    getProjectDir() {
+        return process.env.GEMINI_PROJECT_DIR ?? process.env.CLAUDE_PROJECT_DIR;
+    }
+    /**
+     * Extract session ID from Gemini CLI hook input.
+     * Priority: session_id field > env fallback > ppid fallback.
+     */
+    extractSessionId(input) {
+        if (input.session_id)
+            return input.session_id;
+        return `pid-${process.ppid}`;
+    }
+}

package/build/adapters/opencode/config.d.ts

@@ -0,0 +1,8 @@
+/**
+ * adapters/opencode/config — Thin re-exports from OpenCodeAdapter.
+ *
+ * This module exists for backward compatibility. All logic lives in the
+ * adapter class (index.ts). New code should use getAdapter() from detect.ts.
+ */
+export { OpenCodeAdapter } from "./index.js";
+export { HOOK_TYPES, REQUIRED_HOOKS, OPTIONAL_HOOKS } from "./hooks.js";

package/build/adapters/opencode/config.js

@@ -0,0 +1,8 @@
+/**
+ * adapters/opencode/config — Thin re-exports from OpenCodeAdapter.
+ *
+ * This module exists for backward compatibility. All logic lives in the
+ * adapter class (index.ts). New code should use getAdapter() from detect.ts.
+ */
+export { OpenCodeAdapter } from "./index.js";
+export { HOOK_TYPES, REQUIRED_HOOKS, OPTIONAL_HOOKS } from "./hooks.js";

package/build/adapters/opencode/hooks.d.ts

@@ -0,0 +1,38 @@
+/**
+ * adapters/opencode/hooks — OpenCode hook definitions and validators.
+ *
+ * Defines the hook types and validation helpers specific to OpenCode's
+ * TypeScript plugin paradigm. This module is used by:
+ *   - CLI setup/upgrade commands (to configure plugin in opencode.json)
+ *   - Doctor command (to validate plugin configuration)
+ *
+ * OpenCode hook system reference:
+ *   - I/O: TS plugin functions (not JSON stdin/stdout)
+ *   - Hook names: tool.execute.before, tool.execute.after, experimental.session.compacting
+ *   - Arg modification: output.args mutation
+ *   - Blocking: throw Error in tool.execute.before
+ *   - SessionStart: broken (#14808, no hook #5409)
+ *   - Config: opencode.json plugin array, .opencode/plugins/*.ts
+ */
+/** OpenCode hook types (TS plugin event names). */
+export declare const HOOK_TYPES: {
+    readonly BEFORE: "tool.execute.before";
+    readonly AFTER: "tool.execute.after";
+    readonly COMPACTING: "experimental.session.compacting";
+};
+export type HookType = (typeof HOOK_TYPES)[keyof typeof HOOK_TYPES];
+/**
+ * Required hooks that must be active for context-mode to function.
+ * OpenCode uses TS plugin paradigm — no scripts, just event hooks.
+ */
+export declare const REQUIRED_HOOKS: HookType[];
+/**
+ * Optional hooks that enhance functionality but aren't critical.
+ * experimental.session.compacting is advisory.
+ */
+export declare const OPTIONAL_HOOKS: HookType[];
+/**
+ * Check if an OpenCode plugin entry is the context-mode plugin.
+ * OpenCode plugins are registered as strings in the plugin array.
+ */
+export declare function isContextModePlugin(pluginEntry: string): boolean;

package/build/adapters/opencode/hooks.js

@@ -0,0 +1,50 @@
+/**
+ * adapters/opencode/hooks — OpenCode hook definitions and validators.
+ *
+ * Defines the hook types and validation helpers specific to OpenCode's
+ * TypeScript plugin paradigm. This module is used by:
+ *   - CLI setup/upgrade commands (to configure plugin in opencode.json)
+ *   - Doctor command (to validate plugin configuration)
+ *
+ * OpenCode hook system reference:
+ *   - I/O: TS plugin functions (not JSON stdin/stdout)
+ *   - Hook names: tool.execute.before, tool.execute.after, experimental.session.compacting
+ *   - Arg modification: output.args mutation
+ *   - Blocking: throw Error in tool.execute.before
+ *   - SessionStart: broken (#14808, no hook #5409)
+ *   - Config: opencode.json plugin array, .opencode/plugins/*.ts
+ */
+// ─────────────────────────────────────────────────────────
+// Hook type constants
+// ─────────────────────────────────────────────────────────
+/** OpenCode hook types (TS plugin event names). */
+export const HOOK_TYPES = {
+    BEFORE: "tool.execute.before",
+    AFTER: "tool.execute.after",
+    COMPACTING: "experimental.session.compacting",
+};
+// ─────────────────────────────────────────────────────────
+// Hook validation
+// ─────────────────────────────────────────────────────────
+/**
+ * Required hooks that must be active for context-mode to function.
+ * OpenCode uses TS plugin paradigm — no scripts, just event hooks.
+ */
+export const REQUIRED_HOOKS = [
+    HOOK_TYPES.BEFORE,
+    HOOK_TYPES.AFTER,
+];
+/**
+ * Optional hooks that enhance functionality but aren't critical.
+ * experimental.session.compacting is advisory.
+ */
+export const OPTIONAL_HOOKS = [
+    HOOK_TYPES.COMPACTING,
+];
+/**
+ * Check if an OpenCode plugin entry is the context-mode plugin.
+ * OpenCode plugins are registered as strings in the plugin array.
+ */
+export function isContextModePlugin(pluginEntry) {
+    return pluginEntry.includes("context-mode");
+}

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

@@ -0,0 +1,52 @@
+/**
+ * adapters/opencode — OpenCode platform adapter.
+ *
+ * Implements HookAdapter for OpenCode's TypeScript plugin paradigm.
+ *
+ * OpenCode hook specifics:
+ *   - I/O: TS plugin functions (not JSON stdin/stdout)
+ *   - Hook names: tool.execute.before, tool.execute.after, experimental.session.compacting
+ *   - Arg modification: output.args mutation
+ *   - Blocking: throw Error in tool.execute.before
+ *   - Output modification: output.output mutation (TUI bug for bash #13575)
+ *   - SessionStart: broken (#14808, no hook #5409)
+ *   - Session ID: input.sessionID (camelCase!)
+ *   - Project dir: ctx.directory in plugin init (no env var)
+ *   - Config: opencode.json plugin array, .opencode/plugins/*.ts
+ *   - Session dir: ~/.config/opencode/context-mode/sessions/
+ */
+import type { HookAdapter, HookParadigm, PlatformCapabilities, DiagnosticResult, PreToolUseEvent, PostToolUseEvent, PreCompactEvent, SessionStartEvent, PreToolUseResponse, PostToolUseResponse, PreCompactResponse, SessionStartResponse, HookRegistration, RoutingInstructionsConfig } from "../types.js";
+export declare class OpenCodeAdapter implements HookAdapter {
+    readonly name = "OpenCode";
+    readonly paradigm: HookParadigm;
+    readonly capabilities: PlatformCapabilities;
+    parsePreToolUseInput(raw: unknown): PreToolUseEvent;
+    parsePostToolUseInput(raw: unknown): PostToolUseEvent;
+    parsePreCompactInput(raw: unknown): PreCompactEvent;
+    parseSessionStartInput(raw: unknown): SessionStartEvent;
+    formatPreToolUseResponse(response: PreToolUseResponse): unknown;
+    formatPostToolUseResponse(response: PostToolUseResponse): unknown;
+    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;
+    validateHooks(_pluginRoot: string): DiagnosticResult[];
+    checkPluginRegistration(): DiagnosticResult;
+    getInstalledVersion(): string;
+    configureAllHooks(_pluginRoot: string): string[];
+    backupSettings(): string | null;
+    setHookPermissions(_pluginRoot: string): string[];
+    updatePluginRegistry(_pluginRoot: string, _version: string): void;
+    getRoutingInstructionsConfig(): RoutingInstructionsConfig;
+    writeRoutingInstructions(projectDir: string, pluginRoot: string): string | null;
+    /**
+     * Extract session ID from OpenCode hook input.
+     * OpenCode uses camelCase sessionID.
+     */
+    private extractSessionId;
+}