@duckmind/dm-darwin-x64 0.43.4 → 0.48.5

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 (254) hide show
  1. package/dm +0 -0
  2. package/extensions/.dm-extensions.json +242 -50
  3. package/extensions/dm-9router-ext/package.json +2 -19
  4. package/extensions/dm-9router-ext/src/index.js +5 -0
  5. package/extensions/dm-ask-user/index.js +10 -0
  6. package/extensions/dm-ask-user/package.json +1 -21
  7. package/extensions/dm-cli-anything/package.json +0 -6
  8. package/extensions/dm-context/package.json +2 -12
  9. package/extensions/dm-context/src/context.js +1 -0
  10. package/extensions/dm-context/src/index.js +7 -0
  11. package/extensions/dm-context/src/utils.js +1 -0
  12. package/extensions/dm-cua/package.json +0 -7
  13. package/extensions/dm-fff/package.json +1 -28
  14. package/extensions/dm-fff/src/index.js +15 -0
  15. package/extensions/dm-fff/src/query.js +1 -0
  16. package/extensions/dm-goal/package.json +2 -31
  17. package/extensions/dm-goal/src/goal.js +43 -0
  18. package/extensions/dm-grill-me/index.js +174 -0
  19. package/extensions/dm-grill-me/package.json +1 -26
  20. package/extensions/dm-image2/package.json +0 -7
  21. package/extensions/dm-subagents/package.json +1 -32
  22. package/extensions/dm-subagents/src/agents/agent-management.js +37 -0
  23. package/extensions/dm-subagents/src/agents/agent-memory.js +6 -0
  24. package/extensions/dm-subagents/src/agents/agent-scope.js +1 -0
  25. package/extensions/dm-subagents/src/agents/agent-selection.js +1 -0
  26. package/extensions/dm-subagents/src/agents/agent-serializer.js +7 -0
  27. package/extensions/dm-subagents/src/agents/agents.js +11 -0
  28. package/extensions/dm-subagents/src/agents/chain-serializer.js +12 -0
  29. package/extensions/dm-subagents/src/agents/frontmatter.js +6 -0
  30. package/extensions/dm-subagents/src/agents/identity.js +1 -0
  31. package/extensions/dm-subagents/src/agents/proactive-skills.js +1 -0
  32. package/extensions/dm-subagents/src/agents/skills.js +6 -0
  33. package/extensions/dm-subagents/src/extension/config.js +2 -0
  34. package/extensions/dm-subagents/src/extension/control-notices.js +4 -0
  35. package/extensions/dm-subagents/src/extension/doctor.js +16 -0
  36. package/extensions/dm-subagents/src/extension/fanout-child.js +231 -0
  37. package/extensions/dm-subagents/src/extension/index.js +367 -0
  38. package/extensions/dm-subagents/src/extension/rpc.js +8 -0
  39. package/extensions/dm-subagents/src/extension/schemas.js +1 -0
  40. package/extensions/dm-subagents/src/extension/{tool-description.ts → tool-description.js} +6 -126
  41. package/extensions/dm-subagents/src/intercom/intercom-bridge.js +13 -0
  42. package/extensions/dm-subagents/src/intercom/native-supervisor-channel.js +5 -0
  43. package/extensions/dm-subagents/src/intercom/result-intercom.js +3 -0
  44. package/extensions/dm-subagents/src/profiles/profiles.js +3 -0
  45. package/extensions/dm-subagents/src/runs/background/async-execution.js +46 -0
  46. package/extensions/dm-subagents/src/runs/background/async-job-tracker.js +14 -0
  47. package/extensions/dm-subagents/src/runs/background/async-resume.js +8 -0
  48. package/extensions/dm-subagents/src/runs/background/async-status.js +12 -0
  49. package/extensions/dm-subagents/src/runs/background/chain-append.js +2 -0
  50. package/extensions/dm-subagents/src/runs/background/chain-root-attachment.js +1 -0
  51. package/extensions/dm-subagents/src/runs/background/completion-batcher.js +1 -0
  52. package/extensions/dm-subagents/src/runs/background/completion-dedupe.js +1 -0
  53. package/extensions/dm-subagents/src/runs/background/control-channel.js +1 -0
  54. package/extensions/dm-subagents/src/runs/background/fleet-view.js +17 -0
  55. package/extensions/dm-subagents/src/runs/background/notify.js +3 -0
  56. package/extensions/dm-subagents/src/runs/background/parallel-groups.js +1 -0
  57. package/extensions/dm-subagents/src/runs/background/result-watcher.js +8 -0
  58. package/extensions/dm-subagents/src/runs/background/run-id-resolver.js +4 -0
  59. package/extensions/dm-subagents/src/runs/background/run-status.js +23 -0
  60. package/extensions/dm-subagents/src/runs/background/scheduled-runs.js +4 -0
  61. package/extensions/dm-subagents/src/runs/background/stale-run-reconciler.js +11 -0
  62. package/extensions/dm-subagents/src/runs/background/subagent-runner.js +78 -0
  63. package/extensions/dm-subagents/src/runs/background/top-level-async.js +1 -0
  64. package/extensions/dm-subagents/src/runs/background/wait.js +11 -0
  65. package/extensions/dm-subagents/src/runs/foreground/chain-clarify.js +12 -0
  66. package/extensions/dm-subagents/src/runs/foreground/chain-execution.js +102 -0
  67. package/extensions/dm-subagents/src/runs/foreground/execution.js +51 -0
  68. package/extensions/dm-subagents/src/runs/foreground/subagent-executor.js +228 -0
  69. package/extensions/dm-subagents/src/runs/shared/acceptance.js +3 -0
  70. package/extensions/dm-subagents/src/runs/shared/chain-outputs.js +1 -0
  71. package/extensions/dm-subagents/src/runs/shared/completion-guard.js +3 -0
  72. package/extensions/dm-subagents/src/runs/shared/dm-args.js +1 -0
  73. package/extensions/dm-subagents/src/runs/shared/dm-spawn.js +1 -0
  74. package/extensions/dm-subagents/src/runs/shared/dynamic-fanout.js +1 -0
  75. package/extensions/dm-subagents/src/runs/shared/long-running-guard.js +1 -0
  76. package/extensions/dm-subagents/src/runs/shared/mcp-direct-tool-allowlist.js +1 -0
  77. package/extensions/dm-subagents/src/runs/shared/model-fallback.js +1 -0
  78. package/extensions/dm-subagents/src/runs/shared/model-scope.js +1 -0
  79. package/extensions/dm-subagents/src/runs/shared/nested-events.js +8 -0
  80. package/extensions/dm-subagents/src/runs/shared/nested-path.js +1 -0
  81. package/extensions/dm-subagents/src/runs/shared/nested-render.js +1 -0
  82. package/extensions/dm-subagents/src/runs/shared/parallel-utils.js +5 -0
  83. package/extensions/dm-subagents/src/runs/shared/run-history.js +5 -0
  84. package/extensions/dm-subagents/src/runs/shared/single-output.js +14 -0
  85. package/extensions/dm-subagents/src/runs/shared/structured-output.js +1 -0
  86. package/extensions/dm-subagents/src/runs/shared/subagent-control.js +5 -0
  87. package/extensions/dm-subagents/src/runs/shared/subagent-prompt-runtime.js +22 -0
  88. package/extensions/dm-subagents/src/runs/shared/tool-budget.js +1 -0
  89. package/extensions/dm-subagents/src/runs/shared/turn-budget.js +7 -0
  90. package/extensions/dm-subagents/src/runs/shared/workflow-graph.js +1 -0
  91. package/extensions/dm-subagents/src/runs/shared/worktree.js +3 -0
  92. package/extensions/dm-subagents/src/shared/artifacts.js +2 -0
  93. package/extensions/dm-subagents/src/shared/atomic-json.js +1 -0
  94. package/extensions/dm-subagents/src/shared/child-transcript.js +5 -0
  95. package/extensions/dm-subagents/src/shared/file-coalescer.js +1 -0
  96. package/extensions/dm-subagents/src/shared/fork-context.js +6 -0
  97. package/extensions/dm-subagents/src/shared/formatters.js +9 -0
  98. package/extensions/dm-subagents/src/shared/jsonl-writer.js +2 -0
  99. package/extensions/dm-subagents/src/shared/model-info.js +1 -0
  100. package/extensions/dm-subagents/src/shared/post-exit-stdio-guard.js +1 -0
  101. package/extensions/dm-subagents/src/shared/session-identity.js +1 -0
  102. package/extensions/dm-subagents/src/shared/session-tokens.js +2 -0
  103. package/extensions/dm-subagents/src/shared/settings.js +23 -0
  104. package/extensions/dm-subagents/src/shared/status-format.js +1 -0
  105. package/extensions/dm-subagents/src/shared/types.js +8 -0
  106. package/extensions/dm-subagents/src/shared/utils.js +2 -0
  107. package/extensions/dm-subagents/src/slash/prompt-template-bridge.js +1 -0
  108. package/extensions/dm-subagents/src/slash/prompt-workflows.js +7 -0
  109. package/extensions/dm-subagents/src/slash/slash-bridge.js +1 -0
  110. package/extensions/dm-subagents/src/slash/slash-commands.js +38 -0
  111. package/extensions/dm-subagents/src/slash/slash-live-state.js +6 -0
  112. package/extensions/dm-subagents/src/tui/render-helpers.js +1 -0
  113. package/extensions/dm-subagents/src/tui/render.js +4 -0
  114. package/extensions/dm-tasks/package.json +1 -30
  115. package/extensions/dm-tasks/src/auto-clear.js +1 -0
  116. package/extensions/dm-tasks/src/index.js +212 -0
  117. package/extensions/dm-tasks/src/process-tracker.js +1 -0
  118. package/extensions/dm-tasks/src/task-store.js +1 -0
  119. package/extensions/dm-tasks/src/tasks-config.js +1 -0
  120. package/extensions/dm-tasks/src/types.js +0 -0
  121. package/extensions/dm-tasks/src/ui/settings-menu.js +1 -0
  122. package/extensions/dm-tasks/src/ui/task-widget.js +1 -0
  123. package/extensions/dm-usage/index.js +9 -0
  124. package/extensions/dm-usage/package.json +1 -18
  125. package/extensions/greedysearch-dm/bin/search.mjs +51 -51
  126. package/extensions/greedysearch-dm/index.js +20 -0
  127. package/extensions/greedysearch-dm/package.json +1 -22
  128. package/extensions/greedysearch-dm/src/formatters/results.js +8 -0
  129. package/extensions/greedysearch-dm/src/formatters/sources.js +1 -0
  130. package/extensions/greedysearch-dm/src/formatters/synthesis.js +1 -0
  131. package/extensions/greedysearch-dm/src/search/research.mjs +59 -59
  132. package/extensions/greedysearch-dm/src/search/synthesis-runner.mjs +10 -10
  133. package/extensions/greedysearch-dm/src/tools/greedy-search-handler.js +20 -0
  134. package/extensions/greedysearch-dm/src/tools/shared.js +9 -0
  135. package/extensions/greedysearch-dm/src/types.js +0 -0
  136. package/extensions/greedysearch-dm/src/utils/helpers.js +1 -0
  137. package/package.json +1 -1
  138. package/extensions/dm-9router-ext/src/index.ts +0 -541
  139. package/extensions/dm-ask-user/index.ts +0 -857
  140. package/extensions/dm-context/src/context.ts +0 -158
  141. package/extensions/dm-context/src/index.ts +0 -439
  142. package/extensions/dm-context/src/utils.ts +0 -6
  143. package/extensions/dm-fff/src/index.ts +0 -1023
  144. package/extensions/dm-fff/src/query.ts +0 -87
  145. package/extensions/dm-goal/src/goal.ts +0 -1073
  146. package/extensions/dm-grill-me/index.ts +0 -1085
  147. package/extensions/dm-subagents/src/agents/agent-management.ts +0 -1052
  148. package/extensions/dm-subagents/src/agents/agent-memory.ts +0 -254
  149. package/extensions/dm-subagents/src/agents/agent-scope.ts +0 -6
  150. package/extensions/dm-subagents/src/agents/agent-selection.ts +0 -25
  151. package/extensions/dm-subagents/src/agents/agent-serializer.ts +0 -121
  152. package/extensions/dm-subagents/src/agents/agents.ts +0 -1553
  153. package/extensions/dm-subagents/src/agents/chain-serializer.ts +0 -277
  154. package/extensions/dm-subagents/src/agents/frontmatter.ts +0 -93
  155. package/extensions/dm-subagents/src/agents/identity.ts +0 -30
  156. package/extensions/dm-subagents/src/agents/proactive-skills.ts +0 -191
  157. package/extensions/dm-subagents/src/agents/skills.ts +0 -729
  158. package/extensions/dm-subagents/src/extension/config.ts +0 -39
  159. package/extensions/dm-subagents/src/extension/control-notices.ts +0 -92
  160. package/extensions/dm-subagents/src/extension/doctor.ts +0 -214
  161. package/extensions/dm-subagents/src/extension/fanout-child.ts +0 -172
  162. package/extensions/dm-subagents/src/extension/index.ts +0 -656
  163. package/extensions/dm-subagents/src/extension/rpc.ts +0 -369
  164. package/extensions/dm-subagents/src/extension/schemas.ts +0 -309
  165. package/extensions/dm-subagents/src/intercom/intercom-bridge.ts +0 -180
  166. package/extensions/dm-subagents/src/intercom/native-supervisor-channel.ts +0 -519
  167. package/extensions/dm-subagents/src/intercom/result-intercom.ts +0 -377
  168. package/extensions/dm-subagents/src/profiles/profiles.ts +0 -637
  169. package/extensions/dm-subagents/src/runs/background/async-execution.ts +0 -1065
  170. package/extensions/dm-subagents/src/runs/background/async-job-tracker.ts +0 -441
  171. package/extensions/dm-subagents/src/runs/background/async-resume.ts +0 -391
  172. package/extensions/dm-subagents/src/runs/background/async-status.ts +0 -395
  173. package/extensions/dm-subagents/src/runs/background/chain-append.ts +0 -282
  174. package/extensions/dm-subagents/src/runs/background/chain-root-attachment.ts +0 -191
  175. package/extensions/dm-subagents/src/runs/background/completion-batcher.ts +0 -166
  176. package/extensions/dm-subagents/src/runs/background/completion-dedupe.ts +0 -63
  177. package/extensions/dm-subagents/src/runs/background/control-channel.ts +0 -332
  178. package/extensions/dm-subagents/src/runs/background/fleet-view.ts +0 -515
  179. package/extensions/dm-subagents/src/runs/background/notify.ts +0 -225
  180. package/extensions/dm-subagents/src/runs/background/parallel-groups.ts +0 -45
  181. package/extensions/dm-subagents/src/runs/background/result-watcher.ts +0 -315
  182. package/extensions/dm-subagents/src/runs/background/run-id-resolver.ts +0 -84
  183. package/extensions/dm-subagents/src/runs/background/run-status.ts +0 -434
  184. package/extensions/dm-subagents/src/runs/background/scheduled-runs.ts +0 -514
  185. package/extensions/dm-subagents/src/runs/background/stale-run-reconciler.ts +0 -368
  186. package/extensions/dm-subagents/src/runs/background/subagent-runner.ts +0 -3171
  187. package/extensions/dm-subagents/src/runs/background/top-level-async.ts +0 -13
  188. package/extensions/dm-subagents/src/runs/background/wait.ts +0 -353
  189. package/extensions/dm-subagents/src/runs/foreground/chain-clarify.ts +0 -1333
  190. package/extensions/dm-subagents/src/runs/foreground/chain-execution.ts +0 -1313
  191. package/extensions/dm-subagents/src/runs/foreground/execution.ts +0 -1239
  192. package/extensions/dm-subagents/src/runs/foreground/subagent-executor.ts +0 -3613
  193. package/extensions/dm-subagents/src/runs/shared/acceptance.ts +0 -879
  194. package/extensions/dm-subagents/src/runs/shared/chain-outputs.ts +0 -116
  195. package/extensions/dm-subagents/src/runs/shared/completion-guard.ts +0 -147
  196. package/extensions/dm-subagents/src/runs/shared/dm-args.ts +0 -271
  197. package/extensions/dm-subagents/src/runs/shared/dm-spawn.ts +0 -147
  198. package/extensions/dm-subagents/src/runs/shared/dynamic-fanout.ts +0 -295
  199. package/extensions/dm-subagents/src/runs/shared/long-running-guard.ts +0 -175
  200. package/extensions/dm-subagents/src/runs/shared/mcp-direct-tool-allowlist.ts +0 -365
  201. package/extensions/dm-subagents/src/runs/shared/model-fallback.ts +0 -292
  202. package/extensions/dm-subagents/src/runs/shared/model-scope.ts +0 -128
  203. package/extensions/dm-subagents/src/runs/shared/nested-events.ts +0 -908
  204. package/extensions/dm-subagents/src/runs/shared/nested-path.ts +0 -52
  205. package/extensions/dm-subagents/src/runs/shared/nested-render.ts +0 -115
  206. package/extensions/dm-subagents/src/runs/shared/parallel-utils.ts +0 -198
  207. package/extensions/dm-subagents/src/runs/shared/run-history.ts +0 -60
  208. package/extensions/dm-subagents/src/runs/shared/single-output.ts +0 -180
  209. package/extensions/dm-subagents/src/runs/shared/structured-output.ts +0 -77
  210. package/extensions/dm-subagents/src/runs/shared/subagent-control.ts +0 -223
  211. package/extensions/dm-subagents/src/runs/shared/subagent-prompt-runtime.ts +0 -342
  212. package/extensions/dm-subagents/src/runs/shared/tool-budget.ts +0 -74
  213. package/extensions/dm-subagents/src/runs/shared/turn-budget.ts +0 -52
  214. package/extensions/dm-subagents/src/runs/shared/workflow-graph.ts +0 -206
  215. package/extensions/dm-subagents/src/runs/shared/worktree.ts +0 -600
  216. package/extensions/dm-subagents/src/shared/artifacts.ts +0 -113
  217. package/extensions/dm-subagents/src/shared/atomic-json.ts +0 -86
  218. package/extensions/dm-subagents/src/shared/child-transcript.ts +0 -212
  219. package/extensions/dm-subagents/src/shared/file-coalescer.ts +0 -40
  220. package/extensions/dm-subagents/src/shared/fork-context.ts +0 -194
  221. package/extensions/dm-subagents/src/shared/formatters.ts +0 -133
  222. package/extensions/dm-subagents/src/shared/jsonl-writer.ts +0 -81
  223. package/extensions/dm-subagents/src/shared/model-info.ts +0 -78
  224. package/extensions/dm-subagents/src/shared/post-exit-stdio-guard.ts +0 -85
  225. package/extensions/dm-subagents/src/shared/session-identity.ts +0 -10
  226. package/extensions/dm-subagents/src/shared/session-tokens.ts +0 -44
  227. package/extensions/dm-subagents/src/shared/settings.ts +0 -450
  228. package/extensions/dm-subagents/src/shared/status-format.ts +0 -49
  229. package/extensions/dm-subagents/src/shared/types.ts +0 -1257
  230. package/extensions/dm-subagents/src/shared/utils.ts +0 -554
  231. package/extensions/dm-subagents/src/slash/prompt-template-bridge.ts +0 -420
  232. package/extensions/dm-subagents/src/slash/prompt-workflows.ts +0 -330
  233. package/extensions/dm-subagents/src/slash/slash-bridge.ts +0 -176
  234. package/extensions/dm-subagents/src/slash/slash-commands.ts +0 -1296
  235. package/extensions/dm-subagents/src/slash/slash-live-state.ts +0 -292
  236. package/extensions/dm-subagents/src/tui/render-helpers.ts +0 -80
  237. package/extensions/dm-subagents/src/tui/render.ts +0 -1748
  238. package/extensions/dm-tasks/src/auto-clear.ts +0 -91
  239. package/extensions/dm-tasks/src/index.ts +0 -1145
  240. package/extensions/dm-tasks/src/process-tracker.ts +0 -140
  241. package/extensions/dm-tasks/src/task-store.ts +0 -305
  242. package/extensions/dm-tasks/src/tasks-config.ts +0 -23
  243. package/extensions/dm-tasks/src/types.ts +0 -40
  244. package/extensions/dm-tasks/src/ui/settings-menu.ts +0 -100
  245. package/extensions/dm-tasks/src/ui/task-widget.ts +0 -265
  246. package/extensions/dm-usage/index.ts +0 -1718
  247. package/extensions/greedysearch-dm/index.ts +0 -177
  248. package/extensions/greedysearch-dm/src/formatters/results.ts +0 -163
  249. package/extensions/greedysearch-dm/src/formatters/sources.ts +0 -116
  250. package/extensions/greedysearch-dm/src/formatters/synthesis.ts +0 -87
  251. package/extensions/greedysearch-dm/src/tools/greedy-search-handler.ts +0 -370
  252. package/extensions/greedysearch-dm/src/tools/shared.ts +0 -187
  253. package/extensions/greedysearch-dm/src/types.ts +0 -110
  254. package/extensions/greedysearch-dm/src/utils/helpers.ts +0 -40
