@cleocode/adapters 2026.4.0 → 2026.4.3

package/src/providers/opencode/install.ts

@@ -2,66 +2,53 @@
  * OpenCode Install Provider
  *
  * Handles CLEO installation into OpenCode environments:
- * - Registers CLEO MCP server in .opencode/config.json
  * - Ensures AGENTS.md has CLEO @-references
  *
  * @task T5240
  */
 
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
 import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cleocode/contracts';
 
 /** Lines that should appear in AGENTS.md to reference CLEO. */
 const INSTRUCTION_REFERENCES = ['@~/.cleo/templates/CLEO-INJECTION.md', '@.cleo/memory-bridge.md'];
 
-/** MCP server registration key used in OpenCode config. */
-const MCP_SERVER_KEY = 'cleo';
-
 /**
  * Install provider for OpenCode.
  *
  * Manages CLEO's integration with OpenCode by:
- * 1. Registering the CLEO MCP server in .opencode/config.json
- * 2. Ensuring AGENTS.md contains @-references to CLEO instruction files
+ * 1. Ensuring AGENTS.md contains @-references to CLEO instruction files
+ *
+ * @remarks
+ * Installation is idempotent -- running install multiple times on the same
+ * project produces the same result. Only AGENTS.md is managed; OpenCode's
+ * plugin system is handled separately by the hook provider.
  */
 export class OpenCodeInstallProvider implements AdapterInstallProvider {
-  private installedProjectDir: string | null = 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: InstallOptions): Promise<InstallResult> {
-    const { projectDir, mcpServerPath } = options;
+    const { projectDir } = options;
     const installedAt = new Date().toISOString();
     let instructionFileUpdated = false;
-    let mcpRegistered = false;
     const details: Record<string, unknown> = {};
 
-    // Step 1: Register MCP server in .opencode/config.json
-    if (mcpServerPath) {
-      mcpRegistered = this.registerMcpServer(projectDir, mcpServerPath);
-      if (mcpRegistered) {
-        details.mcpConfigPath = join(projectDir, '.opencode', 'config.json');
-      }
-    }
-
-    // Step 2: Ensure AGENTS.md has @-references
+    // Step 1: Ensure AGENTS.md has @-references
     instructionFileUpdated = this.updateInstructionFile(projectDir);
     if (instructionFileUpdated) {
       details.instructionFile = join(projectDir, 'AGENTS.md');
     }
 
-    this.installedProjectDir = projectDir;
-
     return {
       success: true,
       installedAt,
       instructionFileUpdated,
-      mcpRegistered,
+      mcpRegistered: false,
       details,
     };
   }
