opencastle 0.27.0 → 0.27.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 (242) hide show
  1. package/bin/cli.mjs +6 -0
  2. package/dist/cli/agents.d.ts +3 -0
  3. package/dist/cli/agents.d.ts.map +1 -0
  4. package/dist/cli/agents.js +161 -0
  5. package/dist/cli/agents.js.map +1 -0
  6. package/dist/cli/baselines.d.ts +3 -0
  7. package/dist/cli/baselines.d.ts.map +1 -0
  8. package/dist/cli/baselines.js +128 -0
  9. package/dist/cli/baselines.js.map +1 -0
  10. package/dist/cli/convoy/dashboard-types.d.ts +146 -0
  11. package/dist/cli/convoy/dashboard-types.d.ts.map +1 -0
  12. package/dist/cli/convoy/dashboard-types.js +2 -0
  13. package/dist/cli/convoy/dashboard-types.js.map +1 -0
  14. package/dist/cli/convoy/engine.d.ts +67 -2
  15. package/dist/cli/convoy/engine.d.ts.map +1 -1
  16. package/dist/cli/convoy/engine.js +2036 -28
  17. package/dist/cli/convoy/engine.js.map +1 -1
  18. package/dist/cli/convoy/engine.test.js +1659 -70
  19. package/dist/cli/convoy/engine.test.js.map +1 -1
  20. package/dist/cli/convoy/event-schemas.d.ts +9 -0
  21. package/dist/cli/convoy/event-schemas.d.ts.map +1 -0
  22. package/dist/cli/convoy/event-schemas.js +185 -0
  23. package/dist/cli/convoy/event-schemas.js.map +1 -0
  24. package/dist/cli/convoy/events.d.ts +12 -1
  25. package/dist/cli/convoy/events.d.ts.map +1 -1
  26. package/dist/cli/convoy/events.js +186 -13
  27. package/dist/cli/convoy/events.js.map +1 -1
  28. package/dist/cli/convoy/events.test.js +325 -28
  29. package/dist/cli/convoy/events.test.js.map +1 -1
  30. package/dist/cli/convoy/expertise.d.ts +16 -0
  31. package/dist/cli/convoy/expertise.d.ts.map +1 -0
  32. package/dist/cli/convoy/expertise.js +121 -0
  33. package/dist/cli/convoy/expertise.js.map +1 -0
  34. package/dist/cli/convoy/expertise.test.d.ts +2 -0
  35. package/dist/cli/convoy/expertise.test.d.ts.map +1 -0
  36. package/dist/cli/convoy/expertise.test.js +96 -0
  37. package/dist/cli/convoy/expertise.test.js.map +1 -0
  38. package/dist/cli/convoy/export.test.js +1 -0
  39. package/dist/cli/convoy/export.test.js.map +1 -1
  40. package/dist/cli/convoy/formula.d.ts +19 -0
  41. package/dist/cli/convoy/formula.d.ts.map +1 -0
  42. package/dist/cli/convoy/formula.js +142 -0
  43. package/dist/cli/convoy/formula.js.map +1 -0
  44. package/dist/cli/convoy/formula.test.d.ts +2 -0
  45. package/dist/cli/convoy/formula.test.d.ts.map +1 -0
  46. package/dist/cli/convoy/formula.test.js +342 -0
  47. package/dist/cli/convoy/formula.test.js.map +1 -0
  48. package/dist/cli/convoy/gates.d.ts +128 -0
  49. package/dist/cli/convoy/gates.d.ts.map +1 -0
  50. package/dist/cli/convoy/gates.js +606 -0
  51. package/dist/cli/convoy/gates.js.map +1 -0
  52. package/dist/cli/convoy/gates.test.d.ts +2 -0
  53. package/dist/cli/convoy/gates.test.d.ts.map +1 -0
  54. package/dist/cli/convoy/gates.test.js +976 -0
  55. package/dist/cli/convoy/gates.test.js.map +1 -0
  56. package/dist/cli/convoy/health.d.ts +11 -0
  57. package/dist/cli/convoy/health.d.ts.map +1 -1
  58. package/dist/cli/convoy/health.js +54 -0
  59. package/dist/cli/convoy/health.js.map +1 -1
  60. package/dist/cli/convoy/health.test.js +56 -1
  61. package/dist/cli/convoy/health.test.js.map +1 -1
  62. package/dist/cli/convoy/issues.d.ts +8 -0
  63. package/dist/cli/convoy/issues.d.ts.map +1 -0
  64. package/dist/cli/convoy/issues.js +98 -0
  65. package/dist/cli/convoy/issues.js.map +1 -0
  66. package/dist/cli/convoy/issues.test.d.ts +2 -0
  67. package/dist/cli/convoy/issues.test.d.ts.map +1 -0
  68. package/dist/cli/convoy/issues.test.js +107 -0
  69. package/dist/cli/convoy/issues.test.js.map +1 -0
  70. package/dist/cli/convoy/knowledge.d.ts +5 -0
  71. package/dist/cli/convoy/knowledge.d.ts.map +1 -0
  72. package/dist/cli/convoy/knowledge.js +116 -0
  73. package/dist/cli/convoy/knowledge.js.map +1 -0
  74. package/dist/cli/convoy/knowledge.test.d.ts +2 -0
  75. package/dist/cli/convoy/knowledge.test.d.ts.map +1 -0
  76. package/dist/cli/convoy/knowledge.test.js +87 -0
  77. package/dist/cli/convoy/knowledge.test.js.map +1 -0
  78. package/dist/cli/convoy/lessons.d.ts +17 -0
  79. package/dist/cli/convoy/lessons.d.ts.map +1 -0
  80. package/dist/cli/convoy/lessons.js +149 -0
  81. package/dist/cli/convoy/lessons.js.map +1 -0
  82. package/dist/cli/convoy/lessons.test.d.ts +2 -0
  83. package/dist/cli/convoy/lessons.test.d.ts.map +1 -0
  84. package/dist/cli/convoy/lessons.test.js +135 -0
  85. package/dist/cli/convoy/lessons.test.js.map +1 -0
  86. package/dist/cli/convoy/lock.d.ts +13 -0
  87. package/dist/cli/convoy/lock.d.ts.map +1 -0
  88. package/dist/cli/convoy/lock.js +88 -0
  89. package/dist/cli/convoy/lock.js.map +1 -0
  90. package/dist/cli/convoy/lock.test.d.ts +2 -0
  91. package/dist/cli/convoy/lock.test.d.ts.map +1 -0
  92. package/dist/cli/convoy/lock.test.js +136 -0
  93. package/dist/cli/convoy/lock.test.js.map +1 -0
  94. package/dist/cli/convoy/log-merge.test.d.ts +2 -0
  95. package/dist/cli/convoy/log-merge.test.d.ts.map +1 -0
  96. package/dist/cli/convoy/log-merge.test.js +147 -0
  97. package/dist/cli/convoy/log-merge.test.js.map +1 -0
  98. package/dist/cli/convoy/merge.d.ts +4 -0
  99. package/dist/cli/convoy/merge.d.ts.map +1 -1
  100. package/dist/cli/convoy/merge.js +18 -1
  101. package/dist/cli/convoy/merge.js.map +1 -1
  102. package/dist/cli/convoy/merge.test.js +6 -7
  103. package/dist/cli/convoy/merge.test.js.map +1 -1
  104. package/dist/cli/convoy/partition.d.ts +51 -0
  105. package/dist/cli/convoy/partition.d.ts.map +1 -0
  106. package/dist/cli/convoy/partition.js +186 -0
  107. package/dist/cli/convoy/partition.js.map +1 -0
  108. package/dist/cli/convoy/partition.test.d.ts +2 -0
  109. package/dist/cli/convoy/partition.test.d.ts.map +1 -0
  110. package/dist/cli/convoy/partition.test.js +315 -0
  111. package/dist/cli/convoy/partition.test.js.map +1 -0
  112. package/dist/cli/convoy/pipeline.test.js +6 -0
  113. package/dist/cli/convoy/pipeline.test.js.map +1 -1
  114. package/dist/cli/convoy/store.d.ts +99 -7
  115. package/dist/cli/convoy/store.d.ts.map +1 -1
  116. package/dist/cli/convoy/store.js +764 -31
  117. package/dist/cli/convoy/store.js.map +1 -1
  118. package/dist/cli/convoy/store.test.js +1810 -18
  119. package/dist/cli/convoy/store.test.js.map +1 -1
  120. package/dist/cli/convoy/types.d.ts +427 -5
  121. package/dist/cli/convoy/types.d.ts.map +1 -1
  122. package/dist/cli/convoy/types.js +42 -1
  123. package/dist/cli/convoy/types.js.map +1 -1
  124. package/dist/cli/log.d.ts +11 -0
  125. package/dist/cli/log.d.ts.map +1 -1
  126. package/dist/cli/log.js +114 -2
  127. package/dist/cli/log.js.map +1 -1
  128. package/dist/cli/run/adapters/claude.d.ts +2 -0
  129. package/dist/cli/run/adapters/claude.d.ts.map +1 -1
  130. package/dist/cli/run/adapters/claude.js +89 -49
  131. package/dist/cli/run/adapters/claude.js.map +1 -1
  132. package/dist/cli/run/adapters/claude.test.d.ts +2 -0
  133. package/dist/cli/run/adapters/claude.test.d.ts.map +1 -0
  134. package/dist/cli/run/adapters/claude.test.js +205 -0
  135. package/dist/cli/run/adapters/claude.test.js.map +1 -0
  136. package/dist/cli/run/adapters/copilot.d.ts +1 -0
  137. package/dist/cli/run/adapters/copilot.d.ts.map +1 -1
  138. package/dist/cli/run/adapters/copilot.js +84 -46
  139. package/dist/cli/run/adapters/copilot.js.map +1 -1
  140. package/dist/cli/run/adapters/copilot.test.d.ts +2 -0
  141. package/dist/cli/run/adapters/copilot.test.d.ts.map +1 -0
  142. package/dist/cli/run/adapters/copilot.test.js +195 -0
  143. package/dist/cli/run/adapters/copilot.test.js.map +1 -0
  144. package/dist/cli/run/adapters/cursor.d.ts +1 -0
  145. package/dist/cli/run/adapters/cursor.d.ts.map +1 -1
  146. package/dist/cli/run/adapters/cursor.js +83 -47
  147. package/dist/cli/run/adapters/cursor.js.map +1 -1
  148. package/dist/cli/run/adapters/cursor.test.d.ts +2 -0
  149. package/dist/cli/run/adapters/cursor.test.d.ts.map +1 -0
  150. package/dist/cli/run/adapters/cursor.test.js +129 -0
  151. package/dist/cli/run/adapters/cursor.test.js.map +1 -0
  152. package/dist/cli/run/adapters/opencode.d.ts +1 -0
  153. package/dist/cli/run/adapters/opencode.d.ts.map +1 -1
  154. package/dist/cli/run/adapters/opencode.js +81 -47
  155. package/dist/cli/run/adapters/opencode.js.map +1 -1
  156. package/dist/cli/run/adapters/opencode.test.d.ts +2 -0
  157. package/dist/cli/run/adapters/opencode.test.d.ts.map +1 -0
  158. package/dist/cli/run/adapters/opencode.test.js +119 -0
  159. package/dist/cli/run/adapters/opencode.test.js.map +1 -0
  160. package/dist/cli/run/executor.js +1 -1
  161. package/dist/cli/run/executor.js.map +1 -1
  162. package/dist/cli/run/schema.d.ts.map +1 -1
  163. package/dist/cli/run/schema.js +245 -4
  164. package/dist/cli/run/schema.js.map +1 -1
  165. package/dist/cli/run/schema.test.js +669 -0
  166. package/dist/cli/run/schema.test.js.map +1 -1
  167. package/dist/cli/run.d.ts.map +1 -1
  168. package/dist/cli/run.js +362 -22
  169. package/dist/cli/run.js.map +1 -1
  170. package/dist/cli/types.d.ts +85 -2
  171. package/dist/cli/types.d.ts.map +1 -1
  172. package/dist/cli/types.js.map +1 -1
  173. package/dist/cli/watch.d.ts +15 -0
  174. package/dist/cli/watch.d.ts.map +1 -0
  175. package/dist/cli/watch.js +279 -0
  176. package/dist/cli/watch.js.map +1 -0
  177. package/package.json +5 -1
  178. package/src/cli/agents.ts +177 -0
  179. package/src/cli/baselines.ts +143 -0
  180. package/src/cli/convoy/TELEMETRY.md +203 -0
  181. package/src/cli/convoy/dashboard-types.ts +141 -0
  182. package/src/cli/convoy/engine.test.ts +1937 -70
  183. package/src/cli/convoy/engine.ts +2350 -40
  184. package/src/cli/convoy/event-schemas.ts +195 -0
  185. package/src/cli/convoy/events.test.ts +384 -39
  186. package/src/cli/convoy/events.ts +202 -16
  187. package/src/cli/convoy/expertise.test.ts +128 -0
  188. package/src/cli/convoy/expertise.ts +163 -0
  189. package/src/cli/convoy/export.test.ts +1 -0
  190. package/src/cli/convoy/formula.test.ts +405 -0
  191. package/src/cli/convoy/formula.ts +174 -0
  192. package/src/cli/convoy/gates.test.ts +1169 -0
  193. package/src/cli/convoy/gates.ts +774 -0
  194. package/src/cli/convoy/health.test.ts +64 -2
  195. package/src/cli/convoy/health.ts +80 -2
  196. package/src/cli/convoy/issues.test.ts +143 -0
  197. package/src/cli/convoy/issues.ts +136 -0
  198. package/src/cli/convoy/knowledge.test.ts +101 -0
  199. package/src/cli/convoy/knowledge.ts +132 -0
  200. package/src/cli/convoy/lessons.test.ts +188 -0
  201. package/src/cli/convoy/lessons.ts +164 -0
  202. package/src/cli/convoy/lock.test.ts +181 -0
  203. package/src/cli/convoy/lock.ts +103 -0
  204. package/src/cli/convoy/log-merge.test.ts +179 -0
  205. package/src/cli/convoy/merge.test.ts +6 -7
  206. package/src/cli/convoy/merge.ts +19 -1
  207. package/src/cli/convoy/partition.test.ts +423 -0
  208. package/src/cli/convoy/partition.ts +232 -0
  209. package/src/cli/convoy/pipeline.test.ts +6 -0
  210. package/src/cli/convoy/store.test.ts +2041 -20
  211. package/src/cli/convoy/store.ts +945 -46
  212. package/src/cli/convoy/types.ts +278 -4
  213. package/src/cli/log.ts +120 -2
  214. package/src/cli/run/adapters/claude.test.ts +234 -0
  215. package/src/cli/run/adapters/claude.ts +45 -5
  216. package/src/cli/run/adapters/copilot.test.ts +224 -0
  217. package/src/cli/run/adapters/copilot.ts +34 -4
  218. package/src/cli/run/adapters/cursor.test.ts +144 -0
  219. package/src/cli/run/adapters/cursor.ts +33 -2
  220. package/src/cli/run/adapters/opencode.test.ts +135 -0
  221. package/src/cli/run/adapters/opencode.ts +30 -2
  222. package/src/cli/run/executor.ts +1 -1
  223. package/src/cli/run/schema.test.ts +758 -0
  224. package/src/cli/run/schema.ts +300 -25
  225. package/src/cli/run.ts +341 -21
  226. package/src/cli/types.ts +86 -1
  227. package/src/cli/watch.ts +298 -0
  228. package/src/dashboard/dist/_astro/{index.DtnyD8a5.css → index.6L3_HsPT.css} +1 -1
  229. package/src/dashboard/dist/data/.gitkeep +0 -0
  230. package/src/dashboard/dist/data/convoy-list.json +1 -0
  231. package/src/dashboard/dist/data/overall-stats.json +24 -0
  232. package/src/dashboard/dist/index.html +701 -3
  233. package/src/dashboard/node_modules/.vite/deps/_metadata.json +6 -6
  234. package/src/dashboard/public/data/.gitkeep +0 -0
  235. package/src/dashboard/public/data/convoy-list.json +1 -0
  236. package/src/dashboard/public/data/overall-stats.json +24 -0
  237. package/src/dashboard/scripts/etl.test.ts +210 -0
  238. package/src/dashboard/scripts/etl.ts +108 -0
  239. package/src/dashboard/scripts/integration-test.ts +504 -0
  240. package/src/dashboard/src/pages/index.astro +854 -15
  241. package/src/dashboard/src/styles/dashboard.css +557 -1
  242. package/src/orchestrator/prompts/generate-convoy.prompt.md +212 -13
