@cleocode/adapters 2026.3.72 → 2026.3.73

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (96) hide show
  1. package/dist/index.d.ts +3 -0
  2. package/dist/index.d.ts.map +1 -1
  3. package/dist/index.js +1227 -101
  4. package/dist/index.js.map +4 -4
  5. package/dist/providers/claude-code/adapter.d.ts.map +1 -1
  6. package/dist/providers/claude-code/adapter.js +16 -5
  7. package/dist/providers/claude-code/adapter.js.map +1 -1
  8. package/dist/providers/claude-code/hooks.d.ts +89 -25
  9. package/dist/providers/claude-code/hooks.d.ts.map +1 -1
  10. package/dist/providers/claude-code/hooks.js +230 -28
  11. package/dist/providers/claude-code/hooks.js.map +1 -1
  12. package/dist/providers/codex/adapter.d.ts +70 -0
  13. package/dist/providers/codex/adapter.d.ts.map +1 -0
  14. package/dist/providers/codex/adapter.js +134 -0
  15. package/dist/providers/codex/adapter.js.map +1 -0
  16. package/dist/providers/codex/hooks.d.ts +85 -0
  17. package/dist/providers/codex/hooks.d.ts.map +1 -0
  18. package/dist/providers/codex/hooks.js +155 -0
  19. package/dist/providers/codex/hooks.js.map +1 -0
  20. package/dist/providers/codex/index.d.ts +22 -0
  21. package/dist/providers/codex/index.d.ts.map +1 -0
  22. package/dist/providers/codex/index.js +24 -0
  23. package/dist/providers/codex/index.js.map +1 -0
  24. package/dist/providers/codex/install.d.ts +74 -0
  25. package/dist/providers/codex/install.d.ts.map +1 -0
  26. package/dist/providers/codex/install.js +183 -0
  27. package/dist/providers/codex/install.js.map +1 -0
  28. package/dist/providers/cursor/adapter.d.ts.map +1 -1
  29. package/dist/providers/cursor/adapter.js +16 -2
  30. package/dist/providers/cursor/adapter.js.map +1 -1
  31. package/dist/providers/cursor/hooks.d.ts +102 -17
  32. package/dist/providers/cursor/hooks.d.ts.map +1 -1
  33. package/dist/providers/cursor/hooks.js +164 -18
  34. package/dist/providers/cursor/hooks.js.map +1 -1
  35. package/dist/providers/gemini-cli/adapter.d.ts +70 -0
  36. package/dist/providers/gemini-cli/adapter.d.ts.map +1 -0
  37. package/dist/providers/gemini-cli/adapter.js +145 -0
  38. package/dist/providers/gemini-cli/adapter.js.map +1 -0
  39. package/dist/providers/gemini-cli/hooks.d.ts +92 -0
  40. package/dist/providers/gemini-cli/hooks.d.ts.map +1 -0
  41. package/dist/providers/gemini-cli/hooks.js +169 -0
  42. package/dist/providers/gemini-cli/hooks.js.map +1 -0
  43. package/dist/providers/gemini-cli/index.d.ts +22 -0
  44. package/dist/providers/gemini-cli/index.d.ts.map +1 -0
  45. package/dist/providers/gemini-cli/index.js +24 -0
  46. package/dist/providers/gemini-cli/index.js.map +1 -0
  47. package/dist/providers/gemini-cli/install.d.ts +74 -0
  48. package/dist/providers/gemini-cli/install.d.ts.map +1 -0
  49. package/dist/providers/gemini-cli/install.js +183 -0
  50. package/dist/providers/gemini-cli/install.js.map +1 -0
  51. package/dist/providers/kimi/adapter.d.ts +72 -0
  52. package/dist/providers/kimi/adapter.d.ts.map +1 -0
  53. package/dist/providers/kimi/adapter.js +133 -0
  54. package/dist/providers/kimi/adapter.js.map +1 -0
  55. package/dist/providers/kimi/hooks.d.ts +64 -0
  56. package/dist/providers/kimi/hooks.d.ts.map +1 -0
  57. package/dist/providers/kimi/hooks.js +73 -0
  58. package/dist/providers/kimi/hooks.js.map +1 -0
  59. package/dist/providers/kimi/index.d.ts +22 -0
  60. package/dist/providers/kimi/index.d.ts.map +1 -0
  61. package/dist/providers/kimi/index.js +24 -0
  62. package/dist/providers/kimi/index.js.map +1 -0
  63. package/dist/providers/kimi/install.d.ts +80 -0
  64. package/dist/providers/kimi/install.d.ts.map +1 -0
  65. package/dist/providers/kimi/install.js +189 -0
  66. package/dist/providers/kimi/install.js.map +1 -0
  67. package/dist/providers/opencode/adapter.d.ts.map +1 -1
  68. package/dist/providers/opencode/adapter.js +13 -6
  69. package/dist/providers/opencode/adapter.js.map +1 -1
  70. package/dist/providers/opencode/hooks.d.ts +89 -28
  71. package/dist/providers/opencode/hooks.d.ts.map +1 -1
  72. package/dist/providers/opencode/hooks.js +145 -37
  73. package/dist/providers/opencode/hooks.js.map +1 -1
  74. package/package.json +3 -2
  75. package/src/index.ts +18 -0
  76. package/src/providers/claude-code/adapter.ts +16 -5
  77. package/src/providers/claude-code/hooks.ts +154 -30
  78. package/src/providers/codex/adapter.ts +154 -0
  79. package/src/providers/codex/hooks.ts +163 -0
  80. package/src/providers/codex/index.ts +27 -0
  81. package/src/providers/codex/install.ts +203 -0
  82. package/src/providers/codex/manifest.json +28 -0
  83. package/src/providers/cursor/adapter.ts +16 -2
  84. package/src/providers/cursor/hooks.ts +167 -18
  85. package/src/providers/gemini-cli/adapter.ts +165 -0
  86. package/src/providers/gemini-cli/hooks.ts +177 -0
  87. package/src/providers/gemini-cli/index.ts +27 -0
  88. package/src/providers/gemini-cli/install.ts +203 -0
  89. package/src/providers/gemini-cli/manifest.json +35 -0
  90. package/src/providers/kimi/adapter.ts +153 -0
  91. package/src/providers/kimi/hooks.ts +80 -0
  92. package/src/providers/kimi/index.ts +27 -0
  93. package/src/providers/kimi/install.ts +209 -0
  94. package/src/providers/kimi/manifest.json +24 -0
  95. package/src/providers/opencode/adapter.ts +13 -6
  96. package/src/providers/opencode/hooks.ts +146 -37
