@cleocode/adapters 2026.4.0 → 2026.4.2

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 (289) hide show
  1. package/dist/index.d.ts +9 -1
  2. package/dist/index.d.ts.map +1 -1
  3. package/dist/index.js +724 -630
  4. package/dist/index.js.map +3 -3
  5. package/dist/providers/claude-code/adapter.d.ts +21 -1
  6. package/dist/providers/claude-code/adapter.d.ts.map +1 -1
  7. package/dist/providers/claude-code/context-monitor.d.ts +11 -0
  8. package/dist/providers/claude-code/context-monitor.d.ts.map +1 -1
  9. package/dist/providers/claude-code/hooks.d.ts +7 -0
  10. package/dist/providers/claude-code/hooks.d.ts.map +1 -1
  11. package/dist/providers/claude-code/index.d.ts +16 -1
  12. package/dist/providers/claude-code/index.d.ts.map +1 -1
  13. package/dist/providers/claude-code/install.d.ts +10 -18
  14. package/dist/providers/claude-code/install.d.ts.map +1 -1
  15. package/dist/providers/claude-code/paths.d.ts +8 -0
  16. package/dist/providers/claude-code/paths.d.ts.map +1 -1
  17. package/dist/providers/claude-code/spawn.d.ts +7 -0
  18. package/dist/providers/claude-code/spawn.d.ts.map +1 -1
  19. package/dist/providers/claude-code/statusline.d.ts +44 -0
  20. package/dist/providers/claude-code/statusline.d.ts.map +1 -1
  21. package/dist/providers/claude-code/task-sync.d.ts +8 -0
  22. package/dist/providers/claude-code/task-sync.d.ts.map +1 -1
  23. package/dist/providers/claude-code/transport.d.ts +11 -0
  24. package/dist/providers/claude-code/transport.d.ts.map +1 -1
  25. package/dist/providers/codex/adapter.d.ts +14 -1
  26. package/dist/providers/codex/adapter.d.ts.map +1 -1
  27. package/dist/providers/codex/hooks.d.ts +6 -0
  28. package/dist/providers/codex/hooks.d.ts.map +1 -1
  29. package/dist/providers/codex/index.d.ts +16 -1
  30. package/dist/providers/codex/index.d.ts.map +1 -1
  31. package/dist/providers/codex/install.d.ts +8 -17
  32. package/dist/providers/codex/install.d.ts.map +1 -1
  33. package/dist/providers/cursor/adapter.d.ts +15 -1
  34. package/dist/providers/cursor/adapter.d.ts.map +1 -1
  35. package/dist/providers/cursor/hooks.d.ts +7 -0
  36. package/dist/providers/cursor/hooks.d.ts.map +1 -1
  37. package/dist/providers/cursor/index.d.ts +16 -1
  38. package/dist/providers/cursor/index.d.ts.map +1 -1
  39. package/dist/providers/cursor/install.d.ts +10 -17
  40. package/dist/providers/cursor/install.d.ts.map +1 -1
  41. package/dist/providers/gemini-cli/adapter.d.ts +15 -1
  42. package/dist/providers/gemini-cli/adapter.d.ts.map +1 -1
  43. package/dist/providers/gemini-cli/hooks.d.ts +7 -0
  44. package/dist/providers/gemini-cli/hooks.d.ts.map +1 -1
  45. package/dist/providers/gemini-cli/index.d.ts +16 -1
  46. package/dist/providers/gemini-cli/index.d.ts.map +1 -1
  47. package/dist/providers/gemini-cli/install.d.ts +8 -17
  48. package/dist/providers/gemini-cli/install.d.ts.map +1 -1
  49. package/dist/providers/kimi/adapter.d.ts +15 -2
  50. package/dist/providers/kimi/adapter.d.ts.map +1 -1
  51. package/dist/providers/kimi/hooks.d.ts +6 -0
  52. package/dist/providers/kimi/hooks.d.ts.map +1 -1
  53. package/dist/providers/kimi/index.d.ts +16 -1
  54. package/dist/providers/kimi/index.d.ts.map +1 -1
  55. package/dist/providers/kimi/install.d.ts +7 -22
  56. package/dist/providers/kimi/install.d.ts.map +1 -1
  57. package/dist/providers/opencode/adapter.d.ts +17 -1
  58. package/dist/providers/opencode/adapter.d.ts.map +1 -1
  59. package/dist/providers/opencode/hooks.d.ts +9 -0
  60. package/dist/providers/opencode/hooks.d.ts.map +1 -1
  61. package/dist/providers/opencode/index.d.ts +16 -1
  62. package/dist/providers/opencode/index.d.ts.map +1 -1
  63. package/dist/providers/opencode/install.d.ts +8 -17
  64. package/dist/providers/opencode/install.d.ts.map +1 -1
  65. package/dist/providers/opencode/spawn.d.ts +23 -1
  66. package/dist/providers/opencode/spawn.d.ts.map +1 -1
  67. package/dist/providers/shared/transcript-reader.d.ts +15 -0
  68. package/dist/providers/shared/transcript-reader.d.ts.map +1 -1
  69. package/dist/registry.d.ts +54 -2
  70. package/dist/registry.d.ts.map +1 -1
  71. package/package.json +3 -3
  72. package/src/__tests__/claude-code-adapter.test.js +21 -30
  73. package/src/__tests__/claude-code-adapter.test.js.map +1 -1
  74. package/src/__tests__/claude-code-adapter.test.ts +21 -32
  75. package/src/__tests__/cursor-adapter.test.js +25 -29
  76. package/src/__tests__/cursor-adapter.test.js.map +1 -1
  77. package/src/__tests__/cursor-adapter.test.ts +26 -33
  78. package/src/__tests__/opencode-adapter.test.js +47 -46
  79. package/src/__tests__/opencode-adapter.test.js.map +1 -1
  80. package/src/__tests__/opencode-adapter.test.ts +51 -49
  81. package/src/index.ts +9 -1
  82. package/src/providers/claude-code/__tests__/adapter.test.js +50 -23
  83. package/src/providers/claude-code/__tests__/adapter.test.js.map +1 -1
  84. package/src/providers/claude-code/__tests__/adapter.test.ts +52 -23
  85. package/src/providers/claude-code/adapter.ts +22 -2
  86. package/src/providers/claude-code/context-monitor.ts +11 -0
  87. package/src/providers/claude-code/hooks.ts +7 -0
  88. package/src/providers/claude-code/index.ts +16 -1
  89. package/src/providers/claude-code/install.ts +15 -96
  90. package/src/providers/claude-code/manifest.json +1 -1
  91. package/src/providers/claude-code/paths.ts +8 -0
  92. package/src/providers/claude-code/spawn.ts +7 -0
  93. package/src/providers/claude-code/statusline.ts +44 -0
  94. package/src/providers/claude-code/task-sync.ts +8 -0
  95. package/src/providers/claude-code/transport.ts +11 -0
  96. package/src/providers/codex/adapter.ts +15 -2
  97. package/src/providers/codex/hooks.ts +6 -0
  98. package/src/providers/codex/index.ts +16 -1
  99. package/src/providers/codex/install.ts +17 -81
  100. package/src/providers/codex/manifest.json +1 -1
  101. package/src/providers/cursor/__tests__/adapter.test.js +37 -12
  102. package/src/providers/cursor/__tests__/adapter.test.js.map +1 -1
  103. package/src/providers/cursor/__tests__/adapter.test.ts +43 -12
  104. package/src/providers/cursor/adapter.ts +16 -2
  105. package/src/providers/cursor/hooks.ts +7 -0
  106. package/src/providers/cursor/index.ts +16 -1
  107. package/src/providers/cursor/install.ts +23 -88
  108. package/src/providers/cursor/manifest.json +1 -1
  109. package/src/providers/gemini-cli/adapter.ts +16 -2
  110. package/src/providers/gemini-cli/hooks.ts +7 -0
  111. package/src/providers/gemini-cli/index.ts +16 -1
  112. package/src/providers/gemini-cli/install.ts +17 -81
  113. package/src/providers/gemini-cli/manifest.json +1 -1
  114. package/src/providers/kimi/adapter.ts +16 -3
  115. package/src/providers/kimi/hooks.ts +6 -0
  116. package/src/providers/kimi/index.ts +16 -1
  117. package/src/providers/kimi/install.ts +16 -86
  118. package/src/providers/kimi/manifest.json +1 -1
  119. package/src/providers/opencode/__tests__/adapter.test.js +48 -35
  120. package/src/providers/opencode/__tests__/adapter.test.js.map +1 -1
  121. package/src/providers/opencode/__tests__/adapter.test.ts +49 -34
  122. package/src/providers/opencode/adapter.ts +18 -2
  123. package/src/providers/opencode/hooks.ts +9 -0
  124. package/src/providers/opencode/index.ts +16 -1
  125. package/src/providers/opencode/install.ts +17 -90
  126. package/src/providers/opencode/manifest.json +1 -1
  127. package/src/providers/opencode/spawn.ts +23 -1
  128. package/src/providers/shared/transcript-reader.ts +15 -0
  129. package/src/registry.ts +54 -2
  130. package/dist/providers/claude-code/adapter.js +0 -165
  131. package/dist/providers/claude-code/adapter.js.map +0 -1
  132. package/dist/providers/claude-code/context-monitor.js +0 -148
  133. package/dist/providers/claude-code/context-monitor.js.map +0 -1
  134. package/dist/providers/claude-code/hooks.js +0 -279
  135. package/dist/providers/claude-code/hooks.js.map +0 -1
  136. package/dist/providers/claude-code/index.js +0 -26
  137. package/dist/providers/claude-code/index.js.map +0 -1
  138. package/dist/providers/claude-code/install.js +0 -234
  139. package/dist/providers/claude-code/install.js.map +0 -1
  140. package/dist/providers/claude-code/paths.js +0 -33
  141. package/dist/providers/claude-code/paths.js.map +0 -1
  142. package/dist/providers/claude-code/spawn.js +0 -164
  143. package/dist/providers/claude-code/spawn.js.map +0 -1
  144. package/dist/providers/claude-code/statusline.js +0 -86
  145. package/dist/providers/claude-code/statusline.js.map +0 -1
  146. package/dist/providers/claude-code/task-sync.js +0 -111
  147. package/dist/providers/claude-code/task-sync.js.map +0 -1
  148. package/dist/providers/claude-code/transport.js +0 -18
  149. package/dist/providers/claude-code/transport.js.map +0 -1
  150. package/dist/providers/codex/adapter.js +0 -134
  151. package/dist/providers/codex/adapter.js.map +0 -1
  152. package/dist/providers/codex/hooks.js +0 -107
  153. package/dist/providers/codex/hooks.js.map +0 -1
  154. package/dist/providers/codex/index.js +0 -24
  155. package/dist/providers/codex/index.js.map +0 -1
  156. package/dist/providers/codex/install.js +0 -183
  157. package/dist/providers/codex/install.js.map +0 -1
  158. package/dist/providers/cursor/adapter.js +0 -138
  159. package/dist/providers/cursor/adapter.js.map +0 -1
  160. package/dist/providers/cursor/hooks.js +0 -201
  161. package/dist/providers/cursor/hooks.js.map +0 -1
  162. package/dist/providers/cursor/index.js +0 -21
  163. package/dist/providers/cursor/index.js.map +0 -1
  164. package/dist/providers/cursor/install.js +0 -238
  165. package/dist/providers/cursor/install.js.map +0 -1
  166. package/dist/providers/cursor/spawn.js +0 -59
  167. package/dist/providers/cursor/spawn.js.map +0 -1
  168. package/dist/providers/gemini-cli/adapter.js +0 -145
  169. package/dist/providers/gemini-cli/adapter.js.map +0 -1
  170. package/dist/providers/gemini-cli/hooks.js +0 -121
  171. package/dist/providers/gemini-cli/hooks.js.map +0 -1
  172. package/dist/providers/gemini-cli/index.js +0 -24
  173. package/dist/providers/gemini-cli/index.js.map +0 -1
  174. package/dist/providers/gemini-cli/install.js +0 -183
  175. package/dist/providers/gemini-cli/install.js.map +0 -1
  176. package/dist/providers/kimi/adapter.js +0 -133
  177. package/dist/providers/kimi/adapter.js.map +0 -1
  178. package/dist/providers/kimi/hooks.js +0 -73
  179. package/dist/providers/kimi/hooks.js.map +0 -1
  180. package/dist/providers/kimi/index.js +0 -24
  181. package/dist/providers/kimi/index.js.map +0 -1
  182. package/dist/providers/kimi/install.js +0 -189
  183. package/dist/providers/kimi/install.js.map +0 -1
  184. package/dist/providers/opencode/adapter.js +0 -151
  185. package/dist/providers/opencode/adapter.js.map +0 -1
  186. package/dist/providers/opencode/hooks.js +0 -197
  187. package/dist/providers/opencode/hooks.js.map +0 -1
  188. package/dist/providers/opencode/index.js +0 -22
  189. package/dist/providers/opencode/index.js.map +0 -1
  190. package/dist/providers/opencode/install.js +0 -180
  191. package/dist/providers/opencode/install.js.map +0 -1
  192. package/dist/providers/opencode/spawn.js +0 -219
  193. package/dist/providers/opencode/spawn.js.map +0 -1
  194. package/dist/providers/shared/transcript-reader.js +0 -109
  195. package/dist/providers/shared/transcript-reader.js.map +0 -1
  196. package/dist/registry.js +0 -55
  197. package/dist/registry.js.map +0 -1
  198. package/src/__tests__/claude-code-adapter.test.d.ts +0 -10
  199. package/src/__tests__/cursor-adapter.test.d.ts +0 -10
  200. package/src/__tests__/opencode-adapter.test.d.ts +0 -10
  201. package/src/index.d.ts +0 -35
  202. package/src/index.d.ts.map +0 -1
  203. package/src/index.js +0 -13
  204. package/src/index.js.map +0 -1
  205. package/src/providers/claude-code/__tests__/adapter.test.d.ts +0 -7
  206. package/src/providers/claude-code/adapter.d.ts +0 -79
  207. package/src/providers/claude-code/adapter.d.ts.map +0 -1
  208. package/src/providers/claude-code/adapter.js +0 -154
  209. package/src/providers/claude-code/adapter.js.map +0 -1
  210. package/src/providers/claude-code/context-monitor.d.ts +0 -24
  211. package/src/providers/claude-code/context-monitor.d.ts.map +0 -1
  212. package/src/providers/claude-code/context-monitor.js +0 -148
  213. package/src/providers/claude-code/context-monitor.js.map +0 -1
  214. package/src/providers/claude-code/hooks.d.ts +0 -59
  215. package/src/providers/claude-code/hooks.d.ts.map +0 -1
  216. package/src/providers/claude-code/hooks.js +0 -77
  217. package/src/providers/claude-code/hooks.js.map +0 -1
  218. package/src/providers/claude-code/index.d.ts +0 -28
  219. package/src/providers/claude-code/index.d.ts.map +0 -1
  220. package/src/providers/claude-code/index.js +0 -26
  221. package/src/providers/claude-code/index.js.map +0 -1
  222. package/src/providers/claude-code/install.d.ts +0 -75
  223. package/src/providers/claude-code/install.d.ts.map +0 -1
  224. package/src/providers/claude-code/install.js +0 -234
  225. package/src/providers/claude-code/install.js.map +0 -1
  226. package/src/providers/claude-code/paths.d.ts +0 -24
  227. package/src/providers/claude-code/paths.d.ts.map +0 -1
  228. package/src/providers/claude-code/paths.js +0 -33
  229. package/src/providers/claude-code/paths.js.map +0 -1
  230. package/src/providers/claude-code/spawn.d.ts +0 -60
  231. package/src/providers/claude-code/spawn.d.ts.map +0 -1
  232. package/src/providers/claude-code/spawn.js +0 -164
  233. package/src/providers/claude-code/spawn.js.map +0 -1
  234. package/src/providers/claude-code/statusline.d.ts +0 -23
  235. package/src/providers/claude-code/statusline.d.ts.map +0 -1
  236. package/src/providers/claude-code/statusline.js +0 -86
  237. package/src/providers/claude-code/statusline.js.map +0 -1
  238. package/src/providers/claude-code/task-sync.js +0 -122
  239. package/src/providers/claude-code/task-sync.js.map +0 -1
  240. package/src/providers/claude-code/transport.d.ts +0 -14
  241. package/src/providers/claude-code/transport.d.ts.map +0 -1
  242. package/src/providers/claude-code/transport.js +0 -18
  243. package/src/providers/claude-code/transport.js.map +0 -1
  244. package/src/providers/cursor/__tests__/adapter.test.d.ts +0 -7
  245. package/src/providers/cursor/adapter.d.ts +0 -66
  246. package/src/providers/cursor/adapter.d.ts.map +0 -1
  247. package/src/providers/cursor/adapter.js +0 -124
  248. package/src/providers/cursor/adapter.js.map +0 -1
  249. package/src/providers/cursor/hooks.d.ts +0 -48
  250. package/src/providers/cursor/hooks.d.ts.map +0 -1
  251. package/src/providers/cursor/hooks.js +0 -55
  252. package/src/providers/cursor/hooks.js.map +0 -1
  253. package/src/providers/cursor/index.d.ts +0 -19
  254. package/src/providers/cursor/index.d.ts.map +0 -1
  255. package/src/providers/cursor/index.js +0 -21
  256. package/src/providers/cursor/index.js.map +0 -1
  257. package/src/providers/cursor/install.d.ts +0 -94
  258. package/src/providers/cursor/install.d.ts.map +0 -1
  259. package/src/providers/cursor/install.js +0 -238
  260. package/src/providers/cursor/install.js.map +0 -1
  261. package/src/providers/cursor/spawn.d.ts +0 -50
  262. package/src/providers/cursor/spawn.d.ts.map +0 -1
  263. package/src/providers/cursor/spawn.js +0 -59
  264. package/src/providers/cursor/spawn.js.map +0 -1
  265. package/src/providers/opencode/__tests__/adapter.test.d.ts +0 -7
  266. package/src/providers/opencode/adapter.d.ts +0 -71
  267. package/src/providers/opencode/adapter.d.ts.map +0 -1
  268. package/src/providers/opencode/adapter.js +0 -144
  269. package/src/providers/opencode/adapter.js.map +0 -1
  270. package/src/providers/opencode/hooks.d.ts +0 -66
  271. package/src/providers/opencode/hooks.d.ts.map +0 -1
  272. package/src/providers/opencode/hooks.js +0 -89
  273. package/src/providers/opencode/hooks.js.map +0 -1
  274. package/src/providers/opencode/index.d.ts +0 -20
  275. package/src/providers/opencode/index.d.ts.map +0 -1
  276. package/src/providers/opencode/index.js +0 -22
  277. package/src/providers/opencode/index.js.map +0 -1
  278. package/src/providers/opencode/install.d.ts +0 -65
  279. package/src/providers/opencode/install.d.ts.map +0 -1
  280. package/src/providers/opencode/install.js +0 -180
  281. package/src/providers/opencode/install.js.map +0 -1
  282. package/src/providers/opencode/spawn.d.ts +0 -75
  283. package/src/providers/opencode/spawn.d.ts.map +0 -1
  284. package/src/providers/opencode/spawn.js +0 -219
  285. package/src/providers/opencode/spawn.js.map +0 -1
  286. package/src/registry.d.ts +0 -36
  287. package/src/registry.d.ts.map +0 -1
  288. package/src/registry.js +0 -55
  289. package/src/registry.js.map +0 -1
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/providers/codex/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,eAAe,YAAY,CAAC;AAE5B;;;;;GAKG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,YAAY,EAAE,CAAC;AAC5B,CAAC"}
@@ -1,183 +0,0 @@
1
- /**
2
- * Codex CLI Install Provider
3
- *
4
- * Handles CLEO installation into Codex CLI environments:
5
- * - Registers CLEO MCP server in ~/.codex/config.json
6
- * - Ensures AGENTS.md has CLEO @-references
7
- *
8
- * @task T162
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 Codex CLI config. */
17
- const MCP_SERVER_KEY = 'cleo';
18
- /**
19
- * Install provider for Codex CLI.
20
- *
21
- * Manages CLEO's integration with Codex CLI by:
22
- * 1. Registering the CLEO MCP server in ~/.codex/config.json
23
- * 2. Ensuring AGENTS.md contains @-references to CLEO instruction files
24
- *
25
- * @task T162
26
- * @epic T134
27
- */
28
- export class CodexInstallProvider {
29
- /**
30
- * Install CLEO into a Codex CLI environment.
31
- *
32
- * @param options - Installation options including project directory and MCP server path
33
- * @returns Result describing what was installed
34
- * @task T162
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 ~/.codex/config.json
43
- if (mcpServerPath) {
44
- mcpRegistered = this.registerMcpServer(mcpServerPath);
45
- if (mcpRegistered) {
46
- details.mcpConfigPath = join(homedir(), '.codex', 'config.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 Codex CLI environment.
64
- *
65
- * Removes the MCP server registration from ~/.codex/config.json.
66
- * Does not remove AGENTS.md references (they are harmless if CLEO is not present).
67
- * @task T162
68
- */
69
- async uninstall() {
70
- const configPath = join(homedir(), '.codex', 'config.json');
71
- if (existsSync(configPath)) {
72
- try {
73
- const raw = readFileSync(configPath, '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(configPath, 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 Codex CLI environment.
88
- *
89
- * Checks for MCP server registered in ~/.codex/config.json.
90
- * Returns true if the CLEO MCP server entry is found.
91
- * @task T162
92
- */
93
- async isInstalled() {
94
- const configPath = join(homedir(), '.codex', 'config.json');
95
- if (existsSync(configPath)) {
96
- try {
97
- const config = JSON.parse(readFileSync(configPath, '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 T162
116
- */
117
- async ensureInstructionReferences(projectDir) {
118
- this.updateInstructionFile(projectDir);
119
- }
120
- /**
121
- * Register the CLEO MCP server in ~/.codex/config.json.
122
- *
123
- * Codex CLI stores its MCP server configuration in ~/.codex/config.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 codexDir = join(homedir(), '.codex');
131
- const configPath = join(codexDir, 'config.json');
132
- let config = {};
133
- mkdirSync(codexDir, { recursive: true });
134
- if (existsSync(configPath)) {
135
- try {
136
- config = JSON.parse(readFileSync(configPath, '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(configPath, 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
@@ -1 +0,0 @@
1
- {"version":3,"file":"install.js","sourceRoot":"","sources":["../../../src/providers/codex/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,+DAA+D;AAC/D,MAAM,sBAAsB,GAAG,CAAC,sCAAsC,EAAE,yBAAyB,CAAC,CAAC;AAEnG,4DAA4D;AAC5D,MAAM,cAAc,GAAG,MAAM,CAAC;AAE9B;;;;;;;;;GASG;AACH,MAAM,OAAO,oBAAoB;IAC/B;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,CAAC,OAAuB;QACnC,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC;QAC9C,MAAM,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC7C,IAAI,sBAAsB,GAAG,KAAK,CAAC;QACnC,IAAI,aAAa,GAAG,KAAK,CAAC;QAC1B,MAAM,OAAO,GAA4B,EAAE,CAAC;QAE5C,sDAAsD;QACtD,IAAI,aAAa,EAAE,CAAC;YAClB,aAAa,GAAG,IAAI,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC;YACtD,IAAI,aAAa,EAAE,CAAC;gBAClB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;YACnE,CAAC;QACH,CAAC;QAED,4CAA4C;QAC5C,sBAAsB,GAAG,IAAI,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC;QAChE,IAAI,sBAAsB,EAAE,CAAC;YAC3B,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QAC1D,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,WAAW;YACX,sBAAsB;YACtB,aAAa;YACb,OAAO;SACR,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,SAAS;QACb,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;QAC5D,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;gBAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC;gBAC1D,MAAM,UAAU,GAAG,MAAM,CAAC,UAAiD,CAAC;gBAC5E,IAAI,UAAU,IAAI,cAAc,IAAI,UAAU,EAAE,CAAC;oBAC/C,OAAO,UAAU,CAAC,cAAc,CAAC,CAAC;oBAClC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;gBAC7E,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,iCAAiC;YACnC,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,WAAW;QACf,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;QAC5D,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;gBAC7D,MAAM,UAAU,GAAG,MAAM,CAAC,UAAiD,CAAC;gBAC5E,IAAI,UAAU,IAAI,cAAc,IAAI,UAAU,EAAE,CAAC;oBAC/C,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,eAAe;YACjB,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,2BAA2B,CAAC,UAAkB;QAClD,IAAI,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC;IACzC,CAAC;IAED;;;;;;;;OAQG;IACK,iBAAiB,CAAC,aAAqB;QAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;QAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;QACjD,IAAI,MAAM,GAA4B,EAAE,CAAC;QAEzC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEzC,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;YACzD,CAAC;YAAC,MAAM,CAAC;gBACP,6BAA6B;YAC/B,CAAC;QACH,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;YAChE,MAAM,CAAC,UAAU,GAAG,EAAE,CAAC;QACzB,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,CAAC,UAAqC,CAAC;QAChE,UAAU,CAAC,cAAc,CAAC,GAAG;YAC3B,OAAO,EAAE,MAAM;YACf,IAAI,EAAE,CAAC,aAAa,CAAC;SACtB,CAAC;QAEF,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;QAC3E,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACK,qBAAqB,CAAC,UAAkB;QAC9C,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QACnD,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,IAAI,OAAO,GAAG,KAAK,CAAC;QAEpB,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC7B,OAAO,GAAG,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YAC9C,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;QAED,MAAM,WAAW,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;QAEnF,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEzC,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YACrD,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,IAAI,CAAC;QACnD,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,SAAS,GAAG,IAAI,CAAC;QAC7B,CAAC;QAED,aAAa,CAAC,YAAY,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}
@@ -1,138 +0,0 @@
1
- /**
2
- * Cursor Adapter
3
- *
4
- * Main CLEOProviderAdapter implementation for Cursor AI code editor.
5
- * Provides install capabilities for CLEO integration. Hooks and spawn
6
- * are not supported since Cursor lacks CLI-based lifecycle events
7
- * and subagent spawning.
8
- *
9
- * @task T5240
10
- */
11
- import { existsSync } from 'node:fs';
12
- import { join } from 'node:path';
13
- import { CursorHookProvider } from './hooks.js';
14
- import { CursorInstallProvider } from './install.js';
15
- /**
16
- * CLEO provider adapter for Cursor AI code editor.
17
- *
18
- * Bridges CLEO's adapter system with Cursor's capabilities:
19
- * - Install: Registers MCP server in .cursor/mcp.json and manages rule files
20
- * - Hooks: Stub provider (Cursor has no lifecycle event system)
21
- * - Spawn: Not supported (Cursor has no CLI for subagent spawning)
22
- */
23
- export class CursorAdapter {
24
- id = 'cursor';
25
- name = 'Cursor';
26
- version = '1.0.0';
27
- capabilities = {
28
- supportsHooks: true,
29
- // 10/16 canonical events — derived from getProviderHookProfile('cursor') in CAAMP 1.9.1.
30
- // PermissionRequest, PreModel, PostModel, PostCompact, Notification, ConfigChange are
31
- // not supported by Cursor's hook system.
32
- supportedHookEvents: [
33
- 'SessionStart',
34
- 'SessionEnd',
35
- 'PromptSubmit',
36
- 'ResponseComplete',
37
- 'PreToolUse',
38
- 'PostToolUse',
39
- 'PostToolUseFailure',
40
- 'SubagentStart',
41
- 'SubagentStop',
42
- 'PreCompact',
43
- ],
44
- supportsSpawn: false,
45
- supportsInstall: true,
46
- supportsMcp: true,
47
- supportsInstructionFiles: true,
48
- instructionFilePattern: '.cursor/rules/*.mdc',
49
- supportsContextMonitor: false,
50
- supportsStatusline: false,
51
- supportsProviderPaths: true,
52
- supportsTransport: false,
53
- supportsTaskSync: false,
54
- };
55
- hooks;
56
- install;
57
- projectDir = null;
58
- initialized = false;
59
- constructor() {
60
- this.hooks = new CursorHookProvider();
61
- this.install = new CursorInstallProvider();
62
- }
63
- /**
64
- * Initialize the adapter for a given project directory.
65
- *
66
- * @param projectDir - Root directory of the project
67
- */
68
- async initialize(projectDir) {
69
- this.projectDir = projectDir;
70
- this.initialized = true;
71
- }
72
- /**
73
- * Dispose the adapter and clean up resources.
74
- */
75
- async dispose() {
76
- if (this.hooks.isRegistered()) {
77
- await this.hooks.unregisterNativeHooks();
78
- }
79
- this.initialized = false;
80
- this.projectDir = null;
81
- }
82
- /**
83
- * Run a health check to verify Cursor is accessible.
84
- *
85
- * Checks:
86
- * 1. Adapter has been initialized
87
- * 2. .cursor/ configuration directory exists in the project
88
- * 3. CURSOR_EDITOR env var is set
89
- *
90
- * @returns Health status with details about each check
91
- */
92
- async healthCheck() {
93
- const details = {};
94
- if (!this.initialized) {
95
- return {
96
- healthy: false,
97
- provider: this.id,
98
- details: { error: 'Adapter not initialized' },
99
- };
100
- }
101
- // Check for Cursor config directory in the project
102
- let configExists = false;
103
- if (this.projectDir) {
104
- const cursorConfigDir = join(this.projectDir, '.cursor');
105
- configExists = existsSync(cursorConfigDir);
106
- details.configDirExists = configExists;
107
- }
108
- // Check for CURSOR_EDITOR env var
109
- const editorEnvSet = process.env.CURSOR_EDITOR !== undefined;
110
- details.editorEnvSet = editorEnvSet;
111
- // Check for legacy .cursorrules file
112
- if (this.projectDir) {
113
- const legacyRulesExist = existsSync(join(this.projectDir, '.cursorrules'));
114
- details.legacyRulesExist = legacyRulesExist;
115
- }
116
- // Healthy if we detect Cursor presence (config dir or env var)
117
- const healthy = configExists || editorEnvSet;
118
- details.detected = healthy;
119
- return {
120
- healthy,
121
- provider: this.id,
122
- details,
123
- };
124
- }
125
- /**
126
- * Check whether the adapter has been initialized.
127
- */
128
- isInitialized() {
129
- return this.initialized;
130
- }
131
- /**
132
- * Get the project directory this adapter was initialized with.
133
- */
134
- getProjectDir() {
135
- return this.projectDir;
136
- }
137
- }
138
- //# sourceMappingURL=adapter.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/providers/cursor/adapter.ts"],"names":[],"mappings":"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"}
@@ -1,201 +0,0 @@
1
- /**
2
- * Cursor Hook Provider
3
- *
4
- * Maps Cursor's native hook events to CAAMP canonical hook events.
5
- * Cursor supports 10 of 16 canonical events through its config-based hook system.
6
- *
7
- * Event translation uses CAAMP normalizer APIs:
8
- * - `toCanonical(nativeName, 'cursor')` for runtime event name resolution
9
- * - `getSupportedEvents('cursor')` to enumerate supported canonical events
10
- * - `getProviderHookProfile('cursor')` for the full provider profile
11
- *
12
- * Cursor uses camelCase native event names (e.g. `sessionStart`, `preToolUse`).
13
- * Hooks are configured via `.cursor/hooks.json`. Supported handler types:
14
- * command, prompt.
15
- *
16
- * Unsupported events: PermissionRequest, PreModel, PostModel, PostCompact,
17
- * Notification, ConfigChange.
18
- *
19
- * @task T165
20
- * @epic T134
21
- */
22
- /** CAAMP provider identifier for Cursor. */
23
- const PROVIDER_ID = 'cursor';
24
- /**
25
- * Fallback map from Cursor native event names to CAAMP canonical names.
26
- *
27
- * Derived from `getProviderHookProfile('cursor').mappings` in CAAMP 1.9.1.
28
- * Covers all 10 supported events. PermissionRequest, PreModel, PostModel,
29
- * PostCompact, Notification, and ConfigChange are not supported by Cursor.
30
- *
31
- * Cursor uses camelCase names while CAAMP canonical names are PascalCase.
32
- */
33
- const CURSOR_EVENT_MAP = {
34
- // CAAMP: toNative('SessionStart', 'cursor') = 'sessionStart'
35
- sessionStart: 'SessionStart',
36
- // CAAMP: toNative('SessionEnd', 'cursor') = 'sessionEnd'
37
- sessionEnd: 'SessionEnd',
38
- // CAAMP: toNative('PromptSubmit', 'cursor') = 'beforeSubmitPrompt'
39
- beforeSubmitPrompt: 'PromptSubmit',
40
- // CAAMP: toNative('ResponseComplete', 'cursor') = 'stop'
41
- stop: 'ResponseComplete',
42
- // CAAMP: toNative('PreToolUse', 'cursor') = 'preToolUse'
43
- preToolUse: 'PreToolUse',
44
- // CAAMP: toNative('PostToolUse', 'cursor') = 'postToolUse'
45
- postToolUse: 'PostToolUse',
46
- // CAAMP: toNative('PostToolUseFailure', 'cursor') = 'postToolUseFailure'
47
- postToolUseFailure: 'PostToolUseFailure',
48
- // CAAMP: toNative('SubagentStart', 'cursor') = 'subagentStart'
49
- subagentStart: 'SubagentStart',
50
- // CAAMP: toNative('SubagentStop', 'cursor') = 'subagentStop'
51
- subagentStop: 'SubagentStop',
52
- // CAAMP: toNative('PreCompact', 'cursor') = 'preCompact'
53
- preCompact: 'PreCompact',
54
- };
55
- /**
56
- * Hook provider for Cursor.
57
- *
58
- * Cursor registers hooks via its config system at `.cursor/hooks.json`.
59
- * Supported handler types: command, prompt.
60
- *
61
- * CAAMP 1.9.1 reveals Cursor supports 10 of 16 canonical events. Previously
62
- * this provider was a no-op stub. It now provides full event mapping and CAAMP
63
- * normalizer integration.
64
- *
65
- * Event mapping is based on `getProviderHookProfile('cursor')` from CAAMP 1.9.1.
66
- * Async accessors (`getSupportedCanonicalEvents`, `getProviderProfile`) call
67
- * CAAMP directly when available.
68
- *
69
- * Since hooks are registered through the config system (managed by the install
70
- * provider), `registerNativeHooks` and `unregisterNativeHooks` track registration
71
- * state without performing filesystem operations.
72
- *
73
- * @task T165
74
- * @epic T134
75
- */
76
- export class CursorHookProvider {
77
- registered = false;
78
- /**
79
- * Map a Cursor native event name to a CAAMP canonical hook event name.
80
- *
81
- * Looks up the native event name in the map derived from
82
- * `getProviderHookProfile('cursor').mappings` (CAAMP 1.9.1). Cursor uses
83
- * camelCase names (e.g. "preToolUse", "sessionStart").
84
- *
85
- * Returns null for unsupported events (PermissionRequest, PreModel,
86
- * PostModel, PostCompact, Notification, ConfigChange).
87
- *
88
- * @param providerEvent - Cursor native event name (e.g. "preToolUse", "sessionStart")
89
- * @returns CAAMP canonical event name, or null if unmapped
90
- * @task T165
91
- */
92
- mapProviderEvent(providerEvent) {
93
- return CURSOR_EVENT_MAP[providerEvent] ?? null;
94
- }
95
- /**
96
- * Register native hooks for a project.
97
- *
98
- * For Cursor, hooks are registered via the config system
99
- * (`.cursor/hooks.json`), managed by the install provider.
100
- * This method marks hooks as registered without performing filesystem operations.
101
- *
102
- * Iterating supported events is handled at install time using
103
- * `getSupportedCanonicalEvents()` to enumerate all 10 supported hooks.
104
- *
105
- * @param _projectDir - Project directory (unused; Cursor config manages registration)
106
- * @task T165
107
- */
108
- async registerNativeHooks(_projectDir) {
109
- this.registered = true;
110
- }
111
- /**
112
- * Unregister native hooks.
113
- *
114
- * For Cursor, this is a no-op since hooks are managed through the config
115
- * system. Unregistration happens via the install provider's uninstall method.
116
- *
117
- * @task T165
118
- */
119
- async unregisterNativeHooks() {
120
- this.registered = false;
121
- }
122
- /**
123
- * Check whether hooks have been registered via `registerNativeHooks`.
124
- */
125
- isRegistered() {
126
- return this.registered;
127
- }
128
- /**
129
- * Get the native→canonical event mapping for introspection and debugging.
130
- *
131
- * Returns the map derived from `getProviderHookProfile('cursor').mappings`
132
- * (CAAMP 1.9.1). Use `getSupportedCanonicalEvents()` to enumerate canonical
133
- * names via live CAAMP APIs.
134
- *
135
- * @returns Immutable record of native event name → canonical event name
136
- */
137
- getEventMap() {
138
- return { ...CURSOR_EVENT_MAP };
139
- }
140
- /**
141
- * Enumerate supported canonical events via CAAMP's `getSupportedEvents()`.
142
- *
143
- * Calls `getSupportedEvents('cursor')` from the CAAMP normalizer to get the
144
- * authoritative list. Cursor supports 10 of 16 canonical events. Falls back
145
- * to the values of the static event map when CAAMP is unavailable at runtime.
146
- *
147
- * @returns Array of CAAMP canonical event names supported by Cursor
148
- * @task T165
149
- */
150
- async getSupportedCanonicalEvents() {
151
- try {
152
- const { getSupportedEvents } = await import('@cleocode/caamp');
153
- return getSupportedEvents(PROVIDER_ID);
154
- }
155
- catch {
156
- return [...new Set(Object.values(CURSOR_EVENT_MAP))];
157
- }
158
- }
159
- /**
160
- * Retrieve the full provider hook profile from CAAMP.
161
- *
162
- * Calls `getProviderHookProfile('cursor')` from the CAAMP normalizer to
163
- * get the complete profile: hook system type (`config`), config path
164
- * (`.cursor/hooks.json`), handler types (command, prompt), and all event
165
- * mappings. Returns null when CAAMP is unavailable at runtime.
166
- *
167
- * @returns Provider hook profile or null if CAAMP is unavailable
168
- * @task T165
169
- */
170
- async getProviderProfile() {
171
- try {
172
- const { getProviderHookProfile } = await import('@cleocode/caamp');
173
- return getProviderHookProfile(PROVIDER_ID) ?? null;
174
- }
175
- catch {
176
- return null;
177
- }
178
- }
179
- /**
180
- * Translate a CAAMP canonical event to its Cursor native name via CAAMP.
181
- *
182
- * Calls `toNative(canonical, 'cursor')` from the CAAMP normalizer.
183
- * Returns null for unsupported events or when CAAMP is unavailable.
184
- *
185
- * @param canonical - CAAMP canonical event name (e.g. "PreToolUse")
186
- * @returns Cursor native event name (e.g. "preToolUse") or null
187
- * @task T165
188
- */
189
- async toNativeEvent(canonical) {
190
- try {
191
- const { toNative } = await import('@cleocode/caamp');
192
- return toNative(canonical, PROVIDER_ID);
193
- }
194
- catch {
195
- // Invert the static map as fallback
196
- const entry = Object.entries(CURSOR_EVENT_MAP).find(([, v]) => v === canonical);
197
- return entry?.[0] ?? null;
198
- }
199
- }
200
- }
201
- //# sourceMappingURL=hooks.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../src/providers/cursor/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,4CAA4C;AAC5C,MAAM,WAAW,GAAG,QAAiB,CAAC;AAEtC;;;;;;;;GAQG;AACH,MAAM,gBAAgB,GAA2B;IAC/C,mEAAmE;IACnE,YAAY,EAAE,cAAc;IAC5B,iEAAiE;IACjE,UAAU,EAAE,YAAY;IACxB,yEAAyE;IACzE,kBAAkB,EAAE,cAAc;IAClC,2DAA2D;IAC3D,IAAI,EAAE,kBAAkB;IACxB,iEAAiE;IACjE,UAAU,EAAE,YAAY;IACxB,kEAAkE;IAClE,WAAW,EAAE,aAAa;IAC1B,yEAAyE;IACzE,kBAAkB,EAAE,oBAAoB;IACxC,oEAAoE;IACpE,aAAa,EAAE,eAAe;IAC9B,mEAAmE;IACnE,YAAY,EAAE,cAAc;IAC5B,iEAAiE;IACjE,UAAU,EAAE,YAAY;CACzB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAO,kBAAkB;IACrB,UAAU,GAAG,KAAK,CAAC;IAE3B;;;;;;;;;;;;;OAaG;IACH,gBAAgB,CAAC,aAAqB;QACpC,OAAO,gBAAgB,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC;IACjD,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,mBAAmB,CAAC,WAAmB;QAC3C,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;IACzB,CAAC;IAED;;;;;;;OAOG;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;;;;;;;;OAQG;IACH,WAAW;QACT,OAAO,EAAE,GAAG,gBAAgB,EAAE,CAAC;IACjC,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,2BAA2B;QAC/B,IAAI,CAAC;YACH,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;YAC/D,OAAO,kBAAkB,CAAC,WAAW,CAAa,CAAC;QACrD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,kBAAkB;QACtB,IAAI,CAAC;YACH,MAAM,EAAE,sBAAsB,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;YACnE,OAAO,sBAAsB,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC;QACrD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,aAAa,CAAC,SAAiB;QACnC,IAAI,CAAC;YACH,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;YACrD,OAAO,QAAQ,CAAC,SAA2C,EAAE,WAAW,CAAC,CAAC;QAC5E,CAAC;QAAC,MAAM,CAAC;YACP,oCAAoC;YACpC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;YAChF,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QAC5B,CAAC;IACH,CAAC;CACF"}
@@ -1,21 +0,0 @@
1
- /**
2
- * Cursor provider adapter.
3
- *
4
- * CLEO provider adapter for Cursor AI code editor.
5
- * Default export is the adapter class for dynamic loading by AdapterManager.
6
- *
7
- * @task T5240
8
- */
9
- import { CursorAdapter } from './adapter.js';
10
- export { CursorAdapter } from './adapter.js';
11
- export { CursorHookProvider } from './hooks.js';
12
- export { CursorInstallProvider } from './install.js';
13
- export default CursorAdapter;
14
- /**
15
- * Factory function for creating adapter instances.
16
- * Used by AdapterManager's dynamic import fallback.
17
- */
18
- export function createAdapter() {
19
- return new CursorAdapter();
20
- }
21
- //# sourceMappingURL=index.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.js","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,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,aAAa,EAAE,CAAC;AAC7B,CAAC"}