@@ -0,0 +1,234 @@
1
+ import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest'
2
+ import { mkdtempSync, rmSync, existsSync, readFileSync, realpathSync } from 'node:fs'
3
+ import { tmpdir } from 'node:os'
4
+ import { join } from 'node:path'
5
+ import { EventEmitter } from 'node:events'
6
+ import type { Task } from '../../types.js'
7
+
8
+ // ── Helpers ───────────────────────────────────────────────────────────────────
9
+
10
+ function makeTask(): Task {
11
+ return {
12
+ id: 'test-task',
13
+ agent: 'developer',
14
+ prompt: 'Do something',
15
+ files: [],
16
+ timeout: '5m',
17
+ depends_on: [],
18
+ description: 'test task',
19
+ max_retries: 0,
20
+ } as unknown as Task
21
+ }
22
+
23
+ function makeMockProc(exitCode = 0, stdoutData = '{"result":"ok"}') {
24
+ const proc = new EventEmitter() as EventEmitter & {
25
+ stdout: EventEmitter
26
+ stderr: EventEmitter
27
+ killed: boolean
28
+ kill: ReturnType<typeof vi.fn>
29
+ }
30
+ proc.stdout = new EventEmitter()
31
+ proc.stderr = new EventEmitter()
32
+ proc.killed = false
33
+ proc.kill = vi.fn()
34
+ process.nextTick(() => {
35
+ if (stdoutData) proc.stdout.emit('data', Buffer.from(stdoutData))
36
+ proc.emit('close', exitCode)
37
+ })
38
+ return proc
39
+ }
40
+
41
+ // ── SDK mode ──────────────────────────────────────────────────────────────────
42
+
43
+ describe('claude adapter — SDK mode', () => {
44
+ let mockCreateSession: ReturnType<typeof vi.fn>
45
+ let mockSession: {
46
+ sendAndWait: ReturnType<typeof vi.fn>
47
+ on: ReturnType<typeof vi.fn>
48
+ destroy: ReturnType<typeof vi.fn>
49
+ abort: ReturnType<typeof vi.fn>
50
+ }
51
+
52
+ beforeEach(() => {
53
+ vi.resetModules()
54
+ mockSession = {
55
+ sendAndWait: vi.fn().mockResolvedValue({ data: { content: 'I did the task' } }),
56
+ on: vi.fn(),
57
+ destroy: vi.fn().mockResolvedValue(undefined),
58
+ abort: vi.fn().mockResolvedValue(undefined),
59
+ }
60
+ mockCreateSession = vi.fn().mockResolvedValue(mockSession)
61
+ vi.doMock('@anthropic-ai/agent-sdk', () => {
62
+ // Must use a regular function (not arrow) so `new AgentClient()` works
63
+ function MockAgentClient(this: Record<string, unknown>) {
64
+ this.start = vi.fn().mockResolvedValue(undefined)
65
+ this.createSession = mockCreateSession
66
+ }
67
+ return {
68
+ AgentClient: MockAgentClient,
69
+ approveAll: vi.fn(),
70
+ }
71
+ })
72
+ })
73
+
74
+ afterEach(() => {
75
+ vi.restoreAllMocks()
76
+ })
77
+
78
+ it('passes mcpServers to createSession when provided', async () => {
79
+ const { execute } = await import('./claude.js')
80
+ const mcpServers = [{ name: 'my-mcp', type: 'local', command: 'node', args: ['server.js'] }]
81
+ await execute(makeTask(), { mcpServers })
82
+ expect(mockCreateSession).toHaveBeenCalledWith(
83
+ expect.objectContaining({ mcpServers }),
84
+ )
85
+ })
86
+
87
+ it('does NOT include mcpServers in createSession when not provided', async () => {
88
+ const { execute } = await import('./claude.js')
89
+ await execute(makeTask(), {})
90
+ const callArg = mockCreateSession.mock.calls[0]?.[0] as Record<string, unknown>
91
+ expect(callArg).not.toHaveProperty('mcpServers')
92
+ })
93
+
94
+ it('does NOT include mcpServers when mcpServers is empty array', async () => {
95
+ const { execute } = await import('./claude.js')
96
+ await execute(makeTask(), { mcpServers: [] })
97
+ const callArg = mockCreateSession.mock.calls[0]?.[0] as Record<string, unknown>
98
+ expect(callArg).not.toHaveProperty('mcpServers')
99
+ })
100
+ })
101
+
102
+ // ── CLI mode ──────────────────────────────────────────────────────────────────
103
+
104
+ describe('claude adapter — CLI mode', () => {
105
+ let tmpDir: string
106
+ let mockSpawn: ReturnType<typeof vi.fn>
107
+
108
+ beforeEach(() => {
109
+ vi.resetModules()
110
+ tmpDir = realpathSync(mkdtempSync(join(tmpdir(), 'claude-test-')))
111
+
112
+ mockSpawn = vi.fn().mockImplementation((cmd: string) => {
113
+ if (cmd === 'which') return makeMockProc(0, '')
114
+ return makeMockProc(0, '{"result":"ok"}')
115
+ })
116
+ vi.doMock('node:child_process', () => ({ spawn: mockSpawn }))
117
+ })
118
+
119
+ afterEach(() => {
120
+ rmSync(tmpDir, { recursive: true, force: true })
121
+ vi.restoreAllMocks()
122
+ })
123
+
124
+ it('writes mcp.json to cwd with correct format when mcpServers provided', async () => {
125
+ let capturedContent: string | null = null
126
+ mockSpawn.mockImplementation((cmd: string) => {
127
+ if (cmd === 'which') return makeMockProc(0, '')
128
+ const mcpPath = join(tmpDir, 'mcp.json')
129
+ if (existsSync(mcpPath)) {
130
+ capturedContent = readFileSync(mcpPath, 'utf8')
131
+ }
132
+ return makeMockProc(0, '{}')
133
+ })
134
+
135
+ const { executeViaCli } = await import('./claude.js')
136
+ const mcpServers = [{ name: 'my-mcp', type: 'local', command: 'node', args: ['server.js'] }]
137
+ await executeViaCli(makeTask(), { mcpServers, cwd: tmpDir })
138
+
139
+ expect(capturedContent).not.toBeNull()
140
+ expect(JSON.parse(capturedContent!)).toEqual({
141
+ mcpServers: { 'my-mcp': { command: 'node', args: ['server.js'] } },
142
+ })
143
+ })
144
+
145
+ it('passes --mcp-config flag pointing to mcp.json path', async () => {
146
+ const capturedArgs: string[] = []
147
+ mockSpawn.mockImplementation((cmd: string, args: string[]) => {
148
+ if (cmd === 'which') return makeMockProc(0, '')
149
+ capturedArgs.push(...args)
150
+ return makeMockProc(0, '{}')
151
+ })
152
+ const { executeViaCli } = await import('./claude.js')
153
+ const mcpServers = [{ name: 'my-mcp', type: 'local', command: 'node', args: ['server.js'] }]
154
+ await executeViaCli(makeTask(), { mcpServers, cwd: tmpDir })
155
+
156
+ const idx = capturedArgs.indexOf('--mcp-config')
157
+ expect(idx).toBeGreaterThanOrEqual(0)
158
+ expect(capturedArgs[idx + 1]).toBe(join(tmpDir, 'mcp.json'))
159
+ })
160
+
161
+ it('cleans up mcp.json after successful execution', async () => {
162
+ const { executeViaCli } = await import('./claude.js')
163
+ const mcpServers = [{ name: 'my-mcp', type: 'local', command: 'node', args: ['server.js'] }]
164
+ await executeViaCli(makeTask(), { mcpServers, cwd: tmpDir })
165
+ expect(existsSync(join(tmpDir, 'mcp.json'))).toBe(false)
166
+ })
167
+
168
+ it('cleans up mcp.json after failed execution (non-zero exit)', async () => {
169
+ mockSpawn.mockImplementation((cmd: string) => {
170
+ if (cmd === 'which') return makeMockProc(0, '')
171
+ return makeMockProc(1, '')
172
+ })
173
+ const { executeViaCli } = await import('./claude.js')
174
+ const mcpServers = [{ name: 'err-mcp', type: 'local', command: 'node', args: [] }]
175
+ await executeViaCli(makeTask(), { mcpServers, cwd: tmpDir })
176
+ expect(existsSync(join(tmpDir, 'mcp.json'))).toBe(false)
177
+ })
178
+
179
+ it('includes --approve-mcps flag when mcp_approve_all is true', async () => {
180
+ const capturedArgs: string[] = []
181
+ mockSpawn.mockImplementation((cmd: string, args: string[]) => {
182
+ if (cmd === 'which') return makeMockProc(0, '')
183
+ capturedArgs.push(...args)
184
+ return makeMockProc(0, '{}')
185
+ })
186
+ const { executeViaCli } = await import('./claude.js')
187
+ await executeViaCli(makeTask(), { mcp_approve_all: true, cwd: tmpDir })
188
+ expect(capturedArgs).toContain('--approve-mcps')
189
+ })
190
+
191
+ it('does NOT write mcp.json when mcpServers not configured', async () => {
192
+ const { executeViaCli } = await import('./claude.js')
193
+ await executeViaCli(makeTask(), { cwd: tmpDir })
194
+ expect(existsSync(join(tmpDir, 'mcp.json'))).toBe(false)
195
+ })
196
+
197
+ it('does NOT add --approve-mcps when mcp_approve_all is not set', async () => {
198
+ const capturedArgs: string[] = []
199
+ mockSpawn.mockImplementation((cmd: string, args: string[]) => {
200
+ if (cmd === 'which') return makeMockProc(0, '')
201
+ capturedArgs.push(...args)
202
+ return makeMockProc(0, '{}')
203
+ })
204
+ const { executeViaCli } = await import('./claude.js')
205
+ await executeViaCli(makeTask(), { cwd: tmpDir })
206
+ expect(capturedArgs).not.toContain('--approve-mcps')
207
+ })
208
+
209
+ it('maps mcpServers with url and config into mcp.json', async () => {
210
+ let capturedContent: string | null = null
211
+ mockSpawn.mockImplementation((cmd: string) => {
212
+ if (cmd === 'which') return makeMockProc(0, '')
213
+ const mcpPath = join(tmpDir, 'mcp.json')
214
+ if (existsSync(mcpPath)) capturedContent = readFileSync(mcpPath, 'utf8')
215
+ return makeMockProc(0, '{}')
216
+ })
217
+ const { executeViaCli } = await import('./claude.js')
218
+ const mcpServers = [
219
+ {
220
+ name: 'remote-mcp',
221
+ type: 'remote',
222
+ url: 'http://localhost:9000',
223
+ config: { token: 'abc' },
224
+ },
225
+ ]
226
+ await executeViaCli(makeTask(), { mcpServers, cwd: tmpDir })
227
+ expect(capturedContent).not.toBeNull()
228
+ const parsed = JSON.parse(capturedContent!) as { mcpServers: Record<string, Record<string, unknown>> }
229
+ expect(parsed.mcpServers['remote-mcp']).toMatchObject({
230
+ url: 'http://localhost:9000',
231
+ token: 'abc',
232
+ })
233
+ })
234
+ })
@@ -1,10 +1,13 @@
1
1
  import { spawn } from 'node:child_process'
