genaicode 2.34.0 → 2.35.1

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 (134) hide show
  1. package/dist/agents/artifacts.d.ts +1 -1
  2. package/dist/agents/artifacts.js +4 -65
  3. package/dist/agents/artifacts.js.map +1 -1
  4. package/dist/agents/cli-agent.d.ts +3 -0
  5. package/dist/agents/cli-agent.js +1 -0
  6. package/dist/agents/cli-agent.js.map +1 -1
  7. package/dist/agents/drivers/anthropic-managed.d.ts +4 -0
  8. package/dist/agents/drivers/anthropic-managed.js +46 -0
  9. package/dist/agents/drivers/anthropic-managed.js.map +1 -1
  10. package/dist/agents/drivers/antigravity.js +2 -0
  11. package/dist/agents/drivers/antigravity.js.map +1 -1
  12. package/dist/agents/drivers/claude.js +2 -0
  13. package/dist/agents/drivers/claude.js.map +1 -1
  14. package/dist/agents/drivers/codex-live.js +2 -0
  15. package/dist/agents/drivers/codex-live.js.map +1 -1
  16. package/dist/agents/drivers/codex.js +2 -0
  17. package/dist/agents/drivers/codex.js.map +1 -1
  18. package/dist/agents/drivers/copilot.js +2 -0
  19. package/dist/agents/drivers/copilot.js.map +1 -1
  20. package/dist/agents/drivers/cursor-cloud.js +45 -0
  21. package/dist/agents/drivers/cursor-cloud.js.map +1 -1
  22. package/dist/agents/drivers/cursor.js +2 -0
  23. package/dist/agents/drivers/cursor.js.map +1 -1
  24. package/dist/agents/drivers/gemini-managed.js +2 -0
  25. package/dist/agents/drivers/gemini-managed.js.map +1 -1
  26. package/dist/agents/drivers/gemini.js +2 -0
  27. package/dist/agents/drivers/gemini.js.map +1 -1
  28. package/dist/agents/drivers/muse-live.js +2 -0
  29. package/dist/agents/drivers/muse-live.js.map +1 -1
  30. package/dist/agents/drivers/muse.js +2 -0
  31. package/dist/agents/drivers/muse.js.map +1 -1
  32. package/dist/agents/drivers/openai-managed.js +2 -0
  33. package/dist/agents/drivers/openai-managed.js.map +1 -1
  34. package/dist/agents/drivers/opencode.js +2 -0
  35. package/dist/agents/drivers/opencode.js.map +1 -1
  36. package/dist/agents/drivers/vibe.js +2 -0
  37. package/dist/agents/drivers/vibe.js.map +1 -1
  38. package/dist/agents/hosted.js +2 -0
  39. package/dist/agents/hosted.js.map +1 -1
  40. package/dist/agents/live-agent.d.ts +3 -0
  41. package/dist/agents/live-agent.js +1 -0
  42. package/dist/agents/live-agent.js.map +1 -1
  43. package/dist/agents/managed.d.ts +3 -0
  44. package/dist/agents/managed.js +1 -0
  45. package/dist/agents/managed.js.map +1 -1
  46. package/dist/agents/mcp-server.d.ts +19 -0
  47. package/dist/agents/mcp-server.js +74 -0
  48. package/dist/agents/mcp-server.js.map +1 -0
  49. package/dist/agents/pack-git.d.ts +23 -0
  50. package/dist/agents/pack-git.js +112 -0
  51. package/dist/agents/pack-git.js.map +1 -0
  52. package/dist/agents/pack.d.ts +68 -0
  53. package/dist/agents/pack.js +611 -0
  54. package/dist/agents/pack.js.map +1 -0
  55. package/dist/agents/session.d.ts +10 -0
  56. package/dist/agents/session.js +26 -0
  57. package/dist/agents/session.js.map +1 -1
  58. package/dist/agents/sessions/claude.d.ts +14 -0
  59. package/dist/agents/sessions/claude.js +233 -0
  60. package/dist/agents/sessions/claude.js.map +1 -0
  61. package/dist/agents/sessions/codex-api.d.ts +32 -0
  62. package/dist/agents/sessions/codex-api.js +233 -0
  63. package/dist/agents/sessions/codex-api.js.map +1 -0
  64. package/dist/agents/sessions/codex.d.ts +28 -0
  65. package/dist/agents/sessions/codex.js +430 -0
  66. package/dist/agents/sessions/codex.js.map +1 -0
  67. package/dist/agents/sessions/doctor.d.ts +67 -0
  68. package/dist/agents/sessions/doctor.js +182 -0
  69. package/dist/agents/sessions/doctor.js.map +1 -0
  70. package/dist/agents/sessions/files.d.ts +44 -0
  71. package/dist/agents/sessions/files.js +150 -0
  72. package/dist/agents/sessions/files.js.map +1 -0
  73. package/dist/agents/sessions/group.d.ts +24 -0
  74. package/dist/agents/sessions/group.js +27 -0
  75. package/dist/agents/sessions/group.js.map +1 -0
  76. package/dist/agents/sessions/hooks.d.ts +32 -0
  77. package/dist/agents/sessions/hooks.js +155 -0
  78. package/dist/agents/sessions/hooks.js.map +1 -0
  79. package/dist/agents/sessions/index.d.ts +42 -0
  80. package/dist/agents/sessions/index.js +97 -0
  81. package/dist/agents/sessions/index.js.map +1 -0
  82. package/dist/agents/sessions/live.d.ts +67 -0
  83. package/dist/agents/sessions/live.js +308 -0
  84. package/dist/agents/sessions/live.js.map +1 -0
  85. package/dist/agents/sessions/sqlite.d.ts +12 -0
  86. package/dist/agents/sessions/sqlite.js +61 -0
  87. package/dist/agents/sessions/sqlite.js.map +1 -0
  88. package/dist/agents/sessions/stores.d.ts +38 -0
  89. package/dist/agents/sessions/stores.js +630 -0
  90. package/dist/agents/sessions/stores.js.map +1 -0
  91. package/dist/agents/sessions/transcript.d.ts +20 -0
  92. package/dist/agents/sessions/transcript.js +134 -0
  93. package/dist/agents/sessions/transcript.js.map +1 -0
  94. package/dist/agents/sessions/types.d.ts +95 -0
  95. package/dist/agents/sessions/types.js +2 -0
  96. package/dist/agents/sessions/types.js.map +1 -0
  97. package/dist/agents/types.d.ts +31 -0
  98. package/dist/agents.d.ts +6 -0
  99. package/dist/agents.js +3 -0
  100. package/dist/agents.js.map +1 -1
  101. package/dist/cli/args.d.ts +26 -0
  102. package/dist/cli/args.js +66 -0
  103. package/dist/cli/args.js.map +1 -1
  104. package/dist/cli/hook.d.ts +7 -0
  105. package/dist/cli/hook.js +21 -0
  106. package/dist/cli/hook.js.map +1 -0
  107. package/dist/cli/main.d.ts +3 -1
  108. package/dist/cli/main.js +237 -2
  109. package/dist/cli/main.js.map +1 -1
  110. package/dist/cli.js +31 -21
  111. package/dist/cli.js.map +1 -1
  112. package/dist/providers/google-converter.js +18 -8
  113. package/dist/providers/google-converter.js.map +1 -1
  114. package/dist/providers/openai-converter.js +3 -2
  115. package/dist/providers/openai-converter.js.map +1 -1
  116. package/dist/providers/openai-responses-converter.d.ts +35 -0
  117. package/dist/providers/openai-responses-converter.js +188 -0
  118. package/dist/providers/openai-responses-converter.js.map +1 -0
  119. package/dist/providers/openai.d.ts +6 -1
  120. package/dist/providers/openai.js +16 -1
  121. package/dist/providers/openai.js.map +1 -1
  122. package/dist/providers.d.ts +1 -0
  123. package/dist/providers.js +1 -0
  124. package/dist/providers.js.map +1 -1
  125. package/dist/ui/index.js +109 -82
  126. package/dist/ui/sessions.d.ts +19 -0
  127. package/dist/ui/sessions.js +59 -0
  128. package/dist/ui/sessions.js.map +1 -0
  129. package/dist/ui/web-client.js +15 -14
  130. package/docs/CHANGELOG.md +26 -0
  131. package/docs/agents.md +212 -1
  132. package/docs/cli.md +41 -0
  133. package/docs/llm.md +6 -1
  134. package/package.json +1 -1