@@ -1,450 +0,0 @@
1
- /**
2
- * Chain behavior, template resolution, and directory management
3
- */
4
-
5
- import * as fs from "node:fs";
6
- import * as path from "node:path";
7
- import type { AgentConfig } from "../agents/agents.ts";
8
- import { normalizeSkillInput } from "../agents/skills.ts";
9
- import { CHAIN_RUNS_DIR, type AcceptanceInput, type JsonSchemaObject, type OutputMode, type ToolBudgetConfig } from "./types.ts";
10
- const CHAIN_DIR_MAX_AGE_MS = 24 * 60 * 60 * 1000; // 24 hours
11
- const INITIAL_PROGRESS_CONTENT = "# Progress\n\n## Status\nIn Progress\n\n## Tasks\n\n## Files Changed\n\n## Notes\n";
12
-
13
- // =============================================================================
14
- // Behavior Resolution Types
15
- // =============================================================================
16
-
17
- export interface ResolvedStepBehavior {
18
- output: string | false;
19
- outputMode: OutputMode;
20
- reads: string[] | false;
21
- progress: boolean;
22
- skills: string[] | false;
23
- model?: string;
24
- }
25
-
26
- export interface StepOverrides {
27
- output?: string | false;
28
- outputMode?: OutputMode;
29
- reads?: string[] | false;
30
- progress?: boolean;
31
- skills?: string[] | false;
32
- model?: string;
33
- }
34
-
35
- function normalizeOutputOverride(output: string | false | undefined): string | false | undefined {
36
- return output === "false" ? false : output;
37
- }
38
-
39
- // =============================================================================
40
- // Chain Step Types
41
- // =============================================================================
42
-
43
- /** Sequential step: single agent execution */
44
- export interface SequentialStep {
45
- agent: string;
46
- task?: string;
47
- phase?: string;
48
- label?: string;
49
- as?: string;
50
- outputSchema?: JsonSchemaObject;
51
- cwd?: string;
52
- output?: string | false;
53
- outputMode?: OutputMode;
54
- reads?: string[] | false;
55
- progress?: boolean;
56
- skill?: string | string[] | false;
57
- model?: string;
58
- toolBudget?: ToolBudgetConfig;
59
- acceptance?: AcceptanceInput;
60
- }
61
-
62
- /** Parallel task item within a parallel step */
63
- export interface ParallelTaskItem {
64
- agent: string;
65
- task?: string;
66
- phase?: string;
67
- label?: string;
68
- as?: string;
69
- outputSchema?: JsonSchemaObject;
70
- cwd?: string;
71
- count?: number;
72
- output?: string | false;
73
- outputMode?: OutputMode;
74
- reads?: string[] | false;
75
- progress?: boolean;
76
- skill?: string | string[] | false;
77
- model?: string;
78
- toolBudget?: ToolBudgetConfig;
79
- acceptance?: AcceptanceInput;
80
- }
81
-
82
- export interface DynamicExpandSpec {
83
- from: {
84
- output: string;
85
- path: string;
86
- };
87
- item?: string;
88
- key?: string;
89
- maxItems?: number;
90
- onEmpty?: "skip" | "fail";
91
- }
92
-
93
- export type DynamicParallelTemplate = Omit<ParallelTaskItem, "as" | "count">;
94
-
95
- export interface DynamicCollectSpec {
96
- as: string;
97
- outputSchema?: JsonSchemaObject;
98
- }
99
-
100
- export interface DynamicParallelStep {
101
- expand: DynamicExpandSpec;
102
- parallel: DynamicParallelTemplate;
103
- collect: DynamicCollectSpec;
104
- concurrency?: number;
105
- failFast?: boolean;
106
- phase?: string;
107
- label?: string;
108
- acceptance?: AcceptanceInput;
109
- }
110
-
111
- /** Parallel step: multiple agents running concurrently */
112
- export interface ParallelStep {
113
- parallel: ParallelTaskItem[];
114
- concurrency?: number;
115
- failFast?: boolean;
116
- worktree?: boolean;
117
- cwd?: string;
118
- }
119
-
120
- /** Union type for chain steps */
121
- export type ChainStep = SequentialStep | ParallelStep | DynamicParallelStep;
122
-
123
- // =============================================================================
124
- // Type Guards
125
- // =============================================================================
126
-
127
- export function isParallelStep(step: ChainStep): step is ParallelStep {
128
- return "parallel" in step && Array.isArray((step as ParallelStep).parallel);
129
- }
130
-
131
- export function isDynamicParallelStep(step: ChainStep): step is DynamicParallelStep {
132
- return "expand" in step && "collect" in step && "parallel" in step && !Array.isArray((step as { parallel?: unknown }).parallel);
133
- }
134
-
135
- /** Get all agent names in a step (single for sequential, multiple for parallel) */
136
- export function getStepAgents(step: ChainStep): string[] {
137
- if (isParallelStep(step)) {
138
- return step.parallel.map((t) => t.agent);
139
- }
140
- if (isDynamicParallelStep(step)) {
141
- return [step.parallel.agent];
142
- }
143
- return [step.agent];
144
- }
145
-
146
- // =============================================================================
147
- // Chain Directory Management
148
- // =============================================================================
149
-
150
- export function createChainDir(runId: string, baseDir?: string): string {
151
- const chainDir = path.join(baseDir ? path.resolve(baseDir) : CHAIN_RUNS_DIR, runId);
152
- fs.mkdirSync(chainDir, { recursive: true });
153
- return chainDir;
154
- }
155
-
156
- export function removeChainDir(chainDir: string): void {
157
- try {
158
- fs.rmSync(chainDir, { recursive: true });
159
- } catch {
160
- // Chain cleanup is best-effort. Runs can already have cleaned their temp dir.
161
- }
162
- }
163
-
164
- export function cleanupOldChainDirs(): void {
165
- if (!fs.existsSync(CHAIN_RUNS_DIR)) return;
166
- const now = Date.now();
167
- let dirs: string[];
168
- try {
169
- dirs = fs.readdirSync(CHAIN_RUNS_DIR);
170
- } catch {
171
- // Startup cleanup is best-effort. If the scoped temp root is unreadable,
172
- // skip cleanup instead of failing extension startup.
173
- return;
174
- }
175
-
176
- for (const dir of dirs) {
177
- try {
178
- const dirPath = path.join(CHAIN_RUNS_DIR, dir);
179
- const stat = fs.statSync(dirPath);
180
- if (stat.isDirectory() && now - stat.mtimeMs > CHAIN_DIR_MAX_AGE_MS) {
181
- fs.rmSync(dirPath, { recursive: true });
182
- }
183
- } catch {
184
- // Skip directories that can't be processed; continue with others
185
- }
186
- }
187
- }
188
-
189
- // =============================================================================
190
- // Template Resolution
191
- // =============================================================================
192
-
193
- /** Resolved templates for a chain - string for sequential, string[] for parallel */
194
- export type ResolvedTemplates = (string | string[])[];
195
-
196
- /**
197
- * Resolve templates for a chain with parallel step support.
198
- * Returns string for sequential steps, string[] for parallel steps.
199
- */
200
- export function resolveChainTemplates(
201
- steps: ChainStep[],
202
- ): ResolvedTemplates {
203
- return steps.map((step, i) => {
204
- if (isParallelStep(step)) {
205
- // Parallel step: resolve each task's template
206
- return step.parallel.map((task) => {
207
- if (task.task) return task.task;
208
- // Default for parallel tasks is {previous}
209
- return "{previous}";
210
- });
211
- }
212
- if (isDynamicParallelStep(step)) {
213
- return step.parallel.task ?? "{previous}";
214
- }
215
- // Sequential step: existing logic
216
- const seq = step as SequentialStep;
217
- if (seq.task) return seq.task;
218
- // Default: first step uses {task}, others use {previous}
219
- return i === 0 ? "{task}" : "{previous}";
220
- });
221
- }
222
-
223
- // =============================================================================
224
- // Behavior Resolution
225
- // =============================================================================
226
-
227
- /**
228
- * Resolve effective chain behavior per step.
229
- * Priority: step override > agent frontmatter > false (disabled)
230
- */
231
- export function resolveStepBehavior(
232
- agentConfig: AgentConfig,
233
- stepOverrides: StepOverrides,
234
- chainSkills?: string[],
235
- ): ResolvedStepBehavior {
236
- // Output: step override > frontmatter > false (no output)
237
- const stepOutput = normalizeOutputOverride(stepOverrides.output);
238
- const output =
239
- stepOutput !== undefined
240
- ? stepOutput
241
- : normalizeOutputOverride(agentConfig.output) ?? false;
242
-
243
- // Reads: step override > frontmatter defaultReads > false (no reads)
244
- const reads =
245
- stepOverrides.reads !== undefined
246
- ? stepOverrides.reads
247
- : agentConfig.defaultReads ?? false;
248
-
249
- // Progress: step override > frontmatter defaultProgress > false
250
- const progress =
251
- stepOverrides.progress !== undefined
252
- ? stepOverrides.progress
253
- : agentConfig.defaultProgress ?? false;
254
-
255
- let skills: string[] | false;
256
- if (stepOverrides.skills === false) {
257
- skills = false;
258
- } else if (stepOverrides.skills !== undefined) {
259
- skills = [...stepOverrides.skills];
260
- if (chainSkills && chainSkills.length > 0) {
261
- skills = [...new Set([...skills, ...chainSkills])];
262
- }
263
- } else {
264
- skills = agentConfig.skills ? [...agentConfig.skills] : [];
265
- if (chainSkills && chainSkills.length > 0) {
266
- skills = [...new Set([...skills, ...chainSkills])];
267
- }
268
- }
269
-
270
- const outputMode = stepOverrides.outputMode ?? "inline";
271
- const model = stepOverrides.model ?? agentConfig.model;
272
- return { output, outputMode, reads, progress, skills, model };
273
- }
274
-
275
- export function resolveTaskTextForFileUpdatePolicy(task: string | undefined, originalTask?: string): string | undefined {
276
- if (!task) return originalTask;
277
- return originalTask ? task.replaceAll("{task}", originalTask) : task;
278
- }
279
-
280
- export function taskDisallowsFileUpdates(task: string | undefined): boolean {
281
- if (!task) return false;
282
- return /\breview[- ]only\b/i.test(task)
283
- || /\bread[- ]only\s+(?:review|audit|inspection|pass)\b/i.test(task)
284
- || /\b(?:no|without)\s+(?:file\s+)?edits?\b/i.test(task)
285
- || /\b(?:do not|don't|must not)\s+(?:edit|modify|write|touch)\b/i.test(task)
286
- || /\bleave\s+files?\s+unchanged\b/i.test(task);
287
- }
288
-
289
- export function suppressProgressForReadOnlyTask(behavior: ResolvedStepBehavior, task: string | undefined, originalTask?: string): ResolvedStepBehavior {
290
- const policyTask = resolveTaskTextForFileUpdatePolicy(task, originalTask);
291
- return behavior.progress && taskDisallowsFileUpdates(policyTask) ? { ...behavior, progress: false } : behavior;
292
- }
293
-
294
- // =============================================================================
295
- // Chain Instruction Injection
296
- // =============================================================================
297
-
298
- /**
299
- * Resolve a file path: absolute paths pass through, relative paths get chainDir prepended.
300
- */
301
- function resolveChainPath(filePath: string, chainDir: string): string {
302
- return path.isAbsolute(filePath) ? filePath : path.join(chainDir, filePath);
303
- }
304
-
305
- /**
306
- * Build chain instructions from resolved behavior.
307
- * These are appended to the task to tell the agent what to read/write.
308
- */
309
- export function writeInitialProgressFile(progressDir: string): void {
310
- fs.mkdirSync(progressDir, { recursive: true });
311
- fs.writeFileSync(path.join(progressDir, "progress.md"), INITIAL_PROGRESS_CONTENT);
312
- }
313
-
314
- export function buildChainInstructions(
315
- behavior: ResolvedStepBehavior,
316
- chainDir: string,
317
- isFirstProgressAgent: boolean,
318
- previousSummary?: string,
319
- ): { prefix: string; suffix: string } {
320
- const prefixParts: string[] = [];
321
- const suffixParts: string[] = [];
322
-
323
- // READS - prepend to override any hardcoded filenames in task text
324
- if (behavior.reads && behavior.reads.length > 0) {
325
- const files = behavior.reads.map((f) => resolveChainPath(f, chainDir));
326
- prefixParts.push(`[Read from: ${files.join(", ")}]`);
327
- }
328
-
329
- // OUTPUT - prepend so agent knows where to write
330
- if (behavior.output) {
331
- const outputPath = resolveChainPath(behavior.output, chainDir);
332
- prefixParts.push(`[Write to: ${outputPath}]`);
333
- }
334
-
335
- // Progress instructions in suffix (less critical)
336
- if (behavior.progress) {
337
- const progressPath = path.join(chainDir, "progress.md");
338
- if (isFirstProgressAgent) {
339
- suffixParts.push(`Create and maintain progress at: ${progressPath}`);
340
- } else {
341
- suffixParts.push(`Update progress at: ${progressPath}`);
342
- }
343
- }
344
-
345
- // Include previous step's summary in suffix if available
346
- if (previousSummary && previousSummary.trim()) {
347
- suffixParts.push(`Previous step output:\n${previousSummary.trim()}`);
348
- }
349
-
350
- const prefix = prefixParts.length > 0
351
- ? prefixParts.join("\n") + "\n\n"
352
- : "";
353
-
354
- const suffix = suffixParts.length > 0
355
- ? "\n\n---\n" + suffixParts.join("\n")
356
- : "";
357
-
358
- return { prefix, suffix };
359
- }
360
-
361
- // =============================================================================
362
- // Parallel Step Support
363
- // =============================================================================
364
-
365
- /**
366
- * Resolve behaviors for all tasks in a parallel step.
367
- * Creates namespaced output paths to avoid collisions.
368
- */
369
- export function resolveParallelBehaviors(
370
- tasks: ParallelTaskItem[],
371
- agentConfigs: AgentConfig[],
372
- stepIndex: number,
373
- chainSkills?: string[],
374
- ): ResolvedStepBehavior[] {
375
- return tasks.map((task, taskIndex) => {
376
- const config = agentConfigs.find((a) => a.name === task.agent);
377
- if (!config) {
378
- throw new Error(`Unknown agent: ${task.agent}`);
379
- }
380
-
381
- // Build subdirectory path for this parallel task
382
- const subdir = path.join(`parallel-${stepIndex}`, `${taskIndex}-${task.agent}`);
383
-
384
- // Output: task override > agent default (namespaced) > false
385
- // Absolute paths pass through unchanged; relative paths get namespaced under subdir
386
- let output: string | false = false;
387
- const taskOutput = normalizeOutputOverride(task.output);
388
- const configOutput = normalizeOutputOverride(config.output);
389
- if (taskOutput !== undefined) {
390
- if (taskOutput === false) {
391
- output = false;
392
- } else if (path.isAbsolute(taskOutput)) {
393
- output = taskOutput; // Absolute path: use as-is
394
- } else {
395
- output = path.join(subdir, taskOutput); // Relative: namespace under subdir
396
- }
397
- } else if (configOutput) {
398
- // Agent defaults are always relative, so namespace them
399
- output = path.join(subdir, configOutput);
400
- }
401
-
402
- // Reads: task override > agent default > false
403
- const reads =
404
- task.reads !== undefined ? task.reads : config.defaultReads ?? false;
405
-
406
- // Progress: task override > agent default > false
407
- const progress =
408
- task.progress !== undefined
409
- ? task.progress
410
- : config.defaultProgress ?? false;
411
-
412
- const taskSkillInput = normalizeSkillInput(task.skill);
413
- let skills: string[] | false;
414
- if (taskSkillInput === false) {
415
- skills = false;
416
- } else if (taskSkillInput !== undefined) {
417
- skills = [...taskSkillInput];
418
- if (chainSkills && chainSkills.length > 0) {
419
- skills = [...new Set([...skills, ...chainSkills])];
420
- }
421
- } else {
422
- skills = config.skills ? [...config.skills] : [];
423
- if (chainSkills && chainSkills.length > 0) {
424
- skills = [...new Set([...skills, ...chainSkills])];
425
- }
426
- }
427
-
428
- const outputMode = task.outputMode ?? "inline";
429
- const model = task.model ?? config.model;
430
- return { output, outputMode, reads, progress, skills, model };
431
- });
432
- }
433
-
434
- /**
435
- * Create subdirectories for parallel step outputs
436
- */
437
- export function createParallelDirs(
438
- chainDir: string,
439
- stepIndex: number,
440
- taskCount: number,
441
- agentNames: string[],
442
- ): void {
443
- for (let i = 0; i < taskCount; i++) {
444
- const subdir = path.join(chainDir, `parallel-${stepIndex}`, `${i}-${agentNames[i]}`);
445
- fs.mkdirSync(subdir, { recursive: true });
446
- }
447
- }
448
-
449
- export type { ParallelTaskResult } from "../runs/shared/parallel-utils.ts";
450
- export { aggregateParallelOutputs } from "../runs/shared/parallel-utils.ts";
@@ -1,49 +0,0 @@
1
- import type { ActivityState, AsyncJobStep } from "./types.ts";
2
-
3
- type StepStatusLike = Pick<AsyncJobStep, "status">;
4
-
5
- function formatActivityAge(ms: number): string {
6
- if (ms < 1000) return "now";
7
- if (ms < 60000) return `${Math.floor(ms / 1000)}s`;
8
- return `${Math.floor(ms / 60000)}m`;
9
- }
10
-
11
- export function formatActivityLabel(lastActivityAt: number | undefined, activityState?: ActivityState, now = Date.now()): string | undefined {
12
- if (lastActivityAt === undefined) {
13
- if (activityState === "needs_attention") return "needs attention";
14
- if (activityState === "active_long_running") return "active but long-running";
15
- return undefined;
16
- }
17
- const age = formatActivityAge(Math.max(0, now - lastActivityAt));
18
- if (activityState === "needs_attention") return `no activity for ${age}`;
19
- if (activityState === "active_long_running") return `active but long-running · last activity ${age} ago`;
20
- return age === "now" ? "active now" : `active ${age} ago`;
21
- }
22
-
23
- function isCompletedStepStatus(status: AsyncJobStep["status"]): boolean {
24
- return status === "complete" || status === "completed";
25
- }
26
-
27
- export function aggregateStepStatus(steps: StepStatusLike[]): AsyncJobStep["status"] {
28
- if (steps.some((step) => step.status === "running")) return "running";
29
- if (steps.some((step) => step.status === "failed")) return "failed";
30
- if (steps.some((step) => step.status === "paused")) return "paused";
31
- if (steps.length > 0 && steps.every((step) => isCompletedStepStatus(step.status))) return "complete";
32
- return "pending";
33
- }
34
-
35
- export function formatAgentRunningLabel(count: number): string {
36
- return count === 1 ? "1 agent running" : `${count} agents running`;
37
- }
38
-
39
- export function formatParallelOutcome(steps: StepStatusLike[], total: number, options: { showRunning?: boolean } = {}): string {
40
- const running = steps.filter((step) => step.status === "running").length;
41
- const done = steps.filter((step) => isCompletedStepStatus(step.status)).length;
42
- const failed = steps.filter((step) => step.status === "failed").length;
43
- const paused = steps.filter((step) => step.status === "paused").length;
44
- const parts = [`${done}/${total} done`];
45
- if (options.showRunning !== false && running > 0) parts.unshift(formatAgentRunningLabel(running));
46
- if (failed > 0) parts.push(`${failed} failed`);
47
- if (paused > 0) parts.push(`${paused} paused`);
48
- return parts.join(" · ");
49
- }