2
+ import { writeFileSync, unlinkSync } from 'node:fs'
3
+ import { join } from 'node:path'
2
4
  import { parseTimeout } from '../schema.js'
3
5
  import type { Task, ExecuteOptions, ExecuteResult, TokenUsage } from '../../types.js'
4
6
 
5
7
  // Adapter name
6
8
  export const name = 'claude'
7
9
 
10
+ export function supportsSessionContinuity(): boolean { return false }
8
11
  // Module-level state for mode selection
9
12
  let mode: 'sdk' | 'cli' | null = null
10
13
 
@@ -100,6 +103,8 @@ async function executeViaSdk(task: Task, options: ExecuteOptions = {}): Promise<
100
103
  },
101
104
  infiniteSessions: { enabled: false },
102
105
  ...(options.verbose ? { streaming: true } : {}),
106
+ // mcpServers is forward-compatible: field will be recognised by future SDK versions
107
+ ...(options.mcpServers?.length ? { mcpServers: options.mcpServers } : {}),
103
108
  })
104
109
  activeSessions.set(task.id, session)
105
110
  if (options.verbose) {
@@ -108,12 +113,21 @@ async function executeViaSdk(task: Task, options: ExecuteOptions = {}): Promise<
108
113
  process.stdout.write(event.data.deltaContent)
109
114
  })
