@draht/coding-agent 2026.10.4-3 → 2026.10.8-1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (246) hide show
  1. package/CHANGELOG.md +13 -0
  2. package/README.md +32 -6
  3. package/dist/bundle/chunks/anthropic.js +1 -1
  4. package/dist/bundle/chunks/{chunk-JTLUBTZT.js → chunk-6QIFWMDF.js} +1 -1
  5. package/dist/bundle/chunks/{chunk-AFL4IDSI.js → chunk-AHGUOQPH.js} +2 -2
  6. package/dist/bundle/chunks/{chunk-VPYAVQLP.js → chunk-BOGY4QVF.js} +4 -4
  7. package/dist/bundle/chunks/chunk-GD2WVXWT.js +65 -0
  8. package/dist/bundle/chunks/{chunk-3HF756LN.js → chunk-KJJJSTND.js} +292 -153
  9. package/dist/bundle/chunks/chunk-PGJAHC3R.js +107 -0
  10. package/dist/bundle/chunks/chunk-QVFELZW2.js +312 -0
  11. package/dist/bundle/chunks/{chunk-V5HG6S2T.js → chunk-QVTLBSTH.js} +1 -1
  12. package/dist/bundle/chunks/{chunk-A4OX5CPR.js → chunk-U6LDZZGM.js} +1 -1
  13. package/dist/bundle/chunks/{chunk-XO3IECI5.js → chunk-VQOV5VFH.js} +1 -1
  14. package/dist/bundle/chunks/{cli-L74YA5GF.js → cli-O6OWCY7N.js} +1 -1
  15. package/dist/bundle/chunks/execute-4JU5WQXP.js +18 -0
  16. package/dist/bundle/chunks/google-antigravity.js +1 -1
  17. package/dist/bundle/chunks/google-gemini-cli.js +1 -1
  18. package/dist/bundle/chunks/openai-chatgpt.js +1 -1
  19. package/dist/bundle/chunks/openai-codex.js +1 -1
  20. package/dist/bundle/chunks/openrouter.js +1 -1
  21. package/dist/bundle/chunks/radius.js +1 -1
  22. package/dist/bundle/chunks/{runtime-RYUR6LRB.js → runtime-FIGQHW75.js} +1 -1
  23. package/dist/bundle/chunks/runtime-TJ3EAMJK.js +3 -0
  24. package/dist/bundle/chunks/{settings-manager-CHEMMAGQ.js → settings-manager-HC5RR36T.js} +1 -1
  25. package/dist/bundle/chunks/virtual-modules-UIGTRGHQ.js +2 -0
  26. package/dist/bundle/chunks/xai.js +1 -1
  27. package/dist/bundle/cli-runtime.js +1 -1
  28. package/dist/bundle/index.js +1 -1
  29. package/dist/bundle/rpc-entry.js +1 -1
  30. package/dist/cli/args.js +3 -3
  31. package/dist/cli/args.js.map +1 -1
  32. package/dist/core/builtins/duet.d.ts +5 -2
  33. package/dist/core/builtins/duet.d.ts.map +1 -1
  34. package/dist/core/builtins/duet.js +65 -27
  35. package/dist/core/builtins/duet.js.map +1 -1
  36. package/dist/core/builtins/index.d.ts.map +1 -1
  37. package/dist/core/builtins/index.js +2 -0
  38. package/dist/core/builtins/index.js.map +1 -1
  39. package/dist/core/builtins/polyphase.d.ts +15 -0
  40. package/dist/core/builtins/polyphase.d.ts.map +1 -0
  41. package/dist/core/builtins/polyphase.js +196 -0
  42. package/dist/core/builtins/polyphase.js.map +1 -0
  43. package/dist/core/builtins/subagent.d.ts +44 -34
  44. package/dist/core/builtins/subagent.d.ts.map +1 -1
  45. package/dist/core/builtins/subagent.js +827 -560
  46. package/dist/core/builtins/subagent.js.map +1 -1
  47. package/dist/core/extensions/types.d.ts +17 -2
  48. package/dist/core/extensions/types.d.ts.map +1 -1
  49. package/dist/core/extensions/types.js.map +1 -1
  50. package/dist/core/keybindings.d.ts +30 -0
  51. package/dist/core/keybindings.d.ts.map +1 -1
  52. package/dist/core/keybindings.js +24 -0
  53. package/dist/core/keybindings.js.map +1 -1
  54. package/dist/core/model-resolver.js +4 -4
  55. package/dist/core/model-resolver.js.map +1 -1
  56. package/dist/core/multi-agent/permission-gate.d.ts.map +1 -1
  57. package/dist/core/multi-agent/permission-gate.js +4 -1
  58. package/dist/core/multi-agent/permission-gate.js.map +1 -1
  59. package/dist/core/polyphase/approval.d.ts +35 -0
  60. package/dist/core/polyphase/approval.d.ts.map +1 -0
  61. package/dist/core/polyphase/approval.js +184 -0
  62. package/dist/core/polyphase/approval.js.map +1 -0
  63. package/dist/core/polyphase/child-events.d.ts +107 -0
  64. package/dist/core/polyphase/child-events.d.ts.map +1 -0
  65. package/dist/core/polyphase/child-events.js +862 -0
  66. package/dist/core/polyphase/child-events.js.map +1 -0
  67. package/dist/core/polyphase/child-process.d.ts +65 -0
  68. package/dist/core/polyphase/child-process.d.ts.map +1 -0
  69. package/dist/core/polyphase/child-process.js +361 -0
  70. package/dist/core/polyphase/child-process.js.map +1 -0
  71. package/dist/core/polyphase/commands.d.ts +44 -0
  72. package/dist/core/polyphase/commands.d.ts.map +1 -0
  73. package/dist/core/polyphase/commands.js +244 -0
  74. package/dist/core/polyphase/commands.js.map +1 -0
  75. package/dist/core/polyphase/details.d.ts +40 -0
  76. package/dist/core/polyphase/details.d.ts.map +1 -0
  77. package/dist/core/polyphase/details.js +538 -0
  78. package/dist/core/polyphase/details.js.map +1 -0
  79. package/dist/core/polyphase/emitter.d.ts +20 -0
  80. package/dist/core/polyphase/emitter.d.ts.map +1 -0
  81. package/dist/core/polyphase/emitter.js +90 -0
  82. package/dist/core/polyphase/emitter.js.map +1 -0
  83. package/dist/core/polyphase/jsonl-reader.d.ts +31 -0
  84. package/dist/core/polyphase/jsonl-reader.d.ts.map +1 -0
  85. package/dist/core/polyphase/jsonl-reader.js +161 -0
  86. package/dist/core/polyphase/jsonl-reader.js.map +1 -0
  87. package/dist/core/polyphase/keyword.d.ts +27 -0
  88. package/dist/core/polyphase/keyword.d.ts.map +1 -0
  89. package/dist/core/polyphase/keyword.js +97 -0
  90. package/dist/core/polyphase/keyword.js.map +1 -0
  91. package/dist/core/polyphase/limiter.d.ts +38 -0
  92. package/dist/core/polyphase/limiter.d.ts.map +1 -0
  93. package/dist/core/polyphase/limiter.js +129 -0
  94. package/dist/core/polyphase/limiter.js.map +1 -0
  95. package/dist/core/polyphase/model-selection.d.ts +35 -0
  96. package/dist/core/polyphase/model-selection.d.ts.map +1 -0
  97. package/dist/core/polyphase/model-selection.js +72 -0
  98. package/dist/core/polyphase/model-selection.js.map +1 -0
  99. package/dist/core/polyphase/render/format.d.ts +52 -0
  100. package/dist/core/polyphase/render/format.d.ts.map +1 -0
  101. package/dist/core/polyphase/render/format.js +169 -0
  102. package/dist/core/polyphase/render/format.js.map +1 -0
  103. package/dist/core/polyphase/render/renderers.d.ts +63 -0
  104. package/dist/core/polyphase/render/renderers.d.ts.map +1 -0
  105. package/dist/core/polyphase/render/renderers.js +277 -0
  106. package/dist/core/polyphase/render/renderers.js.map +1 -0
  107. package/dist/core/polyphase/render/run-block.d.ts +45 -0
  108. package/dist/core/polyphase/render/run-block.d.ts.map +1 -0
  109. package/dist/core/polyphase/render/run-block.js +843 -0
  110. package/dist/core/polyphase/render/run-block.js.map +1 -0
  111. package/dist/core/polyphase/render/snapshot.d.ts +106 -0
  112. package/dist/core/polyphase/render/snapshot.d.ts.map +1 -0
  113. package/dist/core/polyphase/render/snapshot.js +292 -0
  114. package/dist/core/polyphase/render/snapshot.js.map +1 -0
  115. package/dist/core/polyphase/result-text.d.ts +41 -0
  116. package/dist/core/polyphase/result-text.d.ts.map +1 -0
  117. package/dist/core/polyphase/result-text.js +326 -0
  118. package/dist/core/polyphase/result-text.js.map +1 -0
  119. package/dist/core/polyphase/session.d.ts +33 -0
  120. package/dist/core/polyphase/session.d.ts.map +1 -0
  121. package/dist/core/polyphase/session.js +106 -0
  122. package/dist/core/polyphase/session.js.map +1 -0
  123. package/dist/core/polyphase/settings.d.ts +18 -0
  124. package/dist/core/polyphase/settings.d.ts.map +1 -0
  125. package/dist/core/polyphase/settings.js +93 -0
  126. package/dist/core/polyphase/settings.js.map +1 -0
  127. package/dist/core/polyphase/store.d.ts +197 -0
  128. package/dist/core/polyphase/store.d.ts.map +1 -0
  129. package/dist/core/polyphase/store.js +558 -0
  130. package/dist/core/polyphase/store.js.map +1 -0
  131. package/dist/core/polyphase/types.d.ts +371 -0
  132. package/dist/core/polyphase/types.d.ts.map +1 -0
  133. package/dist/core/polyphase/types.js +36 -0
  134. package/dist/core/polyphase/types.js.map +1 -0
  135. package/dist/core/polyphase/ui/controller.d.ts +28 -0
  136. package/dist/core/polyphase/ui/controller.d.ts.map +1 -0
  137. package/dist/core/polyphase/ui/controller.js +150 -0
  138. package/dist/core/polyphase/ui/controller.js.map +1 -0
  139. package/dist/core/polyphase/ui/dock.d.ts +27 -0
  140. package/dist/core/polyphase/ui/dock.d.ts.map +1 -0
  141. package/dist/core/polyphase/ui/dock.js +121 -0
  142. package/dist/core/polyphase/ui/dock.js.map +1 -0
  143. package/dist/core/polyphase/ui/inspector.d.ts +117 -0
  144. package/dist/core/polyphase/ui/inspector.d.ts.map +1 -0
  145. package/dist/core/polyphase/ui/inspector.js +1016 -0
  146. package/dist/core/polyphase/ui/inspector.js.map +1 -0
  147. package/dist/core/polyphase/ui/transcript-layout.d.ts +55 -0
  148. package/dist/core/polyphase/ui/transcript-layout.d.ts.map +1 -0
  149. package/dist/core/polyphase/ui/transcript-layout.js +210 -0
  150. package/dist/core/polyphase/ui/transcript-layout.js.map +1 -0
  151. package/dist/core/polyphase/update-pump.d.ts +18 -0
  152. package/dist/core/polyphase/update-pump.d.ts.map +1 -0
  153. package/dist/core/polyphase/update-pump.js +132 -0
  154. package/dist/core/polyphase/update-pump.js.map +1 -0
  155. package/dist/core/polyphase/workflow/agent-host.d.ts +26 -0
  156. package/dist/core/polyphase/workflow/agent-host.d.ts.map +1 -0
  157. package/dist/core/polyphase/workflow/agent-host.js +187 -0
  158. package/dist/core/polyphase/workflow/agent-host.js.map +1 -0
  159. package/dist/core/polyphase/workflow/guidance.d.ts +19 -0
  160. package/dist/core/polyphase/workflow/guidance.d.ts.map +1 -0
  161. package/dist/core/polyphase/workflow/guidance.js +119 -0
  162. package/dist/core/polyphase/workflow/guidance.js.map +1 -0
  163. package/dist/core/polyphase/workflow/launch.d.ts +41 -0
  164. package/dist/core/polyphase/workflow/launch.d.ts.map +1 -0
  165. package/dist/core/polyphase/workflow/launch.js +173 -0
  166. package/dist/core/polyphase/workflow/launch.js.map +1 -0
  167. package/dist/core/polyphase/workflow/meta.d.ts +43 -0
  168. package/dist/core/polyphase/workflow/meta.d.ts.map +1 -0
  169. package/dist/core/polyphase/workflow/meta.js +529 -0
  170. package/dist/core/polyphase/workflow/meta.js.map +1 -0
  171. package/dist/core/polyphase/workflow/prelude.d.ts +24 -0
  172. package/dist/core/polyphase/workflow/prelude.d.ts.map +1 -0
  173. package/dist/core/polyphase/workflow/prelude.js +93 -0
  174. package/dist/core/polyphase/workflow/prelude.js.map +1 -0
  175. package/dist/core/polyphase/workflow/runtime.d.ts +79 -0
  176. package/dist/core/polyphase/workflow/runtime.d.ts.map +1 -0
  177. package/dist/core/polyphase/workflow/runtime.js +217 -0
  178. package/dist/core/polyphase/workflow/runtime.js.map +1 -0
  179. package/dist/core/polyphase/workflow/runtime.lazy.d.ts +3 -0
  180. package/dist/core/polyphase/workflow/runtime.lazy.d.ts.map +1 -0
  181. package/dist/core/polyphase/workflow/runtime.lazy.js +3 -0
  182. package/dist/core/polyphase/workflow/runtime.lazy.js.map +1 -0
  183. package/dist/core/polyphase/workflow/saved.d.ts +55 -0
  184. package/dist/core/polyphase/workflow/saved.d.ts.map +1 -0
  185. package/dist/core/polyphase/workflow/saved.js +299 -0
  186. package/dist/core/polyphase/workflow/saved.js.map +1 -0
  187. package/dist/core/polyphase/workflow/structured-output.d.ts +22 -0
  188. package/dist/core/polyphase/workflow/structured-output.d.ts.map +1 -0
  189. package/dist/core/polyphase/workflow/structured-output.js +66 -0
  190. package/dist/core/polyphase/workflow/structured-output.js.map +1 -0
  191. package/dist/core/polyphase/workflow/tool.d.ts +24 -0
  192. package/dist/core/polyphase/workflow/tool.d.ts.map +1 -0
  193. package/dist/core/polyphase/workflow/tool.js +139 -0
  194. package/dist/core/polyphase/workflow/tool.js.map +1 -0
  195. package/dist/core/sdk.d.ts +1 -1
  196. package/dist/core/sdk.js +1 -1
  197. package/dist/core/sdk.js.map +1 -1
  198. package/dist/core/settings-manager.d.ts +27 -0
  199. package/dist/core/settings-manager.d.ts.map +1 -1
  200. package/dist/core/settings-manager.js.map +1 -1
  201. package/dist/core/socket-server/permission-relay.js +4 -0
  202. package/dist/core/socket-server/permission-relay.js.map +1 -1
  203. package/dist/core/trust-manager.d.ts +3 -2
  204. package/dist/core/trust-manager.d.ts.map +1 -1
  205. package/dist/core/trust-manager.js +5 -2
  206. package/dist/core/trust-manager.js.map +1 -1
  207. package/dist/experimental/micro/runtime.js +1 -1
  208. package/dist/experimental/micro/runtime.js.map +1 -1
  209. package/dist/modes/interactive/components/keybinding-hints.d.ts +7 -0
  210. package/dist/modes/interactive/components/keybinding-hints.d.ts.map +1 -1
  211. package/dist/modes/interactive/components/keybinding-hints.js +18 -0
  212. package/dist/modes/interactive/components/keybinding-hints.js.map +1 -1
  213. package/dist/modes/interactive/interactive-mode.d.ts.map +1 -1
  214. package/dist/modes/interactive/interactive-mode.js +11 -2
  215. package/dist/modes/interactive/interactive-mode.js.map +1 -1
  216. package/dist/modes/rpc/rpc-types.d.ts +9 -0
  217. package/dist/modes/rpc/rpc-types.d.ts.map +1 -1
  218. package/dist/modes/rpc/rpc-types.js.map +1 -1
  219. package/dist/prompts/commands/orchestrate.md +1 -1
  220. package/dist/utils/shell.d.ts.map +1 -1
  221. package/dist/utils/shell.js +7 -1
  222. package/dist/utils/shell.js.map +1 -1
  223. package/docs/docs.json +4 -0
  224. package/docs/duet.md +3 -3
  225. package/docs/environment-variables.md +11 -0
  226. package/docs/json.md +7 -0
  227. package/docs/keybindings.md +20 -0
  228. package/docs/polyphase.md +391 -0
  229. package/docs/rpc-commands.md +9 -9
  230. package/docs/settings.md +12 -0
  231. package/docs/virtual-models.md +3 -3
  232. package/examples/extensions/preset.ts +3 -3
  233. package/examples/extensions/subagent/README.md +1 -1
  234. package/examples/extensions/subagent/agents/planner.md +1 -1
  235. package/examples/extensions/subagent/agents/reviewer.md +1 -1
  236. package/examples/extensions/subagent/agents/scout.md +1 -1
  237. package/examples/extensions/subagent/agents/worker.md +1 -1
  238. package/examples/extensions/summarize.ts +3 -3
  239. package/examples/sdk/02-custom-model.ts +1 -1
  240. package/examples/sdk/12-full-control.ts +1 -1
  241. package/examples/sdk/README.md +1 -1
  242. package/package.json +10 -10
  243. package/prompts/commands/orchestrate.md +1 -1
  244. package/dist/bundle/chunks/chunk-SPZUYYP5.js +0 -170
  245. package/dist/bundle/chunks/execute-EMOVNTD6.js +0 -328
  246. package/dist/bundle/chunks/virtual-modules-OC56AAJ7.js +0 -2
