@cleocode/adapters 2026.4.0 → 2026.4.2

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

@@ -1,5 +1,5 @@
 /**
- * Cursor provider adapter.
+ * @packageDocumentation
  *
  * CLEO provider adapter for Cursor AI code editor.
  * Default export is the adapter class for dynamic loading by AdapterManager.
@@ -14,6 +14,21 @@ export default CursorAdapter;
 /**
  * Factory function for creating adapter instances.
  * Used by AdapterManager's dynamic import fallback.
+ *
+ * @remarks
+ * This is the primary entry point for dynamic adapter loading.
+ * AdapterManager calls this function when it resolves the cursor
+ * provider via its import-based discovery mechanism.
+ *
+ * @returns A new {@link CursorAdapter} instance ready for initialization
+ *
+ * @example
+ * ```typescript
+ * import { createAdapter } from '@cleocode/adapters/providers/cursor';
+ *
+ * const adapter = createAdapter();
+ * await adapter.initialize('/path/to/project');
+ * ```
  */
 export declare function createAdapter(): CursorAdapter;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/cursor/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,eAAe,aAAa,CAAC;AAE7B;;;GAGG;AACH,wBAAgB,aAAa,IAAI,aAAa,CAE7C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/cursor/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,eAAe,aAAa,CAAC;AAE7B;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,IAAI,aAAa,CAE7C"}

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

@@ -2,7 +2,6 @@
  * 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)
  *
@@ -19,30 +18,33 @@ import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cle
  * 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)
