@cleocode/adapters 2026.4.13 → 2026.4.14

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

@@ -0,0 +1,50 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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/gemini-cli/adapter.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Gemini CLI Adapter
+ *
+ * Main CLEOProviderAdapter implementation for Google Gemini CLI.
+ * Provides hooks and install capabilities for CLEO integration.
+ *
+ * @task T161
+ * @epic T134
+ */
+import type { AdapterCapabilities, AdapterHealthStatus, CLEOProviderAdapter } from '@cleocode/contracts';
+import { GeminiCliHookProvider } from './hooks.js';
+import { GeminiCliInstallProvider } from './install.js';
+/**
+ * CLEO provider adapter for Google Gemini CLI.
+ *
+ * Bridges CLEO's adapter system with Gemini CLI's native capabilities:
+ * - Hooks: Maps Gemini CLI events (SessionStart, PreToolUse, etc.) to CAAMP events
+ * - 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();
+    /**
+     * Initialize the adapter for a given project directory.
+     *
+     * @param projectDir - Root directory of the project
+     * @task T161
+     */
+    initialize(projectDir: string): Promise<void>;
+    /**
+     * Dispose the adapter and clean up resources.
+     *
+     * Unregisters hooks and releases any tracked state.
+     * @task T161
+     */
+    dispose(): Promise<void>;
+    /**
+     * Run a health check to verify Gemini CLI is accessible.
+     *
+     * Checks:
+     * 1. Adapter has been initialized
+     * 2. Gemini CLI binary is available in PATH
+     * 3. ~/.gemini/ configuration directory exists
+     *
+     * @returns Health status with details about each check
+     * @task T161
+     */
+    healthCheck(): Promise<AdapterHealthStatus>;
+    /**
+     * Check whether the adapter has been initialized.
+     * @task T161
+     */
+    isInitialized(): boolean;
+    /**
+     * Get the project directory this adapter was initialized with.
+     * @task T161
+     */
+    getProjectDir(): string | null;
+}
+//# sourceMappingURL=adapter.d.ts.map

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

@@ -0,0 +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;;;;;;;;;;;;;;;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,CAsB/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

@@ -0,0 +1,99 @@
+/**
+ * Gemini CLI Hook Provider
+ *
+ * Maps Gemini CLI's native hook events to CAAMP canonical hook events.
+ * Gemini CLI supports 11 canonical events through its hook system.
+ *
+ * Gemini CLI event mapping:
+ * - SessionStart        -> SessionStart
+ * - SessionEnd          -> SessionEnd
+ * - PromptSubmit        -> BeforeAgent
+ * - ResponseComplete    -> AfterAgent
+ * - PreToolUse          -> BeforeTool
+ * - PostToolUse         -> AfterTool
+ * - PreModel            -> BeforeModel
+ * - PostModel           -> AfterModel
+ * - PreCompact          -> PreCompress
+ * - Notification        -> Notification
+ *
+ * @task T161
+ * @epic T134
+ */
+import type { AdapterHookProvider } from '@cleocode/contracts';
+/**
+ * Hook provider for Gemini CLI.
+ *
+ * Gemini CLI registers hooks via its configuration system at
+ * ~/.gemini/. Hook handlers are shell scripts or commands 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.
+ *
+ * @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.
+     *
+     * @param providerEvent - Gemini CLI event name (e.g. "SessionStart", "PreToolUse")
+     * @returns CAAMP event name or null if unmapped
+     * @task T161
+     */
+    mapProviderEvent(providerEvent: string): string | null;
+    /**
+     * Register native hooks for a project.
+     *
+     * For Gemini CLI, hooks are registered via the config system
+     * (~/.gemini/), which is handled by the install provider.
+     * This method marks hooks as registered without performing
+     * filesystem operations.
+     *
+     * @param _projectDir - Project directory (unused; hooks are global)
+     * @task T161
+     */
+    registerNativeHooks(_projectDir: string): Promise<void>;
+    /**
+     * Unregister native hooks.
+     *
+     * For Gemini CLI, this is a no-op since hooks are managed through
+     * the config system. Unregistration happens via the install
+     * provider's uninstall method.
+     * @task T161
+     */
+    unregisterNativeHooks(): Promise<void>;
+    /**
+     * Check whether hooks have been registered via registerNativeHooks.
+     * @task T161
+     */
+    isRegistered(): boolean;
+    /**
+     * Get the full event mapping for introspection/debugging.
+     * @task T161
+     */
+    getEventMap(): Readonly<Record<string, string>>;
+    /**
+     * Extract a plain-text transcript from Gemini CLI session data.
+     *
+     * Reads the most recent JSON/JSONL session file under `~/.gemini/`
+     * and returns its turns as a flat string for brain observation extraction.
+     *
+     * Returns null when no session data is found or on any read error.
+     *
+     * @param _sessionId - CLEO session ID (unused; reads the most recent file)
+     * @param _projectDir - Project directory (unused; Gemini CLI uses global paths)
+     * @task T161 @epic T134
+     */
+    getTranscript(_sessionId: string, _projectDir: string): Promise<string | null>;
+}
+//# sourceMappingURL=hooks.d.ts.map

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

