@cleocode/adapters 2.0.0

package/src/providers/opencode/adapter.js

@@ -0,0 +1,144 @@
+/**
+ * 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/src/providers/opencode/adapter.js.map

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

package/src/providers/opencode/adapter.ts

@@ -0,0 +1,165 @@
+/**
+ * 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 type {
+  AdapterCapabilities,
+  AdapterHealthStatus,
+  CLEOProviderAdapter,
+} from '@cleocode/contracts';
+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 implements CLEOProviderAdapter {
+  readonly id = 'opencode';
+  readonly name = 'OpenCode';
+  readonly version = '1.0.0';
+
+  capabilities: AdapterCapabilities = {
+    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: OpenCodeHookProvider;
+  spawn: OpenCodeSpawnProvider;
+  install: OpenCodeInstallProvider;
+
+  private projectDir: string | null = null;
+  private 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: string): Promise<void> {
+    this.projectDir = projectDir;
+    this.initialized = true;
+  }
+
+  /**
+   * Dispose the adapter and clean up resources.
+   *
+   * Unregisters hooks and releases any tracked state.
+   */
+  async dispose(): Promise<void> {
+    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(): Promise<AdapterHealthStatus> {
+    const details: Record<string, unknown> = {};
+
+    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(): boolean {
+    return this.initialized;
+  }
+
+  /**
+   * Get the project directory this adapter was initialized with.
+   */
+  getProjectDir(): string | null {
+    return this.projectDir;
+  }
+}

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

@@ -0,0 +1,66 @@
+/**
+ * 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/src/providers/opencode/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["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"}

package/src/providers/opencode/hooks.js

@@ -0,0 +1,89 @@
+/**
+ * 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
+ */
+/**
+ * Mapping from OpenCode native event names to CAAMP event names.
+ *
+ * OpenCode uses dot-delimited event names (e.g. "session.start")
+ * while CAAMP uses camelCase (e.g. "onSessionStart").
+ */
+const OPENCODE_EVENT_MAP = {
+    'session.start': 'onSessionStart',
+    'session.end': 'onSessionEnd',
+    'tool.start': 'onToolStart',
+    'tool.complete': 'onToolComplete',
+    'error': 'onError',
+    'prompt.submit': 'onPromptSubmit',
+};
+/**
+ * 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 class OpenCodeHookProvider {
+    registered = false;
+    /**
+     * 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) {
+        return OPENCODE_EVENT_MAP[providerEvent] ?? 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)
+     */
+    async registerNativeHooks(_projectDir) {
+        this.registered = true;
+    }
+    /**
+     * 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.
+     */
+    async unregisterNativeHooks() {
+        this.registered = false;
+    }
+    /**
+     * Check whether hooks have been registered via registerNativeHooks.
+     */
+    isRegistered() {
+        return this.registered;
+    }
+    /**
+     * Get the full event mapping for introspection/debugging.
+     */
+    getEventMap() {
+        return { ...OPENCODE_EVENT_MAP };
+    }
+}
+//# sourceMappingURL=hooks.js.map

package/src/providers/opencode/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH;;;;;GAKG;AACH,MAAM,kBAAkB,GAA2B;IACjD,eAAe,EAAE,gBAAgB;IACjC,aAAa,EAAE,cAAc;IAC7B,YAAY,EAAE,aAAa;IAC3B,eAAe,EAAE,gBAAgB;IACjC,OAAO,EAAE,SAAS;IAClB,eAAe,EAAE,gBAAgB;CAClC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,OAAO,oBAAoB;IACvB,UAAU,GAAG,KAAK,CAAC;IAE3B;;;;;OAKG;IACH,gBAAgB,CAAC,aAAqB;QACpC,OAAO,kBAAkB,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC;IACnD,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,mBAAmB,CAAC,WAAmB;QAC3C,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;IACzB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,qBAAqB;QACzB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,EAAE,GAAG,kBAAkB,EAAE,CAAC;IACnC,CAAC;CACF"}

package/src/providers/opencode/hooks.ts