+ * 1. Creating/updating .cursorrules with @-references (legacy)
+ * 2. Creating .cursor/rules/cleo.mdc with @-references (modern)
+ *
+ * @remarks
+ * Installation is idempotent and writes to both instruction file formats
+ * for maximum compatibility. The legacy `.cursorrules` file is only modified
+ * if it already exists (never created from scratch). The modern MDC file
+ * is always created or updated to ensure Cursor's rule engine picks it up.
  */
 export declare class CursorInstallProvider implements AdapterInstallProvider {
-    private installedProjectDir;
     /**
      * 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
      */
     install(options: InstallOptions): Promise<InstallResult>;
     /**
      * 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).
      */
     uninstall(): Promise<void>;
     /**
      * 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.
      */
     isInstalled(): Promise<boolean>;
     /**
@@ -53,15 +55,6 @@ export declare class CursorInstallProvider implements AdapterInstallProvider {
      * @param projectDir - Project root directory
      */
     ensureInstructionReferences(projectDir: string): Promise<void>;
-    /**
-     * 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
-     */
-    private registerMcpServer;
     /**
      * Update instruction files with CLEO @-references.
      *

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

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/cursor/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAQjG;;;;;;;GAOG;AACH,qBAAa,qBAAsB,YAAW,sBAAsB;IAClE,OAAO,CAAC,mBAAmB,CAAuB;IAElD;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAgC9D;;;;;OAKG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBhC;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAiBrC;;;;;;OAMG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;;;;;;OAOG;IACH,OAAO,CAAC,iBAAiB;IA6BzB;;;;;;OAMG;IACH,OAAO,CAAC,sBAAsB;IAgB9B;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAmBzB;;;;;;;OAOG;IACH,OAAO,CAAC,iBAAiB;IA2BzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAQ3B"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/cursor/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAKjG;;;;;;;;;;;;GAYG;AACH,qBAAa,qBAAsB,YAAW,sBAAsB;IAClE;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAqB9D;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAEhC;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAqBrC;;;;;;OAMG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;;;;;OAMG;IACH,OAAO,CAAC,sBAAsB;IAgB9B;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAmBzB;;;;;;;OAOG;IACH,OAAO,CAAC,iBAAiB;IA2BzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAQ3B"}

package/dist/providers/gemini-cli/adapter.d.ts

@@ -15,19 +15,33 @@ import { GeminiCliInstallProvider } from './install.js';
  *
  * Bridges CLEO's adapter system with Gemini CLI's native capabilities:
  * - Hooks: Maps Gemini CLI events (SessionStart, PreToolUse, etc.) to CAAMP events
- * - Install: Registers MCP server in ~/.gemini/settings.json and ensures AGENTS.md references
+ * - Install: Ensures AGENTS.md references for CLEO instruction files
+ *
+ * @remarks
+ * Gemini CLI supports 10 canonical CAAMP events through its hook system,
+ * including PreModel and PostModel which most other providers lack. It has
+ * no spawn or transport capabilities. Integration is through AGENTS.md
+ * instruction files and the Gemini CLI's configuration at `~/.gemini/`.
  *
  * @task T161
  * @epic T134
  */
 export declare class GeminiCliAdapter implements CLEOProviderAdapter {
+    /** Unique provider identifier. */
     readonly id = "gemini-cli";
+    /** Human-readable provider name. */
     readonly name = "Gemini CLI";
+    /** Adapter version string. */
     readonly version = "1.0.0";
+    /** Declared capabilities for this provider. */
     capabilities: AdapterCapabilities;
+    /** Hook provider for CAAMP event mapping. */
     hooks: GeminiCliHookProvider;
+    /** Install provider for managing instruction files. */
     install: GeminiCliInstallProvider;
+    /** Project directory this adapter was initialized with, or null. */
     private projectDir;
+    /** Whether {@link initialize} has been called. */
     private initialized;
     constructor();
     /**

package/dist/providers/gemini-cli/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/providers/gemini-cli/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAIxD;;;;;;;;;GASG;AACH,qBAAa,gBAAiB,YAAW,mBAAmB;IAC1D,QAAQ,CAAC,EAAE,gBAAgB;IAC3B,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,OAAO,WAAW;IAE3B,YAAY,EAAE,mBAAmB,CAuB/B;IAEF,KAAK,EAAE,qBAAqB,CAAC;IAC7B,OAAO,EAAE,wBAAwB,CAAC;IAElC,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,WAAW,CAAS;;IAO5B;;;;;OAKG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnD;;;;;OAKG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ9B;;;;;;;;;;OAUG;IACG,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAqCjD;;;OAGG;IACH,aAAa,IAAI,OAAO;IAIxB;;;OAGG;IACH,aAAa,IAAI,MAAM,GAAG,IAAI;CAG/B"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/providers/gemini-cli/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAIxD;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,gBAAiB,YAAW,mBAAmB;IAC1D,kCAAkC;IAClC,QAAQ,CAAC,EAAE,gBAAgB;IAC3B,oCAAoC;IACpC,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,WAAW;IAE3B,+CAA+C;IAC/C,YAAY,EAAE,mBAAmB,CAuB/B;IAEF,6CAA6C;IAC7C,KAAK,EAAE,qBAAqB,CAAC;IAC7B,uDAAuD;IACvD,OAAO,EAAE,wBAAwB,CAAC;IAElC,oEAAoE;IACpE,OAAO,CAAC,UAAU,CAAuB;IACzC,kDAAkD;IAClD,OAAO,CAAC,WAAW,CAAS;;IAO5B;;;;;OAKG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnD;;;;;OAKG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ9B;;;;;;;;;;OAUG;IACG,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAqCjD;;;OAGG;IACH,aAAa,IAAI,OAAO;IAIxB;;;OAGG;IACH,aAAa,IAAI,MAAM,GAAG,IAAI;CAG/B"}

package/dist/providers/gemini-cli/hooks.d.ts

@@ -31,10 +31,17 @@ import type { AdapterHookProvider } from '@cleocode/contracts';
  * the install provider), registerNativeHooks and unregisterNativeHooks
  * track registration state without performing filesystem operations.
  *
+ * @remarks
+ * Gemini CLI uses its own event naming convention (e.g. BeforeAgent,
+ * AfterTool, PreCompress) which differs from both the PascalCase CAAMP
+ * canonical names and other providers' conventions. The static event map
+ * covers all 10 supported canonical events.
+ *
  * @task T161
  * @epic T134
  */
 export declare class GeminiCliHookProvider implements AdapterHookProvider {
+    /** Whether hooks have been registered for the current session. */
     private registered;
     /**
      * Map a Gemini CLI native event name to a CAAMP hook event name.

package/dist/providers/gemini-cli/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/providers/gemini-cli/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAmB/D;;;;;;;;;;;;;GAaG;AACH,qBAAa,qBAAsB,YAAW,mBAAmB;IAC/D,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;;;OAMG;IACH,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAItD;;;;;;;;;;OAUG;IACG,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D;;;;;;;OAOG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5C;;;OAGG;IACH,YAAY,IAAI,OAAO;IAIvB;;;OAGG;IACH,WAAW,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAI/C;;;;;;;;;;;OAWG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAGrF"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/providers/gemini-cli/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAmB/D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,qBAAsB,YAAW,mBAAmB;IAC/D,kEAAkE;IAClE,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;;;OAMG;IACH,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAItD;;;;;;;;;;OAUG;IACG,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D;;;;;;;OAOG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5C;;;OAGG;IACH,YAAY,IAAI,OAAO;IAIvB;;;OAGG;IACH,WAAW,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAI/C;;;;;;;;;;;OAWG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAGrF"}

package/dist/providers/gemini-cli/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * Gemini CLI provider adapter.
+ * @packageDocumentation
  *
  * CLEO provider adapter for Google Gemini CLI.
  * Default export is the adapter class for dynamic loading by AdapterManager.
@@ -16,6 +16,21 @@ export default GeminiCliAdapter;
  * Factory function for creating adapter instances.
  * Used by AdapterManager's dynamic import fallback.
  *
+ * @remarks
+ * This is the primary entry point for dynamic adapter loading.
+ * AdapterManager calls this function when it resolves the gemini-cli
+ * provider via its import-based discovery mechanism.
+ *
+ * @returns A new {@link GeminiCliAdapter} instance ready for initialization
+ *
+ * @example
+ * ```typescript
+ * import { createAdapter } from '@cleocode/adapters/providers/gemini-cli';
+ *
+ * const adapter = createAdapter();
+ * await adapter.initialize('/path/to/project');
+ * ```
+ *
  * @task T161
  */
 export declare function createAdapter(): GeminiCliAdapter;

package/dist/providers/gemini-cli/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/gemini-cli/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAExD,eAAe,gBAAgB,CAAC;AAEhC;;;;;GAKG;AACH,wBAAgB,aAAa,IAAI,gBAAgB,CAEhD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/gemini-cli/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAExD,eAAe,gBAAgB,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,IAAI,gBAAgB,CAEhD"}

package/dist/providers/gemini-cli/install.d.ts

@@ -2,7 +2,6 @@
  * Gemini CLI Install Provider
  *
  * Handles CLEO installation into Gemini CLI environments:
- * - Registers CLEO MCP server in ~/.gemini/settings.json
  * - Ensures AGENTS.md has CLEO @-references
  *
  * @task T161
@@ -13,8 +12,12 @@ import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cle
  * Install provider for Gemini CLI.
  *
  * Manages CLEO's integration with Gemini CLI by:
- * 1. Registering the CLEO MCP server in ~/.gemini/settings.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; Gemini CLI
+ * does not have an MCP or plugin registration mechanism.
  *
  * @task T161
  * @epic T134
@@ -23,7 +26,7 @@ export declare class GeminiCliInstallProvider implements AdapterInstallProvider
     /**
      * 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
      */
@@ -31,7 +34,6 @@ export declare class GeminiCliInstallProvider implements AdapterInstallProvider
     /**
      * 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
      */
@@ -39,8 +41,7 @@ export declare class GeminiCliInstallProvider implements AdapterInstallProvider
     /**
      * 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
      */
     isInstalled(): Promise<boolean>;
@@ -53,16 +54,6 @@ export declare class GeminiCliInstallProvider implements AdapterInstallProvider
      * @task T161
      */
     ensureInstructionReferences(projectDir: string): Promise<void>;
-    /**
-     * 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
-     */
-    private registerMcpServer;
     /**
      * Update AGENTS.md with CLEO @-references.
      *

package/dist/providers/gemini-cli/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/gemini-cli/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAQjG;;;;;;;;;GASG;AACH,qBAAa,wBAAyB,YAAW,sBAAsB;IACrE;;;;;;OAMG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IA8B9D;;;;;;OAMG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBhC;;;;;;OAMG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAiBrC;;;;;;;OAOG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;;;;;;;OAQG;IACH,OAAO,CAAC,iBAAiB;IA6BzB;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;CA4B9B"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/gemini-cli/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAKjG;;;;;;;;;;;;;GAaG;AACH,qBAAa,wBAAyB,YAAW,sBAAsB;IACrE;;;;;;OAMG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAqB9D;;;;;OAKG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAIhC;;;;;OAKG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAgBrC;;;;;;;OAOG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;CA4B9B"}

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

@@ -3,7 +3,7 @@
  *
  * Main CLEOProviderAdapter implementation for Moonshot AI Kimi.
  * Provides install-only capabilities for CLEO integration.
- * Kimi has no native hook system, so integration is via MCP only.
+ * Kimi has no native hook system; integration is via instruction files.
  *
  * @task T163
  * @epic T134
@@ -16,19 +16,32 @@ import { KimiInstallProvider } from './install.js';
  *
  * Bridges CLEO's adapter system with Kimi's integration surface:
  * - Hooks: No-op (Kimi has no native hook system)
- * - Install: Registers MCP server in ~/.kimi/mcp.json and ensures AGENTS.md references
+ * - Install: Ensures AGENTS.md references for CLEO instruction files
+ *
+ * @remarks
+ * Kimi has no native hook or event system, so all hook-related capabilities
+ * are disabled. The adapter is install-only, managing AGENTS.md references
+ * for CLEO instruction injection.
  *
  * @task T163
  * @epic T134
  */
 export declare class KimiAdapter implements CLEOProviderAdapter {
+    /** Unique provider identifier. */
     readonly id = "kimi";
+    /** Human-readable provider name. */
     readonly name = "Kimi";
+    /** Adapter version string. */
     readonly version = "1.0.0";
+    /** Declared capabilities for this provider. */
     capabilities: AdapterCapabilities;
+    /** Hook provider (no-op since Kimi has no event system). */
     hooks: KimiHookProvider;
+    /** Install provider for managing instruction files. */
     install: KimiInstallProvider;
+    /** Project directory this adapter was initialized with, or null. */
     private projectDir;
+    /** Whether {@link initialize} has been called. */
     private initialized;
     constructor();
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/providers/kimi/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAInD;;;;;;;;;GASG;AACH,qBAAa,WAAY,YAAW,mBAAmB;IACrD,QAAQ,CAAC,EAAE,UAAU;IACrB,QAAQ,CAAC,IAAI,UAAU;IACvB,QAAQ,CAAC,OAAO,WAAW;IAE3B,YAAY,EAAE,mBAAmB,CAY/B;IAEF,KAAK,EAAE,gBAAgB,CAAC;IACxB,OAAO,EAAE,mBAAmB,CAAC;IAE7B,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,WAAW,CAAS;;IAO5B;;;;;OAKG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnD;;;;;;OAMG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAK9B;;;;;;;;;;OAUG;IACG,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAqCjD;;;OAGG;IACH,aAAa,IAAI,OAAO;IAIxB;;;OAGG;IACH,aAAa,IAAI,MAAM,GAAG,IAAI;CAG/B"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/providers/kimi/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAInD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,WAAY,YAAW,mBAAmB;IACrD,kCAAkC;IAClC,QAAQ,CAAC,EAAE,UAAU;IACrB,oCAAoC;IACpC,QAAQ,CAAC,IAAI,UAAU;IACvB,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,WAAW;IAE3B,+CAA+C;IAC/C,YAAY,EAAE,mBAAmB,CAY/B;IAEF,4DAA4D;IAC5D,KAAK,EAAE,gBAAgB,CAAC;IACxB,uDAAuD;IACvD,OAAO,EAAE,mBAAmB,CAAC;IAE7B,oEAAoE;IACpE,OAAO,CAAC,UAAU,CAAuB;IACzC,kDAAkD;IAClD,OAAO,CAAC,WAAW,CAAS;;IAO5B;;;;;OAKG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnD;;;;;;OAMG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAK9B;;;;;;;;;;OAUG;IACG,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAqCjD;;;OAGG;IACH,aAAa,IAAI,OAAO;IAIxB;;;OAGG;IACH,aAAa,IAAI,MAAM,GAAG,IAAI;CAG/B"}

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

@@ -16,10 +16,16 @@ import type { AdapterHookProvider } from '@cleocode/contracts';
  * All hook-related methods are no-ops; mapProviderEvent always
  * returns null since there are no events to map.
  *
+ * @remarks
+ * Since Kimi has no hookable events, the event map is empty and
+ * `mapProviderEvent` always returns null. Registration state is tracked
+ * purely for interface compliance with {@link AdapterHookProvider}.
+ *
  * @task T163
  * @epic T134
  */
 export declare class KimiHookProvider implements AdapterHookProvider {
+    /** Whether hooks have been registered (always a no-op for Kimi). */
     private registered;
     /**
      * Map a Kimi native event name to a CAAMP hook event name.

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

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/providers/kimi/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D;;;;;;;;;GASG;AACH,qBAAa,gBAAiB,YAAW,mBAAmB;IAC1D,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;;;;;OAQG;IACH,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIvD;;;;;;;;OAQG;IACG,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D;;;;;OAKG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5C;;;OAGG;IACH,YAAY,IAAI,OAAO;IAIvB;;;;;OAKG;IACH,WAAW,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAGhD"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/providers/kimi/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D;;;;;;;;;;;;;;GAcG;AACH,qBAAa,gBAAiB,YAAW,mBAAmB;IAC1D,oEAAoE;IACpE,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;;;;;OAQG;IACH,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIvD;;;;;;;;OAQG;IACG,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D;;;;;OAKG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5C;;;OAGG;IACH,YAAY,IAAI,OAAO;IAIvB;;;;;OAKG;IACH,WAAW,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAGhD"}

package/dist/providers/kimi/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * Kimi provider adapter.
+ * @packageDocumentation
  *
  * CLEO provider adapter for Moonshot AI Kimi.
  * Default export is the adapter class for dynamic loading by AdapterManager.
@@ -16,6 +16,21 @@ export default KimiAdapter;
  * Factory function for creating adapter instances.
  * Used by AdapterManager's dynamic import fallback.
  *
+ * @remarks
+ * This is the primary entry point for dynamic adapter loading.
+ * AdapterManager calls this function when it resolves the kimi
+ * provider via its import-based discovery mechanism.
+ *
+ * @returns A new {@link KimiAdapter} instance ready for initialization
+ *
+ * @example
+ * ```typescript
+ * import { createAdapter } from '@cleocode/adapters/providers/kimi';
+ *
+ * const adapter = createAdapter();
+ * await adapter.initialize('/path/to/project');
+ * ```
+ *
  * @task T163
  */
 export declare function createAdapter(): KimiAdapter;

package/dist/providers/kimi/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/kimi/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD,eAAe,WAAW,CAAC;AAE3B;;;;;GAKG;AACH,wBAAgB,aAAa,IAAI,WAAW,CAE3C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/kimi/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD,eAAe,WAAW,CAAC;AAE3B;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,IAAI,WAAW,CAE3C"}

package/dist/providers/kimi/install.d.ts

@@ -2,12 +2,8 @@
  * Kimi Install Provider
  *
  * Handles CLEO installation into Kimi environments:
- * - Registers CLEO MCP server in ~/.kimi/mcp.json
  * - Ensures AGENTS.md has CLEO @-references
  *
- * Kimi has no native hook system, so this is the primary integration
- * mechanism: registering the MCP server so CLEO can be accessed as a tool.
- *
  * @task T163
  * @epic T134
  */
@@ -16,11 +12,12 @@ import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cle
  * Install provider for Kimi.
  *
  * Manages CLEO's integration with Kimi by:
- * 1. Registering the CLEO MCP server in ~/.kimi/mcp.json
- * 2. Ensuring AGENTS.md contains @-references to CLEO instruction files
+ * 1. Ensuring AGENTS.md contains @-references to CLEO instruction files
  *
- * Since Kimi has no native hook system, MCP registration is the only
- * mechanism for surfacing CLEO capabilities inside a Kimi session.
+ * @remarks
+ * Installation is idempotent -- running install multiple times on the same
+ * project produces the same result. Only AGENTS.md is managed; Kimi does
+ * not have an MCP or plugin registration mechanism.
  *
  * @task T163
  * @epic T134
@@ -29,7 +26,7 @@ export declare class KimiInstallProvider implements AdapterInstallProvider {
     /**
      * 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
      */
@@ -37,7 +34,6 @@ export declare class KimiInstallProvider implements AdapterInstallProvider {
     /**
      * 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
      */
@@ -45,8 +41,7 @@ export declare class KimiInstallProvider implements AdapterInstallProvider {
     /**
      * 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
      */
     isInstalled(): Promise<boolean>;
@@ -59,16 +54,6 @@ export declare class KimiInstallProvider implements AdapterInstallProvider {
      * @task T163
      */
     ensureInstructionReferences(projectDir: string): Promise<void>;
-    /**
-     * 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
-     */
-    private registerMcpServer;
     /**
      * Update AGENTS.md with CLEO @-references.
      *

package/dist/providers/kimi/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/kimi/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAQjG;;;;;;;;;;;;GAYG;AACH,qBAAa,mBAAoB,YAAW,sBAAsB;IAChE;;;;;;OAMG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IA8B9D;;;;;;OAMG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBhC;;;;;;OAMG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAiBrC;;;;;;;OAOG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;;;;;;;OAQG;IACH,OAAO,CAAC,iBAAiB;IA6BzB;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;CA4B9B"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/kimi/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAKjG;;;;;;;;;;;;;GAaG;AACH,qBAAa,mBAAoB,YAAW,sBAAsB;IAChE;;;;;;OAMG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAqB9D;;;;;OAKG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAIhC;;;;;OAKG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAgBrC;;;;;;;OAOG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;CA4B9B"}

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

@@ -16,17 +16,33 @@ import { OpenCodeSpawnProvider } from './spawn.js';
  * 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
+ * - Install: Ensures AGENTS.md references for CLEO instruction files
+ *
+ * @remarks
+ * OpenCode is the second-most feature-complete adapter after Claude Code,
+ * supporting 10 canonical events through its JavaScript plugin system,
+ * subagent spawning via the `opencode run` CLI command, and instruction
+ * file management via AGENTS.md. It uniquely supports PreModel via the
+ * `chat.params` event, which allows pre-inference parameter injection.
  */
 export declare class OpenCodeAdapter implements CLEOProviderAdapter {
+    /** Unique provider identifier. */
     readonly id = "opencode";
+    /** Human-readable provider name. */
     readonly name = "OpenCode";
+    /** Adapter version string. */
     readonly version = "1.0.0";
+    /** Declared capabilities for this provider. */
     capabilities: AdapterCapabilities;
+    /** Hook provider for CAAMP event mapping via OpenCode's plugin system. */
     hooks: OpenCodeHookProvider;
+    /** Spawn provider for launching subagent processes via `opencode run`. */
     spawn: OpenCodeSpawnProvider;
+    /** Install provider for managing AGENTS.md instruction files. */
     install: OpenCodeInstallProvider;
+    /** Project directory this adapter was initialized with, or null. */
     private projectDir;
+    /** Whether {@link initialize} has been called. */
     private initialized;
     constructor();
     /**

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

@@ -1 +1 @@
-{"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,CA2B/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"}
+{"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;;;;;;;;;;;;;;GAcG;AACH,qBAAa,eAAgB,YAAW,mBAAmB;IACzD,kCAAkC;IAClC,QAAQ,CAAC,EAAE,cAAc;IACzB,oCAAoC;IACpC,QAAQ,CAAC,IAAI,cAAc;IAC3B,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,WAAW;IAE3B,+CAA+C;IAC/C,YAAY,EAAE,mBAAmB,CA2B/B;IAEF,0EAA0E;IAC1E,KAAK,EAAE,oBAAoB,CAAC;IAC5B,0EAA0E;IAC1E,KAAK,EAAE,qBAAqB,CAAC;IAC7B,iEAAiE;IACjE,OAAO,EAAE,uBAAuB,CAAC;IAEjC,oEAAoE;IACpE,OAAO,CAAC,UAAU,CAAuB;IACzC,kDAAkD;IAClD,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/hooks.d.ts

@@ -33,10 +33,19 @@ import type { AdapterHookProvider } from '@cleocode/contracts';
  * provider), `registerNativeHooks` and `unregisterNativeHooks` track registration
  * state without performing filesystem operations.
  *
+ * @remarks
+ * OpenCode uses dot-delimited and `event:`-prefixed event names
+ * (e.g. `event:session.created`, `tool.execute.before`) which differ
+ * significantly from the PascalCase CAAMP canonical names. The static
+ * event map covers all 10 supported events. Async CAAMP accessors
+ * (`getSupportedCanonicalEvents`, `getProviderProfile`, `toNativeEvent`)
+ * call the normalizer directly when available and fall back to the static map.
+ *
  * @task T164
  * @epic T134
  */
 export declare class OpenCodeHookProvider implements AdapterHookProvider {
+    /** Whether hooks have been registered for the current session. */
     private registered;
     /**
      * Map an OpenCode native event name to a CAAMP canonical hook event name.

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

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/providers/opencode/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAuC/D;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,oBAAqB,YAAW,mBAAmB;IAC9D,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;;;;;;;;OAWG;IACH,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAItD;;;;;;;;;;;;OAYG;IACG,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D;;;;;;;OAOG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5C;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;;;;;;;OAQG;IACH,WAAW,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAI/C;;;;;;;;;;OAUG;IACG,2BAA2B,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAStD;;;;;;;;;;OAUG;IACG,kBAAkB,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IASnD;;;;;;;;;OASG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAU/D"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/providers/opencode/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAuC/D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,oBAAqB,YAAW,mBAAmB;IAC9D,kEAAkE;IAClE,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;;;;;;;;OAWG;IACH,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAItD;;;;;;;;;;;;OAYG;IACG,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D;;;;;;;OAOG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5C;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;;;;;;;OAQG;IACH,WAAW,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAI/C;;;;;;;;;;OAUG;IACG,2BAA2B,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAStD;;;;;;;;;;OAUG;IACG,kBAAkB,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IASnD;;;;;;;;;OASG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAU/D"}

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

@@ -1,5 +1,5 @@
 /**
- * OpenCode provider adapter.
+ * @packageDocumentation
  *
  * CLEO provider adapter for OpenCode AI coding assistant.
  * Default export is the adapter class for dynamic loading by AdapterManager.
@@ -15,6 +15,21 @@ export default OpenCodeAdapter;
 /**
  * Factory function for creating adapter instances.
  * Used by AdapterManager's dynamic import fallback.
+ *
+ * @remarks
+ * This is the primary entry point for dynamic adapter loading.
+ * AdapterManager calls this function when it resolves the opencode
+ * provider via its import-based discovery mechanism.
+ *
+ * @returns A new {@link OpenCodeAdapter} instance ready for initialization
+ *
+ * @example
+ * ```typescript
+ * import { createAdapter } from '@cleocode/adapters/providers/opencode';
+ *
+ * const adapter = createAdapter();
+ * await adapter.initialize('/path/to/project');
+ * ```
  */
 export declare function createAdapter(): OpenCodeAdapter;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/opencode/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,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEnD,eAAe,eAAe,CAAC;AAE/B;;;GAGG;AACH,wBAAgB,aAAa,IAAI,eAAe,CAE/C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/opencode/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,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEnD,eAAe,eAAe,CAAC;AAE/B;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,IAAI,eAAe,CAE/C"}