@mxalbert/context-mode 2.0.0

package/build/adapters/kiro/index.js

@@ -0,0 +1,301 @@
+/**
+ * adapters/kiro — Kiro IDE/CLI platform adapter.
+ *
+ * Implements HookAdapter for Kiro's hooks-capable paradigm (json-stdio).
+ *
+ * Kiro specifics:
+ *   - Hooks via agent config files (~/.kiro/agents/<name>.json)
+ *   - Config: ~/.kiro/settings/mcp.json (JSON format)
+ *   - MCP: full support via mcpServers in mcp.json
+ *   - Hook exit codes: 0=allow, 2=block
+ *   - Cannot modify tool input (exit codes only)
+ *   - Session dir: ~/.kiro/context-mode/sessions/
+ *   - Routing file: KIRO.md
+ *
+ * Sources:
+ *   - MCP config: https://kiro.dev/docs/mcp/configuration/
+ *   - clientInfo.name: https://github.com/kirodotdev/Kiro/issues/5205 ("Kiro CLI")
+ *   - CLI hooks: https://kiro.dev/docs/cli/custom-agents/configuration-reference#hooks-field
+ */
+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";
+import { HOOK_TYPES as KIRO_HOOK_TYPES, PRE_TOOL_USE_MATCHER_PATTERN as KIRO_PRE_TOOL_USE_MATCHER_PATTERN, buildHookCommand as buildKiroHookCommand, isContextModeHook as isKiroContextModeHook, } from "./hooks.js";
+// ─────────────────────────────────────────────────────────
+// Adapter implementation
+// ─────────────────────────────────────────────────────────
+export class KiroAdapter extends BaseAdapter {
+    constructor() {
+        super([".kiro"]);
+    }
+    name = "Kiro";
+    paradigm = "json-stdio";
+    capabilities = {
+        preToolUse: true,
+        postToolUse: true,
+        preCompact: false,
+        sessionStart: true, // Kiro agentSpawn = SessionStart equivalent
+        canModifyArgs: false, // Kiro CLI uses exit codes, can't modify input
+        canModifyOutput: false,
+        canInjectSessionContext: true, // agentSpawn returns additionalContext via JSON stdout
+    };
+    // ── Input parsing ──────────────────────────────────────
+    parsePreToolUseInput(raw) {
+        const input = raw;
+        return {
+            toolName: input.tool_name ?? "",
+            toolInput: input.tool_input ?? {},
+            sessionId: `pid-${process.ppid}`,
+            projectDir: input.cwd ?? process.cwd(),
+            raw,
+        };
+    }
+    parsePostToolUseInput(raw) {
+        const input = raw;
+        const toolResponse = input.tool_response;
+        return {
+            toolName: input.tool_name ?? "",
+            toolInput: input.tool_input ?? {},
+            toolOutput: typeof toolResponse === "string"
+                ? toolResponse
+                : JSON.stringify(toolResponse ?? ""),
+            sessionId: `pid-${process.ppid}`,
+            projectDir: input.cwd ?? process.cwd(),
+            raw,
+        };
+    }
+    parsePreCompactInput(_raw) {
+        throw new Error("Kiro does not support PreCompact hooks");
+    }
+    parseSessionStartInput(raw) {
+        // Kiro maps agentSpawn -> SessionStart. Stdin shape mirrors codex/CC.
+        const input = (raw ?? {});
+        const source = input.source ?? "startup";
+        return {
+            source,
+            sessionId: `pid-${process.ppid}`,
+            projectDir: input.cwd ?? process.cwd(),
+            raw,
+        };
+    }
+    // ── Response formatting ────────────────────────────────
+    formatPreToolUseResponse(response) {
+        // Kiro CLI uses exit codes — this format is for adapter interface completeness.
+        // The actual hook script handles exit codes directly.
+        switch (response.decision) {
+            case "deny":
+                return { exitCode: 2, stderr: response.reason ?? "Blocked by context-mode" };
+            case "context":
+                return { exitCode: 0, stdout: response.additionalContext ?? "" };
+            default:
+                return undefined; // allow — no output needed
+        }
+    }
+    formatPostToolUseResponse(_response) {
+        return undefined; // PostToolUse is non-blocking
+    }
+    formatPreCompactResponse(_response) {
+        return undefined;
+    }
+    formatSessionStartResponse(response) {
+        // Kiro agentSpawn returns the same hookSpecificOutput shape as CC SessionStart.
+        if (!response?.context)
+            return undefined;
+        return {
+            hookSpecificOutput: {
+                hookEventName: "agentSpawn",
+                additionalContext: response.context,
+            },
+        };
+    }
+    // ── Configuration ──────────────────────────────────────
+    getSettingsPath() {
+        return resolve(homedir(), ".kiro", "settings", "mcp.json");
+    }
+    /**
+     * Kiro stores per-project context under .kiro/ (steering files, etc).
+     * Auto-memory + rule detection use this project-relative dir, returned as
+     * an absolute path resolved against `projectDir` (or `process.cwd()`).
+     * (Settings/MCP config still live under ~/.kiro/.)
+     */
+    getConfigDir(projectDir) {
+        return resolve(projectDir ?? process.cwd(), ".kiro");
+    }
+    getInstructionFiles() {
+        return ["KIRO.md"];
+    }
+    generateHookConfig(pluginRoot) {
+        // Kiro CLI hook config format: { <hookName>: [{ matcher, command }] }
+        // Note: This generates the entries for agent config files (~/.kiro/agents/*.json).
+        return {
+            [KIRO_HOOK_TYPES.PRE_TOOL_USE]: [{
+                    matcher: KIRO_PRE_TOOL_USE_MATCHER_PATTERN,
+                    hooks: [{ type: "command", command: buildKiroHookCommand(KIRO_HOOK_TYPES.PRE_TOOL_USE, pluginRoot) }],
+                }],
+            [KIRO_HOOK_TYPES.POST_TOOL_USE]: [{
+                    matcher: "*",
+                    hooks: [{ type: "command", command: buildKiroHookCommand(KIRO_HOOK_TYPES.POST_TOOL_USE, pluginRoot) }],
+                }],
+            [KIRO_HOOK_TYPES.AGENT_SPAWN]: [{
+                    matcher: "*",
+                    hooks: [{ type: "command", command: buildKiroHookCommand(KIRO_HOOK_TYPES.AGENT_SPAWN, pluginRoot) }],
+                }],
+            [KIRO_HOOK_TYPES.USER_PROMPT_SUBMIT]: [{
+                    matcher: "*",
+                    hooks: [{ type: "command", command: buildKiroHookCommand(KIRO_HOOK_TYPES.USER_PROMPT_SUBMIT, pluginRoot) }],
+                }],
+        };
+    }
+    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) {
+        const results = [];
+        const defaultAgent = resolve(homedir(), ".kiro", "agents", "default.json");
+        try {
+            const config = JSON.parse(readFileSync(defaultAgent, "utf-8"));
+            const hooks = config.hooks ?? {};
+            // Check required hooks
+            for (const hookType of [KIRO_HOOK_TYPES.PRE_TOOL_USE]) {
+                const entries = hooks[hookType] ?? [];
+                const found = entries.some((e) => isKiroContextModeHook(e, hookType));
+                results.push({
+                    check: `Hook: ${hookType}`,
+                    status: found ? "pass" : "fail",
+                    message: found
+                        ? `context-mode ${hookType} hook found`
+                        : `context-mode ${hookType} hook not configured`,
+                    ...(found ? {} : { fix: `Run: context-mode upgrade` }),
+                });
+            }
+            // Check optional hooks
+            for (const hookType of [KIRO_HOOK_TYPES.POST_TOOL_USE]) {
+                const entries = hooks[hookType] ?? [];
+                const found = entries.some((e) => isKiroContextModeHook(e, hookType));
+                results.push({
+                    check: `Hook: ${hookType}`,
+                    status: found ? "pass" : "warn",
+                    message: found
+                        ? `context-mode ${hookType} hook found`
+                        : `context-mode ${hookType} hook not configured (optional)`,
+                });
+            }
+        }
+        catch {
+            results.push({
+                check: "Hook configuration",
+                status: "warn",
+                message: "Could not read ~/.kiro/agents/default.json",
+                fix: "Run: context-mode upgrade",
+            });
+        }
+        return results;
+    }
+    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 ~/.kiro/settings/mcp.json",
+            };
+        }
+        catch {
+            return {
+                check: "MCP registration",
+                status: "warn",
+                message: "Could not read ~/.kiro/settings/mcp.json",
+            };
+        }
+    }
+    getInstalledVersion() {
+        try {
+            const pkgPath = resolve(homedir(), ".kiro", "extensions", "context-mode", "package.json");
+            const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+            return pkg.version ?? "unknown";
+        }
+        catch {
+            return "not installed";
+        }
+    }
+    // ── Upgrade ────────────────────────────────────────────
+    configureAllHooks(pluginRoot) {
+        const changes = [];
+        const configDir = resolve(homedir(), ".kiro", "agents");
+        const defaultAgent = resolve(configDir, "default.json");
+        try {
+            mkdirSync(configDir, { recursive: true });
+            let config = {};
+            try {
+                config = JSON.parse(readFileSync(defaultAgent, "utf-8"));
+            }
+            catch {
+                // No existing config — create new
+            }
+            const hooks = (config.hooks ?? {});
+            // Hooks to add: [hookType, matcher]
+            const hookSpecs = [
+                [KIRO_HOOK_TYPES.PRE_TOOL_USE, KIRO_PRE_TOOL_USE_MATCHER_PATTERN],
+                [KIRO_HOOK_TYPES.POST_TOOL_USE, "*"],
+                [KIRO_HOOK_TYPES.AGENT_SPAWN, "*"],
+                [KIRO_HOOK_TYPES.USER_PROMPT_SUBMIT, "*"],
+            ];
+            for (const [hookType, matcher] of hookSpecs) {
+                const entries = (hooks[hookType] ?? []);
+                if (!entries.some(e => isKiroContextModeHook(e, hookType))) {
+                    entries.push({
+                        matcher,
+                        command: buildKiroHookCommand(hookType, pluginRoot),
+                    });
+                    hooks[hookType] = entries;
+                    changes.push(`Added ${hookType} hook to ${defaultAgent}`);
+                }
+            }
+            config.hooks = hooks;
+            writeFileSync(defaultAgent, JSON.stringify(config, null, 2), "utf-8");
+        }
+        catch (err) {
+            changes.push(`Failed to configure hooks: ${err.message}`);
+        }
+        return changes;
+    }
+    setHookPermissions(_pluginRoot) {
+        return [];
+    }
+    updatePluginRegistry(_pluginRoot, _version) {
+        // Kiro plugin registry is managed via mcp.json
+    }
+    getRoutingInstructions() {
+        const instructionsPath = resolve(dirname(fileURLToPath(import.meta.url)), "..", "..", "..", "configs", "kiro", "KIRO.md");
+        try {
+            return readFileSync(instructionsPath, "utf-8");
+        }
+        catch {
+            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/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,81 @@
+/**
+ * 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 TurnEndEvent = {
+    type?: string;
+    message?: unknown;
+    messages?: unknown;
+};
+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: "turn_end", handler: HookHandler<TurnEndEvent>): 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 {};