@@ -0,0 +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;;;;;;;;;;;;;;;;;;;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

@@ -0,0 +1,37 @@
+/**
+ * @packageDocumentation
+ *
+ * CLEO provider adapter for Google Gemini CLI.
+ * Default export is the adapter class for dynamic loading by AdapterManager.
+ *
+ * @task T161
+ * @epic T134
+ */
+import { GeminiCliAdapter } from './adapter.js';
+export { GeminiCliAdapter } from './adapter.js';
+export { GeminiCliHookProvider } from './hooks.js';
+export { GeminiCliInstallProvider } from './install.js';
+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;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,IAAI,gBAAgB,CAEhD"}

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

@@ -0,0 +1,65 @@
+/**
+ * Gemini CLI Install Provider
+ *
+ * Handles CLEO installation into Gemini CLI environments:
+ * - Ensures AGENTS.md has CLEO @-references
+ *
+ * @task T161
+ * @epic T134
+ */
+import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cleocode/contracts';
+/**
+ * Install provider for Gemini CLI.
+ *
+ * Manages CLEO's integration with Gemini CLI by:
+ * 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
+ */
+export declare class GeminiCliInstallProvider implements AdapterInstallProvider {
+    /**
+     * Install CLEO into a Gemini CLI environment.
+     *
+     * @param options - Installation options including project directory
+     * @returns Result describing what was installed
+     * @task T161
+     */
+    install(options: InstallOptions): Promise<InstallResult>;
+    /**
+     * Uninstall CLEO from the Gemini CLI environment.
+     *
+     * Does not remove AGENTS.md references (they are harmless if CLEO is not present).
+     * @task T161
+     */
+    uninstall(): Promise<void>;
+    /**
+     * Check whether CLEO is installed in the Gemini CLI environment.
+     *
+     * Checks for CLEO references in AGENTS.md.
+     * @task T161
+     */
+    isInstalled(): Promise<boolean>;
+    /**
+     * Ensure AGENTS.md contains @-references to CLEO instruction files.
+     *
+     * Creates AGENTS.md if it does not exist. Appends any missing references.
+     *
+     * @param projectDir - Project root directory
+     * @task T161
+     */
+    ensureInstructionReferences(projectDir: string): Promise<void>;
+    /**
+     * Update AGENTS.md with CLEO @-references.
+     *
+     * @param projectDir - Project root directory
+     * @returns true if the file was created or modified
+     */
+    private updateInstructionFile;
+}
+//# sourceMappingURL=install.d.ts.map

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

@@ -0,0 +1 @@
+{"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;IAoB9D;;;;;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

@@ -0,0 +1,85 @@
+/**
+ * Kimi Adapter
+ *
+ * Main CLEOProviderAdapter implementation for Moonshot AI Kimi.
+ * Provides install-only capabilities for CLEO integration.
+ * Kimi has no native hook system; integration is via instruction files.
+ *
+ * @task T163
+ * @epic T134
+ */
+import type { AdapterCapabilities, AdapterHealthStatus, CLEOProviderAdapter } from '@cleocode/contracts';
+import { KimiHookProvider } from './hooks.js';
+import { KimiInstallProvider } from './install.js';
+/**
+ * CLEO provider adapter for Moonshot AI Kimi.
+ *
+ * Bridges CLEO's adapter system with Kimi's integration surface:
+ * - Hooks: No-op (Kimi has no native hook system)
+ * - 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();
+    /**
+     * Initialize the adapter for a given project directory.
+     *
+     * @param projectDir - Root directory of the project
+     * @task T163
+     */
+    initialize(projectDir: string): Promise<void>;
+    /**
+     * Dispose the adapter and clean up resources.
+     *
+     * Releases tracked state. No hooks to unregister since Kimi
+     * has no native hook system.
+     * @task T163
+     */
+    dispose(): Promise<void>;
+    /**
+     * Run a health check to verify Kimi is accessible.
+     *
+     * Checks:
+     * 1. Adapter has been initialized
+     * 2. Kimi CLI binary is available in PATH
+     * 3. ~/.kimi/ configuration directory exists
+     *
+     * @returns Health status with details about each check
+     * @task T163
+     */
+    healthCheck(): Promise<AdapterHealthStatus>;
+    /**
+     * Check whether the adapter has been initialized.
+     * @task T163
+     */
+    isInitialized(): boolean;
+    /**
+     * Get the project directory this adapter was initialized with.
+     * @task T163
+     */
+    getProjectDir(): string | null;
+}
+//# sourceMappingURL=adapter.d.ts.map

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