@@ -0,0 +1,184 @@
1
+ /**
2
+ * Approval descriptions for the `workflow` tool and the `/workflow`, `/<name>` command path.
3
+ * See DESIGN.md §15.1.
4
+ */
5
+ import * as os from "node:os";
6
+ import * as path from "node:path";
7
+ import { realPathStrict } from "../../utils/canonical-path.js";
8
+ import { WORKFLOW_TOOL_NAME } from "./types.js";
9
+ import { extractWorkflowMeta } from "./workflow/meta.js";
10
+ import { findSavedWorkflow } from "./workflow/saved.js";
11
+ const MAX_ARG_CHARS = 120;
12
+ function truncateArgs(args) {
13
+ const codePoints = Array.from(args);
14
+ if (codePoints.length <= MAX_ARG_CHARS)
15
+ return args;
16
+ return `${codePoints.slice(0, MAX_ARG_CHARS - 1).join("")}…`;
17
+ }
18
+ /**
19
+ * Sanitizes, then JSON-quotes, args so model-controlled text can't break the surrounding dialog.
20
+ * `JSON.stringify` already escapes quotes, backslashes and C0 controls (including newlines and
21
+ * tabs) as visible `\n`/`\t`-style sequences, so only the characters it leaves unescaped — C1
22
+ * controls (U+0080-U+009F, including U+009B, the 8-bit CSI), U+2028/U+2029 and bidi overrides —
23
+ * are replaced with spaces first. Unlike `oneLine`'s full C0 sweep (used for prose that must
24
+ * collapse to one row), this must not touch C0 or args would lose their visible escapes.
25
+ */
26
+ function quoteArgs(args) {
27
+ return JSON.stringify(sanitizeArgsForQuoting(truncateArgs(args)));
28
+ }
29
+ function formatApproxTokens(tokens) {
30
+ if (tokens >= 1_000_000)
31
+ return `${trimDecimal(tokens / 1_000_000)}m`;
32
+ if (tokens >= 1_000) {
33
+ const kilos = trimDecimal(tokens / 1_000);
34
+ // toFixed(1) can round up to "1000.0", which would display as "1000k" instead of "1m".
35
+ if (Number(kilos) >= 1000)
36
+ return `${trimDecimal(tokens / 1_000_000)}m`;
37
+ return `${kilos}k`;
38
+ }
39
+ return `${tokens}`;
40
+ }
41
+ function trimDecimal(value) {
42
+ return Number(value.toFixed(1)).toString();
43
+ }
44
+ // C0/C1 controls, the Unicode line/paragraph separators, and the bidi embedding/override/isolate
45
+ // controls. None of these are escaped by `JSON.stringify`, and a line separator or bidi override
46
+ // can visually relocate or hide text in a terminal even where a literal "\n" can't.
47
+ const UNSAFE_INLINE_PATTERN = /[\u0000-\u001f\u007f-\u009f\u2028\u2029\u202a-\u202e\u2066-\u2069]+/g;
48
+ function sanitizeInline(value) {
49
+ return value.replace(UNSAFE_INLINE_PATTERN, " ");
50
+ }
51
+ // Same as UNSAFE_INLINE_PATTERN minus C0 (\u0000-\u001f): JSON.stringify already escapes those
52
+ // visibly (e.g. "\n", "\t"), so quoteArgs must leave them for it instead of collapsing them here.
53
+ const UNSAFE_QUOTED_PATTERN = /[\u007f-\u009f\u2028\u2029\u202a-\u202e\u2066-\u2069]+/g;
54
+ function sanitizeArgsForQuoting(value) {
55
+ return value.replace(UNSAFE_QUOTED_PATTERN, " ");
56
+ }
57
+ /**
58
+ * Collapses newlines and other unsafe characters to spaces so model-controlled text (a workflow's
59
+ * `meta.description`, phase titles, phase models) can't inject extra lines into the approval
60
+ * message. `boundDialogText` treats every "\n" in the message as a deliberate row break, so an
61
+ * unsanitized multi-line description could push the trust-relevant Source/Limits lines past its
62
+ * row cap.
63
+ */
64
+ function oneLine(value) {
65
+ return sanitizeInline(value).replace(/ {2,}/g, " ").trim();
66
+ }
67
+ function formatBudgetText(budgetTokens) {
68
+ return budgetTokens === null ? "no budget" : `budget ${formatApproxTokens(budgetTokens)} tokens`;
69
+ }
70
+ function formatLimitsLine(limits, budgetTokens) {
71
+ return `Limits: ${limits.concurrency} agents at once · up to ${limits.maxAgents} agents · ${formatBudgetText(budgetTokens)}`;
72
+ }
73
+ function countScriptLines(script) {
74
+ if (script.length === 0)
75
+ return 0;
76
+ let newlineCount = 0;
77
+ for (let i = 0; i < script.length; i++)
78
+ if (script.charCodeAt(i) === 10)
79
+ newlineCount++;
80
+ return script.endsWith("\n") ? newlineCount : newlineCount + 1;
81
+ }
82
+ function resolveBudgetTokens(input, limits) {
83
+ const budget = input.budgetTokens;
84
+ return typeof budget === "number" && Number.isFinite(budget) ? budget : limits.budgetTokens;
85
+ }
86
+ function formatMessagePhases(phases) {
87
+ return phases
88
+ .map((phase, index) => `${index + 1} ${oneLine(phase.title)}${phase.model ? ` (${oneLine(phase.model)})` : ""}`)
89
+ .join(" · ");
90
+ }
91
+ function formatOperationPhases(phases) {
92
+ return phases.map((phase) => oneLine(phase.title)).join(" → ");
93
+ }
94
+ function formatSourceText(info) {
95
+ if (info.source === "inline") {
96
+ const lines = info.scriptLines ?? 0;
97
+ return `inline script written by the model (${lines} ${lines === 1 ? "line" : "lines"})`;
98
+ }
99
+ return `${info.source} ${info.path ?? ""}`.trim();
100
+ }
101
+ export function describeWorkflowForApproval(meta, info, limits) {
102
+ const lines = [
103
+ oneLine(meta.description),
104
+ `Phases: ${formatMessagePhases(meta.phases)}`,
105
+ `Source: ${formatSourceText(info)}`,
106
+ ];
107
+ if (info.args)
108
+ lines.push(`Args: ${quoteArgs(info.args)}`);
109
+ const budgetTokens = info.budgetTokens !== undefined ? info.budgetTokens : limits.budgetTokens;
110
+ lines.push(formatLimitsLine(limits, budgetTokens));
111
+ lines.push("Each agent is a separate paid model session. Tool calls inside agents still follow permission rules.");
112
+ const operation = `workflow ${meta.name}: ${formatOperationPhases(meta.phases)}${info.args ? `; args ${quoteArgs(info.args)}` : ""}`;
113
+ return { title: `Run workflow "${meta.name}"?`, message: lines.join("\n"), operation };
114
+ }
115
+ export function describeInvalidWorkflow(message, info) {
116
+ return {
117
+ title: "Run workflow (invalid meta)?",
118
+ message: `The meta block is invalid: ${oneLine(message)}. Approving fails before any agent starts.`,
119
+ operation: `workflow (invalid meta): ${formatSourceText(info)}`,
120
+ };
121
+ }
122
+ function formatSavedWorkflowPath(filePath, source, cwd) {
123
+ if (source === "project") {
124
+ const baseCwd = realPathStrict(cwd) ?? cwd;
125
+ const rel = path.relative(baseCwd, filePath);
126
+ return path.isAbsolute(rel) ? filePath : rel;
127
+ }
128
+ const home = os.homedir();
129
+ if (filePath === home || filePath.startsWith(`${home}${path.sep}`))
130
+ return `~${filePath.slice(home.length)}`;
131
+ return filePath;
132
+ }
133
+ function readStringField(input, field) {
134
+ const value = input[field];
135
+ return typeof value === "string" ? value : undefined;
136
+ }
137
+ /** Only "workflow" (inline script or saved name); undefined for every other tool and for unknown saved names. Never throws. */
138
+ export function describeToolCallForApproval(toolName, input, context) {
139
+ try {
140
+ if (toolName !== WORKFLOW_TOOL_NAME)
141
+ return undefined;
142
+ const args = readStringField(input, "args") ?? "";
143
+ const script = readStringField(input, "script");
144
+ if (script !== undefined) {
145
+ const info = {
146
+ source: "inline",
147
+ scriptLines: countScriptLines(script),
148
+ args,
149
+ budgetTokens: resolveBudgetTokens(input, context.limits),
150
+ };
151
+ const extraction = extractWorkflowMeta(script);
152
+ if (!extraction.ok) {
153
+ return describeInvalidWorkflow(`${extraction.error.message} (line ${extraction.error.line})`, info);
154
+ }
155
+ return describeWorkflowForApproval(extraction.meta, info, context.limits);
156
+ }
157
+ const name = readStringField(input, "name");
158
+ if (name === undefined)
159
+ return undefined;
160
+ const workflow = findSavedWorkflow(name, {
161
+ cwd: context.cwd,
162
+ agentDir: context.agentDir,
163
+ projectTrusted: context.projectTrusted,
164
+ });
165
+ if (workflow === undefined)
166
+ return undefined;
167
+ const info = {
168
+ source: workflow.source,
169
+ path: formatSavedWorkflowPath(workflow.path, workflow.source, context.cwd),
170
+ args,
171
+ budgetTokens: resolveBudgetTokens(input, context.limits),
172
+ };
173
+ if (!workflow.valid)
174
+ return describeInvalidWorkflow(workflow.error ?? "invalid meta block", info);
175
+ const meta = { name: workflow.name, description: workflow.description, phases: workflow.phases };
176
+ if (workflow.whenToUse !== undefined)
177
+ meta.whenToUse = workflow.whenToUse;
178
+ return describeWorkflowForApproval(meta, info, context.limits);
179
+ }
180
+ catch {
181
+ return undefined;
182
+ }
183
+ }
184
+ //# sourceMappingURL=approval.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"approval.js","sourceRoot":"","sources":["../../../src/core/polyphase/approval.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Approval descriptions for the `workflow` tool and the `/workflow`, `/<name>` command path.\n * See DESIGN.md §15.1.\n */\n\nimport * as os from \"node:os\";\nimport * as path from \"node:path\";\nimport { realPathStrict } from \"../../utils/canonical-path.ts\";\nimport type { WorkflowSource } from \"./types.ts\";\nimport { WORKFLOW_TOOL_NAME } from \"./types.ts\";\nimport { extractWorkflowMeta, type WorkflowMeta, type WorkflowPhaseMeta } from \"./workflow/meta.ts\";\nimport { findSavedWorkflow } from \"./workflow/saved.ts\";\n\nexport interface ApprovalDescription {\n\ttitle: string;\n\tmessage: string;\n\toperation: string;\n}\n\nexport interface ApprovalLimits {\n\tconcurrency: number;\n\tmaxAgents: number;\n\tbudgetTokens: number | null;\n}\n\nexport interface ApprovalContext {\n\tcwd: string;\n\tprojectTrusted: boolean;\n\tagentDir: string;\n\tlimits: ApprovalLimits;\n}\n\nexport interface WorkflowApprovalInfo {\n\tsource: WorkflowSource;\n\t/** Display path for \"project\"/\"user\" sources, already relative to cwd or home. */\n\tpath?: string;\n\tscriptLines?: number;\n\targs?: string;\n\tbudgetTokens?: number | null;\n}\n\nconst MAX_ARG_CHARS = 120;\n\nfunction truncateArgs(args: string): string {\n\tconst codePoints = Array.from(args);\n\tif (codePoints.length <= MAX_ARG_CHARS) return args;\n\treturn `${codePoints.slice(0, MAX_ARG_CHARS - 1).join(\"\")}…`;\n}\n\n/**\n * Sanitizes, then JSON-quotes, args so model-controlled text can't break the surrounding dialog.\n * `JSON.stringify` already escapes quotes, backslashes and C0 controls (including newlines and\n * tabs) as visible `\\n`/`\\t`-style sequences, so only the characters it leaves unescaped — C1\n * controls (U+0080-U+009F, including U+009B, the 8-bit CSI), U+2028/U+2029 and bidi overrides —\n * are replaced with spaces first. Unlike `oneLine`'s full C0 sweep (used for prose that must\n * collapse to one row), this must not touch C0 or args would lose their visible escapes.\n */\nfunction quoteArgs(args: string): string {\n\treturn JSON.stringify(sanitizeArgsForQuoting(truncateArgs(args)));\n}\n\nfunction formatApproxTokens(tokens: number): string {\n\tif (tokens >= 1_000_000) return `${trimDecimal(tokens / 1_000_000)}m`;\n\tif (tokens >= 1_000) {\n\t\tconst kilos = trimDecimal(tokens / 1_000);\n\t\t// toFixed(1) can round up to \"1000.0\", which would display as \"1000k\" instead of \"1m\".\n\t\tif (Number(kilos) >= 1000) return `${trimDecimal(tokens / 1_000_000)}m`;\n\t\treturn `${kilos}k`;\n\t}\n\treturn `${tokens}`;\n}\n\nfunction trimDecimal(value: number): string {\n\treturn Number(value.toFixed(1)).toString();\n}\n\n// C0/C1 controls, the Unicode line/paragraph separators, and the bidi embedding/override/isolate\n// controls. None of these are escaped by `JSON.stringify`, and a line separator or bidi override\n// can visually relocate or hide text in a terminal even where a literal \"\\n\" can't.\nconst UNSAFE_INLINE_PATTERN = /[\\u0000-\\u001f\\u007f-\\u009f\\u2028\\u2029\\u202a-\\u202e\\u2066-\\u2069]+/g;\n\nfunction sanitizeInline(value: string): string {\n\treturn value.replace(UNSAFE_INLINE_PATTERN, \" \");\n}\n\n// Same as UNSAFE_INLINE_PATTERN minus C0 (\\u0000-\\u001f): JSON.stringify already escapes those\n// visibly (e.g. \"\\n\", \"\\t\"), so quoteArgs must leave them for it instead of collapsing them here.\nconst UNSAFE_QUOTED_PATTERN = /[\\u007f-\\u009f\\u2028\\u2029\\u202a-\\u202e\\u2066-\\u2069]+/g;\n\nfunction sanitizeArgsForQuoting(value: string): string {\n\treturn value.replace(UNSAFE_QUOTED_PATTERN, \" \");\n}\n\n/**\n * Collapses newlines and other unsafe characters to spaces so model-controlled text (a workflow's\n * `meta.description`, phase titles, phase models) can't inject extra lines into the approval\n * message. `boundDialogText` treats every \"\\n\" in the message as a deliberate row break, so an\n * unsanitized multi-line description could push the trust-relevant Source/Limits lines past its\n * row cap.\n */\nfunction oneLine(value: string): string {\n\treturn sanitizeInline(value).replace(/ {2,}/g, \" \").trim();\n}\n\nfunction formatBudgetText(budgetTokens: number | null): string {\n\treturn budgetTokens === null ? \"no budget\" : `budget ${formatApproxTokens(budgetTokens)} tokens`;\n}\n\nfunction formatLimitsLine(limits: ApprovalLimits, budgetTokens: number | null): string {\n\treturn `Limits: ${limits.concurrency} agents at once · up to ${limits.maxAgents} agents · ${formatBudgetText(budgetTokens)}`;\n}\n\nfunction countScriptLines(script: string): number {\n\tif (script.length === 0) return 0;\n\tlet newlineCount = 0;\n\tfor (let i = 0; i < script.length; i++) if (script.charCodeAt(i) === 10) newlineCount++;\n\treturn script.endsWith(\"\\n\") ? newlineCount : newlineCount + 1;\n}\n\nfunction resolveBudgetTokens(input: Record<string, unknown>, limits: ApprovalLimits): number | null {\n\tconst budget = input.budgetTokens;\n\treturn typeof budget === \"number\" && Number.isFinite(budget) ? budget : limits.budgetTokens;\n}\n\nfunction formatMessagePhases(phases: readonly WorkflowPhaseMeta[]): string {\n\treturn phases\n\t\t.map((phase, index) => `${index + 1} ${oneLine(phase.title)}${phase.model ? ` (${oneLine(phase.model)})` : \"\"}`)\n\t\t.join(\" · \");\n}\n\nfunction formatOperationPhases(phases: readonly WorkflowPhaseMeta[]): string {\n\treturn phases.map((phase) => oneLine(phase.title)).join(\" → \");\n}\n\nfunction formatSourceText(info: WorkflowApprovalInfo): string {\n\tif (info.source === \"inline\") {\n\t\tconst lines = info.scriptLines ?? 0;\n\t\treturn `inline script written by the model (${lines} ${lines === 1 ? \"line\" : \"lines\"})`;\n\t}\n\treturn `${info.source} ${info.path ?? \"\"}`.trim();\n}\n\nexport function describeWorkflowForApproval(\n\tmeta: WorkflowMeta,\n\tinfo: WorkflowApprovalInfo,\n\tlimits: ApprovalLimits,\n): ApprovalDescription {\n\tconst lines = [\n\t\toneLine(meta.description),\n\t\t`Phases: ${formatMessagePhases(meta.phases)}`,\n\t\t`Source: ${formatSourceText(info)}`,\n\t];\n\tif (info.args) lines.push(`Args: ${quoteArgs(info.args)}`);\n\tconst budgetTokens = info.budgetTokens !== undefined ? info.budgetTokens : limits.budgetTokens;\n\tlines.push(formatLimitsLine(limits, budgetTokens));\n\tlines.push(\"Each agent is a separate paid model session. Tool calls inside agents still follow permission rules.\");\n\n\tconst operation = `workflow ${meta.name}: ${formatOperationPhases(meta.phases)}${\n\t\tinfo.args ? `; args ${quoteArgs(info.args)}` : \"\"\n\t}`;\n\n\treturn { title: `Run workflow \"${meta.name}\"?`, message: lines.join(\"\\n\"), operation };\n}\n\nexport function describeInvalidWorkflow(message: string, info: WorkflowApprovalInfo): ApprovalDescription {\n\treturn {\n\t\ttitle: \"Run workflow (invalid meta)?\",\n\t\tmessage: `The meta block is invalid: ${oneLine(message)}. Approving fails before any agent starts.`,\n\t\toperation: `workflow (invalid meta): ${formatSourceText(info)}`,\n\t};\n}\n\nfunction formatSavedWorkflowPath(filePath: string, source: \"project\" | \"user\", cwd: string): string {\n\tif (source === \"project\") {\n\t\tconst baseCwd = realPathStrict(cwd) ?? cwd;\n\t\tconst rel = path.relative(baseCwd, filePath);\n\t\treturn path.isAbsolute(rel) ? filePath : rel;\n\t}\n\tconst home = os.homedir();\n\tif (filePath === home || filePath.startsWith(`${home}${path.sep}`)) return `~${filePath.slice(home.length)}`;\n\treturn filePath;\n}\n\nfunction readStringField(input: Record<string, unknown>, field: string): string | undefined {\n\tconst value = input[field];\n\treturn typeof value === \"string\" ? value : undefined;\n}\n\n/** Only \"workflow\" (inline script or saved name); undefined for every other tool and for unknown saved names. Never throws. */\nexport function describeToolCallForApproval(\n\ttoolName: string,\n\tinput: Record<string, unknown>,\n\tcontext: ApprovalContext,\n): ApprovalDescription | undefined {\n\ttry {\n\t\tif (toolName !== WORKFLOW_TOOL_NAME) return undefined;\n\n\t\tconst args = readStringField(input, \"args\") ?? \"\";\n\t\tconst script = readStringField(input, \"script\");\n\t\tif (script !== undefined) {\n\t\t\tconst info: WorkflowApprovalInfo = {\n\t\t\t\tsource: \"inline\",\n\t\t\t\tscriptLines: countScriptLines(script),\n\t\t\t\targs,\n\t\t\t\tbudgetTokens: resolveBudgetTokens(input, context.limits),\n\t\t\t};\n\t\t\tconst extraction = extractWorkflowMeta(script);\n\t\t\tif (!extraction.ok) {\n\t\t\t\treturn describeInvalidWorkflow(`${extraction.error.message} (line ${extraction.error.line})`, info);\n\t\t\t}\n\t\t\treturn describeWorkflowForApproval(extraction.meta, info, context.limits);\n\t\t}\n\n\t\tconst name = readStringField(input, \"name\");\n\t\tif (name === undefined) return undefined;\n\n\t\tconst workflow = findSavedWorkflow(name, {\n\t\t\tcwd: context.cwd,\n\t\t\tagentDir: context.agentDir,\n\t\t\tprojectTrusted: context.projectTrusted,\n\t\t});\n\t\tif (workflow === undefined) return undefined;\n\n\t\tconst info: WorkflowApprovalInfo = {\n\t\t\tsource: workflow.source,\n\t\t\tpath: formatSavedWorkflowPath(workflow.path, workflow.source, context.cwd),\n\t\t\targs,\n\t\t\tbudgetTokens: resolveBudgetTokens(input, context.limits),\n\t\t};\n\t\tif (!workflow.valid) return describeInvalidWorkflow(workflow.error ?? \"invalid meta block\", info);\n\n\t\tconst meta: WorkflowMeta = { name: workflow.name, description: workflow.description, phases: workflow.phases };\n\t\tif (workflow.whenToUse !== undefined) meta.whenToUse = workflow.whenToUse;\n\t\treturn describeWorkflowForApproval(meta, info, context.limits);\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n"]}
@@ -0,0 +1,107 @@
1
+ import type { JsonValue, Usage } from "@draht/ai";
2
+ import type { JsonAgentSessionEvent } from "../../modes/json-event.ts";
3
+ import { type AgentModelInfo, type ChildAgentState, type ChildStateChange, type ChildStateLimits, type RunResult } from "./types.ts";
4
+ export interface SessionHeaderRecord {
5
+ type: "session";
6
+ id: string;
7
+ cwd?: string;
8
+ timestamp?: string;
9
+ version?: number;
10
+ }
11
+ export type ChildWireRecord = SessionHeaderRecord | JsonAgentSessionEvent;
12
+ /** JSON.parse in try/catch; returns undefined for malformed lines or values without a string `type`. */
13
+ export declare function parseChildLine(line: string): ChildWireRecord | undefined;
14
+ /** One line ≤ 120 chars: command | path | file_path | pattern | query | url, else compact JSON. */
15
+ export declare function summarizeToolArgs(_toolName: string, args: JsonValue | undefined): string;
16
+ /** Last line matching /^STATUS:\s*\S.*$/m, trimmed. */
17
+ export declare function extractStatusLine(text: string): string | undefined;
18
+ /** input + output + cacheWrite (cache reads excluded); 0 for undefined. */
19
+ export declare function billableTokens(usage: Usage | undefined): number;
20
+ export declare function createChildAgentState(model: AgentModelInfo): ChildAgentState;
21
+ export interface ChildExit {
22
+ code: number | null;
23
+ signal: NodeJS.Signals | null;
24
+ cancelled: boolean;
25
+ spawnError?: string;
26
+ }
27
+ export interface ChildFinish {
28
+ exitCode: number;
29
+ failure?: string;
30
+ }
31
+ export declare class ChildEventReducer {
32
+ readonly state: ChildAgentState;
33
+ private readonly limits;
34
+ private readonly now;
35
+ private toolItemsById;
36
+ private openThinking;
37
+ private openText;
38
+ /** Last thinking/text item, kept past `*_end` so `nowLine` shows its final content instead of going blank. */
39
+ private lastThinking;
40
+ private lastText;
41
+ private lastToolItem;
42
+ private blockedPending;
43
+ private pendingStructuredById;
44
+ /** Buffered `toolcall_delta` argument JSON per content index, up to `TOOLCALL_ARG_BUFFER_MAX_CHARS` (not surfaced). */
45
+ private toolcallArgBuffers;
46
+ private lastHeartbeatAt;
47
+ constructor(init: {
48
+ model: AgentModelInfo;
49
+ limits?: Partial<ChildStateLimits>;
50
+ now?: () => number;
51
+ });
52
+ markQueued(): ChildStateChange;
53
+ markSpawning(): ChildStateChange;
54
+ apply(record: ChildWireRecord): ChildStateChange;
55
+ /** For skipped tool_execution_update lines: "fine" at most once per second, else "none". */
56
+ noteHeartbeat(): ChildStateChange;
57
+ noteStderr(chunk: string): void;
58
+ /** Fallback re-spawn: reset everything except queuedAt/startedAt; add an info notice. */
59
+ resetForRetry(model: AgentModelInfo, notice: string): void;
60
+ finish(exit: ChildExit): ChildFinish;
61
+ /** After the run finished: keep the newest `maxChars` transcript chars. */
62
+ trimForRetention(maxChars: number): void;
63
+ dropTranscript(): void;
64
+ /** Clears open/last item refs that point at an item removed from the transcript. */
65
+ private clearRefsTo;
66
+ private applyRecord;
67
+ private handleMessageStart;
68
+ private handleMessageEnd;
69
+ private handleMessageUpdate;
70
+ private applyAssistantMessageEvent;
71
+ private handleToolExecutionStart;
72
+ private handleToolExecutionEnd;
73
+ private nextSeq;
74
+ private pushNotice;
75
+ private pushItem;
76
+ private mutateItem;
77
+ /** `addition` is typed `unknown`, not `string`, on purpose: a well-typed-looking wire record can
78
+ * still carry a non-string `delta` at runtime (`parseChildLine` only checks `type`), and this
79
+ * must throw before touching `item.text` rather than let a non-string silently become part of
80
+ * the transcript or poison `transcriptChars` with a NaN-producing `.length` on a non-string. */
81
+ private appendCapped;
82
+ /** The full item content replaces the accumulated (already tail-capped) text; droppedChars reflects
83
+ * this final content, not the sum of every delta's cap, so it is assigned rather than accumulated.
84
+ * `content` is `unknown`, not `string`, for the same reason as {@link appendCapped}'s `addition`. */
85
+ private replaceCapped;
86
+ private measure;
87
+ /** Shrinks `item` in place, keeping its tail (most recent content), until `measure(item) <=
88
+ * maxChars`. Used only to keep the newest transcript item instead of evicting it outright. */
89
+ private tailTrimToFit;
90
+ private adjustChars;
91
+ private evictIfNeeded;
92
+ private isOpenItem;
93
+ private bump;
94
+ private computeNowLine;
95
+ }
96
+ export declare function toRunResult(state: Readonly<ChildAgentState>, base: {
97
+ agent: string;
98
+ task: string;
99
+ step?: number;
100
+ }, finish: ChildFinish, extras: {
101
+ cancelled: boolean;
102
+ structured?: {
103
+ value: JsonValue;
104
+ };
105
+ durationMs: number;
106
+ }): RunResult;
107
+ //# sourceMappingURL=child-events.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"child-events.d.ts","sourceRoot":"","sources":["../../../src/core/polyphase/child-events.ts"],"names":[],"mappings":"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"}