@@ -0,0 +1,97 @@
+/**
+ * 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';
+
+/**
+ * Mapping from OpenCode native event names to CAAMP event names.
+ *
+ * OpenCode uses dot-delimited event names (e.g. "session.start")
+ * while CAAMP uses camelCase (e.g. "onSessionStart").
+ */
+const OPENCODE_EVENT_MAP: Record<string, string> = {
+  'session.start': 'onSessionStart',
+  'session.end': 'onSessionEnd',
+  'tool.start': 'onToolStart',
+  'tool.complete': 'onToolComplete',
+  'error': 'onError',
+  'prompt.submit': 'onPromptSubmit',
+};
+
+/**
+ * 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 class OpenCodeHookProvider implements AdapterHookProvider {
+  private registered = false;
+
+  /**
+   * 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 {
+    return OPENCODE_EVENT_MAP[providerEvent] ?? 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)
+   */
+  async registerNativeHooks(_projectDir: string): Promise<void> {
+    this.registered = true;
+  }
+
+  /**
+   * 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.
+   */
+  async unregisterNativeHooks(): Promise<void> {
+    this.registered = false;
+  }
+
+  /**
+   * Check whether hooks have been registered via registerNativeHooks.
+   */
+  isRegistered(): boolean {
+    return this.registered;
+  }
+
+  /**
+   * Get the full event mapping for introspection/debugging.
+   */
+  getEventMap(): Readonly<Record<string, string>> {
+    return { ...OPENCODE_EVENT_MAP };
+  }
+}

package/src/providers/opencode/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * OpenCode provider adapter.
+ *
+ * CLEO provider adapter for OpenCode AI coding assistant.
+ * Default export is the adapter class for dynamic loading by AdapterManager.
+ *
+ * @task T5240
+ */
+import { OpenCodeAdapter } from './adapter.js';
+export { OpenCodeAdapter } from './adapter.js';
+export { OpenCodeHookProvider } from './hooks.js';
+export { OpenCodeSpawnProvider } from './spawn.js';
+export { OpenCodeInstallProvider } from './install.js';
+export default OpenCodeAdapter;
+/**
+ * Factory function for creating adapter instances.
+ * Used by AdapterManager's dynamic import fallback.
+ */
+export declare function createAdapter(): OpenCodeAdapter;
+//# sourceMappingURL=index.d.ts.map

package/src/providers/opencode/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAEvD,eAAe,eAAe,CAAC;AAE/B;;;GAGG;AACH,wBAAgB,aAAa,IAAI,eAAe,CAE/C"}

package/src/providers/opencode/index.js

@@ -0,0 +1,22 @@
+/**
+ * OpenCode provider adapter.
+ *
+ * CLEO provider adapter for OpenCode AI coding assistant.
+ * Default export is the adapter class for dynamic loading by AdapterManager.
+ *
+ * @task T5240
+ */
+import { OpenCodeAdapter } from './adapter.js';
+export { OpenCodeAdapter } from './adapter.js';
+export { OpenCodeHookProvider } from './hooks.js';
+export { OpenCodeSpawnProvider } from './spawn.js';
+export { OpenCodeInstallProvider } from './install.js';
+export default OpenCodeAdapter;
+/**
+ * Factory function for creating adapter instances.
+ * Used by AdapterManager's dynamic import fallback.
+ */
+export function createAdapter() {
+    return new OpenCodeAdapter();
+}
+//# sourceMappingURL=index.js.map

package/src/providers/opencode/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAEvD,eAAe,eAAe,CAAC;AAE/B;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,eAAe,EAAE,CAAC;AAC/B,CAAC"}

package/src/providers/opencode/index.ts

@@ -0,0 +1,25 @@
+/**
+ * OpenCode provider adapter.
+ *
+ * CLEO provider adapter for OpenCode AI coding assistant.
+ * Default export is the adapter class for dynamic loading by AdapterManager.
+ *
+ * @task T5240
+ */
+
+import { OpenCodeAdapter } from './adapter.js';
+
+export { OpenCodeAdapter } from './adapter.js';
+export { OpenCodeHookProvider } from './hooks.js';
+export { OpenCodeSpawnProvider } from './spawn.js';
+export { OpenCodeInstallProvider } from './install.js';
+
+export default OpenCodeAdapter;
+
+/**
+ * Factory function for creating adapter instances.
+ * Used by AdapterManager's dynamic import fallback.
+ */
+export function createAdapter(): OpenCodeAdapter {
+  return new OpenCodeAdapter();
+}