@cleocode/adapters 2.0.0 → 2026.3.39

package/dist/providers/cursor/install.js

@@ -1,241 +0,0 @@
-/**
- * Cursor Install Provider
- *
- * Handles CLEO installation into Cursor environments:
- * - Registers CLEO MCP server in .cursor/mcp.json
- * - Ensures .cursorrules has CLEO @-references (legacy format)
- * - Creates .cursor/rules/cleo.mdc with CLEO references (modern format)
- *
- * Cursor supports two instruction file formats:
- * 1. Legacy: .cursorrules (flat file, project root)
- * 2. Modern: .cursor/rules/*.mdc (MDC format, per-rule files)
- *
- * This provider writes to both for maximum compatibility.
- *
- * @task T5240
- */
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
-/** Lines that should appear in instruction files to reference CLEO. */
-const INSTRUCTION_REFERENCES = [
-    '@~/.cleo/templates/CLEO-INJECTION.md',
-    '@.cleo/memory-bridge.md',
-];
-/** MCP server registration key used in Cursor config. */
-const MCP_SERVER_KEY = 'cleo';
-/**
- * Install provider for Cursor.
- *
- * Manages CLEO's integration with Cursor by:
- * 1. Registering the CLEO MCP server in .cursor/mcp.json
- * 2. Creating/updating .cursorrules with @-references (legacy)
- * 3. Creating .cursor/rules/cleo.mdc with @-references (modern)
- */
-export class CursorInstallProvider {
-    installedProjectDir = null;
-    /**
-     * Install CLEO into a Cursor project.
-     *
-     * @param options - Installation options including project directory and MCP server path
-     * @returns Result describing what was installed
-     */
-    async install(options) {
-        const { projectDir, mcpServerPath } = options;
-        const installedAt = new Date().toISOString();
-        let instructionFileUpdated = false;
-        let mcpRegistered = false;
-        const details = {};
-        // Step 1: Register MCP server in .cursor/mcp.json
-        if (mcpServerPath) {
-            mcpRegistered = this.registerMcpServer(projectDir, mcpServerPath);
-            if (mcpRegistered) {
-                details.mcpConfigPath = join(projectDir, '.cursor', 'mcp.json');
-            }
-        }
-        // Step 2: Ensure instruction files have @-references
-        instructionFileUpdated = this.updateInstructionFiles(projectDir);
-        if (instructionFileUpdated) {
-            details.instructionFiles = this.getUpdatedFileList(projectDir);
-        }
-        this.installedProjectDir = projectDir;
-        return {
-            success: true,
-            installedAt,
-            instructionFileUpdated,
-            mcpRegistered,
-            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 = join(this.installedProjectDir, '.cursor', 'mcp.json');
-        if (existsSync(mcpPath)) {
-            try {
-                const raw = readFileSync(mcpPath, 'utf-8');
-                const config = JSON.parse(raw);
-                const mcpServers = config.mcpServers;
-                if (mcpServers && MCP_SERVER_KEY in mcpServers) {
-                    delete mcpServers[MCP_SERVER_KEY];
-                    writeFileSync(mcpPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
-                }
-            }
-            catch {
-                // Ignore errors during uninstall
-            }
-        }
-        this.installedProjectDir = null;
-    }
-    /**
-     * Check whether CLEO is installed in the current environment.
-     *
-     * Checks for MCP server registered in .cursor/mcp.json.
-     */
-    async isInstalled() {
-        const mcpPath = join(process.cwd(), '.cursor', 'mcp.json');
-        if (existsSync(mcpPath)) {
-            try {
-                const config = JSON.parse(readFileSync(mcpPath, 'utf-8'));
-                const mcpServers = config.mcpServers;
-                if (mcpServers && MCP_SERVER_KEY in mcpServers) {
-                    return true;
-                }
-            }
-            catch {
-                // Fall through
-            }
-        }
-        return false;
-    }
-    /**
-     * Ensure instruction files contain @-references to CLEO.
-     *
-     * Updates .cursorrules (legacy) and creates .cursor/rules/cleo.mdc (modern).
-     *
-     * @param projectDir - Project root directory
-     */
-    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 = join(projectDir, '.cursor');
-        const mcpPath = join(cursorDir, 'mcp.json');
-        let config = {};
-        mkdirSync(cursorDir, { recursive: true });
-        if (existsSync(mcpPath)) {
-            try {
-                config = JSON.parse(readFileSync(mcpPath, 'utf-8'));
-            }
-            catch {
-                // Start fresh on parse error
-            }
-        }
-        if (!config.mcpServers || typeof config.mcpServers !== 'object') {
-            config.mcpServers = {};
-        }
-        const mcpServers = config.mcpServers;
-        mcpServers[MCP_SERVER_KEY] = {
-            command: 'node',
-            args: [mcpServerPath],
-        };
-        writeFileSync(mcpPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
-        return true;
-    }
-    /**
-     * Update instruction files with CLEO @-references.
-     *
-     * Handles both legacy (.cursorrules) and modern (.cursor/rules/cleo.mdc) formats.
-     *
-     * @returns true if any file was created or modified
-     */
-    updateInstructionFiles(projectDir) {
-        let updated = false;
-        // Update legacy .cursorrules if it exists
-        if (this.updateLegacyRules(projectDir)) {
-            updated = true;
-        }
-        // Create/update modern .cursor/rules/cleo.mdc
-        if (this.updateModernRules(projectDir)) {
-            updated = true;
-        }
-        return updated;
-    }
-    /**
-     * Update legacy .cursorrules file with @-references.
-     * Only modifies the file if it already exists (does not create it).
-     *
-     * @returns true if the file was modified
-     */
-    updateLegacyRules(projectDir) {
-        const rulesPath = join(projectDir, '.cursorrules');
-        if (!existsSync(rulesPath)) {
-            return false;
-        }
-        let content = readFileSync(rulesPath, 'utf-8');
-        const missingRefs = INSTRUCTION_REFERENCES.filter((ref) => !content.includes(ref));
-        if (missingRefs.length === 0) {
-            return false;
-        }
-        const separator = content.endsWith('\n') ? '' : '\n';
-        content = content + separator + missingRefs.join('\n') + '\n';
-        writeFileSync(rulesPath, content, 'utf-8');
-        return true;
-    }
-    /**
-     * Create or update .cursor/rules/cleo.mdc with CLEO references.
-     *
-     * MDC (Markdown Component) format is Cursor's modern rule file format.
-     * Each .mdc file in .cursor/rules/ is loaded as a rule set.
-     *
-     * @returns true if the file was created or modified
-     */
-    updateModernRules(projectDir) {
-        const rulesDir = join(projectDir, '.cursor', 'rules');
-        const mdcPath = join(rulesDir, 'cleo.mdc');
-        const expectedContent = [
-            '---',
-            'description: CLEO task management protocol references',
-            'globs: "**/*"',
-            'alwaysApply: true',
-            '---',
-            '',
-            ...INSTRUCTION_REFERENCES,
-            '',
-        ].join('\n');
-        if (existsSync(mdcPath)) {
-            const existing = readFileSync(mdcPath, 'utf-8');
-            if (existing === expectedContent) {
-                return false;
-            }
-        }
-        mkdirSync(rulesDir, { recursive: true });
-        writeFileSync(mdcPath, expectedContent, 'utf-8');
-        return true;
-    }
-    /**
-     * Get list of instruction files that were updated.
-     */
-    getUpdatedFileList(projectDir) {
-        const files = [];
-        if (existsSync(join(projectDir, '.cursorrules'))) {
-            files.push(join(projectDir, '.cursorrules'));
-        }
-        files.push(join(projectDir, '.cursor', 'rules', 'cleo.mdc'));
-        return files;
-    }
-}
-//# sourceMappingURL=install.js.map

package/dist/providers/cursor/install.js.map

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

package/dist/providers/cursor/spawn.d.ts

@@ -1,50 +0,0 @@
-/**
- * Cursor Spawn Provider
- *
- * Cursor is a GUI-based AI code editor and does not support
- * CLI-based subagent spawning. This provider implements
- * the AdapterSpawnProvider interface with appropriate rejections.
- *
- * @task T5240
- */
-import type { AdapterSpawnProvider, SpawnContext, SpawnResult } from '@cleocode/contracts';
-/**
- * Spawn provider for Cursor.
- *
- * Cursor does not support subagent spawning via CLI. The adapter
- * declares supportsSpawn: false in its capabilities. All methods
- * either reject or return empty results.
- */
-export declare class CursorSpawnProvider implements AdapterSpawnProvider {
-    /**
-     * Check if Cursor supports spawning subagents.
-     *
-     * @returns false (Cursor does not support CLI spawning)
-     */
-    canSpawn(): Promise<boolean>;
-    /**
-     * Attempt to spawn a subagent via Cursor.
-     *
-     * Always throws because Cursor does not support subagent spawning.
-     * Callers should check canSpawn() before calling this method.
-     *
-     * @param _context - Unused; spawning is not supported
-     * @throws Error explaining that Cursor does not support subagent spawning
-     */
-    spawn(_context: SpawnContext): Promise<SpawnResult>;
-    /**
-     * List running Cursor subagent processes.
-     *
-     * @returns Empty array (no processes can be spawned)
-     */
-    listRunning(): Promise<SpawnResult[]>;
-    /**
-     * Terminate a Cursor subagent process.
-     *
-     * No-op because Cursor cannot spawn processes.
-     *
-     * @param _instanceId - Unused; no processes to terminate
-     */
-    terminate(_instanceId: string): Promise<void>;
-}
-//# sourceMappingURL=spawn.d.ts.map

package/dist/providers/cursor/spawn.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../src/providers/cursor/spawn.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAE3F;;;;;;GAMG;AACH,qBAAa,mBAAoB,YAAW,oBAAoB;IAC9D;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IAIlC;;;;;;;;OAQG;IACG,KAAK,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAQzD;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAI3C;;;;;;OAMG;IACG,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGpD"}

package/dist/providers/cursor/spawn.js

@@ -1,59 +0,0 @@
-/**
- * Cursor Spawn Provider
- *
- * Cursor is a GUI-based AI code editor and does not support
- * CLI-based subagent spawning. This provider implements
- * the AdapterSpawnProvider interface with appropriate rejections.
- *
- * @task T5240
- */
-/**
- * Spawn provider for Cursor.
- *
- * Cursor does not support subagent spawning via CLI. The adapter
- * declares supportsSpawn: false in its capabilities. All methods
- * either reject or return empty results.
- */
-export class CursorSpawnProvider {
-    /**
-     * Check if Cursor supports spawning subagents.
-     *
-     * @returns false (Cursor does not support CLI spawning)
-     */
-    async canSpawn() {
-        return false;
-    }
-    /**
-     * Attempt to spawn a subagent via Cursor.
-     *
-     * Always throws because Cursor does not support subagent spawning.
-     * Callers should check canSpawn() before calling this method.
-     *
-     * @param _context - Unused; spawning is not supported
-     * @throws Error explaining that Cursor does not support subagent spawning
-     */
-    async spawn(_context) {
-        throw new Error('Cursor does not support subagent spawning. ' +
-            'Cursor is a GUI-based editor without CLI subagent capabilities. ' +
-            'Use a provider that supports spawning (e.g., Claude Code or OpenCode).');
-    }
-    /**
-     * List running Cursor subagent processes.
-     *
-     * @returns Empty array (no processes can be spawned)
-     */
-    async listRunning() {
-        return [];
-    }
-    /**
-     * Terminate a Cursor subagent process.
-     *
-     * No-op because Cursor cannot spawn processes.
-     *
-     * @param _instanceId - Unused; no processes to terminate
-     */
-    async terminate(_instanceId) {
-        // No-op: Cursor does not spawn processes.
-    }
-}
-//# sourceMappingURL=spawn.js.map

package/dist/providers/cursor/spawn.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"spawn.js","sourceRoot":"","sources":["../../../src/providers/cursor/spawn.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;;;GAMG;AACH,MAAM,OAAO,mBAAmB;IAC9B;;;;OAIG;IACH,KAAK,CAAC,QAAQ;QACZ,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,KAAK,CAAC,QAAsB;QAChC,MAAM,IAAI,KAAK,CACb,6CAA6C;YAC7C,kEAAkE;YAClE,wEAAwE,CACzE,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,WAAW;QACf,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,SAAS,CAAC,WAAmB;QACjC,0CAA0C;IAC5C,CAAC;CACF"}

package/dist/providers/opencode/adapter.d.ts

@@ -1,67 +0,0 @@
-/**
- * OpenCode Adapter
- *
- * Main CLEOProviderAdapter implementation for OpenCode AI coding assistant.
- * Provides spawn, hooks, and install capabilities for CLEO integration.
- *
- * @task T5240
- */
-import type { AdapterCapabilities, AdapterHealthStatus, CLEOProviderAdapter } from '@cleocode/contracts';
-import { OpenCodeHookProvider } from './hooks.js';
-import { OpenCodeInstallProvider } from './install.js';
-import { OpenCodeSpawnProvider } from './spawn.js';
-/**
- * CLEO provider adapter for OpenCode AI coding assistant.
- *
- * Bridges CLEO's adapter system with OpenCode's native capabilities:
- * - Hooks: Maps OpenCode events (session.start, tool.complete, etc.) to CAAMP events
- * - Spawn: Launches subagent processes via the `opencode` CLI
- * - Install: Registers MCP server in .opencode/config.json and ensures AGENTS.md references
- */
-export declare class OpenCodeAdapter implements CLEOProviderAdapter {
-    readonly id = "opencode";
-    readonly name = "OpenCode";
-    readonly version = "1.0.0";
-    capabilities: AdapterCapabilities;
-    hooks: OpenCodeHookProvider;
-    spawn: OpenCodeSpawnProvider;
-    install: OpenCodeInstallProvider;
-    private projectDir;
-    private initialized;
-    constructor();
-    /**
-     * Initialize the adapter for a given project directory.
-     *
-     * Validates the environment by checking for the OpenCode CLI
-     * and OpenCode configuration directory.
-     *
-     * @param projectDir - Root directory of the project
-     */
-    initialize(projectDir: string): Promise<void>;
-    /**
-     * Dispose the adapter and clean up resources.
-     *
-     * Unregisters hooks and releases any tracked state.
-     */
-    dispose(): Promise<void>;
-    /**
-     * Run a health check to verify OpenCode is accessible.
-     *
-     * Checks:
-     * 1. Adapter has been initialized
-     * 2. OpenCode CLI is available in PATH
-     * 3. .opencode/ configuration directory exists in the project
-     *
-     * @returns Health status with details about each check
-     */
-    healthCheck(): Promise<AdapterHealthStatus>;
-    /**
-     * Check whether the adapter has been initialized.
-     */
-    isInitialized(): boolean;
-    /**
-     * Get the project directory this adapter was initialized with.
-     */
-    getProjectDir(): string | null;
-}
-//# sourceMappingURL=adapter.d.ts.map

package/dist/providers/opencode/adapter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/providers/opencode/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAInD;;;;;;;GAOG;AACH,qBAAa,eAAgB,YAAW,mBAAmB;IACzD,QAAQ,CAAC,EAAE,cAAc;IACzB,QAAQ,CAAC,IAAI,cAAc;IAC3B,QAAQ,CAAC,OAAO,WAAW;IAE3B,YAAY,EAAE,mBAAmB,CAoB/B;IAEF,KAAK,EAAE,oBAAoB,CAAC;IAC5B,KAAK,EAAE,qBAAqB,CAAC;IAC7B,OAAO,EAAE,uBAAuB,CAAC;IAEjC,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,WAAW,CAAS;;IAQ5B;;;;;;;OAOG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnD;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ9B;;;;;;;;;OASG;IACG,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;IA2CjD;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,aAAa,IAAI,MAAM,GAAG,IAAI;CAG/B"}

package/dist/providers/opencode/adapter.js

@@ -1,144 +0,0 @@
-/**
- * OpenCode Adapter
- *
- * Main CLEOProviderAdapter implementation for OpenCode AI coding assistant.
- * Provides spawn, hooks, and install capabilities for CLEO integration.
- *
- * @task T5240
- */
-import { exec } from 'node:child_process';
-import { existsSync } from 'node:fs';
-import { join } from 'node:path';
-import { promisify } from 'node:util';
-import { OpenCodeHookProvider } from './hooks.js';
-import { OpenCodeInstallProvider } from './install.js';
-import { OpenCodeSpawnProvider } from './spawn.js';
-const execAsync = promisify(exec);
-/**
- * CLEO provider adapter for OpenCode AI coding assistant.
- *
- * Bridges CLEO's adapter system with OpenCode's native capabilities:
- * - Hooks: Maps OpenCode events (session.start, tool.complete, etc.) to CAAMP events
- * - Spawn: Launches subagent processes via the `opencode` CLI
- * - Install: Registers MCP server in .opencode/config.json and ensures AGENTS.md references
- */
-export class OpenCodeAdapter {
-    id = 'opencode';
-    name = 'OpenCode';
-    version = '1.0.0';
-    capabilities = {
-        supportsHooks: true,
-        supportedHookEvents: [
-            'onSessionStart',
-            'onSessionEnd',
-            'onToolStart',
-            'onToolComplete',
-            'onError',
-            'onPromptSubmit',
-        ],
-        supportsSpawn: true,
-        supportsInstall: true,
-        supportsMcp: true,
-        supportsInstructionFiles: true,
-        instructionFilePattern: 'AGENTS.md',
-        supportsContextMonitor: false,
-        supportsStatusline: false,
-        supportsProviderPaths: true,
-        supportsTransport: false,
-        supportsTaskSync: false,
-    };
-    hooks;
-    spawn;
-    install;
-    projectDir = null;
-    initialized = false;
-    constructor() {
-        this.hooks = new OpenCodeHookProvider();
-        this.spawn = new OpenCodeSpawnProvider();
-        this.install = new OpenCodeInstallProvider();
-    }
-    /**
-     * Initialize the adapter for a given project directory.
-     *
-     * Validates the environment by checking for the OpenCode CLI
-     * and OpenCode 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 OpenCode is accessible.
-     *
-     * Checks:
-     * 1. Adapter has been initialized
-     * 2. OpenCode CLI is available in PATH
-     * 3. .opencode/ configuration directory exists in the project
-     *
-     * @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 OpenCode CLI availability
-        let cliAvailable = false;
-        try {
-            const { stdout } = await execAsync('which opencode');
-            cliAvailable = stdout.trim().length > 0;
-            details.cliPath = stdout.trim();
-        }
-        catch {
-            details.cliAvailable = false;
-        }
-        // Check for OpenCode config directory in the project
-        if (this.projectDir) {
-            const openCodeConfigDir = join(this.projectDir, '.opencode');
-            const configExists = existsSync(openCodeConfigDir);
-            details.configDirExists = configExists;
-        }
-        // Check for OPENCODE_VERSION env var
-        const versionEnvSet = process.env.OPENCODE_VERSION !== undefined;
-        details.versionEnvSet = versionEnvSet;
-        // 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/opencode/adapter.js.map

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

package/dist/providers/opencode/hooks.d.ts

@@ -1,66 +0,0 @@
-/**
- * OpenCode Hook Provider
- *
- * Maps OpenCode's native hook events to CAAMP hook events.
- * OpenCode supports 6 of 8 CAAMP events through its agent/hook system.
- *
- * OpenCode event mapping:
- * - session.start     -> onSessionStart
- * - session.end       -> onSessionEnd
- * - tool.start        -> onToolStart
- * - tool.complete     -> onToolComplete
- * - error             -> onError
- * - prompt.submit     -> onPromptSubmit
- *
- * @task T5240
- */
-import type { AdapterHookProvider } from '@cleocode/contracts';
-/**
- * Hook provider for OpenCode.
- *
- * OpenCode registers hooks via its configuration system at
- * .opencode/config.json. Hook handlers are defined as shell commands
- * or script paths that execute when the corresponding event fires.
- *
- * Since hooks are registered through the config system (managed by
- * the install provider), registerNativeHooks and unregisterNativeHooks
- * track registration state without performing filesystem operations.
- */
-export declare class OpenCodeHookProvider implements AdapterHookProvider {
-    private registered;
-    /**
-     * Map an OpenCode native event name to a CAAMP hook event name.
-     *
-     * @param providerEvent - OpenCode event name (e.g. "session.start", "tool.complete")
-     * @returns CAAMP event name or null if unmapped
-     */
-    mapProviderEvent(providerEvent: string): string | null;
-    /**
-     * 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.
-     *
-     * @param _projectDir - Project directory (unused; config manages registration)
-     */
-    registerNativeHooks(_projectDir: string): Promise<void>;
-    /**
-     * 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.
-     */
-    unregisterNativeHooks(): Promise<void>;
-    /**
-     * Check whether hooks have been registered via registerNativeHooks.
-     */
-    isRegistered(): boolean;
-    /**
-     * Get the full event mapping for introspection/debugging.
-     */
-    getEventMap(): Readonly<Record<string, string>>;
-}
-//# sourceMappingURL=hooks.d.ts.map

package/dist/providers/opencode/hooks.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/providers/opencode/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAiB/D;;;;;;;;;;GAUG;AACH,qBAAa,oBAAqB,YAAW,mBAAmB;IAC9D,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;;OAKG;IACH,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAItD;;;;;;;;;OASG;IACG,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D;;;;;;OAMG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5C;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;OAEG;IACH,WAAW,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAGhD"}