@cleocode/adapters 2026.3.37 → 2026.3.39

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 (234) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +503 -0
  3. package/dist/index.js +621 -496
  4. package/dist/index.js.map +4 -4
  5. package/package.json +12 -7
  6. package/src/__tests__/claude-code-adapter.test.d.ts +10 -0
  7. package/src/__tests__/claude-code-adapter.test.d.ts.map +1 -0
  8. package/src/__tests__/claude-code-adapter.test.js +192 -0
  9. package/src/__tests__/claude-code-adapter.test.js.map +1 -0
  10. package/src/__tests__/claude-code-adapter.test.ts +235 -0
  11. package/src/__tests__/cursor-adapter.test.d.ts +10 -0
  12. package/src/__tests__/cursor-adapter.test.d.ts.map +1 -0
  13. package/src/__tests__/cursor-adapter.test.js +196 -0
  14. package/src/__tests__/cursor-adapter.test.js.map +1 -0
  15. package/src/__tests__/cursor-adapter.test.ts +246 -0
  16. package/src/__tests__/opencode-adapter.test.d.ts +10 -0
  17. package/src/__tests__/opencode-adapter.test.d.ts.map +1 -0
  18. package/src/__tests__/opencode-adapter.test.js +204 -0
  19. package/src/__tests__/opencode-adapter.test.js.map +1 -0
  20. package/src/__tests__/opencode-adapter.test.ts +250 -0
  21. package/src/index.d.ts +28 -20
  22. package/src/index.d.ts.map +1 -1
  23. package/src/index.js +4 -19
  24. package/src/index.js.map +1 -1
  25. package/src/index.ts +25 -25
  26. package/src/providers/claude-code/__tests__/adapter.test.d.ts +1 -1
  27. package/src/providers/claude-code/__tests__/adapter.test.d.ts.map +0 -0
  28. package/src/providers/claude-code/__tests__/adapter.test.js +2 -2
  29. package/src/providers/claude-code/__tests__/adapter.test.js.map +1 -1
  30. package/src/providers/claude-code/__tests__/adapter.test.ts +2 -2
  31. package/src/providers/claude-code/adapter.d.ts +54 -50
  32. package/src/providers/claude-code/adapter.d.ts.map +0 -0
  33. package/src/providers/claude-code/adapter.js +1 -1
  34. package/src/providers/claude-code/adapter.js.map +1 -1
  35. package/src/providers/claude-code/adapter.ts +1 -1
  36. package/src/providers/claude-code/context-monitor.d.ts +6 -6
  37. package/src/providers/claude-code/context-monitor.d.ts.map +0 -0
  38. package/src/providers/claude-code/context-monitor.js +0 -0
  39. package/src/providers/claude-code/context-monitor.js.map +0 -0
  40. package/src/providers/claude-code/context-monitor.ts +0 -0
  41. package/src/providers/claude-code/hooks.d.ts +36 -36
  42. package/src/providers/claude-code/hooks.d.ts.map +0 -0
  43. package/src/providers/claude-code/hooks.js +0 -0
  44. package/src/providers/claude-code/hooks.js.map +0 -0
  45. package/src/providers/claude-code/hooks.ts +0 -0
  46. package/src/providers/claude-code/index.d.ts +6 -2
  47. package/src/providers/claude-code/index.d.ts.map +1 -1
  48. package/src/providers/claude-code/index.js +1 -1
  49. package/src/providers/claude-code/index.js.map +1 -1
  50. package/src/providers/claude-code/index.ts +2 -2
  51. package/src/providers/claude-code/install.d.ts +52 -52
  52. package/src/providers/claude-code/install.d.ts.map +1 -1
  53. package/src/providers/claude-code/install.js +1 -4
  54. package/src/providers/claude-code/install.js.map +1 -1
  55. package/src/providers/claude-code/install.ts +1 -4
  56. package/src/providers/claude-code/manifest.json +0 -0
  57. package/src/providers/claude-code/paths.d.ts +5 -5
  58. package/src/providers/claude-code/paths.d.ts.map +0 -0
  59. package/src/providers/claude-code/paths.js +0 -0
  60. package/src/providers/claude-code/paths.js.map +0 -0
  61. package/src/providers/claude-code/paths.ts +0 -0
  62. package/src/providers/claude-code/spawn.d.ts +37 -37
  63. package/src/providers/claude-code/spawn.d.ts.map +1 -1
  64. package/src/providers/claude-code/spawn.js +4 -0
  65. package/src/providers/claude-code/spawn.js.map +1 -1
  66. package/src/providers/claude-code/spawn.ts +5 -0
  67. package/src/providers/claude-code/statusline.d.ts +1 -2
  68. package/src/providers/claude-code/statusline.d.ts.map +0 -0
  69. package/src/providers/claude-code/statusline.js +2 -1
  70. package/src/providers/claude-code/statusline.js.map +1 -1
  71. package/src/providers/claude-code/statusline.ts +3 -3
  72. package/src/providers/claude-code/task-sync.d.ts +7 -7
  73. package/src/providers/claude-code/task-sync.d.ts.map +1 -1
  74. package/src/providers/claude-code/task-sync.js +1 -3
  75. package/src/providers/claude-code/task-sync.js.map +1 -1
  76. package/src/providers/claude-code/task-sync.ts +1 -3
  77. package/src/providers/claude-code/transport.d.ts +3 -3
  78. package/src/providers/claude-code/transport.d.ts.map +0 -0
  79. package/src/providers/claude-code/transport.js +0 -0
  80. package/src/providers/claude-code/transport.js.map +0 -0
  81. package/src/providers/claude-code/transport.ts +0 -0
  82. package/src/providers/cursor/__tests__/adapter.test.d.ts +1 -1
  83. package/src/providers/cursor/__tests__/adapter.test.d.ts.map +0 -0
  84. package/src/providers/cursor/__tests__/adapter.test.js +2 -2
  85. package/src/providers/cursor/__tests__/adapter.test.js.map +1 -1
  86. package/src/providers/cursor/__tests__/adapter.test.ts +2 -2
  87. package/src/providers/cursor/adapter.d.ts +44 -40
  88. package/src/providers/cursor/adapter.d.ts.map +0 -0
  89. package/src/providers/cursor/adapter.js +0 -0
  90. package/src/providers/cursor/adapter.js.map +0 -0
  91. package/src/providers/cursor/adapter.ts +0 -0
  92. package/src/providers/cursor/hooks.d.ts +29 -29
  93. package/src/providers/cursor/hooks.d.ts.map +0 -0
  94. package/src/providers/cursor/hooks.js +0 -0
  95. package/src/providers/cursor/hooks.js.map +0 -0
  96. package/src/providers/cursor/hooks.ts +0 -0
  97. package/src/providers/cursor/index.d.ts +1 -1
  98. package/src/providers/cursor/index.d.ts.map +0 -0
  99. package/src/providers/cursor/index.js +0 -0
  100. package/src/providers/cursor/index.js.map +0 -0
  101. package/src/providers/cursor/index.ts +0 -0
  102. package/src/providers/cursor/install.d.ts +67 -67
  103. package/src/providers/cursor/install.d.ts.map +1 -1
  104. package/src/providers/cursor/install.js +1 -4
  105. package/src/providers/cursor/install.js.map +1 -1
  106. package/src/providers/cursor/install.ts +1 -4
  107. package/src/providers/cursor/manifest.json +0 -0
  108. package/src/providers/cursor/spawn.d.ts +31 -31
  109. package/src/providers/cursor/spawn.d.ts.map +0 -0
  110. package/src/providers/cursor/spawn.js +0 -0
  111. package/src/providers/cursor/spawn.js.map +1 -1
  112. package/src/providers/cursor/spawn.ts +2 -2
  113. package/src/providers/opencode/__tests__/adapter.test.d.ts +1 -1
  114. package/src/providers/opencode/__tests__/adapter.test.d.ts.map +0 -0
  115. package/src/providers/opencode/__tests__/adapter.test.js +2 -2
  116. package/src/providers/opencode/__tests__/adapter.test.js.map +1 -1
  117. package/src/providers/opencode/__tests__/adapter.test.ts +2 -2
  118. package/src/providers/opencode/adapter.d.ts +50 -46
  119. package/src/providers/opencode/adapter.d.ts.map +0 -0
  120. package/src/providers/opencode/adapter.js +0 -0
  121. package/src/providers/opencode/adapter.js.map +0 -0
  122. package/src/providers/opencode/adapter.ts +0 -0
  123. package/src/providers/opencode/hooks.d.ts +36 -36
  124. package/src/providers/opencode/hooks.d.ts.map +0 -0
  125. package/src/providers/opencode/hooks.js +1 -1
  126. package/src/providers/opencode/hooks.js.map +1 -1
  127. package/src/providers/opencode/hooks.ts +1 -1
  128. package/src/providers/opencode/index.d.ts +2 -2
  129. package/src/providers/opencode/index.d.ts.map +1 -1
  130. package/src/providers/opencode/index.js +1 -1
  131. package/src/providers/opencode/index.js.map +1 -1
  132. package/src/providers/opencode/index.ts +1 -1
  133. package/src/providers/opencode/install.d.ts +46 -46
  134. package/src/providers/opencode/install.d.ts.map +1 -1
  135. package/src/providers/opencode/install.js +1 -4
  136. package/src/providers/opencode/install.js.map +1 -1
  137. package/src/providers/opencode/install.ts +1 -4
  138. package/src/providers/opencode/manifest.json +0 -0
  139. package/src/providers/opencode/spawn.d.ts +42 -39
  140. package/src/providers/opencode/spawn.d.ts.map +1 -1
  141. package/src/providers/opencode/spawn.js +0 -0
  142. package/src/providers/opencode/spawn.js.map +1 -1
  143. package/src/providers/opencode/spawn.ts +2 -7
  144. package/src/registry.d.ts +12 -12
  145. package/src/registry.d.ts.map +1 -1
  146. package/src/registry.js +0 -0
  147. package/src/registry.js.map +1 -1
  148. package/src/registry.ts +1 -3
  149. package/dist/index.d.ts +0 -27
  150. package/dist/index.d.ts.map +0 -1
  151. package/dist/providers/claude-code/adapter.d.ts +0 -75
  152. package/dist/providers/claude-code/adapter.d.ts.map +0 -1
  153. package/dist/providers/claude-code/adapter.js +0 -154
  154. package/dist/providers/claude-code/adapter.js.map +0 -1
  155. package/dist/providers/claude-code/context-monitor.d.ts +0 -24
  156. package/dist/providers/claude-code/context-monitor.d.ts.map +0 -1
  157. package/dist/providers/claude-code/context-monitor.js +0 -148
  158. package/dist/providers/claude-code/context-monitor.js.map +0 -1
  159. package/dist/providers/claude-code/hooks.d.ts +0 -59
  160. package/dist/providers/claude-code/hooks.d.ts.map +0 -1
  161. package/dist/providers/claude-code/hooks.js +0 -77
  162. package/dist/providers/claude-code/hooks.js.map +0 -1
  163. package/dist/providers/claude-code/index.d.ts +0 -24
  164. package/dist/providers/claude-code/index.d.ts.map +0 -1
  165. package/dist/providers/claude-code/index.js +0 -26
  166. package/dist/providers/claude-code/index.js.map +0 -1
  167. package/dist/providers/claude-code/install.d.ts +0 -75
  168. package/dist/providers/claude-code/install.d.ts.map +0 -1
  169. package/dist/providers/claude-code/install.js +0 -237
  170. package/dist/providers/claude-code/install.js.map +0 -1
  171. package/dist/providers/claude-code/paths.d.ts +0 -24
  172. package/dist/providers/claude-code/paths.d.ts.map +0 -1
  173. package/dist/providers/claude-code/paths.js +0 -33
  174. package/dist/providers/claude-code/paths.js.map +0 -1
  175. package/dist/providers/claude-code/spawn.d.ts +0 -60
  176. package/dist/providers/claude-code/spawn.d.ts.map +0 -1
  177. package/dist/providers/claude-code/spawn.js +0 -160
  178. package/dist/providers/claude-code/spawn.js.map +0 -1
  179. package/dist/providers/claude-code/statusline.d.ts +0 -24
  180. package/dist/providers/claude-code/statusline.d.ts.map +0 -1
  181. package/dist/providers/claude-code/statusline.js +0 -85
  182. package/dist/providers/claude-code/statusline.js.map +0 -1
  183. package/dist/providers/claude-code/task-sync.d.ts +0 -27
  184. package/dist/providers/claude-code/task-sync.d.ts.map +0 -1
  185. package/dist/providers/claude-code/task-sync.js +0 -124
  186. package/dist/providers/claude-code/task-sync.js.map +0 -1
  187. package/dist/providers/claude-code/transport.d.ts +0 -14
  188. package/dist/providers/claude-code/transport.d.ts.map +0 -1
  189. package/dist/providers/claude-code/transport.js +0 -18
  190. package/dist/providers/claude-code/transport.js.map +0 -1
  191. package/dist/providers/cursor/adapter.d.ts +0 -62
  192. package/dist/providers/cursor/adapter.d.ts.map +0 -1
  193. package/dist/providers/cursor/adapter.js +0 -124
  194. package/dist/providers/cursor/adapter.js.map +0 -1
  195. package/dist/providers/cursor/hooks.d.ts +0 -48
  196. package/dist/providers/cursor/hooks.d.ts.map +0 -1
  197. package/dist/providers/cursor/hooks.js +0 -55
  198. package/dist/providers/cursor/hooks.js.map +0 -1
  199. package/dist/providers/cursor/index.d.ts +0 -19
  200. package/dist/providers/cursor/index.d.ts.map +0 -1
  201. package/dist/providers/cursor/index.js +0 -21
  202. package/dist/providers/cursor/index.js.map +0 -1
  203. package/dist/providers/cursor/install.d.ts +0 -94
  204. package/dist/providers/cursor/install.d.ts.map +0 -1
  205. package/dist/providers/cursor/install.js +0 -241
  206. package/dist/providers/cursor/install.js.map +0 -1
  207. package/dist/providers/cursor/spawn.d.ts +0 -50
  208. package/dist/providers/cursor/spawn.d.ts.map +0 -1
  209. package/dist/providers/cursor/spawn.js +0 -59
  210. package/dist/providers/cursor/spawn.js.map +0 -1
  211. package/dist/providers/opencode/adapter.d.ts +0 -67
  212. package/dist/providers/opencode/adapter.d.ts.map +0 -1
  213. package/dist/providers/opencode/adapter.js +0 -144
  214. package/dist/providers/opencode/adapter.js.map +0 -1
  215. package/dist/providers/opencode/hooks.d.ts +0 -66
  216. package/dist/providers/opencode/hooks.d.ts.map +0 -1
  217. package/dist/providers/opencode/hooks.js +0 -89
  218. package/dist/providers/opencode/hooks.js.map +0 -1
  219. package/dist/providers/opencode/index.d.ts +0 -20
  220. package/dist/providers/opencode/index.d.ts.map +0 -1
  221. package/dist/providers/opencode/index.js +0 -22
  222. package/dist/providers/opencode/index.js.map +0 -1
  223. package/dist/providers/opencode/install.d.ts +0 -65
  224. package/dist/providers/opencode/install.d.ts.map +0 -1
  225. package/dist/providers/opencode/install.js +0 -183
  226. package/dist/providers/opencode/install.js.map +0 -1
  227. package/dist/providers/opencode/spawn.d.ts +0 -72
  228. package/dist/providers/opencode/spawn.d.ts.map +0 -1
  229. package/dist/providers/opencode/spawn.js +0 -219
  230. package/dist/providers/opencode/spawn.js.map +0 -1
  231. package/dist/registry.d.ts +0 -36
  232. package/dist/registry.d.ts.map +0 -1
  233. package/dist/registry.js +0 -55
  234. package/dist/registry.js.map +0 -1