@@ -0,0 +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;;;;;;;;;;;;;;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,CAW/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

@@ -0,0 +1,70 @@
+/**
+ * Kimi Hook Provider
+ *
+ * Kimi has no native hook system (hookSystem is "none").
+ * This provider implements the minimal AdapterHookProvider interface
+ * with a no-op mapProviderEvent that always returns null.
+ *
+ * @task T163
+ * @epic T134
+ */
+import type { AdapterHookProvider } from '@cleocode/contracts';
+/**
+ * Hook provider for Kimi.
+ *
+ * Kimi does not expose a native hook or event system.
+ * 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.
+     *
+     * Kimi has no hook system, so this always returns null.
+     *
+     * @param _providerEvent - Unused; Kimi emits no hookable events
+     * @returns Always null
+     * @task T163
+     */
+    mapProviderEvent(_providerEvent: string): string | null;
+    /**
+     * Register native hooks for a project.
+     *
+     * Kimi has no hook system. This method is a no-op and only
+     * tracks registration state for interface compliance.
+     *
+     * @param _projectDir - Project directory (unused)
+     * @task T163
+     */
+    registerNativeHooks(_projectDir: string): Promise<void>;
+    /**
+     * Unregister native hooks.
+     *
+     * Kimi has no hook system. This method is a no-op.
+     * @task T163
+     */
+    unregisterNativeHooks(): Promise<void>;
+    /**
+     * Check whether hooks have been registered via registerNativeHooks.
+     * @task T163
+     */
+    isRegistered(): boolean;
+    /**
+     * Get the full event mapping for introspection/debugging.
+     *
+     * Returns an empty map since Kimi has no hookable events.
+     * @task T163
+     */
+    getEventMap(): Readonly<Record<string, string>>;
+}
+//# sourceMappingURL=hooks.d.ts.map

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

@@ -0,0 +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;;;;;;;;;;;;;;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

@@ -0,0 +1,37 @@
+/**
+ * @packageDocumentation
+ *
+ * CLEO provider adapter for Moonshot AI Kimi.
+ * Default export is the adapter class for dynamic loading by AdapterManager.
+ *
+ * @task T163
+ * @epic T134
+ */
+import { KimiAdapter } from './adapter.js';
+export { KimiAdapter } from './adapter.js';
+export { KimiHookProvider } from './hooks.js';
+export { KimiInstallProvider } from './install.js';
+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;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,IAAI,WAAW,CAE3C"}

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

@@ -0,0 +1,65 @@
+/**
+ * Kimi Install Provider
+ *
+ * Handles CLEO installation into Kimi environments:
+ * - Ensures AGENTS.md has CLEO @-references
+ *
+ * @task T163
+ * @epic T134
+ */
+import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cleocode/contracts';
+/**
+ * Install provider for Kimi.
+ *
+ * Manages CLEO's integration with Kimi by:
+ * 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; Kimi does
+ * not have an MCP or plugin registration mechanism.
+ *
+ * @task T163
+ * @epic T134
+ */
+export declare class KimiInstallProvider implements AdapterInstallProvider {
+    /**
+     * Install CLEO into a Kimi environment.
+     *
+     * @param options - Installation options including project directory
+     * @returns Result describing what was installed
+     * @task T163
+     */
+    install(options: InstallOptions): Promise<InstallResult>;
+    /**
+     * Uninstall CLEO from the Kimi environment.
+     *
+     * Does not remove AGENTS.md references (they are harmless if CLEO is not present).
+     * @task T163
+     */
+    uninstall(): Promise<void>;
+    /**
+     * Check whether CLEO is installed in the Kimi environment.
+     *
+     * Checks for CLEO references in AGENTS.md.
+     * @task T163
+     */
+    isInstalled(): Promise<boolean>;
+    /**
+     * Ensure AGENTS.md contains @-references to CLEO instruction files.
+     *
+     * Creates AGENTS.md if it does not exist. Appends any missing references.
+     *
+     * @param projectDir - Project root directory
+     * @task T163
+     */
+    ensureInstructionReferences(projectDir: string): Promise<void>;
+    /**
+     * Update AGENTS.md with CLEO @-references.
+     *
+     * @param projectDir - Project root directory
+     * @returns true if the file was created or modified
+     */
+    private updateInstructionFile;
+}
+//# sourceMappingURL=install.d.ts.map

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

@@ -0,0 +1 @@
+{"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;IAoB9D;;;;;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"}