@cleocode/adapters 2026.3.71 → 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,70 @@
1
+ /**
2
+ * Gemini CLI Adapter
3
+ *
4
+ * Main CLEOProviderAdapter implementation for Google Gemini CLI.
5
+ * Provides hooks and install capabilities for CLEO integration.
6
+ *
7
+ * @task T161
8
+ * @epic T134
9
+ */
10
+ import type { AdapterCapabilities, AdapterHealthStatus, CLEOProviderAdapter } from '@cleocode/contracts';
11
+ import { GeminiCliHookProvider } from './hooks.js';
12
+ import { GeminiCliInstallProvider } from './install.js';
13
+ /**
14
+ * CLEO provider adapter for Google Gemini CLI.
15
+ *
16
+ * Bridges CLEO's adapter system with Gemini CLI's native capabilities:
17
+ * - Hooks: Maps Gemini CLI events (SessionStart, PreToolUse, etc.) to CAAMP events
18
+ * - Install: Registers MCP server in ~/.gemini/settings.json and ensures AGENTS.md references
19
+ *
20
+ * @task T161
21
+ * @epic T134
22
+ */
23
+ export declare class GeminiCliAdapter implements CLEOProviderAdapter {
24
+ readonly id = "gemini-cli";
25
+ readonly name = "Gemini CLI";
26
+ readonly version = "1.0.0";
27
+ capabilities: AdapterCapabilities;
28
+ hooks: GeminiCliHookProvider;
29
+ install: GeminiCliInstallProvider;
30
+ private projectDir;
31
+ private initialized;
32
+ constructor();
33
+ /**
34
+ * Initialize the adapter for a given project directory.
35
+ *
36
+ * @param projectDir - Root directory of the project
37
+ * @task T161
38
+ */
39
+ initialize(projectDir: string): Promise<void>;
40
+ /**
41
+ * Dispose the adapter and clean up resources.
42
+ *
43
+ * Unregisters hooks and releases any tracked state.
44
+ * @task T161
45
+ */
46
+ dispose(): Promise<void>;
47
+ /**
48
+ * Run a health check to verify Gemini CLI is accessible.
49
+ *
50
+ * Checks:
51
+ * 1. Adapter has been initialized
52
+ * 2. Gemini CLI binary is available in PATH
53
+ * 3. ~/.gemini/ configuration directory exists
54
+ *
55
+ * @returns Health status with details about each check
56
+ * @task T161
57
+ */
58
+ healthCheck(): Promise<AdapterHealthStatus>;
59
+ /**
60
+ * Check whether the adapter has been initialized.
61
+ * @task T161
62
+ */
63
+ isInitialized(): boolean;
64
+ /**
65
+ * Get the project directory this adapter was initialized with.
66
+ * @task T161
67
+ */
68
+ getProjectDir(): string | null;
69
+ }
70
+ //# sourceMappingURL=adapter.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/providers/gemini-cli/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAIxD;;;;;;;;;GASG;AACH,qBAAa,gBAAiB,YAAW,mBAAmB;IAC1D,QAAQ,CAAC,EAAE,gBAAgB;IAC3B,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,OAAO,WAAW;IAE3B,YAAY,EAAE,mBAAmB,CAuB/B;IAEF,KAAK,EAAE,qBAAqB,CAAC;IAC7B,OAAO,EAAE,wBAAwB,CAAC;IAElC,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,WAAW,CAAS;;IAO5B;;;;;OAKG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnD;;;;;OAKG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ9B;;;;;;;;;;OAUG;IACG,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAqCjD;;;OAGG;IACH,aAAa,IAAI,OAAO;IAIxB;;;OAGG;IACH,aAAa,IAAI,MAAM,GAAG,IAAI;CAG/B"}
@@ -0,0 +1,145 @@
1
+ /**
2
+ * Gemini CLI Adapter
3
+ *
4
+ * Main CLEOProviderAdapter implementation for Google Gemini CLI.
5
+ * Provides hooks and install capabilities for CLEO integration.
6
+ *
7
+ * @task T161
8
+ * @epic T134
9
+ */
10
+ import { exec } from 'node:child_process';
11
+ import { existsSync } from 'node:fs';
12
+ import { homedir } from 'node:os';
13
+ import { join } from 'node:path';
14
+ import { promisify } from 'node:util';
15
+ import { GeminiCliHookProvider } from './hooks.js';
16
+ import { GeminiCliInstallProvider } from './install.js';
17
+ const execAsync = promisify(exec);
18
+ /**
19
+ * CLEO provider adapter for Google Gemini CLI.
20
+ *
21
+ * Bridges CLEO's adapter system with Gemini CLI's native capabilities:
22
+ * - Hooks: Maps Gemini CLI events (SessionStart, PreToolUse, etc.) to CAAMP events
23
+ * - Install: Registers MCP server in ~/.gemini/settings.json and ensures AGENTS.md references
24
+ *
25
+ * @task T161
26
+ * @epic T134
27
+ */
28
+ export class GeminiCliAdapter {
29
+ id = 'gemini-cli';
30
+ name = 'Gemini CLI';
31
+ version = '1.0.0';
32
+ capabilities = {
33
+ supportsHooks: true,
34
+ supportedHookEvents: [
35
+ 'SessionStart',
36
+ 'SessionEnd',
37
+ 'BeforeAgent',
38
+ 'AfterAgent',
39
+ 'BeforeTool',
40
+ 'AfterTool',
41
+ 'BeforeModel',
42
+ 'AfterModel',
43
+ 'PreCompress',
44
+ 'Notification',
45
+ ],
46
+ supportsSpawn: false,
47
+ supportsInstall: true,
48
+ supportsMcp: true,
49
+ supportsInstructionFiles: false,
50
+ supportsContextMonitor: false,
51
+ supportsStatusline: false,
52
+ supportsProviderPaths: false,
53
+ supportsTransport: false,
54
+ supportsTaskSync: false,
55
+ };
56
+ hooks;
57
+ install;
58
+ projectDir = null;
59
+ initialized = false;
60
+ constructor() {
61
+ this.hooks = new GeminiCliHookProvider();
62
+ this.install = new GeminiCliInstallProvider();
63
+ }
64
+ /**
65
+ * Initialize the adapter for a given project directory.
66
+ *
67
+ * @param projectDir - Root directory of the project
68
+ * @task T161
69
+ */
70
+ async initialize(projectDir) {
71
+ this.projectDir = projectDir;
72
+ this.initialized = true;
73
+ }
74
+ /**
75
+ * Dispose the adapter and clean up resources.
76
+ *
77
+ * Unregisters hooks and releases any tracked state.
78
+ * @task T161
79
+ */
80
+ async dispose() {
81
+ if (this.hooks.isRegistered()) {
82
+ await this.hooks.unregisterNativeHooks();
83
+ }
84
+ this.initialized = false;
85
+ this.projectDir = null;
86
+ }
87
+ /**
88
+ * Run a health check to verify Gemini CLI is accessible.
89
+ *
90
+ * Checks:
91
+ * 1. Adapter has been initialized
92
+ * 2. Gemini CLI binary is available in PATH
93
+ * 3. ~/.gemini/ configuration directory exists
94
+ *
95
+ * @returns Health status with details about each check
96
+ * @task T161
97
+ */
98
+ async healthCheck() {
99
+ const details = {};
100
+ if (!this.initialized) {
101
+ return {
102
+ healthy: false,
103
+ provider: this.id,
104
+ details: { error: 'Adapter not initialized' },
105
+ };
106
+ }
107
+ // Check Gemini CLI availability
108
+ let cliAvailable = false;
109
+ try {
110
+ const { stdout } = await execAsync('which gemini');
111
+ cliAvailable = stdout.trim().length > 0;
112
+ details.cliPath = stdout.trim();
113
+ }
114
+ catch {
115
+ details.cliAvailable = false;
116
+ }
117
+ // Check for Gemini CLI config directory
118
+ const geminiConfigDir = join(homedir(), '.gemini');
119
+ const configExists = existsSync(geminiConfigDir);
120
+ details.configDirExists = configExists;
121
+ // Healthy if CLI is available (primary requirement)
122
+ const healthy = cliAvailable;
123
+ details.cliAvailable = cliAvailable;
124
+ return {
125
+ healthy,
126
+ provider: this.id,
127
+ details,
128
+ };
129
+ }
130
+ /**
131
+ * Check whether the adapter has been initialized.
132
+ * @task T161
133
+ */
134
+ isInitialized() {
135
+ return this.initialized;
136
+ }
137
+ /**
138
+ * Get the project directory this adapter was initialized with.
139
+ * @task T161
140
+ */
141
+ getProjectDir() {
142
+ return this.projectDir;
143
+ }
144
+ }
145
+ //# sourceMappingURL=adapter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/providers/gemini-cli/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAMtC,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAExD,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAElC;;;;;;;;;GASG;AACH,MAAM,OAAO,gBAAgB;IAClB,EAAE,GAAG,YAAY,CAAC;IAClB,IAAI,GAAG,YAAY,CAAC;IACpB,OAAO,GAAG,OAAO,CAAC;IAE3B,YAAY,GAAwB;QAClC,aAAa,EAAE,IAAI;QACnB,mBAAmB,EAAE;YACnB,cAAc;YACd,YAAY;YACZ,aAAa;YACb,YAAY;YACZ,YAAY;YACZ,WAAW;YACX,aAAa;YACb,YAAY;YACZ,aAAa;YACb,cAAc;SACf;QACD,aAAa,EAAE,KAAK;QACpB,eAAe,EAAE,IAAI;QACrB,WAAW,EAAE,IAAI;QACjB,wBAAwB,EAAE,KAAK;QAC/B,sBAAsB,EAAE,KAAK;QAC7B,kBAAkB,EAAE,KAAK;QACzB,qBAAqB,EAAE,KAAK;QAC5B,iBAAiB,EAAE,KAAK;QACxB,gBAAgB,EAAE,KAAK;KACxB,CAAC;IAEF,KAAK,CAAwB;IAC7B,OAAO,CAA2B;IAE1B,UAAU,GAAkB,IAAI,CAAC;IACjC,WAAW,GAAG,KAAK,CAAC;IAE5B;QACE,IAAI,CAAC,KAAK,GAAG,IAAI,qBAAqB,EAAE,CAAC;QACzC,IAAI,CAAC,OAAO,GAAG,IAAI,wBAAwB,EAAE,CAAC;IAChD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,UAAU,CAAC,UAAkB;QACjC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,OAAO;QACX,IAAI,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,EAAE,CAAC;YAC9B,MAAM,IAAI,CAAC,KAAK,CAAC,qBAAqB,EAAE,CAAC;QAC3C,CAAC;QACD,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QACzB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;IACzB,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,WAAW;QACf,MAAM,OAAO,GAA4B,EAAE,CAAC;QAE5C,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,QAAQ,EAAE,IAAI,CAAC,EAAE;gBACjB,OAAO,EAAE,EAAE,KAAK,EAAE,yBAAyB,EAAE;aAC9C,CAAC;QACJ,CAAC;QAED,gCAAgC;QAChC,IAAI,YAAY,GAAG,KAAK,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,cAAc,CAAC,CAAC;YACnD,YAAY,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;YACxC,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;QAClC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,YAAY,GAAG,KAAK,CAAC;QAC/B,CAAC;QAED,wCAAwC;QACxC,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;QACnD,MAAM,YAAY,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;QACjD,OAAO,CAAC,eAAe,GAAG,YAAY,CAAC;QAEvC,oDAAoD;QACpD,MAAM,OAAO,GAAG,YAAY,CAAC;QAC7B,OAAO,CAAC,YAAY,GAAG,YAAY,CAAC;QAEpC,OAAO;YACL,OAAO;YACP,QAAQ,EAAE,IAAI,CAAC,EAAE;YACjB,OAAO;SACR,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;;OAGG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;CACF"}
@@ -0,0 +1,92 @@
1
+ /**
2
+ * Gemini CLI Hook Provider
3
+ *
4
+ * Maps Gemini CLI's native hook events to CAAMP canonical hook events.
5
+ * Gemini CLI supports 11 canonical events through its hook system.
6
+ *
7
+ * Gemini CLI event mapping:
8
+ * - SessionStart -> SessionStart
9
+ * - SessionEnd -> SessionEnd
10
+ * - PromptSubmit -> BeforeAgent
11
+ * - ResponseComplete -> AfterAgent
12
+ * - PreToolUse -> BeforeTool
13
+ * - PostToolUse -> AfterTool
14
+ * - PreModel -> BeforeModel
15
+ * - PostModel -> AfterModel
16
+ * - PreCompact -> PreCompress
17
+ * - Notification -> Notification
18
+ *
19
+ * @task T161
20
+ * @epic T134
21
+ */
22
+ import type { AdapterHookProvider } from '@cleocode/contracts';
23
+ /**
24
+ * Hook provider for Gemini CLI.
25
+ *
26
+ * Gemini CLI registers hooks via its configuration system at
27
+ * ~/.gemini/. Hook handlers are shell scripts or commands that
28
+ * execute when the corresponding event fires.
29
+ *
30
+ * Since hooks are registered through the config system (managed by
31
+ * the install provider), registerNativeHooks and unregisterNativeHooks
32
+ * track registration state without performing filesystem operations.
33
+ *
34
+ * @task T161
35
+ * @epic T134
36
+ */
37
+ export declare class GeminiCliHookProvider implements AdapterHookProvider {
38
+ private registered;
39
+ /**
40
+ * Map a Gemini CLI native event name to a CAAMP hook event name.
41
+ *
42
+ * @param providerEvent - Gemini CLI event name (e.g. "SessionStart", "PreToolUse")
43
+ * @returns CAAMP event name or null if unmapped
44
+ * @task T161
45
+ */
46
+ mapProviderEvent(providerEvent: string): string | null;
47
+ /**
48
+ * Register native hooks for a project.
49
+ *
50
+ * For Gemini CLI, hooks are registered via the config system
51
+ * (~/.gemini/), which is handled by the install provider.
52
+ * This method marks hooks as registered without performing
53
+ * filesystem operations.
54
+ *
55
+ * @param _projectDir - Project directory (unused; hooks are global)
56
+ * @task T161
57
+ */
58
+ registerNativeHooks(_projectDir: string): Promise<void>;
59
+ /**
60
+ * Unregister native hooks.
61
+ *
62
+ * For Gemini CLI, this is a no-op since hooks are managed through
63
+ * the config system. Unregistration happens via the install
64
+ * provider's uninstall method.
65
+ * @task T161
66
+ */
67
+ unregisterNativeHooks(): Promise<void>;
68
+ /**
69
+ * Check whether hooks have been registered via registerNativeHooks.
70
+ * @task T161
71
+ */
72
+ isRegistered(): boolean;
73
+ /**
74
+ * Get the full event mapping for introspection/debugging.
75
+ * @task T161
76
+ */
77
+ getEventMap(): Readonly<Record<string, string>>;
78
+ /**
79
+ * Extract a plain-text transcript from Gemini CLI session data.
80
+ *
81
+ * Reads the most recent session file under ~/.gemini/ and extracts
82
+ * turn text into a flat string for brain observation extraction.
83
+ *
84
+ * Returns null when no session data is found or on any read error.
85
+ *
86
+ * @param _sessionId - CLEO session ID (unused; reads the most recent file)
87
+ * @param _projectDir - Project directory (unused; Gemini CLI uses global paths)
88
+ * @task T161 @epic T134
89
+ */
90
+ getTranscript(_sessionId: string, _projectDir: string): Promise<string | null>;
91
+ }
92
+ //# sourceMappingURL=hooks.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/providers/gemini-cli/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAkB/D;;;;;;;;;;;;;GAaG;AACH,qBAAa,qBAAsB,YAAW,mBAAmB;IAC/D,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;;;OAMG;IACH,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAItD;;;;;;;;;;OAUG;IACG,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D;;;;;;;OAOG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5C;;;OAGG;IACH,YAAY,IAAI,OAAO;IAIvB;;;OAGG;IACH,WAAW,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAI/C;;;;;;;;;;;OAWG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAmDrF"}
@@ -0,0 +1,169 @@
1
+ /**
2
+ * Gemini CLI Hook Provider
3
+ *
4
+ * Maps Gemini CLI's native hook events to CAAMP canonical hook events.
5
+ * Gemini CLI supports 11 canonical events through its hook system.
6
+ *
7
+ * Gemini CLI event mapping:
8
+ * - SessionStart -> SessionStart
9
+ * - SessionEnd -> SessionEnd
10
+ * - PromptSubmit -> BeforeAgent
11
+ * - ResponseComplete -> AfterAgent
12
+ * - PreToolUse -> BeforeTool
13
+ * - PostToolUse -> AfterTool
14
+ * - PreModel -> BeforeModel
15
+ * - PostModel -> AfterModel
16
+ * - PreCompact -> PreCompress
17
+ * - Notification -> Notification
18
+ *
19
+ * @task T161
20
+ * @epic T134
21
+ */
22
+ import { readdir, readFile } from 'node:fs/promises';
23
+ import { join } from 'node:path';
24
+ /**
25
+ * Mapping from Gemini CLI native event names to CAAMP canonical event names.
26
+ */
27
+ const GEMINI_CLI_EVENT_MAP = {
28
+ SessionStart: 'SessionStart',
29
+ SessionEnd: 'SessionEnd',
30
+ PromptSubmit: 'BeforeAgent',
31
+ ResponseComplete: 'AfterAgent',
32
+ PreToolUse: 'BeforeTool',
33
+ PostToolUse: 'AfterTool',
34
+ PreModel: 'BeforeModel',
35
+ PostModel: 'AfterModel',
36
+ PreCompact: 'PreCompress',
37
+ Notification: 'Notification',
38
+ };
39
+ /**
40
+ * Hook provider for Gemini CLI.
41
+ *
42
+ * Gemini CLI registers hooks via its configuration system at
43
+ * ~/.gemini/. Hook handlers are shell scripts or commands that
44
+ * execute when the corresponding event fires.
45
+ *
46
+ * Since hooks are registered through the config system (managed by
47
+ * the install provider), registerNativeHooks and unregisterNativeHooks
48
+ * track registration state without performing filesystem operations.
49
+ *
50
+ * @task T161
51
+ * @epic T134
52
+ */
53
+ export class GeminiCliHookProvider {
54
+ registered = false;
55
+ /**
56
+ * Map a Gemini CLI native event name to a CAAMP hook event name.
57
+ *
58
+ * @param providerEvent - Gemini CLI event name (e.g. "SessionStart", "PreToolUse")
59
+ * @returns CAAMP event name or null if unmapped
60
+ * @task T161
61
+ */
62
+ mapProviderEvent(providerEvent) {
63
+ return GEMINI_CLI_EVENT_MAP[providerEvent] ?? null;
64
+ }
65
+ /**
66
+ * Register native hooks for a project.
67
+ *
68
+ * For Gemini CLI, hooks are registered via the config system
69
+ * (~/.gemini/), which is handled by the install provider.
70
+ * This method marks hooks as registered without performing
71
+ * filesystem operations.
72
+ *
73
+ * @param _projectDir - Project directory (unused; hooks are global)
74
+ * @task T161
75
+ */
76
+ async registerNativeHooks(_projectDir) {
77
+ this.registered = true;
78
+ }
79
+ /**
80
+ * Unregister native hooks.
81
+ *
82
+ * For Gemini CLI, this is a no-op since hooks are managed through
83
+ * the config system. Unregistration happens via the install
84
+ * provider's uninstall method.
85
+ * @task T161
86
+ */
87
+ async unregisterNativeHooks() {
88
+ this.registered = false;
89
+ }
90
+ /**
91
+ * Check whether hooks have been registered via registerNativeHooks.
92
+ * @task T161
93
+ */
94
+ isRegistered() {
95
+ return this.registered;
96
+ }
97
+ /**
98
+ * Get the full event mapping for introspection/debugging.
99
+ * @task T161
100
+ */
101
+ getEventMap() {
102
+ return { ...GEMINI_CLI_EVENT_MAP };
103
+ }
104
+ /**
105
+ * Extract a plain-text transcript from Gemini CLI session data.
106
+ *
107
+ * Reads the most recent session file under ~/.gemini/ and extracts
108
+ * turn text into a flat string for brain observation extraction.
109
+ *
110
+ * Returns null when no session data is found or on any read error.
111
+ *
112
+ * @param _sessionId - CLEO session ID (unused; reads the most recent file)
113
+ * @param _projectDir - Project directory (unused; Gemini CLI uses global paths)
114
+ * @task T161 @epic T134
115
+ */
116
+ async getTranscript(_sessionId, _projectDir) {
117
+ try {
118
+ const homeDir = process.env.HOME ?? process.env.USERPROFILE ?? '/root';
119
+ const geminiDir = join(homeDir, '.gemini');
120
+ let allFiles = [];
121
+ try {
122
+ const entries = await readdir(geminiDir, { withFileTypes: true });
123
+ for (const entry of entries) {
124
+ if (!entry.isFile())
125
+ continue;
126
+ const name = entry.name;
127
+ if (name.endsWith('.json') || name.endsWith('.jsonl')) {
128
+ allFiles.push(join(geminiDir, name));
129
+ }
130
+ }
131
+ }
132
+ catch {
133
+ return null;
134
+ }
135
+ if (allFiles.length === 0)
136
+ return null;
137
+ // Sort descending by filename (timestamps in filenames sort naturally)
138
+ allFiles = allFiles.sort((a, b) => b.localeCompare(a));
139
+ const mostRecent = allFiles[0];
140
+ if (!mostRecent)
141
+ return null;
142
+ const raw = await readFile(mostRecent, 'utf-8');
143
+ const turns = [];
144
+ // Support both JSONL (one JSON per line) and JSON array formats
145
+ const lines = raw.split('\n').filter((l) => l.trim());
146
+ for (const line of lines) {
147
+ try {
148
+ const entry = JSON.parse(line);
149
+ const role = entry.role;
150
+ const content = entry.content;
151
+ if (role === 'assistant' && typeof content === 'string') {
152
+ turns.push(`assistant: ${content}`);
153
+ }
154
+ else if (role === 'user' && typeof content === 'string') {
155
+ turns.push(`user: ${content}`);
156
+ }
157
+ }
158
+ catch {
159
+ // Skip malformed lines
160
+ }
161
+ }
162
+ return turns.length > 0 ? turns.join('\n') : null;
163
+ }
164
+ catch {
165
+ return null;
166
+ }
167
+ }
168
+ }
169
+ //# sourceMappingURL=hooks.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../src/providers/gemini-cli/hooks.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,22 @@
1
+ /**
2
+ * Gemini CLI provider adapter.
3
+ *
4
+ * CLEO provider adapter for Google Gemini CLI.
5
+ * Default export is the adapter class for dynamic loading by AdapterManager.
6
+ *
7
+ * @task T161
8
+ * @epic T134
9
+ */
10
+ import { GeminiCliAdapter } from './adapter.js';
11
+ export { GeminiCliAdapter } from './adapter.js';
12
+ export { GeminiCliHookProvider } from './hooks.js';
13
+ export { GeminiCliInstallProvider } from './install.js';
14
+ export default GeminiCliAdapter;
15
+ /**
16
+ * Factory function for creating adapter instances.
17
+ * Used by AdapterManager's dynamic import fallback.
18
+ *
19
+ * @task T161
20
+ */
21
+ export declare function createAdapter(): GeminiCliAdapter;
22
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/gemini-cli/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAExD,eAAe,gBAAgB,CAAC;AAEhC;;;;;GAKG;AACH,wBAAgB,aAAa,IAAI,gBAAgB,CAEhD"}
@@ -0,0 +1,24 @@
1
+ /**
2
+ * Gemini CLI provider adapter.
3
+ *
4
+ * CLEO provider adapter for Google Gemini CLI.
5
+ * Default export is the adapter class for dynamic loading by AdapterManager.
6
+ *
7
+ * @task T161
8
+ * @epic T134
9
+ */
10
+ import { GeminiCliAdapter } from './adapter.js';
11
+ export { GeminiCliAdapter } from './adapter.js';
12
+ export { GeminiCliHookProvider } from './hooks.js';
13
+ export { GeminiCliInstallProvider } from './install.js';
14
+ export default GeminiCliAdapter;
15
+ /**
16
+ * Factory function for creating adapter instances.
17
+ * Used by AdapterManager's dynamic import fallback.
18
+ *
19
+ * @task T161
20
+ */
21
+ export function createAdapter() {
22
+ return new GeminiCliAdapter();
23
+ }
24
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/providers/gemini-cli/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAExD,eAAe,gBAAgB,CAAC;AAEhC;;;;;GAKG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,gBAAgB,EAAE,CAAC;AAChC,CAAC"}
@@ -0,0 +1,74 @@
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 type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cleocode/contracts';
12
+ /**
13
+ * Install provider for Gemini CLI.
14
+ *
15
+ * Manages CLEO's integration with Gemini CLI by:
16
+ * 1. Registering the CLEO MCP server in ~/.gemini/settings.json
17
+ * 2. Ensuring AGENTS.md contains @-references to CLEO instruction files
18
+ *
19
+ * @task T161
20
+ * @epic T134
21
+ */
22
+ export declare class GeminiCliInstallProvider implements AdapterInstallProvider {
23
+ /**
24
+ * Install CLEO into a Gemini CLI environment.
25
+ *
26
+ * @param options - Installation options including project directory and MCP server path
27
+ * @returns Result describing what was installed
28
+ * @task T161
29
+ */
30
+ install(options: InstallOptions): Promise<InstallResult>;
31
+ /**
32
+ * Uninstall CLEO from the Gemini CLI environment.
33
+ *
34
+ * Removes the MCP server registration from ~/.gemini/settings.json.
35
+ * Does not remove AGENTS.md references (they are harmless if CLEO is not present).
36
+ * @task T161
37
+ */
38
+ uninstall(): Promise<void>;
39
+ /**
40
+ * Check whether CLEO is installed in the Gemini CLI environment.
41
+ *
42
+ * Checks for MCP server registered in ~/.gemini/settings.json.
43
+ * Returns true if the CLEO MCP server entry is found.
44
+ * @task T161
45
+ */
46
+ isInstalled(): Promise<boolean>;
47
+ /**
48
+ * Ensure AGENTS.md contains @-references to CLEO instruction files.
49
+ *
50
+ * Creates AGENTS.md if it does not exist. Appends any missing references.
51
+ *
52
+ * @param projectDir - Project root directory
53
+ * @task T161
54
+ */
55
+ ensureInstructionReferences(projectDir: string): Promise<void>;
56
+ /**
57
+ * Register the CLEO MCP server in ~/.gemini/settings.json.
58
+ *
59
+ * Gemini CLI stores its MCP server configuration in ~/.gemini/settings.json
60
+ * under the mcpServers key.
61
+ *
62
+ * @param mcpServerPath - Absolute path to the MCP server entry point
63
+ * @returns true if registration was performed or updated
64
+ */
65
+ private registerMcpServer;
66
+ /**
67
+ * Update AGENTS.md with CLEO @-references.
68
+ *
69
+ * @param projectDir - Project root directory
70
+ * @returns true if the file was created or modified
71
+ */
72
+ private updateInstructionFile;
73
+ }
74
+ //# sourceMappingURL=install.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/gemini-cli/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAQjG;;;;;;;;;GASG;AACH,qBAAa,wBAAyB,YAAW,sBAAsB;IACrE;;;;;;OAMG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IA8B9D;;;;;;OAMG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBhC;;;;;;OAMG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAiBrC;;;;;;;OAOG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;;;;;;;OAQG;IACH,OAAO,CAAC,iBAAiB;IA6BzB;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;CA4B9B"}