110
115
  }
116
+ interface SdkResponse {
117
+ data?: {
118
+ content?: string
119
+ usage?: Record<string, number>
120
+ }
121
+ usage?: Record<string, number>
122
+ }
123
+
111
124
  try {
112
125
  const timeoutMs = parseTimeout(task.timeout)
113
126
  const response = await session.sendAndWait({ prompt }, timeoutMs)
114
- const data = (response as any)?.data as Record<string, unknown> | undefined
127
+ const typed = response as SdkResponse
128
+ const data = typed?.data
115
129
  const output = (data?.content as string | undefined) ?? ''
116
- const rawUsage = data?.usage ?? (response as any)?.usage
130
+ const rawUsage = data?.usage ?? typed?.usage
117
131
  const u = rawUsage as Record<string, number> | undefined
118
132
  const usageResult = u
119
133
  ? {
@@ -150,7 +164,7 @@ function killSdk(task: Task): void {
150
164
  }
151
165
 
152
166
  // --- CLI implementation (from claude-code.ts) ---
153
- async function executeViaCli(task: Task, options: ExecuteOptions = {}): Promise<ExecuteResult> {
167
+ export async function executeViaCli(task: Task, options: ExecuteOptions = {}): Promise<ExecuteResult> {
154
168
  let prompt = `You are a ${task.agent}. ${task.prompt}`
155
169
  if (task.files && task.files.length > 0) {
156
170
  prompt += `\n\nOnly modify files under: ${task.files.join(', ')}`
@@ -163,11 +177,32 @@ async function executeViaCli(task: Task, options: ExecuteOptions = {}): Promise<
163
177
  '--max-turns',
164
178
  '50',
165
179
  ]
166
- return new Promise((resolve) => {
180
+ const cwd = options?.cwd ?? process.cwd()
181
+ const mcpJsonPath = join(cwd, 'mcp.json')
182
+ let wroteJson = false
183
+ if (options.mcpServers?.length) {
184
+ const mcpJson: Record<string, Record<string, unknown>> = {}
185
+ for (const server of options.mcpServers) {
186
+ const entry: Record<string, unknown> = {}
187
+ if (server.command) entry.command = server.command
188
+ if (server.args) entry.args = server.args
189
+ if (server.url) entry.url = server.url
190
+ if (server.config) Object.assign(entry, server.config)
191
+ mcpJson[server.name] = entry
192
+ }
193
+ writeFileSync(mcpJsonPath, JSON.stringify({ mcpServers: mcpJson }, null, 2), 'utf8')
194
+ args.push('--mcp-config', mcpJsonPath)
195
+ wroteJson = true
196
+ }
197
+ if (options.mcp_approve_all) {
198
+ args.push('--approve-mcps')
199
+ }
200
+ try {
201
+ return await new Promise<ExecuteResult>((resolve) => {
167
202
  const proc = spawn('claude', args, {
168
203
  stdio: ['ignore', 'pipe', 'pipe'],
169
204
  env: { ...process.env },
170
- cwd: options?.cwd ?? process.cwd(),
205
+ cwd,
171
206
  })
172
207
  let stdout = ''
173
208
  let stderr = ''
@@ -212,6 +247,11 @@ async function executeViaCli(task: Task, options: ExecuteOptions = {}): Promise<
212
247
  })
213
248
  task._process = proc
214
249
  })
250
+ } finally {
251
+ if (wroteJson) {
252
+ try { unlinkSync(mcpJsonPath) } catch { /* ignore */ }
253
+ }
254
+ }
215
255
  }
216
256
 
217
257
  function killCli(task: Task): void {
@@ -0,0 +1,224 @@
1
+ import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest'
2
+ import { mkdtempSync, rmSync, existsSync, readFileSync, realpathSync } from 'node:fs'
3
+ import { tmpdir } from 'node:os'
4
+ import { join } from 'node:path'
5
+ import { EventEmitter } from 'node:events'
6
+ import type { Task } from '../../types.js'
7
+
8
+ // ── Helpers ───────────────────────────────────────────────────────────────────
9
+
10
+ function makeTask(): Task {
11
+ return {
12
+ id: 'test-task',
13
+ agent: 'developer',
14
+ prompt: 'Do something',
15
+ files: [],
16
+ timeout: '5m',
17
+ depends_on: [],
18
+ description: 'test task',
19
+ max_retries: 0,
20
+ } as unknown as Task
21
+ }
22
+
23
+ function makeMockProc(exitCode = 0, stdoutData = '{"result":"ok"}') {
24
+ const proc = new EventEmitter() as EventEmitter & {
25
+ stdout: EventEmitter
26
+ stderr: EventEmitter
27
+ killed: boolean
28
+ kill: ReturnType<typeof vi.fn>
29
+ }
30
+ proc.stdout = new EventEmitter()
31
+ proc.stderr = new EventEmitter()
32
+ proc.killed = false
33
+ proc.kill = vi.fn()
34
+ process.nextTick(() => {
35
+ if (stdoutData) proc.stdout.emit('data', Buffer.from(stdoutData))
36
+ proc.emit('close', exitCode)
37
+ })
38
+ return proc
39
+ }
40
+
41
+ // ── SDK mode ──────────────────────────────────────────────────────────────────
42
+
43
+ describe('copilot adapter — SDK mode', () => {
44
+ let mockCreateSession: ReturnType<typeof vi.fn>
45
+ let mockSession: {
46
+ sendAndWait: ReturnType<typeof vi.fn>
47
+ on: ReturnType<typeof vi.fn>
48
+ destroy: ReturnType<typeof vi.fn>
49
+ abort: ReturnType<typeof vi.fn>
50
+ }
51
+
52
+ beforeEach(() => {
53
+ vi.resetModules()
54
+ mockSession = {
55
+ sendAndWait: vi.fn().mockResolvedValue({ data: { content: 'I did the task' } }),
56
+ on: vi.fn(),
57
+ destroy: vi.fn().mockResolvedValue(undefined),
58
+ abort: vi.fn().mockResolvedValue(undefined),
59
+ }
60
+ mockCreateSession = vi.fn().mockResolvedValue(mockSession)
61
+ vi.doMock('@github/copilot-sdk', () => {
62
+ // Must use a regular function (not arrow) so `new CopilotClient()` works
63
+ function MockCopilotClient(this: Record<string, unknown>) {
64
+ this.start = vi.fn().mockResolvedValue(undefined)
65
+ this.createSession = mockCreateSession
66
+ }
67
+ return {
68
+ CopilotClient: MockCopilotClient,
69
+ approveAll: vi.fn(),
70
+ }
71
+ })
72
+ })
73
+
74
+ afterEach(() => {
75
+ vi.restoreAllMocks()
76
+ })
77
+
78
+ it('passes mcpServers to createSession when provided', async () => {
79
+ const { execute } = await import('./copilot.js')
80
+ const mcpServers = [{ name: 'my-mcp', type: 'local', command: 'node', args: ['server.js'] }]
81
+ await execute(makeTask(), { mcpServers })
82
+ expect(mockCreateSession).toHaveBeenCalledWith(
83
+ expect.objectContaining({ mcpServers }),
84
+ )
85
+ })
86
+
87
+ it('does NOT include mcpServers in createSession when not provided', async () => {
88
+ const { execute } = await import('./copilot.js')
89
+ await execute(makeTask(), {})
90
+ const callArg = mockCreateSession.mock.calls[0]?.[0] as Record<string, unknown>
91
+ expect(callArg).not.toHaveProperty('mcpServers')
92
+ })
93
+
94
+ it('does NOT include mcpServers when mcpServers is empty array', async () => {
95
+ const { execute } = await import('./copilot.js')
96
+ await execute(makeTask(), { mcpServers: [] })
97
+ const callArg = mockCreateSession.mock.calls[0]?.[0] as Record<string, unknown>
98
+ expect(callArg).not.toHaveProperty('mcpServers')
99
+ })
100
+ })
101
+
102
+ // ── CLI mode ──────────────────────────────────────────────────────────────────
103
+
104
+ describe('copilot adapter — CLI mode', () => {
105
+ let tmpDir: string
106
+ let mockSpawn: ReturnType<typeof vi.fn>
107
+
108
+ beforeEach(() => {
109
+ vi.resetModules()
110
+ tmpDir = realpathSync(mkdtempSync(join(tmpdir(), 'copilot-test-')))
111
+
112
+ // Make SDK unavailable so the adapter falls through to CLI
113
+ vi.doMock('@github/copilot-sdk', () => {
114
+ throw new Error('Module not found: @github/copilot-sdk')
115
+ })
116
+
117
+ mockSpawn = vi.fn().mockImplementation((cmd: string) => {
118
+ if (cmd === 'which') return makeMockProc(0, '')
119
+ return makeMockProc(0, '{"result":"ok"}')
120
+ })
121
+ vi.doMock('node:child_process', () => ({ spawn: mockSpawn }))
122
+ })
123
+
124
+ afterEach(() => {
125
+ rmSync(tmpDir, { recursive: true, force: true })
126
+ vi.restoreAllMocks()
127
+ })
128
+
129
+ it('writes mcp.json to cwd with correct format when mcpServers provided', async () => {
130
+ let capturedContent: string | null = null
131
+ mockSpawn.mockImplementation((cmd: string) => {
132
+ if (cmd === 'which') return makeMockProc(0, '')
133
+ // mcp.json should exist at this point
134
+ const mcpPath = join(tmpDir, 'mcp.json')
135
+ if (existsSync(mcpPath)) {
136
+ capturedContent = readFileSync(mcpPath, 'utf8')
137
+ }
138
+ return makeMockProc(0, '{}')
139
+ })
140
+
141
+ const { execute } = await import('./copilot.js')
142
+ const mcpServers = [{ name: 'my-mcp', type: 'local', command: 'node', args: ['server.js'] }]
143
+ await execute(makeTask(), { mcpServers, cwd: tmpDir })
144
+
145
+ expect(capturedContent).not.toBeNull()
146
+ expect(JSON.parse(capturedContent!)).toEqual({
147
+ mcpServers: { 'my-mcp': { command: 'node', args: ['server.js'] } },
148
+ })
149
+ })
150
+
151
+ it('cleans up mcp.json after successful execution', async () => {
152
+ const { execute } = await import('./copilot.js')
153
+ const mcpServers = [{ name: 'my-mcp', type: 'local', command: 'node', args: ['server.js'] }]
154
+ await execute(makeTask(), { mcpServers, cwd: tmpDir })
155
+ expect(existsSync(join(tmpDir, 'mcp.json'))).toBe(false)
156
+ })
157
+
158
+ it('cleans up mcp.json after failed execution (non-zero exit)', async () => {
159
+ mockSpawn.mockImplementation((cmd: string) => {
160
+ if (cmd === 'which') return makeMockProc(0, '')
161
+ return makeMockProc(1, '') // non-zero exit
162
+ })
163
+ const { execute } = await import('./copilot.js')
164
+ const mcpServers = [{ name: 'err-mcp', type: 'local', command: 'node', args: [] }]
165
+ await execute(makeTask(), { mcpServers, cwd: tmpDir })
166
+ expect(existsSync(join(tmpDir, 'mcp.json'))).toBe(false)
167
+ })
168
+
169
+ it('includes --approve-mcps flag when mcp_approve_all is true', async () => {
170
+ const capturedArgs: string[] = []
171
+ mockSpawn.mockImplementation((cmd: string, args: string[]) => {
172
+ if (cmd === 'which') return makeMockProc(0, '')
173
+ capturedArgs.push(...args)
174
+ return makeMockProc(0, '{}')
175
+ })
176
+ const { execute } = await import('./copilot.js')
177
+ await execute(makeTask(), { mcp_approve_all: true, cwd: tmpDir })
178
+ expect(capturedArgs).toContain('--approve-mcps')
179
+ })
180
+
181
+ it('does NOT write mcp.json when mcpServers not configured', async () => {
182
+ const { execute } = await import('./copilot.js')
183
+ await execute(makeTask(), { cwd: tmpDir })
184
+ expect(existsSync(join(tmpDir, 'mcp.json'))).toBe(false)
185
+ })
186
+
187
+ it('does NOT add --approve-mcps when mcp_approve_all is not set', async () => {
188
+ const capturedArgs: string[] = []
189
+ mockSpawn.mockImplementation((cmd: string, args: string[]) => {
190
+ if (cmd === 'which') return makeMockProc(0, '')
191
+ capturedArgs.push(...args)
192
+ return makeMockProc(0, '{}')
193
+ })
194
+ const { execute } = await import('./copilot.js')
195
+ await execute(makeTask(), { cwd: tmpDir })
196
+ expect(capturedArgs).not.toContain('--approve-mcps')
197
+ })
198
+
199
+ it('maps mcpServers with url and config into mcp.json', async () => {
200
+ let capturedContent: string | null = null
201
+ mockSpawn.mockImplementation((cmd: string) => {
202
+ if (cmd === 'which') return makeMockProc(0, '')
203
+ const mcpPath = join(tmpDir, 'mcp.json')
204
+ if (existsSync(mcpPath)) capturedContent = readFileSync(mcpPath, 'utf8')
205
+ return makeMockProc(0, '{}')
206
+ })
207
+ const { execute } = await import('./copilot.js')
208
+ const mcpServers = [
209
+ {
210
+ name: 'remote-mcp',
211
+ type: 'remote',
212
+ url: 'http://localhost:9000',
213
+ config: { token: 'abc' },
214
+ },
215
+ ]
216
+ await execute(makeTask(), { mcpServers, cwd: tmpDir })
217
+ expect(capturedContent).not.toBeNull()
218
+ const parsed = JSON.parse(capturedContent!) as { mcpServers: Record<string, Record<string, unknown>> }
219
+ expect(parsed.mcpServers['remote-mcp']).toMatchObject({
220
+ url: 'http://localhost:9000',
221
+ token: 'abc',
222
+ })
223
+ })
224
+ })
@@ -1,12 +1,15 @@
1
1
 
2
2
  import { spawn } from 'node:child_process'
3
- import type { CopilotClient as CopilotClientType, CopilotSession, PermissionHandler } from '@github/copilot-sdk'
3
+ import { writeFileSync, unlinkSync } from 'node:fs'
4
+ import { join } from 'node:path'
5
+ import type { CopilotClient as CopilotClientType, CopilotSession, PermissionHandler, SessionConfig } from '@github/copilot-sdk'
4
6
  import { parseTimeout } from '../schema.js'
5
7
  import type { Task, ExecuteOptions, ExecuteResult, TokenUsage } from '../../types.js'
6
8
 
7
9
  // Adapter name
8
10
  export const name = 'copilot'
9
11
 
12
+ export function supportsSessionContinuity(): boolean { return true }
10
13
  // --- Unified adapter: SDK first, fallback to CLI ---
11
14
  let mode: 'sdk' | 'cli' | null = null
12
15
 
@@ -83,7 +86,9 @@ async function executeViaSdk(task: Task, options: ExecuteOptions = {}): Promise<
83
86
  },
84
87
  infiniteSessions: { enabled: false },
85
88
  ...(options.verbose ? { streaming: true } : {}),
86
- })
89
+ // mcpServers is forward-compatible: field will be recognised by future SDK versions
90
+ ...(options.mcpServers?.length ? { mcpServers: options.mcpServers } : {}),
91
+ } as SessionConfig)
87
92
  activeSessions.set(task.id, session)
