@cleocode/adapters 2026.4.0 → 2026.4.3

package/dist/index.js

@@ -8,23 +8,27 @@ var __export = (target, all) => {
     __defProp(target, name, { get: all[name], enumerable: true });
 };
 
-// packages/adapters/src/providers/claude-code/paths.js
+// packages/adapters/src/providers/claude-code/paths.ts
 import { homedir } from "node:os";
 import { join } from "node:path";
 var ClaudeCodePathProvider;
 var init_paths = __esm({
-  "packages/adapters/src/providers/claude-code/paths.js"() {
+  "packages/adapters/src/providers/claude-code/paths.ts"() {
     "use strict";
     ClaudeCodePathProvider = class {
+      /** Get the provider's root configuration directory. */
       getProviderDir() {
         return process.env["CLAUDE_HOME"] ?? join(homedir(), ".claude");
       }
+      /** Get the path to the provider's settings file, or null if unavailable. */
       getSettingsPath() {
         return process.env["CLAUDE_SETTINGS"] ?? join(this.getProviderDir(), "settings.json");
       }
+      /** Get the directory where agents are installed, or null if unsupported. */
       getAgentInstallDir() {
         return join(this.getProviderDir(), "agents");
       }
+      /** Get the path to the provider's memory database, or null if unsupported. */
       getMemoryDbPath() {
         return process.env["CLAUDE_MEM_DB"] ?? join(homedir(), ".claude-mem", "claude-mem.db");
       }
@@ -32,25 +36,21 @@ var init_paths = __esm({
   }
 });
 
-// packages/adapters/src/providers/claude-code/context-monitor.js
+// packages/adapters/src/providers/claude-code/context-monitor.ts
 import { existsSync, readFileSync, writeFileSync } from "node:fs";
 import { mkdir } from "node:fs/promises";
 import { homedir as homedir2 } from "node:os";
 import { dirname, join as join2 } from "node:path";
 function getContextStatusFromPercentage(percentage) {
-  if (percentage >= THRESHOLDS.EMERGENCY)
-    return "emergency";
-  if (percentage >= THRESHOLDS.CRITICAL)
-    return "critical";
-  if (percentage >= THRESHOLDS.CAUTION)
-    return "caution";
-  if (percentage >= THRESHOLDS.WARNING)
-    return "warning";
+  if (percentage >= THRESHOLDS.EMERGENCY) return "emergency";
+  if (percentage >= THRESHOLDS.CRITICAL) return "critical";
+  if (percentage >= THRESHOLDS.CAUTION) return "caution";
+  if (percentage >= THRESHOLDS.WARNING) return "warning";
   return "ok";
 }
 var THRESHOLDS, ClaudeCodeContextMonitorProvider;
 var init_context_monitor = __esm({
-  "packages/adapters/src/providers/claude-code/context-monitor.js"() {
+  "packages/adapters/src/providers/claude-code/context-monitor.ts"() {
     "use strict";
     init_paths();
     THRESHOLDS = {
@@ -60,13 +60,14 @@ var init_context_monitor = __esm({
       EMERGENCY: 95
     };
     ClaudeCodeContextMonitorProvider = class {
+      /** Path provider for resolving Claude Code directory locations. */
       pathProvider = new ClaudeCodePathProvider();
+      /** Process raw context window JSON and return a formatted summary string. */
       async processContextInput(input, cwd) {
         const typed = input;
         const contextSize = typed.context_window?.context_window_size ?? 2e5;
         const usage = typed.context_window?.current_usage;
-        if (!usage)
-          return "-- no data";
+        if (!usage) return "-- no data";
         const inputTokens = usage.input_tokens ?? 0;
         const outputTokens = usage.output_tokens ?? 0;
         const cacheCreate = usage.cache_creation_input_tokens ?? 0;
@@ -110,17 +111,15 @@ var init_context_monitor = __esm({
         }
         return `${percentage}% | ${totalTokens}/${contextSize}`;
       }
+      /** Check the current statusline integration status in Claude Code settings. */
       checkStatuslineIntegration() {
         const settingsPath = this.pathProvider.getSettingsPath();
-        if (!settingsPath || !existsSync(settingsPath))
-          return "no_settings";
+        if (!settingsPath || !existsSync(settingsPath)) return "no_settings";
         try {
           const settings = JSON.parse(readFileSync(settingsPath, "utf-8"));
           const statusLine = settings.statusLine;
-          if (!statusLine?.type)
-            return "not_configured";
-          if (statusLine.type !== "command")
-            return "custom_no_cleo";
+          if (!statusLine?.type) return "not_configured";
+          if (statusLine.type !== "command") return "custom_no_cleo";
           const cmd = statusLine.command ?? "";
           if (cmd.includes("context-monitor.sh") || cmd.includes("cleo-statusline") || cmd.includes(".context-state.json") || cmd.includes("context-states")) {
             return "configured";
@@ -129,8 +128,7 @@ var init_context_monitor = __esm({
           if (existsSync(scriptPath)) {
             try {
               const content = readFileSync(scriptPath, "utf-8");
-              if (content.includes("context-state.json"))
-                return "configured";
+              if (content.includes("context-state.json")) return "configured";
             } catch {
             }
           }
@@ -139,6 +137,7 @@ var init_context_monitor = __esm({
           return "no_settings";
         }
       }
+      /** Get the recommended statusline configuration object for Claude Code settings. */
       getStatuslineConfig() {
         return {
           statusLine: {
@@ -147,6 +146,7 @@ var init_context_monitor = __esm({
           }
         };
       }
+      /** Get human-readable setup instructions for enabling context monitoring. */
       getSetupInstructions() {
         const settingsPath = this.pathProvider.getSettingsPath() ?? "~/.claude/settings.json";
         return [
@@ -162,24 +162,58 @@ var init_context_monitor = __esm({
   }
 });
 
-// packages/adapters/src/providers/claude-code/hooks.js
-var CLAUDE_CODE_EVENT_MAP, ClaudeCodeHookProvider;
+// packages/adapters/src/providers/claude-code/hooks.ts
+import { readdir, readFile } from "node:fs/promises";
+import { join as join3 } from "node:path";
+var PROVIDER_ID, CLAUDE_CODE_EVENT_MAP, ClaudeCodeHookProvider;
 var init_hooks = __esm({
-  "packages/adapters/src/providers/claude-code/hooks.js"() {
+  "packages/adapters/src/providers/claude-code/hooks.ts"() {
     "use strict";
+    PROVIDER_ID = "claude-code";
     CLAUDE_CODE_EVENT_MAP = {
-      SessionStart: "onSessionStart",
-      PostToolUse: "onToolComplete",
-      UserPromptSubmit: "onPromptSubmit",
-      Stop: "onSessionEnd"
+      // CAAMP: toNative('SessionStart',      'claude-code') = 'SessionStart'
+      SessionStart: "SessionStart",
+      // CAAMP: toNative('SessionEnd',        'claude-code') = 'SessionEnd'
+      SessionEnd: "SessionEnd",
+      // CAAMP: toNative('PromptSubmit',      'claude-code') = 'UserPromptSubmit'
+      UserPromptSubmit: "PromptSubmit",
+      // CAAMP: toNative('ResponseComplete',  'claude-code') = 'Stop'
+      Stop: "ResponseComplete",
+      // CAAMP: toNative('PreToolUse',        'claude-code') = 'PreToolUse'
+      PreToolUse: "PreToolUse",
+      // CAAMP: toNative('PostToolUse',       'claude-code') = 'PostToolUse'
+      PostToolUse: "PostToolUse",
+      // CAAMP: toNative('PostToolUseFailure','claude-code') = 'PostToolUseFailure'
+      PostToolUseFailure: "PostToolUseFailure",
+      // CAAMP: toNative('PermissionRequest', 'claude-code') = 'PermissionRequest'
+      PermissionRequest: "PermissionRequest",
+      // CAAMP: toNative('SubagentStart',     'claude-code') = 'SubagentStart'
+      SubagentStart: "SubagentStart",
+      // CAAMP: toNative('SubagentStop',      'claude-code') = 'SubagentStop'
+      SubagentStop: "SubagentStop",
+      // CAAMP: toNative('PreCompact',        'claude-code') = 'PreCompact'
+      PreCompact: "PreCompact",
+      // CAAMP: toNative('PostCompact',       'claude-code') = 'PostCompact'
+      PostCompact: "PostCompact",
+      // CAAMP: toNative('Notification',      'claude-code') = 'Notification'
+      Notification: "Notification",
+      // CAAMP: toNative('ConfigChange',      'claude-code') = 'ConfigChange'
+      ConfigChange: "ConfigChange"
     };
     ClaudeCodeHookProvider = class {
+      /** Whether hooks have been registered for the current session. */
       registered = false;
       /**
-       * Map a Claude Code native event name to a CAAMP hook event name.
+       * Map a Claude Code native event name to a CAAMP canonical hook event name.
+       *
+       * Looks up the native event name in the map derived from
+       * `getProviderHookProfile('claude-code').mappings` (CAAMP 1.9.1).
+       * Returns null for unrecognised events (e.g. PreModel, PostModel which
+       * Claude Code does not support).
        *
-       * @param providerEvent - Claude Code event name (e.g. "SessionStart", "PostToolUse")
-       * @returns CAAMP event name or null if unmapped
+       * @param providerEvent - Claude Code native event (e.g. "UserPromptSubmit", "Stop")
+       * @returns CAAMP canonical event name, or null if unmapped
+       * @task T164
        */
       mapProviderEvent(providerEvent) {
         return CLAUDE_CODE_EVENT_MAP[providerEvent] ?? null;
@@ -187,12 +221,15 @@ var init_hooks = __esm({
       /**
        * Register native hooks for a project.
        *
-       * For Claude Code, hooks are registered via the plugin system
-       * (hooks.json descriptor), which is handled by the
-       * install provider. This method is a no-op since registration
-       * is managed through the plugin install lifecycle.
+       * For Claude Code, hooks are registered via the config system
+       * (`~/.claude/settings.json`), managed by the install provider.
+       * This method marks hooks as registered without performing filesystem operations.
        *
-       * @param _projectDir - Project directory (unused; hooks are global)
+       * Iterating supported events is handled at install time using
+       * `getSupportedCanonicalEvents()` to enumerate all 14 supported hooks.
+       *
+       * @param _projectDir - Project directory (unused; Claude Code uses global config)
+       * @task T164
        */
       async registerNativeHooks(_projectDir) {
         this.registered = true;
@@ -200,111 +237,206 @@ var init_hooks = __esm({
       /**
        * Unregister native hooks.
        *
-       * For Claude Code, this is a no-op since hooks are managed through
-       * the plugin system. Unregistration happens via the install provider's
-       * uninstall method.
+       * For Claude Code, this is a no-op since hooks are managed through the config
+       * system. Unregistration happens via the install provider's uninstall method.
+       *
+       * @task T164
        */
       async unregisterNativeHooks() {
         this.registered = false;
       }
       /**
-       * Check whether hooks have been registered via registerNativeHooks.
+       * Check whether hooks have been registered via `registerNativeHooks`.
        */
       isRegistered() {
         return this.registered;
       }
       /**
-       * Get the full event mapping for introspection/debugging.
+       * Get the native→canonical event mapping for introspection and debugging.
+       *
+       * Returns the map derived from `getProviderHookProfile('claude-code').mappings`
+       * (CAAMP 1.9.1). Use `getSupportedCanonicalEvents()` to enumerate canonical
+       * names via live CAAMP APIs.
+       *
+       * @returns Immutable record of native event name → canonical event name
        */
       getEventMap() {
         return { ...CLAUDE_CODE_EVENT_MAP };
       }
+      /**
+       * Enumerate supported canonical events via CAAMP's `getSupportedEvents()`.
+       *
+       * Calls `getSupportedEvents('claude-code')` from the CAAMP normalizer to
+       * get the authoritative list. Claude Code supports 14 of 16 canonical events
+       * (PreModel and PostModel are not supported). Falls back to the values of
+       * the static event map when CAAMP is unavailable at runtime.
+       *
+       * @returns Array of CAAMP canonical event names supported by Claude Code
+       * @task T164
+       */
+      async getSupportedCanonicalEvents() {
+        try {
+          const { getSupportedEvents } = await import("@cleocode/caamp");
+          return getSupportedEvents(PROVIDER_ID);
+        } catch {
+          return [...new Set(Object.values(CLAUDE_CODE_EVENT_MAP))];
+        }
+      }
+      /**
+       * Retrieve the full provider hook profile from CAAMP.
+       *
+       * Calls `getProviderHookProfile('claude-code')` from the CAAMP normalizer to
+       * get the complete profile: hook system type (`config`), config path
+       * (`~/.claude/settings.json`), handler types, and all event mappings.
+       * Returns null when CAAMP is unavailable at runtime.
+       *
+       * @returns Provider hook profile or null if CAAMP is unavailable
+       * @task T164
+       */
+      async getProviderProfile() {
+        try {
+          const { getProviderHookProfile } = await import("@cleocode/caamp");
+          return getProviderHookProfile(PROVIDER_ID) ?? null;
+        } catch {
+          return null;
+        }
+      }
+      /**
+       * Translate a CAAMP canonical event to its Claude Code native name via CAAMP.
+       *
+       * Calls `toNative(canonical, 'claude-code')` from the CAAMP normalizer.
+       * Returns null for unsupported events (PreModel, PostModel) or when
+       * CAAMP is unavailable.
+       *
+       * @param canonical - CAAMP canonical event name (e.g. "PromptSubmit")
+       * @returns Claude Code native event name or null
+       * @task T164
+       */
+      async toNativeEvent(canonical) {
+        try {
+          const { toNative } = await import("@cleocode/caamp");
+          return toNative(canonical, PROVIDER_ID);
+        } catch {
+          const entry = Object.entries(CLAUDE_CODE_EVENT_MAP).find(([, v]) => v === canonical);
+          return entry?.[0] ?? null;
+        }
+      }
+      /**
+       * Extract a plain-text transcript from Claude Code session JSONL files.
+       *
+       * Reads the most recent .jsonl file under `~/.claude/projects/` and
+       * extracts user/assistant turn text into a flat string for brain
+       * observation extraction.
+       *
+       * Returns null when no session data is found or on any read error.
+       *
+       * @param _sessionId - CLEO session ID (unused; reads the most recent file)
+       * @param _projectDir - Project directory (unused; Claude Code uses global paths)
+       * @task T144 @epic T134
+       */
+      async getTranscript(_sessionId, _projectDir) {
+        try {
+          const homeDir = process.env.HOME ?? process.env.USERPROFILE ?? "/root";
+          const projectsDir = join3(homeDir, ".claude", "projects");
+          let allFiles = [];
+          try {
+            const projectDirs = await readdir(projectsDir, { withFileTypes: true });
+            for (const entry of projectDirs) {
+              if (!entry.isDirectory()) continue;
+              const subDir = join3(projectsDir, entry.name);
+              try {
+                const files = await readdir(subDir);
+                for (const file of files) {
+                  if (!file.endsWith(".jsonl")) continue;
+                  const filePath = join3(subDir, file);
+                  allFiles.push({ path: filePath, mtime: 0 });
+                }
+              } catch {
+              }
+            }
+          } catch {
+            return null;
+          }
+          if (allFiles.length === 0) return null;
+          allFiles = allFiles.sort((a, b) => b.path.localeCompare(a.path));
+          const mostRecent = allFiles[0];
+          if (!mostRecent) return null;
+          const raw = await readFile(mostRecent.path, "utf-8");
+          const lines = raw.split("\n").filter((l) => l.trim());
+          const turns = [];
+          for (const line of lines) {
+            try {
+              const entry = JSON.parse(line);
+              const role = entry.role;
+              const content = entry.content;
+              if (role === "assistant" && typeof content === "string") {
+                turns.push(`assistant: ${content}`);
+              } else if (role === "user" && typeof content === "string") {
+                turns.push(`user: ${content}`);
+              }
+            } catch {
+            }
+          }
+          return turns.length > 0 ? turns.join("\n") : null;
+        } catch {
+          return null;
+        }
+      }
     };
   }
 });
 
-// packages/adapters/src/providers/claude-code/install.js
+// packages/adapters/src/providers/claude-code/install.ts
 import { existsSync as existsSync2, mkdirSync, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "node:fs";
 import { homedir as homedir3 } from "node:os";
-import { join as join3 } from "node:path";
-var INSTRUCTION_REFERENCES, MCP_SERVER_KEY, ClaudeCodeInstallProvider;
+import { join as join4 } from "node:path";
+var INSTRUCTION_REFERENCES, ClaudeCodeInstallProvider;
 var init_install = __esm({
-  "packages/adapters/src/providers/claude-code/install.js"() {
+  "packages/adapters/src/providers/claude-code/install.ts"() {
     "use strict";
     INSTRUCTION_REFERENCES = ["@~/.cleo/templates/CLEO-INJECTION.md", "@.cleo/memory-bridge.md"];
-    MCP_SERVER_KEY = "cleo";
     ClaudeCodeInstallProvider = class {
-      installedProjectDir = null;
       /**
        * Install CLEO into a Claude Code project.
        *
-       * @param options - Installation options including project directory and MCP server path
+       * @param options - Installation options including project directory
        * @returns Result describing what was installed
        */
       async install(options) {
-        const { projectDir, mcpServerPath } = options;
+        const { projectDir } = options;
         const installedAt = (/* @__PURE__ */ new Date()).toISOString();
         let instructionFileUpdated = false;
-        let mcpRegistered = false;
         const details = {};
-        if (mcpServerPath) {
-          mcpRegistered = this.registerMcpServer(projectDir, mcpServerPath);
-          if (mcpRegistered) {
-            details.mcpConfigPath = join3(projectDir, ".mcp.json");
-          }
-        }
         instructionFileUpdated = this.updateInstructionFile(projectDir);
         if (instructionFileUpdated) {
-          details.instructionFile = join3(projectDir, "CLAUDE.md");
+          details.instructionFile = join4(projectDir, "CLAUDE.md");
         }
         const pluginResult = this.registerPlugin();
         if (pluginResult) {
           details.plugin = pluginResult;
         }
-        this.installedProjectDir = projectDir;
         return {
           success: true,
           installedAt,
           instructionFileUpdated,
-          mcpRegistered,
+          mcpRegistered: false,
           details
         };
       }
       /**
        * Uninstall CLEO from the current Claude Code project.
        *
-       * Removes the MCP server registration from .mcp.json.
        * Does not remove CLAUDE.md references (they are harmless if CLEO is not present).
        */
       async uninstall() {
-        if (!this.installedProjectDir)
-          return;
-        const mcpPath = join3(this.installedProjectDir, ".mcp.json");
-        if (existsSync2(mcpPath)) {
-          try {
-            const raw = readFileSync2(mcpPath, "utf-8");
-            const config = JSON.parse(raw);
-            const mcpServers = config.mcpServers;
-            if (mcpServers && MCP_SERVER_KEY in mcpServers) {
-              delete mcpServers[MCP_SERVER_KEY];
-              writeFileSync2(mcpPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
-            }
-          } catch {
-          }
-        }
-        this.installedProjectDir = null;
       }
       /**
        * Check whether CLEO is installed in the current environment.
        *
-       * Checks for:
-       * 1. MCP server registered in .mcp.json
-       * 2. Plugin enabled in ~/.claude/settings.json
-       *
-       * Returns true if either condition is met (partial install counts).
+       * Checks for plugin enabled in ~/.claude/settings.json.
        */
       async isInstalled() {
-        const settingsPath = join3(homedir3(), ".claude", "settings.json");
+        const settingsPath = join4(homedir3(), ".claude", "settings.json");
         if (existsSync2(settingsPath)) {
           try {
             const settings = JSON.parse(readFileSync2(settingsPath, "utf-8"));
@@ -315,17 +447,6 @@ var init_install = __esm({
           } catch {
           }
         }
-        const mcpPath = join3(process.cwd(), ".mcp.json");
-        if (existsSync2(mcpPath)) {
-          try {
-            const config = JSON.parse(readFileSync2(mcpPath, "utf-8"));
-            const mcpServers = config.mcpServers;
-            if (mcpServers && MCP_SERVER_KEY in mcpServers) {
-              return true;
-            }
-          } catch {
-          }
-        }
         return false;
       }
       /**
@@ -338,38 +459,13 @@ var init_install = __esm({
       async ensureInstructionReferences(projectDir) {
         this.updateInstructionFile(projectDir);
       }
-      /**
-       * Register the CLEO MCP server in .mcp.json.
-       *
-       * @returns true if registration was performed or updated
-       */
-      registerMcpServer(projectDir, mcpServerPath) {
-        const mcpPath = join3(projectDir, ".mcp.json");
-        let config = {};
-        if (existsSync2(mcpPath)) {
-          try {
-            config = JSON.parse(readFileSync2(mcpPath, "utf-8"));
-          } catch {
-          }
-        }
-        if (!config.mcpServers || typeof config.mcpServers !== "object") {
-          config.mcpServers = {};
-        }
-        const mcpServers = config.mcpServers;
-        mcpServers[MCP_SERVER_KEY] = {
-          command: "node",
-          args: [mcpServerPath]
-        };
-        writeFileSync2(mcpPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
-        return true;
-      }
       /**
        * Update CLAUDE.md with CLEO @-references.
        *
        * @returns true if the file was created or modified
        */
       updateInstructionFile(projectDir) {
-        const claudeMdPath = join3(projectDir, "CLAUDE.md");
+        const claudeMdPath = join4(projectDir, "CLAUDE.md");
         let content = "";
         let existed = false;
         if (existsSync2(claudeMdPath)) {
@@ -397,7 +493,7 @@ var init_install = __esm({
        */
       registerPlugin() {
         const home = homedir3();
-        const settingsPath = join3(home, ".claude", "settings.json");
+        const settingsPath = join4(home, ".claude", "settings.json");
         let settings = {};
         if (existsSync2(settingsPath)) {
           try {
@@ -415,7 +511,7 @@ var init_install = __esm({
         }
         enabledPlugins[pluginKey] = true;
         settings.enabledPlugins = enabledPlugins;
-        mkdirSync(join3(home, ".claude"), { recursive: true });
+        mkdirSync(join4(home, ".claude"), { recursive: true });
         writeFileSync2(settingsPath, JSON.stringify(settings, null, 2) + "\n", "utf-8");
         return `Enabled ${pluginKey} in ~/.claude/settings.json`;
       }
@@ -593,13 +689,13 @@ var init_src = __esm({
   }
 });
 
-// packages/adapters/src/providers/claude-code/spawn.js
+// packages/adapters/src/providers/claude-code/spawn.ts
 import { exec, spawn as nodeSpawn } from "node:child_process";
 import { unlink, writeFile } from "node:fs/promises";
 import { promisify } from "node:util";
 var execAsync, ClaudeCodeSpawnProvider;
 var init_spawn = __esm({
-  "packages/adapters/src/providers/claude-code/spawn.js"() {
+  "packages/adapters/src/providers/claude-code/spawn.ts"() {
     "use strict";
     init_src();
     execAsync = promisify(exec);
@@ -722,8 +818,7 @@ var init_spawn = __esm({
        */
       async terminate(instanceId) {
         const tracked = this.processMap.get(instanceId);
-        if (!tracked)
-          return;
+        if (!tracked) return;
         try {
           process.kill(tracked.pid, "SIGTERM");
         } catch {
@@ -734,9 +829,9 @@ var init_spawn = __esm({
   }
 });
 
-// packages/adapters/src/providers/claude-code/task-sync.js
-import { readFile, rm, stat } from "node:fs/promises";
-import { join as join4 } from "node:path";
+// packages/adapters/src/providers/claude-code/task-sync.ts
+import { readFile as readFile2, stat } from "node:fs/promises";
+import { join as join5 } from "node:path";
 function parseTaskId(content) {
   const match = content.match(/^\[T(\d+)\]/);
   return match ? `T${match[1]}` : null;
@@ -757,17 +852,19 @@ function mapStatus(twStatus) {
   }
 }
 function getTodoWriteFilePath(projectDir) {
-  return join4(projectDir, ".cleo", "sync", "todowrite-state.json");
+  return join5(projectDir, ".cleo", "sync", "todowrite-state.json");
 }
 var ClaudeCodeTaskSyncProvider;
 var init_task_sync = __esm({
-  "packages/adapters/src/providers/claude-code/task-sync.js"() {
+  "packages/adapters/src/providers/claude-code/task-sync.ts"() {
     "use strict";
     ClaudeCodeTaskSyncProvider = class {
+      /** Optional override path for the TodoWrite state file (used in tests). */
       customFilePath;
       constructor(options) {
         this.customFilePath = options?.filePath;
       }
+      /** Retrieve external tasks from Claude's TodoWrite state file. */
       async getExternalTasks(projectDir) {
         const filePath = this.customFilePath ?? getTodoWriteFilePath(projectDir);
         try {
@@ -775,7 +872,7 @@ var init_task_sync = __esm({
         } catch {
           return [];
         }
-        const raw = await readFile(filePath, "utf-8");
+        const raw = await readFile2(filePath, "utf-8");
         let state;
         try {
           state = JSON.parse(raw);
@@ -790,15 +887,14 @@ var init_task_sync = __esm({
         for (const item of state.todos) {
           const cleoTaskId = parseTaskId(item.content);
           const title = cleoTaskId ? stripPrefixes(item.content).trim() : item.content.trim();
-          if (!title)
-            continue;
+          if (!title) continue;
           tasks.push({
             externalId: cleoTaskId ?? `tw-new-${syntheticIndex++}`,
-            cleoTaskId,
             title,
             status: mapStatus(item.status),
             providerMeta: {
               source: "todowrite",
+              cleoTaskId,
               activeForm: item.activeForm,
               rawContent: item.content
             }
@@ -806,24 +902,19 @@ var init_task_sync = __esm({
         }
         return tasks;
       }
-      async cleanup(projectDir) {
-        const filePath = this.customFilePath ?? getTodoWriteFilePath(projectDir);
-        try {
-          await rm(filePath);
-        } catch {
-        }
-      }
     };
   }
 });
 
-// packages/adapters/src/providers/claude-code/transport.js
+// packages/adapters/src/providers/claude-code/transport.ts
 var ClaudeCodeTransportProvider;
 var init_transport = __esm({
-  "packages/adapters/src/providers/claude-code/transport.js"() {
+  "packages/adapters/src/providers/claude-code/transport.ts"() {
     "use strict";
     ClaudeCodeTransportProvider = class {
+      /** Provider-specific transport name used for capability negotiation. */
       transportName = "claude-code";
+      /** Create a transport instance for inter-agent messaging. */
       createTransport() {
         return null;
       }
@@ -831,15 +922,15 @@ var init_transport = __esm({
   }
 });
 
-// packages/adapters/src/providers/claude-code/adapter.js
+// packages/adapters/src/providers/claude-code/adapter.ts
 import { exec as exec2 } from "node:child_process";
 import { existsSync as existsSync3 } from "node:fs";
 import { homedir as homedir4 } from "node:os";
-import { join as join5 } from "node:path";
+import { join as join6 } from "node:path";
 import { promisify as promisify2 } from "node:util";
 var execAsync2, ClaudeCodeAdapter;
 var init_adapter = __esm({
-  "packages/adapters/src/providers/claude-code/adapter.js"() {
+  "packages/adapters/src/providers/claude-code/adapter.ts"() {
     "use strict";
     init_context_monitor();
     init_hooks();
@@ -850,21 +941,36 @@ var init_adapter = __esm({
     init_transport();
     execAsync2 = promisify2(exec2);
     ClaudeCodeAdapter = class {
+      /** Unique provider identifier. */
       id = "claude-code";
+      /** Human-readable provider name. */
       name = "Claude Code";
+      /** Adapter version string. */
       version = "1.0.0";
+      /** Declared capabilities for this provider. */
       capabilities = {
         supportsHooks: true,
+        // 14/16 canonical events — derived from getProviderHookProfile('claude-code') in CAAMP 1.9.1.
+        // PreModel and PostModel are not supported by Claude Code.
         supportedHookEvents: [
-          "onSessionStart",
-          "onSessionEnd",
-          "onToolStart",
-          "onToolComplete",
-          "onError"
+          "SessionStart",
+          "SessionEnd",
+          "PromptSubmit",
+          "ResponseComplete",
+          "PreToolUse",
+          "PostToolUse",
+          "PostToolUseFailure",
+          "PermissionRequest",
+          "SubagentStart",
+          "SubagentStop",
+          "PreCompact",
+          "PostCompact",
+          "Notification",
+          "ConfigChange"
         ],
         supportsSpawn: true,
         supportsInstall: true,
-        supportsMcp: true,
+        supportsMcp: false,
         supportsInstructionFiles: true,
         instructionFilePattern: "CLAUDE.md",
         supportsContextMonitor: true,
@@ -873,14 +979,23 @@ var init_adapter = __esm({
         supportsTransport: true,
         supportsTaskSync: true
       };
+      /** Hook provider for CAAMP event mapping and registration. */
       hooks;
+      /** Spawn provider for launching subagent processes via `claude` CLI. */
       spawn;
+      /** Install provider for managing instruction files and plugin registration. */
       install;
+      /** Path provider for resolving Claude Code directory locations. */
       paths;
+      /** Context monitor for tracking context window usage and statusline output. */
       contextMonitor;
+      /** Transport provider for inter-agent communication. */
       transport;
+      /** Task sync provider bridging Claude's TodoWrite format to CLEO tasks. */
       taskSync;
+      /** Project directory this adapter was initialized with, or null. */
       projectDir = null;
+      /** Whether {@link initialize} has been called. */
       initialized = false;
       constructor() {
         this.hooks = new ClaudeCodeHookProvider();
@@ -942,7 +1057,7 @@ var init_adapter = __esm({
         } catch {
           details.cliAvailable = false;
         }
-        const claudeConfigDir = join5(homedir4(), ".claude");
+        const claudeConfigDir = join6(homedir4(), ".claude");
         const configExists = existsSync3(claudeConfigDir);
         details.configDirExists = configExists;
         const entrypointSet = process.env.CLAUDE_CODE_ENTRYPOINT !== void 0;
@@ -971,24 +1086,21 @@ var init_adapter = __esm({
   }
 });
 
-// packages/adapters/src/providers/claude-code/statusline.js
+// packages/adapters/src/providers/claude-code/statusline.ts
 import { existsSync as existsSync4, readFileSync as readFileSync3 } from "node:fs";
 import { homedir as homedir5 } from "node:os";
-import { join as join6 } from "node:path";
+import { join as join7 } from "node:path";
 function getClaudeSettingsPath() {
-  return process.env["CLAUDE_SETTINGS"] ?? join6(process.env["CLAUDE_HOME"] ?? join6(homedir5(), ".claude"), "settings.json");
+  return process.env["CLAUDE_SETTINGS"] ?? join7(process.env["CLAUDE_HOME"] ?? join7(homedir5(), ".claude"), "settings.json");
 }
 function checkStatuslineIntegration() {
   const settingsPath = getClaudeSettingsPath();
-  if (!existsSync4(settingsPath))
-    return "no_settings";
+  if (!existsSync4(settingsPath)) return "no_settings";
   try {
     const settings = JSON.parse(readFileSync3(settingsPath, "utf-8"));
     const statusLine = settings.statusLine;
-    if (!statusLine?.type)
-      return "not_configured";
-    if (statusLine.type !== "command")
-      return "custom_no_cleo";
+    if (!statusLine?.type) return "not_configured";
+    if (statusLine.type !== "command") return "custom_no_cleo";
     const cmd = statusLine.command ?? "";
     if (cmd.includes("context-monitor.sh") || cmd.includes("cleo-statusline") || cmd.includes(".context-state.json") || cmd.includes("context-states")) {
       return "configured";
@@ -997,8 +1109,7 @@ function checkStatuslineIntegration() {
     if (existsSync4(scriptPath)) {
       try {
         const content = readFileSync3(scriptPath, "utf-8");
-        if (content.includes("context-state.json"))
-          return "configured";
+        if (content.includes("context-state.json")) return "configured";
       } catch {
       }
     }
@@ -1011,7 +1122,7 @@ function getStatuslineConfig(cleoHome) {
   return {
     statusLine: {
       type: "command",
-      command: join6(cleoHome, "lib", "session", "context-monitor.sh")
+      command: join7(cleoHome, "lib", "session", "context-monitor.sh")
     }
   };
 }
@@ -1027,12 +1138,12 @@ function getSetupInstructions(cleoHome) {
   ].join("\n");
 }
 var init_statusline = __esm({
-  "packages/adapters/src/providers/claude-code/statusline.js"() {
+  "packages/adapters/src/providers/claude-code/statusline.ts"() {
     "use strict";
   }
 });
 
-// packages/adapters/src/providers/claude-code/index.js
+// packages/adapters/src/providers/claude-code/index.ts
 var claude_code_exports = {};
 __export(claude_code_exports, {
   ClaudeCodeAdapter: () => ClaudeCodeAdapter,
@@ -1053,7 +1164,7 @@ function createAdapter() {
 }
 var claude_code_default;
 var init_claude_code = __esm({
-  "packages/adapters/src/providers/claude-code/index.js"() {
+  "packages/adapters/src/providers/claude-code/index.ts"() {
     "use strict";
     init_adapter();
     init_adapter();
@@ -1068,30 +1179,66 @@ var init_claude_code = __esm({
   }
 });
 
-// packages/adapters/src/providers/cursor/hooks.js
-var CursorHookProvider;
+// packages/adapters/src/providers/cursor/hooks.ts
+var PROVIDER_ID2, CURSOR_EVENT_MAP, CursorHookProvider;
 var init_hooks2 = __esm({
-  "packages/adapters/src/providers/cursor/hooks.js"() {
+  "packages/adapters/src/providers/cursor/hooks.ts"() {
     "use strict";
+    PROVIDER_ID2 = "cursor";
+    CURSOR_EVENT_MAP = {
+      // CAAMP: toNative('SessionStart',       'cursor') = 'sessionStart'
+      sessionStart: "SessionStart",
+      // CAAMP: toNative('SessionEnd',         'cursor') = 'sessionEnd'
+      sessionEnd: "SessionEnd",
+      // CAAMP: toNative('PromptSubmit',       'cursor') = 'beforeSubmitPrompt'
+      beforeSubmitPrompt: "PromptSubmit",
+      // CAAMP: toNative('ResponseComplete',   'cursor') = 'stop'
+      stop: "ResponseComplete",
+      // CAAMP: toNative('PreToolUse',         'cursor') = 'preToolUse'
+      preToolUse: "PreToolUse",
+      // CAAMP: toNative('PostToolUse',        'cursor') = 'postToolUse'
+      postToolUse: "PostToolUse",
+      // CAAMP: toNative('PostToolUseFailure', 'cursor') = 'postToolUseFailure'
+      postToolUseFailure: "PostToolUseFailure",
+      // CAAMP: toNative('SubagentStart',      'cursor') = 'subagentStart'
+      subagentStart: "SubagentStart",
+      // CAAMP: toNative('SubagentStop',       'cursor') = 'subagentStop'
+      subagentStop: "SubagentStop",
+      // CAAMP: toNative('PreCompact',         'cursor') = 'preCompact'
+      preCompact: "PreCompact"
+    };
     CursorHookProvider = class {
+      /** Whether hooks have been registered for the current session. */
       registered = false;
       /**
-       * Map a provider event name to a CAAMP hook event name.
+       * Map a Cursor native event name to a CAAMP canonical hook event name.
+       *
+       * Looks up the native event name in the map derived from
+       * `getProviderHookProfile('cursor').mappings` (CAAMP 1.9.1). Cursor uses
+       * camelCase names (e.g. "preToolUse", "sessionStart").
        *
-       * Always returns null since Cursor does not emit hook events.
+       * Returns null for unsupported events (PermissionRequest, PreModel,
+       * PostModel, PostCompact, Notification, ConfigChange).
        *
-       * @param _providerEvent - Ignored; Cursor has no hook events
-       * @returns null (no mapping available)
+       * @param providerEvent - Cursor native event name (e.g. "preToolUse", "sessionStart")
+       * @returns CAAMP canonical event name, or null if unmapped
+       * @task T165
        */
-      mapProviderEvent(_providerEvent) {
-        return null;
+      mapProviderEvent(providerEvent) {
+        return CURSOR_EVENT_MAP[providerEvent] ?? null;
       }
       /**
        * Register native hooks for a project.
        *
-       * No-op for Cursor since it has no hook system.
+       * For Cursor, hooks are registered via the config system
+       * (`.cursor/hooks.json`), managed by the install provider.
+       * This method marks hooks as registered without performing filesystem operations.
        *
-       * @param _projectDir - Ignored
+       * Iterating supported events is handled at install time using
+       * `getSupportedCanonicalEvents()` to enumerate all 10 supported hooks.
+       *
+       * @param _projectDir - Project directory (unused; Cursor config manages registration)
+       * @task T165
        */
       async registerNativeHooks(_projectDir) {
         this.registered = true;
@@ -1099,99 +1246,146 @@ var init_hooks2 = __esm({
       /**
        * Unregister native hooks.
        *
-       * No-op for Cursor since it has no hook system.
+       * For Cursor, this is a no-op since hooks are managed through the config
+       * system. Unregistration happens via the install provider's uninstall method.
+       *
+       * @task T165
        */
       async unregisterNativeHooks() {
         this.registered = false;
       }
       /**
-       * Check whether hooks have been registered.
+       * Check whether hooks have been registered via `registerNativeHooks`.
        */
       isRegistered() {
         return this.registered;
       }
+      /**
+       * Get the native→canonical event mapping for introspection and debugging.
+       *
+       * Returns the map derived from `getProviderHookProfile('cursor').mappings`
+       * (CAAMP 1.9.1). Use `getSupportedCanonicalEvents()` to enumerate canonical
+       * names via live CAAMP APIs.
+       *
+       * @returns Immutable record of native event name → canonical event name
+       */
+      getEventMap() {
+        return { ...CURSOR_EVENT_MAP };
+      }
+      /**
+       * Enumerate supported canonical events via CAAMP's `getSupportedEvents()`.
+       *
+       * Calls `getSupportedEvents('cursor')` from the CAAMP normalizer to get the
+       * authoritative list. Cursor supports 10 of 16 canonical events. Falls back
+       * to the values of the static event map when CAAMP is unavailable at runtime.
+       *
+       * @returns Array of CAAMP canonical event names supported by Cursor
+       * @task T165
+       */
+      async getSupportedCanonicalEvents() {
+        try {
+          const { getSupportedEvents } = await import("@cleocode/caamp");
+          return getSupportedEvents(PROVIDER_ID2);
+        } catch {
+          return [...new Set(Object.values(CURSOR_EVENT_MAP))];
+        }
+      }
+      /**
+       * Retrieve the full provider hook profile from CAAMP.
+       *
+       * Calls `getProviderHookProfile('cursor')` from the CAAMP normalizer to
+       * get the complete profile: hook system type (`config`), config path
+       * (`.cursor/hooks.json`), handler types (command, prompt), and all event
+       * mappings. Returns null when CAAMP is unavailable at runtime.
+       *
+       * @returns Provider hook profile or null if CAAMP is unavailable
+       * @task T165
+       */
+      async getProviderProfile() {
+        try {
+          const { getProviderHookProfile } = await import("@cleocode/caamp");
+          return getProviderHookProfile(PROVIDER_ID2) ?? null;
+        } catch {
+          return null;
+        }
+      }
+      /**
+       * Translate a CAAMP canonical event to its Cursor native name via CAAMP.
+       *
+       * Calls `toNative(canonical, 'cursor')` from the CAAMP normalizer.
+       * Returns null for unsupported events or when CAAMP is unavailable.
+       *
+       * @param canonical - CAAMP canonical event name (e.g. "PreToolUse")
+       * @returns Cursor native event name (e.g. "preToolUse") or null
+       * @task T165
+       */
+      async toNativeEvent(canonical) {
+        try {
+          const { toNative } = await import("@cleocode/caamp");
+          return toNative(canonical, PROVIDER_ID2);
+        } catch {
+          const entry = Object.entries(CURSOR_EVENT_MAP).find(([, v]) => v === canonical);
+          return entry?.[0] ?? null;
+        }
+      }
     };
   }
 });
 
-// packages/adapters/src/providers/cursor/install.js
-import { existsSync as existsSync7, mkdirSync as mkdirSync3, readFileSync as readFileSync5, writeFileSync as writeFileSync4 } from "node:fs";
-import { join as join11 } from "node:path";
-var INSTRUCTION_REFERENCES3, MCP_SERVER_KEY3, CursorInstallProvider;
+// packages/adapters/src/providers/cursor/install.ts
+import { existsSync as existsSync7, mkdirSync as mkdirSync2, readFileSync as readFileSync5, writeFileSync as writeFileSync4 } from "node:fs";
+import { join as join12 } from "node:path";
+var INSTRUCTION_REFERENCES3, CursorInstallProvider;
 var init_install2 = __esm({
-  "packages/adapters/src/providers/cursor/install.js"() {
+  "packages/adapters/src/providers/cursor/install.ts"() {
     "use strict";
     INSTRUCTION_REFERENCES3 = ["@~/.cleo/templates/CLEO-INJECTION.md", "@.cleo/memory-bridge.md"];
-    MCP_SERVER_KEY3 = "cleo";
     CursorInstallProvider = class {
-      installedProjectDir = null;
       /**
        * Install CLEO into a Cursor project.
        *
-       * @param options - Installation options including project directory and MCP server path
+       * @param options - Installation options including project directory
        * @returns Result describing what was installed
        */
       async install(options) {
-        const { projectDir, mcpServerPath } = options;
+        const { projectDir } = options;
         const installedAt = (/* @__PURE__ */ new Date()).toISOString();
         let instructionFileUpdated = false;
-        let mcpRegistered = false;
         const details = {};
-        if (mcpServerPath) {
-          mcpRegistered = this.registerMcpServer(projectDir, mcpServerPath);
-          if (mcpRegistered) {
-            details.mcpConfigPath = join11(projectDir, ".cursor", "mcp.json");
-          }
-        }
         instructionFileUpdated = this.updateInstructionFiles(projectDir);
         if (instructionFileUpdated) {
           details.instructionFiles = this.getUpdatedFileList(projectDir);
         }
-        this.installedProjectDir = projectDir;
         return {
           success: true,
           installedAt,
           instructionFileUpdated,
-          mcpRegistered,
+          mcpRegistered: false,
           details
         };
       }
       /**
        * Uninstall CLEO from the current Cursor project.
        *
-       * Removes the MCP server registration from .cursor/mcp.json.
        * Does not remove instruction file references (they are harmless if CLEO is not present).
        */
       async uninstall() {
-        if (!this.installedProjectDir)
-          return;
-        const mcpPath = join11(this.installedProjectDir, ".cursor", "mcp.json");
-        if (existsSync7(mcpPath)) {
-          try {
-            const raw = readFileSync5(mcpPath, "utf-8");
-            const config = JSON.parse(raw);
-            const mcpServers = config.mcpServers;
-            if (mcpServers && MCP_SERVER_KEY3 in mcpServers) {
-              delete mcpServers[MCP_SERVER_KEY3];
-              writeFileSync4(mcpPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
-            }
-          } catch {
-          }
-        }
-        this.installedProjectDir = null;
       }
       /**
        * Check whether CLEO is installed in the current environment.
        *
-       * Checks for MCP server registered in .cursor/mcp.json.
+       * Checks for .cursor/rules/cleo.mdc or .cursorrules with CLEO references.
        */
       async isInstalled() {
-        const mcpPath = join11(process.cwd(), ".cursor", "mcp.json");
-        if (existsSync7(mcpPath)) {
+        const mdcPath = join12(process.cwd(), ".cursor", "rules", "cleo.mdc");
+        if (existsSync7(mdcPath)) {
+          return true;
+        }
+        const rulesPath = join12(process.cwd(), ".cursorrules");
+        if (existsSync7(rulesPath)) {
           try {
-            const config = JSON.parse(readFileSync5(mcpPath, "utf-8"));
-            const mcpServers = config.mcpServers;
-            if (mcpServers && MCP_SERVER_KEY3 in mcpServers) {
+            const content = readFileSync5(rulesPath, "utf-8");
+            if (INSTRUCTION_REFERENCES3.some((ref) => content.includes(ref))) {
               return true;
             }
           } catch {
@@ -1209,36 +1403,6 @@ var init_install2 = __esm({
       async ensureInstructionReferences(projectDir) {
         this.updateInstructionFiles(projectDir);
       }
-      /**
-       * Register the CLEO MCP server in .cursor/mcp.json.
-       *
-       * Cursor stores MCP server configuration in .cursor/mcp.json
-       * under the mcpServers key.
-       *
-       * @returns true if registration was performed or updated
-       */
-      registerMcpServer(projectDir, mcpServerPath) {
-        const cursorDir = join11(projectDir, ".cursor");
-        const mcpPath = join11(cursorDir, "mcp.json");
-        let config = {};
-        mkdirSync3(cursorDir, { recursive: true });
-        if (existsSync7(mcpPath)) {
-          try {
-            config = JSON.parse(readFileSync5(mcpPath, "utf-8"));
-          } catch {
-          }
-        }
-        if (!config.mcpServers || typeof config.mcpServers !== "object") {
-          config.mcpServers = {};
-        }
-        const mcpServers = config.mcpServers;
-        mcpServers[MCP_SERVER_KEY3] = {
-          command: "node",
-          args: [mcpServerPath]
-        };
-        writeFileSync4(mcpPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
-        return true;
-      }
       /**
        * Update instruction files with CLEO @-references.
        *
@@ -1263,7 +1427,7 @@ var init_install2 = __esm({
        * @returns true if the file was modified
        */
       updateLegacyRules(projectDir) {
-        const rulesPath = join11(projectDir, ".cursorrules");
+        const rulesPath = join12(projectDir, ".cursorrules");
         if (!existsSync7(rulesPath)) {
           return false;
         }
@@ -1286,8 +1450,8 @@ var init_install2 = __esm({
        * @returns true if the file was created or modified
        */
       updateModernRules(projectDir) {
-        const rulesDir = join11(projectDir, ".cursor", "rules");
-        const mdcPath = join11(rulesDir, "cleo.mdc");
+        const rulesDir = join12(projectDir, ".cursor", "rules");
+        const mdcPath = join12(rulesDir, "cleo.mdc");
         const expectedContent = [
           "---",
           "description: CLEO task management protocol references",
@@ -1304,7 +1468,7 @@ var init_install2 = __esm({
             return false;
           }
         }
-        mkdirSync3(rulesDir, { recursive: true });
+        mkdirSync2(rulesDir, { recursive: true });
         writeFileSync4(mdcPath, expectedContent, "utf-8");
         return true;
       }
@@ -1313,35 +1477,53 @@ var init_install2 = __esm({
        */
       getUpdatedFileList(projectDir) {
         const files = [];
-        if (existsSync7(join11(projectDir, ".cursorrules"))) {
-          files.push(join11(projectDir, ".cursorrules"));
+        if (existsSync7(join12(projectDir, ".cursorrules"))) {
+          files.push(join12(projectDir, ".cursorrules"));
         }
-        files.push(join11(projectDir, ".cursor", "rules", "cleo.mdc"));
+        files.push(join12(projectDir, ".cursor", "rules", "cleo.mdc"));
         return files;
       }
     };
   }
 });
 
-// packages/adapters/src/providers/cursor/adapter.js
+// packages/adapters/src/providers/cursor/adapter.ts
 import { existsSync as existsSync8 } from "node:fs";
-import { join as join12 } from "node:path";
+import { join as join13 } from "node:path";
 var CursorAdapter;
 var init_adapter2 = __esm({
-  "packages/adapters/src/providers/cursor/adapter.js"() {
+  "packages/adapters/src/providers/cursor/adapter.ts"() {
     "use strict";
     init_hooks2();
     init_install2();
     CursorAdapter = class {
+      /** Unique provider identifier. */
       id = "cursor";
+      /** Human-readable provider name. */
       name = "Cursor";
+      /** Adapter version string. */
       version = "1.0.0";
+      /** Declared capabilities for this provider. */
       capabilities = {
-        supportsHooks: false,
-        supportedHookEvents: [],
+        supportsHooks: true,
+        // 10/16 canonical events — derived from getProviderHookProfile('cursor') in CAAMP 1.9.1.
+        // PermissionRequest, PreModel, PostModel, PostCompact, Notification, ConfigChange are
+        // not supported by Cursor's hook system.
+        supportedHookEvents: [
+          "SessionStart",
+          "SessionEnd",
+          "PromptSubmit",
+          "ResponseComplete",
+          "PreToolUse",
+          "PostToolUse",
+          "PostToolUseFailure",
+          "SubagentStart",
+          "SubagentStop",
+          "PreCompact"
+        ],
         supportsSpawn: false,
         supportsInstall: true,
-        supportsMcp: true,
+        supportsMcp: false,
         supportsInstructionFiles: true,
         instructionFilePattern: ".cursor/rules/*.mdc",
         supportsContextMonitor: false,
@@ -1350,9 +1532,13 @@ var init_adapter2 = __esm({
         supportsTransport: false,
         supportsTaskSync: false
       };
+      /** Hook provider for CAAMP event mapping. */
       hooks;
+      /** Install provider for managing rule files. */
       install;
+      /** Project directory this adapter was initialized with, or null. */
       projectDir = null;
+      /** Whether {@link initialize} has been called. */
       initialized = false;
       constructor() {
         this.hooks = new CursorHookProvider();
@@ -1398,14 +1584,14 @@ var init_adapter2 = __esm({
         }
         let configExists = false;
         if (this.projectDir) {
-          const cursorConfigDir = join12(this.projectDir, ".cursor");
+          const cursorConfigDir = join13(this.projectDir, ".cursor");
           configExists = existsSync8(cursorConfigDir);
           details.configDirExists = configExists;
         }
         const editorEnvSet = process.env.CURSOR_EDITOR !== void 0;
         details.editorEnvSet = editorEnvSet;
         if (this.projectDir) {
-          const legacyRulesExist = existsSync8(join12(this.projectDir, ".cursorrules"));
+          const legacyRulesExist = existsSync8(join13(this.projectDir, ".cursorrules"));
           details.legacyRulesExist = legacyRulesExist;
         }
         const healthy = configExists || editorEnvSet;
@@ -1432,7 +1618,7 @@ var init_adapter2 = __esm({
   }
 });
 
-// packages/adapters/src/providers/cursor/index.js
+// packages/adapters/src/providers/cursor/index.ts
 var cursor_exports = {};
 __export(cursor_exports, {
   CursorAdapter: () => CursorAdapter,
@@ -1446,7 +1632,7 @@ function createAdapter3() {
 }
 var cursor_default;
 var init_cursor = __esm({
-  "packages/adapters/src/providers/cursor/index.js"() {
+  "packages/adapters/src/providers/cursor/index.ts"() {
     "use strict";
     init_adapter2();
     init_adapter2();
@@ -1456,26 +1642,48 @@ var init_cursor = __esm({
   }
 });
 
-// packages/adapters/src/providers/opencode/hooks.js
-var OPENCODE_EVENT_MAP, OpenCodeHookProvider;
+// packages/adapters/src/providers/opencode/hooks.ts
+var PROVIDER_ID3, OPENCODE_EVENT_MAP, OpenCodeHookProvider;
 var init_hooks3 = __esm({
-  "packages/adapters/src/providers/opencode/hooks.js"() {
+  "packages/adapters/src/providers/opencode/hooks.ts"() {
     "use strict";
+    PROVIDER_ID3 = "opencode";
     OPENCODE_EVENT_MAP = {
-      "session.start": "onSessionStart",
-      "session.end": "onSessionEnd",
-      "tool.start": "onToolStart",
-      "tool.complete": "onToolComplete",
-      error: "onError",
-      "prompt.submit": "onPromptSubmit"
+      // CAAMP: toNative('SessionStart',       'opencode') = 'event:session.created'
+      "event:session.created": "SessionStart",
+      // CAAMP: toNative('SessionEnd',         'opencode') = 'event:session.deleted'
+      "event:session.deleted": "SessionEnd",
+      // CAAMP: toNative('PromptSubmit',       'opencode') = 'chat.message'
+      "chat.message": "PromptSubmit",
+      // CAAMP: toNative('ResponseComplete',   'opencode') = 'event:session.idle'
+      "event:session.idle": "ResponseComplete",
+      // CAAMP: toNative('PreToolUse',         'opencode') = 'tool.execute.before'
+      "tool.execute.before": "PreToolUse",
+      // CAAMP: toNative('PostToolUse',        'opencode') = 'tool.execute.after'
+      "tool.execute.after": "PostToolUse",
+      // CAAMP: toNative('PermissionRequest',  'opencode') = 'permission.ask'
+      "permission.ask": "PermissionRequest",
+      // CAAMP: toNative('PreModel',           'opencode') = 'chat.params'
+      "chat.params": "PreModel",
+      // CAAMP: toNative('PreCompact',         'opencode') = 'experimental.session.compacting'
+      "experimental.session.compacting": "PreCompact",
+      // CAAMP: toNative('PostCompact',        'opencode') = 'event:session.compacted'
+      "event:session.compacted": "PostCompact"
     };
     OpenCodeHookProvider = class {
+      /** Whether hooks have been registered for the current session. */
       registered = false;
       /**
-       * Map an OpenCode native event name to a CAAMP hook event name.
+       * Map an OpenCode native event name to a CAAMP canonical hook event name.
+       *
+       * Looks up the native event name in the map derived from
+       * `getProviderHookProfile('opencode').mappings` (CAAMP 1.9.1).
+       * Returns null for unsupported events (PostToolUseFailure, SubagentStart,
+       * SubagentStop, Notification, ConfigChange).
        *
-       * @param providerEvent - OpenCode event name (e.g. "session.start", "tool.complete")
-       * @returns CAAMP event name or null if unmapped
+       * @param providerEvent - OpenCode native event (e.g. "event:session.created", "tool.execute.before")
+       * @returns CAAMP canonical event name, or null if unmapped
+       * @task T164
        */
       mapProviderEvent(providerEvent) {
         return OPENCODE_EVENT_MAP[providerEvent] ?? null;
@@ -1483,12 +1691,15 @@ var init_hooks3 = __esm({
       /**
        * Register native hooks for a project.
        *
-       * For OpenCode, hooks are registered via the config system
-       * (.opencode/config.json), which is handled by the install provider.
-       * This method marks hooks as registered without performing
-       * filesystem operations.
+       * For OpenCode, hooks are registered via the plugin system
+       * (`.opencode/plugins/`), managed by the install provider.
+       * This method marks hooks as registered without performing filesystem operations.
+       *
+       * Iterating supported events is handled at install time using
+       * `getSupportedCanonicalEvents()` to enumerate all 10 supported hooks.
        *
        * @param _projectDir - Project directory (unused; config manages registration)
+       * @task T164
        */
       async registerNativeHooks(_projectDir) {
         this.registered = true;
@@ -1496,108 +1707,143 @@ var init_hooks3 = __esm({
       /**
        * Unregister native hooks.
        *
-       * For OpenCode, this is a no-op since hooks are managed through
-       * the config system. Unregistration happens via the install
-       * provider's uninstall method.
+       * For OpenCode, this is a no-op since hooks are managed through the plugin
+       * system. Unregistration happens via the install provider's uninstall method.
+       *
+       * @task T164
        */
       async unregisterNativeHooks() {
         this.registered = false;
       }
       /**
-       * Check whether hooks have been registered via registerNativeHooks.
+       * Check whether hooks have been registered via `registerNativeHooks`.
        */
       isRegistered() {
         return this.registered;
       }
       /**
-       * Get the full event mapping for introspection/debugging.
+       * Get the native→canonical event mapping for introspection and debugging.
+       *
+       * Returns the map derived from `getProviderHookProfile('opencode').mappings`
+       * (CAAMP 1.9.1). Use `getSupportedCanonicalEvents()` to enumerate canonical
+       * names via live CAAMP APIs.
+       *
+       * @returns Immutable record of native event name → canonical event name
        */
       getEventMap() {
         return { ...OPENCODE_EVENT_MAP };
       }
+      /**
+       * Enumerate supported canonical events via CAAMP's `getSupportedEvents()`.
+       *
+       * Calls `getSupportedEvents('opencode')` from the CAAMP normalizer to get the
+       * authoritative list. OpenCode supports 10 of 16 canonical events via its
+       * plugin system. Falls back to the values of the static event map when
+       * CAAMP is unavailable at runtime.
+       *
+       * @returns Array of CAAMP canonical event names supported by OpenCode
+       * @task T164
+       */
+      async getSupportedCanonicalEvents() {
+        try {
+          const { getSupportedEvents } = await import("@cleocode/caamp");
+          return getSupportedEvents(PROVIDER_ID3);
+        } catch {
+          return [...new Set(Object.values(OPENCODE_EVENT_MAP))];
+        }
+      }
+      /**
+       * Retrieve the full provider hook profile from CAAMP.
+       *
+       * Calls `getProviderHookProfile('opencode')` from the CAAMP normalizer to
+       * get the complete profile: hook system type (`plugin`), config path
+       * (`.opencode/plugins/`), handler types, and all event mappings.
+       * Returns null when CAAMP is unavailable at runtime.
+       *
+       * @returns Provider hook profile or null if CAAMP is unavailable
+       * @task T164
+       */
+      async getProviderProfile() {
+        try {
+          const { getProviderHookProfile } = await import("@cleocode/caamp");
+          return getProviderHookProfile(PROVIDER_ID3) ?? null;
+        } catch {
+          return null;
+        }
+      }
+      /**
+       * Translate a CAAMP canonical event to its OpenCode native name via CAAMP.
+       *
+       * Calls `toNative(canonical, 'opencode')` from the CAAMP normalizer.
+       * Returns null for unsupported events or when CAAMP is unavailable.
+       *
+       * @param canonical - CAAMP canonical event name (e.g. "PreToolUse")
+       * @returns OpenCode native event name or null
+       * @task T164
+       */
+      async toNativeEvent(canonical) {
+        try {
+          const { toNative } = await import("@cleocode/caamp");
+          return toNative(canonical, PROVIDER_ID3);
+        } catch {
+          const entry = Object.entries(OPENCODE_EVENT_MAP).find(([, v]) => v === canonical);
+          return entry?.[0] ?? null;
+        }
+      }
     };
   }
 });
 
-// packages/adapters/src/providers/opencode/install.js
-import { existsSync as existsSync13, mkdirSync as mkdirSync6, readFileSync as readFileSync8, writeFileSync as writeFileSync7 } from "node:fs";
-import { join as join18 } from "node:path";
-var INSTRUCTION_REFERENCES6, MCP_SERVER_KEY6, OpenCodeInstallProvider;
+// packages/adapters/src/providers/opencode/install.ts
+import { existsSync as existsSync13, readFileSync as readFileSync8, writeFileSync as writeFileSync7 } from "node:fs";
+import { join as join19 } from "node:path";
+var INSTRUCTION_REFERENCES6, OpenCodeInstallProvider;
 var init_install3 = __esm({
-  "packages/adapters/src/providers/opencode/install.js"() {
+  "packages/adapters/src/providers/opencode/install.ts"() {
     "use strict";
     INSTRUCTION_REFERENCES6 = ["@~/.cleo/templates/CLEO-INJECTION.md", "@.cleo/memory-bridge.md"];
-    MCP_SERVER_KEY6 = "cleo";
     OpenCodeInstallProvider = class {
-      installedProjectDir = null;
       /**
        * Install CLEO into an OpenCode project.
        *
-       * @param options - Installation options including project directory and MCP server path
+       * @param options - Installation options including project directory
        * @returns Result describing what was installed
        */
       async install(options) {
-        const { projectDir, mcpServerPath } = options;
+        const { projectDir } = options;
         const installedAt = (/* @__PURE__ */ new Date()).toISOString();
         let instructionFileUpdated = false;
-        let mcpRegistered = false;
         const details = {};
-        if (mcpServerPath) {
-          mcpRegistered = this.registerMcpServer(projectDir, mcpServerPath);
-          if (mcpRegistered) {
-            details.mcpConfigPath = join18(projectDir, ".opencode", "config.json");
-          }
-        }
         instructionFileUpdated = this.updateInstructionFile(projectDir);
         if (instructionFileUpdated) {
-          details.instructionFile = join18(projectDir, "AGENTS.md");
+          details.instructionFile = join19(projectDir, "AGENTS.md");
         }
-        this.installedProjectDir = projectDir;
         return {
           success: true,
           installedAt,
           instructionFileUpdated,
-          mcpRegistered,
+          mcpRegistered: false,
           details
         };
       }
       /**
        * Uninstall CLEO from the current OpenCode project.
        *
-       * Removes the MCP server registration from .opencode/config.json.
        * Does not remove AGENTS.md references (they are harmless if CLEO is not present).
        */
       async uninstall() {
-        if (!this.installedProjectDir)
-          return;
-        const configPath = join18(this.installedProjectDir, ".opencode", "config.json");
-        if (existsSync13(configPath)) {
-          try {
-            const raw = readFileSync8(configPath, "utf-8");
-            const config = JSON.parse(raw);
-            const mcpServers = config.mcpServers;
-            if (mcpServers && MCP_SERVER_KEY6 in mcpServers) {
-              delete mcpServers[MCP_SERVER_KEY6];
-              writeFileSync7(configPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
-            }
-          } catch {
-          }
-        }
-        this.installedProjectDir = null;
       }
       /**
        * Check whether CLEO is installed in the current environment.
        *
-       * Checks for MCP server registered in .opencode/config.json.
-       * Returns true if the CLEO MCP server entry is found.
+       * Checks for CLEO references in AGENTS.md.
        */
       async isInstalled() {
-        const configPath = join18(process.cwd(), ".opencode", "config.json");
-        if (existsSync13(configPath)) {
+        const agentsMdPath = join19(process.cwd(), "AGENTS.md");
+        if (existsSync13(agentsMdPath)) {
           try {
-            const config = JSON.parse(readFileSync8(configPath, "utf-8"));
-            const mcpServers = config.mcpServers;
-            if (mcpServers && MCP_SERVER_KEY6 in mcpServers) {
+            const content = readFileSync8(agentsMdPath, "utf-8");
+            if (INSTRUCTION_REFERENCES6.some((ref) => content.includes(ref))) {
               return true;
             }
           } catch {
@@ -1615,43 +1861,13 @@ var init_install3 = __esm({
       async ensureInstructionReferences(projectDir) {
         this.updateInstructionFile(projectDir);
       }
-      /**
-       * Register the CLEO MCP server in .opencode/config.json.
-       *
-       * OpenCode stores its MCP server configuration in .opencode/config.json
-       * under the mcpServers key.
-       *
-       * @returns true if registration was performed or updated
-       */
-      registerMcpServer(projectDir, mcpServerPath) {
-        const openCodeDir = join18(projectDir, ".opencode");
-        const configPath = join18(openCodeDir, "config.json");
-        let config = {};
-        mkdirSync6(openCodeDir, { recursive: true });
-        if (existsSync13(configPath)) {
-          try {
-            config = JSON.parse(readFileSync8(configPath, "utf-8"));
-          } catch {
-          }
-        }
-        if (!config.mcpServers || typeof config.mcpServers !== "object") {
-          config.mcpServers = {};
-        }
-        const mcpServers = config.mcpServers;
-        mcpServers[MCP_SERVER_KEY6] = {
-          command: "node",
-          args: [mcpServerPath]
-        };
-        writeFileSync7(configPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
-        return true;
-      }
       /**
        * Update AGENTS.md with CLEO @-references.
        *
        * @returns true if the file was created or modified
        */
       updateInstructionFile(projectDir) {
-        const agentsMdPath = join18(projectDir, "AGENTS.md");
+        const agentsMdPath = join19(projectDir, "AGENTS.md");
         let content = "";
         let existed = false;
         if (existsSync13(agentsMdPath)) {
@@ -1676,10 +1892,10 @@ var init_install3 = __esm({
   }
 });
 
-// packages/adapters/src/providers/opencode/spawn.js
+// packages/adapters/src/providers/opencode/spawn.ts
 import { exec as exec6, spawn as nodeSpawn2 } from "node:child_process";
-import { mkdir as mkdir2, readFile as readFile3, writeFile as writeFile2 } from "node:fs/promises";
-import { join as join19 } from "node:path";
+import { mkdir as mkdir2, readFile as readFile4, writeFile as writeFile2 } from "node:fs/promises";
+import { join as join20 } from "node:path";
 import { promisify as promisify6 } from "node:util";
 function buildOpenCodeAgentMarkdown(description, instructions) {
   const normalizedDesc = description.replace(/\s+/g, " ").trim();
@@ -1695,8 +1911,8 @@ function buildOpenCodeAgentMarkdown(description, instructions) {
   ].join("\n");
 }
 async function ensureSubagentDefinition(workingDirectory) {
-  const agentDir = join19(workingDirectory, ".opencode", "agent");
-  const agentPath = join19(agentDir, `${OPENCODE_SUBAGENT_NAME}.md`);
+  const agentDir = join20(workingDirectory, ".opencode", "agent");
+  const agentPath = join20(agentDir, `${OPENCODE_SUBAGENT_NAME}.md`);
   const description = "CLEO task executor with protocol compliance.";
   const instructions = [
     "# CLEO Subagent",
@@ -1710,7 +1926,7 @@ async function ensureSubagentDefinition(workingDirectory) {
   await mkdir2(agentDir, { recursive: true });
   let existing = null;
   try {
-    existing = await readFile3(agentPath, "utf-8");
+    existing = await readFile4(agentPath, "utf-8");
   } catch {
     existing = null;
   }
@@ -1721,7 +1937,7 @@ async function ensureSubagentDefinition(workingDirectory) {
 }
 var execAsync6, OPENCODE_SUBAGENT_NAME, OPENCODE_FALLBACK_AGENT, OpenCodeSpawnProvider;
 var init_spawn2 = __esm({
-  "packages/adapters/src/providers/opencode/spawn.js"() {
+  "packages/adapters/src/providers/opencode/spawn.ts"() {
     "use strict";
     execAsync6 = promisify6(exec6);
     OPENCODE_SUBAGENT_NAME = "cleo-subagent";
@@ -1763,20 +1979,24 @@ var init_spawn2 = __esm({
           } catch {
             agentName = OPENCODE_FALLBACK_AGENT;
           }
-          const child = nodeSpawn2("opencode", [
-            "run",
-            "--format",
-            "json",
-            "--agent",
-            agentName,
-            "--title",
-            `CLEO ${context.taskId}`,
-            context.prompt
-          ], {
-            cwd: workingDirectory,
-            detached: true,
-            stdio: "ignore"
-          });
+          const child = nodeSpawn2(
+            "opencode",
+            [
+              "run",
+              "--format",
+              "json",
+              "--agent",
+              agentName,
+              "--title",
+              `CLEO ${context.taskId}`,
+              context.prompt
+            ],
+            {
+              cwd: workingDirectory,
+              detached: true,
+              stdio: "ignore"
+            }
+          );
           child.unref();
           if (child.pid) {
             this.processMap.set(instanceId, {
@@ -1842,8 +2062,7 @@ var init_spawn2 = __esm({
        */
       async terminate(instanceId) {
         const tracked = this.processMap.get(instanceId);
-        if (!tracked)
-          return;
+        if (!tracked) return;
         try {
           process.kill(tracked.pid, "SIGTERM");
         } catch {
@@ -1854,36 +2073,47 @@ var init_spawn2 = __esm({
   }
 });
 
-// packages/adapters/src/providers/opencode/adapter.js
+// packages/adapters/src/providers/opencode/adapter.ts
 import { exec as exec7 } from "node:child_process";
 import { existsSync as existsSync14 } from "node:fs";
-import { join as join20 } from "node:path";
+import { join as join21 } from "node:path";
 import { promisify as promisify7 } from "node:util";
 var execAsync7, OpenCodeAdapter;
 var init_adapter3 = __esm({
-  "packages/adapters/src/providers/opencode/adapter.js"() {
+  "packages/adapters/src/providers/opencode/adapter.ts"() {
     "use strict";
     init_hooks3();
     init_install3();
     init_spawn2();
     execAsync7 = promisify7(exec7);
     OpenCodeAdapter = class {
+      /** Unique provider identifier. */
       id = "opencode";
+      /** Human-readable provider name. */
       name = "OpenCode";
+      /** Adapter version string. */
       version = "1.0.0";
+      /** Declared capabilities for this provider. */
       capabilities = {
         supportsHooks: true,
+        // 10/16 canonical events — derived from getProviderHookProfile('opencode') in CAAMP 1.9.1.
+        // PostToolUseFailure, SubagentStart, SubagentStop, Notification, ConfigChange are
+        // not supported by OpenCode's plugin system.
         supportedHookEvents: [
-          "onSessionStart",
-          "onSessionEnd",
-          "onToolStart",
-          "onToolComplete",
-          "onError",
-          "onPromptSubmit"
+          "SessionStart",
+          "SessionEnd",
+          "PromptSubmit",
+          "ResponseComplete",
+          "PreToolUse",
+          "PostToolUse",
+          "PermissionRequest",
+          "PreModel",
+          "PreCompact",
+          "PostCompact"
         ],
         supportsSpawn: true,
         supportsInstall: true,
-        supportsMcp: true,
+        supportsMcp: false,
         supportsInstructionFiles: true,
         instructionFilePattern: "AGENTS.md",
         supportsContextMonitor: false,
@@ -1892,10 +2122,15 @@ var init_adapter3 = __esm({
         supportsTransport: false,
         supportsTaskSync: false
       };
+      /** Hook provider for CAAMP event mapping via OpenCode's plugin system. */
       hooks;
+      /** Spawn provider for launching subagent processes via `opencode run`. */
       spawn;
+      /** Install provider for managing AGENTS.md instruction files. */
       install;
+      /** Project directory this adapter was initialized with, or null. */
       projectDir = null;
+      /** Whether {@link initialize} has been called. */
       initialized = false;
       constructor() {
         this.hooks = new OpenCodeHookProvider();
@@ -1954,7 +2189,7 @@ var init_adapter3 = __esm({
           details.cliAvailable = false;
         }
         if (this.projectDir) {
-          const openCodeConfigDir = join20(this.projectDir, ".opencode");
+          const openCodeConfigDir = join21(this.projectDir, ".opencode");
           const configExists = existsSync14(openCodeConfigDir);
           details.configDirExists = configExists;
         }
@@ -1984,7 +2219,7 @@ var init_adapter3 = __esm({
   }
 });
 
-// packages/adapters/src/providers/opencode/index.js
+// packages/adapters/src/providers/opencode/index.ts
 var opencode_exports = {};
 __export(opencode_exports, {
   OpenCodeAdapter: () => OpenCodeAdapter,
@@ -1999,7 +2234,7 @@ function createAdapter6() {
 }
 var opencode_default;
 var init_opencode = __esm({
-  "packages/adapters/src/providers/opencode/index.js"() {
+  "packages/adapters/src/providers/opencode/index.ts"() {
     "use strict";
     init_adapter3();
     init_adapter3();
@@ -2016,17 +2251,17 @@ init_claude_code();
 // packages/adapters/src/providers/codex/adapter.ts
 import { exec as exec3 } from "node:child_process";
 import { existsSync as existsSync6 } from "node:fs";
-import { homedir as homedir8 } from "node:os";
-import { join as join10 } from "node:path";
+import { homedir as homedir7 } from "node:os";
+import { join as join11 } from "node:path";
 import { promisify as promisify3 } from "node:util";
 
 // packages/adapters/src/providers/codex/hooks.ts
 import { homedir as homedir6 } from "node:os";
-import { join as join8 } from "node:path";
+import { join as join9 } from "node:path";
 
 // packages/adapters/src/providers/shared/transcript-reader.ts
-import { readdir, readFile as readFile2 } from "node:fs/promises";
-import { join as join7 } from "node:path";
+import { readdir as readdir2, readFile as readFile3 } from "node:fs/promises";
+import { join as join8 } from "node:path";
 function parseTranscriptLines(raw) {
   const turns = [];
   const lines = raw.split("\n").filter((l) => l.trim());
@@ -2046,12 +2281,12 @@ function parseTranscriptLines(raw) {
 async function readLatestTranscript(providerDir) {
   let allFiles = [];
   try {
-    const entries = await readdir(providerDir, { withFileTypes: true });
+    const entries = await readdir2(providerDir, { withFileTypes: true });
     for (const entry of entries) {
       if (!entry.isFile()) continue;
       const name = entry.name;
       if (name.endsWith(".json") || name.endsWith(".jsonl")) {
-        allFiles.push(join7(providerDir, name));
+        allFiles.push(join8(providerDir, name));
       }
     }
   } catch {
@@ -2062,7 +2297,7 @@ async function readLatestTranscript(providerDir) {
   const mostRecent = allFiles[0];
   if (!mostRecent) return null;
   try {
-    const raw = await readFile2(mostRecent, "utf-8");
+    const raw = await readFile3(mostRecent, "utf-8");
     const turns = parseTranscriptLines(raw);
     return turns.length > 0 ? turns.map((t) => `${t.role}: ${t.content}`).join("\n") : null;
   } catch {
@@ -2077,6 +2312,7 @@ var CODEX_EVENT_MAP = {
   ResponseComplete: "Stop"
 };
 var CodexHookProvider = class {
+  /** Whether hooks have been registered for the current session. */
   registered = false;
   /**
    * Map a Codex CLI native event name to a CAAMP hook event name.
@@ -2140,84 +2376,59 @@ var CodexHookProvider = class {
    * @task T162 @epic T134
    */
   async getTranscript(_sessionId, _projectDir) {
-    return readLatestTranscript(join8(homedir6(), ".codex"));
+    return readLatestTranscript(join9(homedir6(), ".codex"));
   }
 };
 
 // packages/adapters/src/providers/codex/install.ts
-import { existsSync as existsSync5, mkdirSync as mkdirSync2, readFileSync as readFileSync4, writeFileSync as writeFileSync3 } from "node:fs";
-import { homedir as homedir7 } from "node:os";
-import { join as join9 } from "node:path";
+import { existsSync as existsSync5, readFileSync as readFileSync4, writeFileSync as writeFileSync3 } from "node:fs";
+import { join as join10 } from "node:path";
 var INSTRUCTION_REFERENCES2 = ["@~/.cleo/templates/CLEO-INJECTION.md", "@.cleo/memory-bridge.md"];
-var MCP_SERVER_KEY2 = "cleo";
 var CodexInstallProvider = class {
   /**
    * Install CLEO into a Codex CLI environment.
    *
-   * @param options - Installation options including project directory and MCP server path
+   * @param options - Installation options including project directory
    * @returns Result describing what was installed
    * @task T162
    */
   async install(options) {
-    const { projectDir, mcpServerPath } = options;
+    const { projectDir } = options;
     const installedAt = (/* @__PURE__ */ new Date()).toISOString();
     let instructionFileUpdated = false;
-    let mcpRegistered = false;
     const details = {};
-    if (mcpServerPath) {
-      mcpRegistered = this.registerMcpServer(mcpServerPath);
-      if (mcpRegistered) {
-        details.mcpConfigPath = join9(homedir7(), ".codex", "config.json");
-      }
-    }
     instructionFileUpdated = this.updateInstructionFile(projectDir);
     if (instructionFileUpdated) {
-      details.instructionFile = join9(projectDir, "AGENTS.md");
+      details.instructionFile = join10(projectDir, "AGENTS.md");
     }
     return {
       success: true,
       installedAt,
       instructionFileUpdated,
-      mcpRegistered,
+      mcpRegistered: false,
       details
     };
   }
   /**
    * Uninstall CLEO from the Codex CLI environment.
    *
-   * Removes the MCP server registration from ~/.codex/config.json.
    * Does not remove AGENTS.md references (they are harmless if CLEO is not present).
    * @task T162
    */
   async uninstall() {
-    const configPath = join9(homedir7(), ".codex", "config.json");
-    if (existsSync5(configPath)) {
-      try {
-        const raw = readFileSync4(configPath, "utf-8");
-        const config = JSON.parse(raw);
-        const mcpServers = config.mcpServers;
-        if (mcpServers && MCP_SERVER_KEY2 in mcpServers) {
-          delete mcpServers[MCP_SERVER_KEY2];
-          writeFileSync3(configPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
-        }
-      } catch {
-      }
-    }
   }
   /**
    * Check whether CLEO is installed in the Codex CLI environment.
    *
-   * Checks for MCP server registered in ~/.codex/config.json.
-   * Returns true if the CLEO MCP server entry is found.
+   * Checks for CLEO references in AGENTS.md.
    * @task T162
    */
   async isInstalled() {
-    const configPath = join9(homedir7(), ".codex", "config.json");
-    if (existsSync5(configPath)) {
+    const agentsMdPath = join10(process.cwd(), "AGENTS.md");
+    if (existsSync5(agentsMdPath)) {
       try {
-        const config = JSON.parse(readFileSync4(configPath, "utf-8"));
-        const mcpServers = config.mcpServers;
-        if (mcpServers && MCP_SERVER_KEY2 in mcpServers) {
+        const content = readFileSync4(agentsMdPath, "utf-8");
+        if (INSTRUCTION_REFERENCES2.some((ref) => content.includes(ref))) {
           return true;
         }
       } catch {
@@ -2236,37 +2447,6 @@ var CodexInstallProvider = class {
   async ensureInstructionReferences(projectDir) {
     this.updateInstructionFile(projectDir);
   }
-  /**
-   * Register the CLEO MCP server in ~/.codex/config.json.
-   *
-   * Codex CLI stores its MCP server configuration in ~/.codex/config.json
-   * under the mcpServers key.
-   *
-   * @param mcpServerPath - Absolute path to the MCP server entry point
-   * @returns true if registration was performed or updated
-   */
-  registerMcpServer(mcpServerPath) {
-    const codexDir = join9(homedir7(), ".codex");
-    const configPath = join9(codexDir, "config.json");
-    let config = {};
-    mkdirSync2(codexDir, { recursive: true });
-    if (existsSync5(configPath)) {
-      try {
-        config = JSON.parse(readFileSync4(configPath, "utf-8"));
-      } catch {
-      }
-    }
-    if (!config.mcpServers || typeof config.mcpServers !== "object") {
-      config.mcpServers = {};
-    }
-    const mcpServers = config.mcpServers;
-    mcpServers[MCP_SERVER_KEY2] = {
-      command: "node",
-      args: [mcpServerPath]
-    };
-    writeFileSync3(configPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
-    return true;
-  }
   /**
    * Update AGENTS.md with CLEO @-references.
    *
@@ -2274,7 +2454,7 @@ var CodexInstallProvider = class {
    * @returns true if the file was created or modified
    */
   updateInstructionFile(projectDir) {
-    const agentsMdPath = join9(projectDir, "AGENTS.md");
+    const agentsMdPath = join10(projectDir, "AGENTS.md");
     let content = "";
     let existed = false;
     if (existsSync5(agentsMdPath)) {
@@ -2300,15 +2480,19 @@ var CodexInstallProvider = class {
 // packages/adapters/src/providers/codex/adapter.ts
 var execAsync3 = promisify3(exec3);
 var CodexAdapter = class {
+  /** Unique provider identifier. */
   id = "codex";
+  /** Human-readable provider name. */
   name = "Codex";
+  /** Adapter version string. */
   version = "1.0.0";
+  /** Declared capabilities for this provider. */
   capabilities = {
     supportsHooks: true,
     supportedHookEvents: ["SessionStart", "UserPromptSubmit", "Stop"],
     supportsSpawn: false,
     supportsInstall: true,
-    supportsMcp: true,
+    supportsMcp: false,
     supportsInstructionFiles: false,
     supportsContextMonitor: false,
     supportsStatusline: false,
@@ -2316,9 +2500,13 @@ var CodexAdapter = class {
     supportsTransport: false,
     supportsTaskSync: false
   };
+  /** Hook provider for CAAMP event mapping. */
   hooks;
+  /** Install provider for managing instruction files. */
   install;
+  /** Project directory this adapter was initialized with, or null. */
   projectDir = null;
+  /** Whether {@link initialize} has been called. */
   initialized = false;
   constructor() {
     this.hooks = new CodexHookProvider();
@@ -2375,7 +2563,7 @@ var CodexAdapter = class {
     } catch {
       details.cliAvailable = false;
     }
-    const codexConfigDir = join10(homedir8(), ".codex");
+    const codexConfigDir = join11(homedir7(), ".codex");
     const configExists = existsSync6(codexConfigDir);
     details.configDirExists = configExists;
     const healthy = cliAvailable;
@@ -2413,13 +2601,13 @@ init_cursor();
 // packages/adapters/src/providers/gemini-cli/adapter.ts
 import { exec as exec4 } from "node:child_process";
 import { existsSync as existsSync10 } from "node:fs";
-import { homedir as homedir11 } from "node:os";
-import { join as join15 } from "node:path";
+import { homedir as homedir9 } from "node:os";
+import { join as join16 } from "node:path";
 import { promisify as promisify4 } from "node:util";
 
 // packages/adapters/src/providers/gemini-cli/hooks.ts
-import { homedir as homedir9 } from "node:os";
-import { join as join13 } from "node:path";
+import { homedir as homedir8 } from "node:os";
+import { join as join14 } from "node:path";
 var GEMINI_CLI_EVENT_MAP = {
   SessionStart: "SessionStart",
   SessionEnd: "SessionEnd",
@@ -2433,6 +2621,7 @@ var GEMINI_CLI_EVENT_MAP = {
   Notification: "Notification"
 };
 var GeminiCliHookProvider = class {
+  /** Whether hooks have been registered for the current session. */
   registered = false;
   /**
    * Map a Gemini CLI native event name to a CAAMP hook event name.
@@ -2496,84 +2685,59 @@ var GeminiCliHookProvider = class {
    * @task T161 @epic T134
    */
   async getTranscript(_sessionId, _projectDir) {
-    return readLatestTranscript(join13(homedir9(), ".gemini"));
+    return readLatestTranscript(join14(homedir8(), ".gemini"));
   }
 };
 
 // packages/adapters/src/providers/gemini-cli/install.ts
-import { existsSync as existsSync9, mkdirSync as mkdirSync4, readFileSync as readFileSync6, writeFileSync as writeFileSync5 } from "node:fs";
-import { homedir as homedir10 } from "node:os";
-import { join as join14 } from "node:path";
+import { existsSync as existsSync9, readFileSync as readFileSync6, writeFileSync as writeFileSync5 } from "node:fs";
+import { join as join15 } from "node:path";
 var INSTRUCTION_REFERENCES4 = ["@~/.cleo/templates/CLEO-INJECTION.md", "@.cleo/memory-bridge.md"];
-var MCP_SERVER_KEY4 = "cleo";
 var GeminiCliInstallProvider = class {
   /**
    * Install CLEO into a Gemini CLI environment.
    *
-   * @param options - Installation options including project directory and MCP server path
+   * @param options - Installation options including project directory
    * @returns Result describing what was installed
    * @task T161
    */
   async install(options) {
-    const { projectDir, mcpServerPath } = options;
+    const { projectDir } = options;
     const installedAt = (/* @__PURE__ */ new Date()).toISOString();
     let instructionFileUpdated = false;
-    let mcpRegistered = false;
     const details = {};
-    if (mcpServerPath) {
-      mcpRegistered = this.registerMcpServer(mcpServerPath);
-      if (mcpRegistered) {
-        details.mcpConfigPath = join14(homedir10(), ".gemini", "settings.json");
-      }
-    }
     instructionFileUpdated = this.updateInstructionFile(projectDir);
     if (instructionFileUpdated) {
-      details.instructionFile = join14(projectDir, "AGENTS.md");
+      details.instructionFile = join15(projectDir, "AGENTS.md");
     }
     return {
       success: true,
       installedAt,
       instructionFileUpdated,
-      mcpRegistered,
+      mcpRegistered: false,
       details
     };
   }
   /**
    * Uninstall CLEO from the Gemini CLI environment.
    *
-   * Removes the MCP server registration from ~/.gemini/settings.json.
    * Does not remove AGENTS.md references (they are harmless if CLEO is not present).
    * @task T161
    */
   async uninstall() {
-    const settingsPath = join14(homedir10(), ".gemini", "settings.json");
-    if (existsSync9(settingsPath)) {
-      try {
-        const raw = readFileSync6(settingsPath, "utf-8");
-        const config = JSON.parse(raw);
-        const mcpServers = config.mcpServers;
-        if (mcpServers && MCP_SERVER_KEY4 in mcpServers) {
-          delete mcpServers[MCP_SERVER_KEY4];
-          writeFileSync5(settingsPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
-        }
-      } catch {
-      }
-    }
   }
   /**
    * Check whether CLEO is installed in the Gemini CLI environment.
    *
-   * Checks for MCP server registered in ~/.gemini/settings.json.
-   * Returns true if the CLEO MCP server entry is found.
+   * Checks for CLEO references in AGENTS.md.
    * @task T161
    */
   async isInstalled() {
-    const settingsPath = join14(homedir10(), ".gemini", "settings.json");
-    if (existsSync9(settingsPath)) {
+    const agentsMdPath = join15(process.cwd(), "AGENTS.md");
+    if (existsSync9(agentsMdPath)) {
       try {
-        const config = JSON.parse(readFileSync6(settingsPath, "utf-8"));
-        const mcpServers = config.mcpServers;
-        if (mcpServers && MCP_SERVER_KEY4 in mcpServers) {
+        const content = readFileSync6(agentsMdPath, "utf-8");
+        if (INSTRUCTION_REFERENCES4.some((ref) => content.includes(ref))) {
           return true;
         }
       } catch {
@@ -2592,37 +2756,6 @@ var GeminiCliInstallProvider = class {
   async ensureInstructionReferences(projectDir) {
     this.updateInstructionFile(projectDir);
   }
-  /**
-   * Register the CLEO MCP server in ~/.gemini/settings.json.
-   *
-   * Gemini CLI stores its MCP server configuration in ~/.gemini/settings.json
-   * under the mcpServers key.
-   *
-   * @param mcpServerPath - Absolute path to the MCP server entry point
-   * @returns true if registration was performed or updated
-   */
-  registerMcpServer(mcpServerPath) {
-    const geminiDir = join14(homedir10(), ".gemini");
-    const settingsPath = join14(geminiDir, "settings.json");
-    let config = {};
-    mkdirSync4(geminiDir, { recursive: true });
-    if (existsSync9(settingsPath)) {
-      try {
-        config = JSON.parse(readFileSync6(settingsPath, "utf-8"));
-      } catch {
-      }
-    }
-    if (!config.mcpServers || typeof config.mcpServers !== "object") {
-      config.mcpServers = {};
-    }
-    const mcpServers = config.mcpServers;
-    mcpServers[MCP_SERVER_KEY4] = {
-      command: "node",
-      args: [mcpServerPath]
-    };
-    writeFileSync5(settingsPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
-    return true;
-  }
   /**
    * Update AGENTS.md with CLEO @-references.
    *
@@ -2630,7 +2763,7 @@ var GeminiCliInstallProvider = class {
    * @returns true if the file was created or modified
    */
   updateInstructionFile(projectDir) {
-    const agentsMdPath = join14(projectDir, "AGENTS.md");
+    const agentsMdPath = join15(projectDir, "AGENTS.md");
     let content = "";
     let existed = false;
     if (existsSync9(agentsMdPath)) {
@@ -2656,9 +2789,13 @@ var GeminiCliInstallProvider = class {
 // packages/adapters/src/providers/gemini-cli/adapter.ts
 var execAsync4 = promisify4(exec4);
 var GeminiCliAdapter = class {
+  /** Unique provider identifier. */
   id = "gemini-cli";
+  /** Human-readable provider name. */
   name = "Gemini CLI";
+  /** Adapter version string. */
   version = "1.0.0";
+  /** Declared capabilities for this provider. */
   capabilities = {
     supportsHooks: true,
     supportedHookEvents: [
@@ -2675,7 +2812,7 @@ var GeminiCliAdapter = class {
     ],
     supportsSpawn: false,
     supportsInstall: true,
-    supportsMcp: true,
+    supportsMcp: false,
     supportsInstructionFiles: false,
     supportsContextMonitor: false,
     supportsStatusline: false,
@@ -2683,9 +2820,13 @@ var GeminiCliAdapter = class {
     supportsTransport: false,
     supportsTaskSync: false
   };
+  /** Hook provider for CAAMP event mapping. */
   hooks;
+  /** Install provider for managing instruction files. */
   install;
+  /** Project directory this adapter was initialized with, or null. */
   projectDir = null;
+  /** Whether {@link initialize} has been called. */
   initialized = false;
   constructor() {
     this.hooks = new GeminiCliHookProvider();
@@ -2742,7 +2883,7 @@ var GeminiCliAdapter = class {
     } catch {
       details.cliAvailable = false;
     }
-    const geminiConfigDir = join15(homedir11(), ".gemini");
+    const geminiConfigDir = join16(homedir9(), ".gemini");
     const configExists = existsSync10(geminiConfigDir);
     details.configDirExists = configExists;
     const healthy = cliAvailable;
@@ -2777,12 +2918,13 @@ function createAdapter4() {
 // packages/adapters/src/providers/kimi/adapter.ts
 import { exec as exec5 } from "node:child_process";
 import { existsSync as existsSync12 } from "node:fs";
-import { homedir as homedir13 } from "node:os";
-import { join as join17 } from "node:path";
+import { homedir as homedir10 } from "node:os";
+import { join as join18 } from "node:path";
 import { promisify as promisify5 } from "node:util";
 
 // packages/adapters/src/providers/kimi/hooks.ts
 var KimiHookProvider = class {
+  /** Whether hooks have been registered (always a no-op for Kimi). */
   registered = false;
   /**
    * Map a Kimi native event name to a CAAMP hook event name.
@@ -2836,79 +2978,54 @@ var KimiHookProvider = class {
 };
 
 // packages/adapters/src/providers/kimi/install.ts
-import { existsSync as existsSync11, mkdirSync as mkdirSync5, readFileSync as readFileSync7, writeFileSync as writeFileSync6 } from "node:fs";
-import { homedir as homedir12 } from "node:os";
-import { join as join16 } from "node:path";
+import { existsSync as existsSync11, readFileSync as readFileSync7, writeFileSync as writeFileSync6 } from "node:fs";
+import { join as join17 } from "node:path";
 var INSTRUCTION_REFERENCES5 = ["@~/.cleo/templates/CLEO-INJECTION.md", "@.cleo/memory-bridge.md"];
-var MCP_SERVER_KEY5 = "cleo";
 var KimiInstallProvider = class {
   /**
    * Install CLEO into a Kimi environment.
    *
-   * @param options - Installation options including project directory and MCP server path
+   * @param options - Installation options including project directory
    * @returns Result describing what was installed
    * @task T163
    */
   async install(options) {
-    const { projectDir, mcpServerPath } = options;
+    const { projectDir } = options;
     const installedAt = (/* @__PURE__ */ new Date()).toISOString();
     let instructionFileUpdated = false;
-    let mcpRegistered = false;
     const details = {};
-    if (mcpServerPath) {
-      mcpRegistered = this.registerMcpServer(mcpServerPath);
-      if (mcpRegistered) {
-        details.mcpConfigPath = join16(homedir12(), ".kimi", "mcp.json");
-      }
-    }
     instructionFileUpdated = this.updateInstructionFile(projectDir);
     if (instructionFileUpdated) {
-      details.instructionFile = join16(projectDir, "AGENTS.md");
+      details.instructionFile = join17(projectDir, "AGENTS.md");
     }
     return {
       success: true,
       installedAt,
       instructionFileUpdated,
-      mcpRegistered,
+      mcpRegistered: false,
       details
     };
   }
   /**
    * Uninstall CLEO from the Kimi environment.
    *
-   * Removes the MCP server registration from ~/.kimi/mcp.json.
    * Does not remove AGENTS.md references (they are harmless if CLEO is not present).
    * @task T163
    */
   async uninstall() {
-    const mcpPath = join16(homedir12(), ".kimi", "mcp.json");
-    if (existsSync11(mcpPath)) {
-      try {
-        const raw = readFileSync7(mcpPath, "utf-8");
-        const config = JSON.parse(raw);
-        const mcpServers = config.mcpServers;
-        if (mcpServers && MCP_SERVER_KEY5 in mcpServers) {
-          delete mcpServers[MCP_SERVER_KEY5];
-          writeFileSync6(mcpPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
-        }
-      } catch {
-      }
-    }
   }
   /**
    * Check whether CLEO is installed in the Kimi environment.
    *
-   * Checks for MCP server registered in ~/.kimi/mcp.json.
-   * Returns true if the CLEO MCP server entry is found.
+   * Checks for CLEO references in AGENTS.md.
    * @task T163
    */
   async isInstalled() {
-    const mcpPath = join16(homedir12(), ".kimi", "mcp.json");
-    if (existsSync11(mcpPath)) {
+    const agentsMdPath = join17(process.cwd(), "AGENTS.md");
+    if (existsSync11(agentsMdPath)) {
       try {
-        const config = JSON.parse(readFileSync7(mcpPath, "utf-8"));
-        const mcpServers = config.mcpServers;
-        if (mcpServers && MCP_SERVER_KEY5 in mcpServers) {
+        const content = readFileSync7(agentsMdPath, "utf-8");
+        if (INSTRUCTION_REFERENCES5.some((ref) => content.includes(ref))) {
           return true;
         }
       } catch {
@@ -2927,37 +3044,6 @@ var KimiInstallProvider = class {
   async ensureInstructionReferences(projectDir) {
     this.updateInstructionFile(projectDir);
   }
-  /**
-   * Register the CLEO MCP server in ~/.kimi/mcp.json.
-   *
-   * Kimi stores its MCP server configuration in ~/.kimi/mcp.json
-   * under the mcpServers key.
-   *
-   * @param mcpServerPath - Absolute path to the MCP server entry point
-   * @returns true if registration was performed or updated
-   */
-  registerMcpServer(mcpServerPath) {
-    const kimiDir = join16(homedir12(), ".kimi");
-    const mcpPath = join16(kimiDir, "mcp.json");
-    let config = {};
-    mkdirSync5(kimiDir, { recursive: true });
-    if (existsSync11(mcpPath)) {
-      try {
-        config = JSON.parse(readFileSync7(mcpPath, "utf-8"));
-      } catch {
-      }
-    }
-    if (!config.mcpServers || typeof config.mcpServers !== "object") {
-      config.mcpServers = {};
-    }
-    const mcpServers = config.mcpServers;
-    mcpServers[MCP_SERVER_KEY5] = {
-      command: "node",
-      args: [mcpServerPath]
-    };
-    writeFileSync6(mcpPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
-    return true;
-  }
   /**
    * Update AGENTS.md with CLEO @-references.
    *
@@ -2965,7 +3051,7 @@ var KimiInstallProvider = class {
    * @returns true if the file was created or modified
    */
   updateInstructionFile(projectDir) {
-    const agentsMdPath = join16(projectDir, "AGENTS.md");
+    const agentsMdPath = join17(projectDir, "AGENTS.md");
     let content = "";
     let existed = false;
     if (existsSync11(agentsMdPath)) {
@@ -2991,15 +3077,19 @@ var KimiInstallProvider = class {
 // packages/adapters/src/providers/kimi/adapter.ts
 var execAsync5 = promisify5(exec5);
 var KimiAdapter = class {
+  /** Unique provider identifier. */
   id = "kimi";
+  /** Human-readable provider name. */
   name = "Kimi";
+  /** Adapter version string. */
   version = "1.0.0";
+  /** Declared capabilities for this provider. */
   capabilities = {
     supportsHooks: false,
     supportedHookEvents: [],
     supportsSpawn: false,
     supportsInstall: true,
-    supportsMcp: true,
+    supportsMcp: false,
     supportsInstructionFiles: false,
     supportsContextMonitor: false,
     supportsStatusline: false,
@@ -3007,9 +3097,13 @@ var KimiAdapter = class {
     supportsTransport: false,
     supportsTaskSync: false
   };
+  /** Hook provider (no-op since Kimi has no event system). */
   hooks;
+  /** Install provider for managing instruction files. */
   install;
+  /** Project directory this adapter was initialized with, or null. */
   projectDir = null;
+  /** Whether {@link initialize} has been called. */
   initialized = false;
   constructor() {
     this.hooks = new KimiHookProvider();
@@ -3064,7 +3158,7 @@ var KimiAdapter = class {
     } catch {
       details.cliAvailable = false;
     }
-    const kimiConfigDir = join17(homedir13(), ".kimi");
+    const kimiConfigDir = join18(homedir10(), ".kimi");
     const configExists = existsSync12(kimiConfigDir);
     details.configDirExists = configExists;
     const healthy = cliAvailable;
@@ -3099,9 +3193,9 @@ function createAdapter5() {
 // packages/adapters/src/index.ts
 init_opencode();
 
-// packages/adapters/src/registry.js
+// packages/adapters/src/registry.ts
 import { readFileSync as readFileSync9 } from "node:fs";
-import { dirname as dirname2, join as join21, resolve } from "node:path";
+import { dirname as dirname2, join as join22, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 var PROVIDER_IDS = ["claude-code", "opencode", "cursor"];
 function getProviderManifests() {
@@ -3109,7 +3203,7 @@ function getProviderManifests() {
   const baseDir = resolve(dirname2(fileURLToPath(import.meta.url)), "providers");
   for (const providerId of PROVIDER_IDS) {
     try {
-      const manifestPath = join21(baseDir, providerId, "manifest.json");
+      const manifestPath = join22(baseDir, providerId, "manifest.json");
       const raw = readFileSync9(manifestPath, "utf-8");
       manifests.push(JSON.parse(raw));
     } catch {