context-mode 1.0.168 → 2.0.0-next.5

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

@@ -1,83 +0,0 @@
-/**
- * adapters/gemini-cli/hooks — Gemini CLI hook definitions and matchers.
- *
- * Defines the hook types, matchers, and registration format specific to
- * Gemini CLI's hook system. This module is used by:
- *   - CLI setup/upgrade commands (to configure hooks in settings.json)
- *   - Doctor command (to validate hook configuration)
- *   - Hook config generation
- *
- * 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: BeforeAgent, BeforeTool, AfterTool, AfterModel, PreCompress, SessionStart
- *   - AfterModel fires per model call inside the stream loop
- *     (packages/core/src/core/geminiChat.ts:1213); payload carries
- *     llm_request + llm_response (hooks/types.ts:692-695) whose
- *     usageMetadata + resolved model drive per-turn token/cost capture
- *     (refs: docs/prds/2026-06-paid-observability/adapter-matrix/gemini-cli.md).
- *   - 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 AFTER_MODEL: "AfterModel";
-    readonly PRE_COMPRESS: "PreCompress";
-    readonly SESSION_START: "SessionStart";
-};
-export type HookType = (typeof HOOK_TYPES)[keyof typeof HOOK_TYPES];
-/**
- * Negative-lookahead matcher for external MCP tool namespaces on Gemini CLI (#529).
- *
- * Gemini CLI MCP wire shape: `mcp__<server>__<tool>` (verified in
- * hooks/core/tool-naming.mjs — context-mode's own tools surface as
- * `mcp__context-mode__<tool>`). This pattern fires BeforeTool for any
- * external `mcp__<server>__<tool>` whose server segment does NOT contain
- * `context-mode`. Without it, large payloads from slack / telegram / gdrive /
- * notion-style MCPs bypass the routing nudge and flood the model's context.
- *
- * The negative lookahead `(?!.*context-mode)` covers both the canonical
- * `mcp__context-mode__*` and any Claude shim `mcp__plugin_context-mode_*`
- * names. Gemini native bare tool names (run_shell_command, read_file, …)
- * are not `mcp__`-prefixed and are unaffected.
- */
-export declare const EXTERNAL_MCP_MATCHER_PATTERN = "mcp__(?!.*context-mode)";
-/** Map of hook types to their script file names. */
-export declare const HOOK_SCRIPTS: Record<HookType, string>;
-/** Required hooks that must be configured for context-mode to function. */
-export declare const REQUIRED_HOOKS: HookType[];
-/** Optional hooks that enhance functionality but aren't critical. */
-export declare const OPTIONAL_HOOKS: HookType[];
-/**
- * Check if a hook entry points to a context-mode hook script.
- * Matches both legacy format (node .../beforetool.mjs) and
- * CLI dispatcher format (context-mode hook gemini-cli beforetool).
- */
-export declare function isContextModeHook(entry: {
-    hooks?: Array<{
-        command?: string;
-    }>;
-}, hookType: HookType): boolean;
-/**
- * Build the hook command string for a given hook type.
- * Uses absolute node path to avoid PATH issues (homebrew, nvm, volta, etc.).
- * Falls back to CLI dispatcher if pluginRoot is not provided.
- *
- * Issue #712: gemini-cli hook scripts live under `hooks/gemini-cli/<script>`
- * on disk (verified via the published `files` field in package.json and
- * HOOK_MAP in src/cli.ts which uses the same subdir for the CLI
- * dispatcher form). The introducing commit (f5c9d02) carried claude-code's
- * flat `hooks/<script>` shape over without accounting for the platform
- * subdir, causing `ctx doctor` to FAIL every hook on every install
- * (paths pointed at `<pluginRoot>/hooks/<script>` which never exist for
- * gemini-cli). `setHookPermissions` in index.ts already uses the correct
- * subdir, so this restores three-callsite parity.
- */
-export declare function buildHookCommand(hookType: HookType, pluginRoot?: string): string;

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