88
93
  if (options.verbose) {
89
94
  session.on('assistant.message_delta', (event: { data: { deltaContent: string } }) => {
@@ -143,11 +148,31 @@ async function executeViaCli(task: Task, options: ExecuteOptions = {}): Promise<
143
148
  '--max-turns',
144
149
  '50',
145
150
  ]
146
- return new Promise((resolve) => {
151
+ const cwd = options?.cwd ?? process.cwd()
152
+ const mcpJsonPath = join(cwd, 'mcp.json')
153
+ let wroteJson = false
154
+ if (options.mcpServers?.length) {
155
+ const mcpJson: Record<string, Record<string, unknown>> = {}
156
+ for (const server of options.mcpServers) {
157
+ const entry: Record<string, unknown> = {}
158
+ if (server.command) entry.command = server.command
159
+ if (server.args) entry.args = server.args
160
+ if (server.url) entry.url = server.url
161
+ if (server.config) Object.assign(entry, server.config)
162
+ mcpJson[server.name] = entry
163
+ }
164
+ writeFileSync(mcpJsonPath, JSON.stringify({ mcpServers: mcpJson }, null, 2), 'utf8')
165
+ wroteJson = true
166
+ }
167
+ if (options.mcp_approve_all) {
168
+ args.push('--approve-mcps')
169
+ }
170
+ try {
171
+ return await new Promise<ExecuteResult>((resolve) => {
147
172
  const proc = spawn('copilot', args, {
148
173
  stdio: ['ignore', 'pipe', 'pipe'],
149
174
  env: { ...process.env },
150
- cwd: options?.cwd ?? process.cwd(),
175
+ cwd,
151
176
  })
152
177
  let stdout = ''
153
178
  let stderr = ''
@@ -192,6 +217,11 @@ async function executeViaCli(task: Task, options: ExecuteOptions = {}): Promise<
192
217
  })
193
218
  task._process = proc
194
219
  })
220
+ } finally {
221
+ if (wroteJson) {
222
+ try { unlinkSync(mcpJsonPath) } catch { /* ignore */ }
223
+ }
224
+ }
195
225
  }
196
226
 
197
227
  function killCli(task: Task): void {