@@ -69,44 +56,21 @@ export class OpenCodeInstallProvider implements AdapterInstallProvider {
   /**
    * 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(): Promise<void> {
-    if (!this.installedProjectDir) return;
-
-    const configPath = join(this.installedProjectDir, '.opencode', 'config.json');
-    if (existsSync(configPath)) {
-      try {
-        const raw = readFileSync(configPath, 'utf-8');
-        const config = JSON.parse(raw) as Record<string, unknown>;
-        const mcpServers = config.mcpServers as Record<string, unknown> | undefined;
-        if (mcpServers && MCP_SERVER_KEY in mcpServers) {
-          delete mcpServers[MCP_SERVER_KEY];
-          writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
-        }
-      } catch {
-        // Ignore errors during uninstall
-      }
-    }
-
-    this.installedProjectDir = null;
-  }
+  async uninstall(): Promise<void> {}
 
   /**
    * 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(): Promise<boolean> {
-    // Check current directory for .opencode/config.json with cleo server
-    const configPath = join(process.cwd(), '.opencode', 'config.json');
-    if (existsSync(configPath)) {
+    const agentsMdPath = join(process.cwd(), 'AGENTS.md');
+    if (existsSync(agentsMdPath)) {
       try {
-        const config = JSON.parse(readFileSync(configPath, 'utf-8'));
-        const mcpServers = config.mcpServers as Record<string, unknown> | undefined;
-        if (mcpServers && MCP_SERVER_KEY in mcpServers) {
+        const content = readFileSync(agentsMdPath, 'utf-8');
+        if (INSTRUCTION_REFERENCES.some((ref) => content.includes(ref))) {
           return true;
         }
       } catch {
@@ -128,43 +92,6 @@ export class OpenCodeInstallProvider implements AdapterInstallProvider {
     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
-   */
-  private registerMcpServer(projectDir: string, mcpServerPath: string): boolean {
-    const openCodeDir = join(projectDir, '.opencode');
-    const configPath = join(openCodeDir, 'config.json');
-    let config: Record<string, unknown> = {};
-
-    mkdirSync(openCodeDir, { recursive: true });
-
-    if (existsSync(configPath)) {
-      try {
-        config = JSON.parse(readFileSync(configPath, 'utf-8'));
-      } catch {
-        // Start fresh on parse error
-      }
-    }
-
-    if (!config.mcpServers || typeof config.mcpServers !== 'object') {
-      config.mcpServers = {};
-    }
-
-    const mcpServers = config.mcpServers as Record<string, unknown>;
-    mcpServers[MCP_SERVER_KEY] = {
-      command: 'node',
-      args: [mcpServerPath],
-    };
-
-    writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
-    return true;
-  }
-
   /**
    * Update AGENTS.md with CLEO @-references.
    *

package/src/providers/opencode/manifest.json

@@ -10,7 +10,7 @@
     "supportedHookEvents": ["onSessionStart", "onSessionEnd", "onToolStart", "onToolComplete", "onError", "onPromptSubmit"],
     "supportsSpawn": true,
     "supportsInstall": true,
-    "supportsMcp": true,
+    "supportsMcp": false,
     "supportsInstructionFiles": true,
     "instructionFilePattern": "AGENTS.md",
     "supportsContextMonitor": false,

package/src/providers/opencode/spawn.ts

@@ -38,9 +38,24 @@ interface TrackedProcess {
  * OpenCode agents are defined as markdown files with YAML frontmatter
  * in the .opencode/agent/ directory.
  *
+ * @remarks
+ * The generated markdown uses YAML frontmatter with `mode: subagent`
+ * and `hidden: true` so the agent does not appear in OpenCode's
+ * interactive agent selection menu.
+ *
  * @param description - Agent description for frontmatter
  * @param instructions - Markdown instructions body
- * @returns Complete agent definition markdown
+ * @returns Complete agent definition markdown with YAML frontmatter
+ *
+ * @example
+ * ```typescript
+ * import { buildOpenCodeAgentMarkdown } from '@cleocode/adapters/providers/opencode/spawn';
+ *
+ * const md = buildOpenCodeAgentMarkdown(
+ *   'CLEO task executor',
+ *   '# Subagent\n\nExecute the delegated task.',
+ * );
+ * ```
  */
 export function buildOpenCodeAgentMarkdown(description: string, instructions: string): string {
   const normalizedDesc = description.replace(/\s+/g, ' ').trim();
@@ -103,6 +118,13 @@ async function ensureSubagentDefinition(workingDirectory: string): Promise<strin
  * Each spawn ensures a CLEO subagent definition exists, then runs
  * `opencode run --format json --agent <name> --title <title> <prompt>`
  * as a detached, unref'd child process.
+ *
+ * @remarks
+ * Before spawning, the provider ensures a `cleo-subagent` agent definition
+ * exists in `.opencode/agent/`. If the definition cannot be created, it
+ * falls back to the built-in `general` agent. Processes are tracked by
+ * instance ID in an in-memory map and verified via `kill(pid, 0)` liveness
+ * checks.
  */
 export class OpenCodeSpawnProvider implements AdapterSpawnProvider {
   /** Map of instance IDs to tracked process info. */

package/src/providers/shared/transcript-reader.ts

@@ -82,11 +82,26 @@ function parseTranscriptLines(raw: string): TranscriptTurn[] {
  * - No JSON/JSONL files are present
  * - The most recent file contains no parseable turns
  *
+ * @remarks
+ * This utility is shared by Gemini CLI and Codex CLI hook providers which
+ * both store session data in the same flat JSON/JSONL format. Only the
+ * most recent file is read to keep memory usage bounded.
+ *
  * @param providerDir - Absolute path to the provider's session directory
  *   (e.g. `~/.gemini` or `~/.codex`).
  * @returns A plain-text transcript with lines of the form `role: content`,
  *   or `null` if no transcript could be extracted.
  *
+ * @example
+ * ```typescript
+ * import { readLatestTranscript } from '../shared/transcript-reader.js';
+ *
+ * const transcript = await readLatestTranscript('/home/user/.gemini');
+ * if (transcript) {
+ *   console.log(transcript);
+ * }
+ * ```
+ *
  * @task T161
  * @epic T134
  */

package/src/registry.ts

@@ -11,18 +11,37 @@ import { readFileSync } from 'node:fs';
 import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
-/** Minimal manifest shape for provider discovery. */
+/**
+ * Minimal manifest shape for provider discovery.
+ *
+ * @remarks
+ * Each provider adapter ships a `manifest.json` in its directory under
+ * `providers/`. The registry reads these at startup to populate the
+ * adapter discovery surface. The shape is intentionally minimal -- only
+ * the fields needed for dynamic loading and detection are required.
+ */
 export interface AdapterManifest {
+  /** Unique provider identifier (e.g. "claude-code", "cursor"). */
   id: string;
+  /** Human-readable display name for the provider. */
   name: string;
+  /** Semantic version of the adapter. */
   version: string;
+  /** Short description of what the provider integrates with. */
   description: string;
+  /** Provider slug used for directory lookups. */
   provider: string;
+  /** Relative path to the adapter's entry point module. */
   entryPoint: string;
+  /** Capability flags declared by the adapter. */
   capabilities: Record<string, unknown>;
+  /** Patterns used to auto-detect the provider in a project. */
   detectionPatterns: Array<{
+    /** Detection strategy type (e.g. "file", "env"). */
     type: string;
+    /** Glob or regex pattern to match. */
     pattern: string;
+    /** Human-readable explanation of this detection rule. */
     description: string;
   }>;
 }
@@ -33,7 +52,22 @@ const PROVIDER_IDS = ['claude-code', 'opencode', 'cursor'] as const;
 /**
  * Get the manifests for all bundled provider adapters.
  *
- * @returns Array of adapter manifests
+ * @remarks
+ * Scans the known provider directories for `manifest.json` files.
+ * Providers whose manifests cannot be loaded (missing or malformed)
+ * are silently skipped.
+ *
+ * @returns Array of adapter manifests for successfully loaded providers
+ *
+ * @example
+ * ```typescript
+ * import { getProviderManifests } from '@cleocode/adapters';
+ *
+ * const manifests = getProviderManifests();
+ * for (const m of manifests) {
+ *   console.log(`${m.id}: ${m.name} v${m.version}`);
+ * }
+ * ```
  */
 export function getProviderManifests(): AdapterManifest[] {
   const manifests: AdapterManifest[] = [];
@@ -56,6 +90,24 @@ export function getProviderManifests(): AdapterManifest[] {
  * Discover all available provider adapters.
  *
  * Returns a map of provider ID to adapter factory function.
+ *
+ * @remarks
+ * Each factory lazily imports the provider module and constructs a new
+ * adapter instance. This avoids loading all provider code upfront and
+ * keeps startup fast.
+ *
+ * @returns Map of provider ID to async factory function that creates an adapter instance
+ *
+ * @example
+ * ```typescript
+ * import { discoverProviders } from '@cleocode/adapters';
+ *
+ * const providers = await discoverProviders();
+ * const factory = providers.get('claude-code');
+ * if (factory) {
+ *   const adapter = await factory();
+ * }
+ * ```
  */
 export async function discoverProviders(): Promise<Map<string, () => Promise<unknown>>> {
   const providers = new Map<string, () => Promise<unknown>>();

package/dist/providers/claude-code/adapter.js

@@ -1,165 +0,0 @@
-/**
- * Claude Code Adapter
- *
- * Main CLEOProviderAdapter implementation for Anthropic's Claude Code CLI.
- * Provides spawn, hooks, and install capabilities for CLEO integration.
- *
- * @task T5240
- */
-import { exec } from 'node:child_process';
-import { existsSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-import { promisify } from 'node:util';
-import { ClaudeCodeContextMonitorProvider } from './context-monitor.js';
-import { ClaudeCodeHookProvider } from './hooks.js';
-import { ClaudeCodeInstallProvider } from './install.js';
-import { ClaudeCodePathProvider } from './paths.js';
-import { ClaudeCodeSpawnProvider } from './spawn.js';
-import { ClaudeCodeTaskSyncProvider } from './task-sync.js';
-import { ClaudeCodeTransportProvider } from './transport.js';
-const execAsync = promisify(exec);
-/**
- * CLEO provider adapter for Anthropic Claude Code CLI.
- *
- * Bridges CLEO's adapter system with Claude Code's native capabilities:
- * - Hooks: Maps Claude Code events (SessionStart, PostToolUse, etc.) to CAAMP events
- * - Spawn: Launches subagent processes via the `claude` CLI
- * - Install: Registers MCP server, instruction files, and brain observation plugin
- */
-export class ClaudeCodeAdapter {
-    id = 'claude-code';
-    name = 'Claude Code';
-    version = '1.0.0';
-    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: [
-            'SessionStart',
-            'SessionEnd',
-            'PromptSubmit',
-            'ResponseComplete',
-            'PreToolUse',
-            'PostToolUse',
-            'PostToolUseFailure',
-            'PermissionRequest',
-            'SubagentStart',
-            'SubagentStop',
-            'PreCompact',
-            'PostCompact',
-            'Notification',
-            'ConfigChange',
-        ],
-        supportsSpawn: true,
-        supportsInstall: true,
-        supportsMcp: true,
-        supportsInstructionFiles: true,
-        instructionFilePattern: 'CLAUDE.md',
-        supportsContextMonitor: true,
-        supportsStatusline: true,
-        supportsProviderPaths: true,
-        supportsTransport: true,
-        supportsTaskSync: true,
-    };
-    hooks;
-    spawn;
-    install;
-    paths;
-    contextMonitor;
-    transport;
-    taskSync;
-    projectDir = null;
-    initialized = false;
-    constructor() {
-        this.hooks = new ClaudeCodeHookProvider();
-        this.spawn = new ClaudeCodeSpawnProvider();
-        this.install = new ClaudeCodeInstallProvider();
-        this.paths = new ClaudeCodePathProvider();
-        this.contextMonitor = new ClaudeCodeContextMonitorProvider();
-        this.transport = new ClaudeCodeTransportProvider();
-        this.taskSync = new ClaudeCodeTaskSyncProvider();
-    }
-    /**
-     * Initialize the adapter for a given project directory.
-     *
-     * Validates the environment by checking for the Claude CLI
-     * and Claude Code configuration directory.
-     *
-     * @param projectDir - Root directory of the project
-     */
-    async initialize(projectDir) {
-        this.projectDir = projectDir;
-        this.initialized = true;
-    }
-    /**
-     * Dispose the adapter and clean up resources.
-     *
-     * Unregisters hooks and releases any tracked state.
-     */
-    async dispose() {
-        if (this.hooks.isRegistered()) {
-            await this.hooks.unregisterNativeHooks();
-        }
-        this.initialized = false;
-        this.projectDir = null;
-    }
-    /**
-     * Run a health check to verify Claude Code is accessible.
-     *
-     * Checks:
-     * 1. Adapter has been initialized
-     * 2. Claude CLI is available in PATH
-     * 3. ~/.claude/ configuration directory exists
-     *
-     * @returns Health status with details about each check
-     */
-    async healthCheck() {
-        const details = {};
-        if (!this.initialized) {
-            return {
-                healthy: false,
-                provider: this.id,
-                details: { error: 'Adapter not initialized' },
-            };
-        }
-        // Check Claude CLI availability
-        let cliAvailable = false;
-        try {
-            const { stdout } = await execAsync('which claude');
-            cliAvailable = stdout.trim().length > 0;
-            details.cliPath = stdout.trim();
-        }
-        catch {
-            details.cliAvailable = false;
-        }
-        // Check for Claude Code config directory
-        const claudeConfigDir = join(homedir(), '.claude');
-        const configExists = existsSync(claudeConfigDir);
-        details.configDirExists = configExists;
-        // Check for CLAUDE_CODE_ENTRYPOINT env var
-        const entrypointSet = process.env.CLAUDE_CODE_ENTRYPOINT !== undefined;
-        details.entrypointEnvSet = entrypointSet;
-        // Healthy if CLI is available (primary requirement)
-        const healthy = cliAvailable;
-        details.cliAvailable = cliAvailable;
-        return {
-            healthy,
-            provider: this.id,
-            details,
-        };
-    }
-    /**
-     * Check whether the adapter has been initialized.
-     */
-    isInitialized() {
-        return this.initialized;
-    }
-    /**
-     * Get the project directory this adapter was initialized with.
-     */
-    getProjectDir() {
-        return this.projectDir;
-    }
-}
-//# sourceMappingURL=adapter.js.map

package/dist/providers/claude-code/adapter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/providers/claude-code/adapter.ts"],"names":[],"mappings":"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"}

package/dist/providers/claude-code/context-monitor.js

@@ -1,148 +0,0 @@
-/**
- * Claude Code context monitor provider.
- *
- * Implements AdapterContextMonitorProvider for Claude Code's context window
- * tracking and statusline integration.
- *
- * @task T5240
- */
-import { existsSync, readFileSync, writeFileSync } from 'node:fs';
-import { mkdir } from 'node:fs/promises';
-import { homedir } from 'node:os';
-import { dirname, join } from 'node:path';
-import { ClaudeCodePathProvider } from './paths.js';
-/** Thresholds for context window status levels. */
-const THRESHOLDS = {
-    WARNING: 50,
-    CAUTION: 70,
-    CRITICAL: 85,
-    EMERGENCY: 95,
-};
-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';
-    return 'ok';
-}
-/**
- * Context monitor provider for Claude Code.
- *
- * Processes context window JSON from Claude Code and writes state files
- * for statusline display. Also provides statusline configuration
- * and setup instructions specific to Claude Code's settings.json.
- */
-export class ClaudeCodeContextMonitorProvider {
-    pathProvider = new ClaudeCodePathProvider();
-    async processContextInput(input, cwd) {
-        const typed = input;
-        const contextSize = typed.context_window?.context_window_size ?? 200000;
-        const usage = typed.context_window?.current_usage;
-        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;
-        const totalTokens = inputTokens + outputTokens + cacheCreate;
-        const percentage = Math.floor((totalTokens * 100) / contextSize);
-        const status = getContextStatusFromPercentage(percentage);
-        // Write state file if CLEO dir exists
-        const cleoDir = cwd ? join(cwd, '.cleo') : '.cleo';
-        if (existsSync(cleoDir)) {
-            const stateDir = join(cleoDir, 'context-states');
-            const statePath = join(stateDir, '.context-state.json');
-            const state = {
-                $schema: 'https://cleo-dev.com/schemas/v1/context-state.schema.json',
-                version: '1.0.0',
-                timestamp: new Date().toISOString().replace(/\.\d{3}Z$/, 'Z'),
-                staleAfterMs: 5000,
-                contextWindow: {
-                    maxTokens: contextSize,
-                    currentTokens: totalTokens,
-                    percentage,
-                    breakdown: {
-                        inputTokens,
-                        outputTokens,
-                        cacheCreationTokens: cacheCreate,
-                        cacheReadTokens: usage.cache_read_input_tokens ?? 0,
-                    },
-                },
-                thresholds: {
-                    warning: THRESHOLDS.WARNING,
-                    caution: THRESHOLDS.CAUTION,
-                    critical: THRESHOLDS.CRITICAL,
-                    emergency: THRESHOLDS.EMERGENCY,
-                },
-                status,
-                cleoSessionId: '',
-            };
-            try {
-                await mkdir(dirname(statePath), { recursive: true });
-                writeFileSync(statePath, JSON.stringify(state, null, 2));
-            }
-            catch {
-                // Non-fatal
-            }
-        }
-        return `${percentage}% | ${totalTokens}/${contextSize}`;
-    }
-    checkStatuslineIntegration() {
-        const settingsPath = this.pathProvider.getSettingsPath();
-        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';
-            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';
-            }
-            const scriptPath = cmd.startsWith('~') ? cmd.replace('~', homedir()) : cmd;
-            if (existsSync(scriptPath)) {
-                try {
-                    const content = readFileSync(scriptPath, 'utf-8');
-                    if (content.includes('context-state.json'))
-                        return 'configured';
-                }
-                catch {
-                    /* unreadable */
-                }
-            }
-            return 'custom_no_cleo';
-        }
-        catch {
-            return 'no_settings';
-        }
-    }
-    getStatuslineConfig() {
-        return {
-            statusLine: {
-                type: 'command',
-                command: join(homedir(), '.cleo', 'lib', 'session', 'context-monitor.sh'),
-            },
-        };
-    }
-    getSetupInstructions() {
-        const settingsPath = this.pathProvider.getSettingsPath() ?? '~/.claude/settings.json';
-        return [
-            'To enable context monitoring, add to your Claude Code settings:',
-            `File: ${settingsPath}`,
-            '',
-            JSON.stringify(this.getStatuslineConfig(), null, 2),
-            '',
-            'This enables real-time context window tracking in the CLI.',
-        ].join('\n');
-    }
-}
-//# sourceMappingURL=context-monitor.js.map

package/dist/providers/claude-code/context-monitor.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"context-monitor.js","sourceRoot":"","sources":["../../../src/providers/claude-code/context-monitor.ts"],"names":[],"mappings":"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"}