context-mode 1.0.111 → 1.0.113

package/build/adapters/cursor/index.js

@@ -4,11 +4,12 @@
  * Native Cursor hooks use lower-camel hook names and flat command entries in
  * `.cursor/hooks.json` / `~/.cursor/hooks.json`.
  */
-import { readFileSync, writeFileSync, mkdirSync, accessSync, chmodSync, constants, existsSync, } from "node:fs";
+import { readFileSync, writeFileSync, mkdirSync, accessSync, chmodSync, constants, existsSync, readdirSync, } from "node:fs";
 import { execSync } from "node:child_process";
 import { resolve, join } from "node:path";
 import { homedir } from "node:os";
 import { BaseAdapter } from "../base.js";
+import { resolveClaudeConfigDir } from "../../util/claude-config.js";
 import { HOOK_TYPES as CURSOR_HOOK_NAMES, HOOK_SCRIPTS as CURSOR_HOOK_SCRIPTS, PRE_TOOL_USE_MATCHER_PATTERN, REQUIRED_HOOKS, OPTIONAL_HOOKS, isContextModeHook, buildHookCommand, } from "./hooks.js";
 const CURSOR_ENTERPRISE_HOOKS_PATH = "/Library/Application Support/Cursor/hooks.json";
 export class CursorAdapter extends BaseAdapter {
@@ -263,8 +264,72 @@ export class CursorAdapter extends BaseAdapter {
                 message: "Claude-compatible hooks detected; native Cursor hooks are the supported configuration",
             });
         }
+        const pluginInstalls = this.detectPluginInstalls();
+        if (pluginInstalls.length > 0) {
+            const nativeHasContextMode = loaded
+                ? Object.entries(loaded.config.hooks ?? {}).some(([type, entries]) => Array.isArray(entries) && entries.some((entry) => isContextModeHook(entry, type)))
+                : false;
+            if (nativeHasContextMode && loaded) {
+                results.push({
+                    check: "Plugin/native hook duplication",
+                    status: "warn",
+                    message: `context-mode plugin detected at ${pluginInstalls[0]} alongside native hooks in ${loaded.path} — ` +
+                        `each event will fire twice. Remove one configuration to avoid duplicate routing.`,
+                    fix: "Remove the native .cursor/hooks.json entries OR uninstall the plugin",
+                });
+            }
+            else {
+                results.push({
+                    check: "Plugin install",
+                    status: "pass",
+                    message: `context-mode plugin installed at ${pluginInstalls[0]}`,
+                });
+            }
+        }
         return results;
     }
