context-mode 1.0.168 → 2.0.0-next.5

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

@@ -1,341 +0,0 @@
-/**
- * adapters/copilot-cli — GitHub Copilot CLI adapter.
- *
- * Native config:
- *   - MCP:   $COPILOT_HOME/mcp-config.json or ~/.copilot/mcp-config.json
- *            under root key `mcpServers`.
- *   - Hooks: $COPILOT_HOME/hooks/context-mode.json or
- *            ~/.copilot/hooks/context-mode.json.
- *
- * Hooks use Copilot CLI's native camelCase event keys (preToolUse /
- * postToolUse / sessionStart / userPromptSubmitted / agentStop / preCompact)
- * with flat `{ type, command }` entries. (The CLI also accepts PascalCase
- * event names alongside camelCase — copilot-cli changelog.md:1065 — so the
- * casing is not load-bearing; we use camelCase because it is the CLI's native
- * naming.) Copilot CLI's command output contract is top-level
- * (`permissionDecision`, `modifiedArgs`, `additionalContext`), so this adapter
- * overrides the response formatter from CopilotBaseAdapter.
- */
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { homedir } from "node:os";
-import { dirname, join, resolve } from "node:path";
-import { CopilotBaseAdapter } from "../copilot-base.js";
-import { resolveContextModeDataRoot } from "../base.js";
-import { parseJsonc } from "../../util/jsonc.js";
-import { HOOK_TYPES as COPILOT_HOOK_NAMES, HOOK_SCRIPTS as COPILOT_HOOK_SCRIPTS, buildHookCommand as buildCopilotHookCommand, } from "./hooks.js";
-const COPILOT_PLUGIN_ENV = "CONTEXT_MODE_COPILOT_PLUGIN";
-function isCopilotPluginRuntime() {
-    return process.env[COPILOT_PLUGIN_ENV] === "1";
-}
-function copilotPluginHooksPath(pluginRoot) {
-    return resolve(pluginRoot, "configs", "copilot-cli", "hooks.json");
-}
-function readHookConfig(path) {
-    return parseJsonc(readFileSync(path, "utf-8")) ?? {};
-}
-function hasHook(hooks, hookName) {
-    return Array.isArray(hooks?.[hookName]) && (hooks?.[hookName]).length > 0;
-}
-export function copilotCliHome() {
-    const raw = process.env.COPILOT_HOME;
-    if (raw && raw.trim() !== "") {
-        if (raw.startsWith("~")) {
-            return join(homedir(), raw.replace(/^~[/\\]?/, ""));
-        }
-        return resolve(raw);
-    }
-    return join(homedir(), ".copilot");
-}
-export function copilotCliMcpConfigPath() {
-    return join(copilotCliHome(), "mcp-config.json");
-}
-export class CopilotCliAdapter extends CopilotBaseAdapter {
-    constructor() {
-        super([".copilot"]);
-    }
-    name = "GitHub Copilot CLI";
-    hookModule = {
-        HOOK_TYPES: COPILOT_HOOK_NAMES,
-        HOOK_SCRIPTS: COPILOT_HOOK_SCRIPTS,
-        buildHookCommand: buildCopilotHookCommand,
-    };
-    hookSubdir = "copilot-cli";
-    extractSessionId(input) {
-        const raw = input;
-        if (raw.transcript_path) {
-            const match = raw.transcript_path.match(/([a-f0-9-]{36})\.jsonl$/);
-            if (match)
-                return match[1];
-        }
-        if (raw.conversation_id)
-            return raw.conversation_id;
-        // `session_id` (snake_case) is the field Copilot CLI documents in its hook
-        // payloads (copilot-cli changelog.md:811). Prefer it; `sessionId` (camelCase)
-        // is kept only as a defensive fallback for non-standard payload shapes and is
-        // not a documented Copilot CLI field.
-        if (raw.session_id)
-            return raw.session_id;
-        if (input.sessionId)
-            return input.sessionId;
-        return `pid-${process.ppid}`;
-    }
-    getProjectDir() {
-        return process.cwd();
-    }
-    parsePreToolUseInput(raw) {
-        const input = raw;
-        return {
-            toolName: input.tool_name ?? input.toolName ?? "",
-            toolInput: input.tool_input ?? input.toolArgs ?? {},
-            sessionId: this.extractSessionId(input),
-            projectDir: typeof input.cwd === "string" && input.cwd ? input.cwd : process.cwd(),
-            raw,
-        };
-    }
-    parsePostToolUseInput(raw) {
-        const input = raw;
-        const output = input.tool_result?.text_result_for_llm ??
-            input.toolResult?.textResultForLlm ??
-            (typeof input.tool_response === "string" ? input.tool_response : undefined) ??
-            input.tool_output;
-        return {
-            toolName: input.tool_name ?? input.toolName ?? "",
-            toolInput: input.tool_input ?? input.toolArgs ?? {},
-            toolOutput: output,
-            isError: input.is_error,
-            sessionId: this.extractSessionId(input),
-            projectDir: typeof input.cwd === "string" && input.cwd ? input.cwd : process.cwd(),
-            raw,
-        };
-    }
-    getSettingsPath(_projectDir) {
-        return join(copilotCliHome(), "hooks", "context-mode.json");
-    }
-    getConfigDir(_projectDir) {
-        return copilotCliHome();
-    }
-    getSessionDir() {
-        // Parity with codex/kimi: honor CONTEXT_MODE_DATA_DIR first, else root
-        // session storage at getConfigDir() (= copilotCliHome(), COPILOT_HOME-aware)
-        // so the TS server reads sessions from the SAME place the hook runtime
-        // (COPILOT_OPTS configDirEnv: "COPILOT_HOME") writes them. Without this, a
-        // relocated COPILOT_HOME splits hook writes ($COPILOT_HOME/...) from server
-        // reads (~/.copilot/...) and sessions appear empty/orphaned.
-        const override = resolveContextModeDataRoot();
-        const dir = override
-            ? join(override, "context-mode", "sessions")
-            : join(this.getConfigDir(), "context-mode", "sessions");
-        mkdirSync(dir, { recursive: true });
-        return dir;
-    }
-    getInstructionFiles() {
-        return [".github/copilot-instructions.md", "AGENTS.md"];
-    }
-    // ── Hook-config writing (Copilot CLI shape) ────────────
-    //
-    // GitHub Copilot CLI's hooks schema differs from the VS Code / JetBrains
-    // Copilot extensions that share CopilotBaseAdapter:
-    //   - hook entries are FLAT `{ type: "command", command }` — NOT the
-    //     Claude-Code nested `{ matcher, hooks: [...] }` shape the base emits, and
-    //   - we emit a top-level `"version": 1`. This is OPTIONAL, not mandatory:
-    //     the Copilot CLI accepts hook config files that omit the version field
-    //     (copilot-cli changelog.md:1109). We still write version:1 to pin the
-    //     schema explicitly — it is harmless and self-documenting, NOT a
-    //     hooks-never-fire requirement.
-    // The shared base also hardcodes `mkdir .github/hooks` and writes there, but
-    // this adapter's settings live at ~/.copilot/hooks/context-mode.json, so
-    // writeSettings is overridden to create the real parent directory. All three
-    // overrides are scoped to copilot-cli so vscode/jetbrains-copilot keep the
-    // shared base behavior unchanged.
-    generateHookConfig(pluginRoot) {
-        const { HOOK_TYPES, buildHookCommand } = this.hookModule;
-        const flat = (hookType) => [
-            { type: "command", command: buildHookCommand(hookType, pluginRoot) },
-        ];
-        // Emit an entry for every declared hook type (preToolUse, postToolUse,
-        // preCompact, sessionStart, userPromptSubmitted, agentStop).
-        const config = {};
-        for (const hookType of Object.values(HOOK_TYPES)) {
-            config[hookType] = flat(hookType);
-        }
-        return config;
-    }
-    writeSettings(settings) {
-        const configPath = this.getSettingsPath();
-        mkdirSync(dirname(configPath), { recursive: true });
-        writeFileSync(configPath, JSON.stringify(settings, null, 2) + "\n", "utf-8");
-    }
-    configureAllHooks(pluginRoot) {
-        const changes = [];
-        const settings = this.readSettings() ?? {};
-        const hooks = settings.hooks ?? {};
-        const { HOOK_TYPES, HOOK_SCRIPTS, buildHookCommand } = this.hookModule;
-        // Configure every hook type the module declares (preToolUse, postToolUse,
-        // preCompact, sessionStart, userPromptSubmitted, agentStop) — driven by
-        // HOOK_TYPES so new events are picked up automatically.
-        for (const hookType of Object.values(HOOK_TYPES)) {
-            if (!HOOK_SCRIPTS[hookType])
-                continue;
-            const desired = [
-                { type: "command", command: buildHookCommand(hookType, pluginRoot) },
-            ];
-            // Only treat a hook as drift when it differs from desired, so repeated
-            // `context-mode upgrade` runs stay idempotent.
-            if (JSON.stringify(hooks[hookType]) !== JSON.stringify(desired)) {
-                hooks[hookType] = desired;
-                changes.push(`Configured ${hookType} hook`);
-            }
-        }
-        // We pin version:1 explicitly (optional per copilot-cli changelog.md:1109,
-        // but self-documenting); treat a missing/mismatched value as drift to repair.
-        if (settings.version !== 1) {
-            changes.push("Set hooks schema version to 1");
-        }
-        if (changes.length > 0) {
-            settings.version = 1;
-            settings.hooks = hooks;
-            this.writeSettings(settings);
-            changes.push(`Wrote hook config to ${this.getSettingsPath()}`);
-        }
-        return changes;
-    }
-    readSettings() {
-        try {
-            const raw = readFileSync(this.getSettingsPath(), "utf-8");
-            return parseJsonc(raw) ?? null;
-        }
-        catch {
-            return null;
-        }
-    }
-    formatPreToolUseResponse(response) {
-        if (response.decision === "deny") {
-            return {
-                permissionDecision: "deny",
-                permissionDecisionReason: response.reason ?? "Blocked by context-mode hook",
-            };
-        }
-        if (response.decision === "ask") {
-            return {
-                permissionDecision: "ask",
-                permissionDecisionReason: response.reason ?? "Action requires user confirmation",
-            };
-        }
-        if (response.decision === "modify" && response.updatedInput) {
-            return { modifiedArgs: response.updatedInput };
-        }
-        if (response.decision === "context" && response.additionalContext) {
-            return { additionalContext: response.additionalContext };
-        }
-        return undefined;
-    }
-    formatPostToolUseResponse(response) {
-        if (response.updatedOutput) {
-            return {
-                modifiedResult: {
-                    resultType: "success",
-                    textResultForLlm: response.updatedOutput,
-                },
-            };
-        }
-        if (response.additionalContext) {
-            return { additionalContext: response.additionalContext };
-        }
-        return undefined;
-    }
-    formatPreCompactResponse(response) {
-        void response;
-        return undefined;
-    }
-    formatSessionStartResponse(response) {
-        return response.context ? { additionalContext: response.context } : undefined;
-    }
-    validateHooks(pluginRoot) {
-        const results = [];
-        const pluginRuntime = isCopilotPluginRuntime();
-        const settingsPath = pluginRuntime ? copilotPluginHooksPath(pluginRoot) : this.getSettingsPath();
-        const settingsLabel = pluginRuntime
-            ? `Copilot CLI plugin bundle hooks.json (${settingsPath})`
-            : settingsPath;
-        const fix = pluginRuntime
-            ? "copilot plugin install mksglu/context-mode:configs/copilot-cli"
-            : "context-mode upgrade";
-        try {
-            const config = readHookConfig(settingsPath);
-            const hooks = config.hooks;
-            results.push({
-                check: "Hooks schema version",
-                status: config.version === 1 ? "pass" : "fail",
-                message: config.version === 1
-                    ? `${settingsLabel} declares the required "version": 1`
-                    : `${settingsLabel} is missing top-level "version": 1`,
-                ...(config.version === 1 ? {} : { fix }),
-            });
-            for (const hookName of Object.values(COPILOT_HOOK_NAMES)) {
-                const configured = hasHook(hooks, hookName);
-                results.push({
-                    check: `${hookName} hook`,
-                    status: configured ? "pass" : "fail",
-                    message: configured
-                        ? `${hookName} hook configured in ${settingsLabel}`
-                        : `${hookName} not found in ${settingsLabel}`,
-                    ...(configured ? {} : { fix }),
-                });
-            }
-        }
-        catch {
-            results.push({
-                check: "Hook configuration",
-                status: "fail",
-                message: `Could not read ${settingsLabel}`,
-                fix,
-            });
-        }
-        return results;
-    }
-    checkPluginRegistration() {
-        if (isCopilotPluginRuntime()) {
-            return {
-                check: "MCP registration",
-                status: "pass",
-                message: "context-mode loaded from the Copilot CLI plugin bundle",
-            };
-        }
-        try {
-            const raw = readFileSync(copilotCliMcpConfigPath(), "utf-8");
-            const config = parseJsonc(raw) ?? {};
-            const mcpServers = config?.mcpServers ?? {};
-            if ("context-mode" in mcpServers) {
-                return {
-                    check: "MCP registration",
-                    status: "pass",
-                    message: "context-mode found in Copilot CLI mcp-config.json",
-                };
-            }
-            return {
-                check: "MCP registration",
-                status: "fail",
-                message: "context-mode not found in Copilot CLI mcpServers",
-                // `context-mode upgrade` configures HOOKS only — never the MCP server.
-                // Copilot CLI's own command writes ~/.copilot/mcp-config.json for us.
-                fix: "copilot mcp add context-mode -- context-mode",
-            };
-        }
-        catch {
-            return {
-                check: "MCP registration",
-                status: "fail",
-                message: `Could not read ${copilotCliMcpConfigPath()}`,
-                fix: "copilot mcp add context-mode -- context-mode",
-            };
-        }
-    }
-    getInstalledVersion() {
-        // Copilot's user-level MCP config and local/plugin-dir bundle do not expose
-        // a durable installed plugin version to this process. The npm package
-        // version is already checked above, so avoid the false `vconfigured` WARN.
-        return existsSync(copilotCliMcpConfigPath()) || existsSync(this.getSettingsPath())
-            ? "standalone"
-            : "not installed";
-    }
-}

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

