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