@@ -0,0 +1,183 @@
1
+ /**
2
+ * Gemini CLI Install Provider
3
+ *
4
+ * Handles CLEO installation into Gemini CLI environments:
5
+ * - Registers CLEO MCP server in ~/.gemini/settings.json
6
+ * - Ensures AGENTS.md has CLEO @-references
7
+ *
8
+ * @task T161
9
+ * @epic T134
10
+ */
11
+ import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
12
+ import { homedir } from 'node:os';
13
+ import { join } from 'node:path';
14
+ /** Lines that should appear in AGENTS.md to reference CLEO. */
15
+ const INSTRUCTION_REFERENCES = ['@~/.cleo/templates/CLEO-INJECTION.md', '@.cleo/memory-bridge.md'];
16
+ /** MCP server registration key used in Gemini CLI settings. */
17
+ const MCP_SERVER_KEY = 'cleo';
18
+ /**
19
+ * Install provider for Gemini CLI.
20
+ *
21
+ * Manages CLEO's integration with Gemini CLI by:
22
+ * 1. Registering the CLEO MCP server in ~/.gemini/settings.json
23
+ * 2. Ensuring AGENTS.md contains @-references to CLEO instruction files
24
+ *
25
+ * @task T161
26
+ * @epic T134
27
+ */
28
+ export class GeminiCliInstallProvider {
29
+ /**
30
+ * Install CLEO into a Gemini CLI environment.
31
+ *
32
+ * @param options - Installation options including project directory and MCP server path
33
+ * @returns Result describing what was installed
34
+ * @task T161
35
+ */
36
+ async install(options) {
37
+ const { projectDir, mcpServerPath } = options;
38
+ const installedAt = new Date().toISOString();
39
+ let instructionFileUpdated = false;
40
+ let mcpRegistered = false;
41
+ const details = {};
42
+ // Step 1: Register MCP server in ~/.gemini/settings.json
43
+ if (mcpServerPath) {
44
+ mcpRegistered = this.registerMcpServer(mcpServerPath);
45
+ if (mcpRegistered) {
46
+ details.mcpConfigPath = join(homedir(), '.gemini', 'settings.json');
47
+ }
48
+ }
49
+ // Step 2: Ensure AGENTS.md has @-references
50
+ instructionFileUpdated = this.updateInstructionFile(projectDir);
51
+ if (instructionFileUpdated) {
52
+ details.instructionFile = join(projectDir, 'AGENTS.md');
53
+ }
54
+ return {
55
+ success: true,
56
+ installedAt,
57
+ instructionFileUpdated,
58
+ mcpRegistered,
59
+ details,
60
+ };
61
+ }
62
+ /**
63
+ * Uninstall CLEO from the Gemini CLI environment.
64
+ *
65
+ * Removes the MCP server registration from ~/.gemini/settings.json.
66
+ * Does not remove AGENTS.md references (they are harmless if CLEO is not present).
67
+ * @task T161
68
+ */
69
+ async uninstall() {
70
+ const settingsPath = join(homedir(), '.gemini', 'settings.json');
71
+ if (existsSync(settingsPath)) {
72
+ try {
73
+ const raw = readFileSync(settingsPath, 'utf-8');
74
+ const config = JSON.parse(raw);
75
+ const mcpServers = config.mcpServers;
76
+ if (mcpServers && MCP_SERVER_KEY in mcpServers) {
77
+ delete mcpServers[MCP_SERVER_KEY];
78
+ writeFileSync(settingsPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
79
+ }
80
+ }
81
+ catch {
82
+ // Ignore errors during uninstall
83
+ }
84
+ }
85
+ }
86
+ /**
87
+ * Check whether CLEO is installed in the Gemini CLI environment.
88
+ *
89
+ * Checks for MCP server registered in ~/.gemini/settings.json.
90
+ * Returns true if the CLEO MCP server entry is found.
91
+ * @task T161
92
+ */
93
+ async isInstalled() {
94
+ const settingsPath = join(homedir(), '.gemini', 'settings.json');
95
+ if (existsSync(settingsPath)) {
96
+ try {
97
+ const config = JSON.parse(readFileSync(settingsPath, 'utf-8'));
98
+ const mcpServers = config.mcpServers;
99
+ if (mcpServers && MCP_SERVER_KEY in mcpServers) {
100
+ return true;
101
+ }
102
+ }
103
+ catch {
104
+ // Fall through
105
+ }
106
+ }
107
+ return false;
108
+ }
109
+ /**
110
+ * Ensure AGENTS.md contains @-references to CLEO instruction files.
111
+ *
112
+ * Creates AGENTS.md if it does not exist. Appends any missing references.
113
+ *
114
+ * @param projectDir - Project root directory
115
+ * @task T161
116
+ */
117
+ async ensureInstructionReferences(projectDir) {
118
+ this.updateInstructionFile(projectDir);
119
+ }
120
+ /**
121
+ * Register the CLEO MCP server in ~/.gemini/settings.json.
122
+ *
123
+ * Gemini CLI stores its MCP server configuration in ~/.gemini/settings.json
124
+ * under the mcpServers key.
125
+ *
126
+ * @param mcpServerPath - Absolute path to the MCP server entry point
127
+ * @returns true if registration was performed or updated
128
+ */
129
+ registerMcpServer(mcpServerPath) {
130
+ const geminiDir = join(homedir(), '.gemini');
131
+ const settingsPath = join(geminiDir, 'settings.json');
132
+ let config = {};
133
+ mkdirSync(geminiDir, { recursive: true });
134
+ if (existsSync(settingsPath)) {
135
+ try {
136
+ config = JSON.parse(readFileSync(settingsPath, 'utf-8'));
137
+ }
138
+ catch {
139
+ // Start fresh on parse error
140
+ }
141
+ }
142
+ if (!config.mcpServers || typeof config.mcpServers !== 'object') {
143
+ config.mcpServers = {};
144
+ }
145
+ const mcpServers = config.mcpServers;
146
+ mcpServers[MCP_SERVER_KEY] = {
147
+ command: 'node',
148
+ args: [mcpServerPath],
149
+ };
150
+ writeFileSync(settingsPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
151
+ return true;
152
+ }
153
+ /**
154
+ * Update AGENTS.md with CLEO @-references.
155
+ *
156
+ * @param projectDir - Project root directory
157
+ * @returns true if the file was created or modified
158
+ */
159
+ updateInstructionFile(projectDir) {
160
+ const agentsMdPath = join(projectDir, 'AGENTS.md');
161
+ let content = '';
162
+ let existed = false;
163
+ if (existsSync(agentsMdPath)) {
164
+ content = readFileSync(agentsMdPath, 'utf-8');
165
+ existed = true;
166
+ }
167
+ const missingRefs = INSTRUCTION_REFERENCES.filter((ref) => !content.includes(ref));
168
+ if (missingRefs.length === 0) {
169
+ return false;
170
+ }
171
+ const refsBlock = missingRefs.join('\n');
172
+ if (existed) {
173
+ const separator = content.endsWith('\n') ? '' : '\n';
174
+ content = content + separator + refsBlock + '\n';
175
+ }
176
+ else {
177
+ content = refsBlock + '\n';
178
+ }
179
+ writeFileSync(agentsMdPath, content, 'utf-8');
180
+ return true;
181
+ }
182
+ }
183
+ //# sourceMappingURL=install.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"install.js","sourceRoot":"","sources":["../../../src/providers/gemini-cli/install.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,72 @@
1
+ /**
2
+ * Kimi Adapter
3
+ *
4
+ * Main CLEOProviderAdapter implementation for Moonshot AI Kimi.
5
+ * Provides install-only capabilities for CLEO integration.
6
+ * Kimi has no native hook system, so integration is via MCP only.
7
+ *
8
+ * @task T163
9
+ * @epic T134
10
+ */
11
+ import type { AdapterCapabilities, AdapterHealthStatus, CLEOProviderAdapter } from '@cleocode/contracts';
12
+ import { KimiHookProvider } from './hooks.js';
13
+ import { KimiInstallProvider } from './install.js';
14
+ /**
15
+ * CLEO provider adapter for Moonshot AI Kimi.
16
+ *
17
+ * Bridges CLEO's adapter system with Kimi's integration surface:
18
+ * - Hooks: No-op (Kimi has no native hook system)
19
+ * - Install: Registers MCP server in ~/.kimi/mcp.json and ensures AGENTS.md references
20
+ *
21
+ * @task T163
22
+ * @epic T134
23
+ */
24
+ export declare class KimiAdapter implements CLEOProviderAdapter {
25
+ readonly id = "kimi";
26
+ readonly name = "Kimi";
27
+ readonly version = "1.0.0";
28
+ capabilities: AdapterCapabilities;
29
+ hooks: KimiHookProvider;
30
+ install: KimiInstallProvider;
31
+ private projectDir;
32
+ private initialized;
33
+ constructor();
34
+ /**
35
+ * Initialize the adapter for a given project directory.
36
+ *
37
+ * @param projectDir - Root directory of the project
38
+ * @task T163
39
+ */
40
+ initialize(projectDir: string): Promise<void>;
41
+ /**
42
+ * Dispose the adapter and clean up resources.
43
+ *
44
+ * Releases tracked state. No hooks to unregister since Kimi
45
+ * has no native hook system.
46
+ * @task T163
47
+ */
48
+ dispose(): Promise<void>;
49
+ /**
50
+ * Run a health check to verify Kimi is accessible.
51
+ *
52
+ * Checks:
53
+ * 1. Adapter has been initialized
54
+ * 2. Kimi CLI binary is available in PATH
55
+ * 3. ~/.kimi/ configuration directory exists
56
+ *
57
+ * @returns Health status with details about each check
58
+ * @task T163
59
+ */
60
+ healthCheck(): Promise<AdapterHealthStatus>;
61
+ /**
62
+ * Check whether the adapter has been initialized.
63
+ * @task T163
64
+ */
65
+ isInitialized(): boolean;
66
+ /**
67
+ * Get the project directory this adapter was initialized with.
68
+ * @task T163
69
+ */
70
+ getProjectDir(): string | null;
71
+ }
72
+ //# sourceMappingURL=adapter.d.ts.map
@@ -0,0 +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"}
@@ -0,0 +1,133 @@
1
+ /**
2
+ * Kimi Adapter
3
+ *
4
+ * Main CLEOProviderAdapter implementation for Moonshot AI Kimi.
5
+ * Provides install-only capabilities for CLEO integration.
6
+ * Kimi has no native hook system, so integration is via MCP only.
7
+ *
8
+ * @task T163
9
+ * @epic T134
10
+ */
11
+ import { exec } from 'node:child_process';
12
+ import { existsSync } from 'node:fs';
13
+ import { homedir } from 'node:os';
14
+ import { join } from 'node:path';
15
+ import { promisify } from 'node:util';
16
+ import { KimiHookProvider } from './hooks.js';
17
+ import { KimiInstallProvider } from './install.js';
18
+ const execAsync = promisify(exec);
19
+ /**
20
+ * CLEO provider adapter for Moonshot AI Kimi.
21
+ *
22
+ * Bridges CLEO's adapter system with Kimi's integration surface:
23
+ * - Hooks: No-op (Kimi has no native hook system)
24
+ * - Install: Registers MCP server in ~/.kimi/mcp.json and ensures AGENTS.md references
25
+ *
26
+ * @task T163
27
+ * @epic T134
28
+ */
29
+ export class KimiAdapter {
30
+ id = 'kimi';
31
+ name = 'Kimi';
32
+ version = '1.0.0';
33
+ capabilities = {
34
+ supportsHooks: false,
35
+ supportedHookEvents: [],
36
+ supportsSpawn: false,
37
+ supportsInstall: true,
38
+ supportsMcp: true,
39
+ supportsInstructionFiles: false,
40
+ supportsContextMonitor: false,
41
+ supportsStatusline: false,
42
+ supportsProviderPaths: false,
43
+ supportsTransport: false,
44
+ supportsTaskSync: false,
45
+ };
46
+ hooks;
47
+ install;
48
+ projectDir = null;
49
+ initialized = false;
50
+ constructor() {
51
+ this.hooks = new KimiHookProvider();
52
+ this.install = new KimiInstallProvider();
53
+ }
54
+ /**
55
+ * Initialize the adapter for a given project directory.
56
+ *
57
+ * @param projectDir - Root directory of the project
58
+ * @task T163
59
+ */
60
+ async initialize(projectDir) {
61
+ this.projectDir = projectDir;
62
+ this.initialized = true;
63
+ }
64
+ /**
65
+ * Dispose the adapter and clean up resources.
66
+ *
67
+ * Releases tracked state. No hooks to unregister since Kimi
68
+ * has no native hook system.
69
+ * @task T163
70
+ */
71
+ async dispose() {
72
+ this.initialized = false;
73
+ this.projectDir = null;
74
+ }
75
+ /**
76
+ * Run a health check to verify Kimi is accessible.
77
+ *
78
+ * Checks:
79
+ * 1. Adapter has been initialized
80
+ * 2. Kimi CLI binary is available in PATH
81
+ * 3. ~/.kimi/ configuration directory exists
82
+ *
83
+ * @returns Health status with details about each check
84
+ * @task T163
85
+ */
86
+ async healthCheck() {
87
+ const details = {};
88
+ if (!this.initialized) {
89
+ return {
90
+ healthy: false,
91
+ provider: this.id,
92
+ details: { error: 'Adapter not initialized' },
93
+ };
94
+ }
95
+ // Check Kimi CLI availability
96
+ let cliAvailable = false;
97
+ try {
98
+ const { stdout } = await execAsync('which kimi');
99
+ cliAvailable = stdout.trim().length > 0;
100
+ details.cliPath = stdout.trim();
101
+ }
102
+ catch {
103
+ details.cliAvailable = false;
104
+ }
105
+ // Check for Kimi config directory
106
+ const kimiConfigDir = join(homedir(), '.kimi');
107
+ const configExists = existsSync(kimiConfigDir);
108
+ details.configDirExists = configExists;
109
+ // Healthy if CLI is available (primary requirement)
110
+ const healthy = cliAvailable;
111
+ details.cliAvailable = cliAvailable;
112
+ return {
113
+ healthy,
114
+ provider: this.id,
115
+ details,
116
+ };
117
+ }
118
+ /**
119
+ * Check whether the adapter has been initialized.
120
+ * @task T163
121
+ */
122
+ isInitialized() {
123
+ return this.initialized;
124
+ }
125
+ /**
126
+ * Get the project directory this adapter was initialized with.
127
+ * @task T163
128
+ */
129
+ getProjectDir() {
130
+ return this.projectDir;
131
+ }
132
+ }
133
+ //# sourceMappingURL=adapter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/providers/kimi/adapter.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,64 @@
1
+ /**
2
+ * Kimi Hook Provider
3
+ *
4
+ * Kimi has no native hook system (hookSystem is "none").
5
+ * This provider implements the minimal AdapterHookProvider interface
6
+ * with a no-op mapProviderEvent that always returns null.
7
+ *
8
+ * @task T163
9
+ * @epic T134
10
+ */
11
+ import type { AdapterHookProvider } from '@cleocode/contracts';
12
+ /**
13
+ * Hook provider for Kimi.
14
+ *
15
+ * Kimi does not expose a native hook or event system.
16
+ * All hook-related methods are no-ops; mapProviderEvent always
17
+ * returns null since there are no events to map.
18
+ *
19
+ * @task T163
20
+ * @epic T134
21
+ */
22
+ export declare class KimiHookProvider implements AdapterHookProvider {
23
+ private registered;
24
+ /**
25
+ * Map a Kimi native event name to a CAAMP hook event name.
26
+ *
27
+ * Kimi has no hook system, so this always returns null.
28
+ *
29
+ * @param _providerEvent - Unused; Kimi emits no hookable events
30
+ * @returns Always null
31
+ * @task T163
32
+ */
33
+ mapProviderEvent(_providerEvent: string): string | null;
34
+ /**
35
+ * Register native hooks for a project.
36
+ *
37
+ * Kimi has no hook system. This method is a no-op and only
38
+ * tracks registration state for interface compliance.
39
+ *
40
+ * @param _projectDir - Project directory (unused)
41
+ * @task T163
42
+ */
43
+ registerNativeHooks(_projectDir: string): Promise<void>;
44
+ /**
45
+ * Unregister native hooks.
46
+ *
47
+ * Kimi has no hook system. This method is a no-op.
48
+ * @task T163
49
+ */
50
+ unregisterNativeHooks(): Promise<void>;
51
+ /**
52
+ * Check whether hooks have been registered via registerNativeHooks.
53
+ * @task T163
54
+ */
55
+ isRegistered(): boolean;
56
+ /**
57
+ * Get the full event mapping for introspection/debugging.
58
+ *
59
+ * Returns an empty map since Kimi has no hookable events.
60
+ * @task T163
61
+ */
62
+ getEventMap(): Readonly<Record<string, string>>;
63
+ }
64
+ //# sourceMappingURL=hooks.d.ts.map
@@ -0,0 +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"}
@@ -0,0 +1,73 @@
1
+ /**
2
+ * Kimi Hook Provider
3
+ *
4
+ * Kimi has no native hook system (hookSystem is "none").
5
+ * This provider implements the minimal AdapterHookProvider interface
6
+ * with a no-op mapProviderEvent that always returns null.
7
+ *
8
+ * @task T163
9
+ * @epic T134
10
+ */
11
+ /**
12
+ * Hook provider for Kimi.
13
+ *
14
+ * Kimi does not expose a native hook or event system.
15
+ * All hook-related methods are no-ops; mapProviderEvent always
16
+ * returns null since there are no events to map.
17
+ *
18
+ * @task T163
19
+ * @epic T134
20
+ */
21
+ export class KimiHookProvider {
22
+ registered = false;
23
+ /**
24
+ * Map a Kimi native event name to a CAAMP hook event name.
25
+ *
26
+ * Kimi has no hook system, so this always returns null.
27
+ *
28
+ * @param _providerEvent - Unused; Kimi emits no hookable events
29
+ * @returns Always null
30
+ * @task T163
31
+ */
32
+ mapProviderEvent(_providerEvent) {
33
+ return null;
34
+ }
35
+ /**
36
+ * Register native hooks for a project.
37
+ *
38
+ * Kimi has no hook system. This method is a no-op and only
39
+ * tracks registration state for interface compliance.
40
+ *
41
+ * @param _projectDir - Project directory (unused)
42
+ * @task T163
43
+ */
44
+ async registerNativeHooks(_projectDir) {
45
+ this.registered = true;
46
+ }
47
+ /**
48
+ * Unregister native hooks.
49
+ *
50
+ * Kimi has no hook system. This method is a no-op.
51
+ * @task T163
52
+ */
53
+ async unregisterNativeHooks() {
54
+ this.registered = false;
55
+ }
56
+ /**
57
+ * Check whether hooks have been registered via registerNativeHooks.
58
+ * @task T163
59
+ */
60
+ isRegistered() {
61
+ return this.registered;
62
+ }
63
+ /**
64
+ * Get the full event mapping for introspection/debugging.
65
+ *
66
+ * Returns an empty map since Kimi has no hookable events.
67
+ * @task T163
68
+ */
69
+ getEventMap() {
70
+ return {};
71
+ }
72
+ }
73
+ //# sourceMappingURL=hooks.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../src/providers/kimi/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH;;;;;;;;;GASG;AACH,MAAM,OAAO,gBAAgB;IACnB,UAAU,GAAG,KAAK,CAAC;IAE3B;;;;;;;;OAQG;IACH,gBAAgB,CAAC,cAAsB;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,mBAAmB,CAAC,WAAmB;QAC3C,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;IACzB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,qBAAqB;QACzB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;IAC1B,CAAC;IAED;;;OAGG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;;;;OAKG;IACH,WAAW;QACT,OAAO,EAAE,CAAC;IACZ,CAAC;CACF"}
@@ -0,0 +1,22 @@
1
+ /**
2
+ * Kimi provider adapter.
3
+ *
4
+ * CLEO provider adapter for Moonshot AI Kimi.
5
+ * Default export is the adapter class for dynamic loading by AdapterManager.
6
+ *
7
+ * @task T163
8
+ * @epic T134
9
+ */
10
+ import { KimiAdapter } from './adapter.js';
11
+ export { KimiAdapter } from './adapter.js';
12
+ export { KimiHookProvider } from './hooks.js';
13
+ export { KimiInstallProvider } from './install.js';
14
+ export default KimiAdapter;
15
+ /**
16
+ * Factory function for creating adapter instances.
17
+ * Used by AdapterManager's dynamic import fallback.
18
+ *
19
+ * @task T163
20
+ */
21
+ export declare function createAdapter(): KimiAdapter;
22
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +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"}
@@ -0,0 +1,24 @@
1
+ /**
2
+ * Kimi provider adapter.
3
+ *
4
+ * CLEO provider adapter for Moonshot AI Kimi.
5
+ * Default export is the adapter class for dynamic loading by AdapterManager.
6
+ *
7
+ * @task T163
8
+ * @epic T134
9
+ */
10
+ import { KimiAdapter } from './adapter.js';
11
+ export { KimiAdapter } from './adapter.js';
12
+ export { KimiHookProvider } from './hooks.js';
13
+ export { KimiInstallProvider } from './install.js';
14
+ export default KimiAdapter;
15
+ /**
16
+ * Factory function for creating adapter instances.
17
+ * Used by AdapterManager's dynamic import fallback.
18
+ *
19
+ * @task T163
20
+ */
21
+ export function createAdapter() {
22
+ return new KimiAdapter();
23
+ }
24
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","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,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,WAAW,EAAE,CAAC;AAC3B,CAAC"}