@@ -1,4 +0,0 @@
-/**
- * adapters/cursor/config — Thin re-exports from CursorAdapter.
- */
-export { CursorAdapter } from "./index.js";

package/build/adapters/cursor/config.js

@@ -1,4 +0,0 @@
-/**
- * adapters/cursor/config — Thin re-exports from CursorAdapter.
- */
-export { CursorAdapter } from "./index.js";

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

@@ -1,55 +0,0 @@
-/**
- * adapters/cursor/hooks — Cursor hook definitions and config helpers.
- *
- * Cursor native hook config lives in `.cursor/hooks.json` or `~/.cursor/hooks.json`.
- * Unlike Claude/Gemini/VS Code Copilot, each hook entry is a flat object rather
- * than a `{ matcher, hooks: [...] }` wrapper.
- */
-/** Cursor hook type names. */
-export declare const HOOK_TYPES: {
-    readonly PRE_TOOL_USE: "preToolUse";
-    readonly POST_TOOL_USE: "postToolUse";
-    readonly SESSION_START: "sessionStart";
-    readonly STOP: "stop";
-    readonly AFTER_AGENT_RESPONSE: "afterAgentResponse";
-};
-export type HookType = (typeof HOOK_TYPES)[keyof typeof HOOK_TYPES];
-/** Map of hook types that have actual script files. */
-export declare const HOOK_SCRIPTS: Partial<Record<HookType, string>>;
-/**
- * Negative-lookahead matcher for external MCP tool namespaces on Cursor (#529).
- *
- * Cursor MCP wire shape: `MCP:<tool>` (verified in
- * tests/fixtures/cursor/pretooluse-mcp.json, hooks/cursor/posttooluse.mjs:19-25).
- * Context-mode's own tools surface as `MCP:ctx_<...>`. The negative lookahead
- * on the `ctx_` prefix fires for every other MCP tool whose payload would
- * otherwise flood the model's context window before PostToolUse can act.
- *
- * Routing.mjs `isExternalMcpTool` is extended to recognise the `MCP:` prefix
- * so the routing branch returns external-MCP guidance instead of passthrough.
- */
-export declare const EXTERNAL_MCP_MATCHER_PATTERN = "MCP:(?!ctx_)";
-/** Canonical Cursor-native matchers for tools context-mode routes proactively. */
-export declare const PRE_TOOL_USE_MATCHERS: readonly ["Shell", "Read", "Grep", "WebFetch", "mcp_web_fetch", "mcp_fetch_tool", "Task", "MCP:ctx_execute", "MCP:ctx_execute_file", "MCP:ctx_batch_execute", "MCP:(?!ctx_)"];
-export declare const PRE_TOOL_USE_MATCHER_PATTERN: string;
-/** Required hooks for native Cursor support. */
-export declare const REQUIRED_HOOKS: HookType[];
-/** Optional hooks that improve behavior but aren't strictly required. */
-export declare const OPTIONAL_HOOKS: HookType[];
-/** Minimal native Cursor hook entry shape. */
-export interface CursorHookCommandEntry {
-    type?: string;
-    command?: string;
-    matcher?: string;
-    timeout?: number;
-    loop_limit?: number | null;
-    failClosed?: boolean;
-}
-/** Check whether a native Cursor hook entry points to context-mode. */
-export declare function isContextModeHook(entry: CursorHookCommandEntry | {
-    hooks?: Array<{
-        command?: string;
-    }>;
-}, hookType: HookType): boolean;
-/** Build the CLI dispatcher command for a Cursor hook type. */
-export declare function buildHookCommand(hookType: HookType): string;