@@ -1,89 +0,0 @@
1
- /**
2
- * OpenCode Hook Provider
3
- *
4
- * Maps OpenCode's native hook events to CAAMP hook events.
5
- * OpenCode supports 6 of 8 CAAMP events through its agent/hook system.
6
- *
7
- * OpenCode event mapping:
8
- * - session.start -> onSessionStart
9
- * - session.end -> onSessionEnd
10
- * - tool.start -> onToolStart
11
- * - tool.complete -> onToolComplete
12
- * - error -> onError
13
- * - prompt.submit -> onPromptSubmit
14
- *
15
- * @task T5240
16
- */
17
- /**
18
- * Mapping from OpenCode native event names to CAAMP event names.
19
- *
20
- * OpenCode uses dot-delimited event names (e.g. "session.start")
21
- * while CAAMP uses camelCase (e.g. "onSessionStart").
22
- */
23
- const OPENCODE_EVENT_MAP = {
24
- 'session.start': 'onSessionStart',
25
- 'session.end': 'onSessionEnd',
26
- 'tool.start': 'onToolStart',
27
- 'tool.complete': 'onToolComplete',
28
- 'error': 'onError',
29
- 'prompt.submit': 'onPromptSubmit',
30
- };
31
- /**
32
- * Hook provider for OpenCode.
33
- *
34
- * OpenCode registers hooks via its configuration system at
35
- * .opencode/config.json. Hook handlers are defined as shell commands
36
- * or script paths that execute when the corresponding event fires.
37
- *
38
- * Since hooks are registered through the config system (managed by
39
- * the install provider), registerNativeHooks and unregisterNativeHooks
40
- * track registration state without performing filesystem operations.
41
- */
42
- export class OpenCodeHookProvider {
43
- registered = false;
44
- /**
45
- * Map an OpenCode native event name to a CAAMP hook event name.
46
- *
47
- * @param providerEvent - OpenCode event name (e.g. "session.start", "tool.complete")
48
- * @returns CAAMP event name or null if unmapped
49
- */
50
- mapProviderEvent(providerEvent) {
51
- return OPENCODE_EVENT_MAP[providerEvent] ?? null;
52
- }
53
- /**
54
- * Register native hooks for a project.
55
- *
56
- * For OpenCode, hooks are registered via the config system
57
- * (.opencode/config.json), which is handled by the install provider.
58
- * This method marks hooks as registered without performing
59
- * filesystem operations.
60
- *
61
- * @param _projectDir - Project directory (unused; config manages registration)
62
- */
63
- async registerNativeHooks(_projectDir) {
64
- this.registered = true;
65
- }
66
- /**
67
- * Unregister native hooks.
68
- *
69
- * For OpenCode, this is a no-op since hooks are managed through
70
- * the config system. Unregistration happens via the install
71
- * provider's uninstall method.
72
- */
73
- async unregisterNativeHooks() {
74
- this.registered = false;
75
- }
76
- /**
77
- * Check whether hooks have been registered via registerNativeHooks.
78
- */
79
- isRegistered() {
80
- return this.registered;
81
- }
82
- /**
83
- * Get the full event mapping for introspection/debugging.
84
- */
85
- getEventMap() {
86
- return { ...OPENCODE_EVENT_MAP };
87
- }
88
- }
89
- //# sourceMappingURL=hooks.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../src/providers/opencode/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH;;;;;GAKG;AACH,MAAM,kBAAkB,GAA2B;IACjD,eAAe,EAAE,gBAAgB;IACjC,aAAa,EAAE,cAAc;IAC7B,YAAY,EAAE,aAAa;IAC3B,eAAe,EAAE,gBAAgB;IACjC,OAAO,EAAE,SAAS;IAClB,eAAe,EAAE,gBAAgB;CAClC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,OAAO,oBAAoB;IACvB,UAAU,GAAG,KAAK,CAAC;IAE3B;;;;;OAKG;IACH,gBAAgB,CAAC,aAAqB;QACpC,OAAO,kBAAkB,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC;IACnD,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,mBAAmB,CAAC,WAAmB;QAC3C,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;IACzB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,qBAAqB;QACzB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,EAAE,GAAG,kBAAkB,EAAE,CAAC;IACnC,CAAC;CACF"}
@@ -1,20 +0,0 @@
1
- /**
2
- * OpenCode provider adapter.
3
- *
4
- * CLEO provider adapter for OpenCode AI coding assistant.
5
- * Default export is the adapter class for dynamic loading by AdapterManager.
6
- *
7
- * @task T5240
8
- */
9
- import { OpenCodeAdapter } from './adapter.js';
10
- export { OpenCodeAdapter } from './adapter.js';
11
- export { OpenCodeHookProvider } from './hooks.js';
12
- export { OpenCodeSpawnProvider } from './spawn.js';
13
- export { OpenCodeInstallProvider } from './install.js';
14
- export default OpenCodeAdapter;
15
- /**
16
- * Factory function for creating adapter instances.
17
- * Used by AdapterManager's dynamic import fallback.
18
- */
19
- export declare function createAdapter(): OpenCodeAdapter;
20
- //# sourceMappingURL=index.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/opencode/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAEvD,eAAe,eAAe,CAAC;AAE/B;;;GAGG;AACH,wBAAgB,aAAa,IAAI,eAAe,CAE/C"}
@@ -1,22 +0,0 @@
1
- /**
2
- * OpenCode provider adapter.
3
- *
4
- * CLEO provider adapter for OpenCode AI coding assistant.
5
- * Default export is the adapter class for dynamic loading by AdapterManager.
6
- *
7
- * @task T5240
8
- */
9
- import { OpenCodeAdapter } from './adapter.js';
10
- export { OpenCodeAdapter } from './adapter.js';
11
- export { OpenCodeHookProvider } from './hooks.js';
12
- export { OpenCodeSpawnProvider } from './spawn.js';
13
- export { OpenCodeInstallProvider } from './install.js';
14
- export default OpenCodeAdapter;
15
- /**
16
- * Factory function for creating adapter instances.
17
- * Used by AdapterManager's dynamic import fallback.
18
- */
19
- export function createAdapter() {
20
- return new OpenCodeAdapter();
21
- }
22
- //# sourceMappingURL=index.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/providers/opencode/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAEvD,eAAe,eAAe,CAAC;AAE/B;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,eAAe,EAAE,CAAC;AAC/B,CAAC"}
@@ -1,65 +0,0 @@
1
- /**
2
- * OpenCode Install Provider
3
- *
4
- * Handles CLEO installation into OpenCode environments:
5
- * - Registers CLEO MCP server in .opencode/config.json
6
- * - Ensures AGENTS.md has CLEO @-references
7
- *
8
- * @task T5240
9
- */
10
- import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cleocode/contracts';
11
- /**
12
- * Install provider for OpenCode.
13
- *
14
- * Manages CLEO's integration with OpenCode by:
15
- * 1. Registering the CLEO MCP server in .opencode/config.json
16
- * 2. Ensuring AGENTS.md contains @-references to CLEO instruction files
17
- */
18
- export declare class OpenCodeInstallProvider implements AdapterInstallProvider {
19
- private installedProjectDir;
20
- /**
21
- * Install CLEO into an OpenCode project.
22
- *
23
- * @param options - Installation options including project directory and MCP server path
24
- * @returns Result describing what was installed
25
- */
26
- install(options: InstallOptions): Promise<InstallResult>;
27
- /**
28
- * Uninstall CLEO from the current OpenCode project.
29
- *
30
- * Removes the MCP server registration from .opencode/config.json.
31
- * Does not remove AGENTS.md references (they are harmless if CLEO is not present).
32
- */
33
- uninstall(): Promise<void>;
34
- /**
35
- * Check whether CLEO is installed in the current environment.
36
- *
37
- * Checks for MCP server registered in .opencode/config.json.
38
- * Returns true if the CLEO MCP server entry is found.
39
- */
40
- isInstalled(): Promise<boolean>;
41
- /**
42
- * Ensure AGENTS.md contains @-references to CLEO instruction files.
43
- *
44
- * Creates AGENTS.md if it does not exist. Appends any missing references.
45
- *
46
- * @param projectDir - Project root directory
47
- */
48
- ensureInstructionReferences(projectDir: string): Promise<void>;
49
- /**
50
- * Register the CLEO MCP server in .opencode/config.json.
51
- *
52
- * OpenCode stores its MCP server configuration in .opencode/config.json
53
- * under the mcpServers key.
54
- *
55
- * @returns true if registration was performed or updated
56
- */
57
- private registerMcpServer;
58
- /**
59
- * Update AGENTS.md with CLEO @-references.
60
- *
61
- * @returns true if the file was created or modified
62
- */
63
- private updateInstructionFile;
64
- }
65
- //# sourceMappingURL=install.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/opencode/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAWjG;;;;;;GAMG;AACH,qBAAa,uBAAwB,YAAW,sBAAsB;IACpE,OAAO,CAAC,mBAAmB,CAAuB;IAElD;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAgC9D;;;;;OAKG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBhC;;;;;OAKG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAkBrC;;;;;;OAMG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;;;;;;OAOG;IACH,OAAO,CAAC,iBAAiB;IA6BzB;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;CA8B9B"}
@@ -1,183 +0,0 @@
1
- /**
2
- * OpenCode Install Provider
3
- *
4
- * Handles CLEO installation into OpenCode environments:
5
- * - Registers CLEO MCP server in .opencode/config.json
6
- * - Ensures AGENTS.md has CLEO @-references
7
- *
8
- * @task T5240
9
- */
10
- import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
11
- import { join } from 'node:path';
12
- /** Lines that should appear in AGENTS.md to reference CLEO. */
13
- const INSTRUCTION_REFERENCES = [
14
- '@~/.cleo/templates/CLEO-INJECTION.md',
15
- '@.cleo/memory-bridge.md',
16
- ];
17
- /** MCP server registration key used in OpenCode config. */
18
- const MCP_SERVER_KEY = 'cleo';
19
- /**
20
- * Install provider for OpenCode.
21
- *
22
- * Manages CLEO's integration with OpenCode by:
23
- * 1. Registering the CLEO MCP server in .opencode/config.json
24
- * 2. Ensuring AGENTS.md contains @-references to CLEO instruction files
25
- */
26
- export class OpenCodeInstallProvider {
27
- installedProjectDir = null;
28
- /**
29
- * Install CLEO into an OpenCode project.
30
- *
31
- * @param options - Installation options including project directory and MCP server path
32
- * @returns Result describing what was installed
33
- */
34
- async install(options) {
35
- const { projectDir, mcpServerPath } = options;
36
- const installedAt = new Date().toISOString();
37
- let instructionFileUpdated = false;
38
- let mcpRegistered = false;
39
- const details = {};
40
- // Step 1: Register MCP server in .opencode/config.json
41
- if (mcpServerPath) {
42
- mcpRegistered = this.registerMcpServer(projectDir, mcpServerPath);
43
- if (mcpRegistered) {
44
- details.mcpConfigPath = join(projectDir, '.opencode', 'config.json');
45
- }
46
- }
47
- // Step 2: Ensure AGENTS.md has @-references
48
- instructionFileUpdated = this.updateInstructionFile(projectDir);
49
- if (instructionFileUpdated) {
50
- details.instructionFile = join(projectDir, 'AGENTS.md');
51
- }
52
- this.installedProjectDir = projectDir;
53
- return {
54
- success: true,
55
- installedAt,
56
- instructionFileUpdated,
57
- mcpRegistered,
58
- details,
59
- };
60
- }
61
- /**
62
- * Uninstall CLEO from the current OpenCode project.
63
- *
64
- * Removes the MCP server registration from .opencode/config.json.
65
- * Does not remove AGENTS.md references (they are harmless if CLEO is not present).
66
- */
67
- async uninstall() {
68
- if (!this.installedProjectDir)
69
- return;
70
- const configPath = join(this.installedProjectDir, '.opencode', '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
- this.installedProjectDir = null;
86
- }
87
- /**
88
- * Check whether CLEO is installed in the current environment.
89
- *
90
- * Checks for MCP server registered in .opencode/config.json.
91
- * Returns true if the CLEO MCP server entry is found.
92
- */
93
- async isInstalled() {
94
- // Check current directory for .opencode/config.json with cleo server
95
- const configPath = join(process.cwd(), '.opencode', 'config.json');
96
- if (existsSync(configPath)) {
97
- try {
98
- const config = JSON.parse(readFileSync(configPath, 'utf-8'));
99
- const mcpServers = config.mcpServers;
100
- if (mcpServers && MCP_SERVER_KEY in mcpServers) {
101
- return true;
102
- }
103
- }
104
- catch {
105
- // Fall through
106
- }
107
- }
108
- return false;
109
- }
110
- /**
111
- * Ensure AGENTS.md contains @-references to CLEO instruction files.
112
- *
113
- * Creates AGENTS.md if it does not exist. Appends any missing references.
114
- *
115
- * @param projectDir - Project root directory
116
- */
117
- async ensureInstructionReferences(projectDir) {
118
- this.updateInstructionFile(projectDir);
119
- }
120
- /**
121
- * Register the CLEO MCP server in .opencode/config.json.
122
- *
123
- * OpenCode stores its MCP server configuration in .opencode/config.json
124
- * under the mcpServers key.
125
- *
126
- * @returns true if registration was performed or updated
127
- */
128
- registerMcpServer(projectDir, mcpServerPath) {
129
- const openCodeDir = join(projectDir, '.opencode');
130
- const configPath = join(openCodeDir, 'config.json');
131
- let config = {};
132
- mkdirSync(openCodeDir, { recursive: true });
133
- if (existsSync(configPath)) {
134
- try {
135
- config = JSON.parse(readFileSync(configPath, 'utf-8'));
136
- }
137
- catch {
138
- // Start fresh on parse error
139
- }
140
- }
141
- if (!config.mcpServers || typeof config.mcpServers !== 'object') {
142
- config.mcpServers = {};
143
- }
144
- const mcpServers = config.mcpServers;
145
- mcpServers[MCP_SERVER_KEY] = {
146
- command: 'node',
147
- args: [mcpServerPath],
148
- };
149
- writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
150
- return true;
151
- }
152
- /**
153
- * Update AGENTS.md with CLEO @-references.
154
- *
155
- * @returns true if the file was created or modified
156
- */
157
- updateInstructionFile(projectDir) {
158
- const agentsMdPath = join(projectDir, 'AGENTS.md');
159
- let content = '';
160
- let existed = false;
161
- if (existsSync(agentsMdPath)) {
162
- content = readFileSync(agentsMdPath, 'utf-8');
163
- existed = true;
164
- }
165
- const missingRefs = INSTRUCTION_REFERENCES.filter((ref) => !content.includes(ref));
166
- if (missingRefs.length === 0) {
167
- return false;
168
- }
169
- const refsBlock = missingRefs.join('\n');
170
- if (existed) {
171
- // Append missing references
172
- const separator = content.endsWith('\n') ? '' : '\n';
173
- content = content + separator + refsBlock + '\n';
174
- }
175
- else {
176
- // Create new AGENTS.md with references
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/opencode/install.ts"],"names":[],"mappings":"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"}
@@ -1,72 +0,0 @@
1
- /**
2
- * OpenCode Spawn Provider
3
- *
4
- * Implements AdapterSpawnProvider for OpenCode CLI.
5
- * Migrated from src/core/spawn/adapters/opencode-adapter.ts
6
- *
7
- * Uses `opencode run --agent ... --format json` to spawn subagent
8
- * processes. Processes run detached and are tracked by PID for
9
- * listing and termination.
10
- *
11
- * @task T5240
12
- */
13
- import type { AdapterSpawnProvider, SpawnContext, SpawnResult } from '@cleocode/contracts';
14
- /**
15
- * Build the markdown content for an OpenCode agent definition file.
16
- *
17
- * OpenCode agents are defined as markdown files with YAML frontmatter
18
- * in the .opencode/agent/ directory.
19
- *
20
- * @param description - Agent description for frontmatter
21
- * @param instructions - Markdown instructions body
22
- * @returns Complete agent definition markdown
23
- */
24
- export declare function buildOpenCodeAgentMarkdown(description: string, instructions: string): string;
25
- /**
26
- * Spawn provider for OpenCode.
27
- *
28
- * Spawns detached OpenCode CLI processes for subagent execution.
29
- * Each spawn ensures a CLEO subagent definition exists, then runs
30
- * `opencode run --format json --agent <name> --title <title> <prompt>`
31
- * as a detached, unref'd child process.
32
- */
33
- export declare class OpenCodeSpawnProvider implements AdapterSpawnProvider {
34
- /** Map of instance IDs to tracked process info. */
35
- private processMap;
36
- /**
37
- * Check if the OpenCode CLI is available in PATH.
38
- *
39
- * @returns true if `opencode` is found via `which`
40
- */
41
- canSpawn(): Promise<boolean>;
42
- /**
43
- * Spawn a subagent via OpenCode CLI.
44
- *
45
- * Ensures the CLEO subagent definition exists in the project's
46
- * .opencode/agent/ directory, then spawns a detached OpenCode
47
- * process. The process runs independently of the parent.
48
- *
49
- * @param context - Spawn context with taskId, prompt, and options
50
- * @returns Spawn result with instance ID and status
51
- */
52
- spawn(context: SpawnContext): Promise<SpawnResult>;
53
- /**
54
- * List currently running OpenCode subagent processes.
55
- *
56
- * Checks each tracked process via kill(pid, 0) to verify it is still alive.
57
- * Dead processes are automatically cleaned from the tracking map.
58
- *
59
- * @returns Array of spawn results for running processes
60
- */
61
- listRunning(): Promise<SpawnResult[]>;
62
- /**
63
- * Terminate a running spawn by instance ID.
64
- *
65
- * Sends SIGTERM to the tracked process. If the process is not found
66
- * or has already exited, this is a no-op.
67
- *
68
- * @param instanceId - ID of the spawn instance to terminate
69
- */
70
- terminate(instanceId: string): Promise<void>;
71
- }
72
- //# sourceMappingURL=spawn.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../src/providers/opencode/spawn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAiB3F;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,MAAM,CAYR;AA4CD;;;;;;;GAOG;AACH,qBAAa,qBAAsB,YAAW,oBAAoB;IAChE,mDAAmD;IACnD,OAAO,CAAC,UAAU,CAAqC;IAEvD;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IASlC;;;;;;;;;OASG;IACG,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAiExD;;;;;;;OAOG;IACG,WAAW,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAqB3C;;;;;;;OAOG;IACG,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAWnD"}