@duckmind/dm-darwin-x64 0.43.2 → 0.43.8

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 (256) hide show
  1. package/dm +0 -0
  2. package/extensions/.dm-extensions.json +242 -49
  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 +135 -135
  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/engines.mjs +9 -9
  132. package/extensions/greedysearch-dm/src/search/paths.mjs +1 -0
  133. package/extensions/greedysearch-dm/src/search/research.mjs +100 -100
  134. package/extensions/greedysearch-dm/src/search/synthesis-runner.mjs +10 -10
  135. package/extensions/greedysearch-dm/src/tools/greedy-search-handler.js +20 -0
  136. package/extensions/greedysearch-dm/src/tools/shared.js +9 -0
  137. package/extensions/greedysearch-dm/src/types.js +0 -0
  138. package/extensions/greedysearch-dm/src/utils/helpers.js +1 -0
  139. package/package.json +1 -1
  140. package/extensions/dm-9router-ext/src/index.ts +0 -541
  141. package/extensions/dm-ask-user/index.ts +0 -857
  142. package/extensions/dm-context/src/context.ts +0 -158
  143. package/extensions/dm-context/src/index.ts +0 -439
  144. package/extensions/dm-context/src/utils.ts +0 -6
  145. package/extensions/dm-fff/src/index.ts +0 -1023
  146. package/extensions/dm-fff/src/query.ts +0 -87
  147. package/extensions/dm-goal/src/goal.ts +0 -1073
  148. package/extensions/dm-grill-me/index.ts +0 -1085
  149. package/extensions/dm-subagents/src/agents/agent-management.ts +0 -1052
  150. package/extensions/dm-subagents/src/agents/agent-memory.ts +0 -254
  151. package/extensions/dm-subagents/src/agents/agent-scope.ts +0 -6
  152. package/extensions/dm-subagents/src/agents/agent-selection.ts +0 -25
  153. package/extensions/dm-subagents/src/agents/agent-serializer.ts +0 -121
  154. package/extensions/dm-subagents/src/agents/agents.ts +0 -1553
  155. package/extensions/dm-subagents/src/agents/chain-serializer.ts +0 -277
  156. package/extensions/dm-subagents/src/agents/frontmatter.ts +0 -93
  157. package/extensions/dm-subagents/src/agents/identity.ts +0 -30
  158. package/extensions/dm-subagents/src/agents/proactive-skills.ts +0 -191
  159. package/extensions/dm-subagents/src/agents/skills.ts +0 -729
  160. package/extensions/dm-subagents/src/extension/config.ts +0 -39
  161. package/extensions/dm-subagents/src/extension/control-notices.ts +0 -92
  162. package/extensions/dm-subagents/src/extension/doctor.ts +0 -214
  163. package/extensions/dm-subagents/src/extension/fanout-child.ts +0 -172
  164. package/extensions/dm-subagents/src/extension/index.ts +0 -656
  165. package/extensions/dm-subagents/src/extension/rpc.ts +0 -369
  166. package/extensions/dm-subagents/src/extension/schemas.ts +0 -309
  167. package/extensions/dm-subagents/src/intercom/intercom-bridge.ts +0 -180
  168. package/extensions/dm-subagents/src/intercom/native-supervisor-channel.ts +0 -519
  169. package/extensions/dm-subagents/src/intercom/result-intercom.ts +0 -377
  170. package/extensions/dm-subagents/src/profiles/profiles.ts +0 -637
  171. package/extensions/dm-subagents/src/runs/background/async-execution.ts +0 -1065
  172. package/extensions/dm-subagents/src/runs/background/async-job-tracker.ts +0 -441
  173. package/extensions/dm-subagents/src/runs/background/async-resume.ts +0 -391
  174. package/extensions/dm-subagents/src/runs/background/async-status.ts +0 -395
  175. package/extensions/dm-subagents/src/runs/background/chain-append.ts +0 -282
  176. package/extensions/dm-subagents/src/runs/background/chain-root-attachment.ts +0 -191
  177. package/extensions/dm-subagents/src/runs/background/completion-batcher.ts +0 -166
  178. package/extensions/dm-subagents/src/runs/background/completion-dedupe.ts +0 -63
  179. package/extensions/dm-subagents/src/runs/background/control-channel.ts +0 -332
  180. package/extensions/dm-subagents/src/runs/background/fleet-view.ts +0 -515
  181. package/extensions/dm-subagents/src/runs/background/notify.ts +0 -225
  182. package/extensions/dm-subagents/src/runs/background/parallel-groups.ts +0 -45
  183. package/extensions/dm-subagents/src/runs/background/result-watcher.ts +0 -315
  184. package/extensions/dm-subagents/src/runs/background/run-id-resolver.ts +0 -84
  185. package/extensions/dm-subagents/src/runs/background/run-status.ts +0 -434
  186. package/extensions/dm-subagents/src/runs/background/scheduled-runs.ts +0 -514
  187. package/extensions/dm-subagents/src/runs/background/stale-run-reconciler.ts +0 -368
  188. package/extensions/dm-subagents/src/runs/background/subagent-runner.ts +0 -3171
  189. package/extensions/dm-subagents/src/runs/background/top-level-async.ts +0 -13
  190. package/extensions/dm-subagents/src/runs/background/wait.ts +0 -353
  191. package/extensions/dm-subagents/src/runs/foreground/chain-clarify.ts +0 -1333
  192. package/extensions/dm-subagents/src/runs/foreground/chain-execution.ts +0 -1313
  193. package/extensions/dm-subagents/src/runs/foreground/execution.ts +0 -1239
  194. package/extensions/dm-subagents/src/runs/foreground/subagent-executor.ts +0 -3613
  195. package/extensions/dm-subagents/src/runs/shared/acceptance.ts +0 -879
  196. package/extensions/dm-subagents/src/runs/shared/chain-outputs.ts +0 -116
  197. package/extensions/dm-subagents/src/runs/shared/completion-guard.ts +0 -147
  198. package/extensions/dm-subagents/src/runs/shared/dm-args.ts +0 -271
  199. package/extensions/dm-subagents/src/runs/shared/dm-spawn.ts +0 -147
  200. package/extensions/dm-subagents/src/runs/shared/dynamic-fanout.ts +0 -295
  201. package/extensions/dm-subagents/src/runs/shared/long-running-guard.ts +0 -175
  202. package/extensions/dm-subagents/src/runs/shared/mcp-direct-tool-allowlist.ts +0 -365
  203. package/extensions/dm-subagents/src/runs/shared/model-fallback.ts +0 -292
  204. package/extensions/dm-subagents/src/runs/shared/model-scope.ts +0 -128
  205. package/extensions/dm-subagents/src/runs/shared/nested-events.ts +0 -908
  206. package/extensions/dm-subagents/src/runs/shared/nested-path.ts +0 -52
  207. package/extensions/dm-subagents/src/runs/shared/nested-render.ts +0 -115
  208. package/extensions/dm-subagents/src/runs/shared/parallel-utils.ts +0 -198
  209. package/extensions/dm-subagents/src/runs/shared/run-history.ts +0 -60
  210. package/extensions/dm-subagents/src/runs/shared/single-output.ts +0 -180
  211. package/extensions/dm-subagents/src/runs/shared/structured-output.ts +0 -77
  212. package/extensions/dm-subagents/src/runs/shared/subagent-control.ts +0 -223
  213. package/extensions/dm-subagents/src/runs/shared/subagent-prompt-runtime.ts +0 -342
  214. package/extensions/dm-subagents/src/runs/shared/tool-budget.ts +0 -74
  215. package/extensions/dm-subagents/src/runs/shared/turn-budget.ts +0 -52
  216. package/extensions/dm-subagents/src/runs/shared/workflow-graph.ts +0 -206
  217. package/extensions/dm-subagents/src/runs/shared/worktree.ts +0 -600
  218. package/extensions/dm-subagents/src/shared/artifacts.ts +0 -113
  219. package/extensions/dm-subagents/src/shared/atomic-json.ts +0 -86
  220. package/extensions/dm-subagents/src/shared/child-transcript.ts +0 -212
  221. package/extensions/dm-subagents/src/shared/file-coalescer.ts +0 -40
  222. package/extensions/dm-subagents/src/shared/fork-context.ts +0 -194
  223. package/extensions/dm-subagents/src/shared/formatters.ts +0 -133
  224. package/extensions/dm-subagents/src/shared/jsonl-writer.ts +0 -81
  225. package/extensions/dm-subagents/src/shared/model-info.ts +0 -78
  226. package/extensions/dm-subagents/src/shared/post-exit-stdio-guard.ts +0 -85
  227. package/extensions/dm-subagents/src/shared/session-identity.ts +0 -10
  228. package/extensions/dm-subagents/src/shared/session-tokens.ts +0 -44
  229. package/extensions/dm-subagents/src/shared/settings.ts +0 -450
  230. package/extensions/dm-subagents/src/shared/status-format.ts +0 -49
  231. package/extensions/dm-subagents/src/shared/types.ts +0 -1257
  232. package/extensions/dm-subagents/src/shared/utils.ts +0 -554
  233. package/extensions/dm-subagents/src/slash/prompt-template-bridge.ts +0 -420
  234. package/extensions/dm-subagents/src/slash/prompt-workflows.ts +0 -330
  235. package/extensions/dm-subagents/src/slash/slash-bridge.ts +0 -176
  236. package/extensions/dm-subagents/src/slash/slash-commands.ts +0 -1296
  237. package/extensions/dm-subagents/src/slash/slash-live-state.ts +0 -292
  238. package/extensions/dm-subagents/src/tui/render-helpers.ts +0 -80
  239. package/extensions/dm-subagents/src/tui/render.ts +0 -1748
  240. package/extensions/dm-tasks/src/auto-clear.ts +0 -91
  241. package/extensions/dm-tasks/src/index.ts +0 -1145
  242. package/extensions/dm-tasks/src/process-tracker.ts +0 -140
  243. package/extensions/dm-tasks/src/task-store.ts +0 -305
  244. package/extensions/dm-tasks/src/tasks-config.ts +0 -23
  245. package/extensions/dm-tasks/src/types.ts +0 -40
  246. package/extensions/dm-tasks/src/ui/settings-menu.ts +0 -100
  247. package/extensions/dm-tasks/src/ui/task-widget.ts +0 -265
  248. package/extensions/dm-usage/index.ts +0 -1718
  249. package/extensions/greedysearch-dm/index.ts +0 -177
  250. package/extensions/greedysearch-dm/src/formatters/results.ts +0 -163
  251. package/extensions/greedysearch-dm/src/formatters/sources.ts +0 -116
  252. package/extensions/greedysearch-dm/src/formatters/synthesis.ts +0 -87
  253. package/extensions/greedysearch-dm/src/tools/greedy-search-handler.ts +0 -370
  254. package/extensions/greedysearch-dm/src/tools/shared.ts +0 -187
  255. package/extensions/greedysearch-dm/src/types.ts +0 -110
  256. 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
- }