package/build/adapters/cursor/hooks.js

@@ -1,82 +0,0 @@
-/**
- * adapters/cursor/hooks — Cursor hook definitions and config helpers.
- *
- * Cursor native hook config lives in `.cursor/hooks.json` or `~/.cursor/hooks.json`.
- * Unlike Claude/Gemini/VS Code Copilot, each hook entry is a flat object rather
- * than a `{ matcher, hooks: [...] }` wrapper.
- */
-/** Cursor hook type names. */
-export const HOOK_TYPES = {
-    PRE_TOOL_USE: "preToolUse",
-    POST_TOOL_USE: "postToolUse",
-    SESSION_START: "sessionStart",
-    STOP: "stop",
-    AFTER_AGENT_RESPONSE: "afterAgentResponse",
-};
-/** Map of hook types that have actual script files. */
-export const HOOK_SCRIPTS = {
-    [HOOK_TYPES.PRE_TOOL_USE]: "pretooluse.mjs",
-    [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",
-};
-/**
- * Negative-lookahead matcher for external MCP tool namespaces on Cursor (#529).
- *
- * Cursor MCP wire shape: `MCP:<tool>` (verified in
- * tests/fixtures/cursor/pretooluse-mcp.json, hooks/cursor/posttooluse.mjs:19-25).
- * Context-mode's own tools surface as `MCP:ctx_<...>`. The negative lookahead
- * on the `ctx_` prefix fires for every other MCP tool whose payload would
- * otherwise flood the model's context window before PostToolUse can act.
- *
- * Routing.mjs `isExternalMcpTool` is extended to recognise the `MCP:` prefix
- * so the routing branch returns external-MCP guidance instead of passthrough.
- */
-export const EXTERNAL_MCP_MATCHER_PATTERN = "MCP:(?!ctx_)";
-/** 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",
-    "Grep",
-    "WebFetch",
-    "mcp_web_fetch",
-    "mcp_fetch_tool",
-    "Task",
-    "MCP:ctx_execute",
-    "MCP:ctx_execute_file",
-    "MCP:ctx_batch_execute",
-    EXTERNAL_MCP_MATCHER_PATTERN,
-];
-export const PRE_TOOL_USE_MATCHER_PATTERN = PRE_TOOL_USE_MATCHERS.join("|");
-/** Required hooks for native Cursor support. */
-export const REQUIRED_HOOKS = [
-    HOOK_TYPES.PRE_TOOL_USE,
-];
-/** Optional hooks that improve behavior but aren't strictly required. */
-export const OPTIONAL_HOOKS = [HOOK_TYPES.POST_TOOL_USE];
-/** Check whether a native Cursor hook entry points to context-mode. */
-export function isContextModeHook(entry, hookType) {
-    const scriptName = HOOK_SCRIPTS[hookType];
-    const cliCommand = buildHookCommand(hookType);
-    if ("command" in entry) {
-        const cmd = entry.command ?? "";
-        return (scriptName != null && cmd.includes(scriptName)) || cmd.includes(cliCommand);
-    }
-    const wrappedEntry = entry;
-    return (wrappedEntry.hooks?.some((hook) => {
-        const cmd = hook.command ?? "";
-        return (scriptName != null && cmd.includes(scriptName)) || cmd.includes(cliCommand);
-    }) ?? false);
-}
-/** Build the CLI dispatcher command for a Cursor hook type. */
-export function buildHookCommand(hookType) {
-    return `context-mode hook cursor ${hookType.toLowerCase()}`;
-}

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

@@ -1,64 +0,0 @@
-/**
- * adapters/cursor — Cursor platform adapter.
- *
- * Native Cursor hooks use lower-camel hook names and flat command entries in
- * `.cursor/hooks.json` / `~/.cursor/hooks.json`.
- */
-import { BaseAdapter } from "../base.js";
-import type { HookAdapter, HookParadigm, PlatformCapabilities, DiagnosticResult, PreToolUseEvent, PostToolUseEvent, SessionStartEvent, PreToolUseResponse, PostToolUseResponse, SessionStartResponse, HookRegistration } from "../types.js";
-interface StopEvent {
-    sessionId: string;
-    status: string;
-    loopCount: number;
-    generationId?: string;
-    transcriptPath?: string;
-}
-export declare class CursorAdapter extends BaseAdapter implements HookAdapter {
-    constructor();
-    readonly name = "Cursor";
-    readonly paradigm: HookParadigm;
-    readonly capabilities: PlatformCapabilities;
-    parsePreToolUseInput(raw: unknown): PreToolUseEvent;
-    parsePostToolUseInput(raw: unknown): PostToolUseEvent;
-    parseSessionStartInput(raw: unknown): SessionStartEvent;
-    formatPreToolUseResponse(response: PreToolUseResponse): unknown;
-    formatPostToolUseResponse(response: PostToolUseResponse): unknown;
-    formatSessionStartResponse(response: SessionStartResponse): unknown;
-    parseStopInput(raw: unknown): StopEvent;
-    formatStopResponse(response: {
-        followupMessage?: string;
-    }): Record<string, unknown>;
-    parseAfterAgentResponseInput(raw: unknown): {
-        text: string;
-    };
-    getSettingsPath(): string;
-    /**
-     * Cursor stores conventions per project under .cursor/. Always returned
-     * as an absolute path resolved against `projectDir` (or `process.cwd()`
-     * when omitted) per the HookAdapter.getConfigDir contract.
-     */
-    getConfigDir(projectDir?: string): string;
-    getInstructionFiles(): string[];
-    generateHookConfig(_pluginRoot: string): HookRegistration;
-    readSettings(): Record<string, unknown> | null;
-    writeSettings(settings: Record<string, unknown>): void;
-    validateHooks(_pluginRoot: string): DiagnosticResult[];
-    /**
-     * Detects context-mode plugin installations under Cursor's plugin directories.
-     * Returns absolute paths to any `.cursor-plugin/plugin.json` files whose
-     * `name` matches `context-mode`.
-     */
-    private detectPluginInstalls;
-    checkPluginRegistration(): DiagnosticResult;
-    getInstalledVersion(): string;
-    configureAllHooks(_pluginRoot: string): string[];
-    setHookPermissions(pluginRoot: string): string[];
-    updatePluginRegistry(_pluginRoot: string, _version: string): void;
-    private getCandidateHookConfigPaths;
-    private getProjectDir;
-    private extractSessionId;
-    private loadNativeHookConfig;
-    private hasClaudeCompatibilityHooks;
-    private upsertHookEntry;
-}
-export {};