@@ -0,0 +1,611 @@
1
+ import { mkdirSync } from 'node:fs';
2
+ import path from 'node:path';
3
+ import { findExecutable } from './discovery.js';
4
+ import { approximateSize, EventQueue } from './event-queue.js';
5
+ import { startLocalMcpServer } from './mcp-server.js';
6
+ import { addWorktree, applyPatch, removeWorktree, repoRoot, worktreeChanges, worktreeDiff } from './pack-git.js';
7
+ import { addUsage, tokenCount } from './usage.js';
8
+ const CLIP = 4_000;
9
+ const MAX_DIFF = 60_000;
10
+ const clip = (text, max = CLIP) => text.length > max ? `${text.slice(0, max)}\n[... ${text.length - max} more characters]` : text;
11
+ function defaultBrief(members) {
12
+ const names = members.filter((member) => member.installed).map((member) => member.name);
13
+ return [
14
+ 'You lead a pack of coding agents on this machine. Besides doing work yourself, you can hand parts of it to the',
15
+ `others through the \`pack\` MCP tools. Agents available: ${names.join(', ') || 'none'}.`,
16
+ '- `agents` lists them with their limits. `delegate` starts a task on one and returns at once, so several can run',
17
+ ' in parallel. Give each a complete, self-contained prompt: it sees none of this conversation.',
18
+ '- By default a delegated task works in its own git worktree, a copy of the current files. Nothing it does',
19
+ ' reaches your directory until you `merge` it (`diff` shows it first, `discard` drops it). Use mode `shared`',
20
+ ' for read-only work such as a review, which then runs in your directory.',
21
+ '- `wait` blocks until tasks finish (or its timeout passes; call it again). Always wait for, and then merge or',
22
+ ' discard, every task before you finish. Tasks still running when you finish are stopped.',
23
+ '- Delegate what gains from it: independent pieces in parallel, a second opinion or review from a different',
24
+ ' agent, or work for an agent that still has quota when another ran out. Small tasks are faster done yourself.',
25
+ ].join('\n');
26
+ }
27
+ /** `agent.run(task)`, with a driver that throws on start turned into a run that failed. */
28
+ function startRun(agent, task) {
29
+ try {
30
+ return agent.run(task);
31
+ }
32
+ catch (error) {
33
+ const result = {
34
+ status: 'failed',
35
+ ok: false,
36
+ exitCode: null,
37
+ signal: null,
38
+ error: error instanceof Error ? error.message : String(error),
39
+ };
40
+ return {
41
+ result: Promise.resolve(result),
42
+ abort() { },
43
+ async *[Symbol.asyncIterator]() {
44
+ yield { type: 'done', result };
45
+ },
46
+ };
47
+ }
48
+ }
49
+ /** A short line on what a running task is doing, from its latest event. */
50
+ function activity(event) {
51
+ switch (event.type) {
52
+ case 'message':
53
+ return clip(event.text, 300);
54
+ case 'tool-start':
55
+ return `tool ${event.name}`;
56
+ case 'file-change':
57
+ return `edited ${event.paths.join(', ')}`;
58
+ case 'approval-request':
59
+ return `waiting for approval: ${event.request.summary ?? event.request.kind}`;
60
+ case 'error':
61
+ return `error: ${clip(event.message, 300)}`;
62
+ default:
63
+ return undefined;
64
+ }
65
+ }
66
+ /**
67
+ * One `CodingAgent` over the agents on a machine: `lead` gets the prompt plus MCP tools to
68
+ * delegate parts of it to `members` (in parallel, each in its own git worktree), follow them, and
69
+ * merge what they did. Routing is the lead's judgement; genaicode adds the tools, not a loop.
70
+ *
71
+ * Events are the lead's, plus `subtask-start`, `subtask` and `subtask-update` for delegated work.
72
+ * `usage` events and the result's usage add up the lead and every delegated task, and
73
+ * `task.budget` caps that sum. Delegated tasks inherit `env`, `permissions` and `onApproval`
74
+ * (request ids are prefixed with the task id). `resume`, `steer()` and the session id are the lead's.
75
+ */
76
+ export function pack(options) {
77
+ const { lead, members } = options;
78
+ const maxParallel = options.maxParallel ?? 4;
79
+ const subs = new Map();
80
+ const limits = new Map();
81
+ const lastFailure = new Map();
82
+ // One merge at a time: each patch applies to what the one before left.
83
+ let merging = Promise.resolve();
84
+ let nextId = 1;
85
+ // Delegations still setting up their worktree: they hold a `maxParallel` slot already.
86
+ let starting = 0;
87
+ const noteLimit = (agent, limit) => {
88
+ let known = limits.get(agent);
89
+ if (!known)
90
+ limits.set(agent, (known = new Map()));
91
+ known.set(limit.window, limit);
92
+ };
93
+ const describeMembers = (env) => members.map((member) => {
94
+ const known = [...(limits.get(member.name)?.values() ?? [])];
95
+ const failure = lastFailure.get(member.name);
96
+ return {
97
+ name: member.name,
98
+ installed: findExecutable(member.command, env) !== null,
99
+ running: [...subs.values()].filter((sub) => sub.agent === member && sub.status === 'running').length,
100
+ steer: !!member.capabilities.steer,
101
+ ...(known.length ? { limits: known } : {}),
102
+ ...(failure ? { lastFailure: failure } : {}),
103
+ };
104
+ });
105
+ const report = (sub) => ({
106
+ id: sub.id,
107
+ agent: sub.agent.name,
108
+ prompt: sub.prompt,
109
+ mode: sub.mode,
110
+ status: sub.status,
111
+ cwd: sub.cwd,
112
+ ...(sub.result?.text !== undefined
113
+ ? { text: clip(sub.result.text) }
114
+ : sub.status === 'running' && sub.last
115
+ ? { text: sub.last }
116
+ : {}),
117
+ ...(sub.result?.error ? { error: clip(sub.result.error) } : {}),
118
+ ...(sub.result?.failure ? { failure: sub.result.failure } : {}),
119
+ ...(sub.changes ? { changes: sub.changes } : {}),
120
+ ...(sub.state ? { state: sub.state } : {}),
121
+ });
122
+ const drop = async (sub) => {
123
+ if (sub.repo && sub.dir)
124
+ await removeWorktree(sub.repo, sub.dir);
125
+ sub.dir = undefined;
126
+ };
127
+ return {
128
+ name: options.name ?? 'pack',
129
+ command: lead.command,
130
+ capabilities: lead.capabilities,
131
+ // A pack turn is a session of its lead.
132
+ ...(lead.sessions !== undefined ? { sessions: lead.sessions } : {}),
133
+ tasks: () => [...subs.values()].map(report),
134
+ async close() {
135
+ const all = [...subs.values()];
136
+ for (const sub of all)
137
+ sub.run?.abort();
138
+ await Promise.all(all.map((sub) => sub.ended));
139
+ for (const sub of all) {
140
+ if (sub.dir && sub.state === 'unmerged')
141
+ sub.state = 'discarded';
142
+ await drop(sub);
143
+ }
144
+ },
145
+ run(task) {
146
+ const events = new EventQueue(approximateSize);
147
+ const ended = new AbortController();
148
+ const mine = new Set();
149
+ const settingUp = new Set();
150
+ let leadRun;
151
+ let stopped = false;
152
+ let leadUsage;
153
+ let leadCost;
154
+ let overBudget;
155
+ const warned = new Set();
156
+ const total = () => {
157
+ let usage = leadUsage;
158
+ let costUsd = leadCost;
159
+ for (const sub of mine) {
160
+ if (sub.usage)
161
+ usage = usage ? addUsage(usage, sub.usage) : sub.usage;
162
+ if (sub.costUsd !== undefined)
163
+ costUsd = (costUsd ?? 0) + sub.costUsd;
164
+ }
165
+ return { ...(usage ? { usage } : {}), ...(costUsd !== undefined ? { costUsd } : {}) };
166
+ };
167
+ const stopAll = () => {
168
+ leadRun?.abort();
169
+ for (const sub of mine)
170
+ sub.run?.abort();
171
+ };
172
+ /** Report the pack's usage so far and enforce `task.budget` against it. */
173
+ const usageChanged = () => {
174
+ const { usage, costUsd } = total();
175
+ if (!usage && costUsd === undefined)
176
+ return;
177
+ events.push({ type: 'usage', usage: usage ?? {}, ...(costUsd !== undefined ? { costUsd } : {}) });
178
+ const budget = task.budget;
179
+ if (!budget || overBudget)
180
+ return;
181
+ const checks = [];
182
+ if (budget.maxTokens !== undefined)
183
+ checks.push({ kind: 'tokens', used: usage ? tokenCount(usage) : 0, limit: budget.maxTokens });
184
+ if (budget.maxCostUsd !== undefined && costUsd !== undefined)
185
+ checks.push({ kind: 'cost', used: costUsd, limit: budget.maxCostUsd });
186
+ for (const check of checks) {
187
+ if (check.used > check.limit) {
188
+ overBudget =
189
+ check.kind === 'tokens'
190
+ ? `The pack went over its token budget (${check.used} of ${check.limit}).`
191
+ : `The pack went over its cost budget ($${check.used.toFixed(4)} of $${check.limit}).`;
192
+ events.push({ type: 'error', message: overBudget });
193
+ stopAll();
194
+ return;
195
+ }
196
+ if (check.used >= check.limit * (budget.warnAt ?? 0.8) && !warned.has(check.kind)) {
197
+ warned.add(check.kind);
198
+ events.push({ type: 'budget-warning', warning: check });
199
+ }
200
+ }
201
+ };
202
+ const find = (id) => {
203
+ const sub = typeof id === 'string' ? subs.get(id) : undefined;
204
+ if (!sub)
205
+ throw new Error(`No task ${String(id)}. Known: ${[...subs.keys()].join(', ') || 'none'}.`);
206
+ return sub;
207
+ };
208
+ const delegate = async (args) => {
209
+ const prompt = typeof args.prompt === 'string' ? args.prompt.trim() : '';
210
+ if (!prompt)
211
+ throw new Error('`prompt` is required.');
212
+ const agent = members.find((member) => member.name === args.agent);
213
+ if (!agent)
214
+ throw new Error(`No agent ${String(args.agent)}. Available: ${members.map((m) => m.name).join(', ')}.`);
215
+ if (findExecutable(agent.command, task.env) === null)
216
+ throw new Error(`${agent.name} is not installed.`);
217
+ if (ended.signal.aborted)
218
+ throw new Error('The run has ended.');
219
+ const running = [...subs.values()].filter((sub) => sub.status === 'running').length + starting;
220
+ if (running >= maxParallel)
221
+ throw new Error(`${running} tasks are running already (the most allowed). Wait for one to finish.`);
222
+ // Taken before the first await, so calls made at the same moment cannot share a slot.
223
+ starting += 1;
224
+ const setup = start(agent, prompt, args.mode).finally(() => {
225
+ starting -= 1;
226
+ settingUp.delete(setup);
227
+ });
228
+ settingUp.add(setup);
229
+ return setup;
230
+ };
231
+ const start = async (agent, prompt, wanted) => {
232
+ const repo = await repoRoot(task.cwd);
233
+ const mode = wanted === 'shared' ? 'shared' : wanted === undefined || wanted === 'worktree' ? 'worktree' : null;
234
+ if (!mode)
235
+ throw new Error('`mode` is `worktree` or `shared`.');
236
+ if (mode === 'worktree' && !repo)
237
+ throw new Error('The working directory is not a git repository, so there are no worktrees. Use mode `shared`.');
238
+ const id = `t${nextId++}`;
239
+ let settle;
240
+ const sub = {
241
+ id,
242
+ agent,
243
+ prompt,
244
+ mode,
245
+ cwd: task.cwd,
246
+ status: 'running',
247
+ ended: new Promise((resolve) => (settle = resolve)),
248
+ };
249
+ if (mode === 'worktree' && repo) {
250
+ const dir = path.join(repo, options.worktreeDir ?? path.join('.genaicode', 'worktrees'), `${id}-${Date.now().toString(36)}`);
251
+ sub.start = await addWorktree(repo, dir);
252
+ sub.repo = repo;
253
+ sub.dir = dir;
254
+ sub.state = 'unmerged';
255
+ sub.cwd = path.join(dir, path.relative(repo, task.cwd));
256
+ mkdirSync(sub.cwd, { recursive: true });
257
+ try {
258
+ await options.prepareWorktree?.(dir, repo);
259
+ // The lead finished while the worktree was being set up: nobody would follow the task.
260
+ if (ended.signal.aborted)
261
+ throw new Error('The run has ended.');
262
+ }
263
+ catch (error) {
264
+ await drop(sub);
265
+ throw error;
266
+ }
267
+ }
268
+ subs.set(id, sub);
269
+ mine.add(sub);
270
+ events.push({ type: 'subtask-start', id, agent: agent.name, prompt, cwd: sub.cwd, mode });
271
+ const onApproval = task.onApproval;
272
+ const run = startRun(agent, {
273
+ prompt,
274
+ cwd: sub.cwd,
275
+ ...(task.env ? { env: task.env } : {}),
276
+ ...(task.permissions !== undefined ? { permissions: task.permissions } : {}),
277
+ ...(onApproval
278
+ ? {
279
+ onApproval: (request, signal) => onApproval({
280
+ ...request,
281
+ id: `${id}:${request.id}`,
282
+ summary: `[${agent.name} ${id}] ${request.summary ?? request.kind}`,
283
+ }, signal),
284
+ }
285
+ : {}),
286
+ });
287
+ sub.run = run;
288
+ if (stopped || ended.signal.aborted)
289
+ run.abort();
290
+ void (async () => {
291
+ let result;
292
+ try {
293
+ for await (const event of run) {
294
+ sub.last = activity(event) ?? sub.last;
295
+ if (event.type === 'rate-limit')
296
+ noteLimit(agent.name, event.limit);
297
+ if (event.type === 'usage') {
298
+ sub.usage = event.usage;
299
+ if (event.costUsd !== undefined)
300
+ sub.costUsd = event.costUsd;
301
+ usageChanged();
302
+ }
303
+ if (event.type !== 'done' && event.type !== 'raw' && event.type !== 'stderr') {
304
+ events.push({ type: 'subtask', id, agent: agent.name, event });
305
+ await events.room();
306
+ }
307
+ }
308
+ result = await run.result;
309
+ }
310
+ catch (error) {
311
+ const message = error instanceof Error ? error.message : String(error);
312
+ result = { status: 'failed', ok: false, exitCode: null, signal: null, error: message };
313
+ }
314
+ if (result.usage)
315
+ sub.usage = result.usage;
316
+ if (result.costUsd !== undefined)
317
+ sub.costUsd = result.costUsd;
318
+ if (result.failure)
319
+ lastFailure.set(agent.name, result.failure);
320
+ else if (result.ok)
321
+ lastFailure.delete(agent.name);
322
+ if (sub.dir && sub.start) {
323
+ try {
324
+ sub.changes = await worktreeChanges(sub.dir, sub.start);
325
+ }
326
+ catch {
327
+ sub.changes = undefined;
328
+ }
329
+ }
330
+ sub.result = result;
331
+ sub.status = result.status;
332
+ sub.run = undefined;
333
+ events.push({ type: 'subtask', id, agent: agent.name, event: { type: 'done', result } });
334
+ usageChanged();
335
+ settle();
336
+ })();
337
+ return JSON.stringify({ id, agent: agent.name, mode, cwd: sub.cwd });
338
+ };
339
+ const wait = async (args) => {
340
+ const ids = Array.isArray(args.ids) && args.ids.length ? args.ids : null;
341
+ // By default: what still runs, and what ended since the lead last heard of it.
342
+ const chosen = ids
343
+ ? ids.map(find)
344
+ : [...subs.values()].filter((sub) => sub.status === 'running' || !sub.reported);
345
+ const seconds = typeof args.timeoutSeconds === 'number' ? Math.min(Math.max(args.timeoutSeconds, 0), 600) : 45;
346
+ const pending = chosen.filter((sub) => sub.status === 'running').map((sub) => sub.ended);
347
+ if (pending.length && seconds > 0) {
348
+ let timer;
349
+ const onEnd = new Promise((resolve) => ended.signal.addEventListener('abort', () => resolve(), { once: true }));
350
+ await Promise.race([
351
+ args.until === 'any' ? Promise.race(pending) : Promise.all(pending),
352
+ new Promise((resolve) => (timer = setTimeout(resolve, seconds * 1000))),
353
+ onEnd,
354
+ ]);
355
+ clearTimeout(timer);
356
+ }
357
+ for (const sub of chosen)
358
+ if (sub.status !== 'running')
359
+ sub.reported = true;
360
+ return JSON.stringify(chosen.map(report), null, 1);
361
+ };
362
+ const merge = (args) => {
363
+ const sub = find(args.id);
364
+ const next = merging.then(async () => {
365
+ if (sub.status === 'running')
366
+ throw new Error(`${sub.id} is still running. Wait for it first.`);
367
+ if (sub.mode !== 'worktree')
368
+ throw new Error(`${sub.id} ran in the shared directory: there is nothing to merge.`);
369
+ if (sub.state !== 'unmerged' || !sub.dir || !sub.start || !sub.repo)
370
+ throw new Error(`${sub.id} is already ${sub.state}.`);
371
+ const patch = await worktreeDiff(sub.dir, sub.start);
372
+ const paths = (sub.changes ?? []).map((line) => line.split('\t').slice(1).join('\t'));
373
+ if (patch.trim()) {
374
+ const applied = await applyPatch(sub.repo, patch, args.threeWay === true);
375
+ if (!applied.ok) {
376
+ if (!applied.conflicts)
377
+ throw new Error(`The changes of ${sub.id} do not apply cleanly, nothing was changed:\n${clip(applied.error)}\n` +
378
+ 'Call merge again with threeWay: true to merge what fits and get conflict markers in the rest, or apply the diff by hand.');
379
+ sub.state = 'merged';
380
+ await drop(sub);
381
+ events.push({ type: 'subtask-update', id: sub.id, agent: sub.agent.name, state: 'merged', paths });
382
+ events.push({
383
+ type: 'file-change',
384
+ paths: paths.map((file) => path.join(path.relative(task.cwd, sub.repo), file)),
385
+ });
386
+ return `Merged ${sub.id} with conflicts. Resolve the conflict markers in:\n${clip(applied.error)}`;
387
+ }
388
+ }
389
+ sub.state = 'merged';
390
+ const repo = sub.repo;
391
+ await drop(sub);
392
+ events.push({ type: 'subtask-update', id: sub.id, agent: sub.agent.name, state: 'merged', paths });
393
+ if (paths.length)
394
+ events.push({
395
+ type: 'file-change',
396
+ paths: paths.map((file) => path.join(path.relative(task.cwd, repo), file)),
397
+ });
398
+ return paths.length ? `Merged ${sub.id}:\n${(sub.changes ?? []).join('\n')}` : `${sub.id} changed nothing.`;
399
+ });
400
+ merging = next.catch(() => { });
401
+ return next;
402
+ };
403
+ const tools = [
404
+ {
405
+ name: 'agents',
406
+ description: 'List the coding agents you can delegate to: whether each is installed, what it is running, and the plan limits it reported.',
407
+ inputSchema: { type: 'object', properties: {} },
408
+ call: async () => JSON.stringify(describeMembers(task.env), null, 1),
409
+ },
410
+ {
411
+ name: 'delegate',
412
+ description: 'Start a task on another coding agent and return its id at once. The agent sees only `prompt`. Mode `worktree` (default) gives it its own copy of the current files, to merge later; `shared` runs it in your directory (for read-only work such as reviews).',
413
+ inputSchema: {
414
+ type: 'object',
415
+ properties: {
416
+ agent: { type: 'string', description: 'Agent name, from `agents`.' },
417
+ prompt: { type: 'string', description: 'The complete task, with all the context the agent needs.' },
418
+ mode: { type: 'string', enum: ['worktree', 'shared'] },
419
+ },
420
+ required: ['agent', 'prompt'],
421
+ },
422
+ call: delegate,
423
+ },
424
+ {
425
+ name: 'wait',
426
+ description: 'Wait for delegated tasks and report them: status, final message (or latest activity), error, changed files. Returns when the tasks finished or after timeoutSeconds (default 45); call again while any is `running`.',
427
+ inputSchema: {
428
+ type: 'object',
429
+ properties: {
430
+ ids: {
431
+ type: 'array',
432
+ items: { type: 'string' },
433
+ description: 'Tasks to wait for. Default: every running task, and those that ended since the last wait.',
434
+ },
435
+ until: {
436
+ type: 'string',
437
+ enum: ['all', 'any'],
438
+ description: 'Return when all of them finished (default) or as soon as one did.',
439
+ },
440
+ timeoutSeconds: { type: 'number', description: '0 reports without waiting. At most 600.' },
441
+ },
442
+ },
443
+ call: wait,
444
+ },
445
+ {
446
+ name: 'steer',
447
+ description: 'Send more input to a running task, for agents that take it (`steer` in `agents`).',
448
+ inputSchema: {
449
+ type: 'object',
450
+ properties: { id: { type: 'string' }, text: { type: 'string' } },
451
+ required: ['id', 'text'],
452
+ },
453
+ call: async (args) => {
454
+ const sub = find(args.id);
455
+ if (sub.status !== 'running' || !sub.run)
456
+ throw new Error(`${sub.id} is not running.`);
457
+ if (!sub.run.steer)
458
+ throw new Error(`${sub.agent.name} cannot take input while it runs. Stop it and delegate again.`);
459
+ if (typeof args.text !== 'string' || !args.text.trim())
460
+ throw new Error('`text` is required.');
461
+ await sub.run.steer(args.text);
462
+ return `Sent to ${sub.id}.`;
463
+ },
464
+ },
465
+ {
466
+ name: 'stop',
467
+ description: 'Stop a running task. What it changed so far stays in its worktree.',
468
+ inputSchema: { type: 'object', properties: { id: { type: 'string' } }, required: ['id'] },
469
+ call: async (args) => {
470
+ const sub = find(args.id);
471
+ if (sub.status !== 'running')
472
+ return `${sub.id} already ended (${sub.status}).`;
473
+ sub.run?.abort();
474
+ await sub.ended;
475
+ return `Stopped ${sub.id}.`;
476
+ },
477
+ },
478
+ {
479
+ name: 'diff',
480
+ description: 'The changes a worktree task made, as a unified diff.',
481
+ inputSchema: { type: 'object', properties: { id: { type: 'string' } }, required: ['id'] },
482
+ call: async (args) => {
483
+ const sub = find(args.id);
484
+ if (!sub.dir || !sub.start)
485
+ throw new Error(`${sub.id} has no worktree (${sub.state ?? 'shared'}).`);
486
+ return clip(await worktreeDiff(sub.dir, sub.start), MAX_DIFF) || 'No changes.';
487
+ },
488
+ },
489
+ {
490
+ name: 'merge',
491
+ description: "Apply a finished worktree task's changes to your directory and remove its worktree. All or nothing, unless threeWay is true: then what fits is merged and the rest gets conflict markers for you to resolve.",
492
+ inputSchema: {
493
+ type: 'object',
494
+ properties: { id: { type: 'string' }, threeWay: { type: 'boolean' } },
495
+ required: ['id'],
496
+ },
497
+ call: merge,
498
+ },
499
+ {
500
+ name: 'discard',
501
+ description: "Drop a finished worktree task's changes and remove its worktree.",
502
+ inputSchema: { type: 'object', properties: { id: { type: 'string' } }, required: ['id'] },
503
+ call: async (args) => {
504
+ const sub = find(args.id);
505
+ if (sub.status === 'running')
506
+ throw new Error(`${sub.id} is still running. Stop it first.`);
507
+ if (sub.state !== 'unmerged')
508
+ throw new Error(`${sub.id} is ${sub.state ?? 'a shared task'}: nothing to discard.`);
509
+ sub.state = 'discarded';
510
+ await drop(sub);
511
+ events.push({ type: 'subtask-update', id: sub.id, agent: sub.agent.name, state: 'discarded' });
512
+ return `Discarded ${sub.id}.`;
513
+ },
514
+ },
515
+ ];
516
+ const failed = (error, failure) => ({
517
+ status: 'failed',
518
+ ok: false,
519
+ exitCode: null,
520
+ signal: null,
521
+ error,
522
+ ...(failure ? { failure } : {}),
523
+ });
524
+ const result = (async () => {
525
+ if (!lead.capabilities.mcp)
526
+ return failed(`${lead.name} cannot attach MCP servers, so it cannot lead a pack.`);
527
+ const server = await startLocalMcpServer({ name: 'pack', tools });
528
+ let own;
529
+ try {
530
+ const brief = task.resume ? '' : `${(options.brief ?? defaultBrief)(describeMembers(task.env))}\n\n`;
531
+ const run = startRun(lead, {
532
+ ...task,
533
+ prompt: `${brief}${task.prompt}`,
534
+ budget: undefined,
535
+ mcpServers: [...(task.mcpServers ?? []), server.mcpServer],
536
+ });
537
+ leadRun = run;
538
+ if (stopped)
539
+ run.abort();
540
+ let done;
541
+ for await (const event of run) {
542
+ if (event.type === 'done')
543
+ done = event.result;
544
+ else if (event.type === 'usage') {
545
+ leadUsage = event.usage;
546
+ if (event.costUsd !== undefined)
547
+ leadCost = event.costUsd;
548
+ usageChanged();
549
+ }
550
+ else {
551
+ if (event.type === 'rate-limit')
552
+ noteLimit(lead.name, event.limit);
553
+ events.push(event);
554
+ await events.room();
555
+ }
556
+ }
557
+ own = done ?? (await run.result);
558
+ if (own.usage)
559
+ leadUsage = own.usage;
560
+ if (own.costUsd !== undefined)
561
+ leadCost = own.costUsd;
562
+ // A lead that reports usage only at the end can still take the pack over its budget.
563
+ if (own.usage || own.costUsd !== undefined)
564
+ usageChanged();
565
+ }
566
+ finally {
567
+ // The lead is gone: nobody is left to wait for, merge or steer what still runs.
568
+ ended.abort();
569
+ // A delegation still setting up sees the run ended and removes its worktree.
570
+ await Promise.allSettled([...settingUp]);
571
+ for (const sub of mine)
572
+ sub.run?.abort();
573
+ await Promise.all([...mine].map((sub) => sub.ended));
574
+ await server.close();
575
+ }
576
+ const sum = total();
577
+ return {
578
+ ...(overBudget
579
+ ? { ...failed(overBudget, { kind: 'budget' }), sessionId: own.sessionId, text: own.text }
580
+ : own),
581
+ ...sum,
582
+ };
583
+ })();
584
+ const settled = result
585
+ .catch((error) => {
586
+ const message = error instanceof Error ? error.message : String(error);
587
+ events.push({ type: 'error', message });
588
+ return failed(message);
589
+ })
590
+ .then((final) => {
591
+ events.push({ type: 'done', result: final });
592
+ events.close();
593
+ return final;
594
+ });
595
+ return {
596
+ result: settled,
597
+ abort() {
598
+ stopped = true;
599
+ stopAll();
600
+ },
601
+ ...(lead.capabilities.steer
602
+ ? {
603
+ steer: (text) => leadRun?.steer ? leadRun.steer(text) : Promise.reject(new Error('The agent cannot take input now.')),
604
+ }
605
+ : {}),
606
+ [Symbol.asyncIterator]: () => events.iterate(),
607
+ };
608
+ },
609
+ };
610
+ }
611
+ //# sourceMappingURL=pack.js.map