+    /**
+     * 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`.
+     */
+    detectPluginInstalls() {
+        const roots = [
+            join(homedir(), ".cursor", "plugins", "local"),
+            join(homedir(), ".cursor", "plugins", "cache"),
+        ];
+        const found = [];
+        for (const root of roots) {
+            try {
+                accessSync(root, constants.F_OK);
+            }
+            catch {
+                continue;
+            }
+            // Plugins live one directory deep: <root>/<name>/.cursor-plugin/plugin.json
+            let entries = [];
+            try {
+                entries = readdirSync(root);
+            }
+            catch {
+                continue;
+            }
+            for (const name of entries) {
+                const manifestPath = join(root, name, ".cursor-plugin", "plugin.json");
+                try {
+                    const raw = readFileSync(manifestPath, "utf-8");
+                    const parsed = JSON.parse(raw);
+                    if (parsed?.name === "context-mode") {
+                        found.push(manifestPath);
+                    }
+                }
+                catch {
+                    continue;
+                }
+            }
+        }
+        return found;
+    }
     checkPluginRegistration() {
         const mcpPaths = [resolve(".cursor", "mcp.json"), join(homedir(), ".cursor", "mcp.json")];
         for (const configPath of mcpPaths) {
@@ -294,6 +359,19 @@ export class CursorAdapter extends BaseAdapter {
                 continue;
             }
         }
+        // #489 round-3 — pure plugin install (Marketplace) bundles MCP registration
+        // inside the plugin package. No native mcp.json exists, but the plugin
+        // manifest under ~/.cursor/plugins/{local,cache}/<name>/.cursor-plugin/plugin.json
+        // is enough to consider context-mode registered. Without this, doctor
+        // self-contradicts: `Plugin install: pass` alongside `MCP registration: warn`.
+        const pluginInstalls = this.detectPluginInstalls();
+        if (pluginInstalls.length > 0) {
+            return {
+                check: "MCP registration",
+                status: "pass",
+                message: `context-mode registered via plugin manifest at ${pluginInstalls[0]}`,
+            };
+        }
         return {
             check: "MCP registration",
             status: "warn",
@@ -412,10 +490,13 @@ export class CursorAdapter extends BaseAdapter {
         return null;
     }
     hasClaudeCompatibilityHooks() {
+        // Issue #460 round-3: probe the resolved CC config dir (honors
+        // $CLAUDE_CONFIG_DIR) instead of the literal ~/.claude so users
+        // who relocated their CC config still trigger the compat path.
         const compatPaths = [
             resolve(".claude", "settings.json"),
             resolve(".claude", "settings.local.json"),
-            join(homedir(), ".claude", "settings.json"),
+            join(resolveClaudeConfigDir(), "settings.json"),
         ];
         return compatPaths.some((configPath) => existsSync(configPath));
     }

package/build/adapters/detect.d.ts

@@ -23,7 +23,7 @@ import type { PlatformId, DetectionSignal, HookAdapter } from "./types.js";
  * Single source of truth — consumed by detectPlatform() below and by
  * tests that need to clear platform-related env vars deterministically.
  */
-export declare const PLATFORM_ENV_VARS: readonly [readonly ["claude-code", readonly ["CLAUDE_PROJECT_DIR", "CLAUDE_SESSION_ID"]], readonly ["antigravity", readonly ["ANTIGRAVITY_CLI_ALIAS"]], readonly ["cursor", readonly ["CURSOR_TRACE_ID", "CURSOR_CLI"]], readonly ["kilo", readonly ["KILO_PID"]], readonly ["opencode", readonly ["OPENCODE", "OPENCODE_PID"]], readonly ["zed", readonly ["ZED_SESSION_ID", "ZED_TERM"]], readonly ["codex", readonly ["CODEX_THREAD_ID", "CODEX_CI"]], readonly ["gemini-cli", readonly ["GEMINI_PROJECT_DIR", "GEMINI_CLI"]], readonly ["vscode-copilot", readonly ["VSCODE_PID", "VSCODE_CWD"]], readonly ["jetbrains-copilot", readonly ["IDEA_INITIAL_DIRECTORY"]], readonly ["qwen-code", readonly ["QWEN_PROJECT_DIR"]], readonly ["pi", readonly ["PI_PROJECT_DIR"]]];
+export declare const PLATFORM_ENV_VARS: readonly [readonly ["claude-code", readonly ["CLAUDE_PROJECT_DIR", "CLAUDE_SESSION_ID"]], readonly ["antigravity", readonly ["ANTIGRAVITY_CLI_ALIAS"]], readonly ["cursor", readonly ["CURSOR_TRACE_ID", "CURSOR_CLI"]], readonly ["kilo", readonly ["KILO", "KILO_PID"]], readonly ["opencode", readonly ["OPENCODE", "OPENCODE_PID"]], readonly ["zed", readonly ["ZED_SESSION_ID", "ZED_TERM"]], readonly ["codex", readonly ["CODEX_THREAD_ID", "CODEX_CI"]], readonly ["gemini-cli", readonly ["GEMINI_PROJECT_DIR", "GEMINI_CLI"]], readonly ["vscode-copilot", readonly ["VSCODE_PID", "VSCODE_CWD"]], readonly ["jetbrains-copilot", readonly ["IDEA_INITIAL_DIRECTORY"]], readonly ["qwen-code", readonly ["QWEN_PROJECT_DIR"]], readonly ["omp", readonly ["PI_CODING_AGENT_DIR"]], readonly ["pi", readonly ["PI_PROJECT_DIR"]]];
 /**
  * Sync map from platform identifier → home-relative path segments where that
  * platform stores its config. Mirrors the `super([...])` argument passed by

package/build/adapters/detect.js

@@ -39,10 +39,9 @@ export const PLATFORM_ENV_VARS = [
     // 800+ hits in major OSS detection libs (Vercel Next.js, Bun, Google
     // gemini-cli, Nx, CrewAI).
     ["cursor", ["CURSOR_TRACE_ID", "CURSOR_CLI"]],
-    // kilo (OpenCode fork) — Kilo-Org/kilocode packages/opencode/src/index.ts:140
-    // sets `process.env.KILO_PID = String(process.pid)`. Bare KILO is NEVER set
-    // (verified). Kilo also sets OPENCODE=1 (fork) — listed before opencode.
-    ["kilo", ["KILO_PID"]],
+    // kilo (OpenCode fork) — Kilo-Org/kilocode packages/opencode/src/index.ts:138 + 139
+    // sets `process.env.KILO = 1` + `process.env.KILO_PID = String(process.pid)`. 
+    ["kilo", ["KILO", "KILO_PID"]],
     // opencode — sst/opencode packages/opencode/src/index.ts:108-109 sets
     // OPENCODE=1 + OPENCODE_PID=<pid> on every CLI invocation.
     ["opencode", ["OPENCODE", "OPENCODE_PID"]],
@@ -64,7 +63,11 @@ export const PLATFORM_ENV_VARS = [
     // qwen-code — QWEN_PROJECT_DIR per QwenLM/qwen-code docs/users/features/hooks.md.
     // (QWEN_SESSION_ID removed — 0 hits in qwen-code repository.)
     ["qwen-code", ["QWEN_PROJECT_DIR"]],
-    // pi — PI_PROJECT_DIR consumed by src/pi-extension.ts:154 + src/server.ts:153
+    // omp (can1357/oh-my-pi). PI_CODING_AGENT_DIR is the upstream
+    // agent-dir override per `packages/utils/src/dirs.ts:193`. Listed
+    // BEFORE pi so OMP is not misclassified as Pi when both are installed.
+    ["omp", ["PI_CODING_AGENT_DIR"]],
+    // pi — PI_PROJECT_DIR consumed by src/adapters/pi/extension.ts:154 + src/server.ts:153
     // — implies the Pi runtime sets it before invoking the extension.
     ["pi", ["PI_PROJECT_DIR"]],
     // openclaw — removed (runtime never sets OPENCLAW_HOME or OPENCLAW_CLI;
@@ -92,6 +95,7 @@ export function getSessionDirSegments(platform) {
         case "vscode-copilot": return [".vscode"];
         case "kiro": return [".kiro"];
         case "pi": return [".pi"];
+        case "omp": return [".omp"];
         case "qwen-code": return [".qwen"];
         case "kilo": return [".config", "kilo"];
         case "opencode": return [".config", "opencode"];
@@ -131,7 +135,7 @@ export function detectPlatform(clientInfo) {
     if (platformOverride) {
         const validPlatforms = [
             "claude-code", "gemini-cli", "kilo", "opencode", "codex",
-            "vscode-copilot", "jetbrains-copilot", "cursor", "antigravity", "kiro", "pi", "zed", "qwen-code",
+            "vscode-copilot", "jetbrains-copilot", "cursor", "antigravity", "kiro", "pi", "omp", "zed", "qwen-code",
         ];
         if (validPlatforms.includes(platformOverride)) {
             return {
@@ -188,6 +192,14 @@ export function detectPlatform(clientInfo) {
             reason: "~/.kiro/ directory exists",
         };
     }
+    // OMP listed BEFORE pi: shared ~/.pi history with OMP-only ~/.omp/ marker.
+    if (existsSync(resolve(home, ".omp"))) {
+        return {
+            platform: "omp",
+            confidence: "medium",
+            reason: "~/.omp/ directory exists",
+        };
+    }
     if (existsSync(resolve(home, ".pi"))) {
         return {
             platform: "pi",
@@ -300,6 +312,17 @@ export async function getAdapter(platform) {
             const { QwenCodeAdapter } = await import("./qwen-code/index.js");
             return new QwenCodeAdapter();
         }
+        case "omp": {
+            const { OMPAdapter } = await import("./omp/index.js");
+            return new OMPAdapter();
+        }
+        case "pi": {
+            // Issue #473 follow-up: without this case, getAdapter("pi") fell
+            // through to ClaudeCodeAdapter and Pi sessions wrote into
+            // ~/.claude/context-mode/. PiAdapter pins storage to ~/.pi/.
+            const { PiAdapter } = await import("./pi/index.js");
+            return new PiAdapter();
+        }
         default: {
             // Unsupported platform — fall back to Claude Code adapter
             // (MCP server works everywhere, hooks may not)

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

@@ -0,0 +1,65 @@
+/**
+ * adapters/omp — Oh My Pi (OMP) platform adapter.
+ *
+ * OMP integration facts (verified against can1357/oh-my-pi @ v3.20.1):
+ *   - MCP config: `~/.omp/agent/mcp.json` (global) or `<project>/.omp/mcp.json`
+ *     (project), per `packages/utils/src/dirs.ts` `getMCPConfigPath()` and
+ *     `docs/mcp-config.md` "Preferred config locations".
+ *   - Agent-dir env override: `PI_CODING_AGENT_DIR` — `packages/utils/src/dirs.ts`:
+ *     `let dirs = new DirResolver(process.env.PI_CODING_AGENT_DIR);`
+ *     (No `OMP_*` runtime env exists; `.env`-file `OMP_*` keys are mirrored to
+ *     `PI_*` BEFORE process.env is read.)
+ *   - System-prompt file: `SYSTEM.md` (project `.omp/SYSTEM.md` precedence,
+ *     global `~/.omp/agent/SYSTEM.md` fallback). NOT `PI.md` — no `PI.md`
+ *     loader exists upstream. OMP also auto-discovers `AGENTS.md` via
+ *     `packages/coding-agent/src/discovery/agents-md.ts`.
+ *   - Hook surface: OMP DOES expose pre/post tool-call hooks
+ *     (`~/.omp/agent/hooks/{pre,post}/*.ts`, `omp.on("tool_call", ...)`).
+ *     This adapter ships MCP-only delivery for now; wiring native OMP
+ *     hooks is future work tracked separately.
+ *
+ * Why a dedicated adapter rather than reusing pi:
+ *   OMP and Pi share a runtime surface but different storage roots
+ *   (`~/.omp/agent/` vs `~/.pi/`). Without an OMP adapter, OMP users
+ *   running through a Claude-installed harness silently land their
+ *   context-mode data under `~/.claude/context-mode/` (issue #473).
+ */
+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 OMPAdapter extends BaseAdapter implements HookAdapter {
+    constructor();
+    readonly name = "OMP";
+    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;
+    /**
+     * Resolve OMP agent root, honoring `PI_CODING_AGENT_DIR` when set
+     * (the upstream OMP convention — see `packages/utils/src/dirs.ts`)
+     * and falling back to `~/.omp/agent`.
+     */
+    private getAgentDir;
+    getSettingsPath(): string;
+    /**
+     * OMP nests its config under the agent dir. Always absolute.
+     * `_projectDir` accepted for interface symmetry but unused — home-rooted.
+     */
+    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[];
+    checkPluginRegistration(): DiagnosticResult;
+    getInstalledVersion(): string;
+    configureAllHooks(_pluginRoot: string): string[];
+    setHookPermissions(_pluginRoot: string): string[];
+    updatePluginRegistry(_pluginRoot: string, _version: string): void;
+    getRoutingInstructions(): string;
+}

package/build/adapters/omp/index.js

@@ -0,0 +1,182 @@
+/**
+ * adapters/omp — Oh My Pi (OMP) platform adapter.
+ *
+ * OMP integration facts (verified against can1357/oh-my-pi @ v3.20.1):
+ *   - MCP config: `~/.omp/agent/mcp.json` (global) or `<project>/.omp/mcp.json`
+ *     (project), per `packages/utils/src/dirs.ts` `getMCPConfigPath()` and
+ *     `docs/mcp-config.md` "Preferred config locations".
+ *   - Agent-dir env override: `PI_CODING_AGENT_DIR` — `packages/utils/src/dirs.ts`:
+ *     `let dirs = new DirResolver(process.env.PI_CODING_AGENT_DIR);`
+ *     (No `OMP_*` runtime env exists; `.env`-file `OMP_*` keys are mirrored to
+ *     `PI_*` BEFORE process.env is read.)
+ *   - System-prompt file: `SYSTEM.md` (project `.omp/SYSTEM.md` precedence,
+ *     global `~/.omp/agent/SYSTEM.md` fallback). NOT `PI.md` — no `PI.md`
+ *     loader exists upstream. OMP also auto-discovers `AGENTS.md` via
+ *     `packages/coding-agent/src/discovery/agents-md.ts`.
+ *   - Hook surface: OMP DOES expose pre/post tool-call hooks
+ *     (`~/.omp/agent/hooks/{pre,post}/*.ts`, `omp.on("tool_call", ...)`).
+ *     This adapter ships MCP-only delivery for now; wiring native OMP
+ *     hooks is future work tracked separately.
+ *
+ * Why a dedicated adapter rather than reusing pi:
+ *   OMP and Pi share a runtime surface but different storage roots
+ *   (`~/.omp/agent/` vs `~/.pi/`). Without an OMP adapter, OMP users
+ *   running through a Claude-installed harness silently land their
+ *   context-mode data under `~/.claude/context-mode/` (issue #473).
+ */
+import { readFileSync, writeFileSync, mkdirSync, } from "node:fs";
+import { resolve, dirname } from "node:path";
+import { homedir } from "node:os";
+import { BaseAdapter } from "../base.js";
+// ─────────────────────────────────────────────────────────
+// Adapter implementation
+// ─────────────────────────────────────────────────────────
+export class OMPAdapter extends BaseAdapter {
+    constructor() {
+        super([".omp"]);
+    }
+    name = "OMP";
+    paradigm = "mcp-only";
+    capabilities = {
+        preToolUse: false,
+        postToolUse: false,
+        preCompact: false,
+        sessionStart: false,
+        canModifyArgs: false,
+        canModifyOutput: false,
+        canInjectSessionContext: false,
+    };
+    // ── Input parsing ──────────────────────────────────────
+    // OMP does not support hooks. These methods exist to satisfy the
+    // interface contract but will throw if called.
+    parsePreToolUseInput(_raw) {
+        throw new Error("OMP hooks not wired by this adapter (MCP-only delivery)");
+    }
+    parsePostToolUseInput(_raw) {
+        throw new Error("OMP hooks not wired by this adapter (MCP-only delivery)");
+    }
+    parsePreCompactInput(_raw) {
+        throw new Error("OMP hooks not wired by this adapter (MCP-only delivery)");
+    }
+    parseSessionStartInput(_raw) {
+        throw new Error("OMP hooks not wired by this adapter (MCP-only delivery)");
+    }
+    // ── Response formatting ────────────────────────────────
+    // OMP does not support hooks. Return undefined for all responses.
+    formatPreToolUseResponse(_response) {
+        return undefined;
+    }
+    formatPostToolUseResponse(_response) {
+        return undefined;
+    }
+    formatPreCompactResponse(_response) {
+        return undefined;
+    }
+    formatSessionStartResponse(_response) {
+        return undefined;
+    }
+    // ── Configuration ──────────────────────────────────────
+    /**
+     * Resolve OMP agent root, honoring `PI_CODING_AGENT_DIR` when set
+     * (the upstream OMP convention — see `packages/utils/src/dirs.ts`)
+     * and falling back to `~/.omp/agent`.
+     */
+    getAgentDir() {
+        return process.env.PI_CODING_AGENT_DIR
+            ?? resolve(homedir(), ".omp", "agent");
+    }
+    getSettingsPath() {
+        return resolve(this.getAgentDir(), "mcp.json");
+    }
+    /**
+     * OMP nests its config under the agent dir. Always absolute.
+     * `_projectDir` accepted for interface symmetry but unused — home-rooted.
+     */
+    getConfigDir(_projectDir) {
+        return this.getAgentDir();
+    }
+    getInstructionFiles() {
+        // SYSTEM.md is the OMP-native system-prompt file (see
+        // can1357/oh-my-pi README "Custom System Prompt"). AGENTS.md is also
+        // auto-discovered by the universal discovery layer.
+        return ["SYSTEM.md", "AGENTS.md"];
+    }
+    generateHookConfig(_pluginRoot) {
+        return {};
+    }
+    readSettings() {
+        try {
+            const raw = readFileSync(this.getSettingsPath(), "utf-8");
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+    writeSettings(settings) {
+        const settingsPath = this.getSettingsPath();
+        mkdirSync(dirname(settingsPath), { recursive: true });
+        writeFileSync(settingsPath, JSON.stringify(settings, null, 2), "utf-8");
+    }
+    // ── Diagnostics (doctor) ─────────────────────────────────
+    validateHooks(_pluginRoot) {
+        return [
+            {
+                check: "Hook support",
+                status: "warn",
+                message: "context-mode delivers via MCP for OMP. " +
+                    "Native OMP pre/post tool-call hooks are not yet wired by this adapter.",
+            },
+        ];
+    }
+    checkPluginRegistration() {
+        try {
+            const raw = readFileSync(this.getSettingsPath(), "utf-8");
+            const config = JSON.parse(raw);
+            const mcpServers = config?.mcpServers ?? {};
+            if ("context-mode" in mcpServers) {
+                return {
+                    check: "MCP registration",
+                    status: "pass",
+                    message: "context-mode found in mcpServers config",
+                };
+            }
+            return {
+                check: "MCP registration",
+                status: "fail",
+                message: "context-mode not found in mcpServers",
+                fix: `Add context-mode to mcpServers in ${this.getSettingsPath()}`,
+            };
+        }
+        catch {
+            return {
+                check: "MCP registration",
+                status: "warn",
+                message: `Could not read ${this.getSettingsPath()}`,
+            };
+        }
+    }
+    getInstalledVersion() {
+        try {
+            const pkgPath = resolve(this.getAgentDir(), "extensions", "context-mode", "package.json");
+            const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+            return pkg.version ?? "unknown";
+        }
+        catch {
+            return "not installed";
+        }
+    }
+    // ── Upgrade ────────────────────────────────────────────
+    configureAllHooks(_pluginRoot) {
+        return [];
+    }
+    setHookPermissions(_pluginRoot) {
+        return [];
+    }
+    updatePluginRegistry(_pluginRoot, _version) {
+        // OMP MCP server registry is managed via mcp.json
+    }
+    getRoutingInstructions() {
+        return "# context-mode\n\nUse context-mode MCP tools (execute, execute_file, batch_execute, fetch_and_index, search) instead of run_command/view_file for data-heavy operations.";
+    }
+}

package/build/adapters/omp/plugin.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Oh My Pi (OMP) plugin entry point for context-mode.
+ *
+ * Mirrors the Pi extension shape (`src/adapters/pi/extension.ts`) for
+ * the four OMP hook events that materially protect the context window
+ * and persist session continuity:
+ *
+ *   - session_start         — initialize the session row in our DB
+ *   - tool_call             — hard-block curl/wget/inline-HTTP in bash
+ *   - tool_result           — extract structured events into the session DB
+ *   - session_before_compact — persist a resume snapshot before compaction
+ *
+ * Loaded by OMP via the `omp` (or `pi`) field in package.json — see
+ * upstream loader at refs/platforms/oh-my-pi/packages/coding-agent/src/
+ * extensibility/plugins/loader.ts:75:
+ *   `const manifest: PluginManifest | undefined = pluginPkg.omp || pluginPkg.pi;`
+ * Hook factory contract from refs/.../extensibility/hooks/types.ts:809:
+ *   `export type HookFactory = (pi: HookAPI) => void;`
+ *
+ * OMP differs from Pi in two ways that justify a dedicated plugin file:
+ *   1. Storage roots at ~/.omp/context-mode/ via OMPAdapter, not ~/.pi/
+ *   2. OMP has native MCP support (mcp.json), so no MCP bridge is needed
+ *      — the bridge that Pi's extension ships (mcp-bridge.ts) is dead weight
+ *      under OMP and is intentionally omitted here.
+ */
+export declare function _resetOmpPluginStateForTests(): void;
+/**
+ * Return the current session ID picked by the most recent session_start
+ * handler. Test-only — production code reads `_sessionId` directly via
+ * the closure. The shared SQLite DB at `~/.omp/context-mode/` survives
+ * between tests, so `getLatestSessionId()` cannot disambiguate which
+ * row belongs to "this" test when multiple tests insert in the same
+ * second; tests use this getter instead.
+ */
+export declare function _getOmpPluginSessionIdForTests(): string;
+type ToolCallEvent = {
+    toolName: string;
+    toolCallId?: string;
+    input?: Record<string, unknown>;
+};
+type ToolResultEvent = {
+    toolName: string;
+    toolCallId?: string;
+    input?: Record<string, unknown>;
+    content?: Array<{
+        type: string;
+        text?: string;
+    }>;
+    isError?: boolean;
+};
+type ToolCallEventResult = {
+    block?: boolean;
+    reason?: string;
+};
+type HookEventCtx = Record<string, unknown> | undefined;
+type HookHandler<E, R = void> = (event: E, ctx: HookEventCtx) => R | undefined | Promise<R | undefined>;
+export interface MinimalHookAPI {
+    on(event: "session_start", handler: HookHandler<{
+        type: "session_start";
+    }>): void;
+    on(event: "session_before_compact", handler: HookHandler<{
+        type: "session_before_compact";
+    }>): void;
+    on(event: "tool_call", handler: HookHandler<ToolCallEvent, ToolCallEventResult>): void;
+    on(event: "tool_result", handler: HookHandler<ToolResultEvent>): void;
+    on(event: string, handler: (...args: unknown[]) => unknown): void;
+}
+/**
+ * OMP plugin default export. Called once by the OMP runtime per
+ * upstream `extensibility/plugins/loader.ts` after `omp plugin install
+ * context-mode`. Subsequent `pi.on(...)` registrations route the four
+ * lifecycle events to our SessionDB-backed handlers below.
+ */
+export default function ompPlugin(pi: MinimalHookAPI): void;
+export {};