@@ -1,115 +0,0 @@
-import { buildHookRuntimeCommand } from "../types.js";
-/**
- * adapters/gemini-cli/hooks — Gemini CLI hook definitions and matchers.
- *
- * Defines the hook types, matchers, and registration format specific to
- * Gemini CLI's hook system. This module is used by:
- *   - CLI setup/upgrade commands (to configure hooks in settings.json)
- *   - Doctor command (to validate hook configuration)
- *   - Hook config generation
- *
- * 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: BeforeAgent, BeforeTool, AfterTool, AfterModel, PreCompress, SessionStart
- *   - AfterModel fires per model call inside the stream loop
- *     (packages/core/src/core/geminiChat.ts:1213); payload carries
- *     llm_request + llm_response (hooks/types.ts:692-695) whose
- *     usageMetadata + resolved model drive per-turn token/cost capture
- *     (refs: docs/prds/2026-06-paid-observability/adapter-matrix/gemini-cli.md).
- *   - 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",
-    AFTER_MODEL: "AfterModel",
-    PRE_COMPRESS: "PreCompress",
-    SESSION_START: "SessionStart",
-};
-// ─────────────────────────────────────────────────────────
-// External MCP routing matcher (#529)
-// ─────────────────────────────────────────────────────────
-/**
- * Negative-lookahead matcher for external MCP tool namespaces on Gemini CLI (#529).
- *
- * Gemini CLI MCP wire shape: `mcp__<server>__<tool>` (verified in
- * hooks/core/tool-naming.mjs — context-mode's own tools surface as
- * `mcp__context-mode__<tool>`). This pattern fires BeforeTool for any
- * external `mcp__<server>__<tool>` whose server segment does NOT contain
- * `context-mode`. Without it, large payloads from slack / telegram / gdrive /
- * notion-style MCPs bypass the routing nudge and flood the model's context.
- *
- * The negative lookahead `(?!.*context-mode)` covers both the canonical
- * `mcp__context-mode__*` and any Claude shim `mcp__plugin_context-mode_*`
- * names. Gemini native bare tool names (run_shell_command, read_file, …)
- * are not `mcp__`-prefixed and are unaffected.
- */
-export const EXTERNAL_MCP_MATCHER_PATTERN = "mcp__(?!.*context-mode)";
-// ─────────────────────────────────────────────────────────
-// Hook script file names
-// ─────────────────────────────────────────────────────────
-/** 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.AFTER_MODEL]: "aftermodel.mjs",
-    [HOOK_TYPES.PRE_COMPRESS]: "precompress.mjs",
-    [HOOK_TYPES.SESSION_START]: "sessionstart.mjs",
-};
-// ─────────────────────────────────────────────────────────
-// Hook validation
-// ─────────────────────────────────────────────────────────
-/** Required hooks that must be configured for context-mode to function. */
-export const REQUIRED_HOOKS = [
-    HOOK_TYPES.BEFORE_TOOL,
-    HOOK_TYPES.SESSION_START,
-];
-/** Optional hooks that enhance functionality but aren't critical. */
-export const OPTIONAL_HOOKS = [
-    HOOK_TYPES.AFTER_TOOL,
-    HOOK_TYPES.AFTER_MODEL,
-    HOOK_TYPES.PRE_COMPRESS,
-];
-/**
- * Check if a hook entry points to a context-mode hook script.
- * Matches both legacy format (node .../beforetool.mjs) and
- * CLI dispatcher format (context-mode hook gemini-cli beforetool).
- */
-export function isContextModeHook(entry, hookType) {
-    const scriptName = HOOK_SCRIPTS[hookType];
-    const cliCommand = buildHookCommand(hookType);
-    return (entry.hooks?.some((h) => h.command?.includes(scriptName) || h.command?.includes(cliCommand)) ?? false);
-}
-/**
- * Build the hook command string for a given hook type.
- * Uses absolute node path to avoid PATH issues (homebrew, nvm, volta, etc.).
- * Falls back to CLI dispatcher if pluginRoot is not provided.
- *
- * Issue #712: gemini-cli hook scripts live under `hooks/gemini-cli/<script>`
- * on disk (verified via the published `files` field in package.json and
- * HOOK_MAP in src/cli.ts which uses the same subdir for the CLI
- * dispatcher form). The introducing commit (f5c9d02) carried claude-code's
- * flat `hooks/<script>` shape over without accounting for the platform
- * subdir, causing `ctx doctor` to FAIL every hook on every install
- * (paths pointed at `<pluginRoot>/hooks/<script>` which never exist for
- * gemini-cli). `setHookPermissions` in index.ts already uses the correct
- * subdir, so this restores three-callsite parity.
- */
-export function buildHookCommand(hookType, pluginRoot) {
-    const scriptName = HOOK_SCRIPTS[hookType];
-    if (pluginRoot && scriptName) {
-        return buildHookRuntimeCommand(`${pluginRoot}/hooks/gemini-cli/${scriptName}`);
-    }
-    return `context-mode hook gemini-cli ${hookType.toLowerCase()}`;
-}

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

@@ -1,80 +0,0 @@
-/**
- * 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 { BaseAdapter } from "../base.js";
-import type { HookAdapter, HookParadigm, PlatformCapabilities, DiagnosticResult, HealthCheck, PreToolUseEvent, PostToolUseEvent, PreCompactEvent, SessionStartEvent, PreToolUseResponse, PostToolUseResponse, PreCompactResponse, SessionStartResponse, HookRegistration } from "../types.js";
-export declare class GeminiCLIAdapter extends BaseAdapter implements HookAdapter {
-    constructor();
-    readonly name = "Gemini CLI";
-    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;
-    getInstructionFiles(): string[];
-    generateHookConfig(pluginRoot: string): HookRegistration;
-    readSettings(): Record<string, unknown> | null;
-    writeSettings(settings: Record<string, unknown>): void;
-    validateHooks(pluginRoot: string): DiagnosticResult[];
-    /**
-     * Adapter-defined health checks (Algo-D1) — mirrors claude-code's override
-     * at src/adapters/claude-code/index.ts:275.
-     *
-     * Issue #712 motivation: gemini-cli's hook scripts ship under
-     * `<pluginRoot>/hooks/gemini-cli/<scriptName>` (see HOOK_MAP in
-     * src/cli.ts and `setHookPermissions` in this file). The legacy doctor
-     * path (`getHookScriptPaths` -> `extractHookScriptPath`) round-trips
-     * through `buildHookCommand` -> command-string parsing, so a missing
-     * platform subdir in the emit was invisible to the doctor until a user
-     * installed globally and observed FAIL lines. This override drops the
-     * round-trip: HOOK_SCRIPTS is the single source of truth and we probe
-     * `existsSync(join(pluginRoot, "hooks", "gemini-cli", scriptName))`
-     * directly, so a future regression in the command emit cannot make the
-     * doctor lie about hook health.
-     *
-     * Adding a new hook event in HOOK_SCRIPTS auto-extends doctor coverage
-     * here — no parallel hardcoded list to maintain.
-     */
-    getHealthChecks(pluginRoot: string): readonly HealthCheck[];
-    checkPluginRegistration(): DiagnosticResult;
-    getInstalledVersion(): string;
-    configureAllHooks(pluginRoot: string): string[];
-    setHookPermissions(pluginRoot: string): string[];
-    updatePluginRegistry(pluginRoot: string, version: string): void;
-    /**
-     * Resolve the project directory for a Gemini CLI hook input.
-     * Priority: input.cwd > GEMINI_PROJECT_DIR > CLAUDE_PROJECT_DIR > process.cwd().
-     * Mirrors the cursor / opencode pattern so downstream hooks always
-     * receive a defined projectDir even when the platform omits cwd
-     * from the wire payload (e.g. under worktrees).
-     */
-    private getProjectDir;
-    /**
-     * Extract session ID from Gemini CLI hook input.
-     * Priority: session_id field > env fallback > ppid fallback.
-     */
-    private extractSessionId;
-}